Expand description
Runtime error types.
Structs§
- Admission
Failure Context - Structured context for a pre-execution admission failure: a finite-wait pooled writer checkout timeout, a bounded write-queue enqueue timeout, or a bounded storage-admission wait (reader/writer handle slot or pooled reader checkout). All happen before SQLite executes the request, so all are safe to classify as retryable — the request was never accepted, let alone started.
- Circular
Pack Dependency - Circular pack dependency detected during topological sort.
- Guarded
Write Failure - A guarded edge write (
link/link_many) was refused because one or both endpoints no longer existed at write time. Names the exact endpoint(s) missing instead of a generic “source or target” message, and, for a batch write, which entry in the batch failed first. - Missing
Pack Dependencies - Multiple missing pack dependencies collected into one error.
- Missing
Pack Dependency - A single missing pack dependency.
- Retryable
Failure Context - Structured context for a failure that is proven safe to retry.
- Writer
Pool Checkout Timeout Context - Structured context recovered from either a direct SQLite runtime error or a typed SQLite source preserved inside a storage-driver wrapper.
Enums§
- Channel
Ingest Failure Class - Typed disposition for a channel message whose
comm.ingestwrite failed. - Runtime
Error - All errors produced by the khive-runtime layer.
Constants§
- READ_
TX_ AGE_ EVICTED_ STAGE - Stable wire code/stage for a cached read-only transaction proactively
rolled back after pinning a WAL snapshot past the configured
read_tx_max_agebound (#1846). Always safe to retry: the eviction only ever fires on a read-only handle, so no side effect can exist for a retry to duplicate. Shared by bothkhive_storage::StorageError::ReadTransactionAgeEvicted(clean rollback) andkhive_storage::StorageError::ReadTransactionAgeEvictionCleanupFailed(rollback denied or failed outright) — the renderedmessagefield distinguishes the two; retry behavior is identical for both. - STORAGE_
ADMISSION_ TIMEOUT_ STAGE - Stable wire code/stage for a bounded storage-admission wait (a reader/writer handle slot or a pooled reader checkout) that elapsed before anything was acquired. The operation never started, so the failure is safe to retry.
- WRITER_
ADMISSION_ SCOPE - Stable ADR-131:251
scopediscriminator carried on aWRITER_QUEUE_SATURATED_STAGEfailure — distinguishes write-queue admission saturation from otherunavailablefailure kinds that share the sameretryable: trueshape but are not bounded by the admission deadline (e.g.WRITER_POOL_CHECKOUT_TIMEOUT_STAGE, which has no ADR-131-defined scope and carriesNone). - WRITER_
POOL_ CHECKOUT_ TIMEOUT_ STAGE - Stable ADR-135 F6 stage and wire code for a finite-wait pooled writer checkout that expires before SQLite executes.
- WRITER_
QUEUE_ SATURATED_ STAGE - Stable wire code/stage for a bounded write-queue enqueue that never accepted the request within its configured deadline (#1382, #1643).
- WRITER_
TASK_ BEGIN_ BUSY_ STAGE - Stable wire code/stage for SQLite write-lock contention after the writer queue accepted a request but before its operation closure ran.
Functions§
- fts_
text_ leg_ or_ err - Resolve an FTS text-leg search result, failing loud on parser syntax errors instead of silently degrading to vector-only fusion.
Type Aliases§
- Runtime
Result - Convenience alias for
Result<T, RuntimeError>.