@duetso/agent 0.1.81 → 0.1.83

package/dist/src/tui/starter-section.d.ts

@@ -0,0 +1,99 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
+import { type CliRenderer, type ScrollBoxRenderable, type TextareaRenderable } from "@opentui/core";
+import type { TranscriptWriter } from "./transcript-writer.js";
+export interface StarterSectionOptions {
+    /** Working directory used to seed cwd-aware starter prompts. */
+    workDir: string;
+    /** Current session id; excluded from the recent-sessions list so the
+     *  "pick up the thread" rows do not advertise the live session. */
+    sessionId: string;
+    /** Optional resumed-conversation history fed into starter selection so
+     *  the picker can surface a resume prompt synthesized from the last
+     *  user turn. */
+    history?: AgentMessage[];
+    /** Composer renderable. The section watches `plainText.length` to decide
+     *  whether to repaint the chrome on `syncVisibility`. */
+    inputField: TextareaRenderable;
+    /** Transcript scrollbox; each rendered starter row is appended to the
+     *  scrollbox via `transcriptWriter.addLine` and removed on dismiss. */
+    transcript: ScrollBoxRenderable;
+    /** Transcript writer surfaces `addLine` for the rendered starter rows
+     *  (so the scrollbox owns them) but the section never writes any
+     *  bordered blocks. */
+    transcriptWriter: TranscriptWriter;
+    /** Renderer; only used to tear the TUI down when a "pick up the thread"
+     *  row signals a resume to the outer dispatcher. */
+    renderer: CliRenderer;
+    /** Submit a typed prompt as if the user had hit Enter. Wired to
+     *  `runTui`'s `submit` so non-resume starter rows kick off a real turn. */
+    submit: (text: string) => void;
+    /** When wired, recent-session rows route through this callback so the
+     *  outer dispatcher can swap sessions; when unset (tests, playground)
+     *  the section falls back to re-submitting the prior prompt. */
+    onResumeRequest?: (sessionId: string) => void;
+}
+/**
+ * Boot-screen starter picker. Offers a small set of context-aware prompts
+ * so first-time and returning users land on something concrete in <2
+ * seconds instead of staring at a blank input.
+ *
+ * Lifecycle:
+ *
+ *   - `mount(skills)` runs once on boot and lays down the section.
+ *   - `syncVisibility()` hides/restores the chrome as the composer fills
+ *     and empties, until the user actually commits a prompt.
+ *   - The first submit calls `destroyPermanently()` and the section
+ *     never comes back this session.
+ *
+ * `runTui` skips construction entirely when `input.isResume` is set —
+ * the user explicitly asked to drop back into a known conversation and
+ * "what should we work on today?" before replaying history is noise.
+ */
+export declare class StarterSection {
+    private readonly opts;
+    private readonly entries;
+    private readonly refs;
+    private readonly rowIndexes;
+    private highlightedIndex;
+    private visible;
+    private permanentlyDismissed;
+    private skillCount;
+    constructor(opts: StarterSectionOptions);
+    /**
+     * Build the entry list from cwd-aware starter selection plus the recent
+     * sessions on disk, then paint the chrome. Idempotent across the section
+     * lifecycle in the sense that calling it again with no entries is a
+     * no-op, but typical use is exactly once on boot.
+     */
+    mount(skills: ReadonlyArray<{
+        name: string;
+    }>): void;
+    isVisible(): boolean;
+    move(delta: number): void;
+    jump(targetIndex: number): boolean;
+    /**
+     * Transient hide. Tears down the rendered refs but keeps `entries` and
+     * `highlightedIndex` so `mountChrome()` can restore the exact same
+     * picker if the user backspaces the composer empty again.
+     */
+    dismiss(): void;
+    /**
+     * Permanent destruction: called when the user commits a prompt. After
+     * this the chrome never comes back, even on backspace-to-empty.
+     */
+    destroyPermanently(): void;
+    isPermanentlyDismissed(): boolean;
+    /**
+     * Toggle hook called from `inputField.onContentChange`. Hides the chrome
+     * as soon as the user starts composing, brings it back if they backspace
+     * the composer empty (but only until they actually submit — then
+     * `permanentlyDismissed` latches).
+     */
+    syncVisibility(): void;
+    submitHighlighted(): boolean;
+    private mountChrome;
+    private addLine;
+    private formatRow;
+    private paintHighlight;
+}
+//# sourceMappingURL=starter-section.d.ts.map

package/dist/src/tui/starter-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-section.d.ts","sourceRoot":"","sources":["../../../src/tui/starter-section.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EAExB,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAKvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB;;qBAEiB;IACjB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB;6DACyD;IACzD,UAAU,EAAE,kBAAkB,CAAC;IAC/B;2EACuE;IACvE,UAAU,EAAE,mBAAmB,CAAC;IAChC;;2BAEuB;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC;wDACoD;IACpD,QAAQ,EAAE,WAAW,CAAC;IACtB;+EAC2E;IAC3E,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B;;oEAEgE;IAChE,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/C;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IAgBb,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;IAG7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAC3C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,OAAO,CAAS;IAIxB,OAAO,CAAC,oBAAoB,CAAS;IAGrC,OAAO,CAAC,UAAU,CAAK;gBAEM,IAAI,EAAE,qBAAqB;IAExD;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAmCpD,SAAS,IAAI,OAAO;IAIpB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzB,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAQlC;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAWf;;;OAGG;IACH,kBAAkB,IAAI,IAAI;IAO1B,sBAAsB,IAAI,OAAO;IAIjC;;;;;OAKG;IACH,cAAc,IAAI,IAAI;IAWtB,iBAAiB,IAAI,OAAO;IA6B5B,OAAO,CAAC,WAAW;IAiEnB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/src/tui/starter-section.js

@@ -0,0 +1,254 @@
+import { listRecentSessions } from "./recent-sessions.js";
+import { orderedSelectableStarters, selectStarters } from "./starters.js";
+import { COLORS } from "./theme.js";
+/**
+ * Boot-screen starter picker. Offers a small set of context-aware prompts
+ * so first-time and returning users land on something concrete in <2
+ * seconds instead of staring at a blank input.
+ *
+ * Lifecycle:
+ *
+ *   - `mount(skills)` runs once on boot and lays down the section.
+ *   - `syncVisibility()` hides/restores the chrome as the composer fills
+ *     and empties, until the user actually commits a prompt.
+ *   - The first submit calls `destroyPermanently()` and the section
+ *     never comes back this session.
+ *
+ * `runTui` skips construction entirely when `input.isResume` is set —
+ * the user explicitly asked to drop back into a known conversation and
+ * "what should we work on today?" before replaying history is noise.
+ */
+export class StarterSection {
+    opts;
+    entries = [];
+    refs = [];
+    // Indexes within `refs` that correspond to numbered rows; used to
+    // repaint highlight on arrow / digit navigation.
+    rowIndexes = [];
+    highlightedIndex = 0;
+    visible = false;
+    // Once the user commits a prompt, the chrome is gone for the session.
+    // Until then `dismiss()` is a reversible hide that `syncVisibility()`
+    // can restore when the composer empties again.
+    permanentlyDismissed = false;
+    // Cached so the chrome can re-render the trailing "✦ N skills · /help"
+    // line without re-running selectStarters.
+    skillCount = 0;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    /**
+     * Build the entry list from cwd-aware starter selection plus the recent
+     * sessions on disk, then paint the chrome. Idempotent across the section
+     * lifecycle in the sense that calling it again with no entries is a
+     * no-op, but typical use is exactly once on boot.
+     */
+    mount(skills) {
+        // Read recent sessions off disk synchronously. The helper swallows fs
+        // errors and returns an empty list; a missing/empty ~/.duet/sessions
+        // directory is the common first-boot case.
+        const recentSessions = listRecentSessions({
+            excludeId: this.opts.sessionId,
+            limit: 4,
+        });
+        const result = selectStarters({
+            cwd: this.opts.workDir,
+            sessionHistory: this.opts.history,
+            recentSessions,
+        });
+        // Selectable rows in render order. Recent sessions lead so returning
+        // users hit "pick up the thread" first; new users see the cwd
+        // starters under the original "what should we work on today?" header.
+        const ordered = orderedSelectableStarters(result);
+        this.entries.length = 0;
+        for (const row of ordered) {
+            if (row.kind === "recent" && row.sessionId !== undefined) {
+                this.entries.push({
+                    kind: "recent",
+                    label: row.label,
+                    submit: row.submit,
+                    sessionId: row.sessionId,
+                });
+            }
+            else {
+                this.entries.push({ kind: "prompt", label: row.label, submit: row.submit });
+            }
+        }
+        this.skillCount = skills.length;
+        this.highlightedIndex = 0;
+        this.mountChrome();
+    }
+    isVisible() {
+        return this.visible;
+    }
+    move(delta) {
+        if (!this.visible || this.entries.length === 0)
+            return;
+        const next = (this.highlightedIndex + delta + this.entries.length) % this.entries.length;
+        this.highlightedIndex = next;
+        this.paintHighlight();
+    }
+    jump(targetIndex) {
+        if (!this.visible)
+            return false;
+        if (targetIndex < 0 || targetIndex >= this.entries.length)
+            return false;
+        this.highlightedIndex = targetIndex;
+        this.paintHighlight();
+        return true;
+    }
+    /**
+     * Transient hide. Tears down the rendered refs but keeps `entries` and
+     * `highlightedIndex` so `mountChrome()` can restore the exact same
+     * picker if the user backspaces the composer empty again.
+     */
+    dismiss() {
+        if (!this.visible && this.refs.length === 0)
+            return;
+        for (const ref of this.refs) {
+            this.opts.transcript.remove(ref.id);
+            ref.destroy();
+        }
+        this.refs.length = 0;
+        this.rowIndexes.length = 0;
+        this.visible = false;
+    }
+    /**
+     * Permanent destruction: called when the user commits a prompt. After
+     * this the chrome never comes back, even on backspace-to-empty.
+     */
+    destroyPermanently() {
+        this.dismiss();
+        this.entries.length = 0;
+        this.highlightedIndex = 0;
+        this.permanentlyDismissed = true;
+    }
+    isPermanentlyDismissed() {
+        return this.permanentlyDismissed;
+    }
+    /**
+     * Toggle hook called from `inputField.onContentChange`. Hides the chrome
+     * as soon as the user starts composing, brings it back if they backspace
+     * the composer empty (but only until they actually submit — then
+     * `permanentlyDismissed` latches).
+     */
+    syncVisibility() {
+        if (this.permanentlyDismissed)
+            return;
+        if (this.entries.length === 0)
+            return;
+        const empty = this.opts.inputField.plainText.length === 0;
+        if (!empty && this.visible) {
+            this.dismiss();
+        }
+        else if (empty && !this.visible) {
+            this.mountChrome();
+        }
+    }
+    submitHighlighted() {
+        if (!this.visible)
+            return false;
+        const entry = this.entries[this.highlightedIndex];
+        if (!entry)
+            return false;
+        this.destroyPermanently();
+        // Recent-session rows: when the host wires `onResumeRequest`, signal
+        // the outer dispatcher to swap sessions and tear down this renderer.
+        // The dispatcher disposes the placeholder, calls `manager.resume(id)`
+        // + `hydrate()` + `start()`, and re-enters `runTui` with the hydrated
+        // session + its full message history. End user lands on the same
+        // session id, same agent context, same transcript replayed inline.
+        //
+        // When no callback is wired (tests, playground), fall back to the
+        // legacy shortcut: re-submit the prior prompt in the current session.
+        // Agent has no context; the user lands on the same task with one
+        // keystroke instead of typing it again.
+        if (entry.kind === "recent" && this.opts.onResumeRequest) {
+            this.opts.onResumeRequest(entry.sessionId);
+            this.opts.renderer.destroy();
+            return true;
+        }
+        this.opts.submit(entry.submit);
+        return true;
+    }
+    // Paint the chrome (section headers, numbered rows, hint footer) from
+    // the current `entries` + `highlightedIndex`. Called on first boot and
+    // on every backspace-to-empty restoration. Idempotent: bails if the
+    // chrome is already mounted or no entries exist.
+    mountChrome() {
+        if (this.visible || this.entries.length === 0)
+            return;
+        const recentEntries = this.entries.filter((entry) => entry.kind === "recent");
+        const promptEntries = this.entries.filter((entry) => entry.kind === "prompt");
+        const hasRecent = recentEntries.length > 0;
+        // Every line we render here — spacers included — goes through
+        // `addLine` and gets pushed to `refs`. `dismiss()` iterates that list
+        // to destroy refs; spacers added via fire-and-forget `appendLine`
+        // would leak and accumulate above the next mount on each type →
+        // backspace cycle, pushing the chrome lower every time.
+        const spacer = () => {
+            this.refs.push(this.addLine(" ", COLORS.hint));
+        };
+        this.rowIndexes.length = 0;
+        spacer();
+        if (hasRecent) {
+            this.refs.push(this.addLine("pick up the thread", COLORS.agent));
+            spacer();
+            for (let i = 0; i < this.entries.length; i += 1) {
+                if (this.entries[i].kind !== "recent")
+                    continue;
+                const ref = this.addLine(this.formatRow(i, false), COLORS.hint);
+                this.rowIndexes.push(this.refs.length);
+                this.refs.push(ref);
+            }
+            if (promptEntries.length > 0) {
+                spacer();
+                this.refs.push(this.addLine("or start something new", COLORS.agent));
+                spacer();
+                for (let i = 0; i < this.entries.length; i += 1) {
+                    if (this.entries[i].kind !== "prompt")
+                        continue;
+                    const ref = this.addLine(this.formatRow(i, false), COLORS.hint);
+                    this.rowIndexes.push(this.refs.length);
+                    this.refs.push(ref);
+                }
+            }
+        }
+        else {
+            this.refs.push(this.addLine("what should we work on today?", COLORS.agent));
+            spacer();
+            for (let i = 0; i < this.entries.length; i += 1) {
+                const ref = this.addLine(this.formatRow(i, false), COLORS.hint);
+                this.rowIndexes.push(this.refs.length);
+                this.refs.push(ref);
+            }
+        }
+        spacer();
+        this.refs.push(this.addLine("type a number to run, ↑/↓ to highlight, or just start typing.", COLORS.hint));
+        this.refs.push(this.addLine(`✦ ${this.skillCount} skill${this.skillCount === 1 ? "" : "s"} · /help`, COLORS.hint));
+        this.visible = true;
+        if (this.highlightedIndex >= this.entries.length)
+            this.highlightedIndex = 0;
+        this.paintHighlight();
+    }
+    addLine(content, fg) {
+        return this.opts.transcriptWriter.addLine(content, fg);
+    }
+    formatRow(index, highlighted) {
+        const entry = this.entries[index];
+        const text = entry?.label ?? "";
+        const number = index + 1;
+        const arrow = highlighted ? "▶" : "→";
+        const numberCell = highlighted ? `[${number}]` : ` ${number} `;
+        return `   ${numberCell}  ${arrow}  ${text}`;
+    }
+    paintHighlight() {
+        for (let i = 0; i < this.rowIndexes.length; i += 1) {
+            const ref = this.refs[this.rowIndexes[i]];
+            const isHighlighted = i === this.highlightedIndex;
+            ref.content = this.formatRow(i, isHighlighted);
+            ref.fg = isHighlighted ? COLORS.user : COLORS.hint;
+        }
+    }
+}
+//# sourceMappingURL=starter-section.js.map

package/dist/src/tui/starter-section.js.map

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

package/dist/src/tui/status-controller.d.ts

@@ -0,0 +1,94 @@
+import { type CliRenderer, type TextRenderable } from "@opentui/core";
+import type { TurnTerminalEvent } from "../types/protocol.js";
+export interface StatusControllerOptions {
+    /** Renderer that owns the chrome TextBuffers. Passed through so the
+     *  controller can be constructed alongside the other chrome-touching
+     *  controllers without re-deriving it from `status`/`hint`. */
+    renderer: CliRenderer;
+    /** Working-status line ("● working… (3s)"). Mutated by `setStatus` and the
+     *  ticker; cleared when idle. */
+    status: TextRenderable;
+    /** Bottom hint row. Recomposed by `setHint` from the running/attachment/
+     *  selection segments. */
+    hint: TextRenderable;
+    /**
+     * Re-paints every in-flight tool block header with a fresh spinner +
+     * elapsed counter. Invoked from the ticker so spinners advance in step
+     * with the working-status line. Provided externally because the tool
+     * block map lives with the step renderer, not the status controller.
+     */
+    refreshActiveToolBlocks: () => void;
+}
+/**
+ * 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 declare class StatusController {
+    private readonly opts;
+    private destroyed;
+    private running;
+    private workingStartedAt;
+    private workingTicker;
+    private workingMessage;
+    private queuedFollowUps;
+    private pendingImageCount;
+    private lastSelectionText;
+    private terminal;
+    constructor(opts: StatusControllerOptions);
+    isRunning(): boolean;
+    lastTerminal(): TurnTerminalEvent | undefined;
+    /** 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(): number | undefined;
+    setWorkingMessage(message: string): void;
+    setQueuedFollowUps(count: number): void;
+    /** 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: string): void;
+    /** 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: number): void;
+    markRunning(): void;
+    /** 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?: TurnTerminalEvent): void;
+    setStatus(text: string): void;
+    /** 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(): void;
+    refreshWorkingStatus(): void;
+    /** 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(): void;
+    private startWorkingTicker;
+    private stopWorkingTicker;
+    private attachmentHint;
+}
+/**
+ * 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 declare function formatElapsed(ms: number): string;
+/**
+ * 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 declare function runningMarker(elapsedMs: number): string;
+//# sourceMappingURL=status-controller.d.ts.map

package/dist/src/tui/status-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-controller.d.ts","sourceRoot":"","sources":["../../../src/tui/status-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC;;mEAE+D;IAC/D,QAAQ,EAAE,WAAW,CAAC;IACtB;qCACiC;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB;8BAC0B;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB;;;;;OAKG;IACH,uBAAuB,EAAE,MAAM,IAAI,CAAC;CACrC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAWf,OAAO,CAAC,QAAQ,CAAC,IAAI;IAVjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,QAAQ,CAAgC;gBAEnB,IAAI,EAAE,uBAAuB;IAE1D,SAAS,IAAI,OAAO;IAIpB,YAAY,IAAI,iBAAiB,GAAG,SAAS;IAI7C;;gEAE4D;IAC5D,mBAAmB,IAAI,MAAM,GAAG,SAAS;IAIzC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKxC,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKvC;;2DAEuD;IACvD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKpC;;0BAEsB;IACtB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzC,WAAW,IAAI,IAAI;IASnB;;2EAEuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAU5C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAoB7B;;;uEAGmE;IACnE,WAAW,IAAI,IAAI;IAkBnB,oBAAoB,IAAI,IAAI;IAY5B;;6EAEyE;IACzE,QAAQ,IAAI,IAAI;IAKhB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,cAAc;CAIvB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD"}

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