Package net.thevpc.naru.api.registry

Interface NaruDirective

All Known Subinterfaces:
NaruStructuralDirective
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
    void
    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<net.thevpc.nuts.cmdline.NArgCandidate>
    resolveCandidates(net.thevpc.nuts.cmdline.NCmdLine cmdLine, net.thevpc.nuts.cmdline.NCmdLineAutoCompleteResolver.Pos 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

      void 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.)

    • resolveCandidates

      default List<net.thevpc.nuts.cmdline.NArgCandidate> resolveCandidates(net.thevpc.nuts.cmdline.NCmdLine cmdLine, net.thevpc.nuts.cmdline.NCmdLineAutoCompleteResolver.Pos pos, NaruSession session)
      Resolve autocomplete candidates for this directive.