Struct FileHistoryProvider 

pub struct FileHistoryProvider { /* private fields */ }

A HistoryProvider that persists to a JSON file on disk, loading any existing history from path on construction and rewriting the whole file after every successful run.

Persistence is atomic and concurrency-safe: after_run serializes the whole append→snapshot→write sequence behind an async write_lock (shared across clones), writes to a temporary sibling file, and atomically renames it into place. The in-memory history is only updated after the on-disk write succeeds, so a failed write never diverges memory from disk, and two concurrent runs sharing cloned providers can’t lose each other’s messages via a snapshot/overwrite race.

Implementations

impl FileHistoryProvider

pub fn new(path: impl Into<PathBuf>) -> Result<FileHistoryProvider, Error>

Open (or create) a file-backed history provider at path. A missing or empty file starts with no history; an existing file is parsed eagerly, so a malformed file fails the constructor rather than silently discarding history.

pub fn path(&self) -> &Path

The path this provider persists to.

pub fn list_messages(&self) -> Vec<Message>

The stored messages, in chronological order.

pub fn to_dict(&self) -> Value

Serialize the stored history to {"messages": [...]}.

Trait Implementations

impl Clone for FileHistoryProvider

fn clone(&self) -> FileHistoryProvider

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ContextProvider for FileHistoryProvider

fn before_run<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 mut SessionContext, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, FileHistoryProvider: 'async_trait,

Called before the model is invoked; mutate ctx to inject instructions, messages, and/or tools. Read ctx.input_messages / ctx.session_id.

fn after_run<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, request_messages: &'life1 [Message], response_messages: &'life2 [Message], error: Option<&'life3 Error>, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, FileHistoryProvider: 'async_trait,

Called after an invocation completes, on BOTH success and failure. On success, error is None and response_messages holds the output. On failure, error is Some and response_messages is empty.

fn is_history_provider(&self) -> bool

Whether this provider manages conversation history (a HistoryProvider). Agent and WorkflowAgent use this to detect an already-attached history provider among a session’s context_providers and avoid auto-attaching a redundant InMemoryHistoryProvider. Defaults to false; history providers override it to true.

impl HistoryProvider for FileHistoryProvider