@steerable/agent-shell-web 0.6.15

package/src/components/chat/UnifiedDiff.tsx

@@ -0,0 +1,31 @@
+/**
+ * UnifiedDiff — render a unified diff string (from local_edit_file's
+ * `result.diff`) with per-line colouring. Host-layer renderer plugged into
+ * ToolExecutionCard's `renderOutput` slot; the framework card stays generic.
+ */
+export function UnifiedDiff({ diff }: { diff: string }) {
+  const lines = diff.split('\n');
+  return (
+    <pre className="overflow-x-auto rounded bg-agent-muted/40 px-2 py-1.5 font-mono text-[11px] leading-relaxed">
+      {lines.map((line, i) => {
+        let cls = 'text-agent-foreground';
+        if (line.startsWith('@@')) {
+          cls = 'text-agent-muted-foreground';
+        } else if (line.startsWith('+++') || line.startsWith('---')) {
+          cls = 'font-semibold text-agent-muted-foreground';
+        } else if (line.startsWith('+')) {
+          cls = 'bg-emerald-500/10 text-emerald-700 dark:text-emerald-400';
+        } else if (line.startsWith('-')) {
+          cls = 'bg-rose-500/10 text-rose-700 dark:text-rose-400';
+        }
+        return (
+          <div key={i} className={cls}>
+            {line === '' ? ' ' : line}
+          </div>
+        );
+      })}
+    </pre>
+  );
+}
+
+export default UnifiedDiff;

package/src/components/chat/UserMessage.tsx

@@ -0,0 +1,155 @@
+import { useLayoutEffect, useRef, useState } from 'react';
+import { motion } from 'framer-motion';
+import { LuChevronDown, LuChevronUp, LuCheck, LuCopy } from 'react-icons/lu';
+import type { ChatMessage } from '@steerable/agent-protocol';
+import type { LocalChat, LocalChatAgent } from '@/lib/local-api';
+import { useSlashSources } from '@/lib/slash-sources';
+import { Markdown } from './Markdown';
+import { getFriendlyDate } from './timestamp';
+import { useCopy } from './useCopy';
+
+/**
+ * UserMessage — port of `deeppath`'s user-bubble component, trimmed to the
+ * agent-only surface.
+ *
+ * Differences vs the original:
+ *   - **No RefCards.** Local-backend messages don't carry the `messageMetadata.refs`
+ *     array used by the cloud product to attach goal/task/event/document refs;
+ *     when we eventually want this for agent (e.g. uploaded files), it'll go
+ *     here.
+ *   - **No edit button.** The cloud product's `editChatMessage` rewrites the
+ *     SSE turn in place — we don't have that machinery yet. Tracking under
+ *     phase 2c.
+ *   - **No mentioned-agent chip / inline `ref://` / `tool://` / `agent://`
+ *     parsing.** Agent-only mode doesn't surface multi-agent mentions or
+ *     pinned-ref shortcuts, so the markdown content is rendered directly.
+ *
+ * What we KEEP from the old version (and why it matters for parity):
+ *   - Left-aligned bubble (not right-aligned). The product chat layout stacks
+ *     both user + assistant bubbles flush-left in a vertical column — this is
+ *     the most visible "feel" difference vs a typical chat UI.
+ *   - Bubble background uses the secondary muted token so it sits a notch
+ *     above the canvas without competing with assistant bubbles.
+ *   - 4.5em fold + gradient mask + 「展开全部 / 收起」 toggle so a wall-of-text
+ *     user prompt doesn't steal the whole viewport before the assistant
+ *     replies.
+ *   - Friendly timestamp at bottom-right.
+ *   - `framer-motion` fade/slide-in on mount.
+ */
+
+interface UserMessageProps {
+  message: ChatMessage;
+  agents?: LocalChatAgent[];
+  chats?: LocalChat[];
+}
+
+export function UserMessage({ message, agents = [], chats = [] }: UserMessageProps) {
+  const content = message.content || '';
+  // 发出去的消息里 `/技能` `/mcp__srv__tool` 要和输入框里同样渲染成工具卡片。
+  // 目录来自共享缓存，整屏消息只拉一次。
+  const { skills, mcpTools } = useSlashSources();
+
+  const [isExpanded, setIsExpanded] = useState(false);
+  const [isOverflowing, setIsOverflowing] = useState(false);
+  const contentRef = useRef<HTMLDivElement>(null);
+  const { copied, copy } = useCopy(content);
+
+  useLayoutEffect(() => {
+    const el = contentRef.current;
+    if (!el || isExpanded) return;
+    setIsOverflowing(el.scrollHeight > el.clientHeight + 1);
+  }, [content, isExpanded]);
+
+  return (
+    <motion.div
+      className="group/message mb-2"
+      data-message-role="user"
+      data-message-id={message.id}
+      initial={{ opacity: 0, y: 20 }}
+      animate={{ opacity: 1, y: 0 }}
+      transition={{ duration: 0.3 }}
+    >
+      <div className="flex justify-start">
+        <div className="mx-auto w-full max-w-[var(--chat-input-box-width)] rounded-lg border border-agent-border bg-agent-muted p-3 text-sm text-agent-foreground">
+          <div className="relative">
+            <div
+              ref={contentRef}
+              className={`markdown-content pl-1 ${
+                !isExpanded ? 'overflow-hidden' : ''
+              }`}
+              style={!isExpanded ? { maxHeight: '4.5em' } : undefined}
+            >
+              {content ? (
+                <Markdown
+                  inlineParagraph
+                  agents={agents}
+                  chats={chats}
+                  skills={skills}
+                  mcpTools={mcpTools}
+                >
+                  {content}
+                </Markdown>
+              ) : (
+                <div className="h-4" />
+              )}
+            </div>
+            {!isExpanded && isOverflowing && (
+              <div className="pointer-events-none absolute bottom-0 left-0 right-0 h-5 bg-gradient-to-t from-agent-muted to-transparent" />
+            )}
+          </div>
+
+          {isOverflowing && (
+            <button
+              type="button"
+              onClick={(event) => {
+                event.stopPropagation();
+                setIsExpanded((prev) => !prev);
+              }}
+              className="mt-1 inline-flex items-center gap-0.5 text-xs text-agent-muted-foreground transition-colors hover:text-agent-foreground"
+            >
+              {isExpanded ? (
+                <>
+                  收起
+                  <LuChevronUp className="h-3 w-3" />
+                </>
+              ) : (
+                <>
+                  展开全部
+                  <LuChevronDown className="h-3 w-3" />
+                </>
+              )}
+            </button>
+          )}
+
+          <div className="mt-2 flex items-center justify-between">
+            <button
+              type="button"
+              onClick={() => void copy()}
+              className="inline-flex items-center gap-0.5 rounded text-xs text-agent-muted-foreground opacity-0 transition-all duration-200 hover:text-agent-foreground focus:opacity-100 group-hover/message:opacity-100"
+              title={copied ? '已复制' : '复制消息'}
+              aria-label={copied ? '已复制' : '复制消息'}
+            >
+              {copied ? (
+                <>
+                  <LuCheck className="h-3 w-3 text-emerald-600 dark:text-emerald-400" />
+                  <span className="text-emerald-600 dark:text-emerald-400">
+                    已复制
+                  </span>
+                </>
+              ) : (
+                <LuCopy className="h-3 w-3" />
+              )}
+            </button>
+            <div className="text-[13px] text-agent-muted-foreground">
+              {message.createdAt
+                ? getFriendlyDate(new Date(message.createdAt))
+                : getFriendlyDate(new Date())}
+            </div>
+          </div>
+        </div>
+      </div>
+    </motion.div>
+  );
+}
+
+export default UserMessage;

package/src/components/chat/elapsed.test.ts

@@ -0,0 +1,42 @@
+import { describe, expect, it } from 'vitest';
+import {
+  formatElapsedCompact,
+  inferDurationMs,
+  readPersistedDurationMs,
+} from './elapsed';
+
+describe('formatElapsedCompact', () => {
+  it('matches Codex compact elapsed', () => {
+    expect(formatElapsedCompact(0)).toBe('0s');
+    expect(formatElapsedCompact(999)).toBe('0s');
+    expect(formatElapsedCompact(1_000)).toBe('1s');
+    expect(formatElapsedCompact(12_000)).toBe('12s');
+    expect(formatElapsedCompact(59_000)).toBe('59s');
+    expect(formatElapsedCompact(60_000)).toBe('1m 00s');
+    expect(formatElapsedCompact(61_000)).toBe('1m 01s');
+    expect(formatElapsedCompact(83_000)).toBe('1m 23s');
+    expect(formatElapsedCompact(3_605_000)).toBe('1h 00m 05s');
+    expect(formatElapsedCompact(90_122_000)).toBe('25h 02m 02s');
+  });
+});
+
+describe('readPersistedDurationMs', () => {
+  it('reads a finite non-negative duration from assistant metadata', () => {
+    expect(readPersistedDurationMs(JSON.stringify({ durationMs: 83000 }))).toBe(83000);
+    expect(readPersistedDurationMs(JSON.stringify({ durationMs: 0 }))).toBe(0);
+    expect(readPersistedDurationMs(JSON.stringify({}))).toBeUndefined();
+    expect(readPersistedDurationMs(JSON.stringify({ durationMs: -1 }))).toBeUndefined();
+    expect(readPersistedDurationMs('{')).toBeUndefined();
+    expect(readPersistedDurationMs(null)).toBeUndefined();
+  });
+});
+
+describe('inferDurationMs', () => {
+  it('subtracts the user timestamp from the assistant timestamp', () => {
+    expect(
+      inferDurationMs('2026-09-08T12:00:00.000Z', '2026-09-08T12:01:23.000Z'),
+    ).toBe(83_000);
+    expect(inferDurationMs('2026-09-08T12:00:00.000Z', '2026-09-08T11:59:00.000Z')).toBeUndefined();
+    expect(inferDurationMs(undefined, '2026-09-08T12:00:00.000Z')).toBeUndefined();
+  });
+});

package/src/components/chat/elapsed.ts

@@ -0,0 +1,45 @@
+/**
+ * Codex-style compact elapsed time for the turn-process disclosure.
+ * Examples: 0s, 12s, 1m 00s, 1m 23s, 1h 02m 03s.
+ */
+
+export function formatElapsedCompact(elapsedMs: number): string {
+  const elapsedSecs = Math.max(0, Math.floor(elapsedMs / 1000));
+  if (elapsedSecs < 60) return `${elapsedSecs}s`;
+  if (elapsedSecs < 3600) {
+    const minutes = Math.floor(elapsedSecs / 60);
+    const seconds = elapsedSecs % 60;
+    return `${minutes}m ${String(seconds).padStart(2, '0')}s`;
+  }
+  const hours = Math.floor(elapsedSecs / 3600);
+  const minutes = Math.floor((elapsedSecs % 3600) / 60);
+  const seconds = elapsedSecs % 60;
+  return `${hours}h ${String(minutes).padStart(2, '0')}m ${String(seconds).padStart(2, '0')}s`;
+}
+
+export function readPersistedDurationMs(
+  metadataJson: string | null | undefined,
+): number | undefined {
+  if (!metadataJson) return undefined;
+  try {
+    const parsed = JSON.parse(metadataJson) as { durationMs?: unknown };
+    if (typeof parsed.durationMs !== 'number' || !Number.isFinite(parsed.durationMs)) {
+      return undefined;
+    }
+    return parsed.durationMs >= 0 ? parsed.durationMs : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+/** Wall-clock from a user prompt timestamp to the assistant reply timestamp. */
+export function inferDurationMs(
+  startIso: string | undefined,
+  endIso: string | undefined,
+): number | undefined {
+  if (!startIso || !endIso) return undefined;
+  const start = Date.parse(startIso);
+  const end = Date.parse(endIso);
+  if (!Number.isFinite(start) || !Number.isFinite(end) || end < start) return undefined;
+  return end - start;
+}

package/src/components/chat/executed-actions-model.test.ts

@@ -0,0 +1,134 @@
+import { describe, expect, it } from 'vitest';
+import {
+  expandRunCodeActions,
+  summarizeRunCodeAction,
+  summarizeWebAction,
+} from './executed-actions-model';
+
+// W5-2 工具卡中文摘要的纯映射层测试：web_search 出查询词与结果计数，
+// web_fetch 出短 URL、HTTP 状态、体量与截断标记；失败时只出意图头，
+// 不编造结果字段。
+
+describe('summarizeWebAction / web_search', () => {
+  it('成功时出查询词与结果计数', () => {
+    const summary = summarizeWebAction(
+      'web_search',
+      { query: 'KV cache 量化' },
+      { success: true, data: { result_count: 8, query: 'KV cache 量化', results: [] } },
+    );
+    expect(summary).toBe('搜索“KV cache 量化” → 8 条结果');
+  });
+
+  it('长查询词截断到 40 字符', () => {
+    const summary = summarizeWebAction(
+      'web_search',
+      { query: 'a'.repeat(60) },
+      { success: true, data: { result_count: 1 } },
+    );
+    expect(summary).toBe(`搜索“${'a'.repeat(37)}…” → 1 条结果`);
+  });
+
+  it('失败时只出意图头，不编造计数', () => {
+    const summary = summarizeWebAction(
+      'web_search',
+      { query: 'x' },
+      { success: false, error: 'web search timed out: ReadTimeout' },
+    );
+    expect(summary).toBe('搜索“x”');
+  });
+
+  it('data 缺失（被截断吃掉）时退化为意图头', () => {
+    expect(summarizeWebAction('web_search', { query: 'x' }, { success: true })).toBe(
+      '搜索“x”',
+    );
+  });
+});
+
+describe('summarizeWebAction / web_fetch', () => {
+  it('成功时出短 URL、状态码与体量', () => {
+    const summary = summarizeWebAction(
+      'web_fetch',
+      { url: 'https://example.com/docs/spec.html' },
+      {
+        success: true,
+        data: {
+          url: 'https://example.com/docs/spec.html',
+          status: 200,
+          bytes: 12_288,
+          truncated: false,
+        },
+      },
+    );
+    expect(summary).toBe('抓取 example.com/docs/spec.html → 200 · 12.0 KB');
+  });
+
+  it('截断的抓取带"已截断"标记', () => {
+    const summary = summarizeWebAction(
+      'web_fetch',
+      { url: 'https://example.com/big' },
+      { success: true, data: { status: 200, bytes: 1_000_000, truncated: true } },
+    );
+    expect(summary).toBe('抓取 example.com/big → 200 · 976.6 KB · 已截断');
+  });
+
+  it('失败时只出意图头（SSRF 拒绝 / 超时 / 跨域重定向）', () => {
+    const summary = summarizeWebAction(
+      'web_fetch',
+      { url: 'http://169.254.169.254/latest' },
+      { success: false, error: 'refusing to fetch a non-public address' },
+    );
+    expect(summary).toBe('抓取 169.254.169.254/latest');
+  });
+
+  it('无法解析的 URL 原样截断展示', () => {
+    const summary = summarizeWebAction(
+      'web_fetch',
+      { url: 'not a url at all' },
+      { success: false, error: 'unsupported scheme' },
+    );
+    expect(summary).toBe('抓取 not a url at all');
+  });
+});
+
+describe('summarizeWebAction / 其他工具', () => {
+  it('非 web 工具返回 null（调用方回落通用摘要）', () => {
+    expect(
+      summarizeWebAction('local_exec_shell', { command: 'ls' }, { success: true }),
+    ).toBeNull();
+  });
+});
+
+describe('summarizeRunCodeAction / expandRunCodeActions', () => {
+  it('摘要写出描述和内层工具数，而不是整段 code', () => {
+    const summary = summarizeRunCodeAction(
+      'run_code',
+      { code: 'return tools.call("stub_a")', description: 'two stubs' },
+      {
+        success: true,
+        data: {
+          calls: [
+            { tool: 'stub_a', arguments: {}, result: { success: true } },
+            { tool: 'stub_b', arguments: {}, result: { success: true } },
+          ],
+        },
+      },
+    );
+    expect(summary).toBe('程序「two stubs」· 2 个内层工具');
+  });
+
+  it('展开为程序行 + 内层工具行', () => {
+    const rows = expandRunCodeActions([
+      {
+        tool: 'run_code',
+        arguments: { description: 'two stubs' },
+        result: {
+          success: true,
+          data: {
+            calls: [{ tool: 'stub_a', arguments: { x: 1 }, result: { success: true } }],
+          },
+        },
+      },
+    ]);
+    expect(rows.map((r) => r.tool)).toEqual(['run_code', 'stub_a']);
+  });
+});

package/src/components/chat/executed-actions-model.ts

@@ -0,0 +1,143 @@
+/**
+ * ExecutedActionsCard 的纯函数半侧（W5-2）：web_search / web_fetch 的
+ * 中文摘要。从 action.arguments / action.result 提取关键信息，让工具卡
+ * 一眼可读（查了什么、抓了什么、几条结果、HTTP 状态），而不是甩原始 JSON。
+ *
+ * result 的形态：sidecar ToolResult `{ success, data?, error? }`；桌面
+ * CoreLoop 路径上 data 可能被 context-compactor 截断过大字段，但
+ * result_count / status / bytes / truncated 这些小字段原样保留。
+ */
+
+interface WebToolResultData {
+  result_count?: unknown;
+  status?: unknown;
+  bytes?: unknown;
+  truncated?: unknown;
+  url?: unknown;
+}
+
+function resultData(result: unknown): WebToolResultData | null {
+  if (!result || typeof result !== 'object') return null;
+  const data = (result as { data?: unknown }).data;
+  return data && typeof data === 'object' ? (data as WebToolResultData) : null;
+}
+
+function shortUrl(raw: unknown): string | null {
+  if (typeof raw !== 'string' || raw.length === 0) return null;
+  try {
+    const u = new URL(raw);
+    const path = u.pathname === '/' ? '' : u.pathname;
+    const text = `${u.host}${path}`;
+    return text.length > 48 ? `${text.slice(0, 45)}…` : text;
+  } catch {
+    return raw.length > 48 ? `${raw.slice(0, 45)}…` : raw;
+  }
+}
+
+function formatBytes(n: unknown): string | null {
+  if (typeof n !== 'number' || !Number.isFinite(n) || n < 0) return null;
+  if (n < 1024) return `${n} B`;
+  return `${(n / 1024).toFixed(1)} KB`;
+}
+
+/**
+ * web_search / web_fetch 的卡片摘要；非这两个工具返回 null（调用方回落到
+ * 通用参数摘要）。
+ */
+export function summarizeWebAction(
+  tool: string,
+  args: unknown,
+  result: unknown,
+): string | null {
+  const obj =
+    args && typeof args === 'object' ? (args as Record<string, unknown>) : {};
+  const data = resultData(result);
+  const failed =
+    result &&
+    typeof result === 'object' &&
+    (result as { success?: unknown }).success === false;
+
+  if (tool === 'web_search') {
+    const query = typeof obj.query === 'string' ? obj.query : '';
+    const head = `搜索“${query.length > 40 ? `${query.slice(0, 37)}…` : query}”`;
+    if (failed || !data) return head;
+    const count = typeof data.result_count === 'number' ? data.result_count : null;
+    return count === null ? head : `${head} → ${count} 条结果`;
+  }
+  if (tool === 'web_fetch') {
+    const head = `抓取 ${shortUrl(obj.url) ?? '未知地址'}`;
+    if (failed || !data) return head;
+    const parts: string[] = [];
+    if (typeof data.status === 'number') parts.push(String(data.status));
+    const size = formatBytes(data.bytes);
+    if (size) parts.push(size);
+    if (data.truncated === true) parts.push('已截断');
+    return parts.length > 0 ? `${head} → ${parts.join(' · ')}` : head;
+  }
+  return null;
+}
+
+interface RunCodeCall {
+  tool?: unknown;
+  arguments?: unknown;
+  result?: unknown;
+}
+
+/**
+ * run_code 的卡片摘要：描述 + 内层工具次数，而不是整段程序 JSON。
+ */
+export function summarizeRunCodeAction(
+  tool: string,
+  args: unknown,
+  result: unknown,
+): string | null {
+  if (tool !== 'run_code') return null;
+  const obj =
+    args && typeof args === 'object' ? (args as Record<string, unknown>) : {};
+  const description =
+    typeof obj.description === 'string' && obj.description.trim()
+      ? obj.description.trim()
+      : '程序';
+  const head =
+    description.length > 40 ? `${description.slice(0, 37)}…` : description;
+  const data = resultData(result);
+  const calls = Array.isArray((data as { calls?: unknown } | null)?.calls)
+    ? ((data as { calls: RunCodeCall[] }).calls)
+    : [];
+  const failed =
+    result &&
+    typeof result === 'object' &&
+    (result as { success?: unknown }).success === false;
+  if (failed) return `程序「${head}」失败`;
+  return calls.length > 0
+    ? `程序「${head}」· ${calls.length} 个内层工具`
+    : `程序「${head}」`;
+}
+
+export interface ExecutedActionLike {
+  tool: string;
+  arguments?: unknown;
+  result?: unknown;
+  sandbox?: { backend?: string; enforcement: string };
+}
+
+/** Flatten a run_code action into the outer program plus inner tool rows. */
+export function expandRunCodeActions<T extends ExecutedActionLike>(actions: T[]): T[] {
+  const out: T[] = [];
+  for (const action of actions) {
+    out.push(action);
+    if (action.tool !== 'run_code') continue;
+    const data = resultData(action.result) as { calls?: RunCodeCall[] } | null;
+    const calls = Array.isArray(data?.calls) ? data.calls : [];
+    for (const call of calls) {
+      const name = typeof call.tool === 'string' ? call.tool : 'tool';
+      out.push({
+        ...action,
+        tool: name,
+        arguments: call.arguments,
+        result: call.result,
+      });
+    }
+  }
+  return out;
+}

package/src/components/chat/orchestration-children-model.test.ts

@@ -0,0 +1,115 @@
+import { describe, expect, it } from 'vitest';
+import {
+  childrenToCardModel,
+  foldOrchestrationChildEvents,
+  type ChildInfo,
+} from './orchestration-children-model';
+
+// OrchestrationChildrenCard 的纯映射层测试：agent.child 生命周期事件累积出的
+// ChildInfo 列表 → OrchestrationPlanCard 的 payload + taskStatuses。卡片本身
+// 的点击展开/收起交互由框架 agent-ui 的 cards.test.tsx 覆盖；桌面端到端
+// （真实 Electron + CDP 模拟用户操作）由 scripts/desktop-canary.mjs 覆盖。
+
+describe('childrenToCardModel / P3.1 编排卡片映射', () => {
+  it('空列表产出空任务面', () => {
+    const { payload, taskStatuses } = childrenToCardModel([]);
+    expect(payload.tasks).toEqual([]);
+    expect(taskStatuses).toEqual({});
+  });
+
+  it('spawn 的子代理进 tasks，id/agentId 用 lineage childId', () => {
+    const children: ChildInfo[] = [
+      { childId: '0.1', task: '扫日志', depth: 1, status: 'running' },
+      { childId: '0.2', task: '读配置', depth: 1, status: 'running' },
+    ];
+    const { payload } = childrenToCardModel(children);
+    expect(payload.mode).toBe('parallel');
+    expect(payload.tasks).toEqual([
+      { id: '0.1', agentId: '0.1', prompt: '扫日志' },
+      { id: '0.2', agentId: '0.2', prompt: '读配置' },
+    ]);
+  });
+
+  it('生命周期状态映射到卡片状态点', () => {
+    const children: ChildInfo[] = [
+      { childId: '0.1', status: 'running' },
+      { childId: '0.2', status: 'completed' },
+      { childId: '0.3', status: 'failed' },
+      { childId: '0.4', status: 'cancelled' },
+      { childId: '0.5', status: 'interrupted' },
+    ];
+    const { taskStatuses } = childrenToCardModel(children);
+    expect(taskStatuses).toEqual({
+      '0.1': 'running',
+      '0.2': 'ok',
+      '0.3': 'failed',
+      '0.4': 'skipped',
+      // interrupted 是可恢复的暂停，不是终态
+      '0.5': 'pending',
+    });
+  });
+
+  it('未知状态退化为 pending；缺 task 时 prompt 为空串', () => {
+    const { payload, taskStatuses } = childrenToCardModel([
+      { childId: '0.1', status: 'mystery' },
+    ]);
+    expect(taskStatuses['0.1']).toBe('pending');
+    expect(payload.tasks[0].prompt).toBe('');
+  });
+
+  it('delegate 子代理的 agentId 显示 profile 名(delegate-on-pool)', () => {
+    // delegate_subagent 的 child_spawned 事件带 profile;卡片把 profile
+    // 作为执行者名显示,无 profile 的编排子代理仍退回 lineage childId。
+    const children: ChildInfo[] = [
+      { childId: '0.1', task: '扫日志', profile: 'researcher', status: 'running' },
+      { childId: '0.2', task: '读配置', profile: 'general-purpose', status: 'completed' },
+      { childId: '0.3', task: '六件套子代理', status: 'running' },
+    ];
+    const { payload } = childrenToCardModel(children);
+    expect(payload.tasks).toEqual([
+      { id: '0.1', agentId: 'researcher', prompt: '扫日志' },
+      { id: '0.2', agentId: 'general-purpose', prompt: '读配置' },
+      { id: '0.3', agentId: '0.3', prompt: '六件套子代理' },
+    ]);
+  });
+});
+
+describe('foldOrchestrationChildEvents / 切回重建子代理列表', () => {
+  it('空事件流产出空列表', () => {
+    expect(foldOrchestrationChildEvents([])).toEqual([]);
+  });
+
+  it('spawn → completed → resumed 折叠为终态/恢复态', () => {
+    const list = foldOrchestrationChildEvents([
+      { kind: 'child_spawned', childId: '0.1', task: '扫日志', depth: 1 },
+      { kind: 'child_completed', childId: '0.1', status: 'completed' },
+      { kind: 'child_resumed', childId: '0.1', status: 'running' },
+    ]);
+    expect(list).toEqual([{ childId: '0.1', task: '扫日志', depth: 1, status: 'running' }]);
+  });
+
+  it('未 spawn 就出现的终端事件被跳过', () => {
+    expect(
+      foldOrchestrationChildEvents([{ kind: 'child_failed', childId: 'ghost' }]),
+    ).toEqual([]);
+  });
+
+  it('重复 spawn 幂等，不会产生重复条目', () => {
+    const list = foldOrchestrationChildEvents([
+      { kind: 'child_spawned', childId: '0.1', task: 'A' },
+      { kind: 'child_spawned', childId: '0.1', task: 'A' },
+    ]);
+    expect(list).toHaveLength(1);
+  });
+
+  it('非法条目（缺 kind/childId）被忽略', () => {
+    // 刻意传入非结构化条目验证鲁棒性——运行时可从 JSON 收到任意形状。
+    const list = foldOrchestrationChildEvents([
+      { childId: '0.1' },
+      { kind: 'child_spawned' },
+      null,
+      42,
+    ] as unknown as Parameters<typeof foldOrchestrationChildEvents>[0]);
+    expect(list).toEqual([]);
+  });
+});