Enum SessionEntry 

#[non_exhaustive]
pub enum SessionEntry {
    Message(LlmMessage),
    ModelChange {
        from: ModelSpec,
        to: ModelSpec,
        timestamp: u64,
    },
    ThinkingLevelChange {
        from: String,
        to: String,
        timestamp: u64,
    },
    Compaction {
        dropped_count: usize,
        tokens_before: usize,
        tokens_after: usize,
        timestamp: u64,
    },
    Label {
        text: String,
        message_index: usize,
        timestamp: u64,
    },
    Custom {
        type_name: String,
        data: Value,
        timestamp: u64,
    },
}

A single entry in a persisted session.

Serialized with an adjacently-tagged representation: {"entry_type": "...", "data": {...}}. Old-format lines (raw LlmMessage without entry_type) are deserialized as SessionEntry::Message via a custom fallback in SessionEntry::parse.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Message(LlmMessage)

An LLM message (user, assistant, tool result). The only variant sent to the LLM.

ModelChange

Records a model switch during the session.

Fields

from: ModelSpec

to: ModelSpec

timestamp: u64

ThinkingLevelChange

Records a thinking level change.

Fields

from: String

to: String

timestamp: u64

Compaction

Records a context compaction event.

Fields

dropped_count: usize

tokens_before: usize

tokens_after: usize

timestamp: u64

Label

A user bookmark/annotation on a specific message.

Fields

text: String

message_index: usize

timestamp: u64

Custom

Arbitrary structured data for extensibility.

Fields

type_name: String

data: Value

timestamp: u64

Implementations

impl SessionEntry

pub fn parse(line: &str) -> Result<Self, Error>

Parse a JSONL line into a SessionEntry.

If the line has an entry_type field, it is deserialized as a tagged enum. Otherwise, it is treated as a raw LlmMessage (backward compatibility).

pub const fn as_message(&self) -> Option<&LlmMessage>

Returns the contained LlmMessage if this is a Message variant.

pub fn messages(entries: &[Self]) -> Vec<&LlmMessage>

Extract only Message entries from a slice, returning the LlmMessage values.

pub const fn entry_type_name(&self) -> &'static str

Returns the serde discriminator string for this entry variant.

Matches the rename_all = "snake_case" representation used in serialization.

pub const fn timestamp(&self) -> Option<u64>

Returns the timestamp of this entry, if it has one.

Message entries derive their timestamp from the inner LlmMessage.

Trait Implementations

impl Clone for SessionEntry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SessionEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SessionEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.