Struct Session 

pub struct Session {
    pub id: String,
    pub cwd: String,
    pub messages: Vec<Value>,
    /* private fields */
}

Manages session state and persistence.

Fields

id: String

cwd: String

messages: Vec<Value>

Implementations

impl Session

pub fn new(cwd: impl Into<String>) -> Self

Create a new session with a generated ID.

pub fn with_id(id: impl Into<String>, cwd: impl Into<String>) -> Self

Create a session with a specific ID.

pub fn with_home(self, home: impl Into<PathBuf>) -> Self

Set an explicit home directory override (useful for testing).

pub fn sessions_dir(cwd: &str) -> PathBuf

Get the path where sessions are stored for a given working directory.

pub fn sessions_dir_with_home(cwd: &str, home: PathBuf) -> PathBuf

Get the sessions directory using an explicit home path.

pub fn transcript_path(&self) -> PathBuf

Get the file path for this session’s transcript.

pub async fn append_message(&self, message: &Value) -> Result<()>

Append a JSON message to the transcript file on disk.

Creates the sessions directory and file if they don’t exist. The message is serialized as a single JSON line followed by a newline.

pub async fn load_messages(&self) -> Result<Vec<Value>>

Load all messages from the transcript file.

Returns an empty vec if the file does not exist. Skips any lines that fail to parse as JSON, logging a warning.

Trait Implementations

impl Debug for Session

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

Formats the value using the given formatter.