Struct RingTraceStore 

pub struct RingTraceStore { /* private fields */ }

The built-in bounded sink: FIFO ring (global) + per-scope cap + per-session index. Thread-safe; queries are consistent snapshots.

Implementations

impl RingTraceStore

pub fn new() -> Self

A store with default bounds (2048 records, 512 per scope).

pub fn with_capacity(cap: usize, per_scope_cap: usize) -> Self

pub fn clear(&self)

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn aggregate(&self, f: &TraceFilter) -> Vec<TraceStats>

Aggregate statistics, grouped by (provider, model), filtered.

pub fn session_chain(&self, session_id: &str) -> Option<SessionChainView>

Session chain view: ordered record ids + prefix stability + breaks.

pub fn session_cache_trajectory(&self, session_id: &str) -> Vec<SessionStepStat>

Per-step cache-hit trajectory of a session (RFC-0024 §4.3 session_cache_trajectory): one SessionStepStat per call, in session order, with the reported hit rate and audit verdict (when an auditor is attached). Empty for unknown sessions.

pub fn export_jsonl(&self, w: &mut impl Write) -> Result<()>

Export all records as JSONL (one TraceRecord per line).

Errors

Returns an I/O error (JSON serialization failures included) when serializing a record or writing a line fails.

Trait Implementations

impl Default for RingTraceStore

fn default() -> Self

Returns the “default value” for a type.

impl TraceSink for RingTraceStore

fn record(&self, rec: TraceRecord)

fn as_any(&self) -> &dyn Any

Downcast support (the layer uses this to reach the LCP index of a RingTraceStore sink).

fn flush(&self)