Skip to content
QuadKit Python Framework

Error Codes

Date: 2026-11-01 Total registered codes: 440 Total domains: 58 Total packages contributing codes: 17

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

1. Domain Summary

Section titled “1. Domain Summary”
Domain TagCountGapsPackage(s)
ADMIN1—quadkit-contracts
AGT13—quadkit-ai-agents, quadkit-contracts
AI6005quadkit-contracts
APP3—quadkit
AUTH28—quadkit-auth, quadkit-contracts
CACHE15—quadkit-cache, quadkit-contracts
CFG6—quadkit, quadkit-contracts
CLI3—quadkit-cli
CODEGEN1—quadkit-contracts
CONC8—quadkit
CORE5003, 004quadkit, quadkit-contracts
DB11—quadkit-contracts
DI11—quadkit, quadkit-contracts
DOM9—quadkit, quadkit-contracts
EVAL1—quadkit-contracts
EVT23—quadkit-contracts, quadkit-events
FEAT1—quadkit-contracts
GOV4004, 005, 006, 007, 008, 009quadkit-contracts
GUARD3—quadkit-contracts
HTTP8—quadkit-http
IDEM4—quadkit-contracts
IDX1—quadkit-contracts
INFRA12—quadkit, quadkit-contracts
LLM29—quadkit-ai-llm, quadkit-contracts
LOAD1—quadkit-contracts
LOCK3—quadkit-contracts
MAP4—quadkit, quadkit-contracts
MCP8—quadkit-contracts
MEM3—quadkit-contracts
MM8—quadkit-contracts
MOD6—quadkit-contracts
MONITOR8—quadkit-monitor
MW10—quadkit, quadkit-contracts
NOTIF15—quadkit-contracts, quadkit-notification
PIPE2—quadkit-contracts
PROV1—quadkit-contracts
QE1—quadkit-contracts
QUEUE1—quadkit-contracts
RAG4—quadkit-contracts
REG3—quadkit-contracts
RES7—quadkit-contracts
RESULT1001quadkit-contracts
RET1—quadkit-contracts
RUN1—quadkit-contracts
SEC11007quadkit, quadkit-auth, quadkit-contracts
SERIAL4—quadkit, quadkit-contracts
SES5—quadkit-contracts
SKILL1—quadkit-contracts
SQL38—quadkit-sql
STORE8—quadkit-contracts, quadkit-storage
TASK13—quadkit-contracts, quadkit-tasks
TENANT9—quadkit-contracts
TEST12—quadkit-testing
VAL4—quadkit, quadkit-contracts
VEC4—quadkit-contracts
WEB14—quadkit-contracts, quadkit-web
WEBHOOK1—quadkit-contracts
WF22—quadkit, quadkit-contracts, quadkit-workflow

2. Full Registry (by Package)

Section titled “2. Full Registry (by Package)”

quadkit-contracts (166 codes)

Section titled “quadkit-contracts (166 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_ADMIN_001AdminErrorBase exception for all admin-domain errors. Extended by leaf exceptions in an admin extension.core/quadkit-contracts/src/quadkit/contracts/admin/errors.pyQuadkitError
QK_ERR_AGT_001AgentErrorBase exception for all agent errors.core/quadkit-contracts/src/quadkit/contracts/ai/agents/exceptions.pyQuadkitError
QK_ERR_AGT_002ToolErrorBase exception for tool errors.core/quadkit-contracts/src/quadkit/contracts/ai/agents/exceptions.pyAgentError
QK_ERR_AGT_003StrategyErrorReasoning strategy failed. Raised when the agent’s strategy encounters an error during reasoning …core/quadkit-contracts/src/quadkit/contracts/ai/agents/exceptions.pyAgentError
QK_ERR_AI_001AIErrorBase exception for all AI-domain errors. This is the catch-all for AI operations that fail in exp…core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyDomainError
QK_ERR_AI_002ExtractionErrorBase for structured extraction errors. Used in StructuredExtractorProtocol.extract() return t…core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_AI_003MetricsCollectionErrorError raised during metrics collection.core/quadkit-contracts/src/quadkit/contracts/observability/ai.pyMonitoringError
QK_ERR_AI_004TracingErrorError raised during tracing operations.core/quadkit-contracts/src/quadkit/contracts/observability/ai.pyQuadkitError
QK_ERR_AI_006RelayErrorBase for relay conversion and gateway errors. Extended in quadkit-ai-llm with specific conversion…core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_AI_007MonitoringErrorBase error raised during AI observability monitoring.core/quadkit-contracts/src/quadkit/contracts/observability/ai.pyQuadkitError
QK_ERR_AUTH_001AuthErrorBase exception for all auth-domain errors. This is the catch-all for authentication and authoriza…core/quadkit-contracts/src/quadkit/contracts/auth/exceptions.pyDomainError
QK_ERR_AUTH_002TokenErrorBase class for expected, recoverable token domain failures. All subtypes indicate situations the …core/quadkit-contracts/src/quadkit/contracts/auth/exceptions.pyDomainError
QK_ERR_AUTH_003VerificationErrorBase class for expected, recoverable account-verification failures. All subtypes signal situation…core/quadkit-contracts/src/quadkit/contracts/auth/exceptions.pyDomainError
QK_ERR_CACHE_001CacheErrorBase exception for all cache-domain errors. This is an expected, recoverable error that cache cli…core/quadkit-contracts/src/quadkit/contracts/infra/cache/exceptions.pyDomainError
QK_ERR_CACHE_002CacheKeyNotFoundErrorRaised when cache key is not found.core/quadkit-contracts/src/quadkit/contracts/infra/cache/exceptions.pyCacheError
QK_ERR_CACHE_003CacheWriteErrorRaised when cache write fails.core/quadkit-contracts/src/quadkit/contracts/infra/cache/exceptions.pyCacheError
QK_ERR_CFG_001ConfigurationErrorDeveloper configuration or runtime misconfiguration errors. Supports optional structured validati…core/quadkit-contracts/src/quadkit/contracts/exceptions/config.pyQuadkitError
QK_ERR_CODEGEN_001CollidingFileErrorA generated file collides with an existing file under a FAIL policy.core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyInfrastructureError
QK_ERR_CORE_001QuadkitErrorRoot exception for the entire Quadkit ecosystem. All Quadkit exceptions inherit from this class. …core/quadkit-contracts/src/quadkit/contracts/exceptions/base.pyException
QK_ERR_DB_001DatabaseErrorDatabase-related error (infrastructure-level).core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyInfrastructureError
QK_ERR_DB_002MigrationErrorDatabase migration error.core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyInfrastructureError
QK_ERR_DB_003IntegrityErrorRaised when a database integrity constraint is violated.core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyDatabaseError
QK_ERR_DB_004ConstraintErrorRaised when a generic database constraint is violated.core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyIntegrityError
QK_ERR_DB_005DuplicateKeyErrorRaised when a unique-key constraint is violated (duplicate record).core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyConstraintError
QK_ERR_DB_006UnitOfWorkErrorRaised when a unit-of-work operation fails or is used incorrectly.core/quadkit-contracts/src/quadkit/contracts/data/exceptions.pyQuadkitError
QK_ERR_DB_007DataErrorBase exception for all data-domain errors. This is an expected, recoverable error that data clien…core/quadkit-contracts/src/quadkit/contracts/data/exceptions.pyDomainError
QK_ERR_DB_008DataNotFoundErrorRaised when data item is not found.core/quadkit-contracts/src/quadkit/contracts/data/exceptions.pyDataError
QK_ERR_DB_009DataValidationErrorRaised when data validation fails.core/quadkit-contracts/src/quadkit/contracts/data/exceptions.pyDataError
QK_ERR_DB_010InvalidIdentifierErrorRaised when an SQL identifier fails validation. Attributes: identifier: The offending identifier …core/quadkit-contracts/src/quadkit/contracts/data/sql/sql.pyValidationError
QK_ERR_DB_011NoPrimaryBackendErrorRaised when a multi-backend setup has no backend marked as primary. For multi-backend SQL configu…core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyDatabaseError
QK_ERR_DI_001ContainerErrorBase container error.core/quadkit-contracts/src/quadkit/contracts/exceptions/container.pyQuadkitError
QK_ERR_DI_002DependencyErrorDependency resolution error.core/quadkit-contracts/src/quadkit/contracts/exceptions/container.pyContainerError
QK_ERR_DI_003CircularDependencyErrorCircular dependency detected.core/quadkit-contracts/src/quadkit/contracts/exceptions/container.pyDependencyError
QK_ERR_DI_004UnresolvableDependencyErrorCannot resolve dependency.core/quadkit-contracts/src/quadkit/contracts/exceptions/container.pyDependencyError
QK_ERR_DI_005RegistrationErrorService registration error.core/quadkit-contracts/src/quadkit/contracts/exceptions/container.pyContainerError
QK_ERR_DI_006ContainerBuildErrorContainer build/configuration error.core/quadkit-contracts/src/quadkit/contracts/exceptions/container.pyContainerError
QK_ERR_DI_007ProtocolValidationErrorProtocol validation error.core/quadkit-contracts/src/quadkit/contracts/exceptions/container.pyContainerError
QK_ERR_DI_008ContainerValidationErrorContainer dependency graph validation failed before boot. Raised when Container.validate() di…core/quadkit-contracts/src/quadkit/contracts/exceptions/container.pyContainerBuildError
QK_ERR_DI_009ScopedResolutionErrorAttempted to resolve a scoped service outside of an active scope. Raised when a service registere…core/quadkit-contracts/src/quadkit/contracts/exceptions/container.pyUnresolvableDependencyError
QK_ERR_DOM_001DomainErrorBusiness/domain-level errors (validation failures, not found, auth).core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyQuadkitError
QK_ERR_DOM_002NotFoundErrorResource not found error (domain-level).core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyDomainError
QK_ERR_DOM_003PermissionDeniedErrorPermission denied error (domain-level).core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyDomainError
QK_ERR_DOM_004AuthenticationErrorAuthentication error (domain-level).core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyDomainError
QK_ERR_DOM_005AuthorizationErrorAuthorization/permission error (domain-level).core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyDomainError
QK_ERR_DOM_006RateLimitErrorRate limiting error.core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyDomainError
QK_ERR_DOM_007ConflictErrorResource conflict error.core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyDomainError
QK_ERR_EVAL_001EvaluationErrorBase for evaluation system errors. Extended in the AI evaluation layer with specific failures lik…core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_EVT_001EventErrorBase events/messaging error.core/quadkit-contracts/src/quadkit/contracts/exceptions/events.pyQuadkitError
QK_ERR_EVT_002HandlerNotFoundErrorEvent/command handler not found. Raised when no handler is registered for a specific event or com…core/quadkit-contracts/src/quadkit/contracts/exceptions/events.pyEventError
QK_ERR_EVT_003DuplicateHandlerErrorDuplicate handler registration. Raised when attempting to register a handler for a type that alre…core/quadkit-contracts/src/quadkit/contracts/exceptions/events.pyEventError
QK_ERR_FEAT_001FeatureFlagErrorBase error for the feature flag subsystem.core/quadkit-contracts/src/quadkit/contracts/exceptions/feature_flags.pyQuadkitError
QK_ERR_GOV_001GovernanceErrorBase class for governance-related errors.core/quadkit-contracts/src/quadkit/contracts/ai/governance/errors.pyQuadkitError
QK_ERR_GOV_002BudgetExceededErrorError raised when budget is exceeded.core/quadkit-contracts/src/quadkit/contracts/ai/governance/errors.pyGovernanceError
QK_ERR_GOV_003PolicyViolationErrorError raised when policy is violated.core/quadkit-contracts/src/quadkit/contracts/ai/governance/errors.pyGovernanceError
QK_ERR_GOV_010ResourceExhaustedErrorRaised when a resource quota is exhausted.core/quadkit-contracts/src/quadkit/contracts/ai/governance/resource_unit.pyGovernanceError
QK_ERR_GUARD_001GuardErrorBase for AI guard/policy enforcement errors. Extended in the AI guard layer with specific failure…core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_GUARD_002InputGuardErrorError raised during input guard validation.core/quadkit-contracts/src/quadkit/contracts/ai/guards.pyGuardError
QK_ERR_GUARD_003OutputGuardErrorError raised during output guard validation.core/quadkit-contracts/src/quadkit/contracts/ai/guards.pyGuardError
QK_ERR_IDEM_001IdempotencyErrorBase exception for idempotency flows.core/quadkit-contracts/src/quadkit/contracts/exceptions/idempotency.pyQuadkitError
QK_ERR_IDEM_002DuplicateRequestErrorRaised when an idempotent key is reused before completion.core/quadkit-contracts/src/quadkit/contracts/exceptions/idempotency.pyIdempotencyError
QK_ERR_IDEM_003IdempotencyStoreErrorRaised on unexpected failures inside the idempotency store.core/quadkit-contracts/src/quadkit/contracts/exceptions/idempotency.pyIdempotencyError
QK_ERR_IDEM_004IdempotencyConflictErrorRaised when an idempotency key is already claimed (PENDING).core/quadkit-contracts/src/quadkit/contracts/exceptions/idempotency.pyIdempotencyError
QK_ERR_IDX_001RAGIndexErrorRaised when index operations fail in an expected, recoverable way.core/quadkit-contracts/src/quadkit/contracts/ai/index.pyRAGError
QK_ERR_INFRA_001InfrastructureErrorSystem-level failures (DB down, network timeouts).core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyQuadkitError
QK_ERR_INFRA_002LockErrorDistributed lock error.core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyInfrastructureError
QK_ERR_INFRA_003LockConflictErrorRaised when a lock conflict occurs (resource already locked).core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyLockError
QK_ERR_INFRA_004ComponentErrorBase exception for all component-related errors.core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyQuadkitError
QK_ERR_INFRA_005ComponentConnectionErrorRaised when a connection to an external service fails.core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyInfrastructureError, ComponentError
QK_ERR_INFRA_006KeyNotFoundErrorRaised when a requested key does not exist.core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyNotFoundError, ComponentError
QK_ERR_INFRA_007KeyExistsErrorRaised when trying to create a key that already exists.core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyConflictError, ComponentError
QK_ERR_INFRA_008PubSubErrorBase exception for pub/sub operations.core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyInfrastructureError, ComponentError
QK_ERR_INFRA_009SecretNotFoundErrorRaised when a requested secret does not exist.core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyNotFoundError, ComponentError
QK_ERR_INFRA_010DriverNotAvailableErrorRaised when a driver is not available (dependency not installed).core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyComponentError
QK_ERR_INFRA_011_StoredStreamErrorInternal carrier for propagating typed stream failures.core/quadkit-contracts/src/quadkit/contracts/infra/streams.pyException, Generic[E]
QK_ERR_LLM_001LLMErrorBase for LLM client errors. Extended in quadkit-ai-llm with specific failures like rate limiting,…core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_LOAD_001LoaderErrorRaised when document loading fails in an expected, recoverable way. Extended in a RAG extension wi…core/quadkit-contracts/src/quadkit/contracts/ai/loaders.pyRAGError
QK_ERR_LOCK_001LockAcquisitionErrorRaised when acquiring a lock fails.core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyLockError, ComponentError
QK_ERR_LOCK_002LockNotHeldErrorRaised when trying to operate on a lock that is not held.core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyLockError, ComponentError
QK_ERR_LOCK_003LockOwnershipErrorRaised when trying to release or extend a lock held by another owner.core/quadkit-contracts/src/quadkit/contracts/exceptions/components.pyLockError, ComponentError
QK_ERR_MAP_001MappingErrorObject mapping error.core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyQuadkitError
QK_ERR_MCP_001MCPErrorBase exception for all MCP errors.core/quadkit-contracts/src/quadkit/contracts/mcp/exceptions.pyQuadkitError
QK_ERR_MCP_002MCPTransportErrorTransport-level error (connection, I/O). Raised when the MCP transport layer encounters errors su…core/quadkit-contracts/src/quadkit/contracts/mcp/exceptions.pyMCPError
QK_ERR_MCP_003MCPToolCallErrorTool call failed during MCP execution. Raised when a tool invocation fails, either due to the too…core/quadkit-contracts/src/quadkit/contracts/mcp/exceptions.pyMCPError
QK_ERR_MCP_004MCPResourceErrorResource read or list failed. Raised when a resource operation fails, such as when a resource is …core/quadkit-contracts/src/quadkit/contracts/mcp/exceptions.pyMCPError
QK_ERR_MCP_005MCPProtocolErrorProtocol violation (malformed message, invalid state). Raised when an MCP message violates the pr…core/quadkit-contracts/src/quadkit/contracts/mcp/exceptions.pyMCPError
QK_ERR_MCP_006MCPMethodNotFoundErrorUnknown MCP method requested by client. Raised when the client requests an MCP method that the se…core/quadkit-contracts/src/quadkit/contracts/mcp/exceptions.pyMCPError
QK_ERR_MCP_007MCPPromptErrorPrompt retrieval or list failed. Raised when a prompt operation fails, such as when a prompt is n…core/quadkit-contracts/src/quadkit/contracts/mcp/exceptions.pyMCPError
QK_ERR_MCP_008MCPInitializationErrorMCP server initialization failed. Raised when the MCP server cannot be initialized, usually due t…core/quadkit-contracts/src/quadkit/contracts/mcp/exceptions.pyMCPError
QK_ERR_MEM_001AIMemoryErrorBase for AI memory system errors. Extended in an AI memory extension with specific failures like conso…core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_MEM_002ConsolidationErrorError raised during memory consolidation.core/quadkit-contracts/src/quadkit/contracts/ai/memory.pyAIMemoryError
QK_ERR_MEM_003StorageErrorError raised during memory storage operations.core/quadkit-contracts/src/quadkit/contracts/ai/memory.pyAIMemoryError
QK_ERR_MM_001MultimediaErrorBase exception for all multimedia-generation errors. Mirrors AIError(DomainError) — recoverab…core/quadkit-contracts/src/quadkit/contracts/multimedia/exceptions.pyDomainError
QK_ERR_MM_002TTSErrorBase for text-to-speech generation errors.core/quadkit-contracts/src/quadkit/contracts/multimedia/exceptions.pyMultimediaError
QK_ERR_MM_003MusicGenerationErrorBase for music/sound generation errors.core/quadkit-contracts/src/quadkit/contracts/multimedia/exceptions.pyMultimediaError
QK_ERR_MM_004VideoGenerationErrorBase for video generation errors.core/quadkit-contracts/src/quadkit/contracts/multimedia/exceptions.pyMultimediaError
QK_ERR_MM_005ImageGenerationErrorBase for still-image generation errors.core/quadkit-contracts/src/quadkit/contracts/multimedia/exceptions.pyMultimediaError
QK_ERR_MM_006ProviderNotInstalledErrorRaised eagerly at DI-resolution time when a configured provider’s optional extra is not installed…core/quadkit-contracts/src/quadkit/contracts/multimedia/exceptions.pyMultimediaError
QK_ERR_MM_007UpscaleErrorBase for image/video super-resolution errors.core/quadkit-contracts/src/quadkit/contracts/multimedia/exceptions.pyMultimediaError
QK_ERR_MM_008BeatAnalysisErrorBase for tempo/beat-detection errors.core/quadkit-contracts/src/quadkit/contracts/multimedia/exceptions.pyMultimediaError
QK_ERR_MOD_001ModuleErrorModule configuration or lifecycle error.core/quadkit-contracts/src/quadkit/contracts/exceptions/provider.pyQuadkitError
QK_ERR_MOD_002ModuleImportErrorA module imports a module that does not exist in the graph. Raised during module compilation when…core/quadkit-contracts/src/quadkit/contracts/exceptions/provider.pyModuleError
QK_ERR_MOD_003ModuleExportErrorA module exports a type not provided by its providers. Raised during post-registration validation…core/quadkit-contracts/src/quadkit/contracts/exceptions/provider.pyModuleError
QK_ERR_MOD_004ModuleCycleErrorCircular dependency detected in the module import graph. Raised during module compilation when a …core/quadkit-contracts/src/quadkit/contracts/exceptions/provider.pyModuleError
QK_ERR_MOD_005ModuleVisibilityErrorA provider depends on a service not visible to its module. Raised when a provider in module A tri…core/quadkit-contracts/src/quadkit/contracts/exceptions/provider.pyModuleError
QK_ERR_MOD_006ModuleDuplicateErrorThe same module appears twice with conflicting configurations. Raised when two :class:`DynamicMod…core/quadkit-contracts/src/quadkit/contracts/exceptions/provider.pyModuleError
QK_ERR_MW_001MiddlewareGuardErrorRaised when a middleware guard denies access.core/quadkit-contracts/src/quadkit/contracts/exceptions/middleware.pyQuadkitError
QK_ERR_NOTIF_001NotificationErrorBase for expected, recoverable notification delivery failures. Attributes: channel: Notification …core/quadkit-contracts/src/quadkit/contracts/notification/errors.pyDomainError
QK_ERR_NOTIF_002MailerErrorBase mailer/email notification error.core/quadkit-contracts/src/quadkit/contracts/mailer/errors.pyDomainError
QK_ERR_PIPE_001PipelineExecutionErrorError raised during pipeline execution.core/quadkit-contracts/src/quadkit/contracts/exceptions/execution.pyQuadkitError
QK_ERR_PIPE_002PipelineStepErrorError raised by a pipeline step.core/quadkit-contracts/src/quadkit/contracts/exceptions/execution.pyQuadkitError
QK_ERR_PROV_001ProviderErrorProvider configuration or lifecycle error.core/quadkit-contracts/src/quadkit/contracts/exceptions/provider.pyQuadkitError
QK_ERR_QE_001QueryEngineErrorRaised when query engine operations fail in an expected, recoverable way.core/quadkit-contracts/src/quadkit/contracts/ai/index.pyRAGError
QK_ERR_QUEUE_001QueueErrorBase for expected, recoverable queue / bus failures. Attributes: backend: Name of the queue backe…core/quadkit-contracts/src/quadkit/contracts/queue/errors.pyDomainError
QK_ERR_RAG_001RAGErrorBase for RAG pipeline errors. Extended in a RAG extension with specific failures like retrieval, p…core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_RAG_002RetrievalErrorError raised during document retrieval.core/quadkit-contracts/src/quadkit/contracts/ai/rag.pyRAGError
QK_ERR_RAG_003SynthesisErrorError raised during response synthesis.core/quadkit-contracts/src/quadkit/contracts/ai/rag.pyRAGError
QK_ERR_RAG_004ChunkingErrorError raised during document chunking.core/quadkit-contracts/src/quadkit/contracts/ai/rag.pyRAGError
QK_ERR_REG_001RegistryErrorBase exception for registry errors.core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyQuadkitError
QK_ERR_REG_002RegistryKeyErrorRaised when a key is not found in a registry.core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyRegistryError, KeyError
QK_ERR_REG_003RegistryAlreadyExistsErrorRaised when attempting to register a duplicate key in a registry.core/quadkit-contracts/src/quadkit/contracts/exceptions/infra.pyRegistryError
QK_ERR_RESULT_002UnwrapErrorRaised when unwrap() or unwrap_err() is called on the wrong variant. Provides a clearer error typ…core/quadkit-contracts/src/quadkit/contracts/core/result.pyException
QK_ERR_RES_001ResilienceErrorBase resilience error.core/quadkit-contracts/src/quadkit/contracts/exceptions/resilience.pyQuadkitError
QK_ERR_RES_002RetryErrorRetry operation error.core/quadkit-contracts/src/quadkit/contracts/exceptions/resilience.pyResilienceError
QK_ERR_RES_003CircuitBreakerErrorCircuit breaker error.core/quadkit-contracts/src/quadkit/contracts/exceptions/resilience.pyResilienceError
QK_ERR_RES_004BulkheadErrorBulkhead/rejection error.core/quadkit-contracts/src/quadkit/contracts/exceptions/resilience.pyResilienceError
QK_ERR_RES_005FallbackErrorFallback execution error.core/quadkit-contracts/src/quadkit/contracts/exceptions/resilience.pyResilienceError
QK_ERR_RES_006RetryExhaustedErrorAll retry attempts have been exhausted.core/quadkit-contracts/src/quadkit/contracts/exceptions/resilience.pyRetryError
QK_ERR_RES_007CircuitOpenErrorCircuit breaker is open and rejecting requests.core/quadkit-contracts/src/quadkit/contracts/exceptions/resilience.pyCircuitBreakerError
QK_ERR_RET_001RetrieverErrorBase for retriever errors. Raised when document retrieval fails in an expected, recoverable way (…core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_RUN_001RunnableErrorRecoverable composition failure (input shape, parser error, retry budget exceeded).core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_SEC_001SecurityErrorBase security error for the Quadkit security subsystem.core/quadkit-contracts/src/quadkit/contracts/exceptions/security.pyQuadkitError
QK_ERR_SEC_002GuardDeniedErrorRaised when a GuardChain denies the request. Attributes: guard: The name or type of the guard tha…core/quadkit-contracts/src/quadkit/contracts/exceptions/security.pySecurityError
QK_ERR_SEC_003InputSanitizationErrorRaised when sanitization fails due to unrecoverable input structure.core/quadkit-contracts/src/quadkit/contracts/exceptions/security.pySecurityError
QK_ERR_SEC_004CORSViolationErrorRaised when a request violates the configured CORS policy. Attributes: origin: The request origin…core/quadkit-contracts/src/quadkit/contracts/exceptions/security.pySecurityError
QK_ERR_SEC_005SecretAccessErrorRaised when the caller lacks permission to access or modify a secret. Attributes: secret_name: Na…core/quadkit-contracts/src/quadkit/contracts/exceptions/security.pySecurityError
QK_ERR_SERIAL_001SerializationErrorSerialization/deserialization error.core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyQuadkitError
QK_ERR_SES_001SessionErrorBase class for session-related errors.core/quadkit-contracts/src/quadkit/contracts/ai/session.pyQuadkitError
QK_ERR_SES_002TaskCancelledErrorError raised when a task is cancelled.core/quadkit-contracts/src/quadkit/contracts/ai/session.pyQuadkitError
QK_ERR_SES_003TaskErrorBase class for task execution errors.core/quadkit-contracts/src/quadkit/contracts/ai/session.pyQuadkitError
QK_ERR_SES_004TaskTimeoutErrorError raised when a task times out.core/quadkit-contracts/src/quadkit/contracts/ai/session.pyTaskError
QK_ERR_SES_005TaskValidationErrorError raised when task input validation fails.core/quadkit-contracts/src/quadkit/contracts/ai/session.pyTaskError
QK_ERR_SKILL_001SkillErrorBase for skill execution errors. Extended in an AI skills extension with specific failures like skill …core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_STORE_001StorageErrorBase exception for storage errors.core/quadkit-contracts/src/quadkit/contracts/infra/storage/exceptions.pyQuadkitError
QK_ERR_STORE_003StorageUnsupportedOperationErrorRaised when the requested operation is not supported by the storage driver.core/quadkit-contracts/src/quadkit/contracts/infra/storage/exceptions.pyStorageError
QK_ERR_TASK_001TaskQueueErrorBase class for expected, recoverable task queue failures. All subtypes indicate situations the ca…core/quadkit-contracts/src/quadkit/contracts/infra/tasks/exceptions.pyDomainError
QK_ERR_TENANT_001TenantErrorBase class for all tenancy-related domain errors.core/quadkit-contracts/src/quadkit/contracts/tenancy/errors.pyDomainError
QK_ERR_TENANT_002TenantNotFoundErrorRaised when a requested tenant does not exist.core/quadkit-contracts/src/quadkit/contracts/tenancy/errors.pyTenantError
QK_ERR_TENANT_003TenantInactiveErrorRaised when an operation is attempted on an inactive tenant.core/quadkit-contracts/src/quadkit/contracts/tenancy/errors.pyTenantError
QK_ERR_TENANT_004TenantProvisioningErrorRaised when tenant provisioning (isolation setup) fails.core/quadkit-contracts/src/quadkit/contracts/tenancy/errors.pyTenantError
QK_ERR_TENANT_005TenantResolutionErrorRaised when tenant resolution fails unexpectedly.core/quadkit-contracts/src/quadkit/contracts/tenancy/errors.pyTenantError
QK_ERR_TENANT_006TenantConfigErrorRaised when per-tenant configuration access or mutation fails.core/quadkit-contracts/src/quadkit/contracts/tenancy/errors.pyTenantError
QK_ERR_TENANT_007TenantSlugConflictErrorRaised when a tenant slug is already in use.core/quadkit-contracts/src/quadkit/contracts/tenancy/errors.pyTenantError
QK_ERR_TENANT_008TenantSuspendedErrorRaised when an operation is attempted on a suspended tenant.core/quadkit-contracts/src/quadkit/contracts/tenancy/errors.pyTenantError
QK_ERR_TENANT_009MigrationErrorRaised when a tenant tier migration fails.core/quadkit-contracts/src/quadkit/contracts/tenancy/errors.pyTenantError
QK_ERR_VAL_001FieldErrorA single field-level validation error. Used to represent validation failures for individual field…core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyDomainError
QK_ERR_VAL_002ValidationErrorData validation error.core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyDomainError
QK_ERR_VEC_001VectorErrorBase exception for vector store errors. Extends InfrastructureError because vector operations inv…core/quadkit-contracts/src/quadkit/contracts/data/vector/exceptions.pyInfrastructureError
QK_ERR_VEC_002VectorStoreErrorException raised during vector store operations (CRUD, search).core/quadkit-contracts/src/quadkit/contracts/data/vector/exceptions.pyVectorError
QK_ERR_VEC_003EmbeddingErrorException raised during embedding generation or retrieval.core/quadkit-contracts/src/quadkit/contracts/data/vector/exceptions.pyVectorError
QK_ERR_VEC_004VectorIndexErrorException raised during vector index creation or management.core/quadkit-contracts/src/quadkit/contracts/data/vector/exceptions.pyVectorError
QK_ERR_WEBHOOK_001WebhookErrorBase exception for webhook domain operations.core/quadkit-contracts/src/quadkit/contracts/webhook/exceptions.pyDomainError
QK_ERR_WEB_001WebErrorWeb layer error.core/quadkit-contracts/src/quadkit/contracts/exceptions/domain.pyDomainError
QK_ERR_WEB_002HttpStatusErrorRaised by :meth:HttpResponse.raise_for_status for 4xx/5xx responses. Attributes: status: HTTP s…core/quadkit-contracts/src/quadkit/contracts/web/http_models.pyInfrastructureError
QK_ERR_WF_001WorkflowErrorBase for workflow execution errors. Raised when a workflow graph execution fails in an expected, …core/quadkit-contracts/src/quadkit/contracts/ai/exceptions.pyAIError
QK_ERR_WF_002SagaStepErrorRepresents a recoverable failure from a single saga step action. SagaProtocol step actions must r…core/quadkit-contracts/src/quadkit/contracts/workflow/steps.pyException
QK_ERR_WF_009SagaVersionMismatchErrorRaised when a persisted saga state version is incompatible with the current code. Attributes: sag…core/quadkit-contracts/src/quadkit/contracts/workflow/errors.pyQuadkitError

quadkit (48 codes)

Section titled “quadkit (48 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_APP_001AppErrorBase exception for all app errors.core/quadkit/src/quadkit/app/exceptions.pyQuadkitError
QK_ERR_APP_002AppStartupErrorRaised when the application fails to start or a provider fails during boot.core/quadkit/src/quadkit/app/exceptions.pyAppError
QK_ERR_APP_003AppShutdownErrorRaised when the application cannot complete a graceful shutdown.core/quadkit/src/quadkit/app/exceptions.pyAppError
QK_ERR_CFG_002ConfigurationErrorConfiguration loading, parsing, or validation failed. Raised by: - ConfigProvider during init…core/quadkit/src/quadkit/exceptions.pyQuadkitException
QK_ERR_CFG_003ConfigSourceErrorRaised when a configuration source fails to load its values.core/quadkit/src/quadkit/config/exceptions.pyConfigurationError
QK_ERR_CFG_004ConfigReloadErrorRaised when a live-reload attempt fails.core/quadkit/src/quadkit/config/exceptions.pyConfigurationError
QK_ERR_CFG_005ConfigSectionNotFoundErrorRaised when a required config section is absent from the loaded config.core/quadkit/src/quadkit/config/exceptions.pyConfigurationError
QK_ERR_CFG_006UnknownConfigKeysErrorRaised when a typed config section contains keys its model does not define. Almost always a typo …core/quadkit/src/quadkit/config/exceptions.pyConfigurationError
QK_ERR_CONC_001ConcurrencyErrorBase exception for all concurrency errors.core/quadkit/src/quadkit/concurrency/exceptions.pyQuadkitError
QK_ERR_CONC_002AsyncErrorException raised for errors in asynchronous operations or concurrency control.core/quadkit/src/quadkit/concurrency/exceptions.pyConcurrencyError
QK_ERR_CONC_003ChannelClosedErrorRaised when an operation is attempted on a closed channel.core/quadkit/src/quadkit/concurrency/exceptions.pyConcurrencyError
QK_ERR_CONC_004ChannelFullErrorRaised when sending to a channel that is at capacity.core/quadkit/src/quadkit/concurrency/exceptions.pyConcurrencyError
QK_ERR_CONC_005DispatcherErrorError in dispatcher execution.core/quadkit/src/quadkit/concurrency/exceptions.pyConcurrencyError
QK_ERR_CONC_006StructuredParallelismErrorBase exception for parallel execution errors.core/quadkit/src/quadkit/concurrency/exceptions.pyConcurrencyError
QK_ERR_CONC_007TaskGroupErrorRaised when a task group encounters an error.core/quadkit/src/quadkit/concurrency/exceptions.pyStructuredParallelismError
QK_ERR_CONC_008CancellationScopeErrorRaised when a cancellation scope encounters an error.core/quadkit/src/quadkit/concurrency/exceptions.pyStructuredParallelismError
QK_ERR_CORE_002QuadkitExceptionBase exception for all quadkit domain errors. Extends :class:`~quadkit.contracts.exceptions.base…core/quadkit/src/quadkit/exceptions.pyQuadkitError
QK_ERR_CORE_005CoreErrorBase exception for all core errors.core/quadkit/src/quadkit/primitives/exceptions.pyQuadkitError
QK_ERR_CORE_006ReactiveErrorBase exception for the reactive stream layer.core/quadkit/src/quadkit/reactive/exceptions.pyQuadkitError
QK_ERR_CORE_007BackpressureErrorRaised when a subscriber channel overflows under a non-blocking policy.core/quadkit/src/quadkit/reactive/exceptions.pyReactiveError
QK_ERR_DI_010InjectionErrorDependency injection or container resolution failed. Raised by: - Container.resolve() when a …core/quadkit/src/quadkit/exceptions.pyQuadkitException
QK_ERR_DI_011InterceptorTimeoutErrorRaised when a MethodInterceptorProtocol exceeds its configured timeout.core/quadkit/src/quadkit/di/extensions/aop_interceptors.pyRuntimeError
QK_ERR_DOM_008DomainModelErrorDomain model invariant violated or business rule broken. Raised by: - Domain event handlers - Agg…core/quadkit/src/quadkit/exceptions.pyQuadkitException
QK_ERR_DOM_009DomainPolicyViolationErrorRaised when a domain policy evaluation fails. Distinct from PolicyViolationProtocol (the Resu…core/quadkit/src/quadkit/domain/exceptions.pyQuadkitError
QK_ERR_INFRA_012PluginStateErrorRaised when plugin enable/disable state cannot be persisted or read. The admin surface converts t…core/quadkit/src/quadkit/plugins/exceptions.pyInfrastructureError
QK_ERR_MAP_002MappingErrorBase exception for all object-mapping errors.core/quadkit/src/quadkit/mapping/exceptions.pyQuadkitError
QK_ERR_MAP_003MappingNotFoundErrorRaised when no mapper is registered for a (source, destination) type pair.core/quadkit/src/quadkit/mapping/exceptions.pyMappingError
QK_ERR_MAP_004MappingExecutionErrorRaised when a registered mapper raises an unexpected error during execution.core/quadkit/src/quadkit/mapping/exceptions.pyMappingError
QK_ERR_MW_002MiddlewareErrorBase exception for infrastructure-level middleware errors.core/quadkit/src/quadkit/middleware/exceptions.pyInfrastructureError
QK_ERR_MW_003MiddlewarePolicyErrorBase exception for policy-level middleware rejections. Raised when middleware rejects a request b…core/quadkit/src/quadkit/middleware/exceptions.pyDomainError
QK_ERR_MW_004MiddlewareExecutionErrorRaised when a middleware raises an unexpected error during execution.core/quadkit/src/quadkit/middleware/exceptions.pyMiddlewareError
QK_ERR_MW_005MiddlewareConfigurationErrorRaised when middleware is configured incorrectly.core/quadkit/src/quadkit/middleware/exceptions.pyMiddlewareError
QK_ERR_MW_006MiddlewareChainErrorRaised when the middleware chain cannot be assembled or traversed.core/quadkit/src/quadkit/middleware/exceptions.pyMiddlewareError
QK_ERR_MW_007MiddlewareTimeoutErrorRaised when a middleware exceeds its configured timeout.core/quadkit/src/quadkit/middleware/exceptions.pyMiddlewareError
QK_ERR_MW_008MiddlewareAuthErrorRaised when middleware-level authentication/authorization fails.core/quadkit/src/quadkit/middleware/exceptions.pyMiddlewarePolicyError
QK_ERR_MW_009MiddlewareRateLimitErrorRaised when middleware-level rate limiting is exceeded.core/quadkit/src/quadkit/middleware/exceptions.pyMiddlewarePolicyError
QK_ERR_MW_010MiddlewareCircuitOpenErrorRaised when the circuit breaker in middleware is open.core/quadkit/src/quadkit/middleware/exceptions.pyMiddlewareError
QK_ERR_SEC_006SecurityErrorBase exception for all security-module errors.core/quadkit/src/quadkit/security/exceptions.pyQuadkitError
QK_ERR_SEC_008SecretAccessErrorRaised when access to a secret is denied.core/quadkit/src/quadkit/security/exceptions.pySecretError
QK_ERR_SEC_009EncryptionErrorRaised when field-level encryption fails.core/quadkit/src/quadkit/security/exceptions.pySecurityError
QK_ERR_SEC_010DecryptionErrorRaised when field-level decryption fails.core/quadkit/src/quadkit/security/exceptions.pySecurityError
QK_ERR_SEC_011SecretErrorBase exception for secret store errors.core/quadkit/src/quadkit/security/exceptions.pySecurityError
QK_ERR_SERIAL_002SerializationErrorJSON serialisation or deserialisation failed. Raised by: - JsonSerializer implementations - D…core/quadkit/src/quadkit/exceptions.pyQuadkitException
QK_ERR_SERIAL_003SerializationErrorBase exception for serialization and deserialization failures. Extensions should subclass this fo…core/quadkit/src/quadkit/serialization/exceptions.pyQuadkitError
QK_ERR_SERIAL_004NegotiationErrorRaised when no serializer can be negotiated for a given Accept header.core/quadkit/src/quadkit/serialization/exceptions.pySerializationError
QK_ERR_VAL_003ValidationErrorInput validation against rules failed. Raised by: - ValidatorImpl.validate() when rules do no…core/quadkit/src/quadkit/exceptions.pyQuadkitException
QK_ERR_VAL_004ValidationSystemErrorBase exception for validation system/pipeline failures. Distinct from :class:`~quadkit.contracts…core/quadkit/src/quadkit/validation/exceptions.pyQuadkitError
QK_ERR_WF_019SagaErrorRaised when a saga step fails after compensation has been attempted. Attributes: step_name: Name …core/quadkit/src/quadkit/saga/base.pyQuadkitError

quadkit-ai-agents (10 codes)

Section titled “quadkit-ai-agents (10 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_AGT_004AgentConfigurationErrorInvalid agent configuration. Raised when an agent is constructed with invalid parameters (no tool…packages/quadkit-ai-agents/src/quadkit/ai/agents/exceptions.pyAgentError
QK_ERR_AGT_005AgentExecutionErrorAgent execution failed. Raised when the agent’s reasoning loop encounters an unrecoverable error …packages/quadkit-ai-agents/src/quadkit/ai/agents/exceptions.pyAgentError
QK_ERR_AGT_006ToolNotFoundErrorTool not found in registry. Raised when the agent tries to call a tool that is not registered in …packages/quadkit-ai-agents/src/quadkit/ai/agents/exceptions.pyToolError
QK_ERR_AGT_007ToolExecutionErrorTool execution failed. Raised when a tool raises an exception during execution.packages/quadkit-ai-agents/src/quadkit/ai/agents/exceptions.pyToolError
QK_ERR_AGT_008ToolAccessDeniedErrorAgent does not have access to this tool. Raised when module visibility controls prevent an agent …packages/quadkit-ai-agents/src/quadkit/ai/agents/exceptions.pyToolError
QK_ERR_AGT_009MaxIterationsExceededErrorAgent exceeded maximum reasoning iterations. Raised when the agent reaches max_iterations without…packages/quadkit-ai-agents/src/quadkit/ai/agents/exceptions.pyStrategyError
QK_ERR_AGT_010BudgetExceededErrorAgent exceeded its AI governance budget. Raised when token usage or cost exceeds configured limit…packages/quadkit-ai-agents/src/quadkit/ai/agents/exceptions.pyAgentError
QK_ERR_AGT_011ToolValidationErrorTool input validation failed. Raised when the arguments provided to a tool fail schema validation…packages/quadkit-ai-agents/src/quadkit/ai/agents/exceptions.pyToolError
QK_ERR_AGT_012ToolObservationBlockedErrorA guard blocked tool output from entering the model context.packages/quadkit-ai-agents/src/quadkit/ai/agents/strategies/guard_hook.pyAgentExecutionError
QK_ERR_AGT_013ToolObservationGuardErrorThe guard pipeline failed while checking tool output.packages/quadkit-ai-agents/src/quadkit/ai/agents/strategies/guard_hook.pyAgentExecutionError

quadkit-ai-llm (28 codes)

Section titled “quadkit-ai-llm (28 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_LLM_002LLMErrorBase exception for all LLM-domain errors in quadkit-ai-llm.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.py_ContractsLLMError
QK_ERR_LLM_003LLMAuthenticationErrorInvalid API key or credentials — infrastructure error, raised not wrapped. Raised as an exception…packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_004InvalidRequestErrorError raised when a request to an LLM provider is invalid.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_005ModelNotFoundErrorModel unavailable or not found — recoverable via fallback routing.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_006LLMModelNotFoundErrorModel unavailable or not found — recoverable via fallback routing. Returned as Err from “LLM…packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyModelNotFoundError
QK_ERR_LLM_007LLMRateLimitErrorRate limit exceeded — recoverable via backoff/retry. Returned as Err from “LLMClientProtocol…packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_008LLMQuotaExceededErrorAPI quota or billing limit exceeded — recoverable by routing elsewhere. Returned as Err from …packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_009LLMContentFilterErrorContent blocked by provider safety filter — recoverable via reformulation. Returned as Err fr…packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_010TokenLimitErrorError raised when the token limit for a request is exceeded.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_011ProviderConnectionErrorError raised when connection to an LLM provider fails.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_012StreamErrorError raised during LLM response streaming.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_013ExtractionErrorBase class for structured extraction errors in quadkit-ai-llm.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.py_ContractsExtractionError
QK_ERR_LLM_014ExtractionParseErrorError raised when extraction response cannot be parsed as JSON.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyExtractionError
QK_ERR_LLM_015ExtractionValidationErrorError raised when parsed extraction response fails schema validation.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyExtractionError
QK_ERR_LLM_016ExtractionMaxRetriesErrorError raised when extraction max retries are exhausted.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyExtractionError
QK_ERR_LLM_017ModelRevisionMismatchErrorRaised when the provider returns a model revision that violates the pin policy.packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_018LLMTimeoutErrorRequest exceeded the client timeout — recoverable by routing elsewhere. Returned as Err from …packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError
QK_ERR_LLM_019SchemaValidationErrorRaised when parsed response fails validation.packages/quadkit-ai-llm/src/quadkit/ai/llm/structured/exceptions.pyStructuredOutputError
QK_ERR_LLM_020ModelManagerErrorBase exception for model manager errors.packages/quadkit-ai-llm/src/quadkit/ai/llm/model_manager/types.pyLLMError
QK_ERR_LLM_021ModelNotFoundErrorRaised when a requested model is not found.packages/quadkit-ai-llm/src/quadkit/ai/llm/model_manager/types.pyModelManagerError, BaseModelNotFoundError
QK_ERR_LLM_022ModelLoadErrorRaised when a model fails to load.packages/quadkit-ai-llm/src/quadkit/ai/llm/model_manager/types.pyModelManagerError
QK_ERR_LLM_023ModelUnloadErrorRaised when a model fails to unload.packages/quadkit-ai-llm/src/quadkit/ai/llm/model_manager/types.pyModelManagerError
QK_ERR_LLM_024ProviderConnectionErrorRaised when connection to provider fails.packages/quadkit-ai-llm/src/quadkit/ai/llm/model_manager/types.pyModelManagerError, BaseProviderConnectionError
QK_ERR_LLM_025OrchestratorErrorBase orchestration error.packages/quadkit-ai-llm/src/quadkit/ai/llm/routing/orchestrator.pyLLMError
QK_ERR_LLM_026NoSuitableModelErrorNo model found that meets the requirements.packages/quadkit-ai-llm/src/quadkit/ai/llm/routing/orchestrator.pyOrchestratorError
QK_ERR_LLM_027StructuredOutputErrorBase exception for structured output errors.packages/quadkit-ai-llm/src/quadkit/ai/llm/structured/exceptions.pyExtractionError
QK_ERR_LLM_028ParseErrorRaised when response cannot be parsed.packages/quadkit-ai-llm/src/quadkit/ai/llm/structured/exceptions.pyStructuredOutputError
QK_ERR_LLM_029EmbeddingErrorRaised when embedding generation fails. Covers missing credentials, provider HTTP failures (mappe…packages/quadkit-ai-llm/src/quadkit/ai/llm/exceptions.pyLLMError

quadkit-auth (26 codes)

Section titled “quadkit-auth (26 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_AUTH_004AuthErrorBase exception for all auth errors.packages/quadkit-auth/src/quadkit/auth/exceptions.pyContractsAuthError
QK_ERR_AUTH_005AuthenticationErrorRaised when authentication fails.packages/quadkit-auth/src/quadkit/auth/exceptions.pyQuadkitAuthenticationError, AuthError
QK_ERR_AUTH_006AuthorizationErrorRaised when user lacks required permissions.packages/quadkit-auth/src/quadkit/auth/exceptions.pyQuadkitAuthorizationError, AuthError
QK_ERR_AUTH_007InvalidCredentialsErrorRaised when credentials are invalid.packages/quadkit-auth/src/quadkit/auth/exceptions.pyAuthenticationError
QK_ERR_AUTH_008AccountLockedErrorRaised when an account is locked due to too many failed login attempts. Accounts are locked autom…packages/quadkit-auth/src/quadkit/auth/exceptions.pyAuthenticationError
QK_ERR_AUTH_009UserNotFoundErrorRaised when user is not found.packages/quadkit-auth/src/quadkit/auth/exceptions.pyQuadkitNotFoundError, AuthError
QK_ERR_AUTH_010TokenErrorBase exception for token-related errors.packages/quadkit-auth/src/quadkit/auth/exceptions.pyInvalidCredentialsError
QK_ERR_AUTH_011InvalidTokenErrorRaised when a token is malformed or invalid.packages/quadkit-auth/src/quadkit/auth/exceptions.pyTokenError
QK_ERR_AUTH_012TokenExpiredErrorRaised when a token has expired.packages/quadkit-auth/src/quadkit/auth/exceptions.pyTokenError
QK_ERR_AUTH_013TokenBlacklistedErrorToken has been explicitly revoked.packages/quadkit-auth/src/quadkit/auth/exceptions.pyTokenError
QK_ERR_AUTH_014TokenInvalidErrorToken is structurally invalid or has wrong type.packages/quadkit-auth/src/quadkit/auth/exceptions.pyTokenError
QK_ERR_AUTH_015TokenAudienceErrorToken audience claim does not match expected.packages/quadkit-auth/src/quadkit/auth/exceptions.pyTokenError
QK_ERR_AUTH_016TokenNotFoundErrorToken record does not exist.packages/quadkit-auth/src/quadkit/auth/exceptions.pyTokenError
QK_ERR_AUTH_017InvalidAudienceErrorRaised when a token audience is invalid.packages/quadkit-auth/src/quadkit/auth/exceptions.pyTokenError
QK_ERR_AUTH_018InvalidScopeErrorRaised when a token lacks required scope.packages/quadkit-auth/src/quadkit/auth/exceptions.pyTokenError
QK_ERR_AUTH_019BlacklistedTokenErrorRaised when a token has been blacklisted.packages/quadkit-auth/src/quadkit/auth/exceptions.pyTokenError
QK_ERR_AUTH_020TokenExpiredVerificationErrorAccount verification has expired.packages/quadkit-auth/src/quadkit/auth/exceptions.pyVerificationError
QK_ERR_AUTH_021AlreadyVerifiedErrorAccount is already verified.packages/quadkit-auth/src/quadkit/auth/exceptions.pyVerificationError
QK_ERR_AUTH_022EmailExistsErrorRaised when email is already taken.packages/quadkit-auth/src/quadkit/auth/exceptions.pyAuthError, ConflictError
QK_ERR_AUTH_023UsernameExistsErrorRaised when username is already taken.packages/quadkit-auth/src/quadkit/auth/exceptions.pyAuthError, ConflictError
QK_ERR_AUTH_024PasswordPolicyErrorRaised when password doesn’t meet requirements.packages/quadkit-auth/src/quadkit/auth/exceptions.pyAuthError
QK_ERR_AUTH_025OAuth2ErrorBase exception for OAuth2 errors.packages/quadkit-auth/src/quadkit/auth/exceptions.pyAuthError
QK_ERR_AUTH_026SessionNotFoundErrorRaised when a session cannot be found in the store.packages/quadkit-auth/src/quadkit/auth/exceptions.pyQuadkitNotFoundError, AuthError
QK_ERR_AUTH_027AccountVerificationErrorError during account verification operations.packages/quadkit-auth/src/quadkit/auth/authn/account_verification.pyException
QK_ERR_AUTH_028PasswordResetTokenErrorError during password reset token operations.packages/quadkit-auth/src/quadkit/auth/authn/password_reset.pyException
QK_ERR_SEC_012RateLimitExceededErrorRaised when a client has exceeded the configured rate limit. Carries retry_after (seconds) so…packages/quadkit-auth/src/quadkit/auth/web/middleware/throttle.pyException

quadkit-cache (12 codes)

Section titled “quadkit-cache (12 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_CACHE_004CacheErrorBase exception for cache errors.packages/quadkit-cache/src/quadkit/cache/exceptions.pyQuadkitError
QK_ERR_CACHE_005CacheBackendErrorRaised when the cache backend (Redis/Memcached) fails.packages/quadkit-cache/src/quadkit/cache/exceptions.pyCacheError
QK_ERR_CACHE_006CacheConnectionErrorRaised when the cache connection fails.packages/quadkit-cache/src/quadkit/cache/exceptions.pyCacheBackendError
QK_ERR_CACHE_007CacheTimeoutErrorRaised when a cache operation times out.packages/quadkit-cache/src/quadkit/cache/exceptions.pyCacheError
QK_ERR_CACHE_008CacheKeyErrorRaised when a cache key is invalid or for key-specific errors.packages/quadkit-cache/src/quadkit/cache/exceptions.pyCacheError
QK_ERR_CACHE_009CacheConfigurationErrorRaised when cache configuration is invalid.packages/quadkit-cache/src/quadkit/cache/exceptions.pyCacheError
QK_ERR_CACHE_010CacheStampedeErrorRaised when cache stampede protection fails.packages/quadkit-cache/src/quadkit/cache/exceptions.pyCacheError
QK_ERR_CACHE_011CacheInvalidationErrorRaised when cache invalidation fails.packages/quadkit-cache/src/quadkit/cache/exceptions.pyCacheError
QK_ERR_CACHE_012LockAcquisitionErrorRaised when a distributed lock cannot be acquired.packages/quadkit-cache/src/quadkit/cache/exceptions.pyCacheError
QK_ERR_CACHE_013CacheSerializationErrorRaised when serialization/deserialization fails.packages/quadkit-cache/src/quadkit/cache/exceptions.pySerializationError, CacheError
QK_ERR_CACHE_014CacheCapacityErrorRaised when the cache is at capacity.packages/quadkit-cache/src/quadkit/cache/exceptions.pyCacheError
QK_ERR_CACHE_015CacheSerializationErrorRaised when cache serialization or deserialization fails. This is a cache-specific subclass of th…packages/quadkit-cache/src/quadkit/cache/serialization/base.pySerializationError

quadkit-cli (3 codes)

Section titled “quadkit-cli (3 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_CLI_001CliErrorBase exception for quadkit-cli operations.packages/quadkit-cli/src/quadkit/cli/exceptions.pyQuadkitError
QK_ERR_CLI_002ConfigNotFoundErrorRaised when application.yaml configuration file is not found.packages/quadkit-cli/src/quadkit/cli/exceptions.pyCliError
QK_ERR_CLI_003ProviderNotInstalledErrorRaised when a required provider package is not installed.packages/quadkit-cli/src/quadkit/cli/exceptions.pyCliError

quadkit-events (20 codes)

Section titled “quadkit-events (20 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_EVT_004ConcurrencyErrorConcurrency/optimistic locking error. Raised when event version conflicts indicate concurrent mod…packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_005CommandExecutionErrorCommand execution error.packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_006QueryExecutionErrorQuery execution error.packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_007StreamNotFoundErrorRaised when stream is not found. Parameters mirror the helper used in tests: (stream_type, stream…packages/quadkit-events/src/quadkit/events/exceptions.pyDomainError
QK_ERR_EVT_008EventHandlerErrorRaised when event handling fails.packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_009AggregateNotFoundErrorRaised when aggregate is not found.packages/quadkit-events/src/quadkit/events/exceptions.pyNotFoundError
QK_ERR_EVT_010AdapterConnectionErrorRaised when adapter connection fails.packages/quadkit-events/src/quadkit/events/exceptions.pyInfrastructureError
QK_ERR_EVT_011EventLoadErrorRaised when event loading fails.packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_012EventPersistenceErrorRaised when event persistence fails.packages/quadkit-events/src/quadkit/events/exceptions.pyInfrastructureError, EventError
QK_ERR_EVT_013EventStoreErrorRaised for event store errors.packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_014EventStoreConnectionErrorRaised when event store connection fails.packages/quadkit-events/src/quadkit/events/exceptions.pyEventStoreError, AdapterConnectionError
QK_ERR_EVT_015ProjectionBuildErrorRaised when projection building fails.packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_016ProjectionRebuildErrorRaised when projection rebuilding fails (alias for collection stability).packages/quadkit-events/src/quadkit/events/exceptions.pyProjectionBuildError
QK_ERR_EVT_017ProjectionNotFoundErrorRaised when a projection is not found.packages/quadkit-events/src/quadkit/events/exceptions.pyNotFoundError
QK_ERR_EVT_018WebhookDeliveryErrorRaised when an outbound webhook delivery fails after all retry attempts. Carries the target url…packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_019SchemaErrorRaised for schema-related errors.packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_020SecurityErrorRaised for security-related errors.packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_021StreamingErrorRaised for streaming-related errors.packages/quadkit-events/src/quadkit/events/exceptions.pyEventError
QK_ERR_EVT_022SchemaIncompatibleErrorRaised when a schema is not compatible with previous version.packages/quadkit-events/src/quadkit/events/schema/models.pyEventError
QK_ERR_EVT_023SchemaNotFoundErrorRaised when a schema is not found.packages/quadkit-events/src/quadkit/events/schema/models.pyEventError

quadkit-http (8 codes)

Section titled “quadkit-http (8 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_HTTP_001HTTPClientErrorBase exception for all HTTP client errors.packages/quadkit-http/src/quadkit/http/exceptions.pyInfrastructureError
QK_ERR_HTTP_002HTTPConnectionErrorRaised when a connection to a remote host fails.packages/quadkit-http/src/quadkit/http/exceptions.pyHTTPClientError
QK_ERR_HTTP_003HTTPTimeoutErrorRaised when a connection or request times out.packages/quadkit-http/src/quadkit/http/exceptions.pyHTTPClientError
QK_ERR_HTTP_004HTTPInterceptorErrorRaised when a request/response interceptor fails.packages/quadkit-http/src/quadkit/http/exceptions.pyHTTPClientError
QK_ERR_HTTP_005HTTPCircuitOpenErrorRaised when the circuit breaker is open and requests are rejected.packages/quadkit-http/src/quadkit/http/exceptions.pyHTTPClientError
QK_ERR_HTTP_006HTTPRetryExhaustedErrorRaised when all retry attempts for a request have been exhausted.packages/quadkit-http/src/quadkit/http/exceptions.pyHTTPClientError
QK_ERR_HTTP_007HTTPStatusErrorRaised (or returned as an Err) when the server responds with 4xx/5xx. Callers using the Result-ba…packages/quadkit-http/src/quadkit/http/exceptions.pyHTTPClientError
QK_ERR_HTTP_008HTTPUnsafeURLErrorRaised when a request URL fails the SSRF safety gate.packages/quadkit-http/src/quadkit/http/exceptions.pyHTTPClientError

quadkit-monitor (8 codes)

Section titled “quadkit-monitor (8 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_MONITOR_001MonitorErrorBase exception for monitoring errors.packages/quadkit-monitor/src/quadkit/monitor/exceptions.pyQuadkitError
QK_ERR_MONITOR_002BackendNotAvailableErrorRaised when a required monitoring backend is not available.packages/quadkit-monitor/src/quadkit/monitor/exceptions.pyMonitorError
QK_ERR_MONITOR_003MetricNotFoundErrorRaised when a requested metric is not found.packages/quadkit-monitor/src/quadkit/monitor/exceptions.pyMonitorError
QK_ERR_MONITOR_004InvalidMetricErrorRaised when metric parameters are invalid.packages/quadkit-monitor/src/quadkit/monitor/exceptions.pyMonitorError
QK_ERR_MONITOR_005SpanErrorBase exception for span-related errors.packages/quadkit-monitor/src/quadkit/monitor/exceptions.pyMonitorError
QK_ERR_MONITOR_006SpanNotFoundErrorRaised when a requested span is not found.packages/quadkit-monitor/src/quadkit/monitor/exceptions.pySpanError
QK_ERR_MONITOR_007MonitorConfigurationErrorRaised when monitoring configuration is invalid.packages/quadkit-monitor/src/quadkit/monitor/exceptions.pyMonitorError, _ConfigurationError
QK_ERR_MONITOR_008PerformanceMonitorErrorBase exception for performance monitoring errors.packages/quadkit-monitor/src/quadkit/monitor/profiling/models.pyMonitorError

quadkit-notification (13 codes)

Section titled “quadkit-notification (13 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_NOTIF_003TwilioNotificationErrorTwilio SMS delivery failure.packages/quadkit-notification/src/quadkit/notification/exceptions.pyNotificationError
QK_ERR_NOTIF_004FCMNotificationErrorFCM push notification delivery failure.packages/quadkit-notification/src/quadkit/notification/exceptions.pyNotificationError
QK_ERR_NOTIF_005APNsNotificationErrorAPNs push notification delivery failure.packages/quadkit-notification/src/quadkit/notification/exceptions.pyNotificationError
QK_ERR_NOTIF_006SMTPMailerErrorSMTP-specific delivery failure (rejection, auth error, etc.).packages/quadkit-notification/src/quadkit/notification/exceptions.pyMailerError
QK_ERR_NOTIF_007SendGridMailerErrorSendGrid API delivery failure.packages/quadkit-notification/src/quadkit/notification/exceptions.pyMailerError
QK_ERR_NOTIF_008InboxErrorBase exception for all inbox submodule errors.packages/quadkit-notification/src/quadkit/notification/exceptions.pyDomainError
QK_ERR_NOTIF_009InboxMessageNotFoundErrorRaised when a requested inbox message does not exist.packages/quadkit-notification/src/quadkit/notification/exceptions.pyInboxError
QK_ERR_NOTIF_010InboxPermissionErrorRaised when a user attempts to access another user’s inbox messages.packages/quadkit-notification/src/quadkit/notification/exceptions.pyInboxError
QK_ERR_NOTIF_011WebPushNotificationErrorWeb Push notification delivery failure.packages/quadkit-notification/src/quadkit/notification/exceptions.pyNotificationError
QK_ERR_NOTIF_012WhatsAppNotificationErrorWhatsApp delivery failure via Twilio provider.packages/quadkit-notification/src/quadkit/notification/backends/sms/whatsapp.pyTwilioNotificationError
QK_ERR_NOTIF_013WhatsAppMetaNotificationErrorWhatsApp delivery failure via Meta provider.packages/quadkit-notification/src/quadkit/notification/backends/sms/whatsapp.pyTwilioNotificationError
QK_ERR_NOTIF_014SlackNotificationErrorSlack notification delivery failure.packages/quadkit-notification/src/quadkit/notification/backends/slack/slack_notifier.pyNotificationError
QK_ERR_NOTIF_015PermanentDeliveryFailureRaised when a message has exhausted all delivery retries. Args: delivery_id: The delivery record …packages/quadkit-notification/src/quadkit/notification/delivery/exceptions.pyNotificationError

quadkit-sql (38 codes)

Section titled “quadkit-sql (38 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_SQL_001DatabaseConnectionErrorBase for all connection-related failures. Attributes: host: The database host that was targeted. …packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_002ConnectionRefusedErrorServer actively refused the connection.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseConnectionError
QK_ERR_SQL_003ConnectionTimeoutErrorConnection attempt timed out.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseConnectionError
QK_ERR_SQL_004ConnectionPoolErrorConnection pool exhausted — no connections available within timeout.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseConnectionError
QK_ERR_SQL_005QueryErrorBase for query execution failures. Attributes: sql: The SQL query that failed. params: The parame…packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_006QuerySyntaxErrorThe SQL query has a syntax error.packages/quadkit-sql/src/quadkit/sql/exceptions.pyQueryError
QK_ERR_SQL_007ParameterBindingErrorFailed to bind parameters to a query.packages/quadkit-sql/src/quadkit/sql/exceptions.pyQueryError
QK_ERR_SQL_008IntegrityErrorBase for constraint violation errors. Attributes: constraint: The constraint name that was violat…packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_009DuplicateKeyErrorUnique constraint or primary key violated.packages/quadkit-sql/src/quadkit/sql/exceptions.pyIntegrityError
QK_ERR_SQL_010ForeignKeyErrorForeign key constraint violated.packages/quadkit-sql/src/quadkit/sql/exceptions.pyIntegrityError
QK_ERR_SQL_011NotNullViolationErrorNOT NULL constraint violated. Attributes: column: The column that triggered the violation.packages/quadkit-sql/src/quadkit/sql/exceptions.pyIntegrityError
QK_ERR_SQL_012CheckConstraintErrorCHECK constraint violated.packages/quadkit-sql/src/quadkit/sql/exceptions.pyIntegrityError
QK_ERR_SQL_013TransactionErrorBase for transaction-related failures.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_014SerializationErrorSerialization failure (optimistic concurrency conflict).packages/quadkit-sql/src/quadkit/sql/exceptions.pyTransactionError
QK_ERR_SQL_015OptimisticLockErrorRaised when an optimistic lock check fails on UPDATE. Indicates a concurrent modification was det…packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_016TransactionRollbackErrorTransaction was rolled back (not by the application).packages/quadkit-sql/src/quadkit/sql/exceptions.pyTransactionError
QK_ERR_SQL_017LockErrorRaised when a database lock cannot be acquired.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_018DeadlockErrorDatabase deadlock detected. Inherits from :class:TransactionError because deadlocks are resolve…packages/quadkit-sql/src/quadkit/sql/exceptions.pyTransactionError
QK_ERR_SQL_019SchemaErrorBase for schema-related errors.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_020TableNotFoundErrorReferenced table does not exist.packages/quadkit-sql/src/quadkit/sql/exceptions.pySchemaError
QK_ERR_SQL_021ColumnNotFoundErrorReferenced column does not exist.packages/quadkit-sql/src/quadkit/sql/exceptions.pySchemaError
QK_ERR_SQL_022DatabaseTimeoutErrorDatabase operation timed out.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_023RepositoryErrorRepositoryProtocol-level operation failure.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_024UnitOfWorkErrorRaised when unit of work operation fails.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_025DriverErrorWraps underlying database driver exceptions. Preserves the original exception as __cause__ an…packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError
QK_ERR_SQL_026DataErrorBase exception for data access layer failures.packages/quadkit-sql/src/quadkit/sql/exceptions.pyQuadkitError
QK_ERR_SQL_027DataQueryErrorRaised when a query cannot be built or compiled. Args: message: Explanation of the query error.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDataError
QK_ERR_SQL_028PaginationErrorRaised when pagination parameters are invalid. Args: message: Explanation of the pagination error.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDataError
QK_ERR_SQL_029EntityNotFoundErrorSignals that a required entity does not exist. RepositoryProtocol implementations that cannot fin…packages/quadkit-sql/src/quadkit/sql/exceptions.pyDataError
QK_ERR_SQL_030DataRepositoryErrorRaised when a repository operation fails unexpectedly. Args: message: Explanation of the reposito…packages/quadkit-sql/src/quadkit/sql/exceptions.pyDataError
QK_ERR_SQL_031CursorErrorRaised when a cursor cannot be encoded or decoded. Args: message: Explanation of the cursor error.packages/quadkit-sql/src/quadkit/sql/exceptions.pyDataError
QK_ERR_SQL_032MigrationDependencyErrorRaised when migration dependencies are not satisfied.packages/quadkit-sql/src/quadkit/sql/migrations/base.pyMigrationError
QK_ERR_SQL_033MigrationExecutionErrorRaised when migration execution fails.packages/quadkit-sql/src/quadkit/sql/migrations/base.pyMigrationError
QK_ERR_SQL_034MigrationNotFoundErrorRaised when a migration is not found.packages/quadkit-sql/src/quadkit/sql/migrations/base.pyMigrationError
QK_ERR_SQL_035MigrationValidationErrorRaised when migration validation fails.packages/quadkit-sql/src/quadkit/sql/migrations/base.pyMigrationError
QK_ERR_SQL_036ProtocolValidationErrorRaised when object doesn’t implement protocol.packages/quadkit-sql/src/quadkit/sql/validation/protocols.pyConfigurationError
QK_ERR_SQL_037MappingErrorException raised when entity mapping fails.packages/quadkit-sql/src/quadkit/sql/mappers/base.pyCoreMappingError
QK_ERR_SQL_038TenantScopingErrorRaised when a tenant-scoped operation runs without an active tenant. Mirrors :class:`~quadkit.sql…packages/quadkit-sql/src/quadkit/sql/exceptions.pyDatabaseError

quadkit-storage (6 codes)

Section titled “quadkit-storage (6 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_STORE_002StorageFileNotFoundErrorRaised when file is not found.packages/quadkit-storage/src/quadkit/storage/exceptions.pyDomainError
QK_ERR_STORE_004TransactionErrorRaised when a transaction operation fails.packages/quadkit-storage/src/quadkit/storage/exceptions.pyStorageError
QK_ERR_STORE_005QuotaExceededErrorRaised when a storage quota or size limit is exceeded.packages/quadkit-storage/src/quadkit/storage/exceptions.pyStorageError
QK_ERR_STORE_006InvalidPathErrorRaised when a path is invalid or attempts directory traversal.packages/quadkit-storage/src/quadkit/storage/exceptions.pyStorageError
QK_ERR_STORE_007StorageUnavailableErrorRaised when the storage backend is not reachable or unavailable.packages/quadkit-storage/src/quadkit/storage/exceptions.pyStorageError
QK_ERR_STORE_008ChecksumMismatchErrorRaised when a file’s checksum does not match the expected value.packages/quadkit-storage/src/quadkit/storage/exceptions.pyStorageError

quadkit-tasks (12 codes)

Section titled “quadkit-tasks (12 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_TASK_002QueueFullErrorThe queue has reached its maximum capacity and cannot accept new tasks. The caller should back of…packages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskQueueError
QK_ERR_TASK_003TaskErrorBase exception for all task-related errorspackages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskQueueError
QK_ERR_TASK_004TaskNotFoundErrorRaised when a task cannot be foundpackages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskError
QK_ERR_TASK_005TaskTimeoutErrorRaised when a task execution exceeds timeoutpackages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskError
QK_ERR_TASK_006TaskCancelledErrorRaised when a task is cancelledpackages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskError
QK_ERR_TASK_007TaskExecutionErrorRaised when a task execution failspackages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskError
QK_ERR_TASK_008TaskValidationErrorRaised when task parameters are invalidpackages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskError
QK_ERR_TASK_009DuplicateTaskErrorRaised when a duplicate task is detectedpackages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskError
QK_ERR_TASK_010TaskDependencyCycleErrorRaised at registration time when a dependency cycle is detected. The scheduler validates the depe…packages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskError
QK_ERR_TASK_011TaskRegistrationErrorRaised when a scheduled or handler task fails to register.packages/quadkit-tasks/src/quadkit/tasks/exceptions.pyQuadkitError
QK_ERR_TASK_012TaskLockHeldErrorRaised when an in-memory task lock is already held. Raised by the :func:distributed_lock contex…packages/quadkit-tasks/src/quadkit/tasks/exceptions.pyTaskError
QK_ERR_TASK_013WorkflowErrorRaised when a workflow execution fails unexpectedly.packages/quadkit-tasks/src/quadkit/tasks/workflows/core.pyException

quadkit-testing (12 codes)

Section titled “quadkit-testing (12 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_TEST_001TestingErrorBase exception for quadkit-testing operations.packages/quadkit-testing/src/quadkit/testing/exceptions.pyQuadkitError
QK_ERR_TEST_002TokenBudgetExceededErrorRaised when an AITestClient operation would exceed the configured token budget. Prevents runaway …packages/quadkit-testing/src/quadkit/testing/exceptions.pyTestingError
QK_ERR_TEST_003MemoryBackendErrorBase exception for all memory backend errors.packages/quadkit-testing/src/quadkit/testing/memory/exceptions.pyQuadkitError
QK_ERR_TEST_004CommandBusErrorRaised when a command bus operation fails.packages/quadkit-testing/src/quadkit/testing/memory/exceptions.pyEventError
QK_ERR_TEST_005CommandHandlerNotFoundErrorRaised when no handler is registered for a specific command type.packages/quadkit-testing/src/quadkit/testing/memory/exceptions.pyCommandBusError, HandlerNotFoundError
QK_ERR_TEST_006DuplicateHandlerErrorRaised when a handler is already registered for a command type.packages/quadkit-testing/src/quadkit/testing/memory/exceptions.pyCommandBusError, ContractDuplicateHandlerError
QK_ERR_TEST_007CommandErrorWraps a handler exception for Result-based command dispatch.packages/quadkit-testing/src/quadkit/testing/memory/exceptions.pyCommandBusError
QK_ERR_TEST_008QueryBusErrorRaised when a query bus operation fails.packages/quadkit-testing/src/quadkit/testing/memory/exceptions.pyEventError
QK_ERR_TEST_009QueryHandlerNotFoundErrorRaised when no handler is registered for a specific query type.packages/quadkit-testing/src/quadkit/testing/memory/exceptions.pyQueryBusError, HandlerNotFoundError
QK_ERR_TEST_010QueryDuplicateHandlerErrorRaised when a handler is already registered for a query type.packages/quadkit-testing/src/quadkit/testing/memory/exceptions.pyQueryBusError, ContractDuplicateHandlerError
QK_ERR_TEST_011ConfigurationErrorRaised when a require_stub module is loaded via configure() in test mode. This exception indicate…packages/quadkit-testing/src/quadkit/testing/lib/stubs.pyException
QK_ERR_TEST_012SnapshotMismatchErrorRaised when a value does not match the stored snapshot.packages/quadkit-testing/src/quadkit/testing/lib/snapshots.pyAssertionError

quadkit-web (12 codes)

Section titled “quadkit-web (12 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_WEB_003NotFoundError404 Not Found.packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_004BadRequestError400 Bad Request.packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_005UnauthorizedError401 Unauthorized.packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_006ForbiddenError403 Forbidden.packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_007MethodNotAllowedError405 Method Not Allowed.packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_008ConflictError409 Conflict.packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_009UnprocessableEntityError422 Unprocessable Entity.packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_010InternalServerError500 Internal Server Error.packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_011DependencyResolutionError500 Dependency Resolution Error.packages/quadkit-web/src/quadkit/web/exceptions.pyInternalServerError
QK_ERR_WEB_012RateLimitError429 Too Many Requests.packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_013TooManyConnectionsError503 Service Unavailable — connection limit reached. Raised when a streaming endpoint (e.g. SSE) h…packages/quadkit-web/src/quadkit/web/exceptions.pyHTTPError
QK_ERR_WEB_014HTTPErrorBase HTTP error, compatible with QuadkitError.packages/quadkit-web/src/quadkit/web/exceptions.pyQuadkitError

quadkit-workflow (18 codes)

Section titled “quadkit-workflow (18 codes)”
CodeClassDescriptionFileInherits From
QK_ERR_WF_003WorkflowErrorBase exception for workflow orchestration errors.packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyPipelineExecutionError
QK_ERR_WF_004WorkflowNotFoundErrorRaised when a workflow definition cannot be found.packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyWorkflowError
QK_ERR_WF_005WorkflowStateErrorRaised when a workflow is in an invalid state for the requested operation.packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyWorkflowError
QK_ERR_WF_006WorkflowStepErrorRaised when a workflow step fails to execute.packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyWorkflowError
QK_ERR_WF_007WorkflowTimeoutErrorRaised when a workflow or step exceeds its timeout.packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyWorkflowError
QK_ERR_WF_008WorkflowCompensationErrorRaised when workflow compensation/rollback fails.packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyWorkflowError
QK_ERR_WF_010WorkflowVersionMismatchErrorRaised when resuming a workflow instance with a mismatched definition version. Resuming an in-fli…packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyWorkflowError
QK_ERR_WF_011GraphExecutionErrorBase exception for graph workflow engine operations. Args: message: Human-readable error descript…packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyQuadkitError
QK_ERR_WF_012NodeExecutionErrorA graph node’s execute() method failed. Args: message: Human-readable error description. node: Na…packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyGraphExecutionError
QK_ERR_WF_013CycleDetectedErrorGraph engine exceeded max_iterations (likely cycle). Args: iterations: Number of iterations compl…packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyGraphExecutionError
QK_ERR_WF_014GraphTimeoutErrorGraph workflow execution exceeded total timeout. Args: timeout: The configured timeout value in s…packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyGraphExecutionError
QK_ERR_WF_015GraphValidationErrorGraph structure validation failed.packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyGraphExecutionError
QK_ERR_WF_016HumanInputRequiredErrorRaised by HumanNode to pause execution awaiting human input. Args: prompt: Text/question to displ…packages/quadkit-workflow/src/quadkit/workflow/exceptions.pyGraphExecutionError
QK_ERR_WF_017StateErrorRaised when an invalid state transition is attempted. Extends the contracts ConflictError (a …packages/quadkit-workflow/src/quadkit/workflow/state/exceptions.pyConflictError
QK_ERR_WF_018StateConcurrencyErrorRaised when optimistic version checks fail during a transition. Also a conflict (409): the write …packages/quadkit-workflow/src/quadkit/workflow/state/exceptions.pyStateError
QK_ERR_WF_020BulkOperationErrorBase exception for bulk operation errors.packages/quadkit-workflow/src/quadkit/workflow/bulk/models.pyQuadkitError
QK_ERR_WF_021BulkOperationTimeoutErrorRaised when a bulk operation times out.packages/quadkit-workflow/src/quadkit/workflow/bulk/models.pyBulkOperationError
QK_ERR_WF_022BulkOperationCancelledErrorRaised when a bulk operation is cancelled.packages/quadkit-workflow/src/quadkit/workflow/bulk/models.pyBulkOperationError

3. Code Gaps by Domain

Section titled “3. Code Gaps by Domain”
  • AI: missing codes 005
  • CORE: missing codes 003, 004
  • GOV: missing codes 004, 005, 006, 007, 008, 009
  • RESULT: missing codes 001
  • SEC: missing codes 007

4. Exception Classes Without _code

Section titled “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: 16 classes across 7 packages

quadkit-contracts (7 classes)

Section titled “quadkit-contracts (7 classes)”
ClassInherits FromFile
ContributorDependencyErrorValueErrorcore/quadkit-contracts/src/quadkit/contracts/admin/dependencies.py
HealthCheckNotFoundError—core/quadkit-contracts/src/quadkit/contracts/admin/errors.py
RelayAuthError—core/quadkit-contracts/src/quadkit/contracts/ai/relay/auth.py
RelayBillingError—core/quadkit-contracts/src/quadkit/contracts/ai/governance/relay_billing.py
RelayGatewayErrorExceptioncore/quadkit-contracts/src/quadkit/contracts/ai/relay/gateway.py
RelayLedgerError—core/quadkit-contracts/src/quadkit/contracts/ai/relay/ledger.py
WidgetNotFoundError—core/quadkit-contracts/src/quadkit/contracts/admin/errors.py

quadkit-ai-llm (1 classes)

Section titled “quadkit-ai-llm (1 classes)”
ClassInherits FromFile
InferenceErrorDomainModelpackages/quadkit-ai-llm/src/quadkit/ai/llm/routing/types.py

quadkit-auth (2 classes)

Section titled “quadkit-auth (2 classes)”
ClassInherits FromFile
AttestationErrorValueErrorpackages/quadkit-auth/src/quadkit/auth/authn/passkey_attestation.py
LDAPExceptionExceptionpackages/quadkit-auth/src/quadkit/auth/authn/_ldap_directory.py

quadkit-cli (1 classes)

Section titled “quadkit-cli (1 classes)”
ClassInherits FromFile
LoadError—packages/quadkit-cli/src/quadkit/cli/contributors/runtime.py

quadkit-sql (1 classes)

Section titled “quadkit-sql (1 classes)”
ClassInherits FromFile
NoSecurityPolicyErrorExceptionpackages/quadkit-sql/src/quadkit/sql/row_level_security.py

quadkit-web (2 classes)

Section titled “quadkit-web (2 classes)”
ClassInherits FromFile
FileValidationError—packages/quadkit-web/src/quadkit/web/uploads/pipeline.py
RoomError—packages/quadkit-web/src/quadkit/web/websocket/rooms.py

quadkit-workflow (2 classes)

Section titled “quadkit-workflow (2 classes)”
ClassInherits FromFile
BulkItemError—packages/quadkit-workflow/src/quadkit/workflow/bulk/models.py
StateVersionConflictErrorRuntimeErrorpackages/quadkit-workflow/src/quadkit/workflow/state/exceptions.py

5. Duplicate Codes

Section titled “5. Duplicate Codes”

✅ No duplicate codes detected. Every QK_ERR_* code is unique.

6. Packages Without Registered Codes

Section titled “6. Packages Without Registered Codes”

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

Total: 1 packages

  • quadkit-ai-mcp

7. Suspicious Exception Classes (Potential Leftovers)

Section titled “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.

ClassFilePackage
WidgetNotFoundErrorcore/quadkit-contracts/src/quadkit/contracts/admin/errors.pyquadkit-contracts

8. Full Index by Domain

Section titled “8. Full Index by Domain”

Complete alphabetical listing of all codes grouped by domain tag.

ADMIN (1 codes)

Section titled “ADMIN (1 codes)”
CodeClassDescriptionPackage
QK_ERR_ADMIN_001AdminErrorBase exception for all admin-domain errors. Extended by leaf exceptions in qu…quadkit-contracts

AGT (13 codes)

Section titled “AGT (13 codes)”
CodeClassDescriptionPackage
QK_ERR_AGT_001AgentErrorBase exception for all agent errors.quadkit-contracts
QK_ERR_AGT_002ToolErrorBase exception for tool errors.quadkit-contracts
QK_ERR_AGT_003StrategyErrorReasoning strategy failed. Raised when the agent’s strategy encounters an err…quadkit-contracts
QK_ERR_AGT_004AgentConfigurationErrorInvalid agent configuration. Raised when an agent is constructed with invalid…quadkit-ai-agents
QK_ERR_AGT_005AgentExecutionErrorAgent execution failed. Raised when the agent’s reasoning loop encounters an …quadkit-ai-agents
QK_ERR_AGT_006ToolNotFoundErrorTool not found in registry. Raised when the agent tries to call a tool that i…quadkit-ai-agents
QK_ERR_AGT_007ToolExecutionErrorTool execution failed. Raised when a tool raises an exception during execution.quadkit-ai-agents
QK_ERR_AGT_008ToolAccessDeniedErrorAgent does not have access to this tool. Raised when module visibility contro…quadkit-ai-agents
QK_ERR_AGT_009MaxIterationsExceededErrorAgent exceeded maximum reasoning iterations. Raised when the agent reaches ma…quadkit-ai-agents
QK_ERR_AGT_010BudgetExceededErrorAgent exceeded its AI governance budget. Raised when token usage or cost exce…quadkit-ai-agents
QK_ERR_AGT_011ToolValidationErrorTool input validation failed. Raised when the arguments provided to a tool fa…quadkit-ai-agents
QK_ERR_AGT_012ToolObservationBlockedErrorA guard blocked tool output from entering the model context.quadkit-ai-agents
QK_ERR_AGT_013ToolObservationGuardErrorThe guard pipeline failed while checking tool output.quadkit-ai-agents

AI (6 codes)

Section titled “AI (6 codes)”
CodeClassDescriptionPackage
QK_ERR_AI_001AIErrorBase exception for all AI-domain errors. This is the catch-all for AI operati…quadkit-contracts
QK_ERR_AI_002ExtractionErrorBase for structured extraction errors. Used in “StructuredExtractorProtocol…quadkit-contracts
QK_ERR_AI_003MetricsCollectionErrorError raised during metrics collection.quadkit-contracts
QK_ERR_AI_004TracingErrorError raised during tracing operations.quadkit-contracts
QK_ERR_AI_006RelayErrorBase for relay conversion and gateway errors. Extended in quadkit-ai-llm with…quadkit-contracts
QK_ERR_AI_007MonitoringErrorBase error raised during AI observability monitoring.quadkit-contracts

APP (3 codes)

Section titled “APP (3 codes)”
CodeClassDescriptionPackage
QK_ERR_APP_001AppErrorBase exception for all app errors.quadkit
QK_ERR_APP_002AppStartupErrorRaised when the application fails to start or a provider fails during boot.quadkit
QK_ERR_APP_003AppShutdownErrorRaised when the application cannot complete a graceful shutdown.quadkit

AUTH (28 codes)

Section titled “AUTH (28 codes)”
CodeClassDescriptionPackage
QK_ERR_AUTH_001AuthErrorBase exception for all auth-domain errors. This is the catch-all for authenti…quadkit-contracts
QK_ERR_AUTH_002TokenErrorBase class for expected, recoverable token domain failures. All subtypes indi…quadkit-contracts
QK_ERR_AUTH_003VerificationErrorBase class for expected, recoverable account-verification failures. All subty…quadkit-contracts
QK_ERR_AUTH_004AuthErrorBase exception for all auth errors.quadkit-auth
QK_ERR_AUTH_005AuthenticationErrorRaised when authentication fails.quadkit-auth
QK_ERR_AUTH_006AuthorizationErrorRaised when user lacks required permissions.quadkit-auth
QK_ERR_AUTH_007InvalidCredentialsErrorRaised when credentials are invalid.quadkit-auth
QK_ERR_AUTH_008AccountLockedErrorRaised when an account is locked due to too many failed login attempts. Accou…quadkit-auth
QK_ERR_AUTH_009UserNotFoundErrorRaised when user is not found.quadkit-auth
QK_ERR_AUTH_010TokenErrorBase exception for token-related errors.quadkit-auth
QK_ERR_AUTH_011InvalidTokenErrorRaised when a token is malformed or invalid.quadkit-auth
QK_ERR_AUTH_012TokenExpiredErrorRaised when a token has expired.quadkit-auth
QK_ERR_AUTH_013TokenBlacklistedErrorToken has been explicitly revoked.quadkit-auth
QK_ERR_AUTH_014TokenInvalidErrorToken is structurally invalid or has wrong type.quadkit-auth
QK_ERR_AUTH_015TokenAudienceErrorToken audience claim does not match expected.quadkit-auth
QK_ERR_AUTH_016TokenNotFoundErrorToken record does not exist.quadkit-auth
QK_ERR_AUTH_017InvalidAudienceErrorRaised when a token audience is invalid.quadkit-auth
QK_ERR_AUTH_018InvalidScopeErrorRaised when a token lacks required scope.quadkit-auth
QK_ERR_AUTH_019BlacklistedTokenErrorRaised when a token has been blacklisted.quadkit-auth
QK_ERR_AUTH_020TokenExpiredVerificationErrorAccount verification has expired.quadkit-auth
QK_ERR_AUTH_021AlreadyVerifiedErrorAccount is already verified.quadkit-auth
QK_ERR_AUTH_022EmailExistsErrorRaised when email is already taken.quadkit-auth
QK_ERR_AUTH_023UsernameExistsErrorRaised when username is already taken.quadkit-auth
QK_ERR_AUTH_024PasswordPolicyErrorRaised when password doesn’t meet requirements.quadkit-auth
QK_ERR_AUTH_025OAuth2ErrorBase exception for OAuth2 errors.quadkit-auth
QK_ERR_AUTH_026SessionNotFoundErrorRaised when a session cannot be found in the store.quadkit-auth
QK_ERR_AUTH_027AccountVerificationErrorError during account verification operations.quadkit-auth
QK_ERR_AUTH_028PasswordResetTokenErrorError during password reset token operations.quadkit-auth

CACHE (15 codes)

Section titled “CACHE (15 codes)”
CodeClassDescriptionPackage
QK_ERR_CACHE_001CacheErrorBase exception for all cache-domain errors. This is an expected, recoverable …quadkit-contracts
QK_ERR_CACHE_002CacheKeyNotFoundErrorRaised when cache key is not found.quadkit-contracts
QK_ERR_CACHE_003CacheWriteErrorRaised when cache write fails.quadkit-contracts
QK_ERR_CACHE_004CacheErrorBase exception for cache errors.quadkit-cache
QK_ERR_CACHE_005CacheBackendErrorRaised when the cache backend (Redis/Memcached) fails.quadkit-cache
QK_ERR_CACHE_006CacheConnectionErrorRaised when the cache connection fails.quadkit-cache
QK_ERR_CACHE_007CacheTimeoutErrorRaised when a cache operation times out.quadkit-cache
QK_ERR_CACHE_008CacheKeyErrorRaised when a cache key is invalid or for key-specific errors.quadkit-cache
QK_ERR_CACHE_009CacheConfigurationErrorRaised when cache configuration is invalid.quadkit-cache
QK_ERR_CACHE_010CacheStampedeErrorRaised when cache stampede protection fails.quadkit-cache
QK_ERR_CACHE_011CacheInvalidationErrorRaised when cache invalidation fails.quadkit-cache
QK_ERR_CACHE_012LockAcquisitionErrorRaised when a distributed lock cannot be acquired.quadkit-cache
QK_ERR_CACHE_013CacheSerializationErrorRaised when serialization/deserialization fails.quadkit-cache
QK_ERR_CACHE_014CacheCapacityErrorRaised when the cache is at capacity.quadkit-cache
QK_ERR_CACHE_015CacheSerializationErrorRaised when cache serialization or deserialization fails. This is a cache-spe…quadkit-cache

CFG (6 codes)

Section titled “CFG (6 codes)”
CodeClassDescriptionPackage
QK_ERR_CFG_001ConfigurationErrorDeveloper configuration or runtime misconfiguration errors. Supports optional…quadkit-contracts
QK_ERR_CFG_002ConfigurationErrorConfiguration loading, parsing, or validation failed. Raised by: - “ConfigPr…quadkit
QK_ERR_CFG_003ConfigSourceErrorRaised when a configuration source fails to load its values.quadkit
QK_ERR_CFG_004ConfigReloadErrorRaised when a live-reload attempt fails.quadkit
QK_ERR_CFG_005ConfigSectionNotFoundErrorRaised when a required config section is absent from the loaded config.quadkit
QK_ERR_CFG_006UnknownConfigKeysErrorRaised when a typed config section contains keys its model does not define. A…quadkit

CLI (3 codes)

Section titled “CLI (3 codes)”
CodeClassDescriptionPackage
QK_ERR_CLI_001CliErrorBase exception for quadkit-cli operations.quadkit-cli
QK_ERR_CLI_002ConfigNotFoundErrorRaised when application.yaml configuration file is not found.quadkit-cli
QK_ERR_CLI_003ProviderNotInstalledErrorRaised when a required provider package is not installed.quadkit-cli

CODEGEN (1 codes)

Section titled “CODEGEN (1 codes)”
CodeClassDescriptionPackage
QK_ERR_CODEGEN_001CollidingFileErrorA generated file collides with an existing file under a FAIL policy.quadkit-contracts

CONC (8 codes)

Section titled “CONC (8 codes)”
CodeClassDescriptionPackage
QK_ERR_CONC_001ConcurrencyErrorBase exception for all concurrency errors.quadkit
QK_ERR_CONC_002AsyncErrorException raised for errors in asynchronous operations or concurrency control.quadkit
QK_ERR_CONC_003ChannelClosedErrorRaised when an operation is attempted on a closed channel.quadkit
QK_ERR_CONC_004ChannelFullErrorRaised when sending to a channel that is at capacity.quadkit
QK_ERR_CONC_005DispatcherErrorError in dispatcher execution.quadkit
QK_ERR_CONC_006StructuredParallelismErrorBase exception for parallel execution errors.quadkit
QK_ERR_CONC_007TaskGroupErrorRaised when a task group encounters an error.quadkit
QK_ERR_CONC_008CancellationScopeErrorRaised when a cancellation scope encounters an error.quadkit

CORE (5 codes)

Section titled “CORE (5 codes)”
CodeClassDescriptionPackage
QK_ERR_CORE_001QuadkitErrorRoot exception for the entire Quadkit ecosystem. All Quadkit exceptions inher…quadkit-contracts
QK_ERR_CORE_002QuadkitExceptionBase exception for all quadkit domain errors. Extends :class:`~quadkit.contra…quadkit
QK_ERR_CORE_005CoreErrorBase exception for all core errors.quadkit
QK_ERR_CORE_006ReactiveErrorBase exception for the reactive stream layer.quadkit
QK_ERR_CORE_007BackpressureErrorRaised when a subscriber channel overflows under a non-blocking policy.quadkit

DB (11 codes)

Section titled “DB (11 codes)”
CodeClassDescriptionPackage
QK_ERR_DB_001DatabaseErrorDatabase-related error (infrastructure-level).quadkit-contracts
QK_ERR_DB_002MigrationErrorDatabase migration error.quadkit-contracts
QK_ERR_DB_003IntegrityErrorRaised when a database integrity constraint is violated.quadkit-contracts
QK_ERR_DB_004ConstraintErrorRaised when a generic database constraint is violated.quadkit-contracts
QK_ERR_DB_005DuplicateKeyErrorRaised when a unique-key constraint is violated (duplicate record).quadkit-contracts
QK_ERR_DB_006UnitOfWorkErrorRaised when a unit-of-work operation fails or is used incorrectly.quadkit-contracts
QK_ERR_DB_007DataErrorBase exception for all data-domain errors. This is an expected, recoverable e…quadkit-contracts
QK_ERR_DB_008DataNotFoundErrorRaised when data item is not found.quadkit-contracts
QK_ERR_DB_009DataValidationErrorRaised when data validation fails.quadkit-contracts
QK_ERR_DB_010InvalidIdentifierErrorRaised when an SQL identifier fails validation. Attributes: identifier: The o…quadkit-contracts
QK_ERR_DB_011NoPrimaryBackendErrorRaised when a multi-backend setup has no backend marked as primary. For multi…quadkit-contracts

DI (11 codes)

Section titled “DI (11 codes)”
CodeClassDescriptionPackage
QK_ERR_DI_001ContainerErrorBase container error.quadkit-contracts
QK_ERR_DI_002DependencyErrorDependency resolution error.quadkit-contracts
QK_ERR_DI_003CircularDependencyErrorCircular dependency detected.quadkit-contracts
QK_ERR_DI_004UnresolvableDependencyErrorCannot resolve dependency.quadkit-contracts
QK_ERR_DI_005RegistrationErrorService registration error.quadkit-contracts
QK_ERR_DI_006ContainerBuildErrorContainer build/configuration error.quadkit-contracts
QK_ERR_DI_007ProtocolValidationErrorProtocol validation error.quadkit-contracts
QK_ERR_DI_008ContainerValidationErrorContainer dependency graph validation failed before boot. Raised when “Conta…quadkit-contracts
QK_ERR_DI_009ScopedResolutionErrorAttempted to resolve a scoped service outside of an active scope. Raised when…quadkit-contracts
QK_ERR_DI_010InjectionErrorDependency injection or container resolution failed. Raised by: - “Container…quadkit
QK_ERR_DI_011InterceptorTimeoutErrorRaised when a MethodInterceptorProtocol exceeds its configured timeout.quadkit

DOM (9 codes)

Section titled “DOM (9 codes)”
CodeClassDescriptionPackage
QK_ERR_DOM_001DomainErrorBusiness/domain-level errors (validation failures, not found, auth).quadkit-contracts
QK_ERR_DOM_002NotFoundErrorResource not found error (domain-level).quadkit-contracts
QK_ERR_DOM_003PermissionDeniedErrorPermission denied error (domain-level).quadkit-contracts
QK_ERR_DOM_004AuthenticationErrorAuthentication error (domain-level).quadkit-contracts
QK_ERR_DOM_005AuthorizationErrorAuthorization/permission error (domain-level).quadkit-contracts
QK_ERR_DOM_006RateLimitErrorRate limiting error.quadkit-contracts
QK_ERR_DOM_007ConflictErrorResource conflict error.quadkit-contracts
QK_ERR_DOM_008DomainModelErrorDomain model invariant violated or business rule broken. Raised by: - Domain …quadkit
QK_ERR_DOM_009DomainPolicyViolationErrorRaised when a domain policy evaluation fails. Distinct from “PolicyViolation…quadkit

EVAL (1 codes)

Section titled “EVAL (1 codes)”
CodeClassDescriptionPackage
QK_ERR_EVAL_001EvaluationErrorBase for evaluation system errors. Extended in the AI evaluation layer with s…quadkit-contracts

EVT (23 codes)

Section titled “EVT (23 codes)”
CodeClassDescriptionPackage
QK_ERR_EVT_001EventErrorBase events/messaging error.quadkit-contracts
QK_ERR_EVT_002HandlerNotFoundErrorEvent/command handler not found. Raised when no handler is registered for a s…quadkit-contracts
QK_ERR_EVT_003DuplicateHandlerErrorDuplicate handler registration. Raised when attempting to register a handler …quadkit-contracts
QK_ERR_EVT_004ConcurrencyErrorConcurrency/optimistic locking error. Raised when event version conflicts ind…quadkit-events
QK_ERR_EVT_005CommandExecutionErrorCommand execution error.quadkit-events
QK_ERR_EVT_006QueryExecutionErrorQuery execution error.quadkit-events
QK_ERR_EVT_007StreamNotFoundErrorRaised when stream is not found. Parameters mirror the helper used in tests: …quadkit-events
QK_ERR_EVT_008EventHandlerErrorRaised when event handling fails.quadkit-events
QK_ERR_EVT_009AggregateNotFoundErrorRaised when aggregate is not found.quadkit-events
QK_ERR_EVT_010AdapterConnectionErrorRaised when adapter connection fails.quadkit-events
QK_ERR_EVT_011EventLoadErrorRaised when event loading fails.quadkit-events
QK_ERR_EVT_012EventPersistenceErrorRaised when event persistence fails.quadkit-events
QK_ERR_EVT_013EventStoreErrorRaised for event store errors.quadkit-events
QK_ERR_EVT_014EventStoreConnectionErrorRaised when event store connection fails.quadkit-events
QK_ERR_EVT_015ProjectionBuildErrorRaised when projection building fails.quadkit-events
QK_ERR_EVT_016ProjectionRebuildErrorRaised when projection rebuilding fails (alias for collection stability).quadkit-events
QK_ERR_EVT_017ProjectionNotFoundErrorRaised when a projection is not found.quadkit-events
QK_ERR_EVT_018WebhookDeliveryErrorRaised when an outbound webhook delivery fails after all retry attempts. Carr…quadkit-events
QK_ERR_EVT_019SchemaErrorRaised for schema-related errors.quadkit-events
QK_ERR_EVT_020SecurityErrorRaised for security-related errors.quadkit-events
QK_ERR_EVT_021StreamingErrorRaised for streaming-related errors.quadkit-events
QK_ERR_EVT_022SchemaIncompatibleErrorRaised when a schema is not compatible with previous version.quadkit-events
QK_ERR_EVT_023SchemaNotFoundErrorRaised when a schema is not found.quadkit-events

FEAT (1 codes)

Section titled “FEAT (1 codes)”
CodeClassDescriptionPackage
QK_ERR_FEAT_001FeatureFlagErrorBase error for the feature flag subsystem.quadkit-contracts

GOV (4 codes)

Section titled “GOV (4 codes)”
CodeClassDescriptionPackage
QK_ERR_GOV_001GovernanceErrorBase class for governance-related errors.quadkit-contracts
QK_ERR_GOV_002BudgetExceededErrorError raised when budget is exceeded.quadkit-contracts
QK_ERR_GOV_003PolicyViolationErrorError raised when policy is violated.quadkit-contracts
QK_ERR_GOV_010ResourceExhaustedErrorRaised when a resource quota is exhausted.quadkit-contracts

GUARD (3 codes)

Section titled “GUARD (3 codes)”
CodeClassDescriptionPackage
QK_ERR_GUARD_001GuardErrorBase for AI guard/policy enforcement errors. Extended in the AI guard layer w…quadkit-contracts
QK_ERR_GUARD_002InputGuardErrorError raised during input guard validation.quadkit-contracts
QK_ERR_GUARD_003OutputGuardErrorError raised during output guard validation.quadkit-contracts

HTTP (8 codes)

Section titled “HTTP (8 codes)”
CodeClassDescriptionPackage
QK_ERR_HTTP_001HTTPClientErrorBase exception for all HTTP client errors.quadkit-http
QK_ERR_HTTP_002HTTPConnectionErrorRaised when a connection to a remote host fails.quadkit-http
QK_ERR_HTTP_003HTTPTimeoutErrorRaised when a connection or request times out.quadkit-http
QK_ERR_HTTP_004HTTPInterceptorErrorRaised when a request/response interceptor fails.quadkit-http
QK_ERR_HTTP_005HTTPCircuitOpenErrorRaised when the circuit breaker is open and requests are rejected.quadkit-http
QK_ERR_HTTP_006HTTPRetryExhaustedErrorRaised when all retry attempts for a request have been exhausted.quadkit-http
QK_ERR_HTTP_007HTTPStatusErrorRaised (or returned as an Err) when the server responds with 4xx/5xx. Callers…quadkit-http
QK_ERR_HTTP_008HTTPUnsafeURLErrorRaised when a request URL fails the SSRF safety gate.quadkit-http

IDEM (4 codes)

Section titled “IDEM (4 codes)”
CodeClassDescriptionPackage
QK_ERR_IDEM_001IdempotencyErrorBase exception for idempotency flows.quadkit-contracts
QK_ERR_IDEM_002DuplicateRequestErrorRaised when an idempotent key is reused before completion.quadkit-contracts
QK_ERR_IDEM_003IdempotencyStoreErrorRaised on unexpected failures inside the idempotency store.quadkit-contracts
QK_ERR_IDEM_004IdempotencyConflictErrorRaised when an idempotency key is already claimed (PENDING).quadkit-contracts

IDX (1 codes)

Section titled “IDX (1 codes)”
CodeClassDescriptionPackage
QK_ERR_IDX_001RAGIndexErrorRaised when index operations fail in an expected, recoverable way.quadkit-contracts

INFRA (12 codes)

Section titled “INFRA (12 codes)”
CodeClassDescriptionPackage
QK_ERR_INFRA_001InfrastructureErrorSystem-level failures (DB down, network timeouts).quadkit-contracts
QK_ERR_INFRA_002LockErrorDistributed lock error.quadkit-contracts
QK_ERR_INFRA_003LockConflictErrorRaised when a lock conflict occurs (resource already locked).quadkit-contracts
QK_ERR_INFRA_004ComponentErrorBase exception for all component-related errors.quadkit-contracts
QK_ERR_INFRA_005ComponentConnectionErrorRaised when a connection to an external service fails.quadkit-contracts
QK_ERR_INFRA_006KeyNotFoundErrorRaised when a requested key does not exist.quadkit-contracts
QK_ERR_INFRA_007KeyExistsErrorRaised when trying to create a key that already exists.quadkit-contracts
QK_ERR_INFRA_008PubSubErrorBase exception for pub/sub operations.quadkit-contracts
QK_ERR_INFRA_009SecretNotFoundErrorRaised when a requested secret does not exist.quadkit-contracts
QK_ERR_INFRA_010DriverNotAvailableErrorRaised when a driver is not available (dependency not installed).quadkit-contracts
QK_ERR_INFRA_011_StoredStreamErrorInternal carrier for propagating typed stream failures.quadkit-contracts
QK_ERR_INFRA_012PluginStateErrorRaised when plugin enable/disable state cannot be persisted or read. The admi…quadkit

LLM (29 codes)

Section titled “LLM (29 codes)”
CodeClassDescriptionPackage
QK_ERR_LLM_001LLMErrorBase for LLM client errors. Extended in quadkit-ai-llm with specific failures…quadkit-contracts
QK_ERR_LLM_002LLMErrorBase exception for all LLM-domain errors in quadkit-ai-llm.quadkit-ai-llm
QK_ERR_LLM_003LLMAuthenticationErrorInvalid API key or credentials — infrastructure error, raised not wrapped. Ra…quadkit-ai-llm
QK_ERR_LLM_004InvalidRequestErrorError raised when a request to an LLM provider is invalid.quadkit-ai-llm
QK_ERR_LLM_005ModelNotFoundErrorModel unavailable or not found — recoverable via fallback routing.quadkit-ai-llm
QK_ERR_LLM_006LLMModelNotFoundErrorModel unavailable or not found — recoverable via fallback routing. Returned a…quadkit-ai-llm
QK_ERR_LLM_007LLMRateLimitErrorRate limit exceeded — recoverable via backoff/retry. Returned as Err from…quadkit-ai-llm
QK_ERR_LLM_008LLMQuotaExceededErrorAPI quota or billing limit exceeded — recoverable by routing elsewhere. Retur…quadkit-ai-llm
QK_ERR_LLM_009LLMContentFilterErrorContent blocked by provider safety filter — recoverable via reformulation. Re…quadkit-ai-llm
QK_ERR_LLM_010TokenLimitErrorError raised when the token limit for a request is exceeded.quadkit-ai-llm
QK_ERR_LLM_011ProviderConnectionErrorError raised when connection to an LLM provider fails.quadkit-ai-llm
QK_ERR_LLM_012StreamErrorError raised during LLM response streaming.quadkit-ai-llm
QK_ERR_LLM_013ExtractionErrorBase class for structured extraction errors in quadkit-ai-llm.quadkit-ai-llm
QK_ERR_LLM_014ExtractionParseErrorError raised when extraction response cannot be parsed as JSON.quadkit-ai-llm
QK_ERR_LLM_015ExtractionValidationErrorError raised when parsed extraction response fails schema validation.quadkit-ai-llm
QK_ERR_LLM_016ExtractionMaxRetriesErrorError raised when extraction max retries are exhausted.quadkit-ai-llm
QK_ERR_LLM_017ModelRevisionMismatchErrorRaised when the provider returns a model revision that violates the pin policy.quadkit-ai-llm
QK_ERR_LLM_018LLMTimeoutErrorRequest exceeded the client timeout — recoverable by routing elsewhere. Retur…quadkit-ai-llm
QK_ERR_LLM_019SchemaValidationErrorRaised when parsed response fails validation.quadkit-ai-llm
QK_ERR_LLM_020ModelManagerErrorBase exception for model manager errors.quadkit-ai-llm
QK_ERR_LLM_021ModelNotFoundErrorRaised when a requested model is not found.quadkit-ai-llm
QK_ERR_LLM_022ModelLoadErrorRaised when a model fails to load.quadkit-ai-llm
QK_ERR_LLM_023ModelUnloadErrorRaised when a model fails to unload.quadkit-ai-llm
QK_ERR_LLM_024ProviderConnectionErrorRaised when connection to provider fails.quadkit-ai-llm
QK_ERR_LLM_025OrchestratorErrorBase orchestration error.quadkit-ai-llm
QK_ERR_LLM_026NoSuitableModelErrorNo model found that meets the requirements.quadkit-ai-llm
QK_ERR_LLM_027StructuredOutputErrorBase exception for structured output errors.quadkit-ai-llm
QK_ERR_LLM_028ParseErrorRaised when response cannot be parsed.quadkit-ai-llm
QK_ERR_LLM_029EmbeddingErrorRaised when embedding generation fails. Covers missing credentials, provider …quadkit-ai-llm

LOAD (1 codes)

Section titled “LOAD (1 codes)”
CodeClassDescriptionPackage
QK_ERR_LOAD_001LoaderErrorRaised when document loading fails in an expected, recoverable way. Extended …quadkit-contracts

LOCK (3 codes)

Section titled “LOCK (3 codes)”
CodeClassDescriptionPackage
QK_ERR_LOCK_001LockAcquisitionErrorRaised when acquiring a lock fails.quadkit-contracts
QK_ERR_LOCK_002LockNotHeldErrorRaised when trying to operate on a lock that is not held.quadkit-contracts
QK_ERR_LOCK_003LockOwnershipErrorRaised when trying to release or extend a lock held by another owner.quadkit-contracts

MAP (4 codes)

Section titled “MAP (4 codes)”
CodeClassDescriptionPackage
QK_ERR_MAP_001MappingErrorObject mapping error.quadkit-contracts
QK_ERR_MAP_002MappingErrorBase exception for all object-mapping errors.quadkit
QK_ERR_MAP_003MappingNotFoundErrorRaised when no mapper is registered for a (source, destination) type pair.quadkit
QK_ERR_MAP_004MappingExecutionErrorRaised when a registered mapper raises an unexpected error during execution.quadkit

MCP (8 codes)

Section titled “MCP (8 codes)”
CodeClassDescriptionPackage
QK_ERR_MCP_001MCPErrorBase exception for all MCP errors.quadkit-contracts
QK_ERR_MCP_002MCPTransportErrorTransport-level error (connection, I/O). Raised when the MCP transport layer …quadkit-contracts
QK_ERR_MCP_003MCPToolCallErrorTool call failed during MCP execution. Raised when a tool invocation fails, e…quadkit-contracts
QK_ERR_MCP_004MCPResourceErrorResource read or list failed. Raised when a resource operation fails, such as…quadkit-contracts
QK_ERR_MCP_005MCPProtocolErrorProtocol violation (malformed message, invalid state). Raised when an MCP mes…quadkit-contracts
QK_ERR_MCP_006MCPMethodNotFoundErrorUnknown MCP method requested by client. Raised when the client requests an MC…quadkit-contracts
QK_ERR_MCP_007MCPPromptErrorPrompt retrieval or list failed. Raised when a prompt operation fails, such a…quadkit-contracts
QK_ERR_MCP_008MCPInitializationErrorMCP server initialization failed. Raised when the MCP server cannot be initia…quadkit-contracts

MEM (3 codes)

Section titled “MEM (3 codes)”
CodeClassDescriptionPackage
QK_ERR_MEM_001AIMemoryErrorBase for AI memory system errors. Extended in an AI memory extension with specific…quadkit-contracts
QK_ERR_MEM_002ConsolidationErrorError raised during memory consolidation.quadkit-contracts
QK_ERR_MEM_003StorageErrorError raised during memory storage operations.quadkit-contracts

MM (8 codes)

Section titled “MM (8 codes)”
CodeClassDescriptionPackage
QK_ERR_MM_001MultimediaErrorBase exception for all multimedia-generation errors. Mirrors “AIError(Domain…quadkit-contracts
QK_ERR_MM_002TTSErrorBase for text-to-speech generation errors.quadkit-contracts
QK_ERR_MM_003MusicGenerationErrorBase for music/sound generation errors.quadkit-contracts
QK_ERR_MM_004VideoGenerationErrorBase for video generation errors.quadkit-contracts
QK_ERR_MM_005ImageGenerationErrorBase for still-image generation errors.quadkit-contracts
QK_ERR_MM_006ProviderNotInstalledErrorRaised eagerly at DI-resolution time when a configured provider’s optional ex…quadkit-contracts
QK_ERR_MM_007UpscaleErrorBase for image/video super-resolution errors.quadkit-contracts
QK_ERR_MM_008BeatAnalysisErrorBase for tempo/beat-detection errors.quadkit-contracts

MOD (6 codes)

Section titled “MOD (6 codes)”
CodeClassDescriptionPackage
QK_ERR_MOD_001ModuleErrorModule configuration or lifecycle error.quadkit-contracts
QK_ERR_MOD_002ModuleImportErrorA module imports a module that does not exist in the graph. Raised during mod…quadkit-contracts
QK_ERR_MOD_003ModuleExportErrorA module exports a type not provided by its providers. Raised during post-reg…quadkit-contracts
QK_ERR_MOD_004ModuleCycleErrorCircular dependency detected in the module import graph. Raised during module…quadkit-contracts
QK_ERR_MOD_005ModuleVisibilityErrorA provider depends on a service not visible to its module. Raised when a prov…quadkit-contracts
QK_ERR_MOD_006ModuleDuplicateErrorThe same module appears twice with conflicting configurations. Raised when tw…quadkit-contracts

MONITOR (8 codes)

Section titled “MONITOR (8 codes)”
CodeClassDescriptionPackage
QK_ERR_MONITOR_001MonitorErrorBase exception for monitoring errors.quadkit-monitor
QK_ERR_MONITOR_002BackendNotAvailableErrorRaised when a required monitoring backend is not available.quadkit-monitor
QK_ERR_MONITOR_003MetricNotFoundErrorRaised when a requested metric is not found.quadkit-monitor
QK_ERR_MONITOR_004InvalidMetricErrorRaised when metric parameters are invalid.quadkit-monitor
QK_ERR_MONITOR_005SpanErrorBase exception for span-related errors.quadkit-monitor
QK_ERR_MONITOR_006SpanNotFoundErrorRaised when a requested span is not found.quadkit-monitor
QK_ERR_MONITOR_007MonitorConfigurationErrorRaised when monitoring configuration is invalid.quadkit-monitor
QK_ERR_MONITOR_008PerformanceMonitorErrorBase exception for performance monitoring errors.quadkit-monitor

MW (10 codes)

Section titled “MW (10 codes)”
CodeClassDescriptionPackage
QK_ERR_MW_001MiddlewareGuardErrorRaised when a middleware guard denies access.quadkit-contracts
QK_ERR_MW_002MiddlewareErrorBase exception for infrastructure-level middleware errors.quadkit
QK_ERR_MW_003MiddlewarePolicyErrorBase exception for policy-level middleware rejections. Raised when middleware…quadkit
QK_ERR_MW_004MiddlewareExecutionErrorRaised when a middleware raises an unexpected error during execution.quadkit
QK_ERR_MW_005MiddlewareConfigurationErrorRaised when middleware is configured incorrectly.quadkit
QK_ERR_MW_006MiddlewareChainErrorRaised when the middleware chain cannot be assembled or traversed.quadkit
QK_ERR_MW_007MiddlewareTimeoutErrorRaised when a middleware exceeds its configured timeout.quadkit
QK_ERR_MW_008MiddlewareAuthErrorRaised when middleware-level authentication/authorization fails.quadkit
QK_ERR_MW_009MiddlewareRateLimitErrorRaised when middleware-level rate limiting is exceeded.quadkit
QK_ERR_MW_010MiddlewareCircuitOpenErrorRaised when the circuit breaker in middleware is open.quadkit

NOTIF (15 codes)

Section titled “NOTIF (15 codes)”
CodeClassDescriptionPackage
QK_ERR_NOTIF_001NotificationErrorBase for expected, recoverable notification delivery failures. Attributes: ch…quadkit-contracts
QK_ERR_NOTIF_002MailerErrorBase mailer/email notification error.quadkit-contracts
QK_ERR_NOTIF_003TwilioNotificationErrorTwilio SMS delivery failure.quadkit-notification
QK_ERR_NOTIF_004FCMNotificationErrorFCM push notification delivery failure.quadkit-notification
QK_ERR_NOTIF_005APNsNotificationErrorAPNs push notification delivery failure.quadkit-notification
QK_ERR_NOTIF_006SMTPMailerErrorSMTP-specific delivery failure (rejection, auth error, etc.).quadkit-notification
QK_ERR_NOTIF_007SendGridMailerErrorSendGrid API delivery failure.quadkit-notification
QK_ERR_NOTIF_008InboxErrorBase exception for all inbox submodule errors.quadkit-notification
QK_ERR_NOTIF_009InboxMessageNotFoundErrorRaised when a requested inbox message does not exist.quadkit-notification
QK_ERR_NOTIF_010InboxPermissionErrorRaised when a user attempts to access another user’s inbox messages.quadkit-notification
QK_ERR_NOTIF_011WebPushNotificationErrorWeb Push notification delivery failure.quadkit-notification
QK_ERR_NOTIF_012WhatsAppNotificationErrorWhatsApp delivery failure via Twilio provider.quadkit-notification
QK_ERR_NOTIF_013WhatsAppMetaNotificationErrorWhatsApp delivery failure via Meta provider.quadkit-notification
QK_ERR_NOTIF_014SlackNotificationErrorSlack notification delivery failure.quadkit-notification
QK_ERR_NOTIF_015PermanentDeliveryFailureRaised when a message has exhausted all delivery retries. Args: delivery_id: …quadkit-notification

PIPE (2 codes)

Section titled “PIPE (2 codes)”
CodeClassDescriptionPackage
QK_ERR_PIPE_001PipelineExecutionErrorError raised during pipeline execution.quadkit-contracts
QK_ERR_PIPE_002PipelineStepErrorError raised by a pipeline step.quadkit-contracts

PROV (1 codes)

Section titled “PROV (1 codes)”
CodeClassDescriptionPackage
QK_ERR_PROV_001ProviderErrorProvider configuration or lifecycle error.quadkit-contracts

QE (1 codes)

Section titled “QE (1 codes)”
CodeClassDescriptionPackage
QK_ERR_QE_001QueryEngineErrorRaised when query engine operations fail in an expected, recoverable way.quadkit-contracts

QUEUE (1 codes)

Section titled “QUEUE (1 codes)”
CodeClassDescriptionPackage
QK_ERR_QUEUE_001QueueErrorBase for expected, recoverable queue / bus failures. Attributes: backend: Nam…quadkit-contracts

RAG (4 codes)

Section titled “RAG (4 codes)”
CodeClassDescriptionPackage
QK_ERR_RAG_001RAGErrorBase for RAG pipeline errors. Extended in a RAG extension with specific failur…quadkit-contracts
QK_ERR_RAG_002RetrievalErrorError raised during document retrieval.quadkit-contracts
QK_ERR_RAG_003SynthesisErrorError raised during response synthesis.quadkit-contracts
QK_ERR_RAG_004ChunkingErrorError raised during document chunking.quadkit-contracts

REG (3 codes)

Section titled “REG (3 codes)”
CodeClassDescriptionPackage
QK_ERR_REG_001RegistryErrorBase exception for registry errors.quadkit-contracts
QK_ERR_REG_002RegistryKeyErrorRaised when a key is not found in a registry.quadkit-contracts
QK_ERR_REG_003RegistryAlreadyExistsErrorRaised when attempting to register a duplicate key in a registry.quadkit-contracts

RES (7 codes)

Section titled “RES (7 codes)”
CodeClassDescriptionPackage
QK_ERR_RES_001ResilienceErrorBase resilience error.quadkit-contracts
QK_ERR_RES_002RetryErrorRetry operation error.quadkit-contracts
QK_ERR_RES_003CircuitBreakerErrorCircuit breaker error.quadkit-contracts
QK_ERR_RES_004BulkheadErrorBulkhead/rejection error.quadkit-contracts
QK_ERR_RES_005FallbackErrorFallback execution error.quadkit-contracts
QK_ERR_RES_006RetryExhaustedErrorAll retry attempts have been exhausted.quadkit-contracts
QK_ERR_RES_007CircuitOpenErrorCircuit breaker is open and rejecting requests.quadkit-contracts

RESULT (1 codes)

Section titled “RESULT (1 codes)”
CodeClassDescriptionPackage
QK_ERR_RESULT_002UnwrapErrorRaised when unwrap() or unwrap_err() is called on the wrong variant. Provides…quadkit-contracts

RET (1 codes)

Section titled “RET (1 codes)”
CodeClassDescriptionPackage
QK_ERR_RET_001RetrieverErrorBase for retriever errors. Raised when document retrieval fails in an expecte…quadkit-contracts

RUN (1 codes)

Section titled “RUN (1 codes)”
CodeClassDescriptionPackage
QK_ERR_RUN_001RunnableErrorRecoverable composition failure (input shape, parser error, retry budget exce…quadkit-contracts

SEC (11 codes)

Section titled “SEC (11 codes)”
CodeClassDescriptionPackage
QK_ERR_SEC_001SecurityErrorBase security error for the Quadkit security subsystem.quadkit-contracts
QK_ERR_SEC_002GuardDeniedErrorRaised when a GuardChain denies the request. Attributes: guard: The name or t…quadkit-contracts
QK_ERR_SEC_003InputSanitizationErrorRaised when sanitization fails due to unrecoverable input structure.quadkit-contracts
QK_ERR_SEC_004CORSViolationErrorRaised when a request violates the configured CORS policy. Attributes: origin…quadkit-contracts
QK_ERR_SEC_005SecretAccessErrorRaised when the caller lacks permission to access or modify a secret. Attribu…quadkit-contracts
QK_ERR_SEC_006SecurityErrorBase exception for all security-module errors.quadkit
QK_ERR_SEC_008SecretAccessErrorRaised when access to a secret is denied.quadkit
QK_ERR_SEC_009EncryptionErrorRaised when field-level encryption fails.quadkit
QK_ERR_SEC_010DecryptionErrorRaised when field-level decryption fails.quadkit
QK_ERR_SEC_011SecretErrorBase exception for secret store errors.quadkit
QK_ERR_SEC_012RateLimitExceededErrorRaised when a client has exceeded the configured rate limit. Carries “retry_…quadkit-auth

SERIAL (4 codes)

Section titled “SERIAL (4 codes)”
CodeClassDescriptionPackage
QK_ERR_SERIAL_001SerializationErrorSerialization/deserialization error.quadkit-contracts
QK_ERR_SERIAL_002SerializationErrorJSON serialisation or deserialisation failed. Raised by: - JsonSerializer…quadkit
QK_ERR_SERIAL_003SerializationErrorBase exception for serialization and deserialization failures. Extensions sho…quadkit
QK_ERR_SERIAL_004NegotiationErrorRaised when no serializer can be negotiated for a given Accept header.quadkit

SES (5 codes)

Section titled “SES (5 codes)”
CodeClassDescriptionPackage
QK_ERR_SES_001SessionErrorBase class for session-related errors.quadkit-contracts
QK_ERR_SES_002TaskCancelledErrorError raised when a task is cancelled.quadkit-contracts
QK_ERR_SES_003TaskErrorBase class for task execution errors.quadkit-contracts
QK_ERR_SES_004TaskTimeoutErrorError raised when a task times out.quadkit-contracts
QK_ERR_SES_005TaskValidationErrorError raised when task input validation fails.quadkit-contracts

SKILL (1 codes)

Section titled “SKILL (1 codes)”
CodeClassDescriptionPackage
QK_ERR_SKILL_001SkillErrorBase for skill execution errors. Extended in an AI skills extension with specific …quadkit-contracts

SQL (38 codes)

Section titled “SQL (38 codes)”
CodeClassDescriptionPackage
QK_ERR_SQL_001DatabaseConnectionErrorBase for all connection-related failures. Attributes: host: The database host…quadkit-sql
QK_ERR_SQL_002ConnectionRefusedErrorServer actively refused the connection.quadkit-sql
QK_ERR_SQL_003ConnectionTimeoutErrorConnection attempt timed out.quadkit-sql
QK_ERR_SQL_004ConnectionPoolErrorConnection pool exhausted — no connections available within timeout.quadkit-sql
QK_ERR_SQL_005QueryErrorBase for query execution failures. Attributes: sql: The SQL query that failed…quadkit-sql
QK_ERR_SQL_006QuerySyntaxErrorThe SQL query has a syntax error.quadkit-sql
QK_ERR_SQL_007ParameterBindingErrorFailed to bind parameters to a query.quadkit-sql
QK_ERR_SQL_008IntegrityErrorBase for constraint violation errors. Attributes: constraint: The constraint …quadkit-sql
QK_ERR_SQL_009DuplicateKeyErrorUnique constraint or primary key violated.quadkit-sql
QK_ERR_SQL_010ForeignKeyErrorForeign key constraint violated.quadkit-sql
QK_ERR_SQL_011NotNullViolationErrorNOT NULL constraint violated. Attributes: column: The column that triggered t…quadkit-sql
QK_ERR_SQL_012CheckConstraintErrorCHECK constraint violated.quadkit-sql
QK_ERR_SQL_013TransactionErrorBase for transaction-related failures.quadkit-sql
QK_ERR_SQL_014SerializationErrorSerialization failure (optimistic concurrency conflict).quadkit-sql
QK_ERR_SQL_015OptimisticLockErrorRaised when an optimistic lock check fails on UPDATE. Indicates a concurrent …quadkit-sql
QK_ERR_SQL_016TransactionRollbackErrorTransaction was rolled back (not by the application).quadkit-sql
QK_ERR_SQL_017LockErrorRaised when a database lock cannot be acquired.quadkit-sql
QK_ERR_SQL_018DeadlockErrorDatabase deadlock detected. Inherits from :class:TransactionError because d…quadkit-sql
QK_ERR_SQL_019SchemaErrorBase for schema-related errors.quadkit-sql
QK_ERR_SQL_020TableNotFoundErrorReferenced table does not exist.quadkit-sql
QK_ERR_SQL_021ColumnNotFoundErrorReferenced column does not exist.quadkit-sql
QK_ERR_SQL_022DatabaseTimeoutErrorDatabase operation timed out.quadkit-sql
QK_ERR_SQL_023RepositoryErrorRepositoryProtocol-level operation failure.quadkit-sql
QK_ERR_SQL_024UnitOfWorkErrorRaised when unit of work operation fails.quadkit-sql
QK_ERR_SQL_025DriverErrorWraps underlying database driver exceptions. Preserves the original exception…quadkit-sql
QK_ERR_SQL_026DataErrorBase exception for data access layer failures.quadkit-sql
QK_ERR_SQL_027DataQueryErrorRaised when a query cannot be built or compiled. Args: message: Explanation o…quadkit-sql
QK_ERR_SQL_028PaginationErrorRaised when pagination parameters are invalid. Args: message: Explanation of …quadkit-sql
QK_ERR_SQL_029EntityNotFoundErrorSignals that a required entity does not exist. RepositoryProtocol implementat…quadkit-sql
QK_ERR_SQL_030DataRepositoryErrorRaised when a repository operation fails unexpectedly. Args: message: Explana…quadkit-sql
QK_ERR_SQL_031CursorErrorRaised when a cursor cannot be encoded or decoded. Args: message: Explanation…quadkit-sql
QK_ERR_SQL_032MigrationDependencyErrorRaised when migration dependencies are not satisfied.quadkit-sql
QK_ERR_SQL_033MigrationExecutionErrorRaised when migration execution fails.quadkit-sql
QK_ERR_SQL_034MigrationNotFoundErrorRaised when a migration is not found.quadkit-sql
QK_ERR_SQL_035MigrationValidationErrorRaised when migration validation fails.quadkit-sql
QK_ERR_SQL_036ProtocolValidationErrorRaised when object doesn’t implement protocol.quadkit-sql
QK_ERR_SQL_037MappingErrorException raised when entity mapping fails.quadkit-sql
QK_ERR_SQL_038TenantScopingErrorRaised when a tenant-scoped operation runs without an active tenant. Mirrors …quadkit-sql

STORE (8 codes)

Section titled “STORE (8 codes)”
CodeClassDescriptionPackage
QK_ERR_STORE_001StorageErrorBase exception for storage errors.quadkit-contracts
QK_ERR_STORE_002StorageFileNotFoundErrorRaised when file is not found.quadkit-storage
QK_ERR_STORE_003StorageUnsupportedOperationErrorRaised when the requested operation is not supported by the storage driver.quadkit-contracts
QK_ERR_STORE_004TransactionErrorRaised when a transaction operation fails.quadkit-storage
QK_ERR_STORE_005QuotaExceededErrorRaised when a storage quota or size limit is exceeded.quadkit-storage
QK_ERR_STORE_006InvalidPathErrorRaised when a path is invalid or attempts directory traversal.quadkit-storage
QK_ERR_STORE_007StorageUnavailableErrorRaised when the storage backend is not reachable or unavailable.quadkit-storage
QK_ERR_STORE_008ChecksumMismatchErrorRaised when a file’s checksum does not match the expected value.quadkit-storage

TASK (13 codes)

Section titled “TASK (13 codes)”
CodeClassDescriptionPackage
QK_ERR_TASK_001TaskQueueErrorBase class for expected, recoverable task queue failures. All subtypes indica…quadkit-contracts
QK_ERR_TASK_002QueueFullErrorThe queue has reached its maximum capacity and cannot accept new tasks. The c…quadkit-tasks
QK_ERR_TASK_003TaskErrorBase exception for all task-related errorsquadkit-tasks
QK_ERR_TASK_004TaskNotFoundErrorRaised when a task cannot be foundquadkit-tasks
QK_ERR_TASK_005TaskTimeoutErrorRaised when a task execution exceeds timeoutquadkit-tasks
QK_ERR_TASK_006TaskCancelledErrorRaised when a task is cancelledquadkit-tasks
QK_ERR_TASK_007TaskExecutionErrorRaised when a task execution failsquadkit-tasks
QK_ERR_TASK_008TaskValidationErrorRaised when task parameters are invalidquadkit-tasks
QK_ERR_TASK_009DuplicateTaskErrorRaised when a duplicate task is detectedquadkit-tasks
QK_ERR_TASK_010TaskDependencyCycleErrorRaised at registration time when a dependency cycle is detected. The schedule…quadkit-tasks
QK_ERR_TASK_011TaskRegistrationErrorRaised when a scheduled or handler task fails to register.quadkit-tasks
QK_ERR_TASK_012TaskLockHeldErrorRaised when an in-memory task lock is already held. Raised by the :func:`dist…quadkit-tasks
QK_ERR_TASK_013WorkflowErrorRaised when a workflow execution fails unexpectedly.quadkit-tasks

TENANT (9 codes)

Section titled “TENANT (9 codes)”
CodeClassDescriptionPackage
QK_ERR_TENANT_001TenantErrorBase class for all tenancy-related domain errors.quadkit-contracts
QK_ERR_TENANT_002TenantNotFoundErrorRaised when a requested tenant does not exist.quadkit-contracts
QK_ERR_TENANT_003TenantInactiveErrorRaised when an operation is attempted on an inactive tenant.quadkit-contracts
QK_ERR_TENANT_004TenantProvisioningErrorRaised when tenant provisioning (isolation setup) fails.quadkit-contracts
QK_ERR_TENANT_005TenantResolutionErrorRaised when tenant resolution fails unexpectedly.quadkit-contracts
QK_ERR_TENANT_006TenantConfigErrorRaised when per-tenant configuration access or mutation fails.quadkit-contracts
QK_ERR_TENANT_007TenantSlugConflictErrorRaised when a tenant slug is already in use.quadkit-contracts
QK_ERR_TENANT_008TenantSuspendedErrorRaised when an operation is attempted on a suspended tenant.quadkit-contracts
QK_ERR_TENANT_009MigrationErrorRaised when a tenant tier migration fails.quadkit-contracts

TEST (12 codes)

Section titled “TEST (12 codes)”
CodeClassDescriptionPackage
QK_ERR_TEST_001TestingErrorBase exception for quadkit-testing operations.quadkit-testing
QK_ERR_TEST_002TokenBudgetExceededErrorRaised when an AITestClient operation would exceed the configured token budge…quadkit-testing
QK_ERR_TEST_003MemoryBackendErrorBase exception for all memory backend errors.quadkit-testing
QK_ERR_TEST_004CommandBusErrorRaised when a command bus operation fails.quadkit-testing
QK_ERR_TEST_005CommandHandlerNotFoundErrorRaised when no handler is registered for a specific command type.quadkit-testing
QK_ERR_TEST_006DuplicateHandlerErrorRaised when a handler is already registered for a command type.quadkit-testing
QK_ERR_TEST_007CommandErrorWraps a handler exception for Result-based command dispatch.quadkit-testing
QK_ERR_TEST_008QueryBusErrorRaised when a query bus operation fails.quadkit-testing
QK_ERR_TEST_009QueryHandlerNotFoundErrorRaised when no handler is registered for a specific query type.quadkit-testing
QK_ERR_TEST_010QueryDuplicateHandlerErrorRaised when a handler is already registered for a query type.quadkit-testing
QK_ERR_TEST_011ConfigurationErrorRaised when a require_stub module is loaded via configure() in test mode. Thi…quadkit-testing
QK_ERR_TEST_012SnapshotMismatchErrorRaised when a value does not match the stored snapshot.quadkit-testing

VAL (4 codes)

Section titled “VAL (4 codes)”
CodeClassDescriptionPackage
QK_ERR_VAL_001FieldErrorA single field-level validation error. Used to represent validation failures …quadkit-contracts
QK_ERR_VAL_002ValidationErrorData validation error.quadkit-contracts
QK_ERR_VAL_003ValidationErrorInput validation against rules failed. Raised by: - “ValidatorImpl.validate(…quadkit
QK_ERR_VAL_004ValidationSystemErrorBase exception for validation system/pipeline failures. Distinct from :class:…quadkit

VEC (4 codes)

Section titled “VEC (4 codes)”
CodeClassDescriptionPackage
QK_ERR_VEC_001VectorErrorBase exception for vector store errors. Extends InfrastructureError because v…quadkit-contracts
QK_ERR_VEC_002VectorStoreErrorException raised during vector store operations (CRUD, search).quadkit-contracts
QK_ERR_VEC_003EmbeddingErrorException raised during embedding generation or retrieval.quadkit-contracts
QK_ERR_VEC_004VectorIndexErrorException raised during vector index creation or management.quadkit-contracts

WEB (14 codes)

Section titled “WEB (14 codes)”
CodeClassDescriptionPackage
QK_ERR_WEB_001WebErrorWeb layer error.quadkit-contracts
QK_ERR_WEB_002HttpStatusErrorRaised by :meth:HttpResponse.raise_for_status for 4xx/5xx responses. Attrib…quadkit-contracts
QK_ERR_WEB_003NotFoundError404 Not Found.quadkit-web
QK_ERR_WEB_004BadRequestError400 Bad Request.quadkit-web
QK_ERR_WEB_005UnauthorizedError401 Unauthorized.quadkit-web
QK_ERR_WEB_006ForbiddenError403 Forbidden.quadkit-web
QK_ERR_WEB_007MethodNotAllowedError405 Method Not Allowed.quadkit-web
QK_ERR_WEB_008ConflictError409 Conflict.quadkit-web
QK_ERR_WEB_009UnprocessableEntityError422 Unprocessable Entity.quadkit-web
QK_ERR_WEB_010InternalServerError500 Internal Server Error.quadkit-web
QK_ERR_WEB_011DependencyResolutionError500 Dependency Resolution Error.quadkit-web
QK_ERR_WEB_012RateLimitError429 Too Many Requests.quadkit-web
QK_ERR_WEB_013TooManyConnectionsError503 Service Unavailable — connection limit reached. Raised when a streaming e…quadkit-web
QK_ERR_WEB_014HTTPErrorBase HTTP error, compatible with QuadkitError.quadkit-web

WEBHOOK (1 codes)

Section titled “WEBHOOK (1 codes)”
CodeClassDescriptionPackage
QK_ERR_WEBHOOK_001WebhookErrorBase exception for webhook domain operations.quadkit-contracts

WF (22 codes)

Section titled “WF (22 codes)”
CodeClassDescriptionPackage
QK_ERR_WF_001WorkflowErrorBase for workflow execution errors. Raised when a workflow graph execution fa…quadkit-contracts
QK_ERR_WF_002SagaStepErrorRepresents a recoverable failure from a single saga step action. SagaProtocol…quadkit-contracts
QK_ERR_WF_003WorkflowErrorBase exception for workflow orchestration errors.quadkit-workflow
QK_ERR_WF_004WorkflowNotFoundErrorRaised when a workflow definition cannot be found.quadkit-workflow
QK_ERR_WF_005WorkflowStateErrorRaised when a workflow is in an invalid state for the requested operation.quadkit-workflow
QK_ERR_WF_006WorkflowStepErrorRaised when a workflow step fails to execute.quadkit-workflow
QK_ERR_WF_007WorkflowTimeoutErrorRaised when a workflow or step exceeds its timeout.quadkit-workflow
QK_ERR_WF_008WorkflowCompensationErrorRaised when workflow compensation/rollback fails.quadkit-workflow
QK_ERR_WF_009SagaVersionMismatchErrorRaised when a persisted saga state version is incompatible with the current c…quadkit-contracts
QK_ERR_WF_010WorkflowVersionMismatchErrorRaised when resuming a workflow instance with a mismatched definition version…quadkit-workflow
QK_ERR_WF_011GraphExecutionErrorBase exception for graph workflow engine operations. Args: message: Human-rea…quadkit-workflow
QK_ERR_WF_012NodeExecutionErrorA graph node’s execute() method failed. Args: message: Human-readable error d…quadkit-workflow
QK_ERR_WF_013CycleDetectedErrorGraph engine exceeded max_iterations (likely cycle). Args: iterations: Number…quadkit-workflow
QK_ERR_WF_014GraphTimeoutErrorGraph workflow execution exceeded total timeout. Args: timeout: The configure…quadkit-workflow
QK_ERR_WF_015GraphValidationErrorGraph structure validation failed.quadkit-workflow
QK_ERR_WF_016HumanInputRequiredErrorRaised by HumanNode to pause execution awaiting human input. Args: prompt: Te…quadkit-workflow
QK_ERR_WF_017StateErrorRaised when an invalid state transition is attempted. Extends the contracts `…quadkit-workflow
QK_ERR_WF_018StateConcurrencyErrorRaised when optimistic version checks fail during a transition. Also a confli…quadkit-workflow
QK_ERR_WF_019SagaErrorRaised when a saga step fails after compensation has been attempted. Attribut…quadkit
QK_ERR_WF_020BulkOperationErrorBase exception for bulk operation errors.quadkit-workflow
QK_ERR_WF_021BulkOperationTimeoutErrorRaised when a bulk operation times out.quadkit-workflow
QK_ERR_WF_022BulkOperationCancelledErrorRaised when a bulk operation is cancelled.quadkit-workflow