@with-logic/elwood 0.2.0 → 0.2.2

package/dist/core/models/own-picker.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The one gate for every picker key and every frame the window walk reads.
+ * Implements PRD §5.3 and C-API-24.
+ */
+import type { ModelPickerSpec } from "./picker.ts";
+/**
+ * True only while THIS operation's own COMPLETE picker is the bottom-most region: never its
+ * `painting` shell and never a `follow-up` stage. It gates every shared navigation,
+ * selection, and cancelling key, each adapter's selecting key, and every frame the window
+ * walk reads; a follow-up is answered only by the adapter's `apply`, under that stage's own
+ * guard (Claude's cache warning, Codex's reasoning level).
+ *
+ * Elwood is inside the transaction that wrote `/model`, so these reads carry its authority
+ * (`ownOperation`). A header match alone is untrusted: a transcript or the agent's own output
+ * can print `Select model`, so navigating or Escaping on it could send keys into a running
+ * turn, the real composer, or another prompt (C-API-24). The header gates only the `/model`
+ * open wait (`openAndParse`); the cursor-settle wait reads a parsed row, and the close wait
+ * (`waitUntilClosed`) reads only the bottom-most region. None of them writes.
+ */
+export declare const isOwnCompletePicker: (spec: Pick<ModelPickerSpec, "activeDialog">) => (text: string) => boolean;
+//# sourceMappingURL=own-picker.d.ts.map

package/dist/core/models/own-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-picker.d.ts","sourceRoot":"","sources":["../../../src/core/models/own-picker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,GAC7B,MAAM,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,MAAM,MAAM,MAAM,YACV,CAAC"}

package/dist/core/models/own-picker.js

@@ -0,0 +1,21 @@
+/**
+ * The one gate for every picker key and every frame the window walk reads.
+ * Implements PRD §5.3 and C-API-24.
+ */
+import { ownOperation } from "./rows.js";
+/**
+ * True only while THIS operation's own COMPLETE picker is the bottom-most region: never its
+ * `painting` shell and never a `follow-up` stage. It gates every shared navigation,
+ * selection, and cancelling key, each adapter's selecting key, and every frame the window
+ * walk reads; a follow-up is answered only by the adapter's `apply`, under that stage's own
+ * guard (Claude's cache warning, Codex's reasoning level).
+ *
+ * Elwood is inside the transaction that wrote `/model`, so these reads carry its authority
+ * (`ownOperation`). A header match alone is untrusted: a transcript or the agent's own output
+ * can print `Select model`, so navigating or Escaping on it could send keys into a running
+ * turn, the real composer, or another prompt (C-API-24). The header gates only the `/model`
+ * open wait (`openAndParse`); the cursor-settle wait reads a parsed row, and the close wait
+ * (`waitUntilClosed`) reads only the bottom-most region. None of them writes.
+ */
+export const isOwnCompletePicker = (spec) => (text) => spec.activeDialog(text, ownOperation) === "picker";
+//# sourceMappingURL=own-picker.js.map

package/dist/core/models/own-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-picker.js","sourceRoot":"","sources":["../../../src/core/models/own-picker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,CAAC,IAA2C,EAAE,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE,CAChE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,QAAQ,CAAC"}

package/dist/core/models/picker.d.ts

@@ -2,24 +2,39 @@
  * Shared /model picker automation for adapter sessions.
  * Implements PRD §5.3, §5.7, C-API-23, and C-API-24.
  */
+import type { ElwoodAgentKind } from "../activity/index.ts";
+import type { ObservedTerminal } from "../input/abort.ts";
 import type { AgentModelOption, ModelDialogAuthority, ModelDialogStage, ParsedModelPicker } from "./rows.ts";
-import { type ScreenTerminal } from "./tui-screen.ts";
+export { isOwnCompletePicker } from "./own-picker.ts";
 export declare function pickerTimeout(options?: {
     readonly timeoutMs?: number;
 }): number;
 export type ModelPickerIo = {
-    readonly terminal: ScreenTerminal;
+    /** Every key is written behind its received-output barrier (C-API-56). */
+    readonly terminal: ObservedTerminal;
     readonly blocked?: () => boolean;
     readonly signal?: AbortSignal;
     readonly submit: (command: string, signal: AbortSignal) => Promise<void>;
 };
 export type ModelPickerSpec = {
-    readonly agent: string;
+    readonly agent: ElwoodAgentKind;
     /** A native model-dialog shell can hold input before its rows finish. */
     readonly isCandidate: (text: string) => boolean;
     /** Positive native composer evidence for releasing a foreign-dialog hold. */
     readonly isClear: (text: string) => boolean;
-    readonly isOpen: (text: string) => boolean;
+    /**
+     * Only that the picker's title is on screen: a transcript can print it, and a picker
+     * still painting shows it over stale rows. It gates the `/model` open wait and may hold
+     * input; it never ends a close wait (which reads only the bottom-most region) and never
+     * authorizes a write.
+     */
+    readonly hasPickerHeader: (text: string) => boolean;
+    /**
+     * Positive evidence that the bottom-most dialog is the caller's own, which replaced
+     * ours: Claude's `PreModelSwitch` hook confirmation. Elwood neither answers it nor keeps
+     * it as a survivor; it is left for the caller (PRD §5.3).
+     */
+    readonly isCallerDialog: (text: string) => boolean;
     /**
      * The live, bottom-most model dialog: the only one Elwood may cancel or hold input on.
      * `authority` is REQUIRED and carries proof Elwood opened this dialog (see
@@ -29,8 +44,23 @@ export type ModelPickerSpec = {
      */
     readonly activeDialog: (text: string, authority: ModelDialogAuthority) => ModelDialogStage | undefined;
     readonly parse: (text: string) => ParsedModelPicker;
+    /**
+     * Completes listed rows from state the picker does not render, inside the operation's
+     * queue slot and under its deadline/termination `signal`. Codex reads its configured
+     * default here (PRD §5.3).
+     */
+    readonly withDefaults?: (options: readonly AgentModelOption[], signal: AbortSignal) => Promise<readonly AgentModelOption[]>;
     readonly apply: (io: ModelPickerIo, timeoutMs: number) => Promise<void>;
 };
+/**
+ * Every row the picker lists, rows outside its window included. Cancels with Escape after the
+ * walk, so neither the model nor its effort changes, and returns once the picker is closed.
+ */
 export declare function listPickerModels(io: ModelPickerIo, spec: ModelPickerSpec, timeoutMs: number): Promise<readonly AgentModelOption[]>;
+/**
+ * Selects `id`, walking a scrolling window only until that row is rendered, then moving to it
+ * and applying it with the adapter's own `apply`. An unknown id cancels, and the rejection
+ * lists every row the walk saw.
+ */
 export declare function setPickerModel(io: ModelPickerIo, spec: ModelPickerSpec, id: string, timeoutMs: number): Promise<void>;
 //# sourceMappingURL=picker.d.ts.map

package/dist/core/models/picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../../src/core/models/picker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/E;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,oBAAoB,KAC5B,gBAAgB,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE,CAAC;AAgCF,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAWtC;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../../src/core/models/picker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1D,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAInB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/E;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAChD,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,oBAAoB,KAC5B,gBAAgB,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CACtB,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE,CAAC;AAKF;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAMtC;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/core/models/picker.js

@@ -4,77 +4,83 @@
  */
 import { delay } from "../delay.js";
 import { elwoodError } from "../errors.js";
+import { arrowDown, arrowUp } from "../input/constants.js";
+import { waitUntilClosed } from "./close-wait.js";
 import { sendPickerInput } from "./input.js";
-import { defaultModelTimeoutMs, openCommandScreen, waitForScreen, } from "./tui-screen.js";
+import { isOwnCompletePicker } from "./own-picker.js";
+import { defaultModelTimeoutMs, openCommandScreen, waitForScreen } from "./tui-screen.js";
+import { cursorOption, revealPickerRows } from "./window.js";
+export { isOwnCompletePicker } from "./own-picker.js";
 export function pickerTimeout(options) {
     return options?.timeoutMs ?? defaultModelTimeoutMs;
 }
-/**
- * Elwood is inside the transaction that wrote `/model`, so these reads carry its authority.
- * Every wait and write below is gated on `ours(spec)` rather than the raw `isOpen` header:
- * a header match alone is untrusted candidate evidence — a transcript or the agent's own
- * output can print `Select model` — so navigating or Escaping on it could send keys into a
- * running turn, the real composer, or another prompt (C-API-24).
- */
-const opened = { opened: true };
-/** True only while THIS operation's own dialog is the bottom-most region of the screen. */
-const ours = (spec) => (text) => spec.activeDialog(text, opened) !== undefined;
-/**
- * The guard for a CANCELLING Escape, which is deliberately weaker than `ours`.
- *
- * Navigation and selection must land on a fully recognized dialog, because an arrow or
- * Enter on the wrong screen changes something. Escape only closes, and this operation
- * opened the screen that is up: a picker whose rows never parsed is still OUR picker, and
- * abandoning it because the grammar cannot describe it would leave it open for the next
- * queued write. So the header is enough here, and only here.
- */
-const oursOrOpen = (spec) => (text) => ours(spec)(text) || spec.isOpen(text);
 const escapeKey = "\u001b";
-const arrowDown = "\u001b[B";
-const arrowUp = "\u001b[A";
 const arrowStepMs = 80;
+/**
+ * Every row the picker lists, rows outside its window included. Cancels with Escape after the
+ * walk, so neither the model nor its effort changes, and returns once the picker is closed.
+ */
 export async function listPickerModels(io, spec, timeoutMs) {
-    const parsed = await openAndParse(io, spec, timeoutMs);
-    await sendPickerInput(io, escapeKey, oursOrOpen(spec));
-    await waitForScreen(io.terminal, (text) => !oursOrOpen(spec)(text), timeoutMs, `${spec.agent} model picker to close`, io.signal);
-    return parsed.options;
+    const opening = await openAndParse(io, spec, timeoutMs);
+    const { options } = await revealPickerRows(io, spec, opening, { timeoutMs });
+    await sendPickerInput(io, escapeKey, isOwnCompletePicker(spec));
+    await waitUntilClosed(io, spec, timeoutMs);
+    return options;
 }
+/**
+ * Selects `id`, walking a scrolling window only until that row is rendered, then moving to it
+ * and applying it with the adapter's own `apply`. An unknown id cancels, and the rejection
+ * lists every row the walk saw.
+ */
 export async function setPickerModel(io, spec, id, timeoutMs) {
-    const parsed = await openAndParse(io, spec, timeoutMs);
+    const opening = await openAndParse(io, spec, timeoutMs);
     const wanted = id.toLowerCase();
     // Row ids are already lower-cased labels (`rows.ts`), so matching the id
     // alone covers a caller that passes the display label in any case.
-    const target = parsed.options.findIndex((option) => option.id === wanted);
-    if (target === -1 || parsed.cursorIndex === -1) {
-        await sendPickerInput(io, escapeKey, oursOrOpen(spec));
-        const reason = target === -1 ? `Unknown model id "${id}".` : "Could not locate the picker cursor.";
+    const isTarget = (option) => option.id === wanted;
+    const ownCompletePicker = isOwnCompletePicker(spec);
+    // A row outside a scrolling window is as selectable as a rendered one: walk only until it
+    // is rendered. An unknown id walks the whole list, so the error names every row.
+    const walk = { timeoutMs, found: isTarget };
+    const { frame: parsed, options } = await revealPickerRows(io, spec, opening, walk);
+    const targetOptionIndex = parsed.options.findIndex(isTarget);
+    if (targetOptionIndex === -1 || parsed.cursorOptionIndex === -1) {
+        await sendPickerInput(io, escapeKey, ownCompletePicker);
+        const reason = targetOptionIndex === -1
+            ? `Unknown model id "${id}".`
+            : "Could not locate the picker cursor.";
         throw elwoodError("model_automation_failed", reason, {
-            available: parsed.options.map((option) => option.id),
+            available: options.map((option) => option.id),
         });
     }
-    const delta = target - parsed.cursorIndex;
+    const delta = targetOptionIndex - parsed.cursorOptionIndex;
     const key = delta > 0 ? arrowDown : arrowUp;
     for (let step = 0; step < Math.abs(delta); step += 1) {
-        await sendPickerInput(io, key, ours(spec));
+        await sendPickerInput(io, key, ownCompletePicker);
         await delay(arrowStepMs);
     }
-    await waitForScreen(io.terminal, (text) => spec.parse(text).cursorIndex === target, timeoutMs, `${spec.agent} picker cursor on "${id}"`, io.signal);
+    // Settle on the cursor row's identity, not its index: a scrolled Claude window shifts
+    // which rows are rendered as the cursor moves, so the target's index changes with it.
+    await waitForScreen(io.terminal, (text) => cursorOption(spec.parse(text))?.id === wanted, timeoutMs, `${spec.agent} picker cursor on "${id}"`, io.signal);
     await spec.apply(io, timeoutMs);
+    await waitUntilClosed(io, spec, timeoutMs);
 }
 async function openAndParse(io, spec, timeoutMs) {
-    const text = await openCommandScreen({
+    await openCommandScreen({
         terminal: io.terminal,
         ...(io.signal === undefined ? {} : { signal: io.signal }),
         submit: (signal) => io.submit("/model", signal),
-        isOpen: spec.isOpen,
+        isOpen: spec.hasPickerHeader,
         timeoutMs,
         label: `${spec.agent} model picker`,
     });
-    const parsed = spec.parse(text);
-    if (parsed.options.length === 0) {
-        await sendPickerInput(io, escapeKey, oursOrOpen(spec));
-        throw elwoodError("model_automation_failed", "Could not parse any model picker rows.");
-    }
-    return parsed;
+    // The header paints before the rows finish: Claude draws the picker over its slash-command
+    // menu, so a frame that merely shows `Select model` can hold three rows above stale
+    // commands. Parse only the complete dialog the grammar recognizes as ours, the same guard
+    // every key write passes, or a partial list is returned as the catalog. A picker that
+    // never completes is not written to here: the transaction's failure cleanup Escapes it
+    // once it is recognizable, and a candidate that never is keeps queued input held.
+    const text = await waitForScreen(io.terminal, isOwnCompletePicker(spec), timeoutMs, `${spec.agent} model picker rows`, io.signal);
+    return spec.parse(text);
 }
 //# sourceMappingURL=picker.js.map

package/dist/core/models/picker.js.map

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

package/dist/core/models/row-block.d.ts

@@ -0,0 +1,66 @@
+/**
+ * The one contiguous block of option rows inside a native model dialog, fed line by line.
+ * Split from `dialog-region.ts`, which decides what may surround the block. Implements
+ * C-API-24.
+ */
+export declare const caretRow: RegExp;
+export declare const numberedRow: RegExp;
+/**
+ * How a CLI windows a list longer than its viewport, for the adapter that does. `above`
+ * and `below` each match a row's start through the marker it wears in the cursor column
+ * while rows are hidden above the window (its first visible row) or below it (its last);
+ * `overflow` is the line that may stand directly under that last row while any are hidden,
+ * which wears the `below` marker or, when the cursor is on it, the cursor in its place. The
+ * overflow line's `hidden` named group captures how many rows are hidden.
+ */
+export type ScrollGrammar = {
+    readonly above: RegExp;
+    readonly below: RegExp;
+    readonly overflow: RegExp;
+};
+/** `line` with a leading scroll marker blanked, so it reads as an ordinary option row. */
+export declare function unmarkedRow(line: string, scroll: ScrollGrammar | undefined): string;
+/**
+ * Whether the overflow line may stand directly under row `line`: only a window's last row,
+ * which wears the `below` marker or, when the cursor is on it, the cursor in its place. The
+ * region grammar and the overflow-count parser (`rows.ts`) share this one rule.
+ */
+export declare function overflowMayFollowRow(line: string, scroll: ScrollGrammar | undefined): boolean;
+export declare class RowBlock {
+    rowCount: number;
+    cursorCount: number;
+    private nextRowNumber;
+    /**
+     * A `below` row, or the overflow line under it, ended the window: no later row belongs to
+     * it. A window at the bottom of the list has neither; the dialog's footer ends it.
+     */
+    private windowEnded;
+    /**
+     * The last line accepted was a row wearing the `below` marker or the cursor, which takes
+     * the marker's place: the only line the overflow line may stand under.
+     */
+    private overflowMayFollow;
+    private readonly complete;
+    private readonly scroll;
+    constructor(options: {
+        readonly complete: boolean;
+        readonly scroll: ScrollGrammar | undefined;
+    });
+    /**
+     * Whether `line` extends the block: its next row or, on a windowed list, the overflow line
+     * directly under its last row, which is `below`-marked or the cursor row. A COMPLETE dialog's rows are full picker rows
+     * (`1. Label  Description`); while a candidate is still painting, a numbered row whose
+     * description has not arrived yet counts too, so the shell keeps holding input. Anything
+     * else — a renumbered second list, a row after the window ended, a scroll marker the
+     * CLI's grammar does not define — is not this dialog's.
+     */
+    accept(line: string): boolean;
+    /**
+     * Whether `row` (`line` with any scroll marker blanked) is the block's next row. Only the
+     * FIRST row may be numbered past 1, and only under an `above` marker: a window scrolled
+     * down hides the rows above it, but an unmarked list that starts at 3 is someone else's,
+     * and an `above` marker below the first row is not a window.
+     */
+    private isRow;
+}
+//# sourceMappingURL=row-block.d.ts.map

package/dist/core/models/row-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-block.d.ts","sourceRoot":"","sources":["../../../src/core/models/row-block.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,QAAQ,QAAa,CAAC;AACnC,eAAO,MAAM,WAAW,QAA4B,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAGnF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAE7F;AAED,qBAAa,QAAQ;IACnB,QAAQ,SAAK;IACb,WAAW,SAAK;IAChB,OAAO,CAAC,aAAa,CAAK;IAC1B;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAS;IAC5B;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBACvC,OAAO,EAAE;QACnB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;KAC5C;IAKD;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAiB7B;;;;;OAKG;IACH,OAAO,CAAC,KAAK;CASd"}

package/dist/core/models/row-block.js

@@ -0,0 +1,87 @@
+/**
+ * The one contiguous block of option rows inside a native model dialog, fed line by line.
+ * Split from `dialog-region.ts`, which decides what may surround the block. Implements
+ * C-API-24.
+ */
+import { rowPattern } from "./rows.js";
+export const caretRow = /^\s*[❯›]/;
+export const numberedRow = /^\s*[❯›]?\s*(\d+)[.)]\s/;
+/** `line` with a leading scroll marker blanked, so it reads as an ordinary option row. */
+export function unmarkedRow(line, scroll) {
+    const marker = [scroll?.above, scroll?.below].find((pattern) => pattern?.test(line));
+    return marker === undefined ? line : line.replace(marker, (start) => " ".repeat(start.length));
+}
+/**
+ * Whether the overflow line may stand directly under row `line`: only a window's last row,
+ * which wears the `below` marker or, when the cursor is on it, the cursor in its place. The
+ * region grammar and the overflow-count parser (`rows.ts`) share this one rule.
+ */
+export function overflowMayFollowRow(line, scroll) {
+    return scroll?.below.test(line) === true || caretRow.test(unmarkedRow(line, scroll));
+}
+export class RowBlock {
+    rowCount = 0;
+    cursorCount = 0;
+    nextRowNumber = 1;
+    /**
+     * A `below` row, or the overflow line under it, ended the window: no later row belongs to
+     * it. A window at the bottom of the list has neither; the dialog's footer ends it.
+     */
+    windowEnded = false;
+    /**
+     * The last line accepted was a row wearing the `below` marker or the cursor, which takes
+     * the marker's place: the only line the overflow line may stand under.
+     */
+    overflowMayFollow = false;
+    complete;
+    scroll;
+    constructor(options) {
+        this.complete = options.complete;
+        this.scroll = options.scroll;
+    }
+    /**
+     * Whether `line` extends the block: its next row or, on a windowed list, the overflow line
+     * directly under its last row, which is `below`-marked or the cursor row. A COMPLETE dialog's rows are full picker rows
+     * (`1. Label  Description`); while a candidate is still painting, a numbered row whose
+     * description has not arrived yet counts too, so the shell keeps holding input. Anything
+     * else — a renumbered second list, a row after the window ended, a scroll marker the
+     * CLI's grammar does not define — is not this dialog's.
+     */
+    accept(line) {
+        const mayBeOverflow = this.overflowMayFollow;
+        this.overflowMayFollow = false;
+        if (mayBeOverflow && this.scroll?.overflow.test(line) === true) {
+            this.windowEnded = true;
+            return true;
+        }
+        const row = unmarkedRow(line, this.scroll);
+        if (this.windowEnded || !this.isRow(line, row))
+            return false;
+        this.rowCount += 1;
+        this.nextRowNumber = Number(numberedRow.exec(row)?.[1]) + 1;
+        this.windowEnded = this.scroll?.below.test(line) === true;
+        if (caretRow.test(row))
+            this.cursorCount += 1;
+        this.overflowMayFollow = overflowMayFollowRow(line, this.scroll);
+        return true;
+    }
+    /**
+     * Whether `row` (`line` with any scroll marker blanked) is the block's next row. Only the
+     * FIRST row may be numbered past 1, and only under an `above` marker: a window scrolled
+     * down hides the rows above it, but an unmarked list that starts at 3 is someone else's,
+     * and an `above` marker below the first row is not a window.
+     */
+    isRow(line, row) {
+        if (!(rowPattern.test(row) || (!this.complete && numberedRow.test(row))))
+            return false;
+        const number = Number(numberedRow.exec(row)?.[1]);
+        // A number that rounds is not the row the CLI drew, and rows that round together would
+        // pass for consecutive ones.
+        if (!Number.isSafeInteger(number))
+            return false;
+        if (this.scroll?.above.test(line) === true)
+            return this.rowCount === 0 && number > 1;
+        return number === this.nextRowNumber;
+    }
+}
+//# sourceMappingURL=row-block.js.map

package/dist/core/models/row-block.js.map

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

package/dist/core/models/rows.d.ts

@@ -3,6 +3,7 @@
  * model dialog only as the bottom-most native region of the viewport.
  * Implements PRD §5.3 AgentModelOption, C-API-23, and C-API-24.
  */
+import { type ScrollGrammar } from "./row-block.ts";
 export type AgentModelOption = {
     readonly id: string;
     readonly label: string;
@@ -11,16 +12,44 @@ export type AgentModelOption = {
     readonly isDefault: boolean;
     readonly raw: string;
 };
+/**
+ * One rendered option row. `absoluteRowNumber` is the row's 1-based position in the WHOLE
+ * list, as the CLI numbers it: a scrolled window keeps it, so `↑ 3.` is the third model even
+ * as the first row on screen.
+ */
+export type PickerRow = {
+    readonly absoluteRowNumber: number;
+    readonly option: AgentModelOption;
+};
 export type ParsedModelPicker = {
+    readonly rows: readonly PickerRow[];
+    /** Each row's option, in the same order as `rows`. */
     readonly options: readonly AgentModelOption[];
-    readonly cursorIndex: number;
+    /** Index into `rows` and `options` of the highlighted row; -1 while none is painted. */
+    readonly cursorOptionIndex: number;
+    /**
+     * How many rows the window hides below its last rendered row: 0 when the window reaches
+     * the end of the list, the overflow line's count when one is drawn, and undefined when
+     * the window marks rows hidden below without a positive count, so the length is unknown.
+     */
+    readonly hiddenRowCountBelow: number | undefined;
 };
 export declare const claudeModelPickerHeader: RegExp;
 export declare const codexModelPickerHeader: RegExp;
+/** `1. Label  Description`, capturing the cursor glyph, absolute row number, label and description. */
 export declare const rowPattern: RegExp;
-export declare function parseClaudeModelPicker(text: string): ParsedModelPicker;
+/**
+ * Claude's rendered rows. Under `scroll`, a row wearing a scroll marker (`↓ 10.`) is an
+ * ordinary option; its `raw` keeps the marker as rendered.
+ */
+export declare function parseClaudeModelPicker(text: string, scroll?: ScrollGrammar): ParsedModelPicker;
+/**
+ * Rendered markers only. Codex 0.164 draws `(current)` and never `(default)`, so a lone
+ * `(current)` says nothing about the default; the Codex spec marks it from config.toml.
+ */
 export declare function parseCodexModelPicker(text: string): ParsedModelPicker;
-export { bottomDialogCandidate, bottomDialogRow } from "./dialog-region.ts";
+export { bottomDialogCandidate, bottomDialogRow, type DialogGrammar } from "./dialog-region.ts";
+export type { ScrollGrammar } from "./row-block.ts";
 /**
  * The picker itself, the stage an accepted row opens (reasoning level, cache warning),
  * or a dialog shell still `painting`: it holds input but is never sent a key.

package/dist/core/models/rows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../src/core/models/rows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AACtD,eAAO,MAAM,sBAAsB,QAA4B,CAAC;AAEhE,eAAO,MAAM,UAAU,QAAgD,CAAC;AAExE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAUtE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAarE;AAoBD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE5E;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAEnE;;;;;;;;;;;;;;;;;GAiBG;AACH;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,oBAAuC,CAAC;AAEnE,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,CAAC"}
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../src/core/models/rows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAwB,KAAK,aAAa,EAAe,MAAM,gBAAgB,CAAC;AAEvF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IACpC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,wFAAwF;IACxF,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CAClD,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AACtD,eAAO,MAAM,sBAAsB,QAA4B,CAAC;AAEhE,uGAAuG;AACvG,eAAO,MAAM,UAAU,QAAkD,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAU9F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAOrE;AA+CD,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChG,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAEnE;;;;;;;;;;;;;;;;;GAiBG;AACH;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,oBAAuC,CAAC;AAEnE,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,CAAC"}

package/dist/core/models/rows.js

@@ -3,11 +3,17 @@
  * model dialog only as the bottom-most native region of the viewport.
  * Implements PRD §5.3 AgentModelOption, C-API-23, and C-API-24.
  */
+import { overflowMayFollowRow, unmarkedRow } from "./row-block.js";
 export const claudeModelPickerHeader = /Select model/;
 export const codexModelPickerHeader = /Select Model and Effort/;
-export const rowPattern = /^\s*(❯|›)?\s*\d+\.\s+(.+?)\s{2,}(\S.*?)\s*$/;
-export function parseClaudeModelPicker(text) {
-    return parseRows(pickerRegion(text, claudeModelPickerHeader), (labelText) => {
+/** `1. Label  Description`, capturing the cursor glyph, absolute row number, label and description. */
+export const rowPattern = /^\s*(❯|›)?\s*(\d+)\.\s+(.+?)\s{2,}(\S.*?)\s*$/;
+/**
+ * Claude's rendered rows. Under `scroll`, a row wearing a scroll marker (`↓ 10.`) is an
+ * ordinary option; its `raw` keeps the marker as rendered.
+ */
+export function parseClaudeModelPicker(text, scroll) {
+    return parseRows(pickerRegion(text, claudeModelPickerHeader), scroll, (labelText) => {
         const isCurrent = labelText.includes("✔");
         const isDefault = /\(recommended\)/i.test(labelText);
         const label = labelText
@@ -17,35 +23,57 @@ export function parseClaudeModelPicker(text) {
         return { label, id: label.toLowerCase(), isCurrent, isDefault };
     });
 }
+/**
+ * Rendered markers only. Codex 0.164 draws `(current)` and never `(default)`, so a lone
+ * `(current)` says nothing about the default; the Codex spec marks it from config.toml.
+ */
 export function parseCodexModelPicker(text) {
-    const parsed = parseRows(pickerRegion(text, codexModelPickerHeader), (labelText) => {
+    return parseRows(pickerRegion(text, codexModelPickerHeader), undefined, (labelText) => {
         const isCurrent = /\(current\)/i.test(labelText);
         const isDefault = /\(default\)/i.test(labelText);
         const label = labelText.replace(/\((?:current|default)\)/gi, "").trim();
         return { label, id: label.toLowerCase(), isCurrent, isDefault };
     });
-    // Codex omits the default marker when the current model is the default.
-    if (parsed.options.some((option) => option.isDefault))
-        return parsed;
-    const options = parsed.options.map((option) => option.isCurrent ? { ...option, isDefault: true } : option);
-    return { options, cursorIndex: parsed.cursorIndex };
 }
-function parseRows(region, decorate) {
-    const options = [];
-    let cursorIndex = -1;
+function parseRows(region, scroll, decorate) {
+    const rows = [];
+    let cursorOptionIndex = -1;
+    let hiddenRowCountBelow = 0;
+    // As in the region grammar, a count is read only from the line directly under a row
+    // `overflowMayFollowRow` allows; an overflow line anywhere else leaves the length unknown.
+    let overflowMayFollow = false;
     for (const line of region.split("\n")) {
-        const match = rowPattern.exec(line);
-        if (!match)
+        const mayBeOverflow = overflowMayFollow;
+        overflowMayFollow = false;
+        const overflow = scroll?.overflow.exec(line);
+        if (overflow)
+            hiddenRowCountBelow = mayBeOverflow ? positiveCount(overflow.groups?.["hidden"]) : undefined;
+        const match = rowPattern.exec(unmarkedRow(line, scroll));
+        const absoluteRowNumber = Number(match?.[2]);
+        // As in the region grammar, a number that rounds is not the row the CLI drew.
+        if (!(match && Number.isSafeInteger(absoluteRowNumber)))
             continue;
         if (match[1])
-            cursorIndex = options.length;
-        options.push({
-            ...decorate(match[2]),
-            description: match[3],
-            raw: line.trim(),
+            cursorOptionIndex = rows.length;
+        // A `below` marker says rows are hidden; only the overflow line under it says how many.
+        if (scroll?.below.test(line) === true)
+            hiddenRowCountBelow = undefined;
+        overflowMayFollow = overflowMayFollowRow(line, scroll);
+        rows.push({
+            absoluteRowNumber,
+            option: {
+                ...decorate(match[3]),
+                description: match[4],
+                raw: line.trim(),
+            },
         });
     }
-    return { options, cursorIndex };
+    return { rows, options: rows.map((row) => row.option), cursorOptionIndex, hiddenRowCountBelow };
+}
+/** The rendered hidden-row count, returned only when it is a positive, exactly representable integer. */
+function positiveCount(text) {
+    const count = Number(text);
+    return Number.isSafeInteger(count) && count > 0 ? count : undefined;
 }
 export { bottomDialogCandidate, bottomDialogRow } from "./dialog-region.js";
 /**