Struct SessionStore 

pub struct SessionStore { /* private fields */ }

Session store — holds in-memory state and manages file persistence.

Implementations

impl SessionStore

pub fn new(source_file: &str) -> Self

Create a new session store. Loads existing persistent data if present.

pub fn flush(&self) -> Result<(), String>

Flush persistent store to disk.

pub fn remember(&mut self, key: &str, value: &str, source_step: &str)

Store a value in ephemeral memory.

pub fn recall(&self, key: &str) -> Option<&MemoryEntry>

Recall a value from ephemeral memory. Returns None if not found.

pub fn memory_entries(&self) -> Vec<&MemoryEntry>

List all ephemeral memory entries.

pub fn persist(&mut self, key: &str, value: &str, source_step: &str)

Persist a value to the file-backed store.

pub fn retrieve(&self, key: &str) -> Option<&MemoryEntry>

Retrieve a value from the file-backed store.

pub fn retrieve_query(&self, query: &str) -> Vec<&MemoryEntry>

Retrieve all entries matching a simple query (substring match on key or value).

pub fn mutate(&mut self, key: &str, new_value: &str, source_step: &str) -> bool

Mutate (update) an existing entry in the store. Returns true if the key existed and was updated.

pub fn purge(&mut self, key: &str) -> bool

Purge (delete) an entry from the store. Returns true if the key existed and was removed.

pub fn purge_query(&mut self, query: &str) -> usize

Purge all entries matching a query (substring match). Returns the number of entries removed.

pub fn store_count(&self) -> usize

Number of entries in the persistent store.

pub fn memory_count(&self) -> usize

Number of entries in ephemeral memory.

pub fn store_path(&self) -> &Path

Path to the store file (for display).

Trait Implementations

impl Debug for SessionStore

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

Formats the value using the given formatter.