@pentoshi/clai 3.18.2 → 4.0.1

package/dist/ui-core/actions/format-shortcuts.js

@@ -0,0 +1,267 @@
+/**
+ * Human-readable keyboard shortcut reference for /shortcuts.
+ * Emits markdown so the pager can render headings, tables, and code chips.
+ * Built from defaultKeymap so the list cannot drift from real bindings.
+ */
+import { defaultKeymap } from "./keymap.js";
+const CONTEXT_ORDER = [
+    "global",
+    "composer",
+    "transcript",
+    "plan",
+    "pager",
+    "jobs",
+    "modal",
+    "picker",
+    "transcript-search",
+];
+const CONTEXT_TITLES = {
+    global: "Global",
+    composer: "Composer",
+    transcript: "Transcript",
+    plan: "Plan / tasks",
+    pager: "Pager",
+    jobs: "Jobs",
+    modal: "Confirm modal",
+    picker: "Picker",
+    secret: "Secret prompt",
+    "transcript-search": "Transcript search",
+};
+const CONTEXT_BLURBS = {
+    global: "Work from any focus (unless a modal traps keys).",
+    composer: "While typing in the input box.",
+    transcript: "When the chat pane has focus.",
+    plan: "When the tasks pane is focused.",
+    pager: "Inside full-output / help / plan detail views.",
+    jobs: "Background jobs panel.",
+    modal: "Yes/no and confirm dialogs.",
+    picker: "Model, provider, history, and other menus.",
+};
+const ACTION_LABELS = {
+    "app.interrupt": "Abort turn / arm exit (double-press to quit)",
+    "app.cancel": "Cancel / dismiss (never quits)",
+    "app.quit": "Quit",
+    "app.help": "Open command help",
+    "app.toggle-plan": "Toggle plan / tasks pane",
+    "app.jobs": "Open background jobs",
+    "jobs.view-live": "View selected job output (follows while it runs)",
+    "pager.toggle-follow": "Follow / pause live output",
+    "app.cycle-mode": "Cycle mode (ask → agent → plan)",
+    "focus.next-region": "Cycle focus (composer → chat → plan)",
+    "focus.composer": "Focus composer",
+    "focus.transcript": "Focus transcript",
+    "editor.submit": "Submit prompt",
+    "editor.newline": "Insert newline",
+    "editor.history-prev": "Previous prompt in history",
+    "editor.history-next": "Next prompt in history",
+    "editor.clear": "Clear draft",
+    "editor.cut-draft": "Cut draft (copy to clipboard, then clear)",
+    "transcript.scroll-up": "Scroll chat up",
+    "transcript.scroll-down": "Scroll chat down",
+    "transcript.page-up": "Page chat up",
+    "transcript.page-down": "Page chat down",
+    "transcript.top": "Jump to top of chat",
+    "transcript.bottom": "Jump to bottom of chat",
+    "transcript.search": "Search transcript",
+    "transcript.expand-toggle": "Expand / collapse focused card",
+    "transcript.toggle-thinking": "Toggle thinking blocks",
+    "transcript.toggle-output": "Toggle tool / compacted output",
+    "selection.copy": "Copy selection",
+    "selection.clear": "Clear selection",
+    "selection.select-all": "Select all",
+    "selection.extend-left": "Extend selection left",
+    "selection.extend-right": "Extend selection right",
+    "selection.extend-up": "Extend selection up",
+    "selection.extend-down": "Extend selection down",
+    "selection.extend-word-left": "Extend selection word left",
+    "selection.extend-word-right": "Extend selection word right",
+    "selection.extend-line-start": "Extend selection to line start",
+    "selection.extend-line-end": "Extend selection to line end",
+    "picker.up": "Move selection up",
+    "picker.down": "Move selection down",
+    "picker.accept": "Accept",
+    "picker.dismiss": "Dismiss",
+    "modal.confirm": "Confirm",
+    "modal.deny": "Deny",
+    "modal.dismiss": "Dismiss",
+    "plan.next-task": "Next task",
+    "plan.prev-task": "Previous task",
+    "plan.toggle-detail": "Open full plan detail",
+    "pager.line-up": "Line up",
+    "pager.line-down": "Line down",
+    "pager.page-up": "Page up",
+    "pager.page-down": "Page down",
+    "pager.top": "Jump to top",
+    "pager.bottom": "Jump to bottom",
+    "pager.search": "Search in pager",
+    "pager.next-match": "Next search match",
+    "pager.prev-match": "Previous search match",
+    "pager.export-scrollback": "Export to scrollback",
+    "pager.export-editor": "Open in editor",
+    "pager.copy": "Copy pager body",
+    "pager.format": "Formatted markdown view",
+    "pager.raw": "Raw text view",
+    "pager.close": "Close pager",
+    "jobs.up": "Previous job",
+    "jobs.down": "Next job",
+    "jobs.tail": "Snapshot of job output",
+    "jobs.stop": "Stop job",
+    "jobs.close": "Close jobs panel",
+};
+/** Pretty-print a normalized chord for humans. */
+export function humanizeChord(chord) {
+    return chord
+        .split("+")
+        .map((part) => {
+        const p = part.toLowerCase();
+        if (p === "ctrl")
+            return "Ctrl";
+        if (p === "alt")
+            return "Alt/Option";
+        if (p === "shift")
+            return "Shift";
+        if (p === "meta")
+            return "Cmd/Meta";
+        if (p === "pageup")
+            return "PageUp";
+        if (p === "pagedown")
+            return "PageDown";
+        if (p === "escape")
+            return "Esc";
+        if (p === "enter")
+            return "Enter";
+        if (p === "backspace")
+            return "Backspace";
+        if (p === "delete")
+            return "Delete";
+        if (p === "tab")
+            return "Tab";
+        if (p === "up")
+            return "↑";
+        if (p === "down")
+            return "↓";
+        if (p === "left")
+            return "←";
+        if (p === "right")
+            return "→";
+        if (p === "home")
+            return "Home";
+        if (p === "end")
+            return "End";
+        if (p.length === 1)
+            return p.toUpperCase();
+        return part;
+    })
+        .join("+");
+}
+function labelFor(action) {
+    return ACTION_LABELS[action] ?? action;
+}
+function escapeCell(text) {
+    return text.replace(/\|/g, "\\|").replace(/\n/g, " ");
+}
+const COMPOSER_TEXTAREA_NOTES = [
+    {
+        chord: "Option/Alt+Backspace",
+        label: "Delete previous word",
+    },
+    {
+        chord: "Option/Alt+Delete",
+        label: "Delete next word",
+    },
+    {
+        chord: "Cmd (Mac) / Ctrl (Win)+Backspace or Delete",
+        label: "Delete the whole line",
+    },
+    {
+        chord: "Ctrl+U",
+        label: "Delete the whole line (macOS Cmd+Backspace often arrives as Ctrl+U). Empty draft → jump chat to top",
+    },
+    {
+        chord: "Ctrl+A / Ctrl+E",
+        label: "Line start / line end (readline)",
+    },
+    {
+        chord: "Ctrl+K",
+        label: "Delete to end of line (readline)",
+    },
+    {
+        chord: "Ctrl+W",
+        label: "Delete word backward",
+    },
+    {
+        chord: "Double Ctrl+C",
+        label: "Quit clai (first press aborts a running turn)",
+    },
+    {
+        chord: "/exit or /quit",
+        label: "Quit",
+    },
+    {
+        chord: "/shortcuts",
+        label: "This reference",
+    },
+    {
+        chord: "/help",
+        label: "Slash command list",
+    },
+];
+/**
+ * Markdown document for the keyboard shortcuts pager.
+ */
+export function formatShortcutsReference(bindings = defaultKeymap) {
+    const byContext = new Map();
+    for (const b of bindings) {
+        const list = byContext.get(b.context) ?? [];
+        list.push(b);
+        byContext.set(b.context, list);
+    }
+    const out = [
+        "# Keyboard shortcuts",
+        "",
+        "Chords are **terminal-dependent**. On macOS, **Cmd+Backspace** often arrives as **Ctrl+U** (line delete in the composer — not chat scroll while typing).",
+        "",
+        "Status chips under the input are clickable: `^T` · `^O` · `^U` · `^D` · `^X` · `^Q`.",
+        "",
+    ];
+    for (const ctx of CONTEXT_ORDER) {
+        const list = byContext.get(ctx);
+        if (!list || list.length === 0)
+            continue;
+        out.push(`## ${CONTEXT_TITLES[ctx]}`);
+        out.push("");
+        const blurb = CONTEXT_BLURBS[ctx];
+        if (blurb) {
+            out.push(`*${blurb}*`);
+            out.push("");
+        }
+        out.push("| Keys | Action |");
+        out.push("| --- | --- |");
+        const byAction = new Map();
+        for (const b of list) {
+            const chords = byAction.get(b.action) ?? [];
+            chords.push(humanizeChord(b.chord));
+            byAction.set(b.action, chords);
+        }
+        for (const [action, chords] of byAction) {
+            const keys = chords.map((c) => `\`${c}\``).join(" · ");
+            out.push(`| ${escapeCell(keys)} | ${escapeCell(labelFor(action))} |`);
+        }
+        out.push("");
+    }
+    out.push("## Composer editing");
+    out.push("");
+    out.push("*Textarea defaults and clai overrides (not all appear in the action keymap).*");
+    out.push("");
+    out.push("| Keys | Action |");
+    out.push("| --- | --- |");
+    for (const note of COMPOSER_TEXTAREA_NOTES) {
+        out.push(`| \`${escapeCell(note.chord)}\` | ${escapeCell(note.label)} |`);
+    }
+    out.push("");
+    out.push("---");
+    out.push("");
+    out.push("Tip: run `/help` for slash commands · `q` or `Esc` closes this pager.");
+    return out.join("\n");
+}
+//# sourceMappingURL=format-shortcuts.js.map

package/dist/ui-core/actions/format-shortcuts.js.map

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

package/dist/ui-core/actions/keymap.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Default keymap and conflict validation (V2-033).
+ *
+ * A chord is a normalized, case-insensitive string ("ctrl+c", "shift+enter",
+ * "up"). Bindings are data: help/status text and tests read them so no
+ * component hardcodes terminal bytes. `validateKeymap` guarantees a context
+ * never binds one chord to two different actions, which is asserted in tests so
+ * new bindings cannot silently shadow existing ones.
+ */
+import type { ActionContext, ActionId } from "./action-id.js";
+export { normalizeChord } from "./chord.js";
+export interface KeyBinding {
+    readonly chord: string;
+    readonly action: ActionId;
+    readonly context: ActionContext;
+}
+export interface KeymapConflict {
+    readonly context: ActionContext;
+    readonly chord: string;
+    readonly actions: readonly ActionId[];
+}
+export declare const defaultKeymap: readonly KeyBinding[];
+export declare function validateKeymap(bindings: readonly KeyBinding[]): KeymapConflict[];

package/dist/ui-core/actions/keymap.js

@@ -0,0 +1,147 @@
+/**
+ * Default keymap and conflict validation (V2-033).
+ *
+ * A chord is a normalized, case-insensitive string ("ctrl+c", "shift+enter",
+ * "up"). Bindings are data: help/status text and tests read them so no
+ * component hardcodes terminal bytes. `validateKeymap` guarantees a context
+ * never binds one chord to two different actions, which is asserted in tests so
+ * new bindings cannot silently shadow existing ones.
+ */
+import { normalizeChord } from "./chord.js";
+export { normalizeChord } from "./chord.js";
+function binding(chord, action, context) {
+    return { chord: normalizeChord(chord), action, context };
+}
+export const defaultKeymap = [
+    // global
+    // Ctrl+C: abort-then-quit (double press). Esc: dismiss/arm, then cancel all.
+    // Exit: double Ctrl+C or /exit. (Ctrl+D is chat jump-to-bottom, not quit.)
+    binding("ctrl+c", "app.interrupt", "global"),
+    binding("escape", "app.cancel", "global"),
+    binding("ctrl+g", "app.help", "global"),
+    binding("ctrl+h", "app.toggle-plan", "global"),
+    binding("ctrl+p", "plan.toggle-detail", "global"),
+    binding("ctrl+j", "app.jobs", "global"),
+    binding("ctrl+t", "transcript.toggle-thinking", "global"),
+    binding("ctrl+o", "transcript.toggle-output", "global"),
+    // Shift+Tab cycles ask → agent → plan from any base region (bare Tab is
+    // reserved for the composer completion menu / focus, so it stays free).
+    binding("shift+tab", "app.cycle-mode", "global"),
+    // Absolute bottom of chat from anywhere (including composer).
+    // Ctrl+U is NOT global: macOS Cmd+Backspace often arrives as Ctrl+U, and
+    // OpenTUI's textarea uses ctrl+u for delete-to-line-start. Jump-to-top is
+    // bound on transcript/pager; from composer only when the draft is empty
+    // (handled in App.tsx so typing never scrolls the chat).
+    // No bare g/G — those conflict with typing.
+    binding("ctrl+d", "transcript.bottom", "global"),
+    binding("tab", "focus.next-region", "global"),
+    // Queued follow-ups (04-UI-SPEC §4.4). Ctrl+Alt keeps them clear of both
+    // composer editing and the transcript scroll chords.
+    binding("ctrl+alt+up", "queue.select-prev", "global"),
+    binding("ctrl+alt+down", "queue.select-next", "global"),
+    binding("ctrl+alt+enter", "queue.send-now", "global"),
+    binding("ctrl+alt+e", "queue.edit", "global"),
+    binding("ctrl+alt+backspace", "queue.remove", "global"),
+    // composer
+    binding("enter", "editor.submit", "composer"),
+    binding("shift+enter", "editor.newline", "composer"),
+    binding("alt+enter", "editor.newline", "composer"),
+    binding("ctrl+enter", "editor.newline", "composer"),
+    binding("ctrl+n", "editor.newline", "composer"),
+    binding("up", "editor.history-prev", "composer"),
+    binding("down", "editor.history-next", "composer"),
+    binding("ctrl+x", "editor.cut-draft", "composer"),
+    binding("ctrl+q", "editor.clear", "composer"),
+    // transcript
+    binding("up", "transcript.scroll-up", "transcript"),
+    binding("down", "transcript.scroll-down", "transcript"),
+    binding("pageup", "transcript.page-up", "transcript"),
+    binding("pagedown", "transcript.page-down", "transcript"),
+    binding("ctrl+u", "transcript.top", "transcript"),
+    binding("ctrl+d", "transcript.bottom", "transcript"),
+    binding("home", "transcript.top", "transcript"),
+    binding("end", "transcript.bottom", "transcript"),
+    binding("ctrl+r", "transcript.search", "transcript"),
+    binding("enter", "transcript.expand-toggle", "transcript"),
+    // Terminals that reserve Ctrl+C for copy use Ctrl+Shift+C for selection copy.
+    binding("ctrl+shift+c", "selection.copy", "transcript"),
+    binding("escape", "selection.clear", "transcript"),
+    binding("ctrl+a", "selection.select-all", "transcript"),
+    // Keyboard range extension is intentionally unbound: the transcript has no
+    // caret or range highlight, so shift+arrow selections were invisible. Mouse
+    // drag (native selection) and Ctrl+A + Ctrl+Shift+C cover copying.
+    // picker
+    binding("up", "picker.up", "picker"),
+    binding("down", "picker.down", "picker"),
+    binding("enter", "picker.accept", "picker"),
+    binding("escape", "picker.dismiss", "picker"),
+    // modal
+    binding("y", "modal.confirm", "modal"),
+    binding("n", "modal.deny", "modal"),
+    binding("escape", "modal.dismiss", "modal"),
+    // plan
+    binding("down", "plan.next-task", "plan"),
+    binding("up", "plan.prev-task", "plan"),
+    binding("enter", "plan.toggle-detail", "plan"),
+    // transcript search
+    binding("escape", "picker.dismiss", "transcript-search"),
+    binding("enter", "picker.accept", "transcript-search"),
+    // pager
+    binding("up", "pager.line-up", "pager"),
+    binding("k", "pager.line-up", "pager"),
+    binding("down", "pager.line-down", "pager"),
+    binding("j", "pager.line-down", "pager"),
+    binding("pageup", "pager.page-up", "pager"),
+    binding("pagedown", "pager.page-down", "pager"),
+    // Match chat: ^U/^D = absolute top/bottom (no g/G).
+    binding("ctrl+u", "pager.top", "pager"),
+    binding("ctrl+d", "pager.bottom", "pager"),
+    binding("home", "pager.top", "pager"),
+    binding("end", "pager.bottom", "pager"),
+    binding("ctrl+r", "pager.search", "pager"),
+    binding("n", "pager.next-match", "pager"),
+    binding("shift+n", "pager.prev-match", "pager"),
+    // Many terminals drop Shift on Ctrl chords, so bind both forms. Bare `s`
+    // is also available (pager traps input; no conflict with transcript search).
+    binding("ctrl+shift+s", "pager.export-scrollback", "pager"),
+    binding("ctrl+s", "pager.export-scrollback", "pager"),
+    binding("s", "pager.export-scrollback", "pager"),
+    binding("ctrl+shift+e", "pager.export-editor", "pager"),
+    binding("ctrl+e", "pager.export-editor", "pager"),
+    binding("e", "pager.export-editor", "pager"),
+    binding("c", "pager.copy", "pager"),
+    // Follow/pause a live job feed. No-op on static bodies.
+    binding("l", "pager.toggle-follow", "pager"),
+    // Markdown view toggle (tool dumps, .md files, mixed bodies).
+    binding("f", "pager.format", "pager"),
+    binding("r", "pager.raw", "pager"),
+    binding("q", "pager.close", "pager"),
+    binding("escape", "pager.close", "pager"),
+    // jobs
+    binding("up", "jobs.up", "jobs"),
+    binding("down", "jobs.down", "jobs"),
+    binding("enter", "jobs.view-live", "jobs"),
+    binding("v", "jobs.view-live", "jobs"),
+    binding("t", "jobs.tail", "jobs"),
+    binding("k", "jobs.stop", "jobs"),
+    binding("q", "jobs.close", "jobs"),
+    binding("escape", "jobs.close", "jobs"),
+];
+export function validateKeymap(bindings) {
+    const byKey = new Map();
+    for (const b of bindings) {
+        const key = `${b.context}::${b.chord}`;
+        const set = byKey.get(key) ?? new Set();
+        set.add(b.action);
+        byKey.set(key, set);
+    }
+    const conflicts = [];
+    for (const [key, actions] of byKey) {
+        if (actions.size > 1) {
+            const [context, chord] = key.split("::");
+            conflicts.push({ context, chord, actions: [...actions] });
+        }
+    }
+    return conflicts;
+}
+//# sourceMappingURL=keymap.js.map

package/dist/ui-core/actions/keymap.js.map

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

package/dist/ui-core/actions/mode-cycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-cycle.js","sourceRoot":"","sources":["../../../src/ui-core/actions/mode-cycle.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,iCAAiC;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAE1E,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,OAAa;IACpC,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,gBAAgB,CAAC,CAAC,CAAE,CAAC;IAC3C,OAAO,gBAAgB,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAE,CAAC;AAClE,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,IAAU;IAC1C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK;YACR,OAAO,8BAA8B,CAAC;QACxC,KAAK,MAAM;YACT,OAAO,+BAA+B,CAAC;QACzC,KAAK,OAAO,CAAC;QACb;YACE,OAAO,0BAA0B,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/ui-core/bootstrap/can-use-tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"can-use-tui.js","sourceRoot":"","sources":["../../../src/ui-core/bootstrap/can-use-tui.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QACxC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;IAC3B,IAAI,IAAI,GAAG,QAAQ,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;QACvC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;IACvE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,uEAAuE;IACvE,4EAA4E;IAC5E,kDAAkD;IAClD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,qCAAqC,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;QACjC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK;QAC/B,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO;QAC/B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/ui-core/bootstrap/capabilities.js

@@ -0,0 +1,96 @@
+/**
+ * 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);
+}
+export 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";
+}
+function positiveOr(value, fallback) {
+    return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+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: positiveOr(input.columns, DEFAULT_COLUMNS),
+        rows: positiveOr(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/ui-core/bootstrap/capabilities.js.map

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