@epoch-agent/view 0.1.0

package/LICENSE

@@ -0,0 +1,219 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+--------------------------------------------------------------------------------
+
+epoch-agent
+Copyright 2024-2026 bowen
+
+Portions of this software are derived from the Gemini CLI
+(https://github.com/google-gemini/gemini-cli), Copyright 2025 Google LLC,
+licensed under the Apache License, Version 2.0. Those files have been modified;
+each one retains its original copyright notice and SPDX-License-Identifier
+header. See the NOTICE file in the project source repository for the complete
+list of derived files.
+
+This software also quotes, with attribution, two lines of prose from OpenAI
+Codex (https://github.com/openai/codex), Copyright 2025 OpenAI, licensed under
+the Apache License, Version 2.0. No source file is a derived work of Codex.
+See the NOTICE file for details.

package/README.md

@@ -0,0 +1,42 @@
+# @epoch-agent/view
+
+展示层纯逻辑。把 `AgentEvent` 折叠成结构化的可渲染 item。
+
+- ✅ **做**：事件 → item 的折叠（`applyStreamEvent`）、diff 计算、这些 item 的类型
+- ❌ **不做**：任何组件、任何格式化、任何 I/O。既没有 `node:`，也没有 DOM
+- **依赖**：只有 [protocol](../protocol)
+
+## 存在的理由
+
+只有一条：[tui](../tui) 和 [web](../web) 必须共用同一份折叠逻辑。它修掉的三个语义错误
+——文本顺序、并行工具串台、reasoning 覆盖——两边都会踩，抄一份就是两份漂移。
+
+## 导出
+
+| 导出                                      | 说明                                                 |
+| ----------------------------------------- | ---------------------------------------------------- |
+| `applyStreamEvent(state, event)`          | 折叠一个 `AgentEvent`，返回新的 item 列表 + 变更信息 |
+| `diffLines(before, after)`                | 行级 diff                                            |
+| `collapseContext(lines)`                  | 把连续的未改动行折叠成 `@@` 摘要                     |
+| `DIFF_CONTEXT_LINES` / `DIFF_MAX_LINES`   | 折叠与截断的阈值                                     |
+| `HistoryItem*` / `ToolDisplayItem` 等类型 | item 的判别联合                                      |
+
+## 分界线
+
+> ⚠️ **这里进了 React 就说明分界画错了。** 真到那一步，该拆成 `view-core` + 各自的
+> 组件层，而不是往这里塞组件。
+
+`protocol` 的 `AgentEvent` 加成员时，这里的 reducer 要跟着处理，否则 TUI 和 Web 会
+静默丢事件。
+
+## 开发
+
+```bash
+pnpm --filter @epoch-agent/view test
+pnpm --filter @epoch-agent/view build   # tui / web 都从 dist 解析它，改完必须 build
+```
+
+> ⚠️ [web](../web) 和 [tui](../tui) 是按 package.json 的 `exports` 从**本包的 `dist/`**
+> 解析的。只改源码不 build，vite / tsx 那边看到的还是上一次的产物——症状是
+> `vite build` 报 `MISSING_EXPORT`，或者新加的字段在界面上永远不出现。
+> 根目录的 `pnpm build` 会自己排好顺序。

package/dist/index.d.ts

@@ -0,0 +1,257 @@
+import { ToolArtifact, AgentEvent } from '@epoch-agent/protocol';
+
+/**
+ * 展示项类型 — 基于 Google Gemini CLI types.ts
+ * @license Apache-2.0 (adapted from google-gemini/gemini-cli)
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ * Modifications Copyright 2024-2026 bowen
+ *
+ * ---
+ *
+ * 这些类型原来住在 `packages/tui/src/types/message-types.ts`。提到 `@epoch-agent/view`
+ * 是因为浏览器端要用同一套（方案 20 §7）：它们产出的是**结构化 display item**
+ * （`tool_group` / `diff` / 文本段），格式化在组件里，并不绑终端。
+ *
+ * `web` 不能依赖 `tui`（ink / react peer 会跟进浏览器包），所以落点是一个
+ * 两边都能依赖、且**只依赖 protocol** 的新包。晚一天提取，web 就只能先抄一份，
+ * 然后两份永远漂移。
+ *
+ * 本文件**不许**出现 node: 或 DOM 的东西 —— view 的 tsconfig 既不带
+ * `@types/node` 也不带 DOM lib，写了当场编译不过。
+ */
+
+interface HistoryItemBase {
+    text?: string;
+    /**
+     * 这一项**从哪一帧开始**的广播序号（`WireEnvelope.seq`）。
+     *
+     * 只是**锚点**，不渲染成文本：浏览器把它落在 `<li class="ev" data-seq>` 上，
+     * 三处真在用 —— 检视面板的产物行（「这个文件是哪一步产出的」）、回退（检查点）
+     * 的目标、URL 锚点。设计稿决定 2 在 2026-08-11 撤掉的是「每行都印一个三位数」
+     * 那个**形态**，不是这个字段。
+     *
+     * ⚠️ 三处它**没有值**，调用方必须当它可能不存在：
+     *   1. TUI —— 那边直接吃 `AgentEvent`，压根没有信封，也不需要锚点；
+     *   2. 回放（`GET /messages` 折出来的历史）—— 落盘的消息里没有 seq；
+     *   3. 一项由多帧合成时，取的是**第一帧**（正文的第一个增量、工具组的第一次
+     *      调用）。锚点要回答的是「从哪儿开始的」，用最后一帧会让回退目标往后漂。
+     */
+    seq?: number;
+}
+type HistoryItemUser = HistoryItemBase & {
+    type: 'user';
+    text: string;
+};
+/**
+ * 模型的回复正文。
+ *
+ * 判别值原来是 `'gemini'` —— 那是从 gemini-cli 抄过来的历史命名，在一个跑
+ * deepseek / anthropic / openai 的引擎里叫这个名字纯属误导。改成 `'assistant'`，
+ * 与 `EpochMessageRole` 对齐。
+ */
+type HistoryItemAssistant = HistoryItemBase & {
+    type: 'assistant';
+    text: string;
+};
+type HistoryItemInfo = HistoryItemBase & {
+    type: 'info';
+    text: string;
+    secondaryText?: string;
+    source?: string;
+    icon?: string;
+    color?: string;
+    marginBottom?: number;
+};
+type HistoryItemError = HistoryItemBase & {
+    type: 'error';
+    text: string;
+};
+type HistoryItemWarning = HistoryItemBase & {
+    type: 'warning';
+    text: string;
+};
+type HistoryItemModel = HistoryItemBase & {
+    type: 'model';
+    model: string;
+};
+/**
+ * 模型的思考原文。
+ *
+ * **默认不产出**：运行期只显示 `Thinking…` 状态行，reasoning 在内存里累加。
+ * 只有 `/thinking` 打开时，本轮结束才把它作为一条历史项落下来 ——
+ * 边流边显示等于每个 token 都触发一次整帧重绘，而且没人读得下去。
+ */
+type HistoryItemThinking = HistoryItemBase & {
+    type: 'thinking';
+    thought: string;
+};
+/** 补丁预览。oldContent / newContent 缺一边表示新建或删除 */
+type HistoryItemDiff = HistoryItemBase & {
+    type: 'diff';
+    filePath: string;
+    oldContent?: string;
+    newContent?: string;
+};
+type HistoryItemToolGroup = HistoryItemBase & {
+    type: 'tool_group';
+    tools: ToolDisplayItem[];
+    borderTop?: boolean;
+    borderBottom?: boolean;
+    borderColor?: string;
+    borderDimColor?: boolean;
+};
+type HistoryItemToolDisplayGroup = HistoryItemBase & {
+    type: 'tool_display_group';
+    tools: ToolDisplayItem[];
+};
+interface ToolDisplayItem {
+    callId: string;
+    toolName: string;
+    request: unknown;
+    status: 'pending' | 'done' | 'error';
+    result?: string;
+    /**
+     * 执行**期间**已经吐出来的输出（尾部若干行）。只在 `status === 'pending'` 时有值 ——
+     * `tool-result` 到达时会被清掉，由最终 `result` 顶上。
+     *
+     * 和 `result` 是**两个通道**且口径不同：这一份是「现在跑到哪了」的活尾巴，
+     * 已经剥过 ANSI、折叠过 `\r`、只保留尾部（见 protocol 的 `tool-output-delta`）；
+     * `result` 是喂给模型的那份最终文本。渲染层自己决定尾巴里再取几行。
+     */
+    liveOutput?: string;
+    /**
+     * 工具产出的二进制（截图 / 音频 / 文件）。
+     *
+     * 和 `result` 是**两个通道**：`result` 是喂给模型的那份文本（里面已经含了每个
+     * artifact 的 summary），这里是给人看的那份 —— 画缩略图行、按 Ctrl+O 打开。
+     * 见 protocol/src/events.ts 里 `tool-result` 的注释。
+     */
+    artifacts?: ToolArtifact[];
+}
+type HistoryItemCompression = HistoryItemBase & {
+    type: 'compression';
+    compressedCount: number;
+};
+type HistoryItemSessionSummary = HistoryItemBase & {
+    type: 'session_summary';
+    duration: string;
+};
+type HistoryItemHint = HistoryItemBase & {
+    type: 'hint';
+    text: string;
+};
+/** 联合类型（无 ID） */
+type HistoryItemWithoutId = HistoryItemUser | HistoryItemAssistant | HistoryItemInfo | HistoryItemError | HistoryItemWarning | HistoryItemModel | HistoryItemThinking | HistoryItemDiff | HistoryItemToolGroup | HistoryItemToolDisplayGroup | HistoryItemCompression | HistoryItemSessionSummary | HistoryItemHint;
+/** 完整历史项（带 ID） */
+type HistoryItem = HistoryItemWithoutId & {
+    id: number;
+};
+
+/**
+ * 流式事件 reducer —— 把 AgentEvent 折叠进 pending 消息列表。
+ *
+ * 抽成纯函数是为了能单测，也为了修掉原先散在 App.handleSubmit 里的三个语义错误：
+ *   1. text-delta 曾经 map 到**所有**文本项上，工具调用之后的文本会被追加进
+ *      第一段文本里，顺序错乱（文本跑到工具调用前面）。
+ *   2. tool-result 曾经把**所有** pending 工具一次性标记 done 并塞同一个 result，
+ *      多工具并行时结果串台。
+ *   3. reasoning-delta 曾经覆盖而非累加，思考过程只剩最后一个 chunk 的碎片。
+ *
+ * 事件类型来自 @epoch-agent/protocol。以前 TUI 自己定义一份 StreamEvent，
+ * 字段名和引擎不一样（args/isError vs input/success），靠 cli 里一段手写适配缝合；
+ * 而且协议里没有 callId，只能靠「toolName + 调用顺序」猜工具结果归属。现在
+ * callId 是一等字段，直接精确认领。
+ *
+ * 本文件原来住在 `packages/tui/src/streaming/reducer.ts`。提到 `@epoch-agent/view`
+ * 是因为它产出的是结构化 display item，格式化在组件里、**并不绑终端**，
+ * 浏览器端能原样用 —— 而它修掉的那三个语义错误，web 一样会踩。
+ */
+
+interface StreamReduceResult {
+    pending: HistoryItemWithoutId[];
+    /** 累加的 reasoning 文本（供状态栏显示） */
+    thought: string;
+}
+/**
+ * 这一帧信封上、`AgentEvent` 里没有的东西。
+ *
+ * 今天只有 `seq`（导轨的锚点，见 `HistoryItemBase.seq`）。做成一个对象而不是
+ * 第三个位置参数，是因为下一个要透的多半是 `ts`（回合耗时），而那时候再改签名
+ * 会动到 TUI 那边所有调用点 —— 它一个都不传，正好什么都不用改。
+ */
+interface StreamEventMeta {
+    /** `WireEnvelope.seq`。TUI 不传（它吃的是裸事件，没有信封） */
+    seq?: number;
+}
+/**
+ * 把一个事件折叠进当前状态。纯函数：不改入参，返回新数组。
+ *
+ * 不影响渲染的事件（turn-complete / finish / approval-request）原样返回同一个
+ * 引用，调用方可以用 `next === prev` 判断。
+ *
+ * `meta` 只有浏览器传（信封上的 `seq`）。**它只在新建项时落一次** ——
+ * 追加进已有项（正文的第二个增量、并进同一个工具组的第二次调用）时不覆盖，
+ * 否则锚点会跟着最后一帧往后漂，而回退要的是「从哪儿开始」。
+ */
+declare function applyStreamEvent(state: StreamReduceResult, event: AgentEvent, meta?: StreamEventMeta): StreamReduceResult;
+
+/**
+ * 行级 diff —— 纯函数，可单测。
+ *
+ * 协议里的 `diff` 事件带 `oldContent` / `newContent`（
+ * [protocol/events.ts](../../protocol/src/events.ts) 的 `type: 'diff'`），
+ * 旧版 TUI 把它渲染成一行「📝 补丁预览: a.ts」，两段内容直接扔了。
+ *
+ * 用经典 LCS 动态规划，**但有上限**：DP 表是 O(n·m)，几千行的文件会吃掉几十 MB
+ * 并且卡住渲染线程。超限就退回「N 行 → M 行」的摘要 —— 少显示细节可以接受，
+ * 界面卡死不行。
+ *
+ * ## 为什么住在 view 而不是 tui / web
+ *
+ * `diffLines` 原来在 `tui/src/streaming/`、`collapseContext` 原来在
+ * `tui/src/components/messages/diff-message.tsx`。Track B 落地时因为不能 import
+ * tui（ink / react 的 peer 会跟进浏览器包）而在 web 里各抄了一份**逐字副本**
+ * （连 `CONTEXT_LINES = 1` 都一样）。两份的漂移是真风险：改了一边忘了另一边，
+ * 终端和浏览器就会对同一个补丁画出不同的行数，而两边的用例各自都是绿的。
+ * 这里是两边都能依赖的地方（reducer 就在隔壁），并且这个文件**零依赖**——
+ * 没有 `node:`、没有 DOM、没有 React，符合本包的分界线。
+ *
+ * 留在各自组件里的**只有渲染约束**：终端没有滚动条，折叠完还要按可用高度硬裁到
+ * 固定行数并打一句「还有 N 行」；浏览器给 `max-height` + 内部滚动，一行不丢。
+ * 那不是 diff 语义，搬上来反而会让本包去关心它不该知道的终端高度。
+ */
+/** 超过这个行数就不做逐行 diff */
+declare const DIFF_MAX_LINES = 400;
+type DiffLineKind = 'add' | 'remove' | 'context';
+interface DiffLine {
+    kind: DiffLineKind;
+    text: string;
+}
+interface DiffResult {
+    lines: DiffLine[];
+    added: number;
+    removed: number;
+    /** true = 内容太大，没有逐行比，`lines` 为空 */
+    truncated: boolean;
+}
+/**
+ * 比较两段文本，产出带 add / remove / context 标记的行序列。
+ *
+ * 内容缺失（undefined）时按空串处理：新建文件只有 newContent，删除只有
+ * oldContent，两种都该显示成纯增 / 纯删而不是空 diff。
+ */
+declare function diffLines(oldContent?: string, newContent?: string): DiffResult;
+/** 变更行前后各保留几行上下文 */
+declare const DIFF_CONTEXT_LINES = 1;
+/**
+ * 把全量行序列压成「变更行 + 上下文」，被跳过的位置插入一个 `null` 当作省略号锚点。
+ *
+ * coding agent 的补丁大多是几行改动散落在几百行文件里，全量打印等于把屏幕冲掉。
+ * 省略的位置必须留锚点，让调用方画出 `⋯` —— **不静默吞掉**。
+ *
+ * 抽成纯函数是为了能直接对着数组断言，不用把组件渲染出来数行数。
+ */
+declare function collapseContext(lines: readonly DiffLine[], context?: number): Array<DiffLine | null>;
+
+export { DIFF_CONTEXT_LINES, DIFF_MAX_LINES, type DiffLine, type DiffLineKind, type DiffResult, type HistoryItem, type HistoryItemAssistant, type HistoryItemBase, type HistoryItemCompression, type HistoryItemDiff, type HistoryItemError, type HistoryItemHint, type HistoryItemInfo, type HistoryItemModel, type HistoryItemSessionSummary, type HistoryItemThinking, type HistoryItemToolDisplayGroup, type HistoryItemToolGroup, type HistoryItemUser, type HistoryItemWarning, type HistoryItemWithoutId, type StreamEventMeta, type StreamReduceResult, type ToolDisplayItem, applyStreamEvent, collapseContext, diffLines };

package/dist/index.js

@@ -0,0 +1,193 @@
+// src/reducer.ts
+function anchor(meta) {
+  return meta?.seq !== void 0 ? { seq: meta.seq } : {};
+}
+var LIVE_TAIL_LINES = 20;
+var LIVE_TAIL_CHARS = 4e3;
+function tailOf(text) {
+  const lines = text.split("\n");
+  const kept = lines.length > LIVE_TAIL_LINES ? lines.slice(-LIVE_TAIL_LINES) : lines;
+  const joined = kept.join("\n");
+  return joined.length > LIVE_TAIL_CHARS ? joined.slice(-LIVE_TAIL_CHARS) : joined;
+}
+function patchTool(pending, callId, patch) {
+  for (let i = pending.length - 1; i >= 0; i--) {
+    const item = pending[i];
+    if (item?.type !== "tool_group") continue;
+    const idx = item.tools.findIndex((t) => t.callId === callId);
+    if (idx === -1) continue;
+    const tools = [...item.tools];
+    tools[idx] = patch(tools[idx]);
+    const next = [...pending];
+    next[i] = { ...item, tools };
+    return next;
+  }
+  return null;
+}
+function applyStreamEvent(state, event, meta) {
+  const { pending, thought } = state;
+  switch (event.type) {
+    case "reasoning-delta":
+      return { 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 {
+        pending: [...pending, { type: "assistant", text: event.text, ...anchor(meta) }],
+        thought
+      };
+    }
+    case "tool-call": {
+      const tool = {
+        callId: event.callId,
+        toolName: event.toolName,
+        request: event.input,
+        status: "pending"
+      };
+      const last = pending[pending.length - 1];
+      if (last?.type === "tool_group") {
+        const next = [...pending];
+        next[next.length - 1] = { ...last, tools: [...last.tools, tool] };
+        return { pending: next, thought };
+      }
+      return {
+        pending: [...pending, { type: "tool_group", tools: [tool], ...anchor(meta) }],
+        thought
+      };
+    }
+    case "tool-output-delta": {
+      if (!event.text) return state;
+      const next = patchTool(pending, event.callId, (tool) => ({
+        ...tool,
+        liveOutput: tailOf((tool.liveOutput ?? "") + event.text)
+      }));
+      return next ? { pending: next, thought } : state;
+    }
+    case "tool-result": {
+      const next = patchTool(pending, event.callId, (tool) => {
+        const { liveOutput: _dropped, ...rest } = tool;
+        return {
+          ...rest,
+          status: event.ok ? "done" : "error",
+          result: event.output,
+          // 空数组也不要落下去：`artifacts: []` 和「没有产物」在渲染上没区别，
+          // 但会让 `formatArtifact` 那一层多一次判空
+          ...event.artifacts && event.artifacts.length > 0 ? { artifacts: event.artifacts } : {}
+        };
+      });
+      return next ? { pending: next, thought } : state;
+    }
+    case "diff":
+      return {
+        pending: [
+          ...pending,
+          {
+            type: "diff",
+            filePath: event.filePath,
+            ...event.oldContent !== void 0 ? { oldContent: event.oldContent } : {},
+            ...event.newContent !== void 0 ? { newContent: event.newContent } : {},
+            ...anchor(meta)
+          }
+        ],
+        thought
+      };
+    case "error":
+      return {
+        pending: [...pending, { type: "error", text: event.message || "\u9519\u8BEF", ...anchor(meta) }],
+        thought
+      };
+    case "run-start":
+    case "finish":
+    case "usage":
+    case "turn-complete":
+    case "approval-request":
+    case "question":
+      return state;
+    default: {
+      return state;
+    }
+  }
+}
+
+// src/diff-lines.ts
+var DIFF_MAX_LINES = 400;
+function splitLines(text) {
+  if (text === "") return [];
+  const lines = text.split("\n");
+  if (lines.length > 1 && lines[lines.length - 1] === "") lines.pop();
+  return lines;
+}
+function lcsTable(a, b) {
+  const table = Array.from(
+    { length: a.length + 1 },
+    () => new Uint32Array(b.length + 1)
+  );
+  for (let i = a.length - 1; i >= 0; i--) {
+    const row = table[i];
+    const next = table[i + 1];
+    for (let j = b.length - 1; j >= 0; j--) {
+      row[j] = a[i] === b[j] ? next[j + 1] + 1 : Math.max(next[j], row[j + 1]);
+    }
+  }
+  return table;
+}
+function diffLines(oldContent = "", newContent = "") {
+  const a = splitLines(oldContent);
+  const b = splitLines(newContent);
+  if (a.length > DIFF_MAX_LINES || b.length > DIFF_MAX_LINES) {
+    return { lines: [], added: b.length, removed: a.length, truncated: true };
+  }
+  const table = lcsTable(a, b);
+  const lines = [];
+  let added = 0;
+  let removed = 0;
+  let i = 0;
+  let j = 0;
+  while (i < a.length && j < b.length) {
+    if (a[i] === b[j]) {
+      lines.push({ kind: "context", text: a[i] });
+      i++;
+      j++;
+    } else if (table[i + 1][j] >= table[i][j + 1]) {
+      lines.push({ kind: "remove", text: a[i] });
+      removed++;
+      i++;
+    } else {
+      lines.push({ kind: "add", text: b[j] });
+      added++;
+      j++;
+    }
+  }
+  for (; i < a.length; i++, removed++) lines.push({ kind: "remove", text: a[i] });
+  for (; j < b.length; j++, added++) lines.push({ kind: "add", text: b[j] });
+  return { lines, added, removed, truncated: false };
+}
+var DIFF_CONTEXT_LINES = 1;
+function collapseContext(lines, context = DIFF_CONTEXT_LINES) {
+  const keep = /* @__PURE__ */ new Set();
+  lines.forEach((line, i) => {
+    if (line.kind === "context") return;
+    for (let k = i - context; k <= i + context; k++) {
+      if (k >= 0 && k < lines.length) keep.add(k);
+    }
+  });
+  const out = [];
+  let skipping = false;
+  lines.forEach((line, i) => {
+    if (keep.has(i)) {
+      out.push(line);
+      skipping = false;
+    } else if (!skipping) {
+      out.push(null);
+      skipping = true;
+    }
+  });
+  return out;
+}
+
+export { DIFF_CONTEXT_LINES, DIFF_MAX_LINES, applyStreamEvent, collapseContext, diffLines };

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@epoch-agent/view",
+  "version": "0.1.0",
+  "private": false,
+  "description": "epoch-agent 展示层纯逻辑：AgentEvent → 可渲染 item，tui 与 web 共用",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Ddbor/epoch-agent.git"
+  },
+  "license": "Apache-2.0",
+  "author": "epoch-agent",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@epoch-agent/protocol": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.6",
+    "typescript": "^5.8.3",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}