Struct SessionContext 

pub struct SessionContext {
    pub session_id: String,
    pub session_dir: PathBuf,
    pub base_dir: PathBuf,
    pub is_new_session: bool,
    /* private fields */
}

Session context — holds the session ID, directory, base directory, and file lock.

Created via resolve_session. The lock is released when the struct is dropped.

Fields

session_id: String

Session identifier (user-provided or auto-generated).

session_dir: PathBuf

Path to the session directory on disk.

base_dir: PathBuf

Base directory for all session data.

is_new_session: bool

Whether this session was just created (vs reused).

Implementations

impl SessionContext

pub fn session_id_path(&self) -> PathBuf

Path to the session ID marker file.

pub fn metadata_path(&self) -> PathBuf

Path to the session metadata JSON file.

pub fn log_path(&self) -> PathBuf

Path to the session log file (human-readable).

pub fn turn_path(&self, turn: usize) -> PathBuf

Path to the per-turn JSONL event log. turn is 1-indexed.

pub fn messages_jsonl_path(&self) -> PathBuf

Path to the messages.jsonl window snapshot (one ChatMessage per line).

pub fn last_turn_number(&self) -> u32

Highest turn number already logged for this session (0 if none).

Scans session_dir for turn_NNN.jsonl files and returns the max N. Consumers that persist per-turn logs should initialize their turn counter from this value (then increment) so that reusing a session id across process runs continues the turn sequence instead of resetting to 1 and appending a later run’s turn_001.jsonl into an earlier one.

Trait Implementations

impl Debug for SessionContext

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

Formats the value using the given formatter.