@wrongstack/tui 0.284.1 → 0.286.0

package/dist/git-info.d.ts

@@ -0,0 +1,20 @@
+export interface GitInfo {
+    branch: string;
+    /** Total lines added in working tree vs HEAD (staged + unstaged). */
+    added: number;
+    /** Total lines deleted in working tree vs HEAD (staged + unstaged). */
+    deleted: number;
+    /** Count of untracked files in the working tree. */
+    untracked: number;
+}
+/**
+ * Read git branch + change summary for the given cwd. Returns `null`
+ * when the directory isn't a git repository or git isn't installed —
+ * the status bar just hides the git chip in that case.
+ *
+ * Spawns two short-lived `git` processes in parallel. Cheap enough to
+ * call on a 3–5 second interval; the caller is responsible for the
+ * cadence (this function is purely fire-and-result).
+ */
+export declare function readGitInfo(cwd: string): Promise<GitInfo | null>;
+//# sourceMappingURL=git-info.d.ts.map

package/dist/git-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-info.d.ts","sourceRoot":"","sources":["../src/git-info.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAgCtE"}

package/dist/heap-watchdog.d.ts

@@ -0,0 +1,41 @@
+export interface HeapSample {
+    ts: string;
+    /** Resident set size, bytes. */
+    rss: number;
+    heapUsed: number;
+    heapTotal: number;
+    /** Off-heap (buffers, etc.), bytes. */
+    external: number;
+    /** V8 hard heap limit, bytes — the OOM ceiling. */
+    heapLimit: number;
+    /** heapUsed / heapLimit, 0–1. */
+    load: number;
+}
+export interface HeapWatchdogOptions {
+    /** Sampling cadence. Default 60s. */
+    sampleEveryMs?: number | undefined;
+    /** Diagnostic-file append cadence. Default 5min. */
+    logEveryMs?: number | undefined;
+    /** Diagnostics file. Default ~/.wrongstack/logs/heap.jsonl */
+    logPath?: string | undefined;
+    /** Fraction of the heap limit that triggers a 'warn' callback. Default 0.6. */
+    warnAt?: number | undefined;
+    /** Fraction of the heap limit that triggers a 'critical' callback. Default 0.85. */
+    criticalAt?: number | undefined;
+    /**
+     * Extra structure sizes merged into every diagnostic line — supply cheap
+     * counters (array lengths, approximate char totals). Must not throw.
+     */
+    collectStats?: (() => Record<string, number>) | undefined;
+    /** Called on threshold crossings with a human-readable message. */
+    onWarn?: ((level: 'warn' | 'critical', message: string, sample: HeapSample) => void) | undefined;
+}
+export declare function defaultHeapLogPath(): string;
+export declare function takeHeapSample(): HeapSample;
+/**
+ * Start the watchdog. Returns a stop function — call it on unmount/exit.
+ * All I/O is best-effort and serialized; a failed append never throws into
+ * the caller.
+ */
+export declare function startHeapWatchdog(opts?: HeapWatchdogOptions): () => void;
+//# sourceMappingURL=heap-watchdog.d.ts.map

package/dist/heap-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heap-watchdog.d.ts","sourceRoot":"","sources":["../src/heap-watchdog.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAC1D,mEAAmE;IACnE,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAClG;AAID,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,cAAc,IAAI,UAAU,CAY3C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,IAAI,CAoG5E"}

package/dist/highlight.d.ts

@@ -0,0 +1,30 @@
+export interface Token {
+    text: string;
+    color?: string | undefined;
+    dim?: boolean | undefined;
+    bold?: boolean | undefined;
+}
+export type Lang = 'ts' | 'js' | 'json' | 'bash' | 'python' | 'diff' | 'plain';
+/** Carry state for constructs that span lines (block comments, triple strings). */
+export interface HLState {
+    block?: boolean | undefined;
+    triple?: string | null;
+}
+/**
+ * Highlight ONE line. `carry` threads multi-line state (block comments, triple
+ * strings) from the previous line; pass the returned `carry` into the next call.
+ * Guarantees `result.tokens.map(t=>t.text).join('') === line`.
+ */
+export declare function highlightLine(line: string, lang: Lang, carry?: HLState): {
+    tokens: Token[];
+    carry: HLState;
+};
+/** Map a code-fence info string (```ts, ```bash, …) to a supported Lang. */
+export declare function detectLang(fenceInfo: string): Lang;
+/**
+ * Infer a supported Lang from a file path's extension (`foo/bar.tsx` → `ts`).
+ * Used by diff rendering to syntax-highlight changed/context lines of the
+ * touched file. Unknown or missing extensions fall back to `plain`.
+ */
+export declare function langFromPath(path: string): Lang;
+//# sourceMappingURL=highlight.d.ts.map

package/dist/highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../src/highlight.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/E,mFAAmF;AACnF,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AA6aD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,KAAK,GAAE,OAAY,GAClB;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAgBrC;AAwBD,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI/C"}

package/dist/hit-test.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Mouse hit-testing for the full-mouse-mode TUI layout.
+ *
+ * Ink exposes no absolute terminal coordinates, but the mouse-mode layout is
+ * deterministic top-down: the chat history occupies the first `viewportRows`
+ * rows of the terminal (its managed scrollbar is the last column of that band),
+ * and everything below it (rows viewportRows+1 .. termRows) is the bottom region
+ * — input, pickers, confirm prompt, status bar, panels. That is enough to map a
+ * 1-based SGR mouse report (x,y) onto a coarse region without any DOM measuring.
+ *
+ * Finer resolution inside the bottom region (which status-bar line, which
+ * confirm button) is layered on top by the consumers using their own measured
+ * offsets + the co-located column-span helpers; this primitive only owns the
+ * top-level row/column geometry so it stays pure and unit-testable.
+ */
+/** Mouse-mode layout geometry. All values are 1-based to match SGR reports. */
+export interface MouseLayout {
+    /** Live terminal row count. */
+    termRows: number;
+    /** Live terminal column count. */
+    termCols: number;
+    /** Rows the history viewport occupies, from the top of the screen. */
+    viewportRows: number;
+}
+export type HitRegion = 
+/** The managed scrollbar track; `cell` is the 0-based row on the track. */
+{
+    kind: 'scrollbar';
+    cell: number;
+}
+/** Inside the history viewport; `row` is 0-based from the viewport top. */
+ | {
+    kind: 'history';
+    row: number;
+}
+/** Below the history viewport; `row` is 0-based from the bottom-region top. */
+ | {
+    kind: 'bottom';
+    row: number;
+};
+/**
+ * Columns at the right edge of the history viewport that count as the
+ * scrollbar, so a click need not land exactly on the 1-column track. The track
+ * itself renders in the last column; this widens the target by one.
+ */
+export declare const SCROLLBAR_HIT_WIDTH = 2;
+/**
+ * Map a 1-based terminal (x,y) onto a layout region, or null when the point is
+ * outside the terminal. Pure — no side effects, no DOM access.
+ */
+export declare function hitRegion(layout: MouseLayout, x: number, y: number): HitRegion | null;
+/**
+ * 1-based absolute terminal row of a status-bar content line.
+ *
+ * The status bar is bottom-anchored above whatever panels render below it, so
+ * its band starts at `termRows - belowHeight - statusBarHeight + 1`. Its first
+ * `headerRows` rows are non-content (the single top border), so content line
+ * `line` (0-based: line 1 = 0) sits `headerRows + line` rows into the band.
+ *
+ * `statusBarHeight` and `belowHeight` are live `measureElement` heights of the
+ * status-bar wrapper and the below-status-bar panel region. Returns null when
+ * the requested content line doesn't exist in the measured band.
+ */
+export declare function statusBarLineRow(opts: {
+    termRows: number;
+    /** Measured status-bar height, including its top border row. */
+    statusBarHeight: number;
+    /** Measured height of everything rendered below the status bar (0 if none). */
+    belowHeight: number;
+    /** Non-content rows at the top of the status bar (the border). */
+    headerRows: number;
+    /** 0-based content line index (line 1 = 0, line 2 = 1, …). */
+    line: number;
+}): number | null;
+//# sourceMappingURL=hit-test.d.ts.map

package/dist/hit-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit-test.d.ts","sourceRoot":"","sources":["../src/hit-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,SAAS;AACnB,2EAA2E;AACzE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACrC,2EAA2E;GACzE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAClC,+EAA+E;GAC7E;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQrF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,GAAG,IAAI,CAKhB"}

package/dist/hooks/fleet-chat-coalescer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pure per-agent tool-call aggregation for compact fleet-chat mode.
+ *
+ * In `compact` mode the director bridge does not emit one chat line per
+ * subagent tool call; instead each call is folded into a per-agent
+ * `ToolAgg` and committed as ONE summary line at the same turn
+ * boundaries that flush the buffered assistant text (session end, task
+ * completion, effect teardown). Kept hook-free so it is unit-testable
+ * without React or a Director.
+ */
+export interface ToolAgg {
+    /** Total tool calls in this turn. */
+    total: number;
+    /** Calls that reported ok === false. */
+    fails: number;
+    /** Sum of reported durations (calls without a duration contribute 0). */
+    totalMs: number;
+    /** Call count per tool name, insertion-ordered. */
+    byTool: Map<string, number>;
+}
+export declare function newToolAgg(): ToolAgg;
+export declare function addTool(agg: ToolAgg, name: string, ok?: boolean | undefined, durationMs?: number | undefined): void;
+/**
+ * Render an aggregate as a single chat line:
+ * `14 tools · grep×9 read×5 · 3.2s · 1 ✗`
+ *
+ * The top `maxTools` tools by count are listed; any remainder collapses
+ * into `+N more`. Segments with nothing to say (no duration, no
+ * failures) are omitted. Returns '' for an empty aggregate.
+ */
+export declare function formatToolSummary(agg: ToolAgg, maxTools?: number): string;
+//# sourceMappingURL=fleet-chat-coalescer.d.ts.map

package/dist/hooks/fleet-chat-coalescer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-chat-coalescer.d.ts","sourceRoot":"","sources":["../../src/hooks/fleet-chat-coalescer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,OAAO;IACtB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,CAAC,EAAE,OAAO,GAAG,SAAS,EACxB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,GAC9B,IAAI,CAON;AAQD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CAWpE"}

package/dist/hooks/use-auth-panel.d.ts

@@ -0,0 +1,38 @@
+import type { Action, State } from '../app-reducer.js';
+import { type AuthPanelHost } from '../components/auth-panel-model.js';
+export interface UseAuthPanelOptions {
+    authHost: AuthPanelHost | undefined;
+    stateRef: {
+        current: State;
+    };
+    dispatch: React.Dispatch<Action>;
+    /**
+     * Live `state.authPanel.open` — when the panel closes from OUTSIDE the
+     * controller (another panel's `closePanels`, an F-key toggle, Ctrl+C),
+     * any in-flight flow must be aborted so an invisible prompt can't leave
+     * an OAuth loopback server (or a pending readline promise) running
+     * behind a closed panel.
+     */
+    open: boolean;
+}
+export interface AuthPanelController {
+    /** Open the panel (used by `/auth` via the panel bridge). No-op without a host. */
+    openAuthPanel: (view?: 'list' | 'oauth') => boolean;
+    onAuthEnter: () => void;
+    onAuthBack: () => void;
+    onAuthShortcut: (input: string) => void;
+    onAuthPromptSubmit: () => void;
+    onAuthPromptCancel: () => void;
+    onAuthConfirm: (yes: boolean) => void;
+    onAuthFlowCancel: () => void;
+    /**
+     * Ctrl+C while the panel is open. In raw-mode terminals (ConPTY, most
+     * Windows setups) Ctrl+C arrives as key DATA — not a SIGINT — so the
+     * key router must handle it; the app's SIGINT ladder covers the
+     * console-event delivery path. Both paths abort any in-flight flow and
+     * close the panel.
+     */
+    onAuthCtrlC: () => void;
+}
+export declare function useAuthPanel(opts: UseAuthPanelOptions): AuthPanelController;
+//# sourceMappingURL=use-auth-panel.d.ts.map

package/dist/hooks/use-auth-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-auth-panel.d.ts","sourceRoot":"","sources":["../../src/hooks/use-auth-panel.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,mCAAmC,CAAC;AAE3C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE;QAAE,OAAO,EAAE,KAAK,CAAA;KAAE,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC;;;;;;OAMG;IACH,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,aAAa,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,KAAK,OAAO,CAAC;IACpD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAgBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAoS3E"}

package/dist/hooks/use-autonomous-coordinator.d.ts

@@ -0,0 +1,21 @@
+import type { CoordinatorEvent } from '@wrongstack/core';
+/**
+ * Wires the AutonomousCoordinator into the TUI reducer via dispatch.
+ *
+ * When `subscribeCoordinatorEvents` is provided, this hook:
+ * 1. Subscribes to all coordinator events on mount
+ * 2. Maps each CoordinatorEvent to a `coordinatorEvent` dispatch action
+ * 3. Cleans up the subscription on unmount
+ *
+ * When the option is omitted (coordinator not active), the hook is a no-op.
+ *
+ * @param subscribeCoordinatorEvents - the TUI's subscribe function from RunTuiOptions
+ * @param dispatch - the TUI reducer dispatch
+ */
+export declare function useAutonomousCoordinator(subscribeCoordinatorEvents: ((fn: (event: CoordinatorEvent) => void) => () => void) | undefined, dispatch: React.Dispatch<{
+    type: 'coordinatorEvent';
+    event: CoordinatorEvent;
+} | {
+    type: 'toggleCoordinatorMonitor';
+}>): void;
+//# sourceMappingURL=use-autonomous-coordinator.d.ts.map

package/dist/hooks/use-autonomous-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-autonomous-coordinator.d.ts","sourceRoot":"","sources":["../../src/hooks/use-autonomous-coordinator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,0BAA0B,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC,GAAG,SAAS,EAC/F,QAAQ,EAAE,KAAK,CAAC,QAAQ,CACpB;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,0BAA0B,CAAA;CAAE,CACvC,GACA,IAAI,CAgBN"}

package/dist/hooks/use-brain-events.d.ts

@@ -0,0 +1,7 @@
+import type { EventBus } from '@wrongstack/core';
+import type { Action } from '../app-reducer.js';
+/**
+ * Brain decision events → chat history / status bar.
+ */
+export declare function useBrainEvents(events: EventBus, dispatch: React.Dispatch<Action>, getSessionId?: (() => string | undefined) | undefined): void;
+//# sourceMappingURL=use-brain-events.d.ts.map

package/dist/hooks/use-brain-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-brain-events.d.ts","sourceRoot":"","sources":["../../src/hooks/use-brain-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,EAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAChC,YAAY,CAAC,EAAE,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GACpD,IAAI,CA6EN"}

package/dist/hooks/use-brain-panel.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Brain panel controller — opens the panel and translates settings-view
+ * key actions into BrainPanelHost mutations (live apply + persist on the
+ * CLI side), refreshing the snapshot and surfacing errors as panel hints.
+ * Extracted from app.tsx (hotspot guardrail).
+ */
+import React from 'react';
+import type { Action } from '../app-state.js';
+import type { BrainRiskLevel } from '../components/brain-panel.js';
+import { type BrainPanelHost, type BrainPanelRow } from '../components/brain-panel-model.js';
+/** Selection returned by the shared model-pick overlay (null = cancelled). */
+export type ModelPickSelection = {
+    providerId: string;
+    model: string;
+} | null;
+export interface UseBrainPanelOptions {
+    dispatch: React.Dispatch<Action>;
+    getBrainData?: (() => {
+        riskLevel: BrainRiskLevel;
+        log: Array<{
+            kind: string;
+            question: string;
+            outcome: string;
+            age: string;
+        }>;
+    }) | undefined;
+    brainPanelHost?: BrainPanelHost | undefined;
+    /**
+     * The SHARED two-step model picker (same overlay as /model), invoked in
+     * 'pick' mode: resolves with the selection instead of switching the
+     * session model. Provided by App's requestModelPick.
+     */
+    requestModelPick?: ((title: string) => Promise<ModelPickSelection>) | undefined;
+}
+export interface BrainPanelController {
+    openBrainPanel: () => void;
+    handleBrainAdjust: (row: BrainPanelRow, delta: number) => void;
+    handleBrainEnter: (row: BrainPanelRow) => void;
+    handleBrainDelete: (row: BrainPanelRow) => void;
+    handleBrainVoterMod: (index: number, mod: 'persona' | 'veto') => void;
+}
+export declare function useBrainPanel(opts: UseBrainPanelOptions): BrainPanelController;
+//# sourceMappingURL=use-brain-panel.d.ts.map

package/dist/hooks/use-brain-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-brain-panel.d.ts","sourceRoot":"","sources":["../../src/hooks/use-brain-panel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EAInB,MAAM,oCAAoC,CAAC;AAE5C,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EACT,CAAC,MAAM;QACL,SAAS,EAAE,cAAc,CAAC;QAC1B,GAAG,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9E,CAAC,GACF,SAAS,CAAC;IACd,cAAc,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IAC5C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC,GAAG,SAAS,CAAC;CACjF;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,iBAAiB,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,gBAAgB,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAChD,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,KAAK,IAAI,CAAC;CACvE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,CAmO9E"}

package/dist/hooks/use-director-fleet-bridge.d.ts

@@ -0,0 +1,31 @@
+import type { Director, FleetChatVerbosity } from '@wrongstack/core';
+import type { Action, State } from '../app-reducer.js';
+export interface UseDirectorFleetBridgeOptions {
+    director: Director | null;
+    dispatch: React.Dispatch<Action>;
+    stateRef: React.MutableRefObject<State>;
+    chatMode: FleetChatVerbosity;
+}
+/**
+ * Director FleetBus -> TUI state bridge.
+ *
+ * High-frequency text deltas are batched so subagent streams do not cause a
+ * render per token. The hook keeps live refs for settings/state that should not
+ * force FleetBus re-subscription.
+ *
+ * Chat-history gating (`chatMode`):
+ * - 'full'    — every tool call gets its own 🔧 line, interim 💬 text commits
+ *               at each tool boundary (legacy behavior).
+ * - 'compact' — tool calls fold into a per-agent {@link ToolAgg} and the
+ *               whole turn commits as ONE entry (💬 text with the tool
+ *               summary as `detail`, or a lone 🔧 summary) at session end /
+ *               task completion / teardown.
+ * - 'off'     — no subagent chat entries at all; provider errors/retries
+ *               still surface as warn/error entries.
+ * The fleet table (F2/F3) is fed in EVERY mode. The mode is read at commit
+ * time via a live ref; a mid-burst flip applies from the next boundary on.
+ * `/clear` mid-run is safe: buffers live inside the effect, and subagent
+ * entries are never rehydrated on resume.
+ */
+export declare function useDirectorFleetBridge({ director, dispatch, stateRef, chatMode, }: UseDirectorFleetBridgeOptions): void;
+//# sourceMappingURL=use-director-fleet-bridge.d.ts.map

package/dist/hooks/use-director-fleet-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-director-fleet-bridge.d.ts","sourceRoot":"","sources":["../../src/hooks/use-director-fleet-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAc,MAAM,kBAAkB,CAAC;AAEjF,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAuBvD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE,6BAA6B,GAAG,IAAI,CA+ZtC"}

package/dist/hooks/use-file-search.d.ts

@@ -0,0 +1,42 @@
+/**
+ * File-search hook — @-token detection, file search, and file picker
+ * selection handler. Extracted from app.tsx (Issue #23, PR 4).
+ *
+ * Drives the <FilePicker /> component: watches buffer/cursor for an
+ * active `@<query>` token, calls searchFiles(), dispatches matches,
+ * and on Enter/click registers the picked file as an attachment.
+ */
+import type { InputBuilder } from '@wrongstack/core';
+import type { Action, State } from '../app-reducer.js';
+/**
+ * Find an active `@<query>` token at the cursor. The token starts at the
+ * last `@` not preceded by a non-whitespace char, and runs up to the cursor
+ * (no whitespace allowed inside). Returns null if no active token.
+ */
+export declare function detectAtToken(buffer: string, cursor: number): {
+    start: number;
+    end: number;
+    query: string;
+} | null;
+export interface UseFileSearchOptions {
+    state: State;
+    dispatch: React.Dispatch<Action>;
+    projectRoot: string;
+    builderRef: React.MutableRefObject<InputBuilder | null>;
+    draftRef: React.MutableRefObject<{
+        buffer: string;
+        cursor: number;
+    }>;
+    setDraft: (buffer: string, cursor: number) => void;
+    tokenPreviewsRef: React.MutableRefObject<Map<string, string>>;
+}
+export interface FileSearchResult {
+    /** Called from the host's Enter handler when the file picker is open. */
+    onPickerEnter: () => Promise<void>;
+}
+/**
+ * Watches buffer/cursor for `@<query>` tokens, drives file search, and
+ * provides the Enter handler for the <FilePicker> component.
+ */
+export declare function useFileSearch(options: UseFileSearchOptions): FileSearchResult;
+//# sourceMappingURL=use-file-search.d.ts.map

package/dist/hooks/use-file-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-file-search.d.ts","sourceRoot":"","sources":["../../src/hooks/use-file-search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAKvD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAetD;AAID,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,KAAK,CAAC,gBAAgB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACxD,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,gBAAgB,CA6E7E"}

package/dist/hooks/use-input-history-persistence.d.ts

@@ -0,0 +1,14 @@
+import type { Action, State } from '../app-reducer.js';
+export interface UseInputHistoryPersistenceOptions {
+    projectRoot: string;
+    inputHistory: State['inputHistory'];
+    dispatch: React.Dispatch<Action>;
+}
+/**
+ * Per-project prompt history persistence.
+ *
+ * Loads prompt history from `projectInputHistory` on mount and saves it back
+ * with a 200ms debounce whenever the in-memory list changes.
+ */
+export declare function useInputHistoryPersistence({ projectRoot, inputHistory, dispatch, }: UseInputHistoryPersistenceOptions): void;
+//# sourceMappingURL=use-input-history-persistence.d.ts.map

package/dist/hooks/use-input-history-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-input-history-persistence.d.ts","sourceRoot":"","sources":["../../src/hooks/use-input-history-persistence.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,iCAAiC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IACpC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,EAAE,iCAAiC,GAAG,IAAI,CA+C1C"}

package/dist/hooks/use-mode-picker.d.ts

@@ -0,0 +1,15 @@
+import type { Mode } from '@wrongstack/core';
+import type { Action } from '../app-reducer.js';
+export interface GetModesResult {
+    modes: Mode[];
+    activeId: string | null;
+}
+export interface UseModePickerOptions {
+    dispatch: React.Dispatch<Action>;
+    getModes?: (() => Promise<GetModesResult>) | undefined;
+}
+export declare function buildModePickerOptions(result: GetModesResult): import("../components/mode-picker.js").ModeOption[];
+export declare function useModePicker({ dispatch, getModes, }: UseModePickerOptions): {
+    openModePicker: () => Promise<void>;
+};
+//# sourceMappingURL=use-mode-picker.d.ts.map

package/dist/hooks/use-mode-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-mode-picker.d.ts","sourceRoot":"","sources":["../../src/hooks/use-mode-picker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,SAAS,CAAC;CACxD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,uDAE5D;AAED,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,QAAQ,GACT,EAAE,oBAAoB,GAAG;IAAE,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAShE"}

package/dist/hooks/use-model-pick.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Generic model-pick request — the reusable side of the /model overlay.
+ *
+ * `requestModelPick(title)` opens the SAME two-step provider→model picker
+ * as the /model command, but in purpose 'pick': Enter RESOLVES the returned
+ * promise with the selection instead of switching the session model, and
+ * every close path (Esc at step 1, global overlay close, a competing open)
+ * resolves null. Callers: the Brain panel (pool/voters/judge) — and any
+ * future surface that needs a model choice.
+ */
+import React from 'react';
+import type { Action } from '../app-state.js';
+export type ModelPickSelection = {
+    providerId: string;
+    model: string;
+} | null;
+export interface UseModelPickRequestOptions {
+    dispatch: React.Dispatch<Action>;
+    getPickableProviders?: (() => Promise<Array<{
+        id: string;
+        family: string;
+        models: string[];
+    }>>) | undefined;
+    /** Live `state.modelPicker.open` — closes without a pick resolve null. */
+    pickerOpen: boolean;
+}
+export interface ModelPickRequestController {
+    /** Open the shared picker; resolves with the choice or null on cancel. */
+    requestModelPick: (title: string) => Promise<ModelPickSelection>;
+    /** Wired into the key hook as `onModelPicked` (purpose 'pick' Enter). */
+    handleModelPicked: (providerId: string, modelId: string) => void;
+}
+export declare function useModelPickRequest(opts: UseModelPickRequestOptions): ModelPickRequestController;
+//# sourceMappingURL=use-model-pick.d.ts.map

package/dist/hooks/use-model-pick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-model-pick.d.ts","sourceRoot":"","sources":["../../src/hooks/use-model-pick.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC;AAE9E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,oBAAoB,CAAC,EACjB,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC,GACxE,SAAS,CAAC;IACd,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,0EAA0E;IAC1E,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjE,yEAAyE;IACzE,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,0BAA0B,GAAG,0BAA0B,CAmChG"}

package/dist/hooks/use-paste-handling.d.ts

@@ -0,0 +1,30 @@
+import type { InputBuilder } from '@wrongstack/core';
+import type { Action } from '../app-reducer.js';
+export interface UsePasteHandlingOptions {
+    builderRef: React.MutableRefObject<InputBuilder | null>;
+    dispatch: React.Dispatch<Action>;
+    draftRef: React.MutableRefObject<{
+        buffer: string;
+        cursor: number;
+    }>;
+    setDraft: (buffer: string, cursor: number) => void;
+    tokenPreviewsRef: React.MutableRefObject<Map<string, string>>;
+}
+export interface PasteHandlingResult {
+    pasteAccumRef: React.MutableRefObject<string | null>;
+    pasteFlushTimerRef: React.MutableRefObject<ReturnType<typeof setTimeout> | null>;
+    commitPaste: (full: string) => Promise<void>;
+    pasteClipboardImage: () => Promise<void>;
+    pasteClipboardText: () => Promise<void>;
+}
+/**
+ * Bracketed-paste accumulator and clipboard paste handling.
+ *
+ * A single paste can be delivered across several stdin/keypress events: only
+ * the first carries the \x1b[200~ begin marker and only the last carries
+ * \x1b[201~. We buffer every fragment here between those markers and finalize
+ * once, so a paste never fragments into multiple placeholders or leaks
+ * newlines into the buffer.
+ */
+export declare function usePasteHandling({ builderRef, dispatch, draftRef, setDraft, tokenPreviewsRef, }: UsePasteHandlingOptions): PasteHandlingResult;
+//# sourceMappingURL=use-paste-handling.d.ts.map

package/dist/hooks/use-paste-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-paste-handling.d.ts","sourceRoot":"","sources":["../../src/hooks/use-paste-handling.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,KAAK,CAAC,gBAAgB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACxD,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,KAAK,CAAC,gBAAgB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrD,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;IACjF,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,mBAAmB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,gBAAgB,GACjB,EAAE,uBAAuB,GAAG,mBAAmB,CAwH/C"}

package/dist/hooks/use-picker-keys.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Picker key dispatch.
+ *
+ * The picker dispatch is a closed dispatch table where each picker checks
+ * `state.<picker>.open` and either handles the key (returning `true`) or
+ * falls through (returning `false`). The hook returns a single function
+ * `tryPickerKey(input, key, isEnter)` that the caller's `handleKey` invokes
+ * *before* its non-picker dispatch and bails on `true`.
+ */
+import type { Action, State } from '../app-reducer.js';
+import type { KeyEvent } from '../components/input.js';
+import type { AutonomyStage } from './use-statusline-state.js';
+export interface PickerKeysHost {
+    state: State;
+    dispatch: React.Dispatch<Action>;
+    lastEnterAtRef: {
+        current: number;
+    };
+    inputGateRef: {
+        current: boolean;
+    };
+    switchProviderAndModel: ((providerId: string, modelId: string) => string | null | Promise<string | null>) | undefined;
+    setLiveProvider: ((v: string) => void) | undefined;
+    setLiveModel: ((v: string) => void) | undefined;
+    setActiveMaxContext: ((v: number | undefined) => void) | undefined;
+    getAgentCtxMaxContext: () => number;
+    activeMaxContext: number | undefined;
+    currentContextTokens: number;
+    switchAutonomy: ((mode: AutonomyStage) => string | null) | undefined;
+    submit: ((text: string) => void) | undefined;
+    onAuthEnter: (() => void) | undefined;
+    onAuthBack: (() => void) | undefined;
+    onAuthShortcut: ((input: string) => void) | undefined;
+    onAuthPromptSubmit: (() => void) | undefined;
+    onAuthPromptCancel: (() => void) | undefined;
+    onAuthConfirm: ((yes: boolean) => void) | undefined;
+    onAuthFlowCancel: (() => void) | undefined;
+    onAuthCtrlC: (() => void) | undefined;
+    onPromptPickerEnter: (() => void) | undefined;
+    onResumePickerEnter: (() => Promise<void>) | undefined;
+    onSessionsPanelEnter: (() => Promise<void>) | undefined;
+    onProjectPickerEnter: (() => Promise<void>) | undefined;
+    onSlashPickerEnter: (() => void) | undefined;
+    onSettingsPickerEnter: (() => void) | undefined;
+    onPluginPickerToggle: (() => Promise<void> | void) | undefined;
+    onMcpPickerToggle: (() => Promise<void> | void) | undefined;
+    onMcpPickerRestart: (() => Promise<void> | void) | undefined;
+    onToolsPickerToggle: (() => Promise<void> | void) | undefined;
+    onHelpPanelEnter: (() => void) | undefined;
+    onBrainRiskChange: ((delta: number) => void) | undefined;
+    /** Settings-view value edit: ←/→ on the focused row. */
+    onBrainAdjust: ((row: import('../components/brain-panel-model.js').BrainPanelRow, delta: number) => void) | undefined;
+    /** Settings-view Enter: toggle a boolean row or open the model picker. */
+    onBrainEnter: ((row: import('../components/brain-panel-model.js').BrainPanelRow) => void) | undefined;
+    /** Settings-view d/Delete on a removable row. */
+    onBrainDelete: ((row: import('../components/brain-panel-model.js').BrainPanelRow) => void) | undefined;
+    /** Voter row modifiers: p = cycle persona, v = toggle veto. */
+    onBrainVoterMod: ((index: number, mod: 'persona' | 'veto') => void) | undefined;
+    /**
+     * Generic model-pick resolution: Enter on the model step when the picker
+     * was opened with purpose 'pick' (requestModelPick) — the selection is
+     * RETURNED to the caller instead of switching the session model.
+     */
+    onModelPicked: ((providerId: string, modelId: string) => void) | undefined;
+    onShadowStart: (() => Promise<void> | void) | undefined;
+    onShadowStop: (() => Promise<void> | void) | undefined;
+    onFKeyPickerEnter: (() => void) | undefined;
+    onPickerEnter: (() => Promise<void>) | undefined;
+    onSlashPickerTab: (() => void) | undefined;
+}
+export declare function usePickerKeys(host: PickerKeysHost): (input: string, key: KeyEvent, isEnter: boolean) => boolean;
+//# sourceMappingURL=use-picker-keys.d.ts.map