Skip to content

exceptions.md

Latest commit

 

History

History
34 lines (28 loc) · 1.46 KB

exceptions.md

File metadata and controls

34 lines (28 loc) · 1.46 KB

Exceptions

The SDK raises a small, focused exception hierarchy rooted at AssemblyError. Every error you can catch from agent_assembly is a subclass of AssemblyError — code that does except AssemblyError: will catch any SDK-raised error without needing to enumerate the leaf classes.

Hierarchy at a glance

AssemblyError                       (base)
├── AgentError                      (agent registration / lifecycle)
├── PolicyError                     (policy evaluation problems)
├── GatewayError                    (network / HTTP transport)
├── ConfigurationError              (bad init_assembly() arguments)
├── AdapterValidationError          (adapter ABC contract failure)
├── OpTerminatedError               (gateway terminated an in-flight op)
└── ToolExecutionBlockedError       (tool call blocked by policy)
    ├── MCPToolBlockedError         (MCP tool call blocked by policy)
    └── PolicyViolationError        (policy denied a tool call)

PolicyViolationError and MCPToolBlockedError both derive from ToolExecutionBlockedError, so except ToolExecutionBlockedError: catches every policy-blocked tool call regardless of which framework raised it.

agent_assembly.exceptions

::: agent_assembly.exceptions options: show_root_heading: false show_root_toc_entry: false members_order: source show_bases: true show_source: true filters: - "!^_"