Struct Session 

pub struct Session<M>
where
    M: AgentMessage,
{ /* private fields */ }

Session manager: JSONL persistence, history access, context trimming.

Uses Claude Code compatible JSONL format with UUID v7 (time-sortable).

Implementations

impl<M> Session<M>

where M: AgentMessage,

pub fn new(session_dir: &str, max_history: usize) -> Result<Session<M>, Error>

Create a new session with a fresh JSONL file.

Creates the session directory if it doesn’t exist. Returns an error if the directory cannot be created.

pub fn resume(path: &Path, _session_dir: &str, max_history: usize) -> Session<M>

Resume from a specific session file.

pub fn resume_last(session_dir: &str, max_history: usize) -> Option<Session<M>>

Resume the most recent session in the session directory.

pub fn push(&mut self, role: <M as AgentMessage>::Role, content: String) -> &M

Push a message, persist to JSONL, return ref.

pub fn push_msg(&mut self, msg: M)

Push a pre-built message.

pub fn messages(&self) -> &[M]

Access messages.

pub fn messages_mut(&mut self) -> &mut Vec<M>

Mutable access to messages (for external trimming).

pub fn is_empty(&self) -> bool

pub fn len(&self) -> usize

pub fn session_file(&self) -> &Path

pub fn session_id(&self) -> &str

pub fn trim(&mut self) -> usize

Trim history to fit context window.

Preserves system messages and the most recent non-system messages. Inserts a “[N earlier messages trimmed]” system notice. Returns the number of trimmed messages (0 if no trimming needed).