Struct Folio 

pub struct Folio {
    pub source: PathBuf,
    pub recorded: Vec<Recorded>,
}

One rendered session: the unit the tool turns into a single HTML file.

Fields

source: PathBuf

recorded: Vec<Recorded>

The session as read, in file order, so a harness note keeps its place among the turns it stands between.

Implementations

impl Folio

pub fn read(source: &Path) -> Result<Self>

Reads a session JSONL file, keeping the lines that carry conversation and the notes the harness wrote around them.

pub fn turns(&self) -> impl Iterator<Item = &Turn>

The conversation alone, for the figures that are about what the model was sent and what it wrote.

pub fn session_id(&self) -> &str

pub fn peek(source: &Path) -> SessionPeek

Cheaply scans a session’s listing metadata (its title and working directory) without parsing the conversation, tolerating malformed lines so one bad session never breaks a picker that lists every session. This is deliberately lenient where Folio::read is strict: a label is best-effort, a render is not.

pub fn output(&self) -> Option<u64>

The output across the session, or None when no turn reports usage. Output totals, since each turn produces its own.

pub fn largest_input(&self) -> Option<u64>

The largest input any one turn took, or None when no turn reports usage: how big the conversation ever got. A high-water mark rather than a sum, since every turn is sent the whole conversation and summing that would count the same text once per turn that saw it.

pub fn panels(&self) -> Vec<Panel>

Folds the raw stream into the display one: drops /clear boundaries, merges each tool-result turn back into the assistant turn it answers so a call and its result render as one panel, and lifts the turns the harness wrote for itself out of the conversation and into glosses.

Trait Implementations

impl Debug for Folio

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

Formats the value using the given formatter.