Struct BufferedSessionArchive 

pub struct BufferedSessionArchive { /* private fields */ }

Background archive writer used from the terminal event loop.

The handle only serializes events and queues commands; all filesystem work happens on its worker thread. Queued journal lines and metadata edits are retried until flush or drop makes them durable, and the entry’s updated_at advances at each successful boundary that received events so the session browser can order by last activity.

Implementations

impl BufferedSessionArchive

pub fn id(&self) -> &str

pub fn append(&self, event: &ArchiveEvent) -> Result<(), PersistenceError>

Serialize and queue one journal record without filesystem I/O in the caller.

pub fn append_human( &self, text: impl Into<String>, direct: bool, ) -> Result<(), PersistenceError>

pub fn append_agent(&self, event: &AgentEvent) -> Result<(), PersistenceError>

pub fn replace_metadata( &self, metadata: SessionMetadata, ) -> Result<(), PersistenceError>

Queue a complete provider metadata snapshot, retaining unknown keys.

pub fn update_metadata<F>(&self, apply: F) -> Result<(), PersistenceError>

where F: FnOnce(&mut SessionMetadata) + Send + 'static,

Queue an in-place provider metadata edit, preserving unknown keys.

pub fn update_entry<F>(&self, apply: F) -> Result<(), PersistenceError>

where F: FnOnce(&mut ArchiveEntry) + Send + 'static,

Queue an archive entry edit (title, state, roster). The session id is pinned to the directory and titles stay bounded.

pub fn touch(&self) -> Result<(), PersistenceError>

Queue an activity timestamp update.

pub fn checkpoint(&self) -> Result<(), PersistenceError>

Request a durable checkpoint without blocking the UI.

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

Drain queued records and metadata edits and make them durable.

Trait Implementations

impl Debug for BufferedSessionArchive

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

Formats the value using the given formatter.

impl Drop for BufferedSessionArchive

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.