Struct Session 

pub struct Session {
    pub id: u64,
    pub agent: String,
    pub history: Vec<Message>,
    pub created_by: String,
    pub title: String,
    pub uptime_secs: u64,
    pub created_at: Instant,
    pub file_path: Option<PathBuf>,
}

A conversation session tied to a specific agent.

Fields

id: u64

Unique session identifier (monotonic counter, runtime-only).

agent: String

Name of the agent this session is bound to.

history: Vec<Message>

Conversation history (the working context for the LLM).

created_by: String

Origin of this session (e.g. “user”, “tg:12345”).

title: String

Conversation title (set by the set_title tool).

uptime_secs: u64

Accumulated active time in seconds (persisted to meta).

created_at: Instant

When this session was loaded/created in this process.

file_path: Option<PathBuf>

Path to the JSONL persistence file.

Implementations

impl Session

pub fn new( id: u64, agent: impl Into<String>, created_by: impl Into<String>, ) -> Self

Create a new session with an empty history.

pub fn init_file(&mut self, sessions_dir: &Path)

Initialize a new JSONL file in the flat sessions directory.

Creates {sessions_dir}/{agent}_{sender}_{seq}.jsonl with seq auto-incremented globally per identity.

pub fn set_title(&mut self, title: &str)

Set the conversation title and rename the file to include the title slug.

pub fn rewrite_meta(&self)

Rewrite the meta line (first line) of the JSONL file.

pub fn append_messages(&self, messages: &[Message])

Append messages to the JSONL file. Skips auto-injected messages.

pub fn append_compact(&self, summary: &str)

Append a compact marker to the JSONL file.

pub fn load_context(path: &Path) -> Result<(SessionMeta, Vec<Message>)>

Load the working context from a JSONL session file.

Reads from the last {"compact":"..."} marker forward. If no compact marker exists, loads all messages.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.