Tools

Tool examples cover the surfaces a developer reaches for when giving an agent things to do. Sources under examples/tools/.

Name	Scenario	Source
`tools_schema`	Build a `get_weather` tool with typed args; agent dispatches it for two cities in one turn.	src
`tools_calling_agent`	Multi-tool agent — Calculator + WordCount, dispatched as the user asks each.	src
`tools_orchestrator`	Fan out three slow price-fetch tools in parallel, fold to the cheapest. No agent loop.	src
`tools_stateful_http`	Translator tool that reuses one connection pool across calls — the shape of any external-service tool.	src

How to run

COGNIS_PROVIDER=ollama COGNIS_OLLAMA_MODEL=llama3.1 \
  cargo run -p cognis-examples --example tools_schema

Building your first typed tool? tools_schema — SchemaBasedTool with a typed Params struct.
Calling external services? tools_stateful_http shows the shared-client pattern.
No agent loop, just a DAG of calls? tools_orchestrator.

Tool, SchemaBasedTool, validators, ToolOrchestrator.

Deny-lists, SSRF protection, sandboxing.

Approval-gated tool calls.