@pentoshi/clai 2.0.62 → 3.5.1

package/dist/tui-v2/rendering/plan-view.js

@@ -0,0 +1,196 @@
+/**
+ * Pure display helpers for the plan pane + Ctrl+P pager body (PLAN-001, V2-070).
+ */
+import { planProgress } from "../../store/plan.js";
+export const TASK_GLYPH = {
+    pending: "○",
+    in_progress: "◉",
+    done: "✓",
+    failed: "✗",
+    skipped: "–",
+};
+export const TASK_STATE_LABEL = {
+    pending: "pending",
+    in_progress: "active",
+    done: "done",
+    failed: "failed",
+    skipped: "skipped",
+};
+export const STATUS_LABEL = {
+    draft: "draft",
+    approved: "approved",
+    in_progress: "in progress",
+    completed: "completed",
+    abandoned: "abandoned",
+};
+export function planStatusColor(status) {
+    switch (status) {
+        case "completed":
+            return "success";
+        case "in_progress":
+        case "approved":
+            return "activity";
+        case "draft":
+            return "cyan";
+        case "abandoned":
+            return "muted";
+        default:
+            return "foreground";
+    }
+}
+export function taskStateColor(state) {
+    switch (state) {
+        case "done":
+            return "success";
+        case "in_progress":
+            return "activity";
+        case "failed":
+            return "accent";
+        case "skipped":
+            return "muted";
+        case "pending":
+        default:
+            return "muted";
+    }
+}
+export function progressView(plan) {
+    const { done, total } = planProgress(plan);
+    if (total === 0)
+        return { done: 0, total: 0, label: "no tasks" };
+    if (done === total)
+        return { done, total, label: `${done}/${total} complete` };
+    return { done, total, label: `${done}/${total} tasks` };
+}
+export function taskLabel(task) {
+    return `${TASK_GLYPH[task.state]} ${task.id}  ${task.title}`;
+}
+export function activeTaskId(plan) {
+    return plan.tasks.find((t) => t.state === "pending" || t.state === "in_progress")?.id;
+}
+/** Soft-wrap without ellipsis — full text, never truncated. */
+export function wrapPlanText(text, width) {
+    const clean = text.replace(/\s+/g, " ").trim();
+    if (!clean)
+        return [""];
+    const max = Math.max(8, width);
+    if (clean.length <= max)
+        return [clean];
+    const lines = [];
+    let rest = clean;
+    while (rest.length > max) {
+        let breakAt = rest.lastIndexOf(" ", max);
+        if (breakAt < Math.floor(max * 0.35))
+            breakAt = max;
+        lines.push(rest.slice(0, breakAt).trimEnd());
+        rest = rest.slice(breakAt).trimStart();
+    }
+    if (rest)
+        lines.push(rest);
+    return lines;
+}
+/**
+ * Strip redundant `t1:` / `t1 -` prefixes when the model baked the task id
+ * into the title (keeps the pager readable).
+ */
+export function cleanTaskTitle(task) {
+    let title = task.title.replace(/\s+/g, " ").trim();
+    const id = task.id.trim();
+    if (!id)
+        return title;
+    // t1: … | t1 - … | t1. … | [t1] …
+    const re = new RegExp(`^\\[?${id.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\]?\\s*[:.\\-)–—]\\s*`, "i");
+    title = title.replace(re, "");
+    return title || task.title.trim();
+}
+const PAGER_WIDTH = 76;
+const RULE = "─".repeat(PAGER_WIDTH);
+function pushWrapped(lines, text, prefix, width) {
+    const bodyWidth = Math.max(12, width - prefix.length);
+    const wrapped = wrapPlanText(text, bodyWidth);
+    for (let i = 0; i < wrapped.length; i++) {
+        lines.push(i === 0 ? `${prefix}${wrapped[i]}` : `${" ".repeat(prefix.length)}${wrapped[i]}`);
+    }
+}
+/**
+ * Full plan body for the OpenTUI pager (Ctrl+P / /plan).
+ * Plain text only — no chalk/ANSI (those look messy in the pager).
+ * Tasks are card-like blocks with clear rules between them.
+ */
+export function formatPlanPagerDocument(plan) {
+    const { done, total } = planProgress(plan);
+    const lines = [];
+    lines.push(plan.goal.trim() || "Untitled plan");
+    lines.push("");
+    lines.push(`Status   ${STATUS_LABEL[plan.status]}    Progress   ${done}/${total}    Kind   ${plan.kind || "general"}`);
+    lines.push(`Updated  ${plan.updatedAt.replace("T", " ").slice(0, 19)}`);
+    lines.push("");
+    lines.push(RULE);
+    lines.push("");
+    const detail = plan.detail.trim();
+    if (detail) {
+        lines.push("Approach");
+        lines.push("");
+        for (const raw of detail.split(/\r?\n/)) {
+            const line = raw.replace(/\t/g, "  ");
+            if (line.trim() === "") {
+                lines.push("");
+            }
+            else if (/^#{1,6}\s/.test(line.trim())) {
+                lines.push(line.trim().replace(/^#+\s*/, ""));
+            }
+            else if (/^[-*•]\s/.test(line.trim()) || /^\d+[.)]\s/.test(line.trim())) {
+                pushWrapped(lines, line.trim(), "  ", PAGER_WIDTH);
+            }
+            else {
+                pushWrapped(lines, line.trim(), "  ", PAGER_WIDTH);
+            }
+        }
+        lines.push("");
+        lines.push(RULE);
+        lines.push("");
+    }
+    lines.push(`Tasks  (${total})`);
+    lines.push("");
+    if (plan.tasks.length === 0) {
+        lines.push("  (no tasks)");
+    }
+    else {
+        plan.tasks.forEach((task, i) => {
+            const glyph = TASK_GLYPH[task.state] ?? "○";
+            const state = TASK_STATE_LABEL[task.state] ?? task.state;
+            const num = String(i + 1).padStart(2, " ");
+            const title = cleanTaskTitle(task);
+            // Card header: glyph + index + title (wrapped)
+            pushWrapped(lines, title, `${glyph}  ${num}.  `, PAGER_WIDTH);
+            // State as a clean tag line (not free-floating "done")
+            lines.push(`      [${state}]  ${task.id}`);
+            if (task.note?.trim()) {
+                pushWrapped(lines, task.note.trim(), "      note  ", PAGER_WIDTH);
+            }
+            // Boundary between tasks
+            if (i < plan.tasks.length - 1) {
+                lines.push("");
+                lines.push(RULE);
+                lines.push("");
+            }
+        });
+    }
+    lines.push("");
+    lines.push(RULE);
+    lines.push("");
+    if (plan.status === "draft") {
+        lines.push("Next: /implement to approve and run, or refine the plan in chat.");
+    }
+    else if (plan.status === "approved" || plan.status === "in_progress") {
+        lines.push("Plan is approved — the agent marks tasks as they complete.");
+    }
+    else if (plan.status === "completed") {
+        lines.push("All tasks completed.");
+    }
+    else {
+        lines.push(`Plan status: ${STATUS_LABEL[plan.status]}.`);
+    }
+    lines.push("q/esc:close  ·  ↑↓:scroll  ·  ^r:search");
+    return lines.join("\n");
+}
+//# sourceMappingURL=plan-view.js.map

package/dist/tui-v2/rendering/plan-view.js.map

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

package/dist/tui-v2/rendering/render-markdown-lines.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Classic-parity markdown for OpenTUI transcript rows.
+ *
+ * OpenTUI's native `<markdown>` component does not expand `<br>`, and its
+ * table styling diverges from classic clai. We reuse `renderMarkdown` from
+ * `ui/markdown.ts` (tables, fences, lists, `<br>`, …) and convert the ANSI
+ * output into OpenTUI `StyledText` chunks.
+ */
+import { ansiToStyledText } from "./ansi-to-styled.js";
+type StyledLine = ReturnType<typeof ansiToStyledText>;
+export interface RenderMarkdownLinesOptions {
+    /** Wrap budget in columns (classic uses terminal width − chrome). */
+    readonly width: number;
+    /** Default body color (assistant replies use theme.response green). */
+    readonly defaultFg?: string | undefined;
+    /**
+     * `renderMarkdown` prefixes every line with two spaces; strip them when the
+     * caller already pads the container (assistant box uses paddingLeft: 2).
+     */
+    readonly stripOuterIndent?: boolean | undefined;
+}
+/**
+ * Pre-normalize a few HTML-ish tokens models emit so classic markdown sees
+ * clean source (beyond the `<br>` expansion it already does).
+ */
+export declare function preprocessAssistantMarkdown(text: string): string;
+/** Render markdown into one StyledText line per physical row. */
+export declare function renderMarkdownLines(text: string, options: RenderMarkdownLinesOptions): StyledLine[];
+export {};

package/dist/tui-v2/rendering/render-markdown-lines.js

@@ -0,0 +1,46 @@
+/**
+ * Classic-parity markdown for OpenTUI transcript rows.
+ *
+ * OpenTUI's native `<markdown>` component does not expand `<br>`, and its
+ * table styling diverges from classic clai. We reuse `renderMarkdown` from
+ * `ui/markdown.ts` (tables, fences, lists, `<br>`, …) and convert the ANSI
+ * output into OpenTUI `StyledText` chunks.
+ */
+import { renderMarkdown } from "../../ui/markdown.js";
+import { ansiToStyledText } from "./ansi-to-styled.js";
+/**
+ * Pre-normalize a few HTML-ish tokens models emit so classic markdown sees
+ * clean source (beyond the `<br>` expansion it already does).
+ */
+export function preprocessAssistantMarkdown(text) {
+    return text
+        // Non-breaking spaces → regular space so wrap math stays sane.
+        .replace(/\u00a0/g, " ")
+        // Common self-closing / HTML line breaks that slip past some model paths.
+        .replace(/<\/?br\s*\/?>/gi, "<br>")
+        // Paragraph breaks occasionally emitted as HTML.
+        .replace(/<\/p>\s*<p[^>]*>/gi, "\n\n")
+        .replace(/<\/?p[^>]*>/gi, "\n")
+        // Horizontal rules as HTML.
+        .replace(/<hr\s*\/?>/gi, "\n---\n");
+}
+/** Render markdown into one StyledText line per physical row. */
+export function renderMarkdownLines(text, options) {
+    if (!text)
+        return [];
+    const prepared = preprocessAssistantMarkdown(text);
+    const width = Math.max(20, options.width);
+    const rendered = renderMarkdown(prepared, width).replace(/\n+$/, "");
+    if (!rendered)
+        return [];
+    return rendered.split("\n").map((line) => {
+        let body = line;
+        if (options.stripOuterIndent && body.startsWith("  ")) {
+            body = body.slice(2);
+        }
+        return ansiToStyledText(body.length === 0 ? " " : body, {
+            defaultFg: options.defaultFg,
+        });
+    });
+}
+//# sourceMappingURL=render-markdown-lines.js.map

package/dist/tui-v2/rendering/render-markdown-lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-markdown-lines.js","sourceRoot":"","sources":["../../../src/tui-v2/rendering/render-markdown-lines.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAgBvD;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,OAAO,IAAI;QACT,+DAA+D;SAC9D,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;QACxB,0EAA0E;SACzE,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC;QACnC,iDAAiD;SAChD,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC;SACrC,OAAO,CAAC,eAAe,EAAE,IAAI,CAAC;QAC/B,4BAA4B;SAC3B,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAAmC;IAEnC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,QAAQ,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzB,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvC,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,IAAI,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE;YACtD,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tui-v2/rendering/sanitize-display.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Display-safe text sanitization (QUALITY visual correctness / V2-094).
+ *
+ * External content (tool output, model text, paste) can carry C0/C1 controls
+ * and OSC/CSI sequences that corrupt a terminal or inject misleading UI.
+ * This pure helper strips those bytes while preserving ordinary newlines,
+ * tabs, and Unicode. Clipboard/export paths should run content through here
+ * before writing terminal-facing strings.
+ */
+export declare function stripAnsiSequences(text: string): string;
+export declare function stripControlChars(text: string): string;
+/** Full display sanitize: ANSI first, then remaining control characters. */
+export declare function sanitizeDisplayText(text: string): string;

package/dist/tui-v2/rendering/sanitize-display.js

@@ -0,0 +1,24 @@
+/**
+ * Display-safe text sanitization (QUALITY visual correctness / V2-094).
+ *
+ * External content (tool output, model text, paste) can carry C0/C1 controls
+ * and OSC/CSI sequences that corrupt a terminal or inject misleading UI.
+ * This pure helper strips those bytes while preserving ordinary newlines,
+ * tabs, and Unicode. Clipboard/export paths should run content through here
+ * before writing terminal-facing strings.
+ */
+// CSI / OSC / DCS first (order matters: bare ESC+letter must not swallow `]`).
+const ANSI_ESCAPE_RE = /\x1b(?:\[[0-?]*[ -/]*[@-~]|\][^\x07\x1b]*(?:\x07|\x1b\\)?|P[^\x1b]*(?:\x1b\\)?|[@-Z\\_])/g;
+// C0 controls except TAB (0x09) and LF (0x0a); DEL; C1 0x80–0x9f.
+const CONTROL_CHARS_RE = /[\x00-\x08\x0b-\x1a\x1c-\x1f\x7f\x80-\x9f]/g;
+export function stripAnsiSequences(text) {
+    return text.replace(ANSI_ESCAPE_RE, "");
+}
+export function stripControlChars(text) {
+    return text.replace(CONTROL_CHARS_RE, "");
+}
+/** Full display sanitize: ANSI first, then remaining control characters. */
+export function sanitizeDisplayText(text) {
+    return stripControlChars(stripAnsiSequences(text));
+}
+//# sourceMappingURL=sanitize-display.js.map

package/dist/tui-v2/rendering/sanitize-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-display.js","sourceRoot":"","sources":["../../../src/tui-v2/rendering/sanitize-display.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,MAAM,cAAc,GAClB,2FAA2F,CAAC;AAC9F,kEAAkE;AAClE,MAAM,gBAAgB,GAAG,6CAA6C,CAAC;AAEvE,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,iBAAiB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/tui-v2/rendering/strip-tool-surfaces.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Remove tool-call surfaces from assistant display text so the TUI never
+ * flashes raw ```tool JSON (or XML tool_call blocks) before tool cards appear.
+ *
+ * Safe for streaming: incomplete trailing fences are stripped from the cursor
+ * to end-of-string so mid-fence tokens never paint.
+ */
+export declare function stripToolCallSurfaces(text: string): string;
+/** True when stripping leaves nothing meaningful for a Response card. */
+export declare function isToolFenceOnlyText(text: string): boolean;

package/dist/tui-v2/rendering/strip-tool-surfaces.js

@@ -0,0 +1,32 @@
+/**
+ * Remove tool-call surfaces from assistant display text so the TUI never
+ * flashes raw ```tool JSON (or XML tool_call blocks) before tool cards appear.
+ *
+ * Safe for streaming: incomplete trailing fences are stripped from the cursor
+ * to end-of-string so mid-fence tokens never paint.
+ */
+const COMPLETE_TOOL_FENCE = /```(?:tool|json\s*tool)\b[^\n]*\n[\s\S]*?```/gi;
+const TRAILING_TOOL_FENCE = /```(?:tool|json\s*tool)\b[\s\S]*$/i;
+const COMPLETE_TOOL_XML = /<tool_call\b[^>]*>[\s\S]*?<\/tool_call>/gi;
+const TRAILING_TOOL_XML = /<tool_call\b[^>]*>[\s\S]*$/i;
+/** Kimi / sentinel-style blocks sometimes leak as prose. */
+const COMPLETE_TOOL_SENTINEL = /(?:^|\n)\s*(?:tool_call|invoke_tool)\s*\([\s\S]*?\)\s*(?=\n|$)/gi;
+export function stripToolCallSurfaces(text) {
+    if (!text)
+        return text;
+    let s = text;
+    s = s.replace(COMPLETE_TOOL_FENCE, "");
+    s = s.replace(TRAILING_TOOL_FENCE, "");
+    s = s.replace(COMPLETE_TOOL_XML, "");
+    s = s.replace(TRAILING_TOOL_XML, "");
+    s = s.replace(COMPLETE_TOOL_SENTINEL, "\n");
+    // Collapse leftover blank runs from removed fences.
+    s = s.replace(/[ \t]+\n/g, "\n");
+    s = s.replace(/\n{3,}/g, "\n\n");
+    return s;
+}
+/** True when stripping leaves nothing meaningful for a Response card. */
+export function isToolFenceOnlyText(text) {
+    return stripToolCallSurfaces(text).trim().length === 0;
+}
+//# sourceMappingURL=strip-tool-surfaces.js.map

package/dist/tui-v2/rendering/strip-tool-surfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-tool-surfaces.js","sourceRoot":"","sources":["../../../src/tui-v2/rendering/strip-tool-surfaces.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,mBAAmB,GACvB,gDAAgD,CAAC;AACnD,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AACjE,MAAM,iBAAiB,GAAG,2CAA2C,CAAC;AACtE,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AACxD,4DAA4D;AAC5D,MAAM,sBAAsB,GAC1B,kEAAkE,CAAC;AAErE,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC5C,oDAAoD;IACpD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/tui-v2/rendering/theme.d.ts

@@ -0,0 +1,67 @@
+/**
+ * CLAI theme tokens (V2-030 / QUALITY "visual correctness").
+ *
+ * Palette is anchored to the CLAI wordmark gradient (magenta → blue → cyan)
+ * plus the legacy amber mode badge, green READY/success, and aqua chrome.
+ * Components should pull from these tokens — never scatter raw hex.
+ */
+import type { ThemeHint } from "../bootstrap/capabilities.js";
+export interface Theme {
+    readonly background: string;
+    readonly foreground: string;
+    readonly muted: string;
+    readonly accent: string;
+    readonly border: string;
+    readonly statusBackground: string;
+    /** Selected row / focus highlight (legacy #2563EB). */
+    readonly selection: string;
+    /** Alternating list row A (legacy #1E293B). */
+    readonly rowA: string;
+    /** Alternating list row B (legacy #0F172A). */
+    readonly rowB: string;
+    /** Chip / badge slate (legacy #334155). */
+    readonly chip: string;
+    /** Mode badge amber / RUNNING (legacy #B45309). */
+    readonly mode: string;
+    /** Success / READY / allow-all green. */
+    readonly success: string;
+    /**
+     * Wordmark top-of-"I" magenta (`WORDMARK_TOP_HEX` / chalk.magentaBright).
+     * Used for plan/task pane border, agent-card frame, output accents.
+     */
+    readonly magenta: string;
+    /** Soft cyan for command labels (legacy #67E8F9). */
+    readonly cyan: string;
+    readonly white: string;
+    /** Assistant / model reply body (user request: green chat text). */
+    readonly response: string;
+    /** Amber/yellow activity text while RUNNING (legacy yellow). */
+    readonly activity: string;
+    /** Spinner color while RUNNING (legacy magenta). */
+    readonly spinner: string;
+    /** Queued badge amber-dark (legacy #854D0E). */
+    readonly queued: string;
+    /** Teal chip for idle command shortcuts (richer than flat slate). */
+    readonly chipTeal: string;
+    /** Indigo chip alternate for idle shortcuts. */
+    readonly chipIndigo: string;
+    /**
+     * Prompt / YOU badge background — same as the CTRL+O OUTPUT chip so user
+     * chrome and output chrome share one brand accent.
+     */
+    readonly prompt: string;
+    /** Thinking / reasoning text (violet). */
+    readonly thinking: string;
+    /**
+     * Input / composer border, ❯ mark, and cursor — electric aqua, a step
+     * stronger than the `/` command menu border (`theme.border` #22D3EE).
+     */
+    readonly inputBorder: string;
+    /** User prompt bubble border — soft magenta. */
+    readonly userBorder: string;
+    /** Tool output card border — blue from wordmark mid gradient. */
+    readonly toolBorder: string;
+    /** Modal accent border. */
+    readonly modalBorder: string;
+}
+export declare function themeFor(hint: ThemeHint): Theme;

package/dist/tui-v2/rendering/theme.js

@@ -0,0 +1,74 @@
+/**
+ * CLAI theme tokens (V2-030 / QUALITY "visual correctness").
+ *
+ * Palette is anchored to the CLAI wordmark gradient (magenta → blue → cyan)
+ * plus the legacy amber mode badge, green READY/success, and aqua chrome.
+ * Components should pull from these tokens — never scatter raw hex.
+ */
+const DARK_THEME = {
+    background: "#0b0e14",
+    foreground: "#F8FAFC",
+    muted: "#94A3B8",
+    accent: "#5cc8ff",
+    border: "#22D3EE",
+    statusBackground: "#11151c",
+    selection: "#2563EB",
+    rowA: "#1E293B",
+    rowB: "#0F172A",
+    chip: "#334155",
+    mode: "#B45309",
+    success: "#166534",
+    // Top of CLAI wordmark "I" (magentaBright) — plan pane + agent card frame.
+    magenta: "#FF55FF",
+    cyan: "#67E8F9",
+    white: "#FFFFFF",
+    response: "#4ADE80",
+    activity: "#FACC15",
+    spinner: "#E879F9",
+    queued: "#854D0E",
+    chipTeal: "#0E7490",
+    chipIndigo: "#3730A3",
+    // Match CTRL+O OUTPUT chip bg for YOU / prompt chrome.
+    prompt: "#0E7490",
+    thinking: "#A78BFA",
+    // Stronger aqua than /command border (#22D3EE) — high-sat electric cyan.
+    inputBorder: "#2EEBFF",
+    userBorder: "#0E7490",
+    toolBorder: "#3B82F6",
+    modalBorder: "#22D3EE",
+};
+const LIGHT_THEME = {
+    background: "#fdfdfd",
+    foreground: "#1c1f24",
+    muted: "#6b7280",
+    accent: "#0969da",
+    border: "#0891B2",
+    statusBackground: "#f0f2f4",
+    selection: "#0969da",
+    rowA: "#eef2f7",
+    rowB: "#f8fafc",
+    chip: "#e2e8f0",
+    mode: "#B45309",
+    success: "#166534",
+    // Top of CLAI wordmark "I" (slightly deeper on light bg for contrast).
+    magenta: "#D946EF",
+    cyan: "#0891b2",
+    white: "#FFFFFF",
+    response: "#15803d",
+    activity: "#a16207",
+    spinner: "#a21caf",
+    queued: "#854D0E",
+    chipTeal: "#0e7490",
+    chipIndigo: "#4338ca",
+    prompt: "#0e7490",
+    thinking: "#7c3aed",
+    // Stronger aqua than /command border (#0891B2) for light terminals.
+    inputBorder: "#06B6D4",
+    userBorder: "#0e7490",
+    toolBorder: "#2563eb",
+    modalBorder: "#0891B2",
+};
+export function themeFor(hint) {
+    return hint === "light" ? LIGHT_THEME : DARK_THEME;
+}
+//# sourceMappingURL=theme.js.map

package/dist/tui-v2/rendering/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/tui-v2/rendering/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+DH,MAAM,UAAU,GAAU;IACxB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,gBAAgB,EAAE,SAAS;IAC3B,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,2EAA2E;IAC3E,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,SAAS;IACrB,uDAAuD;IACvD,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,yEAAyE;IACzE,WAAW,EAAE,SAAS;IACtB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,SAAS;CACvB,CAAC;AAEF,MAAM,WAAW,GAAU;IACzB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,gBAAgB,EAAE,SAAS;IAC3B,SAAS,EAAE,SAAS;IACpB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,uEAAuE;IACvE,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE,SAAS;IACrB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,oEAAoE;IACpE,WAAW,EAAE,SAAS;IACtB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,SAAS;CACvB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,IAAe;IACtC,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC;AACrD,CAAC"}

package/dist/tui-v2/rendering/tool-presenter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Pure presentation logic for tool cards (CHAT-004/005, V2-054/055).
+ *
+ * Collapsed cards must stay cheap even when the spool holds multi‑MB output
+ * (no full-string split on every render). Full bodies open in the pager.
+ */
+import type { BoundedTextState } from "../../app/events/event-buffer.js";
+import type { ToolItem } from "../state/transcript-types.js";
+export interface ToolPresentation {
+    readonly glyph: string;
+    readonly statusLabel: string;
+    readonly name: string;
+    readonly argsLabel: string | undefined;
+    readonly argsDisplay: string | undefined;
+    readonly detail: string | undefined;
+}
+export declare function presentTool(item: ToolItem): ToolPresentation;
+export interface OutputPresentation {
+    readonly lines: readonly string[];
+    readonly hiddenAboveCount: number;
+    readonly truncatedNotice: string | undefined;
+}
+/**
+ * Sample start+end of a huge string so we never `.split("\n")` a multi‑MB body
+ * just to draw a collapsed card.
+ */
+export declare function sampleEnds(raw: string, eachEnd?: number): string;
+export declare function cleanToolOutputLines(raw: string, options?: {
+    readonly maxLineChars?: number;
+}): string[];
+/**
+ * Card body presentation.
+ *
+ * Collapsed: head + tail with a mid-body “··· N lines more ···” gap so the end
+ * of streaming output stays visible. Expanded (Ctrl+O): full cleaned body in
+ * place (classic parity). The unbounded raw body always lives in the spool /
+ * artifact and the click-to-open pager modal.
+ */
+export declare function presentOutput(tail: string, state: BoundedTextState | undefined, expanded: boolean): OutputPresentation;