@autopilot-agent/cli 0.0.0-stage → 0.2.0

package/dist/tui/viewport/viewport.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** 备用屏视口：按应用层视口裁剪时间线并渲染自绘滚动条。 */
+import { memo } from "react";
+import { Box, Text } from "ink";
+import { CLI_TUI_COLORS, TUI_ACCENT_BG_COLOR, TUI_ACCENT_COLOR, TUI_CHIP_TEXT_COLOR, TUI_DIFF_ADDED_COLOR, TUI_DIFF_REMOVED_COLOR, TUI_TOOL_ERROR_BG_COLOR, TUI_TOOL_ERROR_COLOR, TUI_TOOL_ERROR_TEXT_COLOR } from "../../design-tokens.js";
+import { getTuiVisualLineSelectionRange } from "./selection.js";
+/** 将备用屏时间线的品牌样式映射回 Design.md 规定的 ANSI token。 */
+function getTuiViewportSpanColor(style, useColor) {
+    if (!useColor)
+        return undefined;
+    if (style === "accent")
+        return CLI_TUI_COLORS.accent;
+    if (style === "brand-blue")
+        return CLI_TUI_COLORS.copilotBlue;
+    if (style === "brand-ink")
+        return CLI_TUI_COLORS.copilotInk;
+    if (style === "brand-muted")
+        return CLI_TUI_COLORS.copilotMuted;
+    if (style === "muted")
+        return CLI_TUI_COLORS.copilotMuted;
+    if (style === "diff-border" || style === "diff-meta")
+        return TUI_ACCENT_COLOR;
+    if (style === "diff-added")
+        return TUI_DIFF_ADDED_COLOR;
+    if (style === "diff-removed")
+        return TUI_DIFF_REMOVED_COLOR;
+    if (style === "error")
+        return TUI_TOOL_ERROR_COLOR;
+    if (style === "chip-active")
+        return TUI_CHIP_TEXT_COLOR;
+    if (style === "chip-error")
+        return TUI_TOOL_ERROR_TEXT_COLOR;
+    return undefined;
+}
+/** 取得备用屏 span 的背景与粗体强调；活动工具徽标 chip 使用强调背景 + 深色粗体文字。 */
+function getTuiViewportSpanEmphasis(style, useColor) {
+    if (!useColor)
+        return {};
+    if (style === "chip-active")
+        return { backgroundColor: TUI_ACCENT_BG_COLOR, bold: true };
+    if (style === "chip-error")
+        return { backgroundColor: TUI_TOOL_ERROR_BG_COLOR, bold: true };
+    return {};
+}
+/** 在视口的已换行文本中保留来源样式，并与鼠标划选反显组合。 */
+function renderTuiViewportLine(line, selection, useColor) {
+    if (line.text.length === 0)
+        return _jsx(Text, { children: " " });
+    const boundaries = new Set([0, line.text.length]);
+    if (selection) {
+        boundaries.add(selection.start);
+        boundaries.add(selection.end);
+    }
+    for (const span of line.spans) {
+        boundaries.add(span.start);
+        boundaries.add(span.end);
+    }
+    const offsets = [...boundaries].filter(function keepOffset(offset) { return offset >= 0 && offset <= line.text.length; }).sort(function sortOffset(left, right) { return left - right; });
+    return offsets.slice(0, -1).map(function renderSegment(start, index) {
+        const end = offsets[index + 1] ?? start;
+        const style = line.spans.find(function findStyle(span) { return span.start <= start && span.end >= end; })?.style;
+        const selected = selection !== undefined && start >= selection.start && end <= selection.end;
+        const emphasis = getTuiViewportSpanEmphasis(style, useColor);
+        return _jsx(Text, { color: getTuiViewportSpanColor(style, useColor), backgroundColor: emphasis.backgroundColor, bold: emphasis.bold, inverse: selected && useColor, children: line.text.slice(start, end) || " " }, `${start}:${end}`);
+    });
+}
+/** 根据当前窗口比例生成一列纯文本滚动条，拇指至少占一行。 */
+function createTuiScrollbar(lines, state) {
+    if (lines <= 0)
+        return [];
+    if (state.totalHeight <= state.viewportHeight || state.viewportHeight <= 0)
+        return Array.from({ length: lines }, function emptyScrollbar() { return " "; });
+    const thumbLength = Math.max(1, Math.min(lines, Math.round(lines * state.viewportHeight / state.totalHeight)));
+    const maximumStart = Math.max(0, lines - thumbLength);
+    const maximumTop = Math.max(1, state.totalHeight - state.viewportHeight);
+    const thumbStart = Math.min(maximumStart, Math.round(maximumStart * state.scrollTop / maximumTop));
+    return Array.from({ length: lines }, function renderScrollbar(_value, index) {
+        return index >= thumbStart && index < thumbStart + thumbLength ? "█" : "░";
+    });
+}
+/** 在备用屏中按应用层视口裁剪时间线，并把最右一列留给自绘滚动条。 */
+export const TuiViewportTimeline = memo(function TuiViewportTimeline(props) {
+    const visibleLines = props.lines.slice(props.state.scrollTop, props.state.scrollTop + props.state.viewportHeight);
+    const scrollbar = createTuiScrollbar(props.state.viewportHeight, props.state);
+    return (_jsxs(Box, { height: props.state.viewportHeight, width: props.columns, flexDirection: "row", overflow: "hidden", "aria-role": "list", children: [_jsx(Box, { width: Math.max(1, props.columns - 1), flexDirection: "column", overflow: "hidden", children: visibleLines.map(function renderViewportLine(line, index) {
+                    const range = getTuiVisualLineSelectionRange(props.lines, props.selection, props.state.scrollTop + index);
+                    return _jsx(Box, { width: Math.max(1, props.columns - 1), flexDirection: "row", overflow: "hidden", children: renderTuiViewportLine(line, range, props.useColor) }, `${line.itemId}:${line.sourceStart}:${index}`);
+                }) }), _jsx(Box, { width: 1, flexDirection: "column", overflow: "hidden", children: scrollbar.map(function renderScrollbarCell(cell, index) {
+                    return _jsx(Text, { color: props.useColor ? CLI_TUI_COLORS.copilotMuted : undefined, children: cell }, index);
+                }) })] }));
+});

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

@@ -0,0 +1,23 @@
+/** TUI 会话内输入历史状态；纯函数维护草稿、FIFO 队列和上下边界召回语义。 */
+/** 会话内输入历史的最小状态。 */
+export interface TuiInputHistoryState {
+    entries: string[];
+    index?: number;
+    draft: string;
+}
+/** 历史导航动作的稳定结果。 */
+export interface TuiInputHistoryNavigation {
+    state: TuiInputHistoryState;
+    input: string;
+    changed: boolean;
+}
+/** 创建空的会话内输入历史。 */
+export declare function createTuiInputHistoryState(): TuiInputHistoryState;
+/** 成功提交输入后写入 FIFO，并退出历史浏览。 */
+export declare function recordTuiInputHistory(state: TuiInputHistoryState, input: string, maximumEntries?: number): TuiInputHistoryState;
+/** 判断上下箭头是否位于允许切换历史的视觉行边界。 */
+export declare function canNavigateTuiInputHistory(direction: "up" | "down", cursorLine: number, lineCount: number, browsingHistory: boolean, pickerActive: boolean): boolean;
+/** 在输入历史中向上或向下移动，并在首次进入时保存草稿。 */
+export declare function navigateTuiInputHistory(state: TuiInputHistoryState, direction: "up" | "down", currentInput: string, enabled?: boolean): TuiInputHistoryNavigation;
+/** 普通编辑立即退出历史浏览，并把编辑后的内容作为新的草稿。 */
+export declare function updateTuiInputHistoryDraft(state: TuiInputHistoryState, input: string): TuiInputHistoryState;

package/dist/tui-input-history.js

@@ -0,0 +1,42 @@
+/** TUI 会话内输入历史状态；纯函数维护草稿、FIFO 队列和上下边界召回语义。 */
+/** 创建空的会话内输入历史。 */
+export function createTuiInputHistoryState() {
+    return { entries: [], draft: "" };
+}
+/** 成功提交输入后写入 FIFO，并退出历史浏览。 */
+export function recordTuiInputHistory(state, input, maximumEntries = 100) {
+    const limit = Math.max(1, maximumEntries);
+    const entries = [...state.entries, input].slice(-limit);
+    return { entries, draft: "", index: undefined };
+}
+/** 判断上下箭头是否位于允许切换历史的视觉行边界。 */
+export function canNavigateTuiInputHistory(direction, cursorLine, lineCount, browsingHistory, pickerActive) {
+    if (pickerActive)
+        return false;
+    if (direction === "up")
+        return cursorLine <= 0;
+    return browsingHistory && cursorLine >= Math.max(0, lineCount - 1);
+}
+/** 在输入历史中向上或向下移动，并在首次进入时保存草稿。 */
+export function navigateTuiInputHistory(state, direction, currentInput, enabled = true) {
+    if (!enabled || state.entries.length === 0)
+        return { state, input: currentInput, changed: false };
+    if (direction === "up") {
+        const index = state.index === undefined ? state.entries.length - 1 : Math.max(0, state.index - 1);
+        const nextState = { ...state, index, draft: state.index === undefined ? currentInput : state.draft };
+        return { state: nextState, input: nextState.entries[index], changed: nextState.entries[index] !== currentInput };
+    }
+    if (state.index === undefined)
+        return { state, input: currentInput, changed: false };
+    if (state.index < state.entries.length - 1) {
+        const index = state.index + 1;
+        const nextState = { ...state, index };
+        return { state: nextState, input: nextState.entries[index], changed: nextState.entries[index] !== currentInput };
+    }
+    const nextState = { ...state, index: undefined };
+    return { state: nextState, input: nextState.draft, changed: nextState.draft !== currentInput };
+}
+/** 普通编辑立即退出历史浏览，并把编辑后的内容作为新的草稿。 */
+export function updateTuiInputHistoryDraft(state, input) {
+    return { ...state, draft: input, index: undefined };
+}

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

@@ -0,0 +1,24 @@
+/** TUI 原始输入分流器；仅解析 SGR 鼠标报文，并完整保留普通键盘字节顺序。 */
+/** 已归一化的 SGR 鼠标报文。 */
+export interface TuiSgrMouseEvent {
+    code: number;
+    column: number;
+    row: number;
+    released: boolean;
+    kind: "wheel_up" | "wheel_down" | "button" | "drag" | "move";
+}
+/** 一次输入分流的无副作用结果。 */
+export interface TuiInputRouterResult {
+    passthrough: string;
+    mouseEvents: TuiSgrMouseEvent[];
+    diagnostics: Array<"invalid_sgr_mouse" | "sgr_mouse_overflow">;
+}
+/** 提供跨 chunk 缓冲的原始输入分流器。 */
+export interface TuiInputRouter {
+    push(chunk: string): TuiInputRouterResult;
+    finish(): TuiInputRouterResult;
+}
+/** 根据 SGR 按钮编码归类鼠标行为，供上层状态机消费。 */
+export declare function classifyTuiSgrMouseEvent(code: number): TuiSgrMouseEvent["kind"];
+/** 创建有界的输入分流器，避免残缺鼠标控制序列无限累积。 */
+export declare function createTuiInputRouter(bufferLimit?: number): TuiInputRouter;

package/dist/tui-input-router.js

@@ -0,0 +1,115 @@
+/** TUI 原始输入分流器；仅解析 SGR 鼠标报文，并完整保留普通键盘字节顺序。 */
+const SGR_MOUSE_PREFIX = "\u001b[<";
+const X10_MOUSE_PREFIX = "\u001b[M";
+const DEFAULT_SGR_BUFFER_LIMIT = 256;
+/** 根据 SGR 按钮编码归类鼠标行为，供上层状态机消费。 */
+export function classifyTuiSgrMouseEvent(code) {
+    // SGR 会把 Shift/Alt/Ctrl 叠加到按钮编码；滚轮方向仍由最低位决定。
+    // 不能只识别 64/65，否则按住修饰键或部分 Windows Terminal 报文会被误作普通点击。
+    if ((code & 64) === 64)
+        return (code & 1) === 0 ? "wheel_up" : "wheel_down";
+    if ((code & 32) === 32)
+        return (code & 3) === 3 ? "move" : "drag";
+    return "button";
+}
+/** 创建有界的输入分流器，避免残缺鼠标控制序列无限累积。 */
+export function createTuiInputRouter(bufferLimit = DEFAULT_SGR_BUFFER_LIMIT) {
+    const limit = Math.max(1, bufferLimit);
+    let bufferedMousePrefix = "";
+    /** 构造统一的结果对象，避免调用方猜测未解析数据。 */
+    function createResult(passthrough = "", mouseEvents = [], diagnostics = []) {
+        return { passthrough, mouseEvents, diagnostics };
+    }
+    /** 解析一个完整 SGR 鼠标报文；格式不合法时返回 undefined。 */
+    function parseMouseSequence(sequence) {
+        const match = /^\u001b\[<(\d+);(\d+);(\d+)([Mm])$/u.exec(sequence);
+        if (!match)
+            return undefined;
+        const code = Number(match[1]);
+        return {
+            code,
+            column: Number(match[2]),
+            row: Number(match[3]),
+            released: match[4] === "m",
+            kind: classifyTuiSgrMouseEvent(code),
+        };
+    }
+    /** 解析 X10 三字节鼠标报文；部分终端忽略 1006 时仍会以该格式回传滚轮和拖拽。 */
+    function parseX10MouseSequence(sequence) {
+        if (sequence.length !== 6 || !sequence.startsWith(X10_MOUSE_PREFIX))
+            return undefined;
+        const code = sequence.charCodeAt(3) - 32;
+        const column = sequence.charCodeAt(4) - 32;
+        const row = sequence.charCodeAt(5) - 32;
+        if (code < 0 || column < 1 || row < 1)
+            return undefined;
+        return {
+            code,
+            column,
+            row,
+            released: code === 3,
+            kind: classifyTuiSgrMouseEvent(code),
+        };
+    }
+    /** 处理一个输入 chunk，同时只缓存确认属于 SGR 鼠标前缀的残缺序列。 */
+    function push(chunk) {
+        let source = bufferedMousePrefix + chunk;
+        bufferedMousePrefix = "";
+        let passthrough = "";
+        const mouseEvents = [];
+        const diagnostics = [];
+        while (source.length > 0) {
+            const sgrPrefixIndex = source.indexOf(SGR_MOUSE_PREFIX);
+            const x10PrefixIndex = source.indexOf(X10_MOUSE_PREFIX);
+            const prefixIndex = sgrPrefixIndex < 0
+                ? x10PrefixIndex
+                : x10PrefixIndex < 0
+                    ? sgrPrefixIndex
+                    : Math.min(sgrPrefixIndex, x10PrefixIndex);
+            if (prefixIndex < 0) {
+                passthrough += source;
+                break;
+            }
+            passthrough += source.slice(0, prefixIndex);
+            source = source.slice(prefixIndex);
+            if (source.startsWith(X10_MOUSE_PREFIX)) {
+                if (source.length < 6) {
+                    bufferedMousePrefix = source;
+                    break;
+                }
+                const sequence = source.slice(0, 6);
+                source = source.slice(6);
+                const mouseEvent = parseX10MouseSequence(sequence);
+                if (mouseEvent)
+                    mouseEvents.push(mouseEvent);
+                else
+                    diagnostics.push("invalid_sgr_mouse");
+                continue;
+            }
+            const terminatorIndex = source.search(/[Mm]/u);
+            if (terminatorIndex < 0) {
+                if (source.length > limit)
+                    diagnostics.push("sgr_mouse_overflow");
+                else
+                    bufferedMousePrefix = source;
+                break;
+            }
+            const sequence = source.slice(0, terminatorIndex + 1);
+            source = source.slice(terminatorIndex + 1);
+            const mouseEvent = parseMouseSequence(sequence);
+            if (mouseEvent)
+                mouseEvents.push(mouseEvent);
+            else
+                diagnostics.push("invalid_sgr_mouse");
+        }
+        return createResult(passthrough, mouseEvents, diagnostics);
+    }
+    /** 在输入结束时丢弃残缺鼠标前缀，绝不把其泄漏给文本输入。 */
+    function finish() {
+        if (!bufferedMousePrefix)
+            return createResult();
+        bufferedMousePrefix = "";
+        return createResult("", [], ["invalid_sgr_mouse"]);
+    }
+    return { push, finish };
+}

package/dist/tui.d.ts

@@ -0,0 +1,15 @@
+/**
+ * CLI Ink TUI 公开出口（barrel）。
+ * 实现已按领域拆分到 tui/ 目录；这里只 re-export 对外契约符号，
+ * 保证 index.ts、main.ts 与既有测试的 import 零改动。
+ */
+export type { CliTuiActivePrompt, CliTuiInitialOperation, CliTuiPendingInput, CliTuiRecap, CliTuiSnapshot, CliTuiStore, CliTuiTimelineEvent, CliTuiTranscriptItem, CliTuiTurnMetrics, RunCliTuiOptions, RunCliTuiResult, TuiMouseInputSink, TuiOutputStream, TuiRenderMode, TuiTerminalSizeSource, TuiTerminalLifecycle, } from "./tui/types.js";
+export { createCliTuiStore } from "./tui/store.js";
+export { formatCliTuiRecap, runCliTui } from "./tui/run.js";
+export { createRoutedTuiStdin, createTuiMouseInputSink, createTuiRenderStdout, createTuiTerminalLifecycle } from "./tui/lifecycle.js";
+export { createTuiViewportDiffSource, formatTuiViewportMarkdown } from "./tui/viewport/sources.js";
+export { getTuiRenderModeFallbackNotice, resolveTuiRenderMode, resolveTuiRenderModePolicy } from "./tui/render-mode.js";
+export { parseTuiControlAction, resolveTuiDeleteDirection } from "./tui/input/keys.js";
+export { CliTuiApp } from "./tui/app.js";
+export { resolveTrustDialogNavigation, runCliTrustDialog, TuiTrustDialog, TRUST_DIALOG_OPTIONS } from "./tui/trust-dialog.js";
+export type { CliTrustDecision, CliTrustDialogOptions, CliTrustDialogSignalSource } from "./tui/trust-dialog.js";

package/dist/tui.js

@@ -0,0 +1,13 @@
+/**
+ * CLI Ink TUI 公开出口（barrel）。
+ * 实现已按领域拆分到 tui/ 目录；这里只 re-export 对外契约符号，
+ * 保证 index.ts、main.ts 与既有测试的 import 零改动。
+ */
+export { createCliTuiStore } from "./tui/store.js";
+export { formatCliTuiRecap, runCliTui } from "./tui/run.js";
+export { createRoutedTuiStdin, createTuiMouseInputSink, createTuiRenderStdout, createTuiTerminalLifecycle } from "./tui/lifecycle.js";
+export { createTuiViewportDiffSource, formatTuiViewportMarkdown } from "./tui/viewport/sources.js";
+export { getTuiRenderModeFallbackNotice, resolveTuiRenderMode, resolveTuiRenderModePolicy } from "./tui/render-mode.js";
+export { parseTuiControlAction, resolveTuiDeleteDirection } from "./tui/input/keys.js";
+export { CliTuiApp } from "./tui/app.js";
+export { resolveTrustDialogNavigation, runCliTrustDialog, TuiTrustDialog, TRUST_DIALOG_OPTIONS } from "./tui/trust-dialog.js";