@autopilot-agent/cli 0.0.0-stage → 0.2.0

package/dist/timeline-lines.js

@@ -0,0 +1,104 @@
+/** TUI 时间线视觉行模型；统一文字换行、样式片段与源文本坐标，暂不接入渲染。 */
+import stringWidth from "string-width";
+import wrapAnsi from "wrap-ansi";
+/** 将一个样式范围裁剪到当前视觉行，保留行内坐标。 */
+function clipTimelineSpans(spans, sourceStart, sourceEnd) {
+    return spans.flatMap(function clipSpan(span) {
+        const start = Math.max(span.start, sourceStart);
+        const end = Math.min(span.end, sourceEnd);
+        return start < end ? [{ ...span, start: start - sourceStart, end: end - sourceStart }] : [];
+    });
+}
+/** 找到包含给定偏移的完整 Unicode grapheme，避免换行截断组合 emoji。 */
+function getTimelineGraphemeEnd(source, offset) {
+    const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+    for (const segment of segmenter.segment(source)) {
+        const end = segment.index + segment.segment.length;
+        if (segment.index < offset && offset < end)
+            return end;
+    }
+    return offset;
+}
+/** 复用现有 wrap-ansi 规则生成视觉行，同时把被截断的 grapheme 收拢到同一行。 */
+function wrapTimelineSource(source, columns) {
+    const lines = [];
+    let offset = 0;
+    while (offset < source.length) {
+        const newline = source.indexOf("\n", offset);
+        const sourceEnd = newline < 0 ? source.length : newline;
+        const remaining = source.slice(offset, sourceEnd);
+        if (remaining.length === 0) {
+            lines.push({ text: "", sourceStart: offset, sourceEnd: offset });
+            offset = newline < 0 ? source.length : newline + 1;
+            continue;
+        }
+        const candidate = wrapAnsi(remaining, columns, { hard: true, trim: false, wordWrap: true }).split("\n")[0] ?? remaining;
+        const candidateEnd = getTimelineGraphemeEnd(source, offset + candidate.length);
+        const visualEnd = Math.min(sourceEnd, Math.max(offset + 1, candidateEnd));
+        lines.push({ text: source.slice(offset, visualEnd), sourceStart: offset, sourceEnd: visualEnd });
+        offset = visualEnd;
+        if (offset === sourceEnd && newline >= 0)
+            offset += 1;
+    }
+    if (source.endsWith("\n"))
+        lines.push({ text: "", sourceStart: source.length, sourceEnd: source.length });
+    return lines;
+}
+/** 将安全时间线文本按当前终端列宽转换为统一的视觉行。 */
+export function createTimelineVisualLines(items, columns) {
+    const width = Math.max(1, columns);
+    return items.flatMap(function createItemLines(item) { return createTimelineVisualLinesForItem(item, width); });
+}
+/** 为单个 source 生成视觉行；缓存与全量实现共用完全相同的换行规则。 */
+function createTimelineVisualLinesForItem(item, width) {
+    const spans = item.spans ?? [];
+    return wrapTimelineSource(item.text, width).map(function createVisualLine(line) {
+        return {
+            itemId: item.itemId,
+            text: line.text,
+            displayWidth: stringWidth(line.text),
+            sourceStart: line.sourceStart,
+            sourceEnd: line.sourceEnd,
+            spans: clipTimelineSpans(spans, line.sourceStart, line.sourceEnd),
+        };
+    });
+}
+/** 将 source 的样式范围压成轻量指纹，避免同一文本因新对象重复换行。 */
+function getTimelineSpanFingerprint(spans) {
+    return (spans ?? []).map(function fingerprintSpan(span) { return `${span.start}:${span.end}:${span.style}`; }).join("|");
+}
+/** 创建按 itemId、文本、spans 与终端宽度复用的视觉行缓存。 */
+export function createTimelineVisualLineCache() {
+    const entries = new Map();
+    const stats = { builds: 0, hits: 0, widthInvalidations: 0 };
+    /** 按当前 source 顺序拼出视觉行，同时只重算发生变化的 item。 */
+    function getLines(items, columns) {
+        const width = Math.max(1, columns);
+        return items.flatMap(function getCachedItemLines(item) {
+            const spans = getTimelineSpanFingerprint(item.spans);
+            const previous = entries.get(item.itemId);
+            if (previous && previous.text === item.text && previous.spans === spans && previous.width === width) {
+                stats.hits += 1;
+                return previous.lines;
+            }
+            if (previous && previous.width !== width)
+                stats.widthInvalidations += 1;
+            const lines = createTimelineVisualLinesForItem(item, width);
+            entries.set(item.itemId, { text: item.text, spans, width, lines });
+            stats.builds += 1;
+            return lines;
+        });
+    }
+    /** 返回当前缓存计数快照，调用方不得修改内部状态。 */
+    function getStats() {
+        return { ...stats };
+    }
+    /** 清空视觉行缓存并重置计数，供终端生命周期切换或测试隔离使用。 */
+    function clear() {
+        entries.clear();
+        stats.builds = 0;
+        stats.hits = 0;
+        stats.widthInvalidations = 0;
+    }
+    return { getLines, getStats, clear };
+}

package/dist/tui/app.d.ts

@@ -0,0 +1,30 @@
+/** 瘦身后的 Ink 应用组件：编排 store 订阅、dispatchAction、动画时钟与渲染。 */
+import { type ReactNode } from "react";
+import type { CliController, CliControllerResult } from "../controller.js";
+import type { CliExitCode } from "../types.js";
+import type { CliTuiInitialOperation, CliTuiStore, TuiTerminalSizeSource, TuiMouseInputSink, TuiRenderMode } from "./types.js";
+/** Ink 应用组件；useInput 只把用户动作交给 Controller Action。 */
+export declare function CliTuiApp(props: {
+    store: CliTuiStore;
+    controller: CliController;
+    initial?: CliTuiInitialOperation;
+    closeWhenIdle: boolean;
+    /** canonical 工作区根；缺省时 @ 文件候选菜单不激活。 */
+    workspaceRoot?: string;
+    useColor: boolean;
+    screenReader: boolean;
+    renderMode?: TuiRenderMode;
+    reducedMotion?: boolean;
+    mouseInput?: TuiMouseInputSink;
+    onCopyText?(text: string): void;
+    onResult(result: CliControllerResult): void;
+    onRequestInterrupt(): void;
+    onRequestCancel(): void;
+    onEof(): void;
+    onAppExit(code: CliExitCode): void;
+    terminalSizeSource?: TuiTerminalSizeSource;
+    onTerminalSizeChange?(size: {
+        columns: number;
+        rows: number;
+    }): void;
+}): ReactNode;

package/dist/tui/app.js

@@ -0,0 +1,413 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/** 瘦身后的 Ink 应用组件：编排 store 订阅、dispatchAction、动画时钟与渲染。 */
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { Box, useInput, useStdin, useStdout } from "ink";
+import { TuiActivityLine } from "../activity-animation.js";
+import { createTuiAnimationClock } from "../animation-clock.js";
+import { resolveFileMentionContext } from "../file-mention-context.js";
+import { createTimelineVisualLineCache } from "../timeline-lines.js";
+import { TuiApprovalPrompt, createTuiApprovalOptions } from "./approval.js";
+import { TuiBrandHeader, TUI_BRAND_HISTORY_ITEM } from "./brand/brand-header.js";
+import { TuiContextReport } from "./context.js";
+import { isActiveTuiStatus, isTerminalStatus, readTuiTerminalSize } from "./format.js";
+import { recordTuiRuntimeErrorDiagnostic } from "./performance-diagnostics.js";
+import { useFileMentionIndex } from "./hooks/use-file-mention-index.js";
+import { usePickers } from "./hooks/use-pickers.js";
+import { useStatusView } from "./hooks/use-status-view.js";
+import { useViewport } from "./hooks/use-viewport.js";
+import { TuiInputArea } from "./input-area.js";
+import { TuiInfoLines, TuiStatusLine } from "./status-line.js";
+import { TuiJobs } from "./jobs.js";
+import { TuiLiveTurn } from "./timeline/turn.js";
+import { getTuiTurnTodo } from "./timeline/turn-items.js";
+import { MemoizedTuiTranscriptItem, TuiPendingInputItem, TuiPromptLine } from "./transcript.js";
+import { getTuiSelectedText } from "./viewport/selection.js";
+import { createTuiViewportSourceCache } from "./viewport/sources.js";
+import { TuiViewportTimeline } from "./viewport/viewport.js";
+const EMPTY_VIEWPORT_SOURCES = [];
+const EMPTY_VIEWPORT_LINES = [];
+/** Ink 应用组件；useInput 只把用户动作交给 Controller Action。 */
+export function CliTuiApp(props) {
+    const { isRawModeSupported, stdin } = useStdin();
+    const { stdout } = useStdout();
+    const terminalSizeSource = props.terminalSizeSource ?? stdout;
+    const [snapshot, setSnapshot] = useState(props.store.getSnapshot());
+    const [terminalFocused, setTerminalFocused] = useState(true);
+    /** Claude Code 式 Ctrl+O 切换动态区 Todo 清单的紧凑/展开形态，只影响本地视图。 */
+    const [todoExpanded, setTodoExpanded] = useState(false);
+    const [jobView, setJobView] = useState(undefined);
+    const [jobListCache, setJobListCache] = useState(undefined);
+    const [jobSelectedIndex, setJobSelectedIndex] = useState(0);
+    const jobViewRef = useRef(undefined);
+    const jobRequestGeneration = useRef(0);
+    /** /context 覆盖视图；打开时取代时间线渲染，Esc 关闭后回到正常聊天。 */
+    const [contextView, setContextView] = useState(undefined);
+    const rawInputSequenceRef = useRef("");
+    const busy = useRef(false);
+    const keepOpenAfterCancel = useRef(false);
+    const lastSubmittedPromptRef = useRef(undefined);
+    const initialStarted = useRef(false);
+    const lastResult = useRef(undefined);
+    const animationClockRef = useRef(undefined);
+    if (!animationClockRef.current)
+        animationClockRef.current = createTuiAnimationClock();
+    const animationClock = animationClockRef.current;
+    /** 防抖后的终端尺寸；Ink 与应用布局共同使用同一份稳定快照。 */
+    const [terminalSize, setTerminalSize] = useState(function createTerminalSize() {
+        return readTuiTerminalSize(terminalSizeSource);
+    });
+    const isViewportMode = props.renderMode === "alternate-screen" && !props.screenReader;
+    const columns = terminalSize.columns;
+    const rows = terminalSize.rows;
+    const { statusView, refreshStatusView } = useStatusView(props.controller);
+    /** 输入子树通过 ref 读取 slash 与 @ 建议，父级只注入视口按键处理器。 */
+    const derivedRef = useRef({
+        slashCommandSuggestions: [],
+        fileMentionSuggestions: [],
+        handleTuiViewportKey: function noViewportKey() { return false; },
+    });
+    const pickers = usePickers({ dispatchAction, rawInputSequenceRef });
+    const fileMentionIndex = useFileMentionIndex(props.workspaceRoot);
+    const [inputLayout, setInputLayout] = useState({
+        promptHeight: 4,
+        pickerHeight: 0,
+    });
+    const handleInputLayoutChange = useCallback(function handleInputLayoutChange(next) {
+        setInputLayout(function updateInputLayout(previous) {
+            return previous.promptHeight === next.promptHeight && previous.pickerHeight === next.pickerHeight ? previous : next;
+        });
+    }, []);
+    const infoMessages = snapshot.transcript
+        .filter(function isNotice(item) { return item.kind === "notice"; })
+        .slice(-4)
+        .map(function getNoticeMessage(item) { return item.message; });
+    const approvalHeight = isViewportMode && snapshot.pendingApproval ? createTuiApprovalOptions(snapshot.pendingApproval).length + 6 : 0;
+    // Todo 展开态最多占 10 行；矮终端为输入框、状态栏和活动文案至少保留 6 行。
+    const todoRowLimit = Math.max(2, Math.min(10, rows - 6));
+    const activeTodoForm = getTuiTurnTodo(snapshot.liveEvents, snapshot.liveTurnId ?? "")?.todos.find(function active(todo) { return todo.status === "in_progress"; })?.activeForm;
+    const fixedHeight = inputLayout.promptHeight + inputLayout.pickerHeight + approvalHeight + infoMessages.length + 1 + (statusView ? 5 : 2);
+    const viewportHeight = Math.max(1, rows - fixedHeight);
+    const viewportSourceCacheRef = useRef(undefined);
+    if (!viewportSourceCacheRef.current)
+        viewportSourceCacheRef.current = createTuiViewportSourceCache();
+    const viewportLineCacheRef = useRef(undefined);
+    if (!viewportLineCacheRef.current)
+        viewportLineCacheRef.current = createTimelineVisualLineCache();
+    const viewportContentWidth = Math.max(1, columns - 1);
+    const viewportSources = useMemo(function getCachedViewportSources() {
+        return isViewportMode
+            ? viewportSourceCacheRef.current.getSources(snapshot, statusView, pickers.approvalPickerIndex, viewportContentWidth, todoExpanded, props.useColor, todoRowLimit)
+            : EMPTY_VIEWPORT_SOURCES;
+    }, [isViewportMode, pickers.approvalPickerIndex, snapshot, statusView, viewportContentWidth, todoExpanded, props.useColor, todoRowLimit]);
+    const viewportLines = useMemo(function getCachedViewportLines() {
+        return isViewportMode
+            ? viewportLineCacheRef.current.getLines(viewportSources, viewportContentWidth)
+            : EMPTY_VIEWPORT_LINES;
+    }, [isViewportMode, viewportContentWidth, viewportSources]);
+    const { viewportState, selection, handleTuiMouseEvent, handleTuiViewportKey } = useViewport({
+        isViewportMode,
+        columns,
+        viewportLines,
+        viewportHeight,
+        stdout,
+        onCopyText: props.onCopyText,
+    });
+    derivedRef.current.handleTuiViewportKey = handleTuiViewportKey;
+    const selectedText = isViewportMode ? getTuiSelectedText(viewportLines, selection) : "";
+    const animationActive = isRawModeSupported && stdout.isTTY !== false && terminalFocused;
+    /** 把用户动作交给 Controller；结束后刷新状态栏并按投影结果打开对应 picker。 */
+    async function dispatchAction(action, prompt, preserveSkillPickerQuery = false) {
+        const allowWhileRunning = (action.type === "submit_prompt" || action.type === "open_permissions" || action.type === "set_permission_mode" || action.type === "open_model_picker" || action.type === "set_model" || action.type === "open_effort_picker" || action.type === "set_effort" || action.type === "list_jobs" || action.type === "show_job" || action.type === "read_job_output" || action.type === "stop_job") && isActiveTuiStatus(props.store.getSnapshot().status);
+        if (busy.current && !allowWhileRunning)
+            return;
+        const isJobAction = action.type === "list_jobs" || action.type === "show_job" || action.type === "read_job_output" || action.type === "stop_job";
+        const jobGeneration = isJobAction ? ++jobRequestGeneration.current : undefined;
+        const inputPosition = prompt && allowWhileRunning ? props.store.captureInputPosition() : undefined;
+        if (prompt) {
+            lastSubmittedPromptRef.current = prompt.trim();
+            props.store.recordPrompt(prompt, !allowWhileRunning);
+        }
+        if (action.type === "approve")
+            props.store.recordApprovalSubmission(action.decision);
+        if (!allowWhileRunning)
+            busy.current = true;
+        // D2/D5：仅交互 TUI 在发送前把 @ 引用的工作区文件内容以 <system-reminder> 附加块并入 action.content；
+        // start/steer/queue/initial 四条 TUI 提交路径都经过此处，时间线与 Esc 恢复仍使用原文 prompt。
+        let dispatchedAction = action;
+        if (action.type === "submit_prompt" && prompt && props.workspaceRoot) {
+            const resolved = await resolveFileMentionContext(action.content, props.workspaceRoot);
+            for (const message of resolved.notices)
+                props.store.addNotice(message);
+            if (resolved.content !== action.content)
+                dispatchedAction = { ...action, content: resolved.content };
+        }
+        let result;
+        try {
+            result = await props.controller.dispatch(dispatchedAction);
+        }
+        catch (error) {
+            recordTuiRuntimeErrorDiagnostic(error);
+            result = {
+                kind: "error",
+                exitCode: 1,
+                lines: [],
+                message: "CLI_RUNTIME_ERROR",
+                projection: props.controller.getProjection(),
+            };
+        }
+        finally {
+            if (!allowWhileRunning)
+                busy.current = false;
+        }
+        lastResult.current = result;
+        props.onResult(result);
+        if (result.jobView && jobGeneration === jobRequestGeneration.current) {
+            jobViewRef.current = result.jobView;
+            setJobView(result.jobView);
+            if (result.jobView.mode === "list") {
+                const nextList = result.jobView;
+                setJobListCache(nextList);
+                setJobSelectedIndex(function clampJobSelection(previous) { return Math.min(previous, Math.max(0, nextList.list.jobs.length - 1)); });
+            }
+            else {
+                const updated = result.jobView.job;
+                setJobListCache(function updateCachedSummary(previous) {
+                    if (!previous)
+                        return previous;
+                    return { ...previous, list: { ...previous.list, jobs: previous.list.jobs.map(function replaceJob(job) { return job.jobId === updated.jobId && (updated.revision ?? 0) >= (job.revision ?? 0) ? updated : job; }) } };
+                });
+            }
+        }
+        if (result.contextView)
+            setContextView(result.contextView);
+        if (prompt && result.submittedInput)
+            props.store.addPendingPrompt(prompt, result.submittedInput, inputPosition);
+        await refreshStatusView();
+        if (result.skillOptions) {
+            pickers.setSkillPickerSkills(result.skillOptions);
+            if (!preserveSkillPickerQuery)
+                pickers.updateSkillPickerQuery("");
+        }
+        if (result.permissionOptions) {
+            pickers.permissionPickerOptionsRef.current = result.permissionOptions;
+            pickers.setPermissionPickerOptions(result.permissionOptions);
+            pickers.updatePermissionPickerIndex(Math.max(0, result.permissionOptions.findIndex(function findSelected(option) { return option.selected; })));
+        }
+        if (result.modelOptions) {
+            pickers.modelPickerOptionsRef.current = result.modelOptions;
+            pickers.setModelPickerOptions(result.modelOptions);
+            pickers.updateModelPickerIndex(Math.max(0, result.modelOptions.findIndex(function findSelected(option) { return option.selected; })));
+        }
+        if (result.effortOptions) {
+            pickers.effortPickerOptionsRef.current = result.effortOptions;
+            pickers.setEffortPickerOptions(result.effortOptions);
+            pickers.updateEffortPickerIndex(Math.max(0, result.effortOptions.findIndex(function findSelected(option) { return option.selected; })));
+        }
+        if (result.kind === "exit")
+            props.onAppExit(result.exitCode);
+    }
+    /** 统一接管终端 resize；inline 防抖，备用屏即时提交，布局提交后由 Ink 清理旧帧。 */
+    useEffect(function subscribeTerminalResize() {
+        const onResize = terminalSizeSource.on;
+        const offResize = terminalSizeSource.off;
+        if (!onResize || !offResize)
+            return;
+        let timer;
+        function commitTerminalSize() {
+            const nextSize = readTuiTerminalSize(terminalSizeSource);
+            timer = undefined;
+            setTerminalSize(nextSize);
+        }
+        function handleTerminalResize() {
+            if (isViewportMode) {
+                commitTerminalSize();
+                return;
+            }
+            if (timer)
+                clearTimeout(timer);
+            timer = setTimeout(commitTerminalSize, 200);
+        }
+        onResize.call(terminalSizeSource, "resize", handleTerminalResize);
+        return function cleanupTerminalResize() {
+            if (timer)
+                clearTimeout(timer);
+            offResize.call(terminalSizeSource, "resize", handleTerminalResize);
+        };
+    }, [isViewportMode, terminalSizeSource]);
+    useLayoutEffect(function syncTerminalSizeToInk() {
+        props.onTerminalSizeChange?.(terminalSize);
+    }, [terminalSize, props.onTerminalSizeChange]);
+    useEffect(function bindTuiMouseInput() {
+        props.mouseInput?.setHandler(handleTuiMouseEvent);
+        return function unbindTuiMouseInput() {
+            props.mouseInput?.setHandler(undefined);
+        };
+    }, [props.mouseInput, isViewportMode, columns, viewportHeight, viewportLines.length]);
+    useEffect(function resetApprovalSelection() {
+        pickers.updateApprovalPickerIndex(0);
+    }, [snapshot.pendingApproval?.approvalId]);
+    useEffect(function disposeTuiAnimationClock() {
+        return function disposeAnimationClock() {
+            animationClock.dispose();
+        };
+    }, [animationClock]);
+    useEffect(function subscribeTuiStore() {
+        return props.store.subscribe(function updateTuiSnapshot() {
+            setSnapshot(props.store.getSnapshot());
+        });
+    }, [props.store]);
+    useEffect(function refreshStatusOnTurnChange() {
+        void refreshStatusView();
+    }, [props.controller, snapshot.status, snapshot.liveTurnId]);
+    // 用量事件到达时重新查询状态栏，让 context 行在 Turn 运行中也能反映三态变化。
+    useEffect(function refreshStatusOnContextUsage() {
+        void refreshStatusView();
+    }, [props.controller, snapshot.contextUsage]);
+    useEffect(function subscribeStdinEnd() {
+        function handleStdinEnd() {
+            props.onEof();
+        }
+        stdin.on("end", handleStdinEnd);
+        return function unsubscribeStdinEnd() {
+            stdin.removeListener("end", handleStdinEnd);
+        };
+    }, [stdin, props.onEof]);
+    useEffect(function captureRawInputSequence() {
+        /** 在 Ink 解析前缓存原始按键序列，用于区分 macOS Backspace 与前向 Delete。 */
+        function capture(chunk) {
+            rawInputSequenceRef.current = String(chunk);
+        }
+        stdin.prependListener("data", capture);
+        return function unsubscribeRawInputSequence() {
+            stdin.removeListener("data", capture);
+        };
+    }, [stdin]);
+    useEffect(function captureTerminalFocus() {
+        /** 读取终端 focus in/out 报告，让失焦时共享动画时钟停止。 */
+        function captureFocus(chunk) {
+            const value = String(chunk);
+            if (value.includes("\u001b[O"))
+                setTerminalFocused(false);
+            if (value.includes("\u001b[I"))
+                setTerminalFocused(true);
+        }
+        stdin.on("data", captureFocus);
+        return function unsubscribeTerminalFocus() {
+            stdin.removeListener("data", captureFocus);
+        };
+    }, [stdin]);
+    useEffect(function runInitialOperation() {
+        if (initialStarted.current || !props.initial)
+            return;
+        initialStarted.current = true;
+        if (props.initial.type === "start") {
+            void dispatchAction({ type: "submit_prompt", content: props.initial.content }, props.initial.content);
+        }
+        else {
+            void (async function resumeInitialTurn() {
+                if (busy.current)
+                    return;
+                busy.current = true;
+                let result;
+                try {
+                    result = await props.controller.resume();
+                }
+                catch {
+                    result = {
+                        kind: "error",
+                        exitCode: 1,
+                        lines: [],
+                        message: "CLI_RUNTIME_ERROR",
+                        projection: props.controller.getProjection(),
+                    };
+                }
+                finally {
+                    busy.current = false;
+                }
+                lastResult.current = result;
+                props.onResult(result);
+                await refreshStatusView();
+            })();
+        }
+    }, [props.controller, props.initial]);
+    useEffect(function closeCompletedOneShot() {
+        if (!props.closeWhenIdle || !initialStarted.current || busy.current)
+            return;
+        if (keepOpenAfterCancel.current)
+            return;
+        if (snapshot.status !== "running" && snapshot.status !== "waiting_approval") {
+            props.onAppExit(snapshot.requestedExitCode ?? lastResult.current?.exitCode ?? 0);
+        }
+    }, [props.closeWhenIdle, snapshot.status, snapshot.requestedExitCode]);
+    /** 在 Job 视图内复用 Ink 输入路由；Esc 只返回视图，不取消 Turn 或退出进程。 */
+    useInput(function handleJobInput(value, key) {
+        const current = jobViewRef.current;
+        if (!current)
+            return;
+        if (key.escape || value === "\u001b") {
+            jobRequestGeneration.current += 1;
+            const next = current.mode === "detail" ? jobListCache : undefined;
+            jobViewRef.current = next;
+            setJobView(next);
+            return;
+        }
+        if (current.mode === "list") {
+            if (key.upArrow) {
+                setJobSelectedIndex(function selectPrevious(index) { return Math.max(0, index - 1); });
+                return;
+            }
+            if (key.downArrow) {
+                setJobSelectedIndex(function selectNext(index) { return Math.min(Math.max(0, current.list.jobs.length - 1), index + 1); });
+                return;
+            }
+            const selected = current.list.jobs[jobSelectedIndex];
+            if (key.return && selected)
+                void dispatchAction({ type: "show_job", jobId: selected.jobId });
+            else if (value === "o" && selected)
+                void dispatchAction({ type: "read_job_output", jobId: selected.jobId });
+            else if (value === "s" && selected?.canStop)
+                void dispatchAction({ type: "stop_job", jobId: selected.jobId });
+            else if (value === "r")
+                void dispatchAction({ type: "list_jobs" });
+            return;
+        }
+        if (value === "o")
+            void dispatchAction({ type: "read_job_output", jobId: current.job.jobId });
+        else if (value === "s" && current.job.canStop)
+            void dispatchAction({ type: "stop_job", jobId: current.job.jobId });
+        else if (value === "r")
+            void dispatchAction({ type: current.output ? "read_job_output" : "show_job", jobId: current.job.jobId });
+    }, { isActive: isRawModeSupported && jobView !== undefined });
+    /** 在 Context 覆盖视图内复用 Ink 输入路由；Esc 只关闭视图回到聊天，不取消 Turn 或退出进程。 */
+    useInput(function handleContextInput(value, key) {
+        if (contextView === undefined)
+            return;
+        if (key.escape || value === "\u001b")
+            setContextView(undefined);
+    }, { isActive: isRawModeSupported && contextView !== undefined });
+    // Ctrl+O 只切换 Todo 展开视图；picker 与审批等待打开时让位，避免按键语义冲突。
+    useInput(function handleTodoExpandInput(input, key) {
+        if (key.ctrl && input === "o")
+            setTodoExpanded(function toggleTodoExpanded(previous) { return !previous; });
+    }, { isActive: isRawModeSupported && !pickers.isPickerActive && !snapshot.pendingApproval });
+    const isLiveTurnTerminal = Boolean(snapshot.liveTurnId && isTerminalStatus(snapshot.status));
+    const inlineHistoryItems = isViewportMode ? [] : [
+        TUI_BRAND_HISTORY_ITEM,
+        ...snapshot.transcript.filter(function selectInlineHistoryItem(item) {
+            if (item.kind === "notice")
+                return false;
+            if (item.kind === "turn")
+                return item.turnId !== snapshot.liveTurnId || isLiveTurnTerminal;
+            return item.key !== snapshot.activePrompt?.key || isLiveTurnTerminal;
+        }),
+    ];
+    const activePrompt = snapshot.activePrompt && !isLiveTurnTerminal ? snapshot.activePrompt : undefined;
+    return (_jsxs(Box, { flexDirection: "column", width: columns, "aria-role": "list", children: [jobView ? _jsx(TuiJobs, { view: jobView, selectedIndex: jobSelectedIndex, useColor: props.useColor, screenReader: props.screenReader }) : contextView ? _jsx(TuiContextReport, { usage: contextView.usage, expanded: contextView.expanded, columns: columns, useColor: props.useColor, screenReader: props.screenReader }) : isViewportMode ? _jsxs(_Fragment, { children: [_jsx(TuiViewportTimeline, { lines: viewportLines, state: viewportState, columns: columns, useColor: props.useColor, selection: selection }), snapshot.pendingApproval ? _jsx(TuiApprovalPrompt, { pendingApproval: snapshot.pendingApproval, selectedIndex: pickers.approvalPickerIndex, useColor: props.useColor, screenReader: props.screenReader }) : null] }) : _jsxs(_Fragment, { children: [inlineHistoryItems.map(function renderInlineHistoryItem(item) {
+                        if (item.kind !== "brand") {
+                            return _jsx(MemoizedTuiTranscriptItem, { item: item, columns: columns, useColor: props.useColor, screenReader: props.screenReader }, item.key);
+                        }
+                        return _jsx(TuiBrandHeader, { statusView: statusView, columns: columns, useColor: props.useColor, screenReader: props.screenReader, reducedMotion: props.reducedMotion ?? false, animationActive: false }, item.key);
+                    }), activePrompt ? _jsx(TuiPromptLine, { content: activePrompt.content, columns: columns, useColor: props.useColor, keyValue: activePrompt.key }) : null, _jsx(TuiLiveTurn, { turnId: isLiveTurnTerminal ? undefined : snapshot.liveTurnId, events: snapshot.liveEvents, presentation: snapshot.livePresentation, pendingApproval: snapshot.pendingApproval, approvalSelectedIndex: pickers.approvalPickerIndex, status: snapshot.status, metrics: snapshot.liveMetrics, useColor: props.useColor, screenReader: props.screenReader, todoExpanded: todoExpanded, todoRowLimit: todoRowLimit, maximumWidth: Math.max(1, columns - 2) }), snapshot.pendingInputs.map(function renderPendingInput(item) {
+                        return item.delivery === "queue" ? _jsx(TuiPendingInputItem, { item: item, useColor: props.useColor }, item.key) : null;
+                    })] }), _jsx(TuiActivityLine, { activity: snapshot.activity, status: snapshot.status, waitingForApproval: snapshot.pendingApproval !== undefined, useColor: props.useColor, screenReader: props.screenReader, reducedMotion: props.reducedMotion ?? false, animationActive: animationActive, clock: animationClock, startedAt: snapshot.liveMetrics?.startedAt, activeForm: activeTodoForm }), _jsx(TuiInfoLines, { messages: infoMessages, useColor: props.useColor }), _jsx(TuiInputArea, { store: props.store, columns: columns, busy: busy, keepOpenAfterCancel: keepOpenAfterCancel, lastSubmittedPromptRef: lastSubmittedPromptRef, rawInputSequenceRef: rawInputSequenceRef, dispatchAction: dispatchAction, onEof: props.onEof, onRequestInterrupt: props.onRequestInterrupt, onRequestCancel: props.onRequestCancel, isRawModeSupported: isRawModeSupported, isInputActive: jobView === undefined && contextView === undefined, showInput: jobView === undefined && contextView === undefined, useColor: props.useColor, screenReader: props.screenReader, pickers: pickers, derivedRef: derivedRef, fileMentionIndex: fileMentionIndex, onLayoutChange: handleInputLayoutChange }), _jsx(TuiStatusLine, { snapshot: snapshot, statusView: statusView, useColor: props.useColor, screenReader: props.screenReader, selectionCharacters: selectedText.length })] }));
+}

package/dist/tui/approval.d.ts

@@ -0,0 +1,19 @@
+/** 审批菜单：根据待审批工具收窄选项，并以 CC 风格上下选择、回车确认。 */
+import { type ReactNode } from "react";
+import type { CliAction, CliProjection } from "../types.js";
+/** TTY 审批菜单只保存公开决定与可见标签，不携带冻结工具输入。 */
+export interface CliTuiApprovalOption {
+    decision: Extract<CliAction, {
+        type: "approve";
+    }>["decision"];
+    label: string;
+}
+/** 根据待审批工具收窄菜单；旧记录缺少冻结范围时保持最保守的单次/拒绝。 */
+export declare function createTuiApprovalOptions(pendingApproval: NonNullable<CliProjection["pendingApproval"]>): CliTuiApprovalOption[];
+/** 以 CC 风格上下选择、回车确认渲染当前审批菜单。 */
+export declare function TuiApprovalPrompt(props: {
+    pendingApproval: NonNullable<CliProjection["pendingApproval"]>;
+    selectedIndex: number;
+    useColor: boolean;
+    screenReader: boolean;
+}): ReactNode;

package/dist/tui/approval.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR } from "../design-tokens.js";
+import { getTuiToolLabel } from "./format.js";
+/** 根据待审批工具收窄菜单；旧记录缺少冻结范围时保持最保守的单次/拒绝。 */
+export function createTuiApprovalOptions(pendingApproval) {
+    if (pendingApproval.allowedDecisions) {
+        // run_command 的工作区级授权展示为"记住此命令"（精确命令约束，与 Web 审批卡同一文案）；
+        // todo_write 的单次批准即任务文件集合批准，与 Web 审批卡同一文案。
+        const labels = {
+            allow_once: pendingApproval.toolName === "todo_write"
+                ? pendingApproval.constraint === "task-ext-files:v1" ? "批准本任务外部文件修改" : "批准本任务文件修改"
+                : "允许本次",
+            allow_session: "本次会话允许",
+            allow_workspace: pendingApproval.toolName === "run_command" ? "记住此命令" : "此工作区允许",
+            deny: "拒绝",
+        };
+        return pendingApproval.allowedDecisions.map(function createFrozenOption(decision) { return { decision, label: labels[decision] }; });
+    }
+    if (pendingApproval.toolName === "run_command") {
+        return [
+            { decision: "allow_once", label: "允许本次" },
+            { decision: "deny", label: "拒绝" },
+        ];
+    }
+    return [
+        { decision: "allow_once", label: "允许本次" },
+        { decision: "allow_session", label: "本次会话允许" },
+        { decision: "allow_workspace", label: "此工作区允许" },
+        { decision: "deny", label: "拒绝" },
+    ];
+}
+/** 以 CC 风格上下选择、回车确认渲染当前审批菜单。 */
+export function TuiApprovalPrompt(props) {
+    const options = createTuiApprovalOptions(props.pendingApproval);
+    const selectedIndex = Math.max(0, Math.min(props.selectedIndex, options.length - 1));
+    return (_jsxs(Box, { borderStyle: "single", borderColor: props.useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "\u9700\u8981\u4F60\u7684\u786E\u8BA4" }), _jsxs(Text, { children: ["\u64CD\u4F5C\uFF1A", props.pendingApproval.display?.operation ?? getTuiToolLabel(props.pendingApproval.toolName)] }), _jsxs(Text, { children: ["\u539F\u56E0\uFF1A", props.pendingApproval.reason] }), props.pendingApproval.display?.resource ? _jsxs(Text, { children: ["\u5F71\u54CD\uFF1A", props.pendingApproval.display.resource] }) : null, props.pendingApproval.display?.cwd ? _jsxs(Text, { children: ["\u5DE5\u4F5C\u76EE\u5F55\uFF1A", props.pendingApproval.display.cwd] }) : null, props.pendingApproval.display?.effect === "external" && props.pendingApproval.display?.hostExecution === true ? (_jsx(Text, { color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "\u26A0 \u5916\u90E8\u8DEF\u5F84\uFF1A\u547D\u4EE4\u58F0\u660E\u4E86\u5DE5\u4F5C\u533A\u5916\u76EE\u6807\uFF0C\u4F46\u5BBF\u4E3B\u8FDB\u7A0B\u4E0D\u53D7\u8BE5\u6587\u4EF6\u8303\u56F4\u7EA6\u675F\uFF0C\u53EF\u80FD\u540C\u65F6\u5F71\u54CD\u5176\u4ED6\u6587\u4EF6\uFF1B\u6279\u51C6\u4E0D\u6784\u6210\u7CBE\u786E\u8303\u56F4\u4FDD\u8BC1" })) : null, props.pendingApproval.display?.effect === "external" && props.pendingApproval.display?.hostExecution !== true && props.pendingApproval.display?.unknownScope ? (_jsx(Text, { color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "\u26A0 \u4FEE\u6539\u8303\u56F4\u65E0\u6CD5\u7CBE\u786E\u9650\u5B9A\uFF1A\u8BE5\u547D\u4EE4\u672A\u58F0\u660E\u7CBE\u786E\u5916\u90E8\u76EE\u6807\uFF0C\u8BF7\u5BA1\u67E5\u5B8C\u6574\u547D\u4EE4\u540E\u518D\u51B3\u5B9A" })) : null, props.pendingApproval.display?.effect === "external" && props.pendingApproval.display?.hostExecution !== true && !props.pendingApproval.display?.unknownScope ? (_jsx(Text, { color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "\u26A0 \u5916\u90E8\u8DEF\u5F84\uFF1A\u76EE\u6807\u4F4D\u4E8E\u5DE5\u4F5C\u533A\u4E4B\u5916\uFF0C\u6388\u6743\u4EC5\u8986\u76D6\u4E0A\u8FF0\u7CBE\u786E\u76EE\u6807" })) : null, props.pendingApproval.display?.hostExecution === true ? (_jsx(Text, { color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "Windows \u5BBF\u4E3B\u6267\u884C\uFF1A\u672C\u6B21\u547D\u4EE4\u5C06\u5728\u5F53\u524D\u7528\u6237\u6743\u9650\u4E0B\u76F4\u63A5\u8FD0\u884C\uFF0C\u672A\u542F\u7528\u6C99\u7BB1\u9694\u79BB\uFF1B\u6279\u51C6\u4EC5\u5BF9\u672C\u6B21\u8C03\u7528\u6709\u6548\uFF0C\u62D2\u7EDD\u5219\u4E0D\u6267\u884C" })) : null, props.pendingApproval.toolName === "run_command" && options.some(function hasWorkspaceOption(option) { return option.decision === "allow_workspace"; }) ? (_jsx(Text, { dimColor: props.useColor, children: "\u9009\u62E9\u201C\u8BB0\u4F4F\u6B64\u547D\u4EE4\u201D\u4F1A\u8BB0\u4F4F\u672C\u6761\u547D\u4EE4\uFF08\u7A0B\u5E8F\u3001\u53C2\u6570\u4E0E\u5DE5\u4F5C\u76EE\u5F55\u5B8C\u5168\u4E00\u81F4\uFF09\uFF0C\u6B64\u540E\u5728\u672C\u5DE5\u4F5C\u533A\u81EA\u52A8\u653E\u884C\uFF1B\u53C2\u6570\u6216\u76EE\u5F55\u4E0D\u540C\u7684\u547D\u4EE4\u4ECD\u4F1A\u91CD\u65B0\u8BE2\u95EE" })) : null, props.pendingApproval.constraint === "task-ext-files:v1" ? (_jsx(Text, { color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: "\u26A0 \u5916\u90E8\u8DEF\u5F84\uFF1A\u76EE\u6807\u4F4D\u4E8E\u5DE5\u4F5C\u533A\u4E4B\u5916\uFF0C\u4E0E\u5DE5\u4F5C\u533A\u6587\u4EF6\u96C6\u5408\u5206\u5F00\u5355\u72EC\u6279\u51C6\uFF1B\u6388\u6743\u4EC5\u8986\u76D6\u6E05\u5355\u5185\u7CBE\u786E\u6587\u4EF6\uFF0C\u4E0D\u542B\u7236\u76EE\u5F55\u6216\u9012\u5F52\u6743\u9650" })) : null, props.pendingApproval.toolName === "todo_write" && props.pendingApproval.constraint !== "task-ext-files:v1" && options.some(function hasOnceOption(option) { return option.decision === "allow_once"; }) ? (_jsx(Text, { dimColor: props.useColor, children: "\u6279\u51C6\u540E\uFF0C\u672C\u4EFB\u52A1\u5185\u5BF9\u6E05\u5355\u5185\u6587\u4EF6\u7684\u5BF9\u5E94\u4FEE\u6539\u5C06\u81EA\u52A8\u653E\u884C\uFF1B\u6E05\u5355\u5916\u7684\u65B0\u6587\u4EF6\u4ECD\u4F1A\u9010\u6B21\u8BE2\u95EE\uFF1B\u6388\u6743\u4EC5\u8986\u76D6\u5F53\u524D\u4EFB\u52A1" })) : null, props.pendingApproval.constraint === "task-ext-files:v1" && options.some(function hasOnceOption(option) { return option.decision === "allow_once"; }) ? (_jsx(Text, { dimColor: props.useColor, children: "\u6279\u51C6\u540E\uFF0C\u672C\u4EFB\u52A1\u5185\u5BF9\u6E05\u5355\u5185\u7CBE\u786E\u6587\u4EF6\u7684\u5BF9\u5E94\u4FEE\u6539\u5C06\u81EA\u52A8\u653E\u884C\uFF1B\u6E05\u5355\u5916\u76EE\u6807\u4ECD\u9010\u6B21\u8BE2\u95EE\uFF1B\u6388\u6743\u4EC5\u8986\u76D6\u5F53\u524D\u4EFB\u52A1\uFF0C\u65B0\u76EE\u5F55\u6216\u65B0\u6587\u4EF6\u4E0D\u4F1A\u56E0\u6B64\u83B7\u5F97\u6388\u6743" })) : null, props.pendingApproval.constraint === "no-sandbox-exec:v1" ? (_jsx(Text, { color: props.useColor ? "yellow" : undefined, children: "\u6C99\u7BB1\u542F\u52A8\u5931\u8D25\uFF1A\u672C\u6B21\u5C06\u65E0\u6C99\u7BB1\u9694\u79BB\u76F4\u63A5\u6267\u884C\u4E0A\u8FF0\u547D\u4EE4\uFF1B\u6279\u51C6\u4EC5\u5BF9\u672C\u6B21\u8C03\u7528\u6709\u6548\uFF0C\u62D2\u7EDD\u5219\u4EFB\u52A1\u505C\u6B62" })) : null, props.pendingApproval.display?.effect === "external" && props.pendingApproval.toolName !== "run_command" && options.some(function hasWorkspaceOption(option) { return option.decision === "allow_workspace"; }) ? (_jsx(Text, { dimColor: props.useColor, children: "\u9009\u62E9\u201C\u6B64\u5DE5\u4F5C\u533A\u5141\u8BB8\u201D\u5C06\u628A\u8BE5\u89C4\u5219\u5199\u5165\u5DE5\u4F5C\u533A .autopilot/settings.local.json" })) : null, options.map(function renderApprovalOption(option, index) {
+                const selected = index === selectedIndex;
+                return _jsxs(Text, { inverse: selected && props.useColor, children: [selected ? "›" : " ", " ", option.label, selected && props.screenReader ? "（已选择）" : ""] }, option.decision);
+            }), _jsx(Text, { dimColor: props.useColor, children: "\u2191/\u2193 \u9009\u62E9 \u00B7 Enter \u786E\u8BA4" })] }));
+}

package/dist/tui/brand/brand-header.d.ts

@@ -0,0 +1,20 @@
+/** 顶部品牌头：静态像素字标 + Autopilot 版本/模型/推理强度信息。 */
+import { type ReactNode } from "react";
+import type { CliStatusView } from "../../types.js";
+import type { CliTuiTranscriptItem } from "../types.js";
+/** 内联历史项标记：用于把品牌头和 transcript 放入同一棵可重排的渲染树。 */
+export declare const TUI_BRAND_HISTORY_ITEM: {
+    kind: "brand";
+    key: string;
+};
+/** 内联历史项：品牌头或 transcript 节点。 */
+export type TuiInlineHistoryItem = typeof TUI_BRAND_HISTORY_ITEM | CliTuiTranscriptItem;
+/** 渲染顶部品牌头。 */
+export declare function TuiBrandHeader(props: {
+    statusView?: CliStatusView;
+    columns: number;
+    useColor: boolean;
+    screenReader: boolean;
+    reducedMotion: boolean;
+    animationActive: boolean;
+}): ReactNode;