Errors reference catalog¶
Every exception the framework raises has a dedicated reference
page. The error message in the runtime ends with a More: link to
its page; you should rarely need to visit this catalog directly.
If you arrived here from an error message, follow the link the message printed. If you're browsing — start with ReplayDivergenceError (the voice reference for the catalog) or UnsupportedPatternError (the authoring guide for pattern subscriptions).
The hierarchy itself is documented at Concepts: Failure model.
By category¶
The seven category bases match the
ActiveGraphError hierarchy:
ReplayError¶
PatternError¶
StorageError¶
- CorruptedEventPayloadError
- DuplicateEventError
- EventNotFoundError
- InvalidStoreURL
- NonSerializableEventError
- SchemaVersionMismatch
ExecutionError¶
ConfigurationError¶
- MissingProviderError
- MissingToolError
- MissingOptionalDependency
- InvalidToolRegistration
- InvalidRuntimeConfiguration
- InvalidArgumentType
- RuntimeContextRequiredError
- InvalidPatchLifecycleState
RegistrationError¶
- BehaviorNotFoundError
- AmbiguousBehaviorError
- ToolNotFoundError
- AmbiguousToolError
- IncompatibleRuntimeState
PackError¶
Internal (framework-bug voice)¶
What's related¶
- Concepts: Failure model — the hierarchy and the events-not-exceptions principle.
- API reference: Errors — the class hierarchy rendered from docstrings.
- Cookbook: Debugging — diagnostic workflows that build on the per-error catalog.