@autopilot-agent/cli 0.0.0-stage → 0.2.0

package/dist/tui/timeline/presentation-timeline.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/** 基于共享 Presentation selector 的 CLI 时间线；不读取旧工具 summary、detail 或审批 preview。 */
+import { getPresentationCopy, getToolPresentationProfile, isSandboxUnavailableErrorCode, selectToolCalls } from "@autopilot-agent/presentation";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_BG_COLOR, TUI_ACCENT_COLOR, TUI_CHIP_TEXT_COLOR, TUI_TOOL_ERROR_BG_COLOR, TUI_TOOL_ERROR_TEXT_COLOR } from "../../design-tokens.js";
+import { TUI_AGENT_LABEL } from "../constants.js";
+import { TuiDiffStats } from "../diff-stats.js";
+import { getTuiDiffStats } from "../format.js";
+import { TuiDiffBlock } from "../markdown/diff.js";
+import { TuiMarkdown } from "../markdown/markdown.js";
+import { TuiPromptLine } from "../transcript.js";
+import { TuiTodoList } from "../todo-list.js";
+import { getTuiTurnItems } from "./turn-items.js";
+/** 取得 ToolCall 的纯文本状态标志，不依赖颜色表达执行结果。 */
+function getToolStateGlyph(state) {
+    if (state === "completed")
+        return "•";
+    if (state === "denied")
+        return "×";
+    if (state === "cancelled" || state === "timeout")
+        return "⚠";
+    if (state === "failed")
+        return "×";
+    return "✢";
+}
+/** 取得拒绝、取消与超时文字；执行失败由叉号和错误详情表达。沙箱不可用类拒绝是环境阻塞而非用户拒绝，文案必须区分。 */
+function getToolStateText(state, errorCode) {
+    if (state === "denied")
+        return isSandboxUnavailableErrorCode(errorCode) ? "沙箱不可用，命令未启动" : "已拒绝";
+    if (state === "cancelled")
+        return "已取消";
+    if (state === "timeout")
+        return "已超时";
+    return undefined;
+}
+/** 判断工具是否处于失败类终态；失败步骤文字使用错误红并保留文字标签。 */
+function isFailedToolState(state) {
+    return state === "failed" || state === "denied" || state === "cancelled" || state === "timeout";
+}
+/** 取得 Turn 的纯文本终态标志，不把失败、取消和上限混为成功。 */
+function getTurnStateGlyph(state) {
+    return state === "completed" ? "✓" : state === "interrupted" || state === "paused" ? "⚠" : "×";
+}
+/** 从 Core 冻结的 Web 明细生成 TUI 安全文案，不读取 query、URL 路径或网页正文。 */
+function getWebToolDetailText(item) {
+    if (item.detail?.kind === "web_search") {
+        const summary = item.detail.sourceCount === 0 ? "搜索服务未返回结构化引用" : `找到 ${item.detail.sourceCount} 个公开来源`;
+        return `${summary}${item.detail.truncated ? " · 结果已截断" : ""}`;
+    }
+    if (item.detail?.kind === "web_fetch") {
+        return `${item.detail.host} · ${item.detail.contentType}${item.detail.truncated ? " · 内容已截断" : ""}`;
+    }
+    return undefined;
+}
+/** 将一个共享 selector 节点渲染为 Ink 视图，Tool 节点的 React key 始终绑定 callId。 */
+function renderPresentationItem(item, useColor, maximumWidth, detailView, toolCallIndex) {
+    if (item.kind === "todo")
+        return _jsx(Box, { flexDirection: "column", children: _jsx(TuiTodoList, { item: item, expanded: detailView.expanded || detailView.screenReader, useColor: useColor, screenReader: detailView.screenReader, columns: maximumWidth + 2, rowLimit: detailView.rowLimit, showToggleHint: detailView.showToggleHint }) }, item.id);
+    if (item.kind === "thinking")
+        return _jsxs(Text, { dimColor: useColor, children: ["\u2722 ", item.summary] }, item.id);
+    if (item.kind === "tool_group") {
+        const summary = (_jsxs(Text, { children: [_jsx(Text, { dimColor: useColor, children: "\u2022 Exploring codebase \u00B7 " }), _jsx(Text, { color: useColor ? TUI_ACCENT_COLOR : undefined, children: item.toolCallIds.length }), _jsx(Text, { dimColor: useColor, children: " operations" })] }, item.id));
+        // 分组默认只显示摘要；Ctrl+O 详情态或 screen reader 下展开渲染组内各调用。
+        if (!detailView.toolGroupsExpanded && !detailView.screenReader)
+            return summary;
+        const children = item.toolCallIds
+            .map(function findGroupChild(callId) { return toolCallIndex?.get(callId); })
+            .filter(function isKnownCall(child) { return child !== undefined; });
+        return (_jsxs(Box, { flexDirection: "column", children: [summary, children.map(function renderGroupChild(child) { return _jsx(Box, { paddingLeft: 2, children: renderPresentationItem(child, useColor, maximumWidth, detailView, toolCallIndex) }, child.callId); })] }, item.id));
+    }
+    if (item.kind === "tool_call") {
+        const title = getPresentationCopy(item.state === "failed" ? getToolPresentationProfile(item.toolName).completedTitleKey : item.titleKey);
+        const jobProgramLabel = item.job?.action === "start" ? item.job.programLabel?.toUpperCase() : undefined;
+        const diffStats = getTuiDiffStats(item.diff);
+        const detail = getWebToolDetailText(item) ?? [jobProgramLabel ? undefined : item.target, item.resultSummary].filter(Boolean).join(" · ");
+        const glyph = getToolStateGlyph(item.state);
+        // 失败沿用完成态工具名称，仅徽标使用错误红；前缀符号独立显示。
+        const stateText = getToolStateText(item.state, item.errorCode);
+        const head = isFailedToolState(item.state)
+            ? _jsxs(Text, { children: [_jsxs(Text, { color: useColor ? TUI_TOOL_ERROR_BG_COLOR : undefined, children: [glyph, " "] }), _jsxs(Text, { backgroundColor: useColor ? TUI_TOOL_ERROR_BG_COLOR : undefined, color: useColor ? TUI_TOOL_ERROR_TEXT_COLOR : undefined, bold: useColor || undefined, children: ["[", title, "]", stateText ? ` · ${stateText}` : ""] })] })
+            : _jsxs(Text, { children: [_jsxs(Text, { dimColor: useColor, children: [glyph, " "] }), _jsxs(Text, { backgroundColor: useColor ? TUI_ACCENT_BG_COLOR : undefined, color: useColor ? TUI_CHIP_TEXT_COLOR : undefined, bold: useColor || undefined, children: ["[", title, "]"] })] });
+        return _jsxs(Box, { flexDirection: "column", children: [head, jobProgramLabel ? _jsxs(Text, { children: ["  \u2514\u2500 ", _jsx(Text, { bold: true, color: useColor ? TUI_ACCENT_COLOR : undefined, children: jobProgramLabel }), detail ? _jsxs(Text, { dimColor: useColor, children: [" \u00B7 ", detail] }) : null] }) : detail || diffStats ? _jsxs(Text, { children: ["  \u2514\u2500 ", detail ? _jsxs(Text, { dimColor: useColor, children: [detail, " "] }) : null, diffStats ? _jsx(TuiDiffStats, { ...diffStats, useColor: useColor }) : null] }) : null, item.errorCode ? _jsxs(Text, { dimColor: useColor, children: ["  \u2514\u2500 ", item.errorCode] }) : null, item.executionMode === "unisolated" ? _jsx(Text, { color: useColor ? TUI_TOOL_ERROR_TEXT_COLOR : undefined, children: "  \u2514\u2500 \u672A\u9694\u79BB\uFF1A\u5BBF\u4E3B\u76F4\u63A5\u6267\u884C" }) : null, item.diagnostics?.length ? _jsxs(Text, { dimColor: useColor, children: ["  \u2514\u2500 \u8BCA\u65AD\uFF1A", item.diagnostics.join("；")] }) : null, item.job?.action === "start" && (item.job.observedStatus === "starting" || item.job.observedStatus === "running") ? _jsx(Text, { dimColor: useColor, children: "  /jobs \u67E5\u770B\u540E\u53F0\u4EFB\u52A1" }) : null, item.diff?.text ? _jsx(TuiDiffBlock, { diff: item.diff.text, keyPrefix: item.callId, useColor: useColor }) : null] }, item.callId);
+    }
+    if (item.kind === "approval") {
+        const detail = item.display?.actionPreview ?? item.display?.operation ?? "需要确认";
+        // 历史行与待审卡共用 constraint 判定，普通批准与无沙箱批准不得混淆。
+        const noSandbox = item.constraint === "no-sandbox-exec:v1" ? " · 无沙箱直接执行" : "";
+        // Talk-Plan1022 S3：宿主执行审批事实与 no-sandbox 降级卡分开呈现，措辞不宣称已执行。
+        const hostExecution = item.display?.executionMode === "unisolated" ? " · 将在当前用户权限下运行（未启用沙箱隔离）" : "";
+        return _jsxs(Text, { dimColor: useColor, children: ["\u26A0 ", detail, noSandbox, hostExecution, item.state === "resolved" ? " · 已处理" : ""] }, item.id);
+    }
+    if (item.kind === "user_question")
+        return _jsx(Text, { dimColor: useColor, children: "\u8BF7\u5728\u652F\u6301\u7ED3\u6784\u5316\u56DE\u7B54\u7684 Web \u4E2D\u5904\u7406" }, item.id);
+    if (item.kind === "assistant_answer") {
+        if (item.channel === "process")
+            return _jsx(TuiMarkdown, { content: item.content, keyPrefix: item.id, useColor: useColor, maximumWidth: maximumWidth }, item.id);
+        return _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, color: useColor ? TUI_ACCENT_COLOR : undefined, children: ["\u2022 ", TUI_AGENT_LABEL] }), _jsx(TuiMarkdown, { content: item.content, keyPrefix: item.id, useColor: useColor, maximumWidth: maximumWidth })] }, item.id);
+    }
+    if (item.kind === "context_notice")
+        return _jsx(Text, { dimColor: useColor, children: item.state === "compacted" ? "Context organized" : `Context ${item.state}` }, item.id);
+    if (item.kind === "undo") {
+        const isPartial = item.state === "failed" && (item.restoredPaths.length > 0 || item.compensatedPaths.length > 0);
+        const title = item.state === "completed" ? "Undo completed" : isPartial ? "Undo incomplete" : "Undo failed";
+        return _jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { dimColor: useColor, children: [item.state === "completed" ? "✓" : "⚠", " ", title] }), item.restoredPaths.length > 0 ? _jsxs(Text, { dimColor: useColor, children: ["  restored: ", item.restoredPaths.join(", ")] }) : null, item.compensatedPaths.length > 0 ? _jsxs(Text, { dimColor: useColor, children: ["  compensated: ", item.compensatedPaths.join(", ")] }) : null, item.conflicts.length > 0 ? _jsxs(Text, { dimColor: useColor, children: ["  conflicts (not overwritten): ", item.conflicts.join(", ")] }) : null] }, item.id);
+    }
+    if (item.kind === "input_notice")
+        return _jsxs(Text, { dimColor: useColor, children: [item.delivery === "steer" ? "[引导] " : item.delivery === "queue" ? "[排队] " : "", "Input ", item.state] }, item.id);
+    if (item.kind === "turn_summary")
+        return _jsxs(Text, { dimColor: useColor, children: [getTurnStateGlyph(item.state), " ", getPresentationCopy(`turn.${item.state}`), " \u00B7 ", item.toolCount, " tools"] }, item.id);
+    if (item.kind === "job") {
+        if (item.state === "interrupted")
+            return _jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: useColor, children: "\u26A0 Job interrupted" }), _jsx(Text, { dimColor: useColor, children: "  Process cannot be reattached after restart." })] }, item.id);
+        return _jsxs(Text, { dimColor: useColor, children: ["Job ", item.state, item.summary ? ` · ${item.summary}` : ""] }, item.id);
+    }
+    if (item.kind === "capability_notice")
+        return _jsx(Text, { dimColor: useColor, children: item.summary ?? item.state }, item.id);
+    return null;
+}
+/** 渲染指定 Turn 的共享 Presentation 时间线；无匹配节点时由调用方回退兼容旧事件。 */
+export function renderTuiPresentationTimeline(presentation, turnId, useColor, maximumWidth, detailView, events = []) {
+    // 构建 callId 索引供展开分组取回组内调用；分组只按 callId 引用，不携带子节点事实。
+    const toolCallIndex = new Map(selectToolCalls(presentation, turnId).map(function indexToolCall(call) { return [call.callId, call]; }));
+    return getTuiTurnItems(presentation, turnId, events).map(function renderSharedTimelineItem(item) {
+        if ("type" in item)
+            return _jsxs(Box, { flexDirection: "column", children: [_jsx(TuiPromptLine, { content: item.content, useColor: useColor, columns: maximumWidth + 2 }), _jsxs(Text, { dimColor: useColor, children: [item.delivery === "queue" ? "[排队]" : "[引导]", " ", item.cancelled ? "已取消" : item.consumed === false ? "等待当前步骤结束" : "已插入当前 turn"] })] }, `input:${item.inputId}`);
+        return renderPresentationItem(item, useColor, maximumWidth, detailView, toolCallIndex);
+    });
+}

package/dist/tui/timeline/progress.d.ts

@@ -0,0 +1,12 @@
+/** 当前思考进度汇总；只统计已发出的 tool_started，避免结果重复计数。 */
+import { type ReactNode } from "react";
+import type { CliTurnStatus } from "../../types.js";
+import type { CliTuiTimelineEvent, CliTuiTurnMetrics } from "../types.js";
+/** 汇总 Claude Code 风格的当前思考进度；只统计已发出的 tool_started，避免结果重复计数。 */
+export declare function TuiLiveProgressSummary(props: {
+    events: CliTuiTimelineEvent[];
+    status: CliTurnStatus;
+    metrics?: CliTuiTurnMetrics;
+    useColor: boolean;
+    activeTodoForm?: string;
+}): ReactNode;

package/dist/tui/timeline/progress.js

@@ -0,0 +1,43 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+/** 当前思考进度汇总；只统计已发出的 tool_started，避免结果重复计数。 */
+import { useEffect, useState } from "react";
+import { Text } from "ink";
+import { formatTuiDuration } from "../format.js";
+/** 汇总 Claude Code 风格的当前思考进度；只统计已发出的 tool_started，避免结果重复计数。 */
+export function TuiLiveProgressSummary(props) {
+    const [now, setNow] = useState(() => Date.now());
+    const active = props.status === "running" || props.status === "waiting_approval";
+    useEffect(function refreshProgressSummary() {
+        if (!active)
+            return;
+        const timer = setInterval(function updateProgressSummaryClock() { setNow(Date.now()); }, 1_000);
+        return function stopProgressSummaryClock() { clearInterval(timer); };
+    }, [active]);
+    if (!active || !props.metrics)
+        return null;
+    // Todo 的 activeForm 是模型声明的稳定活动文案，优先于宿主猜测的工具动词短语。
+    if (props.activeTodoForm) {
+        return _jsxs(Text, { dimColor: props.useColor, children: [props.activeTodoForm, " \u00B7 ", formatTuiDuration(Math.max(0, now - props.metrics.startedAt)), "\u2026"] });
+    }
+    const counts = new Map();
+    for (const event of props.events) {
+        if (event.type !== "tool_started")
+            continue;
+        counts.set(event.toolName, (counts.get(event.toolName) ?? 0) + 1);
+    }
+    const phrases = [];
+    const phrase = function makePhrase(toolName, verb, singular) {
+        const count = counts.get(toolName) ?? 0;
+        if (count === 0)
+            return;
+        phrases.push(`${verb} ${count} ${count === 1 ? singular : singular + "s"}`);
+    };
+    phrase("glob_files", "listing", "directory");
+    phrase("grep_files", "searching", "code search");
+    phrase("read_file", "reading", "file");
+    phrase("run_command", "running", "shell command");
+    phrase("write_file", "writing", "file");
+    phrase("edit_file", "editing", "file");
+    const thinking = `Thinking for ${formatTuiDuration(Math.max(0, now - props.metrics.startedAt))}`;
+    return _jsxs(Text, { dimColor: props.useColor, children: [thinking, phrases.length > 0 ? `, ${phrases.join(", ")}` : "", "\u2026"] });
+}

package/dist/tui/timeline/static-timeline.d.ts

@@ -0,0 +1,13 @@
+/** 历史 Turn 时间线：把安全事件聚合为可读时间线行，连续 answer_delta 只显示为一个回答块。 */
+import { type ReactNode } from "react";
+import type { CliTurnStatus } from "../../types.js";
+import type { CliTuiTimelineEvent } from "../types.js";
+import type { AgentPresentationState } from "@autopilot-agent/presentation";
+/** 将安全事件聚合为可读的时间线行，连续 answer_delta 只显示为一个回答块。 */
+export declare function renderTimeline(events: CliTuiTimelineEvent[], useColor: boolean, timing?: {
+    thoughtDurationMs?: number;
+    totalDurationMs?: number;
+    presentation?: AgentPresentationState;
+    turnId?: string;
+    status?: CliTurnStatus;
+}, maximumWidth?: number, screenReader?: boolean): ReactNode[];

package/dist/tui/timeline/static-timeline.js

@@ -0,0 +1,131 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR, TUI_TOOL_ERROR_TEXT_COLOR } from "../../design-tokens.js";
+import { TUI_AGENT_LABEL } from "../constants.js";
+import { formatTuiDuration, formatTuiInputConsumed, getTuiApprovalDecisionLabel, getTuiToolLabel, getTuiTerminationSummary, getTuiTurnFailureReason } from "../format.js";
+import { TuiMarkdown } from "../markdown/markdown.js";
+import { renderTuiToolTreeEvent } from "./tool-tree.js";
+import { renderTuiPresentationTimeline } from "./presentation-timeline.js";
+import { TuiPromptLine } from "../transcript.js";
+import { TuiTodoList } from "../todo-list.js";
+import { getTuiTurnTodo } from "./turn-items.js";
+/** 将安全事件聚合为可读的时间线行，连续 answer_delta 只显示为一个回答块。 */
+export function renderTimeline(events, useColor, timing, maximumWidth = 80, screenReader = false) {
+    // 历史区在 Turn 终态只固化一次最终快照；读屏模式继续输出中文状态，不能退化为 glyph-only。
+    if (timing?.presentation && timing.turnId && timing.presentation.items.some(function belongsToTurn(item) { return item.kind === "capability_notice" || ("turnId" in item && item.turnId === timing.turnId); })) {
+        const nodes = renderTuiPresentationTimeline(timing.presentation, timing.turnId, useColor, maximumWidth, { expanded: true, screenReader }, events);
+        const failureReason = getTuiTurnFailureReason(events);
+        const terminationSummary = getTuiTerminationSummary(events, timing?.status);
+        if (terminationSummary)
+            nodes.push(_jsxs(Text, { children: ["\u7EC8\u6001\uFF1A", terminationSummary] }, "turn:termination"));
+        else if (failureReason)
+            nodes.push(_jsxs(Text, { children: ["\u539F\u56E0\uFF1A", failureReason] }, "turn:failure-reason"));
+        if (timing.totalDurationMs !== undefined)
+            nodes.push(_jsxs(Text, { dimColor: useColor, children: ["* Cogitated for ", formatTuiDuration(timing.totalDurationMs)] }, "turn:total-duration"));
+        return nodes;
+    }
+    const nodes = [];
+    let answer = "";
+    let answerSeq = 0;
+    let lastAnswerNodeIndex;
+    const submittedApprovalIds = new Set(events.flatMap(function readSubmittedApproval(event) {
+        return event.type === "tui_approval_submitted" ? [event.approvalId] : [];
+    }));
+    function flushAnswer() {
+        if (!answer)
+            return;
+        const isFirstAnswer = answerSeq === 0;
+        nodes.push(_jsxs(Box, { flexDirection: "column", children: [isFirstAnswer && timing?.thoughtDurationMs !== undefined ? _jsxs(Text, { dimColor: useColor, children: ["Thought for ", formatTuiDuration(timing.thoughtDurationMs)] }) : null, _jsxs(Text, { bold: true, color: useColor ? TUI_ACCENT_COLOR : undefined, children: ["\u2022 ", TUI_AGENT_LABEL] }), _jsx(TuiMarkdown, { content: answer, keyPrefix: "answer:" + String(answerSeq), useColor: useColor, maximumWidth: maximumWidth })] }, "answer:" + String(answerSeq++)));
+        lastAnswerNodeIndex = nodes.length - 1;
+        answer = "";
+    }
+    /** 收到 Core reset/discard 后移除已经固化的暂定回答，避免每个工具步骤都留下重复报告。 */
+    function discardAnswer() {
+        answer = "";
+        if (lastAnswerNodeIndex === undefined)
+            return;
+        nodes[lastAnswerNodeIndex] = undefined;
+        lastAnswerNodeIndex = undefined;
+        answerSeq = Math.max(0, answerSeq - 1);
+    }
+    for (const event of events) {
+        if (event.type === "answer_delta") {
+            answer += event.delta;
+            continue;
+        }
+        if (event.type === "answer_reset") {
+            discardAnswer();
+            continue;
+        }
+        flushAnswer();
+        if (event.type === "tui_input_consumed") {
+            nodes.push(_jsxs(Box, { flexDirection: "column", children: [_jsx(TuiPromptLine, { content: event.content, useColor: useColor, columns: maximumWidth + 2 }), _jsx(Text, { dimColor: useColor, children: event.cancelled ? "[引导] 已取消" : event.consumed === false ? "[引导] 等待当前步骤结束" : formatTuiInputConsumed(event) })] }, "input:" + event.inputId));
+        }
+        else if (event.type === "tui_approval_submitted") {
+            nodes.push(_jsxs(Text, { dimColor: useColor, children: ["Approval submitted \u00B7 ", getTuiApprovalDecisionLabel(event.decision)] }, String(event.seq) + ":approval:" + event.approvalId));
+        }
+        else if (event.type === "turn_started") {
+            continue;
+        }
+        else if (event.type === "reasoning_summary") {
+            continue;
+        }
+        else if (event.type === "reasoning_hidden") {
+            continue;
+        }
+        else if (event.type === "tool_started" || event.type === "tool_result") {
+            nodes.push(_jsx(Box, { children: renderTuiToolTreeEvent(event, useColor) }, String(event.seq)));
+        }
+        else if (event.type === "approval_required") {
+            if (submittedApprovalIds.has(event.approvalId))
+                continue;
+            nodes.push(_jsxs(Box, { borderStyle: "single", borderColor: useColor ? TUI_ACCENT_COLOR : undefined, paddingX: 1, flexDirection: "column", children: [_jsx(Text, { bold: true, color: useColor ? TUI_ACCENT_COLOR : undefined, children: "Approval required" }), _jsxs(Text, { children: ["\u64CD\u4F5C\uFF1A", getTuiToolLabel(event.toolName)] }), _jsxs(Text, { children: ["\u539F\u56E0\uFF1A", event.reason] }), event.display?.executionMode === "unisolated" && _jsx(Text, { color: useColor ? TUI_TOOL_ERROR_TEXT_COLOR : undefined, children: "\u5C06\u5728\u5F53\u524D\u7528\u6237\u6743\u9650\u4E0B\u8FD0\u884C\uFF08\u672A\u542F\u7528\u6C99\u7BB1\u9694\u79BB\uFF09" }), _jsx(Text, { dimColor: useColor, children: "[y] \u672C\u6B21  [s] \u672C\u6B21\u4F1A\u8BDD  [w] \u6B64\u5DE5\u4F5C\u533A  [n] \u62D2\u7EDD" })] }, String(event.seq)));
+        }
+        else if (event.type === "input_queued") {
+            nodes.push(_jsx(Text, { dimColor: useColor, children: "Additional instruction queued; waiting for the current step" }, String(event.seq)));
+        }
+        else if (event.type === "todo_updated") {
+            // Todo 展示由共享 Presentation 的单卡负责，事件流本身不产生重复的静态行。
+            continue;
+        }
+        else if (event.type === "input_joined" || event.type === "input_consumed") {
+            continue;
+        }
+        else if (event.type === "model_recovery") {
+            nodes.push(_jsxs(Text, { dimColor: useColor, children: ["Recovering \u00B7 ", event.reason] }, String(event.seq)));
+        }
+        else if (event.type === "context_overflow") {
+            nodes.push(_jsx(Text, { children: "Context limit reached; organizing before continuing" }, String(event.seq)));
+        }
+        else if (event.type === "context_compact_started") {
+            nodes.push(_jsx(Text, { dimColor: useColor, children: "Organizing context" }, String(event.seq)));
+        }
+        else if (event.type === "context_compacted") {
+            nodes.push(_jsx(Text, { children: "Context organized" }, String(event.seq)));
+        }
+        else if (event.type === "context_compact_failed") {
+            nodes.push(_jsx(Text, { children: "Context organization failed" }, String(event.seq)));
+        }
+        else if (event.type === "context_compact_circuit_open") {
+            nodes.push(_jsx(Text, { children: "Context organization temporarily unavailable" }, String(event.seq)));
+        }
+        else if (event.type === "active_skills") {
+            continue;
+        }
+        else if (event.type === "status") {
+            continue;
+        }
+    }
+    flushAnswer();
+    const todo = getTuiTurnTodo(events, timing?.turnId ?? events[0]?.turnId ?? "");
+    if (todo)
+        nodes.push(_jsx(Box, { flexDirection: "column", children: _jsx(TuiTodoList, { item: todo, expanded: true, useColor: useColor, screenReader: screenReader, columns: maximumWidth + 2 }) }, "turn:todo"));
+    const terminationSummary = getTuiTerminationSummary(events, timing?.status);
+    if (terminationSummary)
+        nodes.push(_jsxs(Text, { children: ["\u7EC8\u6001\uFF1A", terminationSummary] }, "turn:termination"));
+    else if (getTuiTurnFailureReason(events))
+        nodes.push(_jsxs(Text, { children: ["\u539F\u56E0\uFF1A", getTuiTurnFailureReason(events)] }, "turn:failure-reason"));
+    if (timing?.totalDurationMs !== undefined)
+        nodes.push(_jsxs(Text, { dimColor: useColor, children: ["* Cogitated for ", formatTuiDuration(timing.totalDurationMs)] }, "turn:total-duration"));
+    return nodes.filter(function isVisibleTimelineNode(node) { return node !== undefined; });
+}

package/dist/tui/timeline/tool-tree.d.ts

@@ -0,0 +1,7 @@
+/** 工具进度树节点：父节点是徽标 chip 与参数 chip，子节点是结果行与 unified diff。 */
+import { type ReactNode } from "react";
+import type { CliTuiTimelineEvent } from "../types.js";
+/** 按进度树展示工具：徽标持久强调，参数 chip 与徽标同行并右端截断，结果行保留 └─ 连线与 ✓/✗ 文字标签。 */
+export declare function renderTuiToolTreeEvent(event: Extract<CliTuiTimelineEvent, {
+    type: "tool_started" | "tool_result";
+}>, useColor: boolean): ReactNode;

package/dist/tui/timeline/tool-tree.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_BG_COLOR, TUI_ACCENT_COLOR, TUI_CHIP_TEXT_COLOR, TUI_TOOL_ERROR_COLOR, TUI_TOOL_SUCCESS_COLOR } from "../../design-tokens.js";
+import { TuiDiffStats } from "../diff-stats.js";
+import { cleanTuiToolSummary, getTuiDiffStats, getTuiToolLabel, getTuiToolLineParts } from "../format.js";
+import { TuiDiffBlock } from "../markdown/diff.js";
+/** 渲染工具徽标 chip：强调背景 + 深色粗体在活动与完成态持久显示；NO_COLOR 退化为纯方括号文本。 */
+function TuiToolBadge(props) {
+    if (!props.useColor)
+        return _jsx(Text, { children: props.badge });
+    return _jsx(Text, { backgroundColor: TUI_ACCENT_BG_COLOR, color: TUI_CHIP_TEXT_COLOR, bold: true, children: props.badge });
+}
+/** 按进度树展示工具：徽标持久强调，参数 chip 与徽标同行并右端截断，结果行保留 └─ 连线与 ✓/✗ 文字标签。 */
+export function renderTuiToolTreeEvent(event, useColor) {
+    if (event.type === "tool_started") {
+        const detail = cleanTuiToolSummary(event.toolName, event.summary).trim();
+        return (_jsx(Box, { flexDirection: "column", children: _jsxs(Text, { wrap: "truncate-end", children: ["├─ ", _jsx(TuiToolBadge, { badge: `[${getTuiToolLabel(event.toolName)}]`, useColor: useColor }), detail ? _jsxs(_Fragment, { children: [" ", _jsxs(Text, { color: useColor ? TUI_ACCENT_COLOR : undefined, children: ["[", detail, "]"] })] }) : null] }) }));
+    }
+    const diffStats = getTuiDiffStats(event.diff ? { text: event.diff } : undefined);
+    const parts = getTuiToolLineParts(event.toolName, event.summary, event.status, event.errorCode);
+    if (event.status !== "success") {
+        return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: useColor ? TUI_TOOL_ERROR_COLOR : undefined, children: `└─ ${parts.glyph ? `${parts.glyph} ` : ""}${parts.badge}${parts.rest}` }), event.diff ? _jsx(TuiDiffBlock, { diff: event.diff, keyPrefix: String(event.seq), useColor: useColor }) : null] }));
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["└─ ", _jsx(Text, { color: useColor ? TUI_TOOL_SUCCESS_COLOR : undefined, children: parts.glyph }), " ", _jsx(TuiToolBadge, { badge: parts.badge, useColor: useColor }), parts.rest, diffStats ? _jsxs(_Fragment, { children: [" ", _jsx(TuiDiffStats, { ...diffStats, useColor: useColor })] }) : null] }), event.diff ? _jsx(TuiDiffBlock, { diff: event.diff, keyPrefix: String(event.seq), useColor: useColor }) : null] }));
+}

package/dist/tui/timeline/turn-items.d.ts

@@ -0,0 +1,12 @@
+/** 合并既有 Presentation 与宿主输入位置，并读取每轮最后一次安全 Todo。 */
+import { type AgentPresentationState, type TimelineItem, type TodoSnapshotItem } from "@autopilot-agent/presentation";
+import type { CliTuiInputPosition, CliTuiTimelineEvent } from "../types.js";
+export type TuiHostInput = Extract<CliTuiTimelineEvent, {
+    type: "tui_input_consumed";
+}>;
+/** 保存当前可见事实的稳定边界，连续回答以字符位置保留输入前后的正文。 */
+export declare function captureTuiInputPosition(turnId: string | undefined, events: CliTuiTimelineEvent[], presentation?: AgentPresentationState): CliTuiInputPosition;
+/** 只采用该轮自身的最后一次 todo_updated；显式空列表保持清空语义。 */
+export declare function getTuiTurnTodo(events: CliTuiTimelineEvent[], turnId: string): TodoSnapshotItem | undefined;
+/** 按提交边界切分共享节点，再复用 selector 分组；宿主正文不会被后来的分组或回答吞到前面。 */
+export declare function getTuiTurnItems(presentation: AgentPresentationState, turnId: string, events: CliTuiTimelineEvent[]): Array<TimelineItem | TuiHostInput>;

package/dist/tui/timeline/turn-items.js

@@ -0,0 +1,28 @@
+/** 合并既有 Presentation 与宿主输入位置，并读取每轮最后一次安全 Todo。 */
+import { capturePresentationInputPosition, reducePresentationInput, selectTurnTimeline } from "@autopilot-agent/presentation";
+/** 保存当前可见事实的稳定边界，连续回答以字符位置保留输入前后的正文。 */
+export function captureTuiInputPosition(turnId, events, presentation) {
+    return { turnId, eventCount: events.filter(function publicEvent(event) { return event.type !== "tui_input_consumed"; }).length, items: presentation && turnId ? capturePresentationInputPosition(presentation, turnId).items : [] };
+}
+/** 只采用该轮自身的最后一次 todo_updated；显式空列表保持清空语义。 */
+export function getTuiTurnTodo(events, turnId) {
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index];
+        if (event?.type === "todo_updated" && event.turnId === turnId)
+            return { id: `todo:${turnId}`, kind: "todo", turnId, todos: event.todos, counts: event.counts };
+    }
+    return undefined;
+}
+/** 按提交边界切分共享节点，再复用 selector 分组；宿主正文不会被后来的分组或回答吞到前面。 */
+export function getTuiTurnItems(presentation, turnId, events) {
+    const inputs = events.filter(function host(event) { return event.type === "tui_input_consumed"; });
+    let state = presentation;
+    for (const input of inputs) {
+        state = reducePresentationInput(state, { kind: "host_event", event: { kind: "input", input: { turnId: input.turnId, inputId: input.inputId, delivery: input.delivery, content: input.content, position: input.position ?? { items: [] }, cancelled: input.cancelled, state: input.consumed === false ? "queued" : "consumed" } } });
+    }
+    const todo = getTuiTurnTodo(events, turnId);
+    // CLI 只采用本轮 events；不把恢复或 Session latest 误当作本轮更新。
+    state = { ...state, todosByTurn: { ...state.todosByTurn, [turnId]: todo ?? { id: `todo:${turnId}`, kind: "todo", turnId, todos: [], counts: { completed: 0, pending: 0, inProgress: 0 } } } };
+    const inputById = new Map(inputs.map(function pair(input) { return [input.inputId, input]; }));
+    return selectTurnTimeline(state, turnId).map(function host(item) { return item.kind === "input_notice" ? inputById.get(item.inputId) ?? item : item; });
+}

package/dist/tui/timeline/turn.d.ts

@@ -0,0 +1,19 @@
+/** 渲染当前 Turn；它会随安全事件更新，完成后整体进入历史树。 */
+import type { CliProjection, CliTurnStatus } from "../../types.js";
+import type { AgentPresentationState } from "@autopilot-agent/presentation";
+import type { CliTuiTimelineEvent, CliTuiTurnMetrics } from "../types.js";
+/** 渲染当前 Turn；memo 保证输入光标更新不会触发 live timeline 组件执行。 */
+export declare const TuiLiveTurn: import("react").NamedExoticComponent<{
+    turnId?: string;
+    events: CliTuiTimelineEvent[];
+    presentation?: AgentPresentationState;
+    pendingApproval?: CliProjection["pendingApproval"];
+    approvalSelectedIndex: number;
+    status: CliTurnStatus;
+    metrics?: CliTuiTurnMetrics;
+    useColor: boolean;
+    screenReader: boolean;
+    todoExpanded: boolean;
+    todoRowLimit?: number;
+    maximumWidth: number;
+}>;

package/dist/tui/timeline/turn.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/** 渲染当前 Turn；它会随安全事件更新，完成后整体进入历史树。 */
+import { memo } from "react";
+import { Box, Text } from "ink";
+import { TuiApprovalPrompt } from "../approval.js";
+import { formatTuiDuration, getTuiTerminationSummary, getTuiTurnFailureReason } from "../format.js";
+import { TuiLiveTimeline } from "./live.js";
+import { renderTuiPresentationTimeline } from "./presentation-timeline.js";
+import { TuiTodoList } from "../todo-list.js";
+import { getTuiTurnTodo } from "./turn-items.js";
+/** 渲染当前 Turn；memo 保证输入光标更新不会触发 live timeline 组件执行。 */
+export const TuiLiveTurn = memo(function TuiLiveTurn(props) {
+    if (!props.turnId || props.events.length === 0)
+        return null;
+    const hasPresentation = props.presentation?.items.some(function belongsToTurn(item) { return item.kind === "capability_notice" || ("turnId" in item && item.turnId === props.turnId); }) ?? false;
+    const failureReason = getTuiTurnFailureReason(props.events);
+    const terminationSummary = getTuiTerminationSummary(props.events, props.status);
+    return (_jsxs(Box, { flexDirection: "column", children: [props.presentation && hasPresentation
+                ? renderTuiPresentationTimeline(props.presentation, props.turnId, props.useColor, props.maximumWidth, { expanded: props.todoExpanded, screenReader: props.screenReader, rowLimit: props.todoRowLimit, showToggleHint: true, toolGroupsExpanded: props.todoExpanded }, props.events)
+                : _jsxs(_Fragment, { children: [_jsx(TuiLiveTimeline, { turnId: props.turnId, events: props.events, status: props.status, metrics: props.metrics, useColor: props.useColor, maximumWidth: props.maximumWidth }), getTuiTurnTodo(props.events, props.turnId) ? _jsx(TuiTodoList, { item: getTuiTurnTodo(props.events, props.turnId), expanded: props.todoExpanded || props.screenReader, screenReader: props.screenReader, useColor: props.useColor, columns: props.maximumWidth + 2, rowLimit: props.todoRowLimit, showToggleHint: true }) : null] }), terminationSummary ? _jsxs(Text, { children: ["\u7EC8\u6001\uFF1A", terminationSummary] }) : hasPresentation && failureReason ? _jsxs(Text, { children: ["\u539F\u56E0\uFF1A", failureReason] }) : null, props.pendingApproval ? _jsx(TuiApprovalPrompt, { pendingApproval: props.pendingApproval, selectedIndex: props.approvalSelectedIndex, useColor: props.useColor, screenReader: props.screenReader }) : null, props.metrics?.completedAt !== undefined ? _jsxs(Text, { dimColor: props.useColor, children: ["* Cogitated for ", formatTuiDuration(Math.max(0, props.metrics.completedAt - props.metrics.startedAt))] }) : null] }));
+});

package/dist/tui/todo-list.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Agent Todo 任务链的 CLI 视图：紧凑/展开两种形态共用同一份结构化行数据，
+ * Ink 动态区与备用屏视口都从这里取行，避免两套展示实现。
+ */
+import { type ReactNode } from "react";
+import type { TodoItem } from "@autopilot-agent/core";
+import { type AgentPresentationState, type TodoSnapshotItem } from "@autopilot-agent/presentation";
+/** Todo 行的状态与安全文本；样式由 Ink 或视口 spans 分别映射，hidden 行表示被截断的隐藏计数。 */
+export interface TuiTodoDisplayRow {
+    status: TodoItem["status"];
+    text: string;
+    hidden?: boolean;
+}
+/** Todo 视图的完整展示数据；紧凑态只有 header，展开态附任务行与隐藏计数。 */
+export interface TuiTodoDisplay {
+    header: string;
+    activeForm?: string;
+    rows: TuiTodoDisplayRow[];
+    hidden: number;
+}
+/** 取得 Todo 状态的中文文字标签，供 screen reader 与 NO_COLOR 场景朗读。 */
+export declare function getTuiTodoStatusLabel(status: TodoItem["status"]): string;
+/** 从共享 Presentation 读取当前 Turn 任务链的 in_progress activeForm，作为活动状态的稳定文案。 */
+export declare function getTuiTodoActiveForm(presentation: AgentPresentationState | undefined, turnId: string): string | undefined;
+/** 取得 Todo 状态的纯文本 glyph，颜色不是唯一状态载体。 */
+export declare function getTuiTodoStatusGlyph(status: TodoItem["status"]): string;
+/** 按显示宽度做 grapheme 安全截断，中英文与组合 emoji 不会截出半字。 */
+export declare function truncateTuiTodoText(text: string, maximumWidth: number): string;
+/** 按优先级（in_progress → 最近完成 → pending）在行数上限内挑选可见任务，保持原清单顺序展示。 */
+export declare function orderTuiTodoItems(todos: TodoItem[], limit?: number): {
+    shown: TodoItem[];
+    hidden: number;
+};
+/** 生成 Todo 视图的共享展示数据；紧凑态一行，展开态为 header + 任务行 + 隐藏计数。 */
+export declare function getTuiTodoDisplay(item: TodoSnapshotItem, options: {
+    expanded: boolean;
+    screenReader: boolean;
+    columns: number;
+    rowLimit?: number;
+}): TuiTodoDisplay | undefined;
+/** 渲染 Todo 任务链的 Ink 视图；screen reader 时每行前缀中文状态文字。 */
+export declare function TuiTodoList(props: {
+    item: TodoSnapshotItem;
+    expanded: boolean;
+    useColor: boolean;
+    screenReader: boolean;
+    columns: number;
+    rowLimit?: number;
+    showToggleHint?: boolean;
+}): ReactNode;