@indianic/dialout 1.8.0 → 1.9.0

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

@@ -0,0 +1,218 @@
+// 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.
+
+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;
+}
+
+// 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: string): string {
+  return line.replace(BORDER_LEFT, '').replace(BORDER_RIGHT, '').replace(/\s+$/, '');
+}
+
+function hash(s: string): string {
+  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: string): { label: string; checked: boolean | null } {
+  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: string[], end: number): { question: string; detail: string[] } {
+  const block: string[] = [];
+  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) };
+}
+
+type Menu = { opts: PanePromptOption[]; start: number };
+
+/** "❯ 1. Yes / 2. No" with indented hints under rows, scanning up from `bottom`. */
+function numberedMenu(lines: string[], bottom: number): Menu | null {
+  const opts: PanePromptOption[] = [];
+  let hints: string[] = [];
+  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: string[], bottom: number): Menu | null {
+  const opts: PanePromptOption[] = [];
+  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.
+ */
+export function detectPanePrompt(pane: string): PanePrompt | null {
+  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: Menu | null = 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. */
+export const PROMPT_KEYS = ['Up', 'Down', 'Left', 'Right', 'Enter', 'Escape', 'Tab', 'BTab', 'Space', 'BSpace', 'C-c'] as const;
+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 function isSafeKeyList(keys: unknown): keys is string[] {
+  return Array.isArray(keys) && keys.length > 0 && keys.length <= 40
+    && keys.every((k) => typeof k === 'string' && ((PROMPT_KEYS as readonly string[]).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.
+ */
+export function promptKeys(p: PanePrompt, n: number): string[] {
+  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/src/session.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;
@@ -26,6 +27,12 @@ export interface AiSessionSummary {
   // Which file this row was built from, so opening the session resolves to
   // the same one rather than re-racing the other panes.
   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;
 }
 
 // Replay cap. Opening a month-old session must not flood the socket, and a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indianic/dialout",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Dialout agent — reach your office, home or build machine from any browser or phone. Remote tmux terminals, live port checks, filesystem browsing, process control and HTTP tunnels. The agent dials out: no inbound ports, no VPN, no port forwarding.",
   "bin": {
     "dialout": "./bin/devdash-agent.js"