Skip to content

agent.tool_not_allowed

This tool is not available in the current mode. Switch the assistant to a mode that covers this action, or do it yourself in the app.

AccessDeniedError from the agent’s tool dispatch: the model asked for a tool name outside the catalog built for this run — a hallucinated name, or a handler the current agent mode doesn’t expose.

The catalog is derived from the mounted registry (buildToolCatalog), so a handler without a description never becomes a tool at all. Describe the handler, or widen the agent mode, if the call was meant to work.