Error Codes

Date: 2026-08-29 Total registered codes: 613 Total domains: 76 Total packages contributing codes: 47

This is the authoritative registry of all ORI_ERR_* error codes in the Oridecon Framework monorepo. Every exception class carrying a _code attribute is listed here. Generated by scanning all *.py source files (excluding tests and examples) for _code assignments matching ORI_ERR_<DOMAIN>_<NNN>.

---

1. Domain Summary

Domain Tag	Count	Gaps	Package(s)
ADMIN	30	—	oridecon-admin, oridecon-contracts
ADMIN_ACTION	2	—	oridecon-admin
AGT	11	—	oridecon-ai-agents, oridecon-contracts
AI	5	—	oridecon-ai, oridecon-contracts
AIWORK	3	—	oridecon-ai-workers
APP	3	—	oridecon
AUDIT	4	—	oridecon-audit
AUTH	28	—	oridecon-auth, oridecon-contracts
CACHE	15	—	oridecon-cache, oridecon-contracts
CFG	6	—	oridecon, oridecon-contracts
CLI	3	—	oridecon-cli
CODEGEN	1	—	oridecon-contracts
CONC	8	—	oridecon
CORE	3	003, 004	oridecon, oridecon-contracts
DB	11	—	oridecon-contracts
DI	11	—	oridecon, oridecon-contracts
DOM	9	—	oridecon, oridecon-contracts
EVAL	1	—	oridecon-contracts
EVT	23	—	oridecon-contracts, oridecon-events
FEAT	4	—	oridecon-contracts, oridecon-features
FEED	5	—	oridecon-ai-feedback
GOV	7	004, 005, 009	oridecon-ai-governance, oridecon-contracts
GQL	15	—	oridecon-graphql
GRAPH	12	—	oridecon-graph
GUARD	6	—	oridecon-ai-guard, oridecon-contracts
HTTP	8	—	oridecon-http
IDEM	6	—	oridecon-contracts, oridecon-resilience
IDX	1	—	oridecon-contracts
INFRA	11	—	oridecon-contracts
LLM	26	—	oridecon-ai-llm, oridecon-contracts
LOAD	1	—	oridecon-contracts
LOCK	2	—	oridecon-contracts
MAP	4	—	oridecon, oridecon-contracts
MCP	8	—	oridecon-contracts
MEM	8	004, 007	oridecon-ai-memory, oridecon-contracts
MM	8	—	oridecon-contracts
MM_BEAT	1	001, 002	oridecon-multimedia-beat
MM_IMAGE	2	—	oridecon-multimedia-image
MM_MUSIC	1	—	oridecon-multimedia-music
MM_TTS	1	001	oridecon-multimedia-tts
MM_UPSCALE	3	—	oridecon-multimedia-upscale
MM_VIDEO	6	—	oridecon-multimedia-video
MOD	6	—	oridecon-contracts
MONITOR	8	—	oridecon-monitor
MW	10	—	oridecon, oridecon-contracts
NOSQL	7	—	oridecon-nosql
NOTIF	14	—	oridecon-contracts, oridecon-notification
OBS	4	—	oridecon-ai-observability
PIPE	2	—	oridecon-contracts
PROMPT	7	—	oridecon-ai-prompt
PROV	1	—	oridecon-contracts
QE	1	—	oridecon-contracts
QUEUE	7	—	oridecon-contracts, oridecon-queue
RAG	14	007, 008, 009	oridecon-ai-rag, oridecon-contracts
REG	3	—	oridecon-contracts
RES	11	—	oridecon-contracts, oridecon-resilience
RESULT	1	001	oridecon-contracts
RET	1	—	oridecon-contracts
RUN	1	—	oridecon-contracts
SEARCH	10	—	oridecon-search
SEC	11	007	oridecon, oridecon-auth, oridecon-contracts
SECRET	7	—	oridecon-secrets
SERIAL	4	—	oridecon, oridecon-contracts
SES	12	—	oridecon-ai-session, oridecon-contracts
SKILL	8	—	oridecon-ai-skills, oridecon-contracts
SQL	38	—	oridecon-sql
STORE	8	—	oridecon-contracts, oridecon-storage
TASK	11	—	oridecon-contracts, oridecon-tasks
TENANT	9	—	oridecon-contracts
TEST	12	—	oridecon-testing
UI	1	—	oridecon-ui
VAL	4	—	oridecon, oridecon-contracts
VEC	15	—	oridecon-contracts, oridecon-vector
WEB	14	—	oridecon-contracts, oridecon-web
WEBHOOK	6	—	oridecon-contracts, oridecon-webhook
WF	22	—	oridecon, oridecon-contracts, oridecon-workflow

---

2. Full Registry (by Package)

oridecon-contracts (163 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_ADMIN_001	AdminError	Base exception for all admin-domain errors. Extended by leaf exceptions in oridecon-admin.	core/oridecon-contracts/src/oridecon/contracts/admin/errors.py	OrideconError
ORI_ERR_AGT_001	AgentError	Base exception for all agent errors.	core/oridecon-contracts/src/oridecon/contracts/ai/agents/exceptions.py	OrideconError
ORI_ERR_AGT_002	ToolError	Base exception for tool errors.	core/oridecon-contracts/src/oridecon/contracts/ai/agents/exceptions.py	AgentError
ORI_ERR_AGT_003	StrategyError	Reasoning strategy failed. Raised when the agent’s strategy encounters an error during reasoning …	core/oridecon-contracts/src/oridecon/contracts/ai/agents/exceptions.py	AgentError
ORI_ERR_AI_001	AIError	Base exception for all AI-domain errors. This is the catch-all for AI operations that fail in exp…	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	DomainError
ORI_ERR_AI_002	ExtractionError	Base for structured extraction errors. Used in StructuredExtractorProtocol.extract() return t…	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_AI_003	MetricsCollectionError	Error raised during metrics collection.	core/oridecon-contracts/src/oridecon/contracts/observability/ai.py	MonitoringError
ORI_ERR_AI_004	TracingError	Error raised during tracing operations.	core/oridecon-contracts/src/oridecon/contracts/observability/ai.py	OrideconError
ORI_ERR_AUTH_001	AuthError	Base exception for all auth-domain errors. This is the catch-all for authentication and authoriza…	core/oridecon-contracts/src/oridecon/contracts/auth/exceptions.py	DomainError
ORI_ERR_AUTH_002	TokenError	Base class for expected, recoverable token domain failures. All subtypes indicate situations the …	core/oridecon-contracts/src/oridecon/contracts/auth/exceptions.py	DomainError
ORI_ERR_AUTH_003	VerificationError	Base class for expected, recoverable account-verification failures. All subtypes signal situation…	core/oridecon-contracts/src/oridecon/contracts/auth/exceptions.py	DomainError
ORI_ERR_CACHE_001	CacheError	Base exception for all cache-domain errors. This is an expected, recoverable error that cache cli…	core/oridecon-contracts/src/oridecon/contracts/infra/cache/exceptions.py	DomainError
ORI_ERR_CACHE_002	CacheKeyNotFoundError	Raised when cache key is not found.	core/oridecon-contracts/src/oridecon/contracts/infra/cache/exceptions.py	CacheError
ORI_ERR_CACHE_003	CacheWriteError	Raised when cache write fails.	core/oridecon-contracts/src/oridecon/contracts/infra/cache/exceptions.py	CacheError
ORI_ERR_CFG_001	ConfigurationError	Developer configuration or runtime misconfiguration errors. Supports optional structured validati…	core/oridecon-contracts/src/oridecon/contracts/exceptions/config.py	OrideconError
ORI_ERR_CODEGEN_001	CollidingFileError	A generated file collides with an existing file under a FAIL policy.	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	InfrastructureError
ORI_ERR_CORE_001	OrideconError	Root exception for the entire Oridecon ecosystem. All Oridecon exceptions inherit from this class…	core/oridecon-contracts/src/oridecon/contracts/exceptions/base.py	Exception
ORI_ERR_DB_001	DatabaseError	Database-related error (infrastructure-level).	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	InfrastructureError
ORI_ERR_DB_002	MigrationError	Database migration error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	InfrastructureError
ORI_ERR_DB_003	IntegrityError	Raised when a database integrity constraint is violated.	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	DatabaseError
ORI_ERR_DB_004	ConstraintError	Raised when a generic database constraint is violated.	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	IntegrityError
ORI_ERR_DB_005	DuplicateKeyError	Raised when a unique-key constraint is violated (duplicate record).	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	ConstraintError
ORI_ERR_DB_006	UnitOfWorkError	Raised when a unit-of-work operation fails or is used incorrectly.	core/oridecon-contracts/src/oridecon/contracts/data/exceptions.py	OrideconError
ORI_ERR_DB_007	DataError	Base exception for all data-domain errors. This is an expected, recoverable error that data clien…	core/oridecon-contracts/src/oridecon/contracts/data/exceptions.py	DomainError
ORI_ERR_DB_008	DataNotFoundError	Raised when data item is not found.	core/oridecon-contracts/src/oridecon/contracts/data/exceptions.py	DataError
ORI_ERR_DB_009	DataValidationError	Raised when data validation fails.	core/oridecon-contracts/src/oridecon/contracts/data/exceptions.py	DataError
ORI_ERR_DB_010	InvalidIdentifierError	Raised when an SQL identifier fails validation. Attributes: identifier: The offending identifier …	core/oridecon-contracts/src/oridecon/contracts/data/sql/sql.py	ValidationError
ORI_ERR_DB_011	NoPrimaryBackendError	Raised when a multi-backend setup has no backend marked as primary. For multi-backend SQL configu…	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	DatabaseError
ORI_ERR_DI_001	ContainerError	Base container error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/container.py	OrideconError
ORI_ERR_DI_002	DependencyError	Dependency resolution error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/container.py	ContainerError
ORI_ERR_DI_003	CircularDependencyError	Circular dependency detected.	core/oridecon-contracts/src/oridecon/contracts/exceptions/container.py	DependencyError
ORI_ERR_DI_004	UnresolvableDependencyError	Cannot resolve dependency.	core/oridecon-contracts/src/oridecon/contracts/exceptions/container.py	DependencyError
ORI_ERR_DI_005	RegistrationError	Service registration error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/container.py	ContainerError
ORI_ERR_DI_006	ContainerBuildError	Container build/configuration error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/container.py	ContainerError
ORI_ERR_DI_007	ProtocolValidationError	Protocol validation error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/container.py	ContainerError
ORI_ERR_DI_008	ContainerValidationError	Container dependency graph validation failed before boot. Raised when Container.validate() di…	core/oridecon-contracts/src/oridecon/contracts/exceptions/container.py	ContainerBuildError
ORI_ERR_DI_009	ScopedResolutionError	Attempted to resolve a scoped service outside of an active scope. Raised when a service registere…	core/oridecon-contracts/src/oridecon/contracts/exceptions/container.py	UnresolvableDependencyError
ORI_ERR_DOM_001	DomainError	Business/domain-level errors (validation failures, not found, auth).	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	OrideconError
ORI_ERR_DOM_002	NotFoundError	Resource not found error (domain-level).	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	DomainError
ORI_ERR_DOM_003	PermissionDeniedError	Permission denied error (domain-level).	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	DomainError
ORI_ERR_DOM_004	AuthenticationError	Authentication error (domain-level).	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	DomainError
ORI_ERR_DOM_005	AuthorizationError	Authorization/permission error (domain-level).	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	DomainError
ORI_ERR_DOM_006	RateLimitError	Rate limiting error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	DomainError
ORI_ERR_DOM_007	ConflictError	Resource conflict error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	DomainError
ORI_ERR_EVAL_001	EvaluationError	Base for evaluation system errors. Extended in the AI evaluation layer with specific failures lik…	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_EVT_001	EventError	Base events/messaging error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/events.py	OrideconError
ORI_ERR_EVT_002	HandlerNotFoundError	Event/command handler not found. Raised when no handler is registered for a specific event or com…	core/oridecon-contracts/src/oridecon/contracts/exceptions/events.py	EventError
ORI_ERR_EVT_003	DuplicateHandlerError	Duplicate handler registration. Raised when attempting to register a handler for a type that alre…	core/oridecon-contracts/src/oridecon/contracts/exceptions/events.py	EventError
ORI_ERR_FEAT_001	FeatureFlagError	Base error for the feature flag subsystem.	core/oridecon-contracts/src/oridecon/contracts/exceptions/feature_flags.py	OrideconError
ORI_ERR_GOV_001	GovernanceError	Base class for governance-related errors.	core/oridecon-contracts/src/oridecon/contracts/ai/governance/errors.py	OrideconError
ORI_ERR_GOV_002	BudgetExceededError	Error raised when budget is exceeded.	core/oridecon-contracts/src/oridecon/contracts/ai/governance/errors.py	GovernanceError
ORI_ERR_GOV_003	PolicyViolationError	Error raised when policy is violated.	core/oridecon-contracts/src/oridecon/contracts/ai/governance/errors.py	GovernanceError
ORI_ERR_GOV_010	ResourceExhaustedError	Raised when a resource quota is exhausted.	core/oridecon-contracts/src/oridecon/contracts/ai/governance/resource_unit.py	GovernanceError
ORI_ERR_GUARD_001	GuardError	Base for AI guard/policy enforcement errors. Extended in the AI guard layer with specific failure…	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_GUARD_002	InputGuardError	Error raised during input guard validation.	core/oridecon-contracts/src/oridecon/contracts/ai/guards.py	GuardError
ORI_ERR_GUARD_003	OutputGuardError	Error raised during output guard validation.	core/oridecon-contracts/src/oridecon/contracts/ai/guards.py	GuardError
ORI_ERR_IDEM_001	IdempotencyError	Base exception for idempotency flows.	core/oridecon-contracts/src/oridecon/contracts/exceptions/idempotency.py	OrideconError
ORI_ERR_IDEM_002	DuplicateRequestError	Raised when an idempotent key is reused before completion.	core/oridecon-contracts/src/oridecon/contracts/exceptions/idempotency.py	IdempotencyError
ORI_ERR_IDEM_003	IdempotencyStoreError	Raised on unexpected failures inside the idempotency store.	core/oridecon-contracts/src/oridecon/contracts/exceptions/idempotency.py	IdempotencyError
ORI_ERR_IDEM_004	IdempotencyConflictError	Raised when an idempotency key is already claimed (PENDING).	core/oridecon-contracts/src/oridecon/contracts/exceptions/idempotency.py	IdempotencyError
ORI_ERR_IDX_001	IndexError	Raised when index operations fail in an expected, recoverable way.	core/oridecon-contracts/src/oridecon/contracts/ai/index.py	RAGError
ORI_ERR_INFRA_001	InfrastructureError	System-level failures (DB down, network timeouts).	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	OrideconError
ORI_ERR_INFRA_002	LockError	Distributed lock error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	InfrastructureError
ORI_ERR_INFRA_003	LockConflictError	Raised when a lock conflict occurs (resource already locked).	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	LockError
ORI_ERR_INFRA_004	ComponentError	Base exception for all component-related errors.	core/oridecon-contracts/src/oridecon/contracts/exceptions/components.py	OrideconError
ORI_ERR_INFRA_005	ComponentConnectionError	Raised when a connection to an external service fails.	core/oridecon-contracts/src/oridecon/contracts/exceptions/components.py	InfrastructureError, ComponentError
ORI_ERR_INFRA_006	KeyNotFoundError	Raised when a requested key does not exist.	core/oridecon-contracts/src/oridecon/contracts/exceptions/components.py	NotFoundError, ComponentError
ORI_ERR_INFRA_007	KeyExistsError	Raised when trying to create a key that already exists.	core/oridecon-contracts/src/oridecon/contracts/exceptions/components.py	ConflictError, ComponentError
ORI_ERR_INFRA_008	PubSubError	Base exception for pub/sub operations.	core/oridecon-contracts/src/oridecon/contracts/exceptions/components.py	InfrastructureError, ComponentError
ORI_ERR_INFRA_009	SecretNotFoundError	Raised when a requested secret does not exist.	core/oridecon-contracts/src/oridecon/contracts/exceptions/components.py	NotFoundError, ComponentError
ORI_ERR_INFRA_010	DriverNotAvailableError	Raised when a driver is not available (dependency not installed).	core/oridecon-contracts/src/oridecon/contracts/exceptions/components.py	ComponentError
ORI_ERR_INFRA_011	_StoredStreamError	Internal carrier for propagating typed stream failures.	core/oridecon-contracts/src/oridecon/contracts/infra/streams.py	Exception, Generic[E]
ORI_ERR_LLM_001	LLMError	Base for LLM client errors. Extended in oridecon-ai-llm with specific failures like rate limiting…	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_LOAD_001	LoaderError	Raised when document loading fails in an expected, recoverable way. Extended in oridecon-ai-rag w…	core/oridecon-contracts/src/oridecon/contracts/ai/loaders.py	RAGError
ORI_ERR_LOCK_001	LockAcquisitionError	Raised when acquiring a lock fails.	core/oridecon-contracts/src/oridecon/contracts/exceptions/components.py	LockError, ComponentError
ORI_ERR_LOCK_002	LockNotHeldError	Raised when trying to operate on a lock that is not held.	core/oridecon-contracts/src/oridecon/contracts/exceptions/components.py	LockError, ComponentError
ORI_ERR_MAP_001	MappingError	Object mapping error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	OrideconError
ORI_ERR_MCP_001	MCPError	Base exception for all MCP errors.	core/oridecon-contracts/src/oridecon/contracts/mcp/exceptions.py	OrideconError
ORI_ERR_MCP_002	MCPTransportError	Transport-level error (connection, I/O). Raised when the MCP transport layer encounters errors su…	core/oridecon-contracts/src/oridecon/contracts/mcp/exceptions.py	MCPError
ORI_ERR_MCP_003	MCPToolCallError	Tool call failed during MCP execution. Raised when a tool invocation fails, either due to the too…	core/oridecon-contracts/src/oridecon/contracts/mcp/exceptions.py	MCPError
ORI_ERR_MCP_004	MCPResourceError	Resource read or list failed. Raised when a resource operation fails, such as when a resource is …	core/oridecon-contracts/src/oridecon/contracts/mcp/exceptions.py	MCPError
ORI_ERR_MCP_005	MCPProtocolError	Protocol violation (malformed message, invalid state). Raised when an MCP message violates the pr…	core/oridecon-contracts/src/oridecon/contracts/mcp/exceptions.py	MCPError
ORI_ERR_MCP_006	MCPMethodNotFoundError	Unknown MCP method requested by client. Raised when the client requests an MCP method that the se…	core/oridecon-contracts/src/oridecon/contracts/mcp/exceptions.py	MCPError
ORI_ERR_MCP_007	MCPPromptError	Prompt retrieval or list failed. Raised when a prompt operation fails, such as when a prompt is n…	core/oridecon-contracts/src/oridecon/contracts/mcp/exceptions.py	MCPError
ORI_ERR_MCP_008	MCPInitializationError	MCP server initialization failed. Raised when the MCP server cannot be initialized, usually due t…	core/oridecon-contracts/src/oridecon/contracts/mcp/exceptions.py	MCPError
ORI_ERR_MEM_001	AIMemoryError	Base for AI memory system errors. Extended in oridecon-ai-memory with specific failures like cons…	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_MEM_002	ConsolidationError	Error raised during memory consolidation.	core/oridecon-contracts/src/oridecon/contracts/ai/memory.py	AIMemoryError
ORI_ERR_MEM_003	StorageError	Error raised during memory storage operations.	core/oridecon-contracts/src/oridecon/contracts/ai/memory.py	AIMemoryError
ORI_ERR_MM_001	MultimediaError	Base exception for all multimedia-generation errors. Mirrors AIError(DomainError) — recoverab…	core/oridecon-contracts/src/oridecon/contracts/multimedia/exceptions.py	DomainError
ORI_ERR_MM_002	TTSError	Base for text-to-speech generation errors.	core/oridecon-contracts/src/oridecon/contracts/multimedia/exceptions.py	MultimediaError
ORI_ERR_MM_003	MusicGenerationError	Base for music/sound generation errors.	core/oridecon-contracts/src/oridecon/contracts/multimedia/exceptions.py	MultimediaError
ORI_ERR_MM_004	VideoGenerationError	Base for video generation errors.	core/oridecon-contracts/src/oridecon/contracts/multimedia/exceptions.py	MultimediaError
ORI_ERR_MM_005	ImageGenerationError	Base for still-image generation errors.	core/oridecon-contracts/src/oridecon/contracts/multimedia/exceptions.py	MultimediaError
ORI_ERR_MM_006	ProviderNotInstalledError	Raised eagerly at DI-resolution time when a configured provider’s optional extra is not installed…	core/oridecon-contracts/src/oridecon/contracts/multimedia/exceptions.py	MultimediaError
ORI_ERR_MM_007	UpscaleError	Base for image/video super-resolution errors.	core/oridecon-contracts/src/oridecon/contracts/multimedia/exceptions.py	MultimediaError
ORI_ERR_MM_008	BeatAnalysisError	Base for tempo/beat-detection errors.	core/oridecon-contracts/src/oridecon/contracts/multimedia/exceptions.py	MultimediaError
ORI_ERR_MOD_001	ModuleError	Module configuration or lifecycle error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/provider.py	OrideconError
ORI_ERR_MOD_002	ModuleImportError	A module imports a module that does not exist in the graph. Raised during module compilation when…	core/oridecon-contracts/src/oridecon/contracts/exceptions/provider.py	ModuleError
ORI_ERR_MOD_003	ModuleExportError	A module exports a type not provided by its providers. Raised during post-registration validation…	core/oridecon-contracts/src/oridecon/contracts/exceptions/provider.py	ModuleError
ORI_ERR_MOD_004	ModuleCycleError	Circular dependency detected in the module import graph. Raised during module compilation when a …	core/oridecon-contracts/src/oridecon/contracts/exceptions/provider.py	ModuleError
ORI_ERR_MOD_005	ModuleVisibilityError	A provider depends on a service not visible to its module. Raised when a provider in module A tri…	core/oridecon-contracts/src/oridecon/contracts/exceptions/provider.py	ModuleError
ORI_ERR_MOD_006	ModuleDuplicateError	The same module appears twice with conflicting configurations. Raised when two :class:`DynamicMod…	core/oridecon-contracts/src/oridecon/contracts/exceptions/provider.py	ModuleError
ORI_ERR_MW_001	MiddlewareGuardError	Raised when a middleware guard denies access.	core/oridecon-contracts/src/oridecon/contracts/exceptions/middleware.py	OrideconError
ORI_ERR_NOTIF_001	NotificationError	Base for expected, recoverable notification delivery failures. Attributes: channel: Notification …	core/oridecon-contracts/src/oridecon/contracts/notification/errors.py	DomainError
ORI_ERR_NOTIF_002	MailerError	Base mailer/email notification error.	core/oridecon-contracts/src/oridecon/contracts/mailer/errors.py	DomainError
ORI_ERR_PIPE_001	PipelineExecutionError	Error raised during pipeline execution.	core/oridecon-contracts/src/oridecon/contracts/exceptions/execution.py	OrideconError
ORI_ERR_PIPE_002	PipelineStepError	Error raised by a pipeline step.	core/oridecon-contracts/src/oridecon/contracts/exceptions/execution.py	OrideconError
ORI_ERR_PROV_001	ProviderError	Provider configuration or lifecycle error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/provider.py	OrideconError
ORI_ERR_QE_001	QueryEngineError	Raised when query engine operations fail in an expected, recoverable way.	core/oridecon-contracts/src/oridecon/contracts/ai/index.py	RAGError
ORI_ERR_QUEUE_001	QueueError	Base for expected, recoverable queue / bus failures. Attributes: backend: Name of the queue backe…	core/oridecon-contracts/src/oridecon/contracts/queue/errors.py	DomainError
ORI_ERR_RAG_001	RAGError	Base for RAG pipeline errors. Extended in oridecon-ai-rag with specific failures like retrieval, …	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_RAG_002	RetrievalError	Error raised during document retrieval.	core/oridecon-contracts/src/oridecon/contracts/ai/rag.py	RAGError
ORI_ERR_RAG_003	SynthesisError	Error raised during response synthesis.	core/oridecon-contracts/src/oridecon/contracts/ai/rag.py	RAGError
ORI_ERR_RAG_004	ChunkingError	Error raised during document chunking.	core/oridecon-contracts/src/oridecon/contracts/ai/rag.py	RAGError
ORI_ERR_REG_001	RegistryError	Base exception for registry errors.	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	OrideconError
ORI_ERR_REG_002	RegistryKeyError	Raised when a key is not found in a registry.	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	RegistryError, KeyError
ORI_ERR_REG_003	RegistryAlreadyExistsError	Raised when attempting to register a duplicate key in a registry.	core/oridecon-contracts/src/oridecon/contracts/exceptions/infra.py	RegistryError
ORI_ERR_RESULT_002	UnwrapError	Raised when unwrap() or unwrap_err() is called on the wrong variant. Provides a clearer error typ…	core/oridecon-contracts/src/oridecon/contracts/core/result.py	Exception
ORI_ERR_RES_001	ResilienceError	Base resilience error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/resilience.py	OrideconError
ORI_ERR_RES_002	RetryError	Retry operation error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/resilience.py	ResilienceError
ORI_ERR_RES_003	CircuitBreakerError	Circuit breaker error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/resilience.py	ResilienceError
ORI_ERR_RES_004	BulkheadError	Bulkhead/rejection error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/resilience.py	ResilienceError
ORI_ERR_RES_005	FallbackError	Fallback execution error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/resilience.py	ResilienceError
ORI_ERR_RES_006	RetryExhaustedError	All retry attempts have been exhausted.	core/oridecon-contracts/src/oridecon/contracts/exceptions/resilience.py	RetryError
ORI_ERR_RES_007	CircuitOpenError	Circuit breaker is open and rejecting requests.	core/oridecon-contracts/src/oridecon/contracts/exceptions/resilience.py	CircuitBreakerError
ORI_ERR_RET_001	RetrieverError	Base for retriever errors. Raised when document retrieval fails in an expected, recoverable way (…	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_RUN_001	RunnableError	Recoverable composition failure (input shape, parser error, retry budget exceeded).	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_SEC_001	SecurityError	Base security error for the Oridecon security subsystem.	core/oridecon-contracts/src/oridecon/contracts/exceptions/security.py	OrideconError
ORI_ERR_SEC_002	GuardDeniedError	Raised when a GuardChain denies the request. Attributes: guard: The name or type of the guard tha…	core/oridecon-contracts/src/oridecon/contracts/exceptions/security.py	SecurityError
ORI_ERR_SEC_003	InputSanitizationError	Raised when sanitization fails due to unrecoverable input structure.	core/oridecon-contracts/src/oridecon/contracts/exceptions/security.py	SecurityError
ORI_ERR_SEC_004	CORSViolationError	Raised when a request violates the configured CORS policy. Attributes: origin: The request origin…	core/oridecon-contracts/src/oridecon/contracts/exceptions/security.py	SecurityError
ORI_ERR_SEC_005	SecretAccessError	Raised when the caller lacks permission to access or modify a secret. Attributes: secret_name: Na…	core/oridecon-contracts/src/oridecon/contracts/exceptions/security.py	SecurityError
ORI_ERR_SERIAL_001	SerializationError	Serialization/deserialization error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	OrideconError
ORI_ERR_SES_001	SessionError	Base class for session-related errors.	core/oridecon-contracts/src/oridecon/contracts/ai/session.py	OrideconError
ORI_ERR_SES_002	TaskCancelledError	Error raised when a task is cancelled.	core/oridecon-contracts/src/oridecon/contracts/ai/session.py	OrideconError
ORI_ERR_SES_003	TaskError	Base class for task execution errors.	core/oridecon-contracts/src/oridecon/contracts/ai/session.py	OrideconError
ORI_ERR_SES_004	TaskTimeoutError	Error raised when a task times out.	core/oridecon-contracts/src/oridecon/contracts/ai/session.py	TaskError
ORI_ERR_SES_005	TaskValidationError	Error raised when task input validation fails.	core/oridecon-contracts/src/oridecon/contracts/ai/session.py	TaskError
ORI_ERR_SKILL_001	SkillError	Base for skill execution errors. Extended in oridecon-ai-skills with specific failures like skill…	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_STORE_001	StorageError	Base exception for storage errors.	core/oridecon-contracts/src/oridecon/contracts/infra/storage/exceptions.py	OrideconError
ORI_ERR_STORE_003	StorageUnsupportedOperationError	Raised when the requested operation is not supported by the storage driver.	core/oridecon-contracts/src/oridecon/contracts/infra/storage/exceptions.py	StorageError
ORI_ERR_TASK_001	TaskQueueError	Base class for expected, recoverable task queue failures. All subtypes indicate situations the ca…	core/oridecon-contracts/src/oridecon/contracts/infra/tasks/exceptions.py	DomainError
ORI_ERR_TENANT_001	TenantError	Base class for all tenancy-related domain errors.	core/oridecon-contracts/src/oridecon/contracts/tenancy/errors.py	DomainError
ORI_ERR_TENANT_002	TenantNotFoundError	Raised when a requested tenant does not exist.	core/oridecon-contracts/src/oridecon/contracts/tenancy/errors.py	TenantError
ORI_ERR_TENANT_003	TenantInactiveError	Raised when an operation is attempted on an inactive tenant.	core/oridecon-contracts/src/oridecon/contracts/tenancy/errors.py	TenantError
ORI_ERR_TENANT_004	TenantProvisioningError	Raised when tenant provisioning (isolation setup) fails.	core/oridecon-contracts/src/oridecon/contracts/tenancy/errors.py	TenantError
ORI_ERR_TENANT_005	TenantResolutionError	Raised when tenant resolution fails unexpectedly.	core/oridecon-contracts/src/oridecon/contracts/tenancy/errors.py	TenantError
ORI_ERR_TENANT_006	TenantConfigError	Raised when per-tenant configuration access or mutation fails.	core/oridecon-contracts/src/oridecon/contracts/tenancy/errors.py	TenantError
ORI_ERR_TENANT_007	TenantSlugConflictError	Raised when a tenant slug is already in use.	core/oridecon-contracts/src/oridecon/contracts/tenancy/errors.py	TenantError
ORI_ERR_TENANT_008	TenantSuspendedError	Raised when an operation is attempted on a suspended tenant.	core/oridecon-contracts/src/oridecon/contracts/tenancy/errors.py	TenantError
ORI_ERR_TENANT_009	MigrationError	Raised when a tenant tier migration fails.	core/oridecon-contracts/src/oridecon/contracts/tenancy/errors.py	TenantError
ORI_ERR_VAL_001	FieldError	A single field-level validation error. Used to represent validation failures for individual field…	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	DomainError
ORI_ERR_VAL_002	ValidationError	Data validation error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	DomainError
ORI_ERR_VEC_001	VectorError	Base exception for vector store errors. Extends InfrastructureError because vector operations inv…	core/oridecon-contracts/src/oridecon/contracts/data/vector/exceptions.py	InfrastructureError
ORI_ERR_VEC_002	VectorStoreError	Exception raised during vector store operations (CRUD, search).	core/oridecon-contracts/src/oridecon/contracts/data/vector/exceptions.py	VectorError
ORI_ERR_VEC_003	EmbeddingError	Exception raised during embedding generation or retrieval.	core/oridecon-contracts/src/oridecon/contracts/data/vector/exceptions.py	VectorError
ORI_ERR_VEC_004	VectorIndexError	Exception raised during vector index creation or management.	core/oridecon-contracts/src/oridecon/contracts/data/vector/exceptions.py	VectorError
ORI_ERR_WEBHOOK_001	WebhookError	Base exception for webhook domain operations.	core/oridecon-contracts/src/oridecon/contracts/webhook/exceptions.py	DomainError
ORI_ERR_WEB_001	WebError	Web layer error.	core/oridecon-contracts/src/oridecon/contracts/exceptions/domain.py	DomainError
ORI_ERR_WEB_002	HttpStatusError	Raised by :meth:HttpResponse.raise_for_status for 4xx/5xx responses. Attributes: status: HTTP s…	core/oridecon-contracts/src/oridecon/contracts/web/http_models.py	InfrastructureError
ORI_ERR_WF_001	WorkflowError	Base for workflow execution errors. Raised when a workflow graph execution fails in an expected, …	core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py	AIError
ORI_ERR_WF_002	SagaStepError	Represents a recoverable failure from a single saga step action. SagaProtocol step actions must r…	core/oridecon-contracts/src/oridecon/contracts/workflow/steps.py	Exception
ORI_ERR_WF_009	SagaVersionMismatchError	Raised when a persisted saga state version is incompatible with the current code. Attributes: sag…	core/oridecon-contracts/src/oridecon/contracts/workflow/errors.py	OrideconError

oridecon (45 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_APP_001	AppError	Base exception for all app errors.	core/oridecon/src/oridecon/app/exceptions.py	OrideconError
ORI_ERR_APP_002	AppStartupError	Raised when the application fails to start or a provider fails during boot.	core/oridecon/src/oridecon/app/exceptions.py	AppError
ORI_ERR_APP_003	AppShutdownError	Raised when the application cannot complete a graceful shutdown.	core/oridecon/src/oridecon/app/exceptions.py	AppError
ORI_ERR_CFG_002	ConfigurationError	Configuration loading, parsing, or validation failed. Raised by: - ConfigProvider during init…	core/oridecon/src/oridecon/exceptions.py	OrideconException
ORI_ERR_CFG_003	ConfigSourceError	Raised when a configuration source fails to load its values.	core/oridecon/src/oridecon/config/exceptions.py	ConfigurationError
ORI_ERR_CFG_004	ConfigReloadError	Raised when a live-reload attempt fails.	core/oridecon/src/oridecon/config/exceptions.py	ConfigurationError
ORI_ERR_CFG_005	ConfigSectionNotFoundError	Raised when a required config section is absent from the loaded config.	core/oridecon/src/oridecon/config/exceptions.py	ConfigurationError
ORI_ERR_CFG_006	UnknownConfigKeysError	Raised when a typed config section contains keys its model does not define. Almost always a typo …	core/oridecon/src/oridecon/config/exceptions.py	ConfigurationError
ORI_ERR_CONC_001	ConcurrencyError	Base exception for all concurrency errors.	core/oridecon/src/oridecon/concurrency/exceptions.py	OrideconError
ORI_ERR_CONC_002	AsyncError	Exception raised for errors in asynchronous operations or concurrency control.	core/oridecon/src/oridecon/concurrency/exceptions.py	ConcurrencyError
ORI_ERR_CONC_003	ChannelClosedError	Raised when an operation is attempted on a closed channel.	core/oridecon/src/oridecon/concurrency/exceptions.py	ConcurrencyError
ORI_ERR_CONC_004	ChannelFullError	Raised when sending to a channel that is at capacity.	core/oridecon/src/oridecon/concurrency/exceptions.py	ConcurrencyError
ORI_ERR_CONC_005	DispatcherError	Error in dispatcher execution.	core/oridecon/src/oridecon/concurrency/exceptions.py	ConcurrencyError
ORI_ERR_CONC_006	StructuredParallelismError	Base exception for parallel execution errors.	core/oridecon/src/oridecon/concurrency/exceptions.py	ConcurrencyError
ORI_ERR_CONC_007	TaskGroupError	Raised when a task group encounters an error.	core/oridecon/src/oridecon/concurrency/exceptions.py	StructuredParallelismError
ORI_ERR_CONC_008	CancellationScopeError	Raised when a cancellation scope encounters an error.	core/oridecon/src/oridecon/concurrency/exceptions.py	StructuredParallelismError
ORI_ERR_CORE_002	OrideconException	Base exception for all oridecon domain errors. Extends :class:`~oridecon.contracts.exceptions.bas…	core/oridecon/src/oridecon/exceptions.py	OrideconError
ORI_ERR_CORE_005	CoreError	Base exception for all core errors.	core/oridecon/src/oridecon/primitives/exceptions.py	OrideconError
ORI_ERR_DI_010	InjectionError	Dependency injection or container resolution failed. Raised by: - Container.resolve() when a …	core/oridecon/src/oridecon/exceptions.py	OrideconException
ORI_ERR_DI_011	InterceptorTimeoutError	Raised when a MethodInterceptorProtocol exceeds its configured timeout.	core/oridecon/src/oridecon/di/extensions/aop_interceptors.py	RuntimeError
ORI_ERR_DOM_008	DomainModelError	Domain model invariant violated or business rule broken. Raised by: - Domain event handlers - Agg…	core/oridecon/src/oridecon/exceptions.py	OrideconException
ORI_ERR_DOM_009	DomainPolicyViolationError	Raised when a domain policy evaluation fails. Distinct from PolicyViolationProtocol (the Resu…	core/oridecon/src/oridecon/domain/exceptions.py	OrideconError
ORI_ERR_MAP_002	MappingError	Base exception for all object-mapping errors.	core/oridecon/src/oridecon/mapping/exceptions.py	OrideconError
ORI_ERR_MAP_003	MappingNotFoundError	Raised when no mapper is registered for a (source, destination) type pair.	core/oridecon/src/oridecon/mapping/exceptions.py	MappingError
ORI_ERR_MAP_004	MappingExecutionError	Raised when a registered mapper raises an unexpected error during execution.	core/oridecon/src/oridecon/mapping/exceptions.py	MappingError
ORI_ERR_MW_002	MiddlewareError	Base exception for infrastructure-level middleware errors.	core/oridecon/src/oridecon/middleware/exceptions.py	InfrastructureError
ORI_ERR_MW_003	MiddlewarePolicyError	Base exception for policy-level middleware rejections. Raised when middleware rejects a request b…	core/oridecon/src/oridecon/middleware/exceptions.py	DomainError
ORI_ERR_MW_004	MiddlewareExecutionError	Raised when a middleware raises an unexpected error during execution.	core/oridecon/src/oridecon/middleware/exceptions.py	MiddlewareError
ORI_ERR_MW_005	MiddlewareConfigurationError	Raised when middleware is configured incorrectly.	core/oridecon/src/oridecon/middleware/exceptions.py	MiddlewareError
ORI_ERR_MW_006	MiddlewareChainError	Raised when the middleware chain cannot be assembled or traversed.	core/oridecon/src/oridecon/middleware/exceptions.py	MiddlewareError
ORI_ERR_MW_007	MiddlewareTimeoutError	Raised when a middleware exceeds its configured timeout.	core/oridecon/src/oridecon/middleware/exceptions.py	MiddlewareError
ORI_ERR_MW_008	MiddlewareAuthError	Raised when middleware-level authentication/authorization fails.	core/oridecon/src/oridecon/middleware/exceptions.py	MiddlewarePolicyError
ORI_ERR_MW_009	MiddlewareRateLimitError	Raised when middleware-level rate limiting is exceeded.	core/oridecon/src/oridecon/middleware/exceptions.py	MiddlewarePolicyError
ORI_ERR_MW_010	MiddlewareCircuitOpenError	Raised when the circuit breaker in middleware is open.	core/oridecon/src/oridecon/middleware/exceptions.py	MiddlewareError
ORI_ERR_SEC_006	SecurityError	Base exception for all security-module errors.	core/oridecon/src/oridecon/security/exceptions.py	OrideconError
ORI_ERR_SEC_008	SecretAccessError	Raised when access to a secret is denied.	core/oridecon/src/oridecon/security/exceptions.py	SecretError
ORI_ERR_SEC_009	EncryptionError	Raised when field-level encryption fails.	core/oridecon/src/oridecon/security/exceptions.py	SecurityError
ORI_ERR_SEC_010	DecryptionError	Raised when field-level decryption fails.	core/oridecon/src/oridecon/security/exceptions.py	SecurityError
ORI_ERR_SEC_011	SecretError	Base exception for secret store errors.	core/oridecon/src/oridecon/security/exceptions.py	SecurityError
ORI_ERR_SERIAL_002	SerializationError	JSON serialisation or deserialisation failed. Raised by: - JsonSerializer implementations - D…	core/oridecon/src/oridecon/exceptions.py	OrideconException
ORI_ERR_SERIAL_003	SerializationError	Base exception for serialization and deserialization failures. Extensions should subclass this fo…	core/oridecon/src/oridecon/serialization/exceptions.py	OrideconError
ORI_ERR_SERIAL_004	NegotiationError	Raised when no serializer can be negotiated for a given Accept header.	core/oridecon/src/oridecon/serialization/exceptions.py	SerializationError
ORI_ERR_VAL_003	ValidationError	Input validation against rules failed. Raised by: - ValidatorImpl.validate() when rules do no…	core/oridecon/src/oridecon/exceptions.py	OrideconException
ORI_ERR_VAL_004	ValidationSystemError	Base exception for validation system/pipeline failures. Distinct from :class:`~oridecon.contracts…	core/oridecon/src/oridecon/validation/exceptions.py	OrideconError
ORI_ERR_WF_019	SagaError	Raised when a saga step fails after compensation has been attempted. Attributes: step_name: Name …	core/oridecon/src/oridecon/saga/base.py	OrideconError

oridecon-admin (31 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_ADMIN_002	AdminError	Base exception for all admin errors.	experimental/apps/oridecon-admin/src/oridecon/admin/exceptions.py	OrideconError
ORI_ERR_ADMIN_003	NotFoundError	Raised when a resource is not found.	experimental/apps/oridecon-admin/src/oridecon/admin/exceptions.py	DomainError
ORI_ERR_ADMIN_004	PermissionDeniedError	Raised when permission is denied.	experimental/apps/oridecon-admin/src/oridecon/admin/exceptions.py	DomainError
ORI_ERR_ADMIN_005	ConflictError	Raised when a resource conflict occurs.	experimental/apps/oridecon-admin/src/oridecon/admin/exceptions.py	DomainError
ORI_ERR_ADMIN_006	AdminValidationError	Raised when validation fails.	experimental/apps/oridecon-admin/src/oridecon/admin/exceptions.py	BaseValidationError
ORI_ERR_ADMIN_007	DataError	Raised when a data source or database error occurs in admin.	experimental/apps/oridecon-admin/src/oridecon/admin/exceptions.py	DomainError
ORI_ERR_ADMIN_008	AdminDataError	Raised when a storage/database operation fails. Translates low-level database exceptions to a dom…	experimental/apps/oridecon-admin/src/oridecon/admin/exceptions.py	AdminError
ORI_ERR_ADMIN_009	NotificationError	Raised when a notification fails to send.	experimental/apps/oridecon-admin/src/oridecon/admin/exceptions.py	DomainError
ORI_ERR_ADMIN_010	AdminAuthError	Base exception for all admin authentication errors.	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	DomainError
ORI_ERR_ADMIN_011	InvalidCredentialsError	Raised when email/password combination is incorrect.	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	AdminAuthError
ORI_ERR_ADMIN_012	AccountLockedError	Raised when an account is temporarily or permanently locked. Args: message: Human-readable descri…	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	AdminAuthError
ORI_ERR_ADMIN_013	RateLimitExceededError	Raised when the IP-based rate limit is exceeded. Args: message: Human-readable description. retry…	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	AdminAuthError
ORI_ERR_ADMIN_014	SessionNotFoundError	Raised when the requested session does not exist.	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	AdminAuthError
ORI_ERR_ADMIN_015	SessionExpiredError	Raised when the session has exceeded its idle or absolute timeout.	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	AdminAuthError
ORI_ERR_ADMIN_016	CsrfValidationError	Raised when CSRF token is missing, invalid, or expired.	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	AdminAuthError
ORI_ERR_ADMIN_017	PasswordPolicyError	Raised when a password does not meet policy requirements.	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	AdminAuthError
ORI_ERR_ADMIN_018	SetupAlreadyCompletedError	Raised when setup is attempted after an admin account already exists.	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	AdminAuthError
ORI_ERR_ADMIN_019	SetupTokenInvalidError	Raised when the ADMIN_SETUP_TOKEN env var is set and the provided token doesn’t match.	experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py	AdminAuthError
ORI_ERR_ADMIN_020	ContributorPermissionError	Raised when a user lacks required permissions to execute a contributor action. Contains the contr…	experimental/apps/oridecon-admin/src/oridecon/admin/contributors/exceptions.py	AdminError
ORI_ERR_ADMIN_021	ContributorNotFoundError	Raised when a contributor ID cannot be found in the assembled dashboard. Args: contributor_id: Th…	experimental/apps/oridecon-admin/src/oridecon/admin/contributors/exceptions.py	AdminError
ORI_ERR_ADMIN_022	AdminError	Admin operation error with structured response.	experimental/apps/oridecon-admin/src/oridecon/admin/core/middleware.py	CoreAdminError
ORI_ERR_ADMIN_023	LockError	Base lock error.	experimental/apps/oridecon-admin/src/oridecon/admin/core/distributed_lock.py	CoreLockError
ORI_ERR_ADMIN_024	LockAcquisitionError	Could not acquire lock — another process holds it.	experimental/apps/oridecon-admin/src/oridecon/admin/core/distributed_lock.py	LockError
ORI_ERR_ADMIN_025	LockTimeoutError	Lock acquisition timed out waiting for the lock to be released.	experimental/apps/oridecon-admin/src/oridecon/admin/core/distributed_lock.py	LockError
ORI_ERR_ADMIN_026	LockConflictError	Raised when trying to acquire a lock already held by another user.	experimental/apps/oridecon-admin/src/oridecon/admin/services/collaborative.py	RuntimeError
ORI_ERR_ADMIN_027	FeatureDisabledError	Raised when a required admin feature is disabled.	experimental/apps/oridecon-admin/src/oridecon/admin/services/feature_flags.py	ConfigurationError
ORI_ERR_ADMIN_028	JobNotFoundError	Raised when a job_id is not found in the queue.	experimental/apps/oridecon-admin/src/oridecon/admin/services/background_jobs.py	KeyError
ORI_ERR_ADMIN_029	AsyncValidationError	Raised when async validation fails.	experimental/apps/oridecon-admin/src/oridecon/admin/forms/async_validation.py	CoreValidationError
ORI_ERR_ADMIN_030	TenantNotFoundError	Raised when a tenant is not found in the registry.	experimental/apps/oridecon-admin/src/oridecon/admin/multitenancy/models.py	KeyError
ORI_ERR_ADMIN_ACTION_001	ActionError	Base exception for all action-related errors.	experimental/apps/oridecon-admin/src/oridecon/admin/actions/exceptions.py	AdminError
ORI_ERR_ADMIN_ACTION_002	PermissionDenied	Raised when a user lacks permission to execute an action.	experimental/apps/oridecon-admin/src/oridecon/admin/actions/exceptions.py	ActionError

oridecon-ai (1 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_AI_005	AIError	Base exception for oridecon-ai.	experimental/ai/oridecon-ai/src/oridecon/ai/exceptions.py	_ContractsAIError

oridecon-ai-agents (8 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_AGT_004	AgentConfigurationError	Invalid agent configuration. Raised when an agent is constructed with invalid parameters (no tool…	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/exceptions.py	AgentError
ORI_ERR_AGT_005	AgentExecutionError	Agent execution failed. Raised when the agent’s reasoning loop encounters an unrecoverable error …	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/exceptions.py	AgentError
ORI_ERR_AGT_006	ToolNotFoundError	Tool not found in registry. Raised when the agent tries to call a tool that is not registered in …	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/exceptions.py	ToolError
ORI_ERR_AGT_007	ToolExecutionError	Tool execution failed. Raised when a tool raises an exception during execution.	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/exceptions.py	ToolError
ORI_ERR_AGT_008	ToolAccessDeniedError	Agent does not have access to this tool. Raised when module visibility controls prevent an agent …	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/exceptions.py	ToolError
ORI_ERR_AGT_009	MaxIterationsExceededError	Agent exceeded maximum reasoning iterations. Raised when the agent reaches max_iterations without…	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/exceptions.py	StrategyError
ORI_ERR_AGT_010	BudgetExceededError	Agent exceeded its AI governance budget. Raised when token usage or cost exceeds configured limit…	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/exceptions.py	AgentError
ORI_ERR_AGT_011	ToolValidationError	Tool input validation failed. Raised when the arguments provided to a tool fail schema validation…	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/exceptions.py	ToolError

oridecon-ai-feedback (5 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_FEED_001	FeedbackError	Base exception for all feedback-related errors.	experimental/ai/oridecon-ai-feedback/src/oridecon/ai/feedback/exceptions.py	AIError
ORI_ERR_FEED_002	FeedbackProcessingError	Raised when a feedback processor fails.	experimental/ai/oridecon-ai-feedback/src/oridecon/ai/feedback/exceptions.py	FeedbackError
ORI_ERR_FEED_003	FeedbackValidationError	Raised when feedback data fails validation.	experimental/ai/oridecon-ai-feedback/src/oridecon/ai/feedback/exceptions.py	FeedbackError
ORI_ERR_FEED_004	FeedbackAuthorizationError	Raised when the endpoint’s authorization callback denies a submission.	experimental/ai/oridecon-ai-feedback/src/oridecon/ai/feedback/exceptions.py	FeedbackError
ORI_ERR_FEED_005	FeedbackTooLargeError	Raised when a payload exceeds MAX_FEEDBACK_TEXT_LENGTH or MAX_CONTEXT_SIZE.	experimental/ai/oridecon-ai-feedback/src/oridecon/ai/feedback/exceptions.py	FeedbackValidationError

oridecon-ai-governance (3 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_GOV_006	RateLimitExceededError	Raised when RPM or TPM limits are exceeded. Attributes: limit: Configured limit value. current: C…	experimental/ai/oridecon-ai-governance/src/oridecon/ai/governance/exceptions.py	GovernanceError
ORI_ERR_GOV_007	ModelAccessDeniedError	Raised when a user is denied access to a model by policy. Attributes: model: Model identifier tha…	experimental/ai/oridecon-ai-governance/src/oridecon/ai/governance/exceptions.py	GovernanceError
ORI_ERR_GOV_008	GovernancePersistenceError	Raised when a governance persistence backend is unavailable. Raised by :class:`~oridecon.ai.gover…	experimental/ai/oridecon-ai-governance/src/oridecon/ai/governance/exceptions.py	GovernanceError

oridecon-ai-guard (3 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_GUARD_004	GuardError	Base exception for all guard-related errors.	experimental/ai/oridecon-ai-guard/src/oridecon/ai/guard/exceptions.py	_ContractsGuardError
ORI_ERR_GUARD_005	GuardConfigurationError	Raised when a guard is misconfigured at boot time.	experimental/ai/oridecon-ai-guard/src/oridecon/ai/guard/exceptions.py	GuardError
ORI_ERR_GUARD_006	GuardPipelineError	Raised when the guard pipeline encounters an unrecoverable error.	experimental/ai/oridecon-ai-guard/src/oridecon/ai/guard/exceptions.py	GuardError

oridecon-ai-llm (25 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_LLM_002	LLMError	Base exception for all LLM-domain errors in oridecon-ai-llm.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	_ContractsLLMError
ORI_ERR_LLM_003	LLMAuthenticationError	Invalid API key or credentials — infrastructure error, raised not wrapped. Raised as an exception…	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_004	InvalidRequestError	Error raised when a request to an LLM provider is invalid.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_005	ModelNotFoundError	Model unavailable or not found — recoverable via fallback routing.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_006	LLMModelNotFoundError	Model unavailable or not found — recoverable via fallback routing. Returned as Err from “LLM…	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	ModelNotFoundError
ORI_ERR_LLM_007	LLMRateLimitError	Rate limit exceeded — recoverable via backoff/retry. Returned as Err from “LLMClientProtocol…	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_008	LLMQuotaExceededError	API quota or billing limit exceeded — recoverable by routing elsewhere. Returned as Err from …	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_009	LLMContentFilterError	Content blocked by provider safety filter — recoverable via reformulation. Returned as Err fr…	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_010	TokenLimitError	Error raised when the token limit for a request is exceeded.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_011	ProviderConnectionError	Error raised when connection to an LLM provider fails.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_012	StreamError	Error raised during LLM response streaming.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_013	ExtractionError	Base class for structured extraction errors in oridecon-ai-llm.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	_ContractsExtractionError
ORI_ERR_LLM_014	ExtractionParseError	Error raised when extraction response cannot be parsed as JSON.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	ExtractionError
ORI_ERR_LLM_015	ExtractionValidationError	Error raised when parsed extraction response fails schema validation.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	ExtractionError
ORI_ERR_LLM_016	ExtractionMaxRetriesError	Error raised when extraction max retries are exhausted.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	ExtractionError
ORI_ERR_LLM_017	ModelRevisionMismatchError	Raised when the provider returns a model revision that violates the pin policy.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_018	LLMTimeoutError	Request exceeded the client timeout — recoverable by routing elsewhere. Returned as Err from …	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py	LLMError
ORI_ERR_LLM_019	SchemaValidationError	Raised when parsed response fails validation.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/structured/exceptions.py	StructuredOutputError
ORI_ERR_LLM_020	ModelManagerError	Base exception for model manager errors.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/model_manager/types.py	LLMError
ORI_ERR_LLM_021	ModelNotFoundError	Raised when a requested model is not found.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/model_manager/types.py	ModelManagerError, BaseModelNotFoundError
ORI_ERR_LLM_022	ModelLoadError	Raised when a model fails to load.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/model_manager/types.py	ModelManagerError
ORI_ERR_LLM_023	ModelUnloadError	Raised when a model fails to unload.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/model_manager/types.py	ModelManagerError
ORI_ERR_LLM_024	ProviderConnectionError	Raised when connection to provider fails.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/model_manager/types.py	ModelManagerError, BaseProviderConnectionError
ORI_ERR_LLM_025	OrchestratorError	Base orchestration error.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/routing/orchestrator.py	LLMError
ORI_ERR_LLM_026	NoSuitableModelError	No model found that meets the requirements.	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/routing/orchestrator.py	OrchestratorError

oridecon-ai-memory (5 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_MEM_005	MemorySystemError	Base exception for memory operations.	experimental/ai/oridecon-ai-memory/src/oridecon/ai/memory/exceptions.py	_ContractsAIMemoryError
ORI_ERR_MEM_006	MemoryStoreError	Raised when a backend store operation fails.	experimental/ai/oridecon-ai-memory/src/oridecon/ai/memory/exceptions.py	MemorySystemError
ORI_ERR_MEM_008	MemoryCapacityError	Raised when a memory store is at capacity and cannot accept new entries.	experimental/ai/oridecon-ai-memory/src/oridecon/ai/memory/exceptions.py	MemorySystemError
ORI_ERR_MEM_009	EmbeddingError	Raised when generating or storing an embedding fails.	experimental/ai/oridecon-ai-memory/src/oridecon/ai/memory/exceptions.py	MemorySystemError
ORI_ERR_MEM_010	FactExtractionError	Raised when entity/fact extraction from text fails.	experimental/ai/oridecon-ai-memory/src/oridecon/ai/memory/exceptions.py	MemorySystemError

oridecon-ai-observability (4 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_OBS_001	ObservabilityError	Base exception for all observability-related errors.	experimental/ai/oridecon-ai-observability/src/oridecon/ai/observability/exceptions.py	AIError
ORI_ERR_OBS_002	HealthCheckError	Raised when a health check infrastructure operation fails.	experimental/ai/oridecon-ai-observability/src/oridecon/ai/observability/exceptions.py	ObservabilityError
ORI_ERR_OBS_003	MetricsError	Raised when a metrics recording or retrieval operation fails.	experimental/ai/oridecon-ai-observability/src/oridecon/ai/observability/exceptions.py	ObservabilityError
ORI_ERR_OBS_004	TracingError	Raised when a tracing operation fails.	experimental/ai/oridecon-ai-observability/src/oridecon/ai/observability/exceptions.py	ObservabilityError

oridecon-ai-prompt (7 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_PROMPT_001	PromptError	Base exception for all prompt-related errors.	experimental/ai/oridecon-ai-prompt/src/oridecon/ai/prompt/exceptions.py	_ContractsAIError
ORI_ERR_PROMPT_002	PromptRenderError	Raised when a template cannot be rendered. Common causes: missing required variable, type mismatc…	experimental/ai/oridecon-ai-prompt/src/oridecon/ai/prompt/exceptions.py	PromptError
ORI_ERR_PROMPT_003	PromptValidationError	Raised when a variable fails validation (type, length, allowed values).	experimental/ai/oridecon-ai-prompt/src/oridecon/ai/prompt/exceptions.py	PromptError
ORI_ERR_PROMPT_004	PromptNotFoundError	Raised when a named template is not found in the registry.	experimental/ai/oridecon-ai-prompt/src/oridecon/ai/prompt/exceptions.py	PromptError
ORI_ERR_PROMPT_005	PromptVersionError	Raised on version conflicts or invalid rollback targets.	experimental/ai/oridecon-ai-prompt/src/oridecon/ai/prompt/exceptions.py	PromptError
ORI_ERR_PROMPT_006	PromptConfigError	Raised when the prompt configuration is invalid.	experimental/ai/oridecon-ai-prompt/src/oridecon/ai/prompt/exceptions.py	PromptError
ORI_ERR_PROMPT_007	OptimizationError	Raised when prompt optimization fails.	experimental/ai/oridecon-ai-prompt/src/oridecon/ai/prompt/exceptions.py	PromptError

oridecon-ai-rag (10 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_RAG_005	RAGError	Base exception for RAG errors.	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/exceptions.py	_ContractsRAGError
ORI_ERR_RAG_006	PreprocessingError	Raised when document preprocessing fails.	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/exceptions.py	RAGError
ORI_ERR_RAG_010	MultimodalError	Base exception for multimodal processing errors.	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/exceptions.py	RAGError
ORI_ERR_RAG_011	AudioLoaderError	Raised when audio loading fails.	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/exceptions.py	MultimodalError
ORI_ERR_RAG_012	VideoLoaderError	Raised when video loading fails.	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/exceptions.py	MultimodalError
ORI_ERR_RAG_013	ImageLoaderError	Raised when image loading fails.	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/exceptions.py	MultimodalError
ORI_ERR_RAG_014	CLIPEmbeddingError	Raised when CLIP embedding computation fails.	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/exceptions.py	MultimodalError
ORI_ERR_RAG_015	MissingCitationsError	Raised when a pipeline with require_citations=True produces no citations.	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/exceptions.py	RAGError
ORI_ERR_RAG_016	UnsupportedFormatError	Raised when no loader is registered for the given file format or URL.	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/loaders/registry.py	RAGError
ORI_ERR_RAG_017	MissingOptionalDependencyError	—	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/deps/optional.py	ImportError

oridecon-ai-session (7 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_SES_006	SessionError	Base error for all session operations. All session-specific exceptions inherit from this class.	experimental/ai/oridecon-ai-session/src/oridecon/ai/session/exceptions.py	_ContractsSessionError
ORI_ERR_SES_007	SessionNotFoundError	Raised when a session cannot be found by its ID. Args: session_id: The ID of the session that was…	experimental/ai/oridecon-ai-session/src/oridecon/ai/session/exceptions.py	SessionError
ORI_ERR_SES_008	SessionClosedError	Raised when an operation is attempted on a closed session. Args: session_id: The ID of the closed…	experimental/ai/oridecon-ai-session/src/oridecon/ai/session/exceptions.py	SessionError
ORI_ERR_SES_009	SessionExpiredError	Raised when an operation is attempted on an expired session. Args: session_id: The ID of the expi…	experimental/ai/oridecon-ai-session/src/oridecon/ai/session/exceptions.py	SessionError
ORI_ERR_SES_010	CheckpointNotFoundError	Raised when a checkpoint cannot be found by its ID. Args: checkpoint_id: The ID of the checkpoint…	experimental/ai/oridecon-ai-session/src/oridecon/ai/session/exceptions.py	SessionError
ORI_ERR_SES_011	SessionTransitionError	Raised when an invalid state transition is attempted. Args: session_id: The session ID. from_stat…	experimental/ai/oridecon-ai-session/src/oridecon/ai/session/exceptions.py	SessionError
ORI_ERR_SES_012	SessionCapacityError	Raised when a session limit is exceeded. Args: detail: Human-readable description of the exceeded…	experimental/ai/oridecon-ai-session/src/oridecon/ai/session/exceptions.py	SessionError

oridecon-ai-skills (7 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_SKILL_002	SkillNotFoundError	Raised when a requested skill is not registered.	experimental/ai/oridecon-ai-skills/src/oridecon/ai/skills/exceptions.py	SkillError
ORI_ERR_SKILL_003	SkillAlreadyRegisteredError	Raised when a skill is registered under a name that already exists.	experimental/ai/oridecon-ai-skills/src/oridecon/ai/skills/exceptions.py	SkillError
ORI_ERR_SKILL_004	SkillValidationError	Raised when skill parameter validation fails.	experimental/ai/oridecon-ai-skills/src/oridecon/ai/skills/exceptions.py	SkillError
ORI_ERR_SKILL_005	SkillPermissionDeniedError	Raised when the caller lacks required permissions for a skill.	experimental/ai/oridecon-ai-skills/src/oridecon/ai/skills/exceptions.py	SkillError
ORI_ERR_SKILL_006	SkillTimeoutError	Raised when skill execution exceeds the configured timeout.	experimental/ai/oridecon-ai-skills/src/oridecon/ai/skills/exceptions.py	SkillError
ORI_ERR_SKILL_007	SkillRoutingError	Raised when a SkillRouter finds no matching route.	experimental/ai/oridecon-ai-skills/src/oridecon/ai/skills/exceptions.py	SkillError
ORI_ERR_SKILL_008	SkillExecutionError	Raised when a skill execution fails after all retry attempts.	experimental/ai/oridecon-ai-skills/src/oridecon/ai/skills/exceptions.py	SkillError

oridecon-ai-workers (3 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_AIWORK_001	WorkerError	Base exception for all worker-related errors.	experimental/ai/oridecon-ai-workers/src/oridecon/ai/workers/exceptions.py	AIError
ORI_ERR_AIWORK_002	DLQError	Raised when a Dead Letter Queue operation fails.	experimental/ai/oridecon-ai-workers/src/oridecon/ai/workers/exceptions.py	WorkerError
ORI_ERR_AIWORK_003	MaintenanceError	Raised when a maintenance task operation fails.	experimental/ai/oridecon-ai-workers/src/oridecon/ai/workers/exceptions.py	WorkerError

oridecon-audit (4 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_AUDIT_001	AuditError	Base exception for all audit-domain errors.	packages/oridecon-audit/src/oridecon/audit/exceptions.py	DomainError
ORI_ERR_AUDIT_002	AuditStoreError	Raised when the audit store fails to persist or query entries.	packages/oridecon-audit/src/oridecon/audit/exceptions.py	AuditError
ORI_ERR_AUDIT_003	AuditVerificationError	Raised when audit trail verification encounters an unexpected failure.	packages/oridecon-audit/src/oridecon/audit/exceptions.py	AuditError
ORI_ERR_AUDIT_004	AuditRetentionError	Raised when a retention purge fails.	packages/oridecon-audit/src/oridecon/audit/exceptions.py	AuditError

oridecon-auth (26 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_AUTH_004	AuthError	Base exception for all auth errors.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	ContractsAuthError
ORI_ERR_AUTH_005	AuthenticationError	Raised when authentication fails.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	OrideconAuthenticationError, AuthError
ORI_ERR_AUTH_006	AuthorizationError	Raised when user lacks required permissions.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	OrideconAuthorizationError, AuthError
ORI_ERR_AUTH_007	InvalidCredentialsError	Raised when credentials are invalid.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	AuthenticationError
ORI_ERR_AUTH_008	AccountLockedError	Raised when an account is locked due to too many failed login attempts. Accounts are locked autom…	packages/oridecon-auth/src/oridecon/auth/exceptions.py	AuthenticationError
ORI_ERR_AUTH_009	UserNotFoundError	Raised when user is not found.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	OrideconNotFoundError, AuthError
ORI_ERR_AUTH_010	TokenError	Base exception for token-related errors.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	InvalidCredentialsError
ORI_ERR_AUTH_011	InvalidTokenError	Raised when a token is malformed or invalid.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	TokenError
ORI_ERR_AUTH_012	TokenExpiredError	Raised when a token has expired.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	TokenError
ORI_ERR_AUTH_013	TokenBlacklistedError	Token has been explicitly revoked.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	TokenError
ORI_ERR_AUTH_014	TokenInvalidError	Token is structurally invalid or has wrong type.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	TokenError
ORI_ERR_AUTH_015	TokenAudienceError	Token audience claim does not match expected.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	TokenError
ORI_ERR_AUTH_016	TokenNotFoundError	Token record does not exist.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	TokenError
ORI_ERR_AUTH_017	InvalidAudienceError	Raised when a token audience is invalid.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	TokenError
ORI_ERR_AUTH_018	InvalidScopeError	Raised when a token lacks required scope.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	TokenError
ORI_ERR_AUTH_019	BlacklistedTokenError	Raised when a token has been blacklisted.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	TokenError
ORI_ERR_AUTH_020	TokenExpiredVerificationError	Account verification has expired.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	VerificationError
ORI_ERR_AUTH_021	AlreadyVerifiedError	Account is already verified.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	VerificationError
ORI_ERR_AUTH_022	EmailExistsError	Raised when email is already taken.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	AuthError, ConflictError
ORI_ERR_AUTH_023	UsernameExistsError	Raised when username is already taken.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	AuthError, ConflictError
ORI_ERR_AUTH_024	PasswordPolicyError	Raised when password doesn’t meet requirements.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	AuthError
ORI_ERR_AUTH_025	OAuth2Error	Base exception for OAuth2 errors.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	AuthError
ORI_ERR_AUTH_026	SessionNotFoundError	Raised when a session cannot be found in the store.	packages/oridecon-auth/src/oridecon/auth/exceptions.py	OrideconNotFoundError, AuthError
ORI_ERR_AUTH_027	AccountVerificationError	Error during account verification operations.	packages/oridecon-auth/src/oridecon/auth/authn/account_verification.py	Exception
ORI_ERR_AUTH_028	PasswordResetTokenError	Error during password reset token operations.	packages/oridecon-auth/src/oridecon/auth/authn/password_reset.py	Exception
ORI_ERR_SEC_012	RateLimitExceededError	Raised when a client has exceeded the configured rate limit. Carries retry_after (seconds) so…	packages/oridecon-auth/src/oridecon/auth/web/middleware/throttle.py	Exception

oridecon-cache (12 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_CACHE_004	CacheError	Base exception for cache errors.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	OrideconError
ORI_ERR_CACHE_005	CacheBackendError	Raised when the cache backend (Redis/Memcached) fails.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	CacheError
ORI_ERR_CACHE_006	CacheConnectionError	Raised when the cache connection fails.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	CacheBackendError
ORI_ERR_CACHE_007	CacheTimeoutError	Raised when a cache operation times out.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	CacheError
ORI_ERR_CACHE_008	CacheKeyError	Raised when a cache key is invalid or for key-specific errors.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	CacheError
ORI_ERR_CACHE_009	CacheConfigurationError	Raised when cache configuration is invalid.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	CacheError
ORI_ERR_CACHE_010	CacheStampedeError	Raised when cache stampede protection fails.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	CacheError
ORI_ERR_CACHE_011	CacheInvalidationError	Raised when cache invalidation fails.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	CacheError
ORI_ERR_CACHE_012	LockAcquisitionError	Raised when a distributed lock cannot be acquired.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	CacheError
ORI_ERR_CACHE_013	CacheSerializationError	Raised when serialization/deserialization fails.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	SerializationError, CacheError
ORI_ERR_CACHE_014	CacheCapacityError	Raised when the cache is at capacity.	packages/oridecon-cache/src/oridecon/cache/exceptions.py	CacheError
ORI_ERR_CACHE_015	CacheSerializationError	Raised when cache serialization or deserialization fails. This is a cache-specific subclass of th…	packages/oridecon-cache/src/oridecon/cache/serialization/base.py	SerializationError

oridecon-cli (3 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_CLI_001	CliError	Base exception for oridecon-cli operations.	experimental/apps/oridecon-cli/src/oridecon/cli/exceptions.py	OrideconError
ORI_ERR_CLI_002	ConfigNotFoundError	Raised when application.yaml configuration file is not found.	experimental/apps/oridecon-cli/src/oridecon/cli/exceptions.py	CliError
ORI_ERR_CLI_003	ProviderNotInstalledError	Raised when a required provider package is not installed.	experimental/apps/oridecon-cli/src/oridecon/cli/exceptions.py	CliError

oridecon-events (20 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_EVT_004	ConcurrencyError	Concurrency/optimistic locking error. Raised when event version conflicts indicate concurrent mod…	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_005	CommandExecutionError	Command execution error.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_006	QueryExecutionError	Query execution error.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_007	StreamNotFoundError	Raised when stream is not found. Parameters mirror the helper used in tests: (stream_type, stream…	packages/oridecon-events/src/oridecon/events/exceptions.py	DomainError
ORI_ERR_EVT_008	EventHandlerError	Raised when event handling fails.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_009	AggregateNotFoundError	Raised when aggregate is not found.	packages/oridecon-events/src/oridecon/events/exceptions.py	NotFoundError
ORI_ERR_EVT_010	AdapterConnectionError	Raised when adapter connection fails.	packages/oridecon-events/src/oridecon/events/exceptions.py	InfrastructureError
ORI_ERR_EVT_011	EventLoadError	Raised when event loading fails.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_012	EventPersistenceError	Raised when event persistence fails.	packages/oridecon-events/src/oridecon/events/exceptions.py	InfrastructureError, EventError
ORI_ERR_EVT_013	EventStoreError	Raised for event store errors.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_014	EventStoreConnectionError	Raised when event store connection fails.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventStoreError, AdapterConnectionError
ORI_ERR_EVT_015	ProjectionBuildError	Raised when projection building fails.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_016	ProjectionRebuildError	Raised when projection rebuilding fails (alias for collection stability).	packages/oridecon-events/src/oridecon/events/exceptions.py	ProjectionBuildError
ORI_ERR_EVT_017	ProjectionNotFoundError	Raised when a projection is not found.	packages/oridecon-events/src/oridecon/events/exceptions.py	NotFoundError
ORI_ERR_EVT_018	WebhookDeliveryError	Raised when an outbound webhook delivery fails after all retry attempts. Carries the target url…	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_019	SchemaError	Raised for schema-related errors.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_020	SecurityError	Raised for security-related errors.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_021	StreamingError	Raised for streaming-related errors.	packages/oridecon-events/src/oridecon/events/exceptions.py	EventError
ORI_ERR_EVT_022	SchemaIncompatibleError	Raised when a schema is not compatible with previous version.	packages/oridecon-events/src/oridecon/events/schema/models.py	EventError
ORI_ERR_EVT_023	SchemaNotFoundError	Raised when a schema is not found.	packages/oridecon-events/src/oridecon/events/schema/models.py	EventError

oridecon-features (3 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_FEAT_002	FlagNotFoundError	Raised when a requested feature flag does not exist in any provider. Attributes: flag_key: The ke…	packages/oridecon-features/src/oridecon/features/exceptions.py	FeatureFlagError
ORI_ERR_FEAT_003	FlagEvaluationError	Raised when a flag provider fails during evaluation. Attributes: flag_key: The key of the flag th…	packages/oridecon-features/src/oridecon/features/exceptions.py	FeatureFlagError
ORI_ERR_FEAT_004	FeatureFlagDisabledError	Raised when a feature-guarded path is called with the flag disabled.	packages/oridecon-features/src/oridecon/features/exceptions.py	FeatureFlagError

oridecon-graph (12 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_GRAPH_001	GraphError	Base exception for all graph store operations.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	InfrastructureError
ORI_ERR_GRAPH_002	GraphConnectionError	Failed to connect to the graph store.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_003	GraphNotFoundError	Requested graph database does not exist.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_004	GraphAlreadyExistsError	Attempted to create a graph that already exists.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_005	GraphNodeNotFoundError	Referenced node does not exist.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_006	GraphEdgeNotFoundError	Referenced edge does not exist.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_007	DetachRequiredError	Node has edges and detach=False was specified.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_008	TraversalError	Traversal query failed.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_009	CypherCompilationError	Failed to compile a traversal query to Cypher.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_010	GraphSchemaError	Schema operation (index, constraint) failed.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_011	GraphTransactionError	Graph transaction failed.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError
ORI_ERR_GRAPH_012	GraphQueryError	Raw query execution failed.	packages/oridecon-graph/src/oridecon/graph/exceptions.py	GraphError

oridecon-graphql (15 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_GQL_001	GraphQLError	Base exception for all GraphQL errors.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	OrideconError
ORI_ERR_GQL_002	ExecutionError	Raised when execution fails.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_003	GraphQLTimeoutError	Raised when execution times out.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	ExecutionError
ORI_ERR_GQL_004	QueryTooDeepError	Raised when a GraphQL query exceeds the maximum depth.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_005	InputGraphQLError	Raised for invalid user input.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_006	ParseError	Raised when query parsing fails.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_007	QueryTooComplexError	Raised when query exceeds complexity limit.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_008	ResolverError	Raised when a resolver fails.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_009	AuthenticationError	Raised when authentication is required but missing. Also satisfies “oridecon.contracts.exception…	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError, _ContractsAuthenticationError
ORI_ERR_GQL_010	AuthorizationError	Raised when user is authenticated but lacks permissions. Also satisfies “oridecon.contracts.exce…	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError, _ContractsAuthorizationError
ORI_ERR_GQL_011	ForbiddenError	Raised when access is forbidden.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_012	NotFoundError	Raised when a requested resource is not found.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_013	RateLimitError	Raised when rate limit is exceeded.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_014	SubscriptionError	Raised for subscription-related errors.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError
ORI_ERR_GQL_015	GraphQLConnectionError	Raised when a network connection error occurs during GraphQL execution.	packages/oridecon-graphql/src/oridecon/graphql/exceptions.py	GraphQLError

oridecon-http (8 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_HTTP_001	HTTPClientError	Base exception for all HTTP client errors.	packages/oridecon-http/src/oridecon/http/exceptions.py	InfrastructureError
ORI_ERR_HTTP_002	HTTPConnectionError	Raised when a connection to a remote host fails.	packages/oridecon-http/src/oridecon/http/exceptions.py	HTTPClientError
ORI_ERR_HTTP_003	HTTPTimeoutError	Raised when a connection or request times out.	packages/oridecon-http/src/oridecon/http/exceptions.py	HTTPClientError
ORI_ERR_HTTP_004	HTTPInterceptorError	Raised when a request/response interceptor fails.	packages/oridecon-http/src/oridecon/http/exceptions.py	HTTPClientError
ORI_ERR_HTTP_005	HTTPCircuitOpenError	Raised when the circuit breaker is open and requests are rejected.	packages/oridecon-http/src/oridecon/http/exceptions.py	HTTPClientError
ORI_ERR_HTTP_006	HTTPRetryExhaustedError	Raised when all retry attempts for a request have been exhausted.	packages/oridecon-http/src/oridecon/http/exceptions.py	HTTPClientError
ORI_ERR_HTTP_007	HTTPStatusError	Raised (or returned as an Err) when the server responds with 4xx/5xx. Callers using the Result-ba…	packages/oridecon-http/src/oridecon/http/exceptions.py	HTTPClientError
ORI_ERR_HTTP_008	HTTPUnsafeURLError	Raised when a request URL fails the SSRF safety gate.	packages/oridecon-http/src/oridecon/http/exceptions.py	HTTPClientError

oridecon-monitor (8 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_MONITOR_001	MonitorError	Base exception for monitoring errors.	packages/oridecon-monitor/src/oridecon/monitor/exceptions.py	OrideconError
ORI_ERR_MONITOR_002	BackendNotAvailableError	Raised when a required monitoring backend is not available.	packages/oridecon-monitor/src/oridecon/monitor/exceptions.py	MonitorError
ORI_ERR_MONITOR_003	MetricNotFoundError	Raised when a requested metric is not found.	packages/oridecon-monitor/src/oridecon/monitor/exceptions.py	MonitorError
ORI_ERR_MONITOR_004	InvalidMetricError	Raised when metric parameters are invalid.	packages/oridecon-monitor/src/oridecon/monitor/exceptions.py	MonitorError
ORI_ERR_MONITOR_005	SpanError	Base exception for span-related errors.	packages/oridecon-monitor/src/oridecon/monitor/exceptions.py	MonitorError
ORI_ERR_MONITOR_006	SpanNotFoundError	Raised when a requested span is not found.	packages/oridecon-monitor/src/oridecon/monitor/exceptions.py	SpanError
ORI_ERR_MONITOR_007	MonitorConfigurationError	Raised when monitoring configuration is invalid.	packages/oridecon-monitor/src/oridecon/monitor/exceptions.py	MonitorError, _ConfigurationError
ORI_ERR_MONITOR_008	PerformanceMonitorError	Base exception for performance monitoring errors.	packages/oridecon-monitor/src/oridecon/monitor/profiling/models.py	MonitorError

oridecon-multimedia-beat (1 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_MM_BEAT_003	BeatAnalysisDecodeError	Audio could not be decoded, or was rejected before decoding. Covers undecodable files, unsafe ass…	experimental/multimedia/oridecon-multimedia-beat/src/oridecon/multimedia/beat/exceptions.py	BeatAnalysisError

oridecon-multimedia-image (2 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_MM_IMAGE_001	ImageTimeoutError	Raised when an image generation operation exceeds its timeout.	experimental/multimedia/oridecon-multimedia-image/src/oridecon/multimedia/image/exceptions.py	ImageGenerationError
ORI_ERR_MM_IMAGE_002	ImageGenerationAuthenticationError	Raised when the image backend rejects the configured API credentials.	experimental/multimedia/oridecon-multimedia-image/src/oridecon/multimedia/image/exceptions.py	ImageGenerationError

oridecon-multimedia-music (1 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_MM_MUSIC_001	MusicGenerationAuthenticationError	Raised when the music backend rejects the configured API credentials.	experimental/multimedia/oridecon-multimedia-music/src/oridecon/multimedia/music/exceptions.py	MusicGenerationError

oridecon-multimedia-tts (1 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_MM_TTS_002	TTSAuthenticationError	Invalid API key or credentials — infrastructure error, raised not wrapped.	experimental/multimedia/oridecon-multimedia-tts/src/oridecon/multimedia/tts/exceptions.py	TTSError

oridecon-multimedia-upscale (3 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_MM_UPSCALE_001	UpscaleAssetTooLargeError	Raised when an upscale source asset exceeds the byte cap. Also a ValueError so callers and te…	experimental/multimedia/oridecon-multimedia-upscale/src/oridecon/multimedia/upscale/exceptions.py	UpscaleError, ValueError
ORI_ERR_MM_UPSCALE_002	UpscaleUnsafeAssetURLError	Raised when an upscale source asset URI is not safe to request. Also a ValueError so callers …	experimental/multimedia/oridecon-multimedia-upscale/src/oridecon/multimedia/upscale/exceptions.py	UpscaleError, ValueError
ORI_ERR_MM_UPSCALE_003	UpscaleAssetDownloadError	Raised when an upscale source asset fetch returns a non-200 response. Also a ValueError so ca…	experimental/multimedia/oridecon-multimedia-upscale/src/oridecon/multimedia/upscale/exceptions.py	UpscaleError, ValueError

oridecon-multimedia-video (6 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_MM_VIDEO_001	VideoTimeoutError	Raised when a video generation operation exceeds its timeout.	experimental/multimedia/oridecon-multimedia-video/src/oridecon/multimedia/video/exceptions.py	VideoGenerationError
ORI_ERR_MM_VIDEO_002	VideoGenerationAuthenticationError	Raised when the video backend rejects the configured API credentials.	experimental/multimedia/oridecon-multimedia-video/src/oridecon/multimedia/video/exceptions.py	VideoGenerationError
ORI_ERR_MM_VIDEO_003	VideoProcessingError	Raised when an ffmpeg processing operation fails.	experimental/multimedia/oridecon-multimedia-video/src/oridecon/multimedia/video/exceptions.py	VideoGenerationError
ORI_ERR_MM_VIDEO_004	VideoAssetTooLargeError	Raised when a materialized asset exceeds the byte cap. Also a ValueError so the processor’s e…	experimental/multimedia/oridecon-multimedia-video/src/oridecon/multimedia/video/exceptions.py	VideoProcessingError, ValueError
ORI_ERR_MM_VIDEO_005	VideoUnsafeAssetURLError	Raised when an asset URI is not safe to request. Also a ValueError so the processor’s existin…	experimental/multimedia/oridecon-multimedia-video/src/oridecon/multimedia/video/exceptions.py	VideoProcessingError, ValueError
ORI_ERR_MM_VIDEO_006	VideoAssetDownloadError	Raised when a remote asset download returns a non-200 response. Also a ValueError so the proc…	experimental/multimedia/oridecon-multimedia-video/src/oridecon/multimedia/video/exceptions.py	VideoProcessingError, ValueError

oridecon-nosql (7 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_NOSQL_001	NoSQLError	Base exception for all NoSQL operations.	packages/oridecon-nosql/src/oridecon/nosql/exceptions.py	OrideconError
ORI_ERR_NOSQL_002	NoSQLConnectionError	Failed to connect to the document store.	packages/oridecon-nosql/src/oridecon/nosql/exceptions.py	NoSQLError
ORI_ERR_NOSQL_003	DocumentNotFoundError	Requested document does not exist.	packages/oridecon-nosql/src/oridecon/nosql/exceptions.py	NoSQLError
ORI_ERR_NOSQL_004	DuplicateKeyError	Insert/update violated a unique constraint.	packages/oridecon-nosql/src/oridecon/nosql/exceptions.py	NoSQLError
ORI_ERR_NOSQL_005	DocumentValidationError	Document failed schema validation.	packages/oridecon-nosql/src/oridecon/nosql/exceptions.py	NoSQLError
ORI_ERR_NOSQL_006	TransactionError	Multi-document transaction failed.	packages/oridecon-nosql/src/oridecon/nosql/exceptions.py	NoSQLError
ORI_ERR_NOSQL_007	NoSQLFilterError	Filter rejected by the operator/identifier validation guard.	packages/oridecon-nosql/src/oridecon/nosql/exceptions.py	NoSQLError

oridecon-notification (12 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_NOTIF_003	TwilioNotificationError	Twilio SMS delivery failure.	packages/oridecon-notification/src/oridecon/notification/exceptions.py	NotificationError
ORI_ERR_NOTIF_004	FCMNotificationError	FCM push notification delivery failure.	packages/oridecon-notification/src/oridecon/notification/exceptions.py	NotificationError
ORI_ERR_NOTIF_005	APNsNotificationError	APNs push notification delivery failure.	packages/oridecon-notification/src/oridecon/notification/exceptions.py	NotificationError
ORI_ERR_NOTIF_006	SMTPMailerError	SMTP-specific delivery failure (rejection, auth error, etc.).	packages/oridecon-notification/src/oridecon/notification/exceptions.py	MailerError
ORI_ERR_NOTIF_007	SendGridMailerError	SendGrid API delivery failure.	packages/oridecon-notification/src/oridecon/notification/exceptions.py	MailerError
ORI_ERR_NOTIF_008	InboxError	Base exception for all inbox submodule errors.	packages/oridecon-notification/src/oridecon/notification/exceptions.py	DomainError
ORI_ERR_NOTIF_009	InboxMessageNotFoundError	Raised when a requested inbox message does not exist.	packages/oridecon-notification/src/oridecon/notification/exceptions.py	InboxError
ORI_ERR_NOTIF_010	InboxPermissionError	Raised when a user attempts to access another user’s inbox messages.	packages/oridecon-notification/src/oridecon/notification/exceptions.py	InboxError
ORI_ERR_NOTIF_011	WebPushNotificationError	Web Push notification delivery failure.	packages/oridecon-notification/src/oridecon/notification/exceptions.py	NotificationError
ORI_ERR_NOTIF_012	WhatsAppNotificationError	WhatsApp delivery failure via Twilio provider.	packages/oridecon-notification/src/oridecon/notification/backends/sms/whatsapp.py	TwilioNotificationError
ORI_ERR_NOTIF_013	WhatsAppMetaNotificationError	WhatsApp delivery failure via Meta provider.	packages/oridecon-notification/src/oridecon/notification/backends/sms/whatsapp.py	TwilioNotificationError
ORI_ERR_NOTIF_014	SlackNotificationError	Slack notification delivery failure.	packages/oridecon-notification/src/oridecon/notification/backends/slack/slack_notifier.py	NotificationError

oridecon-queue (6 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_QUEUE_002	RedisQueueError	Redis queue failure.	packages/oridecon-queue/src/oridecon/queue/exceptions.py	QueueError
ORI_ERR_QUEUE_003	RabbitMQQueueError	RabbitMQ queue failure.	packages/oridecon-queue/src/oridecon/queue/exceptions.py	QueueError
ORI_ERR_QUEUE_004	KafkaQueueError	Kafka queue failure.	packages/oridecon-queue/src/oridecon/queue/exceptions.py	QueueError
ORI_ERR_QUEUE_005	SQSQueueError	SQS queue failure.	packages/oridecon-queue/src/oridecon/queue/exceptions.py	QueueError
ORI_ERR_QUEUE_006	AzureServiceBusQueueError	Azure Service Bus queue failure.	packages/oridecon-queue/src/oridecon/queue/exceptions.py	QueueError
ORI_ERR_QUEUE_007	GCPPubSubQueueError	GCP Pub/Sub queue failure.	packages/oridecon-queue/src/oridecon/queue/exceptions.py	QueueError

oridecon-resilience (6 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_IDEM_005	IdempotencyBackendError	Raised when a Redis or database backend connection fails. This exception is raised when the under…	packages/oridecon-resilience/src/oridecon/resilience/exceptions.py	IdempotencyError
ORI_ERR_IDEM_006	IdempotencyConfigurationError	Raised when the idempotency store is misconfigured. This exception is raised when required config…	packages/oridecon-resilience/src/oridecon/resilience/exceptions.py	IdempotencyError
ORI_ERR_RES_008	RetryExhaustedError	All retry attempts exhausted.	packages/oridecon-resilience/src/oridecon/resilience/exceptions.py	RetryError
ORI_ERR_RES_009	CircuitOpenError	Circuit breaker is open.	packages/oridecon-resilience/src/oridecon/resilience/exceptions.py	CircuitBreakerError
ORI_ERR_RES_010	BulkheadRejectedError	Bulkhead rejected due to capacity limits.	packages/oridecon-resilience/src/oridecon/resilience/exceptions.py	BulkheadError
ORI_ERR_RES_011	ResilienceTimeoutError	Resilience operation timed out. Inherits from both ResilienceError and built-in TimeoutError so t…	packages/oridecon-resilience/src/oridecon/resilience/exceptions.py	ResilienceError, TimeoutError

oridecon-search (10 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_SEARCH_001	SearchError	Base exception for search operations.	packages/oridecon-search/src/oridecon/search/exceptions.py	OrideconError
ORI_ERR_SEARCH_002	IndexNotFoundError	Raised when index is not found.	packages/oridecon-search/src/oridecon/search/exceptions.py	DomainError
ORI_ERR_SEARCH_003	BackendError	Raised when search backend encounters an error.	packages/oridecon-search/src/oridecon/search/exceptions.py	InfrastructureError
ORI_ERR_SEARCH_004	SearchValidationError	Raised when search query validation fails.	packages/oridecon-search/src/oridecon/search/exceptions.py	SearchError
ORI_ERR_SEARCH_005	TransformationError	Raised when document transformation fails.	packages/oridecon-search/src/oridecon/search/exceptions.py	SearchError
ORI_ERR_SEARCH_006	CacheError	Raised when search cache operation fails.	packages/oridecon-search/src/oridecon/search/exceptions.py	SearchError
ORI_ERR_SEARCH_007	QueryError	Raised when search query execution fails.	packages/oridecon-search/src/oridecon/search/exceptions.py	SearchError
ORI_ERR_SEARCH_008	ConfigurationError	Raised when search configuration is invalid.	packages/oridecon-search/src/oridecon/search/exceptions.py	SearchError
ORI_ERR_SEARCH_009	SearchIndexError	Raised when search index operation fails.	packages/oridecon-search/src/oridecon/search/exceptions.py	SearchError
ORI_ERR_SEARCH_010	SchedulerError	Raised when search scheduler operation fails.	packages/oridecon-search/src/oridecon/search/exceptions.py	SearchError

oridecon-secrets (7 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_SECRET_001	SecretsError	Base exception for all secrets-domain errors.	packages/oridecon-secrets/src/oridecon/secrets/exceptions.py	OrideconError
ORI_ERR_SECRET_002	SecretNotFoundError	Raised when a requested secret does not exist.	packages/oridecon-secrets/src/oridecon/secrets/exceptions.py	SecretsError
ORI_ERR_SECRET_003	SecretAccessError	Raised when access to a secret is denied.	packages/oridecon-secrets/src/oridecon/secrets/exceptions.py	SecretsError
ORI_ERR_SECRET_004	SecretRotationError	Raised when automatic rotation of a secret fails.	packages/oridecon-secrets/src/oridecon/secrets/exceptions.py	SecretsError
ORI_ERR_SECRET_005	SecretBackendError	Raised when the underlying secret backend (e.g. Vault) fails.	packages/oridecon-secrets/src/oridecon/secrets/exceptions.py	SecretsError
ORI_ERR_SECRET_006	SecretConfigError	Raised when secrets subsystem configuration is invalid.	packages/oridecon-secrets/src/oridecon/secrets/exceptions.py	SecretsError
ORI_ERR_SECRET_007	SecretBackendUnavailableError	Backend auth/network/permission failure — distinct from secret-not-found.	packages/oridecon-secrets/src/oridecon/secrets/exceptions.py	InfrastructureError

oridecon-sql (38 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_SQL_001	DatabaseConnectionError	Base for all connection-related failures. Attributes: host: The database host that was targeted. …	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_002	ConnectionRefusedError	Server actively refused the connection.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseConnectionError
ORI_ERR_SQL_003	ConnectionTimeoutError	Connection attempt timed out.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseConnectionError
ORI_ERR_SQL_004	ConnectionPoolError	Connection pool exhausted — no connections available within timeout.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseConnectionError
ORI_ERR_SQL_005	QueryError	Base for query execution failures. Attributes: sql: The SQL query that failed. params: The parame…	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_006	QuerySyntaxError	The SQL query has a syntax error.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	QueryError
ORI_ERR_SQL_007	ParameterBindingError	Failed to bind parameters to a query.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	QueryError
ORI_ERR_SQL_008	IntegrityError	Base for constraint violation errors. Attributes: constraint: The constraint name that was violat…	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_009	DuplicateKeyError	Unique constraint or primary key violated.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	IntegrityError
ORI_ERR_SQL_010	ForeignKeyError	Foreign key constraint violated.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	IntegrityError
ORI_ERR_SQL_011	NotNullViolationError	NOT NULL constraint violated. Attributes: column: The column that triggered the violation.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	IntegrityError
ORI_ERR_SQL_012	CheckConstraintError	CHECK constraint violated.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	IntegrityError
ORI_ERR_SQL_013	TransactionError	Base for transaction-related failures.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_014	SerializationError	Serialization failure (optimistic concurrency conflict).	packages/oridecon-sql/src/oridecon/sql/exceptions.py	TransactionError
ORI_ERR_SQL_015	OptimisticLockError	Raised when an optimistic lock check fails on UPDATE. Indicates a concurrent modification was det…	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_016	TransactionRollbackError	Transaction was rolled back (not by the application).	packages/oridecon-sql/src/oridecon/sql/exceptions.py	TransactionError
ORI_ERR_SQL_017	LockError	Raised when a database lock cannot be acquired.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_018	DeadlockError	Database deadlock detected. Inherits from :class:TransactionError because deadlocks are resolve…	packages/oridecon-sql/src/oridecon/sql/exceptions.py	TransactionError
ORI_ERR_SQL_019	SchemaError	Base for schema-related errors.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_020	TableNotFoundError	Referenced table does not exist.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	SchemaError
ORI_ERR_SQL_021	ColumnNotFoundError	Referenced column does not exist.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	SchemaError
ORI_ERR_SQL_022	DatabaseTimeoutError	Database operation timed out.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_023	RepositoryError	RepositoryProtocol-level operation failure.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_024	UnitOfWorkError	Raised when unit of work operation fails.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_025	DriverError	Wraps underlying database driver exceptions. Preserves the original exception as __cause__ an…	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError
ORI_ERR_SQL_026	DataError	Base exception for data access layer failures.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	OrideconError
ORI_ERR_SQL_027	DataQueryError	Raised when a query cannot be built or compiled. Args: message: Explanation of the query error.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DataError
ORI_ERR_SQL_028	PaginationError	Raised when pagination parameters are invalid. Args: message: Explanation of the pagination error.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DataError
ORI_ERR_SQL_029	EntityNotFoundError	Signals that a required entity does not exist. RepositoryProtocol implementations that cannot fin…	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DataError
ORI_ERR_SQL_030	DataRepositoryError	Raised when a repository operation fails unexpectedly. Args: message: Explanation of the reposito…	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DataError
ORI_ERR_SQL_031	CursorError	Raised when a cursor cannot be encoded or decoded. Args: message: Explanation of the cursor error.	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DataError
ORI_ERR_SQL_032	MigrationDependencyError	Raised when migration dependencies are not satisfied.	packages/oridecon-sql/src/oridecon/sql/migrations/base.py	MigrationError
ORI_ERR_SQL_033	MigrationExecutionError	Raised when migration execution fails.	packages/oridecon-sql/src/oridecon/sql/migrations/base.py	MigrationError
ORI_ERR_SQL_034	MigrationNotFoundError	Raised when a migration is not found.	packages/oridecon-sql/src/oridecon/sql/migrations/base.py	MigrationError
ORI_ERR_SQL_035	MigrationValidationError	Raised when migration validation fails.	packages/oridecon-sql/src/oridecon/sql/migrations/base.py	MigrationError
ORI_ERR_SQL_036	ProtocolValidationError	Raised when object doesn’t implement protocol.	packages/oridecon-sql/src/oridecon/sql/validation/protocols.py	ConfigurationError
ORI_ERR_SQL_037	MappingError	Exception raised when entity mapping fails.	packages/oridecon-sql/src/oridecon/sql/mappers/base.py	CoreMappingError
ORI_ERR_SQL_038	TenantScopingError	Raised when a tenant-scoped operation runs without an active tenant. Mirrors :class:`~oridecon.sq…	packages/oridecon-sql/src/oridecon/sql/exceptions.py	DatabaseError

oridecon-storage (6 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_STORE_002	StorageFileNotFoundError	Raised when file is not found.	packages/oridecon-storage/src/oridecon/storage/exceptions.py	DomainError
ORI_ERR_STORE_004	TransactionError	Raised when a transaction operation fails.	packages/oridecon-storage/src/oridecon/storage/exceptions.py	StorageError
ORI_ERR_STORE_005	QuotaExceededError	Raised when a storage quota or size limit is exceeded.	packages/oridecon-storage/src/oridecon/storage/exceptions.py	StorageError
ORI_ERR_STORE_006	InvalidPathError	Raised when a path is invalid or attempts directory traversal.	packages/oridecon-storage/src/oridecon/storage/exceptions.py	StorageError
ORI_ERR_STORE_007	StorageUnavailableError	Raised when the storage backend is not reachable or unavailable.	packages/oridecon-storage/src/oridecon/storage/exceptions.py	StorageError
ORI_ERR_STORE_008	ChecksumMismatchError	Raised when a file’s checksum does not match the expected value.	packages/oridecon-storage/src/oridecon/storage/exceptions.py	StorageError

oridecon-tasks (10 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_TASK_002	QueueFullError	The queue has reached its maximum capacity and cannot accept new tasks. The caller should back of…	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	TaskQueueError
ORI_ERR_TASK_003	TaskError	Base exception for all task-related errors	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	TaskQueueError
ORI_ERR_TASK_004	TaskNotFoundError	Raised when a task cannot be found	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	TaskError
ORI_ERR_TASK_005	TaskTimeoutError	Raised when a task execution exceeds timeout	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	TaskError
ORI_ERR_TASK_006	TaskCancelledError	Raised when a task is cancelled	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	TaskError
ORI_ERR_TASK_007	TaskExecutionError	Raised when a task execution fails	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	TaskError
ORI_ERR_TASK_008	TaskValidationError	Raised when task parameters are invalid	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	TaskError
ORI_ERR_TASK_009	DuplicateTaskError	Raised when a duplicate task is detected	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	TaskError
ORI_ERR_TASK_010	TaskDependencyCycleError	Raised at registration time when a dependency cycle is detected. The scheduler validates the depe…	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	TaskError
ORI_ERR_TASK_011	TaskRegistrationError	Raised when a scheduled or handler task fails to register.	packages/oridecon-tasks/src/oridecon/tasks/exceptions.py	OrideconError

oridecon-testing (12 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_TEST_001	TestingError	Base exception for oridecon-testing operations.	packages/oridecon-testing/src/oridecon/testing/exceptions.py	OrideconError
ORI_ERR_TEST_002	TokenBudgetExceededError	Raised when an AITestClient operation would exceed the configured token budget. Prevents runaway …	packages/oridecon-testing/src/oridecon/testing/exceptions.py	TestingError
ORI_ERR_TEST_003	MemoryBackendError	Base exception for all memory backend errors.	packages/oridecon-testing/src/oridecon/testing/memory/exceptions.py	OrideconError
ORI_ERR_TEST_004	CommandBusError	Raised when a command bus operation fails.	packages/oridecon-testing/src/oridecon/testing/memory/exceptions.py	EventError
ORI_ERR_TEST_005	CommandHandlerNotFoundError	Raised when no handler is registered for a specific command type.	packages/oridecon-testing/src/oridecon/testing/memory/exceptions.py	CommandBusError, HandlerNotFoundError
ORI_ERR_TEST_006	DuplicateHandlerError	Raised when a handler is already registered for a command type.	packages/oridecon-testing/src/oridecon/testing/memory/exceptions.py	CommandBusError, ContractDuplicateHandlerError
ORI_ERR_TEST_007	CommandError	Wraps a handler exception for Result-based command dispatch.	packages/oridecon-testing/src/oridecon/testing/memory/exceptions.py	CommandBusError
ORI_ERR_TEST_008	QueryBusError	Raised when a query bus operation fails.	packages/oridecon-testing/src/oridecon/testing/memory/exceptions.py	EventError
ORI_ERR_TEST_009	QueryHandlerNotFoundError	Raised when no handler is registered for a specific query type.	packages/oridecon-testing/src/oridecon/testing/memory/exceptions.py	QueryBusError, HandlerNotFoundError
ORI_ERR_TEST_010	QueryDuplicateHandlerError	Raised when a handler is already registered for a query type.	packages/oridecon-testing/src/oridecon/testing/memory/exceptions.py	QueryBusError, ContractDuplicateHandlerError
ORI_ERR_TEST_011	ConfigurationError	Raised when a require_stub module is loaded via configure() in test mode. This exception indicate…	packages/oridecon-testing/src/oridecon/testing/lib/stubs.py	Exception
ORI_ERR_TEST_012	SnapshotMismatchError	Raised when a value does not match the stored snapshot.	packages/oridecon-testing/src/oridecon/testing/lib/snapshots.py	AssertionError

oridecon-ui (1 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_UI_001	UIError	Base exception for all UI-domain errors.	experimental/apps/oridecon-ui/src/oridecon/ui/exceptions.py	OrideconError

oridecon-vector (11 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_VEC_005	VectorError	Base exception for all vector store operations.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	InfrastructureError
ORI_ERR_VEC_006	VectorConnectionError	Failed to connect to the vector store.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError
ORI_ERR_VEC_007	CollectionNotFoundError	Requested collection does not exist.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError
ORI_ERR_VEC_008	CollectionAlreadyExistsError	Attempted to create a collection that already exists.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError
ORI_ERR_VEC_009	DimensionMismatchError	Vector dimensionality does not match the collection.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError
ORI_ERR_VEC_010	VectorConfigError	Invalid vector store configuration.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError
ORI_ERR_VEC_011	FilterCompilationError	Failed to compile a metadata filter for the target backend.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError
ORI_ERR_VEC_012	VectorUpsertError	Failed to upsert vectors.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError
ORI_ERR_VEC_013	VectorSearchError	Failed to execute similarity search.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError
ORI_ERR_VEC_014	VectorDeleteError	Failed to delete vectors.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError
ORI_ERR_VEC_015	VectorTimeoutError	Vector store operation timed out.	packages/oridecon-vector/src/oridecon/vector/exceptions.py	VectorError

oridecon-web (12 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_WEB_003	NotFoundError	404 Not Found.	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_004	BadRequestError	400 Bad Request.	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_005	UnauthorizedError	401 Unauthorized.	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_006	ForbiddenError	403 Forbidden.	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_007	MethodNotAllowedError	405 Method Not Allowed.	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_008	ConflictError	409 Conflict.	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_009	UnprocessableEntityError	422 Unprocessable Entity.	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_010	InternalServerError	500 Internal Server Error.	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_011	DependencyResolutionError	500 Dependency Resolution Error.	packages/oridecon-web/src/oridecon/web/exceptions.py	InternalServerError
ORI_ERR_WEB_012	RateLimitError	429 Too Many Requests.	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_013	TooManyConnectionsError	503 Service Unavailable — connection limit reached. Raised when a streaming endpoint (e.g. SSE) h…	packages/oridecon-web/src/oridecon/web/exceptions.py	HTTPError
ORI_ERR_WEB_014	HTTPError	Base HTTP error, compatible with OrideconError.	packages/oridecon-web/src/oridecon/web/exceptions.py	OrideconError

oridecon-webhook (5 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_WEBHOOK_002	SubscriptionNotFoundError	Raised when a subscription ID is not found.	packages/oridecon-webhook/src/oridecon/webhook/exceptions.py	WebhookError
ORI_ERR_WEBHOOK_003	SubscriptionInactiveError	Raised when attempting to deliver to a deactivated subscription.	packages/oridecon-webhook/src/oridecon/webhook/exceptions.py	WebhookError
ORI_ERR_WEBHOOK_004	InvalidWebhookURLError	Raised when a subscription URL fails validation.	packages/oridecon-webhook/src/oridecon/webhook/exceptions.py	WebhookError
ORI_ERR_WEBHOOK_005	DeliveryAttemptNotFoundError	Raised when a delivery attempt ID is not found.	packages/oridecon-webhook/src/oridecon/webhook/exceptions.py	WebhookError
ORI_ERR_WEBHOOK_006	SecretRotationError	Raised when secret rotation fails.	packages/oridecon-webhook/src/oridecon/webhook/exceptions.py	WebhookError

oridecon-workflow (18 codes)

Code	Class	Description	File	Inherits From
ORI_ERR_WF_003	WorkflowError	Base exception for workflow orchestration errors.	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	PipelineExecutionError
ORI_ERR_WF_004	WorkflowNotFoundError	Raised when a workflow definition cannot be found.	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	WorkflowError
ORI_ERR_WF_005	WorkflowStateError	Raised when a workflow is in an invalid state for the requested operation.	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	WorkflowError
ORI_ERR_WF_006	WorkflowStepError	Raised when a workflow step fails to execute.	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	WorkflowError
ORI_ERR_WF_007	WorkflowTimeoutError	Raised when a workflow or step exceeds its timeout.	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	WorkflowError
ORI_ERR_WF_008	WorkflowCompensationError	Raised when workflow compensation/rollback fails.	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	WorkflowError
ORI_ERR_WF_010	WorkflowVersionMismatchError	Raised when resuming a workflow instance with a mismatched definition version. Resuming an in-fli…	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	WorkflowError
ORI_ERR_WF_011	GraphExecutionError	Base exception for graph workflow engine operations. Args: message: Human-readable error descript…	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	OrideconError
ORI_ERR_WF_012	NodeExecutionError	A graph node’s execute() method failed. Args: message: Human-readable error description. node: Na…	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	GraphExecutionError
ORI_ERR_WF_013	CycleDetectedError	Graph engine exceeded max_iterations (likely cycle). Args: iterations: Number of iterations compl…	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	GraphExecutionError
ORI_ERR_WF_014	GraphTimeoutError	Graph workflow execution exceeded total timeout. Args: timeout: The configured timeout value in s…	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	GraphExecutionError
ORI_ERR_WF_015	GraphValidationError	Graph structure validation failed.	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	GraphExecutionError
ORI_ERR_WF_016	HumanInputRequiredError	Raised by HumanNode to pause execution awaiting human input. Args: prompt: Text/question to displ…	packages/oridecon-workflow/src/oridecon/workflow/exceptions.py	GraphExecutionError
ORI_ERR_WF_017	StateError	Raised when an invalid state transition is attempted. Attributes: event: The event that was not p…	packages/oridecon-workflow/src/oridecon/workflow/state/exceptions.py	OrideconError
ORI_ERR_WF_018	StateConcurrencyError	Raised when optimistic version checks fail during a transition.	packages/oridecon-workflow/src/oridecon/workflow/state/exceptions.py	StateError
ORI_ERR_WF_020	BulkOperationError	Base exception for bulk operation errors.	packages/oridecon-workflow/src/oridecon/workflow/bulk/models.py	OrideconError
ORI_ERR_WF_021	BulkOperationTimeoutError	Raised when a bulk operation times out.	packages/oridecon-workflow/src/oridecon/workflow/bulk/models.py	BulkOperationError
ORI_ERR_WF_022	BulkOperationCancelledError	Raised when a bulk operation is cancelled.	packages/oridecon-workflow/src/oridecon/workflow/bulk/models.py	BulkOperationError

---

3. Code Gaps by Domain

• CORE: missing codes 003, 004
• GOV: missing codes 004, 005, 009
• MEM: missing codes 004, 007
• MM_BEAT: missing codes 001, 002
• MM_TTS: missing codes 001
• RAG: missing codes 007, 008, 009
• RESULT: missing codes 001
• SEC: missing codes 007

4. Exception Classes Without _code

These exception classes were found in src/ trees but their containing file has no _code assignment. They are candidates for registration.

Total: 36 classes across 14 packages

oridecon-contracts (7 classes)

Class	Inherits From	File
ContributorDependencyError	ValueError	core/oridecon-contracts/src/oridecon/contracts/admin/dependencies.py
HealthCheckNotFoundError	—	core/oridecon-contracts/src/oridecon/contracts/admin/errors.py
RelayAuthError	—	core/oridecon-contracts/src/oridecon/contracts/ai/relay/auth.py
RelayBillingError	—	core/oridecon-contracts/src/oridecon/contracts/ai/governance/relay_billing.py
RelayGatewayError	Exception	core/oridecon-contracts/src/oridecon/contracts/ai/relay/gateway.py
RelayLedgerError	—	core/oridecon-contracts/src/oridecon/contracts/ai/relay/ledger.py
WidgetNotFoundError	—	core/oridecon-contracts/src/oridecon/contracts/admin/errors.py

oridecon (3 classes)

Class	Inherits From	File
BackpressureError	ReactiveError	core/oridecon/src/oridecon/reactive/exceptions.py
PluginStateError	InfrastructureError	core/oridecon/src/oridecon/plugins/exceptions.py
ReactiveError	OrideconError	core/oridecon/src/oridecon/reactive/exceptions.py

oridecon-admin (5 classes)

Class	Inherits From	File
AdminQueryTimeoutError	TimeoutError	experimental/apps/oridecon-admin/src/oridecon/admin/data/timeout.py
ImportRowError	—	experimental/apps/oridecon-admin/src/oridecon/admin/services/import_/service.py
NameCollisionError	Exception	experimental/apps/oridecon-admin/src/oridecon/admin/dashboard/naming_policy.py
ReadOnlyError	Exception	experimental/apps/oridecon-admin/src/oridecon/admin/data/read_only.py
RelationPersistenceError	DomainError	experimental/apps/oridecon-admin/src/oridecon/admin/relations/errors.py

oridecon-ai-agents (2 classes)

Class	Inherits From	File
ToolObservationBlockedError	AgentExecutionError	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/strategies/guard_hook.py
ToolObservationGuardError	AgentExecutionError	experimental/ai/oridecon-ai-agents/src/oridecon/ai/agents/strategies/guard_hook.py

oridecon-ai-evaluation (8 classes)

Class	Inherits From	File
AblationError	BaseEvaluationError	experimental/ai/oridecon-ai-evaluation/src/oridecon/ai/evaluation/exceptions.py
AnalysisError	BaseEvaluationError	experimental/ai/oridecon-ai-evaluation/src/oridecon/ai/evaluation/exceptions.py
CheckpointError	BaseEvaluationError	experimental/ai/oridecon-ai-evaluation/src/oridecon/ai/evaluation/exceptions.py
DatasetError	BaseEvaluationError	experimental/ai/oridecon-ai-evaluation/src/oridecon/ai/evaluation/exceptions.py
EvaluationConfigError	BaseEvaluationError	experimental/ai/oridecon-ai-evaluation/src/oridecon/ai/evaluation/exceptions.py
EvaluatorNotFoundError	BaseEvaluationError	experimental/ai/oridecon-ai-evaluation/src/oridecon/ai/evaluation/exceptions.py
HarnessError	BaseEvaluationError	experimental/ai/oridecon-ai-evaluation/src/oridecon/ai/evaluation/exceptions.py
TrackingError	BaseEvaluationError	experimental/ai/oridecon-ai-evaluation/src/oridecon/ai/evaluation/exceptions.py

oridecon-ai-governance (1 classes)

Class	Inherits From	File
_ExpressionError	Exception	experimental/ai/oridecon-ai-governance/src/oridecon/ai/governance/relay_billing/pricing/parser.py

oridecon-ai-llm (1 classes)

Class	Inherits From	File
InferenceError	DomainModel	experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/routing/types.py

oridecon-ai-rag (1 classes)

Class	Inherits From	File
PipelineError	—	experimental/ai/oridecon-ai-rag/src/oridecon/ai/rag/pipeline/types.py

oridecon-ai-workers (1 classes)

Class	Inherits From	File
IngestionError	—	experimental/ai/oridecon-ai-workers/src/oridecon/ai/workers/adapters/rag_adapter.py

oridecon-cli (1 classes)

Class	Inherits From	File
LoadError	—	experimental/apps/oridecon-cli/src/oridecon/cli/contributors/runtime.py

oridecon-search (2 classes)

Class	Inherits From	File
FilterRenderError	ValueError	packages/oridecon-search/src/oridecon/search/backends/filters/_validation.py
UnsupportedOperatorError	ValueError	packages/oridecon-search/src/oridecon/search/filterset/block_translator.py

oridecon-sql (1 classes)

Class	Inherits From	File
NoSecurityPolicyError	Exception	packages/oridecon-sql/src/oridecon/sql/row_level_security.py

oridecon-web (2 classes)

Class	Inherits From	File
FileValidationError	—	packages/oridecon-web/src/oridecon/web/uploads/pipeline.py
RoomError	—	packages/oridecon-web/src/oridecon/web/websocket/rooms.py

oridecon-workflow (1 classes)

Class	Inherits From	File
BulkItemError	—	packages/oridecon-workflow/src/oridecon/workflow/bulk/models.py

5. Duplicate Codes

⚠️ Duplicate codes found:

• ORI_ERR_ADMIN_020 appears 2 times:
  • ContributorPermissionError in experimental/apps/oridecon-admin/src/oridecon/admin/contributors/exceptions.py
  • PasswordResetTokenInvalidError in experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py
• ORI_ERR_ADMIN_021 appears 2 times:
  • ContributorNotFoundError in experimental/apps/oridecon-admin/src/oridecon/admin/contributors/exceptions.py
  • PasswordResetTokenExpiredError in experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py
• ORI_ERR_ADMIN_022 appears 3 times:
  • AdminError in experimental/apps/oridecon-admin/src/oridecon/admin/core/middleware.py
  • MfaNotEnabledError in experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py
  • AdminRoleError in experimental/apps/oridecon-admin/src/oridecon/admin/rbac/errors.py
• ORI_ERR_ADMIN_023 appears 3 times:
  • LockError in experimental/apps/oridecon-admin/src/oridecon/admin/core/distributed_lock.py
  • MfaVerificationFailedError in experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py
  • RoleDuplicateError in experimental/apps/oridecon-admin/src/oridecon/admin/rbac/errors.py
• ORI_ERR_ADMIN_024 appears 3 times:
  • LockAcquisitionError in experimental/apps/oridecon-admin/src/oridecon/admin/core/distributed_lock.py
  • EmailVerificationRequiredError in experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py
  • RoleNotFoundError in experimental/apps/oridecon-admin/src/oridecon/admin/rbac/errors.py
• ORI_ERR_ADMIN_025 appears 3 times:
  • LockTimeoutError in experimental/apps/oridecon-admin/src/oridecon/admin/core/distributed_lock.py
  • EmailVerificationTokenInvalidError in experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py
  • SystemRoleError in experimental/apps/oridecon-admin/src/oridecon/admin/rbac/errors.py
• ORI_ERR_ADMIN_026 appears 2 times:
  • LockConflictError in experimental/apps/oridecon-admin/src/oridecon/admin/services/collaborative.py
  • EmailOtpDeliveryError in experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py
• ORI_ERR_ADMIN_027 appears 2 times:
  • FeatureDisabledError in experimental/apps/oridecon-admin/src/oridecon/admin/services/feature_flags.py
  • EmailOtpCooldownError in experimental/apps/oridecon-admin/src/oridecon/admin/auth/errors.py
• ORI_ERR_AI_003 appears 2 times:
  • MetricsCollectionError in core/oridecon-contracts/src/oridecon/contracts/observability/ai.py
  • RelayError in core/oridecon-contracts/src/oridecon/contracts/ai/exceptions.py
• ORI_ERR_AI_005 appears 2 times:
  • AIError in experimental/ai/oridecon-ai/src/oridecon/ai/exceptions.py
  • MonitoringError in core/oridecon-contracts/src/oridecon/contracts/observability/ai.py
• ORI_ERR_LLM_017 appears 2 times:
  • ModelRevisionMismatchError in experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py
  • StructuredOutputError in experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/structured/exceptions.py
• ORI_ERR_LLM_018 appears 2 times:
  • LLMTimeoutError in experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/exceptions.py
  • ParseError in experimental/ai/oridecon-ai-llm/src/oridecon/ai/llm/structured/exceptions.py
• ORI_ERR_NOTIF_011 appears 2 times:
  • WebPushNotificationError in packages/oridecon-notification/src/oridecon/notification/exceptions.py
  • PermanentDeliveryFailure in packages/oridecon-notification/src/oridecon/notification/delivery/exceptions.py
• ORI_ERR_TASK_011 appears 2 times:
  • TaskRegistrationError in packages/oridecon-tasks/src/oridecon/tasks/exceptions.py
  • WorkflowError in packages/oridecon-tasks/src/oridecon/tasks/workflows/core.py

6. Packages Without Registered Codes

These packages have source files but no ORI_ERR_* codes registered.

Total: 7 packages

• oridecon-ai-evaluation
• oridecon-ai-mcp
• oridecon-ai-relay
• oridecon-ai-relay-gateway
• oridecon-multimedia
• oridecon-multimedia-interpolate
• oridecon-tenancy

7. Suspicious Exception Classes (Potential Leftovers)

These classes have names suggestive of template/placeholder code and may be leftover scaffolding that was never cleaned up.

Class	File	Package
WidgetNotFoundError	core/oridecon-contracts/src/oridecon/contracts/admin/errors.py	oridecon-contracts

8. Full Index by Domain

Complete alphabetical listing of all codes grouped by domain tag.

ADMIN (30 codes)

Code	Class	Description	Package
ORI_ERR_ADMIN_001	AdminError	Base exception for all admin-domain errors. Extended by leaf exceptions in le…	oridecon-contracts
ORI_ERR_ADMIN_002	AdminError	Base exception for all admin errors.	oridecon-admin
ORI_ERR_ADMIN_003	NotFoundError	Raised when a resource is not found.	oridecon-admin
ORI_ERR_ADMIN_004	PermissionDeniedError	Raised when permission is denied.	oridecon-admin
ORI_ERR_ADMIN_005	ConflictError	Raised when a resource conflict occurs.	oridecon-admin
ORI_ERR_ADMIN_006	AdminValidationError	Raised when validation fails.	oridecon-admin
ORI_ERR_ADMIN_007	DataError	Raised when a data source or database error occurs in admin.	oridecon-admin
ORI_ERR_ADMIN_008	AdminDataError	Raised when a storage/database operation fails. Translates low-level database…	oridecon-admin
ORI_ERR_ADMIN_009	NotificationError	Raised when a notification fails to send.	oridecon-admin
ORI_ERR_ADMIN_010	AdminAuthError	Base exception for all admin authentication errors.	oridecon-admin
ORI_ERR_ADMIN_011	InvalidCredentialsError	Raised when email/password combination is incorrect.	oridecon-admin
ORI_ERR_ADMIN_012	AccountLockedError	Raised when an account is temporarily or permanently locked. Args: message: H…	oridecon-admin
ORI_ERR_ADMIN_013	RateLimitExceededError	Raised when the IP-based rate limit is exceeded. Args: message: Human-readabl…	oridecon-admin
ORI_ERR_ADMIN_014	SessionNotFoundError	Raised when the requested session does not exist.	oridecon-admin
ORI_ERR_ADMIN_015	SessionExpiredError	Raised when the session has exceeded its idle or absolute timeout.	oridecon-admin
ORI_ERR_ADMIN_016	CsrfValidationError	Raised when CSRF token is missing, invalid, or expired.	oridecon-admin
ORI_ERR_ADMIN_017	PasswordPolicyError	Raised when a password does not meet policy requirements.	oridecon-admin
ORI_ERR_ADMIN_018	SetupAlreadyCompletedError	Raised when setup is attempted after an admin account already exists.	oridecon-admin
ORI_ERR_ADMIN_019	SetupTokenInvalidError	Raised when the ADMIN_SETUP_TOKEN env var is set and the provided token doesn…	oridecon-admin
ORI_ERR_ADMIN_020	ContributorPermissionError	Raised when a user lacks required permissions to execute a contributor action…	oridecon-admin
ORI_ERR_ADMIN_021	ContributorNotFoundError	Raised when a contributor ID cannot be found in the assembled dashboard. Args…	oridecon-admin
ORI_ERR_ADMIN_022	AdminError	Admin operation error with structured response.	oridecon-admin
ORI_ERR_ADMIN_023	LockError	Base lock error.	oridecon-admin
ORI_ERR_ADMIN_024	LockAcquisitionError	Could not acquire lock — another process holds it.	oridecon-admin
ORI_ERR_ADMIN_025	LockTimeoutError	Lock acquisition timed out waiting for the lock to be released.	oridecon-admin
ORI_ERR_ADMIN_026	LockConflictError	Raised when trying to acquire a lock already held by another user.	oridecon-admin
ORI_ERR_ADMIN_027	FeatureDisabledError	Raised when a required admin feature is disabled.	oridecon-admin
ORI_ERR_ADMIN_028	JobNotFoundError	Raised when a job_id is not found in the queue.	oridecon-admin
ORI_ERR_ADMIN_029	AsyncValidationError	Raised when async validation fails.	oridecon-admin
ORI_ERR_ADMIN_030	TenantNotFoundError	Raised when a tenant is not found in the registry.	oridecon-admin

ADMIN_ACTION (2 codes)

Code	Class	Description	Package
ORI_ERR_ADMIN_ACTION_001	ActionError	Base exception for all action-related errors.	oridecon-admin
ORI_ERR_ADMIN_ACTION_002	PermissionDenied	Raised when a user lacks permission to execute an action.	oridecon-admin

AGT (11 codes)

Code	Class	Description	Package
ORI_ERR_AGT_001	AgentError	Base exception for all agent errors.	oridecon-contracts
ORI_ERR_AGT_002	ToolError	Base exception for tool errors.	oridecon-contracts
ORI_ERR_AGT_003	StrategyError	Reasoning strategy failed. Raised when the agent’s strategy encounters an err…	oridecon-contracts
ORI_ERR_AGT_004	AgentConfigurationError	Invalid agent configuration. Raised when an agent is constructed with invalid…	oridecon-ai-agents
ORI_ERR_AGT_005	AgentExecutionError	Agent execution failed. Raised when the agent’s reasoning loop encounters an …	oridecon-ai-agents
ORI_ERR_AGT_006	ToolNotFoundError	Tool not found in registry. Raised when the agent tries to call a tool that i…	oridecon-ai-agents
ORI_ERR_AGT_007	ToolExecutionError	Tool execution failed. Raised when a tool raises an exception during execution.	oridecon-ai-agents
ORI_ERR_AGT_008	ToolAccessDeniedError	Agent does not have access to this tool. Raised when module visibility contro…	oridecon-ai-agents
ORI_ERR_AGT_009	MaxIterationsExceededError	Agent exceeded maximum reasoning iterations. Raised when the agent reaches ma…	oridecon-ai-agents
ORI_ERR_AGT_010	BudgetExceededError	Agent exceeded its AI governance budget. Raised when token usage or cost exce…	oridecon-ai-agents
ORI_ERR_AGT_011	ToolValidationError	Tool input validation failed. Raised when the arguments provided to a tool fa…	oridecon-ai-agents

AI (5 codes)

Code	Class	Description	Package
ORI_ERR_AI_001	AIError	Base exception for all AI-domain errors. This is the catch-all for AI operati…	oridecon-contracts
ORI_ERR_AI_002	ExtractionError	Base for structured extraction errors. Used in “StructuredExtractorProtocol…	oridecon-contracts
ORI_ERR_AI_003	MetricsCollectionError	Error raised during metrics collection.	oridecon-contracts
ORI_ERR_AI_004	TracingError	Error raised during tracing operations.	oridecon-contracts
ORI_ERR_AI_005	AIError	Base exception for oridecon-ai.	oridecon-ai

AIWORK (3 codes)

Code	Class	Description	Package
ORI_ERR_AIWORK_001	WorkerError	Base exception for all worker-related errors.	oridecon-ai-workers
ORI_ERR_AIWORK_002	DLQError	Raised when a Dead Letter Queue operation fails.	oridecon-ai-workers
ORI_ERR_AIWORK_003	MaintenanceError	Raised when a maintenance task operation fails.	oridecon-ai-workers

APP (3 codes)

Code	Class	Description	Package
ORI_ERR_APP_001	AppError	Base exception for all app errors.	oridecon
ORI_ERR_APP_002	AppStartupError	Raised when the application fails to start or a provider fails during boot.	oridecon
ORI_ERR_APP_003	AppShutdownError	Raised when the application cannot complete a graceful shutdown.	oridecon

AUDIT (4 codes)

Code	Class	Description	Package
ORI_ERR_AUDIT_001	AuditError	Base exception for all audit-domain errors.	oridecon-audit
ORI_ERR_AUDIT_002	AuditStoreError	Raised when the audit store fails to persist or query entries.	oridecon-audit
ORI_ERR_AUDIT_003	AuditVerificationError	Raised when audit trail verification encounters an unexpected failure.	oridecon-audit
ORI_ERR_AUDIT_004	AuditRetentionError	Raised when a retention purge fails.	oridecon-audit

AUTH (28 codes)

Code	Class	Description	Package
ORI_ERR_AUTH_001	AuthError	Base exception for all auth-domain errors. This is the catch-all for authenti…	oridecon-contracts
ORI_ERR_AUTH_002	TokenError	Base class for expected, recoverable token domain failures. All subtypes indi…	oridecon-contracts
ORI_ERR_AUTH_003	VerificationError	Base class for expected, recoverable account-verification failures. All subty…	oridecon-contracts
ORI_ERR_AUTH_004	AuthError	Base exception for all auth errors.	oridecon-auth
ORI_ERR_AUTH_005	AuthenticationError	Raised when authentication fails.	oridecon-auth
ORI_ERR_AUTH_006	AuthorizationError	Raised when user lacks required permissions.	oridecon-auth
ORI_ERR_AUTH_007	InvalidCredentialsError	Raised when credentials are invalid.	oridecon-auth
ORI_ERR_AUTH_008	AccountLockedError	Raised when an account is locked due to too many failed login attempts. Accou…	oridecon-auth
ORI_ERR_AUTH_009	UserNotFoundError	Raised when user is not found.	oridecon-auth
ORI_ERR_AUTH_010	TokenError	Base exception for token-related errors.	oridecon-auth
ORI_ERR_AUTH_011	InvalidTokenError	Raised when a token is malformed or invalid.	oridecon-auth
ORI_ERR_AUTH_012	TokenExpiredError	Raised when a token has expired.	oridecon-auth
ORI_ERR_AUTH_013	TokenBlacklistedError	Token has been explicitly revoked.	oridecon-auth
ORI_ERR_AUTH_014	TokenInvalidError	Token is structurally invalid or has wrong type.	oridecon-auth
ORI_ERR_AUTH_015	TokenAudienceError	Token audience claim does not match expected.	oridecon-auth
ORI_ERR_AUTH_016	TokenNotFoundError	Token record does not exist.	oridecon-auth
ORI_ERR_AUTH_017	InvalidAudienceError	Raised when a token audience is invalid.	oridecon-auth
ORI_ERR_AUTH_018	InvalidScopeError	Raised when a token lacks required scope.	oridecon-auth
ORI_ERR_AUTH_019	BlacklistedTokenError	Raised when a token has been blacklisted.	oridecon-auth
ORI_ERR_AUTH_020	TokenExpiredVerificationError	Account verification has expired.	oridecon-auth
ORI_ERR_AUTH_021	AlreadyVerifiedError	Account is already verified.	oridecon-auth
ORI_ERR_AUTH_022	EmailExistsError	Raised when email is already taken.	oridecon-auth
ORI_ERR_AUTH_023	UsernameExistsError	Raised when username is already taken.	oridecon-auth
ORI_ERR_AUTH_024	PasswordPolicyError	Raised when password doesn’t meet requirements.	oridecon-auth
ORI_ERR_AUTH_025	OAuth2Error	Base exception for OAuth2 errors.	oridecon-auth
ORI_ERR_AUTH_026	SessionNotFoundError	Raised when a session cannot be found in the store.	oridecon-auth
ORI_ERR_AUTH_027	AccountVerificationError	Error during account verification operations.	oridecon-auth
ORI_ERR_AUTH_028	PasswordResetTokenError	Error during password reset token operations.	oridecon-auth

CACHE (15 codes)

Code	Class	Description	Package
ORI_ERR_CACHE_001	CacheError	Base exception for all cache-domain errors. This is an expected, recoverable …	oridecon-contracts
ORI_ERR_CACHE_002	CacheKeyNotFoundError	Raised when cache key is not found.	oridecon-contracts
ORI_ERR_CACHE_003	CacheWriteError	Raised when cache write fails.	oridecon-contracts
ORI_ERR_CACHE_004	CacheError	Base exception for cache errors.	oridecon-cache
ORI_ERR_CACHE_005	CacheBackendError	Raised when the cache backend (Redis/Memcached) fails.	oridecon-cache
ORI_ERR_CACHE_006	CacheConnectionError	Raised when the cache connection fails.	oridecon-cache
ORI_ERR_CACHE_007	CacheTimeoutError	Raised when a cache operation times out.	oridecon-cache
ORI_ERR_CACHE_008	CacheKeyError	Raised when a cache key is invalid or for key-specific errors.	oridecon-cache
ORI_ERR_CACHE_009	CacheConfigurationError	Raised when cache configuration is invalid.	oridecon-cache
ORI_ERR_CACHE_010	CacheStampedeError	Raised when cache stampede protection fails.	oridecon-cache
ORI_ERR_CACHE_011	CacheInvalidationError	Raised when cache invalidation fails.	oridecon-cache
ORI_ERR_CACHE_012	LockAcquisitionError	Raised when a distributed lock cannot be acquired.	oridecon-cache
ORI_ERR_CACHE_013	CacheSerializationError	Raised when serialization/deserialization fails.	oridecon-cache
ORI_ERR_CACHE_014	CacheCapacityError	Raised when the cache is at capacity.	oridecon-cache
ORI_ERR_CACHE_015	CacheSerializationError	Raised when cache serialization or deserialization fails. This is a cache-spe…	oridecon-cache

CFG (6 codes)

Code	Class	Description	Package
ORI_ERR_CFG_001	ConfigurationError	Developer configuration or runtime misconfiguration errors. Supports optional…	oridecon-contracts
ORI_ERR_CFG_002	ConfigurationError	Configuration loading, parsing, or validation failed. Raised by: - “ConfigPr…	oridecon
ORI_ERR_CFG_003	ConfigSourceError	Raised when a configuration source fails to load its values.	oridecon
ORI_ERR_CFG_004	ConfigReloadError	Raised when a live-reload attempt fails.	oridecon
ORI_ERR_CFG_005	ConfigSectionNotFoundError	Raised when a required config section is absent from the loaded config.	oridecon
ORI_ERR_CFG_006	UnknownConfigKeysError	Raised when a typed config section contains keys its model does not define. A…	oridecon

CLI (3 codes)

Code	Class	Description	Package
ORI_ERR_CLI_001	CliError	Base exception for oridecon-cli operations.	oridecon-cli
ORI_ERR_CLI_002	ConfigNotFoundError	Raised when application.yaml configuration file is not found.	oridecon-cli
ORI_ERR_CLI_003	ProviderNotInstalledError	Raised when a required provider package is not installed.	oridecon-cli

CODEGEN (1 codes)

Code	Class	Description	Package
ORI_ERR_CODEGEN_001	CollidingFileError	A generated file collides with an existing file under a FAIL policy.	oridecon-contracts

CONC (8 codes)

Code	Class	Description	Package
ORI_ERR_CONC_001	ConcurrencyError	Base exception for all concurrency errors.	oridecon
ORI_ERR_CONC_002	AsyncError	Exception raised for errors in asynchronous operations or concurrency control.	oridecon
ORI_ERR_CONC_003	ChannelClosedError	Raised when an operation is attempted on a closed channel.	oridecon
ORI_ERR_CONC_004	ChannelFullError	Raised when sending to a channel that is at capacity.	oridecon
ORI_ERR_CONC_005	DispatcherError	Error in dispatcher execution.	oridecon
ORI_ERR_CONC_006	StructuredParallelismError	Base exception for parallel execution errors.	oridecon
ORI_ERR_CONC_007	TaskGroupError	Raised when a task group encounters an error.	oridecon
ORI_ERR_CONC_008	CancellationScopeError	Raised when a cancellation scope encounters an error.	oridecon

CORE (3 codes)

Code	Class	Description	Package
ORI_ERR_CORE_001	OrideconError	Root exception for the entire Oridecon ecosystem. All Oridecon exceptions inh…	oridecon-contracts
ORI_ERR_CORE_002	OrideconException	Base exception for all oridecon domain errors. Extends :class:`~oridecon.cont…	oridecon
ORI_ERR_CORE_005	CoreError	Base exception for all core errors.	oridecon

DB (11 codes)

Code	Class	Description	Package
ORI_ERR_DB_001	DatabaseError	Database-related error (infrastructure-level).	oridecon-contracts
ORI_ERR_DB_002	MigrationError	Database migration error.	oridecon-contracts
ORI_ERR_DB_003	IntegrityError	Raised when a database integrity constraint is violated.	oridecon-contracts
ORI_ERR_DB_004	ConstraintError	Raised when a generic database constraint is violated.	oridecon-contracts
ORI_ERR_DB_005	DuplicateKeyError	Raised when a unique-key constraint is violated (duplicate record).	oridecon-contracts
ORI_ERR_DB_006	UnitOfWorkError	Raised when a unit-of-work operation fails or is used incorrectly.	oridecon-contracts
ORI_ERR_DB_007	DataError	Base exception for all data-domain errors. This is an expected, recoverable e…	oridecon-contracts
ORI_ERR_DB_008	DataNotFoundError	Raised when data item is not found.	oridecon-contracts
ORI_ERR_DB_009	DataValidationError	Raised when data validation fails.	oridecon-contracts
ORI_ERR_DB_010	InvalidIdentifierError	Raised when an SQL identifier fails validation. Attributes: identifier: The o…	oridecon-contracts
ORI_ERR_DB_011	NoPrimaryBackendError	Raised when a multi-backend setup has no backend marked as primary. For multi…	oridecon-contracts

DI (11 codes)

Code	Class	Description	Package
ORI_ERR_DI_001	ContainerError	Base container error.	oridecon-contracts
ORI_ERR_DI_002	DependencyError	Dependency resolution error.	oridecon-contracts
ORI_ERR_DI_003	CircularDependencyError	Circular dependency detected.	oridecon-contracts
ORI_ERR_DI_004	UnresolvableDependencyError	Cannot resolve dependency.	oridecon-contracts
ORI_ERR_DI_005	RegistrationError	Service registration error.	oridecon-contracts
ORI_ERR_DI_006	ContainerBuildError	Container build/configuration error.	oridecon-contracts
ORI_ERR_DI_007	ProtocolValidationError	Protocol validation error.	oridecon-contracts
ORI_ERR_DI_008	ContainerValidationError	Container dependency graph validation failed before boot. Raised when “Conta…	oridecon-contracts
ORI_ERR_DI_009	ScopedResolutionError	Attempted to resolve a scoped service outside of an active scope. Raised when…	oridecon-contracts
ORI_ERR_DI_010	InjectionError	Dependency injection or container resolution failed. Raised by: - “Container…	oridecon
ORI_ERR_DI_011	InterceptorTimeoutError	Raised when a MethodInterceptorProtocol exceeds its configured timeout.	oridecon

DOM (9 codes)

Code	Class	Description	Package
ORI_ERR_DOM_001	DomainError	Business/domain-level errors (validation failures, not found, auth).	oridecon-contracts
ORI_ERR_DOM_002	NotFoundError	Resource not found error (domain-level).	oridecon-contracts
ORI_ERR_DOM_003	PermissionDeniedError	Permission denied error (domain-level).	oridecon-contracts
ORI_ERR_DOM_004	AuthenticationError	Authentication error (domain-level).	oridecon-contracts
ORI_ERR_DOM_005	AuthorizationError	Authorization/permission error (domain-level).	oridecon-contracts
ORI_ERR_DOM_006	RateLimitError	Rate limiting error.	oridecon-contracts
ORI_ERR_DOM_007	ConflictError	Resource conflict error.	oridecon-contracts
ORI_ERR_DOM_008	DomainModelError	Domain model invariant violated or business rule broken. Raised by: - Domain …	oridecon
ORI_ERR_DOM_009	DomainPolicyViolationError	Raised when a domain policy evaluation fails. Distinct from “PolicyViolation…	oridecon

EVAL (1 codes)

Code	Class	Description	Package
ORI_ERR_EVAL_001	EvaluationError	Base for evaluation system errors. Extended in the AI evaluation layer with s…	oridecon-contracts

EVT (23 codes)

Code	Class	Description	Package
ORI_ERR_EVT_001	EventError	Base events/messaging error.	oridecon-contracts
ORI_ERR_EVT_002	HandlerNotFoundError	Event/command handler not found. Raised when no handler is registered for a s…	oridecon-contracts
ORI_ERR_EVT_003	DuplicateHandlerError	Duplicate handler registration. Raised when attempting to register a handler …	oridecon-contracts
ORI_ERR_EVT_004	ConcurrencyError	Concurrency/optimistic locking error. Raised when event version conflicts ind…	oridecon-events
ORI_ERR_EVT_005	CommandExecutionError	Command execution error.	oridecon-events
ORI_ERR_EVT_006	QueryExecutionError	Query execution error.	oridecon-events
ORI_ERR_EVT_007	StreamNotFoundError	Raised when stream is not found. Parameters mirror the helper used in tests: …	oridecon-events
ORI_ERR_EVT_008	EventHandlerError	Raised when event handling fails.	oridecon-events
ORI_ERR_EVT_009	AggregateNotFoundError	Raised when aggregate is not found.	oridecon-events
ORI_ERR_EVT_010	AdapterConnectionError	Raised when adapter connection fails.	oridecon-events
ORI_ERR_EVT_011	EventLoadError	Raised when event loading fails.	oridecon-events
ORI_ERR_EVT_012	EventPersistenceError	Raised when event persistence fails.	oridecon-events
ORI_ERR_EVT_013	EventStoreError	Raised for event store errors.	oridecon-events
ORI_ERR_EVT_014	EventStoreConnectionError	Raised when event store connection fails.	oridecon-events
ORI_ERR_EVT_015	ProjectionBuildError	Raised when projection building fails.	oridecon-events
ORI_ERR_EVT_016	ProjectionRebuildError	Raised when projection rebuilding fails (alias for collection stability).	oridecon-events
ORI_ERR_EVT_017	ProjectionNotFoundError	Raised when a projection is not found.	oridecon-events
ORI_ERR_EVT_018	WebhookDeliveryError	Raised when an outbound webhook delivery fails after all retry attempts. Carr…	oridecon-events
ORI_ERR_EVT_019	SchemaError	Raised for schema-related errors.	oridecon-events
ORI_ERR_EVT_020	SecurityError	Raised for security-related errors.	oridecon-events
ORI_ERR_EVT_021	StreamingError	Raised for streaming-related errors.	oridecon-events
ORI_ERR_EVT_022	SchemaIncompatibleError	Raised when a schema is not compatible with previous version.	oridecon-events
ORI_ERR_EVT_023	SchemaNotFoundError	Raised when a schema is not found.	oridecon-events

FEAT (4 codes)

Code	Class	Description	Package
ORI_ERR_FEAT_001	FeatureFlagError	Base error for the feature flag subsystem.	oridecon-contracts
ORI_ERR_FEAT_002	FlagNotFoundError	Raised when a requested feature flag does not exist in any provider. Attribut…	oridecon-features
ORI_ERR_FEAT_003	FlagEvaluationError	Raised when a flag provider fails during evaluation. Attributes: flag_key: Th…	oridecon-features
ORI_ERR_FEAT_004	FeatureFlagDisabledError	Raised when a feature-guarded path is called with the flag disabled.	oridecon-features

FEED (5 codes)

Code	Class	Description	Package
ORI_ERR_FEED_001	FeedbackError	Base exception for all feedback-related errors.	oridecon-ai-feedback
ORI_ERR_FEED_002	FeedbackProcessingError	Raised when a feedback processor fails.	oridecon-ai-feedback
ORI_ERR_FEED_003	FeedbackValidationError	Raised when feedback data fails validation.	oridecon-ai-feedback
ORI_ERR_FEED_004	FeedbackAuthorizationError	Raised when the endpoint’s authorization callback denies a submission.	oridecon-ai-feedback
ORI_ERR_FEED_005	FeedbackTooLargeError	Raised when a payload exceeds MAX_FEEDBACK_TEXT_LENGTH or MAX_CONTEXT_SIZE.	oridecon-ai-feedback

GOV (7 codes)

Code	Class	Description	Package
ORI_ERR_GOV_001	GovernanceError	Base class for governance-related errors.	oridecon-contracts
ORI_ERR_GOV_002	BudgetExceededError	Error raised when budget is exceeded.	oridecon-contracts
ORI_ERR_GOV_003	PolicyViolationError	Error raised when policy is violated.	oridecon-contracts
ORI_ERR_GOV_006	RateLimitExceededError	Raised when RPM or TPM limits are exceeded. Attributes: limit: Configured lim…	oridecon-ai-governance
ORI_ERR_GOV_007	ModelAccessDeniedError	Raised when a user is denied access to a model by policy. Attributes: model: …	oridecon-ai-governance
ORI_ERR_GOV_008	GovernancePersistenceError	Raised when a governance persistence backend is unavailable. Raised by :class…	oridecon-ai-governance
ORI_ERR_GOV_010	ResourceExhaustedError	Raised when a resource quota is exhausted.	oridecon-contracts

GQL (15 codes)

Code	Class	Description	Package
ORI_ERR_GQL_001	GraphQLError	Base exception for all GraphQL errors.	oridecon-graphql
ORI_ERR_GQL_002	ExecutionError	Raised when execution fails.	oridecon-graphql
ORI_ERR_GQL_003	GraphQLTimeoutError	Raised when execution times out.	oridecon-graphql
ORI_ERR_GQL_004	QueryTooDeepError	Raised when a GraphQL query exceeds the maximum depth.	oridecon-graphql
ORI_ERR_GQL_005	InputGraphQLError	Raised for invalid user input.	oridecon-graphql
ORI_ERR_GQL_006	ParseError	Raised when query parsing fails.	oridecon-graphql
ORI_ERR_GQL_007	QueryTooComplexError	Raised when query exceeds complexity limit.	oridecon-graphql
ORI_ERR_GQL_008	ResolverError	Raised when a resolver fails.	oridecon-graphql
ORI_ERR_GQL_009	AuthenticationError	Raised when authentication is required but missing. Also satisfies “oridecon…	oridecon-graphql
ORI_ERR_GQL_010	AuthorizationError	Raised when user is authenticated but lacks permissions. Also satisfies “lex…	oridecon-graphql
ORI_ERR_GQL_011	ForbiddenError	Raised when access is forbidden.	oridecon-graphql
ORI_ERR_GQL_012	NotFoundError	Raised when a requested resource is not found.	oridecon-graphql
ORI_ERR_GQL_013	RateLimitError	Raised when rate limit is exceeded.	oridecon-graphql
ORI_ERR_GQL_014	SubscriptionError	Raised for subscription-related errors.	oridecon-graphql
ORI_ERR_GQL_015	GraphQLConnectionError	Raised when a network connection error occurs during GraphQL execution.	oridecon-graphql

GRAPH (12 codes)

Code	Class	Description	Package
ORI_ERR_GRAPH_001	GraphError	Base exception for all graph store operations.	oridecon-graph
ORI_ERR_GRAPH_002	GraphConnectionError	Failed to connect to the graph store.	oridecon-graph
ORI_ERR_GRAPH_003	GraphNotFoundError	Requested graph database does not exist.	oridecon-graph
ORI_ERR_GRAPH_004	GraphAlreadyExistsError	Attempted to create a graph that already exists.	oridecon-graph
ORI_ERR_GRAPH_005	GraphNodeNotFoundError	Referenced node does not exist.	oridecon-graph
ORI_ERR_GRAPH_006	GraphEdgeNotFoundError	Referenced edge does not exist.	oridecon-graph
ORI_ERR_GRAPH_007	DetachRequiredError	Node has edges and detach=False was specified.	oridecon-graph
ORI_ERR_GRAPH_008	TraversalError	Traversal query failed.	oridecon-graph
ORI_ERR_GRAPH_009	CypherCompilationError	Failed to compile a traversal query to Cypher.	oridecon-graph
ORI_ERR_GRAPH_010	GraphSchemaError	Schema operation (index, constraint) failed.	oridecon-graph
ORI_ERR_GRAPH_011	GraphTransactionError	Graph transaction failed.	oridecon-graph
ORI_ERR_GRAPH_012	GraphQueryError	Raw query execution failed.	oridecon-graph

GUARD (6 codes)

Code	Class	Description	Package
ORI_ERR_GUARD_001	GuardError	Base for AI guard/policy enforcement errors. Extended in the AI guard layer w…	oridecon-contracts
ORI_ERR_GUARD_002	InputGuardError	Error raised during input guard validation.	oridecon-contracts
ORI_ERR_GUARD_003	OutputGuardError	Error raised during output guard validation.	oridecon-contracts
ORI_ERR_GUARD_004	GuardError	Base exception for all guard-related errors.	oridecon-ai-guard
ORI_ERR_GUARD_005	GuardConfigurationError	Raised when a guard is misconfigured at boot time.	oridecon-ai-guard
ORI_ERR_GUARD_006	GuardPipelineError	Raised when the guard pipeline encounters an unrecoverable error.	oridecon-ai-guard

HTTP (8 codes)

Code	Class	Description	Package
ORI_ERR_HTTP_001	HTTPClientError	Base exception for all HTTP client errors.	oridecon-http
ORI_ERR_HTTP_002	HTTPConnectionError	Raised when a connection to a remote host fails.	oridecon-http
ORI_ERR_HTTP_003	HTTPTimeoutError	Raised when a connection or request times out.	oridecon-http
ORI_ERR_HTTP_004	HTTPInterceptorError	Raised when a request/response interceptor fails.	oridecon-http
ORI_ERR_HTTP_005	HTTPCircuitOpenError	Raised when the circuit breaker is open and requests are rejected.	oridecon-http
ORI_ERR_HTTP_006	HTTPRetryExhaustedError	Raised when all retry attempts for a request have been exhausted.	oridecon-http
ORI_ERR_HTTP_007	HTTPStatusError	Raised (or returned as an Err) when the server responds with 4xx/5xx. Callers…	oridecon-http
ORI_ERR_HTTP_008	HTTPUnsafeURLError	Raised when a request URL fails the SSRF safety gate.	oridecon-http

IDEM (6 codes)

Code	Class	Description	Package
ORI_ERR_IDEM_001	IdempotencyError	Base exception for idempotency flows.	oridecon-contracts
ORI_ERR_IDEM_002	DuplicateRequestError	Raised when an idempotent key is reused before completion.	oridecon-contracts
ORI_ERR_IDEM_003	IdempotencyStoreError	Raised on unexpected failures inside the idempotency store.	oridecon-contracts
ORI_ERR_IDEM_004	IdempotencyConflictError	Raised when an idempotency key is already claimed (PENDING).	oridecon-contracts
ORI_ERR_IDEM_005	IdempotencyBackendError	Raised when a Redis or database backend connection fails. This exception is r…	oridecon-resilience
ORI_ERR_IDEM_006	IdempotencyConfigurationError	Raised when the idempotency store is misconfigured. This exception is raised …	oridecon-resilience

IDX (1 codes)

Code	Class	Description	Package
ORI_ERR_IDX_001	IndexError	Raised when index operations fail in an expected, recoverable way.	oridecon-contracts

INFRA (11 codes)

Code	Class	Description	Package
ORI_ERR_INFRA_001	InfrastructureError	System-level failures (DB down, network timeouts).	oridecon-contracts
ORI_ERR_INFRA_002	LockError	Distributed lock error.	oridecon-contracts
ORI_ERR_INFRA_003	LockConflictError	Raised when a lock conflict occurs (resource already locked).	oridecon-contracts
ORI_ERR_INFRA_004	ComponentError	Base exception for all component-related errors.	oridecon-contracts
ORI_ERR_INFRA_005	ComponentConnectionError	Raised when a connection to an external service fails.	oridecon-contracts
ORI_ERR_INFRA_006	KeyNotFoundError	Raised when a requested key does not exist.	oridecon-contracts
ORI_ERR_INFRA_007	KeyExistsError	Raised when trying to create a key that already exists.	oridecon-contracts
ORI_ERR_INFRA_008	PubSubError	Base exception for pub/sub operations.	oridecon-contracts
ORI_ERR_INFRA_009	SecretNotFoundError	Raised when a requested secret does not exist.	oridecon-contracts
ORI_ERR_INFRA_010	DriverNotAvailableError	Raised when a driver is not available (dependency not installed).	oridecon-contracts
ORI_ERR_INFRA_011	_StoredStreamError	Internal carrier for propagating typed stream failures.	oridecon-contracts

LLM (26 codes)

Code	Class	Description	Package
ORI_ERR_LLM_001	LLMError	Base for LLM client errors. Extended in oridecon-ai-llm with specific failure…	oridecon-contracts
ORI_ERR_LLM_002	LLMError	Base exception for all LLM-domain errors in oridecon-ai-llm.	oridecon-ai-llm
ORI_ERR_LLM_003	LLMAuthenticationError	Invalid API key or credentials — infrastructure error, raised not wrapped. Ra…	oridecon-ai-llm
ORI_ERR_LLM_004	InvalidRequestError	Error raised when a request to an LLM provider is invalid.	oridecon-ai-llm
ORI_ERR_LLM_005	ModelNotFoundError	Model unavailable or not found — recoverable via fallback routing.	oridecon-ai-llm
ORI_ERR_LLM_006	LLMModelNotFoundError	Model unavailable or not found — recoverable via fallback routing. Returned a…	oridecon-ai-llm
ORI_ERR_LLM_007	LLMRateLimitError	Rate limit exceeded — recoverable via backoff/retry. Returned as Err from…	oridecon-ai-llm
ORI_ERR_LLM_008	LLMQuotaExceededError	API quota or billing limit exceeded — recoverable by routing elsewhere. Retur…	oridecon-ai-llm
ORI_ERR_LLM_009	LLMContentFilterError	Content blocked by provider safety filter — recoverable via reformulation. Re…	oridecon-ai-llm
ORI_ERR_LLM_010	TokenLimitError	Error raised when the token limit for a request is exceeded.	oridecon-ai-llm
ORI_ERR_LLM_011	ProviderConnectionError	Error raised when connection to an LLM provider fails.	oridecon-ai-llm
ORI_ERR_LLM_012	StreamError	Error raised during LLM response streaming.	oridecon-ai-llm
ORI_ERR_LLM_013	ExtractionError	Base class for structured extraction errors in oridecon-ai-llm.	oridecon-ai-llm
ORI_ERR_LLM_014	ExtractionParseError	Error raised when extraction response cannot be parsed as JSON.	oridecon-ai-llm
ORI_ERR_LLM_015	ExtractionValidationError	Error raised when parsed extraction response fails schema validation.	oridecon-ai-llm
ORI_ERR_LLM_016	ExtractionMaxRetriesError	Error raised when extraction max retries are exhausted.	oridecon-ai-llm
ORI_ERR_LLM_017	ModelRevisionMismatchError	Raised when the provider returns a model revision that violates the pin policy.	oridecon-ai-llm
ORI_ERR_LLM_018	LLMTimeoutError	Request exceeded the client timeout — recoverable by routing elsewhere. Retur…	oridecon-ai-llm
ORI_ERR_LLM_019	SchemaValidationError	Raised when parsed response fails validation.	oridecon-ai-llm
ORI_ERR_LLM_020	ModelManagerError	Base exception for model manager errors.	oridecon-ai-llm
ORI_ERR_LLM_021	ModelNotFoundError	Raised when a requested model is not found.	oridecon-ai-llm
ORI_ERR_LLM_022	ModelLoadError	Raised when a model fails to load.	oridecon-ai-llm
ORI_ERR_LLM_023	ModelUnloadError	Raised when a model fails to unload.	oridecon-ai-llm
ORI_ERR_LLM_024	ProviderConnectionError	Raised when connection to provider fails.	oridecon-ai-llm
ORI_ERR_LLM_025	OrchestratorError	Base orchestration error.	oridecon-ai-llm
ORI_ERR_LLM_026	NoSuitableModelError	No model found that meets the requirements.	oridecon-ai-llm

LOAD (1 codes)

Code	Class	Description	Package
ORI_ERR_LOAD_001	LoaderError	Raised when document loading fails in an expected, recoverable way. Extended …	oridecon-contracts

LOCK (2 codes)

Code	Class	Description	Package
ORI_ERR_LOCK_001	LockAcquisitionError	Raised when acquiring a lock fails.	oridecon-contracts
ORI_ERR_LOCK_002	LockNotHeldError	Raised when trying to operate on a lock that is not held.	oridecon-contracts

MAP (4 codes)

Code	Class	Description	Package
ORI_ERR_MAP_001	MappingError	Object mapping error.	oridecon-contracts
ORI_ERR_MAP_002	MappingError	Base exception for all object-mapping errors.	oridecon
ORI_ERR_MAP_003	MappingNotFoundError	Raised when no mapper is registered for a (source, destination) type pair.	oridecon
ORI_ERR_MAP_004	MappingExecutionError	Raised when a registered mapper raises an unexpected error during execution.	oridecon

MCP (8 codes)

Code	Class	Description	Package
ORI_ERR_MCP_001	MCPError	Base exception for all MCP errors.	oridecon-contracts
ORI_ERR_MCP_002	MCPTransportError	Transport-level error (connection, I/O). Raised when the MCP transport layer …	oridecon-contracts
ORI_ERR_MCP_003	MCPToolCallError	Tool call failed during MCP execution. Raised when a tool invocation fails, e…	oridecon-contracts
ORI_ERR_MCP_004	MCPResourceError	Resource read or list failed. Raised when a resource operation fails, such as…	oridecon-contracts
ORI_ERR_MCP_005	MCPProtocolError	Protocol violation (malformed message, invalid state). Raised when an MCP mes…	oridecon-contracts
ORI_ERR_MCP_006	MCPMethodNotFoundError	Unknown MCP method requested by client. Raised when the client requests an MC…	oridecon-contracts
ORI_ERR_MCP_007	MCPPromptError	Prompt retrieval or list failed. Raised when a prompt operation fails, such a…	oridecon-contracts
ORI_ERR_MCP_008	MCPInitializationError	MCP server initialization failed. Raised when the MCP server cannot be initia…	oridecon-contracts

MEM (8 codes)

Code	Class	Description	Package
ORI_ERR_MEM_001	AIMemoryError	Base for AI memory system errors. Extended in oridecon-ai-memory with specifi…	oridecon-contracts
ORI_ERR_MEM_002	ConsolidationError	Error raised during memory consolidation.	oridecon-contracts
ORI_ERR_MEM_003	StorageError	Error raised during memory storage operations.	oridecon-contracts
ORI_ERR_MEM_005	MemorySystemError	Base exception for memory operations.	oridecon-ai-memory
ORI_ERR_MEM_006	MemoryStoreError	Raised when a backend store operation fails.	oridecon-ai-memory
ORI_ERR_MEM_008	MemoryCapacityError	Raised when a memory store is at capacity and cannot accept new entries.	oridecon-ai-memory
ORI_ERR_MEM_009	EmbeddingError	Raised when generating or storing an embedding fails.	oridecon-ai-memory
ORI_ERR_MEM_010	FactExtractionError	Raised when entity/fact extraction from text fails.	oridecon-ai-memory

MM (8 codes)

Code	Class	Description	Package
ORI_ERR_MM_001	MultimediaError	Base exception for all multimedia-generation errors. Mirrors “AIError(Domain…	oridecon-contracts
ORI_ERR_MM_002	TTSError	Base for text-to-speech generation errors.	oridecon-contracts
ORI_ERR_MM_003	MusicGenerationError	Base for music/sound generation errors.	oridecon-contracts
ORI_ERR_MM_004	VideoGenerationError	Base for video generation errors.	oridecon-contracts
ORI_ERR_MM_005	ImageGenerationError	Base for still-image generation errors.	oridecon-contracts
ORI_ERR_MM_006	ProviderNotInstalledError	Raised eagerly at DI-resolution time when a configured provider’s optional ex…	oridecon-contracts
ORI_ERR_MM_007	UpscaleError	Base for image/video super-resolution errors.	oridecon-contracts
ORI_ERR_MM_008	BeatAnalysisError	Base for tempo/beat-detection errors.	oridecon-contracts

MM_BEAT (1 codes)

Code	Class	Description	Package
ORI_ERR_MM_BEAT_003	BeatAnalysisDecodeError	Audio could not be decoded, or was rejected before decoding. Covers undecodab…	oridecon-multimedia-beat

MM_IMAGE (2 codes)

Code	Class	Description	Package
ORI_ERR_MM_IMAGE_001	ImageTimeoutError	Raised when an image generation operation exceeds its timeout.	oridecon-multimedia-image
ORI_ERR_MM_IMAGE_002	ImageGenerationAuthenticationError	Raised when the image backend rejects the configured API credentials.	oridecon-multimedia-image

MM_MUSIC (1 codes)

Code	Class	Description	Package
ORI_ERR_MM_MUSIC_001	MusicGenerationAuthenticationError	Raised when the music backend rejects the configured API credentials.	oridecon-multimedia-music

MM_TTS (1 codes)

Code	Class	Description	Package
ORI_ERR_MM_TTS_002	TTSAuthenticationError	Invalid API key or credentials — infrastructure error, raised not wrapped.	oridecon-multimedia-tts

MM_UPSCALE (3 codes)

Code	Class	Description	Package
ORI_ERR_MM_UPSCALE_001	UpscaleAssetTooLargeError	Raised when an upscale source asset exceeds the byte cap. Also a “ValueError…	oridecon-multimedia-upscale
ORI_ERR_MM_UPSCALE_002	UpscaleUnsafeAssetURLError	Raised when an upscale source asset URI is not safe to request. Also a “Valu…	oridecon-multimedia-upscale
ORI_ERR_MM_UPSCALE_003	UpscaleAssetDownloadError	Raised when an upscale source asset fetch returns a non-200 response. Also a …	oridecon-multimedia-upscale

MM_VIDEO (6 codes)

Code	Class	Description	Package
ORI_ERR_MM_VIDEO_001	VideoTimeoutError	Raised when a video generation operation exceeds its timeout.	oridecon-multimedia-video
ORI_ERR_MM_VIDEO_002	VideoGenerationAuthenticationError	Raised when the video backend rejects the configured API credentials.	oridecon-multimedia-video
ORI_ERR_MM_VIDEO_003	VideoProcessingError	Raised when an ffmpeg processing operation fails.	oridecon-multimedia-video
ORI_ERR_MM_VIDEO_004	VideoAssetTooLargeError	Raised when a materialized asset exceeds the byte cap. Also a ValueError …	oridecon-multimedia-video
ORI_ERR_MM_VIDEO_005	VideoUnsafeAssetURLError	Raised when an asset URI is not safe to request. Also a ValueError so the…	oridecon-multimedia-video
ORI_ERR_MM_VIDEO_006	VideoAssetDownloadError	Raised when a remote asset download returns a non-200 response. Also a “Valu…	oridecon-multimedia-video

MOD (6 codes)

Code	Class	Description	Package
ORI_ERR_MOD_001	ModuleError	Module configuration or lifecycle error.	oridecon-contracts
ORI_ERR_MOD_002	ModuleImportError	A module imports a module that does not exist in the graph. Raised during mod…	oridecon-contracts
ORI_ERR_MOD_003	ModuleExportError	A module exports a type not provided by its providers. Raised during post-reg…	oridecon-contracts
ORI_ERR_MOD_004	ModuleCycleError	Circular dependency detected in the module import graph. Raised during module…	oridecon-contracts
ORI_ERR_MOD_005	ModuleVisibilityError	A provider depends on a service not visible to its module. Raised when a prov…	oridecon-contracts
ORI_ERR_MOD_006	ModuleDuplicateError	The same module appears twice with conflicting configurations. Raised when tw…	oridecon-contracts

MONITOR (8 codes)

Code	Class	Description	Package
ORI_ERR_MONITOR_001	MonitorError	Base exception for monitoring errors.	oridecon-monitor
ORI_ERR_MONITOR_002	BackendNotAvailableError	Raised when a required monitoring backend is not available.	oridecon-monitor
ORI_ERR_MONITOR_003	MetricNotFoundError	Raised when a requested metric is not found.	oridecon-monitor
ORI_ERR_MONITOR_004	InvalidMetricError	Raised when metric parameters are invalid.	oridecon-monitor
ORI_ERR_MONITOR_005	SpanError	Base exception for span-related errors.	oridecon-monitor
ORI_ERR_MONITOR_006	SpanNotFoundError	Raised when a requested span is not found.	oridecon-monitor
ORI_ERR_MONITOR_007	MonitorConfigurationError	Raised when monitoring configuration is invalid.	oridecon-monitor
ORI_ERR_MONITOR_008	PerformanceMonitorError	Base exception for performance monitoring errors.	oridecon-monitor

MW (10 codes)

Code	Class	Description	Package
ORI_ERR_MW_001	MiddlewareGuardError	Raised when a middleware guard denies access.	oridecon-contracts
ORI_ERR_MW_002	MiddlewareError	Base exception for infrastructure-level middleware errors.	oridecon
ORI_ERR_MW_003	MiddlewarePolicyError	Base exception for policy-level middleware rejections. Raised when middleware…	oridecon
ORI_ERR_MW_004	MiddlewareExecutionError	Raised when a middleware raises an unexpected error during execution.	oridecon
ORI_ERR_MW_005	MiddlewareConfigurationError	Raised when middleware is configured incorrectly.	oridecon
ORI_ERR_MW_006	MiddlewareChainError	Raised when the middleware chain cannot be assembled or traversed.	oridecon
ORI_ERR_MW_007	MiddlewareTimeoutError	Raised when a middleware exceeds its configured timeout.	oridecon
ORI_ERR_MW_008	MiddlewareAuthError	Raised when middleware-level authentication/authorization fails.	oridecon
ORI_ERR_MW_009	MiddlewareRateLimitError	Raised when middleware-level rate limiting is exceeded.	oridecon
ORI_ERR_MW_010	MiddlewareCircuitOpenError	Raised when the circuit breaker in middleware is open.	oridecon

NOSQL (7 codes)

Code	Class	Description	Package
ORI_ERR_NOSQL_001	NoSQLError	Base exception for all NoSQL operations.	oridecon-nosql
ORI_ERR_NOSQL_002	NoSQLConnectionError	Failed to connect to the document store.	oridecon-nosql
ORI_ERR_NOSQL_003	DocumentNotFoundError	Requested document does not exist.	oridecon-nosql
ORI_ERR_NOSQL_004	DuplicateKeyError	Insert/update violated a unique constraint.	oridecon-nosql
ORI_ERR_NOSQL_005	DocumentValidationError	Document failed schema validation.	oridecon-nosql
ORI_ERR_NOSQL_006	TransactionError	Multi-document transaction failed.	oridecon-nosql
ORI_ERR_NOSQL_007	NoSQLFilterError	Filter rejected by the operator/identifier validation guard.	oridecon-nosql

NOTIF (14 codes)

Code	Class	Description	Package
ORI_ERR_NOTIF_001	NotificationError	Base for expected, recoverable notification delivery failures. Attributes: ch…	oridecon-contracts
ORI_ERR_NOTIF_002	MailerError	Base mailer/email notification error.	oridecon-contracts
ORI_ERR_NOTIF_003	TwilioNotificationError	Twilio SMS delivery failure.	oridecon-notification
ORI_ERR_NOTIF_004	FCMNotificationError	FCM push notification delivery failure.	oridecon-notification
ORI_ERR_NOTIF_005	APNsNotificationError	APNs push notification delivery failure.	oridecon-notification
ORI_ERR_NOTIF_006	SMTPMailerError	SMTP-specific delivery failure (rejection, auth error, etc.).	oridecon-notification
ORI_ERR_NOTIF_007	SendGridMailerError	SendGrid API delivery failure.	oridecon-notification
ORI_ERR_NOTIF_008	InboxError	Base exception for all inbox submodule errors.	oridecon-notification
ORI_ERR_NOTIF_009	InboxMessageNotFoundError	Raised when a requested inbox message does not exist.	oridecon-notification
ORI_ERR_NOTIF_010	InboxPermissionError	Raised when a user attempts to access another user’s inbox messages.	oridecon-notification
ORI_ERR_NOTIF_011	WebPushNotificationError	Web Push notification delivery failure.	oridecon-notification
ORI_ERR_NOTIF_012	WhatsAppNotificationError	WhatsApp delivery failure via Twilio provider.	oridecon-notification
ORI_ERR_NOTIF_013	WhatsAppMetaNotificationError	WhatsApp delivery failure via Meta provider.	oridecon-notification
ORI_ERR_NOTIF_014	SlackNotificationError	Slack notification delivery failure.	oridecon-notification

OBS (4 codes)

Code	Class	Description	Package
ORI_ERR_OBS_001	ObservabilityError	Base exception for all observability-related errors.	oridecon-ai-observability
ORI_ERR_OBS_002	HealthCheckError	Raised when a health check infrastructure operation fails.	oridecon-ai-observability
ORI_ERR_OBS_003	MetricsError	Raised when a metrics recording or retrieval operation fails.	oridecon-ai-observability
ORI_ERR_OBS_004	TracingError	Raised when a tracing operation fails.	oridecon-ai-observability

PIPE (2 codes)

Code	Class	Description	Package
ORI_ERR_PIPE_001	PipelineExecutionError	Error raised during pipeline execution.	oridecon-contracts
ORI_ERR_PIPE_002	PipelineStepError	Error raised by a pipeline step.	oridecon-contracts

PROMPT (7 codes)

Code	Class	Description	Package
ORI_ERR_PROMPT_001	PromptError	Base exception for all prompt-related errors.	oridecon-ai-prompt
ORI_ERR_PROMPT_002	PromptRenderError	Raised when a template cannot be rendered. Common causes: missing required va…	oridecon-ai-prompt
ORI_ERR_PROMPT_003	PromptValidationError	Raised when a variable fails validation (type, length, allowed values).	oridecon-ai-prompt
ORI_ERR_PROMPT_004	PromptNotFoundError	Raised when a named template is not found in the registry.	oridecon-ai-prompt
ORI_ERR_PROMPT_005	PromptVersionError	Raised on version conflicts or invalid rollback targets.	oridecon-ai-prompt
ORI_ERR_PROMPT_006	PromptConfigError	Raised when the prompt configuration is invalid.	oridecon-ai-prompt
ORI_ERR_PROMPT_007	OptimizationError	Raised when prompt optimization fails.	oridecon-ai-prompt

PROV (1 codes)

Code	Class	Description	Package
ORI_ERR_PROV_001	ProviderError	Provider configuration or lifecycle error.	oridecon-contracts

QE (1 codes)

Code	Class	Description	Package
ORI_ERR_QE_001	QueryEngineError	Raised when query engine operations fail in an expected, recoverable way.	oridecon-contracts

QUEUE (7 codes)

Code	Class	Description	Package
ORI_ERR_QUEUE_001	QueueError	Base for expected, recoverable queue / bus failures. Attributes: backend: Nam…	oridecon-contracts
ORI_ERR_QUEUE_002	RedisQueueError	Redis queue failure.	oridecon-queue
ORI_ERR_QUEUE_003	RabbitMQQueueError	RabbitMQ queue failure.	oridecon-queue
ORI_ERR_QUEUE_004	KafkaQueueError	Kafka queue failure.	oridecon-queue
ORI_ERR_QUEUE_005	SQSQueueError	SQS queue failure.	oridecon-queue
ORI_ERR_QUEUE_006	AzureServiceBusQueueError	Azure Service Bus queue failure.	oridecon-queue
ORI_ERR_QUEUE_007	GCPPubSubQueueError	GCP Pub/Sub queue failure.	oridecon-queue

RAG (14 codes)

Code	Class	Description	Package
ORI_ERR_RAG_001	RAGError	Base for RAG pipeline errors. Extended in oridecon-ai-rag with specific failu…	oridecon-contracts
ORI_ERR_RAG_002	RetrievalError	Error raised during document retrieval.	oridecon-contracts
ORI_ERR_RAG_003	SynthesisError	Error raised during response synthesis.	oridecon-contracts
ORI_ERR_RAG_004	ChunkingError	Error raised during document chunking.	oridecon-contracts
ORI_ERR_RAG_005	RAGError	Base exception for RAG errors.	oridecon-ai-rag
ORI_ERR_RAG_006	PreprocessingError	Raised when document preprocessing fails.	oridecon-ai-rag
ORI_ERR_RAG_010	MultimodalError	Base exception for multimodal processing errors.	oridecon-ai-rag
ORI_ERR_RAG_011	AudioLoaderError	Raised when audio loading fails.	oridecon-ai-rag
ORI_ERR_RAG_012	VideoLoaderError	Raised when video loading fails.	oridecon-ai-rag
ORI_ERR_RAG_013	ImageLoaderError	Raised when image loading fails.	oridecon-ai-rag
ORI_ERR_RAG_014	CLIPEmbeddingError	Raised when CLIP embedding computation fails.	oridecon-ai-rag
ORI_ERR_RAG_015	MissingCitationsError	Raised when a pipeline with require_citations=True produces no citations.	oridecon-ai-rag
ORI_ERR_RAG_016	UnsupportedFormatError	Raised when no loader is registered for the given file format or URL.	oridecon-ai-rag
ORI_ERR_RAG_017	MissingOptionalDependencyError	—	oridecon-ai-rag

REG (3 codes)

Code	Class	Description	Package
ORI_ERR_REG_001	RegistryError	Base exception for registry errors.	oridecon-contracts
ORI_ERR_REG_002	RegistryKeyError	Raised when a key is not found in a registry.	oridecon-contracts
ORI_ERR_REG_003	RegistryAlreadyExistsError	Raised when attempting to register a duplicate key in a registry.	oridecon-contracts

RES (11 codes)

Code	Class	Description	Package
ORI_ERR_RES_001	ResilienceError	Base resilience error.	oridecon-contracts
ORI_ERR_RES_002	RetryError	Retry operation error.	oridecon-contracts
ORI_ERR_RES_003	CircuitBreakerError	Circuit breaker error.	oridecon-contracts
ORI_ERR_RES_004	BulkheadError	Bulkhead/rejection error.	oridecon-contracts
ORI_ERR_RES_005	FallbackError	Fallback execution error.	oridecon-contracts
ORI_ERR_RES_006	RetryExhaustedError	All retry attempts have been exhausted.	oridecon-contracts
ORI_ERR_RES_007	CircuitOpenError	Circuit breaker is open and rejecting requests.	oridecon-contracts
ORI_ERR_RES_008	RetryExhaustedError	All retry attempts exhausted.	oridecon-resilience
ORI_ERR_RES_009	CircuitOpenError	Circuit breaker is open.	oridecon-resilience
ORI_ERR_RES_010	BulkheadRejectedError	Bulkhead rejected due to capacity limits.	oridecon-resilience
ORI_ERR_RES_011	ResilienceTimeoutError	Resilience operation timed out. Inherits from both ResilienceError and built-…	oridecon-resilience

RESULT (1 codes)

Code	Class	Description	Package
ORI_ERR_RESULT_002	UnwrapError	Raised when unwrap() or unwrap_err() is called on the wrong variant. Provides…	oridecon-contracts

RET (1 codes)

Code	Class	Description	Package
ORI_ERR_RET_001	RetrieverError	Base for retriever errors. Raised when document retrieval fails in an expecte…	oridecon-contracts

RUN (1 codes)

Code	Class	Description	Package
ORI_ERR_RUN_001	RunnableError	Recoverable composition failure (input shape, parser error, retry budget exce…	oridecon-contracts

SEARCH (10 codes)

Code	Class	Description	Package
ORI_ERR_SEARCH_001	SearchError	Base exception for search operations.	oridecon-search
ORI_ERR_SEARCH_002	IndexNotFoundError	Raised when index is not found.	oridecon-search
ORI_ERR_SEARCH_003	BackendError	Raised when search backend encounters an error.	oridecon-search
ORI_ERR_SEARCH_004	SearchValidationError	Raised when search query validation fails.	oridecon-search
ORI_ERR_SEARCH_005	TransformationError	Raised when document transformation fails.	oridecon-search
ORI_ERR_SEARCH_006	CacheError	Raised when search cache operation fails.	oridecon-search
ORI_ERR_SEARCH_007	QueryError	Raised when search query execution fails.	oridecon-search
ORI_ERR_SEARCH_008	ConfigurationError	Raised when search configuration is invalid.	oridecon-search
ORI_ERR_SEARCH_009	SearchIndexError	Raised when search index operation fails.	oridecon-search
ORI_ERR_SEARCH_010	SchedulerError	Raised when search scheduler operation fails.	oridecon-search

SEC (11 codes)

Code	Class	Description	Package
ORI_ERR_SEC_001	SecurityError	Base security error for the Oridecon security subsystem.	oridecon-contracts
ORI_ERR_SEC_002	GuardDeniedError	Raised when a GuardChain denies the request. Attributes: guard: The name or t…	oridecon-contracts
ORI_ERR_SEC_003	InputSanitizationError	Raised when sanitization fails due to unrecoverable input structure.	oridecon-contracts
ORI_ERR_SEC_004	CORSViolationError	Raised when a request violates the configured CORS policy. Attributes: origin…	oridecon-contracts
ORI_ERR_SEC_005	SecretAccessError	Raised when the caller lacks permission to access or modify a secret. Attribu…	oridecon-contracts
ORI_ERR_SEC_006	SecurityError	Base exception for all security-module errors.	oridecon
ORI_ERR_SEC_008	SecretAccessError	Raised when access to a secret is denied.	oridecon
ORI_ERR_SEC_009	EncryptionError	Raised when field-level encryption fails.	oridecon
ORI_ERR_SEC_010	DecryptionError	Raised when field-level decryption fails.	oridecon
ORI_ERR_SEC_011	SecretError	Base exception for secret store errors.	oridecon
ORI_ERR_SEC_012	RateLimitExceededError	Raised when a client has exceeded the configured rate limit. Carries “retry_…	oridecon-auth

SECRET (7 codes)

Code	Class	Description	Package
ORI_ERR_SECRET_001	SecretsError	Base exception for all secrets-domain errors.	oridecon-secrets
ORI_ERR_SECRET_002	SecretNotFoundError	Raised when a requested secret does not exist.	oridecon-secrets
ORI_ERR_SECRET_003	SecretAccessError	Raised when access to a secret is denied.	oridecon-secrets
ORI_ERR_SECRET_004	SecretRotationError	Raised when automatic rotation of a secret fails.	oridecon-secrets
ORI_ERR_SECRET_005	SecretBackendError	Raised when the underlying secret backend (e.g. Vault) fails.	oridecon-secrets
ORI_ERR_SECRET_006	SecretConfigError	Raised when secrets subsystem configuration is invalid.	oridecon-secrets
ORI_ERR_SECRET_007	SecretBackendUnavailableError	Backend auth/network/permission failure — distinct from secret-not-found.	oridecon-secrets

SERIAL (4 codes)

Code	Class	Description	Package
ORI_ERR_SERIAL_001	SerializationError	Serialization/deserialization error.	oridecon-contracts
ORI_ERR_SERIAL_002	SerializationError	JSON serialisation or deserialisation failed. Raised by: - JsonSerializer…	oridecon
ORI_ERR_SERIAL_003	SerializationError	Base exception for serialization and deserialization failures. Extensions sho…	oridecon
ORI_ERR_SERIAL_004	NegotiationError	Raised when no serializer can be negotiated for a given Accept header.	oridecon

SES (12 codes)

Code	Class	Description	Package
ORI_ERR_SES_001	SessionError	Base class for session-related errors.	oridecon-contracts
ORI_ERR_SES_002	TaskCancelledError	Error raised when a task is cancelled.	oridecon-contracts
ORI_ERR_SES_003	TaskError	Base class for task execution errors.	oridecon-contracts
ORI_ERR_SES_004	TaskTimeoutError	Error raised when a task times out.	oridecon-contracts
ORI_ERR_SES_005	TaskValidationError	Error raised when task input validation fails.	oridecon-contracts
ORI_ERR_SES_006	SessionError	Base error for all session operations. All session-specific exceptions inheri…	oridecon-ai-session
ORI_ERR_SES_007	SessionNotFoundError	Raised when a session cannot be found by its ID. Args: session_id: The ID of …	oridecon-ai-session
ORI_ERR_SES_008	SessionClosedError	Raised when an operation is attempted on a closed session. Args: session_id: …	oridecon-ai-session
ORI_ERR_SES_009	SessionExpiredError	Raised when an operation is attempted on an expired session. Args: session_id…	oridecon-ai-session
ORI_ERR_SES_010	CheckpointNotFoundError	Raised when a checkpoint cannot be found by its ID. Args: checkpoint_id: The …	oridecon-ai-session
ORI_ERR_SES_011	SessionTransitionError	Raised when an invalid state transition is attempted. Args: session_id: The s…	oridecon-ai-session
ORI_ERR_SES_012	SessionCapacityError	Raised when a session limit is exceeded. Args: detail: Human-readable descrip…	oridecon-ai-session

SKILL (8 codes)

Code	Class	Description	Package
ORI_ERR_SKILL_001	SkillError	Base for skill execution errors. Extended in oridecon-ai-skills with specific…	oridecon-contracts
ORI_ERR_SKILL_002	SkillNotFoundError	Raised when a requested skill is not registered.	oridecon-ai-skills
ORI_ERR_SKILL_003	SkillAlreadyRegisteredError	Raised when a skill is registered under a name that already exists.	oridecon-ai-skills
ORI_ERR_SKILL_004	SkillValidationError	Raised when skill parameter validation fails.	oridecon-ai-skills
ORI_ERR_SKILL_005	SkillPermissionDeniedError	Raised when the caller lacks required permissions for a skill.	oridecon-ai-skills
ORI_ERR_SKILL_006	SkillTimeoutError	Raised when skill execution exceeds the configured timeout.	oridecon-ai-skills
ORI_ERR_SKILL_007	SkillRoutingError	Raised when a SkillRouter finds no matching route.	oridecon-ai-skills
ORI_ERR_SKILL_008	SkillExecutionError	Raised when a skill execution fails after all retry attempts.	oridecon-ai-skills

SQL (38 codes)

Code	Class	Description	Package
ORI_ERR_SQL_001	DatabaseConnectionError	Base for all connection-related failures. Attributes: host: The database host…	oridecon-sql
ORI_ERR_SQL_002	ConnectionRefusedError	Server actively refused the connection.	oridecon-sql
ORI_ERR_SQL_003	ConnectionTimeoutError	Connection attempt timed out.	oridecon-sql
ORI_ERR_SQL_004	ConnectionPoolError	Connection pool exhausted — no connections available within timeout.	oridecon-sql
ORI_ERR_SQL_005	QueryError	Base for query execution failures. Attributes: sql: The SQL query that failed…	oridecon-sql
ORI_ERR_SQL_006	QuerySyntaxError	The SQL query has a syntax error.	oridecon-sql
ORI_ERR_SQL_007	ParameterBindingError	Failed to bind parameters to a query.	oridecon-sql
ORI_ERR_SQL_008	IntegrityError	Base for constraint violation errors. Attributes: constraint: The constraint …	oridecon-sql
ORI_ERR_SQL_009	DuplicateKeyError	Unique constraint or primary key violated.	oridecon-sql
ORI_ERR_SQL_010	ForeignKeyError	Foreign key constraint violated.	oridecon-sql
ORI_ERR_SQL_011	NotNullViolationError	NOT NULL constraint violated. Attributes: column: The column that triggered t…	oridecon-sql
ORI_ERR_SQL_012	CheckConstraintError	CHECK constraint violated.	oridecon-sql
ORI_ERR_SQL_013	TransactionError	Base for transaction-related failures.	oridecon-sql
ORI_ERR_SQL_014	SerializationError	Serialization failure (optimistic concurrency conflict).	oridecon-sql
ORI_ERR_SQL_015	OptimisticLockError	Raised when an optimistic lock check fails on UPDATE. Indicates a concurrent …	oridecon-sql
ORI_ERR_SQL_016	TransactionRollbackError	Transaction was rolled back (not by the application).	oridecon-sql
ORI_ERR_SQL_017	LockError	Raised when a database lock cannot be acquired.	oridecon-sql
ORI_ERR_SQL_018	DeadlockError	Database deadlock detected. Inherits from :class:TransactionError because d…	oridecon-sql
ORI_ERR_SQL_019	SchemaError	Base for schema-related errors.	oridecon-sql
ORI_ERR_SQL_020	TableNotFoundError	Referenced table does not exist.	oridecon-sql
ORI_ERR_SQL_021	ColumnNotFoundError	Referenced column does not exist.	oridecon-sql
ORI_ERR_SQL_022	DatabaseTimeoutError	Database operation timed out.	oridecon-sql
ORI_ERR_SQL_023	RepositoryError	RepositoryProtocol-level operation failure.	oridecon-sql
ORI_ERR_SQL_024	UnitOfWorkError	Raised when unit of work operation fails.	oridecon-sql
ORI_ERR_SQL_025	DriverError	Wraps underlying database driver exceptions. Preserves the original exception…	oridecon-sql
ORI_ERR_SQL_026	DataError	Base exception for data access layer failures.	oridecon-sql
ORI_ERR_SQL_027	DataQueryError	Raised when a query cannot be built or compiled. Args: message: Explanation o…	oridecon-sql
ORI_ERR_SQL_028	PaginationError	Raised when pagination parameters are invalid. Args: message: Explanation of …	oridecon-sql
ORI_ERR_SQL_029	EntityNotFoundError	Signals that a required entity does not exist. RepositoryProtocol implementat…	oridecon-sql
ORI_ERR_SQL_030	DataRepositoryError	Raised when a repository operation fails unexpectedly. Args: message: Explana…	oridecon-sql
ORI_ERR_SQL_031	CursorError	Raised when a cursor cannot be encoded or decoded. Args: message: Explanation…	oridecon-sql
ORI_ERR_SQL_032	MigrationDependencyError	Raised when migration dependencies are not satisfied.	oridecon-sql
ORI_ERR_SQL_033	MigrationExecutionError	Raised when migration execution fails.	oridecon-sql
ORI_ERR_SQL_034	MigrationNotFoundError	Raised when a migration is not found.	oridecon-sql
ORI_ERR_SQL_035	MigrationValidationError	Raised when migration validation fails.	oridecon-sql
ORI_ERR_SQL_036	ProtocolValidationError	Raised when object doesn’t implement protocol.	oridecon-sql
ORI_ERR_SQL_037	MappingError	Exception raised when entity mapping fails.	oridecon-sql
ORI_ERR_SQL_038	TenantScopingError	Raised when a tenant-scoped operation runs without an active tenant. Mirrors …	oridecon-sql

STORE (8 codes)

Code	Class	Description	Package
ORI_ERR_STORE_001	StorageError	Base exception for storage errors.	oridecon-contracts
ORI_ERR_STORE_002	StorageFileNotFoundError	Raised when file is not found.	oridecon-storage
ORI_ERR_STORE_003	StorageUnsupportedOperationError	Raised when the requested operation is not supported by the storage driver.	oridecon-contracts
ORI_ERR_STORE_004	TransactionError	Raised when a transaction operation fails.	oridecon-storage
ORI_ERR_STORE_005	QuotaExceededError	Raised when a storage quota or size limit is exceeded.	oridecon-storage
ORI_ERR_STORE_006	InvalidPathError	Raised when a path is invalid or attempts directory traversal.	oridecon-storage
ORI_ERR_STORE_007	StorageUnavailableError	Raised when the storage backend is not reachable or unavailable.	oridecon-storage
ORI_ERR_STORE_008	ChecksumMismatchError	Raised when a file’s checksum does not match the expected value.	oridecon-storage

TASK (11 codes)

Code	Class	Description	Package
ORI_ERR_TASK_001	TaskQueueError	Base class for expected, recoverable task queue failures. All subtypes indica…	oridecon-contracts
ORI_ERR_TASK_002	QueueFullError	The queue has reached its maximum capacity and cannot accept new tasks. The c…	oridecon-tasks
ORI_ERR_TASK_003	TaskError	Base exception for all task-related errors	oridecon-tasks
ORI_ERR_TASK_004	TaskNotFoundError	Raised when a task cannot be found	oridecon-tasks
ORI_ERR_TASK_005	TaskTimeoutError	Raised when a task execution exceeds timeout	oridecon-tasks
ORI_ERR_TASK_006	TaskCancelledError	Raised when a task is cancelled	oridecon-tasks
ORI_ERR_TASK_007	TaskExecutionError	Raised when a task execution fails	oridecon-tasks
ORI_ERR_TASK_008	TaskValidationError	Raised when task parameters are invalid	oridecon-tasks
ORI_ERR_TASK_009	DuplicateTaskError	Raised when a duplicate task is detected	oridecon-tasks
ORI_ERR_TASK_010	TaskDependencyCycleError	Raised at registration time when a dependency cycle is detected. The schedule…	oridecon-tasks
ORI_ERR_TASK_011	TaskRegistrationError	Raised when a scheduled or handler task fails to register.	oridecon-tasks

TENANT (9 codes)

Code	Class	Description	Package
ORI_ERR_TENANT_001	TenantError	Base class for all tenancy-related domain errors.	oridecon-contracts
ORI_ERR_TENANT_002	TenantNotFoundError	Raised when a requested tenant does not exist.	oridecon-contracts
ORI_ERR_TENANT_003	TenantInactiveError	Raised when an operation is attempted on an inactive tenant.	oridecon-contracts
ORI_ERR_TENANT_004	TenantProvisioningError	Raised when tenant provisioning (isolation setup) fails.	oridecon-contracts
ORI_ERR_TENANT_005	TenantResolutionError	Raised when tenant resolution fails unexpectedly.	oridecon-contracts
ORI_ERR_TENANT_006	TenantConfigError	Raised when per-tenant configuration access or mutation fails.	oridecon-contracts
ORI_ERR_TENANT_007	TenantSlugConflictError	Raised when a tenant slug is already in use.	oridecon-contracts
ORI_ERR_TENANT_008	TenantSuspendedError	Raised when an operation is attempted on a suspended tenant.	oridecon-contracts
ORI_ERR_TENANT_009	MigrationError	Raised when a tenant tier migration fails.	oridecon-contracts

TEST (12 codes)

Code	Class	Description	Package
ORI_ERR_TEST_001	TestingError	Base exception for oridecon-testing operations.	oridecon-testing
ORI_ERR_TEST_002	TokenBudgetExceededError	Raised when an AITestClient operation would exceed the configured token budge…	oridecon-testing
ORI_ERR_TEST_003	MemoryBackendError	Base exception for all memory backend errors.	oridecon-testing
ORI_ERR_TEST_004	CommandBusError	Raised when a command bus operation fails.	oridecon-testing
ORI_ERR_TEST_005	CommandHandlerNotFoundError	Raised when no handler is registered for a specific command type.	oridecon-testing
ORI_ERR_TEST_006	DuplicateHandlerError	Raised when a handler is already registered for a command type.	oridecon-testing
ORI_ERR_TEST_007	CommandError	Wraps a handler exception for Result-based command dispatch.	oridecon-testing
ORI_ERR_TEST_008	QueryBusError	Raised when a query bus operation fails.	oridecon-testing
ORI_ERR_TEST_009	QueryHandlerNotFoundError	Raised when no handler is registered for a specific query type.	oridecon-testing
ORI_ERR_TEST_010	QueryDuplicateHandlerError	Raised when a handler is already registered for a query type.	oridecon-testing
ORI_ERR_TEST_011	ConfigurationError	Raised when a require_stub module is loaded via configure() in test mode. Thi…	oridecon-testing
ORI_ERR_TEST_012	SnapshotMismatchError	Raised when a value does not match the stored snapshot.	oridecon-testing

UI (1 codes)

Code	Class	Description	Package
ORI_ERR_UI_001	UIError	Base exception for all UI-domain errors.	oridecon-ui

VAL (4 codes)

Code	Class	Description	Package
ORI_ERR_VAL_001	FieldError	A single field-level validation error. Used to represent validation failures …	oridecon-contracts
ORI_ERR_VAL_002	ValidationError	Data validation error.	oridecon-contracts
ORI_ERR_VAL_003	ValidationError	Input validation against rules failed. Raised by: - “ValidatorImpl.validate(…	oridecon
ORI_ERR_VAL_004	ValidationSystemError	Base exception for validation system/pipeline failures. Distinct from :class:…	oridecon

VEC (15 codes)

Code	Class	Description	Package
ORI_ERR_VEC_001	VectorError	Base exception for vector store errors. Extends InfrastructureError because v…	oridecon-contracts
ORI_ERR_VEC_002	VectorStoreError	Exception raised during vector store operations (CRUD, search).	oridecon-contracts
ORI_ERR_VEC_003	EmbeddingError	Exception raised during embedding generation or retrieval.	oridecon-contracts
ORI_ERR_VEC_004	VectorIndexError	Exception raised during vector index creation or management.	oridecon-contracts
ORI_ERR_VEC_005	VectorError	Base exception for all vector store operations.	oridecon-vector
ORI_ERR_VEC_006	VectorConnectionError	Failed to connect to the vector store.	oridecon-vector
ORI_ERR_VEC_007	CollectionNotFoundError	Requested collection does not exist.	oridecon-vector
ORI_ERR_VEC_008	CollectionAlreadyExistsError	Attempted to create a collection that already exists.	oridecon-vector
ORI_ERR_VEC_009	DimensionMismatchError	Vector dimensionality does not match the collection.	oridecon-vector
ORI_ERR_VEC_010	VectorConfigError	Invalid vector store configuration.	oridecon-vector
ORI_ERR_VEC_011	FilterCompilationError	Failed to compile a metadata filter for the target backend.	oridecon-vector
ORI_ERR_VEC_012	VectorUpsertError	Failed to upsert vectors.	oridecon-vector
ORI_ERR_VEC_013	VectorSearchError	Failed to execute similarity search.	oridecon-vector
ORI_ERR_VEC_014	VectorDeleteError	Failed to delete vectors.	oridecon-vector
ORI_ERR_VEC_015	VectorTimeoutError	Vector store operation timed out.	oridecon-vector

WEB (14 codes)

Code	Class	Description	Package
ORI_ERR_WEB_001	WebError	Web layer error.	oridecon-contracts
ORI_ERR_WEB_002	HttpStatusError	Raised by :meth:HttpResponse.raise_for_status for 4xx/5xx responses. Attrib…	oridecon-contracts
ORI_ERR_WEB_003	NotFoundError	404 Not Found.	oridecon-web
ORI_ERR_WEB_004	BadRequestError	400 Bad Request.	oridecon-web
ORI_ERR_WEB_005	UnauthorizedError	401 Unauthorized.	oridecon-web
ORI_ERR_WEB_006	ForbiddenError	403 Forbidden.	oridecon-web
ORI_ERR_WEB_007	MethodNotAllowedError	405 Method Not Allowed.	oridecon-web
ORI_ERR_WEB_008	ConflictError	409 Conflict.	oridecon-web
ORI_ERR_WEB_009	UnprocessableEntityError	422 Unprocessable Entity.	oridecon-web
ORI_ERR_WEB_010	InternalServerError	500 Internal Server Error.	oridecon-web
ORI_ERR_WEB_011	DependencyResolutionError	500 Dependency Resolution Error.	oridecon-web
ORI_ERR_WEB_012	RateLimitError	429 Too Many Requests.	oridecon-web
ORI_ERR_WEB_013	TooManyConnectionsError	503 Service Unavailable — connection limit reached. Raised when a streaming e…	oridecon-web
ORI_ERR_WEB_014	HTTPError	Base HTTP error, compatible with OrideconError.	oridecon-web

WEBHOOK (6 codes)

Code	Class	Description	Package
ORI_ERR_WEBHOOK_001	WebhookError	Base exception for webhook domain operations.	oridecon-contracts
ORI_ERR_WEBHOOK_002	SubscriptionNotFoundError	Raised when a subscription ID is not found.	oridecon-webhook
ORI_ERR_WEBHOOK_003	SubscriptionInactiveError	Raised when attempting to deliver to a deactivated subscription.	oridecon-webhook
ORI_ERR_WEBHOOK_004	InvalidWebhookURLError	Raised when a subscription URL fails validation.	oridecon-webhook
ORI_ERR_WEBHOOK_005	DeliveryAttemptNotFoundError	Raised when a delivery attempt ID is not found.	oridecon-webhook
ORI_ERR_WEBHOOK_006	SecretRotationError	Raised when secret rotation fails.	oridecon-webhook

WF (22 codes)

Code	Class	Description	Package
ORI_ERR_WF_001	WorkflowError	Base for workflow execution errors. Raised when a workflow graph execution fa…	oridecon-contracts
ORI_ERR_WF_002	SagaStepError	Represents a recoverable failure from a single saga step action. SagaProtocol…	oridecon-contracts
ORI_ERR_WF_003	WorkflowError	Base exception for workflow orchestration errors.	oridecon-workflow
ORI_ERR_WF_004	WorkflowNotFoundError	Raised when a workflow definition cannot be found.	oridecon-workflow
ORI_ERR_WF_005	WorkflowStateError	Raised when a workflow is in an invalid state for the requested operation.	oridecon-workflow
ORI_ERR_WF_006	WorkflowStepError	Raised when a workflow step fails to execute.	oridecon-workflow
ORI_ERR_WF_007	WorkflowTimeoutError	Raised when a workflow or step exceeds its timeout.	oridecon-workflow
ORI_ERR_WF_008	WorkflowCompensationError	Raised when workflow compensation/rollback fails.	oridecon-workflow
ORI_ERR_WF_009	SagaVersionMismatchError	Raised when a persisted saga state version is incompatible with the current c…	oridecon-contracts
ORI_ERR_WF_010	WorkflowVersionMismatchError	Raised when resuming a workflow instance with a mismatched definition version…	oridecon-workflow
ORI_ERR_WF_011	GraphExecutionError	Base exception for graph workflow engine operations. Args: message: Human-rea…	oridecon-workflow
ORI_ERR_WF_012	NodeExecutionError	A graph node’s execute() method failed. Args: message: Human-readable error d…	oridecon-workflow
ORI_ERR_WF_013	CycleDetectedError	Graph engine exceeded max_iterations (likely cycle). Args: iterations: Number…	oridecon-workflow
ORI_ERR_WF_014	GraphTimeoutError	Graph workflow execution exceeded total timeout. Args: timeout: The configure…	oridecon-workflow
ORI_ERR_WF_015	GraphValidationError	Graph structure validation failed.	oridecon-workflow
ORI_ERR_WF_016	HumanInputRequiredError	Raised by HumanNode to pause execution awaiting human input. Args: prompt: Te…	oridecon-workflow
ORI_ERR_WF_017	StateError	Raised when an invalid state transition is attempted. Attributes: event: The …	oridecon-workflow
ORI_ERR_WF_018	StateConcurrencyError	Raised when optimistic version checks fail during a transition.	oridecon-workflow
ORI_ERR_WF_019	SagaError	Raised when a saga step fails after compensation has been attempted. Attribut…	oridecon
ORI_ERR_WF_020	BulkOperationError	Base exception for bulk operation errors.	oridecon-workflow
ORI_ERR_WF_021	BulkOperationTimeoutError	Raised when a bulk operation times out.	oridecon-workflow
ORI_ERR_WF_022	BulkOperationCancelledError	Raised when a bulk operation is cancelled.	oridecon-workflow