Struct SessionStore 

pub struct SessionStore { /* private fields */ }

Session store for persistence.

Directory creation is lazy — the sessions directory is only created on the first call to save, not at construction time.

Implementations

impl SessionStore

pub fn new(sessions_dir: impl AsRef<Path>) -> Self

Create a new session store pointing at an explicit directory.

The directory is not created immediately — it will be created lazily on the first save.

pub fn from_home(home: &AstridHome) -> Self

Create a session store from an AstridHome.

Sessions will be stored in ~/.astrid/sessions/. The directory is created lazily on first save.

pub fn save(&self, session: &AgentSession) -> RuntimeResult<()>

Save a session atomically.

Writes to a temporary file first, then renames. This prevents corruption if the process crashes mid-write (session auto-saves after every turn).

Errors

Returns an error if the session cannot be serialized or written to disk.

pub fn load(&self, id: &SessionId) -> RuntimeResult<Option<AgentSession>>

Load a session by ID.

Errors

Returns an error if the session file cannot be read or deserialized.

pub fn load_by_str(&self, id: &str) -> RuntimeResult<Option<AgentSession>>

Load a session by ID string.

Errors

Returns an error if the ID is not a valid UUID or the session cannot be loaded.

pub fn delete(&self, id: &SessionId) -> RuntimeResult<()>

Delete a session.

Errors

Returns an error if the session file cannot be deleted.

pub fn list(&self) -> RuntimeResult<Vec<SessionId>>

List all session IDs, sorted by modification time (most recent first).

Returns an empty list if the sessions directory does not exist yet.

Errors

Returns an error if the sessions directory cannot be read.

pub fn list_with_metadata(&self) -> RuntimeResult<Vec<SessionSummary>>

List sessions with metadata.

Errors

Returns an error if the sessions directory cannot be read.

pub fn most_recent(&self) -> RuntimeResult<Option<AgentSession>>

Get the most recent session.

Errors

Returns an error if the sessions cannot be listed or loaded.

pub fn list_for_workspace( &self, workspace: &Path, ) -> RuntimeResult<Vec<SessionSummary>>

List sessions filtered by workspace path.

Only returns sessions whose workspace_path matches the given path.

Errors

Returns an error if sessions cannot be listed or loaded.

pub fn cleanup_old(&self, max_age_days: i64) -> RuntimeResult<usize>

Clean up old sessions (older than N days).

Errors

Returns an error if the sessions cannot be listed.