Error Codes

Date: 2026-05-31 Total registered codes: 533 Total domains: 65 Total packages contributing codes: 36

This is the authoritative registry of all LEX_ERR_* error codes in the Lexigram 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 LEX_ERR_<DOMAIN>_<NNN>.

---

1. Domain Summary

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

---

2. Full Registry (by Package)

lexigram-contracts (149 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_ADMIN_001	AdminError	Base exception for all admin-domain errors. Extended by leaf exceptions in lexigram-admin.	lexigram-contracts/src/lexigram/contracts/admin/errors.py	LexigramError
LEX_ERR_AGT_001	AgentError	Base exception for all agent errors.	lexigram-contracts/src/lexigram/contracts/ai/agents.py	LexigramError
LEX_ERR_AGT_002	ToolError	Base exception for tool errors.	lexigram-contracts/src/lexigram/contracts/ai/agents.py	AgentError
LEX_ERR_AGT_003	StrategyError	Reasoning strategy failed. Raised when the agent’s strategy encounters an error during reasoning …	lexigram-contracts/src/lexigram/contracts/ai/agents.py	AgentError
LEX_ERR_AI_001	AIError	Base exception for all AI-domain errors. This is the catch-all for AI operations that fail in exp…	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	DomainError
LEX_ERR_AI_002	ExtractionError	Base for structured extraction errors. Used in StructuredExtractorProtocol.extract() return t…	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_AI_003	MetricsCollectionError	Error raised during metrics collection.	lexigram-contracts/src/lexigram/contracts/observability/ai.py	LexigramError
LEX_ERR_AI_004	TracingError	Error raised during tracing operations.	lexigram-contracts/src/lexigram/contracts/observability/ai.py	LexigramError
LEX_ERR_AUTH_001	AuthError	Base exception for all auth-domain errors. This is the catch-all for authentication and authoriza…	lexigram-contracts/src/lexigram/contracts/auth/exceptions.py	DomainError
LEX_ERR_AUTH_002	TokenError	Base class for expected, recoverable token domain failures. All subtypes indicate situations the …	lexigram-contracts/src/lexigram/contracts/auth/exceptions.py	DomainError
LEX_ERR_AUTH_003	VerificationError	Base class for expected, recoverable account-verification failures. All subtypes signal situation…	lexigram-contracts/src/lexigram/contracts/auth/exceptions.py	DomainError
LEX_ERR_CACHE_001	CacheError	Base exception for all cache-domain errors. This is an expected, recoverable error that cache cli…	lexigram-contracts/src/lexigram/contracts/infra/cache/exceptions.py	DomainError
LEX_ERR_CACHE_002	CacheKeyNotFoundError	Raised when cache key is not found.	lexigram-contracts/src/lexigram/contracts/infra/cache/exceptions.py	CacheError
LEX_ERR_CACHE_003	CacheWriteError	Raised when cache write fails.	lexigram-contracts/src/lexigram/contracts/infra/cache/exceptions.py	CacheError
LEX_ERR_CFG_001	ConfigurationError	Developer configuration or runtime misconfiguration errors. Supports optional structured validati…	lexigram-contracts/src/lexigram/contracts/exceptions/config.py	LexigramError
LEX_ERR_CORE_001	LexigramError	Root exception for the entire Lexigram ecosystem. All Lexigram exceptions inherit from this class…	lexigram-contracts/src/lexigram/contracts/exceptions/base.py	Exception
LEX_ERR_DB_001	DatabaseError	Database-related error (infrastructure-level).	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	InfrastructureError
LEX_ERR_DB_002	MigrationError	Database migration error.	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	InfrastructureError
LEX_ERR_DB_003	IntegrityError	Raised when a database integrity constraint is violated.	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	DatabaseError
LEX_ERR_DB_004	ConstraintError	Raised when a generic database constraint is violated.	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	IntegrityError
LEX_ERR_DB_005	DuplicateKeyError	Raised when a unique-key constraint is violated (duplicate record).	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	ConstraintError
LEX_ERR_DB_006	UnitOfWorkError	Raised when a unit-of-work operation fails or is used incorrectly.	lexigram-contracts/src/lexigram/contracts/data/exceptions.py	LexigramError
LEX_ERR_DB_007	DataError	Base exception for all data-domain errors. This is an expected, recoverable error that data clien…	lexigram-contracts/src/lexigram/contracts/data/exceptions.py	DomainError
LEX_ERR_DB_008	DataNotFoundError	Raised when data item is not found.	lexigram-contracts/src/lexigram/contracts/data/exceptions.py	DataError
LEX_ERR_DB_009	DataValidationError	Raised when data validation fails.	lexigram-contracts/src/lexigram/contracts/data/exceptions.py	DataError
LEX_ERR_DB_010	InvalidIdentifierError	Raised when an SQL identifier fails validation. Attributes: identifier: The offending identifier …	lexigram-contracts/src/lexigram/contracts/data/sql/sql.py	ValidationError
LEX_ERR_DB_011	NoPrimaryBackendError	Raised when a multi-backend setup has no backend marked as primary. For multi-backend SQL configu…	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	DatabaseError
LEX_ERR_DI_001	ContainerError	Base container error.	lexigram-contracts/src/lexigram/contracts/exceptions/container.py	LexigramError
LEX_ERR_DI_002	DependencyError	Dependency resolution error.	lexigram-contracts/src/lexigram/contracts/exceptions/container.py	ContainerError
LEX_ERR_DI_003	CircularDependencyError	Circular dependency detected.	lexigram-contracts/src/lexigram/contracts/exceptions/container.py	DependencyError
LEX_ERR_DI_004	UnresolvableDependencyError	Cannot resolve dependency.	lexigram-contracts/src/lexigram/contracts/exceptions/container.py	DependencyError
LEX_ERR_DI_005	RegistrationError	Service registration error.	lexigram-contracts/src/lexigram/contracts/exceptions/container.py	ContainerError
LEX_ERR_DI_006	ContainerBuildError	Container build/configuration error.	lexigram-contracts/src/lexigram/contracts/exceptions/container.py	ContainerError
LEX_ERR_DI_007	ProtocolValidationError	Protocol validation error.	lexigram-contracts/src/lexigram/contracts/exceptions/container.py	ContainerError
LEX_ERR_DI_008	ContainerValidationError	Container dependency graph validation failed before boot. Raised when Container.validate() di…	lexigram-contracts/src/lexigram/contracts/exceptions/container.py	ContainerBuildError
LEX_ERR_DI_009	ScopedResolutionError	Attempted to resolve a scoped service outside of an active scope. Raised when a service registere…	lexigram-contracts/src/lexigram/contracts/exceptions/container.py	UnresolvableDependencyError
LEX_ERR_DOM_001	DomainError	Business/domain-level errors (validation failures, not found, auth).	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	LexigramError
LEX_ERR_DOM_002	NotFoundError	Resource not found error (domain-level).	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	DomainError
LEX_ERR_DOM_003	PermissionDeniedError	Permission denied error (domain-level).	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	DomainError
LEX_ERR_DOM_004	AuthenticationError	Authentication error (domain-level).	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	DomainError
LEX_ERR_DOM_005	AuthorizationError	Authorization/permission error (domain-level).	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	DomainError
LEX_ERR_DOM_006	RateLimitError	Rate limiting error.	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	DomainError
LEX_ERR_DOM_007	ConflictError	Resource conflict error.	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	DomainError
LEX_ERR_EVAL_001	EvaluationError	Base for evaluation system errors. Extended in the AI evaluation layer with specific failures lik…	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_EVT_001	EventError	Base events/messaging error.	lexigram-contracts/src/lexigram/contracts/exceptions/events.py	LexigramError
LEX_ERR_EVT_002	HandlerNotFoundError	Event/command handler not found. Raised when no handler is registered for a specific event or com…	lexigram-contracts/src/lexigram/contracts/exceptions/events.py	EventError
LEX_ERR_EVT_003	DuplicateHandlerError	Duplicate handler registration. Raised when attempting to register a handler for a type that alre…	lexigram-contracts/src/lexigram/contracts/exceptions/events.py	EventError
LEX_ERR_FEAT_001	FeatureFlagError	Base error for the feature flag subsystem.	lexigram-contracts/src/lexigram/contracts/exceptions/feature_flags.py	LexigramError
LEX_ERR_GOV_001	GovernanceError	Base class for governance-related errors.	lexigram-contracts/src/lexigram/contracts/ai/governance.py	LexigramError
LEX_ERR_GOV_002	BudgetExceededError	Error raised when budget is exceeded.	lexigram-contracts/src/lexigram/contracts/ai/governance.py	GovernanceError
LEX_ERR_GOV_003	PolicyViolationError	Error raised when policy is violated.	lexigram-contracts/src/lexigram/contracts/ai/governance.py	GovernanceError
LEX_ERR_GUARD_001	GuardError	Base for AI guard/policy enforcement errors. Extended in the AI guard layer with specific failure…	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_GUARD_002	InputGuardError	Error raised during input guard validation.	lexigram-contracts/src/lexigram/contracts/ai/guards.py	GuardError
LEX_ERR_GUARD_003	OutputGuardError	Error raised during output guard validation.	lexigram-contracts/src/lexigram/contracts/ai/guards.py	GuardError
LEX_ERR_IDEM_001	IdempotencyError	Base exception for idempotency flows.	lexigram-contracts/src/lexigram/contracts/exceptions/idempotency.py	LexigramError
LEX_ERR_IDEM_002	DuplicateRequestError	Raised when an idempotent key is reused before completion.	lexigram-contracts/src/lexigram/contracts/exceptions/idempotency.py	IdempotencyError
LEX_ERR_IDEM_003	IdempotencyStoreError	Raised on unexpected failures inside the idempotency store.	lexigram-contracts/src/lexigram/contracts/exceptions/idempotency.py	IdempotencyError
LEX_ERR_IDEM_004	IdempotencyConflictError	Raised when an idempotency key is already claimed (PENDING).	lexigram-contracts/src/lexigram/contracts/exceptions/idempotency.py	IdempotencyError
LEX_ERR_IDX_001	IndexError	Raised when index operations fail in an expected, recoverable way.	lexigram-contracts/src/lexigram/contracts/ai/index.py	RAGError
LEX_ERR_INFRA_001	InfrastructureError	System-level failures (DB down, network timeouts).	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	LexigramError
LEX_ERR_INFRA_002	LockError	Distributed lock error.	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	InfrastructureError
LEX_ERR_INFRA_003	LockConflictError	Raised when a lock conflict occurs (resource already locked).	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	LockError
LEX_ERR_INFRA_004	ComponentError	Base exception for all component-related errors.	lexigram-contracts/src/lexigram/contracts/exceptions/components.py	LexigramError
LEX_ERR_INFRA_005	ComponentConnectionError	Raised when a connection to an external service fails.	lexigram-contracts/src/lexigram/contracts/exceptions/components.py	InfrastructureError, ComponentError
LEX_ERR_INFRA_006	KeyNotFoundError	Raised when a requested key does not exist.	lexigram-contracts/src/lexigram/contracts/exceptions/components.py	NotFoundError, ComponentError
LEX_ERR_INFRA_007	KeyExistsError	Raised when trying to create a key that already exists.	lexigram-contracts/src/lexigram/contracts/exceptions/components.py	ConflictError, ComponentError
LEX_ERR_INFRA_008	PubSubError	Base exception for pub/sub operations.	lexigram-contracts/src/lexigram/contracts/exceptions/components.py	InfrastructureError, ComponentError
LEX_ERR_INFRA_009	SecretNotFoundError	Raised when a requested secret does not exist.	lexigram-contracts/src/lexigram/contracts/exceptions/components.py	NotFoundError, ComponentError
LEX_ERR_INFRA_010	DriverNotAvailableError	Raised when a driver is not available (dependency not installed).	lexigram-contracts/src/lexigram/contracts/exceptions/components.py	ComponentError
LEX_ERR_INFRA_011	_StoredStreamError	Internal carrier for propagating typed stream failures.	lexigram-contracts/src/lexigram/contracts/infra/streams.py	Exception, Generic[E]
LEX_ERR_LLM_001	LLMError	Base for LLM client errors. Extended in lexigram-ai-llm with specific failures like rate limiting…	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_LOAD_001	LoaderError	Raised when document loading fails in an expected, recoverable way. Extended in lexigram-ai-rag w…	lexigram-contracts/src/lexigram/contracts/ai/loaders.py	RAGError
LEX_ERR_LOCK_001	LockAcquisitionError	Raised when acquiring a lock fails.	lexigram-contracts/src/lexigram/contracts/exceptions/components.py	LockError, ComponentError
LEX_ERR_LOCK_002	LockNotHeldError	Raised when trying to operate on a lock that is not held.	lexigram-contracts/src/lexigram/contracts/exceptions/components.py	LockError, ComponentError
LEX_ERR_MAP_001	MappingError	Object mapping error.	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	LexigramError
LEX_ERR_MCP_001	MCPError	Base exception for all MCP errors.	lexigram-contracts/src/lexigram/contracts/mcp/exceptions.py	LexigramError
LEX_ERR_MCP_002	MCPTransportError	Transport-level error (connection, I/O). Raised when the MCP transport layer encounters errors su…	lexigram-contracts/src/lexigram/contracts/mcp/exceptions.py	MCPError
LEX_ERR_MCP_003	MCPToolCallError	Tool call failed during MCP execution. Raised when a tool invocation fails, either due to the too…	lexigram-contracts/src/lexigram/contracts/mcp/exceptions.py	MCPError
LEX_ERR_MCP_004	MCPResourceError	Resource read or list failed. Raised when a resource operation fails, such as when a resource is …	lexigram-contracts/src/lexigram/contracts/mcp/exceptions.py	MCPError
LEX_ERR_MCP_005	MCPProtocolError	Protocol violation (malformed message, invalid state). Raised when an MCP message violates the pr…	lexigram-contracts/src/lexigram/contracts/mcp/exceptions.py	MCPError
LEX_ERR_MCP_006	MCPMethodNotFoundError	Unknown MCP method requested by client. Raised when the client requests an MCP method that the se…	lexigram-contracts/src/lexigram/contracts/mcp/exceptions.py	MCPError
LEX_ERR_MCP_007	MCPPromptError	Prompt retrieval or list failed. Raised when a prompt operation fails, such as when a prompt is n…	lexigram-contracts/src/lexigram/contracts/mcp/exceptions.py	MCPError
LEX_ERR_MCP_008	MCPInitializationError	MCP server initialization failed. Raised when the MCP server cannot be initialized, usually due t…	lexigram-contracts/src/lexigram/contracts/mcp/exceptions.py	MCPError
LEX_ERR_MEM_001	AIMemoryError	Base for AI memory system errors. Extended in lexigram-ai-memory with specific failures like cons…	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_MEM_002	ConsolidationError	Error raised during memory consolidation.	lexigram-contracts/src/lexigram/contracts/ai/memory.py	AIMemoryError
LEX_ERR_MEM_003	StorageError	Error raised during memory storage operations.	lexigram-contracts/src/lexigram/contracts/ai/memory.py	AIMemoryError
LEX_ERR_MOD_001	ModuleError	Module configuration or lifecycle error.	lexigram-contracts/src/lexigram/contracts/exceptions/provider.py	LexigramError
LEX_ERR_MOD_002	ModuleImportError	A module imports a module that does not exist in the graph. Raised during module compilation when…	lexigram-contracts/src/lexigram/contracts/exceptions/provider.py	ModuleError
LEX_ERR_MOD_003	ModuleExportError	A module exports a type not provided by its providers. Raised during post-registration validation…	lexigram-contracts/src/lexigram/contracts/exceptions/provider.py	ModuleError
LEX_ERR_MOD_004	ModuleCycleError	Circular dependency detected in the module import graph. Raised during module compilation when a …	lexigram-contracts/src/lexigram/contracts/exceptions/provider.py	ModuleError
LEX_ERR_MOD_005	ModuleVisibilityError	A provider depends on a service not visible to its module. Raised when a provider in module A tri…	lexigram-contracts/src/lexigram/contracts/exceptions/provider.py	ModuleError
LEX_ERR_MOD_006	ModuleDuplicateError	The same module appears twice with conflicting configurations. Raised when two :class:`DynamicMod…	lexigram-contracts/src/lexigram/contracts/exceptions/provider.py	ModuleError
LEX_ERR_MW_001	MiddlewareGuardError	Raised when a middleware guard denies access.	lexigram-contracts/src/lexigram/contracts/exceptions/middleware.py	LexigramError
LEX_ERR_NOTIF_001	NotificationError	Base for expected, recoverable notification delivery failures. Attributes: channel: Notification …	lexigram-contracts/src/lexigram/contracts/notification/errors.py	DomainError
LEX_ERR_NOTIF_002	MailerError	Base mailer/email notification error.	lexigram-contracts/src/lexigram/contracts/mailer/errors.py	DomainError
LEX_ERR_PIPE_001	PipelineExecutionError	Error raised during pipeline execution.	lexigram-contracts/src/lexigram/contracts/exceptions/execution.py	LexigramError
LEX_ERR_PIPE_002	PipelineStepError	Error raised by a pipeline step.	lexigram-contracts/src/lexigram/contracts/exceptions/execution.py	LexigramError
LEX_ERR_PROV_001	ProviderError	Provider configuration or lifecycle error.	lexigram-contracts/src/lexigram/contracts/exceptions/provider.py	LexigramError
LEX_ERR_QE_001	QueryEngineError	Raised when query engine operations fail in an expected, recoverable way.	lexigram-contracts/src/lexigram/contracts/ai/index.py	RAGError
LEX_ERR_QUEUE_001	QueueError	Base for expected, recoverable queue / bus failures. Attributes: backend: Name of the queue backe…	lexigram-contracts/src/lexigram/contracts/queue/errors.py	DomainError
LEX_ERR_RAG_001	RAGError	Base for RAG pipeline errors. Extended in lexigram-ai-rag with specific failures like retrieval, …	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_RAG_002	RetrievalError	Error raised during document retrieval.	lexigram-contracts/src/lexigram/contracts/ai/rag.py	RAGError
LEX_ERR_RAG_003	SynthesisError	Error raised during response synthesis.	lexigram-contracts/src/lexigram/contracts/ai/rag.py	RAGError
LEX_ERR_RAG_004	ChunkingError	Error raised during document chunking.	lexigram-contracts/src/lexigram/contracts/ai/rag.py	RAGError
LEX_ERR_REG_001	RegistryError	Base exception for registry errors.	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	LexigramError
LEX_ERR_REG_002	RegistryKeyError	Raised when a key is not found in a registry.	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	RegistryError, KeyError
LEX_ERR_REG_003	RegistryAlreadyExistsError	Raised when attempting to register a duplicate key in a registry.	lexigram-contracts/src/lexigram/contracts/exceptions/infra.py	RegistryError
LEX_ERR_RESULT_002	UnwrapError	Raised when unwrap() or unwrap_err() is called on the wrong variant. Provides a clearer error typ…	lexigram-contracts/src/lexigram/contracts/core/result.py	Exception
LEX_ERR_RES_001	ResilienceError	Base resilience error.	lexigram-contracts/src/lexigram/contracts/exceptions/resilience.py	LexigramError
LEX_ERR_RES_002	RetryError	Retry operation error.	lexigram-contracts/src/lexigram/contracts/exceptions/resilience.py	ResilienceError
LEX_ERR_RES_003	CircuitBreakerError	Circuit breaker error.	lexigram-contracts/src/lexigram/contracts/exceptions/resilience.py	ResilienceError
LEX_ERR_RES_004	BulkheadError	Bulkhead/rejection error.	lexigram-contracts/src/lexigram/contracts/exceptions/resilience.py	ResilienceError
LEX_ERR_RES_005	FallbackError	Fallback execution error.	lexigram-contracts/src/lexigram/contracts/exceptions/resilience.py	ResilienceError
LEX_ERR_RES_006	RetryExhaustedError	All retry attempts have been exhausted.	lexigram-contracts/src/lexigram/contracts/exceptions/resilience.py	RetryError
LEX_ERR_RES_007	CircuitOpenError	Circuit breaker is open and rejecting requests.	lexigram-contracts/src/lexigram/contracts/exceptions/resilience.py	CircuitBreakerError
LEX_ERR_RET_001	RetrieverError	Base for retriever errors. Raised when document retrieval fails in an expected, recoverable way (…	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_RUN_001	RunnableError	Recoverable composition failure (input shape, parser error, retry budget exceeded).	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_SEC_001	SecurityError	Base security error for the Lexigram security subsystem.	lexigram-contracts/src/lexigram/contracts/exceptions/security.py	LexigramError
LEX_ERR_SEC_002	GuardDeniedError	Raised when a GuardChain denies the request. Attributes: guard: The name or type of the guard tha…	lexigram-contracts/src/lexigram/contracts/exceptions/security.py	SecurityError
LEX_ERR_SEC_003	InputSanitizationError	Raised when sanitization fails due to unrecoverable input structure.	lexigram-contracts/src/lexigram/contracts/exceptions/security.py	SecurityError
LEX_ERR_SEC_004	CORSViolationError	Raised when a request violates the configured CORS policy. Attributes: origin: The request origin…	lexigram-contracts/src/lexigram/contracts/exceptions/security.py	SecurityError
LEX_ERR_SEC_005	SecretAccessError	Raised when the caller lacks permission to access or modify a secret. Attributes: secret_name: Na…	lexigram-contracts/src/lexigram/contracts/exceptions/security.py	SecurityError
LEX_ERR_SERIAL_001	SerializationError	Serialization/deserialization error.	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	LexigramError
LEX_ERR_SES_001	SessionError	Base class for session-related errors.	lexigram-contracts/src/lexigram/contracts/ai/session.py	LexigramError
LEX_ERR_SES_002	TaskCancelledError	Error raised when a task is cancelled.	lexigram-contracts/src/lexigram/contracts/ai/session.py	LexigramError
LEX_ERR_SES_003	TaskError	Base class for task execution errors.	lexigram-contracts/src/lexigram/contracts/ai/session.py	LexigramError
LEX_ERR_SES_004	TaskTimeoutError	Error raised when a task times out.	lexigram-contracts/src/lexigram/contracts/ai/session.py	TaskError
LEX_ERR_SES_005	TaskValidationError	Error raised when task input validation fails.	lexigram-contracts/src/lexigram/contracts/ai/session.py	TaskError
LEX_ERR_SKILL_001	SkillError	Base for skill execution errors. Extended in lexigram-ai-skills with specific failures like skill…	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_TASK_001	TaskQueueError	Base class for expected, recoverable task queue failures. All subtypes indicate situations the ca…	lexigram-contracts/src/lexigram/contracts/infra/tasks/exceptions.py	DomainError
LEX_ERR_TENANT_001	TenantError	Base class for all tenancy-related domain errors.	lexigram-contracts/src/lexigram/contracts/tenancy/errors.py	DomainError
LEX_ERR_TENANT_002	TenantNotFoundError	Raised when a requested tenant does not exist.	lexigram-contracts/src/lexigram/contracts/tenancy/errors.py	TenantError
LEX_ERR_TENANT_003	TenantInactiveError	Raised when an operation is attempted on an inactive tenant.	lexigram-contracts/src/lexigram/contracts/tenancy/errors.py	TenantError
LEX_ERR_TENANT_004	TenantProvisioningError	Raised when tenant provisioning (isolation setup) fails.	lexigram-contracts/src/lexigram/contracts/tenancy/errors.py	TenantError
LEX_ERR_TENANT_005	TenantResolutionError	Raised when tenant resolution fails unexpectedly.	lexigram-contracts/src/lexigram/contracts/tenancy/errors.py	TenantError
LEX_ERR_TENANT_006	TenantConfigError	Raised when per-tenant configuration access or mutation fails.	lexigram-contracts/src/lexigram/contracts/tenancy/errors.py	TenantError
LEX_ERR_TENANT_007	TenantSlugConflictError	Raised when a tenant slug is already in use.	lexigram-contracts/src/lexigram/contracts/tenancy/errors.py	TenantError
LEX_ERR_TENANT_008	TenantSuspendedError	Raised when an operation is attempted on a suspended tenant.	lexigram-contracts/src/lexigram/contracts/tenancy/errors.py	TenantError
LEX_ERR_VAL_001	FieldError	A single field-level validation error. Used to represent validation failures for individual field…	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	DomainError
LEX_ERR_VAL_002	ValidationError	Data validation error.	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	DomainError
LEX_ERR_VEC_001	VectorError	Base exception for vector store errors. Extends InfrastructureError because vector operations inv…	lexigram-contracts/src/lexigram/contracts/data/vector/exceptions.py	InfrastructureError
LEX_ERR_VEC_002	VectorStoreError	Exception raised during vector store operations (CRUD, search).	lexigram-contracts/src/lexigram/contracts/data/vector/exceptions.py	VectorError
LEX_ERR_VEC_003	EmbeddingError	Exception raised during embedding generation or retrieval.	lexigram-contracts/src/lexigram/contracts/data/vector/exceptions.py	VectorError
LEX_ERR_VEC_004	VectorIndexError	Exception raised during vector index creation or management.	lexigram-contracts/src/lexigram/contracts/data/vector/exceptions.py	VectorError
LEX_ERR_WEBHOOK_001	WebhookError	Base exception for webhook domain operations.	lexigram-contracts/src/lexigram/contracts/webhook/exceptions.py	DomainError
LEX_ERR_WEB_001	WebError	Web layer error.	lexigram-contracts/src/lexigram/contracts/exceptions/domain.py	DomainError
LEX_ERR_WEB_002	HttpStatusError	Raised by :meth:HttpResponse.raise_for_status for 4xx/5xx responses. Attributes: status: HTTP s…	lexigram-contracts/src/lexigram/contracts/web/http_models.py	InfrastructureError
LEX_ERR_WF_001	WorkflowError	Base for workflow execution errors. Raised when a workflow graph execution fails in an expected, …	lexigram-contracts/src/lexigram/contracts/ai/exceptions.py	AIError
LEX_ERR_WF_002	SagaStepError	Represents a recoverable failure from a single saga step action. SagaProtocol step actions must r…	lexigram-contracts/src/lexigram/contracts/workflow/steps.py	Exception

lexigram (45 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_APP_001	AppError	Base exception for all app errors.	lexigram/src/lexigram/app/exceptions.py	LexigramError
LEX_ERR_APP_002	AppStartupError	Raised when the application fails to start or a provider fails during boot.	lexigram/src/lexigram/app/exceptions.py	AppError
LEX_ERR_APP_003	AppShutdownError	Raised when the application cannot complete a graceful shutdown.	lexigram/src/lexigram/app/exceptions.py	AppError
LEX_ERR_CFG_002	ConfigurationError	Configuration loading, parsing, or validation failed. Raised by: - ConfigProvider during init…	lexigram/src/lexigram/exceptions.py	LexigramException
LEX_ERR_CFG_003	ConfigSourceError	Raised when a configuration source fails to load its values.	lexigram/src/lexigram/config/exceptions.py	ConfigurationError
LEX_ERR_CFG_004	ConfigReloadError	Raised when a live-reload attempt fails.	lexigram/src/lexigram/config/exceptions.py	ConfigurationError
LEX_ERR_CFG_005	ConfigSectionNotFoundError	Raised when a required config section is absent from the loaded config.	lexigram/src/lexigram/config/exceptions.py	ConfigurationError
LEX_ERR_CONC_001	ConcurrencyError	Base exception for all concurrency errors.	lexigram/src/lexigram/concurrency/exceptions.py	LexigramError
LEX_ERR_CONC_002	AsyncError	Exception raised for errors in asynchronous operations or concurrency control.	lexigram/src/lexigram/concurrency/exceptions.py	ConcurrencyError
LEX_ERR_CONC_003	ChannelClosedError	Raised when an operation is attempted on a closed channel.	lexigram/src/lexigram/concurrency/exceptions.py	ConcurrencyError
LEX_ERR_CONC_004	ChannelFullError	Raised when sending to a channel that is at capacity.	lexigram/src/lexigram/concurrency/exceptions.py	ConcurrencyError
LEX_ERR_CONC_005	DispatcherError	Error in dispatcher execution.	lexigram/src/lexigram/concurrency/exceptions.py	ConcurrencyError
LEX_ERR_CONC_006	StructuredParallelismError	Base exception for parallel execution errors.	lexigram/src/lexigram/concurrency/exceptions.py	ConcurrencyError
LEX_ERR_CONC_007	TaskGroupError	Raised when a task group encounters an error.	lexigram/src/lexigram/concurrency/exceptions.py	StructuredParallelismError
LEX_ERR_CONC_008	CancellationScopeError	Raised when a cancellation scope encounters an error.	lexigram/src/lexigram/concurrency/exceptions.py	StructuredParallelismError
LEX_ERR_CORE_002	LexigramException	Base exception for all lexigram domain errors. Extends :class:`~lexigram.contracts.exceptions.bas…	lexigram/src/lexigram/exceptions.py	LexigramError
LEX_ERR_CORE_005	CoreError	Base exception for all core errors.	lexigram/src/lexigram/primitives/exceptions.py	LexigramError
LEX_ERR_DI_010	InjectionError	Dependency injection or container resolution failed. Raised by: - Container.resolve() when a …	lexigram/src/lexigram/exceptions.py	LexigramException
LEX_ERR_DI_011	InterceptorTimeoutError	Raised when a MethodInterceptorProtocol exceeds its configured timeout.	lexigram/src/lexigram/di/extensions/aop_interceptors.py	RuntimeError
LEX_ERR_DOM_008	DomainModelError	Domain model invariant violated or business rule broken. Raised by: - Domain event handlers - Agg…	lexigram/src/lexigram/exceptions.py	LexigramException
LEX_ERR_DOM_009	PolicyViolationError	Raised when a domain policy evaluation fails. Distinct from PolicyViolationProtocol (the Resu…	lexigram/src/lexigram/domain/exceptions.py	LexigramError
LEX_ERR_MAP_002	MappingError	Base exception for all object-mapping errors.	lexigram/src/lexigram/mapping/exceptions.py	LexigramError
LEX_ERR_MAP_003	MappingNotFoundError	Raised when no mapper is registered for a (source, destination) type pair.	lexigram/src/lexigram/mapping/exceptions.py	MappingError
LEX_ERR_MAP_004	MappingExecutionError	Raised when a registered mapper raises an unexpected error during execution.	lexigram/src/lexigram/mapping/exceptions.py	MappingError
LEX_ERR_MOD_007	ModuleError	Module system error (registration, visibility, exports). Raised by: - Module decorators - Module …	lexigram/src/lexigram/exceptions.py	LexigramException
LEX_ERR_MW_002	MiddlewareError	Base exception for infrastructure-level middleware errors.	lexigram/src/lexigram/middleware/exceptions.py	InfrastructureError
LEX_ERR_MW_003	MiddlewarePolicyError	Base exception for policy-level middleware rejections. Raised when middleware rejects a request b…	lexigram/src/lexigram/middleware/exceptions.py	DomainError
LEX_ERR_MW_004	MiddlewareExecutionError	Raised when a middleware raises an unexpected error during execution.	lexigram/src/lexigram/middleware/exceptions.py	MiddlewareError
LEX_ERR_MW_005	MiddlewareConfigurationError	Raised when middleware is configured incorrectly.	lexigram/src/lexigram/middleware/exceptions.py	MiddlewareError
LEX_ERR_MW_006	MiddlewareChainError	Raised when the middleware chain cannot be assembled or traversed.	lexigram/src/lexigram/middleware/exceptions.py	MiddlewareError
LEX_ERR_MW_007	MiddlewareTimeoutError	Raised when a middleware exceeds its configured timeout.	lexigram/src/lexigram/middleware/exceptions.py	MiddlewareError
LEX_ERR_MW_008	MiddlewareAuthError	Raised when middleware-level authentication/authorization fails.	lexigram/src/lexigram/middleware/exceptions.py	MiddlewarePolicyError
LEX_ERR_MW_009	MiddlewareRateLimitError	Raised when middleware-level rate limiting is exceeded.	lexigram/src/lexigram/middleware/exceptions.py	MiddlewarePolicyError
LEX_ERR_MW_010	MiddlewareCircuitOpenError	Raised when the circuit breaker in middleware is open.	lexigram/src/lexigram/middleware/exceptions.py	MiddlewareError
LEX_ERR_SEC_006	SecurityError	Base exception for all security-module errors.	lexigram/src/lexigram/security/exceptions.py	LexigramError
LEX_ERR_SEC_007	SecretNotFoundError	Raised when a requested secret does not exist.	lexigram/src/lexigram/security/exceptions.py	SecretError
LEX_ERR_SEC_008	SecretAccessError	Raised when access to a secret is denied.	lexigram/src/lexigram/security/exceptions.py	SecretError
LEX_ERR_SEC_009	EncryptionError	Raised when field-level encryption fails.	lexigram/src/lexigram/security/exceptions.py	SecurityError
LEX_ERR_SEC_010	DecryptionError	Raised when field-level decryption fails.	lexigram/src/lexigram/security/exceptions.py	SecurityError
LEX_ERR_SEC_011	SecretError	Base exception for secret store errors.	lexigram/src/lexigram/security/exceptions.py	SecurityError
LEX_ERR_SERIAL_002	SerializationError	JSON serialisation or deserialisation failed. Raised by: - JsonSerializer implementations - D…	lexigram/src/lexigram/exceptions.py	LexigramException
LEX_ERR_SERIAL_003	SerializationError	Base exception for serialization and deserialization failures. Extensions should subclass this fo…	lexigram/src/lexigram/serialization/exceptions.py	LexigramError
LEX_ERR_SERIAL_004	NegotiationError	Raised when no serializer can be negotiated for a given Accept header.	lexigram/src/lexigram/serialization/exceptions.py	SerializationError
LEX_ERR_VAL_003	ValidationError	Input validation against rules failed. Raised by: - ValidatorImpl.validate() when rules do no…	lexigram/src/lexigram/exceptions.py	LexigramException
LEX_ERR_VAL_004	ValidationSystemError	Base exception for validation system/pipeline failures. Distinct from :class:`~lexigram.contracts…	lexigram/src/lexigram/validation/exceptions.py	LexigramError

lexigram-ai (1 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_AI_005	AIError	Base exception for lexigram-ai.	lexigram-ai/src/lexigram/ai/exceptions.py	_ContractsAIError

lexigram-ai-agents (8 codes)

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

lexigram-ai-feedback (3 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_FEED_001	FeedbackError	Base exception for all feedback-related errors.	lexigram-ai-feedback/src/lexigram/ai/feedback/exceptions.py	AIError
LEX_ERR_FEED_002	FeedbackProcessingError	Raised when a feedback processor fails.	lexigram-ai-feedback/src/lexigram/ai/feedback/exceptions.py	FeedbackError
LEX_ERR_FEED_003	FeedbackValidationError	Raised when feedback data fails validation.	lexigram-ai-feedback/src/lexigram/ai/feedback/exceptions.py	FeedbackError

lexigram-ai-llm (25 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_LLM_002	LLMError	Base exception for all LLM-domain errors in lexigram-ai-llm.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	_ContractsLLMError
LEX_ERR_LLM_003	LLMAuthenticationError	Invalid API key or credentials — infrastructure error, raised not wrapped. Raised as an exception…	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	LLMError
LEX_ERR_LLM_004	InvalidRequestError	Error raised when a request to an LLM provider is invalid.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	LLMError
LEX_ERR_LLM_005	ModelNotFoundError	Model unavailable or not found — recoverable via fallback routing.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	LLMError
LEX_ERR_LLM_006	LLMModelNotFoundError	Model unavailable or not found — recoverable via fallback routing. Returned as Err from “LLM…	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	ModelNotFoundError
LEX_ERR_LLM_007	LLMRateLimitError	Rate limit exceeded — recoverable via backoff/retry. Returned as Err from “LLMClientProtocol…	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	LLMError
LEX_ERR_LLM_008	LLMQuotaExceededError	API quota or billing limit exceeded — recoverable by routing elsewhere. Returned as Err from …	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	LLMError
LEX_ERR_LLM_009	LLMContentFilterError	Content blocked by provider safety filter — recoverable via reformulation. Returned as Err fr…	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	LLMError
LEX_ERR_LLM_010	TokenLimitError	Error raised when the token limit for a request is exceeded.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	LLMError
LEX_ERR_LLM_011	ProviderConnectionError	Error raised when connection to an LLM provider fails.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	LLMError
LEX_ERR_LLM_012	StreamError	Error raised during LLM response streaming.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	LLMError
LEX_ERR_LLM_013	ExtractionError	Base class for structured extraction errors in lexigram-ai-llm.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	_ContractsExtractionError
LEX_ERR_LLM_014	ExtractionParseError	Error raised when extraction response cannot be parsed as JSON.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	ExtractionError
LEX_ERR_LLM_015	ExtractionValidationError	Error raised when parsed extraction response fails schema validation.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	ExtractionError
LEX_ERR_LLM_016	ExtractionMaxRetriesError	Error raised when extraction max retries are exhausted.	lexigram-ai-llm/src/lexigram/ai/llm/exceptions.py	ExtractionError
LEX_ERR_LLM_017	StructuredOutputError	Base exception for structured output errors.	lexigram-ai-llm/src/lexigram/ai/llm/structured/exceptions.py	ExtractionError
LEX_ERR_LLM_018	ParseError	Raised when response cannot be parsed.	lexigram-ai-llm/src/lexigram/ai/llm/structured/exceptions.py	StructuredOutputError
LEX_ERR_LLM_019	SchemaValidationError	Raised when parsed response fails validation.	lexigram-ai-llm/src/lexigram/ai/llm/structured/exceptions.py	StructuredOutputError
LEX_ERR_LLM_020	ModelManagerError	Base exception for model manager errors.	lexigram-ai-llm/src/lexigram/ai/llm/model_manager/types.py	LLMError
LEX_ERR_LLM_021	ModelNotFoundError	Raised when a requested model is not found.	lexigram-ai-llm/src/lexigram/ai/llm/model_manager/types.py	ModelManagerError, BaseModelNotFoundError
LEX_ERR_LLM_022	ModelLoadError	Raised when a model fails to load.	lexigram-ai-llm/src/lexigram/ai/llm/model_manager/types.py	ModelManagerError
LEX_ERR_LLM_023	ModelUnloadError	Raised when a model fails to unload.	lexigram-ai-llm/src/lexigram/ai/llm/model_manager/types.py	ModelManagerError
LEX_ERR_LLM_024	ProviderConnectionError	Raised when connection to provider fails.	lexigram-ai-llm/src/lexigram/ai/llm/model_manager/types.py	ModelManagerError, BaseProviderConnectionError
LEX_ERR_LLM_025	OrchestratorError	Base orchestration error.	lexigram-ai-llm/src/lexigram/ai/llm/routing/orchestrator.py	LLMError
LEX_ERR_LLM_026	NoSuitableModelError	No model found that meets the requirements.	lexigram-ai-llm/src/lexigram/ai/llm/routing/orchestrator.py	OrchestratorError

lexigram-ai-memory (5 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_MEM_005	MemorySystemError	Base exception for memory operations.	lexigram-ai-memory/src/lexigram/ai/memory/exceptions.py	_ContractsAIMemoryError
LEX_ERR_MEM_006	MemoryStoreError	Raised when a backend store operation fails.	lexigram-ai-memory/src/lexigram/ai/memory/exceptions.py	MemorySystemError
LEX_ERR_MEM_008	MemoryCapacityError	Raised when a memory store is at capacity and cannot accept new entries.	lexigram-ai-memory/src/lexigram/ai/memory/exceptions.py	MemorySystemError
LEX_ERR_MEM_009	EmbeddingError	Raised when generating or storing an embedding fails.	lexigram-ai-memory/src/lexigram/ai/memory/exceptions.py	MemorySystemError
LEX_ERR_MEM_010	FactExtractionError	Raised when entity/fact extraction from text fails.	lexigram-ai-memory/src/lexigram/ai/memory/exceptions.py	MemorySystemError

lexigram-ai-observability (4 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_OBS_001	ObservabilityError	Base exception for all observability-related errors.	lexigram-ai-observability/src/lexigram/ai/observability/exceptions.py	AIError
LEX_ERR_OBS_002	HealthCheckError	Raised when a health check infrastructure operation fails.	lexigram-ai-observability/src/lexigram/ai/observability/exceptions.py	ObservabilityError
LEX_ERR_OBS_003	MetricsError	Raised when a metrics recording or retrieval operation fails.	lexigram-ai-observability/src/lexigram/ai/observability/exceptions.py	ObservabilityError
LEX_ERR_OBS_004	TracingError	Raised when a tracing operation fails.	lexigram-ai-observability/src/lexigram/ai/observability/exceptions.py	ObservabilityError

lexigram-ai-rag (10 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_RAG_005	RAGError	Base exception for RAG errors.	lexigram-ai-rag/src/lexigram/ai/rag/exceptions.py	_ContractsRAGError
LEX_ERR_RAG_006	PreprocessingError	Raised when document preprocessing fails.	lexigram-ai-rag/src/lexigram/ai/rag/exceptions.py	RAGError
LEX_ERR_RAG_010	MultimodalError	Base exception for multimodal processing errors.	lexigram-ai-rag/src/lexigram/ai/rag/exceptions.py	RAGError
LEX_ERR_RAG_011	AudioLoaderError	Raised when audio loading fails.	lexigram-ai-rag/src/lexigram/ai/rag/exceptions.py	MultimodalError
LEX_ERR_RAG_012	VideoLoaderError	Raised when video loading fails.	lexigram-ai-rag/src/lexigram/ai/rag/exceptions.py	MultimodalError
LEX_ERR_RAG_013	ImageLoaderError	Raised when image loading fails.	lexigram-ai-rag/src/lexigram/ai/rag/exceptions.py	MultimodalError
LEX_ERR_RAG_014	CLIPEmbeddingError	Raised when CLIP embedding computation fails.	lexigram-ai-rag/src/lexigram/ai/rag/exceptions.py	MultimodalError
LEX_ERR_RAG_015	MissingCitationsError	Raised when a pipeline with require_citations=True produces no citations.	lexigram-ai-rag/src/lexigram/ai/rag/exceptions.py	RAGError
LEX_ERR_RAG_016	UnsupportedFormatError	Raised when no loader is registered for the given file format or URL.	lexigram-ai-rag/src/lexigram/ai/rag/loaders/registry.py	RAGError
LEX_ERR_RAG_017	MissingOptionalDependencyError	—	lexigram-ai-rag/src/lexigram/ai/rag/deps/optional.py	ImportError

lexigram-ai-session (7 codes)

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

lexigram-ai-skills (7 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_SKILL_002	SkillNotFoundError	Raised when a requested skill is not registered.	lexigram-ai-skills/src/lexigram/ai/skills/exceptions.py	SkillError
LEX_ERR_SKILL_003	SkillAlreadyRegisteredError	Raised when a skill is registered under a name that already exists.	lexigram-ai-skills/src/lexigram/ai/skills/exceptions.py	SkillError
LEX_ERR_SKILL_004	SkillValidationError	Raised when skill parameter validation fails.	lexigram-ai-skills/src/lexigram/ai/skills/exceptions.py	SkillError
LEX_ERR_SKILL_005	SkillPermissionDeniedError	Raised when the caller lacks required permissions for a skill.	lexigram-ai-skills/src/lexigram/ai/skills/exceptions.py	SkillError
LEX_ERR_SKILL_006	SkillTimeoutError	Raised when skill execution exceeds the configured timeout.	lexigram-ai-skills/src/lexigram/ai/skills/exceptions.py	SkillError
LEX_ERR_SKILL_007	SkillRoutingError	Raised when a SkillRouter finds no matching route.	lexigram-ai-skills/src/lexigram/ai/skills/exceptions.py	SkillError
LEX_ERR_SKILL_008	SkillExecutionError	Raised when a skill execution fails after all retry attempts.	lexigram-ai-skills/src/lexigram/ai/skills/exceptions.py	SkillError

lexigram-ai-workers (3 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_AIWORK_001	WorkerError	Base exception for all worker-related errors.	lexigram-ai-workers/src/lexigram/ai/workers/exceptions.py	AIError
LEX_ERR_AIWORK_002	DLQError	Raised when a Dead Letter Queue operation fails.	lexigram-ai-workers/src/lexigram/ai/workers/exceptions.py	WorkerError
LEX_ERR_AIWORK_003	MaintenanceError	Raised when a maintenance task operation fails.	lexigram-ai-workers/src/lexigram/ai/workers/exceptions.py	WorkerError

lexigram-audit (4 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_AUDIT_001	AuditError	Base exception for all audit-domain errors.	lexigram-audit/src/lexigram/audit/exceptions.py	DomainError
LEX_ERR_AUDIT_002	AuditStoreError	Raised when the audit store fails to persist or query entries.	lexigram-audit/src/lexigram/audit/exceptions.py	AuditError
LEX_ERR_AUDIT_003	AuditVerificationError	Raised when audit trail verification encounters an unexpected failure.	lexigram-audit/src/lexigram/audit/exceptions.py	AuditError
LEX_ERR_AUDIT_004	AuditRetentionError	Raised when a retention purge fails.	lexigram-audit/src/lexigram/audit/exceptions.py	AuditError

lexigram-auth (26 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_AUTH_004	AuthError	Base exception for all auth errors.	lexigram-auth/src/lexigram/auth/exceptions.py	ContractsAuthError
LEX_ERR_AUTH_005	AuthenticationError	Raised when authentication fails.	lexigram-auth/src/lexigram/auth/exceptions.py	LexigramAuthenticationError, AuthError
LEX_ERR_AUTH_006	AuthorizationError	Raised when user lacks required permissions.	lexigram-auth/src/lexigram/auth/exceptions.py	LexigramAuthorizationError, AuthError
LEX_ERR_AUTH_007	InvalidCredentialsError	Raised when credentials are invalid.	lexigram-auth/src/lexigram/auth/exceptions.py	AuthenticationError
LEX_ERR_AUTH_008	AccountLockedError	Raised when an account is locked due to too many failed login attempts. Accounts are locked autom…	lexigram-auth/src/lexigram/auth/exceptions.py	AuthenticationError
LEX_ERR_AUTH_009	UserNotFoundError	Raised when user is not found.	lexigram-auth/src/lexigram/auth/exceptions.py	LexigramNotFoundError, AuthError
LEX_ERR_AUTH_010	TokenError	Base exception for token-related errors.	lexigram-auth/src/lexigram/auth/exceptions.py	InvalidCredentialsError
LEX_ERR_AUTH_011	InvalidTokenError	Raised when a token is malformed or invalid.	lexigram-auth/src/lexigram/auth/exceptions.py	TokenError
LEX_ERR_AUTH_012	TokenExpiredError	Raised when a token has expired.	lexigram-auth/src/lexigram/auth/exceptions.py	TokenError
LEX_ERR_AUTH_013	TokenBlacklistedError	Token has been explicitly revoked.	lexigram-auth/src/lexigram/auth/exceptions.py	TokenError
LEX_ERR_AUTH_014	TokenInvalidError	Token is structurally invalid or has wrong type.	lexigram-auth/src/lexigram/auth/exceptions.py	TokenError
LEX_ERR_AUTH_015	TokenAudienceError	Token audience claim does not match expected.	lexigram-auth/src/lexigram/auth/exceptions.py	TokenError
LEX_ERR_AUTH_016	TokenNotFoundError	Token record does not exist.	lexigram-auth/src/lexigram/auth/exceptions.py	TokenError
LEX_ERR_AUTH_017	InvalidAudienceError	Raised when a token audience is invalid.	lexigram-auth/src/lexigram/auth/exceptions.py	TokenError
LEX_ERR_AUTH_018	InvalidScopeError	Raised when a token lacks required scope.	lexigram-auth/src/lexigram/auth/exceptions.py	TokenError
LEX_ERR_AUTH_019	BlacklistedTokenError	Raised when a token has been blacklisted.	lexigram-auth/src/lexigram/auth/exceptions.py	TokenError
LEX_ERR_AUTH_020	TokenExpiredVerificationError	Account verification has expired.	lexigram-auth/src/lexigram/auth/exceptions.py	VerificationError
LEX_ERR_AUTH_021	AlreadyVerifiedError	Account is already verified.	lexigram-auth/src/lexigram/auth/exceptions.py	VerificationError
LEX_ERR_AUTH_022	EmailExistsError	Raised when email is already taken.	lexigram-auth/src/lexigram/auth/exceptions.py	AuthError, ConflictError
LEX_ERR_AUTH_023	UsernameExistsError	Raised when username is already taken.	lexigram-auth/src/lexigram/auth/exceptions.py	AuthError, ConflictError
LEX_ERR_AUTH_024	PasswordPolicyError	Raised when password doesn’t meet requirements.	lexigram-auth/src/lexigram/auth/exceptions.py	AuthError
LEX_ERR_AUTH_025	OAuth2Error	Base exception for OAuth2 errors.	lexigram-auth/src/lexigram/auth/exceptions.py	AuthError
LEX_ERR_AUTH_026	SessionNotFoundError	Raised when a session cannot be found in the store.	lexigram-auth/src/lexigram/auth/exceptions.py	LexigramNotFoundError, AuthError
LEX_ERR_AUTH_027	AccountVerificationError	Error during account verification operations.	lexigram-auth/src/lexigram/auth/authn/account_verification.py	Exception
LEX_ERR_AUTH_028	PasswordResetTokenError	Error during password reset token operations.	lexigram-auth/src/lexigram/auth/authn/password_reset.py	Exception
LEX_ERR_SEC_012	RateLimitExceededError	Raised when a client has exceeded the configured rate limit. Carries retry_after (seconds) so…	lexigram-auth/src/lexigram/auth/web/middleware/throttle.py	Exception

lexigram-cache (12 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_CACHE_004	CacheError	Base exception for cache errors.	lexigram-cache/src/lexigram/cache/exceptions.py	LexigramError
LEX_ERR_CACHE_005	CacheBackendError	Raised when the cache backend (Redis/Memcached) fails.	lexigram-cache/src/lexigram/cache/exceptions.py	CacheError
LEX_ERR_CACHE_006	CacheConnectionError	Raised when the cache connection fails.	lexigram-cache/src/lexigram/cache/exceptions.py	CacheBackendError
LEX_ERR_CACHE_007	CacheTimeoutError	Raised when a cache operation times out.	lexigram-cache/src/lexigram/cache/exceptions.py	CacheError
LEX_ERR_CACHE_008	CacheKeyError	Raised when a cache key is invalid or for key-specific errors.	lexigram-cache/src/lexigram/cache/exceptions.py	CacheError
LEX_ERR_CACHE_009	CacheConfigurationError	Raised when cache configuration is invalid.	lexigram-cache/src/lexigram/cache/exceptions.py	CacheError
LEX_ERR_CACHE_010	CacheStampedeError	Raised when cache stampede protection fails.	lexigram-cache/src/lexigram/cache/exceptions.py	CacheError
LEX_ERR_CACHE_011	CacheInvalidationError	Raised when cache invalidation fails.	lexigram-cache/src/lexigram/cache/exceptions.py	CacheError
LEX_ERR_CACHE_012	LockAcquisitionError	Raised when a distributed lock cannot be acquired.	lexigram-cache/src/lexigram/cache/exceptions.py	CacheError
LEX_ERR_CACHE_013	CacheSerializationError	Raised when serialization/deserialization fails.	lexigram-cache/src/lexigram/cache/exceptions.py	SerializationError, CacheError
LEX_ERR_CACHE_014	CacheCapacityError	Raised when the cache is at capacity.	lexigram-cache/src/lexigram/cache/exceptions.py	CacheError
LEX_ERR_CACHE_015	CacheSerializationError	Raised when cache serialization or deserialization fails. This is a cache-specific subclass of th…	lexigram-cache/src/lexigram/cache/serialization/base.py	SerializationError

lexigram-cli (3 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_CLI_001	CliError	Base exception for lexigram-cli operations.	lexigram-cli/src/lexigram/cli/exceptions.py	LexigramError
LEX_ERR_CLI_002	ConfigNotFoundError	Raised when application.yaml configuration file is not found.	lexigram-cli/src/lexigram/cli/exceptions.py	CliError
LEX_ERR_CLI_003	ProviderNotInstalledError	Raised when a required provider package is not installed.	lexigram-cli/src/lexigram/cli/exceptions.py	CliError

lexigram-events (20 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_EVT_004	ConcurrencyError	Concurrency/optimistic locking error. Raised when event version conflicts indicate concurrent mod…	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_005	CommandExecutionError	Command execution error.	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_006	QueryExecutionError	Query execution error.	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_007	StreamNotFoundError	Raised when stream is not found. Parameters mirror the helper used in tests: (stream_type, stream…	lexigram-events/src/lexigram/events/exceptions.py	DomainError
LEX_ERR_EVT_008	EventHandlerError	Raised when event handling fails.	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_009	AggregateNotFoundError	Raised when aggregate is not found.	lexigram-events/src/lexigram/events/exceptions.py	NotFoundError
LEX_ERR_EVT_010	AdapterConnectionError	Raised when adapter connection fails.	lexigram-events/src/lexigram/events/exceptions.py	InfrastructureError
LEX_ERR_EVT_011	EventLoadError	Raised when event loading fails.	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_012	EventPersistenceError	Raised when event persistence fails.	lexigram-events/src/lexigram/events/exceptions.py	InfrastructureError, EventError
LEX_ERR_EVT_013	EventStoreError	Raised for event store errors.	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_014	EventStoreConnectionError	Raised when event store connection fails.	lexigram-events/src/lexigram/events/exceptions.py	EventStoreError, AdapterConnectionError
LEX_ERR_EVT_015	ProjectionBuildError	Raised when projection building fails.	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_016	ProjectionRebuildError	Raised when projection rebuilding fails (alias for collection stability).	lexigram-events/src/lexigram/events/exceptions.py	ProjectionBuildError
LEX_ERR_EVT_017	ProjectionNotFoundError	Raised when a projection is not found.	lexigram-events/src/lexigram/events/exceptions.py	NotFoundError
LEX_ERR_EVT_018	WebhookDeliveryError	Raised when an outbound webhook delivery fails after all retry attempts. Carries the target url…	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_019	SchemaError	Raised for schema-related errors.	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_020	SecurityError	Raised for security-related errors.	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_021	StreamingError	Raised for streaming-related errors.	lexigram-events/src/lexigram/events/exceptions.py	EventError
LEX_ERR_EVT_022	SchemaIncompatibleError	Raised when a schema is not compatible with previous version.	lexigram-events/src/lexigram/events/schema/models.py	EventError
LEX_ERR_EVT_023	SchemaNotFoundError	Raised when a schema is not found.	lexigram-events/src/lexigram/events/schema/models.py	EventError

lexigram-features (3 codes)

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

lexigram-graph (12 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_GRAPH_001	GraphError	Base exception for all graph store operations.	lexigram-graph/src/lexigram/graph/exceptions.py	InfrastructureError
LEX_ERR_GRAPH_002	GraphConnectionError	Failed to connect to the graph store.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_003	GraphNotFoundError	Requested graph database does not exist.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_004	GraphAlreadyExistsError	Attempted to create a graph that already exists.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_005	GraphNodeNotFoundError	Referenced node does not exist.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_006	GraphEdgeNotFoundError	Referenced edge does not exist.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_007	DetachRequiredError	Node has edges and detach=False was specified.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_008	TraversalError	Traversal query failed.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_009	CypherCompilationError	Failed to compile a traversal query to Cypher.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_010	GraphSchemaError	Schema operation (index, constraint) failed.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_011	GraphTransactionError	Graph transaction failed.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError
LEX_ERR_GRAPH_012	GraphQueryError	Raw query execution failed.	lexigram-graph/src/lexigram/graph/exceptions.py	GraphError

lexigram-graphql (15 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_GQL_001	GraphQLError	Base exception for all GraphQL errors.	lexigram-graphql/src/lexigram/graphql/exceptions.py	LexigramError
LEX_ERR_GQL_002	ExecutionError	Raised when execution fails.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_003	GraphQLTimeoutError	Raised when execution times out.	lexigram-graphql/src/lexigram/graphql/exceptions.py	ExecutionError
LEX_ERR_GQL_004	QueryTooDeepError	Raised when a GraphQL query exceeds the maximum depth.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_005	InputGraphQLError	Raised for invalid user input.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_006	ParseError	Raised when query parsing fails.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_007	QueryTooComplexError	Raised when query exceeds complexity limit.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_008	ResolverError	Raised when a resolver fails.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_009	AuthenticationError	Raised when authentication is required but missing. Also satisfies “lexigram.contracts.exception…	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError, _ContractsAuthenticationError
LEX_ERR_GQL_010	AuthorizationError	Raised when user is authenticated but lacks permissions. Also satisfies “lexigram.contracts.exce…	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError, _ContractsAuthorizationError
LEX_ERR_GQL_011	ForbiddenError	Raised when access is forbidden.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_012	NotFoundError	Raised when a requested resource is not found.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_013	RateLimitError	Raised when rate limit is exceeded.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_014	SubscriptionError	Raised for subscription-related errors.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError
LEX_ERR_GQL_015	GraphQLConnectionError	Raised when a network connection error occurs during GraphQL execution.	lexigram-graphql/src/lexigram/graphql/exceptions.py	GraphQLError

lexigram-http (7 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_HTTP_001	HTTPClientError	Base exception for all HTTP client errors.	lexigram-http/src/lexigram/http/exceptions.py	InfrastructureError
LEX_ERR_HTTP_002	HTTPConnectionError	Raised when a connection to a remote host fails.	lexigram-http/src/lexigram/http/exceptions.py	HTTPClientError
LEX_ERR_HTTP_003	HTTPTimeoutError	Raised when a connection or request times out.	lexigram-http/src/lexigram/http/exceptions.py	HTTPClientError
LEX_ERR_HTTP_004	HTTPInterceptorError	Raised when a request/response interceptor fails.	lexigram-http/src/lexigram/http/exceptions.py	HTTPClientError
LEX_ERR_HTTP_005	HTTPCircuitOpenError	Raised when the circuit breaker is open and requests are rejected.	lexigram-http/src/lexigram/http/exceptions.py	HTTPClientError
LEX_ERR_HTTP_006	HTTPRetryExhaustedError	Raised when all retry attempts for a request have been exhausted.	lexigram-http/src/lexigram/http/exceptions.py	HTTPClientError
LEX_ERR_HTTP_007	HTTPStatusError	Raised (or returned as an Err) when the server responds with 4xx/5xx. Callers using the Result-ba…	lexigram-http/src/lexigram/http/exceptions.py	HTTPClientError

lexigram-monitor (8 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_MONITOR_001	MonitorError	Base exception for monitoring errors.	lexigram-monitor/src/lexigram/monitor/exceptions.py	LexigramError
LEX_ERR_MONITOR_002	BackendNotAvailableError	Raised when a required monitoring backend is not available.	lexigram-monitor/src/lexigram/monitor/exceptions.py	MonitorError
LEX_ERR_MONITOR_003	MetricNotFoundError	Raised when a requested metric is not found.	lexigram-monitor/src/lexigram/monitor/exceptions.py	MonitorError
LEX_ERR_MONITOR_004	InvalidMetricError	Raised when metric parameters are invalid.	lexigram-monitor/src/lexigram/monitor/exceptions.py	MonitorError
LEX_ERR_MONITOR_005	SpanError	Base exception for span-related errors.	lexigram-monitor/src/lexigram/monitor/exceptions.py	MonitorError
LEX_ERR_MONITOR_006	SpanNotFoundError	Raised when a requested span is not found.	lexigram-monitor/src/lexigram/monitor/exceptions.py	SpanError
LEX_ERR_MONITOR_007	MonitorConfigurationError	Raised when monitoring configuration is invalid.	lexigram-monitor/src/lexigram/monitor/exceptions.py	MonitorError, _ConfigurationError
LEX_ERR_MONITOR_008	PerformanceMonitorError	Base exception for performance monitoring errors.	lexigram-monitor/src/lexigram/monitor/profiling/models.py	MonitorError

lexigram-nosql (6 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_NOSQL_001	NoSQLError	Base exception for all NoSQL operations.	lexigram-nosql/src/lexigram/nosql/exceptions.py	LexigramError
LEX_ERR_NOSQL_002	NoSQLConnectionError	Failed to connect to the document store.	lexigram-nosql/src/lexigram/nosql/exceptions.py	NoSQLError
LEX_ERR_NOSQL_003	DocumentNotFoundError	Requested document does not exist.	lexigram-nosql/src/lexigram/nosql/exceptions.py	NoSQLError
LEX_ERR_NOSQL_004	DuplicateKeyError	Insert/update violated a unique constraint.	lexigram-nosql/src/lexigram/nosql/exceptions.py	NoSQLError
LEX_ERR_NOSQL_005	DocumentValidationError	Document failed schema validation.	lexigram-nosql/src/lexigram/nosql/exceptions.py	NoSQLError
LEX_ERR_NOSQL_006	TransactionError	Multi-document transaction failed.	lexigram-nosql/src/lexigram/nosql/exceptions.py	NoSQLError

lexigram-notification (12 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_NOTIF_003	TwilioNotificationError	Twilio SMS delivery failure.	lexigram-notification/src/lexigram/notification/exceptions.py	NotificationError
LEX_ERR_NOTIF_004	FCMNotificationError	FCM push notification delivery failure.	lexigram-notification/src/lexigram/notification/exceptions.py	NotificationError
LEX_ERR_NOTIF_005	APNsNotificationError	APNs push notification delivery failure.	lexigram-notification/src/lexigram/notification/exceptions.py	NotificationError
LEX_ERR_NOTIF_006	SMTPMailerError	SMTP-specific delivery failure (rejection, auth error, etc.).	lexigram-notification/src/lexigram/notification/exceptions.py	MailerError
LEX_ERR_NOTIF_007	SendGridMailerError	SendGrid API delivery failure.	lexigram-notification/src/lexigram/notification/exceptions.py	MailerError
LEX_ERR_NOTIF_008	InboxError	Base exception for all inbox submodule errors.	lexigram-notification/src/lexigram/notification/exceptions.py	DomainError
LEX_ERR_NOTIF_009	InboxMessageNotFoundError	Raised when a requested inbox message does not exist.	lexigram-notification/src/lexigram/notification/exceptions.py	InboxError
LEX_ERR_NOTIF_010	InboxPermissionError	Raised when a user attempts to access another user’s inbox messages.	lexigram-notification/src/lexigram/notification/exceptions.py	InboxError
LEX_ERR_NOTIF_011	WebPushNotificationError	Web Push notification delivery failure.	lexigram-notification/src/lexigram/notification/exceptions.py	NotificationError
LEX_ERR_NOTIF_012	WhatsAppNotificationError	WhatsApp delivery failure via Twilio provider.	lexigram-notification/src/lexigram/notification/backends/sms/whatsapp.py	TwilioNotificationError
LEX_ERR_NOTIF_013	WhatsAppMetaNotificationError	WhatsApp delivery failure via Meta provider.	lexigram-notification/src/lexigram/notification/backends/sms/whatsapp.py	TwilioNotificationError
LEX_ERR_NOTIF_014	SlackNotificationError	Slack notification delivery failure.	lexigram-notification/src/lexigram/notification/backends/slack/slack_notifier.py	NotificationError

lexigram-queue (6 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_QUEUE_002	RedisQueueError	Redis queue failure.	lexigram-queue/src/lexigram/queue/exceptions.py	QueueError
LEX_ERR_QUEUE_003	RabbitMQQueueError	RabbitMQ queue failure.	lexigram-queue/src/lexigram/queue/exceptions.py	QueueError
LEX_ERR_QUEUE_004	KafkaQueueError	Kafka queue failure.	lexigram-queue/src/lexigram/queue/exceptions.py	QueueError
LEX_ERR_QUEUE_005	SQSQueueError	SQS queue failure.	lexigram-queue/src/lexigram/queue/exceptions.py	QueueError
LEX_ERR_QUEUE_006	AzureServiceBusQueueError	Azure Service Bus queue failure.	lexigram-queue/src/lexigram/queue/exceptions.py	QueueError
LEX_ERR_QUEUE_007	GCPPubSubQueueError	GCP Pub/Sub queue failure.	lexigram-queue/src/lexigram/queue/exceptions.py	QueueError

lexigram-resilience (6 codes)

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

lexigram-search (10 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_SEARCH_001	SearchError	Base exception for search operations.	lexigram-search/src/lexigram/search/exceptions.py	LexigramError
LEX_ERR_SEARCH_002	IndexNotFoundError	Raised when index is not found.	lexigram-search/src/lexigram/search/exceptions.py	DomainError
LEX_ERR_SEARCH_003	BackendError	Raised when search backend encounters an error.	lexigram-search/src/lexigram/search/exceptions.py	InfrastructureError
LEX_ERR_SEARCH_004	SearchValidationError	Raised when search query validation fails.	lexigram-search/src/lexigram/search/exceptions.py	SearchError
LEX_ERR_SEARCH_005	TransformationError	Raised when document transformation fails.	lexigram-search/src/lexigram/search/exceptions.py	SearchError
LEX_ERR_SEARCH_006	CacheError	Raised when search cache operation fails.	lexigram-search/src/lexigram/search/exceptions.py	SearchError
LEX_ERR_SEARCH_007	QueryError	Raised when search query execution fails.	lexigram-search/src/lexigram/search/exceptions.py	SearchError
LEX_ERR_SEARCH_008	ConfigurationError	Raised when search configuration is invalid.	lexigram-search/src/lexigram/search/exceptions.py	SearchError
LEX_ERR_SEARCH_009	SearchIndexError	Raised when search index operation fails.	lexigram-search/src/lexigram/search/exceptions.py	SearchError
LEX_ERR_SEARCH_010	SchedulerError	Raised when search scheduler operation fails.	lexigram-search/src/lexigram/search/exceptions.py	SearchError

lexigram-sql (37 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_SQL_001	DatabaseConnectionError	Base for all connection-related failures. Attributes: host: The database host that was targeted. …	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_002	ConnectionRefusedError	Server actively refused the connection.	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseConnectionError
LEX_ERR_SQL_003	ConnectionTimeoutError	Connection attempt timed out.	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseConnectionError
LEX_ERR_SQL_004	ConnectionPoolError	Connection pool exhausted — no connections available within timeout.	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseConnectionError
LEX_ERR_SQL_005	QueryError	Base for query execution failures. Attributes: sql: The SQL query that failed. params: The parame…	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_006	QuerySyntaxError	The SQL query has a syntax error.	lexigram-sql/src/lexigram/sql/exceptions.py	QueryError
LEX_ERR_SQL_007	ParameterBindingError	Failed to bind parameters to a query.	lexigram-sql/src/lexigram/sql/exceptions.py	QueryError
LEX_ERR_SQL_008	IntegrityError	Base for constraint violation errors. Attributes: constraint: The constraint name that was violat…	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_009	DuplicateKeyError	Unique constraint or primary key violated.	lexigram-sql/src/lexigram/sql/exceptions.py	IntegrityError
LEX_ERR_SQL_010	ForeignKeyError	Foreign key constraint violated.	lexigram-sql/src/lexigram/sql/exceptions.py	IntegrityError
LEX_ERR_SQL_011	NotNullViolationError	NOT NULL constraint violated. Attributes: column: The column that triggered the violation.	lexigram-sql/src/lexigram/sql/exceptions.py	IntegrityError
LEX_ERR_SQL_012	CheckConstraintError	CHECK constraint violated.	lexigram-sql/src/lexigram/sql/exceptions.py	IntegrityError
LEX_ERR_SQL_013	TransactionError	Base for transaction-related failures.	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_014	SerializationError	Serialization failure (optimistic concurrency conflict).	lexigram-sql/src/lexigram/sql/exceptions.py	TransactionError
LEX_ERR_SQL_015	OptimisticLockError	Raised when an optimistic lock check fails on UPDATE. Indicates a concurrent modification was det…	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_016	TransactionRollbackError	Transaction was rolled back (not by the application).	lexigram-sql/src/lexigram/sql/exceptions.py	TransactionError
LEX_ERR_SQL_017	LockError	Raised when a database lock cannot be acquired.	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_018	DeadlockError	Database deadlock detected. Inherits from :class:TransactionError because deadlocks are resolve…	lexigram-sql/src/lexigram/sql/exceptions.py	TransactionError
LEX_ERR_SQL_019	SchemaError	Base for schema-related errors.	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_020	TableNotFoundError	Referenced table does not exist.	lexigram-sql/src/lexigram/sql/exceptions.py	SchemaError
LEX_ERR_SQL_021	ColumnNotFoundError	Referenced column does not exist.	lexigram-sql/src/lexigram/sql/exceptions.py	SchemaError
LEX_ERR_SQL_022	DatabaseTimeoutError	Database operation timed out.	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_023	RepositoryError	RepositoryProtocol-level operation failure.	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_024	UnitOfWorkError	Raised when unit of work operation fails.	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_025	DriverError	Wraps underlying database driver exceptions. Preserves the original exception as __cause__ an…	lexigram-sql/src/lexigram/sql/exceptions.py	DatabaseError
LEX_ERR_SQL_026	DataError	Base exception for data access layer failures.	lexigram-sql/src/lexigram/sql/exceptions.py	LexigramError
LEX_ERR_SQL_027	DataQueryError	Raised when a query cannot be built or compiled. Args: message: Explanation of the query error.	lexigram-sql/src/lexigram/sql/exceptions.py	DataError
LEX_ERR_SQL_028	PaginationError	Raised when pagination parameters are invalid. Args: message: Explanation of the pagination error.	lexigram-sql/src/lexigram/sql/exceptions.py	DataError
LEX_ERR_SQL_029	EntityNotFoundError	Signals that a required entity does not exist. RepositoryProtocol implementations that cannot fin…	lexigram-sql/src/lexigram/sql/exceptions.py	DataError
LEX_ERR_SQL_030	DataRepositoryError	Raised when a repository operation fails unexpectedly. Args: message: Explanation of the reposito…	lexigram-sql/src/lexigram/sql/exceptions.py	DataError
LEX_ERR_SQL_031	CursorError	Raised when a cursor cannot be encoded or decoded. Args: message: Explanation of the cursor error.	lexigram-sql/src/lexigram/sql/exceptions.py	DataError
LEX_ERR_SQL_032	MigrationDependencyError	Raised when migration dependencies are not satisfied.	lexigram-sql/src/lexigram/sql/migrations/base.py	MigrationError
LEX_ERR_SQL_033	MigrationExecutionError	Raised when migration execution fails.	lexigram-sql/src/lexigram/sql/migrations/base.py	MigrationError
LEX_ERR_SQL_034	MigrationNotFoundError	Raised when a migration is not found.	lexigram-sql/src/lexigram/sql/migrations/base.py	MigrationError
LEX_ERR_SQL_035	MigrationValidationError	Raised when migration validation fails.	lexigram-sql/src/lexigram/sql/migrations/base.py	MigrationError
LEX_ERR_SQL_036	ProtocolValidationError	Raised when object doesn’t implement protocol.	lexigram-sql/src/lexigram/sql/validation/protocols.py	ConfigurationError
LEX_ERR_SQL_037	MappingError	Exception raised when entity mapping fails.	lexigram-sql/src/lexigram/sql/mappers/base.py	CoreMappingError

lexigram-storage (8 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_STORE_001	StorageError	Base exception for storage errors.	lexigram-storage/src/lexigram/storage/exceptions.py	LexigramError
LEX_ERR_STORE_002	StorageFileNotFoundError	Raised when file is not found.	lexigram-storage/src/lexigram/storage/exceptions.py	DomainError
LEX_ERR_STORE_003	StorageUnsupportedOperationError	Raised when the requested operation is not supported by the storage driver.	lexigram-storage/src/lexigram/storage/exceptions.py	StorageError
LEX_ERR_STORE_004	TransactionError	Raised when a transaction operation fails.	lexigram-storage/src/lexigram/storage/exceptions.py	StorageError
LEX_ERR_STORE_005	QuotaExceededError	Raised when a storage quota or size limit is exceeded.	lexigram-storage/src/lexigram/storage/exceptions.py	StorageError
LEX_ERR_STORE_006	InvalidPathError	Raised when a path is invalid or attempts directory traversal.	lexigram-storage/src/lexigram/storage/exceptions.py	StorageError
LEX_ERR_STORE_007	StorageUnavailableError	Raised when the storage backend is not reachable or unavailable.	lexigram-storage/src/lexigram/storage/exceptions.py	StorageError
LEX_ERR_STORE_008	ChecksumMismatchError	Raised when a file’s checksum does not match the expected value.	lexigram-storage/src/lexigram/storage/exceptions.py	StorageError

lexigram-tasks (10 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_TASK_002	QueueFullError	The queue has reached its maximum capacity and cannot accept new tasks. The caller should back of…	lexigram-tasks/src/lexigram/tasks/exceptions.py	TaskQueueError
LEX_ERR_TASK_003	TaskError	Base exception for all task-related errors	lexigram-tasks/src/lexigram/tasks/exceptions.py	TaskQueueError
LEX_ERR_TASK_004	TaskNotFoundError	Raised when a task cannot be found	lexigram-tasks/src/lexigram/tasks/exceptions.py	TaskError
LEX_ERR_TASK_005	TaskTimeoutError	Raised when a task execution exceeds timeout	lexigram-tasks/src/lexigram/tasks/exceptions.py	TaskError
LEX_ERR_TASK_006	TaskCancelledError	Raised when a task is cancelled	lexigram-tasks/src/lexigram/tasks/exceptions.py	TaskError
LEX_ERR_TASK_007	TaskExecutionError	Raised when a task execution fails	lexigram-tasks/src/lexigram/tasks/exceptions.py	TaskError
LEX_ERR_TASK_008	TaskValidationError	Raised when task parameters are invalid	lexigram-tasks/src/lexigram/tasks/exceptions.py	TaskError
LEX_ERR_TASK_009	DuplicateTaskError	Raised when a duplicate task is detected	lexigram-tasks/src/lexigram/tasks/exceptions.py	TaskError
LEX_ERR_TASK_010	TaskDependencyCycleError	Raised at registration time when a dependency cycle is detected. The scheduler validates the depe…	lexigram-tasks/src/lexigram/tasks/exceptions.py	TaskError
LEX_ERR_TASK_011	TaskRegistrationError	Raised when a scheduled or handler task fails to register.	lexigram-tasks/src/lexigram/tasks/exceptions.py	LexigramError

lexigram-testing (12 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_TEST_001	TestingError	Base exception for lexigram-testing operations.	lexigram-testing/src/lexigram/testing/exceptions.py	LexigramError
LEX_ERR_TEST_002	TokenBudgetExceededError	Raised when an AITestClient operation would exceed the configured token budget. Prevents runaway …	lexigram-testing/src/lexigram/testing/exceptions.py	TestingError
LEX_ERR_TEST_003	MemoryBackendError	Base exception for all memory backend errors.	lexigram-testing/src/lexigram/testing/memory/exceptions.py	LexigramError
LEX_ERR_TEST_004	CommandBusError	Raised when a command bus operation fails.	lexigram-testing/src/lexigram/testing/memory/exceptions.py	EventError
LEX_ERR_TEST_005	CommandHandlerNotFoundError	Raised when no handler is registered for a specific command type.	lexigram-testing/src/lexigram/testing/memory/exceptions.py	CommandBusError, HandlerNotFoundError
LEX_ERR_TEST_006	DuplicateHandlerError	Raised when a handler is already registered for a command type.	lexigram-testing/src/lexigram/testing/memory/exceptions.py	CommandBusError, ContractDuplicateHandlerError
LEX_ERR_TEST_007	CommandError	Wraps a handler exception for Result-based command dispatch.	lexigram-testing/src/lexigram/testing/memory/exceptions.py	CommandBusError
LEX_ERR_TEST_008	QueryBusError	Raised when a query bus operation fails.	lexigram-testing/src/lexigram/testing/memory/exceptions.py	EventError
LEX_ERR_TEST_009	QueryHandlerNotFoundError	Raised when no handler is registered for a specific query type.	lexigram-testing/src/lexigram/testing/memory/exceptions.py	QueryBusError, HandlerNotFoundError
LEX_ERR_TEST_010	QueryDuplicateHandlerError	Raised when a handler is already registered for a query type.	lexigram-testing/src/lexigram/testing/memory/exceptions.py	QueryBusError, ContractDuplicateHandlerError
LEX_ERR_TEST_011	ConfigurationError	Raised when a require_stub module is loaded via configure() in test mode. This exception indicate…	lexigram-testing/src/lexigram/testing/lib/stubs.py	Exception
LEX_ERR_TEST_012	SnapshotMismatchError	Raised when a value does not match the stored snapshot.	lexigram-testing/src/lexigram/testing/lib/snapshots.py	AssertionError

lexigram-ui (1 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_UI_001	UIError	Base exception for all UI-domain errors.	lexigram-ui/src/lexigram/ui/exceptions.py	LexigramError

lexigram-vector (11 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_VEC_005	VectorError	Base exception for all vector store operations.	lexigram-vector/src/lexigram/vector/exceptions.py	InfrastructureError
LEX_ERR_VEC_006	VectorConnectionError	Failed to connect to the vector store.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError
LEX_ERR_VEC_007	CollectionNotFoundError	Requested collection does not exist.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError
LEX_ERR_VEC_008	CollectionAlreadyExistsError	Attempted to create a collection that already exists.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError
LEX_ERR_VEC_009	DimensionMismatchError	Vector dimensionality does not match the collection.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError
LEX_ERR_VEC_010	VectorConfigError	Invalid vector store configuration.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError
LEX_ERR_VEC_011	FilterCompilationError	Failed to compile a metadata filter for the target backend.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError
LEX_ERR_VEC_012	VectorUpsertError	Failed to upsert vectors.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError
LEX_ERR_VEC_013	VectorSearchError	Failed to execute similarity search.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError
LEX_ERR_VEC_014	VectorDeleteError	Failed to delete vectors.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError
LEX_ERR_VEC_015	VectorTimeoutError	Vector store operation timed out.	lexigram-vector/src/lexigram/vector/exceptions.py	VectorError

lexigram-web (12 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_WEB_003	NotFoundError	404 Not Found.	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_004	BadRequestError	400 Bad Request.	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_005	UnauthorizedError	401 Unauthorized.	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_006	ForbiddenError	403 Forbidden.	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_007	MethodNotAllowedError	405 Method Not Allowed.	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_008	ConflictError	409 Conflict.	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_009	UnprocessableEntityError	422 Unprocessable Entity.	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_010	InternalServerError	500 Internal Server Error.	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_011	DependencyResolutionError	500 Dependency Resolution Error.	lexigram-web/src/lexigram/web/exceptions.py	InternalServerError
LEX_ERR_WEB_012	RateLimitError	429 Too Many Requests.	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_013	TooManyConnectionsError	503 Service Unavailable — connection limit reached. Raised when a streaming endpoint (e.g. SSE) h…	lexigram-web/src/lexigram/web/exceptions.py	HTTPError
LEX_ERR_WEB_014	HTTPError	Base HTTP error, compatible with LexigramError.	lexigram-web/src/lexigram/web/exceptions.py	LexigramError

lexigram-webhook (5 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_WEBHOOK_002	SubscriptionNotFoundError	Raised when a subscription ID is not found.	lexigram-webhook/src/lexigram/webhook/exceptions.py	WebhookError
LEX_ERR_WEBHOOK_003	SubscriptionInactiveError	Raised when attempting to deliver to a deactivated subscription.	lexigram-webhook/src/lexigram/webhook/exceptions.py	WebhookError
LEX_ERR_WEBHOOK_004	InvalidWebhookURLError	Raised when a subscription URL fails validation.	lexigram-webhook/src/lexigram/webhook/exceptions.py	WebhookError
LEX_ERR_WEBHOOK_005	DeliveryAttemptNotFoundError	Raised when a delivery attempt ID is not found.	lexigram-webhook/src/lexigram/webhook/exceptions.py	WebhookError
LEX_ERR_WEBHOOK_006	SecretRotationError	Raised when secret rotation fails.	lexigram-webhook/src/lexigram/webhook/exceptions.py	WebhookError

lexigram-workflow (20 codes)

Code	Class	Description	File	Inherits From
LEX_ERR_WF_003	WorkflowError	Base exception for workflow orchestration errors.	lexigram-workflow/src/lexigram/workflow/exceptions.py	PipelineExecutionError
LEX_ERR_WF_004	WorkflowNotFoundError	Raised when a workflow definition cannot be found.	lexigram-workflow/src/lexigram/workflow/exceptions.py	WorkflowError
LEX_ERR_WF_005	WorkflowStateError	Raised when a workflow is in an invalid state for the requested operation.	lexigram-workflow/src/lexigram/workflow/exceptions.py	WorkflowError
LEX_ERR_WF_006	WorkflowStepError	Raised when a workflow step fails to execute.	lexigram-workflow/src/lexigram/workflow/exceptions.py	WorkflowError
LEX_ERR_WF_007	WorkflowTimeoutError	Raised when a workflow or step exceeds its timeout.	lexigram-workflow/src/lexigram/workflow/exceptions.py	WorkflowError
LEX_ERR_WF_008	WorkflowCompensationError	Raised when workflow compensation/rollback fails.	lexigram-workflow/src/lexigram/workflow/exceptions.py	WorkflowError
LEX_ERR_WF_009	SagaVersionMismatchError	Raised when a persisted saga state version is incompatible with the current code. Args: saga_id: …	lexigram-workflow/src/lexigram/workflow/exceptions.py	WorkflowError
LEX_ERR_WF_010	WorkflowVersionMismatchError	Raised when resuming a workflow instance with a mismatched definition version. Resuming an in-fli…	lexigram-workflow/src/lexigram/workflow/exceptions.py	WorkflowError
LEX_ERR_WF_011	GraphExecutionError	Base exception for graph workflow engine operations. Args: message: Human-readable error descript…	lexigram-workflow/src/lexigram/workflow/exceptions.py	LexigramError
LEX_ERR_WF_012	NodeExecutionError	A graph node’s execute() method failed. Args: message: Human-readable error description. node: Na…	lexigram-workflow/src/lexigram/workflow/exceptions.py	GraphExecutionError
LEX_ERR_WF_013	CycleDetectedError	Graph engine exceeded max_iterations (likely cycle). Args: iterations: Number of iterations compl…	lexigram-workflow/src/lexigram/workflow/exceptions.py	GraphExecutionError
LEX_ERR_WF_014	GraphTimeoutError	Graph workflow execution exceeded total timeout. Args: timeout: The configured timeout value in s…	lexigram-workflow/src/lexigram/workflow/exceptions.py	GraphExecutionError
LEX_ERR_WF_015	GraphValidationError	Graph structure validation failed.	lexigram-workflow/src/lexigram/workflow/exceptions.py	GraphExecutionError
LEX_ERR_WF_016	HumanInputRequiredError	Raised by HumanNode to pause execution awaiting human input. Args: prompt: Text/question to displ…	lexigram-workflow/src/lexigram/workflow/exceptions.py	GraphExecutionError
LEX_ERR_WF_017	StateError	Raised when an invalid state transition is attempted. Attributes: event: The event that was not p…	lexigram-workflow/src/lexigram/workflow/state/exceptions.py	LexigramError
LEX_ERR_WF_018	StateConcurrencyError	Raised when optimistic version checks fail during a transition.	lexigram-workflow/src/lexigram/workflow/state/exceptions.py	StateError
LEX_ERR_WF_019	SagaError	Raised when a saga step fails after compensation has been attempted. Attributes: step_name: Name …	lexigram-workflow/src/lexigram/workflow/saga/base.py	LexigramError
LEX_ERR_WF_020	BulkOperationError	Base exception for bulk operation errors.	lexigram-workflow/src/lexigram/workflow/bulk/models.py	LexigramError
LEX_ERR_WF_021	BulkOperationTimeoutError	Raised when a bulk operation times out.	lexigram-workflow/src/lexigram/workflow/bulk/models.py	BulkOperationError
LEX_ERR_WF_022	BulkOperationCancelledError	Raised when a bulk operation is cancelled.	lexigram-workflow/src/lexigram/workflow/bulk/models.py	BulkOperationError

---

3. Code Gaps by Domain

• CORE: missing codes 003, 004
• MEM: missing codes 004, 007
• RAG: missing codes 007, 008, 009
• RESULT: missing codes 001

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: 11 classes across 8 packages

lexigram-contracts (3 classes)

Class	Inherits From	File
ContributorDependencyError	ValueError	lexigram-contracts/src/lexigram/contracts/admin/dependencies.py
HealthCheckNotFoundError	—	lexigram-contracts/src/lexigram/contracts/admin/errors.py
WidgetNotFoundError	—	lexigram-contracts/src/lexigram/contracts/admin/errors.py

lexigram-ai-llm (1 classes)

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

lexigram-ai-rag (1 classes)

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

lexigram-ai-workers (1 classes)

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

lexigram-cli (1 classes)

Class	Inherits From	File
LoadError	—	lexigram-cli/src/lexigram/cli/contributors/runtime.py

lexigram-sql (1 classes)

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

lexigram-web (2 classes)

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

lexigram-workflow (1 classes)

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

5. Duplicate Codes

⚠️ Duplicate codes found:

• LEX_ERR_NOTIF_011 appears 2 times:
  • WebPushNotificationError in lexigram-notification/src/lexigram/notification/exceptions.py
  • PermanentDeliveryFailure in lexigram-notification/src/lexigram/notification/delivery/exceptions.py
• LEX_ERR_TASK_011 appears 2 times:
  • TaskRegistrationError in lexigram-tasks/src/lexigram/tasks/exceptions.py
  • WorkflowError in lexigram-tasks/src/lexigram/tasks/workflows/core.py

6. Packages Without Registered Codes

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

Total: 2 packages

• lexigram-ai-mcp
• lexigram-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	lexigram-contracts/src/lexigram/contracts/admin/errors.py	lexigram-contracts

8. Full Index by Domain

Complete alphabetical listing of all codes grouped by domain tag.

ADMIN (1 codes)

Code	Class	Description	Package
LEX_ERR_ADMIN_001	AdminError	Base exception for all admin-domain errors. Extended by leaf exceptions in le…	lexigram-contracts

AGT (11 codes)

Code	Class	Description	Package
LEX_ERR_AGT_001	AgentError	Base exception for all agent errors.	lexigram-contracts
LEX_ERR_AGT_002	ToolError	Base exception for tool errors.	lexigram-contracts
LEX_ERR_AGT_003	StrategyError	Reasoning strategy failed. Raised when the agent’s strategy encounters an err…	lexigram-contracts
LEX_ERR_AGT_004	AgentConfigurationError	Invalid agent configuration. Raised when an agent is constructed with invalid…	lexigram-ai-agents
LEX_ERR_AGT_005	AgentExecutionError	Agent execution failed. Raised when the agent’s reasoning loop encounters an …	lexigram-ai-agents
LEX_ERR_AGT_006	ToolNotFoundError	Tool not found in registry. Raised when the agent tries to call a tool that i…	lexigram-ai-agents
LEX_ERR_AGT_007	ToolExecutionError	Tool execution failed. Raised when a tool raises an exception during execution.	lexigram-ai-agents
LEX_ERR_AGT_008	ToolAccessDeniedError	Agent does not have access to this tool. Raised when module visibility contro…	lexigram-ai-agents
LEX_ERR_AGT_009	MaxIterationsExceededError	Agent exceeded maximum reasoning iterations. Raised when the agent reaches ma…	lexigram-ai-agents
LEX_ERR_AGT_010	BudgetExceededError	Agent exceeded its AI governance budget. Raised when token usage or cost exce…	lexigram-ai-agents
LEX_ERR_AGT_011	ToolValidationError	Tool input validation failed. Raised when the arguments provided to a tool fa…	lexigram-ai-agents

AI (5 codes)

Code	Class	Description	Package
LEX_ERR_AI_001	AIError	Base exception for all AI-domain errors. This is the catch-all for AI operati…	lexigram-contracts
LEX_ERR_AI_002	ExtractionError	Base for structured extraction errors. Used in “StructuredExtractorProtocol…	lexigram-contracts
LEX_ERR_AI_003	MetricsCollectionError	Error raised during metrics collection.	lexigram-contracts
LEX_ERR_AI_004	TracingError	Error raised during tracing operations.	lexigram-contracts
LEX_ERR_AI_005	AIError	Base exception for lexigram-ai.	lexigram-ai

AIWORK (3 codes)

Code	Class	Description	Package
LEX_ERR_AIWORK_001	WorkerError	Base exception for all worker-related errors.	lexigram-ai-workers
LEX_ERR_AIWORK_002	DLQError	Raised when a Dead Letter Queue operation fails.	lexigram-ai-workers
LEX_ERR_AIWORK_003	MaintenanceError	Raised when a maintenance task operation fails.	lexigram-ai-workers

APP (3 codes)

Code	Class	Description	Package
LEX_ERR_APP_001	AppError	Base exception for all app errors.	lexigram
LEX_ERR_APP_002	AppStartupError	Raised when the application fails to start or a provider fails during boot.	lexigram
LEX_ERR_APP_003	AppShutdownError	Raised when the application cannot complete a graceful shutdown.	lexigram

AUDIT (4 codes)

Code	Class	Description	Package
LEX_ERR_AUDIT_001	AuditError	Base exception for all audit-domain errors.	lexigram-audit
LEX_ERR_AUDIT_002	AuditStoreError	Raised when the audit store fails to persist or query entries.	lexigram-audit
LEX_ERR_AUDIT_003	AuditVerificationError	Raised when audit trail verification encounters an unexpected failure.	lexigram-audit
LEX_ERR_AUDIT_004	AuditRetentionError	Raised when a retention purge fails.	lexigram-audit

AUTH (28 codes)

Code	Class	Description	Package
LEX_ERR_AUTH_001	AuthError	Base exception for all auth-domain errors. This is the catch-all for authenti…	lexigram-contracts
LEX_ERR_AUTH_002	TokenError	Base class for expected, recoverable token domain failures. All subtypes indi…	lexigram-contracts
LEX_ERR_AUTH_003	VerificationError	Base class for expected, recoverable account-verification failures. All subty…	lexigram-contracts
LEX_ERR_AUTH_004	AuthError	Base exception for all auth errors.	lexigram-auth
LEX_ERR_AUTH_005	AuthenticationError	Raised when authentication fails.	lexigram-auth
LEX_ERR_AUTH_006	AuthorizationError	Raised when user lacks required permissions.	lexigram-auth
LEX_ERR_AUTH_007	InvalidCredentialsError	Raised when credentials are invalid.	lexigram-auth
LEX_ERR_AUTH_008	AccountLockedError	Raised when an account is locked due to too many failed login attempts. Accou…	lexigram-auth
LEX_ERR_AUTH_009	UserNotFoundError	Raised when user is not found.	lexigram-auth
LEX_ERR_AUTH_010	TokenError	Base exception for token-related errors.	lexigram-auth
LEX_ERR_AUTH_011	InvalidTokenError	Raised when a token is malformed or invalid.	lexigram-auth
LEX_ERR_AUTH_012	TokenExpiredError	Raised when a token has expired.	lexigram-auth
LEX_ERR_AUTH_013	TokenBlacklistedError	Token has been explicitly revoked.	lexigram-auth
LEX_ERR_AUTH_014	TokenInvalidError	Token is structurally invalid or has wrong type.	lexigram-auth
LEX_ERR_AUTH_015	TokenAudienceError	Token audience claim does not match expected.	lexigram-auth
LEX_ERR_AUTH_016	TokenNotFoundError	Token record does not exist.	lexigram-auth
LEX_ERR_AUTH_017	InvalidAudienceError	Raised when a token audience is invalid.	lexigram-auth
LEX_ERR_AUTH_018	InvalidScopeError	Raised when a token lacks required scope.	lexigram-auth
LEX_ERR_AUTH_019	BlacklistedTokenError	Raised when a token has been blacklisted.	lexigram-auth
LEX_ERR_AUTH_020	TokenExpiredVerificationError	Account verification has expired.	lexigram-auth
LEX_ERR_AUTH_021	AlreadyVerifiedError	Account is already verified.	lexigram-auth
LEX_ERR_AUTH_022	EmailExistsError	Raised when email is already taken.	lexigram-auth
LEX_ERR_AUTH_023	UsernameExistsError	Raised when username is already taken.	lexigram-auth
LEX_ERR_AUTH_024	PasswordPolicyError	Raised when password doesn’t meet requirements.	lexigram-auth
LEX_ERR_AUTH_025	OAuth2Error	Base exception for OAuth2 errors.	lexigram-auth
LEX_ERR_AUTH_026	SessionNotFoundError	Raised when a session cannot be found in the store.	lexigram-auth
LEX_ERR_AUTH_027	AccountVerificationError	Error during account verification operations.	lexigram-auth
LEX_ERR_AUTH_028	PasswordResetTokenError	Error during password reset token operations.	lexigram-auth

CACHE (15 codes)

Code	Class	Description	Package
LEX_ERR_CACHE_001	CacheError	Base exception for all cache-domain errors. This is an expected, recoverable …	lexigram-contracts
LEX_ERR_CACHE_002	CacheKeyNotFoundError	Raised when cache key is not found.	lexigram-contracts
LEX_ERR_CACHE_003	CacheWriteError	Raised when cache write fails.	lexigram-contracts
LEX_ERR_CACHE_004	CacheError	Base exception for cache errors.	lexigram-cache
LEX_ERR_CACHE_005	CacheBackendError	Raised when the cache backend (Redis/Memcached) fails.	lexigram-cache
LEX_ERR_CACHE_006	CacheConnectionError	Raised when the cache connection fails.	lexigram-cache
LEX_ERR_CACHE_007	CacheTimeoutError	Raised when a cache operation times out.	lexigram-cache
LEX_ERR_CACHE_008	CacheKeyError	Raised when a cache key is invalid or for key-specific errors.	lexigram-cache
LEX_ERR_CACHE_009	CacheConfigurationError	Raised when cache configuration is invalid.	lexigram-cache
LEX_ERR_CACHE_010	CacheStampedeError	Raised when cache stampede protection fails.	lexigram-cache
LEX_ERR_CACHE_011	CacheInvalidationError	Raised when cache invalidation fails.	lexigram-cache
LEX_ERR_CACHE_012	LockAcquisitionError	Raised when a distributed lock cannot be acquired.	lexigram-cache
LEX_ERR_CACHE_013	CacheSerializationError	Raised when serialization/deserialization fails.	lexigram-cache
LEX_ERR_CACHE_014	CacheCapacityError	Raised when the cache is at capacity.	lexigram-cache
LEX_ERR_CACHE_015	CacheSerializationError	Raised when cache serialization or deserialization fails. This is a cache-spe…	lexigram-cache

CFG (5 codes)

Code	Class	Description	Package
LEX_ERR_CFG_001	ConfigurationError	Developer configuration or runtime misconfiguration errors. Supports optional…	lexigram-contracts
LEX_ERR_CFG_002	ConfigurationError	Configuration loading, parsing, or validation failed. Raised by: - “ConfigPr…	lexigram
LEX_ERR_CFG_003	ConfigSourceError	Raised when a configuration source fails to load its values.	lexigram
LEX_ERR_CFG_004	ConfigReloadError	Raised when a live-reload attempt fails.	lexigram
LEX_ERR_CFG_005	ConfigSectionNotFoundError	Raised when a required config section is absent from the loaded config.	lexigram

CLI (3 codes)

Code	Class	Description	Package
LEX_ERR_CLI_001	CliError	Base exception for lexigram-cli operations.	lexigram-cli
LEX_ERR_CLI_002	ConfigNotFoundError	Raised when application.yaml configuration file is not found.	lexigram-cli
LEX_ERR_CLI_003	ProviderNotInstalledError	Raised when a required provider package is not installed.	lexigram-cli

CONC (8 codes)

Code	Class	Description	Package
LEX_ERR_CONC_001	ConcurrencyError	Base exception for all concurrency errors.	lexigram
LEX_ERR_CONC_002	AsyncError	Exception raised for errors in asynchronous operations or concurrency control.	lexigram
LEX_ERR_CONC_003	ChannelClosedError	Raised when an operation is attempted on a closed channel.	lexigram
LEX_ERR_CONC_004	ChannelFullError	Raised when sending to a channel that is at capacity.	lexigram
LEX_ERR_CONC_005	DispatcherError	Error in dispatcher execution.	lexigram
LEX_ERR_CONC_006	StructuredParallelismError	Base exception for parallel execution errors.	lexigram
LEX_ERR_CONC_007	TaskGroupError	Raised when a task group encounters an error.	lexigram
LEX_ERR_CONC_008	CancellationScopeError	Raised when a cancellation scope encounters an error.	lexigram

CORE (3 codes)

Code	Class	Description	Package
LEX_ERR_CORE_001	LexigramError	Root exception for the entire Lexigram ecosystem. All Lexigram exceptions inh…	lexigram-contracts
LEX_ERR_CORE_002	LexigramException	Base exception for all lexigram domain errors. Extends :class:`~lexigram.cont…	lexigram
LEX_ERR_CORE_005	CoreError	Base exception for all core errors.	lexigram

DB (11 codes)

Code	Class	Description	Package
LEX_ERR_DB_001	DatabaseError	Database-related error (infrastructure-level).	lexigram-contracts
LEX_ERR_DB_002	MigrationError	Database migration error.	lexigram-contracts
LEX_ERR_DB_003	IntegrityError	Raised when a database integrity constraint is violated.	lexigram-contracts
LEX_ERR_DB_004	ConstraintError	Raised when a generic database constraint is violated.	lexigram-contracts
LEX_ERR_DB_005	DuplicateKeyError	Raised when a unique-key constraint is violated (duplicate record).	lexigram-contracts
LEX_ERR_DB_006	UnitOfWorkError	Raised when a unit-of-work operation fails or is used incorrectly.	lexigram-contracts
LEX_ERR_DB_007	DataError	Base exception for all data-domain errors. This is an expected, recoverable e…	lexigram-contracts
LEX_ERR_DB_008	DataNotFoundError	Raised when data item is not found.	lexigram-contracts
LEX_ERR_DB_009	DataValidationError	Raised when data validation fails.	lexigram-contracts
LEX_ERR_DB_010	InvalidIdentifierError	Raised when an SQL identifier fails validation. Attributes: identifier: The o…	lexigram-contracts
LEX_ERR_DB_011	NoPrimaryBackendError	Raised when a multi-backend setup has no backend marked as primary. For multi…	lexigram-contracts

DI (11 codes)

Code	Class	Description	Package
LEX_ERR_DI_001	ContainerError	Base container error.	lexigram-contracts
LEX_ERR_DI_002	DependencyError	Dependency resolution error.	lexigram-contracts
LEX_ERR_DI_003	CircularDependencyError	Circular dependency detected.	lexigram-contracts
LEX_ERR_DI_004	UnresolvableDependencyError	Cannot resolve dependency.	lexigram-contracts
LEX_ERR_DI_005	RegistrationError	Service registration error.	lexigram-contracts
LEX_ERR_DI_006	ContainerBuildError	Container build/configuration error.	lexigram-contracts
LEX_ERR_DI_007	ProtocolValidationError	Protocol validation error.	lexigram-contracts
LEX_ERR_DI_008	ContainerValidationError	Container dependency graph validation failed before boot. Raised when “Conta…	lexigram-contracts
LEX_ERR_DI_009	ScopedResolutionError	Attempted to resolve a scoped service outside of an active scope. Raised when…	lexigram-contracts
LEX_ERR_DI_010	InjectionError	Dependency injection or container resolution failed. Raised by: - “Container…	lexigram
LEX_ERR_DI_011	InterceptorTimeoutError	Raised when a MethodInterceptorProtocol exceeds its configured timeout.	lexigram

DOM (9 codes)

Code	Class	Description	Package
LEX_ERR_DOM_001	DomainError	Business/domain-level errors (validation failures, not found, auth).	lexigram-contracts
LEX_ERR_DOM_002	NotFoundError	Resource not found error (domain-level).	lexigram-contracts
LEX_ERR_DOM_003	PermissionDeniedError	Permission denied error (domain-level).	lexigram-contracts
LEX_ERR_DOM_004	AuthenticationError	Authentication error (domain-level).	lexigram-contracts
LEX_ERR_DOM_005	AuthorizationError	Authorization/permission error (domain-level).	lexigram-contracts
LEX_ERR_DOM_006	RateLimitError	Rate limiting error.	lexigram-contracts
LEX_ERR_DOM_007	ConflictError	Resource conflict error.	lexigram-contracts
LEX_ERR_DOM_008	DomainModelError	Domain model invariant violated or business rule broken. Raised by: - Domain …	lexigram
LEX_ERR_DOM_009	PolicyViolationError	Raised when a domain policy evaluation fails. Distinct from “PolicyViolation…	lexigram

EVAL (1 codes)

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

EVT (23 codes)

Code	Class	Description	Package
LEX_ERR_EVT_001	EventError	Base events/messaging error.	lexigram-contracts
LEX_ERR_EVT_002	HandlerNotFoundError	Event/command handler not found. Raised when no handler is registered for a s…	lexigram-contracts
LEX_ERR_EVT_003	DuplicateHandlerError	Duplicate handler registration. Raised when attempting to register a handler …	lexigram-contracts
LEX_ERR_EVT_004	ConcurrencyError	Concurrency/optimistic locking error. Raised when event version conflicts ind…	lexigram-events
LEX_ERR_EVT_005	CommandExecutionError	Command execution error.	lexigram-events
LEX_ERR_EVT_006	QueryExecutionError	Query execution error.	lexigram-events
LEX_ERR_EVT_007	StreamNotFoundError	Raised when stream is not found. Parameters mirror the helper used in tests: …	lexigram-events
LEX_ERR_EVT_008	EventHandlerError	Raised when event handling fails.	lexigram-events
LEX_ERR_EVT_009	AggregateNotFoundError	Raised when aggregate is not found.	lexigram-events
LEX_ERR_EVT_010	AdapterConnectionError	Raised when adapter connection fails.	lexigram-events
LEX_ERR_EVT_011	EventLoadError	Raised when event loading fails.	lexigram-events
LEX_ERR_EVT_012	EventPersistenceError	Raised when event persistence fails.	lexigram-events
LEX_ERR_EVT_013	EventStoreError	Raised for event store errors.	lexigram-events
LEX_ERR_EVT_014	EventStoreConnectionError	Raised when event store connection fails.	lexigram-events
LEX_ERR_EVT_015	ProjectionBuildError	Raised when projection building fails.	lexigram-events
LEX_ERR_EVT_016	ProjectionRebuildError	Raised when projection rebuilding fails (alias for collection stability).	lexigram-events
LEX_ERR_EVT_017	ProjectionNotFoundError	Raised when a projection is not found.	lexigram-events
LEX_ERR_EVT_018	WebhookDeliveryError	Raised when an outbound webhook delivery fails after all retry attempts. Carr…	lexigram-events
LEX_ERR_EVT_019	SchemaError	Raised for schema-related errors.	lexigram-events
LEX_ERR_EVT_020	SecurityError	Raised for security-related errors.	lexigram-events
LEX_ERR_EVT_021	StreamingError	Raised for streaming-related errors.	lexigram-events
LEX_ERR_EVT_022	SchemaIncompatibleError	Raised when a schema is not compatible with previous version.	lexigram-events
LEX_ERR_EVT_023	SchemaNotFoundError	Raised when a schema is not found.	lexigram-events

FEAT (4 codes)

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

FEED (3 codes)

Code	Class	Description	Package
LEX_ERR_FEED_001	FeedbackError	Base exception for all feedback-related errors.	lexigram-ai-feedback
LEX_ERR_FEED_002	FeedbackProcessingError	Raised when a feedback processor fails.	lexigram-ai-feedback
LEX_ERR_FEED_003	FeedbackValidationError	Raised when feedback data fails validation.	lexigram-ai-feedback

GOV (3 codes)

Code	Class	Description	Package
LEX_ERR_GOV_001	GovernanceError	Base class for governance-related errors.	lexigram-contracts
LEX_ERR_GOV_002	BudgetExceededError	Error raised when budget is exceeded.	lexigram-contracts
LEX_ERR_GOV_003	PolicyViolationError	Error raised when policy is violated.	lexigram-contracts

GQL (15 codes)

Code	Class	Description	Package
LEX_ERR_GQL_001	GraphQLError	Base exception for all GraphQL errors.	lexigram-graphql
LEX_ERR_GQL_002	ExecutionError	Raised when execution fails.	lexigram-graphql
LEX_ERR_GQL_003	GraphQLTimeoutError	Raised when execution times out.	lexigram-graphql
LEX_ERR_GQL_004	QueryTooDeepError	Raised when a GraphQL query exceeds the maximum depth.	lexigram-graphql
LEX_ERR_GQL_005	InputGraphQLError	Raised for invalid user input.	lexigram-graphql
LEX_ERR_GQL_006	ParseError	Raised when query parsing fails.	lexigram-graphql
LEX_ERR_GQL_007	QueryTooComplexError	Raised when query exceeds complexity limit.	lexigram-graphql
LEX_ERR_GQL_008	ResolverError	Raised when a resolver fails.	lexigram-graphql
LEX_ERR_GQL_009	AuthenticationError	Raised when authentication is required but missing. Also satisfies “lexigram…	lexigram-graphql
LEX_ERR_GQL_010	AuthorizationError	Raised when user is authenticated but lacks permissions. Also satisfies “lex…	lexigram-graphql
LEX_ERR_GQL_011	ForbiddenError	Raised when access is forbidden.	lexigram-graphql
LEX_ERR_GQL_012	NotFoundError	Raised when a requested resource is not found.	lexigram-graphql
LEX_ERR_GQL_013	RateLimitError	Raised when rate limit is exceeded.	lexigram-graphql
LEX_ERR_GQL_014	SubscriptionError	Raised for subscription-related errors.	lexigram-graphql
LEX_ERR_GQL_015	GraphQLConnectionError	Raised when a network connection error occurs during GraphQL execution.	lexigram-graphql

GRAPH (12 codes)

Code	Class	Description	Package
LEX_ERR_GRAPH_001	GraphError	Base exception for all graph store operations.	lexigram-graph
LEX_ERR_GRAPH_002	GraphConnectionError	Failed to connect to the graph store.	lexigram-graph
LEX_ERR_GRAPH_003	GraphNotFoundError	Requested graph database does not exist.	lexigram-graph
LEX_ERR_GRAPH_004	GraphAlreadyExistsError	Attempted to create a graph that already exists.	lexigram-graph
LEX_ERR_GRAPH_005	GraphNodeNotFoundError	Referenced node does not exist.	lexigram-graph
LEX_ERR_GRAPH_006	GraphEdgeNotFoundError	Referenced edge does not exist.	lexigram-graph
LEX_ERR_GRAPH_007	DetachRequiredError	Node has edges and detach=False was specified.	lexigram-graph
LEX_ERR_GRAPH_008	TraversalError	Traversal query failed.	lexigram-graph
LEX_ERR_GRAPH_009	CypherCompilationError	Failed to compile a traversal query to Cypher.	lexigram-graph
LEX_ERR_GRAPH_010	GraphSchemaError	Schema operation (index, constraint) failed.	lexigram-graph
LEX_ERR_GRAPH_011	GraphTransactionError	Graph transaction failed.	lexigram-graph
LEX_ERR_GRAPH_012	GraphQueryError	Raw query execution failed.	lexigram-graph

GUARD (3 codes)

Code	Class	Description	Package
LEX_ERR_GUARD_001	GuardError	Base for AI guard/policy enforcement errors. Extended in the AI guard layer w…	lexigram-contracts
LEX_ERR_GUARD_002	InputGuardError	Error raised during input guard validation.	lexigram-contracts
LEX_ERR_GUARD_003	OutputGuardError	Error raised during output guard validation.	lexigram-contracts

HTTP (7 codes)

Code	Class	Description	Package
LEX_ERR_HTTP_001	HTTPClientError	Base exception for all HTTP client errors.	lexigram-http
LEX_ERR_HTTP_002	HTTPConnectionError	Raised when a connection to a remote host fails.	lexigram-http
LEX_ERR_HTTP_003	HTTPTimeoutError	Raised when a connection or request times out.	lexigram-http
LEX_ERR_HTTP_004	HTTPInterceptorError	Raised when a request/response interceptor fails.	lexigram-http
LEX_ERR_HTTP_005	HTTPCircuitOpenError	Raised when the circuit breaker is open and requests are rejected.	lexigram-http
LEX_ERR_HTTP_006	HTTPRetryExhaustedError	Raised when all retry attempts for a request have been exhausted.	lexigram-http
LEX_ERR_HTTP_007	HTTPStatusError	Raised (or returned as an Err) when the server responds with 4xx/5xx. Callers…	lexigram-http

IDEM (6 codes)

Code	Class	Description	Package
LEX_ERR_IDEM_001	IdempotencyError	Base exception for idempotency flows.	lexigram-contracts
LEX_ERR_IDEM_002	DuplicateRequestError	Raised when an idempotent key is reused before completion.	lexigram-contracts
LEX_ERR_IDEM_003	IdempotencyStoreError	Raised on unexpected failures inside the idempotency store.	lexigram-contracts
LEX_ERR_IDEM_004	IdempotencyConflictError	Raised when an idempotency key is already claimed (PENDING).	lexigram-contracts
LEX_ERR_IDEM_005	IdempotencyBackendError	Raised when a Redis or database backend connection fails. This exception is r…	lexigram-resilience
LEX_ERR_IDEM_006	IdempotencyConfigurationError	Raised when the idempotency store is misconfigured. This exception is raised …	lexigram-resilience

IDX (1 codes)

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

INFRA (11 codes)

Code	Class	Description	Package
LEX_ERR_INFRA_001	InfrastructureError	System-level failures (DB down, network timeouts).	lexigram-contracts
LEX_ERR_INFRA_002	LockError	Distributed lock error.	lexigram-contracts
LEX_ERR_INFRA_003	LockConflictError	Raised when a lock conflict occurs (resource already locked).	lexigram-contracts
LEX_ERR_INFRA_004	ComponentError	Base exception for all component-related errors.	lexigram-contracts
LEX_ERR_INFRA_005	ComponentConnectionError	Raised when a connection to an external service fails.	lexigram-contracts
LEX_ERR_INFRA_006	KeyNotFoundError	Raised when a requested key does not exist.	lexigram-contracts
LEX_ERR_INFRA_007	KeyExistsError	Raised when trying to create a key that already exists.	lexigram-contracts
LEX_ERR_INFRA_008	PubSubError	Base exception for pub/sub operations.	lexigram-contracts
LEX_ERR_INFRA_009	SecretNotFoundError	Raised when a requested secret does not exist.	lexigram-contracts
LEX_ERR_INFRA_010	DriverNotAvailableError	Raised when a driver is not available (dependency not installed).	lexigram-contracts
LEX_ERR_INFRA_011	_StoredStreamError	Internal carrier for propagating typed stream failures.	lexigram-contracts

LLM (26 codes)

Code	Class	Description	Package
LEX_ERR_LLM_001	LLMError	Base for LLM client errors. Extended in lexigram-ai-llm with specific failure…	lexigram-contracts
LEX_ERR_LLM_002	LLMError	Base exception for all LLM-domain errors in lexigram-ai-llm.	lexigram-ai-llm
LEX_ERR_LLM_003	LLMAuthenticationError	Invalid API key or credentials — infrastructure error, raised not wrapped. Ra…	lexigram-ai-llm
LEX_ERR_LLM_004	InvalidRequestError	Error raised when a request to an LLM provider is invalid.	lexigram-ai-llm
LEX_ERR_LLM_005	ModelNotFoundError	Model unavailable or not found — recoverable via fallback routing.	lexigram-ai-llm
LEX_ERR_LLM_006	LLMModelNotFoundError	Model unavailable or not found — recoverable via fallback routing. Returned a…	lexigram-ai-llm
LEX_ERR_LLM_007	LLMRateLimitError	Rate limit exceeded — recoverable via backoff/retry. Returned as Err from…	lexigram-ai-llm
LEX_ERR_LLM_008	LLMQuotaExceededError	API quota or billing limit exceeded — recoverable by routing elsewhere. Retur…	lexigram-ai-llm
LEX_ERR_LLM_009	LLMContentFilterError	Content blocked by provider safety filter — recoverable via reformulation. Re…	lexigram-ai-llm
LEX_ERR_LLM_010	TokenLimitError	Error raised when the token limit for a request is exceeded.	lexigram-ai-llm
LEX_ERR_LLM_011	ProviderConnectionError	Error raised when connection to an LLM provider fails.	lexigram-ai-llm
LEX_ERR_LLM_012	StreamError	Error raised during LLM response streaming.	lexigram-ai-llm
LEX_ERR_LLM_013	ExtractionError	Base class for structured extraction errors in lexigram-ai-llm.	lexigram-ai-llm
LEX_ERR_LLM_014	ExtractionParseError	Error raised when extraction response cannot be parsed as JSON.	lexigram-ai-llm
LEX_ERR_LLM_015	ExtractionValidationError	Error raised when parsed extraction response fails schema validation.	lexigram-ai-llm
LEX_ERR_LLM_016	ExtractionMaxRetriesError	Error raised when extraction max retries are exhausted.	lexigram-ai-llm
LEX_ERR_LLM_017	StructuredOutputError	Base exception for structured output errors.	lexigram-ai-llm
LEX_ERR_LLM_018	ParseError	Raised when response cannot be parsed.	lexigram-ai-llm
LEX_ERR_LLM_019	SchemaValidationError	Raised when parsed response fails validation.	lexigram-ai-llm
LEX_ERR_LLM_020	ModelManagerError	Base exception for model manager errors.	lexigram-ai-llm
LEX_ERR_LLM_021	ModelNotFoundError	Raised when a requested model is not found.	lexigram-ai-llm
LEX_ERR_LLM_022	ModelLoadError	Raised when a model fails to load.	lexigram-ai-llm
LEX_ERR_LLM_023	ModelUnloadError	Raised when a model fails to unload.	lexigram-ai-llm
LEX_ERR_LLM_024	ProviderConnectionError	Raised when connection to provider fails.	lexigram-ai-llm
LEX_ERR_LLM_025	OrchestratorError	Base orchestration error.	lexigram-ai-llm
LEX_ERR_LLM_026	NoSuitableModelError	No model found that meets the requirements.	lexigram-ai-llm

LOAD (1 codes)

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

LOCK (2 codes)

Code	Class	Description	Package
LEX_ERR_LOCK_001	LockAcquisitionError	Raised when acquiring a lock fails.	lexigram-contracts
LEX_ERR_LOCK_002	LockNotHeldError	Raised when trying to operate on a lock that is not held.	lexigram-contracts

MAP (4 codes)

Code	Class	Description	Package
LEX_ERR_MAP_001	MappingError	Object mapping error.	lexigram-contracts
LEX_ERR_MAP_002	MappingError	Base exception for all object-mapping errors.	lexigram
LEX_ERR_MAP_003	MappingNotFoundError	Raised when no mapper is registered for a (source, destination) type pair.	lexigram
LEX_ERR_MAP_004	MappingExecutionError	Raised when a registered mapper raises an unexpected error during execution.	lexigram

MCP (8 codes)

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

MEM (8 codes)

Code	Class	Description	Package
LEX_ERR_MEM_001	AIMemoryError	Base for AI memory system errors. Extended in lexigram-ai-memory with specifi…	lexigram-contracts
LEX_ERR_MEM_002	ConsolidationError	Error raised during memory consolidation.	lexigram-contracts
LEX_ERR_MEM_003	StorageError	Error raised during memory storage operations.	lexigram-contracts
LEX_ERR_MEM_005	MemorySystemError	Base exception for memory operations.	lexigram-ai-memory
LEX_ERR_MEM_006	MemoryStoreError	Raised when a backend store operation fails.	lexigram-ai-memory
LEX_ERR_MEM_008	MemoryCapacityError	Raised when a memory store is at capacity and cannot accept new entries.	lexigram-ai-memory
LEX_ERR_MEM_009	EmbeddingError	Raised when generating or storing an embedding fails.	lexigram-ai-memory
LEX_ERR_MEM_010	FactExtractionError	Raised when entity/fact extraction from text fails.	lexigram-ai-memory

MOD (7 codes)

Code	Class	Description	Package
LEX_ERR_MOD_001	ModuleError	Module configuration or lifecycle error.	lexigram-contracts
LEX_ERR_MOD_002	ModuleImportError	A module imports a module that does not exist in the graph. Raised during mod…	lexigram-contracts
LEX_ERR_MOD_003	ModuleExportError	A module exports a type not provided by its providers. Raised during post-reg…	lexigram-contracts
LEX_ERR_MOD_004	ModuleCycleError	Circular dependency detected in the module import graph. Raised during module…	lexigram-contracts
LEX_ERR_MOD_005	ModuleVisibilityError	A provider depends on a service not visible to its module. Raised when a prov…	lexigram-contracts
LEX_ERR_MOD_006	ModuleDuplicateError	The same module appears twice with conflicting configurations. Raised when tw…	lexigram-contracts
LEX_ERR_MOD_007	ModuleError	Module system error (registration, visibility, exports). Raised by: - Module …	lexigram

MONITOR (8 codes)

Code	Class	Description	Package
LEX_ERR_MONITOR_001	MonitorError	Base exception for monitoring errors.	lexigram-monitor
LEX_ERR_MONITOR_002	BackendNotAvailableError	Raised when a required monitoring backend is not available.	lexigram-monitor
LEX_ERR_MONITOR_003	MetricNotFoundError	Raised when a requested metric is not found.	lexigram-monitor
LEX_ERR_MONITOR_004	InvalidMetricError	Raised when metric parameters are invalid.	lexigram-monitor
LEX_ERR_MONITOR_005	SpanError	Base exception for span-related errors.	lexigram-monitor
LEX_ERR_MONITOR_006	SpanNotFoundError	Raised when a requested span is not found.	lexigram-monitor
LEX_ERR_MONITOR_007	MonitorConfigurationError	Raised when monitoring configuration is invalid.	lexigram-monitor
LEX_ERR_MONITOR_008	PerformanceMonitorError	Base exception for performance monitoring errors.	lexigram-monitor

MW (10 codes)

Code	Class	Description	Package
LEX_ERR_MW_001	MiddlewareGuardError	Raised when a middleware guard denies access.	lexigram-contracts
LEX_ERR_MW_002	MiddlewareError	Base exception for infrastructure-level middleware errors.	lexigram
LEX_ERR_MW_003	MiddlewarePolicyError	Base exception for policy-level middleware rejections. Raised when middleware…	lexigram
LEX_ERR_MW_004	MiddlewareExecutionError	Raised when a middleware raises an unexpected error during execution.	lexigram
LEX_ERR_MW_005	MiddlewareConfigurationError	Raised when middleware is configured incorrectly.	lexigram
LEX_ERR_MW_006	MiddlewareChainError	Raised when the middleware chain cannot be assembled or traversed.	lexigram
LEX_ERR_MW_007	MiddlewareTimeoutError	Raised when a middleware exceeds its configured timeout.	lexigram
LEX_ERR_MW_008	MiddlewareAuthError	Raised when middleware-level authentication/authorization fails.	lexigram
LEX_ERR_MW_009	MiddlewareRateLimitError	Raised when middleware-level rate limiting is exceeded.	lexigram
LEX_ERR_MW_010	MiddlewareCircuitOpenError	Raised when the circuit breaker in middleware is open.	lexigram

NOSQL (6 codes)

Code	Class	Description	Package
LEX_ERR_NOSQL_001	NoSQLError	Base exception for all NoSQL operations.	lexigram-nosql
LEX_ERR_NOSQL_002	NoSQLConnectionError	Failed to connect to the document store.	lexigram-nosql
LEX_ERR_NOSQL_003	DocumentNotFoundError	Requested document does not exist.	lexigram-nosql
LEX_ERR_NOSQL_004	DuplicateKeyError	Insert/update violated a unique constraint.	lexigram-nosql
LEX_ERR_NOSQL_005	DocumentValidationError	Document failed schema validation.	lexigram-nosql
LEX_ERR_NOSQL_006	TransactionError	Multi-document transaction failed.	lexigram-nosql

NOTIF (14 codes)

Code	Class	Description	Package
LEX_ERR_NOTIF_001	NotificationError	Base for expected, recoverable notification delivery failures. Attributes: ch…	lexigram-contracts
LEX_ERR_NOTIF_002	MailerError	Base mailer/email notification error.	lexigram-contracts
LEX_ERR_NOTIF_003	TwilioNotificationError	Twilio SMS delivery failure.	lexigram-notification
LEX_ERR_NOTIF_004	FCMNotificationError	FCM push notification delivery failure.	lexigram-notification
LEX_ERR_NOTIF_005	APNsNotificationError	APNs push notification delivery failure.	lexigram-notification
LEX_ERR_NOTIF_006	SMTPMailerError	SMTP-specific delivery failure (rejection, auth error, etc.).	lexigram-notification
LEX_ERR_NOTIF_007	SendGridMailerError	SendGrid API delivery failure.	lexigram-notification
LEX_ERR_NOTIF_008	InboxError	Base exception for all inbox submodule errors.	lexigram-notification
LEX_ERR_NOTIF_009	InboxMessageNotFoundError	Raised when a requested inbox message does not exist.	lexigram-notification
LEX_ERR_NOTIF_010	InboxPermissionError	Raised when a user attempts to access another user’s inbox messages.	lexigram-notification
LEX_ERR_NOTIF_011	WebPushNotificationError	Web Push notification delivery failure.	lexigram-notification
LEX_ERR_NOTIF_012	WhatsAppNotificationError	WhatsApp delivery failure via Twilio provider.	lexigram-notification
LEX_ERR_NOTIF_013	WhatsAppMetaNotificationError	WhatsApp delivery failure via Meta provider.	lexigram-notification
LEX_ERR_NOTIF_014	SlackNotificationError	Slack notification delivery failure.	lexigram-notification

OBS (4 codes)

Code	Class	Description	Package
LEX_ERR_OBS_001	ObservabilityError	Base exception for all observability-related errors.	lexigram-ai-observability
LEX_ERR_OBS_002	HealthCheckError	Raised when a health check infrastructure operation fails.	lexigram-ai-observability
LEX_ERR_OBS_003	MetricsError	Raised when a metrics recording or retrieval operation fails.	lexigram-ai-observability
LEX_ERR_OBS_004	TracingError	Raised when a tracing operation fails.	lexigram-ai-observability

PIPE (2 codes)

Code	Class	Description	Package
LEX_ERR_PIPE_001	PipelineExecutionError	Error raised during pipeline execution.	lexigram-contracts
LEX_ERR_PIPE_002	PipelineStepError	Error raised by a pipeline step.	lexigram-contracts

PROV (1 codes)

Code	Class	Description	Package
LEX_ERR_PROV_001	ProviderError	Provider configuration or lifecycle error.	lexigram-contracts

QE (1 codes)

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

QUEUE (7 codes)

Code	Class	Description	Package
LEX_ERR_QUEUE_001	QueueError	Base for expected, recoverable queue / bus failures. Attributes: backend: Nam…	lexigram-contracts
LEX_ERR_QUEUE_002	RedisQueueError	Redis queue failure.	lexigram-queue
LEX_ERR_QUEUE_003	RabbitMQQueueError	RabbitMQ queue failure.	lexigram-queue
LEX_ERR_QUEUE_004	KafkaQueueError	Kafka queue failure.	lexigram-queue
LEX_ERR_QUEUE_005	SQSQueueError	SQS queue failure.	lexigram-queue
LEX_ERR_QUEUE_006	AzureServiceBusQueueError	Azure Service Bus queue failure.	lexigram-queue
LEX_ERR_QUEUE_007	GCPPubSubQueueError	GCP Pub/Sub queue failure.	lexigram-queue

RAG (14 codes)

Code	Class	Description	Package
LEX_ERR_RAG_001	RAGError	Base for RAG pipeline errors. Extended in lexigram-ai-rag with specific failu…	lexigram-contracts
LEX_ERR_RAG_002	RetrievalError	Error raised during document retrieval.	lexigram-contracts
LEX_ERR_RAG_003	SynthesisError	Error raised during response synthesis.	lexigram-contracts
LEX_ERR_RAG_004	ChunkingError	Error raised during document chunking.	lexigram-contracts
LEX_ERR_RAG_005	RAGError	Base exception for RAG errors.	lexigram-ai-rag
LEX_ERR_RAG_006	PreprocessingError	Raised when document preprocessing fails.	lexigram-ai-rag
LEX_ERR_RAG_010	MultimodalError	Base exception for multimodal processing errors.	lexigram-ai-rag
LEX_ERR_RAG_011	AudioLoaderError	Raised when audio loading fails.	lexigram-ai-rag
LEX_ERR_RAG_012	VideoLoaderError	Raised when video loading fails.	lexigram-ai-rag
LEX_ERR_RAG_013	ImageLoaderError	Raised when image loading fails.	lexigram-ai-rag
LEX_ERR_RAG_014	CLIPEmbeddingError	Raised when CLIP embedding computation fails.	lexigram-ai-rag
LEX_ERR_RAG_015	MissingCitationsError	Raised when a pipeline with require_citations=True produces no citations.	lexigram-ai-rag
LEX_ERR_RAG_016	UnsupportedFormatError	Raised when no loader is registered for the given file format or URL.	lexigram-ai-rag
LEX_ERR_RAG_017	MissingOptionalDependencyError	—	lexigram-ai-rag

REG (3 codes)

Code	Class	Description	Package
LEX_ERR_REG_001	RegistryError	Base exception for registry errors.	lexigram-contracts
LEX_ERR_REG_002	RegistryKeyError	Raised when a key is not found in a registry.	lexigram-contracts
LEX_ERR_REG_003	RegistryAlreadyExistsError	Raised when attempting to register a duplicate key in a registry.	lexigram-contracts

RES (11 codes)

Code	Class	Description	Package
LEX_ERR_RES_001	ResilienceError	Base resilience error.	lexigram-contracts
LEX_ERR_RES_002	RetryError	Retry operation error.	lexigram-contracts
LEX_ERR_RES_003	CircuitBreakerError	Circuit breaker error.	lexigram-contracts
LEX_ERR_RES_004	BulkheadError	Bulkhead/rejection error.	lexigram-contracts
LEX_ERR_RES_005	FallbackError	Fallback execution error.	lexigram-contracts
LEX_ERR_RES_006	RetryExhaustedError	All retry attempts have been exhausted.	lexigram-contracts
LEX_ERR_RES_007	CircuitOpenError	Circuit breaker is open and rejecting requests.	lexigram-contracts
LEX_ERR_RES_008	RetryExhaustedError	All retry attempts exhausted.	lexigram-resilience
LEX_ERR_RES_009	CircuitOpenError	Circuit breaker is open.	lexigram-resilience
LEX_ERR_RES_010	BulkheadRejectedError	Bulkhead rejected due to capacity limits.	lexigram-resilience
LEX_ERR_RES_011	ResilienceTimeoutError	Resilience operation timed out. Inherits from both ResilienceError and built-…	lexigram-resilience

RESULT (1 codes)

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

RET (1 codes)

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

RUN (1 codes)

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

SEARCH (10 codes)

Code	Class	Description	Package
LEX_ERR_SEARCH_001	SearchError	Base exception for search operations.	lexigram-search
LEX_ERR_SEARCH_002	IndexNotFoundError	Raised when index is not found.	lexigram-search
LEX_ERR_SEARCH_003	BackendError	Raised when search backend encounters an error.	lexigram-search
LEX_ERR_SEARCH_004	SearchValidationError	Raised when search query validation fails.	lexigram-search
LEX_ERR_SEARCH_005	TransformationError	Raised when document transformation fails.	lexigram-search
LEX_ERR_SEARCH_006	CacheError	Raised when search cache operation fails.	lexigram-search
LEX_ERR_SEARCH_007	QueryError	Raised when search query execution fails.	lexigram-search
LEX_ERR_SEARCH_008	ConfigurationError	Raised when search configuration is invalid.	lexigram-search
LEX_ERR_SEARCH_009	SearchIndexError	Raised when search index operation fails.	lexigram-search
LEX_ERR_SEARCH_010	SchedulerError	Raised when search scheduler operation fails.	lexigram-search

SEC (12 codes)

Code	Class	Description	Package
LEX_ERR_SEC_001	SecurityError	Base security error for the Lexigram security subsystem.	lexigram-contracts
LEX_ERR_SEC_002	GuardDeniedError	Raised when a GuardChain denies the request. Attributes: guard: The name or t…	lexigram-contracts
LEX_ERR_SEC_003	InputSanitizationError	Raised when sanitization fails due to unrecoverable input structure.	lexigram-contracts
LEX_ERR_SEC_004	CORSViolationError	Raised when a request violates the configured CORS policy. Attributes: origin…	lexigram-contracts
LEX_ERR_SEC_005	SecretAccessError	Raised when the caller lacks permission to access or modify a secret. Attribu…	lexigram-contracts
LEX_ERR_SEC_006	SecurityError	Base exception for all security-module errors.	lexigram
LEX_ERR_SEC_007	SecretNotFoundError	Raised when a requested secret does not exist.	lexigram
LEX_ERR_SEC_008	SecretAccessError	Raised when access to a secret is denied.	lexigram
LEX_ERR_SEC_009	EncryptionError	Raised when field-level encryption fails.	lexigram
LEX_ERR_SEC_010	DecryptionError	Raised when field-level decryption fails.	lexigram
LEX_ERR_SEC_011	SecretError	Base exception for secret store errors.	lexigram
LEX_ERR_SEC_012	RateLimitExceededError	Raised when a client has exceeded the configured rate limit. Carries “retry_…	lexigram-auth

SERIAL (4 codes)

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

SES (12 codes)

Code	Class	Description	Package
LEX_ERR_SES_001	SessionError	Base class for session-related errors.	lexigram-contracts
LEX_ERR_SES_002	TaskCancelledError	Error raised when a task is cancelled.	lexigram-contracts
LEX_ERR_SES_003	TaskError	Base class for task execution errors.	lexigram-contracts
LEX_ERR_SES_004	TaskTimeoutError	Error raised when a task times out.	lexigram-contracts
LEX_ERR_SES_005	TaskValidationError	Error raised when task input validation fails.	lexigram-contracts
LEX_ERR_SES_006	SessionError	Base error for all session operations. All session-specific exceptions inheri…	lexigram-ai-session
LEX_ERR_SES_007	SessionNotFoundError	Raised when a session cannot be found by its ID. Args: session_id: The ID of …	lexigram-ai-session
LEX_ERR_SES_008	SessionClosedError	Raised when an operation is attempted on a closed session. Args: session_id: …	lexigram-ai-session
LEX_ERR_SES_009	SessionExpiredError	Raised when an operation is attempted on an expired session. Args: session_id…	lexigram-ai-session
LEX_ERR_SES_010	CheckpointNotFoundError	Raised when a checkpoint cannot be found by its ID. Args: checkpoint_id: The …	lexigram-ai-session
LEX_ERR_SES_011	SessionTransitionError	Raised when an invalid state transition is attempted. Args: session_id: The s…	lexigram-ai-session
LEX_ERR_SES_012	SessionCapacityError	Raised when a session limit is exceeded. Args: detail: Human-readable descrip…	lexigram-ai-session

SKILL (8 codes)

Code	Class	Description	Package
LEX_ERR_SKILL_001	SkillError	Base for skill execution errors. Extended in lexigram-ai-skills with specific…	lexigram-contracts
LEX_ERR_SKILL_002	SkillNotFoundError	Raised when a requested skill is not registered.	lexigram-ai-skills
LEX_ERR_SKILL_003	SkillAlreadyRegisteredError	Raised when a skill is registered under a name that already exists.	lexigram-ai-skills
LEX_ERR_SKILL_004	SkillValidationError	Raised when skill parameter validation fails.	lexigram-ai-skills
LEX_ERR_SKILL_005	SkillPermissionDeniedError	Raised when the caller lacks required permissions for a skill.	lexigram-ai-skills
LEX_ERR_SKILL_006	SkillTimeoutError	Raised when skill execution exceeds the configured timeout.	lexigram-ai-skills
LEX_ERR_SKILL_007	SkillRoutingError	Raised when a SkillRouter finds no matching route.	lexigram-ai-skills
LEX_ERR_SKILL_008	SkillExecutionError	Raised when a skill execution fails after all retry attempts.	lexigram-ai-skills

SQL (37 codes)

Code	Class	Description	Package
LEX_ERR_SQL_001	DatabaseConnectionError	Base for all connection-related failures. Attributes: host: The database host…	lexigram-sql
LEX_ERR_SQL_002	ConnectionRefusedError	Server actively refused the connection.	lexigram-sql
LEX_ERR_SQL_003	ConnectionTimeoutError	Connection attempt timed out.	lexigram-sql
LEX_ERR_SQL_004	ConnectionPoolError	Connection pool exhausted — no connections available within timeout.	lexigram-sql
LEX_ERR_SQL_005	QueryError	Base for query execution failures. Attributes: sql: The SQL query that failed…	lexigram-sql
LEX_ERR_SQL_006	QuerySyntaxError	The SQL query has a syntax error.	lexigram-sql
LEX_ERR_SQL_007	ParameterBindingError	Failed to bind parameters to a query.	lexigram-sql
LEX_ERR_SQL_008	IntegrityError	Base for constraint violation errors. Attributes: constraint: The constraint …	lexigram-sql
LEX_ERR_SQL_009	DuplicateKeyError	Unique constraint or primary key violated.	lexigram-sql
LEX_ERR_SQL_010	ForeignKeyError	Foreign key constraint violated.	lexigram-sql
LEX_ERR_SQL_011	NotNullViolationError	NOT NULL constraint violated. Attributes: column: The column that triggered t…	lexigram-sql
LEX_ERR_SQL_012	CheckConstraintError	CHECK constraint violated.	lexigram-sql
LEX_ERR_SQL_013	TransactionError	Base for transaction-related failures.	lexigram-sql
LEX_ERR_SQL_014	SerializationError	Serialization failure (optimistic concurrency conflict).	lexigram-sql
LEX_ERR_SQL_015	OptimisticLockError	Raised when an optimistic lock check fails on UPDATE. Indicates a concurrent …	lexigram-sql
LEX_ERR_SQL_016	TransactionRollbackError	Transaction was rolled back (not by the application).	lexigram-sql
LEX_ERR_SQL_017	LockError	Raised when a database lock cannot be acquired.	lexigram-sql
LEX_ERR_SQL_018	DeadlockError	Database deadlock detected. Inherits from :class:TransactionError because d…	lexigram-sql
LEX_ERR_SQL_019	SchemaError	Base for schema-related errors.	lexigram-sql
LEX_ERR_SQL_020	TableNotFoundError	Referenced table does not exist.	lexigram-sql
LEX_ERR_SQL_021	ColumnNotFoundError	Referenced column does not exist.	lexigram-sql
LEX_ERR_SQL_022	DatabaseTimeoutError	Database operation timed out.	lexigram-sql
LEX_ERR_SQL_023	RepositoryError	RepositoryProtocol-level operation failure.	lexigram-sql
LEX_ERR_SQL_024	UnitOfWorkError	Raised when unit of work operation fails.	lexigram-sql
LEX_ERR_SQL_025	DriverError	Wraps underlying database driver exceptions. Preserves the original exception…	lexigram-sql
LEX_ERR_SQL_026	DataError	Base exception for data access layer failures.	lexigram-sql
LEX_ERR_SQL_027	DataQueryError	Raised when a query cannot be built or compiled. Args: message: Explanation o…	lexigram-sql
LEX_ERR_SQL_028	PaginationError	Raised when pagination parameters are invalid. Args: message: Explanation of …	lexigram-sql
LEX_ERR_SQL_029	EntityNotFoundError	Signals that a required entity does not exist. RepositoryProtocol implementat…	lexigram-sql
LEX_ERR_SQL_030	DataRepositoryError	Raised when a repository operation fails unexpectedly. Args: message: Explana…	lexigram-sql
LEX_ERR_SQL_031	CursorError	Raised when a cursor cannot be encoded or decoded. Args: message: Explanation…	lexigram-sql
LEX_ERR_SQL_032	MigrationDependencyError	Raised when migration dependencies are not satisfied.	lexigram-sql
LEX_ERR_SQL_033	MigrationExecutionError	Raised when migration execution fails.	lexigram-sql
LEX_ERR_SQL_034	MigrationNotFoundError	Raised when a migration is not found.	lexigram-sql
LEX_ERR_SQL_035	MigrationValidationError	Raised when migration validation fails.	lexigram-sql
LEX_ERR_SQL_036	ProtocolValidationError	Raised when object doesn’t implement protocol.	lexigram-sql
LEX_ERR_SQL_037	MappingError	Exception raised when entity mapping fails.	lexigram-sql

STORE (8 codes)

Code	Class	Description	Package
LEX_ERR_STORE_001	StorageError	Base exception for storage errors.	lexigram-storage
LEX_ERR_STORE_002	StorageFileNotFoundError	Raised when file is not found.	lexigram-storage
LEX_ERR_STORE_003	StorageUnsupportedOperationError	Raised when the requested operation is not supported by the storage driver.	lexigram-storage
LEX_ERR_STORE_004	TransactionError	Raised when a transaction operation fails.	lexigram-storage
LEX_ERR_STORE_005	QuotaExceededError	Raised when a storage quota or size limit is exceeded.	lexigram-storage
LEX_ERR_STORE_006	InvalidPathError	Raised when a path is invalid or attempts directory traversal.	lexigram-storage
LEX_ERR_STORE_007	StorageUnavailableError	Raised when the storage backend is not reachable or unavailable.	lexigram-storage
LEX_ERR_STORE_008	ChecksumMismatchError	Raised when a file’s checksum does not match the expected value.	lexigram-storage

TASK (11 codes)

Code	Class	Description	Package
LEX_ERR_TASK_001	TaskQueueError	Base class for expected, recoverable task queue failures. All subtypes indica…	lexigram-contracts
LEX_ERR_TASK_002	QueueFullError	The queue has reached its maximum capacity and cannot accept new tasks. The c…	lexigram-tasks
LEX_ERR_TASK_003	TaskError	Base exception for all task-related errors	lexigram-tasks
LEX_ERR_TASK_004	TaskNotFoundError	Raised when a task cannot be found	lexigram-tasks
LEX_ERR_TASK_005	TaskTimeoutError	Raised when a task execution exceeds timeout	lexigram-tasks
LEX_ERR_TASK_006	TaskCancelledError	Raised when a task is cancelled	lexigram-tasks
LEX_ERR_TASK_007	TaskExecutionError	Raised when a task execution fails	lexigram-tasks
LEX_ERR_TASK_008	TaskValidationError	Raised when task parameters are invalid	lexigram-tasks
LEX_ERR_TASK_009	DuplicateTaskError	Raised when a duplicate task is detected	lexigram-tasks
LEX_ERR_TASK_010	TaskDependencyCycleError	Raised at registration time when a dependency cycle is detected. The schedule…	lexigram-tasks
LEX_ERR_TASK_011	TaskRegistrationError	Raised when a scheduled or handler task fails to register.	lexigram-tasks

TENANT (8 codes)

Code	Class	Description	Package
LEX_ERR_TENANT_001	TenantError	Base class for all tenancy-related domain errors.	lexigram-contracts
LEX_ERR_TENANT_002	TenantNotFoundError	Raised when a requested tenant does not exist.	lexigram-contracts
LEX_ERR_TENANT_003	TenantInactiveError	Raised when an operation is attempted on an inactive tenant.	lexigram-contracts
LEX_ERR_TENANT_004	TenantProvisioningError	Raised when tenant provisioning (isolation setup) fails.	lexigram-contracts
LEX_ERR_TENANT_005	TenantResolutionError	Raised when tenant resolution fails unexpectedly.	lexigram-contracts
LEX_ERR_TENANT_006	TenantConfigError	Raised when per-tenant configuration access or mutation fails.	lexigram-contracts
LEX_ERR_TENANT_007	TenantSlugConflictError	Raised when a tenant slug is already in use.	lexigram-contracts
LEX_ERR_TENANT_008	TenantSuspendedError	Raised when an operation is attempted on a suspended tenant.	lexigram-contracts

TEST (12 codes)

Code	Class	Description	Package
LEX_ERR_TEST_001	TestingError	Base exception for lexigram-testing operations.	lexigram-testing
LEX_ERR_TEST_002	TokenBudgetExceededError	Raised when an AITestClient operation would exceed the configured token budge…	lexigram-testing
LEX_ERR_TEST_003	MemoryBackendError	Base exception for all memory backend errors.	lexigram-testing
LEX_ERR_TEST_004	CommandBusError	Raised when a command bus operation fails.	lexigram-testing
LEX_ERR_TEST_005	CommandHandlerNotFoundError	Raised when no handler is registered for a specific command type.	lexigram-testing
LEX_ERR_TEST_006	DuplicateHandlerError	Raised when a handler is already registered for a command type.	lexigram-testing
LEX_ERR_TEST_007	CommandError	Wraps a handler exception for Result-based command dispatch.	lexigram-testing
LEX_ERR_TEST_008	QueryBusError	Raised when a query bus operation fails.	lexigram-testing
LEX_ERR_TEST_009	QueryHandlerNotFoundError	Raised when no handler is registered for a specific query type.	lexigram-testing
LEX_ERR_TEST_010	QueryDuplicateHandlerError	Raised when a handler is already registered for a query type.	lexigram-testing
LEX_ERR_TEST_011	ConfigurationError	Raised when a require_stub module is loaded via configure() in test mode. Thi…	lexigram-testing
LEX_ERR_TEST_012	SnapshotMismatchError	Raised when a value does not match the stored snapshot.	lexigram-testing

UI (1 codes)

Code	Class	Description	Package
LEX_ERR_UI_001	UIError	Base exception for all UI-domain errors.	lexigram-ui

VAL (4 codes)

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

VEC (15 codes)

Code	Class	Description	Package
LEX_ERR_VEC_001	VectorError	Base exception for vector store errors. Extends InfrastructureError because v…	lexigram-contracts
LEX_ERR_VEC_002	VectorStoreError	Exception raised during vector store operations (CRUD, search).	lexigram-contracts
LEX_ERR_VEC_003	EmbeddingError	Exception raised during embedding generation or retrieval.	lexigram-contracts
LEX_ERR_VEC_004	VectorIndexError	Exception raised during vector index creation or management.	lexigram-contracts
LEX_ERR_VEC_005	VectorError	Base exception for all vector store operations.	lexigram-vector
LEX_ERR_VEC_006	VectorConnectionError	Failed to connect to the vector store.	lexigram-vector
LEX_ERR_VEC_007	CollectionNotFoundError	Requested collection does not exist.	lexigram-vector
LEX_ERR_VEC_008	CollectionAlreadyExistsError	Attempted to create a collection that already exists.	lexigram-vector
LEX_ERR_VEC_009	DimensionMismatchError	Vector dimensionality does not match the collection.	lexigram-vector
LEX_ERR_VEC_010	VectorConfigError	Invalid vector store configuration.	lexigram-vector
LEX_ERR_VEC_011	FilterCompilationError	Failed to compile a metadata filter for the target backend.	lexigram-vector
LEX_ERR_VEC_012	VectorUpsertError	Failed to upsert vectors.	lexigram-vector
LEX_ERR_VEC_013	VectorSearchError	Failed to execute similarity search.	lexigram-vector
LEX_ERR_VEC_014	VectorDeleteError	Failed to delete vectors.	lexigram-vector
LEX_ERR_VEC_015	VectorTimeoutError	Vector store operation timed out.	lexigram-vector

WEB (14 codes)

Code	Class	Description	Package
LEX_ERR_WEB_001	WebError	Web layer error.	lexigram-contracts
LEX_ERR_WEB_002	HttpStatusError	Raised by :meth:HttpResponse.raise_for_status for 4xx/5xx responses. Attrib…	lexigram-contracts
LEX_ERR_WEB_003	NotFoundError	404 Not Found.	lexigram-web
LEX_ERR_WEB_004	BadRequestError	400 Bad Request.	lexigram-web
LEX_ERR_WEB_005	UnauthorizedError	401 Unauthorized.	lexigram-web
LEX_ERR_WEB_006	ForbiddenError	403 Forbidden.	lexigram-web
LEX_ERR_WEB_007	MethodNotAllowedError	405 Method Not Allowed.	lexigram-web
LEX_ERR_WEB_008	ConflictError	409 Conflict.	lexigram-web
LEX_ERR_WEB_009	UnprocessableEntityError	422 Unprocessable Entity.	lexigram-web
LEX_ERR_WEB_010	InternalServerError	500 Internal Server Error.	lexigram-web
LEX_ERR_WEB_011	DependencyResolutionError	500 Dependency Resolution Error.	lexigram-web
LEX_ERR_WEB_012	RateLimitError	429 Too Many Requests.	lexigram-web
LEX_ERR_WEB_013	TooManyConnectionsError	503 Service Unavailable — connection limit reached. Raised when a streaming e…	lexigram-web
LEX_ERR_WEB_014	HTTPError	Base HTTP error, compatible with LexigramError.	lexigram-web

WEBHOOK (6 codes)

Code	Class	Description	Package
LEX_ERR_WEBHOOK_001	WebhookError	Base exception for webhook domain operations.	lexigram-contracts
LEX_ERR_WEBHOOK_002	SubscriptionNotFoundError	Raised when a subscription ID is not found.	lexigram-webhook
LEX_ERR_WEBHOOK_003	SubscriptionInactiveError	Raised when attempting to deliver to a deactivated subscription.	lexigram-webhook
LEX_ERR_WEBHOOK_004	InvalidWebhookURLError	Raised when a subscription URL fails validation.	lexigram-webhook
LEX_ERR_WEBHOOK_005	DeliveryAttemptNotFoundError	Raised when a delivery attempt ID is not found.	lexigram-webhook
LEX_ERR_WEBHOOK_006	SecretRotationError	Raised when secret rotation fails.	lexigram-webhook

WF (22 codes)

Code	Class	Description	Package
LEX_ERR_WF_001	WorkflowError	Base for workflow execution errors. Raised when a workflow graph execution fa…	lexigram-contracts
LEX_ERR_WF_002	SagaStepError	Represents a recoverable failure from a single saga step action. SagaProtocol…	lexigram-contracts
LEX_ERR_WF_003	WorkflowError	Base exception for workflow orchestration errors.	lexigram-workflow
LEX_ERR_WF_004	WorkflowNotFoundError	Raised when a workflow definition cannot be found.	lexigram-workflow
LEX_ERR_WF_005	WorkflowStateError	Raised when a workflow is in an invalid state for the requested operation.	lexigram-workflow
LEX_ERR_WF_006	WorkflowStepError	Raised when a workflow step fails to execute.	lexigram-workflow
LEX_ERR_WF_007	WorkflowTimeoutError	Raised when a workflow or step exceeds its timeout.	lexigram-workflow
LEX_ERR_WF_008	WorkflowCompensationError	Raised when workflow compensation/rollback fails.	lexigram-workflow
LEX_ERR_WF_009	SagaVersionMismatchError	Raised when a persisted saga state version is incompatible with the current c…	lexigram-workflow
LEX_ERR_WF_010	WorkflowVersionMismatchError	Raised when resuming a workflow instance with a mismatched definition version…	lexigram-workflow
LEX_ERR_WF_011	GraphExecutionError	Base exception for graph workflow engine operations. Args: message: Human-rea…	lexigram-workflow
LEX_ERR_WF_012	NodeExecutionError	A graph node’s execute() method failed. Args: message: Human-readable error d…	lexigram-workflow
LEX_ERR_WF_013	CycleDetectedError	Graph engine exceeded max_iterations (likely cycle). Args: iterations: Number…	lexigram-workflow
LEX_ERR_WF_014	GraphTimeoutError	Graph workflow execution exceeded total timeout. Args: timeout: The configure…	lexigram-workflow
LEX_ERR_WF_015	GraphValidationError	Graph structure validation failed.	lexigram-workflow
LEX_ERR_WF_016	HumanInputRequiredError	Raised by HumanNode to pause execution awaiting human input. Args: prompt: Te…	lexigram-workflow
LEX_ERR_WF_017	StateError	Raised when an invalid state transition is attempted. Attributes: event: The …	lexigram-workflow
LEX_ERR_WF_018	StateConcurrencyError	Raised when optimistic version checks fail during a transition.	lexigram-workflow
LEX_ERR_WF_019	SagaError	Raised when a saga step fails after compensation has been attempted. Attribut…	lexigram-workflow
LEX_ERR_WF_020	BulkOperationError	Base exception for bulk operation errors.	lexigram-workflow
LEX_ERR_WF_021	BulkOperationTimeoutError	Raised when a bulk operation times out.	lexigram-workflow
LEX_ERR_WF_022	BulkOperationCancelledError	Raised when a bulk operation is cancelled.	lexigram-workflow