@autopilot-agent/cli 0.0.0-stage → 0.1.0

package/dist/tui/timeline/live.js

@@ -0,0 +1,151 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/** 动态时间线的增量缓存与渲染：只更新尾部事件或当前回答块，避免重扫全部事件。 */
+import { memo, useRef } from "react";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_COLOR } from "../../design-tokens.js";
+import { TUI_AGENT_LABEL } from "../constants.js";
+import { formatTuiDuration, formatTuiInputConsumed, getTuiApprovalDecisionLabel, isTerminalStatus } from "../format.js";
+import { TuiMarkdown } from "../markdown/markdown.js";
+import { renderTuiToolTreeEvent } from "./tool-tree.js";
+/** 为增量时间线生成稳定键，避免 answer delta 到达时重建历史节点。 */
+function getCliTuiTimelineEventKey(event) {
+    const inputId = "inputId" in event ? event.inputId : "";
+    const approvalId = "approvalId" in event ? event.approvalId : "";
+    return `${event.type}:${event.seq}:${event.turnId}:${inputId}:${approvalId}`;
+}
+/** 判断新事件列表是否只是同一 Turn 的尾部追加。 */
+function isCliTuiTimelineAppendOnly(cache, events) {
+    if (cache.eventCount === 0)
+        return true;
+    return events.length >= cache.eventCount && events[cache.eventCount - 1] === cache.lastEvent;
+}
+/** 应用一条时间线事件，只修改新增尾部或当前回答块。 */
+function appendCliTuiTimelineEvent(cache, event) {
+    if (event.type === "answer_delta") {
+        if (!event.delta)
+            return;
+        const lastBlock = cache.blocks[cache.blocks.length - 1];
+        if (lastBlock?.kind === "answer") {
+            lastBlock.answer += event.delta;
+            return;
+        }
+        cache.blocks.push({ kind: "answer", key: "answer:" + String(event.seq), answer: event.delta });
+        return;
+    }
+    if (event.type === "answer_reset") {
+        for (let index = cache.blocks.length - 1; index >= 0; index -= 1) {
+            if (cache.blocks[index]?.kind === "answer") {
+                cache.blocks.splice(index, 1);
+                break;
+            }
+        }
+    }
+    if (event.type === "tui_approval_submitted") {
+        for (const block of cache.blocks) {
+            if (block.kind === "event" && block.event.type === "approval_required" && block.event.approvalId === event.approvalId)
+                block.hidden = true;
+        }
+    }
+    cache.blocks.push({ kind: "event", key: getCliTuiTimelineEventKey(event), event });
+}
+/** 首次或 Turn 切换时完整归约时间线；后续更新走尾部增量路径。 */
+function createCliTuiTimelineCache(events) {
+    const cache = { eventCount: 0, blocks: [] };
+    for (const event of events)
+        appendCliTuiTimelineEvent(cache, event);
+    cache.eventCount = events.length;
+    cache.lastEvent = events[events.length - 1];
+    return cache;
+}
+/** 为当前 live Turn 复用已归约的时间线块，避免每个输入字符重扫全部事件。 */
+function useCliTuiTimelineBlocks(events) {
+    const cacheRef = useRef(undefined);
+    let cache = cacheRef.current;
+    if (!cache || !isCliTuiTimelineAppendOnly(cache, events)) {
+        cache = createCliTuiTimelineCache(events);
+    }
+    else {
+        for (let index = cache.eventCount; index < events.length; index += 1) {
+            const event = events[index];
+            if (event)
+                appendCliTuiTimelineEvent(cache, event);
+        }
+        cache.eventCount = events.length;
+        cache.lastEvent = events[events.length - 1];
+    }
+    cacheRef.current = cache;
+    return cache.blocks;
+}
+/** 渲染一个不再随连续 answer delta 改变的安全事件节点。 */
+function TuiLiveEventBlock(props) {
+    const event = props.event;
+    if (event.type === "tui_input_consumed") {
+        return _jsx(Text, { dimColor: props.useColor, children: formatTuiInputConsumed(event) });
+    }
+    if (event.type === "tui_approval_submitted") {
+        return _jsxs(Text, { dimColor: props.useColor, children: ["Approval submitted \u00B7 ", getTuiApprovalDecisionLabel(event.decision)] });
+    }
+    if (event.type === "turn_started" || event.type === "reasoning_summary" || event.type === "reasoning_hidden" || event.type === "answer_reset" || event.type === "input_joined" || event.type === "input_consumed" || event.type === "active_skills")
+        return null;
+    if (event.type === "tool_started" || event.type === "tool_result")
+        return renderTuiToolTreeEvent(event, props.useColor);
+    if (event.type === "approval_required")
+        return null;
+    if (event.type === "input_queued")
+        return _jsx(Text, { dimColor: props.useColor, children: "Additional instruction queued; waiting for the current step" });
+    if (event.type === "todo_updated")
+        return null;
+    if (event.type === "model_recovery")
+        return _jsxs(Text, { dimColor: props.useColor, children: ["Recovering \u00B7 ", event.reason] });
+    if (event.type === "context_overflow")
+        return _jsx(Text, { children: "Context limit reached; organizing before continuing" });
+    if (event.type === "context_compact_started")
+        return _jsx(Text, { dimColor: props.useColor, children: "Organizing context" });
+    if (event.type === "context_compacted")
+        return _jsx(Text, { children: "Context organized" });
+    if (event.type === "context_compact_failed")
+        return _jsx(Text, { children: "Context organization failed" });
+    if (event.type === "context_compact_circuit_open")
+        return _jsx(Text, { children: "Context organization temporarily unavailable" });
+    if (event.type === "status" && event.status === "failed" && event.reason)
+        return _jsxs(Text, { children: ["\u539F\u56E0\uFF1A", event.reason] });
+    if (event.type === "status")
+        return null;
+    return null;
+}
+/** 对历史事件节点启用 memo，使新增 answer delta 不重新执行工具/diff/审批渲染。 */
+const MemoizedTuiLiveEventBlock = memo(TuiLiveEventBlock);
+/** 渲染当前累计回答块；只有最后一个连续回答块会随 delta 更新。 */
+function TuiLiveAnswerBlock(props) {
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { bold: true, color: props.useColor ? TUI_ACCENT_COLOR : undefined, children: ["\u2022 ", TUI_AGENT_LABEL] }), props.renderMarkdown
+                ? _jsx(TuiMarkdown, { content: props.answer, keyPrefix: props.keyPrefix, useColor: props.useColor, maximumWidth: props.maximumWidth })
+                : _jsx(Text, { wrap: "wrap", children: props.answer })] }));
+}
+/** 对回答块启用 memo，保持长时间线中已经完成的 Markdown 节点不变。 */
+const MemoizedTuiLiveAnswerBlock = memo(TuiLiveAnswerBlock);
+/** 增量渲染当前 Turn 的时间线块；完整 transcript 由历史树使用 renderTimeline。 */
+function renderTuiLiveTimelineBlock(block, useColor, renderMarkdown, maximumWidth) {
+    if (block.kind === "answer") {
+        return _jsx(MemoizedTuiLiveAnswerBlock, { answer: block.answer, keyPrefix: block.key, useColor: useColor, renderMarkdown: renderMarkdown, maximumWidth: maximumWidth });
+    }
+    if (block.hidden)
+        return null;
+    if (block.event.type === "answer_delta")
+        return null;
+    return _jsx(MemoizedTuiLiveEventBlock, { event: block.event, useColor: useColor });
+}
+/**
+ * Ink 在动态区超过一屏后会清空终端并从顶部重绘；把已经确定的块交给
+ * 历史树后，动态区最多只保留当前回答或未决审批，避免活动期间
+ * 的每个事件都把 Windows Terminal 的原生滚动视口拉回顶部。
+ */
+export const TuiLiveTimeline = memo(function TuiLiveTimeline(props) {
+    const blocks = useCliTuiTimelineBlocks(props.events);
+    const firstAnswerKey = blocks.find(function findFirstAnswer(block) { return block.kind === "answer"; })?.key;
+    function renderBlock(block) {
+        return (_jsxs(Box, { flexDirection: "column", children: [block.key === firstAnswerKey && props.metrics?.firstAnswerAt !== undefined ? _jsxs(Text, { dimColor: props.useColor, children: ["Thought for ", formatTuiDuration(Math.max(0, props.metrics.firstAnswerAt - props.metrics.startedAt))] }) : null, renderTuiLiveTimelineBlock(block, props.useColor, isTerminalStatus(props.status), props.maximumWidth)] }, block.key));
+    }
+    return (_jsx(_Fragment, { children: blocks.map(function renderDynamicTimelineBlock(block) {
+            return renderBlock(block);
+        }) }));
+});

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

@@ -0,0 +1,14 @@
+/** 基于共享 Presentation selector 的 CLI 时间线；不读取旧工具 summary、detail 或审批 preview。 */
+import { type AgentPresentationState } from "@autopilot-agent/presentation";
+import { type ReactNode } from "react";
+/** 详情视图参数：expanded 驱动 Todo 卡展开，toolGroupsExpanded 驱动工具分组展开；screen reader 恒展开全部明细。 */
+type TuiDetailView = {
+    expanded: boolean;
+    screenReader: boolean;
+    rowLimit?: number;
+    showToggleHint?: boolean;
+    toolGroupsExpanded?: boolean;
+};
+/** 渲染指定 Turn 的共享 Presentation 时间线；无匹配节点时由调用方回退兼容旧事件。 */
+export declare function renderTuiPresentationTimeline(presentation: AgentPresentationState, turnId: string, useColor: boolean, maximumWidth: number, detailView: TuiDetailView): ReactNode[];
+export {};

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

@@ -0,0 +1,109 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/** 基于共享 Presentation selector 的 CLI 时间线；不读取旧工具 summary、detail 或审批 preview。 */
+import { getPresentationCopy, selectTimeline, 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_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 { TuiTodoList } from "../todo-list.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 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 === "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.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);
+        // 徽标 chip 两态：活动与完成步骤都持久使用强调背景 + 深色粗体，失败类终态整行用错误红。
+        const head = isFailedToolState(item.state)
+            ? _jsxs(Text, { color: useColor ? TUI_TOOL_ERROR_COLOR : undefined, children: [glyph, " [", title, "]"] })
+            : _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.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 ?? "需要确认";
+        return _jsxs(Text, { dimColor: useColor, children: ["\u26A0 ", detail, 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 === "todo")
+        return _jsx(TuiTodoList, { item: item, expanded: detailView.expanded, useColor: useColor, screenReader: detailView.screenReader, columns: maximumWidth, rowLimit: detailView.rowLimit, showToggleHint: detailView.showToggleHint }, 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: ["Input ", item.state, item.content ? ` · ${item.content}` : ""] }, 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) {
+    // 构建 callId 索引供展开分组取回组内调用；分组只按 callId 引用，不携带子节点事实。
+    const toolCallIndex = new Map(selectToolCalls(presentation, turnId).map(function indexToolCall(call) { return [call.callId, call]; }));
+    return selectTimeline(presentation)
+        .filter(function belongsToTurn(item) { return item.kind === "capability_notice" || ("turnId" in item && item.turnId === turnId); })
+        .map(function renderSharedTimelineItem(item) { 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,121 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { TUI_ACCENT_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";
+/** 将安全事件聚合为可读的时间线行，连续 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 });
+        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(_jsx(Text, { dimColor: useColor, children: formatTuiInputConsumed(event) }, String(event.seq) + ":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] }), _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") {
+            if (event.status === "failed" && event.reason)
+                nodes.push(_jsxs(Text, { children: ["\u539F\u56E0\uFF1A", event.reason] }, String(event.seq)));
+        }
+    }
+    flushAnswer();
+    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.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, 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 { TuiLiveProgressSummary } from "./progress.js";
+import { getTuiTodoActiveForm } from "../todo-list.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: [_jsx(TuiLiveProgressSummary, { events: props.events, status: props.status, metrics: props.metrics, useColor: props.useColor, activeTodoForm: getTuiTodoActiveForm(props.presentation, props.turnId) }), 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 })
+                : _jsx(TuiLiveTimeline, { turnId: props.turnId, events: props.events, status: props.status, metrics: props.metrics, useColor: props.useColor, maximumWidth: props.maximumWidth }), 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;