Struct JsonFileHistoryStore 

pub struct JsonFileHistoryStore { /* private fields */ }

JSON-backed HistoryStore that writes the full snapshot to a single file. save pretty-prints; load returns Ok(None) when the file does not exist (first run) so callers can seed an empty conversation without branching on the missing-file case.

Implementations

impl JsonFileHistoryStore

pub fn new(path: impl Into<PathBuf>) -> JsonFileHistoryStore

Bind the store to path. The file is not opened until save or load runs; constructing the store cannot fail.

pub fn path(&self) -> &Path

Path the store reads from / writes to.

Trait Implementations

impl HistoryStore for JsonFileHistoryStore

type Error = JsonFileHistoryStoreError

Error type surfaced from save / load. Use std::convert::Infallible when the implementation cannot fail (see InMemoryHistoryStore).

fn save<'life0, 'life1, 'async_trait>( &'life0 self, snapshot: &'life1 ConversationSnapshot, ) -> Pin<Box<dyn Future<Output = Result<(), <JsonFileHistoryStore as HistoryStore>::Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, JsonFileHistoryStore: 'async_trait,

Persist snapshot so a later load returns it. Implementations should treat this as an overwrite — the façade passes the full updated ConversationSnapshot every time rather than diffing.

fn load<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Option<ConversationSnapshot>, <JsonFileHistoryStore as HistoryStore>::Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, JsonFileHistoryStore: 'async_trait,

Return the most recently persisted snapshot, or Ok(None) when the store has never been written to. Returning Ok(None) lets callers default-init the conversation on first run instead of special-casing a missing payload.