@autopilot-agent/cli 0.0.0-stage → 0.2.0

package/dist/tui/input/keys.js

@@ -0,0 +1,58 @@
+/** TUI 按键解析纯函数：归一化控制动作、删除方向、换行/粘贴/focus/滚动判断。 */
+import { splitTuiInputGraphemes } from "./graphemes.js";
+/** 将 Ink 键对象和终端控制字符归一为 TUI 控制动作，兼容真实 TTY 与测试 stdin。 */
+export function parseTuiControlAction(value, key) {
+    if (value === "\u0004" || (key.ctrl && value === "d"))
+        return "eof";
+    if ((key.ctrl && (value === "c" || value === "\u0003")) || value === "\u0003")
+        return "interrupt";
+    if (key.escape || value === "\u001b")
+        return "cancel";
+    return undefined;
+}
+/** 区分 Backspace 与前向 Delete，优先采用终端原始控制字符兼容 macOS Terminal。 */
+export function resolveTuiDeleteDirection(value, key, rawSequence = "") {
+    if (key.backspace || rawSequence === "\b" || rawSequence === "\u007f" || value === "\b" || value === "\u007f")
+        return "backspace";
+    if (/^\u001b\[3(?:;\d+)?[~$^]$/u.test(rawSequence))
+        return "delete";
+    if (key.delete)
+        return "delete";
+    return undefined;
+}
+/** 识别 Claude Code/终端常见的 Shift+Enter 编码；普通回车仍由 key.return 单独处理。 */
+export function isTuiMultilineEnter(value, key, rawSequence = "") {
+    if (key.return && (key.shift || key.meta))
+        return true;
+    const sequencePattern = /(?:\u001b)?\[(?:13;2(?::\d+)?(?:;[\d:]+)?u|13;2~|27;2;13~)$/u;
+    if (value && sequencePattern.test(value))
+        return true;
+    // Ink 的测试 stdin 与 readable 事件先后顺序不同；只有当前事件确实是空输入的特殊键时才读取原始序列，避免复用上一枚按键。
+    return value.length === 0 && key.shift && sequencePattern.test(rawSequence);
+}
+/** 识别 bracketed paste 边界；Ink 会去掉 CSI 序列的首个 ESC 后再交给 useInput。 */
+export function resolveTuiBracketedPasteBoundary(value) {
+    if (value === "[200~" || value === "\u001b[200~")
+        return "start";
+    if (value === "[201~" || value === "\u001b[201~")
+        return "end";
+    return undefined;
+}
+/** 判断终端 focus in/out 报告，避免控制序列被误插入 prompt。 */
+export function isTuiTerminalFocusSequence(value) {
+    return value === "[I" || value === "[O" || value === "\u001b[I" || value === "\u001b[O";
+}
+/** 判断按键是否属于备用屏滚动兜底，避免与普通 Home/End 输入语义混淆。 */
+export function isTuiViewportScrollKey(key) {
+    return key.pageUp || key.pageDown || Boolean(key.ctrl && (key.home || key.end));
+}
+/** 判断光标前的反斜线是否是未被另一枚反斜线转义的续行标记。 */
+export function hasTuiUnescapedContinuation(input, cursorIndex) {
+    const characters = splitTuiInputGraphemes(input);
+    if (cursorIndex <= 0 || characters[cursorIndex - 1] !== "\\")
+        return false;
+    let slashCount = 0;
+    for (let index = cursorIndex - 1; index >= 0 && characters[index] === "\\"; index -= 1)
+        slashCount += 1;
+    return slashCount % 2 === 1;
+}

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

@@ -0,0 +1,27 @@
+/** TUI prompt 视觉布局纯函数：测量视觉行、映射光标行列、生成布局。 */
+/** 一条 prompt 视觉行及其源文本映射。 */
+export interface TuiPromptVisualLine {
+    text: string;
+    start: number;
+    end: number;
+    width: number;
+}
+/** prompt 的完整视觉布局；输入状态仍只保存逻辑 grapheme cursorIndex。 */
+export interface TuiPromptLayout {
+    source: string;
+    lines: TuiPromptVisualLine[];
+    cursorOffset: number;
+    cursorLine: number;
+    cursorColumn: number;
+}
+/** 按 Ink 的 hard wrap 规则测量 prompt 的视觉行，并保留每行对应的源文本 offset。 */
+export declare function measureTuiPromptVisualLines(source: string, columns: number): TuiPromptVisualLine[];
+/** 将源文本 offset 映射为视觉行列；精确区分软换行和显式换行。 */
+export declare function getTuiPromptCursorPosition(lines: TuiPromptVisualLine[], source: string, cursorOffset: number): {
+    line: number;
+    column: number;
+};
+/** 将视觉行列映射回最近的 grapheme 边界，避免把中文或组合 emoji 拆开。 */
+export declare function resolveTuiPromptCursorIndex(input: string, layout: TuiPromptLayout, targetLine: number, targetColumn: number): number;
+/** 生成 prompt 的视觉布局；输入状态仍只保存逻辑 grapheme cursorIndex。 */
+export declare function createTuiPromptLayout(input: string, cursorIndex: number, columns: number): TuiPromptLayout;

package/dist/tui/input/prompt-layout.js

@@ -0,0 +1,84 @@
+/** TUI prompt 视觉布局纯函数：测量视觉行、映射光标行列、生成布局。 */
+import stringWidth from "string-width";
+import wrapAnsi from "wrap-ansi";
+import { TUI_CURSOR_WIDTH, TUI_INPUT_SEGMENTER, TUI_PROMPT_PREFIX } from "../constants.js";
+import { splitTuiInputGraphemes } from "./graphemes.js";
+/** 按 Ink 的 hard wrap 规则测量 prompt 的视觉行，并保留每行对应的源文本 offset。 */
+export function measureTuiPromptVisualLines(source, columns) {
+    const wrapWidth = Math.max(1, columns - TUI_CURSOR_WIDTH);
+    const wrapped = wrapAnsi(source, wrapWidth, { hard: true, trim: false });
+    const wrappedLines = wrapped.split("\n");
+    const lines = [];
+    let searchOffset = 0;
+    for (const line of wrappedLines) {
+        let start = line.length > 0 ? source.indexOf(line, searchOffset) : searchOffset;
+        if (start < 0)
+            start = searchOffset;
+        const end = start + line.length;
+        lines.push({ text: line, start, end, width: stringWidth(line) });
+        searchOffset = end;
+        if (source[searchOffset] === "\n")
+            searchOffset += 1;
+    }
+    return lines.length > 0 ? lines : [{ text: "", start: 0, end: 0, width: 0 }];
+}
+/** 将源文本 offset 映射为视觉行列；精确区分软换行和显式换行。 */
+export function getTuiPromptCursorPosition(lines, source, cursorOffset) {
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index];
+        if (!line || cursorOffset < line.start || cursorOffset > line.end)
+            continue;
+        // 软换行后的边界属于下一行；显式换行前的边界仍属于当前行。
+        if (cursorOffset === line.end && lines[index + 1]?.start === line.end && source[line.end] !== "\n")
+            continue;
+        const localOffset = Math.max(0, Math.min(line.text.length, cursorOffset - line.start));
+        return { line: index, column: stringWidth(line.text.slice(0, localOffset)) };
+    }
+    const lastLine = lines[lines.length - 1] ?? { text: "", start: 0, end: 0, width: 0 };
+    return { line: Math.max(0, lines.length - 1), column: lastLine.width };
+}
+/** 将视觉行列映射回最近的 grapheme 边界，避免把中文或组合 emoji 拆开。 */
+export function resolveTuiPromptCursorIndex(input, layout, targetLine, targetColumn) {
+    const line = layout.lines[targetLine];
+    if (!line)
+        return splitTuiInputGraphemes(input).length;
+    const minimumOffset = line.start === 0 ? TUI_PROMPT_PREFIX.length : line.start;
+    const minimumLocalOffset = Math.max(0, minimumOffset - line.start);
+    let bestOffset = Math.max(line.start, minimumOffset);
+    let bestColumn = stringWidth(line.text.slice(0, minimumLocalOffset));
+    function consider(localOffset) {
+        if (localOffset < minimumLocalOffset || localOffset > line.text.length)
+            return;
+        const column = stringWidth(line.text.slice(0, localOffset));
+        if (column <= targetColumn && column >= bestColumn) {
+            bestColumn = column;
+            bestOffset = line.start + localOffset;
+        }
+    }
+    consider(minimumLocalOffset);
+    for (const segment of TUI_INPUT_SEGMENTER.segment(line.text)) {
+        consider(segment.index);
+        consider(segment.index + segment.segment.length);
+    }
+    const inputOffset = Math.max(0, Math.min(input.length, bestOffset - TUI_PROMPT_PREFIX.length));
+    let cursorIndex = 0;
+    let sourceOffset = 0;
+    for (const segment of TUI_INPUT_SEGMENTER.segment(input)) {
+        if (sourceOffset + segment.segment.length > inputOffset)
+            break;
+        sourceOffset += segment.segment.length;
+        cursorIndex += 1;
+    }
+    return cursorIndex;
+}
+/** 生成 prompt 的视觉布局；输入状态仍只保存逻辑 grapheme cursorIndex。 */
+export function createTuiPromptLayout(input, cursorIndex, columns) {
+    const characters = splitTuiInputGraphemes(input);
+    const cursor = Math.max(0, Math.min(cursorIndex, characters.length));
+    const inputOffset = characters.slice(0, cursor).join("").length;
+    const source = TUI_PROMPT_PREFIX + input;
+    const lines = measureTuiPromptVisualLines(source, columns);
+    const cursorOffset = TUI_PROMPT_PREFIX.length + inputOffset;
+    const position = getTuiPromptCursorPosition(lines, source, cursorOffset);
+    return { source, lines, cursorOffset, cursorLine: position.line, cursorColumn: position.column };
+}

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

@@ -0,0 +1,53 @@
+/** TUI 输入子树：隔离 prompt、光标与 picker 状态，避免普通按键重建完整时间线。 */
+import { type Key } from "ink";
+import type { CliAction, CliSlashCommand } from "../types.js";
+import { usePickers } from "./hooks/use-pickers.js";
+import type { FileMentionIndex } from "./hooks/use-file-mention-index.js";
+import type { CliTuiStore } from "./types.js";
+/** 输入区与父级之间共享的稳定 ref；普通按键不需要把输入正文写回父级。 */
+export interface TuiInputDerivedState {
+    slashCommandSuggestions: CliSlashCommand[];
+    fileMentionSuggestions: string[];
+    handleTuiViewportKey: (key: Key) => boolean;
+}
+/** React ref 形状；输入子树与父级共享同一份派生值容器。 */
+export type TuiInputDerivedRef = {
+    current: TuiInputDerivedState;
+};
+/** 输入区布局高度；只有跨视觉行或 picker 状态变化时才需要通知父级。 */
+export interface TuiInputLayout {
+    promptHeight: number;
+    pickerHeight: number;
+}
+type TuiDispatchAction = (action: CliAction, prompt?: string, preserveSkillPickerQuery?: boolean) => Promise<void>;
+/** 将 prompt 状态、输入分发和 picker 展示隔离到独立子树。 */
+export declare const TuiInputArea: import("react").NamedExoticComponent<{
+    store: CliTuiStore;
+    columns: number;
+    busy: {
+        current: boolean;
+    };
+    keepOpenAfterCancel: {
+        current: boolean;
+    };
+    lastSubmittedPromptRef: {
+        current: string | undefined;
+    };
+    rawInputSequenceRef: {
+        current: string;
+    };
+    dispatchAction: TuiDispatchAction;
+    onEof: () => void;
+    onRequestInterrupt: () => void;
+    onRequestCancel: () => void;
+    isRawModeSupported: boolean;
+    isInputActive: boolean;
+    showInput: boolean;
+    useColor: boolean;
+    screenReader: boolean;
+    pickers: ReturnType<typeof usePickers>;
+    derivedRef: TuiInputDerivedRef;
+    fileMentionIndex?: FileMentionIndex;
+    onLayoutChange?(layout: TuiInputLayout): void;
+}>;
+export {};

package/dist/tui/input-area.js

@@ -0,0 +1,89 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/** TUI 输入子树：隔离 prompt、光标与 picker 状态，避免普通按键重建完整时间线。 */
+import { memo, useEffect, useLayoutEffect } from "react";
+import { useInput } from "ink";
+import { getSlashCommandSuggestions } from "../parser.js";
+import { usePromptInput } from "./hooks/use-prompt-input.js";
+import { extractFileMentionToken, filterFileMentionCandidates } from "./input/file-mention.js";
+import { createTuiPromptLayout } from "./input/prompt-layout.js";
+import { recordTuiPerformanceDiagnostic } from "./performance-diagnostics.js";
+import { TuiEffortPicker } from "./pickers/effort.js";
+import { TuiFileMentionMenu, TUI_FILE_MENTION_VISIBLE_ROWS } from "./pickers/file-mention.js";
+import { TuiModelPicker } from "./pickers/model.js";
+import { TuiPermissionPicker } from "./pickers/permission.js";
+import { TuiSkillPicker } from "./pickers/skill.js";
+import { TuiSlashCommandMenu } from "./pickers/slash.js";
+import { TuiPromptInput } from "./prompt-input.js";
+/** 根据当前 picker 估算固定区高度，供备用屏计算可用视口高度。 */
+function getTuiPickerHeight(input) {
+    if (input.permissions)
+        return input.permissions.length + 6;
+    if (input.models)
+        return input.models.length + 5;
+    if (input.efforts)
+        return input.efforts.length + 5;
+    if (input.skills)
+        return Math.min(8, input.skills.length) + 8;
+    if (input.slashCommands.length > 0)
+        return input.slashCommands.length + 5;
+    if (input.fileMentionCandidates.length > 0)
+        return Math.min(TUI_FILE_MENTION_VISIBLE_ROWS, input.fileMentionCandidates.length) + 5;
+    return 0;
+}
+/** 将 prompt 状态、输入分发和 picker 展示隔离到独立子树。 */
+export const TuiInputArea = memo(function TuiInputArea(props) {
+    const pickers = props.pickers;
+    const { input, cursorIndex, handleInput } = usePromptInput({
+        store: props.store,
+        columns: props.columns,
+        busy: props.busy,
+        keepOpenAfterCancel: props.keepOpenAfterCancel,
+        lastSubmittedPromptRef: props.lastSubmittedPromptRef,
+        rawInputSequenceRef: props.rawInputSequenceRef,
+        dispatchAction: props.dispatchAction,
+        onEof: props.onEof,
+        onRequestInterrupt: props.onRequestInterrupt,
+        onRequestCancel: props.onRequestCancel,
+        isPickerActive: pickers.isPickerActive,
+        dispatchPickerInput: pickers.dispatchPickerInput,
+        approvalPickerIndexRef: pickers.approvalPickerIndexRef,
+        updateApprovalPickerIndex: pickers.updateApprovalPickerIndex,
+        slashCommandIndexRef: pickers.slashCommandIndexRef,
+        updateSlashCommandIndex: pickers.updateSlashCommandIndex,
+        fileMentionIndexRef: pickers.fileMentionIndexRef,
+        updateFileMentionIndex: pickers.updateFileMentionIndex,
+        setFileMentionDismissedInput: pickers.setFileMentionDismissedInput,
+        derivedRef: props.derivedRef,
+    });
+    const slashCommandSuggestions = getSlashCommandSuggestions(input);
+    props.derivedRef.current.slashCommandSuggestions = slashCommandSuggestions;
+    // @ 菜单派生：索引就绪且未被 Esc 关闭时，按当前 token 的四档评分过滤候选池。
+    const fileMentionToken = props.fileMentionIndex?.ready ? extractFileMentionToken(input, cursorIndex) : null;
+    const fileMentionSuggestions = fileMentionToken && pickers.fileMentionDismissedInput !== input
+        ? filterFileMentionCandidates(props.fileMentionIndex?.entries ?? [], fileMentionToken.query)
+        : [];
+    props.derivedRef.current.fileMentionSuggestions = fileMentionSuggestions;
+    const promptHeight = props.showInput ? createTuiPromptLayout(input, cursorIndex, Math.max(1, props.columns - 4)).lines.length + 3 : 0;
+    const pickerHeight = props.showInput
+        ? getTuiPickerHeight({ permissions: pickers.permissionPickerOptions, models: pickers.modelPickerOptions, efforts: pickers.effortPickerOptions, skills: pickers.skillPickerSkills, slashCommands: slashCommandSuggestions, fileMentionCandidates: fileMentionSuggestions })
+        : 0;
+    useLayoutEffect(function notifyInputLayoutChange() {
+        props.onLayoutChange?.({ promptHeight, pickerHeight });
+    }, [pickerHeight, promptHeight, props.onLayoutChange]);
+    useLayoutEffect(function recordInputFrameCommit() {
+        if (props.showInput) {
+            // 诊断只记录输入帧提交时刻，不记录 prompt 正文。
+            recordTuiPerformanceDiagnostic("input_frame_committed", "prompt");
+        }
+    }, [input, cursorIndex, props.showInput]);
+    useEffect(function resetSlashCommandSelection() {
+        pickers.updateSlashCommandIndex(0);
+    }, [slashCommandSuggestions.map(function getCommandName(command) { return command.name; }).join("\u0000")]);
+    useEffect(function resetFileMentionSelection() {
+        pickers.updateFileMentionIndex(0);
+    }, [fileMentionSuggestions.join("\u0000")]);
+    useInput(handleInput, { isActive: props.isRawModeSupported && props.isInputActive });
+    if (!props.showInput)
+        return null;
+    return _jsxs(_Fragment, { children: [_jsx(TuiPromptInput, { input: input, cursorIndex: cursorIndex, columns: props.columns, useColor: props.useColor, screenReader: props.screenReader, busy: props.busy.current }), pickers.permissionPickerOptions ? (_jsx(TuiPermissionPicker, { options: pickers.permissionPickerOptions, selectedIndex: pickers.permissionPickerIndex, useColor: props.useColor, screenReader: props.screenReader })) : pickers.modelPickerOptions ? (_jsx(TuiModelPicker, { options: pickers.modelPickerOptions, selectedIndex: pickers.modelPickerIndex, useColor: props.useColor, screenReader: props.screenReader })) : pickers.effortPickerOptions ? (_jsx(TuiEffortPicker, { options: pickers.effortPickerOptions, selectedIndex: pickers.effortPickerIndex, useColor: props.useColor, screenReader: props.screenReader })) : pickers.skillPickerSkills ? (_jsx(TuiSkillPicker, { skills: pickers.skillPickerSkills, query: pickers.skillPickerQuery, selectedIndex: pickers.skillPickerIndex, useColor: props.useColor, screenReader: props.screenReader })) : slashCommandSuggestions.length > 0 ? (_jsx(TuiSlashCommandMenu, { commands: slashCommandSuggestions, selectedIndex: pickers.slashCommandIndex, useColor: props.useColor, screenReader: props.screenReader })) : fileMentionSuggestions.length > 0 ? (_jsx(TuiFileMentionMenu, { candidates: fileMentionSuggestions, selectedIndex: pickers.fileMentionIndex, useColor: props.useColor, screenReader: props.screenReader })) : null] });
+});

package/dist/tui/jobs.d.ts

@@ -0,0 +1,10 @@
+/** 当前 CLI Session 的后台任务列表、详情与有限安全日志视图。 */
+import type { ReactNode } from "react";
+import type { CliJobView } from "../types.js";
+/** 渲染当前 Job 管理视图；按键由 app.tsx 统一分发，避免创建第二套输入器。 */
+export declare function TuiJobs(props: {
+    view: CliJobView;
+    selectedIndex: number;
+    useColor: boolean;
+    screenReader: boolean;
+}): ReactNode;

package/dist/tui/jobs.js

@@ -0,0 +1,24 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR } from "../design-tokens.js";
+/** 将毫秒时间戳格式化为稳定的本地可读时间。 */
+function formatJobTime(value) {
+    return value === undefined ? "-" : new Date(value).toLocaleString();
+}
+/** 渲染单路安全日志，并明确标注缺口、重置和截断事实。 */
+function TuiJobOutput(props) {
+    const flags = [props.stream.gap ? "gap" : "", props.stream.resetRequired ? "reset" : "", props.stream.truncated ? "truncated" : ""].filter(Boolean).join(", ");
+    return _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, children: [props.label, flags ? ` (${flags})` : ""] }), _jsx(Text, { children: props.stream.text || "(empty)" })] });
+}
+/** 渲染当前 Job 管理视图；按键由 app.tsx 统一分发，避免创建第二套输入器。 */
+export function TuiJobs(props) {
+    if (props.view.mode === "list") {
+        const jobs = props.view.list.jobs;
+        return _jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, "aria-role": "list", children: [_jsx(Text, { bold: true, children: "Background jobs" }), jobs.length === 0 ? _jsx(Text, { children: "No jobs in this session." }) : jobs.map(function renderJob(job, index) {
+                    const selected = index === props.selectedIndex;
+                    return _jsxs(Text, { bold: selected, color: selected && props.useColor ? TUI_ACCENT_COLOR : undefined, children: [selected ? "› " : "  ", job.jobId, " \u00B7 ", job.status, " \u00B7 ", job.controlState, job.canStop ? " · stoppable" : ""] }, job.jobId);
+                }), _jsxs(Text, { dimColor: props.useColor, children: ["\u2191\u2193 select \u00B7 Enter details \u00B7 o output \u00B7 s stop \u00B7 r refresh \u00B7 Esc close", props.screenReader ? " · job list" : ""] })] });
+    }
+    const job = props.view.job;
+    return _jsxs(Box, { flexDirection: "column", borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, "aria-role": "list", children: [_jsx(Text, { bold: true, children: "Background job" }), _jsxs(Text, { children: ["ID: ", job.jobId] }), _jsxs(Text, { children: ["Status: ", job.status, " \u00B7 Control: ", job.controlState, " \u00B7 Stop: ", job.canStop ? "available" : "unavailable"] }), _jsxs(Text, { children: ["Started: ", formatJobTime(job.startedAt), " \u00B7 Finished: ", formatJobTime(job.finishedAt), " \u00B7 Exit: ", job.exitCode ?? "-"] }), _jsxs(Text, { children: ["Output: stdout ", job.stdoutBytes, " B \u00B7 stderr ", job.stderrBytes, " B", job.outputTruncated ? " · truncated" : ""] }), props.view.output ? _jsxs(_Fragment, { children: [_jsx(TuiJobOutput, { label: "stdout", stream: props.view.output.stdout }), _jsx(TuiJobOutput, { label: "stderr", stream: props.view.output.stderr })] }) : null, _jsxs(Text, { dimColor: props.useColor, children: ["o output \u00B7 s stop \u00B7 r refresh \u00B7 Esc back", props.screenReader ? " · job details" : ""] })] });
+}

package/dist/tui/lifecycle.d.ts

@@ -0,0 +1,23 @@
+/** TUI 终端生命周期：鼠标事件入口、Ink stdin 包装与幂等的控制序列生命周期。 */
+import { PassThrough } from "node:stream";
+import type { TuiMouseInputSink, TuiRenderMode, TuiTerminalLifecycle } from "./types.js";
+import type { TuiOutputStream } from "./types.js";
+/** 创建跨 DPI resize 时使用的 Ink 输出代理与尺寸提交函数。 */
+export declare function createTuiRenderStdout(source: TuiOutputStream, initialSize: {
+    columns: number;
+    rows: number;
+}): {
+    stdout: TuiOutputStream;
+    setSize(size: {
+        columns: number;
+        rows: number;
+    }): void;
+};
+/** 创建可在 Ink 挂载前后安全使用的鼠标事件入口。 */
+export declare function createTuiMouseInputSink(): TuiMouseInputSink;
+/** 把原始 TTY 包装为 Ink 专用输入流，并转发 raw-mode 与 ref 生命周期以保持 Ink 挂载语义。 */
+export declare function createRoutedTuiStdin(input: NodeJS.ReadStream): PassThrough;
+/** 创建幂等的终端控制序列生命周期，保证所有退出路径只恢复一次。 */
+export declare function createTuiTerminalLifecycle(stdout: {
+    write(chunk: string): void;
+}, mode: TuiRenderMode): TuiTerminalLifecycle;

package/dist/tui/lifecycle.js

@@ -0,0 +1,114 @@
+/** TUI 终端生命周期：鼠标事件入口、Ink stdin 包装与幂等的控制序列生命周期。 */
+import { PassThrough } from "node:stream";
+import { TUI_ALTERNATE_SCREEN_DISABLE, TUI_ALTERNATE_SCREEN_ENABLE, TUI_BRACKETED_PASTE_DISABLE, TUI_BRACKETED_PASTE_ENABLE, TUI_INLINE_RESIZE_CLEAR, TUI_MOUSE_TRACKING_DISABLE, TUI_MOUSE_TRACKING_ENABLE, TUI_TERMINAL_FOCUS_DISABLE, TUI_TERMINAL_FOCUS_ENABLE, } from "./constants.js";
+/** Ink 使用的稳定尺寸输出代理；它转发写入并在新布局提交后通知 resize。 */
+class StableTuiOutputStream {
+    source;
+    size;
+    resizeListeners = new Set();
+    constructor(source, initialSize) {
+        this.source = source;
+        this.size = initialSize;
+    }
+    get columns() { return this.size.columns; }
+    get rows() { return this.size.rows; }
+    get isTTY() { return this.source.isTTY; }
+    /** 将 Ink 的所有输出原样写入真实终端。 */
+    write(chunk, ...args) {
+        const write = this.source.write;
+        const result = write.call(this.source, chunk, ...args);
+        return result !== false;
+    }
+    /** 保存 Ink 的 resize 监听，等待应用布局提交后再触发。 */
+    on(event, listener) {
+        if (event === "resize")
+            this.resizeListeners.add(listener);
+        return this;
+    }
+    /** 移除 Ink 的 resize 监听，满足 Ink 卸载时的监听清理。 */
+    off(event, listener) {
+        if (event === "resize")
+            this.resizeListeners.delete(listener);
+        return this;
+    }
+    /** 更新 Ink 后续布局使用的稳定尺寸，并在缩窄时清空旧物理回流行及 scrollback。 */
+    setSize(size) {
+        const changed = size.columns !== this.size.columns || size.rows !== this.size.rows;
+        const widthDecreased = size.columns < this.size.columns;
+        this.size = size;
+        if (!changed)
+            return;
+        if (widthDecreased)
+            this.source.write(TUI_INLINE_RESIZE_CLEAR);
+        for (const listener of this.resizeListeners)
+            listener();
+    }
+}
+/** 创建跨 DPI resize 时使用的 Ink 输出代理与尺寸提交函数。 */
+export function createTuiRenderStdout(source, initialSize) {
+    const stable = new StableTuiOutputStream(source, initialSize);
+    return {
+        stdout: stable,
+        setSize(size) { stable.setSize(size); },
+    };
+}
+/** 创建可在 Ink 挂载前后安全使用的鼠标事件入口。 */
+export function createTuiMouseInputSink() {
+    let handler;
+    return {
+        setHandler(nextHandler) {
+            handler = nextHandler;
+        },
+        dispatch(event, wheelNotches = 1) {
+            handler?.(event, wheelNotches);
+        },
+    };
+}
+/** 把原始 TTY 包装为 Ink 专用输入流，并转发 raw-mode 与 ref 生命周期以保持 Ink 挂载语义。 */
+export function createRoutedTuiStdin(input) {
+    const routed = new PassThrough();
+    const lifecycleInput = input;
+    Object.defineProperty(routed, "isTTY", { value: input.isTTY === true });
+    if (typeof input.setRawMode === "function") {
+        Object.defineProperty(routed, "setRawMode", { value: input.setRawMode.bind(input) });
+    }
+    if (typeof lifecycleInput.ref === "function") {
+        Object.defineProperty(routed, "ref", { value: lifecycleInput.ref.bind(input) });
+    }
+    if (typeof lifecycleInput.unref === "function") {
+        Object.defineProperty(routed, "unref", { value: lifecycleInput.unref.bind(input) });
+    }
+    return routed;
+}
+/** 创建幂等的终端控制序列生命周期，保证所有退出路径只恢复一次。 */
+export function createTuiTerminalLifecycle(stdout, mode) {
+    let entered = false;
+    let restored = false;
+    /** 按渲染模式进入终端能力；内联路径保留既有 paste/focus 输入语义。 */
+    function enter() {
+        if (entered)
+            return;
+        entered = true;
+        if (mode === "alternate-screen")
+            stdout.write(TUI_ALTERNATE_SCREEN_ENABLE + TUI_MOUSE_TRACKING_ENABLE + TUI_BRACKETED_PASTE_ENABLE + TUI_TERMINAL_FOCUS_ENABLE);
+        else
+            stdout.write(TUI_BRACKETED_PASTE_ENABLE + TUI_TERMINAL_FOCUS_ENABLE);
+    }
+    /** 在 Ink 完成输入初始化或终端重新聚焦后幂等重申鼠标模式，避免初始化顺序清掉备用屏捕获。 */
+    function reassert() {
+        if (!entered || restored || mode !== "alternate-screen")
+            return;
+        stdout.write(TUI_MOUSE_TRACKING_ENABLE);
+    }
+    /** 逆序恢复终端能力；备用屏路径同步关闭鼠标并返回主屏。 */
+    function restore() {
+        if (restored)
+            return;
+        restored = true;
+        if (mode === "alternate-screen")
+            stdout.write(TUI_MOUSE_TRACKING_DISABLE + TUI_BRACKETED_PASTE_DISABLE + TUI_TERMINAL_FOCUS_DISABLE + TUI_ALTERNATE_SCREEN_DISABLE);
+        else
+            stdout.write(TUI_BRACKETED_PASTE_DISABLE + TUI_TERMINAL_FOCUS_DISABLE);
+    }
+    return { enter, reassert, restore };
+}

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

@@ -0,0 +1,8 @@
+/** unified diff 的逐行着色渲染；保持与 Web 的 edit_file 展示语义一致。 */
+import { type ReactNode } from "react";
+/** 将 Core 提供的最终 unified diff 逐行着色，保持与 Web 的 edit_file 展示语义一致。 */
+export declare function TuiDiffBlock(props: {
+    diff: string;
+    keyPrefix: string;
+    useColor: boolean;
+}): ReactNode;

package/dist/tui/markdown/diff.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR, TUI_DIFF_ADDED_COLOR, TUI_DIFF_REMOVED_COLOR } from "../../design-tokens.js";
+/** 将 Core 提供的最终 unified diff 逐行着色，保持与 Web 的 edit_file 展示语义一致。 */
+export function TuiDiffBlock(props) {
+    return (_jsxs(Box, { marginLeft: 2, marginTop: 1, flexDirection: "column", borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, children: [_jsx(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "diff" }), props.diff.split("\n").map(function renderDiffLine(line, index) {
+                const isAdded = line.startsWith("+") && !line.startsWith("+++");
+                const isRemoved = line.startsWith("-") && !line.startsWith("---");
+                const isMeta = line.startsWith("+++") || line.startsWith("---") || line.startsWith("@@");
+                const color = isAdded
+                    ? TUI_DIFF_ADDED_COLOR
+                    : isRemoved
+                        ? TUI_DIFF_REMOVED_COLOR
+                        : isMeta
+                            ? TUI_ACCENT_COLOR
+                            : undefined;
+                return _jsx(Text, { color: props.useColor ? color : undefined, dimColor: props.useColor && isMeta, children: line || " " }, props.keyPrefix + ":line:" + String(index));
+            })] }));
+}

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

@@ -0,0 +1,4 @@
+/** 行内 Markdown 到 Ink Text 节点的纯函数渲染；不支持的语法保留原文。 */
+import { type ReactNode } from "react";
+/** 将常用行内 Markdown 转为 Ink Text 节点；不支持的语法保留原文，确保流式半截内容不丢失。 */
+export declare function renderMarkdownInline(content: string, keyPrefix: string, useColor: boolean): ReactNode[];

package/dist/tui/markdown/inline.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Text } from "ink";
+import { TUI_ACCENT_COLOR } from "../../design-tokens.js";
+/** 将常用行内 Markdown 转为 Ink Text 节点；不支持的语法保留原文，确保流式半截内容不丢失。 */
+export function renderMarkdownInline(content, keyPrefix, useColor) {
+    const nodes = [];
+    const tokenPattern = /(`[^`\n]*`)|(\[([^\]\n]+)\]\(([^)\s]+)(?:\s+"[^"]*")?\))|(\*\*[^*\n]+\*\*|__[^_\n]+__)|(\*[^*\n]+\*|_[^_\n]+_)/g;
+    let offset = 0;
+    let tokenIndex = 0;
+    for (const match of content.matchAll(tokenPattern)) {
+        const index = match.index ?? 0;
+        if (index > offset)
+            nodes.push(content.slice(offset, index));
+        const key = keyPrefix + ":inline:" + String(tokenIndex++);
+        if (match[1]) {
+            nodes.push(_jsx(Text, { bold: true, color: useColor ? TUI_ACCENT_COLOR : undefined, children: match[1].slice(1, -1) }, key));
+        }
+        else if (match[2]) {
+            nodes.push(_jsxs(Text, { underline: true, color: useColor ? TUI_ACCENT_COLOR : undefined, children: [match[3], " (", match[4], ")"] }, key));
+        }
+        else if (match[5]) {
+            nodes.push(_jsx(Text, { bold: true, children: match[5].slice(2, -2) }, key));
+        }
+        else if (match[6]) {
+            nodes.push(_jsx(Text, { italic: true, children: match[6].slice(1, -1) }, key));
+        }
+        offset = index + match[0].length;
+    }
+    if (offset < content.length)
+        nodes.push(content.slice(offset));
+    return nodes;
+}

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

@@ -0,0 +1,17 @@
+/** CLI 所需的安全 Markdown 子集渲染：段落、标题、代码块、引用、列表与对齐表格。 */
+import { type ReactNode } from "react";
+/** 渲染已经按当前终端宽度适配列宽的对齐 Markdown 表格。 */
+export declare function TuiMarkdownAlignedTable(props: {
+    header: string[];
+    rows: string[][];
+    keyPrefix: string;
+    useColor: boolean;
+    maximumWidth: number;
+}): ReactNode;
+/** 渲染 CLI 所需的安全 Markdown 子集，不解析或执行 HTML。 */
+export declare function TuiMarkdown(props: {
+    content: string;
+    keyPrefix: string;
+    useColor: boolean;
+    maximumWidth: number;
+}): ReactNode;