@steerable/agent-shell-web 0.6.15 → 0.6.17

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

@@ -1,115 +0,0 @@
-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([]);
-  });
-});

package/src/components/chat/turn-timeline.test.ts

@@ -1,97 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import type { ExecutedAction } from './ExecutedActionsCard';
-import {
-  appendDelta,
-  countProcessTools,
-  fallbackTimeline,
-  parseTurnBlocks,
-  processHasReasoning,
-  splitTurnProcess,
-  syncTools,
-} from './turn-timeline';
-
-const tool = (name: string, result?: unknown): ExecutedAction => ({
-  tool: name,
-  arguments: { path: `/${name}` },
-  ...(result === undefined ? {} : { result }),
-});
-
-describe('turn-timeline', () => {
-  it('merges consecutive deltas of the same kind and splits on kind change', () => {
-    let blocks = appendDelta([], 'reasoning', '想');
-    blocks = appendDelta(blocks, 'reasoning', '一下');
-    blocks = appendDelta(blocks, 'text', '先读文件');
-    blocks = appendDelta(blocks, 'text', '。');
-    expect(blocks).toEqual([
-      { type: 'reasoning', content: '想一下' },
-      { type: 'text', content: '先读文件。' },
-    ]);
-  });
-
-  it('places tools after the text that preceded them, then more text', () => {
-    let blocks = appendDelta([], 'text', '开始');
-    blocks = syncTools(blocks, [tool('read')]);
-    blocks = appendDelta(blocks, 'text', '接着写');
-    blocks = syncTools(blocks, [tool('read'), tool('write')]);
-    expect(blocks.map((b) => b.type)).toEqual(['text', 'tools', 'text', 'tools']);
-    expect(blocks[1]).toEqual({ type: 'tools', actions: [tool('read')] });
-    expect(blocks[3]).toEqual({ type: 'tools', actions: [tool('write')] });
-  });
-
-  it('groups consecutive tools and updates in-place results', () => {
-    const running = tool('read');
-    const done = tool('read', { success: true });
-    let blocks = syncTools([], [running]);
-    blocks = syncTools(blocks, [done]);
-    blocks = syncTools(blocks, [done, tool('write')]);
-    expect(blocks).toHaveLength(1);
-    expect(blocks[0]).toEqual({ type: 'tools', actions: [done, tool('write')] });
-  });
-
-  it('ignores empty deltas', () => {
-    expect(appendDelta([], 'text', '')).toEqual([]);
-  });
-
-  it('falls back to tools-then-text for history without a timeline', () => {
-    expect(fallbackTimeline('答', [tool('read', { success: true })])).toEqual([
-      { type: 'tools', actions: [tool('read', { success: true })] },
-      { type: 'text', content: '答' },
-    ]);
-    expect(fallbackTimeline('', undefined)).toEqual([]);
-  });
-
-  it('splits trailing summary text from the think→act process', () => {
-    const blocks = [
-      { type: 'reasoning' as const, content: '想' },
-      { type: 'tools' as const, actions: [tool('read')] },
-      { type: 'text' as const, content: '中间说明' },
-      { type: 'tools' as const, actions: [tool('write')] },
-      { type: 'text' as const, content: '总结' },
-    ];
-    expect(splitTurnProcess(blocks)).toEqual({
-      process: blocks.slice(0, 4),
-      answer: [blocks[4]],
-    });
-    expect(splitTurnProcess([{ type: 'text', content: '只回答' }])).toEqual({
-      process: [],
-      answer: [{ type: 'text', content: '只回答' }],
-    });
-    expect(splitTurnProcess([{ type: 'tools', actions: [tool('read')] }])).toEqual({
-      process: [{ type: 'tools', actions: [tool('read')] }],
-      answer: [],
-    });
-    expect(countProcessTools(blocks.slice(0, 4))).toBe(2);
-    expect(processHasReasoning(blocks.slice(0, 4))).toBe(true);
-  });
-
-  it('parses persisted timeline JSON and rejects unknown kinds', () => {
-    const parsed = parseTurnBlocks([
-      { type: 'reasoning', content: 'hmm' },
-      { type: 'tools', actions: [tool('read')] },
-      { type: 'text', content: 'ok' },
-    ]);
-    expect(parsed).toHaveLength(3);
-    expect(parseTurnBlocks([{ type: 'image' }])).toBeNull();
-    expect(parseTurnBlocks([])).toBeNull();
-  });
-});

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

@@ -1,136 +0,0 @@
-/**
- * useChatTasks 契约：
- *   - 拉 GET /chats/:id/tasks，`task-updated` 推送后重拉；
- *   - `finished` 只收本次挂载期间跑到终态的任务——首屏已经终态的历史任务
- *     不算「刚跑完」，否则每次打开对话都会重弹一遍；
- *   - 两次刷新之间从建到完的任务算刚跑完（用户同样没看见它运行过）；
- *   - `dismissFinished` 只隐藏通知，不影响 `tasks` 与 `summary`。
- */
-import { act, renderHook, waitFor } from '@testing-library/react';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import type { LocalTask } from '@/lib/local-api';
-import { useChatTasks } from './useChatTasks';
-
-afterEach(() => {
-  delete (window as { electron?: unknown }).electron;
-});
-
-function makeTask(overrides: Partial<LocalTask> = {}): LocalTask {
-  return {
-    id: 'task-1',
-    chatId: 'chat_1',
-    task: '跑测试',
-    status: 'running',
-    answer: null,
-    error: null,
-    worktreePath: null,
-    worktreeBranch: null,
-    worktreeState: null,
-    createdAt: '2026-09-13T01:00:00.000Z',
-    updatedAt: '2026-09-13T01:01:00.000Z',
-    ...overrides,
-  };
-}
-
-function installBridge(initial: LocalTask[]) {
-  let current = initial;
-  const listeners: Array<(p: { chatId: string; taskId: string; status: string }) => void> = [];
-  (window as { electron?: unknown }).electron = {
-    localBackend: {
-      request: vi.fn((input: { method: string; path: string }) => {
-        if (input.method === 'GET' && input.path.endsWith('/tasks')) {
-          return Promise.resolve({ tasks: current });
-        }
-        return Promise.reject(new Error(`unexpected request: ${input.path}`));
-      }),
-    },
-    onTaskUpdated: (cb: (p: { chatId: string; taskId: string; status: string }) => void) => {
-      listeners.push(cb);
-      return () => listeners.splice(listeners.indexOf(cb), 1);
-    },
-  };
-  return {
-    async push(next: LocalTask[]) {
-      current = next;
-      await act(async () => {
-        for (const cb of listeners) cb({ chatId: 'chat_1', taskId: 'task-1', status: 'x' });
-      });
-    },
-  };
-}
-
-describe('useChatTasks', () => {
-  it('首屏已终态的历史任务不算刚跑完', async () => {
-    installBridge([makeTask({ id: 'a', status: 'completed' })]);
-    const { result } = renderHook(() => useChatTasks('chat_1'));
-
-    await waitFor(() => expect(result.current.tasks).toHaveLength(1));
-    expect(result.current.finished).toEqual([]);
-    expect(result.current.summary.total).toBe(1);
-  });
-
-  it('运行中的任务跑到终态时进 finished', async () => {
-    const bridge = installBridge([makeTask({ id: 'a', status: 'running' })]);
-    const { result } = renderHook(() => useChatTasks('chat_1'));
-
-    await waitFor(() => expect(result.current.tasks).toHaveLength(1));
-    expect(result.current.finished).toEqual([]);
-
-    const done = makeTask({ id: 'a', status: 'completed', answer: '42 行' });
-    await bridge.push([done]);
-
-    await waitFor(() => expect(result.current.finished).toEqual([done]));
-  });
-
-  it('两次刷新之间从建到完的任务也算刚跑完', async () => {
-    const bridge = installBridge([]);
-    const { result } = renderHook(() => useChatTasks('chat_1'));
-
-    await waitFor(() => expect(result.current.tasks).toEqual([]));
-
-    const flash = makeTask({ id: 'a', status: 'failed', error: '炸了' });
-    await bridge.push([flash]);
-
-    await waitFor(() => expect(result.current.finished).toEqual([flash]));
-  });
-
-  it('同一个终态不会重复进 finished', async () => {
-    const bridge = installBridge([makeTask({ id: 'a', status: 'running' })]);
-    const { result } = renderHook(() => useChatTasks('chat_1'));
-
-    await waitFor(() => expect(result.current.tasks).toHaveLength(1));
-
-    const done = makeTask({ id: 'a', status: 'completed' });
-    await bridge.push([done]);
-    await waitFor(() => expect(result.current.finished).toHaveLength(1));
-
-    await bridge.push([done]);
-    expect(result.current.finished).toHaveLength(1);
-  });
-
-  it('dismissFinished 只隐藏通知，任务本身还在', async () => {
-    const bridge = installBridge([makeTask({ id: 'a', status: 'running' })]);
-    const { result } = renderHook(() => useChatTasks('chat_1'));
-
-    await waitFor(() => expect(result.current.tasks).toHaveLength(1));
-    await bridge.push([makeTask({ id: 'a', status: 'failed', error: '炸了' })]);
-    await waitFor(() => expect(result.current.finished).toHaveLength(1));
-
-    act(() => result.current.dismissFinished('a'));
-
-    expect(result.current.finished).toEqual([]);
-    expect(result.current.tasks).toHaveLength(1);
-    expect(result.current.summary.failed).toBe(1);
-  });
-
-  it('任务表读不到时按「没有任务」处理', async () => {
-    (window as { electron?: unknown }).electron = {
-      localBackend: { request: vi.fn(() => Promise.reject(new Error('sidecar 离线'))) },
-      onTaskUpdated: () => () => {},
-    };
-    const { result } = renderHook(() => useChatTasks('chat_1'));
-
-    await waitFor(() => expect(result.current.summary.total).toBe(0));
-    expect(result.current.finished).toEqual([]);
-  });
-});

package/src/components/settings/AgentsSettingsPanel.test.tsx

@@ -1,229 +0,0 @@
-import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import type { LocalChatAgent } from '@/lib/local-api';
-
-const listChatAgents = vi.fn();
-const createChatAgent = vi.fn();
-const updateChatAgent = vi.fn();
-const archiveChatAgent = vi.fn();
-const listChatAgentSkills = vi.fn();
-const listChatAgentTools = vi.fn();
-
-vi.mock('@/lib/electron-bridge', () => ({
-  isElectron: () => true,
-  getElectronBridge: () => ({
-    localBackend: { request: vi.fn() },
-    local: {},
-  }),
-}));
-
-vi.mock('@/lib/local-api', () => ({
-  listChatAgents: (...args: unknown[]) => listChatAgents(...args),
-  createChatAgent: (...args: unknown[]) => createChatAgent(...args),
-  updateChatAgent: (...args: unknown[]) => updateChatAgent(...args),
-  archiveChatAgent: (...args: unknown[]) => archiveChatAgent(...args),
-  listChatAgentSkills: (...args: unknown[]) => listChatAgentSkills(...args),
-  listChatAgentTools: (...args: unknown[]) => listChatAgentTools(...args),
-}));
-
-const { AgentsSettingsPanel } = await import('./AgentsSettingsPanel');
-
-const builtin: LocalChatAgent = {
-  id: 'local-assistant',
-  slug: 'local-assistant',
-  name: '电脑操作员',
-  icon: null,
-  color: '#4f46e5',
-  description: '默认本地助手',
-  rolePrompt: '你是本地离线助手。',
-  isBuiltin: true,
-  sortOrder: 0,
-};
-
-const custom: LocalChatAgent = {
-  id: 'geo-advisor',
-  slug: null,
-  name: '地质顾问',
-  icon: null,
-  color: '#16a34a',
-  description: '答地质问题',
-  rolePrompt: '你是地质顾问。',
-  isBuiltin: false,
-  sortOrder: 1,
-};
-
-beforeEach(() => {
-  listChatAgents.mockReset();
-  createChatAgent.mockReset();
-  updateChatAgent.mockReset();
-  archiveChatAgent.mockReset();
-  listChatAgentSkills.mockReset();
-  listChatAgentTools.mockReset();
-  listChatAgents.mockResolvedValue({ agents: [builtin], total: 1 });
-  createChatAgent.mockResolvedValue({ agent: custom });
-  updateChatAgent.mockResolvedValue({ agent: custom });
-  archiveChatAgent.mockResolvedValue({ id: custom.id, status: 'archived' });
-  listChatAgentSkills.mockResolvedValue({
-    skills: [
-      {
-        id: '90-csv-tools',
-        name: 'csv-tools',
-        displayName: 'CSV 工具',
-        description: '处理本地 CSV 数据。',
-        layer: 'catalog',
-      },
-      {
-        id: '00-identity',
-        name: 'identity',
-        displayName: '',
-        description: '基础身份。',
-        layer: 'eager',
-      },
-    ],
-  });
-  listChatAgentTools.mockResolvedValue({
-    tools: [
-      { name: 'local_exec_shell', description: '执行本地命令。', category: 'local' },
-      { name: 'local_read_file', description: '读取文件。', category: 'local' },
-    ],
-  });
-});
-
-afterEach(cleanup);
-
-/** 技能/工具勾选项的复选框（CheckRow 把 input 包在 label 里）。 */
-function checkbox(row: HTMLElement): HTMLInputElement {
-  return row.querySelector('input') as HTMLInputElement;
-}
-
-describe('AgentsSettingsPanel', () => {
-  it('lists builtin agents and hides archive on them', async () => {
-    render(<AgentsSettingsPanel />);
-    const row = await screen.findByTestId('agent-row-local-assistant');
-    expect(row.textContent).toContain('电脑操作员');
-    expect(row.textContent).toContain('内置');
-    expect(screen.queryByTestId('agent-archive-local-assistant')).toBeNull();
-  });
-
-  it('creates a custom agent and refreshes the catalog', async () => {
-    const onCatalogChange = vi.fn(async () => {});
-    listChatAgents
-      .mockResolvedValueOnce({ agents: [builtin], total: 1 })
-      .mockResolvedValueOnce({ agents: [builtin, custom], total: 2 });
-    render(<AgentsSettingsPanel onCatalogChange={onCatalogChange} />);
-    await screen.findByTestId('agent-row-local-assistant');
-    fireEvent.click(screen.getByTestId('agent-add'));
-    fireEvent.change(screen.getByTestId('agent-form-name'), {
-      target: { value: '地质顾问' },
-    });
-    fireEvent.change(screen.getByTestId('agent-form-role'), {
-      target: { value: '你是地质顾问。' },
-    });
-    fireEvent.click(screen.getByTestId('agent-form-save'));
-    await waitFor(() => {
-      expect(createChatAgent).toHaveBeenCalledWith(
-        expect.objectContaining({
-          name: '地质顾问',
-          rolePrompt: '你是地质顾问。',
-          // 缺省能力面：不钉技能、不限制——新智能体不该一上手就少功能。
-          skillIds: [],
-          allowExternalSkills: true,
-          loadAllSkills: false,
-          toolPolicy: { mode: 'all', tools: [] },
-        }),
-      );
-    });
-    await screen.findByTestId('agent-row-geo-advisor');
-    expect(onCatalogChange).toHaveBeenCalled();
-  });
-
-  it('保存勾选的技能与工具白名单', async () => {
-    render(<AgentsSettingsPanel />);
-    await screen.findByTestId('agent-row-local-assistant');
-    fireEvent.click(screen.getByTestId('agent-add'));
-    fireEvent.change(screen.getByTestId('agent-form-name'), {
-      target: { value: '数据助手' },
-    });
-
-    const csvTools = await screen.findByTestId('agent-form-skill-90-csv-tools');
-    fireEvent.click(checkbox(csvTools));
-    fireEvent.click(screen.getByTestId('agent-form-allow-external-skills'));
-    fireEvent.click(screen.getByTestId('agent-form-tool-mode-allowlist'));
-    const readFile = await screen.findByTestId('agent-form-tool-local_read_file');
-    fireEvent.click(checkbox(readFile));
-
-    fireEvent.click(screen.getByTestId('agent-form-save'));
-    await waitFor(() => {
-      expect(createChatAgent).toHaveBeenCalledWith(
-        expect.objectContaining({
-          name: '数据助手',
-          skillIds: ['90-csv-tools'],
-          allowExternalSkills: false,
-          toolPolicy: { mode: 'allowlist', tools: ['local_read_file'] },
-        }),
-      );
-    });
-  });
-
-  it('编辑时回填已保存的能力面', async () => {
-    const restricted: LocalChatAgent = {
-      ...custom,
-      skillIds: ['90-csv-tools'],
-      allowExternalSkills: false,
-      loadAllSkills: true,
-      toolPolicy: { mode: 'denylist', tools: ['local_exec_shell'] },
-    };
-    listChatAgents.mockResolvedValue({ agents: [restricted], total: 1 });
-    render(<AgentsSettingsPanel />);
-    await screen.findByTestId('agent-row-geo-advisor');
-    fireEvent.click(screen.getByTestId('agent-edit-geo-advisor'));
-
-    const csvTools = await screen.findByTestId('agent-form-skill-90-csv-tools');
-    expect(checkbox(csvTools).checked).toBe(true);
-    expect(
-      (screen.getByTestId('agent-form-allow-external-skills') as HTMLInputElement).checked,
-    ).toBe(false);
-    expect(
-      (screen.getByTestId('agent-form-load-all-skills') as HTMLInputElement).checked,
-    ).toBe(true);
-    expect(
-      screen.getByTestId('agent-form-tool-mode-denylist').getAttribute('aria-pressed'),
-    ).toBe('true');
-    const shell = await screen.findByTestId('agent-form-tool-local_exec_shell');
-    expect(checkbox(shell).checked).toBe(true);
-  });
-
-  it('列表行摘要标出受限的智能体，缺省配置不占位', async () => {
-    const restricted: LocalChatAgent = {
-      ...custom,
-      skillIds: ['90-csv-tools'],
-      allowExternalSkills: false,
-      toolPolicy: { mode: 'allowlist', tools: ['local_read_file'] },
-    };
-    listChatAgents.mockResolvedValue({ agents: [builtin, restricted], total: 2 });
-    render(<AgentsSettingsPanel />);
-    const summary = await screen.findByTestId('agent-capability-geo-advisor');
-    expect(summary.textContent).toContain('技能 1');
-    expect(summary.textContent).toContain('仅限所选技能');
-    expect(summary.textContent).toContain('仅 1 个工具');
-    expect(screen.queryByTestId('agent-capability-local-assistant')).toBeNull();
-  });
-
-  it('archives a custom agent after two-step confirm', async () => {
-    listChatAgents
-      .mockResolvedValueOnce({ agents: [builtin, custom], total: 2 })
-      .mockResolvedValueOnce({ agents: [builtin], total: 1 });
-    render(<AgentsSettingsPanel />);
-    await screen.findByTestId('agent-row-geo-advisor');
-    const archive = screen.getByTestId('agent-archive-geo-advisor');
-    fireEvent.click(archive);
-    expect(archiveChatAgent).not.toHaveBeenCalled();
-    fireEvent.click(archive);
-    await waitFor(() => {
-      expect(archiveChatAgent).toHaveBeenCalledWith('geo-advisor');
-    });
-    await waitFor(() => {
-      expect(screen.queryByTestId('agent-row-geo-advisor')).toBeNull();
-    });
-  });
-});