@pentoshi/clai 2.0.61 → 3.0.0

package/dist/tui-v2/bootstrap/lifecycle.js

@@ -0,0 +1,123 @@
+/**
+ * Renderer lifecycle owner (V2-030).
+ *
+ * Bootstrap creates the renderer, controllers, and stores inside one `try` and
+ * tears them down in `finally`. This object centralizes that contract: it
+ * installs bounded signal/error handlers, tears resources down in reverse order
+ * exactly once, and guarantees the renderer is destroyed (so alternate-screen
+ * reset bytes flush) BEFORE the process exits. The terminal must never be left
+ * corrupted, so destruction is idempotent and covered by signal/error tests.
+ */
+/** Double-SIGINT quit window — matches the App Ctrl+C exit window. */
+export const SIGINT_QUIT_WINDOW_MS = 1500;
+const FATAL_SIGNALS = {
+    SIGTERM: 143,
+    SIGHUP: 129,
+};
+export class RendererLifecycle {
+    options;
+    proc;
+    disposers;
+    started = false;
+    shuttingDown = false;
+    destroyed = false;
+    lastSigintAt = 0;
+    listeners = [];
+    constructor(options) {
+        this.options = options;
+        this.proc = options.process ?? process;
+        this.disposers = [...(options.disposers ?? [])];
+    }
+    get isDestroyed() {
+        return this.destroyed;
+    }
+    /** Install handlers and hand the terminal to the renderer. */
+    async start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.installHandlers();
+        try {
+            await this.options.handle.start();
+        }
+        catch (error) {
+            // Never leave the terminal in the alternate screen if start failed.
+            await this.shutdown();
+            throw error;
+        }
+    }
+    /**
+     * Idempotent teardown: dispose extra resources in reverse order, then destroy
+     * the renderer. Safe to call from multiple signals/error paths concurrently.
+     */
+    async shutdown() {
+        if (this.shuttingDown)
+            return;
+        this.shuttingDown = true;
+        this.removeHandlers();
+        for (let i = this.disposers.length - 1; i >= 0; i--) {
+            const disposer = this.disposers[i];
+            if (!disposer)
+                continue;
+            try {
+                await disposer();
+            }
+            catch (error) {
+                this.options.onError?.(error);
+            }
+        }
+        if (!this.destroyed) {
+            this.destroyed = true;
+            await this.options.handle.destroy();
+        }
+    }
+    /** Tear down fully, then exit — destroy always precedes exit. */
+    async shutdownAndExit(code) {
+        await this.shutdown();
+        this.proc.exit(code);
+    }
+    installHandlers() {
+        // SIGINT is cooperative: first press aborts / arms quit, second exits.
+        // Immediate-exit on SIGINT made the first Ctrl+C kill clai even when the
+        // App only wanted to abort the agent.
+        this.addListener("SIGINT", () => {
+            const now = Date.now();
+            if (this.lastSigintAt > 0 &&
+                now - this.lastSigintAt < SIGINT_QUIT_WINDOW_MS) {
+                void this.shutdownAndExit(130);
+                return;
+            }
+            this.lastSigintAt = now;
+            try {
+                this.options.onSigint?.();
+            }
+            catch (error) {
+                this.options.onError?.(error);
+            }
+        });
+        for (const [signal, code] of Object.entries(FATAL_SIGNALS)) {
+            this.addListener(signal, () => {
+                void this.shutdownAndExit(code);
+            });
+        }
+        this.addListener("uncaughtException", (error) => {
+            this.options.onError?.(error);
+            void this.shutdownAndExit(1);
+        });
+        this.addListener("unhandledRejection", (reason) => {
+            this.options.onError?.(reason);
+            void this.shutdownAndExit(1);
+        });
+    }
+    addListener(event, fn) {
+        this.proc.on(event, fn);
+        this.listeners.push({ event, fn });
+    }
+    removeHandlers() {
+        for (const { event, fn } of this.listeners) {
+            this.proc.off(event, fn);
+        }
+        this.listeners.length = 0;
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/tui-v2/bootstrap/lifecycle.js.map

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

package/dist/tui-v2/bootstrap/osc52-clipboard.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Renderer-facing OSC 52 clipboard adapter (V2-064).
+ *
+ * The native renderer performs OSC encoding and terminal writes. This adapter
+ * only chooses a bounded, capability-checked path and otherwise delegates to
+ * the supplied non-terminal clipboard port.
+ */
+import type { ClipboardPort } from "../../app/ports/clipboard-port.js";
+export interface Osc52RendererPort {
+    isOsc52Supported(): boolean;
+    copyToClipboardOSC52(text: string): boolean;
+}
+export type Osc52FallbackReason = "disabled" | "unsupported" | "too-large" | "rejected" | "failed";
+export interface Osc52CopyResult {
+    readonly method: "osc52" | "fallback";
+    readonly reason?: Osc52FallbackReason;
+}
+export interface Osc52ClipboardPort extends ClipboardPort {
+    readonly lastWrite: Osc52CopyResult | undefined;
+}
+export interface Osc52ClipboardOptions {
+    readonly renderer: Osc52RendererPort;
+    readonly fallback: ClipboardPort;
+    readonly enabled: boolean;
+    /** Bound terminal payload size; oversized text remains available via fallback. */
+    readonly maxBytes?: number;
+}
+export declare function createOsc52ClipboardPort(options: Osc52ClipboardOptions): Osc52ClipboardPort;

package/dist/tui-v2/bootstrap/osc52-clipboard.js

@@ -0,0 +1,44 @@
+/**
+ * Renderer-facing OSC 52 clipboard adapter (V2-064).
+ *
+ * The native renderer performs OSC encoding and terminal writes. This adapter
+ * only chooses a bounded, capability-checked path and otherwise delegates to
+ * the supplied non-terminal clipboard port.
+ */
+const DEFAULT_MAX_BYTES = 100_000;
+export function createOsc52ClipboardPort(options) {
+    const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 0) {
+        throw new Error("OSC 52 maxBytes must be a non-negative safe integer");
+    }
+    let lastWrite;
+    return {
+        get lastWrite() {
+            return lastWrite;
+        },
+        async writeText(text) {
+            const fallbackReason = copyWithOsc52(options, text, maxBytes);
+            if (!fallbackReason) {
+                lastWrite = { method: "osc52" };
+                return;
+            }
+            await options.fallback.writeText(text);
+            lastWrite = { method: "fallback", reason: fallbackReason };
+        },
+    };
+}
+function copyWithOsc52(options, text, maxBytes) {
+    if (!options.enabled)
+        return "disabled";
+    if (Buffer.byteLength(text, "utf8") > maxBytes)
+        return "too-large";
+    try {
+        if (!options.renderer.isOsc52Supported())
+            return "unsupported";
+        return options.renderer.copyToClipboardOSC52(text) ? undefined : "rejected";
+    }
+    catch {
+        return "failed";
+    }
+}
+//# sourceMappingURL=osc52-clipboard.js.map

package/dist/tui-v2/bootstrap/osc52-clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"osc52-clipboard.js","sourceRoot":"","sources":["../../../src/tui-v2/bootstrap/osc52-clipboard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiCH,MAAM,iBAAiB,GAAG,OAAO,CAAC;AAElC,MAAM,UAAU,wBAAwB,CAAC,OAA8B;IACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,SAAsC,CAAC;IAE3C,OAAO;QACL,IAAI,SAAS;YACX,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,IAAY;YAC1B,MAAM,cAAc,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC9D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,SAAS,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;gBAChC,OAAO;YACT,CAAC;YACD,MAAM,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACvC,SAAS,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,OAA8B,EAC9B,IAAY,EACZ,QAAgB;IAEhB,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,UAAU,CAAC;IACxC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,QAAQ;QAAE,OAAO,WAAW,CAAC;IACnE,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE;YAAE,OAAO,aAAa,CAAC;QAC/D,OAAO,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/tui-v2/bootstrap/overlay-ports.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Adapts `OverlayController` into the typed app-layer confirm/secret ports
+ * (CORE-002, V2-073). The agent never reads the terminal directly: it awaits
+ * these promises, which resolve once the user answers the rendered modal.
+ * Prompt text is ported from the classic TUI's `confirm.ts` so both
+ * frontends read the same way.
+ */
+import type { ConfirmationPort } from "../../app/ports/confirm-port.js";
+import type { SecretPort } from "../../app/ports/secret-port.js";
+import type { OverlayController } from "../controllers/overlay-controller.js";
+export declare function createOverlayConfirmPort(overlay: OverlayController): ConfirmationPort;
+export declare function createOverlaySecretPort(overlay: OverlayController): SecretPort["request"];

package/dist/{tui/confirm.js → tui-v2/bootstrap/overlay-ports.js}

@@ -1,3 +1,10 @@
+/**
+ * Adapts `OverlayController` into the typed app-layer confirm/secret ports
+ * (CORE-002, V2-073). The agent never reads the terminal directly: it awaits
+ * these promises, which resolve once the user answers the rendered modal.
+ * Prompt text is ported from the classic TUI's `confirm.ts` so both
+ * frontends read the same way.
+ */
 function describeCall(call) {
     if (call.name === "shell.exec")
         return String(call.args.command ?? "");
@@ -9,47 +16,32 @@ function describeCall(call) {
         return "";
     }
 }
-export function createTuiConfirmPort() {
-    let handler;
-    const ask = async (req) => {
-        if (!handler)
-            return false;
-        return handler(req);
-    };
-    const port = {
+export function createOverlayConfirmPort(overlay) {
+    return {
         async confirmTool(call) {
             const args = describeCall(call);
-            return ask({
-                kind: "tool",
-                prompt: `Run ${call.name}${args ? ` ${args}` : ""}?`,
-            });
+            return overlay.openConfirm({ kind: "tool", prompt: `Run ${call.name}${args ? ` ${args}` : ""}?` });
         },
         async confirmPentest() {
-            return ask({
+            return overlay.openConfirm({
                 kind: "pentest",
                 prompt: "This is a security/pentest action. Confirm you are authorized to run it against this target.",
             });
         },
         async confirmContinue(steps) {
-            return ask({
-                kind: "continue",
-                prompt: `${steps} steps reached — continue running?`,
-            });
+            return overlay.openConfirm({ kind: "continue", prompt: `${steps} steps reached — continue running?` });
         },
         async confirmAgentSwitch(info) {
             const tools = info.tools.length > 0 ? ` (${info.tools.join(", ")})` : "";
             const why = info.reason ? `${info.reason}\n\n` : "";
-            return ask({
+            return overlay.openConfirm({
                 kind: "switch",
                 prompt: `${why}This needs agent mode${tools}, which ask mode can't do. Switch to agent mode and run it?`,
             });
         },
     };
-    return {
-        port,
-        setHandler(h) {
-            handler = h;
-        },
-    };
 }
-//# sourceMappingURL=confirm.js.map
+export function createOverlaySecretPort(overlay) {
+    return (request) => overlay.openSecret(request);
+}
+//# sourceMappingURL=overlay-ports.js.map

package/dist/tui-v2/bootstrap/overlay-ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-ports.js","sourceRoot":"","sources":["../../../src/tui-v2/bootstrap/overlay-ports.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,SAAS,YAAY,CAAC,IAAc;IAClC,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAA0B;IACjE,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,IAAc;YAC9B,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,KAAK,CAAC,cAAc;YAClB,OAAO,OAAO,CAAC,WAAW,CAAC;gBACzB,IAAI,EAAE,SAAS;gBACf,MAAM,EACJ,8FAA8F;aACjG,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,KAAa;YACjC,OAAO,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,oCAAoC,EAAE,CAAC,CAAC;QACzG,CAAC;QACD,KAAK,CAAC,kBAAkB,CAAC,IAAyC;YAChE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,OAAO,OAAO,CAAC,WAAW,CAAC;gBACzB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,GAAG,GAAG,wBAAwB,KAAK,6DAA6D;aACzG,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAA0B;IAChE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/tui-v2/bootstrap/pager-export.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pager export to real terminal scrollback and `$EDITOR` (PICK-003, V2-074).
+ *
+ * Both paths need the real terminal back, not the alternate-screen buffer:
+ * `renderer.suspend()`/`resume()` (used elsewhere for foreground child
+ * processes) hands it over temporarily. Scrollback export just prints to the
+ * now-restored main screen so the content lands in the terminal emulator's
+ * own scrollback; editor export additionally spawns `$EDITOR`/`$PAGER` with
+ * inherited stdio over a temp file. Neither result is read back — this is a
+ * read-only export of pager content, not a round-trip edit.
+ */
+export interface RendererSuspendPort {
+    suspend(): void;
+    resume(): void;
+}
+export interface PagerExportResult {
+    readonly ok: boolean;
+    readonly error?: string;
+}
+export interface PagerExportPort {
+    exportToScrollback(title: string, body: string): PagerExportResult;
+    exportToEditor(body: string): Promise<PagerExportResult>;
+}
+export declare function createPagerExportPort(renderer: RendererSuspendPort): PagerExportPort;

package/dist/tui-v2/bootstrap/pager-export.js

@@ -0,0 +1,87 @@
+/**
+ * Pager export to real terminal scrollback and `$EDITOR` (PICK-003, V2-074).
+ *
+ * Both paths need the real terminal back, not the alternate-screen buffer:
+ * `renderer.suspend()`/`resume()` (used elsewhere for foreground child
+ * processes) hands it over temporarily. Scrollback export just prints to the
+ * now-restored main screen so the content lands in the terminal emulator's
+ * own scrollback; editor export additionally spawns `$EDITOR`/`$PAGER` with
+ * inherited stdio over a temp file. Neither result is read back — this is a
+ * read-only export of pager content, not a round-trip edit.
+ */
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { execa } from "execa";
+function defaultEditor() {
+    return process.env.EDITOR || process.env.VISUAL || (process.platform === "win32" ? "notepad" : "vi");
+}
+/**
+ * Ensure text lands on the main-screen scrollback, not the alt buffer.
+ * OpenTUI's suspend leaves alt-screen; we still force main-screen CSI so
+ * dumps survive after resume (and after the process exits).
+ */
+function writeToMainScrollback(title, body) {
+    // Leave alt screen if still active, then print a clear dump block.
+    process.stdout.write("\x1b[?1049l");
+    const header = `\n\n── clai export: ${title} ──\n`;
+    const footer = `\n── end export ──\n\n`;
+    process.stdout.write(header);
+    process.stdout.write(body.endsWith("\n") ? body : `${body}\n`);
+    process.stdout.write(footer);
+    // Flush so the terminal emulator commits to its scrollback before we
+    // re-enter the alternate screen on resume.
+    try {
+        // @types/node: WriteStream has cork/uncork; force sync flush best-effort.
+        const out = process.stdout;
+        out._handle?.setBlocking?.(true);
+    }
+    catch {
+        // ignore
+    }
+}
+export function createPagerExportPort(renderer) {
+    return {
+        exportToScrollback(title, body) {
+            try {
+                renderer.suspend();
+                writeToMainScrollback(title, body);
+                return { ok: true };
+            }
+            catch (error) {
+                return { ok: false, error: error instanceof Error ? error.message : String(error) };
+            }
+            finally {
+                try {
+                    renderer.resume();
+                }
+                catch {
+                    // Always try to restore the TUI even if resume throws.
+                }
+            }
+        },
+        async exportToEditor(body) {
+            const dir = await mkdtemp(join(tmpdir(), "clai-pager-"));
+            const file = join(dir, "output.txt");
+            try {
+                await writeFile(file, body, "utf8");
+                renderer.suspend();
+                await execa(defaultEditor(), [file], { stdio: "inherit" });
+                return { ok: true };
+            }
+            catch (error) {
+                return { ok: false, error: error instanceof Error ? error.message : String(error) };
+            }
+            finally {
+                try {
+                    renderer.resume();
+                }
+                catch {
+                    // ignore
+                }
+                await rm(dir, { recursive: true, force: true }).catch(() => { });
+            }
+        },
+    };
+}
+//# sourceMappingURL=pager-export.js.map

package/dist/tui-v2/bootstrap/pager-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pager-export.js","sourceRoot":"","sources":["../../../src/tui-v2/bootstrap/pager-export.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAiB9B,SAAS,aAAa;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACvG,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,KAAa,EAAE,IAAY;IACxD,mEAAmE;IACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,uBAAuB,KAAK,OAAO,CAAC;IACnD,MAAM,MAAM,GAAG,wBAAwB,CAAC;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,qEAAqE;IACrE,2CAA2C;IAC3C,IAAI,CAAC;QACH,0EAA0E;QAC1E,MAAM,GAAG,GAAG,OAAO,CAAC,MAAmF,CAAC;QACxG,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAA6B;IACjE,OAAO;QACL,kBAAkB,CAAC,KAAK,EAAE,IAAI;YAC5B,IAAI,CAAC;gBACH,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACnB,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACnC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACtF,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC;oBACH,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACpB,CAAC;gBAAC,MAAM,CAAC;oBACP,uDAAuD;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,IAAI;YACvB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;YACzD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;gBACpC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,KAAK,CAAC,aAAa,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC3D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACtF,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC;oBACH,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACpB,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBACD,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tui-v2/bootstrap/start-tui-v2.d.ts

@@ -0,0 +1,15 @@
+/**
+ * v2 renderer entry point (V2-030/031/034).
+ *
+ * Assembles the composition root, creates the OpenTUI renderer in the alternate
+ * screen, mounts the shell, and hands ownership to `RendererLifecycle` so
+ * signals/errors tear the renderer down before the process exits.
+ */
+import type { Mode, ProviderId } from "../../types.js";
+export interface StartTuiV2Options {
+    readonly mode?: Mode | undefined;
+    readonly provider?: ProviderId | undefined;
+    readonly model?: string | undefined;
+    readonly noHistory?: boolean | undefined;
+}
+export declare function startTuiV2(options?: StartTuiV2Options): Promise<void>;

package/dist/tui-v2/bootstrap/start-tui-v2.js

@@ -0,0 +1,95 @@
+/**
+ * v2 renderer entry point (V2-030/031/034).
+ *
+ * Assembles the composition root, creates the OpenTUI renderer in the alternate
+ * screen, mounts the shell, and hands ownership to `RendererLifecycle` so
+ * signals/errors tear the renderer down before the process exits.
+ */
+import { createElement } from "react";
+import { createCliRenderer } from "@opentui/core";
+import { createRoot } from "@opentui/react";
+import { createInMemoryClipboardPort } from "../../app/adapters/in-memory-clipboard-adapter.js";
+import { App } from "../app/App.js";
+import { ServicesProvider } from "../app/providers.js";
+import { attachCommandHandlers } from "../app/command-handlers.js";
+import { readCapabilitiesFromProcess } from "./capabilities.js";
+import { createCompositionRoot } from "./composition-root.js";
+import { RendererLifecycle } from "./lifecycle.js";
+import { createOsc52ClipboardPort } from "./osc52-clipboard.js";
+import { createPagerExportPort } from "./pager-export.js";
+export async function startTuiV2(options = {}) {
+    // OpenTUI native drag-select is enabled. Interactive chrome (prompts/tools/
+    // composer) sets selectable={false}; response/thinking body stays selectable.
+    // Copy-on-release is wired in TranscriptView via useNativeSelectionCopy.
+    const capabilities = readCapabilitiesFromProcess();
+    const fallbackClipboard = createInMemoryClipboardPort();
+    // We own Ctrl+C (abort then double-press exit). OpenTUI must not kill the
+    // process on the first press, and SIGINT is handled cooperatively below.
+    const renderer = await createCliRenderer({
+        screenMode: "alternate-screen",
+        exitOnCtrlC: false,
+        useMouse: true,
+        clearOnShutdown: true,
+    });
+    // lifecycle is assigned before requestExit runs; use a holder so the
+    // composition root can close over a stable callback.
+    const lifecycleRef = {
+        current: undefined,
+    };
+    const services = createCompositionRoot({
+        provider: options.provider,
+        model: options.model,
+        mode: options.mode,
+        noHistory: options.noHistory,
+        capabilities,
+        clipboard: createOsc52ClipboardPort({
+            renderer,
+            fallback: fallbackClipboard,
+            enabled: capabilities.osc52,
+        }),
+        pagerExport: createPagerExportPort(renderer),
+        requestExit: () => void lifecycleRef.current?.shutdownAndExit(0),
+    });
+    attachCommandHandlers(services);
+    const root = createRoot(renderer);
+    let resolveDone = () => { };
+    const done = new Promise((resolve) => {
+        resolveDone = resolve;
+    });
+    const handle = {
+        start() {
+            root.render(createElement(ServicesProvider, { services, children: createElement(App) }));
+        },
+        destroy() {
+            root.unmount();
+            renderer.destroy();
+            services.dispose();
+            resolveDone();
+        },
+    };
+    const lifecycle = new RendererLifecycle({
+        handle,
+        // Ctrl+C / SIGINT: first signal aborts a live turn (or arms quit via the
+        // App handler path when the key event arrives). A second SIGINT within
+        // the window still exits so kill -INT remains usable without the TUI.
+        onSigint: () => {
+            // Backup path when the key event is not delivered (raw SIGINT). The App
+            // keyboard handler owns the normal Ctrl+C double-press UX.
+            if (services.session.getState().running) {
+                services.session.abort();
+                services.session.notice("info", "turn aborted · Ctrl+C again to exit");
+            }
+            else {
+                services.session.notice("info", "Ctrl+C again to exit");
+            }
+        },
+        onError: (error) => {
+            // The renderer owns the terminal; surface the error after teardown.
+            process.stderr.write(`clai v2 error: ${error instanceof Error ? error.message : String(error)}\n`);
+        },
+    });
+    lifecycleRef.current = lifecycle;
+    await lifecycle.start();
+    await done;
+}
+//# sourceMappingURL=start-tui-v2.js.map

package/dist/tui-v2/bootstrap/start-tui-v2.js.map

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

package/dist/tui-v2/bootstrap/ui-selection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Interactive frontend selection for clai 3.x.
+ *
+ * Default: OpenTUI full-screen TUI.
+ * Opt-out: classic line REPL via `--classic`, `--ui=legacy`, or CLAI_CLASSIC=1.
+ *
+ * `--ui=tui` / `--ui=v2` / CLAI_UI=tui|v2 all resolve to the OpenTUI TUI
+ * (aliases kept so old scripts keep working after the Ink removal).
+ */
+export type UiChoice = "legacy" | "tui";
+export interface UiSelectionOptions {
+    /** Value of the `--ui <choice>` flag, if provided. */
+    readonly ui?: string | undefined;
+    /** `--tui` / `--classic` flags (back-compat). */
+    readonly tui?: boolean | undefined;
+    readonly classic?: boolean | undefined;
+}
+/** True when the resolved frontend is the full-screen OpenTUI. */
+export declare function isTuiRequested(options: UiSelectionOptions, env?: NodeJS.ProcessEnv): boolean;
+/** @deprecated Use {@link isTuiRequested}. Kept for older call sites. */
+export declare function isV2Requested(options: UiSelectionOptions, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Resolve the interactive frontend.
+ *
+ * Precedence: explicit `--ui` → `CLAI_UI` → `--classic`/`CLAI_CLASSIC` →
+ * `--tui` → default TUI.
+ */
+export declare function resolveUiChoice(options: UiSelectionOptions, env?: NodeJS.ProcessEnv): UiChoice;
+/** Human-readable default for doctor/help. */
+export declare function describeUiDefault(): string;

package/dist/tui-v2/bootstrap/ui-selection.js

@@ -0,0 +1,59 @@
+/**
+ * Interactive frontend selection for clai 3.x.
+ *
+ * Default: OpenTUI full-screen TUI.
+ * Opt-out: classic line REPL via `--classic`, `--ui=legacy`, or CLAI_CLASSIC=1.
+ *
+ * `--ui=tui` / `--ui=v2` / CLAI_UI=tui|v2 all resolve to the OpenTUI TUI
+ * (aliases kept so old scripts keep working after the Ink removal).
+ */
+function normalizeUiToken(value) {
+    const token = value?.trim().toLowerCase();
+    return token || undefined;
+}
+function envUiChoice(env) {
+    const token = normalizeUiToken(env.CLAI_UI);
+    if (token === "legacy" || token === "classic")
+        return "legacy";
+    // tui | v2 | opentui → full-screen TUI
+    if (token === "tui" || token === "v2" || token === "opentui")
+        return "tui";
+    return undefined;
+}
+/** True when the resolved frontend is the full-screen OpenTUI. */
+export function isTuiRequested(options, env = process.env) {
+    return resolveUiChoice(options, env) === "tui";
+}
+/** @deprecated Use {@link isTuiRequested}. Kept for older call sites. */
+export function isV2Requested(options, env = process.env) {
+    return isTuiRequested(options, env);
+}
+/**
+ * Resolve the interactive frontend.
+ *
+ * Precedence: explicit `--ui` → `CLAI_UI` → `--classic`/`CLAI_CLASSIC` →
+ * `--tui` → default TUI.
+ */
+export function resolveUiChoice(options, env = process.env) {
+    const flag = normalizeUiToken(options.ui);
+    if (flag === "legacy" || flag === "classic")
+        return "legacy";
+    if (flag === "tui" || flag === "v2" || flag === "opentui")
+        return "tui";
+    const fromEnv = envUiChoice(env);
+    if (fromEnv)
+        return fromEnv;
+    if (options.classic)
+        return "legacy";
+    if (env.CLAI_CLASSIC === "1" || env.CLAI_TUI === "0")
+        return "legacy";
+    // --tui is a no-op affirmation of the default
+    if (options.tui)
+        return "tui";
+    return "tui";
+}
+/** Human-readable default for doctor/help. */
+export function describeUiDefault() {
+    return "tui (OpenTUI); use --classic or --ui=legacy for line REPL";
+}
+//# sourceMappingURL=ui-selection.js.map

package/dist/tui-v2/bootstrap/ui-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-selection.js","sourceRoot":"","sources":["../../../src/tui-v2/bootstrap/ui-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,SAAS,gBAAgB,CAAC,KAAyB;IACjD,MAAM,KAAK,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,OAAO,KAAK,IAAI,SAAS,CAAC;AAC5B,CAAC;AAED,SAAS,WAAW,CAAC,GAAsB;IACzC,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC/D,uCAAuC;IACvC,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC3E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAC5B,OAA2B,EAC3B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,KAAK,CAAC;AACjD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAC3B,OAA2B,EAC3B,MAAyB,OAAO,CAAC,GAAG;IAEpC,OAAO,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA2B,EAC3B,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC7D,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAExE,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC;IACrC,IAAI,GAAG,CAAC,YAAY,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,KAAK,GAAG;QAAE,OAAO,QAAQ,CAAC;IACtE,8CAA8C;IAC9C,IAAI,OAAO,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAE9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB;IAC/B,OAAO,2DAA2D,CAAC;AACrE,CAAC"}

package/dist/tui-v2/components/completion/completion-menu.d.ts

@@ -0,0 +1,23 @@
+/** @jsxImportSource @opentui/react */
+/**
+ * Slash / @-mention completion list rendered ABOVE the composer (legacy parity).
+ * Rows are mouse-hoverable and clickable (pickers parity).
+ */
+import type { ReactNode } from "react";
+import type { Theme } from "../../rendering/theme.js";
+import type { CompletionMenu } from "../../composer/completion.js";
+export interface CompletionMenuViewProps {
+    readonly menu: CompletionMenu;
+    readonly selected: number;
+    readonly theme: Theme;
+    readonly width: number;
+    readonly maxRows?: number | undefined;
+    /** Highlight the row under the mouse (keyboard selection stays independent). */
+    readonly onHoverIndex?: ((index: number) => void) | undefined;
+    /**
+     * Activate a row on click.
+     * Slash / file → accept; directory → typically drill (caller decides).
+     */
+    readonly onActivateIndex?: ((index: number) => void) | undefined;
+}
+export declare function CompletionMenuView(props: CompletionMenuViewProps): ReactNode;