aicodeman 1.14.2 → 1.16.0

package/dist/web/approval-inbox.d.ts

@@ -0,0 +1,159 @@
+/**
+ * @fileoverview Approvals Inbox: server-side registry of prompts waiting on a human.
+ *
+ * One cross-session queue of pending Claude prompts (permission dialogs,
+ * AskUserQuestion/elicitation questions, idle prompts), fed by `/api/hook-event`
+ * and answered via `POST /api/approvals/:id/answer`. Before this store existed,
+ * pending prompts lived only in `app.js` memory (SSE-transient, lost on reload)
+ * and the push notification Approve/Deny buttons had nothing to act on.
+ * Design: `docs/approvals-inbox-plan.md`.
+ *
+ * Invariants:
+ * - At most ONE active item per session: the Claude TUI shows one dialog at a
+ *   time, so a new prompt supersedes the session's previous item.
+ * - Module-level singleton in the style of `session-wait-registry.ts`: no
+ *   `Session` import, no IO; the server injects emit callbacks (`onPending`/
+ *   `onUpdated`/`onResolved`), which keeps this unit-testable and cycle-free.
+ * - Items are in-memory only. A server restart drops them; the next prompt
+ *   re-fires the hook. Claude-mode sessions only (hooks fire for nothing else).
+ * - Answer flow is take-then-write: `take()` removes the item BEFORE keystrokes
+ *   are sent so a double-tap cannot double-send; `restore()` re-inserts on a
+ *   failed write unless a newer prompt arrived meanwhile.
+ *
+ * @dependencies utils (stripAnsi)
+ * @consumedby web/routes/hook-event-routes (notePrompt/resolve), web/routes/approval-routes,
+ *   web/session-listener-wiring (working/exit resolution), web/server (emit callbacks + stop)
+ *
+ * @module web/approval-inbox
+ */
+export type ApprovalKind = 'permission' | 'question' | 'idle';
+export type ApprovalResolution = 'answered' | 'resolved_in_terminal' | 'superseded' | 'session_ended' | 'dismissed' | 'expired';
+/** A numbered choice parsed from the captured dialog frame. */
+export interface ApprovalOption {
+    n: number;
+    label: string;
+}
+export interface ApprovalItem {
+    /** `${sessionId}:${seq}`, stable across re-captures, unique per prompt. */
+    id: string;
+    sessionId: string;
+    sessionName: string;
+    kind: ApprovalKind;
+    createdAt: number;
+    /** Sanitized hook fields (already bounded by sanitizeHookData). */
+    toolName?: string;
+    toolSummary?: string;
+    message?: string;
+    cwd?: string;
+    /** ANSI-stripped tail of the visible pane frame at capture time. */
+    context?: string;
+    /**
+     * Present only when the frame parsed confidently. Gates which digits the
+     * answer endpoint accepts; absent → only approve('1')/deny(Esc) are allowed.
+     */
+    options?: ApprovalOption[];
+}
+export interface ApprovalResolvedInfo {
+    id: string;
+    sessionId: string;
+    kind: ApprovalKind;
+    resolution: ApprovalResolution;
+}
+interface NotePromptArgs {
+    sessionId: string;
+    sessionName: string;
+    kind: ApprovalKind;
+    toolName?: string;
+    toolSummary?: string;
+    message?: string;
+    cwd?: string;
+    /** Returns the raw (ANSI-bearing) pane frame, or null when unavailable. */
+    capture?: () => string | null;
+}
+/**
+ * Normalize a raw pane capture into card context: convert row repaints to
+ * lines, strip ANSI, right-trim lines, drop trailing blanks, keep the last
+ * MAX_CONTEXT_LINES lines.
+ */
+export declare function normalizeCapturedFrame(raw: string | null | undefined): string | undefined;
+/**
+ * Parse the numbered options of a Claude dialog out of a normalized frame.
+ *
+ * Matches the shapes Ink renders for permission prompts and AskUserQuestion:
+ *
+ *     ❯ 1. Yes                                 ❯ 1. Red
+ *       2. Yes, allow all edits (shift+tab)        Prefer red
+ *       3. No, tell Claude what to do (esc)      2. Blue
+ *                                                  Prefer blue
+ *
+ * Options must be consecutively numbered from 1 (2..6 of them); description /
+ * wrap / separator lines between options are tolerated up to a small gap
+ * (AskUserQuestion puts a description under every option and a ─ separator
+ * before its "Chat about this" entry, measured against the live dialog). The
+ * LAST complete block in the frame wins (dialogs render at the bottom).
+ * Returns undefined when nothing parses; callers then fall back to
+ * approve/deny only, so a mis-parse can never route a digit at a dialog that
+ * does not have it.
+ */
+export declare function parseDialogOptions(context: string | undefined): ApprovalOption[] | undefined;
+export declare class ApprovalInbox {
+    /** Keyed by sessionId; the one-active-item-per-session invariant lives here. */
+    private items;
+    private recaptureTimers;
+    /** Capture callbacks kept for answer-time re-verification; dropped on remove. */
+    private captures;
+    private seq;
+    private stopped;
+    /** Emit callbacks, injected by the server (SSE broadcast + push). */
+    onPending?: (item: ApprovalItem) => void;
+    onUpdated?: (item: ApprovalItem) => void;
+    onResolved?: (info: ApprovalResolvedInfo) => void;
+    /**
+     * Record a prompt for a session, superseding any previous item, and return
+     * the new item. Captures context immediately and once more after a short
+     * delay (see RECAPTURE_DELAY_MS).
+     */
+    notePrompt(args: NotePromptArgs): ApprovalItem;
+    /**
+     * Answer-time guard: re-capture the pane and check the dialog is still on
+     * screen before keystrokes are sent at it. Only conclusive when the ORIGINAL
+     * frame parsed options: if a fresh capture then parses none, the dialog is
+     * gone (answered in the terminal moments ago), so the item resolves and the
+     * answer must be refused, because the digit would land in whatever now has
+     * focus. Unparseable-from-the-start items stay answerable (approve/deny
+     * only), same risk the terminal user already carries.
+     */
+    verifyStillAnswerable(id: string): boolean;
+    /** Pending item for a session, TTL-checked. */
+    getForSession(sessionId: string): ApprovalItem | undefined;
+    /** Pending item by id, TTL-checked. */
+    getById(id: string): ApprovalItem | undefined;
+    /** All pending items, TTL-swept, oldest first. */
+    listPending(): ApprovalItem[];
+    /**
+     * Remove the item as `answered` and return it, or undefined if it is no
+     * longer pending. Callers send keystrokes AFTER a successful take, and
+     * `restore()` on a failed write.
+     */
+    take(id: string): ApprovalItem | undefined;
+    /** Re-insert a taken item after a failed write, unless superseded meanwhile. */
+    restore(item: ApprovalItem): void;
+    /** Remove an item without keystrokes (user chose Dismiss). */
+    dismiss(id: string): boolean;
+    /**
+     * Resolve a session's pending item, if any (stop hook, exit, ...). `kinds`
+     * restricts which item kinds the signal may clear: the heuristic `working`
+     * transition passes `['idle']` so a mid-turn flap cannot false-clear a
+     * pending permission/question dialog.
+     */
+    resolveForSession(sessionId: string, resolution: ApprovalResolution, kinds?: ApprovalKind[]): void;
+    /** Clear all timers (shutdown/tests). Items become inert; no events fire after this. */
+    stop(): void;
+    private applyCapture;
+    private remove;
+    private isExpired;
+}
+/** Process-wide singleton, mirroring `sessionWaits`. */
+export declare const approvalInbox: ApprovalInbox;
+export {};
+//# sourceMappingURL=approval-inbox.d.ts.map

package/dist/web/approval-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-inbox.d.ts","sourceRoot":"","sources":["../../src/web/approval-inbox.ts"],"names":[],"mappings":"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"}

package/dist/web/approval-inbox.js

@@ -0,0 +1,322 @@
+/**
+ * @fileoverview Approvals Inbox: server-side registry of prompts waiting on a human.
+ *
+ * One cross-session queue of pending Claude prompts (permission dialogs,
+ * AskUserQuestion/elicitation questions, idle prompts), fed by `/api/hook-event`
+ * and answered via `POST /api/approvals/:id/answer`. Before this store existed,
+ * pending prompts lived only in `app.js` memory (SSE-transient, lost on reload)
+ * and the push notification Approve/Deny buttons had nothing to act on.
+ * Design: `docs/approvals-inbox-plan.md`.
+ *
+ * Invariants:
+ * - At most ONE active item per session: the Claude TUI shows one dialog at a
+ *   time, so a new prompt supersedes the session's previous item.
+ * - Module-level singleton in the style of `session-wait-registry.ts`: no
+ *   `Session` import, no IO; the server injects emit callbacks (`onPending`/
+ *   `onUpdated`/`onResolved`), which keeps this unit-testable and cycle-free.
+ * - Items are in-memory only. A server restart drops them; the next prompt
+ *   re-fires the hook. Claude-mode sessions only (hooks fire for nothing else).
+ * - Answer flow is take-then-write: `take()` removes the item BEFORE keystrokes
+ *   are sent so a double-tap cannot double-send; `restore()` re-inserts on a
+ *   failed write unless a newer prompt arrived meanwhile.
+ *
+ * @dependencies utils (stripAnsi)
+ * @consumedby web/routes/hook-event-routes (notePrompt/resolve), web/routes/approval-routes,
+ *   web/session-listener-wiring (working/exit resolution), web/server (emit callbacks + stop)
+ *
+ * @module web/approval-inbox
+ */
+import { stripAnsi } from '../utils/index.js';
+// ─── Tunables ────────────────────────────────────────────────────────────────
+/** Items older than this are dropped on read: a 12h-old dialog is stale by any measure. */
+const ITEM_TTL_MS = 12 * 60 * 60 * 1000;
+/**
+ * The Notification hook can fire before Ink finishes painting the dialog, so a
+ * single delayed re-capture picks up the frame the immediate capture missed.
+ */
+const RECAPTURE_DELAY_MS = 600;
+/** Context kept per item: enough for a dialog plus a few lines above it. */
+const MAX_CONTEXT_CHARS = 4000;
+const MAX_CONTEXT_LINES = 30;
+const MAX_OPTION_LABEL_CHARS = 120;
+// ─── Pure helpers ────────────────────────────────────────────────────────────
+/**
+ * The visible-frame tmux capture (`formatPaneSnapshot`) carries NO newlines: it
+ * repaints every row at its absolute position via `ESC[<row>;<col>H`. Verified
+ * against a live dialog: without this conversion the whole frame collapses to
+ * one line and no dialog ever parses. Column 1 (or omitted) means a fresh row →
+ * newline; a mid-row jump becomes a space so adjacent words don't merge.
+ */
+// eslint-disable-next-line no-control-regex
+const CURSOR_POSITION_PATTERN = /\x1b\[(?:(\d+)(?:;(\d+))?)?[Hf]/g;
+/**
+ * Normalize a raw pane capture into card context: convert row repaints to
+ * lines, strip ANSI, right-trim lines, drop trailing blanks, keep the last
+ * MAX_CONTEXT_LINES lines.
+ */
+export function normalizeCapturedFrame(raw) {
+    if (!raw)
+        return undefined;
+    const rowed = raw.replace(CURSOR_POSITION_PATTERN, (_m, _row, col) => (!col || col === '1' ? '\n' : ' '));
+    const lines = stripAnsi(rowed)
+        .split('\n')
+        .map((line) => line.replace(/\s+$/, ''));
+    while (lines.length > 0 && lines[lines.length - 1] === '')
+        lines.pop();
+    while (lines.length > 0 && lines[0] === '')
+        lines.shift();
+    if (lines.length === 0)
+        return undefined;
+    const text = lines.slice(-MAX_CONTEXT_LINES).join('\n');
+    return text.length > MAX_CONTEXT_CHARS ? text.slice(-MAX_CONTEXT_CHARS) : text;
+}
+/**
+ * Parse the numbered options of a Claude dialog out of a normalized frame.
+ *
+ * Matches the shapes Ink renders for permission prompts and AskUserQuestion:
+ *
+ *     ❯ 1. Yes                                 ❯ 1. Red
+ *       2. Yes, allow all edits (shift+tab)        Prefer red
+ *       3. No, tell Claude what to do (esc)      2. Blue
+ *                                                  Prefer blue
+ *
+ * Options must be consecutively numbered from 1 (2..6 of them); description /
+ * wrap / separator lines between options are tolerated up to a small gap
+ * (AskUserQuestion puts a description under every option and a ─ separator
+ * before its "Chat about this" entry, measured against the live dialog). The
+ * LAST complete block in the frame wins (dialogs render at the bottom).
+ * Returns undefined when nothing parses; callers then fall back to
+ * approve/deny only, so a mis-parse can never route a digit at a dialog that
+ * does not have it.
+ */
+export function parseDialogOptions(context) {
+    if (!context)
+        return undefined;
+    const lines = context.split('\n');
+    let lastComplete;
+    let run = [];
+    let gap = 0;
+    const commit = () => {
+        if (run.length >= 2 && run.length <= 6)
+            lastComplete = run;
+        run = [];
+        gap = 0;
+    };
+    for (const line of lines) {
+        const m = line.match(/^\s*(?:❯\s*)?(\d)[.)]\s+(.+)$/);
+        const n = m ? Number(m[1]) : NaN;
+        if (m && n === run.length + 1) {
+            run.push({ n, label: m[2].trim().slice(0, MAX_OPTION_LABEL_CHARS) });
+            gap = 0;
+        }
+        else if (m && n === 1) {
+            commit();
+            run = [{ n: 1, label: m[2].trim().slice(0, MAX_OPTION_LABEL_CHARS) }];
+        }
+        else if (run.length > 0 && ++gap > 3) {
+            // Too far past the last option for this to still be its description:
+            // the block is over.
+            commit();
+        }
+    }
+    commit();
+    return lastComplete;
+}
+// ─── Registry ────────────────────────────────────────────────────────────────
+export class ApprovalInbox {
+    /** Keyed by sessionId; the one-active-item-per-session invariant lives here. */
+    items = new Map();
+    recaptureTimers = new Map();
+    /** Capture callbacks kept for answer-time re-verification; dropped on remove. */
+    captures = new Map();
+    seq = 0;
+    stopped = false;
+    /** Emit callbacks, injected by the server (SSE broadcast + push). */
+    onPending;
+    onUpdated;
+    onResolved;
+    /**
+     * Record a prompt for a session, superseding any previous item, and return
+     * the new item. Captures context immediately and once more after a short
+     * delay (see RECAPTURE_DELAY_MS).
+     */
+    notePrompt(args) {
+        this.resolveForSession(args.sessionId, 'superseded');
+        const item = {
+            id: `${args.sessionId}:${++this.seq}`,
+            sessionId: args.sessionId,
+            sessionName: args.sessionName,
+            kind: args.kind,
+            createdAt: Date.now(),
+            toolName: args.toolName,
+            toolSummary: args.toolSummary,
+            message: args.message,
+            cwd: args.cwd,
+        };
+        this.applyCapture(item, args.capture);
+        this.items.set(args.sessionId, item);
+        if (args.capture)
+            this.captures.set(args.sessionId, args.capture);
+        this.onPending?.(item);
+        if (args.capture && !this.stopped) {
+            const timer = setTimeout(() => {
+                this.recaptureTimers.delete(item.id);
+                // Only update the item if it is still the live one for the session.
+                if (this.items.get(args.sessionId)?.id !== item.id)
+                    return;
+                this.applyCapture(item, args.capture);
+                this.onUpdated?.(item);
+            }, RECAPTURE_DELAY_MS);
+            this.recaptureTimers.set(item.id, timer);
+        }
+        return item;
+    }
+    /**
+     * Answer-time guard: re-capture the pane and check the dialog is still on
+     * screen before keystrokes are sent at it. Only conclusive when the ORIGINAL
+     * frame parsed options: if a fresh capture then parses none, the dialog is
+     * gone (answered in the terminal moments ago), so the item resolves and the
+     * answer must be refused, because the digit would land in whatever now has
+     * focus. Unparseable-from-the-start items stay answerable (approve/deny
+     * only), same risk the terminal user already carries.
+     */
+    verifyStillAnswerable(id) {
+        const item = this.getById(id);
+        if (!item)
+            return false;
+        if (item.kind === 'idle' || !item.options)
+            return true;
+        const capture = this.captures.get(item.sessionId);
+        if (!capture)
+            return true;
+        let raw = null;
+        try {
+            raw = capture();
+        }
+        catch {
+            return true; // capture hiccup: inconclusive, keep the item answerable
+        }
+        const context = normalizeCapturedFrame(raw);
+        if (!context)
+            return true;
+        const options = parseDialogOptions(context);
+        if (!options) {
+            this.remove(item, 'resolved_in_terminal');
+            return false;
+        }
+        item.context = context;
+        item.options = options;
+        return true;
+    }
+    /** Pending item for a session, TTL-checked. */
+    getForSession(sessionId) {
+        const item = this.items.get(sessionId);
+        if (!item)
+            return undefined;
+        if (this.isExpired(item)) {
+            this.resolveForSession(sessionId, 'expired');
+            return undefined;
+        }
+        return item;
+    }
+    /** Pending item by id, TTL-checked. */
+    getById(id) {
+        const item = this.getForSession(sessionIdOf(id));
+        return item?.id === id ? item : undefined;
+    }
+    /** All pending items, TTL-swept, oldest first. */
+    listPending() {
+        for (const sessionId of [...this.items.keys()])
+            this.getForSession(sessionId);
+        return [...this.items.values()].sort((a, b) => a.createdAt - b.createdAt);
+    }
+    /**
+     * Remove the item as `answered` and return it, or undefined if it is no
+     * longer pending. Callers send keystrokes AFTER a successful take, and
+     * `restore()` on a failed write.
+     */
+    take(id) {
+        const item = this.getById(id);
+        if (!item)
+            return undefined;
+        this.remove(item, 'answered');
+        return item;
+    }
+    /** Re-insert a taken item after a failed write, unless superseded meanwhile. */
+    restore(item) {
+        if (this.stopped || this.items.has(item.sessionId))
+            return;
+        this.items.set(item.sessionId, item);
+        this.onPending?.(item);
+    }
+    /** Remove an item without keystrokes (user chose Dismiss). */
+    dismiss(id) {
+        const item = this.getById(id);
+        if (!item)
+            return false;
+        this.remove(item, 'dismissed');
+        return true;
+    }
+    /**
+     * Resolve a session's pending item, if any (stop hook, exit, ...). `kinds`
+     * restricts which item kinds the signal may clear: the heuristic `working`
+     * transition passes `['idle']` so a mid-turn flap cannot false-clear a
+     * pending permission/question dialog.
+     */
+    resolveForSession(sessionId, resolution, kinds) {
+        const item = this.items.get(sessionId);
+        if (!item)
+            return;
+        if (kinds && !kinds.includes(item.kind))
+            return;
+        this.remove(item, resolution);
+    }
+    /** Clear all timers (shutdown/tests). Items become inert; no events fire after this. */
+    stop() {
+        this.stopped = true;
+        for (const timer of this.recaptureTimers.values())
+            clearTimeout(timer);
+        this.recaptureTimers.clear();
+        this.items.clear();
+        this.captures.clear();
+    }
+    applyCapture(item, capture) {
+        if (!capture)
+            return;
+        let raw = null;
+        try {
+            raw = capture();
+        }
+        catch {
+            // Capture is best-effort; the card still renders from hook fields.
+        }
+        const context = normalizeCapturedFrame(raw);
+        if (!context)
+            return;
+        item.context = context;
+        // Idle prompts are not dialogs; never offer digit answers for them.
+        if (item.kind !== 'idle')
+            item.options = parseDialogOptions(context);
+    }
+    remove(item, resolution) {
+        this.items.delete(item.sessionId);
+        this.captures.delete(item.sessionId);
+        const timer = this.recaptureTimers.get(item.id);
+        if (timer) {
+            clearTimeout(timer);
+            this.recaptureTimers.delete(item.id);
+        }
+        if (!this.stopped) {
+            this.onResolved?.({ id: item.id, sessionId: item.sessionId, kind: item.kind, resolution });
+        }
+    }
+    isExpired(item) {
+        return Date.now() - item.createdAt > ITEM_TTL_MS;
+    }
+}
+function sessionIdOf(itemId) {
+    return itemId.slice(0, itemId.lastIndexOf(':'));
+}
+/** Process-wide singleton, mirroring `sessionWaits`. */
+export const approvalInbox = new ApprovalInbox();
+//# sourceMappingURL=approval-inbox.js.map

package/dist/web/approval-inbox.js.map

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