Enum LifecycleEvent 

pub enum LifecycleEvent {
    SessionStart {
        source: Option<String>,
    },
    SessionEnd {
        reason: Option<String>,
    },
    WorkingStart,
    WorkingEnd,
    Idle,
    PromptSubmit {
        prompt: Option<String>,
    },
    NeedsInput {
        reason: NeedsInputReason,
    },
    ToolCallStart {
        name: Tool,
        tool_use_id: Option<String>,
        input: Option<Value>,
    },
    ToolCallEnd {
        name: Tool,
        tool_use_id: Option<String>,
        is_error: bool,
    },
    ContextCompactStart {
        trigger: Option<String>,
    },
    ContextUpdate {
        tokens: Option<u64>,
        cost_usd: Option<f64>,
    },
    ProviderModelChange {
        provider: Option<String>,
        model: Option<String>,
    },
    Notification {
        message: Option<String>,
        kind: Option<NotificationKind>,
    },
    ChildSessionStart {
        id: Option<String>,
        role: Option<String>,
    },
    ChildSessionEnd {
        id: Option<String>,
    },
}

Vendor-neutral lifecycle event.

Adapters translate native vendor events into these variants; the daemon dispatches on them to update session state.

Eq is intentionally not derived: ContextUpdate carries an Option<f64> cost, which is not Eq.

Variants

SessionStart

Session opened. source carries why (Claude: startup/resume/ clear; pi: startup).

Fields

source: Option<String>

SessionEnd

Session closed. reason is vendor-supplied when available (pi session_shutdown.reason; Claude SessionEnd.reason).

Fields

reason: Option<String>

WorkingStart

Agent began a working block. (Pi agent_start; Claude has no direct analog — synthesized from UserPromptSubmit or first PreToolUse.)

WorkingEnd

Agent finished a working block. (Pi agent_end; Claude Stop.)

Idle

Explicit idle signal. Distinct from WorkingEnd because pi can transition idle → idle (no work happened) via ctx.isIdle() && !ctx.hasPendingMessages().

PromptSubmit

User submitted a prompt.

Fields

prompt: Option<String>

NeedsInput

Session is waiting on user input.

Fields

reason: NeedsInputReason

ToolCallStart

A tool started executing.

tool_use_id is the correlation id pairing this with its later ToolCallEnd (Claude tool_use_id, pi toolCallId). input is the tool arguments JSON, when the vendor exposes it.

Fields

name: Tool

tool_use_id: Option<String>

input: Option<Value>

ToolCallEnd

A tool finished executing. tool_use_id matches the originating ToolCallStart.

Fields

name: Tool

tool_use_id: Option<String>

is_error: bool

ContextCompactStart

Context compaction is starting. trigger is the cause (Claude: auto/manual).

Fields

trigger: Option<String>

ContextUpdate

Periodic context-usage update (tokens used, accumulated cost). Either field may be None if the vendor doesn’t expose it.

Fields

tokens: Option<u64>

cost_usd: Option<f64>

ProviderModelChange

Provider or model changed mid-session (pi model_select).

Fields

provider: Option<String>

model: Option<String>

Notification

Free-form notification surfaced to the user. kind carries an optional sub-type the UI can render specially.

Fields

message: Option<String>

kind: Option<NotificationKind>

ChildSessionStart

A child session (subagent / task / fork) started. id is a vendor-supplied correlation id; role is a free-form tag (e.g. Claude subagent role: "explore", "plan").

Fields

id: Option<String>

role: Option<String>

ChildSessionEnd

A child session finished.

Fields

id: Option<String>

Implementations

impl LifecycleEvent

pub fn is_terminal_for_turn(&self) -> bool

True if this event ends/clears the session’s working state.

pub fn is_starting(&self) -> bool

True if this event opens the session’s working state.

Trait Implementations

impl Clone for LifecycleEvent

fn clone(&self) -> LifecycleEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LifecycleEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LifecycleEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for LifecycleEvent

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for LifecycleEvent

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 LifecycleEvent