Skip to main content

Module recovery

Module recovery 

Source
Expand description

Opt-in recovery of one immutable completion request, never an agent or tool loop.

Structs§

AdmissionContext
Capabilities
Endpoint facilities declared by a recovery adapter, not permission to retry. Inspect RecoveryGateway::capability_evidence for documentation and limitations.
CapabilityEvidence
Documentation supporting one endpoint capability declaration.
CapabilityEvidenceSet
Evidence for all five recovery capabilities of one completion adapter.
Classification
Failure
Identity
LifecycleEvent
Progress
Recovered
Success and its exact wire accounting; response payload is intentionally not serializable here.
RecoveryCall
Per-call cancellation, independent of remote inference termination.
RecoveryError
RecoveryGateway
One-request recovery adapter. Tool execution stays in the existing broker/session.
RecoveryPolicy
RecoveryReport
SemanticProgress
SystemTiming
ValidatedMetadata
Only recognized provider codes and request-ID formats are retained by default.

Enums§

Acceptance
AdmissionDecision
Category
CompletionDecodeError
Concrete decoding/termination causes available through Failure::inspect_cause. Raw provider payloads remain private; serde errors retain their original type.
Operation
Outcome
Phase
Provider
Reason
RecoveryPolicyError
Invalid recovery options, rejected before a wrapper can dispatch a request. Positive attempt counts and nonnegative finite delays are enforced by Rust’s NonZeroU32 and Duration types. Base delays above the ceiling are valid.
RecoveryStreamEvent
Output and nonsemantic telemetry for one logical completion. Completed and Failed are terminal; progress never proves remote termination.
RetryAfter
Support
Transition
WireEvent
Wire capture is explicit and sensitive. The library never stores captures by default.

Traits§

Admission
Only Allow grants permission. Unresolved completes without a decision and stops recovery; a pending future stays pending until a decision, cancellation, or expiry.
LifecycleObserver
Timing
Inject both monotonic and wall time, sleep, and full jitter for deterministic tests.
WireObserver