tool

type AuditEvent ¶

type AuditEvent struct {
	Tool      string         `json:"tool"`
	Args      map[string]any `json:"args"`
	Duration  int64          `json:"duration_ms"`
	Error     string         `json:"error,omitempty"`
	Timestamp time.Time      `json:"ts"`
}

AuditEvent represents a tool execution event.

type ExecFn ¶

type ExecFn func(context.Context, map[string]any) (string, error)

ExecFn defines the signature for tool execution functions.

type Registry ¶

type Registry map[string]Tool

func DefaultRegistry() Registry

func WrapWithAudit(reg Registry, w io.Writer) Registry

func (r Registry) Use(name string) (Tool, bool)

type TerminalAware ¶

type TerminalAware interface {
	Tool
	Terminal() bool
}

TerminalAware is an optional interface a Tool can implement to signal that a successful execution should normally terminate the agent loop without an additional model reflection pass. Example: the "agent" delegation tool returns a final answer string from the delegated agent.

type Tool ¶

type Tool interface {
	Name() string
	Description() string
	JSONSchema() map[string]any
	Execute(ctx context.Context, args map[string]any) (string, error)
}

Tool represents an executable action available to agents.

func FromManifest(m config.ToolManifest) (Tool, error)

func MarkTerminal(t Tool) Tool

func New(name, desc string, fn func(context.Context, map[string]any) (string, error)) Tool

func NewWithSchema(name, desc string, schema map[string]any, fn func(context.Context, map[string]any) (string, error)) Tool