Enum SessionState 

pub enum SessionState {
    Starting,
    Working,
    Idle,
    WaitingForInput,
    WaitingForPermission,
    Ended,
}

The coarse, inferred lifecycle state of a Claude Code session.

Serialized snake_case (waiting_for_permission, …) into list/status payloads. waiting_for_* are reliable (a Notification hook fires them directly); working/idle are best-effort inference from PreToolUse / Stop plus the transcript-growth backstop (Claude Code ships no dedicated state event — ADR-0052).

Variants

Starting

Session just started (SessionStart), before any turn.

Working

Actively processing a turn — a tool call (PreToolUse/PostToolUse), a submitted prompt (UserPromptSubmit), or observed transcript growth.

Idle

Finished a turn and waiting at the prompt (Stop).

WaitingForInput

Blocked on the user for a plain input/idle notification.

WaitingForPermission

Blocked on the user to approve a tool/permission prompt.

Ended

The session ended (SessionEnd); reaped shortly after via [ENDED_SESSION_TTL].

Implementations

impl SessionState

pub fn for_event(event: &SessionEvent, current: Option<Self>) -> Self

The state a sighting of event implies, given the session’s current state (None for a brand-new session). This is the whole inference machine, kept in one testable place:

• SessionStart → Starting
• UserPromptSubmit / PreToolUse / PostToolUse → Working
• TranscriptGrew → Working, except while WaitingForInput / WaitingForPermission / Ended, which it leaves unchanged — growth is expected in those states without the session doing anything, so it is not evidence the turn resumed (#1418)
• Stop → Idle
• Notification(PermissionPrompt) → WaitingForPermission
• Notification(IdlePrompt | AgentNeedsInput) → WaitingForInput
• Notification(Other) → unchanged (an unclassified notification is not evidence of a state change)
• TranscriptDiscovered → the current state if known, else Idle (a passively-discovered session’s activity is unknown; a later hook or growth upgrades it)
• StreamState(s) → s verbatim (an authoritative stream-json report; the only non-inferred variant — see ADR-0057)

Trait Implementations

impl Clone for SessionState

fn clone(&self) -> SessionState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SessionState

impl Debug for SessionState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SessionState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SessionState

impl PartialEq for SessionState

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SessionState

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 SessionState