Package net.thevpc.naru.api.registry

Interface NaruDirective

All Known Subinterfaces:

NaruStructuralDirective

All Known Implementing Classes:

NaruDirectiveBase

public interface NaruDirective

A tool that can be called by the agent's reasoning model.

Implementations must be stateless (or thread-safe) — the registry reuses the same instance across calls.

Method Summary

Modifier and Type	Method	Description
NaruStmtResult	execute(NaruDirectiveCallContext context)	Execute the tool and return a string result that will be sent back to the model as a "tool" role message.
String[]	getAliases()
String	getDescription()	Human-readable description sent to the model.
String	group()
String	name()	Machine-readable name used in the tool schema (no spaces).
default List<NArgCompleteCandidate>	resolveCandidates(NCmdLine cmdLine, NArgCompletePosition pos, NaruSession session)	Resolve autocomplete candidates for this directive.

Method Details

name

String name()

Machine-readable name used in the tool schema (no spaces).

group

String group()

getAliases

String[] getAliases()

getDescription

String getDescription()

Human-readable description sent to the model.

execute

NaruStmtResult execute(NaruDirectiveCallContext context)

Execute the tool and return a string result that will be sent back to the model as a "tool" role message.

Parameters:

context - per-run context (project dir, session, etc.)

Returns:

result string (text, JSON snippet, error message, …)

resolveCandidates

default List<NArgCompleteCandidate> resolveCandidates(NCmdLine cmdLine,
 NArgCompletePosition pos,
 NaruSession session)

Resolve autocomplete candidates for this directive.