@mono-agent/tui 0.4.0 → 0.4.1

package/dist/remote/client.js

@@ -0,0 +1,173 @@
+import { AgentResponseCancelledError, frameFeedingMessageStream, parseAgentStreamFrame, } from "@mono-agent/agent-contracts";
+export class RemoteAgentResponderError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = "RemoteAgentResponderError";
+        if (code !== undefined) {
+            this.code = code;
+        }
+    }
+}
+/**
+ * AgentResponder over the operator-adapter TUI NDJSON wire: one POST per turn, each
+ * received frame replayed onto the local AgentMessageStream in order. Because
+ * it implements the same contract as an in-process responder, every UI surface
+ * works identically in embedded (`--responder`) and remote (`mono-agent tui`)
+ * modes.
+ */
+export class RemoteAgentResponder {
+    baseUrl;
+    apiKey;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/u, "");
+        this.apiKey = options.apiKey;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    headers(json) {
+        return {
+            ...(json ? { "content-type": "application/json" } : {}),
+            ...(this.apiKey === undefined ? {} : { authorization: `Bearer ${this.apiKey}` }),
+        };
+    }
+    /** Probe GET /v1/info; throws RemoteAgentResponderError when unreachable/unauthorized. */
+    async info() {
+        const response = await this.request(`${this.baseUrl}/v1/info`, { headers: this.headers(false) });
+        const body = (await response.json());
+        const { effort, models, modelOptions, ...rest } = body;
+        const parsedModelOptions = parseModelOptions(modelOptions);
+        return {
+            ...rest,
+            // Older agents may omit `effort` entirely, or send a malformed value; either
+            // way tolerate it and just leave `effort` unset rather than surfacing garbage.
+            ...(typeof effort === "string" ? { effort } : {}),
+            // Older agents omit `models`; only surface a well-formed array of strings so
+            // the model picker never renders garbage entries.
+            ...(Array.isArray(models) && models.every((entry) => typeof entry === "string")
+                ? { models }
+                : {}),
+            // Older agents omit `modelOptions` entirely; a newer agent sends it keyed by
+            // the same ref strings as `models`. Parsed defensively per-entry so one
+            // malformed entry never poisons the well-formed rest.
+            ...(parsedModelOptions === undefined ? {} : { modelOptions: parsedModelOptions }),
+        };
+    }
+    async respond(request, stream) {
+        const response = await this.request(`${this.baseUrl}/v1/turns`, {
+            method: "POST",
+            headers: this.headers(true),
+            body: JSON.stringify({
+                conversationId: request.conversationId,
+                text: request.text,
+                ...(request.metadata === undefined ? {} : { metadata: request.metadata }),
+            }),
+            // Aborting tears down the socket; the adapter aborts the in-flight turn.
+            signal: request.abortSignal,
+        });
+        if (response.body === null) {
+            throw new RemoteAgentResponderError("Agent returned an empty stream body.");
+        }
+        const feed = frameFeedingMessageStream(stream);
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffered = "";
+        try {
+            for (;;) {
+                const { done, value } = await reader.read();
+                buffered += done ? decoder.decode() : decoder.decode(value, { stream: true });
+                const lines = buffered.split("\n");
+                buffered = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (line.length === 0) {
+                        continue;
+                    }
+                    const frame = parseAgentStreamFrame(line);
+                    if (frame.kind === "finish") {
+                        return {
+                            ...(frame.finalText === undefined ? {} : { text: frame.finalText }),
+                            ...(frame.metadata === undefined ? {} : { metadata: frame.metadata }),
+                        };
+                    }
+                    if (frame.kind === "error") {
+                        if (frame.cancelled === true) {
+                            throw new AgentResponseCancelledError(frame.message);
+                        }
+                        throw new RemoteAgentResponderError(frame.message, frame.code);
+                    }
+                    await feed(frame);
+                }
+                if (done) {
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            if (request.abortSignal.aborted && !(error instanceof AgentResponseCancelledError)) {
+                throw new AgentResponseCancelledError();
+            }
+            throw error;
+        }
+        finally {
+            // Idempotent; also tears the socket down on early return/throw.
+            await reader.cancel().catch(() => undefined);
+        }
+        throw new RemoteAgentResponderError("Stream ended without a finish or error frame.");
+    }
+    cancel(conversationId) {
+        // Fire-and-forget: cancellation is best-effort and must never block the UI.
+        void this.fetchImpl(`${this.baseUrl}/v1/conversations/${encodeURIComponent(conversationId)}/cancel`, {
+            method: "POST",
+            headers: this.headers(false),
+        }).catch(() => undefined);
+    }
+    async request(url, init) {
+        let response;
+        try {
+            response = await this.fetchImpl(url, init);
+        }
+        catch (error) {
+            if (init?.signal !== undefined && init.signal.aborted) {
+                throw new AgentResponseCancelledError();
+            }
+            throw new RemoteAgentResponderError(`Agent is unreachable at ${this.baseUrl} (${error instanceof Error ? error.message : String(error)}).`, "unreachable");
+        }
+        if (!response.ok && response.headers.get("content-type")?.includes("application/x-ndjson") !== true) {
+            const detail = await response.text().catch(() => "");
+            throw new RemoteAgentResponderError(`Agent responded ${response.status} at ${url}${detail.length > 0 ? `: ${detail.slice(0, 300)}` : "."}`, response.status === 401 ? "unauthorized" : "http_error");
+        }
+        return response;
+    }
+}
+/**
+ * Defensively parses `/v1/info`'s `modelOptions` field: tolerates absence (an
+ * older agent), a non-record payload, and per-entry shape mismatches — a
+ * malformed entry is dropped rather than surfacing garbage or throwing. Never
+ * returns an empty record; an all-malformed payload degrades to `undefined`,
+ * same as an agent that never sent the field.
+ */
+function parseModelOptions(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    const result = {};
+    for (const [ref, raw] of Object.entries(value)) {
+        if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+            continue;
+        }
+        const entry = raw;
+        const parsedEntry = {
+            ...(Array.isArray(entry.effortLevels) && entry.effortLevels.every((level) => typeof level === "string")
+                ? { effortLevels: entry.effortLevels }
+                : {}),
+            ...(typeof entry.reasoning === "boolean" ? { reasoning: entry.reasoning } : {}),
+            ...(typeof entry.reasoningMode === "string" ? { reasoningMode: entry.reasoningMode } : {}),
+            ...(typeof entry.label === "string" ? { label: entry.label } : {}),
+        };
+        if (Object.keys(parsedEntry).length > 0) {
+            result[ref] = parsedEntry;
+        }
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+//# sourceMappingURL=client.js.map

package/dist/remote/client.js.map

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

package/dist/runtime/start.d.ts

@@ -1,27 +1,20 @@
-import { type TuiAppProps } from "../components/TuiApp.js";
-export interface StartMonoAgentTuiOptions extends TuiAppProps {
-    readonly stdout?: NodeJS.WriteStream;
-    readonly stdin?: NodeJS.ReadStream;
-    readonly stderr?: NodeJS.WriteStream;
-    readonly debug?: boolean;
-    /**
-     * Forwarded to ink's `render({ patchConsole })`. Defaults to `false` so the
-     * TUI does not silently swallow host `console.*` output; set it to `true`
-     * to let Ink intercept and redraw console writes above the app.
-     */
-    readonly patchConsole?: boolean;
+import type { Terminal } from "@earendil-works/pi-tui";
+import type { MonoAgentTuiAppOptions } from "../ui/app.js";
+export interface StartMonoAgentTuiOptions extends Omit<MonoAgentTuiAppOptions, "terminal"> {
+    /** Test seam: inject a Terminal implementation; defaults to the real TTY. */
+    readonly terminal?: Terminal;
 }
 export interface StartMonoAgentTuiHandle {
-    /** Resolves once the Ink app unmounts (user quit or programmatic stop). */
+    /** Resolves once the app exits (user quit or programmatic stop). */
     waitUntilExit(): Promise<void>;
-    /** Unmount the app and restore the TTY. Idempotent. */
+    /** Stop the app and restore the TTY. Idempotent. */
     stop(): Promise<void>;
 }
 /**
- * Mount the TUI against the live TTY (or the provided stdin/stdout pair).
- *
- * Hosts that already manage Ink should embed `<TuiApp />` directly; this
- * convenience function wires `ink.render` for the common case.
+ * Start the pi-tui operator console. Exactly one connection mode applies:
+ * `responder` (in-process/embedded), `connection` (direct remote endpoint), or
+ * `discovery` (open on the agent picker). Replay/config views activate when
+ * `instance`/`config` provide data roots.
  */
 export declare function startMonoAgentTui(options: StartMonoAgentTuiOptions): StartMonoAgentTuiHandle;
 //# sourceMappingURL=start.d.ts.map

package/dist/runtime/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/runtime/start.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,uDAAuD;IACvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,uBAAuB,CAgDzB"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/runtime/start.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,wBAAyB,SAAQ,IAAI,CAAC,sBAAsB,EAAE,UAAU,CAAC;IACxF,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,oDAAoD;IACpD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CA4B5F"}

package/dist/runtime/start.js

@@ -1,45 +1,31 @@
-import React from "react";
-import { render } from "ink";
-import { TuiApp } from "../components/TuiApp.js";
+import { ProcessTerminal } from "@earendil-works/pi-tui";
+import { MonoAgentTuiApp } from "../ui/app.js";
 /**
- * Mount the TUI against the live TTY (or the provided stdin/stdout pair).
- *
- * Hosts that already manage Ink should embed `<TuiApp />` directly; this
- * convenience function wires `ink.render` for the common case.
+ * Start the pi-tui operator console. Exactly one connection mode applies:
+ * `responder` (in-process/embedded), `connection` (direct remote endpoint), or
+ * `discovery` (open on the agent picker). Replay/config views activate when
+ * `instance`/`config` provide data roots.
  */
 export function startMonoAgentTui(options) {
-    const { stdout, stdin, stderr, debug, patchConsole = false, ...appProps } = options;
-    const stdinTarget = stdin ?? process.stdin;
-    if (stdin === undefined &&
-        typeof stdinTarget.isTTY === "boolean" &&
-        stdinTarget.isTTY === false) {
-        throw new Error("startMonoAgentTui requires a TTY stdin. Pipe a stdin manually for non-TTY use.");
+    const modes = [options.responder, options.connection, options.discovery].filter((mode) => mode !== undefined).length;
+    if (modes !== 1) {
+        throw new Error("startMonoAgentTui requires exactly one of `responder`, `connection`, or `discovery`.");
     }
-    const instance = render(React.createElement(TuiApp, appProps), {
-        stdout: stdout ?? process.stdout,
-        stdin: stdinTarget,
-        stderr: stderr ?? process.stderr,
-        debug: debug ?? false,
-        patchConsole,
-        exitOnCtrlC: appProps.exitOnCtrlC ?? true,
+    if (options.terminal === undefined && process.stdin.isTTY !== true) {
+        throw new Error("startMonoAgentTui requires a TTY stdin. Pass a terminal manually for non-TTY use.");
+    }
+    const { terminal, ...appOptions } = options;
+    const app = new MonoAgentTuiApp({
+        ...appOptions,
+        terminal: terminal ?? new ProcessTerminal(),
     });
-    let stopped = false;
+    app.start();
     return {
         async waitUntilExit() {
-            await instance.waitUntilExit();
+            await app.waitUntilExit();
         },
         async stop() {
-            if (stopped) {
-                return;
-            }
-            stopped = true;
-            instance.unmount();
-            try {
-                await instance.waitUntilExit();
-            }
-            catch {
-                // ignore
-            }
+            app.stop();
         },
     };
 }

package/dist/runtime/start.js.map

@@ -1 +1 @@
-{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/runtime/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,MAAM,EAAoB,MAAM,yBAAyB,CAAC;AAsBnE;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAiC;IAEjC,MAAM,EACJ,MAAM,EACN,KAAK,EACL,MAAM,EACN,KAAK,EACL,YAAY,GAAG,KAAK,EACpB,GAAG,QAAQ,EACZ,GAAG,OAAO,CAAC;IAEZ,MAAM,WAAW,GAAG,KAAK,IAAK,OAAO,CAAC,KAA2B,CAAC;IAClE,IACE,KAAK,KAAK,SAAS;QACnB,OAAO,WAAW,CAAC,KAAK,KAAK,SAAS;QACtC,WAAW,CAAC,KAAK,KAAK,KAAK,EAC3B,CAAC;QACD,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE;QAC7D,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM;QAChC,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM;QAChC,KAAK,EAAE,KAAK,IAAI,KAAK;QACrB,YAAY;QACZ,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,IAAI;KAC1C,CAAC,CAAC;IAEH,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO;QACL,KAAK,CAAC,aAAa;YACjB,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,IAAI;YACR,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;YACf,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/runtime/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAe/C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAC7E,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAC7B,CAAC,MAAM,CAAC;IACT,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC;QAC9B,GAAG,UAAU;QACb,QAAQ,EAAE,QAAQ,IAAI,IAAI,eAAe,EAAE;KAC5C,CAAC,CAAC;IACH,GAAG,CAAC,KAAK,EAAE,CAAC;IAEZ,OAAO;QACL,KAAK,CAAC,aAAa;YACjB,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,IAAI;YACR,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/ui/app.d.ts

@@ -0,0 +1,142 @@
+import { TUI } from "@earendil-works/pi-tui";
+import type { Terminal } from "@earendil-works/pi-tui";
+import type { AgentResponder } from "@mono-agent/agent-contracts";
+import type { TuiHistoryStore } from "../agent/history.js";
+export type TuiViewId = "chat" | "picker" | "replay" | "config";
+export interface TuiAppLogger {
+    debug?(message: string, metadata?: Record<string, unknown>): void;
+    info?(message: string, metadata?: Record<string, unknown>): void;
+    warn?(message: string, metadata?: Record<string, unknown>): void;
+    error?(message: string, metadata?: Record<string, unknown>): void;
+}
+export interface MonoAgentTuiAppOptions {
+    readonly terminal: Terminal;
+    /** In-process responder (embedded mode); mutually exclusive with connection/discovery. */
+    readonly responder?: AgentResponder;
+    /** Direct remote connection (from `mono-agent tui` after resolution). */
+    readonly connection?: {
+        readonly baseUrl: string;
+        readonly apiKey?: string;
+    };
+    /** Discovery mode: open on the instance picker over these registries (`registryDirs` union beats the single `registryDir`). */
+    readonly discovery?: {
+        readonly registryDir?: string;
+        readonly registryDirs?: readonly string[];
+        readonly staleAfterMs?: number;
+    };
+    /** Identity + data roots of the selected instance (replay/config views). */
+    readonly instance?: {
+        readonly label?: string;
+        readonly artifactDir?: string;
+        readonly configPath?: string;
+    };
+    readonly conversationId?: string;
+    readonly title?: string;
+    readonly subtitle?: string;
+    readonly initialStatusText?: string;
+    readonly history?: TuiHistoryStore;
+    readonly config?: {
+        readonly path: string;
+        readonly cwd: string;
+        readonly env: Record<string, string | undefined>;
+    };
+    readonly logger?: TuiAppLogger;
+    readonly env?: Record<string, string | undefined>;
+    /** Test seam: coalescing window for streamed markdown; 0 = synchronous. */
+    readonly flushIntervalMs?: number;
+}
+/**
+ * Root controller: owns the pi-tui instance, the view stack, connection state,
+ * and global keys (view cycling, cancel, quit, thinking toggle, help).
+ */
+export declare class MonoAgentTuiApp {
+    readonly tui: TUI;
+    private readonly options;
+    private readonly header;
+    private readonly viewHost;
+    private readonly statusBar;
+    private readonly chat;
+    private readonly picker;
+    private readonly replay;
+    private readonly config;
+    private view;
+    private helpVisible;
+    private helpHandle;
+    /** Candidate models advertised by the connected agent's `/v1/info` (primary first, then fallbacks). */
+    private availableModels;
+    /** Per-model effort/reasoning/mode/label options from `/v1/info` (keyed by model ref); drives the model-aware effort picker + `/model` row annotations. */
+    private modelOptions;
+    /** The connected agent's own default model ref (from `/v1/info`) — the effort picker's effective model when no `/model` override is active. */
+    private agentModel;
+    /** The single open picker overlay (model or effort); only one at a time. */
+    private activePicker;
+    private ctrlCArmedAt;
+    private exitResolve;
+    private readonly exitPromise;
+    private stopped;
+    constructor(options: MonoAgentTuiAppOptions);
+    start(): void;
+    waitUntilExit(): Promise<void>;
+    stop(): void;
+    showView(view: TuiViewId): void;
+    private wireInitialMode;
+    private refreshInstances;
+    private connectTo;
+    /**
+     * Apply a `/v1/info` snapshot's model/effort to the status bar. Unlike the
+     * per-turn finish-metadata correction in ChatView (a delta that never
+     * clears), `info` is a full snapshot of the *newly selected agent* — an
+     * absent `effort` here means this agent genuinely has none configured, so
+     * clearing is correct: otherwise a stale effort from a previously
+     * connected agent would misattribute to this one.
+     */
+    private applyAgentInfo;
+    private applyStaticIdentity;
+    private updateHeader;
+    private handleGlobalInput;
+    /**
+     * Tab/`?` act as global shortcuts (view cycling, help) everywhere except
+     * chat with unsubmitted editor text -- there they pass through to the
+     * editor instead (autocomplete completion / literal `?`). Shared by both
+     * keys so the "empty editor" exception can't drift out of sync between them.
+     */
+    private globalShortcutsAllowedInChat;
+    private cycleView;
+    private handleSlashCommand;
+    private showHelp;
+    private hideHelp;
+    /**
+     * `/model` — with an argument, set (or, for `default`, clear) the session
+     * model override directly; with no argument, open the picker overlay. An
+     * override to a different model runs each turn as a fresh provider session.
+     */
+    private handleModelCommand;
+    private showModelPicker;
+    /**
+     * `/effort` — with an argument, set (or, for `default`, clear) the session
+     * effort override directly; with no argument, open the model-aware picker.
+     */
+    private handleEffortCommand;
+    /**
+     * Model-aware effort picker: the effective model is the `/model` override if
+     * set, else the agent's default. The rows depend on that model's advertised
+     * `reasoningMode`:
+     * - `reasoning: false` / mode `"none"` / empty `effortLevels` → no adjustable
+     *   effort, so we surface a persistent notice instead of an empty picker.
+     * - mode `"toggle"` (binary-thinking local models, e.g. Ollama qwen3.6) → a
+     *   two-row on/off picker; graded levels would misrepresent the model.
+     * - mode `"effort"` with `effortLevels` → those graded levels (local models).
+     * - no mode / no levels (cloud models) → the global {@link EFFORT_LEVELS} enum.
+     */
+    private showEffortPicker;
+    /**
+     * Open a modal select overlay (the model and effort pickers share this).
+     * `onChoose` handles the picked item; the overlay always closes afterward.
+     * nonCapturing keeps input routed through the global listener (which drives
+     * the list explicitly and swallows the rest), so the overlay never contends
+     * for focus with the chat editor underneath it.
+     */
+    private openPickerOverlay;
+    private closePicker;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/ui/app.d.ts.map

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