Struct SessionIndex 

pub struct SessionIndex {
    sessions: Mutex<HashMap<String, SessionMeta>>,
    adapters: Vec<Box<dyn HistoryAdapter>>,
    isolated_roots: Vec<PathBuf>,
}

In-memory index of discovered sessions.

Fields

sessions: Mutex<HashMap<String, SessionMeta>>

session_id -> SessionMeta

adapters: Vec<Box<dyn HistoryAdapter>>

Adapters for all registered providers

isolated_roots: Vec<PathBuf>

Roots under which destructive ops (delete/clear) are allowed.

Implementations

impl SessionIndex

pub fn new(adapters: Vec<Box<dyn HistoryAdapter>>) -> Self

pub fn with_isolated_roots( adapters: Vec<Box<dyn HistoryAdapter>>, isolated_roots: Vec<PathBuf>, ) -> Self

Construct with explicit isolated roots (used by new() and tests).

fn is_isolated(&self, path: &Path) -> bool

True if path lives under an AgentMux-isolated provider home and is therefore safe to delete. Personal global homes are never isolated.

pub fn refresh(&self) -> (u32, u32, u32)

Full scan: discover all files and extract metadata. Returns (discovered, updated, new) counts.

pub fn list( &self, provider: Option<&str>, project: Option<&str>, offset: usize, limit: usize, sort_by: &str, sort_dir: &str, ) -> (Vec<SessionMeta>, u32, bool)

List sessions with pagination and optional filters.

pub fn get_meta(&self, session_id: &str) -> Option<SessionMeta>

Get a session by ID — returns just the meta from index.

pub fn get_full( &self, session_id: &str, ) -> Result<Option<HistorySession>, HistoryError>

Full parse of a session by ID.

pub fn is_empty(&self) -> bool

Check if the index has been populated.

pub fn delete(&self, session_id: &str) -> Result<bool, HistoryError>

Delete a session: remove its on-disk transcript (and the sibling <session_id>/ subagents dir Claude keeps next to it) and drop it from the index. Returns Ok(true) if a file was removed, Ok(false) if the session id is unknown.

pub fn clear(&self, provider: Option<&str>, project: Option<&str>) -> u32

Bulk-delete all indexed sessions matching the optional provider/project filter (no filter = clear everything). Returns the number removed.