@autopilot-agent/cli 0.0.0-stage → 0.2.0

package/dist/tui/markdown/markdown.js

@@ -0,0 +1,117 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import stringWidth from "string-width";
+import { TUI_ACCENT_COLOR } from "../../design-tokens.js";
+import { renderMarkdownInline } from "./inline.js";
+import { fitTuiMarkdownTableColumnWidths, getTuiMarkdownTableColumnWidths, hasMarkdownTableCells, isLooseMarkdownTable, isMarkdownBlockStart, isMarkdownTableDivider, normalizeMarkdownTableCells, splitMarkdownTableRow, wrapTuiMarkdownTableCell, } from "./table.js";
+/** 渲染已经按当前终端宽度适配列宽的对齐 Markdown 表格。 */
+export function TuiMarkdownAlignedTable(props) {
+    const widths = fitTuiMarkdownTableColumnWidths(getTuiMarkdownTableColumnWidths([props.header, ...props.rows]), props.maximumWidth);
+    const makeBorder = function makeBorder(left, join, right) {
+        return left + widths.map(function makeColumnBorder(width) { return "─".repeat(width + 2); }).join(join) + right;
+    };
+    const renderRow = function renderRow(cells, keyPrefix, header = false) {
+        const wrappedCells = cells.map(function wrapCell(cell, index) { return wrapTuiMarkdownTableCell(cell, widths[index] ?? 3); });
+        const rowHeight = Math.max(1, ...wrappedCells.map(function getCellHeight(cellLines) { return cellLines.length; }));
+        return (_jsx(Box, { flexDirection: "column", children: Array.from({ length: rowHeight }, function renderLine(_unused, lineIndex) {
+                return _jsxs(Box, { children: [_jsx(Text, { children: "\u2502" }), wrappedCells.map(function renderCell(cellLines, index) {
+                            const cellLine = cellLines[lineIndex] ?? "";
+                            const padding = " ".repeat(Math.max(0, (widths[index] ?? 3) - stringWidth(cellLine)));
+                            return _jsx(Box, { width: (widths[index] ?? 3) + 2, paddingX: 1, children: _jsx(Text, { bold: header, children: renderMarkdownInline(cellLine + padding, keyPrefix + ":cell:" + String(index) + ":line:" + String(lineIndex), props.useColor) }) }, keyPrefix + ":cell:" + String(index));
+                        }), _jsx(Text, { children: "\u2502" })] }, keyPrefix + ":line:" + String(lineIndex));
+            }) }, keyPrefix));
+    };
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: makeBorder("┌", "┬", "┐") }), renderRow(props.header, props.keyPrefix + ":header", true), _jsx(Text, { children: makeBorder("├", "┼", "┤") }), props.rows.map(function renderTableRow(row, index) { return renderRow(row, props.keyPrefix + ":row:" + String(index)); }), _jsx(Text, { children: makeBorder("└", "┴", "┘") })] }));
+}
+/** 渲染 CLI 所需的安全 Markdown 子集，不解析或执行 HTML。 */
+export function TuiMarkdown(props) {
+    const nodes = [];
+    const lines = props.content.replace(/\r\n?/g, "\n").split("\n");
+    let index = 0;
+    let blockIndex = 0;
+    while (index < lines.length) {
+        const line = lines[index] ?? "";
+        if (!line.trim()) {
+            index += 1;
+            continue;
+        }
+        const key = props.keyPrefix + ":block:" + String(blockIndex++);
+        const fence = line.match(/^\s*(`{3,}|~{3,})\s*([^\s]*)/);
+        if (fence) {
+            const marker = fence[1];
+            const closePattern = new RegExp("^\\s*" + marker[0] + "{" + String(marker.length) + ",}\\s*$");
+            const codeLines = [];
+            index += 1;
+            while (index < lines.length && !closePattern.test(lines[index] ?? "")) {
+                codeLines.push(lines[index] ?? "");
+                index += 1;
+            }
+            if (index < lines.length)
+                index += 1;
+            nodes.push(_jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, children: [_jsxs(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: ["code \u00B7 ", fence[2] || "text"] }), _jsx(Text, { wrap: "wrap", children: codeLines.join("\n") || " " })] }, key));
+            continue;
+        }
+        const heading = line.match(/^(#{1,6})\s+(.+)$/);
+        if (heading) {
+            nodes.push(_jsx(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, wrap: "wrap", children: renderMarkdownInline(heading[2], key, props.useColor) }, key));
+            index += 1;
+            continue;
+        }
+        if (/^\s*(?:---+|\*\*\*+|___+)\s*$/.test(line)) {
+            nodes.push(_jsx(Text, { dimColor: props.useColor, children: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500" }, key));
+            index += 1;
+            continue;
+        }
+        const tableHeader = splitMarkdownTableRow(line);
+        const hasStrictTableDivider = line.includes("|") && isMarkdownTableDivider(lines[index + 1] ?? "");
+        const hasLooseTableRows = isLooseMarkdownTable(lines, index);
+        if (hasStrictTableDivider || hasLooseTableRows) {
+            const tableRows = [];
+            let rowIndex = index + (hasStrictTableDivider ? 2 : 1);
+            while (rowIndex < lines.length && hasMarkdownTableCells(lines[rowIndex] ?? "", tableHeader.length)) {
+                const rowCells = normalizeMarkdownTableCells(lines[rowIndex] ?? "", tableHeader.length);
+                if (!rowCells)
+                    break;
+                tableRows.push(rowCells);
+                rowIndex += 1;
+            }
+            if (tableRows.length > 0) {
+                nodes.push(_jsx(TuiMarkdownAlignedTable, { header: tableHeader, rows: tableRows, keyPrefix: key, useColor: props.useColor, maximumWidth: props.maximumWidth }, key));
+                index = rowIndex;
+                continue;
+            }
+            if (hasStrictTableDivider) {
+                nodes.push(_jsxs(Text, { wrap: "wrap", children: [line, "\n", lines[index + 1] ?? ""] }, key));
+                index += 2;
+                continue;
+            }
+        }
+        const quote = line.match(/^\s*>\s?(.*)$/);
+        if (quote) {
+            const quoteLines = [];
+            while (index < lines.length) {
+                const nextQuote = (lines[index] ?? "").match(/^\s*>\s?(.*)$/);
+                if (!nextQuote)
+                    break;
+                quoteLines.push(nextQuote[1]);
+                index += 1;
+            }
+            nodes.push(_jsx(Box, { borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, children: _jsx(Text, { wrap: "wrap", children: renderMarkdownInline(quoteLines.join(" "), key, props.useColor) }) }, key));
+            continue;
+        }
+        const list = line.match(/^(\s*)((?:[-+*])|(?:\d+[.)]))\s+(.+)$/);
+        if (list) {
+            nodes.push(_jsxs(Text, { wrap: "wrap", children: [list[1], list[2], " ", renderMarkdownInline(list[3], key, props.useColor)] }, key));
+            index += 1;
+            continue;
+        }
+        const paragraph = [line];
+        index += 1;
+        while (index < lines.length && (lines[index] ?? "").trim() && !isMarkdownBlockStart(lines, index)) {
+            paragraph.push(lines[index] ?? "");
+            index += 1;
+        }
+        nodes.push(_jsx(Text, { wrap: "wrap", children: renderMarkdownInline(paragraph.join(" "), key, props.useColor) }, key));
+    }
+    return _jsx(Box, { flexDirection: "column", children: nodes });
+}

package/dist/tui/markdown/table.d.ts

@@ -0,0 +1,19 @@
+/** Markdown 表格纯函数：拆分、识别分隔行、归一化列数与列宽适配，不涉及渲染。 */
+/** 将一行 Markdown 表格拆成可在终端逐格显示的安全文本。 */
+export declare function splitMarkdownTableRow(line: string): string[];
+/** 判断一行是否是 GitHub 风格 Markdown 表格的分隔行。 */
+export declare function isMarkdownTableDivider(line: string): boolean;
+/** 将模型行归一为表头列数；命令内容多出的 shell 管道合并进最后一列。 */
+export declare function normalizeMarkdownTableCells(line: string, cellCount: number): string[] | undefined;
+/** 判断一行是否包含至少指定列数的竖线分列表格数据。 */
+export declare function hasMarkdownTableCells(line: string, cellCount: number): boolean;
+/** 判断模型漏掉分隔行时，表头和首行数据是否仍可安全识别为宽松表格。 */
+export declare function isLooseMarkdownTable(lines: string[], index: number): boolean;
+/** 判断一行是否会开始新的 Markdown 块，避免把相邻段落错误合并。 */
+export declare function isMarkdownBlockStart(lines: string[], index: number): boolean;
+/** 计算 Markdown 表格每列的最大显示宽度。 */
+export declare function getTuiMarkdownTableColumnWidths(rows: string[][]): number[];
+/** 将表格列压缩到当前终端宽度，保留每列至少三个可读字符。 */
+export declare function fitTuiMarkdownTableColumnWidths(widths: number[], maximumWidth: number): number[];
+/** 将单元格文本按指定宽度硬换行，返回逐行显示文本。 */
+export declare function wrapTuiMarkdownTableCell(value: string, width: number): string[];

package/dist/tui/markdown/table.js

@@ -0,0 +1,74 @@
+/** Markdown 表格纯函数：拆分、识别分隔行、归一化列数与列宽适配，不涉及渲染。 */
+import stringWidth from "string-width";
+import wrapAnsi from "wrap-ansi";
+/** 将一行 Markdown 表格拆成可在终端逐格显示的安全文本。 */
+export function splitMarkdownTableRow(line) {
+    const trimmed = line.trim().replace(/^\|/, "").replace(/\|$/, "");
+    return trimmed.split("|").map(function trimCell(cell) { return cell.trim(); });
+}
+/** 判断一行是否是 GitHub 风格 Markdown 表格的分隔行。 */
+export function isMarkdownTableDivider(line) {
+    const cells = splitMarkdownTableRow(line);
+    return cells.length > 0 && cells.every(function isDivider(cell) { return /^:?-{3,}:?$/.test(cell); });
+}
+/** 将模型行归一为表头列数；命令内容多出的 shell 管道合并进最后一列。 */
+export function normalizeMarkdownTableCells(line, cellCount) {
+    if (!line.includes("|"))
+        return undefined;
+    const cells = splitMarkdownTableRow(line);
+    if (cells.length < cellCount)
+        return undefined;
+    if (cells.length === cellCount)
+        return cells;
+    return [...cells.slice(0, cellCount - 1), cells.slice(cellCount - 1).join(" | ")];
+}
+/** 判断一行是否包含至少指定列数的竖线分列表格数据。 */
+export function hasMarkdownTableCells(line, cellCount) {
+    return normalizeMarkdownTableCells(line, cellCount) !== undefined;
+}
+/** 判断模型漏掉分隔行时，表头和首行数据是否仍可安全识别为宽松表格。 */
+export function isLooseMarkdownTable(lines, index) {
+    const header = lines[index] ?? "";
+    const trimmedHeader = header.trim();
+    if (!/^\|.+/.test(trimmedHeader))
+        return false;
+    const cells = splitMarkdownTableRow(header);
+    return cells.length >= 2 && hasMarkdownTableCells(lines[index + 1] ?? "", cells.length);
+}
+/** 判断一行是否会开始新的 Markdown 块，避免把相邻段落错误合并。 */
+export function isMarkdownBlockStart(lines, index) {
+    const line = lines[index] ?? "";
+    return /^\s*(`{3,}|~{3,})/.test(line)
+        || /^#{1,6}\s+/.test(line)
+        || /^\s*>\s?/.test(line)
+        || /^\s*(?:[-+*]|\d+[.)])\s+/.test(line)
+        || /^\s*(?:---+|\*\*\*+|___+)\s*$/.test(line)
+        || (line.includes("|") && (isMarkdownTableDivider(lines[index + 1] ?? "") || isLooseMarkdownTable(lines, index)));
+}
+/** 计算 Markdown 表格每列的最大显示宽度。 */
+export function getTuiMarkdownTableColumnWidths(rows) {
+    return rows[0].map(function getColumnWidth(_cell, columnIndex) {
+        return Math.max(3, ...rows.map(function getCellWidth(row) { return stringWidth(row[columnIndex] ?? ""); }));
+    });
+}
+/** 将表格列压缩到当前终端宽度，保留每列至少三个可读字符。 */
+export function fitTuiMarkdownTableColumnWidths(widths, maximumWidth) {
+    const fitted = widths.map(function fitColumn(width) { return Math.max(3, width); });
+    const availableWidth = Math.max(fitted.length * 3, maximumWidth - fitted.length * 3 - 1);
+    while (fitted.reduce(function sumWidths(total, width) { return total + width; }, 0) > availableWidth) {
+        let widestIndex = 0;
+        for (let index = 1; index < fitted.length; index += 1) {
+            if ((fitted[index] ?? 0) > (fitted[widestIndex] ?? 0))
+                widestIndex = index;
+        }
+        if ((fitted[widestIndex] ?? 3) <= 3)
+            break;
+        fitted[widestIndex] = Math.max(3, (fitted[widestIndex] ?? 3) - 1);
+    }
+    return fitted;
+}
+/** 将单元格文本按指定宽度硬换行，返回逐行显示文本。 */
+export function wrapTuiMarkdownTableCell(value, width) {
+    const wrapped = wrapAnsi(value, Math.max(1, width), { hard: true, trim: false, wordWrap: true }).split("\n");
+    return wrapped.length > 0 ? wrapped : [""];
+}

package/dist/tui/performance-diagnostics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI 性能诊断事件：只缓冲渲染与输入时刻、耗时和事件类型，退出时一次性写入显式文件。
+ */
+/** 记录一个不含用户内容的 CLI 性能诊断点。 */
+export declare function recordTuiPerformanceDiagnostic(point: string, eventType: string, durationMs?: number): void;
+/** 只把稳定类别与白名单错误码写入显式诊断缓冲，不保存异常正文或调用内容。 */
+export declare function recordTuiRuntimeErrorDiagnostic(error: unknown): void;

package/dist/tui/performance-diagnostics.js

@@ -0,0 +1,57 @@
+/**
+ * CLI 性能诊断事件：只缓冲渲染与输入时刻、耗时和事件类型，退出时一次性写入显式文件。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { classifyCliError } from "../error-diagnostics.js";
+const PERFORMANCE_DIAGNOSTICS_KEY = Symbol.for("autopilot.performanceDiagnostics");
+let exitHookInstalled = false;
+/** 返回与 Core 诊断点共享的进程内缓冲。 */
+function getPerformanceDiagnosticBuffer() {
+    const target = globalThis;
+    target[PERFORMANCE_DIAGNOSTICS_KEY] ??= [];
+    return target[PERFORMANCE_DIAGNOSTICS_KEY];
+}
+/** 在进程退出时一次性写入 JSONL，避免逐事件文件 I/O 污染被测热路径。 */
+function ensureExitFlush() {
+    if (exitHookInstalled)
+        return;
+    exitHookInstalled = true;
+    process.once("exit", function flushPerformanceDiagnostics() {
+        const outputFile = process.env.AUTOPILOT_PERF_DIAGNOSTICS_FILE;
+        if (!outputFile)
+            return;
+        fs.mkdirSync(path.dirname(outputFile), { recursive: true });
+        const records = getPerformanceDiagnosticBuffer();
+        fs.writeFileSync(outputFile, records.map(function serialize(record) { return JSON.stringify(record); }).join("\n") + "\n", "utf8");
+    });
+}
+/** 记录一个不含用户内容的 CLI 性能诊断点。 */
+export function recordTuiPerformanceDiagnostic(point, eventType, durationMs) {
+    if (process.env.AUTOPILOT_PERF_DIAGNOSTICS !== "1")
+        return;
+    ensureExitFlush();
+    const record = {
+        version: 1,
+        point,
+        eventType,
+        monotonicMs: Number(performance.now().toFixed(3)),
+        ...(durationMs === undefined ? {} : { durationMs: Number(durationMs.toFixed(3)) }),
+    };
+    getPerformanceDiagnosticBuffer().push(record);
+}
+/** 只把稳定类别与白名单错误码写入显式诊断缓冲，不保存异常正文或调用内容。 */
+export function recordTuiRuntimeErrorDiagnostic(error) {
+    if (process.env.AUTOPILOT_PERF_DIAGNOSTICS !== "1")
+        return;
+    ensureExitFlush();
+    const classification = classifyCliError(error);
+    getPerformanceDiagnosticBuffer().push({
+        version: 1,
+        point: "tui_runtime_error",
+        eventType: "dispatch",
+        monotonicMs: Number(performance.now().toFixed(3)),
+        errorCategory: classification.category,
+        errorCode: classification.code,
+    });
+}

package/dist/tui/pickers/effort.d.ts

@@ -0,0 +1,10 @@
+/** 推理强度 picker；目录完全由 Controller 的 capability 投影提供。 */
+import { type ReactNode } from "react";
+import type { CliEffortOption } from "../../types.js";
+/** 渲染当前模型支持的 effort picker；Pro 不会出现 Low。 */
+export declare function TuiEffortPicker(props: {
+    options: CliEffortOption[];
+    selectedIndex: number;
+    useColor: boolean;
+    screenReader: boolean;
+}): ReactNode;

package/dist/tui/pickers/effort.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR } from "../../design-tokens.js";
+/** 渲染当前模型支持的 effort picker；Pro 不会出现 Low。 */
+export function TuiEffortPicker(props) {
+    const selectedIndex = Math.max(0, Math.min(props.selectedIndex, Math.max(0, props.options.length - 1)));
+    const selectedOption = props.options[selectedIndex];
+    return (_jsxs(Box, { marginTop: 1, borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, flexDirection: "column", "aria-role": "listbox", children: [_jsx(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "Thinking effort" }), _jsx(Text, { dimColor: props.useColor, children: "\u2191\u2193 select \u00B7 Space on/off \u00B7 Enter save \u00B7 Esc cancel" }), props.options.map(function renderEffort(option, index) {
+                const focused = index === selectedIndex;
+                return _jsxs(Text, { bold: focused, color: focused && props.useColor ? TUI_ACCENT_COLOR : undefined, children: [focused ? "› " : "  ", "[", option.selected ? "on" : "off", "] ", option.effort] }, option.effort);
+            }), _jsxs(Text, { dimColor: props.useColor, children: [selectedOption?.selected ? "已选择；Enter 保存为下一个 Turn 默认" : "Space 选择此推理强度", props.screenReader ? " · effort selector" : ""] })] }));
+}

package/dist/tui/pickers/file-mention.d.ts

@@ -0,0 +1,11 @@
+/** `@` 触发的文件候选菜单：codex 风格两列布局、≤5 行滚动窗口与固定键位提示行。 */
+import { type ReactNode } from "react";
+/** @ 菜单一次可见的最大候选行数。 */
+export declare const TUI_FILE_MENTION_VISIBLE_ROWS = 5;
+/** 渲染 @ 文件候选菜单；目录候选以尾随 `/` 标记并在类型列显示 dir，选中行用 `› ` 标记。 */
+export declare function TuiFileMentionMenu(props: {
+    candidates: string[];
+    selectedIndex: number;
+    useColor: boolean;
+    screenReader: boolean;
+}): ReactNode;

package/dist/tui/pickers/file-mention.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR } from "../../design-tokens.js";
+/** @ 菜单一次可见的最大候选行数。 */
+export const TUI_FILE_MENTION_VISIBLE_ROWS = 5;
+/** 计算 ≤5 行滚动窗口的起点，保证选中项始终可见。 */
+function resolveWindowStart(selectedIndex, candidateCount) {
+    if (candidateCount <= TUI_FILE_MENTION_VISIBLE_ROWS)
+        return 0;
+    return Math.max(0, Math.min(selectedIndex - TUI_FILE_MENTION_VISIBLE_ROWS + 1, candidateCount - TUI_FILE_MENTION_VISIBLE_ROWS));
+}
+/** 渲染 @ 文件候选菜单；目录候选以尾随 `/` 标记并在类型列显示 dir，选中行用 `› ` 标记。 */
+export function TuiFileMentionMenu(props) {
+    const selectedIndex = Math.max(0, Math.min(props.selectedIndex, Math.max(0, props.candidates.length - 1)));
+    const windowStart = resolveWindowStart(selectedIndex, props.candidates.length);
+    const visible = props.candidates.slice(windowStart, windowStart + TUI_FILE_MENTION_VISIBLE_ROWS);
+    return (_jsxs(Box, { marginTop: 1, borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, flexDirection: "column", "aria-role": "listbox", children: [_jsx(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "Files" }), _jsx(Text, { dimColor: props.useColor, children: "enter/tab insert \u00B7 esc close \u00B7 \u2191/\u2193 select" }), visible.map(function renderCandidate(candidate, offset) {
+                const absoluteIndex = windowStart + offset;
+                const selected = absoluteIndex === selectedIndex;
+                return (_jsxs(Text, { bold: selected, color: selected && props.useColor ? TUI_ACCENT_COLOR : undefined, children: [selected ? "› " : "  ", candidate, "  ", _jsx(Text, { dimColor: props.useColor, children: candidate.endsWith("/") ? "dir" : "file" })] }, candidate));
+            }), _jsxs(Text, { dimColor: props.useColor, children: [selectedIndex + 1, "/", props.candidates.length, " files", props.screenReader ? " · file selector" : ""] })] }));
+}

package/dist/tui/pickers/model.d.ts

@@ -0,0 +1,10 @@
+/** 模型 picker；目录完全由 Controller 的 settings-filtered capability 投影提供。 */
+import { type ReactNode } from "react";
+import type { CliModelOption } from "../../types.js";
+/** 渲染模型 picker；目录完全由 Controller 的 settings-filtered capability 投影提供。 */
+export declare function TuiModelPicker(props: {
+    options: CliModelOption[];
+    selectedIndex: number;
+    useColor: boolean;
+    screenReader: boolean;
+}): ReactNode;

package/dist/tui/pickers/model.js

@@ -0,0 +1,12 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR } from "../../design-tokens.js";
+/** 渲染模型 picker；目录完全由 Controller 的 settings-filtered capability 投影提供。 */
+export function TuiModelPicker(props) {
+    const selectedIndex = Math.max(0, Math.min(props.selectedIndex, Math.max(0, props.options.length - 1)));
+    const selectedOption = props.options[selectedIndex];
+    return (_jsxs(Box, { marginTop: 1, borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, flexDirection: "column", "aria-role": "listbox", children: [_jsx(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "Models" }), _jsx(Text, { dimColor: props.useColor, children: "\u2191\u2193 select \u00B7 Space on/off \u00B7 Enter save \u00B7 Esc cancel" }), props.options.map(function renderModel(option, index) {
+                const focused = index === selectedIndex;
+                return _jsxs(Text, { bold: focused, color: focused && props.useColor ? TUI_ACCENT_COLOR : undefined, children: [focused ? "› " : "  ", "[", option.selected ? "on" : "off", "] ", option.provider, "/", option.modelId] }, `${option.provider}/${option.modelId}`);
+            }), _jsxs(Text, { dimColor: props.useColor, children: [selectedOption?.selected ? "已选择；Enter 保存为下一个 Turn 默认" : "Space 选择此模型", props.screenReader ? " · model selector" : ""] })] }));
+}

package/dist/tui/pickers/permission.d.ts

@@ -0,0 +1,10 @@
+/** 三态权限 picker；只展示 Core 允许的模式和安全说明。 */
+import { type ReactNode } from "react";
+import type { CliPermissionOption } from "../../types.js";
+/** 渲染三态权限 picker；只展示 Core 允许的模式和安全说明。 */
+export declare function TuiPermissionPicker(props: {
+    options: CliPermissionOption[];
+    selectedIndex: number;
+    useColor: boolean;
+    screenReader: boolean;
+}): ReactNode;

package/dist/tui/pickers/permission.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { CLI_TUI_COLORS, TUI_ACCENT_COLOR } from "../../design-tokens.js";
+/** 渲染三态权限 picker；只展示 Core 允许的模式和安全说明。 */
+export function TuiPermissionPicker(props) {
+    const selectedIndex = Math.max(0, Math.min(props.selectedIndex, Math.max(0, props.options.length - 1)));
+    const selectedOption = props.options[selectedIndex];
+    return (_jsxs(Box, { marginTop: 1, borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, flexDirection: "column", "aria-role": "listbox", children: [_jsx(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "Permissions" }), _jsx(Text, { dimColor: props.useColor, children: "\u2191\u2193 select \u00B7 Space on/off \u00B7 Enter save \u00B7 Esc cancel" }), props.options.map(function renderPermission(option, index) {
+                const focused = index === selectedIndex;
+                const checkboxColor = option.mode === "full_access" && option.selected && props.useColor ? CLI_TUI_COLORS.permissionFullAccess : undefined;
+                return _jsxs(Text, { bold: focused, color: focused && props.useColor ? TUI_ACCENT_COLOR : undefined, children: [focused ? "› " : "  ", _jsxs(Text, { color: checkboxColor, dimColor: false, children: ["[", option.selected ? "on" : "off", "]"] }), " ", option.label, " (", option.mode, ")"] }, option.mode);
+            }), selectedOption ? _jsxs(Text, { dimColor: props.useColor, children: ["  ", selectedOption.description] }) : null, _jsxs(Text, { dimColor: props.useColor, children: [selectedOption?.selected ? "已选择；Enter 保存为下一个 Turn 默认" : "Space 选择此权限模式", props.screenReader ? " · permission selector" : ""] })] }));
+}

package/dist/tui/pickers/skill.d.ts

@@ -0,0 +1,13 @@
+/** Skill 选择器：按展示名、canonical 名称和说明筛选，方向键/空格/搜索操作。 */
+import { type ReactNode } from "react";
+import type { CliSkillSummary } from "../../types.js";
+/** 以展示名、canonical 名称和说明筛选 TUI 内已脱敏的 Skill 摘要。 */
+export declare function filterTuiSkills(skills: CliSkillSummary[], query: string): CliSkillSummary[];
+/** 渲染可用方向键、空格开关和搜索操作的 Skill 选择器。 */
+export declare function TuiSkillPicker(props: {
+    skills: CliSkillSummary[];
+    query: string;
+    selectedIndex: number;
+    useColor: boolean;
+    screenReader: boolean;
+}): ReactNode;

package/dist/tui/pickers/skill.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR, TUI_SKILL_OFF_COLOR, TUI_SKILL_ON_COLOR } from "../../design-tokens.js";
+/** 以展示名、canonical 名称和说明筛选 TUI 内已脱敏的 Skill 摘要。 */
+export function filterTuiSkills(skills, query) {
+    const normalizedQuery = query.trim().toLocaleLowerCase();
+    if (!normalizedQuery)
+        return skills;
+    return skills.filter(function matchesSkill(skill) {
+        return `${skill.displayName}\n${skill.qualifiedName}\n${skill.description}`.toLocaleLowerCase().includes(normalizedQuery);
+    });
+}
+/** 渲染可用方向键、空格开关和搜索操作的 Skill 选择器。 */
+export function TuiSkillPicker(props) {
+    const filteredSkills = filterTuiSkills(props.skills, props.query);
+    const selectedIndex = Math.max(0, Math.min(props.selectedIndex, Math.max(0, filteredSkills.length - 1)));
+    const firstVisibleIndex = Math.max(0, Math.min(selectedIndex - 3, Math.max(0, filteredSkills.length - 8)));
+    const visibleSkills = filteredSkills.slice(firstVisibleIndex, firstVisibleIndex + 8);
+    const selectedSkill = filteredSkills[selectedIndex];
+    return (_jsxs(Box, { marginTop: 1, borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, flexDirection: "column", "aria-role": "listbox", children: [_jsx(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "Skills" }), _jsx(Text, { dimColor: props.useColor, children: "\u2191\u2193 select \u00B7 Space on/off \u00B7 Enter save \u00B7 type or / to search \u00B7 Esc cancel" }), _jsxs(Box, { borderStyle: "single", marginTop: 1, paddingX: 1, "aria-role": "textbox", children: [_jsxs(Text, { children: ["Search: ", props.query] }), _jsx(Text, { color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "\u258F" })] }), visibleSkills.length === 0 ? _jsx(Text, { dimColor: props.useColor, children: "no matching skills" }) : visibleSkills.map(function renderSkill(skill, visibleIndex) {
+                const index = firstVisibleIndex + visibleIndex;
+                const selected = index === selectedIndex;
+                return _jsxs(Text, { bold: selected, color: selected && props.useColor ? TUI_ACCENT_COLOR : undefined, children: [selected ? "› " : "  ", _jsxs(Text, { color: props.useColor ? skill.selected ? TUI_SKILL_ON_COLOR : TUI_SKILL_OFF_COLOR : undefined, children: ["[", skill.selected ? "on" : "off", "]"] }), " ", skill.displayName, " \u00B7 ", skill.qualifiedName] }, skill.qualifiedName);
+            }), selectedSkill?.description ? _jsxs(Text, { dimColor: props.useColor, children: ["  ", selectedSkill.description] }) : null, _jsxs(Text, { dimColor: props.useColor, children: [filteredSkills.length === 0 ? "0 skills" : `${selectedIndex + 1}/${filteredSkills.length} skills`, props.screenReader ? " · skill selector" : ""] })] }));
+}

package/dist/tui/pickers/slash.d.ts

@@ -0,0 +1,10 @@
+/** `/` 触发的完整 slash 命令目录；用户只需选择，不必记住命令名。 */
+import { type ReactNode } from "react";
+import type { CliSlashCommand } from "../../types.js";
+/** 渲染 `/` 触发的完整 slash 命令目录；用户只需选择，不必记住命令名。 */
+export declare function TuiSlashCommandMenu(props: {
+    commands: CliSlashCommand[];
+    selectedIndex: number;
+    useColor: boolean;
+    screenReader: boolean;
+}): ReactNode;

package/dist/tui/pickers/slash.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR } from "../../design-tokens.js";
+/** 渲染 `/` 触发的完整 slash 命令目录；用户只需选择，不必记住命令名。 */
+export function TuiSlashCommandMenu(props) {
+    const selectedIndex = Math.max(0, Math.min(props.selectedIndex, Math.max(0, props.commands.length - 1)));
+    return (_jsxs(Box, { marginTop: 1, borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, flexDirection: "column", "aria-role": "listbox", children: [_jsx(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "Commands" }), _jsx(Text, { dimColor: props.useColor, children: "\u2191\u2193 select \u00B7 Tab complete \u00B7 Enter choose \u00B7 Esc close" }), props.commands.map(function renderSlashCommand(command, index) {
+                const selected = index === selectedIndex;
+                return (_jsxs(Text, { bold: selected, color: selected && props.useColor ? TUI_ACCENT_COLOR : undefined, children: [selected ? "› " : "  ", command.usage, "  ", _jsx(Text, { dimColor: props.useColor, children: command.description })] }, command.name));
+            }), _jsxs(Text, { dimColor: props.useColor, children: [selectedIndex + 1, "/", props.commands.length, " commands", props.screenReader ? " · command selector" : ""] })] }));
+}

package/dist/tui/prompt-input.d.ts

@@ -0,0 +1,11 @@
+/** 带可视光标的多行输入；prompt 按 @mention 分段上色，所有文本放进同一个 Text 避免兄弟节点分别换行。 */
+import { type ReactNode } from "react";
+/** 渲染带可视光标的多行输入；所有 prompt 文本放进同一个 Text，避免兄弟节点分别换行。 */
+export declare function TuiPromptInput(props: {
+    input: string;
+    cursorIndex: number;
+    columns: number;
+    useColor: boolean;
+    screenReader: boolean;
+    busy: boolean;
+}): ReactNode;

package/dist/tui/prompt-input.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR } from "../design-tokens.js";
+import { TUI_CURSOR_CHARACTER, TUI_PROMPT_PREFIX } from "./constants.js";
+import { splitTuiFileMentionSegments } from "./input/file-mention.js";
+import { createTuiPromptLayout } from "./input/prompt-layout.js";
+/** 渲染单个 mention/普通片段；mention 片段用强调色加粗，普通片段保持默认样式。 */
+function renderSegment(segment, key, useColor) {
+    if (segment.isMention && useColor) {
+        return _jsx(Text, { color: TUI_ACCENT_COLOR, bold: true, children: segment.text }, key);
+    }
+    return _jsx(Text, { children: segment.text }, key);
+}
+/** 把一行文本按 mention 分段渲染，并将可视光标插入所属段的正确位置。 */
+function renderLineWithCursor(lineText, cursorOffset, useColor, lineKey) {
+    const nodes = [];
+    const segments = splitTuiFileMentionSegments(lineText);
+    let offset = 0;
+    let cursorRendered = cursorOffset < 0;
+    for (let index = 0; index < segments.length; index += 1) {
+        const segment = segments[index];
+        const start = offset;
+        const end = offset + segment.text.length;
+        offset = end;
+        if (cursorRendered || cursorOffset < start || cursorOffset > end) {
+            nodes.push(renderSegment(segment, `seg-${lineKey}-${index}`, useColor));
+            continue;
+        }
+        // 光标落在本段内：拆成 前/光标/后 三段，光标保持既有强调色。
+        const local = cursorOffset - start;
+        const color = segment.isMention && useColor ? TUI_ACCENT_COLOR : undefined;
+        const before = segment.text.slice(0, local);
+        const after = segment.text.slice(local);
+        if (before)
+            nodes.push(_jsx(Text, { color: color, bold: segment.isMention && useColor, children: before }, `seg-${lineKey}-${index}-b`));
+        nodes.push(_jsx(Text, { color: useColor ? TUI_ACCENT_COLOR : undefined, children: TUI_CURSOR_CHARACTER }, `prompt-cursor-${lineKey}`));
+        if (after)
+            nodes.push(_jsx(Text, { color: color, bold: segment.isMention && useColor, children: after }, `seg-${lineKey}-${index}-a`));
+        cursorRendered = true;
+    }
+    if (!cursorRendered) {
+        // 空行或段切分为空时仍需渲染光标，保持占位行为不变。
+        nodes.push(_jsx(Text, { color: useColor ? TUI_ACCENT_COLOR : undefined, children: TUI_CURSOR_CHARACTER }, `prompt-cursor-${lineKey}`));
+    }
+    return nodes;
+}
+/** 渲染带可视光标的多行输入；所有 prompt 文本放进同一个 Text，避免兄弟节点分别换行。 */
+export function TuiPromptInput(props) {
+    const layout = createTuiPromptLayout(props.input, props.cursorIndex, Math.max(1, props.columns - 4));
+    const nodes = [];
+    const placeholder = props.screenReader && !props.input ? "prompt" : "";
+    for (let index = 0; index < layout.lines.length; index += 1) {
+        const line = layout.lines[index];
+        if (!line)
+            continue;
+        if (index > 0)
+            nodes.push("\n");
+        const isCursorLine = index === layout.cursorLine;
+        let lineText = line.text;
+        let cursorOffset = isCursorLine
+            ? Math.max(0, Math.min(line.text.length, layout.cursorOffset - line.start))
+            : -1;
+        if (index === 0 && lineText.startsWith(TUI_PROMPT_PREFIX)) {
+            nodes.push(_jsx(Text, { color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: TUI_PROMPT_PREFIX }, `prompt-prefix-${index}`));
+            lineText = lineText.slice(TUI_PROMPT_PREFIX.length);
+            cursorOffset = Math.max(0, cursorOffset - TUI_PROMPT_PREFIX.length);
+        }
+        nodes.push(...renderLineWithCursor(lineText, cursorOffset, props.useColor, index));
+        if (isCursorLine && placeholder)
+            nodes.push(placeholder);
+    }
+    return (_jsx(Box, { "aria-role": "textbox", "aria-state": { busy: props.busy, multiline: true }, width: props.columns, marginTop: 1, borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, children: _jsx(Text, { wrap: "wrap", children: nodes }) }));
+}

package/dist/tui/render-mode.d.ts

@@ -0,0 +1,20 @@
+/** TUI 启动期一次性解析的渲染模式纯函数：颜色/读屏/降级/渲染模式策略。 */
+import type { TuiRenderMode } from "./types.js";
+/** 判断当前环境是否要求关闭 ANSI 颜色。 */
+export declare function resolveNoColor(env: NodeJS.ProcessEnv): boolean;
+/** 解析 Ink screen-reader 开关，并保留 Ink 官方环境变量兼容性。 */
+export declare function resolveScreenReader(env: NodeJS.ProcessEnv): boolean;
+/** R0 冻结的最终模式策略；平台由调用方注入，避免测试伪造全局 process.platform。 */
+export declare function resolveTuiRenderModePolicy(input: {
+    env: NodeJS.ProcessEnv;
+    platform: NodeJS.Platform | string;
+}): TuiRenderMode;
+/** R2 的 win32 FULLSCREEN 回落提示；返回值由启动副作用层写入 stderr。 */
+export declare function getTuiRenderModeFallbackNotice(input: {
+    env: NodeJS.ProcessEnv;
+    platform: NodeJS.Platform | string;
+}): string | undefined;
+/** 仅在 TUI 启动期决定内联或备用屏；宿主 TTY/Plain 门禁仍由 main.ts 保持。 */
+export declare function resolveTuiRenderMode(env: NodeJS.ProcessEnv, platform?: NodeJS.Platform | string): TuiRenderMode;
+/** 解析终端 reduced-motion 开关；非标准环境变量只作为 CLI 宿主的本地降级提示。 */
+export declare function resolveReducedMotion(env: NodeJS.ProcessEnv): boolean;

package/dist/tui/render-mode.js

@@ -0,0 +1,31 @@
+/** TUI 启动期一次性解析的渲染模式纯函数：颜色/读屏/降级/渲染模式策略。 */
+/** 判断当前环境是否要求关闭 ANSI 颜色。 */
+export function resolveNoColor(env) {
+    return env.NO_COLOR !== undefined && env.NO_COLOR !== "";
+}
+/** 解析 Ink screen-reader 开关，并保留 Ink 官方环境变量兼容性。 */
+export function resolveScreenReader(env) {
+    return env.INK_SCREEN_READER === "true" || env.SCREEN_READER === "1" || env.SCREEN_READER === "true";
+}
+/** R0 冻结的最终模式策略；平台由调用方注入，避免测试伪造全局 process.platform。 */
+export function resolveTuiRenderModePolicy(input) {
+    if (resolveScreenReader(input.env) || input.env.AUTOPILOT_INLINE_TUI === "1")
+        return "inline";
+    if (input.env.AUTOPILOT_TUI_FULLSCREEN === "1" && input.platform !== "win32")
+        return "alternate-screen";
+    return "inline";
+}
+/** R2 的 win32 FULLSCREEN 回落提示；返回值由启动副作用层写入 stderr。 */
+export function getTuiRenderModeFallbackNotice(input) {
+    if (input.platform !== "win32" || input.env.AUTOPILOT_TUI_FULLSCREEN !== "1")
+        return undefined;
+    return "AUTOPILOT_TUI_FULLSCREEN is unsupported on win32; using inline mode. Remove AUTOPILOT_TUI_FULLSCREEN to cancel this request.\n";
+}
+/** 仅在 TUI 启动期决定内联或备用屏；宿主 TTY/Plain 门禁仍由 main.ts 保持。 */
+export function resolveTuiRenderMode(env, platform = process.platform) {
+    return resolveTuiRenderModePolicy({ env, platform });
+}
+/** 解析终端 reduced-motion 开关；非标准环境变量只作为 CLI 宿主的本地降级提示。 */
+export function resolveReducedMotion(env) {
+    return env.REDUCED_MOTION === "1" || env.REDUCED_MOTION === "true" || env.TERM_REDUCED_MOTION === "1" || env.TERM_REDUCED_MOTION === "true";
+}

package/dist/tui/run.d.ts

@@ -0,0 +1,6 @@
+/** TUI 入口编排：启动 Ink，统一处理信号、退出码和动态渲染生命周期。 */
+import type { CliTuiRecap, RunCliTuiOptions, RunCliTuiResult } from "./types.js";
+/** 将已知的安全会话字段格式化为主屏 recap；输出保持纯文本，兼容 NO_COLOR。 */
+export declare function formatCliTuiRecap(recap: CliTuiRecap): string;
+/** 启动 Ink，统一处理信号、退出码和动态渲染生命周期。 */
+export declare function runCliTui(options: RunCliTuiOptions): Promise<RunCliTuiResult>;