Struct SessionEventLog 

pub struct SessionEventLog { /* private fields */ }

Canonical append-only event log for a single session.

All session history is reconstructable from this log. Live conversation state is never read back into context from here; the log is only consumed for revert, compaction, analytics, and long-term-learning queries.

Implementations

impl SessionEventLog

pub fn open_with_eviction_summary( workspace: &Path, session_id: &str, max_events: usize, eviction_summary_hook: EvictionSummaryHook, ) -> Result<Self, SessionStoreError>

Open a log with an explicit eviction-summary callback.

This is useful for hosts that keep derived memory in another store and for deterministic failure-path tests. The callback must persist its summary before returning Ok(()).

pub fn append(&self, event: &ThreadEvent) -> Result<(), SessionStoreError>

Append an event to the log and update the in-memory index/manifest.

pub fn event_count(&self) -> u64

Number of events recorded.

pub fn visit_snapshot<F>( &self, visitor: F, ) -> Result<SessionManifest, SessionStoreError>

where F: FnMut(u64, &[u8]),

Flush pending event bytes and metadata to the session store. Visit one consistent retained range, including records outside turns. Reads are streamed while cap rewrites and appends are excluded.

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

Flush pending event bytes and metadata to the session store.

pub fn manifest(&self) -> SessionManifest

Snapshot of the session manifest.

pub fn turn_index(&self) -> TurnIndex

Snapshot of the turn index.

Trait Implementations

impl Drop for SessionEventLog

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.