Struct StateApi 

pub struct StateApi {
    pub prune_throttle: PruneThrottle,
    /* private fields */
}

State management system calls.

All data persistence: file (JSON/Markdown) storage, session management.

Fields

prune_throttle: PruneThrottle

Throttle for auto-prune to avoid excessive disk scans.

Implementations

impl StateApi

pub fn new(state_store: Arc<StateStore>) -> Self

Create a new StateApi.

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

Save JSON data.

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

Save markdown content.

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

Load JSON data.

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

Load markdown content.

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

Delete a file.

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

List files in a category.

pub fn commit_all( &self, git: &GitLayer, message: &str, ) -> Result<Option<CommitInfo>>

Commit all changes to git via the provided GitLayer.

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

Save session.

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

Load session.

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

List sessions.

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

Delete session.

pub fn workspace_path(&self) -> &Path

Get workspace base path.

pub fn store(&self) -> &Arc<StateStore>

Access the underlying StateStore (for backup/restore).

pub async fn prune_sessions(&self, config: &PruneConfig) -> Result<usize>

Prune sessions based on configuration.

Removes sessions that exceed TTL or exceed the maximum count.

pub fn should_auto_prune(&self) -> bool

Check if auto-prune should run (respects cooldown throttle).