cc-viewer 1.7.0 → 1.7.1

package/src/utils/toolResultBuilder.js

@@ -0,0 +1,393 @@
+/**
+ * Incremental tool result state builder.
+ * Processes assistant tool_use and user tool_result blocks into lookup maps.
+ *
+ * NOTE: server_tool_use（如 Anthropic 的 web_search）和 web_search_tool_result 不入此 map，
+ * 它们由 ChatMessage.renderAssistantContent 直接从 assistant content 数组渲染。
+ * 详见 src/utils/webSearchGrouping.js 与 src/components/viewers/WebSearchResultsView.jsx。
+ */
+
+import { t } from '../i18n';
+import { buildSingleToolResultCore } from './toolResultCore.js';
+
+// --- WeakMap cache for tool result state ---
+
+const _toolResultCache = new WeakMap();
+
+// 稳定引用,避免 `req.body?.messages || []` 每次构造新 `[]` 字面量打穿 WeakMap 缓存
+// (subAgentEntries 扫描在每次 requests-change 时跑,缓存命中是热路径性能假设)。
+const EMPTY_MESSAGES = Object.freeze([]);
+
+export function getToolResultCache(messages) {
+  return _toolResultCache.get(messages) || null;
+}
+
+export function setToolResultCache(messages, state) {
+  _toolResultCache.set(messages, state);
+}
+
+
+// --- State builder ---
+
+const MAX_EDIT_SNAPSHOTS = 300;
+
+export function createEmptyToolState() {
+  return {
+    toolUseMap: {},
+    toolResultMap: {},
+    readContentMap: {},
+    editSnapshotMap: {},
+    askAnswerMap: {},
+    planApprovalMap: {},
+    latestPlanContent: null,
+    latestPlanFilePath: null,
+    _fileState: {},
+    _editOrder: [],
+  };
+}
+
+/**
+ * i18n 包装:在 toolResultCore 的 buildSingleToolResultCore 基础上附加本地化 label。
+ * 生产路径调用此函数;test 直接调 core 以避开 i18n 依赖。
+ */
+export function buildSingleToolResult(block, matchedTool) {
+  const core = buildSingleToolResultCore(block, matchedTool);
+  let label = t('ui.toolReturn');
+  if (matchedTool) {
+    if (matchedTool.name === 'Task' && matchedTool.input) {
+      const st = matchedTool.input.subagent_type || '';
+      const desc = matchedTool.input.description || '';
+      label = `SubAgent: ${st}${desc ? ' — ' + desc : ''}`;
+    } else {
+      label = t('ui.toolReturnNamed', { name: matchedTool.name });
+    }
+  }
+  return { label, ...core };
+}
+
+/**
+ * 全局聚合所有 requests 的 tool_result 块,按 tool_use_id 索引。
+ *
+ * 设计动机:并行 SubAgent / Teammate 的请求在日志中互相穿插,K+1 不一定是同一 agent
+ * 的下一个 turn。两遍扫描建立"id → result"全局索引,渲染时 O(1) 查询,免去运行时配对。
+ *
+ * Pass 1: 全量构建 toolUseMap(供 label / toolName / toolInput 解析)
+ *   - body.messages 里 role=assistant 的 tool_use 块
+ *   - response.body.content 里的 tool_use 块(末轮)
+ * Pass 2: 提取所有 tool_result 块写入索引(role=user 消息的 content[])
+ *
+ * id 冲突风险:Anthropic API 用 nanoid 24+ char,2^-128 量级,可忽略。
+ */
+export function buildGlobalToolResultIndex(requests) {
+  const state = createEmptyGlobalIndexState();
+  appendToGlobalToolResultIndex(state, requests, 0);
+  return state.index;
+}
+
+// 同一 session 内并发持有的 base64 image 上限:更早入索引的 entry 一旦超过此数,
+// 其 images 字段被改成 oversized 占位,释放 base64 字节(单图 2MB × N = 几十 MB
+// 常驻内存的隐患)。32 张覆盖大多数实际会话;若超过,旧图回退为占位,新图保留。
+const MAX_LIVE_IMAGE_ENTRIES = 32;
+
+/**
+ * 增量索引 state:供 ChatView / TeamModal 在 requests 增量到达时复用,避免每次全量扫描。
+ *   index           : { [tool_use_id]: entry } (出参,共享给调用方)
+ *   _useMap         : 已扫到的 tool_use 块 (Pass 1 累积,Pass 2 查 label)
+ *   _imageEntryIds  : FIFO 队列,跟踪持有 base64 image 的 entry id,超 MAX 时驱逐最早
+ */
+export function createEmptyGlobalIndexState() {
+  return { index: {}, _useMap: {}, _imageEntryIds: [] };
+}
+
+// 把超出 LRU 上限的最早 image entry 降级为 oversized 占位,释放 base64 字符串。
+function _enforceImageBudget(state) {
+  const { index, _imageEntryIds } = state;
+  while (_imageEntryIds.length > MAX_LIVE_IMAGE_ENTRIES) {
+    const evictId = _imageEntryIds.shift();
+    const entry = index[evictId];
+    if (!entry || !Array.isArray(entry.images)) continue;
+    entry.images = entry.images.map(img => (
+      img && img.src && !img.oversized
+        ? { oversized: true, mediaType: img.mediaType, sizeBytes: img.src.length }
+        : img
+    ));
+  }
+}
+
+/**
+ * 增量追加:扫描 requests[startIndex..] 并把新发现的 tool_use / tool_result 累积到 state。
+ * 仅写入新出现的 id(`!(id in index)`),原条目幂等,可重复调用同一切片不会引入副作用。
+ */
+export function appendToGlobalToolResultIndex(state, requests, startIndex) {
+  if (!Array.isArray(requests)) return;
+  const { index, _useMap, _imageEntryIds } = state;
+  for (let i = startIndex; i < requests.length; i++) {
+    const r = requests[i];
+    if (!r) continue;
+    const msgs = r.body?.messages;
+    if (Array.isArray(msgs)) {
+      for (const m of msgs) {
+        if (m?.role === 'assistant' && Array.isArray(m.content)) {
+          for (const b of m.content) {
+            if (b?.type === 'tool_use' && b.id) _useMap[b.id] = b;
+          }
+        }
+      }
+    }
+    const respContent = r.response?.body?.content;
+    if (Array.isArray(respContent)) {
+      for (const b of respContent) {
+        if (b?.type === 'tool_use' && b.id) _useMap[b.id] = b;
+      }
+    }
+  }
+  for (let i = startIndex; i < requests.length; i++) {
+    const r = requests[i];
+    const msgs = r?.body?.messages;
+    if (!Array.isArray(msgs)) continue;
+    for (const m of msgs) {
+      if (m?.role !== 'user' || !Array.isArray(m.content)) continue;
+      for (const b of m.content) {
+        if (b?.type === 'tool_result' && b.tool_use_id && !(b.tool_use_id in index)) {
+          const entry = buildSingleToolResult(b, _useMap[b.tool_use_id]);
+          index[b.tool_use_id] = entry;
+          if (Array.isArray(entry.images) && entry.images.some(img => img && img.src)) {
+            _imageEntryIds.push(b.tool_use_id);
+          }
+        }
+      }
+    }
+  }
+  _enforceImageBudget(state);
+}
+
+/**
+ * SubAgent / Teammate 渲染入口:组合本地 cachedBuildToolResultMap 与全局索引。
+ * globalIndex 由调用方一次性构建(buildGlobalToolResultIndex),所有 entry 共享,
+ * 渲染查询 O(1)。
+ *
+ * 补偿仅覆盖 toolResultMap;readContentMap / editSnapshotMap / latestPlanContent
+ * 等辅助 map 不在补偿范围内 —— SubAgent 卡片只渲染 response.content 块,Read snapshot
+ * 等高级展开由 mainAgent 路径消费,与 SubAgent 解耦。
+ */
+export function buildSubAgentResultMap(req, globalIndex) {
+  const localState = cachedBuildToolResultMap(req?.body?.messages || EMPTY_MESSAGES);
+  const respContent = req?.response?.body?.content;
+  if (!Array.isArray(respContent) || !globalIndex) {
+    return localState.toolResultMap;
+  }
+  // filled lazy-alloc 为 null sentinel:无补偿时返回原引用,避免下游 ChatMessage memo 抖动。
+  let filled = null;
+  for (const b of respContent) {
+    if (b?.type === 'tool_use' && b.id && !localState.toolResultMap[b.id] && globalIndex[b.id]) {
+      if (!filled) filled = {};
+      filled[b.id] = globalIndex[b.id];
+    }
+  }
+  if (!filled) return localState.toolResultMap;
+  return { ...localState.toolResultMap, ...filled };
+}
+
+export function appendToolResultMap(state, messages, startIndex) {
+  const { toolUseMap, toolResultMap, readContentMap, editSnapshotMap, askAnswerMap, planApprovalMap, _fileState } = state;
+  for (let i = startIndex; i < messages.length; i++) {
+    const msg = messages[i];
+    if (msg.role === 'assistant' && Array.isArray(msg.content)) {
+      for (const block of msg.content) {
+        if (block.type === 'tool_use') {
+          let parsed = block;
+          if (typeof block.input === 'string') {
+            try {
+              const cleaned = block.input.replace(/^\[object Object\]/, '');
+              parsed = { ...block, input: JSON.parse(cleaned) };
+            } catch {}
+          }
+          toolUseMap[parsed.id] = parsed;
+          // Write → .claude/plans/ 文件内容追踪
+          if (parsed.name === 'Write' && parsed.input?.file_path
+            && /[/\\]\.claude[/\\]plans[/\\]/.test(parsed.input.file_path) && parsed.input.content) {
+            state.latestPlanContent = parsed.input.content;
+          }
+          // ExitPlanMode V2: input 直接携带 plan + planFilePath（normalizeToolInput 注入）
+          // 不依赖前置 Write/Edit，是 multi-agent-room 等无前置场景的核心数据源
+          if (parsed.name === 'ExitPlanMode' && parsed.input && typeof parsed.input === 'object') {
+            if (typeof parsed.input.plan === 'string' && parsed.input.plan.trim()) {
+              state.latestPlanContent = parsed.input.plan;
+              state._planDirty = (state._planDirty || 0) + 1;
+            }
+            if (typeof parsed.input.planFilePath === 'string' && parsed.input.planFilePath) {
+              state.latestPlanFilePath = parsed.input.planFilePath;
+            }
+          }
+          // Edit → editSnapshotMap + _fileState 更新
+          if (parsed.name === 'Edit' && parsed.input) {
+            const fp = parsed.input.file_path;
+            const oldStr = parsed.input.old_string;
+            const newStr = parsed.input.new_string;
+            if (fp && oldStr != null && newStr != null && _fileState[fp]) {
+              const entry = _fileState[fp];
+              // 淘汰时留 null 占位：rebuild 时 key 已存在则跳过，避免重建已淘汰条目
+              if (!(parsed.id in editSnapshotMap)) {
+                editSnapshotMap[parsed.id] = { plainText: entry.plainText, lineNums: entry.lineNums.slice() };
+                state._editOrder.push(parsed.id);
+                if (state._editOrder.length > MAX_EDIT_SNAPSHOTS) {
+                  const evictId = state._editOrder.shift();
+                  editSnapshotMap[evictId] = null;
+                }
+              }
+              const idx = entry.plainText.indexOf(oldStr);
+              if (idx >= 0) {
+                const before = entry.plainText.substring(0, idx);
+                const lineOffset = before.split('\n').length - 1;
+                const oldLineCount = oldStr.split('\n').length;
+                const newLineCount = newStr.split('\n').length;
+                const lineDelta = newLineCount - oldLineCount;
+                entry.plainText = entry.plainText.substring(0, idx) + newStr + entry.plainText.substring(idx + oldStr.length);
+                if (lineDelta !== 0) {
+                  const startNum = entry.lineNums[lineOffset] || (lineOffset + 1);
+                  const newNums = [];
+                  for (let j = 0; j < newLineCount; j++) {
+                    newNums.push(startNum + j);
+                  }
+                  entry.lineNums = [
+                    ...entry.lineNums.slice(0, lineOffset),
+                    ...newNums,
+                    ...entry.lineNums.slice(lineOffset + oldLineCount).map(n => n + lineDelta),
+                  ];
+                }
+                // Edit plan 文件时同步 latestPlanContent（Write 只追踪全量写入，Edit 追踪增量编辑后的完整内容）
+                if (/[/\\]\.claude[/\\]plans[/\\]/.test(fp)) {
+                  state.latestPlanContent = entry.plainText;
+                }
+              }
+            }
+          }
+        }
+      }
+    } else if (msg.role === 'user' && Array.isArray(msg.content)) {
+      for (const block of msg.content) {
+        if (block.type === 'tool_result') {
+          const matchedTool = toolUseMap[block.tool_use_id];
+          const entry = buildSingleToolResult(block, matchedTool);
+          const { resultText, isPermissionDenied, isUltraplan } = entry;
+          toolResultMap[block.tool_use_id] = entry;
+          if (matchedTool && matchedTool.name === 'Read' && matchedTool.input?.file_path) {
+            readContentMap[matchedTool.input.file_path] = resultText;
+            // _fileState 更新（行号解析）
+            const readLines = resultText.split('\n');
+            const plainLines = [];
+            const lineNums = [];
+            for (const rl of readLines) {
+              const m = rl.match(/^\s*(\d+)[\t→](.*)$/);
+              if (m) {
+                lineNums.push(parseInt(m[1], 10));
+                plainLines.push(m[2]);
+              }
+            }
+            if (plainLines.length > 0) {
+              const existing = _fileState[matchedTool.input.file_path];
+              if (existing) {
+                const mergedMap = new Map();
+                const existingLines = existing.plainText.split('\n');
+                for (let j = 0; j < existing.lineNums.length; j++) {
+                  mergedMap.set(existing.lineNums[j], existingLines[j]);
+                }
+                for (let j = 0; j < lineNums.length; j++) {
+                  mergedMap.set(lineNums[j], plainLines[j]);
+                }
+                const sortedKeys = [...mergedMap.keys()].sort((a, b) => a - b);
+                _fileState[matchedTool.input.file_path] = {
+                  plainText: sortedKeys.map(k => mergedMap.get(k)).join('\n'),
+                  lineNums: sortedKeys,
+                };
+              } else {
+                _fileState[matchedTool.input.file_path] = { plainText: plainLines.join('\n'), lineNums };
+              }
+            }
+          }
+          if (matchedTool && matchedTool.name === 'AskUserQuestion') {
+            const parsed = parseAskAnswerText(resultText);
+            // 被拒绝的 AskUserQuestion：分 cancelled / rejected 两类——
+            //   - cancelled：cc-viewer 主动取消（Cancel 按钮 / 输入框打字打断）。
+            //     ask-bridge.js / sdk-manager.js 注入 reason 时统一加 [cc-viewer:cancel] 前缀
+            //     作为协议级 sentinel，前缀匹配比模糊文案匹配稳定（SDK 升级换文案不影响）。
+            //   - rejected：schema 校验失败 / hook deny 等"未触达"语义。
+            //   ChatMessage 用这两个 sentinel 区分渲染（cancelled 显式带 __cancelReason__ 灰态）。
+            if (Object.keys(parsed).length === 0 && isPermissionDenied) {
+              const looksCancelled = /\[cc-viewer:cancel\]/.test(resultText);
+              if (looksCancelled) {
+                // 截掉 [cc-viewer:cancel] 前缀只显示用户可读 reason，再 slice 200 防超长
+                const cleanedReason = resultText.replace(/^\s*\[cc-viewer:cancel\]\s*/, '').slice(0, 200);
+                askAnswerMap[block.tool_use_id] = { __cancelled__: true, __cancelReason__: cleanedReason };
+              } else {
+                askAnswerMap[block.tool_use_id] = { __rejected__: true };
+              }
+            } else {
+              askAnswerMap[block.tool_use_id] = parsed;
+            }
+            state._askDirty = (state._askDirty || 0) + 1;
+          }
+          if (matchedTool && matchedTool.name === 'ExitPlanMode') {
+            if (isPermissionDenied) {
+              const userSaid = resultText.match(/the user said:\s*([\s\S]*)/i);
+              planApprovalMap[block.tool_use_id] = {
+                status: isUltraplan ? 'ultraplan' : 'rejected',
+                feedback: userSaid ? userSaid[1].trim() : '',
+              };
+            } else {
+              planApprovalMap[block.tool_use_id] = parsePlanApproval(resultText);
+            }
+            state._planDirty = (state._planDirty || 0) + 1;
+            // Plan 审批完成（approved/rejected）后无条件重置 latestPlanContent / latestPlanFilePath，
+            // 防止下一个 plan 周期显示旧内容。已审批卡片的 V2 plan 渲染由 ChatMessage 的
+            // approval.planContent || inp.plan || planFileContents 兜底链承担，不依赖 latestPlanContent。
+            state.latestPlanContent = null;
+            state.latestPlanFilePath = null;
+          }
+        }
+      }
+    }
+  }
+}
+
+export function buildToolResultMap(messages) {
+  const state = createEmptyToolState();
+  appendToolResultMap(state, messages, 0);
+  return state;
+}
+
+export function cachedBuildToolResultMap(messages) {
+  let cached = _toolResultCache.get(messages);
+  if (!cached) {
+    cached = buildToolResultMap(messages);
+    _toolResultCache.set(messages, cached);
+  }
+  return cached;
+}
+
+/** 从 AskUserQuestion tool_result 文本中提取答案 map */
+export function parseAskAnswerText(text) {
+  const answers = {};
+  const re = /"([^"]+)"="([^"]*)"/g;
+  let m;
+  while ((m = re.exec(text)) !== null) {
+    answers[m[1]] = m[2];
+  }
+  return answers;
+}
+
+/** 从 ExitPlanMode tool_result 文本中解析审批状态和计划内容 */
+export function parsePlanApproval(text) {
+  if (!text) return { status: 'pending' };
+  if (/User has approved/i.test(text)) {
+    // Heading may carry a suffix before the colon, e.g. "## Approved Plan (edited by user):"
+    // (Claude Code CLI ≥2.1.201); [^\n]* keeps matching the plain "## Approved Plan:" form.
+    const planMatch = text.match(/##\s*Approved Plan[^\n]*:\s*\n([\s\S]*)/i);
+    return { status: 'approved', planContent: planMatch ? planMatch[1].trim() : '' };
+  }
+  if (/User rejected/i.test(text)) {
+    const feedbackMatch = text.match(/feedback:\s*(.+)/i) || text.match(/User rejected[^:]*:\s*(.+)/i);
+    return { status: 'rejected', feedback: feedbackMatch ? feedbackMatch[1].trim() : '' };
+  }
+  return { status: 'pending' };
+}

package/src/utils/toolResultClassifier.js

@@ -0,0 +1,16 @@
+// 孤儿 tool_use：assistant 调工具但 schema/Zod safeParse 在 PreToolUse hook 之前就抛了
+// InputValidationError——cc-viewer 看到 jsonl 里有 tool_use 块但底层 CLI 从未 spawn hook，
+// 用户既无法答也无法干预。区分于 isPermissionDenied（用户主动拒）：前者根因在 model schema
+// 与 runtime validator 不一致，后者是用户语义否决。
+//
+// 单独成文件让 Node test runner 可直接 import（toolResultBuilder.js 通过 helpers.js 拉了
+// SVG asset import，在 jsdom-less 环境无法加载）。
+export function classifyToolResultError(resultText, isError) {
+  const isPermissionDenied = isError && resultText
+    && /doesn't want to proceed|Permission.*denied|rejected.*tool use|interrupted by user for tool use/i.test(resultText);
+  const isInputValidationError = isError && resultText
+    && /InputValidationError|<tool_use_error>/i.test(resultText)
+    && !isPermissionDenied;
+  const isUltraplan = isPermissionDenied && resultText && /ultraplan/i.test(resultText);
+  return { isPermissionDenied, isInputValidationError, isUltraplan };
+}

package/src/utils/toolResultCore.js

@@ -0,0 +1,167 @@
+/**
+ * tool_result entry 的纯 JS 核心,无 i18n / SVG 依赖。
+ * 拆出独立模块是为了让 node --test 可直接 import(避开 helpers.js → SVG 的 vite-only 链)。
+ * 生产路径仍在 toolResultBuilder.js 通过 buildSingleToolResult 包装,补 i18n label。
+ */
+
+import { internToolResult } from './readResultPool.js';
+import { classifyToolResultError } from './toolResultClassifier.js';
+
+export function extractToolResultText(toolResult) {
+  if (!toolResult.content) return String(toolResult.content ?? '');
+  if (typeof toolResult.content === 'string') return toolResult.content;
+  if (Array.isArray(toolResult.content)) {
+    return toolResult.content
+      .filter(b => b.type === 'text')
+      .map(b => b.text)
+      .join('\n');
+  }
+  return JSON.stringify(toolResult.content);
+}
+
+// 白名单防恶意 JSONL 拼任意 MIME(svg+xml 在某些浏览器可嵌入脚本;text/html 应被
+// <img> 拒绝但日志污染仍可避免)。
+const SAFE_IMAGE_MIME = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);
+
+// base64 字符串长度上限(2MB ≈ 1.5MB 原图)。超限不渲染 <img>,降级为文字提示,
+// 避免每次 Popover 重渲染都构造几 MB src 字符串导致 React diff / 浏览器解码卡顿。
+const MAX_IMAGE_BASE64_LEN = 2 * 1024 * 1024;
+
+/**
+ * 提取 tool_result 内嵌的 image 块为可直接渲染的 src 列表(或大图占位)。
+ * Anthropic API 协议:Read 图片文件 / 截图等返回 `{type:'image', source: {type:'base64', media_type, data}}`,
+ * 也可能是 `{type:'url', url}`。
+ *
+ * 安全/性能:
+ *   - media_type 必须在白名单内,否则跳过
+ *   - base64 超过 MAX_IMAGE_BASE64_LEN 时,返回 { oversized: true, sizeBytes } 让 UI 降级显示
+ */
+export function extractToolResultImages(toolResult) {
+  if (!toolResult || !Array.isArray(toolResult.content)) return [];
+  const out = [];
+  for (const b of toolResult.content) {
+    if (!b || b.type !== 'image' || !b.source) continue;
+    const s = b.source;
+    if (s.type === 'base64' && typeof s.data === 'string' && s.data.length > 0 && typeof s.media_type === 'string') {
+      if (!SAFE_IMAGE_MIME.has(s.media_type)) continue;
+      if (s.data.length > MAX_IMAGE_BASE64_LEN) {
+        out.push({ oversized: true, mediaType: s.media_type, sizeBytes: Math.floor(s.data.length * 0.75) });
+        continue;
+      }
+      out.push({ src: `data:${s.media_type};base64,${s.data}`, mediaType: s.media_type });
+    } else if (s.type === 'url' && typeof s.url === 'string' && /^https?:\/\//.test(s.url)) {
+      out.push({ src: s.url, mediaType: 'image/url' });
+    }
+  }
+  return out;
+}
+
+// Workflow tool_result 文本固定以此句开头（后台启动即时返回，完成走单独的 task-notification）。
+const WF_LAUNCH_MARKER = 'Workflow launched in background';
+const WF_TASK_ID_RE = /Task ID:\s*([A-Za-z0-9_-]+)/;
+const WF_RUN_ID_RE = /Run ID:\s*(wf_[A-Za-z0-9_-]+)/;
+// Transcript dir / Script file 路径段：…/projects/<cwd 编码>/<sessionId(UUID)>/…
+const WF_SESSION_RE = /\/projects\/[^/\s]+\/([0-9a-fA-F-]{36})\//;
+
+/**
+ * 从 Workflow tool_result 原始文本解析定位线索。命中返回 { runId, taskId, sessionId }，
+ * 否则返回 null。sessionId 为全局唯一 UUID，足以让服务端 /api/workflow-journal 定位 journal
+ * 目录，无需 project hint。
+ *
+ * @param {string} txt - tool_result resultText 原文
+ * @returns {{ runId: string|null, taskId: string|null, sessionId: string|null } | null}
+ */
+export function parseWorkflowFromText(txt) {
+  if (typeof txt !== 'string' || txt.indexOf(WF_LAUNCH_MARKER) === -1) return null;
+  const taskId = (txt.match(WF_TASK_ID_RE) || [])[1] || null;
+  const runId = (txt.match(WF_RUN_ID_RE) || [])[1] || null;
+  const sessionId = (txt.match(WF_SESSION_RE) || [])[1] || null;
+  if (!runId && !taskId) return null;
+  return { runId, taskId, sessionId };
+}
+
+export function buildSingleToolResultCore(block, matchedTool) {
+  let toolName = null;
+  let toolInput = null;
+  if (matchedTool) {
+    toolName = matchedTool.name;
+    toolInput = matchedTool.input;
+  }
+  let resultText = extractToolResultText(block);
+  resultText = internToolResult(resultText);
+  const isError = !!block.is_error;
+  const { isPermissionDenied, isInputValidationError, isUltraplan } = classifyToolResultError(resultText, isError);
+  const images = extractToolResultImages(block);
+  // Workflow 工具：直接从原始 tool_result 文本解析 { runId, taskId, sessionId } 线索定位
+  // 并拉取 workflow run journal 渲染面板。线索原生存在于 wire 文本（"Workflow launched in
+  // background. Task ID: … / Run ID: wf_… / Transcript dir: …/projects/<cwd>/<sessionId>/…"），
+  // 不依赖服务端注入——历史日志（含未经 enrich 的旧日志）同样可识别。
+  // 回退：兼容旧路径已注入的 block._ccvWorkflow（服务端 enrich-workflow，仍用于 live）。
+  // 文本解析命中时补回 _ccvWorkflow 携带的 project（解析线索里没有），用于 journal 定位的精确消歧。
+  const parsedWf = parseWorkflowFromText(resultText);
+  const ccvWf = (block._ccvWorkflow && typeof block._ccvWorkflow === 'object') ? block._ccvWorkflow : null;
+  const workflow = parsedWf
+    ? { ...parsedWf, project: ccvWf?.project || null }
+    : ccvWf;
+  return { toolName, toolInput, resultText, isError, isPermissionDenied, isInputValidationError, isUltraplan, images, workflow };
+}
+
+const ANSI_ESCAPE = /\x1b\[[0-9;]*[A-Za-z]/g;
+const READ_LINE_PREFIX = /^\s*\d+[→\t](.*)$/;
+
+/**
+ * 紧凑模式 Popover 浮窗的 tool_result 预览:从 toolResultMap entry 生成截断文本。
+ *
+ * 返回 null 的场景(由 caller skip 渲染预览块):
+ *   - entry 不存在 / resultText 为空
+ *   - isPermissionDenied / isInputValidationError(外部已有红 badge,避免双显示)
+ *
+ * 工具特定清洗:
+ *   - Read:strip 行号前缀(`   123→content` → `content`)
+ *   - Bash:strip ANSI 转义(`\x1b[31mERROR\x1b[0m` → `ERROR`)
+ *
+ * 截断策略:行数上限 maxLines(默认 50,留够内容让 CSS max-height + overflow:auto 触发
+ * 滚动),每行字符上限 maxChars(默认 500,防止超长单行撑爆 popover)。
+ */
+export function compactResultPreview(entry, opts = {}) {
+  if (!entry || typeof entry !== 'object') return null;
+  if (entry.isPermissionDenied || entry.isInputValidationError) return null;
+
+  // 图片优先:Read 图片文件 / 截图等场景,images 数组非空则返回图片预览(text 可同时存在,作为辅助文本)
+  const images = Array.isArray(entry.images) ? entry.images : null;
+  const hasImages = images && images.length > 0;
+
+  const raw = entry.resultText;
+  const hasText = typeof raw === 'string' && raw.length > 0;
+  if (!hasImages && !hasText) return null;
+
+  const maxLines = opts.maxLines || 50;
+  const maxChars = opts.maxChars || 500;
+
+  let text = null;
+  if (hasText) {
+    let cleaned = raw;
+    if (entry.toolName === 'Bash') {
+      cleaned = cleaned.replace(ANSI_ESCAPE, '');
+    }
+    const lines = cleaned.split('\n');
+    const totalLines = lines.length;
+    const slice = lines.slice(0, maxLines);
+    const out = [];
+    for (let i = 0; i < slice.length; i++) {
+      let line = slice[i];
+      if (entry.toolName === 'Read') {
+        const m = line.match(READ_LINE_PREFIX);
+        if (m) line = m[1];
+      }
+      if (line.length > maxChars) line = line.slice(0, maxChars) + '…';
+      out.push(line);
+    }
+    text = out.join('\n');
+    if (totalLines > maxLines) text = text + '\n…';
+    if (text.trim().length === 0) text = null;
+  }
+
+  if (!hasImages && !text) return null;
+  return { text, images: hasImages ? images : null };
+}

package/src/utils/toolsDiff.js

@@ -0,0 +1,44 @@
+/**
+ * Tools diff —— 计算「当前请求 tools」相对「上一条 MainAgent 请求 tools」的新增/移除。
+ *
+ * 用于 ContextTab 的 tools 变化可视化(tools_search 等场景下 tools 列表逐请求变化)。
+ * 抽成纯函数:① 让渲染逻辑变短;② 统一 added/removed 的统计口径(均按唯一 name 计数,
+ * 不再 added 按数组、removed 按集合导致重名时口径不一致);③ 可独立单测。
+ *
+ * 约定:tool 按 name 比对(无 name 的 tool 不参与 diff);prevTools 非数组(无上一条 /
+ * 当前请求非 MainAgent)时视为「无可比对基线」,hasPrev=false、不产生任何 added/removed。
+ *
+ * @param {Array|undefined|null} prevTools 上一条请求的 tools 数组(可空)
+ * @param {Array|undefined|null} curTools  当前请求的 tools 数组
+ * @returns {{
+ *   hasPrev: boolean,            // 是否存在可比对基线
+ *   isAdded: (name: string) => boolean, // 某 name 是否为相对上一条新增
+ *   addedNames: string[],        // 新增的唯一 name 列表
+ *   removedNames: string[],      // 移除的唯一 name 列表(上一条有、当前没有)
+ *   addedCount: number,          // = addedNames.length
+ *   removedCount: number,        // = removedNames.length
+ *   changed: boolean,            // 是否有任何新增或移除
+ * }}
+ */
+export function computeToolsDiff(prevTools, curTools) {
+  const prevNameSet = Array.isArray(prevTools)
+    ? new Set(prevTools.map(t => t?.name).filter(Boolean))
+    : null;
+  const curNameSet = new Set(
+    (Array.isArray(curTools) ? curTools : []).map(t => t?.name).filter(Boolean),
+  );
+
+  const addedNames = prevNameSet ? [...curNameSet].filter(n => !prevNameSet.has(n)) : [];
+  const removedNames = prevNameSet ? [...prevNameSet].filter(n => !curNameSet.has(n)) : [];
+
+  return {
+    hasPrev: prevNameSet != null,
+    // 仅对有 name 且存在基线的 tool 判新增;无 name 无法按名比对,一律不标记
+    isAdded: (name) => prevNameSet != null && !!name && !prevNameSet.has(name),
+    addedNames,
+    removedNames,
+    addedCount: addedNames.length,
+    removedCount: removedNames.length,
+    changed: addedNames.length > 0 || removedNames.length > 0,
+  };
+}

package/src/utils/toolsXmlFormatter.js

@@ -0,0 +1,3 @@
+// Thin re-export: canonical implementation lives in server/lib/tools-xml-formatter.js
+// (no React deps, shared with server-side server/lib/kv-cache-analyzer.js).
+export { formatToolAsXml, formatToolsAsXml } from '../../server/lib/tools-xml-formatter.js';