Errors¶
Every failure mode in Murmur wraps in a MurmurError subclass.
Catch narrow, raise specific. Core code never raises raw Exception
or ValueError.
from murmur.core.errors import (
AllAgentsFailedError,
BudgetExceededError,
ContextError,
DepthLimitError,
MurmurError,
RegistryError,
SpawnCapError,
SpawnCycleError,
SpawnError,
SpecValidationError,
ToolExecutionError,
TopologyError,
TrustViolationError,
)
Hierarchy¶
MurmurError
├── SpawnError
├── SpawnCycleError
├── SpawnCapError
├── ToolExecutionError
├── ContextError
├── BudgetExceededError
├── DepthLimitError
├── RegistryError
├── TrustViolationError
├── AllAgentsFailedError
└── SpecValidationError
└── TopologyError
Base¶
MurmurError¶
Base class for all Murmur errors.
Runtime errors¶
SpawnError¶
Agent failed to spawn or its execution backend errored.
ToolExecutionError¶
A tool call requested by the agent failed during execution.
ContextError¶
Context preparation by a ContextPasser failed.
BudgetExceededError¶
Token, cost, or wall-clock budget was exceeded.
DepthLimitError¶
Cascading-spawn depth limit was reached.
SpawnCycleError¶
A cascading spawn would re-enter an ancestor agent, forming a cycle.
Raised when an agent's name already appears in the parent chain at the
moment the runtime is asked to dispatch it. Cycles are detected per-run
against an in-memory ancestor frozenset on :class:AgentContext; the
runtime never expands a cycle, so the offending child spawn never executes.
SpawnCapError¶
The runtime-wide cascading-spawn cap was exhausted.
The cap (RuntimeOptions.max_total_spawns) is a kill switch independent
of token budget — a runaway agent generating unbounded child spawns hits
this before the cost meter catches up.
TrustViolationError¶
A tool call was denied because the agent's trust level forbids it.
AllAgentsFailedError¶
Every result in a fan-out tier failed; the downstream mapper was not called.
Validation errors¶
RegistryError¶
A spec was not found in the registry, or the registry rejected a write.
SpecValidationError¶
An agent or group spec failed validation.
TopologyError¶
An AgentGroup topology is invalid — cycle, dangling reference, or
incompatible types across an edge.