Enum SessionError 

pub enum SessionError {
    IoError(Error),
    ArtifactCleanup {
        path: PathBuf,
        source: Error,
        removed: Vec<PathBuf>,
        remaining: Vec<PathBuf>,
    },
    IndexCleanup {
        session_id: Uuid,
        message: String,
    },
    OrphanReconciliation {
        path: PathBuf,
        message: String,
    },
    InvalidJson(String),
    SessionNotFound(Uuid),
    EntryNotFound(String),
    BranchNotFound(String),
    ParseError(String),
    LockPoisoned,
    InvalidExternalId(String),
    DurableTurn(String),
    DurableTurnConflict {
        turn_id: String,
        existing: String,
        requested: String,
    },
}

Errors that can occur during session operations.

Variants

IoError(Error)

An I/O error occurred (file read/write, directory creation, etc.).

ArtifactCleanup

Removing one artifact from a Session-owned artifact set failed.

Fields

path: PathBuf

Exact artifact path whose removal failed.

source: Error

Underlying filesystem failure.

removed: Vec<PathBuf>

Paths already removed before the failure.

remaining: Vec<PathBuf>

Paths still present and safe to retry.

IndexCleanup

Session index cleanup failed while the transcript remained discoverable.

Fields

session_id: Uuid

Session whose supplementary index/fork rows could not be removed.

message: String

Content-free index diagnostic.

OrphanReconciliation

Orphan-sidecar validation or SQLite ownership probing failed.

Fields

path: PathBuf

Exact validated sidecar path.

message: String

Content-free validation or SQLite diagnostic.

InvalidJson(String)

A line in the JSONL file is not valid JSON.

SessionNotFound(Uuid)

The requested session was not found.

EntryNotFound(String)

The requested entry ID was not found in the session.

BranchNotFound(String)

The requested branch ID was not found.

ParseError(String)

Failed to parse a session file.

LockPoisoned

A per-session internal mutex was poisoned by a panicking thread.

InvalidExternalId(String)

A host-provided external session identifier is invalid.

DurableTurn(String)

A durable turn cannot be committed because its persisted state is inconsistent.

DurableTurnConflict

A turn was already finalized with a different outcome or payload.

Fields

turn_id: String

Turn identity whose terminal record already exists.

existing: String

Previously persisted terminal outcome or ambiguous state.

requested: String

Requested terminal outcome.

Trait Implementations

impl Debug for SessionError

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

Formats the value using the given formatter.

impl Display for SessionError

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

Formats the value using the given formatter.

impl Error for SessionError

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 From<Error> for SessionError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<SessionError> for PendingSubmissionError

fn from(source: SessionError) -> Self

Converts to this type from the input type.