gaunt-sloth 2.0.0-alpha.2 → 2.0.0-alpha.21

package/dist/tui/components/PromptInput.js

@@ -1,16 +1,102 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from 'react';
-import { Box, Text } from 'ink';
+import { useEffect, useState } from 'react';
+import { Box, Text, useInput, usePaste } from 'ink';
 import TextInput from 'ink-text-input';
+import { SlashCommandMenu } from '#src/tui/components/SlashCommandMenu.js';
+import { filterSlashCommands, slashMenuQuery } from '#src/tui/slashCommands.js';
+import { normalizePastedText } from '#src/tui/pasteParser.js';
 /**
  * The user prompt line. Mirrors the readline `  > ` prompt. Clears on submit; the parent
  * hides it while a turn is running so Ink owns stdin uncontended during streaming.
+ *
+ * TUI-C10 — while the user is typing a bare slash command (input starts with `/`, no space yet),
+ * a discovery menu of the matching registered commands appears just above the prompt. The registry
+ * (`commands`) is the single source, so extension-registered commands show automatically. Arrow
+ * keys move the highlight, Tab completes the highlighted name, Enter dispatches it, Esc dismisses
+ * the menu. The keyboard split is clean: `ink-text-input` ignores Up/Down/Tab and only fires
+ * `onSubmit` on Enter, so this component's `useInput` owns the arrows/Tab/Esc while `onSubmit` owns
+ * Enter — no double-handling. A fully-typed command still dispatches exactly as before (Enter with
+ * the menu open just submits the highlighted command, which equals what was typed).
+ *
+ * TUI-C24 — multiline paste. `ink-text-input` is single-line: an embedded newline in a pasted
+ * burst would otherwise be read as Enter and submit the turn mid-paste (or jam the lines together).
+ * `usePaste` puts the terminal into bracketed-paste mode (`\x1b[?2004h`) while the prompt is mounted
+ * and disables it on unmount, and Ink delivers the pasted text on a channel separate from
+ * `useInput` — so the payload never reaches `TextInput`'s Enter handling. We append the normalized
+ * paste (CRLF/CR → `\n`) to the buffer without submitting; a subsequent explicit Enter submits the
+ * whole multi-line value through the existing `onSubmit` path. Rich multi-line cursor editing /
+ * continuation-line rendering is intentionally NOT handled here — that is node TUI-C25; a buffered
+ * multi-line value may render imperfectly, but the submitted value is correct and intact.
  */
-export function PromptInput({ onSubmit, }) {
+export function PromptInput({ onSubmit, commands = [], onMenuStateChange, }) {
     const [value, setValue] = useState('');
-    return (_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: '  > ' }), _jsx(TextInput, { value: value, onChange: setValue, onSubmit: (submitted) => {
-                    setValue('');
-                    onSubmit(submitted);
-                } })] }));
+    // Highlighted row in the menu. Reset to the top whenever the query changes (the filtered list
+    // changes under it), so navigation always starts from the most-relevant match.
+    const [cursor, setCursor] = useState(0);
+    // Esc dismisses the menu without clearing the input; typing anything re-opens it (onChange
+    // clears this flag), matching how palette menus behave elsewhere.
+    const [dismissed, setDismissed] = useState(false);
+    const query = slashMenuQuery(value);
+    const matches = query !== null && !dismissed ? filterSlashCommands(commands, query) : [];
+    const menuActive = matches.length > 0;
+    // Clamp defensively in case the filtered list shrank below the cursor between renders.
+    const selectedIndex = menuActive ? Math.min(cursor, matches.length - 1) : 0;
+    // Let the parent suppress its competing Tab handler (debug-panel focus) while the menu is open.
+    useEffect(() => {
+        onMenuStateChange?.(menuActive);
+    }, [menuActive, onMenuStateChange]);
+    // TUI-C24 — capture a bracketed paste as buffered text instead of keystrokes. Ink enables
+    // bracketed-paste mode while this hook is mounted and routes the pasted payload here (off the
+    // `useInput` channel), so its embedded newlines never reach TextInput's Enter handling. We append
+    // the normalized paste to the buffer and do NOT submit — a later explicit Enter submits it all.
+    // (Appending, rather than inserting at TextInput's internal cursor, is deliberate: multi-line
+    // cursor editing is TUI-C25's scope; the submitted value stays correct and intact.)
+    usePaste((text) => {
+        const pasted = normalizePastedText(text);
+        if (!pasted)
+            return;
+        setValue((current) => current + pasted);
+        // Mirror onChange's menu bookkeeping so a paste can't leave a stale/incorrectly-open menu.
+        setDismissed(false);
+        setCursor(0);
+    });
+    useInput((_input, key) => {
+        // Only claim keys while the menu is visible; otherwise TextInput handles everything.
+        if (!menuActive)
+            return;
+        if (key.upArrow) {
+            setCursor((c) => (Math.min(c, matches.length - 1) - 1 + matches.length) % matches.length);
+        }
+        else if (key.downArrow) {
+            setCursor((c) => (Math.min(c, matches.length - 1) + 1) % matches.length);
+        }
+        else if (key.tab) {
+            // Complete to the highlighted name plus a trailing space: the space closes the menu (the
+            // input now has whitespace) and leaves the cursor ready for args, without dispatching.
+            setValue(`/${matches[selectedIndex].name} `);
+            setDismissed(false);
+            setCursor(0);
+        }
+        else if (key.escape) {
+            setDismissed(true);
+        }
+        // Enter is intentionally NOT handled here — TextInput's onSubmit owns it (see onSubmit).
+    }, 
+    // Active only while the prompt is mounted; harmless when the menu is closed (early return).
+    { isActive: true });
+    return (_jsxs(Box, { flexDirection: "column", children: [menuActive ? _jsx(SlashCommandMenu, { commands: matches, selectedIndex: selectedIndex }) : null, _jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: '  > ' }), _jsx(TextInput, { value: value, onChange: (next) => {
+                            setValue(next);
+                            setDismissed(false);
+                            setCursor(0);
+                        }, onSubmit: (submitted) => {
+                            // With the menu open, Enter dispatches the HIGHLIGHTED command (so "/mo"+Enter runs
+                            // "/mode"); otherwise submit exactly what was typed. Either way the parent's handler
+                            // parses + dispatches through the registry, so fully-typed dispatch is unchanged.
+                            const toSubmit = menuActive ? `/${matches[selectedIndex].name}` : submitted;
+                            setValue('');
+                            setDismissed(false);
+                            setCursor(0);
+                            onSubmit(toSubmit);
+                        } })] })] }));
 }
 //# sourceMappingURL=PromptInput.js.map

package/dist/tui/components/PromptInput.js.map

@@ -1 +1 @@
-{"version":3,"file":"PromptInput.js","sourceRoot":"","sources":["../../../src/tui/components/PromptInput.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,QAAQ,GAGT;IACC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IACvC,OAAO,CACL,MAAC,GAAG,eACF,KAAC,IAAI,IAAC,KAAK,EAAC,MAAM,YAAE,MAAM,GAAQ,EAClC,KAAC,SAAS,IACR,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,CAAC,SAAS,EAAE,EAAE;oBACtB,QAAQ,CAAC,EAAE,CAAC,CAAC;oBACb,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACtB,CAAC,GACD,IACE,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"PromptInput.js","sourceRoot":"","sources":["../../../src/tui/components/PromptInput.tsx"],"names":[],"mappings":"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"}

package/dist/tui/components/Rule.js.map

@@ -1 +1 @@
-{"version":3,"file":"Rule.js","sourceRoot":"","sources":["../../../src/tui/components/Rule.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAEtC,uEAAuE;AACvE,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,oFAAoF;AACpF,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAA2B;IACnD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;IACjG,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAC,EAAE,KAAK,KAAyB,EAAE;IACrD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IAC/B,mFAAmF;IACnF,oFAAoF;IACpF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAqB,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,mFAAmF;QACnF,QAAQ,EAAE,CAAC;QACX,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC;IAC1C,OAAO,KAAC,IAAI,IAAC,QAAQ,kBAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAQ,CAAC;AACnD,CAAC"}
+{"version":3,"file":"Rule.js","sourceRoot":"","sources":["../../../src/tui/components/Rule.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAEtC,uEAAuE;AACvE,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,oFAAoF;AACpF,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAA2B;IACnD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;IACjG,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAC,EAAE,KAAK,EAAE,GAAuB,EAAE;IACrD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IAC/B,mFAAmF;IACnF,oFAAoF;IACpF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAqB,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxD,mFAAmF;QACnF,QAAQ,EAAE,CAAC;QACX,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,IAAI,OAAO,CAAC,CAAC;IAC1C,OAAO,KAAC,IAAI,IAAC,QAAQ,kBAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,GAAQ,CAAC;AACnD,CAAC"}

package/dist/tui/components/SelectList.d.ts

@@ -3,23 +3,112 @@ export interface SelectItem {
     /** The text shown for this row. */
     label: string;
 }
+/**
+ * CFG-20 — the pure "does this row match the typed filter?" predicate: a case-insensitive
+ * substring test on the row label (the model id, with its ⭐/padding prefix — a substring
+ * match on the id still hits). The raw substring test; query trimming is done once by the
+ * callers ({@link filteredItemIndices} / {@link filterSelectItems}), not here.
+ */
+export declare function matchesFilter(label: string, query: string): boolean;
+/**
+ * CFG-20 — **the single production filter path**: the absolute indices (into `items`) of the rows
+ * whose label matches `query`, in source order. The query is trimmed, so a leading/trailing space
+ * filters like the trimmed text and an all-whitespace query is treated as "no filter" (all rows).
+ * The widget's live filter calls exactly this (see the `filteredIndices` memo below), and
+ * {@link filterSelectItems} is a thin view over it — so a unit test can never validate a matcher
+ * the widget doesn't actually run. Indices (not items) so the widget can map a filtered-view
+ * selection back to the original absolute index even if two labels were to coincide.
+ */
+export declare function filteredItemIndices(items: SelectItem[], query: string): number[];
+/**
+ * CFG-20 — the items (not indices) surviving the filter, in source order: a thin view over the
+ * production {@link filteredItemIndices}, so it can never diverge from the widget's live filter.
+ * Mirrors the shape of TUI-C10's `filterSlashCommands` (pure, case-insensitive, empty/whitespace
+ * query returns the full list) but deliberately does NOT re-rank prefix-before-substring: the
+ * model list arrives already ordered ⭐ preferred-first then alphabetical (CFG-14), and that order
+ * must be preserved within the filtered set, so the source order is kept rather than bucketed.
+ */
+export declare function filterSelectItems(items: SelectItem[], query: string): SelectItem[];
+/**
+ * Derive how many option rows the scrolling window may show at once from the live terminal
+ * height. Ink/Node leaves `rows` `undefined` when not attached to a TTY (and in tests), in
+ * which case we fall back to {@link DEFAULT_WINDOW}. Always at least 1 so a tiny / mis-reported
+ * terminal can never collapse the window to zero.
+ */
+export declare function windowSize(rows: number | undefined): number;
+/**
+ * Standard "keep the cursor in view" windowing. Given the previous window start, the current
+ * cursor index, the window `size` and total item `count`, return the window start that keeps
+ * `cursor` visible while moving as little as possible (sticky: the window only shifts when the
+ * cursor crosses an edge). Clamped to `[0, count - size]` so it never scrolls past either end,
+ * which also makes wraparound (cursor jumping to the far end) resolve to that end cleanly.
+ */
+export declare function clampWindowStart(prevStart: number, cursor: number, size: number, count: number): number;
 /**
  * CFG-11 — a minimal arrow-key + Enter selectable list for the first-run dialog. Up/Down
- * (and k/j) move the highlight, Enter confirms. It deliberately has no number-typing path:
- * the readline number menu remains the non-TTY fallback, this is the keyboard-driven TUI one.
+ * move the highlight, Enter confirms.
+ *
+ * CFG-15 — the list renders within a bounded, scrolling viewport so a long option list (e.g.
+ * openrouter's discovered model list) never overflows the terminal. At most a window's worth of
+ * rows is shown; the window scrolls to keep the highlighted row in view, and dim `↑ N more` /
+ * `↓ N more` affordances signal hidden items above / below.
+ *
+ * CFG-20 — **type-to-filter**: typing letters incrementally filters the list (case-insensitive
+ * substring on the label — see {@link matchesFilter}), so a 200+-model catalog is reachable by
+ * typing a few chars instead of scrolling. Backspace edits the filter; Esc clears it (a second
+ * Esc, with the filter already empty, aborts — see `onCancel`). The filtered set keeps the source
+ * order (⭐ preferred-first then alphabetical). Because letters now feed the filter, the old j/k
+ * vim-nav shortcuts are gone — the arrow keys remain the movement keys.
+ *
+ * CFG-20 — **abort**: Ctrl+C (always) and Esc-on-empty-filter invoke `onCancel`, which the
+ * `runInkSelect` host turns into a {@link SelectCancelledError} so the dialog can abort without
+ * writing a config. Enter, Ctrl+C and Esc are handled as three DISTINCT keys (the previous
+ * default-`exitOnCtrlC` behaviour silently collapsed Ctrl+C into "selected the default").
  *
- * `onSelect` is called once with the chosen index; the caller is responsible for unmounting
- * (the default `runInkSelect` host calls `useApp().exit()` via `onSelect`).
+ * `onSelect` is called once with the chosen **absolute** index into `items` (never the
+ * filtered-view position); the caller is responsible for unmounting (the default `runInkSelect`
+ * host calls `useApp().exit()` via `onSelect`/`onCancel`).
  */
-export declare function SelectList({ title, items, initialIndex, onSelect, }: {
+export declare function SelectList({ title, items, initialIndex, onSelect, onCancel, viewportRows, }: {
     title: string;
     items: SelectItem[];
     initialIndex?: number;
     onSelect: (index: number) => void;
+    /**
+     * CFG-20 — called when the user aborts the selection (Ctrl+C, or Esc with an empty filter).
+     * Optional so a bare `<SelectList>` (e.g. in a render test) can omit it; `runInkSelect` always
+     * supplies it.
+     */
+    onCancel?: () => void;
+    /**
+     * Explicit window height override, mainly for tests. When omitted the window is derived from
+     * the live terminal height via {@link windowSize}.
+     */
+    viewportRows?: number;
 }): React.ReactElement;
 /**
- * Renders {@link SelectList} with Ink and resolves with the chosen index. Imports `ink`
- * dynamically so this module never pulls Ink into a readline-only run. Intended to be used
- * only after the caller has confirmed an interactive TTY + Ink availability.
+ * The subset of Ink's `render` that {@link runInkSelect} relies on: mount a node and expose a
+ * promise that settles when the app exits. Declared as a seam so a test can inject a fake-stream
+ * renderer and drive the real Ctrl+C→reject / Enter→resolve wire without a live TTY (the default
+ * dynamic-`import('ink')` path is otherwise un-unit-testable, since Ink's `useInput` needs raw mode).
+ */
+export type InkRenderFn = (node: React.ReactElement, options?: {
+    exitOnCtrlC?: boolean;
+}) => {
+    waitUntilExit: () => Promise<unknown>;
+};
+/**
+ * Renders {@link SelectList} with Ink and resolves with the chosen absolute index — or **rejects
+ * with a {@link SelectCancelledError}** when the user aborts (Ctrl+C, or Esc with an empty
+ * filter). Imports `ink` dynamically (unless a `render` is injected) so this module never pulls
+ * Ink into a readline-only run. Intended to be used only after the caller has confirmed an
+ * interactive TTY + Ink availability.
+ *
+ * `exitOnCtrlC: false` — Ink's default would unmount on Ctrl+C and let `waitUntilExit()` resolve
+ * normally, so the host would `resolve(chosen)` with the untouched default index (the CFG-20 bug:
+ * Ctrl+C read as "picked the default"). We own Ctrl+C in {@link SelectList} instead and route it
+ * to the reject path.
+ *
+ * @param render - injectable Ink renderer (defaults to Ink's `render`); for tests only.
  */
-export declare function runInkSelect(title: string, items: SelectItem[], initialIndex?: number): Promise<number>;
+export declare function runInkSelect(title: string, items: SelectItem[], initialIndex?: number, render?: InkRenderFn): Promise<number>;

package/dist/tui/components/SelectList.js

@@ -1,50 +1,233 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from 'react';
-import { Box, Text, useApp, useInput } from 'ink';
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from 'react';
+import { Box, Text, useApp, useInput, useStdout } from 'ink';
+import { SelectCancelledError } from '#src/tui/selectCancelled.js';
+/**
+ * CFG-20 — the pure "does this row match the typed filter?" predicate: a case-insensitive
+ * substring test on the row label (the model id, with its ⭐/padding prefix — a substring
+ * match on the id still hits). The raw substring test; query trimming is done once by the
+ * callers ({@link filteredItemIndices} / {@link filterSelectItems}), not here.
+ */
+export function matchesFilter(label, query) {
+    return label.toLowerCase().includes(query.toLowerCase());
+}
+/**
+ * CFG-20 — **the single production filter path**: the absolute indices (into `items`) of the rows
+ * whose label matches `query`, in source order. The query is trimmed, so a leading/trailing space
+ * filters like the trimmed text and an all-whitespace query is treated as "no filter" (all rows).
+ * The widget's live filter calls exactly this (see the `filteredIndices` memo below), and
+ * {@link filterSelectItems} is a thin view over it — so a unit test can never validate a matcher
+ * the widget doesn't actually run. Indices (not items) so the widget can map a filtered-view
+ * selection back to the original absolute index even if two labels were to coincide.
+ */
+export function filteredItemIndices(items, query) {
+    const q = query.trim();
+    const indices = [];
+    items.forEach((item, i) => {
+        if (!q || matchesFilter(item.label, q))
+            indices.push(i);
+    });
+    return indices;
+}
+/**
+ * CFG-20 — the items (not indices) surviving the filter, in source order: a thin view over the
+ * production {@link filteredItemIndices}, so it can never diverge from the widget's live filter.
+ * Mirrors the shape of TUI-C10's `filterSlashCommands` (pure, case-insensitive, empty/whitespace
+ * query returns the full list) but deliberately does NOT re-rank prefix-before-substring: the
+ * model list arrives already ordered ⭐ preferred-first then alphabetical (CFG-14), and that order
+ * must be preserved within the filtered set, so the source order is kept rather than bucketed.
+ */
+export function filterSelectItems(items, query) {
+    return filteredItemIndices(items, query).map((i) => items[i]);
+}
+/** Window size used when the terminal height is unknown (non-TTY / tests). */
+const DEFAULT_WINDOW = 10;
+/**
+ * Rows reserved from the terminal height for chrome around the option window: the title line
+ * plus the two `↑ / ↓ N more` affordance lines, with one line of breathing room. The rest of
+ * the terminal is given to visible options.
+ */
+const RESERVED_ROWS = 4;
+/**
+ * Derive how many option rows the scrolling window may show at once from the live terminal
+ * height. Ink/Node leaves `rows` `undefined` when not attached to a TTY (and in tests), in
+ * which case we fall back to {@link DEFAULT_WINDOW}. Always at least 1 so a tiny / mis-reported
+ * terminal can never collapse the window to zero.
+ */
+export function windowSize(rows) {
+    if (typeof rows === 'number' && Number.isFinite(rows)) {
+        return Math.max(1, Math.floor(rows) - RESERVED_ROWS);
+    }
+    return DEFAULT_WINDOW;
+}
+/**
+ * Standard "keep the cursor in view" windowing. Given the previous window start, the current
+ * cursor index, the window `size` and total item `count`, return the window start that keeps
+ * `cursor` visible while moving as little as possible (sticky: the window only shifts when the
+ * cursor crosses an edge). Clamped to `[0, count - size]` so it never scrolls past either end,
+ * which also makes wraparound (cursor jumping to the far end) resolve to that end cleanly.
+ */
+export function clampWindowStart(prevStart, cursor, size, count) {
+    const maxStart = Math.max(0, count - size);
+    let start = Math.min(Math.max(0, prevStart), maxStart);
+    if (cursor < start) {
+        start = cursor;
+    }
+    else if (cursor >= start + size) {
+        start = cursor - size + 1;
+    }
+    return Math.max(0, Math.min(start, maxStart));
+}
 /**
  * CFG-11 — a minimal arrow-key + Enter selectable list for the first-run dialog. Up/Down
- * (and k/j) move the highlight, Enter confirms. It deliberately has no number-typing path:
- * the readline number menu remains the non-TTY fallback, this is the keyboard-driven TUI one.
+ * move the highlight, Enter confirms.
+ *
+ * CFG-15 — the list renders within a bounded, scrolling viewport so a long option list (e.g.
+ * openrouter's discovered model list) never overflows the terminal. At most a window's worth of
+ * rows is shown; the window scrolls to keep the highlighted row in view, and dim `↑ N more` /
+ * `↓ N more` affordances signal hidden items above / below.
  *
- * `onSelect` is called once with the chosen index; the caller is responsible for unmounting
- * (the default `runInkSelect` host calls `useApp().exit()` via `onSelect`).
+ * CFG-20 — **type-to-filter**: typing letters incrementally filters the list (case-insensitive
+ * substring on the label — see {@link matchesFilter}), so a 200+-model catalog is reachable by
+ * typing a few chars instead of scrolling. Backspace edits the filter; Esc clears it (a second
+ * Esc, with the filter already empty, aborts — see `onCancel`). The filtered set keeps the source
+ * order (⭐ preferred-first then alphabetical). Because letters now feed the filter, the old j/k
+ * vim-nav shortcuts are gone — the arrow keys remain the movement keys.
+ *
+ * CFG-20 — **abort**: Ctrl+C (always) and Esc-on-empty-filter invoke `onCancel`, which the
+ * `runInkSelect` host turns into a {@link SelectCancelledError} so the dialog can abort without
+ * writing a config. Enter, Ctrl+C and Esc are handled as three DISTINCT keys (the previous
+ * default-`exitOnCtrlC` behaviour silently collapsed Ctrl+C into "selected the default").
+ *
+ * `onSelect` is called once with the chosen **absolute** index into `items` (never the
+ * filtered-view position); the caller is responsible for unmounting (the default `runInkSelect`
+ * host calls `useApp().exit()` via `onSelect`/`onCancel`).
  */
-export function SelectList({ title, items, initialIndex = 0, onSelect, }) {
+export function SelectList({ title, items, initialIndex = 0, onSelect, onCancel, viewportRows, }) {
+    const { stdout } = useStdout();
+    // CFG-20 — the active type-to-filter query. Empty = show everything.
+    const [filter, setFilter] = useState('');
+    // `cursor` is a position within the CURRENT filtered view, not an absolute index. With an empty
+    // filter the view is the identity of `items`, so the initial cursor is the caller's preferred
+    // default (initialIndex); a filter reset the cursor to the top of the narrowed set (below).
     const [cursor, setCursor] = useState(initialIndex >= 0 && initialIndex < items.length ? initialIndex : 0);
+    const [windowStart, setWindowStart] = useState(0);
+    // Track the live terminal height in state and refresh it on resize, so the window resizes
+    // with the terminal (mirrors the resize-aware pattern in Rule.tsx).
+    const [rows, setRows] = useState(stdout?.rows);
+    useEffect(() => {
+        if (!stdout)
+            return;
+        const onResize = () => setRows(stdout.rows);
+        onResize();
+        stdout.on('resize', onResize);
+        return () => {
+            stdout.off('resize', onResize);
+        };
+    }, [stdout]);
+    // The absolute indices of the rows that survive the current filter, in source order. Selection
+    // maps back through this array so `onSelect` always reports the original index into `items`. This
+    // is THE filter path — the same trimmed predicate the unit tests exercise via filterSelectItems.
+    const filteredIndices = useMemo(() => filteredItemIndices(items, filter), [items, filter]);
+    const count = filteredIndices.length;
+    // Re-filter the list from the current query, resetting the cursor to the top of the narrowed set.
+    const applyFilter = (next) => {
+        setFilter(next);
+        setCursor(0);
+    };
     useInput((input, key) => {
-        if (key.upArrow || input === 'k') {
-            setCursor((c) => (c - 1 + items.length) % items.length);
+        // Ctrl+C is an unconditional abort (SIGINT semantics), regardless of any typed filter.
+        if (key.ctrl && input === 'c') {
+            onCancel?.();
+            return;
         }
-        else if (key.downArrow || input === 'j') {
-            setCursor((c) => (c + 1) % items.length);
+        if (key.return) {
+            // Only confirm when the filtered set is non-empty (nothing to pick under a no-match filter).
+            if (count > 0)
+                onSelect(filteredIndices[cursor]);
+            return;
         }
-        else if (key.return) {
-            onSelect(cursor);
+        if (key.escape) {
+            // First Esc clears an active filter; a second Esc (empty filter) aborts.
+            if (filter)
+                applyFilter('');
+            else
+                onCancel?.();
+            return;
+        }
+        if (key.upArrow) {
+            if (count > 0)
+                setCursor((c) => (c - 1 + count) % count);
+            return;
+        }
+        if (key.downArrow) {
+            if (count > 0)
+                setCursor((c) => (c + 1) % count);
+            return;
+        }
+        if (key.backspace || key.delete) {
+            if (filter)
+                applyFilter(filter.slice(0, -1));
+            return;
+        }
+        // Any other printable, non-modified key extends the filter. Guard against control/meta combos
+        // and non-printable input (arrows/return/etc. are handled above and arrive with empty `input`).
+        if (input && !key.ctrl && !key.meta && !/[\x00-\x1f]/.test(input)) {
+            applyFilter(filter + input);
         }
     });
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: title }), items.map((item, index) => {
-                const selected = index === cursor;
-                return (_jsxs(Text, { color: selected ? 'cyan' : undefined, children: [selected ? '❯ ' : '  ', item.label] }, index));
-            })] }));
+    const size = typeof viewportRows === 'number' ? Math.max(1, viewportRows) : windowSize(rows);
+    // Derive the display window from the remembered start + current cursor. Computing it in render
+    // keeps the window valid even when the cursor jumps (wraparound), the filter narrows the list,
+    // or the terminal resizes.
+    const start = clampWindowStart(windowStart, cursor, size, count);
+    // Persist the derived start so the window stays sticky across moves (converges in one pass).
+    useEffect(() => {
+        if (start !== windowStart)
+            setWindowStart(start);
+    }, [start, windowStart]);
+    const visibleIndices = filteredIndices.slice(start, start + size);
+    const hiddenAbove = start;
+    const hiddenBelow = count - (start + visibleIndices.length);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: title }), filter ? _jsx(Text, { dimColor: true, children: `  filter: ${filter}` }) : null, count === 0 ? (_jsx(Text, { dimColor: true, children: `  (no matches for "${filter}")` })) : (_jsxs(_Fragment, { children: [hiddenAbove > 0 ? _jsx(Text, { dimColor: true, children: `  ↑ ${hiddenAbove} more` }) : null, visibleIndices.map((absoluteIndex, i) => {
+                        const selected = start + i === cursor;
+                        return (_jsxs(Text, { color: selected ? 'cyan' : undefined, children: [selected ? '❯ ' : '  ', items[absoluteIndex].label] }, absoluteIndex));
+                    }), hiddenBelow > 0 ? _jsx(Text, { dimColor: true, children: `  ↓ ${hiddenBelow} more` }) : null] }))] }));
 }
 /**
- * Renders {@link SelectList} with Ink and resolves with the chosen index. Imports `ink`
- * dynamically so this module never pulls Ink into a readline-only run. Intended to be used
- * only after the caller has confirmed an interactive TTY + Ink availability.
+ * Renders {@link SelectList} with Ink and resolves with the chosen absolute index — or **rejects
+ * with a {@link SelectCancelledError}** when the user aborts (Ctrl+C, or Esc with an empty
+ * filter). Imports `ink` dynamically (unless a `render` is injected) so this module never pulls
+ * Ink into a readline-only run. Intended to be used only after the caller has confirmed an
+ * interactive TTY + Ink availability.
+ *
+ * `exitOnCtrlC: false` — Ink's default would unmount on Ctrl+C and let `waitUntilExit()` resolve
+ * normally, so the host would `resolve(chosen)` with the untouched default index (the CFG-20 bug:
+ * Ctrl+C read as "picked the default"). We own Ctrl+C in {@link SelectList} instead and route it
+ * to the reject path.
+ *
+ * @param render - injectable Ink renderer (defaults to Ink's `render`); for tests only.
  */
-export async function runInkSelect(title, items, initialIndex = 0) {
-    const { render } = await import('ink');
-    return await new Promise((resolve) => {
+export async function runInkSelect(title, items, initialIndex = 0, render) {
+    const renderFn = render ?? (await import('ink')).render;
+    return await new Promise((resolve, reject) => {
         let chosen = initialIndex;
+        let cancelled = false;
         const Host = () => {
             const { exit } = useApp();
             return (_jsx(SelectList, { title: title, items: items, initialIndex: initialIndex, onSelect: (index) => {
                     chosen = index;
                     exit();
+                }, onCancel: () => {
+                    cancelled = true;
+                    exit();
                 } }));
         };
-        const instance = render(_jsx(Host, {}));
-        instance.waitUntilExit().then(() => resolve(chosen));
+        // Own Ctrl+C ourselves (see the doc comment) rather than letting Ink silently unmount.
+        const instance = renderFn(_jsx(Host, {}), { exitOnCtrlC: false });
+        instance
+            .waitUntilExit()
+            .then(() => (cancelled ? reject(new SelectCancelledError()) : resolve(chosen)));
     });
 }
 //# sourceMappingURL=SelectList.js.map

package/dist/tui/components/SelectList.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectList.js","sourceRoot":"","sources":["../../../src/tui/components/SelectList.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAOlD;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,KAAK,EACL,KAAK,EACL,YAAY,GAAG,CAAC,EAChB,QAAQ,GAMT;IACC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAClC,YAAY,IAAI,CAAC,IAAI,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CACpE,CAAC;IAEF,QAAQ,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtB,IAAI,GAAG,CAAC,OAAO,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACjC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,GAAG,CAAC,SAAS,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YAC1C,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;YACtB,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CACL,MAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,aACzB,KAAC,IAAI,cAAE,KAAK,GAAQ,EACnB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBACzB,MAAM,QAAQ,GAAG,KAAK,KAAK,MAAM,CAAC;gBAClC,OAAO,CACL,MAAC,IAAI,IAAa,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,aACnD,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EACtB,IAAI,CAAC,KAAK,KAFF,KAAK,CAGT,CACR,CAAC;YACJ,CAAC,CAAC,IACE,CACP,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,KAAmB,EACnB,YAAY,GAAG,CAAC;IAEhB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QAC3C,IAAI,MAAM,GAAG,YAAY,CAAC;QAC1B,MAAM,IAAI,GAAG,GAAuB,EAAE;YACpC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;YAC1B,OAAO,CACL,KAAC,UAAU,IACT,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;oBAClB,MAAM,GAAG,KAAK,CAAC;oBACf,IAAI,EAAE,CAAC;gBACT,CAAC,GACD,CACH,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAC,IAAI,KAAG,CAAC,CAAC;QAClC,QAAQ,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"SelectList.js","sourceRoot":"","sources":["../../../src/tui/components/SelectList.tsx"],"names":[],"mappings":"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"}

package/dist/tui/components/SlashCommandMenu.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { SlashCommand } from '#src/tui/slashCommands.js';
+/**
+ * TUI-C10 — the slash-command discovery menu. A read-only, presentational list of the commands
+ * that match what the user has typed so far (`/`, `/mo`, …), rendered just above the prompt line so
+ * a beginner can *discover* commands instead of having to already know their names (DL-9).
+ *
+ * It deliberately owns **no** keyboard state: unlike {@link SelectList} (a self-contained blocking
+ * dialog), this menu coexists with the live `<TextInput>` — the user keeps typing to filter — so
+ * `<PromptInput>` owns the arrow/Tab/Enter/Esc handling and just tells this component which row is
+ * highlighted. That keeps the selection logic in one place and this render trivially testable.
+ *
+ * Colour follows the shared palette (DL-8): the highlighted `/name` is **cyan** (the informational
+ * accent, matching SelectList's cursor) and every description is **dim** (secondary/contextual
+ * text). Names are padded to a common width so the descriptions line up into a readable column.
+ */
+export declare function SlashCommandMenu({ commands, selectedIndex, }: {
+    commands: SlashCommand[];
+    selectedIndex: number;
+}): React.ReactElement | null;

package/dist/tui/components/SlashCommandMenu.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+/**
+ * TUI-C10 — the slash-command discovery menu. A read-only, presentational list of the commands
+ * that match what the user has typed so far (`/`, `/mo`, …), rendered just above the prompt line so
+ * a beginner can *discover* commands instead of having to already know their names (DL-9).
+ *
+ * It deliberately owns **no** keyboard state: unlike {@link SelectList} (a self-contained blocking
+ * dialog), this menu coexists with the live `<TextInput>` — the user keeps typing to filter — so
+ * `<PromptInput>` owns the arrow/Tab/Enter/Esc handling and just tells this component which row is
+ * highlighted. That keeps the selection logic in one place and this render trivially testable.
+ *
+ * Colour follows the shared palette (DL-8): the highlighted `/name` is **cyan** (the informational
+ * accent, matching SelectList's cursor) and every description is **dim** (secondary/contextual
+ * text). Names are padded to a common width so the descriptions line up into a readable column.
+ */
+export function SlashCommandMenu({ commands, selectedIndex, }) {
+    if (commands.length === 0)
+        return null;
+    // Width of the widest "/name" so the description column aligns (the leading "/" is included).
+    const nameWidth = commands.reduce((w, c) => Math.max(w, c.name.length + 1), 0);
+    return (_jsx(Box, { flexDirection: "column", children: commands.map((command, index) => {
+            const selected = index === selectedIndex;
+            const label = `/${command.name}`.padEnd(nameWidth);
+            return (_jsxs(Box, { children: [_jsxs(Text, { color: selected ? 'cyan' : undefined, bold: selected, children: [selected ? '❯ ' : '  ', label] }), _jsxs(Text, { dimColor: true, children: ['  ', command.description] })] }, command.name));
+        }) }));
+}
+//# sourceMappingURL=SlashCommandMenu.js.map

package/dist/tui/components/SlashCommandMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlashCommandMenu.js","sourceRoot":"","sources":["../../../src/tui/components/SlashCommandMenu.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAGhC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,QAAQ,EACR,aAAa,GAId;IACC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,8FAA8F;IAC9F,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/E,OAAO,CACL,KAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,YACxB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;YAC/B,MAAM,QAAQ,GAAG,KAAK,KAAK,aAAa,CAAC;YACzC,MAAM,KAAK,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACnD,OAAO,CACL,MAAC,GAAG,eACF,MAAC,IAAI,IAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,aACvD,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EACtB,KAAK,IACD,EACP,MAAC,IAAI,IAAC,QAAQ,mBACX,IAAI,EACJ,OAAO,CAAC,WAAW,IACf,KARC,OAAO,CAAC,IAAI,CAShB,CACP,CAAC;QACJ,CAAC,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/tui/components/StatusBar.d.ts

@@ -5,11 +5,17 @@ import React from 'react';
  * and a turn counter — on a single dim line. Streaming progress itself is shown by the live
  * turn, not here, so this bar stays stable (one line) and does not flicker.
  */
-export declare function StatusBar({ running, mode, modelDisplayName, turnCount, debugHint, }: {
+export declare function StatusBar({ running, mode, modelDisplayName, turnCount, debugHint, autoApprove, }: {
     running: boolean;
     mode: string;
     modelDisplayName?: string;
     turnCount?: number;
     /** When the docked debug panel is open but unfocused, surface how to step into it. */
     debugHint?: boolean;
+    /**
+     * EXT-12 — when session auto-approve is ON, surface a persistent, unmissable indicator so the
+     * user always knows shell commands run without asking. Shown in both the running and idle
+     * states (yellow, matching the warn tone of the /auto-approve ON notice).
+     */
+    autoApprove?: boolean;
 }): React.ReactElement;