Struct SessionManager 

pub struct SessionManager { /* private fields */ }

Manages conversation sessions as append-only trees in JSONL files.

Each entry has an id and parentId forming a tree structure. Appending creates a child of the current leaf. Branching moves the leaf to an earlier entry, allowing new branches without modifying history.

Implementations

impl SessionManager

pub fn with_session( session: Session, session_dir: PathBuf, cwd: PathBuf, persist: bool, ) -> Self

Create a SessionManager wrapping an existing Session.

pub fn new_session(&mut self, options: Option<&NewSessionOptions>)

Create a new session (overwrites current entries). Pi-compatible: defers writing to disk until first assistant message.

pub fn ensure_flushed(&mut self)

Ensure the session file has been written (lazy write). Migrates from in-memory to file-backed storage, writing header + all entries. Called before first assistant message.

pub fn is_persisted(&self) -> bool

pub fn cwd(&self) -> &Path

pub fn session_dir(&self) -> &Path

pub fn uses_default_session_dir(&self) -> bool

Returns true if using the default cwd-encoded session directory.

pub fn session(&self) -> &Session

Get the current session name. Get the underlying Session reference.

pub fn session_mut(&mut self) -> &mut Session

Get the underlying Session mutable reference.

pub fn into_session(self) -> Session

Consume and return the inner Session.

pub fn get_leaf_entry(&self) -> Option<SessionEntry>

Get the current leaf entry (pi-compatible).

pub fn get_children(&self, parent_id: &str) -> Vec<SessionEntry>

Get all direct children of an entry (pi-compatible).

pub fn get_header(&self) -> Option<SessionHeader>

Get the session header (pi-compatible).

pub fn get_tree(&self) -> Vec<SessionTreeNode>

Get the session as a tree structure with resolved children and labels (pi-compatible).

pub fn get_entries(&self) -> Vec<SessionEntry>

Get all session entries (excludes header). Pi-compatible.

pub fn append_message(&mut self, message: &AgentMessage) -> String

pub fn append_message_with_cost( &mut self, message: &AgentMessage, cost: f64, ) -> String

Append a message with a pre-computed cost (pi-style). Pi-compatible lazy-write: defer file creation until first assistant message.

pub fn set_branch(&mut self, branch_from_id: &str) -> Result<(), String>

Move leaf pointer to an earlier entry (starts a new branch). Pi-compatible: delegates to Session::set_leaf_id.

pub fn reset_leaf(&mut self)

Reset leaf pointer to null (before any entries).

pub fn branch_with_summary( &mut self, branch_from_id: Option<&str>, summary: &str, details: Option<Value>, from_hook: Option<bool>, ) -> Result<String, String>

Move leaf pointer with a branch summary entry. Pi-compatible: delegates to Session::move_to.

pub fn create(cwd: &Path, session_dir: Option<&Path>) -> Self

Create a new session.

pub fn create_with_options( cwd: &Path, session_dir: Option<&Path>, options: Option<&NewSessionOptions>, ) -> Self

Create a new session with options (pi-compatible).

pub fn open( path: &Path, session_dir: Option<&Path>, cwd_override: Option<&Path>, ) -> Self

Open a specific session file.

pub fn in_memory(cwd: &Path) -> Self

Create an in-memory session (no file persistence).

pub fn continue_recent(cwd: &Path, session_dir: Option<&Path>) -> Self

Continue the most recent session, or create new if none.

pub fn fork_from( source_path: &Path, target_cwd: &Path, session_dir: Option<&Path>, options: Option<&NewSessionOptions>, ) -> Result<Self>

Fork a session from another project directory into the current one. Pi-compatible: creates a new session with the full history from the source session.

pub fn create_branched_session(&mut self, leaf_id: &str) -> Option<PathBuf>

Create a branched session from a specific leaf path. Extracts the linear path from root to leaf into a new session file. Pi-compatible: creates a new session file, preserving labels.