@gaunt-sloth/core 2.0.0-alpha.3 → 2.0.0-alpha.31

package/dist/core/toolDisplay.js

@@ -0,0 +1,451 @@
+/**
+ * @module toolDisplay
+ * TUI-C30 — the surface-agnostic tool-display registry: how a tool CALL is summarised
+ * (`name(arg=val, …)`) and how its OUTPUT is previewed (up to {@link TOOL_OUTPUT_PREVIEW_LINES}
+ * greyed lines, diff-coloured for `write_file`/`edit_file`), shared by BOTH render surfaces:
+ *
+ *  - the Ink TUI's `ToolCallPanel` (`packages/app/src/tui/components/LiveTurn.tsx`), and
+ *  - the plain/readline (`--no-tui`, piped, single-shot) surface
+ *    (`core/plainToolIndication.ts`).
+ *
+ * Everything here is PURE STRINGS plus a style tag per line ({@link ToolDisplayLine}), so the
+ * module knows nothing about Ink or ANSI: the TUI maps styles to `<Text>` props and the plain
+ * surface maps them to raw ANSI via {@link renderToolLineAnsi}. The shape mirrors vue-ui's
+ * PLAT-17 `toolDisplay.ts` (name → glyph + which args to summarise + optional result formatter,
+ * with a generic fallback — cf. openclaw's `TOOL_DISPLAY_CONFIG` and opencode's
+ * `collapseToolOutput`) so the surfaces stay analogous without sharing code.
+ *
+ * Design rules (from the node spec):
+ *  - **One canonical output cap: {@link TOOL_OUTPUT_PREVIEW_LINES} lines** (and a per-line char
+ *    cap), applied by {@link capToolDisplayLines} with a `… (+N more lines)` overflow marker.
+ *    This is a RENDER-time cap only — the model-facing `OutputBuffer`/EXT-9 head-tail caps are a
+ *    separate layer beneath it and are never touched here.
+ *  - **Secret redaction reuses the GS2-47 `redactSecrets` lineage** (literal env/config secrets +
+ *    provider key patterns) — no new redactor. Applied to the params summary and every
+ *    preview/body line, fail-safe (redact MORE on any error, never leak).
+ *  - **`write_file`/`edit_file` render the change as a diff derived from the tool's ARGS**
+ *    (added = `added` style/green, removed = `removed` style/red); monochrome keeps the `+`/`-`
+ *    prefixes so the diff still reads without colour (DL-7 graceful degradation).
+ */
+import { displayWidth, sliceToWidth } from '#src/utils/displayWidth.js';
+import { collectSecretValues, redactText } from '#src/utils/redactSecrets.js';
+import { env } from '#src/utils/systemUtils.js';
+/** The single canonical output-preview cap (lines). No other preview length exists anywhere. */
+export const TOOL_OUTPUT_PREVIEW_LINES = 10;
+/**
+ * Per-line cap for preview lines, in terminal COLUMNS (a one-line minified bundle must not flood a
+ * row). The `CHARS` in the name is historical; every cap here is a column budget, because a
+ * character count is not a width — see `#src/utils/displayWidth.js`.
+ */
+export const TOOL_PREVIEW_LINE_MAX_CHARS = 200;
+/** Per-value cap inside a params summary, in terminal COLUMNS. */
+export const TOOL_PARAM_VALUE_MAX_CHARS = 48;
+/** Whole params-summary cap (everything inside the parentheses), in terminal COLUMNS. */
+export const TOOL_SUMMARY_MAX_CHARS = 120;
+/** The overflow/truncation marker used everywhere in this module. */
+export const ELLIPSIS = '…';
+/**
+ * Columns {@link ELLIPSIS} itself occupies, which every truncator has to reserve out of its budget
+ * before slicing. Derived rather than written as `1` so it stays true of whatever marker is used.
+ */
+export const ELLIPSIS_WIDTH = displayWidth(ELLIPSIS);
+const FALLBACK_GLYPH = '⚙';
+const FILE_GLYPH = '📁';
+const SHELL_GLYPH = '🔧';
+/* ------------------------------------------------------------------------- *
+ * Small shared helpers                                                       *
+ * ------------------------------------------------------------------------- */
+/**
+ * Tolerant parse of a (possibly partial) streamed args JSON. Mirrors the view-model's
+ * defensive posture: a half-streamed or malformed buffer never throws — it returns `null`.
+ */
+export function parseToolArgsSafe(argsText) {
+    if (!argsText || !argsText.trim())
+        return null;
+    try {
+        const parsed = JSON.parse(argsText);
+        if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The live gth config, registered once per run so {@link getDefaultSecrets} can harvest INLINE
+ * config secrets (a pasted `apiKey`/`token` value) via the GS2-47 config walk — not only the
+ * env-derived literals. `GthAgentRunner.init` sets this next to the crash-context hand-off, so
+ * both render surfaces (the plain observer and the Ink TUI) see it. `undefined` (no config yet)
+ * degrades to env-only collection + the provider patterns, exactly as before.
+ */
+let displayConfig = undefined;
+/**
+ * Register the live config for inline-secret collection (TUI-C32 residual a). Resets the secret
+ * cache so the next {@link getDefaultSecrets} recomputes with the config's inline literals folded
+ * in. Idempotent; a later call with a fresh config supersedes the previous one.
+ */
+export function setToolDisplayConfig(config) {
+    displayConfig = config;
+    cachedSecrets = null;
+}
+/**
+ * Lazily-computed default secret literals for redaction (GS2-47 technique 1), harvested from the
+ * process env AND the registered config (inline `apiKey`/`token` values) the same way
+ * `/debug-dump` does. Cached because `collectSecretValues` walks the whole env + config; the set
+ * cannot change mid-process in any way this render path must react to (a new config resets it via
+ * {@link setToolDisplayConfig}). `redactText` additionally always applies the provider-key
+ * patterns (technique 2).
+ */
+let cachedSecrets = null;
+function getDefaultSecrets() {
+    if (cachedSecrets === null) {
+        try {
+            cachedSecrets = collectSecretValues(displayConfig, env ?? {});
+        }
+        catch {
+            cachedSecrets = []; // patterns still apply via redactText
+        }
+    }
+    return cachedSecrets;
+}
+/** Test seam: drop the cached secret literals + registered config so specs can vary both. */
+export function resetToolDisplaySecretsCacheForTests() {
+    cachedSecrets = null;
+    displayConfig = undefined;
+}
+/** Collapse whitespace runs (incl. newlines) so a value stays a one-line token. */
+function inline(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Truncate to `max` terminal COLUMNS with the {@link ELLIPSIS} marker, reserving the marker's own
+ * width out of the budget. Slicing goes through the shared width primitive: a code-point count
+ * would read a CJK or emoji value as shorter than it renders and hand it back whole, over-running
+ * the row it is drawn on.
+ *
+ * Whether the value fits is put to the SLICE rather than to the ruler, because the slice stops at
+ * the budget: a value that over-runs is recognised from its first `max` columns, where measuring
+ * it reads all of it — and the values arriving here are whole tool-output lines, which
+ * {@link TOOL_PREVIEW_LINE_MAX_CHARS} exists precisely because they can be a megabyte long.
+ */
+function truncate(value, max) {
+    const fitted = sliceToWidth(value, max);
+    if (fitted === value)
+        return value;
+    return sliceToWidth(value, max - ELLIPSIS_WIDTH) + ELLIPSIS;
+}
+/**
+ * Render one arg value for the summary: strings inline+truncated, the rest JSON-ish.
+ *
+ * ORDER MATTERS (fix-cycle-1 finding): redaction runs BEFORE any transformation. Truncating
+ * first would bisect a literal secret longer than the value cap so it no longer
+ * literal-matches — its head would render in the call summary on both surfaces (a partial
+ * leak); whitespace-collapsing first could likewise alter a literal out of matching. So:
+ * redact the RAW text, then inline, then truncate (`<redacted>` contains no whitespace and is
+ * shorter than the cap, so the later steps can never damage the marker).
+ */
+function formatParamValue(value, secrets) {
+    let text;
+    if (typeof value === 'string') {
+        text = value;
+    }
+    else if (value === undefined) {
+        text = 'undefined';
+    }
+    else {
+        try {
+            text = JSON.stringify(value) ?? String(value);
+        }
+        catch {
+            text = String(value);
+        }
+    }
+    return truncate(inline(redactText(text, secrets)), TOOL_PARAM_VALUE_MAX_CHARS);
+}
+/** Split into lines, dropping a single trailing newline's phantom empty last element. */
+function toLines(text) {
+    const lines = text.split('\n');
+    if (lines.length > 1 && lines[lines.length - 1] === '')
+        lines.pop();
+    return lines;
+}
+/** Map raw text lines to styled lines. */
+function styled(lines, style) {
+    return lines.map((text) => ({ text, style }));
+}
+/* ------------------------------------------------------------------------- *
+ * Shell-shaped results (<COMMAND_OUTPUT>) — run_* / run_shell_command /      *
+ * custom toolkit tools all share this body shape, so it is detected by       *
+ * SHAPE, not by name (custom tool names are user-defined).                   *
+ * ------------------------------------------------------------------------- */
+const COMMAND_OUTPUT_RE = /<COMMAND_OUTPUT>\n?([\s\S]*?)<\/COMMAND_OUTPUT>\n?([\s\S]*)$/;
+/**
+ * Parse the shared shell-result shape (`Executing '…'…\n\n<COMMAND_OUTPUT>…</COMMAND_OUTPUT>\n\n
+ * <status line>`). Returns the captured output body and the trailing status text, or `null`
+ * when the result is not shell-shaped.
+ */
+export function parseCommandOutputResult(result) {
+    if (!result)
+        return null;
+    const match = COMMAND_OUTPUT_RE.exec(result);
+    if (!match)
+        return null;
+    return { body: match[1] ?? '', tail: (match[2] ?? '').trim() };
+}
+/**
+ * TUI-C32 residual c — may this tool NAME be treated as shell-shaped at all? A registered entry
+ * must be explicitly {@link ToolDisplayEntry.shellShaped}; an unregistered/custom name falls back
+ * to shape-detection (custom toolkit tools own user-defined names yet share the result shape). A
+ * registered non-shell tool (`read_file`, `list_directory`, …) is therefore NEVER shell-parsed
+ * just because its result happens to contain the `<COMMAND_OUTPUT>` marker.
+ */
+function nameAllowsShellShape(name) {
+    const entry = TOOL_DISPLAY_REGISTRY[name];
+    return entry ? entry.shellShaped === true : true;
+}
+/**
+ * TUI-C32 residual c — is THIS tool call genuinely a shell-shaped result (name allows it AND the
+ * result actually carries the `<COMMAND_OUTPUT>` shape)? Used by the plain surface to decide
+ * `liveOutputAlreadyShown` (the child streamed live via the tool-output channel's default sink),
+ * so a non-shell tool whose result merely quotes the marker no longer has its body suppressed.
+ */
+export function isShellShapedResult(name, result) {
+    return nameAllowsShellShape(name) && parseCommandOutputResult(result) !== null;
+}
+/**
+ * Body formatter for shell-shaped calls: the child's output (preferring the LIVE streamed
+ * output — verbatim what the child printed — over the result's `<COMMAND_OUTPUT>` copy of it,
+ * which is the TUI-C17 dedupe) followed by the closing status line. When the live output
+ * already streamed raw to the terminal (plain surface), only the status tail is rendered so
+ * nothing the user just watched is repeated.
+ */
+function formatShellBody(input) {
+    const parsed = parseCommandOutputResult(input.result);
+    // Not shell-shaped: only handle the still-running live-output case (a named run_* entry with
+    // no result yet). Anything with a non-shell result falls through to the generic rendering so
+    // e.g. a hardline refusal text is never dropped.
+    if (!parsed && (input.result || !input.output))
+        return null;
+    const lines = [];
+    if (!input.liveOutputAlreadyShown) {
+        // TUI-C32 residual d — the streamed live output is normally the verbatim, most-complete copy,
+        // so it is preferred (TUI-C17 dedupe). But if the live channel dropped straggler/tail chunks
+        // it can be a strict PREFIX of the result's `<COMMAND_OUTPUT>` copy (which the model always
+        // receives in full) — in that case fall back to the fuller copy so the expanded view can still
+        // recover what the stream missed. The common case (live === result, an independent/capped
+        // result, or an empty live output) is unchanged: only a genuine dropped-tail prefix overrides.
+        const live = input.output ?? '';
+        const resultBody = parsed?.body ?? '';
+        const body = resultBody.length > live.length && resultBody.startsWith(live) ? resultBody : live;
+        if (body.trim().length > 0)
+            lines.push(...styled(toLines(body), 'dim'));
+    }
+    if (parsed && parsed.tail.length > 0) {
+        lines.push(...styled(toLines(parsed.tail), 'dim'));
+    }
+    return lines.length > 0 ? lines : null;
+}
+/* ------------------------------------------------------------------------- *
+ * write_file / edit_file — diff-coloured rendering derived from the ARGS     *
+ * ------------------------------------------------------------------------- */
+/** `write_file` body: every content line is an ADDED diff line (there is no old content). */
+function formatWriteFileBody(input, args) {
+    if (input.isError)
+        return null; // fall through: the error text is the story, not the diff
+    const content = args?.content;
+    if (typeof content !== 'string')
+        return null;
+    const lines = styled(toLines(content).map((l) => `+ ${l}`), 'added');
+    if (input.result && input.result.trim().length > 0) {
+        lines.push(...styled(toLines(input.result.trim()), 'dim'));
+    }
+    return lines;
+}
+/** `edit_file` body: per edit, the removed oldText lines then the added newText lines. */
+function formatEditFileBody(input, args) {
+    if (input.isError)
+        return null; // fall through: show the recoverable error text instead
+    const edits = args?.edits;
+    if (!Array.isArray(edits) || edits.length === 0)
+        return null;
+    const lines = [];
+    let rendered = 0;
+    for (const raw of edits) {
+        const oldText = raw?.oldText;
+        const newText = raw?.newText;
+        if (typeof oldText !== 'string' || typeof newText !== 'string')
+            continue;
+        if (rendered > 0)
+            lines.push({ text: `${ELLIPSIS}`, style: 'dim' }); // hunk separator
+        rendered += 1;
+        lines.push(...styled(toLines(oldText).map((l) => `- ${l}`), 'removed'));
+        lines.push(...styled(toLines(newText).map((l) => `+ ${l}`), 'added'));
+    }
+    return rendered > 0 ? lines : null;
+}
+/* ------------------------------------------------------------------------- *
+ * The registry                                                               *
+ * ------------------------------------------------------------------------- */
+/**
+ * Named entries. Anything not listed uses the generic fallback (all args summarised,
+ * output+result previewed dim) — plus the SHAPE-based shell formatter, which also covers
+ * user-named custom toolkit tools (they share the `<COMMAND_OUTPUT>` result shape).
+ */
+const TOOL_DISPLAY_REGISTRY = {
+    read_file: { glyph: FILE_GLYPH, summariseArgs: ['path', 'offset', 'limit', 'head', 'tail'] },
+    read_multiple_files: { glyph: FILE_GLYPH, summariseArgs: ['paths'] },
+    gth_read_binary: { glyph: FILE_GLYPH, summariseArgs: ['path'] },
+    write_file: { glyph: FILE_GLYPH, summariseArgs: ['path'], formatBody: formatWriteFileBody },
+    edit_file: {
+        glyph: FILE_GLYPH,
+        summariseArgs: ['path', 'dryRun'],
+        formatBody: formatEditFileBody,
+    },
+    create_directory: { glyph: FILE_GLYPH },
+    list_directory: { glyph: FILE_GLYPH },
+    list_directory_with_sizes: { glyph: FILE_GLYPH },
+    directory_tree: { glyph: FILE_GLYPH },
+    move_file: { glyph: FILE_GLYPH },
+    search_files: { glyph: FILE_GLYPH },
+    get_file_info: { glyph: FILE_GLYPH },
+    delete_file: { glyph: FILE_GLYPH },
+    delete_directory: { glyph: FILE_GLYPH },
+    list_allowed_directories: { glyph: FILE_GLYPH },
+    run_shell_command: {
+        glyph: SHELL_GLYPH,
+        summariseArgs: ['command'],
+        formatBody: formatShellBody,
+        shellShaped: true,
+    },
+    run_tests: { glyph: SHELL_GLYPH, formatBody: formatShellBody, shellShaped: true },
+    run_single_test: {
+        glyph: SHELL_GLYPH,
+        summariseArgs: ['testPath'],
+        formatBody: formatShellBody,
+        shellShaped: true,
+    },
+    run_lint: { glyph: SHELL_GLYPH, formatBody: formatShellBody, shellShaped: true },
+    run_build: { glyph: SHELL_GLYPH, formatBody: formatShellBody, shellShaped: true },
+    task: { glyph: '🤖', summariseArgs: ['subagent_type', 'description'] },
+};
+/** The registry glyph for a tool name (generic `⚙` when unknown). */
+export function getToolGlyph(name) {
+    return TOOL_DISPLAY_REGISTRY[name]?.glyph ?? FALLBACK_GLYPH;
+}
+/* ------------------------------------------------------------------------- *
+ * Params summary                                                             *
+ * ------------------------------------------------------------------------- */
+/**
+ * One-line call summary: `name(arg=val, other=…)`. Key args only (per the registry entry, or
+ * all args for unknown tools), each value inlined + truncated, the whole parenthesised part
+ * capped at {@link TOOL_SUMMARY_MAX_CHARS}, and everything secret-redacted (literals +
+ * provider patterns). Unparsable (mid-stream/malformed) args render as `name(…)` — never a
+ * raw JSON dump. `secrets` defaults to the env-derived literals; pass explicitly for tests.
+ *
+ * Redaction runs BEFORE every truncation step (per value in {@link formatParamValue}, and again
+ * before the whole-summary cap): truncating first would bisect a literal secret longer than a
+ * cap so it no longer literal-matches, leaking its head into the rendered summary
+ * (fix-cycle-1 finding). The final pass over the assembled string is defense in depth only —
+ * `redactText` is idempotent, so re-redacting already-marked text is safe.
+ */
+export function summariseToolCall(name, argsText, secrets = getDefaultSecrets()) {
+    const label = name || '(tool)';
+    const args = parseToolArgsSafe(argsText);
+    if (args === null) {
+        const hasRawArgs = !!argsText && argsText.trim().length > 0 && argsText.trim() !== '{}';
+        return hasRawArgs ? `${label}(${ELLIPSIS})` : `${label}()`;
+    }
+    const entry = TOOL_DISPLAY_REGISTRY[name];
+    const keys = entry?.summariseArgs !== undefined
+        ? entry.summariseArgs.filter((k) => args[k] !== undefined)
+        : Object.keys(args);
+    const parts = keys.map((k) => `${k}=${formatParamValue(args[k], secrets)}`);
+    // Anything parsed but not summarised (write_file's content, unlisted keys) is signalled with
+    // a trailing ellipsis so the summary never silently pretends to be the whole call.
+    const hasHiddenArgs = entry?.summariseArgs !== undefined && Object.keys(args).some((k) => !keys.includes(k));
+    if (hasHiddenArgs)
+        parts.push(ELLIPSIS);
+    // Redact before the whole-summary cap too, so this truncation can no more bisect a secret
+    // out of literal-matching than the per-value one can.
+    const inner = truncate(redactText(parts.join(', '), secrets), TOOL_SUMMARY_MAX_CHARS);
+    return redactText(`${label}(${inner})`, secrets);
+}
+/* ------------------------------------------------------------------------- *
+ * Body + preview                                                             *
+ * ------------------------------------------------------------------------- */
+/**
+ * The FULL (uncapped) body lines for a call: the registry formatter when one applies, else the
+ * shape-based shell formatter, else the generic fallback (live output lines, then the final
+ * result — both dim). Every line is secret-redacted. Used by the TUI's EXPANDED panel; cap it
+ * with {@link capToolDisplayLines} for the collapsed preview.
+ */
+export function buildToolBodyLines(input, secrets = getDefaultSecrets()) {
+    const args = parseToolArgsSafe(input.argsText);
+    const entry = TOOL_DISPLAY_REGISTRY[input.name];
+    let lines = entry?.formatBody?.(input, args) ?? null;
+    // TUI-C32 residual c — only fall back to the shape-based shell formatter for names that may be
+    // shell-shaped (flagged registry entries + unregistered custom tools), so a registered non-shell
+    // tool whose result merely contains `<COMMAND_OUTPUT>` is rendered generically, not shell-parsed.
+    if (lines === null && nameAllowsShellShape(input.name))
+        lines = formatShellBody(input);
+    if (lines === null) {
+        lines = [];
+        if (input.output && input.output.trim().length > 0 && !input.liveOutputAlreadyShown) {
+            lines.push(...styled(toLines(input.output), 'dim'));
+        }
+        if (input.result && input.result.trim().length > 0) {
+            lines.push(...styled(toLines(input.result), 'dim'));
+        }
+    }
+    return lines.map((l) => ({ ...l, text: redactText(l.text, secrets) }));
+}
+/**
+ * Apply the canonical render cap: at most `maxLines` lines (each char-capped at
+ * {@link TOOL_PREVIEW_LINE_MAX_CHARS} with `…`), plus a dim `… (+N more lines)` overflow
+ * marker when anything was cut. The marker line is IN ADDITION to the cap so exactly how much
+ * was hidden is always stated (DL-4 transparency).
+ */
+export function capToolDisplayLines(lines, maxLines = TOOL_OUTPUT_PREVIEW_LINES) {
+    const capped = lines.slice(0, maxLines).map((l) => ({
+        ...l,
+        text: truncate(l.text, TOOL_PREVIEW_LINE_MAX_CHARS),
+    }));
+    const hidden = lines.length - capped.length;
+    if (hidden > 0) {
+        capped.push({
+            text: `${ELLIPSIS} (+${hidden} more line${hidden === 1 ? '' : 's'})`,
+            style: 'dim',
+        });
+    }
+    return capped;
+}
+/**
+ * The collapsed inline preview: {@link buildToolBodyLines} capped at the canonical
+ * {@link TOOL_OUTPUT_PREVIEW_LINES}.
+ */
+export function buildToolPreviewLines(input, secrets = getDefaultSecrets()) {
+    return capToolDisplayLines(buildToolBodyLines(input, secrets));
+}
+/* ------------------------------------------------------------------------- *
+ * ANSI adapter (plain surface)                                               *
+ * ------------------------------------------------------------------------- */
+const ANSI_BY_STYLE = {
+    dim: '\x1b[2m',
+    added: '\x1b[32m',
+    removed: '\x1b[31m',
+};
+const ANSI_RESET = '\x1b[0m';
+/**
+ * Render one styled line as a raw string for the plain surface. Each line is SELF-STYLED
+ * (its own SGR open + reset) so lines compose safely regardless of surrounding styling.
+ * With `colour` false the raw text is returned unchanged — the clean monochrome degradation
+ * for non-TTY/piped output (DL-7); diff lines still read via their `+`/`-` prefixes.
+ */
+export function renderToolLineAnsi(line, colour) {
+    if (!colour)
+        return line.text;
+    return `${ANSI_BY_STYLE[line.style]}${line.text}${ANSI_RESET}`;
+}
+//# sourceMappingURL=toolDisplay.js.map

package/dist/core/toolDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDisplay.js","sourceRoot":"","sources":["../../src/core/toolDisplay.ts"],"names":[],"mappings":"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"}

package/dist/core/toolOutputChannel.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @module toolOutputChannel
+ * TUI-C17 — the managed route for LIVE tool output (a custom/dev toolkit child process's
+ * stdout/stderr chunks and its "🔧 Executing …" announcement).
+ *
+ * The toolkits used to write child output straight to `process.stdout` and announce runs via
+ * `displayInfo`. Under the Ink TUI both bypass Ink's managed frame: the raw text prints out of
+ * order above the agent message, never reaches the `TurnViewModel`, and vanishes on the next
+ * re-render. The fix is an emit/subscribe seam:
+ *
+ * - The toolkits call {@link emitToolOutput} instead of writing to stdout/`displayInfo`.
+ * - With NO subscriber (every non-TUI surface: `--no-tui`, piped, `exec`, the AG-UI server),
+ *   the DEFAULT SINK reproduces the historical behaviour byte-for-byte — `displayInfo` for the
+ *   notice, `stdout.write` for chunks, `displayWarning`/`displayError` for a failure-path
+ *   warning/error — so headless output is unchanged.
+ * - The Ink TUI subscribes for the duration of a turn via {@link mergeToolOutputIntoEvents},
+ *   which converts each chunk into a typed `tool_output` {@link AgentStreamEvent} attributed to
+ *   its tool call, merged live into the turn's event stream so it lands in `foldEvents`.
+ *
+ * Single-subscriber by design: one process hosts at most one interactive TUI session, and the
+ * non-TUI surfaces never subscribe. (Concurrent server sessions — AG-UI/ACP — stay on the
+ * default sink, exactly as before.)
+ *
+ * TUI-C31 hardens the seam's edge windows: failure-path warnings/errors now travel the channel
+ * too ({@link GthToolOutputChunk} `kind: 'warning' | 'error'`, residual a); the merge drains a
+ * straggler queued in the unsubscribe microwindow (residual b) and cleans up on early-`return()`
+ * (residual c); and {@link setToolOutputSuppressed} lets the mounted TUI suppress a
+ * post-unsubscribe straggler between turns instead of leaking it to raw stdout (residual d).
+ */
+import type { AgentStreamEvent } from '#src/core/types.js';
+/** One emitted piece of live tool output, attributed to the tool (and call) that produced it. */
+export interface GthToolOutputChunk {
+    /**
+     * The LangChain tool call id this output belongs to (`ToolRunnableConfig.toolCall.id`),
+     * when the invoking framework supplied one. Lets a consumer nest output under the exact call.
+     */
+    toolCallId?: string;
+    /** The gth tool name (e.g. `run_shell_command`, a custom tool's name). Always known. */
+    toolName: string;
+    /**
+     * `notice` — the "🔧 Executing …" announcement (historically `displayInfo`);
+     * `output` — a verbatim child stdout/stderr chunk (historically `stdout.write`);
+     * `warning` / `error` — a failure-path advisory (historically `displayWarning`/`displayError`),
+     *   e.g. a hardline refusal or a spawn-level failure. TUI-C31 (a): routing these through the
+     *   channel keeps them out of raw stdout while the Ink frame is mounted; the default sink still
+     *   renders them via `displayWarning`/`displayError` for every non-TUI surface, byte-for-byte.
+     */
+    kind: 'notice' | 'output' | 'warning' | 'error';
+    /**
+     * The text, verbatim. Notices carry NO leading newline — raw-console framing (the historical
+     * leading `\n`) is the default sink's concern, not the producer's. A `warning`/`error` DOES
+     * carry whatever leading framing its historical `displayWarning`/`displayError` call had (the
+     * default sink forwards it unchanged), so headless output stays byte-for-byte identical.
+     */
+    text: string;
+}
+export type GthToolOutputListener = (chunk: GthToolOutputChunk) => void;
+/**
+ * Subscribe to live tool output, replacing the default stdout/`displayInfo` sink for as long
+ * as the subscription is active. Returns an unsubscribe function. Last subscriber wins; the
+ * returned unsubscribe only clears its OWN registration (a stale unsubscribe can never detach
+ * a newer subscriber).
+ */
+export declare function subscribeToolOutput(listener: GthToolOutputListener): () => void;
+/**
+ * TUI-C31 (d): mark whether a terminal-owning surface (the Ink TUI) is mounted. While mounted,
+ * the default sink SUPPRESSES output that has no per-turn subscriber (a post-turn straggler)
+ * rather than writing it raw over the managed frame. The TUI session sets this `true` around the
+ * whole session (`render()` … `waitUntilExit()`) and back to `false` on unmount, so once the TUI
+ * is gone the default (headless) stdout sink is fully restored. An active per-turn subscriber
+ * always takes precedence, so legitimate in-turn output is untouched.
+ */
+export declare function setToolOutputSuppressed(value: boolean): void;
+/**
+ * Emit one piece of live tool output. Routed to the active subscriber when present (the Ink
+ * TUI), otherwise to the DEFAULT SINK, which reproduces the pre-TUI-C17 behaviour exactly:
+ * the notice via `displayInfo` with its historical leading newline, chunks via `stdout.write`,
+ * a warning via `displayWarning` and an error via `displayError` (TUI-C31 a). While the TUI is
+ * mounted but no subscriber is attached (between turns), a no-subscriber emit is SUPPRESSED
+ * rather than written raw over the managed frame (TUI-C31 d).
+ */
+export declare function emitToolOutput(chunk: GthToolOutputChunk): void;
+/**
+ * Merge live tool output into an agent event stream: subscribes to the channel for the
+ * lifetime of `inner` and yields each emitted chunk as a `tool_output` event, interleaved
+ * with `inner`'s own events in arrival order. Because tool child output arrives WHILE the
+ * graph stream is awaiting its next message, the merge is push-based (a woken queue), so a
+ * long-running command's output streams into the consumer live rather than batching until
+ * the tool finishes.
+ *
+ * Used by the TUI session around `processMessagesWithEvents`; always unsubscribes (restoring
+ * the default stdout sink) when the inner stream completes, throws, or the consumer stops
+ * early. Errors from `inner` (including aborts) propagate unchanged after the queue drains.
+ */
+export declare function mergeToolOutputIntoEvents(inner: AsyncGenerator<AgentStreamEvent>): AsyncGenerator<AgentStreamEvent>;