🤖 tools

amadan.net/rastrillo/rastrillo/tools

Renders agent tool schemas and dispatches model-proposed calls back through the app's own mux. A tool call and an HTTP POST reach the identical Handle function.

Agents and tools is the guide, and rastrillo.Tool is how an action opts in.

Schemas

func Schemas(defs []rastrillo.ToolDef) []Schema
func SchemasJSON(defs []rastrillo.ToolDef) ([]byte, error)

Turn the generated registry, gen.Tools(), into the schema list an LLM provider expects. Schema is one tool's description and argument map.

There is no LLM client here. Choosing a provider is your business; this package supplies the registry, the schemas and the dispatch.

Dispatch

func Dispatch(handler http.Handler, defs []rastrillo.ToolDef, call Call) (Result, error)

Validates a Call against the registry, applies the consent gate, attributes the actor, and routes it through your ordinary http.Handler.

Because it goes through your handler, a tool call cannot reach a route that is not a registered tool, and cannot skip the middleware your routes sit behind — CSRF and the session guards included. Result carries what the handler answered.

The refusals

ErrUnknownArg matters more than it looks. Quietly dropping an unrecognised argument would let a model believe it had constrained an operation that in fact ran unconstrained.

ConfirmSentence

func ConfirmSentence(def rastrillo.ToolDef, args map[string]string) string

Renders a write tool's confirmation sentence with the call's actual arguments in it, so what a human approves is what will happen, not a generic description of what the tool can do.

Read this page as markdown — exact, unstyled, and cheap for an agent to fetch.