Struct TranscriptStats 

pub struct TranscriptStats {

    pub requests: u64,
    pub pass_through: u64,
    pub viewed: u64,
    pub flushes: u64,
    pub consolidations: u64,
    pub summarizer_calls: u64,
    pub summarizer_failures: u64,
    pub log_messages: usize,
    pub sectioned_messages: usize,
    pub sections: usize,
    pub block_bytes: usize,
    pub band_bytes: usize,
    pub tail_bytes: usize,
    pub log_bytes: usize,
    pub log_content: LogContent,
    pub input_tokens: u64,
    pub cached_input_tokens: u64,
    pub output_tokens: u64,
    pub usage: UsageBreakdown,
}

The compaction’s benchmark snapshot: what the view has been doing, and what the providers’ own usage says about the prefix cache. All counters run from the transcript’s construction; a resumed session keeps its run continuous by folding the saved counters in with TranscriptStats::carry. The struct is the saved shape: the frontend serializes it into the session file verbatim.

Fields

requests: u64

Requests the decorator forwarded.

pass_through: u64

Requests below the budget, sent byte-identical: the whole prefix a cache holds.

viewed: u64

Requests carrying the compaction block plus the whole band.

flushes: u64

Flushes: cut movements, the only moments the view’s prefix breaks.

consolidations: u64

Consolidations: block rewrites past the block cap, each one a full cache break.

summarizer_calls: u64

Summarizer calls issued, successes and failures together.

summarizer_failures: u64

Summarizer calls that failed; each left the extractive stand-in in place.

log_messages: usize

The mirror’s message count at the last request.

sectioned_messages: usize

Messages under the block at the last request: the cut.

sections: usize

The block’s section count at the last request.

block_bytes: usize

The block’s bytes at the last request.

band_bytes: usize

The bytes carried whole from the cut to the log’s end, at the last request.

tail_bytes: usize

The current turn’s bytes at the last request.

log_bytes: usize

The log’s wire bytes at the last request — what the conversation actually holds, each message counted once. The usage split below sums the same content once per request; this is the once.

log_content: LogContent

The log’s bytes by category at the last request, counted once.

input_tokens: u64

Input tokens the providers reported, summed over requests — cached tokens included.

cached_input_tokens: u64

Of those, the tokens the provider served from its prompt cache.

output_tokens: u64

Output tokens the providers reported, summed over requests.

usage: UsageBreakdown

The session’s usage split by category.

Implementations

impl TranscriptStats

pub fn cache_hit_rate(&self) -> Option<f64>

The session’s prompt-cache hit rate: cached input over all input. None before any usage was reported. The providers’ own numbers — the ground truth the stepped design optimizes.

pub fn carry(&mut self, saved: &Self)

Folds a saved session’s counters in, so a resumed session’s stats read as one run with the pre-resume requests included: the run counters and the usage split sum, the cache rate keeps covering everything. The at-last-request snapshots describe the mirror that measured them, so they stay this side’s — except while this mirror has not looked at a log yet (log_messages == 0), where the snapshot is what a Usage page opened before the first request would otherwise render as zeros, and the saved one is the honest figure.

Trait Implementations

impl Clone for TranscriptStats

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TranscriptStats

impl Debug for TranscriptStats

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

Formats the value using the given formatter.

impl Default for TranscriptStats

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TranscriptStats

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TranscriptStats

impl PartialEq for TranscriptStats

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for TranscriptStats

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TranscriptStats