Struct BlockExtractor 

pub struct BlockExtractor { /* private fields */ }

Implementations

impl BlockExtractor

pub fn new(cap: usize) -> Self

pub fn stamp_yurai(&mut self, y: Yurai) -> bool

Stamp the owning pane’s provenance onto this extractor — write-once, and that is the whole point.

Yurai is documented as a pane’s provenance for its whole life, so a settable field would contradict the type it carries: an agent-spawned pane could re-stamp itself Human mid-session and every block after that point would lie, retroactively laundering the history a freio press is supposed to be able to trust.

So the second call is refused rather than applied. Returns true when this call took effect. A refusal is not an error — re-stamping the SAME provenance is harmless and idempotent — but a refusal that would have CHANGED the value is a caller bug, and the return value is how a caller can notice.

Tier-honest: only-mitigated. Yurai::Automation is a public variant, so in-process code can construct a provenance without holding an attested connection; what is closed here is drift after the fact, not fabrication at the source. Fabrication is bounded by tear_types::Yurai::from_shutai being the only production path, which is convention plus its own tests — not a compile error.

pub fn yurai(&self) -> &Yurai

The provenance every block from this extractor carries.

pub fn set_cwd_from_osc7(&mut self, raw: &str)

Record the shell’s current working directory. Called by the OSC 7 hook in GridState — the next prompt-start stamps this onto the new block. OSC 7 payload is typically file://<host>/path/to/dir; we strip the scheme + host to keep just the absolute path.

pub fn current_cwd(&self) -> Option<&str>

Current OSC 7-set cwd, if any. Surfaced for tests and for renderers that want to display the active directory independent of any open block.

pub fn len(&self) -> usize

Number of completed blocks currently retained.

pub fn is_empty(&self) -> bool

pub fn iter(&self) -> impl Iterator<Item = &Block>

Iterate completed blocks oldest-first.

pub fn get(&self, index: u64) -> Option<&Block>

Fetch a single block by its per-pane index. Returns None when the block has been evicted (index < oldest) or never existed (index > latest completed).

pub fn current(&self) -> Option<&Block>

In-progress block (if any). Useful for live “what’s running right now” introspection.

pub fn on_print(&mut self, c: char)

Append a printable char to whatever phase we’re in. No-op when Idle. Called from the vte Perform::print hook.

pub fn on_raw_byte(&mut self, b: u8)

Append raw bytes (for non-Print events like CR/LF/Esc). The output phase wants the full byte stream so a replayer can reproduce escape sequences. Phases Prompt/Command keep only printable chars (escapes there are usually terminal-renderer concerns).

pub fn on_osc_133(&mut self, marker: &str)

Handle an OSC 133 marker. marker is the second OSC param (the A / B / C / D[;<n>] part).

Trait Implementations

impl Default for BlockExtractor

fn default() -> Self

Returns the “default value” for a type.