@epoch-agent/view 0.1.0 → 0.3.1

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ToolArtifact, AgentEvent } from '@epoch-agent/protocol';
+import { WireSessionReference, WireFileReference, WireImageReference, ToolArtifact, AgentEvent } from '@epoch-agent/protocol';
 
 /**
  * 展示项类型 — 基于 Google Gemini CLI types.ts
@@ -42,6 +42,72 @@ interface HistoryItemBase {
 type HistoryItemUser = HistoryItemBase & {
     type: 'user';
     text: string;
+    /**
+     * 这条消息里 `@:` 引用到的那几段会话（方案 53 PR-4）。
+     *
+     * **缺席 = 这条消息里没有引用**，不是「有但没查到」—— 后者是数组里一条带
+     * `omitted` 的记录（那五个稳定错误码之一）。
+     *
+     * ## 为什么它挂在**展示项**上，而不是让浏览器自己去翻 `parts`
+     *
+     * 这一格有**两个**填它的地方，而它们拿到的东西不一样：
+     *
+     * | 谁填                     | 从哪来                                  |
+     * | ------------------------ | --------------------------------------- |
+     * | 回放（`GET /messages`）  | 那条消息的 `parts` 里 `type: 'session'` |
+     * | 刚发出去那一条           | `POST /messages` 的 202 上那个 `references` |
+     *
+     * 后者压根没有 `parts`（用户自己那条消息是本地乐观回显的，SSE 上不回它）。
+     * 两条路合到这一格之后，那张卡的渲染只有一处 —— 而它们要是各画一次，
+     * 刷新前后的同一条消息会长得不一样。
+     *
+     * ⚠️ **带不带正文这件事在契约那一层就定了**：`WireSessionReference` 是那个部件
+     * **摘掉 `text`**（判据在 protocol 的 `wire-rest.ts` 上），所以这一格上永远
+     * 没有另一段会话的转录 —— 那也是「这张卡不展开」的由来
+     * （`web/src/mention/reference-card.tsx` 的文件头）。
+     *
+     * TUI 那一侧今天不画它（方案 53 验收记录第六章：发出去之后屏幕上就是用户打的
+     * 那行字），所以这一格在那边恒缺席 —— 那是一次判断，不是漏接。
+     */
+    references?: readonly WireSessionReference[];
+    /**
+     * 这条消息里 `@路径` 附上的那几个文件（方案 63）。
+     *
+     * 缺席 / 两条路合到一格 / 不带正文的那三条判据**逐字同**上面 `references` 那一
+     * 格（`WireFileReference` 就是那个部件摘掉 `text`），这一格不再抄一遍。
+     * 差别只有填它的那个键：回放从 `parts` 里 `type: 'file'` 读，刚发出去那一条从
+     * 202 的 `files` 读（键不同、判据同一条）。
+     */
+    files?: readonly WireFileReference[];
+    /**
+     * 这条消息里附的那几张图（2026-09-01）。
+     *
+     * ## 这一格是 `state/types.ts` 和 `state/replay.ts` 记的同一笔债
+     *
+     * 两处逐字写着「`@epoch-agent/view` 的展示项里根本没有『图片』这一类，
+     * 真要画缩略图得先往 view 加类型」。这就是那次加类型。
+     *
+     * 在它之前，用户自己那条带图的消息在界面上是一行**文本占位符**
+     * （`[图片 image/jpeg]`，`contentToDisplayText` 的口径）—— 屏幕上说
+     * 「这里有张图」，但人看不到那张图，而它明明就在服务端的 artifact 目录里、
+     * 也已经有一个能取到它的端点。
+     *
+     * 缺席 / 两条路合到一格那两条判据**逐字同**上面 `references`：
+     *
+     * | 谁填 | 从哪来 |
+     * | --- | --- |
+     * | 回放（`GET /messages`） | 那条消息的 `parts` 里 `type: 'image'`（`image` 是服务端路径） |
+     * | 刚发出去那一条 | 浏览器自己刚读的那个文件（`image` 是 `data:` URL） |
+     *
+     * ⚠️ **和上面两格的区别：这一格带「内容」**。`WireImageReference` 只摘了 `type`、
+     * **没摘 `image`** —— 因为界面要的就是那张图。但那一格永远是**引用**
+     * （路径 / http URL / 本地 data URL），服务端绝不在这条线上发 base64，
+     * 判据全文在 `WireImageReference` 上。
+     *
+     * TUI 那一侧恒缺席 —— 终端里画不了图，它照旧走文本占位（同 `references`
+     * 那一格的处置，是一次判断不是漏接）。
+     */
+    images?: readonly WireImageReference[];
 };
 /**
  * 模型的回复正文。

package/dist/index.js

@@ -75,8 +75,6 @@ function applyStreamEvent(state, event, meta) {
           ...rest,
           status: event.ok ? "done" : "error",
           result: event.output,
-          // 空数组也不要落下去：`artifacts: []` 和「没有产物」在渲染上没区别，
-          // 但会让 `formatArtifact` 那一层多一次判空
           ...event.artifacts && event.artifacts.length > 0 ? { artifacts: event.artifacts } : {}
         };
       });
@@ -96,9 +94,14 @@ function applyStreamEvent(state, event, meta) {
         ],
         thought
       };
+    case "notice":
+      return {
+        pending: [...pending, { type: "info", text: event.text, ...anchor(meta) }],
+        thought
+      };
     case "error":
       return {
-        pending: [...pending, { type: "error", text: event.message || "\u9519\u8BEF", ...anchor(meta) }],
+        pending: [...pending, { type: "error", text: event.message, ...anchor(meta) }],
         thought
       };
     case "run-start":
@@ -113,7 +116,6 @@ function applyStreamEvent(state, event, meta) {
     }
   }
 }
-
 // src/diff-lines.ts
 var DIFF_MAX_LINES = 400;
 function splitLines(text) {

package/package.json

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