@steerable/agent-shell-web 0.6.18 → 0.6.20

package/src/components/settings/preset-choice-model.test.ts

@@ -1,96 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import {
-  choiceFromPresetMode,
-  descriptorLabel,
-  overrideFromDescriptor,
-  overridesEqual,
-  presetModeFromChoice,
-  summarizePreset,
-} from './preset-choice-model';
-import type { ProviderPresetDescriptor } from '@/lib/local-api';
-
-// 与框架 llm/presets.py `describe_provider_presets` 同形的注册表行夹具。
-const ROWS: ProviderPresetDescriptor[] = [
-  {
-    host: 'api.deepseek.com',
-    modelPrefix: 'deepseek',
-    temperature: 0.0,
-    topP: null,
-    maxTokens: null,
-    reasoningEffort: null,
-    extraBody: null,
-  },
-  {
-    host: null,
-    modelPrefix: 'qwen3',
-    temperature: 0.6,
-    topP: 0.95,
-    maxTokens: null,
-    reasoningEffort: null,
-    extraBody: { top_k: 20 },
-  },
-];
-
-describe('overrideFromDescriptor', () => {
-  it('drops null fields so they are not sent on the wire', () => {
-    expect(overrideFromDescriptor(ROWS[0])).toEqual({ temperature: 0.0 });
-    expect(overrideFromDescriptor(ROWS[1])).toEqual({
-      temperature: 0.6,
-      topP: 0.95,
-      extraBody: { top_k: 20 },
-    });
-  });
-});
-
-describe('descriptorLabel', () => {
-  it('joins host and model prefix, tolerating single-key rows', () => {
-    expect(descriptorLabel(ROWS[0])).toBe('api.deepseek.com + deepseek*');
-    expect(descriptorLabel(ROWS[1])).toBe('qwen3*');
-  });
-});
-
-describe('summarizePreset', () => {
-  it('renders a one-line parameter summary', () => {
-    expect(summarizePreset(overrideFromDescriptor(ROWS[1]))).toBe(
-      'temperature 0.6 · top_p 0.95 · top_k 20',
-    );
-  });
-
-  it('describes the empty preset honestly (Moonshot case)', () => {
-    expect(summarizePreset(null)).toBe('不下发额外采样参数');
-    expect(summarizePreset({})).toContain('不带采样字段');
-  });
-});
-
-describe('presetModeFromChoice / choiceFromPresetMode', () => {
-  it('round-trips the three modes', () => {
-    expect(presetModeFromChoice(undefined)).toBe('auto');
-    expect(presetModeFromChoice({ enabled: true })).toBe('auto');
-    expect(presetModeFromChoice({ enabled: false })).toBe('off');
-    expect(presetModeFromChoice({ override: { temperature: 0.6 } })).toBe('pinned');
-
-    expect(choiceFromPresetMode('auto', -1, ROWS)).toBeUndefined();
-    expect(choiceFromPresetMode('off', -1, ROWS)).toEqual({ enabled: false });
-    expect(choiceFromPresetMode('pinned', 1, ROWS)).toEqual({
-      override: { temperature: 0.6, topP: 0.95, extraBody: { top_k: 20 } },
-    });
-  });
-
-  it('keeps a saved custom override when the registry is unavailable', () => {
-    const existing = { override: { temperature: 0.42 } };
-    expect(choiceFromPresetMode('pinned', -1, [], existing)).toEqual(existing);
-    // 无注册表也无已保存覆盖：钉死无从谈起，回落为不持久化（自动）。
-    expect(choiceFromPresetMode('pinned', -1, [])).toBeUndefined();
-  });
-});
-
-describe('overridesEqual', () => {
-  it('matches a saved override back to its registry row', () => {
-    expect(overridesEqual(overrideFromDescriptor(ROWS[1]), {
-      temperature: 0.6,
-      topP: 0.95,
-      extraBody: { top_k: 20 },
-    })).toBe(true);
-    expect(overridesEqual(overrideFromDescriptor(ROWS[0]), { temperature: 0.1 })).toBe(false);
-  });
-});

package/src/hooks/useChatsAndAgents.test.ts

@@ -1,165 +0,0 @@
-/**
- * useChatsAndAgents：侧栏状态钩子（分页会话列表 + 智能体目录 + 新建默认选中）。
- * 它是 useChatList 的 Electron 适配层，这里锁定适配层自己的契约：
- *   - 非 Electron 环境完全不发请求（skipInitialLoad + 传输层短路），
- *     create/delete 软失败并给出错误文案；
- *   - Electron 下首屏拉 page 1 与目录，目录到达后默认选中 local-assistant；
- *   - createChat 成功返回 id、失败返回 null 且错误上浮为字符串；
- *   - deleteChat 成功后重置回 page 1 重新拉取；
- *   - patchChatTitle 只改内存、不打后端（SSE 标题推送的配套路径）。
- * 桥走真实的 window.electron 路径，不 mock 模块。
- */
-import { act, renderHook, waitFor } from '@testing-library/react';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { useChatsAndAgents } from './useChatsAndAgents';
-
-type RequestInput = { method: string; path: string; body?: unknown };
-
-const PAGE_1 = {
-  chats: [
-    { id: 'c1', title: '会话一' },
-    { id: 'c2', title: '会话二' },
-  ],
-  pagination: { page: 1, limit: 50, total: 3, totalPages: 2, hasMore: true },
-};
-const PAGE_2 = {
-  chats: [{ id: 'c3', title: '会话三' }],
-  pagination: { page: 2, limit: 50, total: 3, totalPages: 2, hasMore: false },
-};
-const AGENTS = [{ id: 'agent-x' }, { id: 'local-assistant' }];
-
-/** 装一个按路径路由的 request 替身，返回调用记录便于断言。 */
-function installBridge(overrides: {
-  onCreate?: () => Promise<unknown>;
-  onDelete?: () => Promise<unknown>;
-} = {}) {
-  const calls: RequestInput[] = [];
-  const request = vi.fn((input: RequestInput): Promise<unknown> => {
-    calls.push(input);
-    if (input.path.startsWith('/api/v2/chats?')) {
-      return Promise.resolve(input.path.includes('page=2') ? PAGE_2 : PAGE_1);
-    }
-    if (input.path === '/api/v2/chat-agents') return Promise.resolve({ agents: AGENTS });
-    if (input.path === '/api/v2/chats/new') {
-      return overrides.onCreate ? overrides.onCreate() : Promise.resolve({ chatId: 'c-new' });
-    }
-    if (input.method === 'DELETE' && input.path.startsWith('/api/v2/chats/')) {
-      return overrides.onDelete
-        ? overrides.onDelete()
-        : Promise.resolve({ success: true, message: '', chatId: 'c1' });
-    }
-    return Promise.reject(new Error(`unexpected ${input.method} ${input.path}`));
-  });
-  (window as { electron?: unknown }).electron = { localBackend: { request } };
-  return { calls, request };
-}
-
-afterEach(() => {
-  delete (window as { electron?: unknown }).electron;
-});
-
-describe('非 Electron 环境', () => {
-  it('不发任何请求，列表为空', async () => {
-    const { result } = renderHook(() => useChatsAndAgents());
-    await waitFor(() => expect(result.current.isLoading).toBe(false));
-    expect(result.current.chats).toEqual([]);
-    expect(result.current.agents).toEqual([]);
-    expect(result.current.error).toBeNull();
-  });
-
-  it('createChat / deleteChat 软失败并上浮错误', async () => {
-    const { result } = renderHook(() => useChatsAndAgents());
-    let created: string | null = 'unset';
-    await act(async () => {
-      created = await result.current.createChat();
-    });
-    expect(created).toBeNull();
-    expect(result.current.error).toBe('not in electron');
-    let deleted = true;
-    await act(async () => {
-      deleted = await result.current.deleteChat('c1');
-    });
-    expect(deleted).toBe(false);
-  });
-});
-
-describe('Electron 环境', () => {
-  it('首屏拉取会话 page 1 与智能体目录，默认选中 local-assistant', async () => {
-    installBridge();
-    const { result } = renderHook(() => useChatsAndAgents());
-    await waitFor(() => expect(result.current.chats).toHaveLength(2));
-    expect(result.current.chats.map((c) => c.id)).toEqual(['c1', 'c2']);
-    expect(result.current.hasMoreChats).toBe(true);
-    await waitFor(() => expect(result.current.selectedAgentId).toBe('local-assistant'));
-  });
-
-  it('loadMoreChats 追加 page 2，hasMore 随响应翻转为 false', async () => {
-    installBridge();
-    const { result } = renderHook(() => useChatsAndAgents());
-    await waitFor(() => expect(result.current.chats).toHaveLength(2));
-    await act(async () => {
-      await result.current.loadMoreChats();
-    });
-    expect(result.current.chats.map((c) => c.id)).toEqual(['c1', 'c2', 'c3']);
-    expect(result.current.hasMoreChats).toBe(false);
-  });
-
-  it('createChat 成功返回新 id', async () => {
-    installBridge();
-    const { result } = renderHook(() => useChatsAndAgents());
-    await waitFor(() => expect(result.current.isLoading).toBe(false));
-    let id: string | null = null;
-    await act(async () => {
-      id = await result.current.createChat({ agentId: 'local-assistant' });
-    });
-    expect(id).toBe('c-new');
-    expect(result.current.error).toBeNull();
-  });
-
-  it('createChat 失败返回 null 且错误上浮为字符串', async () => {
-    installBridge({ onCreate: () => Promise.reject(new Error('创建失败')) });
-    const { result } = renderHook(() => useChatsAndAgents());
-    await waitFor(() => expect(result.current.isLoading).toBe(false));
-    let id: string | null = 'unset';
-    await act(async () => {
-      id = await result.current.createChat();
-    });
-    expect(id).toBeNull();
-    expect(result.current.error).toBe('创建失败');
-  });
-
-  it('deleteChat 成功后重置回 page 1 重新拉取', async () => {
-    const { calls } = installBridge();
-    const { result } = renderHook(() => useChatsAndAgents());
-    await waitFor(() => expect(result.current.chats).toHaveLength(2));
-    await act(async () => {
-      await result.current.loadMoreChats();
-    });
-    expect(result.current.chats).toHaveLength(3);
-    let ok = false;
-    await act(async () => {
-      ok = await result.current.deleteChat('c3');
-    });
-    expect(ok).toBe(true);
-    expect(calls.some((c) => c.method === 'DELETE' && c.path === '/api/v2/chats/c3')).toBe(true);
-    // 删除后 refresh 重置分页：重新拉了 page 1，列表回到两条。
-    await waitFor(() => expect(result.current.chats.map((c) => c.id)).toEqual(['c1', 'c2']));
-  });
-
-  it('patchChatTitle 只改内存，不发请求', async () => {
-    const { calls } = installBridge();
-    const { result } = renderHook(() => useChatsAndAgents());
-    await waitFor(() => expect(result.current.chats).toHaveLength(2));
-    const before = calls.length;
-    act(() => {
-      result.current.patchChatTitle('c1', '新标题');
-    });
-    expect(result.current.chats[0].title).toBe('新标题');
-    expect(calls.length).toBe(before);
-    // 找不到的 id 静默忽略。
-    act(() => {
-      result.current.patchChatTitle('nope', '无');
-    });
-    expect(result.current.chats).toHaveLength(2);
-  });
-});

package/src/lib/attachments.test.ts

@@ -1,127 +0,0 @@
-/**
- * attachments：会话附件的 renderer 侧助手。
- * 锁定：图像扩展名判定（大小写不敏感、无扩展名不算）、File→base64 的
- * 分块编码（跨块边界与空文件）、saveChatAttachments 的降级阶梯——
- * 无 chatId / 无桥 / 桥无 attachments 能力时原样返回；逐文件失败只退回
- * 该文件，整体失败退回整批（用户的选择不丢）。
- * 桥走真实的 window.electron 路径，不 mock 模块。
- */
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import {
-  fileToBase64,
-  isImageFile,
-  saveChatAttachments,
-  type AttachmentFile,
-} from './attachments';
-
-afterEach(() => {
-  delete (window as { electron?: unknown }).electron;
-  vi.restoreAllMocks();
-});
-
-function installBridge(save?: unknown) {
-  (window as { electron?: unknown }).electron = {
-    localBackend: { request: vi.fn() },
-    ...(save ? { attachments: { save } } : {}),
-  };
-}
-
-describe('isImageFile', () => {
-  it('常见图像扩展名命中，大小写不敏感', () => {
-    for (const p of ['a.png', 'b.JPG', 'c.jpeg', 'd.gif', 'e.webp', 'f.bmp']) {
-      expect(isImageFile(p)).toBe(true);
-    }
-  });
-
-  it('非图像与无扩展名不命中', () => {
-    for (const p of ['a.txt', 'archive.tar.gz', 'noext', 'dot.']) {
-      expect(isImageFile(p)).toBe(false);
-    }
-  });
-});
-
-describe('fileToBase64', () => {
-  it('小文件逐字节编码', async () => {
-    const file = new File([new Uint8Array([1, 2, 3, 255])], 'x.bin');
-    expect(await fileToBase64(file)).toBe('AQID/w==');
-  });
-
-  it('空文件编码为空串', async () => {
-    expect(await fileToBase64(new File([], 'empty'))).toBe('');
-  });
-
-  it('跨 0x8000 分块边界的编码与一次性编码一致', async () => {
-    const bytes = new Uint8Array(0x8000 + 100).fill(0x61);
-    const file = new File([bytes], 'big.bin');
-    const expected = Buffer.from(bytes).toString('base64');
-    expect(await fileToBase64(file)).toBe(expected);
-  });
-});
-
-describe('saveChatAttachments 降级阶梯', () => {
-  const files: AttachmentFile[] = [{ name: 'a.txt', path: '/src/a.txt' }];
-
-  it('无 chatId / 空列表时原样返回（同一引用）', async () => {
-    expect(await saveChatAttachments(null, files)).toBe(files);
-    expect(await saveChatAttachments('', files)).toBe(files);
-    expect(await saveChatAttachments('chat-1', [])).toEqual([]);
-  });
-
-  it('无桥或桥无 attachments 能力时原样返回', async () => {
-    expect(await saveChatAttachments('chat-1', files)).toBe(files);
-    installBridge();
-    expect(await saveChatAttachments('chat-1', files)).toBe(files);
-  });
-
-  it('有路径走 path 拷贝，无路径读字节走 data 上传', async () => {
-    const save = vi.fn().mockResolvedValue({
-      files: [
-        { name: 'a.txt', path: '/stored/a.txt', size: 3 },
-        { name: 'b.txt', path: '/stored/b.txt', size: 2 },
-      ],
-    });
-    installBridge(save);
-    const input: AttachmentFile[] = [
-      { name: 'a.txt', path: '/src/a.txt' },
-      { name: 'b.txt', path: '', file: new File([new Uint8Array([72, 105])], 'b.txt') },
-    ];
-    const result = await saveChatAttachments('chat-1', input);
-    expect(save).toHaveBeenCalledWith({
-      chatId: 'chat-1',
-      files: [
-        { name: 'a.txt', path: '/src/a.txt' },
-        { name: 'b.txt', data: 'SGk=' },
-      ],
-    });
-    expect(result).toEqual([
-      { name: 'a.txt', path: '/stored/a.txt' },
-      { name: 'b.txt', path: '/stored/b.txt' },
-    ]);
-  });
-
-  it('逐文件失败只退回该文件，其余仍用落盘路径', async () => {
-    const save = vi.fn().mockResolvedValue({
-      files: [
-        { name: 'a.txt', path: '/stored/a.txt', size: 3 },
-        { name: 'b.txt', path: '', error: 'too big' },
-      ],
-    });
-    installBridge(save);
-    const input: AttachmentFile[] = [
-      { name: 'a.txt', path: '/src/a.txt' },
-      { name: 'b.txt', path: '/src/b.txt' },
-    ];
-    const result = await saveChatAttachments('chat-1', input);
-    expect(result[0]).toEqual({ name: 'a.txt', path: '/stored/a.txt' });
-    expect(result[1]).toBe(input[1]);
-  });
-
-  it('整体保存失败时 warn 并退回整批原始文件', async () => {
-    const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
-    const save = vi.fn().mockRejectedValue(new Error('disk full'));
-    installBridge(save);
-    const result = await saveChatAttachments('chat-1', files);
-    expect(result).toBe(files);
-    expect(warn).toHaveBeenCalledOnce();
-  });
-});

package/src/lib/chat-title.test.ts

@@ -1,53 +0,0 @@
-/**
- * chat-title 的 `[自动化] ` 前缀解析：本地后端与云端后端共用同一前缀约定，
- * 解析器必须同时接受「带空格前缀」与「裸括号」两种写法，且只有裸括号写法
- * 会 trimStart——带空格分支保留剩余前导空白（此处逐字锁定这一不对称，
- * 改动它属于行为变更）。
- */
-import { describe, expect, it } from 'vitest';
-import { AUTOMATION_TITLE_PREFIX, parseChatTitle } from './chat-title';
-
-describe('parseChatTitle', () => {
-  it('null / undefined / 空串 → 空标题且非自动化', () => {
-    for (const raw of [null, undefined, '']) {
-      expect(parseChatTitle(raw)).toEqual({ displayTitle: '', isAutomation: false });
-    }
-  });
-
-  it('带空格前缀 → 去掉前缀、标记自动化', () => {
-    expect(parseChatTitle(`${AUTOMATION_TITLE_PREFIX}每日报表`)).toEqual({
-      displayTitle: '每日报表',
-      isAutomation: true,
-    });
-  });
-
-  it('裸括号（无空格）→ 去掉括号并 trimStart', () => {
-    expect(parseChatTitle('[自动化]每日报表')).toEqual({
-      displayTitle: '每日报表',
-      isAutomation: true,
-    });
-    expect(parseChatTitle('[自动化]  每日报表')).toEqual({
-      displayTitle: ' 每日报表',
-      isAutomation: true,
-    });
-  });
-
-  it('仅剩前缀本身 → 空标题但仍标记自动化', () => {
-    expect(parseChatTitle('[自动化] ')).toEqual({ displayTitle: '', isAutomation: true });
-    expect(parseChatTitle('[自动化]')).toEqual({ displayTitle: '', isAutomation: true });
-  });
-
-  it('普通标题原样透传', () => {
-    expect(parseChatTitle('聊聊架构')).toEqual({
-      displayTitle: '聊聊架构',
-      isAutomation: false,
-    });
-  });
-
-  it('前缀出现在中段不算自动化', () => {
-    expect(parseChatTitle('笔记：[自动化] 方案')).toEqual({
-      displayTitle: '笔记：[自动化] 方案',
-      isAutomation: false,
-    });
-  });
-});