Struct SessionManager 

pub struct SessionManager { /* private fields */ }

Manages session persistence, indexing, and resume.

Implementations

impl SessionManager

pub fn new(workspace: &Path) -> Result<Self, MemoryError>

Create a new session manager for the given workspace.

pub fn with_dir(sessions_dir: PathBuf) -> Result<Self, MemoryError>

Create a new session manager with a custom sessions directory.

pub fn with_encryption(self, encryptor: SessionEncryptor) -> Self

Enable encryption for session data using the provided encryptor.

pub fn start_session(&mut self, name: Option<&str>) -> SessionEntry

Start a new session with an optional name.

pub fn save_checkpoint( &mut self, memory: &MemorySystem, total_tokens: usize, ) -> Result<(), MemoryError>

Save the current state of a memory system to the active session.

pub fn complete_session( &mut self, summary: Option<String>, ) -> Result<(), MemoryError>

Mark the active session as completed.

pub fn resume_session( &mut self, query: &str, ) -> Result<(MemorySystem, String), MemoryError>

Resume a session by name or ID. Returns the loaded MemorySystem and a continuation prompt to inject into the agent.

pub fn resume_latest(&mut self) -> Result<(MemorySystem, String), MemoryError>

Resume the most recent session.

pub fn list_sessions(&self, limit: usize) -> Vec<&SessionEntry>

List recent sessions.

pub fn rename_session( &mut self, query: &str, new_name: &str, ) -> Result<(), MemoryError>

Rename a session.

pub fn delete_session(&mut self, query: &str) -> Result<String, MemoryError>

Delete a session (removes data file and index entry).

pub fn active_session_id(&self) -> Option<Uuid>

Get the active session ID.

pub fn sessions_dir(&self) -> &Path

Get the sessions directory path.

pub fn index(&self) -> &SessionIndex

Get a reference to the session index.

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

Find incomplete sessions (not completed, with at least one message). Useful for crash recovery — shows sessions that were interrupted.

pub fn search(&self, query: &str) -> Vec<&SessionEntry>

Search sessions by matching query against name, goal, summary, and tags. Returns empty vec for empty/whitespace-only queries.

pub fn filter_by_tag(&self, tag: &str) -> Vec<&SessionEntry>

Filter sessions by tag.

pub fn tag_session(&mut self, query: &str, tag: &str) -> Result<(), MemoryError>

Add a tag to a session.