Enum SessionStatus 

pub enum SessionStatus {
    Completed,
    Crashed,
    Interrupted,
    Paused,
    Active,
}

Status of a session. Persisted as a lowercase string.

Backward compatibility has THREE complementary mechanisms, all required for this enum to load files written by every prior build:

1. #[serde(alias = ...)] on individual variants — accepts legacy on-disk strings that map to the same semantic state. For example, Completed accepts both "completed" (current) and "success" (the string the pre-Goal-276 writer emitted). Without these aliases, old session files would silently load as Active (the other catch-all) instead of Completed.

2. #[serde(other)] on the last variant (Active) — catches any unknown string the build does not recognise (e.g. "stalled" written by a future version, or a typo). It MUST stay last; serde requires the catch-all at the end.

3. #[serde(default)] on the field in SessionMeta (see below) — handles a missing status field on disk. Without it, a .meta.json written before the field existed would fail to load.

Aliases handle known legacy values and preserve semantics; #[serde(other)] handles unknown values and degrades safely to Active; the field-level #[serde(default)] handles a missing field. They are distinct and not interchangeable.

New variants added here must:

• Provide aliases for any prior string literals mapping to the same semantic state.
• Keep Active as the LAST variant (the #[serde(other)] arm must remain terminal — moving it earlier is a serde error).

Variants

Completed

Session finished its goal successfully. Legacy alias: "success" (written by cli/resume.rs and main.rs before Goal 276).

Crashed

Session ended because of an unrecoverable error (provider crash, panic, transcript-limit hard stop, etc.). Legacy alias: "incomplete" (written by the pre-Goal-276 finish_status mapping for non-NoMoreToolCalls outcomes).

Interrupted

Session was cancelled by a shutdown signal (SIGINT/SIGTERM). Legacy alias: "cancelled" (the string FinishReason::Cancelled emits via its Display impl; that string was used in cli/session.rs for the interrupt path).

Paused

Session is parked for later resume (e.g. via recursive pause <id>).

Active

Session is the live, currently-running state. Also acts as the catch-all (#[serde(other)]) for unknown on-disk statuses — see the type-level doc comment above.

MUST remain the last variant. Adding a new variant after Active is a compile error; reorder first.

#[default] makes this the Default::default() value, which #[serde(default)] on the field in SessionMeta relies on when a .meta.json file omits the status key. The #[serde(other)] arm above is a separate catch-all for unknown string values — see the type-level doc comment.

Implementations

impl SessionStatus

pub fn for_finish(reason: &FinishReason) -> Self

Map a [FinishReason] to the canonical SessionStatus written when the writer is finalised.

The mapping is EXHAUSTIVE: there is no wildcard arm, so adding a new variant to FinishReason becomes a compile error in this function rather than silently falling back to Crashed. The compiler is the safety net.

Trait Implementations

impl Clone for SessionStatus

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SessionStatus

impl Debug for SessionStatus

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

Formats the value using the given formatter.

impl Default for SessionStatus

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SessionStatus

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SessionStatus

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

Formats the value using the given formatter.

impl Eq for SessionStatus

impl PartialEq for SessionStatus

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SessionStatus

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SessionStatus