Struct StateStore 

pub struct StateStore {
    pub base_path: PathBuf,
}

A filesystem-based persistent state store.

Files are organized as <base_path>/<category>/<name>.md or <base_path>/<category>/<name>.json.

Fields

base_path: PathBuf

Root directory for all state files.

Implementations

impl StateStore

pub fn save_audit_entries(&self, entries: &[AuditEntry]) -> Result<()>

Save audit entries to the state store.

pub fn load_audit_entries(&self) -> Result<Vec<AuditEntry>>

Load audit entries from the state store.

impl StateStore

pub fn new(base_path: PathBuf) -> Result<Self>

Creates a new state store, initializing the directory if needed.

Example

use oxios_kernel::StateStore;
use std::path::PathBuf;

let store = StateStore::new(PathBuf::from("/tmp/oxios-state")).unwrap();

pub async fn save_markdown( &self, category: &str, name: &str, content: &str, ) -> Result<()>

Save a markdown file under the given category.

pub async fn load_markdown( &self, category: &str, name: &str, ) -> Result<Option<String>>

Load a markdown file from the given category.

pub async fn list_category(&self, category: &str) -> Result<Vec<String>>

List all markdown files in a category (names without extension).

pub async fn save_json<T: Serialize>( &self, category: &str, name: &str, data: &T, ) -> Result<()>

Save a serializable value as JSON under the given category.

pub async fn load_json<T: DeserializeOwned>( &self, category: &str, name: &str, ) -> Result<Option<T>>

Load a deserializable value from JSON in the given category.

pub async fn delete_file(&self, category: &str, name: &str) -> Result<bool>

Delete a file from the given category.

impl StateStore

pub async fn save_session(&self, session: &Session) -> Result<()>

Saves a session to the sessions category.

pub async fn load_session( &self, session_id: &SessionId, ) -> Result<Option<Session>>

Loads a session by ID.

pub async fn list_sessions(&self) -> Result<Vec<SessionSummary>>

Lists all sessions (sorted by updated_at descending).

pub async fn delete_session(&self, session_id: &SessionId) -> Result<bool>

Deletes a session by ID.

pub async fn get_or_create_session( &self, user_id: &str, session_id: Option<&SessionId>, ) -> Result<Session>

Gets or creates a session for a user, initializing with the given session ID.

pub async fn update_session(&self, session: &Session) -> Result<()>

Updates an existing session, saving it to disk.

Trait Implementations

impl Clone for StateStore

fn clone(&self) -> StateStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateStore

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

Formats the value using the given formatter.