Skip to main content

Overview

Discover the installed preset catalogue without resolving credentials, then run one registered tool directly without starting inference. Direct tools use the same policy and branch configuration as an agent run but never publish a Tell conversation head.

Example

Key Points

  • catalogue() is read-only local preset metadata; it does not load API keys or make network calls. models('connection-or-provider') narrows it.
  • tools()->dispatch() performs exactly one enabled tool call. Its result explicitly reports direct, inference: false, and durable: false.
  • For a non-interactive agent run, supply TellAnswerQueue up front. Durable delegation is opt-in through an enabled agent’s spawn_subagent tool and gives each child an inspectable Tell-owned agent-* branch.