@duetso/agent 0.1.81 → 0.1.82

package/dist/src/tui/question-picker.js

@@ -0,0 +1,308 @@
+import { fg, t, } from "@opentui/core";
+import { AUTOCOMPLETE_LIMITS, commitActiveAnswer, formatQuestionOptionDescription, moveQuestionHighlight, NO_HIGHLIGHT, restoreSavedAnswer, } from "./autocomplete.js";
+import { COLORS } from "./theme.js";
+const QUESTION_OPTION_LIMIT = AUTOCOMPLETE_LIMITS.questionOption;
+/**
+ * Owns the question picker: an ask terminal hands it a list of
+ * `TurnQuestion`s and the picker walks the user through them, accumulating
+ * selected option labels until the user either finishes the last question
+ * (dispatches an `answer`), types a free-form prompt over the top
+ * (`flushWithMessage`), or escapes out (host suppresses next escape so the
+ * TUI doesn't also exit).
+ *
+ * Single-select questions live-record the highlighted option as the answer
+ * so arrow navigation alone is enough; multi-select keeps the highlight
+ * separate from a checked-set toggled via Space/Enter and grows a synthetic
+ * "Done" row that advances to the next question.
+ */
+export class QuestionPicker {
+    opts;
+    pendingQuestions = [];
+    activeIndex = 0;
+    // `NO_HIGHLIGHT` (-1) means no row is highlighted yet — the user must press
+    // Up/Down to land on a concrete row. Single-select live-records the
+    // highlight as the answer; multi-select uses highlight purely for
+    // navigation and toggles the checked set on Space/Enter.
+    optionSelectedIndex = NO_HIGHLIGHT;
+    // Per-question checked indices for the active multi-select question. Reset
+    // when the picker advances to the next question; single-select questions
+    // simply ignore this set and use `optionSelectedIndex` instead.
+    multiSelectChecked = new Set();
+    // Answers collected while walking the picker, keyed by question text. We
+    // dispatch the full map once the user finishes the last question, or flush
+    // it early when they decide to type a free-form prompt instead.
+    accumulatedAnswers = {};
+    constructor(opts) {
+        this.opts = opts;
+    }
+    isOpen() {
+        const question = this.pendingQuestions[this.activeIndex];
+        return Boolean(question && question.options.length > 0);
+    }
+    show(questions) {
+        this.pendingQuestions = questions;
+        this.activeIndex = 0;
+        this.optionSelectedIndex = NO_HIGHLIGHT;
+        this.multiSelectChecked = new Set();
+        this.accumulatedAnswers = {};
+        this.render();
+    }
+    hide() {
+        this.pendingQuestions = [];
+        this.activeIndex = 0;
+        this.optionSelectedIndex = NO_HIGHLIGHT;
+        this.multiSelectChecked = new Set();
+        this.accumulatedAnswers = {};
+        this.opts.questionPanel.visible = false;
+        for (const row of this.opts.questionRows) {
+            row.visible = false;
+            row.content = "";
+        }
+    }
+    /**
+     * Confirm whatever is currently highlighted. Multi-select on a regular row
+     * toggles; multi-select on the Done row advances. Single-select always
+     * advances (highlight = answer is already live-recorded by Up/Down). No-op
+     * when nothing is highlighted yet so the user is forced to make an
+     * explicit choice (or skip via Right-arrow).
+     */
+    confirmSelection() {
+        const question = this.activeQuestion();
+        if (!question)
+            return false;
+        if (this.optionSelectedIndex === NO_HIGHLIGHT)
+            return false;
+        if (question.multiSelect && this.optionSelectedIndex !== this.activeQuestionDoneIndex()) {
+            this.toggleActiveMultiSelectOption();
+            return true;
+        }
+        return this.advanceOrSubmit();
+    }
+    /**
+     * Dispatch the partially-collected answers together with a free-form
+     * `message` (and any pending image attachments) as a single
+     * `session.answer({ ..., message, images })` turn, then hide the picker.
+     * Used when the user types over the top of an open picker — without this
+     * the partial selections would be discarded when the prompt fires.
+     */
+    flushWithMessage(message, images) {
+        void this.opts.session
+            .answer({
+            questions: this.pendingQuestions,
+            answers: this.accumulatedAnswers,
+            behavior: "follow_up",
+            message,
+            images,
+        })
+            .catch(this.opts.reportError);
+        this.hide();
+        if (!this.opts.isRunning())
+            this.opts.markRunning();
+    }
+    /**
+     * Handle a keystroke while the picker is open. Returns `true` if the key
+     * was claimed (and `key.preventDefault()` already called); the caller
+     * should stop further dispatch in that case. Returns `false` when the
+     * picker is closed or the key isn't one this controller handles.
+     */
+    handleKey(key) {
+        if (!this.isOpen())
+            return false;
+        if (key.name === "up") {
+            this.moveActiveHighlight(-1);
+            key.preventDefault();
+            return true;
+        }
+        if (key.name === "down") {
+            this.moveActiveHighlight(1);
+            key.preventDefault();
+            return true;
+        }
+        // Space confirms the active selection only when the composer is empty
+        // so users can still type a free-form prompt that includes spaces.
+        // Match either the named form (most terminals) or the literal-char
+        // form some kitty-keyboard parsers emit so the binding is robust
+        // regardless of how the host reports an unmodified Space.
+        if ((key.name === "space" || key.name === " ") && this.opts.inputField.plainText.length === 0) {
+            key.preventDefault();
+            this.confirmSelection();
+            return true;
+        }
+        // Left/Right navigate between questions, but only when the composer is
+        // empty so editing a typed prompt with arrow keys still works.
+        if ((key.name === "left" || key.name === "right") &&
+            this.opts.inputField.plainText.length === 0 &&
+            this.pendingQuestions.length > 1) {
+            const direction = key.name === "left" ? -1 : 1;
+            if (this.navigateActive(direction)) {
+                key.preventDefault();
+                return true;
+            }
+        }
+        if (key.name === "escape") {
+            key.preventDefault();
+            this.opts.onEscapeClose();
+            this.hide();
+            return true;
+        }
+        return false;
+    }
+    // ---- internal -----------------------------------------------------------
+    activeQuestion() {
+        return this.pendingQuestions[this.activeIndex];
+    }
+    /**
+     * Total navigable rows for the active question. The Up/Down handler clamps
+     * navigation to what is actually rendered on screen so a user cannot land
+     * the highlight on a row they cannot see.
+     */
+    activeRowCount() {
+        const question = this.activeQuestion();
+        if (!question)
+            return 0;
+        const optionLimit = question.multiSelect ? QUESTION_OPTION_LIMIT - 1 : QUESTION_OPTION_LIMIT;
+        const visibleOptionCount = Math.min(question.options.length, optionLimit);
+        return visibleOptionCount + (question.multiSelect ? 1 : 0);
+    }
+    /**
+     * Row index of the synthetic Done row when the active question is
+     * multi-select; `undefined` otherwise so callers don't compare against a
+     * sentinel value. The Done row sits one past the last visible option,
+     * clamped to the same limit `render()` uses.
+     */
+    activeQuestionDoneIndex() {
+        const question = this.activeQuestion();
+        if (!question?.multiSelect)
+            return undefined;
+        const optionLimit = QUESTION_OPTION_LIMIT - 1;
+        return Math.min(question.options.length, optionLimit);
+    }
+    render() {
+        const question = this.activeQuestion();
+        if (!question || question.options.length === 0) {
+            this.hide();
+            return;
+        }
+        const { questionPanel, questionTitle, questionRows } = this.opts;
+        questionPanel.visible = true;
+        const baseTitle = question.header
+            ? `${question.header}: ${question.question}`
+            : question.question;
+        const positionPrefix = this.pendingQuestions.length > 1
+            ? `(${this.activeIndex + 1}/${this.pendingQuestions.length}) `
+            : "";
+        const navHint = this.pendingQuestions.length > 1 ? " [←/→ navigate]" : "";
+        questionTitle.content = `${positionPrefix}${baseTitle}${navHint}`;
+        const optionLimit = question.multiSelect ? QUESTION_OPTION_LIMIT - 1 : QUESTION_OPTION_LIMIT;
+        const visibleOptions = question.options.slice(0, optionLimit);
+        const doneIndex = this.activeQuestionDoneIndex();
+        for (const [index, row] of questionRows.entries()) {
+            if (index < visibleOptions.length) {
+                const option = visibleOptions[index];
+                const highlighted = index === this.optionSelectedIndex;
+                const checkbox = question.multiSelect
+                    ? this.multiSelectChecked.has(index)
+                        ? "[x] "
+                        : "[ ] "
+                    : "";
+                const labelColor = highlighted ? COLORS.status : COLORS.user;
+                const description = formatQuestionOptionDescription(option.description);
+                const labelLine = `${checkbox}${option.label}`;
+                row.content = description
+                    ? t `${fg(labelColor)(labelLine)}\n${description}`
+                    : t `${fg(labelColor)(labelLine)}`;
+                row.fg = highlighted ? COLORS.agent : COLORS.hint;
+                row.visible = true;
+                continue;
+            }
+            if (question.multiSelect && index === visibleOptions.length) {
+                // Synthetic Done row carries no checkbox prefix and self-documents
+                // its purpose so users discover how to advance from a multi-select.
+                const highlighted = doneIndex === this.optionSelectedIndex;
+                const labelColor = highlighted ? COLORS.status : COLORS.user;
+                const description = formatQuestionOptionDescription("Advance to next question");
+                row.content = t `${fg(labelColor)("Done")}\n${description}`;
+                row.fg = highlighted ? COLORS.agent : COLORS.hint;
+                row.visible = true;
+                continue;
+            }
+            row.visible = false;
+            row.content = "";
+        }
+    }
+    moveActiveHighlight(direction) {
+        const question = this.activeQuestion();
+        if (!question)
+            return;
+        this.optionSelectedIndex = moveQuestionHighlight(this.optionSelectedIndex, this.activeRowCount(), direction);
+        // Single-select live-records the highlight as the answer so a
+        // prompt-flush or arrow-nav captures it without requiring Space/Enter.
+        // Multi-select keeps highlight separate from the toggled set.
+        if (!question.multiSelect) {
+            this.accumulatedAnswers = commitActiveAnswer(question, this.optionSelectedIndex, this.multiSelectChecked, this.accumulatedAnswers);
+        }
+        this.render();
+    }
+    toggleActiveMultiSelectOption() {
+        const question = this.activeQuestion();
+        if (!question?.multiSelect)
+            return;
+        if (this.multiSelectChecked.has(this.optionSelectedIndex)) {
+            this.multiSelectChecked.delete(this.optionSelectedIndex);
+        }
+        else {
+            this.multiSelectChecked.add(this.optionSelectedIndex);
+        }
+        this.accumulatedAnswers = commitActiveAnswer(question, this.optionSelectedIndex, this.multiSelectChecked, this.accumulatedAnswers);
+        this.render();
+    }
+    navigateActive(direction) {
+        if (this.pendingQuestions.length <= 1)
+            return false;
+        const nextIndex = this.activeIndex + direction;
+        if (nextIndex < 0 || nextIndex >= this.pendingQuestions.length)
+            return false;
+        this.accumulatedAnswers = commitActiveAnswer(this.activeQuestion(), this.optionSelectedIndex, this.multiSelectChecked, this.accumulatedAnswers);
+        this.activeIndex = nextIndex;
+        const restored = restoreSavedAnswer(this.activeQuestion(), this.accumulatedAnswers);
+        this.optionSelectedIndex = restored.selectedIndex;
+        this.multiSelectChecked = restored.checked;
+        this.render();
+        return true;
+    }
+    describeAnswerLabels(question, labels) {
+        if (labels.length === 0)
+            return question.multiSelect ? "(no selection)" : "";
+        return labels.join(", ");
+    }
+    advanceOrSubmit() {
+        const question = this.activeQuestion();
+        if (!question)
+            return false;
+        const accumulatedForActive = this.accumulatedAnswers[question.question] ?? [];
+        const transcriptText = this.describeAnswerLabels(question, accumulatedForActive);
+        if (transcriptText) {
+            this.opts.recordTranscriptEntry("user", transcriptText);
+            this.opts.appendBlock("you:", transcriptText, COLORS.user);
+        }
+        if (this.activeIndex < this.pendingQuestions.length - 1) {
+            this.activeIndex += 1;
+            const restored = restoreSavedAnswer(this.activeQuestion(), this.accumulatedAnswers);
+            this.optionSelectedIndex = restored.selectedIndex;
+            this.multiSelectChecked = restored.checked;
+            this.render();
+            return true;
+        }
+        void this.opts.session
+            .answer({
+            questions: this.pendingQuestions,
+            answers: this.accumulatedAnswers,
+            behavior: "follow_up",
+        })
+            .catch(this.opts.reportError);
+        this.hide();
+        this.opts.markRunning();
+        return true;
+    }
+}
+//# sourceMappingURL=question-picker.js.map

package/dist/src/tui/question-picker.js.map

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

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

@@ -0,0 +1,20 @@
+import { type CliRenderer } from "@opentui/core";
+/**
+ * useMouse: true so the scroll wheel reaches the transcript and OpenTUI
+ * receives drag events for in-app text selection. Bare Ctrl+C is the
+ * always-exit keystroke (via exitOnCtrlC) so the convention every other
+ * interactive Linux/Windows terminal app follows still works here.
+ *
+ * Tests inject a `createTestRenderer` instance via `input.renderer`; in
+ * that mode we skip the production renderer construction and the
+ * `globalThis.window` restore that wraps it (the test renderer never
+ * installs the shim).
+ */
+export declare function acquireRenderer(injected?: CliRenderer): Promise<CliRenderer>;
+/**
+ * Resolves when the renderer emits its `destroy` event, running the supplied
+ * teardown hook synchronously inside the event listener so chrome writers can
+ * flip into a stopped state before the rest of `runTui` returns.
+ */
+export declare function waitForRendererDestroy(renderer: CliRenderer, onDestroy: () => void): Promise<void>;
+//# sourceMappingURL=renderer-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/tui/renderer-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAqB,MAAM,eAAe,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAWlF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,IAAI,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf"}

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

@@ -0,0 +1,50 @@
+import { createCliRenderer } from "@opentui/core";
+/**
+ * useMouse: true so the scroll wheel reaches the transcript and OpenTUI
+ * receives drag events for in-app text selection. Bare Ctrl+C is the
+ * always-exit keystroke (via exitOnCtrlC) so the convention every other
+ * interactive Linux/Windows terminal app follows still works here.
+ *
+ * Tests inject a `createTestRenderer` instance via `input.renderer`; in
+ * that mode we skip the production renderer construction and the
+ * `globalThis.window` restore that wraps it (the test renderer never
+ * installs the shim).
+ */
+export async function acquireRenderer(injected) {
+    if (injected)
+        return injected;
+    const previousWindow = Object.getOwnPropertyDescriptor(globalThis, "window");
+    const renderer = await createCliRenderer({
+        exitOnCtrlC: true,
+        useMouse: true,
+        useKittyKeyboard: {},
+        targetFps: 60,
+    });
+    restoreWindowGlobal(previousWindow);
+    return renderer;
+}
+/**
+ * Resolves when the renderer emits its `destroy` event, running the supplied
+ * teardown hook synchronously inside the event listener so chrome writers can
+ * flip into a stopped state before the rest of `runTui` returns.
+ */
+export function waitForRendererDestroy(renderer, onDestroy) {
+    return new Promise((resolve) => {
+        renderer.once("destroy", () => {
+            onDestroy();
+            resolve();
+        });
+    });
+}
+function restoreWindowGlobal(previousWindow) {
+    // OpenTUI installs `window.requestAnimationFrame` for browser-style
+    // animation compatibility. In Bun, the presence of `window` can send fetch
+    // internals down browser-only paths, while `global.requestAnimationFrame`
+    // remains enough for OpenTUI after initialization.
+    if (previousWindow) {
+        Object.defineProperty(globalThis, "window", previousWindow);
+        return;
+    }
+    delete globalThis.window;
+}
+//# sourceMappingURL=renderer-lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-lifecycle.js","sourceRoot":"","sources":["../../../src/tui/renderer-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAsB;IAC1D,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,cAAc,GAAG,MAAM,CAAC,wBAAwB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC;QACvC,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,IAAI;QACd,gBAAgB,EAAE,EAAE;QACpB,SAAS,EAAE,EAAE;KACd,CAAC,CAAC;IACH,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAAqB,EACrB,SAAqB;IAErB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC5B,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,cAA8C;IACzE,oEAAoE;IACpE,2EAA2E;IAC3E,0EAA0E;IAC1E,mDAAmD;IACnD,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IACD,OAAQ,UAAuD,CAAC,MAAM,CAAC;AACzE,CAAC"}

package/dist/src/tui/session-subscription.d.ts

@@ -0,0 +1,30 @@
+import type { Session } from "../session/session.js";
+import type { QuestionPicker } from "./question-picker.js";
+import type { Sidebar } from "./sidebar.js";
+import type { StatusController } from "./status-controller.js";
+import type { StepRenderer } from "./step-renderer.js";
+export interface SessionSubscriptionDeps {
+    session: Session;
+    sidebar: Sidebar;
+    stepRenderer: StepRenderer;
+    statusController: StatusController;
+    questionPicker: QuestionPicker;
+    appendLine(content: string, fg: string): void;
+    appendBlock(label: string | null, body: string, fg: string): void;
+}
+/**
+ * Re-paints the sidebar from the session's current state snapshot. Used both
+ * inside the event subscription and after the initial boot screen renders.
+ */
+export declare function refreshSidebarFromSession(deps: {
+    session: Session;
+    sidebar: Sidebar;
+}): void;
+/**
+ * Subscribes the chrome (transcript, sidebar, status, question picker) to the
+ * session's event stream and returns the unsubscribe handle. Every event the
+ * runner emits funnels through this one router so the visual layer stays a
+ * thin projection of the session state.
+ */
+export declare function bindSessionToUi(deps: SessionSubscriptionDeps): () => void;
+//# sourceMappingURL=session-subscription.d.ts.map

package/dist/src/tui/session-subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-subscription.d.ts","sourceRoot":"","sources":["../../../src/tui/session-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACnE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAkB5F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAgDzE"}

package/dist/src/tui/session-subscription.js

@@ -0,0 +1,78 @@
+import { COLORS } from "./theme.js";
+/**
+ * Re-paints the sidebar from the session's current state snapshot. Used both
+ * inside the event subscription and after the initial boot screen renders.
+ */
+export function refreshSidebarFromSession(deps) {
+    const { session, sidebar } = deps;
+    const state = session.getState();
+    sidebar.setTodos(state?.todos ?? []);
+    sidebar.setFollowUpQueue(state?.followUpQueue ?? []);
+    sidebar.setStateMachine(state?.stateMachine);
+    const snap = session.getLastUsage();
+    sidebar.setUsage(snap
+        ? {
+            type: "usage",
+            usage: snap.usage,
+            effectiveContextWindow: snap.effectiveContextWindow,
+            contextWindowUsage: snap.contextWindowUsage,
+        }
+        : undefined);
+    sidebar.setSessionCost(session.getSessionCostUsd());
+}
+/**
+ * Subscribes the chrome (transcript, sidebar, status, question picker) to the
+ * session's event stream and returns the unsubscribe handle. Every event the
+ * runner emits funnels through this one router so the visual layer stays a
+ * thin projection of the session state.
+ */
+export function bindSessionToUi(deps) {
+    const { session, sidebar, stepRenderer, statusController, questionPicker, appendLine, appendBlock, } = deps;
+    const refreshSidebar = () => refreshSidebarFromSession({ session, sidebar });
+    return session.subscribe((event) => {
+        refreshSidebar();
+        if (event.type === "step") {
+            stepRenderer.renderStep(event.step);
+        }
+        else if (event.type === "follow_up_queue") {
+            // Mirror the count into the working-status line so the user can see
+            // queued prompts at a glance without scrolling the sidebar.
+            statusController.setQueuedFollowUps(event.prompts.length);
+        }
+        else if (event.type === "memory") {
+            stepRenderer.renderMemoryStatus(event);
+        }
+        else if (event.type === "system") {
+            appendBlock("[system]", event.message, COLORS.system);
+            if (event.level === "error")
+                statusController.markIdle();
+        }
+        else if (event.type === "ask") {
+            appendBlock("[question]", event.questions.map((q) => q.question).join("\n"), COLORS.system);
+            questionPicker.show(event.questions);
+            stepRenderer.renderUsage(event.usage);
+            stepRenderer.renderTurnElapsed();
+            statusController.markIdle(event);
+        }
+        else if (event.type === "complete") {
+            if (event.error) {
+                appendBlock("[error]", event.error, COLORS.error);
+            }
+            stepRenderer.renderUsage(event.usage);
+            stepRenderer.renderTurnElapsed();
+            statusController.markIdle(event);
+        }
+        else if (event.type === "interrupted") {
+            appendLine("[interrupted]", COLORS.system);
+            stepRenderer.renderUsage(event.usage);
+            stepRenderer.renderTurnElapsed();
+            statusController.markIdle(event);
+        }
+        else if (event.type === "sleep") {
+            stepRenderer.renderUsage(event.usage);
+            stepRenderer.renderSleeping(event.wakeAt);
+            statusController.markIdle(event);
+        }
+    });
+}
+//# sourceMappingURL=session-subscription.js.map

package/dist/src/tui/session-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-subscription.js","sourceRoot":"","sources":["../../../src/tui/session-subscription.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAYpC;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAA4C;IACpF,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IACpC,OAAO,CAAC,QAAQ,CACd,IAAI;QACF,CAAC,CAAC;YACE,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;SAC5C;QACH,CAAC,CAAC,SAAS,CACd,CAAC;IACF,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAA6B;IAC3D,MAAM,EACJ,OAAO,EACP,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,WAAW,GACZ,GAAG,IAAI,CAAC;IACT,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,yBAAyB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7E,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,KAAgB,EAAE,EAAE;QAC5C,cAAc,EAAE,CAAC;QACjB,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC5C,oEAAoE;YACpE,4DAA4D;YAC5D,gBAAgB,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,YAAY,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,WAAW,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO;gBAAE,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAC3D,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAChC,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5F,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACrC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtC,YAAY,CAAC,iBAAiB,EAAE,CAAC;YACjC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACpD,CAAC;YACD,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtC,YAAY,CAAC,iBAAiB,EAAE,CAAC;YACjC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACxC,UAAU,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3C,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtC,YAAY,CAAC,iBAAiB,EAAE,CAAC;YACjC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAClC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACtC,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC1C,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

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