Struct RawStdout 

pub struct RawStdout { /* private fields */ }

Emits JSONL events directly to stdout. Used as the base transport layer.

Implementations

impl RawStdout

pub fn detect() -> Self

Trait Implementations

impl EventSink for RawStdout

fn emit_line(&self, line: &str)

Emit one already-formatted line (no trailing newline expected).

fn is_tty(&self) -> bool

Whether we are attached to a TTY (affects newline escaping in tokens).

fn supports_incremental(&self) -> bool

Whether this sink consumes the incremental segment events (seg_append / seg_reset). Legacy hosts (current Android/iOS parsers) do NOT -> false, so those events are not emitted and old clients stay fully unchanged. New hosts opt in once their parser learns the incremental patch semantics.

fn started(&self, task: &str)

fn session(&self, event: &str, session_id: &str)

fn seg(&self, seg: &str, content: &str)

seg_content event. seg ∈ {thinking, thought, action, observation}

fn session_origin(&self, task: &str, session_id: &str, created: bool)

Merged startup event (additive, backward compatible): task + session identity + created flag in a single line. Legacy clients keep consuming start + session_created/session_switched; new clients can consume this one line instead and skip the two legacy lines.

fn seg_append(&self, seg: &str, content: &str)

Incremental segment update (additive, backward compatible): append content to the live segment seg without replacing its identity. New clients can patch a segment in place (no count rewind / full rebuild). Legacy clients ignore this event and keep using seg_content.

fn seg_reset(&self, seg: &str, content: &str)

Incremental segment update (additive, backward compatible): replace the live segment seg’s content in place (identity preserved). Same patching semantics as seg_append; legacy clients ignore it and keep using seg_content.

fn seg_large(&self, seg: &str, content: &str, chunk: usize)

Emit the legacy seg_content (authoritative full content, for old clients) AND, when the sink supports the incremental protocol and content is large, the incremental seg_reset + chunked seg_append pair so new clients can build the segment in place without a count rewind. Small segments only get the legacy event.

fn seg_stream(&self, seg: &str, content: &str, chunk: usize)

Chunked incremental form: reset the live segment in place, then grow it chunk by chunk. Only emitted for large content on incremental hosts; new clients patch in place (stable identity, no full-array rebuild).

fn seg_observation(&self, content: &str, max_chars: usize)

Observation segment with truncation cap. Always emits the legacy seg_content event (content capped to max_chars, matching the old preview behaviour); truncated/total_chars are additive metadata old parsers ignore and new clients use to render a collapse affordance. On incremental hosts, a truncated observation also emits the seg_reset/seg_append pair for in-place patching.

fn tool_progress(&self, state: &str, name: &str, chars: usize)

tool_progress event. state ∈ {building, done}

fn runtime_info(&self)

Startup identity (additive): makes a stale bundled/source binary visible in host logs. Skipped on a terminal.

fn tool_status( &self, call_id: &str, tool: &str, status: &str, duration_ms: u64, error_code: Option<&str>, error_message: Option<&str>, )

Structured tool outcome (additive, backward compatible). Legacy hosts ignore unknown event types; new hosts can distinguish failure / cancel / timeout / validation from ordinary output without parsing text.

fn action(&self, name: &str, args: &str)

Action declaration. Pipe mode: typed JSONL event carrying the tool name so clients can render it as a structured segment. TTY mode: legacy raw line 🛠️ Action: {name}\x00Action Input: {args}.

fn delta(&self, seg: &str, text: &str)

A streaming token attributed to a channel (thinking or thought). Pipe mode emits a typed JSONL event so clients can route tokens to the right UI segment (live typewriter); TTY mode falls back to raw output.

fn token_line(&self, text: &str)

A streaming token. Newlines become \x00 in pipe mode.

fn done(&self, session_id: &str)

fn done_result( &self, session_id: &str, status: &str, iterations: u32, final_text: &str, )

Terminal event carrying the run outcome (status/iterations/final_text). Emitted once per run as the authoritative terminal marker.

fn error(&self, message: &str)