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_id(&self) -> String

pub fn session_file(&self) -> Option<PathBuf>

pub fn leaf_id(&self) -> Option<String>

pub fn session_name(&self) -> Option<String>

Get the current session name.

pub fn session(&self) -> &Session

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_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_thinking_level_change(&mut self, thinking_level: &str) -> String

pub fn append_model_change(&mut self, provider: &str, model_id: &str) -> String

pub fn append_session_info(&mut self, name: &str) -> String

pub fn append_compaction( &mut self, summary: &str, first_kept_entry_id: &str, tokens_before: u64, details: Option<Value>, from_hook: Option<bool>, ) -> String

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

pub fn append_label_change( &mut self, target_id: &str, label: Option<&str>, ) -> String

pub fn append_custom_entry(&mut self, custom_type: &str, data: Value) -> String

pub fn append_active_tools_change( &mut self, active_tool_names: &[String], ) -> String

pub fn append_custom_message_entry( &mut self, custom_type: &str, content: Value, display: bool, details: Option<Value>, ) -> String

pub fn find_entries_by_type(&self, type_name: &str) -> Vec<SessionEntry>

Find all entries of a given type (pi-compatible).

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

Get all entries (excludes header).

pub fn entry(&self, id: &str) -> Option<SessionEntry>

Look up an entry by id.

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

Get all direct children of an entry.

pub fn branch(&self, from_id: Option<&str>) -> Vec<SessionEntry>

Walk from entry to root, returning all entries in path order.

pub fn build_session_context(&self) -> SessionContext

Build the session context (messages for LLM with compaction handling). Pi-compatible: delegates to Session::build_context.

pub fn label(&self, id: &str) -> Option<String>

Get the label for an entry, if any.

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.

pub fn list_all(session_dir: Option<&Path>) -> Vec<SessionInfo>

List all sessions across all project directories (pi-compatible).