#[non_exhaustive]pub enum StoreError {
Show 174 variants
InvalidRunFailureClose,
RunFailureClosing,
UnsupportedFailureCloseRuntime,
InvalidAgentDeadline,
ChildJoinRejected,
ChildCancellationNotFound,
UnsupportedChildRuntime,
IncompleteChildAccounting,
ChildRunConflict,
ChildRunNotFound,
ChildRunRejected,
ChildRunTopologyExceeded,
UnsettledChildRuns,
ChildBudgetObservationRequired,
ChildRunSettlementUnavailable,
Configuration(ConfigurationError),
Database {
operation: &'static str,
source: Error,
},
Migration {
source: MigrateError,
},
UnsupportedServerVersion,
SchemaNotMigrated,
IncompatibleSchema,
IncompleteSchema,
InvalidArtifactStorageLocator,
ArtifactNotFound,
ArtifactRegistrationConflict,
ArtifactParentNotFound,
ArtifactProvenanceNotFound,
GraphDefinitionNotFound,
GraphDefinitionConflict,
InvalidSchedulerFairnessPolicy,
InvalidSchedulerFairnessRetention,
SchedulerFairnessPolicyConflict,
SchedulerFairnessPolicyNotFound,
SchedulerFairnessReservationConflict,
SchedulerFairnessSequenceExhausted,
RunNotFound,
RunConflict,
AgentAdmissionNotFound,
InvalidAgentAdmissionCommit,
AgentAdmissionRejected,
AgentAdmissionSchemaUnavailable,
AgentAdmissionStateRejected,
AgentAdmissionConflict,
AgentSubmissionNotFound,
AgentSubmissionConflict,
RunQuarantined,
InvalidRunQuarantineComponent,
InvalidRunQuarantineRequest,
RunQuarantineNotFound,
RunQuarantineIdConflict,
RunQuarantineConflict,
StaleRunQuarantineObservation,
InvalidClaimedRunRecoveryContext,
StaleClaimedRunRecoveryObservation,
ReadyNodeRecoveryCheckpointMissing,
GraphReplayDependencyUnavailable,
GraphReplayResourceLimit,
InvalidReadyNodeDispatchPlan,
ReadyNodeNotDispatchable,
InvalidDelayedRetryPlan,
RunQuarantineCommitConflict,
RunNotRunnable,
RunNotYetAvailable,
WrongAppendAuthority,
EventIdConflict,
ProjectionIntentConflict,
StaleJournalHead,
CheckpointNotFound,
CheckpointIdConflict,
CheckpointCommitConflict,
InvalidWaitRegistrationBatch,
WaitRegistrationCommitConflict,
WaitRegistrationNotFound,
WaitRegistrationKindMismatch,
InvalidInterruptResolution,
InterruptResolutionCommitConflict,
InvalidTimerFiring,
TimerFiringCommitConflict,
InvalidWaitDiscoveryPageSize,
InvalidDueTimerCursor,
InvalidExpiredInterruptCursor,
InvalidWaitAbandonment,
WaitAbandonmentCommitConflict,
WaitAbandonmentNotFound,
WaitWasAbandoned,
CheckpointBarrierRequired,
InvalidCheckpointBarrier,
CheckpointBarrierIncomplete,
CheckpointBarrierResultConflict,
CheckpointBarrierCommitConflict,
StaleCheckpointHead,
CheckpointBlockedByToolInvocation,
ToolInvocationNotFound,
InvalidToolAuthorizationReceipt,
ToolAuthorizationReceiptNotFound,
ToolAuthorizationReceiptConflict,
InvalidToolAuthorizationReceiptPageSize,
InvalidToolAuthorizationReceiptCursor,
InvalidSkillActivation,
SkillActingWindowNotFound,
SkillActivationConflict,
SkillActingWindowInactive,
ToolInvocationIdConflict,
ToolInvocationCommitConflict,
StaleToolInvocationHead,
InvalidToolInvocationTransition,
InvalidToolInvocationActivation,
CheckpointBlockedByModelInvocation,
ModelInvocationNotFound,
ModelInvocationIdConflict,
ModelInvocationCommitConflict,
StaleModelInvocationHead,
InvalidModelInvocationTransition,
InvalidModelInvocationActivation,
PendingNodeResultNotFound,
PendingNodeResultConflict,
PendingNodeResultCommitConflict,
InvalidPendingNodeResultActivation,
NodeAttemptRequired,
InvalidPendingNodeResult,
InvalidPendingNodeResultBinding,
InvalidPendingNodeResultPageSize,
InvalidPendingNodeResultCursor,
NodeAttemptNotFound,
NodeAttemptIdConflict,
NodeAttemptCommitConflict,
InvalidNodeAttemptActivation,
InvalidNodeAttemptTransition,
NodeAttemptLimitExceeded,
StaleNodeAttemptStart,
InvalidNodeAttemptCursor,
InvalidNodeAttemptPageSize,
InvalidRunnableRunPageSize,
InvalidRunnableRunCursor,
InvalidOutboxBatch,
OutboxDestinationSnapshotMismatch,
OutboxDestinationNotFound,
OutboxDestinationConflict,
OutboxDeliveryNotFound,
OutboxDeliveryIdConflict,
OutboxEnqueueConflict,
OutboxAttemptIdConflict,
StaleOutboxFence,
OutboxAttemptExpired,
OutboxAttemptNotFound,
OutboxCompletionConflict,
InvalidOutboxTransition,
InvalidOutboxAttemptCursor,
InvalidOutboxAttemptPageSize,
StalePendingNodeResultSnapshot,
InvalidJournalCursor,
InvalidCheckpointCursor,
InvalidToolInvocationCursor,
InvalidModelInvocationCursor,
JournalSequenceExhausted,
StaleLifecycleRevision,
InvalidLifecycleTransition,
DurableWaitMutationRequired,
LifecycleObservationAfterCommit,
LeaseHeld,
NoActiveLease,
StaleFence,
LeaseExpired,
DatabaseClockRegression,
LeaseExpiryNotExtended,
LeaseHorizonExceeded,
FencingEpochExhausted,
InvalidPageSize,
InvalidCheckpointPageSize,
InvalidGraphReplayLimits,
InvalidToolInvocationPageSize,
InvalidModelInvocationPageSize,
Encoding {
record: &'static str,
},
CorruptData {
record: &'static str,
},
}Expand description
Durable PostgreSQL operation failure with payload-redacted diagnostics.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
InvalidRunFailureClose
The failure-close boundary lacks complete settled direct evidence or scope.
RunFailureClosing
An immutable failure decision already owns this run’s execution boundary.
UnsupportedFailureCloseRuntime
An older writer cannot mutate a failure-closing run.
InvalidAgentDeadline
Invalid tenant cursor or deadline cancellation audit construction.
ChildJoinRejected
Missing, mismatched or unconsumed dedicated child Join evidence.
ChildCancellationNotFound
No durable parent cancellation witness owns this child key.
UnsupportedChildRuntime
A pre-child binary attempted to mutate a child-enabled run.
IncompleteChildAccounting
Terminal accounting omitted already recorded direct or delegated usage.
ChildRunConflict
Owned-child records, immutable input or scope do not match.
ChildRunNotFound
No ownership record exists inside the supplied parent/tenant boundary.
ChildRunRejected
A fresh child admission failed readiness, authority or budget validation.
ChildRunTopologyExceeded
An ancestor’s finite depth or unsettled-descendant ceiling was reached.
UnsettledChildRuns
Outstanding child work blocks direct external dispatch or parent closure.
ChildBudgetObservationRequired
Invocation start requires a fresh verified child-adjusted budget snapshot.
No complete, fully priced immutable terminal evidence is available yet.
Configuration(ConfigurationError)
Provider configuration was invalid.
Database
Connection or SQL execution failed.
Fields
Migration
Ordered schema migration failed.
Fields
source: MigrateErrorUnderlying migration error.
UnsupportedServerVersion
The connected server is outside the qualified major versions.
SchemaNotMigrated
Required migration metadata has not been installed.
IncompatibleSchema
Applied migration versions or checksums do not match this binary.
IncompleteSchema
Migration metadata exists but required schema objects are missing.
InvalidArtifactStorageLocator
Private artifact object coordinates violated the portable storage contract.
ArtifactNotFound
No immutable artifact exists inside the supplied tenant boundary.
ArtifactRegistrationConflict
An artifact identity, idempotency key, or object locator already owns another record.
ArtifactParentNotFound
A direct artifact parent does not already exist in the same tenant.
ArtifactProvenanceNotFound
The artifact’s causing run event does not exist in the same tenant.
GraphDefinitionNotFound
No exact compiled graph exists inside the supplied tenant registry.
GraphDefinitionConflict
A graph version was already registered with different immutable bytes.
InvalidSchedulerFairnessPolicy
A fairness policy was empty, oversized, or had an invalid cycle length.
InvalidSchedulerFairnessRetention
Reservation retention duration or batch bounds are unsafe.
SchedulerFairnessPolicyConflict
A scheduler shard identity already owns another immutable policy.
SchedulerFairnessPolicyNotFound
No immutable fairness policy exists for the supplied scheduler shard.
SchedulerFairnessReservationConflict
A reservation retry named another shard or policy snapshot.
SchedulerFairnessSequenceExhausted
The durable fairness reservation sequence reached its supported ceiling.
RunNotFound
No run exists inside the supplied tenant boundary.
RunConflict
Run admission reused an identity with different provenance.
AgentAdmissionNotFound
No immutable Agent admission snapshot exists for this tenant-scoped run.
InvalidAgentAdmissionCommit
The supplied event, checkpoint, graph, or scope cannot form an atomic admission.
AgentAdmissionRejected
Database-time budget evaluation rejected a new Agent admission.
The exact pinned state-schema validator was unavailable or panicked.
AgentAdmissionStateRejected
Initial graph state did not satisfy the exact pinned state schema.
AgentAdmissionConflict
The run identity or one stable anchor belongs to another admission intent.
AgentSubmissionNotFound
No durable ingress idempotency mapping exists for this tenant/key.
AgentSubmissionConflict
One ingress key was reused for a different immutable submission.
RunQuarantined
The run is quarantined and cannot execute or mutate normally.
InvalidRunQuarantineComponent
A quarantine component code violated its bounded machine grammar.
InvalidRunQuarantineRequest
A quarantine request crossed its tenant/run journal observation.
RunQuarantineNotFound
No audit-grade quarantine observation exists for the supplied run.
RunQuarantineIdConflict
A stable quarantine identity was reused for another immutable intent.
RunQuarantineConflict
Another immutable quarantine observation already owns the run.
StaleRunQuarantineObservation
The run journal changed after the evidence observation was constructed.
InvalidClaimedRunRecoveryContext
A claimed recovery session crossed its fence, tenant, or run boundary.
StaleClaimedRunRecoveryObservation
Durable journal progress invalidated the claimed recovery observation.
ReadyNodeRecoveryCheckpointMissing
Ready-node recovery was requested before an initial checkpoint exists.
Replay could not run because the exact local schema or reducer was not available.
GraphReplayResourceLimit
Replay result material exceeded the explicitly configured memory bound.
InvalidReadyNodeDispatchPlan
A recovery plan, journal append, fence, or node selection crossed scope.
ReadyNodeNotDispatchable
The selected recovery-plan node does not authorize a new physical start.
InvalidDelayedRetryPlan
A recovery plan contains immediate, in-flight, or terminal work and therefore cannot be projected as one delayed retry wakeup.
RunQuarantineCommitConflict
Immutable quarantine evidence and the mutable run projection disagree.
RunNotRunnable
The run lifecycle is not currently runnable.
RunNotYetAvailable
A durable scheduler gate has not reached its inclusive database time.
WrongAppendAuthority
A caller reached the wrong trusted append entry point.
EventIdConflict
A stable event ID was reused for a different immutable intent.
ProjectionIntentConflict
A retry reused an event ID with a different or unverifiable projection intent.
StaleJournalHead
The supplied complete journal head did not match the locked run row.
CheckpointNotFound
No checkpoint exists for the supplied tenant/run/checkpoint identity.
CheckpointIdConflict
A stable checkpoint ID was reused for a different immutable write intent.
CheckpointCommitConflict
Event and checkpoint idempotency records do not describe one atomic commit.
InvalidWaitRegistrationBatch
A wait batch was empty, oversized, duplicated, or crossed scope/event identity.
WaitRegistrationCommitConflict
Wait event, checkpoint, lifecycle markers, and registration rows disagree.
WaitRegistrationNotFound
No durable wait registration exists under the supplied tenant/run/identity.
WaitRegistrationKindMismatch
A wait identity was loaded through the wrong interrupt/timer API.
InvalidInterruptResolution
Resolution intent did not match an outstanding durable interrupt.
InterruptResolutionCommitConflict
Resolution event, immutable detail, and mutable wait projection disagree.
InvalidTimerFiring
Timer firing intent did not match an outstanding due durable timer.
TimerFiringCommitConflict
Firing event, immutable detail, and mutable wait projection disagree.
InvalidWaitDiscoveryPageSize
A wait-discovery page size was zero or exceeded the decoded-memory bound.
InvalidDueTimerCursor
A due-timer page cursor crossed tenant/cutoff/order scope.
InvalidExpiredInterruptCursor
An expired-interrupt page cursor crossed tenant/cutoff/order scope.
InvalidWaitAbandonment
The supplied run-level edge was not cancellation/failure from waiting.
WaitAbandonmentCommitConflict
Abandonment event, detail set, and mutable wait projections disagree.
WaitAbandonmentNotFound
The requested wait has no immutable abandonment audit fact.
WaitWasAbandoned
Resolution/firing history was requested for a wait abandoned by the run.
CheckpointBarrierRequired
A successor checkpoint must prove the complete result barrier it consumes.
InvalidCheckpointBarrier
The supplied barrier did not match its fully restored durable base.
CheckpointBarrierIncomplete
At least one result required by the complete barrier is not durable.
CheckpointBarrierResultConflict
Durable pending-result identities do not equal the supplied complete barrier.
CheckpointBarrierCommitConflict
Barrier event, checkpoint, and consumption rows do not describe one atomic commit.
StaleCheckpointHead
The supplied complete checkpoint parent did not match the locked run row.
CheckpointBlockedByToolInvocation
A tool invocation on the current checkpoint has not committed a result.
ToolInvocationNotFound
No logical tool invocation exists in the supplied tenant/run boundary.
InvalidToolAuthorizationReceipt
Receipt provenance or descriptor/input binding crossed its durable boundary.
ToolAuthorizationReceiptNotFound
No exact receipt or referenced durable invocation boundary exists.
ToolAuthorizationReceiptConflict
A receipt identity was reused with different immutable canonical bytes.
InvalidToolAuthorizationReceiptPageSize
A receipt audit page size was zero or exceeded its decoded-memory bound.
InvalidToolAuthorizationReceiptCursor
A receipt audit cursor crossed scope or did not match immutable storage.
InvalidSkillActivation
Skill activation approval or acting-window evidence crossed its durable scope.
SkillActingWindowNotFound
No exact Skill acting window exists in the tenant boundary.
SkillActivationConflict
A Skill approval or window identity was reused with different evidence.
SkillActingWindowInactive
The exact acting window expired or has an immutable revocation.
ToolInvocationIdConflict
A stable invocation ID was reused with a different immutable intent.
ToolInvocationCommitConflict
Event and invocation records do not describe one atomic commit.
StaleToolInvocationHead
The supplied complete invocation head did not match its durable current row.
InvalidToolInvocationTransition
The requested invocation state transition was invalid for durable state.
InvalidToolInvocationActivation
The invocation activation is not a ready root-graph node of its checkpoint.
CheckpointBlockedByModelInvocation
A model invocation on the current checkpoint has not committed a response.
ModelInvocationNotFound
No logical model invocation exists in the supplied tenant/run boundary.
ModelInvocationIdConflict
A stable model invocation ID was reused with a different immutable intent.
ModelInvocationCommitConflict
Event and model invocation records do not describe one atomic commit.
StaleModelInvocationHead
The supplied complete model invocation head did not match its durable current row.
InvalidModelInvocationTransition
The requested model invocation transition was invalid for durable state.
InvalidModelInvocationActivation
The model invocation activation is not a ready root-graph node of its checkpoint.
PendingNodeResultNotFound
No pending result exists for the supplied logical node activation key.
PendingNodeResultConflict
A logical activation already has a different immutable semantic result.
PendingNodeResultCommitConflict
Event and pending-result rows do not describe one atomic commit.
InvalidPendingNodeResultActivation
The pending result activation is not a ready root-graph node of its checkpoint.
NodeAttemptRequired
New pending results must be committed through a durable physical node attempt.
InvalidPendingNodeResult
The result’s temporal or control invariants cannot commit at the database observation.
InvalidPendingNodeResultBinding
A pending result named an absent, non-committed, or crossed invocation revision.
InvalidPendingNodeResultPageSize
A pending-result page size exceeded its decoded-memory safety bound.
InvalidPendingNodeResultCursor
A pending-result page cursor crossed scope or did not match its durable row.
NodeAttemptNotFound
No physical node attempt exists in the supplied tenant/run boundary.
NodeAttemptIdConflict
A stable physical attempt identity was reused for another owner.
NodeAttemptCommitConflict
Event and node-attempt rows do not describe one atomic commit.
InvalidNodeAttemptActivation
The attempt activation is not a ready root-graph node of its checkpoint.
InvalidNodeAttemptTransition
The requested physical-attempt transition is invalid for durable history.
NodeAttemptLimitExceeded
One logical activation reached the hard physical-attempt ceiling.
StaleNodeAttemptStart
The supplied exact start does not match the durable physical attempt.
InvalidNodeAttemptCursor
A node-attempt history cursor did not identify the exact stored attempt.
InvalidNodeAttemptPageSize
A node-attempt history page size exceeded its decoded-memory safety bound.
InvalidRunnableRunPageSize
A runnable-run page size exceeded its decoded-memory safety bound.
InvalidRunnableRunCursor
A runnable-run cursor crossed tenant scope or contained an invalid key.
InvalidOutboxBatch
An outbox enqueue batch was empty, duplicated, or exceeded its hard bound.
OutboxDestinationSnapshotMismatch
Destination snapshot digest did not match its canonical configuration.
OutboxDestinationNotFound
No immutable destination snapshot exists in the tenant boundary.
OutboxDestinationConflict
A destination snapshot identity conflicts with durable configuration.
OutboxDeliveryNotFound
No outbox delivery exists in the supplied tenant/run boundary.
OutboxDeliveryIdConflict
A stable delivery identity conflicts with a committed immutable intent.
OutboxEnqueueConflict
Journal event and complete outbox set do not describe one atomic commit.
OutboxAttemptIdConflict
A physical outbox attempt identity was already claimed by another owner.
StaleOutboxFence
The supplied delivery fence is not the exact current attempt.
OutboxAttemptExpired
The current outbox attempt reached its exclusive database expiry.
OutboxAttemptNotFound
A delivery attempt has no durable start in the tenant-scoped run.
OutboxCompletionConflict
A completion conflicts with an already committed terminal attempt.
InvalidOutboxTransition
The requested outbox state transition is invalid for durable history.
InvalidOutboxAttemptCursor
An outbox history cursor did not identify the exact stored attempt.
InvalidOutboxAttemptPageSize
An outbox-attempt page size exceeded its decoded-memory safety bound.
StalePendingNodeResultSnapshot
The run journal advanced after an earlier pending-result page snapshot.
InvalidJournalCursor
A pagination cursor did not identify the exact stored event head.
InvalidCheckpointCursor
A reverse-lineage cursor did not identify the exact stored checkpoint head.
InvalidToolInvocationCursor
An invocation-history cursor did not identify the exact stored revision.
InvalidModelInvocationCursor
A model-invocation history cursor did not identify the exact stored revision.
JournalSequenceExhausted
No higher signed PostgreSQL journal sequence exists.
StaleLifecycleRevision
The expected lifecycle revision did not match the locked run row.
InvalidLifecycleTransition
The requested lifecycle transition was not a valid direct successor.
DurableWaitMutationRequired
A durable-wait edge was attempted through a journal-only mutation path.
LifecycleObservationAfterCommit
A lifecycle observation claimed to occur after the journal commit clock.
LeaseHeld
Another unexpired worker lease currently owns the run.
NoActiveLease
No active lease can satisfy the requested mutation.
StaleFence
Attempt or fencing epoch did not match the current lease.
LeaseExpired
The exact lease reached its exclusive database expiry.
DatabaseClockRegression
The database wall clock moved before a durable lease observation.
LeaseExpiryNotExtended
Renewal did not strictly extend the current expiry.
LeaseHorizonExceeded
Renewal requested an expiry beyond the configured safety horizon.
FencingEpochExhausted
No higher signed PostgreSQL fencing epoch exists.
InvalidPageSize
A requested journal page exceeded the hard bound.
InvalidCheckpointPageSize
A requested checkpoint-lineage page exceeded its memory-safety bound.
InvalidGraphReplayLimits
A graph replay memory limit was zero or exceeded its implementation bound.
InvalidToolInvocationPageSize
A requested invocation-history page exceeded its memory-safety bound.
InvalidModelInvocationPageSize
A requested model-invocation history page exceeded its memory-safety bound.
Encoding
Trusted in-process domain data could not be serialized canonically.
CorruptData
Durable bytes or redundant columns failed closed validation.
Implementations§
Source§impl StoreError
impl StoreError
Sourcepub const fn corrupt_record(&self) -> Option<&'static str>
pub const fn corrupt_record(&self) -> Option<&'static str>
Returns the stable, payload-free record category for an integrity error.
Recovery code can map this value to a bounded quarantine component and hash its separately retained evidence without exposing durable payloads.
Sourcepub fn is_retryable(&self) -> bool
pub fn is_retryable(&self) -> bool
Returns whether retrying the complete transaction with identical stable identities is safe after this failure category.
Trait Implementations§
Source§impl Debug for StoreError
impl Debug for StoreError
Source§impl Display for StoreError
impl Display for StoreError
Source§impl Error for StoreError
impl Error for StoreError
Source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · Source§fn description(&self) -> &str
fn description(&self) -> &str
use the Display impl or to_string()
Source§impl From<ConfigurationError> for StoreError
impl From<ConfigurationError> for StoreError
Source§fn from(source: ConfigurationError) -> Self
fn from(source: ConfigurationError) -> Self
Auto Trait Implementations§
impl !RefUnwindSafe for StoreError
impl !UnwindSafe for StoreError
impl Forget for StoreError
impl Freeze for StoreError
impl Move for StoreError
impl Send for StoreError
impl Sync for StoreError
impl Unpin for StoreError
impl UnsafeUnpin for StoreError
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more