@duetso/agent 0.1.80 → 0.1.82

package/dist/src/tui/slash-commands.d.ts

@@ -0,0 +1,23 @@
+import type { CopyController } from "./copy-controller.js";
+import type { PasteController } from "./paste-controller.js";
+import type { TranscriptWriter } from "./transcript-writer.js";
+/**
+ * Surface used by the slash-command dispatcher. Every handler in this module
+ * is stateless and reaches its mutable state through the controllers wired up
+ * by `runTui`. The dispatcher returns true when the message was claimed so
+ * `submit()` can short-circuit before the message reaches `session.prompt()`.
+ */
+export interface SlashCommandContext {
+    pasteController: PasteController;
+    copyController: CopyController;
+    transcriptWriter: TranscriptWriter;
+    appendBlock(label: string | null, body: string, fg: string): void;
+}
+/**
+ * Routes the message to a local handler when it begins with a slash command
+ * recognized by the TUI. Returns true when handled (caller must not forward
+ * the message to the runner) and false when the message should fall through
+ * to the normal prompt path.
+ */
+export declare function tryDispatchSlashCommand(message: string, ctx: SlashCommandContext): boolean;
+//# sourceMappingURL=slash-commands.d.ts.map

package/dist/src/tui/slash-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slash-commands.d.ts","sourceRoot":"","sources":["../../../src/tui/slash-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI/D;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,eAAe,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CA2B1F"}

package/dist/src/tui/slash-commands.js

@@ -0,0 +1,79 @@
+import { submitDuetFeedback } from "../lib/feedback.js";
+import { COLORS } from "./theme.js";
+/**
+ * Routes the message to a local handler when it begins with a slash command
+ * recognized by the TUI. Returns true when handled (caller must not forward
+ * the message to the runner) and false when the message should fall through
+ * to the normal prompt path.
+ */
+export function tryDispatchSlashCommand(message, ctx) {
+    if (message.startsWith("/image ") || message === "/image") {
+        void handleImageSlashCommand(message, ctx);
+        return true;
+    }
+    if (message === "/paste") {
+        void ctx.pasteController.triggerClipboardProbe("slash");
+        return true;
+    }
+    if (message === "/clear-images") {
+        ctx.pasteController.clearPendingImages();
+        ctx.appendBlock("[paste]", "cleared pending image attachments", COLORS.system);
+        return true;
+    }
+    if (message === "/copy" || message.startsWith("/copy ")) {
+        void ctx.copyController.handleCopySlashCommand(message);
+        return true;
+    }
+    if (message === "/diag" || message.startsWith("/diag ")) {
+        handleDiagSlashCommand(message, ctx);
+        return true;
+    }
+    if (message === "/feedback" || message.startsWith("/feedback ")) {
+        void handleFeedbackSlashCommand(message, ctx);
+        return true;
+    }
+    return false;
+}
+/**
+ * `/diag` toggles a key + selection event log so users can show us exactly
+ * what their terminal forwards when something silently fails (a keystroke
+ * that never reaches the handler, a selection event firing with empty text).
+ * Kept as a flag rather than a one-shot capture so we can layer additional
+ * diagnostic facets on the same surface without inventing new commands.
+ */
+function handleDiagSlashCommand(raw, ctx) {
+    const argument = raw === "/diag" ? "" : raw.slice("/diag ".length).trim();
+    if (argument === "" || argument === "keys") {
+        const enabled = !ctx.transcriptWriter.isKeyDiagnosticsEnabled();
+        ctx.transcriptWriter.setKeyDiagnosticsEnabled(enabled);
+        ctx.appendBlock("[diag]", enabled
+            ? "key + selection event logging ON. Run /diag again to stop."
+            : "key + selection event logging OFF.", COLORS.system);
+        return;
+    }
+    ctx.appendBlock("[diag]", "Usage: /diag (or /diag keys) — toggles key + selection event logging", COLORS.system);
+}
+async function handleFeedbackSlashCommand(raw, ctx) {
+    const content = raw.slice("/feedback".length).trim();
+    if (!content) {
+        ctx.appendBlock("[feedback]", "Usage: /feedback <message>  — send free-form feedback to the Duet team", COLORS.system);
+        return;
+    }
+    ctx.appendBlock("[feedback]", "sending…", COLORS.system);
+    try {
+        const { baseUrl } = await submitDuetFeedback({ content });
+        ctx.appendBlock("[feedback]", `Thanks! Feedback sent to ${baseUrl}.`, COLORS.system);
+    }
+    catch (error) {
+        ctx.appendBlock("[feedback]", error instanceof Error ? error.message : String(error), COLORS.error);
+    }
+}
+async function handleImageSlashCommand(raw, ctx) {
+    const rest = raw.slice("/image".length).trim();
+    if (!rest) {
+        ctx.appendBlock("[paste]", "Usage: /image <path>  — attach a PNG/JPEG/GIF/WebP from disk", COLORS.system);
+        return;
+    }
+    await ctx.pasteController.attachImageFromPath(rest);
+}
+//# sourceMappingURL=slash-commands.js.map

package/dist/src/tui/slash-commands.js.map

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

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