Choose an integration path
Public documentation preview — incomplete. The package and optional AI SDK peers remain private and unpublished. These integration paths are guidance, not a qualified public release or a hosted service.Use the smallest path that meets your task. All execution paths require trusted host policy; results can be denied or uncertain.
- You know the exact tool and arguments. Register a local tool and call it, or obtain a current bound descriptor from discovery/filtering and call it with its expected snapshot. No inference is necessary.
- You need relevant tool candidates but no side effects. Filter tools. The default lexical ranker is model-free; named ranking uses an explicitly configured
.rankingadapter. - You want one proposed action. Scope a bounded
executeto the intended target or compatible model group. The selected routing adapter proposes arguments; validation, policy and approval still gate the one possible call. - Your host already uses the AI SDK. Build a governed ToolSet. The host chooses the
generateTextmodel; each emitted tool call goes throughrouter.callwith fresh trusted context. The host controls step and repeat-call budgets.
needs_input, pending_approval or unknown side effects into automatic retries.