@epoch-agent/view 5.0.0 → 6.1.0

package/README.md

@@ -78,10 +78,14 @@
 
 ```bash
 pnpm --filter @epoch-agent/view test
-pnpm --filter @epoch-agent/view build   # tui / web 都从 dist 解析它，改完必须 build
+pnpm --filter @epoch-agent/view build   # 应用侧（vite build / tsx）从 dist 解析它
 ```
 
-> ⚠️ [web](../web) 和 [tui](../tui) 是按 package.json 的 `exports` 从**本包的 `dist/`**
-> 解析的。只改源码不 build，vite / tsx 那边看到的还是上一次的产物——症状是
-> `vite build` 报 `MISSING_EXPORT`，或者新加的字段在界面上永远不出现。
-> 根目录的 `pnpm build` 会自己排好顺序。
+> ⚠️ [web](../web) 和 [tui](../tui) 的**应用侧**（`vite build`、`tsx`）是按
+> package.json 的 `exports` 从**本包的 `dist/`** 解析的。只改源码不 build，那边看到的
+> 还是上一次的产物——症状是 `vite build` 报 `MISSING_EXPORT`，或者新加的字段在界面上
+> 永远不出现。根目录的 `pnpm build` 会自己排好顺序。
+>
+> ⚠️ **用例不是这一档**：web / tui 的 `vitest.config.ts` 把 `@epoch-agent/view`
+> alias 到 `src/index.ts`，所以 `pnpm test` 不需要先 build。判据和实测在那两份配置的
+> 注释里——那之前 `pnpm test` 读的是 `dist`，改了源码没重建时全绿但测的是旧代码。

package/dist/index.d.ts

@@ -47,6 +47,24 @@ interface HistoryItemBase {
      * 第一次调用）—— 用最后一帧会让回退目标往后漂。
      */
     seq?: number;
+    /**
+     * 这一项对应那条**落盘消息**的主键（`messages.id`）。
+     *
+     * ## 它和 `seq` / `HistoryItem.id` 都不是一回事
+     *
+     * | 钥匙 | 谁发的 | 什么时候有 | 活多久 |
+     * | --- | --- | --- | --- |
+     * | `seq` | 服务进程的全局信封计数器 | 直播 | 进程重启就从 1 重新数 |
+     * | `id`（`HistoryItem.id`） | 浏览器自己的目录计数器 | 直播和回放都有 | 一次补拉就可能换 |
+     * | `msgId` | 会话库的主键 | **只有回放** | 永远不变 |
+     *
+     * 靠它做成的是「跨页稳定锚点」：历史分页之后，同一句提问在服务端那侧永远是
+     * 同一个 `msgId`，而本地 `id` 会随前置页平移。右侧刻度条落在
+     * `data-rail="m<msgId>"` 上就是这一格（判据在 web 的 `thread/rail.ts`）。
+     *
+     * 缺席是常态：直播那条路上没有它（帧里不带落盘主键），TUI 也从不填。
+     */
+    msgId?: number;
 }
 type HistoryItemUser = HistoryItemBase & {
     type: 'user';
@@ -178,6 +196,22 @@ type HistoryItemThinking = HistoryItemBase & {
 type HistoryItemDiff = HistoryItemBase & {
     type: 'diff';
     filePath: string;
+    /**
+     * 产出这张补丁的那次调用（`tool-call` 的 `callId`）。
+     *
+     * 补丁帧自己不带它（protocol 的 `type: 'diff'` 只有路径和两边内容），而它在流里
+     * 恒排在产出者那次调用的 `tool-result` **之前**，引擎又是**一次调用一次地**跑工具
+     * （`core/src/agent/loop.ts` 那个 for 循环）—— 于是收帧那一刻还没收口的那一次调用
+     * 就是它的产出者，`reducer` 据此补上。
+     *
+     * 有了这一格，宿主才能把补丁认回**那一张**卡；没有就只剩「同一路径的第 k 张」，
+     * 中间夹一个也带着这个路径、却不写文件的调用（读、或者名字认不出来的 MCP 工具）
+     * 时就认错一张 —— 补丁从自己那张卡后面跳到前一张后面。
+     *
+     * ⚠️ **只有实时流里补得出来**：落盘的补丁项没有这一格（库表里就没有），所以
+     * 渲染层必须容忍它缺席。
+     */
+    callId?: string;
     oldContent?: string;
     newContent?: string;
     /**

package/dist/index.js

@@ -30,6 +30,17 @@ function patchTool(pending, callId, patch) {
   }
   return null;
 }
+function openCallId(pending) {
+  for (let i = pending.length - 1; i >= 0; i--) {
+    const item = pending[i];
+    if (item?.type !== "tool_group") continue;
+    for (let j = item.tools.length - 1; j >= 0; j--) {
+      const tool = item.tools[j];
+      if (tool?.status === "pending") return tool.callId;
+    }
+  }
+  return void 0;
+}
 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 };
@@ -88,7 +99,8 @@ function applyStreamEvent(state, event, meta) {
       });
       return next ? carry({ pending: next, thought }) : state;
     }
-    case "diff":
+    case "diff": {
+      const producer = openCallId(pending);
       return carry({
         pending: [
           ...pending,
@@ -97,11 +109,13 @@ function applyStreamEvent(state, event, meta) {
             filePath: event.filePath,
             ...event.oldContent !== void 0 ? { oldContent: event.oldContent } : {},
             ...event.newContent !== void 0 ? { newContent: event.newContent } : {},
+            ...producer !== void 0 ? { callId: producer } : {},
             ...anchor(meta)
           }
         ],
         thought
       });
+    }
     case "notice":
       return carry({
         pending: [...pending, { type: "info", text: event.text, ...anchor(meta) }],

package/package.json

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