Struct FileSystemSessionStore 

pub struct FileSystemSessionStore { /* private fields */ }

Filesystem-backed SessionStore with advisory locking and atomic writes.

Writes go through a tmp file in the same directory followed by std::fs::rename, which is atomic on POSIX. An exclusive advisory lock on a .lock sidecar serialises writers; readers are unsynchronised because the atomic rename guarantees a complete file is always visible. On contention, save() retries for up to LOCK_RETRY_BUDGET (5 s) before returning SessionError::Locked.

Implementations

impl FileSystemSessionStore

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

Construct a store rooted at dir. The directory is created lazily on first save.

pub fn dir(&self) -> &Path

Return the storage root directory.

Trait Implementations

impl SessionStore for FileSystemSessionStore

fn save<'life0, 'life1, 'async_trait>( &'life0 self, session: &'life1 Session, ) -> Pin<Box<dyn Future<Output = Result<(), SessionError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Persist a session, replacing any existing record with the same session_id.

fn load<'life0, 'life1, 'async_trait>( &'life0 self, session_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Session, SessionError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Load a session by id. Returns SessionError::NotFound if absent.

fn list_ids<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<String>, SessionError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List all session ids known to this store.

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, session_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), SessionError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Delete a session by id. Returns SessionError::NotFound if absent.

fn list_for_agent<'life0, 'life1, 'async_trait>( &'life0 self, agent_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Vec<Session>, SessionError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Load every session belonging to agent_id. Default impl iterates list_ids + load; override for stores that can serve this from an index.