Enum MemoryContextError 

pub enum MemoryContextError {
    SessionMismatch,
    NotSessionLeaseMode {
        mode: MemoryContextMode,
    },
    NotOneShotMode {
        mode: MemoryContextMode,
    },
    OneShotAlreadyPending {
        lease_id: MemoryLeaseId,
    },
    OneShotAlreadyConsumed {
        lease_id: MemoryLeaseId,
    },
    NoPendingRecall,
    LeaseExpired {
        lease_id: MemoryLeaseId,
    },
    InvalidExpiry,
    InvalidIdentifier {
        field: &'static str,
    },
    RequiresHostConfirmation,
    CapabilityUnavailable,
    ProviderNotRegistered,
    ProviderAmbiguous,
    ContributionProjectMismatch,
    ContributionOutOfBounds {
        field: &'static str,
    },
    ContributionDuplicateMemoryId,
    ContributionMalformed {
        field: &'static str,
    },
    ContributionWithheldContent,
    ContributionClassNotPermitted,
    RecallBudgetBelowMinimum,
}

Typed memory-context failure. Deliberately content-free (spec §19: no content-bearing errors): only host-minted identities and static field names appear.

Variants

SessionMismatch

The lease or revocation targets a different session.

NotSessionLeaseMode

install requires a session-lease mode (RecallEachPrompt, CaptureOnly, CaptureAndRecall).

Fields

mode: MemoryContextMode

The rejected mode.

NotOneShotMode

install_one_shot requires RecallOnce.

Fields

mode: MemoryContextMode

The rejected mode.

OneShotAlreadyPending

A one-shot recall is already pending; consume or revoke it first.

Fields

lease_id: MemoryLeaseId

The pending lease identity.

OneShotAlreadyConsumed

This one-shot lease was already consumed; retries cannot recall twice.

Fields

lease_id: MemoryLeaseId

The consumed lease identity.

NoPendingRecall

No one-shot recall is pending.

LeaseExpired

The lease is expired.

Fields

lease_id: MemoryLeaseId

The expired lease identity.

InvalidExpiry

expires_at is not strictly after granted_at.

InvalidIdentifier

A boundary identifier was empty, oversized, or contained control characters.

Fields

field: &'static str

Static name of the offending field.

RequiresHostConfirmation

The requested transition can only be committed under deterministic, host-owned proof of user intent (spec §6.3 ExplicitCommand from the /memory frontend command, task A5). A model tool call is a proposal (spec §7.2 rules) and cannot carry such proof through JSON parameters, so it is refused without installing any lease.

CapabilityUnavailable

No memory-context capability is wired into this execution context; lease-granting actions are unavailable and nothing was mutated.

ProviderNotRegistered

Enable-time provider validation failed (task A6, spec §7.1): no loaded extension declares the requested context provider as a validated deferred.context_providers capability. Fail closed — nothing was granted.

ProviderAmbiguous

Enable-time provider validation failed (task A6): more than one installed extension declares an overlapping context-provider capability and no explicit provider id disambiguates the request. Fail closed — the host never picks one arbitrarily, and nothing was granted.

ContributionProjectMismatch

A recall contribution’s project identity does not match the host’s expected project (spec §5.2 isolation) — rejected fail-closed, the contribution never influences budgeting or request assembly.

ContributionOutOfBounds

A recall contribution exceeded a spec §10.3 bound (record count, per-record size, or engine-provided rendered budget). Content-free: only the static field name is carried.

Fields

field: &'static str

Static name of the offending field.

ContributionDuplicateMemoryId

A recall contribution repeated a memory_id across its records (spec §6.5). Rejected fail-closed: duplicates defeat per-record accounting and supersession semantics. Content-free by design.

ContributionMalformed

A provider recall response did not parse as the bounded §6.5 wire shape (missing/mistyped field or out-of-vocabulary enum value). Content-free: only the static field name is carried; the recall path fails OPEN on it (task B4 — the turn proceeds without memory).

Fields

field: &'static str

Static name of the offending wire field.

ContributionWithheldContent

A contribution record carried a NON-EMPTY body under a disclosure class that gate_for_model withholds from model context (spec §5.5 / §14.2). Defense in depth: a correct provider never includes withheld content at all, so the whole contribution is rejected. Content-free by design — the withheld body never appears in the error.

ContributionClassNotPermitted

A contribution record’s disclosure class is not in the originating recall request’s DisclosureGrantSet (spec §6.4 permitted_classes): a provider cannot volunteer classes the host never authorized. Content-free by design.

RecallBudgetBelowMinimum

The computed §10.3 recall budget is below the minimum useful floor — recall is skipped rather than reducing core reserves; nothing was held.

Trait Implementations

impl Clone for MemoryContextError

fn clone(&self) -> MemoryContextError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MemoryContextError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for MemoryContextError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for MemoryContextError

impl Error for MemoryContextError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for MemoryContextError

fn eq(&self, other: &MemoryContextError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for MemoryContextError