@steerable/agent-shell-web 0.6.19 → 0.6.20

package/src/components/chat/Markdown.test.tsx

@@ -1,170 +0,0 @@
-/**
- * 消息气泡里的 token 渲染契约：发出去的消息要和输入框看到的一致——
- * `@专家` / `@对话` 渲染成提及卡片，`/技能` / `/mcp__srv__tool` 渲染成工具
- * 卡片，而路径、URL 这类带斜杠的普通文本必须保持原样。
- */
-import { cleanup, render, screen } from '@testing-library/react';
-import { afterEach, describe, expect, it } from 'vitest';
-import { Markdown } from './Markdown';
-import type { McpToolItem, SkillItem } from '@/lib/slash-sources';
-
-afterEach(() => cleanup());
-
-const SKILLS: SkillItem[] = [
-  { name: 'loop', id: '11-loop', displayName: '循环执行', description: '重复执行' },
-  { name: 'goal', id: '10-goal', displayName: '目标跟踪', description: '目标与验收' },
-  { name: 'plan-mode', id: '70-plan-mode', description: '计划模式约束' },
-];
-
-const MCP_TOOLS: McpToolItem[] = [
-  {
-    token: 'mcp__sqlite__query',
-    toolName: 'query',
-    serverKey: 'sqlite',
-    serverName: 'SQLite',
-    description: '执行 SQL',
-  },
-];
-
-function renderMessage(content: string) {
-  render(
-    <Markdown inlineParagraph skills={SKILLS} mcpTools={MCP_TOOLS}>
-      {content}
-    </Markdown>,
-  );
-}
-
-describe('Markdown 消息内的工具 token', () => {
-  it('把行首的技能 token 渲染成琥珀色工具卡片，后续文字保持原样', () => {
-    const { container } = render(
-      <Markdown inlineParagraph skills={SKILLS} mcpTools={MCP_TOOLS}>
-        {'/loop 5分钟说一次你好'}
-      </Markdown>,
-    );
-
-    const chip = container.querySelector('[data-message-tool-chip]');
-    expect(chip).not.toBeNull();
-    expect(chip!.getAttribute('data-tool-type')).toBe('skill');
-    expect(chip!.textContent).toBe('/loop');
-    expect(chip!.className).toContain('amber');
-    expect(container.textContent).toBe('/loop 5分钟说一次你好');
-  });
-
-  it('把 MCP token 渲染成天蓝色工具卡片', () => {
-    const { container } = render(
-      <Markdown inlineParagraph skills={SKILLS} mcpTools={MCP_TOOLS}>
-        {'/mcp__sqlite__query 查一下用户表'}
-      </Markdown>,
-    );
-
-    const chip = container.querySelector('[data-message-tool-chip]');
-    expect(chip!.getAttribute('data-tool-type')).toBe('mcp');
-    expect(chip!.textContent).toBe('/mcp__sqlite__query');
-    expect(chip!.className).toContain('sky');
-  });
-
-  it('句中的技能 token 也成卡片', () => {
-    const { container } = render(
-      <Markdown inlineParagraph skills={SKILLS} mcpTools={MCP_TOOLS}>
-        {'帮我用 /goal 把这件事跟到底'}
-      </Markdown>,
-    );
-
-    const chip = container.querySelector('[data-message-tool-chip]');
-    expect(chip!.textContent).toBe('/goal');
-    expect(container.textContent).toBe('帮我用 /goal 把这件事跟到底');
-  });
-
-  it('路径、URL 与未知 token 保持纯文本', () => {
-    const { container } = render(
-      <Markdown inlineParagraph skills={SKILLS} mcpTools={MCP_TOOLS}>
-        {'看下 /mnt/c 和 /not-a-skill'}
-      </Markdown>,
-    );
-
-    expect(container.querySelector('[data-message-tool-chip]')).toBeNull();
-    expect(container.textContent).toBe('看下 /mnt/c 和 /not-a-skill');
-  });
-
-  it('引擎内部技能不渲染成卡片', () => {
-    const { container } = render(
-      <Markdown inlineParagraph skills={SKILLS} mcpTools={MCP_TOOLS}>
-        {'/plan-mode 试试'}
-      </Markdown>,
-    );
-
-    expect(container.querySelector('[data-message-tool-chip]')).toBeNull();
-  });
-
-  it('@提及与 /工具可以共存', () => {
-    const { container } = render(
-      <Markdown
-        inlineParagraph
-        skills={SKILLS}
-        mcpTools={MCP_TOOLS}
-        agents={[
-          {
-            id: 'a1',
-            slug: 'ops',
-            name: '电脑操作员',
-            icon: null,
-            color: '#2563eb',
-            description: '',
-            rolePrompt: '',
-            isBuiltin: true,
-            sortOrder: 1,
-          },
-        ]}
-      >
-        {'@电脑操作员 用 /loop 每小时跑一次'}
-      </Markdown>,
-    );
-
-    const toolChip = container.querySelector('[data-message-tool-chip]');
-    expect(toolChip!.textContent).toBe('/loop');
-    const mentionChip = container.querySelector('[data-mention-chip]');
-    expect(mentionChip!.getAttribute('data-mention-type')).toBe('agent');
-    expect(screen.getByText('@电脑操作员')).toBeTruthy();
-  });
-
-  it('邮箱与认不出的 @token 保持纯文本', () => {
-    const { container } = render(
-      <Markdown inlineParagraph skills={SKILLS} mcpTools={MCP_TOOLS}>
-        {'发到 a@b.com，参数写 @param'}
-      </Markdown>,
-    );
-
-    expect(container.querySelector('[data-mention-chip]')).toBeNull();
-    expect(container.textContent).toBe('发到 a@b.com，参数写 @param');
-  });
-
-  it('没有传目录时斜杠 token 保持纯文本', () => {
-    const { container } = render(<Markdown inlineParagraph>{'/loop 你好'}</Markdown>);
-    expect(container.querySelector('[data-message-tool-chip]')).toBeNull();
-    expect(container.textContent).toBe('/loop 你好');
-  });
-});
-
-describe('Markdown 消息内的代码块', () => {
-  it('代码块里的斜杠 token 不做替换', () => {
-    const { container } = renderFenced();
-    expect(container.querySelector('[data-message-tool-chip]')).toBeNull();
-    expect(container.textContent).toContain('/loop');
-  });
-
-  function renderFenced() {
-    return render(
-      <Markdown skills={SKILLS} mcpTools={MCP_TOOLS}>
-        {'```\n/loop 5m\n```'}
-      </Markdown>,
-    );
-  }
-});
-
-// 保证渲染入口本身没有在无 token 时改写文本节点
-describe('Markdown 普通文本', () => {
-  it('不含 token 的段落原样渲染', () => {
-    renderMessage('普通一句话，没有任何 token。');
-    expect(screen.getByText('普通一句话，没有任何 token。')).toBeTruthy();
-  });
-});

package/src/components/chat/ModelPicker.test.tsx

@@ -1,149 +0,0 @@
-/**
- * ModelPicker 交互测试：
- *   - 目录行渲染 + 选模型（换模型清掉旧档位）；
- *   - 有 reasoningLevels 的模型才出档位选择器；
- *   - 「跟随设置」回到 null（全局设置）；
- *   - offline/stale 状态如实披露（目录不可用 / 缓存），offline 时仍可选择。
- */
-import { cleanup, fireEvent, render, screen } from '@testing-library/react';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import type { GatewayModelCatalog } from '@/lib/local-api';
-
-const getLlmModels = vi.fn();
-const getLlmSettings = vi.fn();
-
-vi.mock('@/lib/local-api', () => ({
-  getLlmModels: () => getLlmModels(),
-  getLlmSettings: () => getLlmSettings(),
-}));
-
-const { ModelPicker } = await import('./ModelPicker');
-
-const CATALOG: GatewayModelCatalog = {
-  models: [
-    {
-      id: 'z-ai/glm-5.3-flash',
-      name: 'GLM 5.3 Flash',
-      window: 131072,
-      modalities: ['text'],
-      reasoningLevels: ['low', 'high', 'max'],
-      pricing: { promptPerMtok: 0.2, completionPerMtok: 0.8 },
-      joinedFrom: 'z-ai/glm-5.3-flash',
-      capabilities: 'known',
-    },
-    {
-      id: 'openai/qwen/qwen3.8-27b',
-      name: null,
-      window: null,
-      modalities: ['text'],
-      reasoningLevels: [],
-      pricing: null,
-      joinedFrom: null,
-      capabilities: 'unknown',
-    },
-  ],
-  catalogStatus: 'live',
-  fetchedAt: 1_757_000_000,
-  current: { model: null, reasoningEffort: null },
-};
-
-function renderPicker(overrides: Partial<Parameters<typeof ModelPicker>[0]> = {}) {
-  const props = {
-    model: null as string | null,
-    reasoningEffort: null as string | null,
-    onSelectModel: vi.fn(),
-    onSelectEffort: vi.fn(),
-    ...overrides,
-  };
-  const utils = render(<ModelPicker {...props} />);
-  return { ...utils, props };
-}
-
-describe('ModelPicker', () => {
-  beforeEach(() => {
-    getLlmModels.mockResolvedValue(CATALOG);
-    getLlmSettings.mockResolvedValue({ provider: 'openai-compat', model: 'deepseek-chat' });
-  });
-  afterEach(() => cleanup());
-
-  it('shows the settings model by default and lists catalog rows', async () => {
-    const { props } = renderPicker();
-    // 默认展示设置里的模型
-    const trigger = await screen.findByText('deepseek-chat');
-    fireEvent.click(trigger);
-
-    // 目录行 + 跟随设置行
-    expect(await screen.findByText('z-ai/glm-5.3-flash')).toBeTruthy();
-    expect(screen.getByText('openai/qwen/qwen3.8-27b')).toBeTruthy();
-    expect(screen.getByText(/跟随设置/)).toBeTruthy();
-    expect(screen.getByText('思考')).toBeTruthy();
-    expect(screen.getByText('131K')).toBeTruthy();
-    expect(screen.getByText('未识别')).toBeTruthy();
-
-    fireEvent.click(screen.getByText('z-ai/glm-5.3-flash'));
-    expect(props.onSelectModel).toHaveBeenCalledWith('z-ai/glm-5.3-flash');
-    // 换模型清档位，让 sidecar 按新模型校验
-    expect(props.onSelectEffort).toHaveBeenCalledWith(null);
-  });
-
-  it('offers the effort picker only for models with reasoning levels', async () => {
-    const { props, rerender } = renderPicker({ model: 'z-ai/glm-5.3-flash' });
-    // 等目录到达后档位按钮出现
-    const effortTrigger = await screen.findByText('自动');
-    fireEvent.click(effortTrigger);
-    for (const level of ['low', 'high', 'max']) {
-      expect(screen.getByText(level)).toBeTruthy();
-    }
-    fireEvent.click(screen.getByText('max'));
-    expect(props.onSelectEffort).toHaveBeenCalledWith('max');
-
-    // 切到未识别模型：档位选择器消失
-    rerender(
-      <ModelPicker
-        model="openai/qwen/qwen3.8-27b"
-        reasoningEffort={null}
-        onSelectModel={props.onSelectModel}
-        onSelectEffort={props.onSelectEffort}
-      />,
-    );
-    expect(screen.queryByText('自动')).toBeNull();
-  });
-
-  it('discloses the offline state and still allows manual selection', async () => {
-    getLlmModels.mockResolvedValue({
-      models: [],
-      catalogStatus: 'offline',
-      error: 'connect refused',
-    });
-    renderPicker();
-    const trigger = await screen.findByText('deepseek-chat');
-    fireEvent.click(trigger);
-    expect(await screen.findByText('目录不可用')).toBeTruthy();
-    expect(screen.getByText(/网关不可达/)).toBeTruthy();
-  });
-
-  it('badges a stale catalog as cache', async () => {
-    getLlmModels.mockResolvedValue({ ...CATALOG, catalogStatus: 'stale' });
-    renderPicker();
-    fireEvent.click(await screen.findByText('deepseek-chat'));
-    expect(await screen.findByText('缓存')).toBeTruthy();
-    // 缓存目录的模型行照常可选
-    expect(screen.getByText('z-ai/glm-5.3-flash')).toBeTruthy();
-  });
-
-  it('omits a leading icon on the trigger', async () => {
-    renderPicker({ model: 'z-ai/glm-5.3-flash' });
-    const trigger = (await screen.findByText('z-ai/glm-5.3-flash')).closest('button');
-    expect(trigger).toBeTruthy();
-    expect(screen.getByText('本会话')).toBeTruthy();
-    // Chevron only — no CPU / vendor logo in the chip.
-    expect(trigger!.querySelectorAll('svg')).toHaveLength(1);
-  });
-
-  it('resets to the global settings model via 跟随设置', async () => {
-    const { props } = renderPicker({ model: 'z-ai/glm-5.3-flash' });
-    fireEvent.click(await screen.findByText('z-ai/glm-5.3-flash'));
-    fireEvent.click(await screen.findByText(/跟随设置/));
-    expect(props.onSelectModel).toHaveBeenCalledWith(null);
-  });
-});

package/src/components/chat/SessionTreeModal.test.tsx

@@ -1,161 +0,0 @@
-/**
- * SessionTreeModal 的接线契约：
- *   - 打开时经 localBackend 拉 GET /branches/tree，DFS 渲染缩进树，
- *     activeRecordId 行高亮带 ✓；
- *   - 点击（或 Enter）非 active 节点 → POST /branches/activate →
- *     onBranchSwitched + onClose；
- *   - 树只有当前记录一个节点时显示空态文案；
- *   - Escape 关闭。
- */
-import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import type { ChatBranchTreeResponse } from '@/lib/local-api';
-import { SessionTreeModal } from './SessionTreeModal';
-
-afterEach(() => {
-  cleanup();
-  delete (window as { electron?: unknown }).electron;
-});
-
-const TREE_RESPONSE: ChatBranchTreeResponse = {
-  activeRecordId: 'chat_1:r2',
-  nodeCount: 4,
-  truncated: false,
-  tree: {
-    recordId: 'chat_1',
-    sourceRecordId: null,
-    sourceUntilSeq: null,
-    label: 'root',
-    depth: 0,
-    children: [
-      {
-        recordId: 'chat_1:r2',
-        sourceRecordId: 'chat_1',
-        sourceUntilSeq: 5,
-        label: 'question 1',
-        depth: 1,
-        children: [
-          {
-            recordId: 'chat_1:r2:x',
-            sourceRecordId: 'chat_1:r2',
-            sourceUntilSeq: 2,
-            label: 'variant question',
-            depth: 2,
-            children: [],
-          },
-        ],
-      },
-      {
-        recordId: 'chat_1:r3',
-        sourceRecordId: 'chat_1',
-        sourceUntilSeq: 3,
-        label: 'question 0',
-        depth: 1,
-        children: [],
-      },
-    ],
-  },
-};
-
-function installBridge(treeResponse: ChatBranchTreeResponse | null = TREE_RESPONSE) {
-  const request = vi.fn((input: { method: string; path: string; body?: unknown }) => {
-    if (input.method === 'GET' && input.path.endsWith('/branches/tree')) {
-      return Promise.resolve(treeResponse);
-    }
-    if (input.method === 'POST' && input.path.endsWith('/branches/activate')) {
-      return Promise.resolve({ activeRecordId: 'x', messageCount: 3 });
-    }
-    return Promise.reject(new Error(`unexpected request: ${input.method} ${input.path}`));
-  });
-  (window as { electron?: unknown }).electron = { localBackend: { request } };
-  return { request };
-}
-
-describe('SessionTreeModal', () => {
-  it('渲染全树：缩进行 + active 节点高亮', async () => {
-    installBridge();
-    render(<SessionTreeModal chatId="chat_1" onClose={() => {}} />);
-
-    await waitFor(() => expect(screen.queryByText('正在加载分支…')).toBeNull());
-
-    const rows = screen.getAllByRole('button').filter((b) => b.hasAttribute('data-tree-row'));
-    expect(rows).toHaveLength(4);
-    // DFS 顺序：root → r2 → r2:x → r3；label 按行展示（label 在 truncate span 里）。
-    const labels = rows.map(
-      (r) => (r.querySelector('span.truncate') as HTMLElement | null)?.textContent,
-    );
-    expect(labels).toEqual(['root', 'question 1', 'variant question', 'question 0']);
-    // 连接线前缀：根无前缀，孙节点带 │ 缩进。
-    const prefixes = rows.map(
-      (r) => (r.querySelector('span.font-mono') as HTMLElement | null)?.textContent ?? '',
-    );
-    expect(prefixes).toEqual(['', '├─ ', '│  └─ ', '└─ ']);
-    // active 标记在 r2 行。
-    expect(rows[1].getAttribute('data-active')).toBe('true');
-    expect(rows[0].getAttribute('data-active')).toBeNull();
-  });
-
-  it('点击堂兄弟节点：activate + onBranchSwitched + 关闭', async () => {
-    const { request } = installBridge();
-    const onClose = vi.fn();
-    const onBranchSwitched = vi.fn();
-    render(
-      <SessionTreeModal chatId="chat_1" onClose={onClose} onBranchSwitched={onBranchSwitched} />,
-    );
-    await waitFor(() => screen.getByText('question 0'));
-
-    fireEvent.click(screen.getByText('question 0'));
-
-    await waitFor(() => expect(onClose).toHaveBeenCalledTimes(1));
-    expect(request).toHaveBeenCalledWith({
-      method: 'POST',
-      path: '/api/v2/chats/chat_1/branches/activate',
-      body: { recordId: 'chat_1:r3' },
-    });
-    expect(onBranchSwitched).toHaveBeenCalledTimes(1);
-  });
-
-  it('点击 active 节点不触发切换', async () => {
-    const { request } = installBridge();
-    render(<SessionTreeModal chatId="chat_1" onClose={() => {}} />);
-    await waitFor(() => screen.getByText('question 1'));
-
-    fireEvent.click(screen.getByText('question 1'));
-
-    expect(
-      request.mock.calls.filter(([input]) => (input as { method: string }).method === 'POST'),
-    ).toHaveLength(0);
-  });
-
-  it('单节点树显示空态', async () => {
-    installBridge({
-      activeRecordId: 'chat_1',
-      nodeCount: 1,
-      truncated: false,
-      tree: {
-        recordId: 'chat_1',
-        sourceRecordId: null,
-        sourceUntilSeq: null,
-        label: 'root',
-        depth: 0,
-        children: [],
-      },
-    });
-    render(<SessionTreeModal chatId="chat_1" onClose={() => {}} />);
-
-    await waitFor(() => screen.getByText(/重新生成回复后，旧版本会保留在这里/));
-    expect(screen.queryAllByRole('button').filter((b) => b.hasAttribute('data-tree-row')))
-      .toHaveLength(0);
-  });
-
-  it('Escape 关闭模态', async () => {
-    const onClose = vi.fn();
-    installBridge();
-    render(<SessionTreeModal chatId="chat_1" onClose={onClose} />);
-    await waitFor(() => screen.getByText('question 0'));
-
-    fireEvent.keyDown(document, { key: 'Escape' });
-
-    expect(onClose).toHaveBeenCalledTimes(1);
-  });
-});

package/src/components/chat/TaskOutcomeCards.test.tsx

@@ -1,97 +0,0 @@
-/**
- * TaskOutcomeCards 契约：后台任务的终态要出现在用户正在看的对话里。
- *   - 完成显示 answer、失败显示 error，任务名都在；
- *   - 「查看过程」把任务交给右侧推理面板，「忽略」只发出 taskId；
- *   - worktree 待合并的任务提示去任务按钮处理（卡片不重复那套操作）；
- *   - 一次结束太多任务时只留前几张，其余折成一行汇总。
- */
-import { cleanup, fireEvent, render, screen } from '@testing-library/react';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import type { LocalTask } from '@/lib/local-api';
-import { TaskOutcomeCards } from './TaskOutcomeCards';
-
-afterEach(cleanup);
-
-function makeTask(overrides: Partial<LocalTask> = {}): LocalTask {
-  return {
-    id: 'task-1',
-    chatId: 'chat_1',
-    task: '统计仓库行数',
-    status: 'completed',
-    answer: '共 42 行。',
-    error: null,
-    worktreePath: null,
-    worktreeBranch: null,
-    worktreeState: null,
-    createdAt: '2026-09-13T01:00:00.000Z',
-    updatedAt: '2026-09-13T01:01:00.000Z',
-    ...overrides,
-  };
-}
-
-function renderCards(tasks: LocalTask[]) {
-  const onInspect = vi.fn();
-  const onDismiss = vi.fn();
-  render(<TaskOutcomeCards tasks={tasks} onInspect={onInspect} onDismiss={onDismiss} />);
-  return { onInspect, onDismiss };
-}
-
-describe('TaskOutcomeCards', () => {
-  it('没有终态任务时什么都不渲染', () => {
-    renderCards([]);
-    expect(screen.queryByTestId('task-outcome-cards')).toBeNull();
-  });
-
-  it('完成的任务显示任务名与结果', () => {
-    renderCards([makeTask()]);
-
-    expect(screen.getByText('统计仓库行数')).toBeTruthy();
-    expect(screen.getByText('共 42 行。')).toBeTruthy();
-    expect(
-      document.querySelector('[data-task-outcome="task-1"]')?.getAttribute('data-status'),
-    ).toBe('completed');
-  });
-
-  it('失败的任务显示错误原因', () => {
-    renderCards([makeTask({ status: 'failed', answer: null, error: '依赖任务失败：abc' })]);
-
-    expect(screen.getByText('依赖任务失败：abc')).toBeTruthy();
-    expect(
-      document.querySelector('[data-task-outcome="task-1"]')?.getAttribute('data-status'),
-    ).toBe('failed');
-  });
-
-  it('「查看过程」交出整个任务，「忽略」交出 taskId', () => {
-    const task = makeTask();
-    const { onInspect, onDismiss } = renderCards([task]);
-
-    fireEvent.click(screen.getByRole('button', { name: '查看过程' }));
-    expect(onInspect).toHaveBeenCalledWith(task);
-
-    fireEvent.click(screen.getByRole('button', { name: '忽略' }));
-    expect(onDismiss).toHaveBeenCalledWith('task-1');
-  });
-
-  it('worktree 待合并时指回任务按钮，卡片自己不放合并操作', () => {
-    renderCards([
-      makeTask({
-        worktreeState: 'pending',
-        worktreePath: '/tmp/wt',
-        worktreeBranch: 'steerable/fix',
-      }),
-    ]);
-
-    expect(screen.getByText('steerable/fix')).toBeTruthy();
-    expect(screen.getByText(/待合并 — 在标题栏的任务按钮里处理/)).toBeTruthy();
-    expect(screen.queryByRole('button', { name: /合并/ })).toBeNull();
-  });
-
-  it('超过三个时只留前三张，其余折成一行汇总', () => {
-    renderCards(
-      Array.from({ length: 5 }, (_, i) => makeTask({ id: `t${i}`, task: `任务 ${i}` })),
-    );
-
-    expect(document.querySelectorAll('[data-task-outcome]')).toHaveLength(3);
-    expect(screen.getByText(/另有 2 个后台任务已结束/)).toBeTruthy();
-  });
-});