@epoch-agent/view 3.0.0 → 3.1.2

package/dist/index.d.ts

@@ -208,6 +208,16 @@ type HistoryItemDiff = HistoryItemBase & {
     filePath: string;
     oldContent?: string;
     newContent?: string;
+    /**
+     * 内容太大、没存下来（2026-10-30）。
+     *
+     * 落盘那一侧对单侧内容设了上限（`runtime/src/turn-steps.ts` 的
+     * `MAX_DIFF_SIDE_BYTES`），超了的新旧内容一份都不存、只留路径和这一格。
+     *
+     * ⚠️ 渲染层遇到它要画一张**说清楚原因的降级卡**，不是空白、也不是一张
+     * 「整文件新增」的假补丁 —— 后者会在屏幕上冒充一个真实的改动。
+     */
+    omitted?: 'too-large';
 };
 type HistoryItemToolGroup = HistoryItemBase & {
     type: 'tool_group';
@@ -288,6 +298,38 @@ interface StreamReduceResult {
     pending: HistoryItemWithoutId[];
     /** 累加的 reasoning 文本（供状态栏显示） */
     thought: string;
+    /**
+     * 末尾那个工具组**已经封口**了 —— 下一次 `tool-call` 要新起一组（2026-10-30）。
+     *
+     * ## 它治的是「收口那一刻屏幕上的顺序和刷新之后不一样」
+     *
+     * `turn-complete` 是一个 ReAct 步的结束（`core/src/agent/loop.ts`，判据在
+     * `runtime/src/turn-steps.ts` 的文件头）。以前这一帧在 `applyStreamEvent` 里
+     * 是**空操作**，于是「第 1 步调了 todo、第 2 步调了 schedule_draft」这两次调用
+     * 被并进**同一个** `tool_group`。
+     *
+     * 而落盘是**一步一行**、回放按行走（`web/src/state/replay.ts` 的 `pushAssistant`），
+     * 刷出来的是两个分开的工具组。两条路对同一轮给出两种形状，后果不是「长得不一样」：
+     *
+     * 1. 步与步之间那几段思考的「位置」是 `pending.length`（`web/src/state/thought-parts.ts`
+     *    的 `trackThought`）。两个工具组合并成一个之后，两步之间想的那几段撞在**同一个
+     *    下标**上，被并成一段，还一起落到这个合并后的工具组**后面** ——
+     *    屏幕上就是「思考跑到三张工具卡下面去了」；
+     * 2. 收口那一刻（`session-state: idle`）照的就是这份合并过的 pending，于是
+     *    **同一轮在收口后、切走切回后、刷新后长成三种样子**。
+     *
+     * ## 为什么是一个标志而不是往 pending 里塞一样东西
+     *
+     * 往展示项里加「步边界」等于新增一种展示项，两个宿主都得跟着改（判据在
+     * `notice` 那一支的注释末尾）；而这两条路真正需要的只有一句话：
+     * **这一步的工具已经调完了**。它就落在这个标志上，不落在任何会被渲染的项上。
+     *
+     * ⚠️ **同一步之内的连续调用照旧合并**（`tool-call` 那一支的判据是
+     * `!state.sealed`）：一次模型请求里并行调三个工具，屏幕上仍然是一张卡 ——
+     * 那是 Gemini 的分组语义，回放的「一步一行」也是同一个口径（一条 assistant 行
+     * 带着它那一步的全部 `toolCalls`）。
+     */
+    sealed?: boolean;
 }
 /**
  * 这一帧信封上、`AgentEvent` 里没有的东西。
@@ -305,8 +347,14 @@ interface StreamEventMeta {
 /**
  * 把一个事件折叠进当前状态。纯函数：不改入参，返回新数组。
  *
- * 不影响渲染的事件（turn-complete / finish / approval-request）原样返回同一个
- * 引用，调用方可以用 `next === prev` 判断。
+ * **不改任何东西**的事件（`finish` / `usage` / `approval-request` / `question`，
+ * 以及末尾不是工具组时的 `turn-complete`）原样返回同一个引用，调用方可以用
+ * `next === prev` 判断。
+ *
+ * ⚠️ **`turn-complete` 2026-10-30 起可能返回新对象**：它要把末尾那个工具组封口
+ * （`StreamReduceResult.sealed`）。它仍然不改 `pending` 数组本身（引用不变），
+ * 只翻一个标志 —— 所以「`pending` 变了没有」和「`state` 变了没有」在这一帧上
+ * 是两个问题，别拿后者当前者。
  *
  * `meta` 只有浏览器传（信封上的 `seq`）。**它只在新建项时落一次** ——
  * 追加进已有项（正文的第二个增量、并进同一个工具组的第二次调用）时不覆盖，

package/dist/index.js

@@ -29,21 +29,22 @@ function patchTool(pending, callId, patch) {
 }
 function applyStreamEvent(state, event, meta) {
   const { pending, thought } = state;
+  const carry = (next) => state.sealed === void 0 || next.sealed !== void 0 ? next : { ...next, sealed: state.sealed };
   switch (event.type) {
     case "reasoning-delta":
-      return { pending, thought: thought + event.text };
+      return carry({ pending, thought: thought + event.text });
     case "text-delta": {
       if (!event.text) return state;
       const last = pending[pending.length - 1];
       if (last?.type === "assistant") {
         const next = [...pending];
         next[next.length - 1] = { ...last, text: last.text + event.text };
-        return { pending: next, thought };
+        return carry({ pending: next, thought });
       }
-      return {
+      return carry({
         pending: [...pending, { type: "assistant", text: event.text, ...anchor(meta) }],
         thought
-      };
+      });
     }
     case "tool-call": {
       const tool = {
@@ -53,14 +54,15 @@ function applyStreamEvent(state, event, meta) {
         status: "pending"
       };
       const last = pending[pending.length - 1];
-      if (last?.type === "tool_group") {
+      if (last?.type === "tool_group" && state.sealed !== true) {
         const next = [...pending];
         next[next.length - 1] = { ...last, tools: [...last.tools, tool] };
-        return { pending: next, thought };
+        return carry({ pending: next, thought });
       }
       return {
         pending: [...pending, { type: "tool_group", tools: [tool], ...anchor(meta) }],
-        thought
+        thought,
+        sealed: false
       };
     }
     case "tool-output-delta": {
@@ -69,7 +71,7 @@ function applyStreamEvent(state, event, meta) {
         ...tool,
         liveOutput: tailOf((tool.liveOutput ?? "") + event.text)
       }));
-      return next ? { pending: next, thought } : state;
+      return next ? carry({ pending: next, thought }) : state;
     }
     case "tool-result": {
       const next = patchTool(pending, event.callId, (tool) => {
@@ -81,10 +83,10 @@ function applyStreamEvent(state, event, meta) {
           ...event.artifacts && event.artifacts.length > 0 ? { artifacts: event.artifacts } : {}
         };
       });
-      return next ? { pending: next, thought } : state;
+      return next ? carry({ pending: next, thought }) : state;
     }
     case "diff":
-      return {
+      return carry({
         pending: [
           ...pending,
           {
@@ -96,26 +98,27 @@ function applyStreamEvent(state, event, meta) {
           }
         ],
         thought
-      };
+      });
     case "notice":
-      return {
+      return carry({
         pending: [...pending, { type: "info", text: event.text, ...anchor(meta) }],
         thought
-      };
+      });
     case "error":
-      return {
+      return carry({
         pending: [...pending, { type: "error", text: event.message, ...anchor(meta) }],
         thought
-      };
+      });
     case "steer":
-      return {
+      return carry({
         pending: [...pending, { type: "user", text: event.text, ...anchor(meta) }],
         thought
-      };
+      });
+    case "turn-complete":
+      return pending[pending.length - 1]?.type === "tool_group" ? { ...state, sealed: true } : state;
     case "run-start":
     case "finish":
     case "usage":
-    case "turn-complete":
     case "approval-request":
     case "question":
       return state;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/view",
-  "version": "3.0.0",
+  "version": "3.1.2",
   "private": false,
   "description": "epoch-agent 展示层纯逻辑：AgentEvent → 可渲染 item，tui 与 web 共用",
   "repository": {
@@ -22,7 +22,7 @@
     "dist"
   ],
   "dependencies": {
-    "@epoch-agent/protocol": "3.0.0"
+    "@epoch-agent/protocol": "3.1.2"
   },
   "devDependencies": {
     "tsup": "^8.3.6",