@duetso/agent 0.1.81 → 0.1.83

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"}

package/dist/src/tui/transcript-writer.js

@@ -0,0 +1,130 @@
+import { TextRenderable, } from "@opentui/core";
+import { COLORS } from "./theme.js";
+/**
+ * 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 class TranscriptWriter {
+    renderer;
+    transcript;
+    options;
+    destroyed = false;
+    hasRenderedAnyBlock = false;
+    keyDiagnostics = false;
+    log = [];
+    constructor(renderer, transcript, options) {
+        this.renderer = renderer;
+        this.transcript = transcript;
+        this.options = options;
+    }
+    // ---- transcript writes ---------------------------------------------------
+    /** 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, fg) {
+        if (!content)
+            return;
+        if (this.destroyed)
+            return;
+        try {
+            const line = new TextRenderable(this.renderer, { content, fg });
+            this.transcript.add(line);
+        }
+        catch (error) {
+            if (isTextBufferDestroyedError(error)) {
+                this.handleBufferDestroyed();
+                return;
+            }
+            throw error;
+        }
+    }
+    /** Append a labelled block. `beginBlock()` inserts a blank separator before
+     *  every block except the first so distinct steps stay visually distinct. */
+    appendBlock(label, body, fg) {
+        this.beginBlock();
+        const text = label ? `${label}\n${body}` : body;
+        for (const line of text.split("\n"))
+            this.appendLine(line, fg);
+    }
+    beginBlock() {
+        if (this.hasRenderedAnyBlock)
+            this.appendLine(" ", COLORS.hint);
+        this.hasRenderedAnyBlock = true;
+    }
+    /** 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, fg) {
+        const line = new TextRenderable(this.renderer, { content: content || " ", fg });
+        this.transcript.add(line);
+        return line;
+    }
+    // ---- transcript log ------------------------------------------------------
+    /** 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, text) {
+        const trimmed = text.trim();
+        if (!trimmed)
+            return;
+        this.log.push({ kind, text: trimmed });
+    }
+    entries() {
+        return this.log;
+    }
+    // ---- teardown ------------------------------------------------------------
+    /** Flipped from the renderer `destroy` handler. Subsequent transcript
+     *  writes short-circuit instead of throwing from a destroyed buffer. */
+    markDestroyed() {
+        this.destroyed = true;
+    }
+    isDestroyed() {
+        return this.destroyed;
+    }
+    // ---- /diag key + selection logging ---------------------------------------
+    setKeyDiagnosticsEnabled(enabled) {
+        this.keyDiagnostics = enabled;
+    }
+    isKeyDiagnosticsEnabled() {
+        return this.keyDiagnostics;
+    }
+    logKey(label, key) {
+        if (!this.keyDiagnostics)
+            return;
+        const flags = [];
+        if (key.ctrl)
+            flags.push("ctrl");
+        if (key.shift)
+            flags.push("shift");
+        if (key.meta)
+            flags.push("meta");
+        if (key.super)
+            flags.push("super");
+        if (key.option)
+            flags.push("option");
+        const selection = this.options.getLastSelectionText();
+        this.appendBlock("[diag]", `${label} name=${JSON.stringify(key.name)} flags=[${flags.join(",")}] sequence=${JSON.stringify(key.sequence)} source=${key.source} | lastSelection=${selection.length}c rendererSel=${this.renderer.hasSelection ? "yes" : "no"}`, COLORS.hint);
+    }
+    logSelection(text) {
+        if (!this.keyDiagnostics)
+            return;
+        this.appendBlock("[diag]", `selection event: ${text.length} chars — ${JSON.stringify(text.slice(0, 80))}`, COLORS.hint);
+    }
+    handleBufferDestroyed() {
+        this.destroyed = true;
+        this.options.onBufferDestroyed?.();
+    }
+}
+/**
+ * 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 function isTextBufferDestroyedError(error) {
+    return error instanceof Error && error.message === "TextBuffer is destroyed";
+}
+//# sourceMappingURL=transcript-writer.js.map

package/dist/src/tui/transcript-writer.js.map

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

package/dist/src/turn-runner/turn-runner.d.ts

@@ -6,6 +6,7 @@ import { MemoryContextCache } from "../memory/store.js";
 import type { TurnRunnerConfig } from "../types/config.js";
 import type { TurnAgentFile, TurnAnswerCommand, TurnContextWindowUsage, TurnEditFollowUpQueueCommand, TurnEvent, TurnInterruptCommand, TurnMode, TurnPromptCommand, TurnState, TurnTokenUsage, TurnStartCommand, TurnTerminalEvent, TurnCommand, TurnOptions } from "../types/protocol.js";
 import type { StateMachineAgentState } from "../types/state-machine.js";
+import { type WireGuardHorizon } from "./wire-shaping.js";
 import { type TurnRunnerControlResult } from "./tools.js";
 import { SkillContext } from "./skill-context.js";
 import { type StateAgentHandle } from "./state-machine-controller.js";
@@ -26,9 +27,26 @@ export interface AgentConfigInput {
     skills?: Skill[];
     tools: AgentTool[];
 }
+/**
+ * Internal outcome of a single `runAgentWorker` call. Narrower than the
+ * public `TurnTerminalEvent`: a worker only produces `complete` or
+ * `interrupted`. `ask` is synthesized later from `control`; `sleep` is
+ * synthesized by the state-machine controller.
+ */
+export type AgentWorkerOutcome = {
+    type: "complete";
+    status: "completed" | "failed";
+    result?: string;
+    error?: string;
+    state: TurnState;
+} | {
+    type: "interrupted";
+    state: TurnState;
+};
 export interface AgentWorkerResult {
-    terminal: TurnTerminalEvent;
+    outcome: AgentWorkerOutcome;
     control: TurnRunnerControlResult;
+    parentUsage?: TurnTokenUsage;
 }
 /**
  * Rescale the four segment estimates so they sum exactly to the
@@ -182,10 +200,51 @@ export declare class TurnRunner {
      * aggregate and emits a `usage` event so consumers see cost tick after
      * each parent agent boundary. Recording at the worker boundary (instead
      * of per `message_end`) keeps the same behavior when test harnesses
-     * stub `runAgentWorker` and supply `terminal.usage` directly without
+     * stub `runAgentWorker` and supply `parentUsage` directly without
      * running a real pi `Agent`.
      */
     private runAgentWorkerWithUsage;
+    /**
+     * Inspect the most recent assistant message after a parent prompt and,
+     * when it carries a provider context-overflow error, mutate the agent
+     * state and the sticky `wireGuardHorizon` so that a subsequent re-prompt
+     * sends roughly the newer half of observable history.
+     *
+     * Returns `true` only when recovery actually happened — meaning the
+     * horizon advanced past at least one observable message. Callers use
+     * the return value as a single-shot gate: invoke once after the first
+     * `agent.prompt(...)` and, on `true`, resume the turn via
+     * `agent.continue()` exactly once. The helper never inspects the
+     * failing message again, so a second overflow on the retry falls
+     * through naturally as a `failed` turn.
+     *
+     * Mutations on success:
+     * - pops the failure assistant message that pi-agent pushed for the
+     *   overflow (an empty-text marker with `stopReason: "error"` and
+     *   `errorMessage`) so the retry's transcript does not carry it.
+     *   `agent.continue()`'s own run lifecycle resets `errorMessage`
+     *   before the retry, so we do not clear it here;
+     * - advances `this.wireGuardHorizon.evictionHorizon` to the smallest
+     *   value at which `findEvictionHorizon` reports the dispatched list
+     *   shrinks to at most `floor(n / 2)` observable messages, where `n`
+     *   excludes the failure message itself.
+     *
+     * Emits one informational `system` event describing the compaction so
+     * surfaces can show a notice. The message reports the *actual*
+     * post-eviction drop count (after `MIN_HISTORY_TAIL` clamping and
+     * orphan-head skipping), not the half-of-n target.
+     *
+     * Returns `false` when:
+     * - the parent agent did not fail (`errorMessage` is unset);
+     * - the failure is not a context overflow (rate limit, transport
+     *   error, etc. — left as-is for the caller to surface);
+     * - no horizon advance is possible (e.g. the existing horizon already
+     *   covers every evictable message, or the history is too short to
+     *   satisfy `MIN_HISTORY_TAIL`). In those cases retrying with the
+     *   same context would still overflow, so we accept the failure
+     *   instead of paying a second pointless request.
+     */
+    protected tryRecoverFromContextOverflow(agent: Agent): boolean;
     protected updateMemoryAfterAgentRun(messages: AgentMessage[], options: TurnOptions | undefined): Promise<void>;
     private refreshMemoryContextPack;
     /**
@@ -196,7 +255,7 @@ export declare class TurnRunner {
     resolveMemoryActorModel(options: TurnOptions | undefined): string;
     protected createAgent(input: AgentConfigInput, onControlResult?: (result: TurnRunnerControlResult) => void): Agent;
     protected createMemoryTransform(): (messages: AgentMessage[]) => Promise<AgentMessage[]>;
-    private readonly wireGuardHorizon;
+    protected readonly wireGuardHorizon: WireGuardHorizon;
     getSkills(): Promise<readonly Skill[]>;
     /** System-prompt files (AGENTS.md by default) that resolved on disk for this session. */
     getResolvedAgentFiles(): Promise<readonly TurnAgentFile[]>;
@@ -216,6 +275,13 @@ export declare class TurnRunner {
         skills?: readonly Skill[];
     }): string;
     private askUserQuestion;
+    /**
+     * Lifts the internal `AgentWorkerOutcome` shape into the public
+     * `TurnTerminalEvent` shape returned by `runTurnChain`. `runTurnChain`
+     * attaches `usage` / `effectiveContextWindow` / `contextWindowUsage`
+     * at the chain boundary, so this conversion intentionally omits them.
+     */
+    private outcomeToTerminal;
     /**
      * Single source of truth for per-turn option precedence:
      * explicit turn options → carried-over state base → runner config → defaults.