commandmate 0.44.0 → 0.44.2

package/dist/server/src/lib/detection/tools/codex/detect.js

@@ -24,6 +24,7 @@ const cli_patterns_2 = require("./cli-patterns");
 const prompt_1 = require("./prompt");
 const frame_1 = require("../frame");
 const dialog_block_1 = require("../dialog-block");
+const live_region_1 = require("./live-region");
 const run_detection_1 = require("../run-detection");
 const verified_against_1 = require("../verified-against");
 const thinking_constants_1 = require("../../../../config/thinking-constants");
@@ -43,38 +44,6 @@ exports.VERIFIED_AGAINST = verified_against_1.CODEX_VERIFIED_AGAINST;
  */
 const CODEX_CONFIRMATION_FOOTER_PATTERN = /press\s+(?:number|enter)\s+to\s+confirm/i;
 const CODEX_NUMBERED_OPTION_PATTERN = /^\s*[❯›●]?\s*\d{1,2}[.)]\s/;
-/**
- * Index of the Codex status bar within the last 10 content rows, or -1.
- *
- * Issue #2818: a bar carrying a thread title or the Plan-mode badge after the
- * path (codex 0.154.0+) is the same bar, so it is a boundary too. Without it
- * such frames fell to branch D, whose 15-row tail still holds a finished
- * turn's `• Ran …` record, and an idle session read `running`.
- */
-function findCodexFooterBoundary(contentLines) {
-    for (let ci = contentLines.length - 1; ci >= Math.max(0, contentLines.length - 10); ci--) {
-        const line = contentLines[ci];
-        if (cli_patterns_1.CODEX_STATUS_BAR_PATTERN.test(line) || cli_patterns_1.CODEX_TRAILED_STATUS_BAR_PATTERN.test(line))
-            return ci;
-    }
-    return -1;
-}
-/**
- * Exclusive end of the conversation area — the row below the status bar, with
- * the padding above it walked off (Issue #1928).
- *
- * The same boundary branches 0.8 and 2.7 compute inline, named once so
- * `detectDialog` reads the region THEY read. Falls back to the whole frame when
- * the bar cannot be located, which is Issue #1150's drift case: there the tail
- * is the conversation, so the dialog rule still has the right rows.
- */
-function findCodexContentEnd(contentLines) {
-    const boundary = findCodexFooterBoundary(contentLines);
-    let end = boundary >= 0 ? boundary - 1 : contentLines.length - 1;
-    while (end >= 0 && contentLines[end].trim() === '')
-        end--;
-    return end + 1;
-}
 /**
  * Issue #1160: decide whether a Codex prompt that detectPrompt() matched is a stale,
  * already-answered prompt left in the 50-line scan window rather than an active one.
@@ -98,7 +67,7 @@ function findCodexContentEnd(contentLines) {
  * here — keeping the guard conservative against flipping a genuine prompt to running.
  */
 function isCodexStalePrompt(contentLines) {
-    const footerBoundary = findCodexFooterBoundary(contentLines);
+    const footerBoundary = (0, live_region_1.findCodexFooterBoundary)(contentLines);
     const end = footerBoundary >= 0 ? footerBoundary : contentLines.length;
     let lastPromptIdx = -1;
     let lastThinkingIdx = -1;
@@ -166,6 +135,8 @@ function isCodexDialogGlyphTail(raw) {
 exports.codexStatusDetector = (0, run_detection_1.createToolStatusDetector)({
     tool: 'codex',
     verifiedAgainst: exports.VERIFIED_AGAINST,
+    // Issue #3183: where the live part of the frame begins (`./live-region.ts`).
+    liveRegion: live_region_1.CODEX_LIVE_REGION,
     beforePrompt(frame) {
         const { contentLines } = frame;
         // 0.6. The composer is the pane's bottom → no dialog is open (Issue #2841).
@@ -175,7 +146,11 @@ exports.codexStatusDetector = (0, run_detection_1.createToolStatusDetector)({
         // dialog is up, so a composer at the bottom vetoes all of them at once, and
         // the chain goes on to the prompt / thinking / idle readings it would have
         // reached had the transcript not quoted anything.
-        if ((0, cli_patterns_2.isCodexComposerAtBottom)(frame.raw, contentLines, findCodexContentEnd(contentLines))) {
+        //
+        // Issue #3183: "the composer is the bottom" is the live region's
+        // `composerAtBottom`, located once by `normalizeFrame` from
+        // `CODEX_LIVE_REGION` (the #2841 reading, unchanged).
+        if ((0, frame_1.liveRegionOf)(frame, 'codex').composerAtBottom) {
             return null;
         }
         // 0.7. Codex: pager / edit-previous (transcript) mode detection (Issue #1017)
@@ -213,7 +188,7 @@ exports.codexStatusDetector = (0, run_detection_1.createToolStatusDetector)({
         // interactive element and nothing but a keypress moves them: that is `waiting`.
         // Checked ahead of prompt detection because the transcript rows on screen 2 are
         // ordinary text that must not be read as options.
-        const codexLifecycleDialog = (0, cli_patterns_1.getCodexLifecycleDialog)(frame.clean);
+        const codexLifecycleDialog = (0, cli_patterns_1.getCodexLifecycleDialog)((0, frame_1.withLiveRegion)(frame, 'codex'));
         if (codexLifecycleDialog === 'hooks-list' || codexLifecycleDialog === 'hooks-detail') {
             return {
                 status: 'waiting',
@@ -238,7 +213,7 @@ exports.codexStatusDetector = (0, run_detection_1.createToolStatusDetector)({
         // Issue #1150: the status bar is located via CODEX_STATUS_BAR_PATTERN (version-
         // independent; matches both legacy "N% left ·" and v0.141 "model · path" bars),
         // and since #2818 via CODEX_TRAILED_STATUS_BAR_PATTERN too (0.154+ "· <title>").
-        const codexFooterBoundary = findCodexFooterBoundary(contentLines);
+        const codexFooterBoundary = (0, live_region_1.findCodexFooterBoundary)(contentLines);
         let codexContentEnd = codexFooterBoundary >= 0 ? codexFooterBoundary - 1 : contentLines.length - 1;
         while (codexContentEnd >= 0 && contentLines[codexContentEnd].trim() === '') {
             codexContentEnd--;
@@ -310,7 +285,7 @@ exports.codexStatusDetector = (0, run_detection_1.createToolStatusDetector)({
         // block with codex working below it is scrollback, not a dialog — and the
         // glyph rule agrees independently, because the bottom-most `›` on such a
         // frame is the composer codex draws while it works.
-        const codexDialogFrame = (0, cli_patterns_2.readCodexDialogFrame)(frame.raw, contentLines, findCodexContentEnd(contentLines));
+        const codexDialogFrame = (0, cli_patterns_2.readCodexDialogFrame)(frame.raw, contentLines, (0, live_region_1.findCodexContentEnd)(contentLines));
         if (codexDialogFrame && !isCodexStalePrompt(contentLines)) {
             // The footer is not consulted for the verdict; an unrecognised one means
             // codex reworded a screen, which is worth saying out loud exactly once.
@@ -343,7 +318,7 @@ exports.codexStatusDetector = (0, run_detection_1.createToolStatusDetector)({
         // Issue #2841: a prompt above the composer is conversation text, not a
         // dialog — the same veto branch 0.6 applies to the status branches.
         return (isCodexStalePrompt(frame.contentLines) ||
-            (0, cli_patterns_2.isCodexComposerAtBottom)(frame.raw, frame.contentLines, findCodexContentEnd(frame.contentLines)));
+            (0, frame_1.liveRegionOf)(frame, 'codex').composerAtBottom);
     },
     // §4 D1 決定 4 (Issue #1928). All three inputs are readings this module
     // already performs for its status branches, passed rather than recomputed:
@@ -353,13 +328,15 @@ exports.codexStatusDetector = (0, run_detection_1.createToolStatusDetector)({
         // Issue #2841: Auto-Yes and `respond` act on this answer, so it takes the
         // same veto as the status branches — before the lifecycle screens too, whose
         // wording (`Do you trust …`) can be quoted like any other.
-        const contentEnd = findCodexContentEnd(frame.contentLines);
-        if ((0, cli_patterns_2.isCodexComposerAtBottom)(frame.raw, frame.contentLines, contentEnd))
+        // Issue #3183: the veto itself is applied by `createToolStatusDetector`'s
+        // wrapper from the live region, for every tool; this early return only
+        // saves the parse.
+        if ((0, frame_1.liveRegionOf)(frame, 'codex').composerAtBottom)
             return null;
         return (0, prompt_1.detectCodexDialog)(frame, {
-            contentEnd,
+            contentEnd: (0, live_region_1.findCodexContentEnd)(frame.contentLines),
             stalePrompt: isCodexStalePrompt(frame.contentLines),
-            lifecycleDialog: (0, cli_patterns_1.getCodexLifecycleDialog)(frame.clean),
+            lifecycleDialog: (0, cli_patterns_1.getCodexLifecycleDialog)((0, frame_1.withLiveRegion)(frame, 'codex')),
         });
     },
     afterThinking(frame) {
@@ -370,7 +347,7 @@ exports.codexStatusDetector = (0, run_detection_1.createToolStatusDetector)({
         // A. Thinking indicators (• Ran, • Planning) in the conversation area → should show spinner
         // B. Idle prompt (›) at the end of the conversation area → should show ready
         // Strategy: find the Codex status bar, extract content above it, then check for thinking/idle.
-        const codexFooterBoundary = findCodexFooterBoundary(contentLines);
+        const codexFooterBoundary = (0, live_region_1.findCodexFooterBoundary)(contentLines);
         if (codexFooterBoundary >= 0) {
             // Find last non-empty content line above footer (skip padding + input area)
             let lastContentIdx = codexFooterBoundary - 1;
@@ -477,13 +454,16 @@ exports.codexStatusDetector = (0, run_detection_1.createToolStatusDetector)({
  * `detectDialog` vouches for, so the same words quoted in a reply do not count.
  * `/prompt-response` does not call this and keeps accepting an answer.
  *
- * @param cleanOutput - The capture Auto-Yes judged (ANSI and box drawing stripped)
+ * @param cleanOutput - The capture Auto-Yes judged (ANSI and box drawing
+ *   stripped), or the frame the poller normalised once for the tick (Issue #3183)
  */
 function isCodexModelPickerFrame(cleanOutput) {
-    const frame = (0, frame_1.normalizeFrame)(cleanOutput);
+    const frame = typeof cleanOutput === 'string'
+        ? (0, frame_1.normalizeFrame)(cleanOutput, 'codex')
+        : (0, frame_1.withLiveRegion)(cleanOutput, 'codex');
     if (!exports.codexStatusDetector.detectDialog(frame))
         return false;
-    const contentEnd = findCodexContentEnd(frame.contentLines);
+    const contentEnd = (0, live_region_1.findCodexContentEnd)(frame.contentLines);
     const block = (0, dialog_block_1.findNumberedOptionBlock)((0, cli_patterns_1.stripBoxDrawing)(frame.clean).split('\n'), contentEnd);
     return (block !== null &&
         (cli_patterns_1.CODEX_PICKER_FOOTER_PATTERN.test(block.footer) ||

package/dist/server/src/lib/detection/tools/codex/live-region.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Codex's live region (Issue #3183; design doc §7 "codex").
+ *
+ * - **composer** — the bottom-most genuine `›` row ({@link findCodexComposerRow},
+ *   the #892 rule), with "is it the bottom of the pane?" answered by
+ *   {@link isCodexComposerAtBottom} (the #2841 rule: the RAW glyph row's SGR
+ *   first, the stripped last content row otherwise). Before #3183 those were two
+ *   separate readings in two files; they are now the two halves of one marker.
+ *   Measured: `codex-dialogs-0157/quoted-approval-idle.txt` L997 (composer) under
+ *   the quotation at L40-L49.
+ * - **dialog top** — not declared. codex removes its composer while a dialog is
+ *   open and the dialog takes the bottom of the pane (`codex-dialogs-0157/
+ *   approval.txt` L987-L1000), so the whole frame is the right fallback.
+ *
+ * @module lib/detection/tools/codex/live-region
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODEX_LIVE_REGION = void 0;
+exports.findCodexFooterBoundary = findCodexFooterBoundary;
+exports.findCodexContentEnd = findCodexContentEnd;
+const cli_patterns_1 = require("../../cli-patterns");
+const cli_patterns_2 = require("./cli-patterns");
+const live_region_1 = require("../live-region");
+/**
+ * Index of the Codex status bar within the last 10 content rows, or -1.
+ *
+ * Issue #2818: a bar carrying a thread title or the Plan-mode badge after the
+ * path (codex 0.154.0+) is the same bar, so it is a boundary too. Without it
+ * such frames fell to branch D, whose 15-row tail still holds a finished
+ * turn's `• Ran …` record, and an idle session read `running`.
+ */
+function findCodexFooterBoundary(contentLines) {
+    for (let ci = contentLines.length - 1; ci >= Math.max(0, contentLines.length - 10); ci--) {
+        const line = contentLines[ci];
+        if (cli_patterns_1.CODEX_STATUS_BAR_PATTERN.test(line) || cli_patterns_1.CODEX_TRAILED_STATUS_BAR_PATTERN.test(line))
+            return ci;
+    }
+    return -1;
+}
+/**
+ * Exclusive end of the conversation area — the row below the status bar, with
+ * the padding above it walked off (Issue #1928).
+ *
+ * Falls back to the whole frame when the bar cannot be located, which is
+ * Issue #1150's drift case: there the tail is the conversation, so the dialog
+ * rule still has the right rows.
+ */
+function findCodexContentEnd(contentLines) {
+    const boundary = findCodexFooterBoundary(contentLines);
+    let end = boundary >= 0 ? boundary - 1 : contentLines.length - 1;
+    while (end >= 0 && contentLines[end].trim() === '')
+        end--;
+    return end + 1;
+}
+exports.CODEX_LIVE_REGION = {
+    composer: {
+        locate({ raw, contentLines }) {
+            const contentEnd = findCodexContentEnd(contentLines);
+            const atBottom = (0, cli_patterns_2.isCodexComposerAtBottom)(raw, contentLines, contentEnd);
+            const row = (0, cli_patterns_1.findCodexComposerRow)(contentLines);
+            if (row >= 0)
+                return { start: row, end: row, atBottom };
+            if (!atBottom)
+                return null;
+            // The raw glyph row said "composer" although its text reads as a numbered
+            // row (a hand-typed `1. buy milk`): the composer is the last content row.
+            const start = (0, live_region_1.lastContentRow)(contentLines.slice(0, contentEnd));
+            return start < 0 ? null : { start, end: start, atBottom: true };
+        },
+    },
+    composerHidesDialogs: true,
+};

package/dist/server/src/lib/detection/tools/command-code/detect.js

@@ -139,6 +139,8 @@ const selection_shape_1 = require("../../selection-shape");
 const dialog_1 = require("./dialog");
 const permission_1 = require("./permission");
 const status_reason_1 = require("../../status-reason");
+const live_region_1 = require("./live-region");
+const frame_1 = require("../frame");
 const run_detection_1 = require("../run-detection");
 const verified_against_1 = require("../verified-against");
 /** Command Code build these rules were read off (value in ../verified-against). */
@@ -146,7 +148,16 @@ exports.VERIFIED_AGAINST = verified_against_1.COMMAND_CODE_VERIFIED_AGAINST;
 exports.commandCodeStatusDetector = (0, run_detection_1.createToolStatusDetector)({
     tool: 'command-code',
     verifiedAgainst: exports.VERIFIED_AGAINST,
+    // Issue #3183: where the live part of the frame begins (`./live-region.ts`).
+    liveRegion: live_region_1.COMMAND_CODE_LIVE_REGION,
     beforePrompt(frame) {
+        // Issue #3183: an input box at the bottom of the pane means none of the
+        // three overlays below is open — each replaces the input box — so a footer
+        // the conversation quotes cannot reach them, whatever window it sits in.
+        // The live region says so once for every rule; the `…AtBottom` readings
+        // below (#2846) still decide the frames that have no input box.
+        if ((0, frame_1.liveRegionOf)(frame, 'command-code').composerAtBottom)
+            return null;
         // Issue #2761. The plan review overlay, read off its two footer rows.
         //
         // `beforePrompt` and not `afterPrompt`, and that placement is the point: the

package/dist/server/src/lib/detection/tools/command-code/live-region.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Command Code's live region (Issue #3183; design doc §7 "command-code").
+ *
+ * - **composer** — the input box between two rules pinned to the bottom, with a
+ *   `❯` row under the opening rule (`findCommandCodeChromeStart`, the same
+ *   shape as claude's). A `❯ 1.` row there is a question dialog's cursor, not
+ *   the composer, and is refused. Measured: `tui-frame-footer-2776/
+ *   command-code-1.58.0-idle-quoted-footers.txt` L29-L32 under the quoted
+ *   footers at L18-L21.
+ * - **dialog top** — the rule above the first option of a dialog closed by the
+ *   `↑/↓ navigate · enter select` footer. Measured: `command-code-live-2250/
+ *   dialog-shell-command.txt` L29 / L36 / L40.
+ *
+ * @module lib/detection/tools/command-code/live-region
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMAND_CODE_LIVE_REGION = void 0;
+const cli_patterns_1 = require("../../cli-patterns");
+const live_region_1 = require("../live-region");
+/** A numbered cursor row (`❯ 1. Yes`) — a dialog's, never the composer's. */
+const NUMBERED_CURSOR_ROW = /^❯\s*\d{1,2}[.)]\s/;
+exports.COMMAND_CODE_LIVE_REGION = {
+    composer: (0, live_region_1.fencedComposer)(lines => {
+        const start = (0, cli_patterns_1.findCommandCodeChromeStart)(lines);
+        if (start < 0)
+            return -1;
+        return NUMBERED_CURSOR_ROW.test((0, cli_patterns_1.stripAnsi)(lines[start + 1] ?? '')) ? -1 : start;
+    }),
+    dialogTop: (0, live_region_1.ruleAboveOptionRun)({
+        footer: row => /↑\/↓ navigate · enter select/.test(row),
+        rule: /^─{10,}$/,
+        maxRows: 120,
+    }),
+    composerHidesDialogs: true,
+};

package/dist/server/src/lib/detection/tools/copilot/detect.js

@@ -15,6 +15,7 @@ const cli_patterns_1 = require("../../cli-patterns");
 const prompt_detector_1 = require("../../prompt-detector");
 const status_reason_1 = require("../../status-reason");
 const prompt_1 = require("./prompt");
+const live_region_1 = require("./live-region");
 const run_detection_1 = require("../run-detection");
 const verified_against_1 = require("../verified-against");
 /** copilot-cli build these rules were read off (#1885 / #1895; value in ../verified-against, #1929). */
@@ -39,6 +40,8 @@ function readIdleEvidence(frame) {
 exports.copilotStatusDetector = (0, run_detection_1.createToolStatusDetector)({
     tool: 'copilot',
     verifiedAgainst: exports.VERIFIED_AGAINST,
+    // Issue #3183: where the live part of the frame begins (`./live-region.ts`).
+    liveRegion: live_region_1.COPILOT_LIVE_REGION,
     beforePrompt(frame) {
         // 0. Copilot: picker detection BEFORE thinking detection
         // COPILOT_THINKING_PATTERN includes "Reasoning\s+[■▪▮]" which matches the

package/dist/server/src/lib/detection/tools/copilot/live-region.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Copilot's live region (Issue #3183; design doc §7 "copilot").
+ *
+ * - **composer** — the bottom chrome `findCopilotChromeStart` locates: the cwd
+ *   row, the fenced composer (`─` rules on 1.0.80, `╻▄` / `╹▀` frames on
+ *   1.0.82) and the status bar under it. Measured: `copilot-live-1885/
+ *   turn-complete.txt` L997-L1001 (1.0.80) and `copilot-live-2269/
+ *   turn-complete.txt` L996-L1000 (1.0.82).
+ * - **dialog top** — the `╭` corner the bottom `╰` row closes. copilot draws its
+ *   dialogs in a box over the whole bottom of the pane, chrome gone. Measured:
+ *   `copilot-live-1885/permission-dialog.txt` L987 / L1001 (1.0.80; 1.0.82's
+ *   dialog has not been captured — design doc §6 item 3).
+ *
+ * `composerHidesDialogs: false`: the `/model` picker is drawn with the fenced
+ * composer still on screen (`copilot-live-1885/model-picker.txt`; the comment
+ * on `findCopilotChromeStart` records the blank header row it leaves), so only
+ * numbered readings are vetoed by it. The numbered permission dialog replaces
+ * the chrome (`permission-dialog.txt`).
+ *
+ * @module lib/detection/tools/copilot/live-region
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COPILOT_LIVE_REGION = void 0;
+const cli_patterns_1 = require("../../cli-patterns");
+const live_region_1 = require("../live-region");
+/** How far above the bottom row the box's closing corner may sit. */
+const BOX_BOTTOM_MAX_ROWS = 2;
+/** How tall a dialog box may be before it stops looking like one. */
+const BOX_MAX_ROWS = 120;
+function findCopilotDialogBoxTop(lines) {
+    const last = (0, live_region_1.lastContentRow)(lines);
+    let bottom = -1;
+    for (let i = last; i >= Math.max(0, last - BOX_BOTTOM_MAX_ROWS); i--) {
+        if (lines[i].trimStart().startsWith('╰')) {
+            bottom = i;
+            break;
+        }
+    }
+    if (bottom < 0)
+        return -1;
+    for (let i = bottom - 1; i >= Math.max(0, bottom - BOX_MAX_ROWS); i--) {
+        if (lines[i].trimStart().startsWith('╭'))
+            return i;
+    }
+    return -1;
+}
+exports.COPILOT_LIVE_REGION = {
+    composer: (0, live_region_1.fencedComposer)(lines => (0, cli_patterns_1.findCopilotChromeStart)(lines)),
+    dialogTop: (0, live_region_1.dialogTopFrom)(findCopilotDialogBoxTop),
+    composerHidesDialogs: false,
+};

package/dist/server/src/lib/detection/tools/frame.js

@@ -12,9 +12,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.STATUS_CHECK_LINE_COUNT = void 0;
 exports.normalizeFrame = normalizeFrame;
+exports.liveRegionOf = liveRegionOf;
+exports.withLiveRegion = withLiveRegion;
 const cli_patterns_1 = require("../cli-patterns");
 const tui_detection_frame_1 = require("../tui-detection-frame");
 const thinking_constants_1 = require("../../../config/thinking-constants");
+const live_region_specs_1 = require("./live-region-specs");
+const live_region_1 = require("./live-region");
 /**
  * Number of lines from the end to check for prompt and input indicators.
  *
@@ -23,8 +27,17 @@ const thinking_constants_1 = require("../../../config/thinking-constants");
  * existing importers are unaffected.
  */
 exports.STATUS_CHECK_LINE_COUNT = 15;
-/** Build the shared {@link NormalizedFrame} for one capture. */
-function normalizeFrame(output) {
+/**
+ * Build the shared {@link NormalizedFrame} for one capture.
+ *
+ * @param output - The capture. Pass it as captured (ANSI and box drawing
+ *   intact): the input-box markers of claude / Command Code / copilot / opencode
+ *   are rule rows that `stripBoxDrawing` blanks.
+ * @param tool - The CLI the capture came from. Names the live-region declaration
+ *   to apply (Issue #3183); omitted, the region is the whole frame — the reading
+ *   every rule had before.
+ */
+function normalizeFrame(output, tool) {
     const clean = (0, tui_detection_frame_1.normalizeTuiFrameForDetection)((0, cli_patterns_1.stripAnsi)(output));
     const lines = clean.split('\n');
     // Strip trailing empty lines (tmux terminal padding) before windowing.
@@ -40,8 +53,29 @@ function normalizeFrame(output) {
         clean,
         lines,
         contentLines,
+        liveRegion: (0, live_region_1.locateLiveRegion)(tool === undefined ? undefined : live_region_specs_1.LIVE_REGION_SPECS[tool], tool ?? null, {
+            raw: output,
+            contentLines,
+        }),
         lastLines: contentLines.slice(-exports.STATUS_CHECK_LINE_COUNT).join('\n'),
         // DR-003: Separate thinking detection window (5 lines) from prompt detection window (15 lines)
         thinkingLines: contentLines.slice(-thinking_constants_1.THINKING_TAIL_LINE_COUNT).join('\n'),
     };
 }
+/**
+ * The live region of `frame` as `tool` declares it (Issue #3183).
+ *
+ * `frame.liveRegion` when the frame was normalised for `tool`; recomputed
+ * otherwise — a caller that built the frame without naming the tool (older
+ * call sites, tests) still gets the tool's own reading, never a stale one.
+ */
+function liveRegionOf(frame, tool) {
+    if (frame.liveRegion.tool === tool)
+        return frame.liveRegion;
+    return (0, live_region_1.locateLiveRegion)(live_region_specs_1.LIVE_REGION_SPECS[tool], tool, { raw: frame.raw, contentLines: frame.contentLines });
+}
+/** `frame` with its live region located for `tool` (the same object when it already is). */
+function withLiveRegion(frame, tool) {
+    const liveRegion = liveRegionOf(frame, tool);
+    return liveRegion === frame.liveRegion ? frame : { ...frame, liveRegion };
+}

package/dist/server/src/lib/detection/tools/live-region-specs.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Every tool's live-region declaration, by tool (Issue #3183).
+ *
+ * A table of its own rather than a lookup through the detector registry:
+ * `normalizeFrame` reads it, and the detector modules import `normalizeFrame`,
+ * so going through `registry.ts` would close an import cycle. Each detector
+ * declares the same object as its `ToolDetectorSpec.liveRegion`, and
+ * `detector-contract.test.ts` holds the two to identity.
+ *
+ * `gemini` and `vibe-local` have no measured frames and no declaration: their
+ * frames carry the whole-frame region, which is the pre-#3183 reading.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIVE_REGION_SPECS = void 0;
+const live_region_1 = require("./antigravity/live-region");
+const live_region_2 = require("./claude/live-region");
+const live_region_3 = require("./codex/live-region");
+const live_region_4 = require("./command-code/live-region");
+const live_region_5 = require("./copilot/live-region");
+const live_region_6 = require("./opencode/live-region");
+const live_region_7 = require("./opencode-v2/live-region");
+exports.LIVE_REGION_SPECS = {
+    claude: live_region_2.CLAUDE_LIVE_REGION,
+    codex: live_region_3.CODEX_LIVE_REGION,
+    antigravity: live_region_1.ANTIGRAVITY_LIVE_REGION,
+    'command-code': live_region_4.COMMAND_CODE_LIVE_REGION,
+    copilot: live_region_5.COPILOT_LIVE_REGION,
+    opencode: live_region_6.OPENCODE_LIVE_REGION,
+    'opencode-v2': live_region_7.OPENCODE_V2_LIVE_REGION,
+};