Struct PartialSession 

pub struct PartialSession { /* private fields */ }

Host-driven partial STT session state.

Typical loop:

1. push mic chunks
2. if should_decode_partial, host runs STT on partial_window_samples()
3. call on_decode_result with the transcript text
4. on release, finalize with a definitive full-window decode

Implementations

impl PartialSession

pub fn new(config: PartialSessionConfig) -> Self

pub fn dictation() -> Self

Dictation-oriented defaults.

pub fn config(&self) -> &PartialSessionConfig

pub fn buffer(&self) -> &PcmBuffer

pub fn buffer_mut(&mut self) -> &mut PcmBuffer

pub fn stable_text(&self) -> &str

pub fn is_closed(&self) -> bool

pub fn push(&mut self, chunk: &[f32]) -> Result<()>

Push mono 16 kHz samples into the ring buffer.

pub fn should_decode_partial(&self) -> bool

Whether the host should start a partial decode now.

pub fn partial_window_samples(&self) -> ContiguousOwned

Contiguous PCM for the current partial window (host passes to STT).

pub fn begin_partial(&mut self) -> Option<CancelFlag>

Begin a partial: marks the clock, increments inflight, returns cancel token.

Supersedes any previous inflight cancel token (cooperative cancel).

pub fn on_decode_result( &mut self, raw_text: &str, latency_ms: Option<u64>, ) -> PartialUpdate

Host delivers a partial decode result (or error → call Self::end_partial).

pub fn end_partial(&mut self)

Mark a partial as finished without a text update (cancel/error).

pub fn finalize( &mut self, final_text: &str, latency_ms: Option<u64>, ) -> PartialUpdate

Final decode path: host supplies definitive transcript for the full buffer.

pub fn cancel(&mut self) -> PartialUpdate

Cancel the session and any in-flight partial.