examples

Command agent-react demonstrates the ReAct loop in pkg/agent using a deterministic scriptedProvider so the example runs offline.

Command eval-suite shows how to use pkg/eval to gate prompt and agent changes from CI.

Command graph-counter is the smallest non-trivial graph example: a single node that increments a counter, with a conditional self- loop that exits when the limit is reached.

Command graph-interrupt demonstrates the human-in-the-loop cycle built on pkg/graph: Invoke runs until it hits an interrupt-gated node, persists a checkpoint, and returns ErrInterrupted.

Command integration-approval-gate demonstrates the human-in-the-loop pattern: a banking-style agent pauses before any irreversible action (here: transfer money) so a human can approve, reject, or edit the transfer before it goes through.

Command integration-cost-tracked demonstrates per-run budget enforcement: a Provider middleware tallies input + output tokens across every call and aborts the agent the moment the configured budget is exceeded.

Command integration-http-interpret is a complete, copy-paste HTTP service that wraps a galdor agent: structured output, OTel tracing into the embedded SQLite store, a health endpoint, and graceful shutdown.

Command integration-mcp-server exposes a galdor tool registry as an MCP server over stdio.

Command integration-support-bot demonstrates a real-world customer-support pattern: a routing supervisor delegates each incoming user message to one of three specialist agents (billing, technical, general), each with its own tool registry.

Command memory-rag demonstrates the full retrieval-augmented generation flow end-to-end against a local SQLite store and an offline hashing embedder.

Command observability-trace runs a tiny ReAct agent with full OpenTelemetry instrumentation: provider calls, tool executions and graph node hops all emit spans.

Command provider-interface demonstrates galdor's Provider abstraction using an in-process stub implementation.

Command scry-store runs a tiny ReAct agent with the OTel instrumentation pointing at galdor's embedded SQLite span store, then prints the resulting trace using the `galdor scry` CLI.

Command structured-output shows provider.GenerateStructured: constrain a model's reply to a Go struct and get it back decoded.

Command tools-loop demonstrates the LLM ↔ tools dispatch cycle using a deterministic in-process provider.