@indianic/dialout 1.8.0 → 1.9.0

package/node_modules/@indianic/dialout-shared/dist/pane-prompt.d.ts

@@ -0,0 +1,46 @@
+export interface PanePromptOption {
+    /** 1-based position in the menu. */
+    n: number;
+    label: string;
+    /** Indented line(s) under the option: its explanation. */
+    hint?: string;
+    /** The row the cursor is on. */
+    selected: boolean;
+    /** Multi-select rows: ticked or not. null for an ordinary row. */
+    checked: boolean | null;
+}
+export interface PanePrompt {
+    /** Changes when the question or its choices change (not when the cursor moves). */
+    id: string;
+    /** Context above the question: "Bash command", the command itself, a file name. */
+    detail: string[];
+    question: string;
+    options: PanePromptOption[];
+    /** Some rows are checkboxes: a tap toggles rather than answers. */
+    multi: boolean;
+    /** The menu's own key hint, shown small under the choices. */
+    footer: string;
+    /** Approval-shaped (run/edit/trust) rather than a question to answer. */
+    approval: boolean;
+}
+/**
+ * The prompt on screen, or null. Looks only at the bottom of the pane (a
+ * prompt is always the last thing drawn) and demands a cursor-marked list:
+ * either numbered from 1 with the cursor on a row, or any list followed by a
+ * key-hint footer. A shell prompt ("❯ ") or a numbered list in the agent's
+ * reply has neither, which is what keeps false positives out.
+ */
+export declare function detectPanePrompt(pane: string): PanePrompt | null;
+/** Key names the agent may send to a pane, besides single characters. */
+export declare const PROMPT_KEYS: readonly ["Up", "Down", "Left", "Right", "Enter", "Escape", "Tab", "BTab", "Space", "BSpace", "C-c"];
+export type PromptKey = (typeof PROMPT_KEYS)[number];
+/** A key list is safe to hand to `tmux send-keys`: named keys or one printable character each. */
+export declare function isSafeKeyList(keys: unknown): keys is string[];
+/**
+ * Keys that choose option `n` (1-based): move the cursor from where it is to
+ * that row with arrows, then Enter. Arrows rather than the digit shortcut
+ * because every menu honours arrows, and only some honour digits. On a
+ * multi-select row Enter toggles it; the menu stays up and is re-read.
+ */
+export declare function promptKeys(p: PanePrompt, n: number): string[];
+//# sourceMappingURL=pane-prompt.d.ts.map

package/node_modules/@indianic/dialout-shared/dist/pane-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pane-prompt.d.ts","sourceRoot":"","sources":["../src/pane-prompt.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,EAAE,EAAE,MAAM,CAAC;IACX,mFAAmF;IACnF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,mEAAmE;IACnE,KAAK,EAAE,OAAO,CAAC;IACf,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAC;CACnB;AA6GD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAuChE;AAED,yEAAyE;AACzE,eAAO,MAAM,WAAW,sGAAuG,CAAC;AAChI,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAG7D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAK7D"}

package/node_modules/@indianic/dialout-shared/dist/pane-prompt.js

@@ -0,0 +1,227 @@
+"use strict";
+// A coding agent waiting on the user, read from what its TUI is showing.
+//
+// Permission prompts, plan approvals, trust prompts and question menus are
+// drawn in the terminal and most never reach the transcript, so a chat built
+// from the transcript alone looks stuck while the agent is asking something.
+// The agent captures the pane and runs it through detectPanePrompt; clients
+// render the result as tappable choices and answer with promptKeys.
+//
+// One parser for every CLI on purpose: Claude Code, Codex and Grok all draw
+// the same shape — a question, then a list with a cursor on one row
+// (❯ / › / >), usually numbered, then a footer like "Enter to confirm · Esc to
+// cancel". Recognising the shape rather than each vendor's wording is what
+// keeps this working across their releases.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMPT_KEYS = void 0;
+exports.detectPanePrompt = detectPanePrompt;
+exports.isSafeKeyList = isSafeKeyList;
+exports.promptKeys = promptKeys;
+// Box-drawing borders some CLIs draw around a prompt: stripped before parsing,
+// keeping the indentation inside the box (it tells options from their hints).
+const BORDER_LEFT = /^\s*[│┃║] ?/u;
+const BORDER_RIGHT = /\s*[│┃║]\s*$/u;
+/** Lines under a prompt that may still belong to the TUI (status lines). */
+const TRAILING = 14;
+const SEPARATOR = /^[\s─━═╌┄┈\-_╭╮╰╯┌┐└┘╔╗╚╝]{4,}$/u;
+const FOOTER = /(enter to (confirm|select|submit)|esc to (cancel|exit|interrupt)|to navigate|press enter|↑\/↓|tab\/arrow|y\/n)/i;
+const CHECK_ON = /^\[(x|✔|✓|■|●)\]|^[◉☑✔✓■]/iu;
+const CHECK_OFF = /^\[ \]|^[◯○☐□]/u;
+const APPROVAL = /\b(proceed|allow|approve|permission|trust|run|execute|edit|create|delete|make this edit|overwrite|apply)\b/i;
+// "❯ 1. Yes"  "  2. No (esc)"  "› 1. Yes, proceed (y)"
+const NUMBERED = /^(\s*)([❯›>▶→➜●])?\s*(\d{1,2})[.)]\s+(.+?)\s*$/u;
+// "❯ Yes, I trust this folder"  /  "  No, exit" — unnumbered rows
+const BARE = /^(\s*)(?:([❯›>▶→➜●])\s+)?(\S.*?)\s*$/u;
+function clean(line) {
+    return line.replace(BORDER_LEFT, '').replace(BORDER_RIGHT, '').replace(/\s+$/, '');
+}
+function hash(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(36);
+}
+function checkState(label) {
+    if (CHECK_ON.test(label))
+        return { label: label.replace(CHECK_ON, '').trim(), checked: true };
+    if (CHECK_OFF.test(label))
+        return { label: label.replace(CHECK_OFF, '').trim(), checked: false };
+    return { label, checked: null };
+}
+/** Pull the question and its context from the lines above the menu. */
+function above(lines, end) {
+    const block = [];
+    for (let i = end - 1; i >= 0 && block.length < 8; i--) {
+        const l = lines[i].trim();
+        if (SEPARATOR.test(l))
+            break;
+        if (!l) {
+            if (block.length) {
+                const prev = lines[i - 1]?.trim();
+                if (!prev || SEPARATOR.test(prev))
+                    break;
+            }
+            continue;
+        }
+        // A tab strip like "☐ Colour  ☐ Pet  ✔ Submit" is navigation, not content.
+        if (/[☐☒✔✓].*\s{2,}[☐☒✔✓]/u.test(l))
+            continue;
+        block.unshift(l);
+    }
+    if (!block.length)
+        return { question: '', detail: [] };
+    let qi = -1;
+    for (let i = block.length - 1; i >= 0; i--)
+        if (/\?\s*$/.test(block[i])) {
+            qi = i;
+            break;
+        }
+    if (qi < 0)
+        qi = block.length - 1;
+    return { question: block[qi], detail: block.filter((_, i) => i !== qi) };
+}
+/** "❯ 1. Yes / 2. No" with indented hints under rows, scanning up from `bottom`. */
+function numberedMenu(lines, bottom) {
+    const opts = [];
+    let hints = [];
+    let start = -1;
+    let labelCol = 4;
+    let separators = 0;
+    for (let i = bottom; i >= 0; i--) {
+        const raw = lines[i];
+        if (!raw.trim()) {
+            if (opts.length || hints.length)
+                break;
+            continue;
+        }
+        if (SEPARATOR.test(raw.trim())) {
+            if (++separators > 2)
+                break;
+            continue;
+        }
+        const m = raw.match(NUMBERED);
+        if (m) {
+            const ck = checkState(m[4]);
+            opts.unshift({ n: Number(m[3]), label: ck.label, hint: hints.length ? hints.join(' ') : undefined, selected: !!m[2], checked: ck.checked });
+            hints = [];
+            labelCol = raw.indexOf(m[4]);
+            start = i;
+            continue;
+        }
+        // Deeper than an option's label: that option's explanation (it sits
+        // below its option, so it is seen first when scanning upwards).
+        if (raw.search(/\S/) >= Math.max(4, labelCol) && hints.length < 3) {
+            hints.unshift(raw.trim());
+            continue;
+        }
+        break;
+    }
+    if (opts.length < 2)
+        return null;
+    // Must count 1, 2, 3… — a numbered list in prose is not a menu.
+    if (opts[0].n !== 1 || opts.some((o, i) => o.n !== i + 1))
+        return null;
+    return { opts, start };
+}
+/** Unnumbered rows with one cursor, only trusted when a key-hint footer is under them. */
+function bareMenu(lines, bottom) {
+    const opts = [];
+    let start = -1;
+    let indent = -1;
+    for (let i = bottom; i >= 0 && opts.length < 9; i--) {
+        const raw = lines[i];
+        if (!raw.trim()) {
+            if (opts.length)
+                break;
+            continue;
+        }
+        const b = raw.match(BARE);
+        // The question above the rows ends in "?" or ":"; it is not a row.
+        if (!b || (!b[2] && /[?:]\s*$/.test(b[3])))
+            break;
+        const col = raw.indexOf(b[3]);
+        if (indent >= 0 && Math.abs(col - indent) > 1)
+            break;
+        indent = col;
+        const ck = checkState(b[3]);
+        opts.unshift({ n: 0, label: ck.label, selected: !!b[2], checked: ck.checked });
+        start = i;
+    }
+    if (opts.length < 2 || opts.filter((o) => o.selected).length !== 1)
+        return null;
+    opts.forEach((o, i) => { o.n = i + 1; });
+    return { opts, start };
+}
+/**
+ * The prompt on screen, or null. Looks only at the bottom of the pane (a
+ * prompt is always the last thing drawn) and demands a cursor-marked list:
+ * either numbered from 1 with the cursor on a row, or any list followed by a
+ * key-hint footer. A shell prompt ("❯ ") or a numbered list in the agent's
+ * reply has neither, which is what keeps false positives out.
+ */
+function detectPanePrompt(pane) {
+    const all = pane.replace(/\r/g, '').split('\n').map(clean);
+    while (all.length && !all[all.length - 1].trim())
+        all.pop();
+    const lines = all.slice(-45);
+    if (lines.length < 2)
+        return null;
+    const footerAt = (() => {
+        // Status lines can sit under a prompt (Claude Code's statusline is
+        // user-configured and may be several lines), so look a little way up.
+        for (let i = lines.length - 1; i >= Math.max(0, lines.length - TRAILING); i--)
+            if (FOOTER.test(lines[i]))
+                return i;
+        return -1;
+    })();
+    let menu = null;
+    if (footerAt >= 0)
+        menu = numberedMenu(lines, footerAt - 1) || bareMenu(lines, footerAt - 1);
+    else {
+        // No footer: the menu may still have status lines under it.
+        for (let b = lines.length - 1; b >= Math.max(0, lines.length - TRAILING) && !menu; b--) {
+            const m = numberedMenu(lines, b);
+            if (m && m.opts.some((o) => o.selected))
+                menu = m;
+        }
+    }
+    if (!menu)
+        return null;
+    const { opts, start } = menu;
+    if (!opts.some((o) => o.selected) && footerAt < 0)
+        return null;
+    const { question, detail } = above(lines, start);
+    const footer = footerAt >= 0 ? lines[footerAt].trim() : '';
+    const multi = opts.some((o) => o.checked !== null);
+    const text = [question, ...detail, ...opts.map((o) => `${o.n}${o.label}${o.checked}`), footer].join('\n');
+    return {
+        id: hash(text),
+        detail,
+        question: question || 'The agent is waiting for you',
+        options: opts,
+        multi,
+        footer,
+        approval: APPROVAL.test([question, ...detail].join(' ')) && !/type something/i.test(opts.map((o) => o.label).join(' ')),
+    };
+}
+/** Key names the agent may send to a pane, besides single characters. */
+exports.PROMPT_KEYS = ['Up', 'Down', 'Left', 'Right', 'Enter', 'Escape', 'Tab', 'BTab', 'Space', 'BSpace', 'C-c'];
+/** A key list is safe to hand to `tmux send-keys`: named keys or one printable character each. */
+function isSafeKeyList(keys) {
+    return Array.isArray(keys) && keys.length > 0 && keys.length <= 40
+        && keys.every((k) => typeof k === 'string' && (exports.PROMPT_KEYS.includes(k) || /^[A-Za-z0-9]$/.test(k)));
+}
+/**
+ * Keys that choose option `n` (1-based): move the cursor from where it is to
+ * that row with arrows, then Enter. Arrows rather than the digit shortcut
+ * because every menu honours arrows, and only some honour digits. On a
+ * multi-select row Enter toggles it; the menu stays up and is re-read.
+ */
+function promptKeys(p, n) {
+    const from = Math.max(0, p.options.findIndex((o) => o.selected));
+    const to = Math.max(0, Math.min(p.options.length - 1, n - 1));
+    const move = to > from ? Array(to - from).fill('Down') : Array(from - to).fill('Up');
+    return [...move, 'Enter'];
+}

package/node_modules/@indianic/dialout-shared/dist/session.d.ts

@@ -1,6 +1,7 @@
 import type { AiKind } from './kinds';
 import type { AiStatus } from './events';
 import type { PermissionMode } from './permission';
+import type { PanePrompt } from './pane-prompt';
 export interface AiSessionSummary {
     tmuxName: string;
     kind: AiKind;
@@ -22,6 +23,12 @@ export interface AiSessionSummary {
      */
     startedAt: number;
     transcript: string;
+    /**
+     * A menu the agent's TUI is showing (permission, plan approval, question),
+     * read from the pane — the transcript never records most of these. Absent
+     * from agents before 1.9.
+     */
+    prompt?: PanePrompt | null;
 }
 export declare const REPLAY_LIMIT = 200;
 //# sourceMappingURL=session.d.ts.map

package/node_modules/@indianic/dialout-shared/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,CAAC;IAEjB,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAGlB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,eAAO,MAAM,YAAY,MAAM,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,CAAC;IAEjB,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAGlB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5B;AAID,eAAO,MAAM,YAAY,MAAM,CAAC"}

package/node_modules/@indianic/dialout-shared/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indianic/dialout-shared",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Types and constants shared by the Dialout server, agent and mobile app.",
   "publishConfig": {
     "registry": "https://registry.npmjs.org"

package/node_modules/@indianic/dialout-shared/src/.omc/state/sessions/ebad4a54-74e6-4430-8f1c-4e4268aa5d4d/pre-tool-advisory-throttle.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "entries": {
+    "79a93d4a2f8f50b95f852280616242fee1855dc99a3c75211917f55e72e95fae": {
+      "last_emitted_at_ms": 1792572432915,
+      "message": "Use parallel execution for independent tasks. Use run_in_background for long operations (npm install, builds, tests)."
+    }
+  },
+  "updated_at": "2026-10-21T08:47:12.915Z"
+}

package/node_modules/@indianic/dialout-shared/src/event-merge.ts

@@ -1,3 +1,4 @@
+import type { PanePrompt } from './pane-prompt';
 import type { AiEvent } from './events';
 
 // How a client folds ai_session_events messages into its transcript.
@@ -37,6 +38,12 @@ export interface EventsMeta {
   sessionKey?: string;
   /** Who/where, sent with a replay so a captured log can be labelled. */
   session?: { kind: string; folder: string; gitBranch: string; title: string };
+  /**
+   * What the agent's TUI is asking right now, read from its pane (see
+   * pane-prompt.ts). null = nothing asked any more; absent = not reported
+   * (agents before 1.9, or a message that is only about events).
+   */
+  prompt?: PanePrompt | null;
 }
 
 export const EMPTY_TRANSCRIPT: TranscriptState = { events: [], firstSeq: null, earlier: 0 };

package/node_modules/@indianic/dialout-shared/src/index.ts

@@ -12,7 +12,7 @@ export { REPLAY_LIMIT } from './session';
 
 export type { CommandSource, AiCommand, McpServerInfo, AiCapabilities } from './capabilities';
 
-export { NOTIFY_COOLDOWN_MS, shouldNotifyAi } from './notify';
+export { NOTIFY_COOLDOWN_MS, shouldNotifyAi, shouldNotifyPrompt } from './notify';
 
 export type { ToolItem, ChatBlock } from './chat-blocks';
 export { groupEvents, toolGroupStartsOpen } from './chat-blocks';
@@ -40,3 +40,6 @@ export {
 
 export type { TranscriptState, EventsMeta } from './event-merge';
 export { EMPTY_TRANSCRIPT, mergeEvents } from './event-merge';
+
+export type { PanePrompt, PanePromptOption, PromptKey } from './pane-prompt';
+export { PROMPT_KEYS, detectPanePrompt, isSafeKeyList, promptKeys } from './pane-prompt';

package/node_modules/@indianic/dialout-shared/src/notify.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { shouldNotifyAi } from './notify';
+import { NOTIFY_COOLDOWN_MS, shouldNotifyAi, shouldNotifyPrompt } from './notify';
 
 // This is the logic most capable of annoying someone into turning
 // notifications off, so every rule gets a case.
@@ -47,3 +47,14 @@ describe('shouldNotifyAi', () => {
     expect(shouldNotifyAi('working', 'waiting_input', NOW - 200_000, NOW)).toBe(true);
   });
 });
+
+describe('shouldNotifyPrompt', () => {
+  it('fires for a new question, not on first sight, not twice, not inside the cooldown', () => {
+    expect(shouldNotifyPrompt(undefined, 'a', undefined, 1000)).toBe(false);
+    expect(shouldNotifyPrompt(null, 'a', undefined, 1000)).toBe(true);
+    expect(shouldNotifyPrompt('a', 'a', undefined, 1000)).toBe(false);
+    expect(shouldNotifyPrompt('a', null, undefined, 1000)).toBe(false);
+    expect(shouldNotifyPrompt('a', 'b', 1000, 1000 + NOTIFY_COOLDOWN_MS - 1)).toBe(false);
+    expect(shouldNotifyPrompt('a', 'b', 1000, 1000 + NOTIFY_COOLDOWN_MS)).toBe(true);
+  });
+});

package/node_modules/@indianic/dialout-shared/src/notify.ts

@@ -28,3 +28,21 @@ export function shouldNotifyAi(
   if (lastNotifiedAt && nowMs - lastNotifiedAt < NOTIFY_COOLDOWN_MS) return false;
   return true;
 }
+
+/**
+ * A new question on an agent's screen (a pane prompt id not seen before) is
+ * always news, whatever the status said: a session nobody has open reports
+ * 'idle' until asked, so the working → waiting rule above never sees it.
+ * Still not on first sight (reconnect bursts) and still rate-limited.
+ */
+export function shouldNotifyPrompt(
+  previousPromptId: string | null | undefined,
+  nextPromptId: string | null | undefined,
+  lastNotifiedAt: number | undefined,
+  nowMs: number,
+): boolean {
+  if (previousPromptId === undefined) return false;
+  if (!nextPromptId || nextPromptId === previousPromptId) return false;
+  if (lastNotifiedAt && nowMs - lastNotifiedAt < NOTIFY_COOLDOWN_MS) return false;
+  return true;
+}

package/node_modules/@indianic/dialout-shared/src/pane-prompt.test.ts

@@ -0,0 +1,179 @@
+import { describe, expect, it } from 'vitest';
+import { detectPanePrompt, isSafeKeyList, promptKeys } from './pane-prompt';
+
+// Shapes as the CLIs draw them (spacing kept), plus the noise around them.
+const CLAUDE_BASH = `
+⏺ I'll run the tests.
+
+╭──────────────────────────────────────────────────────────────╮
+│ Bash command                                                 │
+│                                                              │
+│   npm test                                                   │
+│   Run the test suite                                         │
+│                                                              │
+│ Do you want to proceed?                                      │
+│ ❯ 1. Yes                                                     │
+│   2. Yes, and don't ask again for npm test commands in /app  │
+│   3. No, and tell Claude what to do differently (esc)        │
+╰──────────────────────────────────────────────────────────────╯
+`;
+
+const CLAUDE_QUESTION = `
+⏺ Let me ask a couple of things first.
+
+────────────────────────────────────────────────────────────────
+ ☐ Colour  ☐ Pet  ✔ Submit  →
+
+Which colour do you prefer?
+
+❯ 1. Red
+     Warm and loud
+  2. Green
+     Calm
+  3. Type something.
+────────────────────────────────────────────────────────────────
+  4. Chat about this
+
+Enter to select · Tab/Arrow keys to navigate · Esc to cancel
+`;
+
+const CLAUDE_TRUST = `
+ Accessing workspace:
+
+ /Users/me/code/app
+
+ Quick safety check: Is this a project you created or one you trust?
+
+ ❯ No, exit
+   Yes, I trust this folder
+
+ Enter to confirm · Esc to cancel
+`;
+
+const CODEX_APPROVAL = `
+• Running tests
+
+  Would you like to run the following command?
+
+  $ npm test
+
+› 1. Yes, proceed (y)
+  2. Yes, and don't ask again for this command (a)
+  3. No, and tell Codex what to do differently (esc)
+
+  Press enter to confirm or esc to cancel
+`;
+
+const MULTI = `
+Which features should I add?
+
+❯ 1. [ ] Dark mode
+  2. [✔] Search
+  3. [ ] Export
+  4. Submit
+
+Enter to select · ↑/↓ to navigate · Esc to cancel
+`;
+
+const IDLE_CLAUDE = `
+⏺ Done. Here is what changed:
+
+  1. Fixed the parser
+  2. Added tests
+  3. Updated docs
+
+────────────────────────────────────────────────────────────────
+❯ 
+────────────────────────────────────────────────────────────────
+  ⏵⏵ auto mode on (shift+tab to cycle)
+`;
+
+const SHELL = `
+~/code/app main
+❯ ls
+README.md  package.json  src
+~/code/app main
+❯ 
+`;
+
+describe('detectPanePrompt', () => {
+  it('reads a Claude permission prompt inside a box', () => {
+    const p = detectPanePrompt(CLAUDE_BASH)!;
+    expect(p.question).toBe('Do you want to proceed?');
+    expect(p.detail).toEqual(['Bash command', 'npm test', 'Run the test suite']);
+    expect(p.options.map((o) => o.label)).toEqual([
+      'Yes', "Yes, and don't ask again for npm test commands in /app", 'No, and tell Claude what to do differently (esc)',
+    ]);
+    expect(p.options[0].selected).toBe(true);
+    expect(p.approval).toBe(true);
+    expect(p.multi).toBe(false);
+  });
+
+  it('reads a question menu with hints, a separator and a footer', () => {
+    const p = detectPanePrompt(CLAUDE_QUESTION)!;
+    expect(p.question).toBe('Which colour do you prefer?');
+    expect(p.options.map((o) => o.label)).toEqual(['Red', 'Green', 'Type something.', 'Chat about this']);
+    expect(p.options[0].hint).toBe('Warm and loud');
+    expect(p.options[1].hint).toBe('Calm');
+    expect(p.footer).toMatch(/Enter to select/);
+    expect(p.approval).toBe(false);
+  });
+
+  it('reads an unnumbered menu when a footer vouches for it', () => {
+    const p = detectPanePrompt(CLAUDE_TRUST)!;
+    expect(p.options.map((o) => [o.n, o.label, o.selected])).toEqual([[1, 'No, exit', true], [2, 'Yes, I trust this folder', false]]);
+    expect(p.question).toMatch(/one you trust\?$/);
+  });
+
+  it('reads a Codex approval', () => {
+    const p = detectPanePrompt(CODEX_APPROVAL)!;
+    expect(p.question).toBe('Would you like to run the following command?');
+    expect(p.detail).toContain('$ npm test');
+    expect(p.options).toHaveLength(3);
+    expect(p.options[0].selected).toBe(true);
+  });
+
+  it('marks multi-select rows', () => {
+    const p = detectPanePrompt(MULTI)!;
+    expect(p.multi).toBe(true);
+    expect(p.options.map((o) => o.checked)).toEqual([false, true, false, null]);
+    expect(p.options[1].label).toBe('Search');
+  });
+
+  it('finds a prompt under several status lines', () => {
+    const status = '\n  [Opus 5.5] │ app │ main\n  Context ░░░░ 12%\n  Usage ok\n  ⏵⏵ auto mode on (shift+tab to cycle)\n';
+    const noFooter = CLAUDE_BASH.trimEnd() + status;
+    expect(detectPanePrompt(noFooter)?.question).toBe('Do you want to proceed?');
+    expect(detectPanePrompt(CLAUDE_TRUST.trimEnd() + status)?.options).toHaveLength(2);
+  });
+
+  it('ignores an idle agent, a numbered reply and a shell prompt', () => {
+    expect(detectPanePrompt(IDLE_CLAUDE)).toBeNull();
+    expect(detectPanePrompt(SHELL)).toBeNull();
+    expect(detectPanePrompt('')).toBeNull();
+  });
+
+  it('keeps its id while the cursor moves, changes it for a new question', () => {
+    const a = detectPanePrompt(CLAUDE_BASH)!;
+    expect(detectPanePrompt(CLAUDE_BASH.replace('❯ 1. Yes', '  1. Yes').replace('│   2. Yes,', '│ ❯ 2. Yes,'))!.id).toBe(a.id);
+    expect(detectPanePrompt(CLAUDE_BASH.replace('npm test  ', 'npm run x'))!.id).not.toBe(a.id);
+  });
+});
+
+describe('promptKeys', () => {
+  it('moves from the cursor to the target, then Enter', () => {
+    const p = detectPanePrompt(CLAUDE_BASH)!;
+    expect(promptKeys(p, 1)).toEqual(['Enter']);
+    expect(promptKeys(p, 3)).toEqual(['Down', 'Down', 'Enter']);
+    const moved = detectPanePrompt(CLAUDE_BASH.replace('❯ 1. Yes', '  1. Yes').replace('│   2. Yes,', '│ ❯ 2. Yes,'))!;
+    expect(promptKeys(moved, 1)).toEqual(['Up', 'Enter']);
+  });
+
+  it('only lets named keys and single characters through', () => {
+    expect(isSafeKeyList(['Down', 'Enter', 'y', '1'])).toBe(true);
+    expect(isSafeKeyList(['rm -rf /'])).toBe(false);
+    expect(isSafeKeyList([';', 'Enter'])).toBe(false);
+    expect(isSafeKeyList([])).toBe(false);
+    expect(isSafeKeyList('Enter')).toBe(false);
+  });
+});