Struct SessionStore 

pub struct SessionStore { /* private fields */ }

The store of named sessions.

Implementations

impl SessionStore

pub fn open(dir: impl Into<PathBuf>) -> Self

A store rooted at dir. The directory is created lazily on first write.

pub fn default_dir() -> Option<PathBuf>

The default per-user location: $XDG_STATE_HOME/agent-abstraction/sessions (falling back to ~/.local/state), or %LOCALAPPDATA% on Windows. None when neither the platform state dir nor $HOME can be resolved.

pub fn path_of(&self, project: &Path, name: &str) -> PathBuf

The file backing name for project. Pure path arithmetic.

The agent is not part of the key on purpose: one name must resolve to one file across agents, so asking for a Claude session under a name Codex already owns is a loud Error::SessionConflict rather than two unrelated conversations quietly sharing a name.

pub fn get(&self, project: &Path, name: &str) -> Result<Option<SessionRecord>>

The stored record, or None when there is none.

Only a genuinely absent file is Ok(None). A permission error, an I/O failure or a corrupt record is an Error::Store, because treating those as “no session” silently starts a new conversation and abandons one the caller believes they are still in.

Errors

Error::Store if the record exists but cannot be read or parsed.

pub fn list(&self, project: &Path) -> Result<Vec<SessionRecord>>

Every session recorded for project, in unspecified order.

A record that cannot be read or parsed is an error rather than an omission: silently returning a short list makes a corrupt store look like a store with fewer sessions. Use SessionStore::list_lossy when skipping bad records is genuinely what you want.

Errors

Error::Store if the directory or any record within it is unreadable.

pub fn list_lossy(&self, project: &Path) -> Vec<SessionRecord>

Every readable session for project, skipping any that are not.

The deliberately lossy counterpart to SessionStore::list, for a UI that would rather show the sessions it can than fail the whole listing.

pub fn bind( &self, agent: Agent, project: &Path, name: &str, token: &str, ) -> Result<SessionRecord>

Record token as the handle for name, preserving the original creation time when the session already existed.

Errors

Error::Store if the record cannot be written.

pub fn forget(&self, project: &Path, name: &str) -> Result<()>

Drop the binding for name. Removing an absent session is not an error.

Errors

Error::Store if an existing record cannot be removed.

Trait Implementations

impl Clone for SessionStore

fn clone(&self) -> SessionStore

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SessionStore

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.