Enum SessionEvent 

pub enum SessionEvent {
    SessionStarted {
        session_id: String,
        cwd: String,
        provider_name: String,
        model: String,
        forked_from: Option<(String, u64)>,
    },
    UserMessage {
        text: String,
        image_refs: Vec<String>,
    },
    AssistantMessage {
        parts: Vec<MessagePart>,
    },
    ToolCall {
        id: String,
        name: String,
        input: Value,
    },
    ToolResult {
        id: String,
        name: String,
        output: String,
        is_error: bool,
        duration_ms: u64,
    },
    Condensation {
        replaced_seq_range: (u64, u64),
        summary: AnchoredSummary,
        tokens_before: u32,
        tokens_after: u32,
    },
    Compaction {
        tier: CompactionTier,
        cleared_count: u32,
        summary: Option<AnchoredSummary>,
    },
    ForkPoint {
        new_session_id: String,
    },
    ModelChanged {
        provider_name: String,
        model: String,
    },
    SessionEnded {
        reason: String,
    },
}

The kind of a persisted conversation-session event.

See specs/068-session-persistence/spec.md §4.3 for the full contract. MessagePart is reused from zeph_llm::provider and AnchoredSummary from zeph_common::memory — this enum MUST NOT redefine either.

Variants

SessionStarted

First event of a session’s log; also written as the header line of a forked child log.

Fields

session_id: String

cwd: String

provider_name: String

model: String

forked_from: Option<(String, u64)>

(parent_session_id, parent_seq_at_fork), set only for forked sessions.

UserMessage

A user turn.

Fields

text: String

image_refs: Vec<String>

Content-hash refs into the session’s blobs/ directory.

AssistantMessage

An assistant turn.

Fields

parts: Vec<MessagePart>

ToolCall

A model-initiated tool invocation.

Fields

id: String

name: String

input: Value

ToolResult

The result of a SessionEvent::ToolCall. Replay never re-executes tools; it folds this recorded output.

Fields

id: String

name: String

output: String

is_error: bool

duration_ms: u64

Condensation

Durable, replayable condensation of a seq range (distinct from live in-memory compaction; see spec §8.1).

Fields

replaced_seq_range: (u64, u64)

[inclusive, inclusive] seq range replaced by summary.

summary: AnchoredSummary

tokens_before: u32

tokens_after: u32

Compaction

Recorded when live hard-compaction fires during a turn, so replay can fold the same prune/summary deterministically.

Fields

tier: CompactionTier

cleared_count: u32

summary: Option<AnchoredSummary>

ForkPoint

Non-destructive provenance record appended to the parent log when a child session is forked from it.

Fields

new_session_id: String

ModelChanged

The active provider/model changed mid-session.

Fields

provider_name: String

model: String

SessionEnded

The session ended; reason is one of user_quit | idle_ttl | shutdown | error.

Fields

reason: String

Trait Implementations

impl Clone for SessionEvent

fn clone(&self) -> SessionEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SessionEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.