Enum SessionError 

pub enum SessionError {
    Io(Error),
    Serde(Error),
    Db(SqlxError),
    NotFound(String),
    InvalidForkPoint(String),
    CondensationOverlap(String),
    Llm(LlmError),
    AlreadyLocked {
        path: String,
        pid: Option<u32>,
        pid_alive: Option<bool>,
    },
    InvalidBlobHash(String),
    Integrity(String),
}

Errors produced by the session persistence, replay, and fork engines.

Variants

Io(Error)

Filesystem I/O failed while reading or appending to an event log.

Serde(Error)

A SessionEvent line failed to (de)serialize.

Db(SqlxError)

The acp_sessions metadata store returned a database error.

NotFound(String)

A lookup by zeph_common::SessionId found no matching session.

InvalidForkPoint(String)

A fork was requested at a seq beyond the source session’s last_seq.

CondensationOverlap(String)

A condensation or compaction range overlapped a previously replaced range (INV-SP-4).

Llm(LlmError)

Condensation summarization failed (LLM call error or timeout).

AlreadyLocked

crate::log::SessionEventLog::open_exclusive found another process already holding the session’s advisory write lock.

Fields

path: String

Path to the contended lock file.

pid: Option<u32>

PID of the process holding the lock, read back from the lock file’s contents at contention time. None if the file was empty or its contents could not be parsed as a PID (e.g. the lock was acquired by a build predating PID recording).

pid_alive: Option<bool>

Whether pid was confirmed still running via a liveness check (kill(pid, 0)) at contention time. None if pid is None, or on non-Unix targets where no liveness check runs.

InvalidBlobHash(String)

A UserMessage.image_refs entry was not a bare hex string, so it was rejected before being joined into a filesystem path (#5982 follow-up, path-traversal guard).

Integrity(String)

A session event log’s hash chain failed to verify (issue #6360): a definite tamper verdict, a partial strip of chain metadata, an unverifiable/possibly-re-keyed chain, an internal (non-trailing) malformed line masquerading as a torn crash-recovery tail, or a chained log read with no history-integrity key configured. Distinct from SessionError::Serde (JSON-syntax errors) because a chain break always escalates to a hard failure and — critically — must be detected and reported before any torn-tail repair runs, so a mid-file tamper is never silently auto-truncated away as ordinary crash recovery (S1).

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

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SessionError

fn from(source: SqlxError) -> Self

Converts to this type from the input type.

impl From<LlmError> for SessionError

fn from(source: LlmError) -> Self

Converts to this type from the input type.