@pentoshi/clai 2.0.62 → 3.5.1

package/dist/tui-v2/app/plan-lifecycle.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Plan approval/implement/discard orchestration (PLAN-004, F-021/023, V2-070/073).
+ *
+ * Mirrors the classic TUI's `/implement` path: approve the persisted plan, flip
+ * the session policy flag the agent gate reads, then run the implement prompt.
+ * Kept out of `PlanController` (persistence only) and out of components.
+ */
+import type { SessionPlan } from "../../store/plan.js";
+import type { AppServices } from "../bootstrap/composition-root.js";
+/** Coding / build plans — scaffold + verify. */
+export declare const IMPLEMENT_PROMPT_CODING: string;
+/** Pentest / security plans — no local dev-server assumption. */
+export declare const IMPLEMENT_PROMPT_PENTEST: string;
+export declare const IMPLEMENT_PROMPT: string;
+export declare function buildImplementPrompt(plan: SessionPlan): string;
+export declare function implementPlan(services: AppServices): Promise<void>;
+export declare function discardPlan(services: AppServices): Promise<void>;
+/**
+ * After a turn ends, if a draft plan is waiting, open the plan-ready confirm.
+ * "P" views full plan detail via the suspended-over-confirm pager path.
+ */
+export declare function promptPlanApprovalIfNeeded(services: AppServices): Promise<void>;

package/dist/tui-v2/app/plan-lifecycle.js

@@ -0,0 +1,95 @@
+/**
+ * Plan approval/implement/discard orchestration (PLAN-004, F-021/023, V2-070/073).
+ *
+ * Mirrors the classic TUI's `/implement` path: approve the persisted plan, flip
+ * the session policy flag the agent gate reads, then run the implement prompt.
+ * Kept out of `PlanController` (persistence only) and out of components.
+ */
+/** Coding / build plans — scaffold + verify. */
+export const IMPLEMENT_PROMPT_CODING = "I approve the plan. Execute it now in STRICT ORDER. " +
+    "Start with the FIRST pending task that still needs work (skip only tasks already marked done). " +
+    "For each task: call task.update {taskId, state:'in_progress'} → do the real work → VERIFY it succeeded → " +
+    "call task.update {taskId, state:'done'}, then move to the NEXT task. " +
+    "If a tool call FAILS, mark the task 'failed', fix the problem, and retry. Do NOT mark a task done when it failed. " +
+    "Do NOT skip ahead to later tasks while earlier ones are still pending. " +
+    "Build for real with fs.write / fs.writeMany when the plan requires files. " +
+    "Run real commands when needed — do not claim anything ran without a successful tool call.";
+/** Pentest / security plans — no local dev-server assumption. */
+export const IMPLEMENT_PROMPT_PENTEST = "I approve the plan. Execute the engagement tasks in STRICT ORDER. " +
+    "Start with the FIRST pending task; do NOT skip to later tasks while earlier ones are still pending. " +
+    "For each task: task.update in_progress → do the recon/testing work with tools → task.update done (or failed with a note). " +
+    "Prefer tool.batch / dns / http.fetch / net.scan for recon; continue when one lookup fails. " +
+    "Do NOT start a local dev server, npm run dev, bun run, vite, next, or shell.start. " +
+    "Do NOT list or read the clai workspace/package.json as a follow-up. Stay on the remote engagement target/scope. " +
+    "When all tasks are done, write the report if needed and STOP with findings — no localhost step.";
+export const IMPLEMENT_PROMPT = IMPLEMENT_PROMPT_CODING;
+/**
+ * When the user implements/discards from the plan pane, the chat plan-ready
+ * confirm must not also run implement/discard (double-queue / double-discard).
+ */
+let planDecisionHandled = false;
+function dismissPlanConfirmIfOpen(services, asYes) {
+    const state = services.overlay.getState();
+    if (state.kind === "confirm" && state.request.kind === "plan") {
+        services.overlay.answerConfirm(asYes);
+    }
+}
+export function buildImplementPrompt(plan) {
+    if (plan.kind === "pentest")
+        return IMPLEMENT_PROMPT_PENTEST;
+    return IMPLEMENT_PROMPT_CODING;
+}
+export async function implementPlan(services) {
+    const plan = services.plan.current();
+    if (!plan)
+        return;
+    if (plan.tasks.length > 0 && plan.tasks.every((t) => t.state === "done"))
+        return;
+    // Pane click wins: mark handled, close chat confirm so Y/N can't re-queue.
+    planDecisionHandled = true;
+    dismissPlanConfirmIfOpen(services, true);
+    await services.plan.approve();
+    services.session.setPlanApproved(true);
+    const prompt = buildImplementPrompt(plan);
+    if (services.session.getState().running) {
+        services.session.enqueue(prompt);
+    }
+    else {
+        await services.session.submit(prompt);
+    }
+}
+export async function discardPlan(services) {
+    planDecisionHandled = true;
+    dismissPlanConfirmIfOpen(services, false);
+    await services.plan.discard();
+    services.session.setPlanApproved(false);
+}
+/**
+ * After a turn ends, if a draft plan is waiting, open the plan-ready confirm.
+ * "P" views full plan detail via the suspended-over-confirm pager path.
+ */
+export async function promptPlanApprovalIfNeeded(services) {
+    if (services.session.isPlanApproved())
+        return;
+    if (services.overlay.isOpen())
+        return;
+    const plan = services.plan.current();
+    if (!plan || plan.status !== "draft" || plan.tasks.length === 0)
+        return;
+    planDecisionHandled = false;
+    const ok = await services.overlay.openConfirm({
+        kind: "plan",
+        prompt: `Implement this plan now? "${plan.goal}" — ${plan.tasks.length} task(s). (Y to implement · N to discard)`,
+    }, async () => {
+        const { formatPlanPagerDocument } = await import("../rendering/plan-view.js");
+        services.overlay.openPager(`Plan · ${plan.goal}`, formatPlanPagerDocument(plan));
+    });
+    // Plan pane already implemented/discarded while this confirm was open.
+    if (planDecisionHandled)
+        return;
+    if (ok)
+        await implementPlan(services);
+    else
+        await discardPlan(services);
+}
+//# sourceMappingURL=plan-lifecycle.js.map

package/dist/tui-v2/app/plan-lifecycle.js.map

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

package/dist/tui-v2/app/providers.d.ts

@@ -0,0 +1,17 @@
+/** @jsxImportSource @opentui/react */
+/**
+ * Dependency-injection providers for the v2 shell (V2-031).
+ *
+ * The composition root is created once at bootstrap and handed to the tree
+ * here; components read services through `useServices` instead of importing
+ * singletons, so the same App can be mounted with fakes in a headless renderer.
+ */
+import { type ReactNode } from "react";
+import type { AppServices } from "../bootstrap/composition-root.js";
+import { type Theme } from "../rendering/theme.js";
+export declare function ServicesProvider(props: {
+    services: AppServices;
+    children: ReactNode;
+}): ReactNode;
+export declare function useServices(): AppServices;
+export declare function useTheme(): Theme;

package/dist/tui-v2/app/providers.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx } from "@opentui/react/jsx-runtime";
+/** @jsxImportSource @opentui/react */
+/**
+ * Dependency-injection providers for the v2 shell (V2-031).
+ *
+ * The composition root is created once at bootstrap and handed to the tree
+ * here; components read services through `useServices` instead of importing
+ * singletons, so the same App can be mounted with fakes in a headless renderer.
+ */
+import { createContext, useContext } from "react";
+import { themeFor } from "../rendering/theme.js";
+const ServicesContext = createContext(null);
+export function ServicesProvider(props) {
+    const value = {
+        services: props.services,
+        theme: themeFor(props.services.capabilities.themeHint),
+    };
+    return (_jsx(ServicesContext.Provider, { value: value, children: props.children }));
+}
+export function useServices() {
+    const ctx = useContext(ServicesContext);
+    if (!ctx)
+        throw new Error("useServices must be used within a ServicesProvider");
+    return ctx.services;
+}
+export function useTheme() {
+    const ctx = useContext(ServicesContext);
+    if (!ctx)
+        throw new Error("useTheme must be used within a ServicesProvider");
+    return ctx.theme;
+}
+//# sourceMappingURL=providers.js.map

package/dist/tui-v2/app/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../../src/tui-v2/app/providers.tsx"],"names":[],"mappings":";AAAA,sCAAsC;AACtC;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAc,MAAM,uBAAuB,CAAC;AAO7D,MAAM,eAAe,GAAG,aAAa,CAA8B,IAAI,CAAC,CAAC;AAEzE,MAAM,UAAU,gBAAgB,CAAC,KAGhC;IACC,MAAM,KAAK,GAAyB;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC;KACvD,CAAC;IACF,OAAO,CACL,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACnC,KAAK,CAAC,QAAQ,GACU,CAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAChF,OAAO,GAAG,CAAC,QAAQ,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,MAAM,GAAG,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC7E,OAAO,GAAG,CAAC,KAAK,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,35 @@
+/**
+ * Renderer-independent terminal capability detection (V2-030).
+ *
+ * Pure function of an injected environment snapshot so capability decisions are
+ * unit-testable without a live TTY. The renderer adapter feeds this the real
+ * `process.env`/stdio at bootstrap; nothing here writes terminal bytes.
+ */
+import type { ColorMode } from "../../app/ports/terminal-port.js";
+export type ThemeHint = "dark" | "light" | "unknown";
+export interface CapabilityEnv {
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly stdoutIsTTY: boolean;
+    readonly stdinIsTTY: boolean;
+    readonly columns: number | undefined;
+    readonly rows: number | undefined;
+}
+export interface TerminalCapabilityReport {
+    readonly isTTY: boolean;
+    readonly columns: number;
+    readonly rows: number;
+    readonly colorMode: ColorMode;
+    readonly noColor: boolean;
+    /** Kitty/CSI-u keyboard protocol; lets Shift+Enter differ from Enter. */
+    readonly kittyKeyboard: boolean;
+    readonly canDistinguishShiftEnter: boolean;
+    readonly mouse: boolean;
+    readonly unicode: boolean;
+    readonly osc52: boolean;
+    readonly reducedMotion: boolean;
+    readonly themeHint: ThemeHint;
+}
+export declare const DEFAULT_COLUMNS = 80;
+export declare const DEFAULT_ROWS = 24;
+export declare function detectCapabilities(input: CapabilityEnv): TerminalCapabilityReport;
+export declare function readCapabilitiesFromProcess(): TerminalCapabilityReport;

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

@@ -0,0 +1,93 @@
+/**
+ * Renderer-independent terminal capability detection (V2-030).
+ *
+ * Pure function of an injected environment snapshot so capability decisions are
+ * unit-testable without a live TTY. The renderer adapter feeds this the real
+ * `process.env`/stdio at bootstrap; nothing here writes terminal bytes.
+ */
+export const DEFAULT_COLUMNS = 80;
+export const DEFAULT_ROWS = 24;
+const TRUECOLOR_TERMS = ["iterm", "kitty", "wezterm", "ghostty", "vte", "alacritty"];
+const KITTY_KEYBOARD_TERMS = ["kitty", "ghostty", "wezterm", "foot"];
+function truthy(value) {
+    if (value === undefined)
+        return false;
+    const v = value.trim().toLowerCase();
+    return v !== "" && v !== "0" && v !== "false" && v !== "no";
+}
+function detectColorMode(env, isTTY) {
+    // NO_COLOR is a hard opt-out regardless of terminal support.
+    if (env.NO_COLOR !== undefined && env.NO_COLOR !== "") {
+        return { colorMode: "none", noColor: true };
+    }
+    if (!isTTY)
+        return { colorMode: "none", noColor: false };
+    const colorterm = (env.COLORTERM ?? "").toLowerCase();
+    const term = (env.TERM ?? "").toLowerCase();
+    const termProgram = (env.TERM_PROGRAM ?? "").toLowerCase();
+    if (colorterm === "truecolor" || colorterm === "24bit") {
+        return { colorMode: "truecolor", noColor: false };
+    }
+    if (TRUECOLOR_TERMS.some((t) => termProgram.includes(t) || term.includes(t))) {
+        return { colorMode: "truecolor", noColor: false };
+    }
+    if (term.includes("256"))
+        return { colorMode: "256", noColor: false };
+    if (term === "" || term === "dumb")
+        return { colorMode: "none", noColor: false };
+    return { colorMode: "16", noColor: false };
+}
+function detectKittyKeyboard(env) {
+    const term = (env.TERM ?? "").toLowerCase();
+    const termProgram = (env.TERM_PROGRAM ?? "").toLowerCase();
+    return KITTY_KEYBOARD_TERMS.some((t) => term.includes(t) || termProgram.includes(t));
+}
+function detectUnicode(env) {
+    const locale = `${env.LC_ALL ?? ""}${env.LC_CTYPE ?? ""}${env.LANG ?? ""}`;
+    if (locale === "")
+        return true; // assume modern terminal when unset
+    return /utf-?8/i.test(locale);
+}
+function detectThemeHint(env) {
+    const explicit = (env.CLAI_THEME ?? "").toLowerCase();
+    if (explicit === "dark" || explicit === "light")
+        return explicit;
+    const colorfgbg = env.COLORFGBG;
+    if (colorfgbg) {
+        const parts = colorfgbg.split(";");
+        const bg = Number(parts[parts.length - 1]);
+        if (Number.isFinite(bg))
+            return bg <= 6 ? "dark" : "light";
+    }
+    return "unknown";
+}
+export function detectCapabilities(input) {
+    const { env } = input;
+    const isTTY = input.stdoutIsTTY && input.stdinIsTTY;
+    const { colorMode, noColor } = detectColorMode(env, isTTY);
+    const kittyKeyboard = isTTY && detectKittyKeyboard(env);
+    return {
+        isTTY,
+        columns: input.columns ?? DEFAULT_COLUMNS,
+        rows: input.rows ?? DEFAULT_ROWS,
+        colorMode,
+        noColor,
+        kittyKeyboard,
+        canDistinguishShiftEnter: kittyKeyboard,
+        mouse: isTTY,
+        unicode: detectUnicode(env),
+        osc52: isTTY,
+        reducedMotion: truthy(env.CLAI_REDUCED_MOTION) || truthy(env.NO_MOTION),
+        themeHint: detectThemeHint(env),
+    };
+}
+export function readCapabilitiesFromProcess() {
+    return detectCapabilities({
+        env: process.env,
+        stdoutIsTTY: Boolean(process.stdout.isTTY),
+        stdinIsTTY: Boolean(process.stdin.isTTY),
+        columns: process.stdout.columns,
+        rows: process.stdout.rows,
+    });
+}
+//# sourceMappingURL=capabilities.js.map

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

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

package/dist/tui-v2/bootstrap/composition-root.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Dependency-injection root (V2-031).
+ *
+ * Constructs the ports, controllers, and command registry once at bootstrap
+ * and returns them as an explicit service bundle — no service locator, no
+ * hidden singletons. Every dependency is overridable so the shell can be
+ * assembled with fakes in tests. This module is renderer-independent: it wires
+ * the application layer and input controllers but imports no `@opentui`/React.
+ */
+import type { Mode, ProviderId } from "../../types.js";
+import type { AnyAppEvent } from "../../app/events/app-event.js";
+import type { Clock, IdFactory } from "../../app/events/sequencer.js";
+import type { AgentPort } from "../../app/ports/agent-port.js";
+import type { PersistencePort } from "../../app/ports/persistence-port.js";
+import type { JobsPort } from "../../app/ports/jobs-port.js";
+import type { UpdatesPort } from "../../app/ports/updates-port.js";
+import type { ClipboardPort } from "../../app/ports/clipboard-port.js";
+import type { ConfirmationPort } from "../../app/ports/confirm-port.js";
+import type { SecretPort } from "../../app/ports/secret-port.js";
+import { SessionController } from "../../app/controllers/session-controller.js";
+import { type CommandRegistry } from "../../app/commands/registry.js";
+import { ActionRouter } from "../actions/action-router.js";
+import { FocusController } from "../controllers/focus-controller.js";
+import { SelectionController } from "../controllers/selection-controller.js";
+import { ToastController } from "../controllers/toast-controller.js";
+import { OverlayController } from "../controllers/overlay-controller.js";
+import { TranscriptStore } from "../state/transcript-store.js";
+import { PlanController } from "../../app/controllers/plan-controller.js";
+import type { PagerExportPort } from "./pager-export.js";
+import { type TerminalCapabilityReport } from "./capabilities.js";
+export interface AppPorts {
+    readonly agent: AgentPort;
+    readonly persistence: PersistencePort;
+    readonly jobs: JobsPort;
+    readonly updates: UpdatesPort;
+    readonly clipboard: ClipboardPort;
+    readonly confirm: ConfirmationPort | undefined;
+    readonly requestSecret: SecretPort["request"] | undefined;
+}
+export interface CompositionOptions {
+    readonly agent?: AgentPort | undefined;
+    readonly persistence?: PersistencePort | undefined;
+    readonly jobs?: JobsPort | undefined;
+    readonly updates?: UpdatesPort | undefined;
+    readonly clipboard?: ClipboardPort | undefined;
+    readonly confirm?: ConfirmationPort | undefined;
+    readonly requestSecret?: SecretPort["request"] | undefined;
+    readonly emit?: ((event: AnyAppEvent) => void) | undefined;
+    readonly capabilities?: TerminalCapabilityReport | undefined;
+    /** SEL-006: auto-copy a non-empty mouse selection on release. Default true. */
+    readonly copyOnRelease?: boolean | undefined;
+    readonly pagerExport?: PagerExportPort | undefined;
+    /** Signals the renderer to tear down and exit (Ctrl+D / second Ctrl+C). */
+    readonly requestExit?: (() => void) | undefined;
+    readonly provider?: ProviderId | undefined;
+    readonly model?: string | undefined;
+    readonly mode?: Mode | undefined;
+    /** Skip session persistence + AI titles (CLI --no-history). */
+    readonly noHistory?: boolean | undefined;
+    readonly sessionId?: string | undefined;
+    readonly idFactory?: IdFactory | undefined;
+    readonly clock?: Clock | undefined;
+}
+export interface AppServices {
+    readonly ports: AppPorts;
+    readonly commands: CommandRegistry;
+    readonly session: SessionController;
+    readonly focus: FocusController;
+    readonly router: ActionRouter;
+    /** Single owner for pane-scoped semantic selection and copy requests. */
+    readonly selection: SelectionController;
+    /** Ephemeral right-edge toasts (copy confirmation, short status). */
+    readonly toast: ToastController;
+    readonly transcript: TranscriptStore;
+    readonly plan: PlanController;
+    /** Single owner for the one blocking overlay (picker/confirm/secret/pager/jobs). */
+    readonly overlay: OverlayController;
+    readonly pagerExport: PagerExportPort;
+    readonly requestExit: () => void;
+    readonly capabilities: TerminalCapabilityReport;
+    /** Events captured when no external `emit` sink is supplied (test aid). */
+    readonly recordedEvents: readonly AnyAppEvent[];
+    dispose(): void;
+}
+export declare function createCompositionRoot(options?: CompositionOptions): AppServices;

package/dist/tui-v2/bootstrap/composition-root.js

@@ -0,0 +1,131 @@
+/**
+ * Dependency-injection root (V2-031).
+ *
+ * Constructs the ports, controllers, and command registry once at bootstrap
+ * and returns them as an explicit service bundle — no service locator, no
+ * hidden singletons. Every dependency is overridable so the shell can be
+ * assembled with fakes in tests. This module is renderer-independent: it wires
+ * the application layer and input controllers but imports no `@opentui`/React.
+ */
+import { createCurrentAgentPort } from "../../app/adapters/current-agent-adapter.js";
+import { createCurrentPersistencePort } from "../../app/adapters/current-store-adapter.js";
+import { createCurrentJobsPort } from "../../app/adapters/current-jobs-adapter.js";
+import { createCurrentUpdatesPort } from "../../app/adapters/current-updates-adapter.js";
+import { createInMemoryClipboardPort } from "../../app/adapters/in-memory-clipboard-adapter.js";
+import { SessionController } from "../../app/controllers/session-controller.js";
+import { buildDefaultCommandRegistry, } from "../../app/commands/registry.js";
+import { ActionRouter } from "../actions/action-router.js";
+import { FocusController } from "../controllers/focus-controller.js";
+import { SelectionController } from "../controllers/selection-controller.js";
+import { ToastController } from "../controllers/toast-controller.js";
+import { OverlayController } from "../controllers/overlay-controller.js";
+import { TranscriptStore } from "../state/transcript-store.js";
+import { serializeForHistory } from "../state/transcript-hydrate.js";
+import { PlanController } from "../../app/controllers/plan-controller.js";
+import { createOverlayConfirmPort, createOverlaySecretPort } from "./overlay-ports.js";
+import { detectCapabilities, readCapabilitiesFromProcess, } from "./capabilities.js";
+function noopPagerExportPort() {
+    return {
+        exportToScrollback: () => ({ ok: false, error: "no renderer attached" }),
+        exportToEditor: async () => ({ ok: false, error: "no renderer attached" }),
+    };
+}
+export function createCompositionRoot(options = {}) {
+    const recorded = [];
+    const transcript = new TranscriptStore();
+    const persistence = options.persistence ?? createCurrentPersistencePort();
+    const plan = new PlanController(persistence);
+    const externalEmit = options.emit;
+    // The transcript store and plan controller observe every event
+    // unconditionally; the recorder/external sink split below is unrelated to
+    // that (it is only about where raw AppEvents surface for tests/consumers).
+    const emit = (event) => {
+        transcript.dispatch(event);
+        plan.observe(event);
+        if (externalEmit)
+            externalEmit(event);
+        else
+            recorded.push(event);
+    };
+    const focus = new FocusController();
+    const overlay = new OverlayController(focus);
+    const ports = {
+        agent: options.agent ?? createCurrentAgentPort(),
+        persistence,
+        jobs: options.jobs ?? createCurrentJobsPort(),
+        updates: options.updates ?? createCurrentUpdatesPort(),
+        clipboard: options.clipboard ?? createInMemoryClipboardPort(),
+        confirm: options.confirm ?? createOverlayConfirmPort(overlay),
+        requestSecret: options.requestSecret ?? createOverlaySecretPort(overlay),
+    };
+    const toast = new ToastController();
+    // Auto-copy-on-release disabled — it fought touch/focus/history.
+    // Explicit copy remains via Ctrl+Shift+C (selection.copy).
+    const selection = new SelectionController(ports.clipboard, {
+        copyOnRelease: options.copyOnRelease ?? false,
+    });
+    // Late-bound: session is constructed below; snapshot closes over it.
+    let sessionRef;
+    const session = new SessionController({
+        agent: ports.agent,
+        persistence: ports.persistence,
+        emit,
+        confirm: ports.confirm,
+        requestSecret: ports.requestSecret,
+        provider: options.provider,
+        model: options.model,
+        mode: options.mode,
+        sessionId: options.sessionId,
+        idFactory: options.idFactory,
+        clock: options.clock,
+        noHistory: options.noHistory,
+        getTranscriptSnapshot: () => {
+            const live = sessionRef;
+            if (!live)
+                return undefined;
+            return serializeForHistory(transcript.getState(), (id) => live.spool.tail(id));
+        },
+    });
+    sessionRef = session;
+    const commands = buildDefaultCommandRegistry();
+    const router = new ActionRouter();
+    const pagerExport = options.pagerExport ?? noopPagerExportPort();
+    const capabilities = options.capabilities ??
+        (typeof process !== "undefined"
+            ? readCapabilitiesFromProcess()
+            : detectCapabilities({
+                env: {},
+                stdoutIsTTY: false,
+                stdinIsTTY: false,
+                columns: undefined,
+                rows: undefined,
+            }));
+    let disposed = false;
+    return {
+        ports,
+        commands,
+        session,
+        focus,
+        router,
+        selection,
+        toast,
+        transcript,
+        plan,
+        overlay,
+        pagerExport,
+        requestExit: options.requestExit ?? (() => { }),
+        capabilities,
+        recordedEvents: recorded,
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            overlay.dispose();
+            selection.dispose();
+            toast.dispose();
+            plan.dispose();
+            session.dispose();
+        },
+    };
+}
+//# sourceMappingURL=composition-root.js.map

package/dist/tui-v2/bootstrap/composition-root.js.map

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

package/dist/tui-v2/bootstrap/disable-native-selection.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @deprecated Select-to-copy is re-enabled. This module is intentionally a
+ * no-op kept so any stale imports fail soft. Prefer not calling it.
+ *
+ * Historical note: a hard prototype patch here killed all mouse selection
+ * (and broke Option/drag-select). Clicks are preserved by marking interactive
+ * chrome `selectable={false}` instead of disabling OpenTUI selection globally.
+ */
+import type { CliRenderer } from "@opentui/core";
+/** No-op — OpenTUI mouse text selection is enabled. */
+export declare function disableOpenTuiMouseTextSelection(_renderer?: CliRenderer): void;

package/dist/tui-v2/bootstrap/disable-native-selection.js

@@ -0,0 +1,13 @@
+/**
+ * @deprecated Select-to-copy is re-enabled. This module is intentionally a
+ * no-op kept so any stale imports fail soft. Prefer not calling it.
+ *
+ * Historical note: a hard prototype patch here killed all mouse selection
+ * (and broke Option/drag-select). Clicks are preserved by marking interactive
+ * chrome `selectable={false}` instead of disabling OpenTUI selection globally.
+ */
+/** No-op — OpenTUI mouse text selection is enabled. */
+export function disableOpenTuiMouseTextSelection(_renderer) {
+    // intentionally empty
+}
+//# sourceMappingURL=disable-native-selection.js.map

package/dist/tui-v2/bootstrap/disable-native-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disable-native-selection.js","sourceRoot":"","sources":["../../../src/tui-v2/bootstrap/disable-native-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,uDAAuD;AACvD,MAAM,UAAU,gCAAgC,CAAC,SAAuB;IACtE,sBAAsB;AACxB,CAAC"}

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

@@ -0,0 +1,62 @@
+/**
+ * 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.
+ */
+export interface RendererHandle {
+    /** Enter alternate screen / take over the terminal. */
+    start(): void | Promise<void>;
+    /** Leave alternate screen and flush pending reset bytes. */
+    destroy(): void | Promise<void>;
+}
+export interface ProcessLike {
+    on(event: string, listener: (...args: unknown[]) => void): unknown;
+    off(event: string, listener: (...args: unknown[]) => void): unknown;
+    exit(code?: number): void;
+}
+export type Disposer = () => void | Promise<void>;
+export interface LifecycleOptions {
+    readonly handle: RendererHandle;
+    readonly process?: ProcessLike | undefined;
+    /** Extra teardown (controllers/stores) disposed in reverse creation order. */
+    readonly disposers?: readonly Disposer[] | undefined;
+    /** Surfaced errors from signals/uncaught exceptions before shutdown. */
+    readonly onError?: ((error: unknown) => void) | undefined;
+    /**
+     * Optional cooperative first-SIGINT hook (e.g. abort the agent). A second
+     * SIGINT within {@link SIGINT_QUIT_WINDOW_MS} still shuts down and exits so
+     * `kill -INT` remains a reliable way to leave the TUI.
+     */
+    readonly onSigint?: (() => void) | undefined;
+}
+/** Double-SIGINT quit window — matches the App Ctrl+C exit window. */
+export declare const SIGINT_QUIT_WINDOW_MS = 1500;
+export declare class RendererLifecycle {
+    private readonly options;
+    private readonly proc;
+    private readonly disposers;
+    private started;
+    private shuttingDown;
+    private destroyed;
+    private lastSigintAt;
+    private readonly listeners;
+    constructor(options: LifecycleOptions);
+    get isDestroyed(): boolean;
+    /** Install handlers and hand the terminal to the renderer. */
+    start(): Promise<void>;
+    /**
+     * Idempotent teardown: dispose extra resources in reverse order, then destroy
+     * the renderer. Safe to call from multiple signals/error paths concurrently.
+     */
+    shutdown(): Promise<void>;
+    /** Tear down fully, then exit — destroy always precedes exit. */
+    shutdownAndExit(code: number): Promise<void>;
+    private installHandlers;
+    private addListener;
+    private removeHandlers;
+}