@duetso/agent 0.1.80 → 0.1.82

package/dist/src/tui/status-controller.js

@@ -0,0 +1,186 @@
+import { HINT_IDLE, HINT_RUNNING, HINT_SELECTION_COPY } from "./theme.js";
+import { isTextBufferDestroyedError } from "./transcript-writer.js";
+/**
+ * Owns the "is a turn running?" surface of the TUI: the working-status line,
+ * the bottom hint row, and the 1 s ticker that advances both while a turn is
+ * in flight. Also remembers the most recent terminal event so `runTui` can
+ * return it to the caller after the renderer is destroyed.
+ *
+ * Preserves the v0.1.68 dual-mechanism guard against the OpenTUI race where
+ * child TextBuffers are destroyed synchronously *before* the `destroy` event
+ * fires: writes short-circuit on `destroyed`, and a `try/catch` around the
+ * actual buffer mutation swallows the late-arriving exception and tears down
+ * the ticker so the next callback does not throw again.
+ */
+export class StatusController {
+    opts;
+    destroyed = false;
+    running = false;
+    workingStartedAt;
+    workingTicker;
+    workingMessage = "working…";
+    queuedFollowUps = 0;
+    pendingImageCount = 0;
+    lastSelectionText = "";
+    terminal;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    isRunning() {
+        return this.running;
+    }
+    lastTerminal() {
+        return this.terminal;
+    }
+    /** Wall-clock start of the current turn, or undefined while idle. Read by
+     *  the "● turn finished in Ns" and sleep banners which live outside this
+     *  controller but want to show the same elapsed counter. */
+    getWorkingStartedAt() {
+        return this.workingStartedAt;
+    }
+    setWorkingMessage(message) {
+        this.workingMessage = message;
+        this.refreshWorkingStatus();
+    }
+    setQueuedFollowUps(count) {
+        this.queuedFollowUps = count;
+        this.refreshWorkingStatus();
+    }
+    /** Mirror of the most recent drag-selection text. Stored here so the hint
+     *  row can advertise the copy keystroke only while something is selectable;
+     *  the canonical selection state lives in `runTui`. */
+    setSelectionText(text) {
+        this.lastSelectionText = text;
+        this.refreshHint();
+    }
+    /** Mirror of `pendingImages.length`. Stored here so the hint row can show
+     *  the attachment count without dragging the whole `PendingImage[]` into
+     *  the controller. */
+    setPendingImageCount(count) {
+        this.pendingImageCount = count;
+        this.refreshHint();
+    }
+    markRunning() {
+        this.running = true;
+        this.workingMessage = "working…";
+        this.workingStartedAt = Date.now();
+        this.refreshHint();
+        this.refreshWorkingStatus();
+        this.startWorkingTicker();
+    }
+    /** Settle the working-status surface and optionally record the terminal
+     *  event that ended the turn. The terminal is exposed via `lastTerminal()`
+     *  so `runTui` can return it to its caller after renderer teardown. */
+    markIdle(terminal) {
+        if (terminal !== undefined)
+            this.terminal = terminal;
+        this.running = false;
+        this.stopWorkingTicker();
+        this.workingStartedAt = undefined;
+        this.workingMessage = "working…";
+        this.refreshHint();
+        this.refreshWorkingStatus();
+    }
+    setStatus(text) {
+        // Renderer teardown destroys the underlying TextBuffer synchronously, but
+        // in-flight async work (session events, ticker callbacks, upgrade-status
+        // pushes) may still drive chrome updates on the next microtask. The
+        // `destroyed` flag catches writes after our destroy handler runs; the
+        // try/catch backstops the window between OpenTUI tearing down child
+        // TextBuffers and emitting the `destroy` event, which is when the ticker
+        // callback typically lands.
+        if (this.destroyed)
+            return;
+        try {
+            this.opts.status.content = text;
+        }
+        catch (error) {
+            if (isTextBufferDestroyedError(error)) {
+                this.shutdown();
+                return;
+            }
+            throw error;
+        }
+    }
+    /** Recompose the bottom hint row from the controller's current running
+     *  state plus any active attachment / selection segments. Called from any
+     *  input that changes a hint segment (attachments, selection) and from
+     *  the running-state transitions in `markRunning` / `markIdle`. */
+    refreshHint() {
+        if (this.destroyed)
+            return;
+        const base = this.running ? HINT_RUNNING : HINT_IDLE;
+        const segments = [];
+        if (this.pendingImageCount > 0)
+            segments.push(this.attachmentHint());
+        segments.push(base);
+        if (this.lastSelectionText.trim().length > 0)
+            segments.push(HINT_SELECTION_COPY);
+        try {
+            this.opts.hint.content = segments.join(" · ");
+        }
+        catch (error) {
+            if (isTextBufferDestroyedError(error)) {
+                this.shutdown();
+                return;
+            }
+            throw error;
+        }
+    }
+    refreshWorkingStatus() {
+        if (this.destroyed)
+            return;
+        this.opts.refreshActiveToolBlocks();
+        if (this.workingStartedAt === undefined) {
+            this.setStatus(this.queuedFollowUps > 0 ? `queued follow-ups: ${this.queuedFollowUps}` : "");
+            return;
+        }
+        const elapsed = formatElapsed(Date.now() - this.workingStartedAt);
+        const queued = this.queuedFollowUps > 0 ? ` · queued follow-ups: ${this.queuedFollowUps}` : "";
+        this.setStatus(`● ${this.workingMessage} (${elapsed})${queued}`);
+    }
+    /** Flip the destroyed flag and stop the ticker. Invoked from the renderer
+     *  destroy handler and from our own try/catch when a buffer write fires the
+     *  destroyed-buffer guard mid-flight. Subsequent chrome writes no-op. */
+    shutdown() {
+        this.destroyed = true;
+        this.stopWorkingTicker();
+    }
+    startWorkingTicker() {
+        if (this.workingTicker !== undefined)
+            return;
+        this.workingTicker = setInterval(() => this.refreshWorkingStatus(), 1000);
+    }
+    stopWorkingTicker() {
+        if (this.workingTicker !== undefined) {
+            clearInterval(this.workingTicker);
+            this.workingTicker = undefined;
+        }
+    }
+    attachmentHint() {
+        const n = this.pendingImageCount;
+        return n === 1 ? "📎 1 image attached" : `📎 ${n} images attached`;
+    }
+}
+/**
+ * Renders an elapsed millisecond span as `${seconds}s` below a minute, and
+ * `${minutes}m ${seconds}s` past it. Exported because the tool-call finalizer
+ * and the post-turn banners share the same format.
+ */
+export function formatElapsed(ms) {
+    const totalSeconds = Math.max(0, Math.floor(ms / 1000));
+    if (totalSeconds < 60)
+        return `${totalSeconds}s`;
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    return `${minutes}m ${seconds}s`;
+}
+/**
+ * Spinner marker for an in-flight tool call. Sub-second runs drop the
+ * elapsed counter so a transcript of fast tools is not littered with "0s"
+ * markers.
+ */
+export function runningMarker(elapsedMs) {
+    return elapsedMs >= 1000 ? `⏳ ${formatElapsed(elapsedMs)}` : "⏳";
+}
+//# sourceMappingURL=status-controller.js.map

package/dist/src/tui/status-controller.js.map

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

package/dist/src/tui/step-renderer.d.ts

@@ -0,0 +1,55 @@
+import { type CliRenderer, type ScrollBoxRenderable } from "@opentui/core";
+import { StatusController } from "./status-controller.js";
+import { TranscriptWriter } from "./transcript-writer.js";
+import type { TurnEvent, TurnStep, TurnTokenUsage } from "../types/protocol.js";
+export interface StepRendererOptions {
+    renderer: CliRenderer;
+    transcript: ScrollBoxRenderable;
+    transcriptWriter: TranscriptWriter;
+    statusController: StatusController;
+    /** Invoked at the start of `renderStep` so a stale question picker
+     *  panel is dismissed before the next agent activity lands; the next
+     *  step supersedes the open question. */
+    onStepStart?: () => void;
+}
+/**
+ * Renders the streaming surface of a turn: text deltas, reasoning deltas,
+ * tool-call blocks (live spinner → ✓/✗), memory phase banners, and the
+ * post-turn usage / elapsed / sleep lines.
+ *
+ * Owns the in-flight stream/tool-block bookkeeping so the StatusController
+ * ticker can call `refreshActiveToolBlocks()` to advance spinners without
+ * cracking open the renderer state.
+ */
+export declare class StepRenderer {
+    private readonly opts;
+    private activeTextStream;
+    private activeReasoningStream;
+    private readonly activeToolBlocks;
+    constructor(opts: StepRendererOptions);
+    renderStep(step: TurnStep): void;
+    /** Repaint every in-flight tool block header with a fresh spinner +
+     *  elapsed counter. Invoked from StatusController's 1 s ticker so the
+     *  spinner column advances in step with the working-status line. */
+    refreshActiveToolBlocks(): void;
+    renderUsage(usage?: TurnTokenUsage): void;
+    renderTurnElapsed(): void;
+    renderSleeping(wakeAt: number): void;
+    renderMemoryStatus(event: Extract<TurnEvent, {
+        type: "memory";
+    }>): void;
+    private renderDelta;
+    private renderToolCall;
+    private finalizeToolCall;
+    private finalizeDelta;
+    private toolBlockColumns;
+}
+/**
+ * Format the body of a memory phase event for display. Returns the empty
+ * string when there are no observations or usage bumps to show, so the
+ * caller can elide the block entirely.
+ */
+export declare function formatMemoryEventBody(event: Extract<TurnEvent, {
+    type: "memory";
+}>): string;
+//# sourceMappingURL=step-renderer.d.ts.map

package/dist/src/tui/step-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-renderer.d.ts","sourceRoot":"","sources":["../../../src/tui/step-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAkB,MAAM,eAAe,CAAC;AAC3F,OAAO,EAAgC,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAIxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiChF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,mBAAmB,CAAC;IAChC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC;;6CAEyC;IACzC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAQX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,qBAAqB,CAA6B;IAI1D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgC;gBAEpC,IAAI,EAAE,mBAAmB;IAEtD,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IA+ChC;;wEAEoE;IACpE,uBAAuB,IAAI,IAAI;IAa/B,WAAW,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI;IAwBzC,iBAAiB,IAAI,IAAI;IAazB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWpC,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,GAAG,IAAI;IAcvE,OAAO,CAAC,WAAW;IAgCnB,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,gBAAgB;CAIzB;AAOD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,GAAG,MAAM,CAa3F"}

package/dist/src/tui/step-renderer.js

@@ -0,0 +1,246 @@
+import { TextRenderable } from "@opentui/core";
+import { formatElapsed, runningMarker } from "./status-controller.js";
+import { SIDEBAR_WIDTH } from "./sidebar.js";
+import { COLORS } from "./theme.js";
+import { assembleToolBlock, formatToolBlock, truncateToolText } from "./tool-formatters.js";
+/**
+ * Renders the streaming surface of a turn: text deltas, reasoning deltas,
+ * tool-call blocks (live spinner → ✓/✗), memory phase banners, and the
+ * post-turn usage / elapsed / sleep lines.
+ *
+ * Owns the in-flight stream/tool-block bookkeeping so the StatusController
+ * ticker can call `refreshActiveToolBlocks()` to advance spinners without
+ * cracking open the renderer state.
+ */
+export class StepRenderer {
+    opts;
+    activeTextStream;
+    activeReasoningStream;
+    // Tool calls fire twice (running → completed/error). Track the rendered
+    // block by toolCallId so the second event updates the same line in place
+    // instead of pushing a separate block.
+    activeToolBlocks = new Map();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    renderStep(step) {
+        this.opts.onStepStart?.();
+        if (step.type === "text_delta") {
+            this.activeTextStream = this.renderDelta(this.activeTextStream, null, step.delta, COLORS.agent);
+        }
+        else if (step.type === "reasoning_delta") {
+            this.activeReasoningStream = this.renderDelta(this.activeReasoningStream, "[reasoning]", step.delta, COLORS.reasoning, true);
+        }
+        else if (step.type === "text") {
+            this.opts.transcriptWriter.recordEntry("agent", step.text);
+            if (this.activeTextStream) {
+                this.finalizeDelta(this.activeTextStream, step.text);
+                this.activeTextStream = undefined;
+                return;
+            }
+            this.opts.transcriptWriter.appendBlock(null, step.text, COLORS.agent);
+        }
+        else if (step.type === "reasoning") {
+            const trimmed = step.text.trim();
+            if (this.activeReasoningStream) {
+                this.finalizeDelta(this.activeReasoningStream, trimmed);
+                this.activeReasoningStream = undefined;
+                return;
+            }
+            if (trimmed) {
+                this.opts.transcriptWriter.appendBlock("[reasoning]", truncateToolText(trimmed), COLORS.reasoning);
+            }
+        }
+        else if (step.type === "tool_call") {
+            this.renderToolCall(step);
+        }
+        else if (step.type === "system") {
+            this.opts.transcriptWriter.appendBlock("[system]", step.message, COLORS.system);
+        }
+    }
+    /** Repaint every in-flight tool block header with a fresh spinner +
+     *  elapsed counter. Invoked from StatusController's 1 s ticker so the
+     *  spinner column advances in step with the working-status line. */
+    refreshActiveToolBlocks() {
+        if (this.activeToolBlocks.size === 0)
+            return;
+        const columns = this.toolBlockColumns();
+        for (const block of this.activeToolBlocks.values()) {
+            if (block.startedAt === undefined)
+                continue;
+            block.line.content = assembleToolBlock({ header: block.header, body: block.body || undefined }, runningMarker(Date.now() - block.startedAt), { columns });
+        }
+    }
+    renderUsage(usage) {
+        if (!usage)
+            return;
+        // Cumulative cost is updated on the session when the terminal event is
+        // handled; sidebar refreshes from `getSessionCostUsd()` via `refreshSidebar`.
+        // Tokens stay terse (just in/out) since the cost breakdown below is
+        // where the cache wins actually matter. Cost is split across all four
+        // buckets (in / out / cache read / cache write) so prompt-cache hits and
+        // writes are visible at a glance; zero buckets collapse out.
+        const tokens = `Tokens: in=${usage.input} out=${usage.output}`;
+        const costParts = [
+            ["in", usage.cost.input],
+            ["out", usage.cost.output],
+            ["cr", usage.cost.cacheRead],
+            ["cw", usage.cost.cacheWrite],
+        ]
+            .filter(([, value]) => value > 0)
+            .map(([label, value]) => `${label}=$${value.toFixed(4)}`);
+        const cost = usage.cost.total === 0
+            ? ""
+            : ` · Cost: $${usage.cost.total.toFixed(4)}${costParts.length > 1 ? ` (${costParts.join(" ")})` : ""}`;
+        this.opts.transcriptWriter.appendLine(`[usage] ${tokens}${cost}`, COLORS.hint);
+    }
+    renderTurnElapsed() {
+        const startedAt = this.opts.statusController.getWorkingStartedAt();
+        if (startedAt === undefined)
+            return;
+        this.opts.transcriptWriter.appendLine(`● turn finished in ${formatElapsed(Date.now() - startedAt)}`, COLORS.status);
+    }
+    // Sleep terminals replace the usual "turn finished" line because the session
+    // is going back to sleep, not wrapping up. When a turn ran before the sleep
+    // (e.g. an injected prompt while waiting on a state machine), include its
+    // duration so the user can still see how long the work took.
+    renderSleeping(wakeAt) {
+        const wakeLabel = new Date(wakeAt).toLocaleTimeString();
+        const startedAt = this.opts.statusController.getWorkingStartedAt();
+        const turnDuration = startedAt === undefined ? "" : ` · turn took ${formatElapsed(Date.now() - startedAt)}`;
+        this.opts.transcriptWriter.appendLine(`● sleeping until ${wakeLabel}${turnDuration}`, COLORS.status);
+    }
+    renderMemoryStatus(event) {
+        if (event.status === "running") {
+            this.opts.statusController.setWorkingMessage(event.message);
+            return;
+        }
+        const body = formatMemoryEventBody(event);
+        if (body) {
+            this.opts.transcriptWriter.appendBlock(`[memory:${event.phase}]`, body, COLORS.memory);
+        }
+        if (this.opts.statusController.isRunning()) {
+            this.opts.statusController.setWorkingMessage("working…");
+        }
+    }
+    renderDelta(block, label, delta, fg, truncate = false) {
+        const next = block ??
+            {
+                line: new TextRenderable(this.opts.renderer, { content: "", fg }),
+                label,
+                body: "",
+                truncate,
+            };
+        if (!block) {
+            this.opts.transcriptWriter.beginBlock();
+            this.opts.transcript.add(next.line);
+        }
+        next.body += delta;
+        updateStreamingBlock(next);
+        return next;
+    }
+    // Render a tool call as a single, self-updating block. The first event
+    // (`status: "running"`) creates the block with a spinner; the second event
+    // (`completed` or `error`) replaces the spinner with ✓/✗ and appends the
+    // truncated result inline so the call and its outcome stay visually paired.
+    // Per-tool formatters in `tool-formatters.ts` decide the header text and
+    // whether the call should appear in the transcript at all (e.g.
+    // ask_user_question hides itself live and lets the `ask` terminal event
+    // own the question display).
+    renderToolCall(step) {
+        const existing = this.activeToolBlocks.get(step.toolCallId);
+        if (existing) {
+            this.finalizeToolCall(step, existing);
+            return;
+        }
+        const isLive = step.status === "running" || step.status === "pending";
+        const formatStatus = isLive ? "running" : step.status === "error" ? "error" : "completed";
+        const formatted = formatToolBlock({
+            toolName: step.toolName,
+            status: formatStatus,
+            input: step.input,
+            output: step.output,
+            mode: "live",
+        });
+        if (formatted.hidden)
+            return;
+        const startedAt = isLive ? Date.now() : undefined;
+        const marker = "⏳";
+        const fg = step.status === "error" ? COLORS.error : COLORS.tool;
+        const columns = this.toolBlockColumns();
+        const line = new TextRenderable(this.opts.renderer, {
+            content: assembleToolBlock(formatted, marker, { columns }),
+            fg,
+        });
+        this.opts.transcriptWriter.beginBlock();
+        this.opts.transcript.add(line);
+        const block = {
+            line,
+            header: formatted.header,
+            body: formatted.body ?? "",
+            input: step.input,
+            startedAt,
+        };
+        this.activeToolBlocks.set(step.toolCallId, block);
+        // The same event may already carry a terminal status (cached/replayed
+        // history). Fall through to finalize against the just-created block.
+        if (!isLive) {
+            this.finalizeToolCall(step, block);
+        }
+    }
+    finalizeToolCall(step, block) {
+        const isError = step.status === "error";
+        const glyph = isError ? "✗" : "✓";
+        const elapsedMs = block.startedAt === undefined ? 0 : Date.now() - block.startedAt;
+        // Sub-second runs drop the elapsed suffix so the transcript does not get
+        // littered with "0s" markers from fast tools (read, ls, todo_write, …).
+        const durationSuffix = elapsedMs >= 1000 ? ` ${formatElapsed(elapsedMs)}` : "";
+        const formatted = formatToolBlock({
+            toolName: step.toolName,
+            status: isError ? "error" : "completed",
+            input: block.input,
+            output: step.output,
+            mode: "live",
+        });
+        block.line.content = assembleToolBlock(formatted, `${glyph}${durationSuffix}`, {
+            columns: this.toolBlockColumns(),
+        });
+        block.line.fg = isError ? COLORS.error : COLORS.tool;
+        this.activeToolBlocks.delete(step.toolCallId);
+    }
+    finalizeDelta(block, body) {
+        block.body = body;
+        updateStreamingBlock(block);
+    }
+    // Width budget for a tool block: terminal width minus the fixed sidebar
+    // column and a small fudge for borders/padding. Recomputed per render so a
+    // resize after a tool block lands updates new blocks; existing blocks keep
+    // the width they were rendered at, which is acceptable since the renderer
+    // would otherwise re-wrap and could exceed the row cap.
+    toolBlockColumns() {
+        const transcriptColumnPadding = 4;
+        return Math.max(20, this.opts.renderer.terminalWidth - SIDEBAR_WIDTH - transcriptColumnPadding);
+    }
+}
+function updateStreamingBlock(block) {
+    const body = block.truncate ? truncateToolText(block.body) : block.body;
+    block.line.content = block.label ? `${block.label}\n${body}` : body;
+}
+/**
+ * Format the body of a memory phase event for display. Returns the empty
+ * string when there are no observations or usage bumps to show, so the
+ * caller can elide the block entirely.
+ */
+export function formatMemoryEventBody(event) {
+    const hasObservations = Boolean(event.observations && event.observations.length > 0);
+    const hasBumps = Boolean(event.usageBumpedObservations && event.usageBumpedObservations.length > 0);
+    if (!hasObservations && !hasBumps) {
+        return "";
+    }
+    const sections = [event.message];
+    if (hasObservations) {
+        sections.push(event.observations.map((observation) => observation.content).join("\n\n"));
+    }
+    return truncateToolText(sections.join("\n"));
+}
+//# sourceMappingURL=step-renderer.js.map

package/dist/src/tui/step-renderer.js.map

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

package/dist/src/tui/transcript-writer.d.ts

@@ -0,0 +1,63 @@
+import { type CliRenderer, type KeyEvent, type ScrollBoxRenderable, TextRenderable } from "@opentui/core";
+import type { TranscriptEntry } from "./transcript-log.js";
+export interface TranscriptWriterOptions {
+    /** Reads the last drag-selected text; surfaced in `/diag` key dumps so we
+     *  can correlate "key fired" with "selection state at that moment". */
+    getLastSelectionText: () => string;
+    /** Invoked when the underlying TextBuffer is observed to be destroyed
+     *  mid-mutation (the OpenTUI race the v0.1.68 fix targets). The caller
+     *  uses this to tear down timers (working ticker) that would otherwise
+     *  fire again on a dead buffer. */
+    onBufferDestroyed?: () => void;
+}
+/**
+ * Owns every write to the transcript ScrollBox plus the `/diag` key+selection
+ * event log. Centralizing here keeps the post-teardown try/catch that swallows
+ * "TextBuffer is destroyed" in exactly one place (v0.1.68 fix), and gives the
+ * status/hint controllers a single `isDestroyed()` source of truth.
+ */
+export declare class TranscriptWriter {
+    private readonly renderer;
+    private readonly transcript;
+    private readonly options;
+    private destroyed;
+    private hasRenderedAnyBlock;
+    private keyDiagnostics;
+    private readonly log;
+    constructor(renderer: CliRenderer, transcript: ScrollBoxRenderable, options: TranscriptWriterOptions);
+    /** Append a single line. Empty content is ignored so callers can guard with
+     *  raw input without producing blank rows; use `addLine` instead when a
+     *  spacer is wanted and a renderable handle is needed. */
+    appendLine(content: string, fg: string): void;
+    /** Append a labelled block. `beginBlock()` inserts a blank separator before
+     *  every block except the first so distinct steps stay visually distinct. */
+    appendBlock(label: string | null, body: string, fg: string): void;
+    beginBlock(): void;
+    /** Append a line and return the renderable handle. Used by the starter
+     *  block (which destroys its own refs on dismiss) and substitutes a single
+     *  space for empty content so the renderable still occupies a row. */
+    addLine(content: string, fg: string): TextRenderable;
+    /** Records a user/agent message body in the parallel log read by `/copy`
+     *  and the copy keystroke. Trims and drops empty payloads so noisy
+     *  presentation-only writes (spacers, etc.) do not pollute the log. */
+    recordEntry(kind: TranscriptEntry["kind"], text: string): void;
+    entries(): readonly TranscriptEntry[];
+    /** Flipped from the renderer `destroy` handler. Subsequent transcript
+     *  writes short-circuit instead of throwing from a destroyed buffer. */
+    markDestroyed(): void;
+    isDestroyed(): boolean;
+    setKeyDiagnosticsEnabled(enabled: boolean): void;
+    isKeyDiagnosticsEnabled(): boolean;
+    logKey(label: string, key: KeyEvent): void;
+    logSelection(text: string): void;
+    private handleBufferDestroyed;
+}
+/**
+ * OpenTUI's TextBuffer throws a plain Error with this exact message from its
+ * `guard()` method when any setter is touched after destroy. We sniff the
+ * message to distinguish post-teardown races (swallow) from real bugs
+ * (rethrow). Exported so the status/hint controllers can share the same
+ * sniff without re-importing OpenTUI internals.
+ */
+export declare function isTextBufferDestroyedError(error: unknown): boolean;
+//# sourceMappingURL=transcript-writer.d.ts.map

package/dist/src/tui/transcript-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-writer.d.ts","sourceRoot":"","sources":["../../../src/tui/transcript-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,cAAc,EACf,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC;2EACuE;IACvE,oBAAoB,EAAE,MAAM,MAAM,CAAC;IACnC;;;uCAGmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAOzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;gBAG1B,QAAQ,EAAE,WAAW,EACrB,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE,uBAAuB;IAKnD;;8DAE0D;IAC1D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAe7C;iFAC6E;IAC7E,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAMjE,UAAU,IAAI,IAAI;IAKlB;;0EAEsE;IACtE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc;IAQpD;;2EAEuE;IACvE,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9D,OAAO,IAAI,SAAS,eAAe,EAAE;IAMrC;4EACwE;IACxE,aAAa,IAAI,IAAI;IAIrB,WAAW,IAAI,OAAO;IAMtB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIhD,uBAAuB,IAAI,OAAO;IAIlC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;IAgB1C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAShC,OAAO,CAAC,qBAAqB;CAI9B;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElE"}