Struct Transcript 

pub struct Transcript {
    pub text: Arc<str>,
    pub role: Role,
    pub finality: Finality,
}

A piece of conversation text flowing through the pipeline: speech-to-text output, language-model output, or text bound for TTS.

The stable-prefix invariant

For a given utterance (a Role::User unit) or generation (a Role::Agent unit), the bytes text[..stable] never change across successive partials: once a prefix is declared stable it is frozen, and only the tail beyond stable may be revised or grow. Downstream stages rely on this to commit settled text early instead of waiting for Finality::Final.

stable is a byte index into text and must lie on a char boundary. STT partials revise their tail, so stable <= text.len(); LM partials are append-only, so stable == text.len(). A Finality::Final transcript carries no stable — the whole text is settled.

Fields

text: Arc<str>

The transcript text so far. For a Finality::Partial this is the current best guess; only text[..stable] is guaranteed frozen.

role: Role

Who produced this text — Role::User (STT) or Role::Agent (LM).

finality: Finality

Whether this is an in-progress Finality::Partial or the completed Finality::Final unit.

Implementations

impl Transcript

pub fn user_partial(text: impl Into<Arc<str>>, stable: usize) -> Self

An in-progress user (STT) transcript: the first stable bytes of text are frozen and its tail may still be revised.

stable must be <= text.len() and lie on a char boundary; both are debug-asserted.

pub fn user_final(text: impl Into<Arc<str>>) -> Self

A completed user utterance.

pub fn agent_partial(text: impl Into<Arc<str>>) -> Self

An in-progress agent (LM) transcript. LM output is append-only, so the entire current text is stable (stable == text.len()).

pub fn agent_final(text: impl Into<Arc<str>>) -> Self

A completed agent generation.

Trait Implementations

impl Clone for Transcript

fn clone(&self) -> Transcript

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Transcript

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

Formats the value using the given formatter.

impl From<Transcript> for DataFrame

fn from(transcript: Transcript) -> Self

Wrap a Transcript as a DataFrame::Transcript so a stage can write Transcript::user_final(text).into() instead of naming the variant.

impl PartialEq for Transcript

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Transcript