@steerable/agent-shell-web 0.6.19 → 0.6.21

package/src/lib/http-bridge.test.ts

@@ -1,283 +0,0 @@
-/**
- * http-bridge：BS 模式下与 Electron preload 同形的宿主桥，传输换成 HTTP。
- * 锁定：request 的方法 / 头 / body 形状与错误语义（detail 优先、status 挂上）、
- * steer / approval / askUser / attachments 的端点逐字形状、startStream 的
- * data→end 事件序列与取消语义（本地取消按正常结束上报）、
- * 浏览器形态下 local.* 的降级回答（目录选择取消、截图不支持）。
- * fetch 用 vi.stubGlobal 替身，不起真实服务器。
- */
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { createHttpBridge } from './http-bridge';
-import type { LocalBackendStreamEvent } from './electron-bridge';
-
-afterEach(() => {
-  vi.unstubAllGlobals();
-});
-
-function stubFetch(handler: (path: string, init?: RequestInit) => unknown) {
-  const fetchMock = vi.fn((input: unknown, init?: RequestInit) =>
-    Promise.resolve(handler(String(input), init)),
-  );
-  vi.stubGlobal('fetch', fetchMock);
-  return fetchMock;
-}
-
-function jsonResponse(payload: unknown, status = 200) {
-  return {
-    ok: status >= 200 && status < 300,
-    status,
-    json: () => Promise.resolve(payload),
-  };
-}
-
-/** 逐 chunk 产出字符串的可读流替身（body.getReader 的最小实现）。 */
-function streamResponse(chunks: string[], status = 200) {
-  const encoder = new TextEncoder();
-  let i = 0;
-  return {
-    ok: status >= 200 && status < 300,
-    status,
-    body: {
-      getReader: () => ({
-        read: () =>
-          Promise.resolve(
-            i < chunks.length
-              ? { done: false as const, value: encoder.encode(chunks[i++]) }
-              : { done: true as const, value: undefined },
-          ),
-      }),
-    },
-  };
-}
-
-describe('localBackend.request', () => {
-  it('GET 不带 body 时不设 Content-Type、不带 body', async () => {
-    const fetchMock = stubFetch(() => jsonResponse({ ok: 1 }));
-    const bridge = createHttpBridge();
-    await bridge.localBackend.request({ method: 'GET', path: '/api/v2/chats' });
-    expect(fetchMock).toHaveBeenCalledWith('/api/v2/chats', {
-      method: 'GET',
-      headers: {},
-      body: undefined,
-    });
-  });
-
-  it('POST 带 body 时加 JSON 头并序列化', async () => {
-    const fetchMock = stubFetch(() => jsonResponse({}));
-    const bridge = createHttpBridge();
-    await bridge.localBackend.request({
-      method: 'POST',
-      path: '/api/v2/chats/new',
-      body: { agentId: 'a1' },
-    });
-    expect(fetchMock).toHaveBeenCalledWith('/api/v2/chats/new', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: '{"agentId":"a1"}',
-    });
-  });
-
-  it('非 2xx 且响应带 detail 时抛 detail，status 挂在错误上', async () => {
-    stubFetch(() => jsonResponse({ detail: '参数错误' }, 422));
-    const bridge = createHttpBridge();
-    const err = await bridge.localBackend
-      .request({ method: 'GET', path: '/x' })
-      .catch((e: unknown) => e);
-    expect(err).toBeInstanceOf(Error);
-    expect((err as Error).message).toBe('参数错误');
-    expect((err as Error & { status?: number }).status).toBe(422);
-  });
-
-  it('非 2xx 且响应非 JSON 时退化为状态码描述', async () => {
-    stubFetch(() => ({
-      ok: false,
-      status: 500,
-      json: () => Promise.reject(new Error('not json')),
-    }));
-    const bridge = createHttpBridge();
-    await expect(
-      bridge.localBackend.request({ method: 'GET', path: '/x' }),
-    ).rejects.toThrow('Request failed (500)');
-  });
-});
-
-describe('host 端点形状', () => {
-  it('steerChat 只在 ok===true 时为真', async () => {
-    const fetchMock = stubFetch(() => jsonResponse({ ok: true }));
-    const bridge = createHttpBridge();
-    await expect(bridge.localBackend.steerChat!('c1', '停一下')).resolves.toBe(true);
-    expect(fetchMock).toHaveBeenCalledWith(
-      '/host/steer',
-      expect.objectContaining({ method: 'POST', body: '{"chatId":"c1","content":"停一下"}' }),
-    );
-  });
-
-  it('approval.decide 与 askUser.answer 打到各自端点', async () => {
-    const fetchMock = stubFetch(() => jsonResponse({}));
-    const bridge = createHttpBridge();
-    await bridge.approval!.decide({ requestId: 'r1', kind: 'allow_once' });
-    await bridge.askUser!.answer({ requestId: 'r2', answers: { q: 'a' } });
-    expect(fetchMock).toHaveBeenCalledWith(
-      '/host/approval/decide',
-      expect.objectContaining({ method: 'POST' }),
-    );
-    expect(fetchMock).toHaveBeenCalledWith(
-      '/host/ask-user/answer',
-      expect.objectContaining({ method: 'POST' }),
-    );
-  });
-
-  it('attachments.save 透传到落盘端点', async () => {
-    const fetchMock = stubFetch(() => jsonResponse({ files: [] }));
-    const bridge = createHttpBridge();
-    await bridge.attachments!.save({ chatId: 'c1', files: [{ name: 'a.txt', data: 'SGk=' }] });
-    expect(fetchMock).toHaveBeenCalledWith(
-      '/host/attachments/save',
-      expect.objectContaining({
-        method: 'POST',
-        body: '{"chatId":"c1","files":[{"name":"a.txt","data":"SGk="}]}',
-      }),
-    );
-  });
-});
-
-describe('startStream / cancelStream', () => {
-  it('按 chunk 发 data 事件，流尽发 end（带状态码），返回 streamId', async () => {
-    stubFetch(() => streamResponse(['data: {"content":"a"}\n\n', 'data: [DONE]\n\n']));
-    const bridge = createHttpBridge();
-    const events: LocalBackendStreamEvent[] = [];
-    const streamId = await bridge.localBackend.startStream(
-      { method: 'POST', path: '/api/v2/chats/c1/run', body: { message: 'hi' } },
-      (e) => events.push(e),
-    );
-    expect(typeof streamId).toBe('string');
-    await vi.waitFor(() => {
-      expect(events).toEqual([
-        { type: 'data', chunk: 'data: {"content":"a"}\n\n' },
-        { type: 'data', chunk: 'data: [DONE]\n\n' },
-        { type: 'end', status: 200 },
-      ]);
-    });
-  });
-
-  it('fetch 本身失败时发 error 事件并返回 null', async () => {
-    const fetchMock = vi.fn().mockRejectedValue(new Error('connection refused'));
-    vi.stubGlobal('fetch', fetchMock);
-    const bridge = createHttpBridge();
-    const events: LocalBackendStreamEvent[] = [];
-    const streamId = await bridge.localBackend.startStream(
-      { method: 'POST', path: '/x' },
-      (e) => events.push(e),
-    );
-    expect(streamId).toBeNull();
-    expect(events).toEqual([{ type: 'error', error: 'connection refused' }]);
-  });
-
-  it('非 2xx 响应发 error 事件并返回 null', async () => {
-    stubFetch(() => ({ ok: false, status: 503, body: null }));
-    const bridge = createHttpBridge();
-    const events: LocalBackendStreamEvent[] = [];
-    const streamId = await bridge.localBackend.startStream(
-      { method: 'POST', path: '/x' },
-      (e) => events.push(e),
-    );
-    expect(streamId).toBeNull();
-    expect(events).toEqual([{ type: 'error', error: 'start stream failed (503)' }]);
-  });
-
-  it('取消进行中的流按正常结束（end 200）上报', async () => {
-    const encoder = new TextEncoder();
-    let rejectRead: ((err: Error) => void) | null = null;
-    let readCount = 0;
-    stubFetch(() => ({
-      ok: true,
-      status: 200,
-      body: {
-        getReader: () => ({
-          read: () => {
-            readCount += 1;
-            if (readCount === 1) {
-              return Promise.resolve({ done: false, value: encoder.encode('chunk-1') });
-            }
-            return new Promise((_, reject) => {
-              rejectRead = reject;
-            });
-          },
-        }),
-      },
-    }));
-    const bridge = createHttpBridge();
-    const events: LocalBackendStreamEvent[] = [];
-    const streamId = await bridge.localBackend.startStream(
-      { method: 'POST', path: '/x' },
-      (e) => events.push(e),
-    );
-    expect(streamId).not.toBeNull();
-    await vi.waitFor(() => expect(events).toHaveLength(1));
-    bridge.localBackend.cancelStream(streamId!);
-    rejectRead!(new Error('The operation was aborted'));
-    await vi.waitFor(() => {
-      expect(events).toEqual([
-        { type: 'data', chunk: 'chunk-1' },
-        { type: 'end', status: 200 },
-      ]);
-    });
-    // 重复取消是 no-op，不抛错。
-    expect(() => bridge.localBackend.cancelStream(streamId!)).not.toThrow();
-  });
-});
-
-describe('BS token（bootstrap 注入的 Bearer）', () => {
-  const BOOT = { platform: 'darwin', flavor: 'test', brandName: 'T', token: 'tok 1' };
-
-  it('request 与 startStream 带 Authorization 头', async () => {
-    vi.stubGlobal('__DEEPPATH_BS__', BOOT);
-    const fetchMock = stubFetch(() => jsonResponse({}));
-    const bridge = createHttpBridge();
-    await bridge.localBackend.request({ method: 'GET', path: '/api/v2/chats' });
-    expect(fetchMock).toHaveBeenCalledWith('/api/v2/chats', {
-      method: 'GET',
-      headers: { Authorization: 'Bearer tok 1' },
-      body: undefined,
-    });
-    await bridge.localBackend.startStream({ method: 'POST', path: '/x' }, () => {});
-    expect(fetchMock).toHaveBeenCalledWith('/x', expect.objectContaining({
-      headers: { 'Content-Type': 'application/json', Authorization: 'Bearer tok 1' },
-    }));
-  });
-
-  it('EventSource 不能设头，token 走 query（URL 编码）', () => {
-    vi.stubGlobal('__DEEPPATH_BS__', BOOT);
-    const urls: string[] = [];
-    vi.stubGlobal(
-      'EventSource',
-      class {
-        constructor(url: string) {
-          urls.push(url);
-        }
-        addEventListener(): void {}
-      },
-    );
-    const bridge = createHttpBridge();
-    bridge.onChatCreated?.(() => {});
-    expect(urls).toEqual(['/api/v2/events?token=tok%201']);
-  });
-});
-
-describe('浏览器形态的 local.* 降级', () => {
-  it('目录选择直接取消（浏览器给不了路径）', async () => {
-    stubFetch(() => jsonResponse({}));
-    const bridge = createHttpBridge();
-    await expect(bridge.local!.selectDirectory()).resolves.toEqual({
-      canceled: true,
-      filePaths: [],
-    });
-  });
-
-  it('窗口截图明确不支持', async () => {
-    stubFetch(() => jsonResponse({}));
-    const bridge = createHttpBridge();
-    const res = await bridge.local!.captureScreenshot();
-    expect(res.success).toBe(false);
-  });
-});

package/src/lib/insights.test.ts

@@ -1,56 +0,0 @@
-/**
- * insights.trackBehavior：fire-and-forget 的行为事件入队。
- * 锁定三条契约：桥缺失时静默返回（浏览器演示态不产生遥测）、
- * 请求形状逐字锁定（端点 / 方法 / body 键）、后端失败绝不抛进 UI。
- * 桥走真实的 window.electron 路径，不 mock 模块。
- */
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { trackBehavior } from './insights';
-
-type RequestInput = { method: string; path: string; body?: unknown };
-
-function installBridge() {
-  const request = vi.fn<(input: RequestInput) => Promise<unknown>>();
-  (window as { electron?: unknown }).electron = { localBackend: { request } };
-  return request;
-}
-
-afterEach(() => {
-  delete (window as { electron?: unknown }).electron;
-});
-
-describe('trackBehavior', () => {
-  it('桥缺失时静默返回，不抛错', () => {
-    expect(() => trackBehavior('chat_opened')).not.toThrow();
-  });
-
-  it('桥存在时 POST 到事件端点，body 带事件名与属性', () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    trackBehavior('chat_opened', { source: 'sidebar' });
-    expect(request).toHaveBeenCalledWith({
-      method: 'POST',
-      path: '/api/v2/insights/events',
-      body: { eventName: 'chat_opened', properties: { source: 'sidebar' } },
-    });
-  });
-
-  it('属性缺省为空对象', () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    trackBehavior('app_launch');
-    expect(request).toHaveBeenCalledWith({
-      method: 'POST',
-      path: '/api/v2/insights/events',
-      body: { eventName: 'app_launch', properties: {} },
-    });
-  });
-
-  it('后端拒绝时吞掉错误，不抛进 UI', async () => {
-    const request = installBridge();
-    request.mockRejectedValue(new Error('backend down'));
-    expect(() => trackBehavior('chat_opened')).not.toThrow();
-    // 让内部 promise 链跑完，确认没有未处理拒绝冒出来。
-    await new Promise((resolve) => setTimeout(resolve, 0));
-  });
-});

package/src/lib/local-api.test.ts

@@ -1,353 +0,0 @@
-/**
- * local-api 传输契约：每个 helper 只是把调用翻译成
- * `window.electron.localBackend.request({ method, path, body? })`，自身不含
- * 业务逻辑。这里逐字锁定方法 / 路径 / 查询串 / body 的形状，以及：
- *   - 桥缺失时 fail-loud（调用方应先 isElectron() 判断降级）；
- *   - 路径参数一律 encodeURIComponent（id 里的 `/`、空格不破坏路由）；
- *   - request 拒绝时错误原样抛出（不包装、不吞）；
- *   - 响应按原样透传（泛型只是编译期标注）。
- * 桥走真实的 getElectronBridge() → window.electron 路径，不 mock 模块。
- */
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import * as api from './local-api';
-
-type RequestInput = { method: string; path: string; body?: unknown };
-
-/** 安装最小可用的 window.electron 桥，返回可断言的 request 替身。 */
-function installBridge() {
-  const request = vi.fn<(input: RequestInput) => Promise<unknown>>();
-  (window as { electron?: unknown }).electron = { localBackend: { request } };
-  return request;
-}
-
-afterEach(() => {
-  delete (window as { electron?: unknown }).electron;
-});
-
-describe('local-api 桥接前置', () => {
-  it('桥缺失时 GET / POST helper 都拒绝并提示只能在桌面壳内使用', async () => {
-    await expect(api.listChats()).rejects.toThrow(/Electron bridge unavailable/);
-    await expect(api.createChat()).rejects.toThrow(/Electron bridge unavailable/);
-  });
-
-  it('request 拒绝时错误原样抛出，不包装', async () => {
-    const request = installBridge();
-    request.mockRejectedValue(new Error('主进程已退出'));
-    await expect(api.listProjects()).rejects.toThrow('主进程已退出');
-  });
-
-  it('响应按原样透传给调用方', async () => {
-    const request = installBridge();
-    const payload = {
-      chats: [{ id: 'chat-1' }],
-      pagination: { page: 1, limit: 50, total: 1, totalPages: 1, hasMore: false },
-    };
-    request.mockResolvedValue(payload);
-    await expect(api.listChats()).resolves.toEqual(payload);
-  });
-});
-
-describe('local-api 会话', () => {
-  it('listChats 缺省 page=1&limit=50，自定义分页透传', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.listChats();
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/chats?page=1&limit=50' });
-    await api.listChats({ page: 3, limit: 10 });
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/chats?page=3&limit=10' });
-  });
-
-  it('createChat 缺省发空对象 body，带参时透传 agentId / projectId', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.createChat();
-    expect(request).toHaveBeenLastCalledWith({ method: 'POST', path: '/api/v2/chats/new', body: {} });
-    await api.createChat({ agentId: 'agent-a', projectId: 'proj-1' });
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'POST',
-      path: '/api/v2/chats/new',
-      body: { agentId: 'agent-a', projectId: 'proj-1' },
-    });
-  });
-
-  it('deleteChat 对 chatId 做 URL 编码', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.deleteChat('chat/1?x');
-    expect(request).toHaveBeenCalledWith({ method: 'DELETE', path: '/api/v2/chats/chat%2F1%3Fx' });
-  });
-
-  it('deleteChatIfEmpty 追加 onlyIfEmpty=1 查询串', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.deleteChatIfEmpty('chat-1');
-    expect(request).toHaveBeenCalledWith({
-      method: 'DELETE',
-      path: '/api/v2/chats/chat-1?onlyIfEmpty=1',
-    });
-  });
-
-  it('pruneEmptyChats 缺省把 exceptChatId 归一为 null，带参时透传', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({ deletedChatIds: [] });
-    await api.pruneEmptyChats();
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'POST',
-      path: '/api/v2/chats/prune-empty',
-      body: { exceptChatId: null },
-    });
-    await api.pruneEmptyChats('chat-9');
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'POST',
-      path: '/api/v2/chats/prune-empty',
-      body: { exceptChatId: 'chat-9' },
-    });
-  });
-});
-
-describe('local-api 会话分支', () => {
-  it('getChatBranches / activateChatBranch / getChatBranchTree 的路径与 body', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.getChatBranches('chat-1');
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/chats/chat-1/branches' });
-    await api.activateChatBranch('chat-1', 'rec-2');
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'POST',
-      path: '/api/v2/chats/chat-1/branches/activate',
-      body: { recordId: 'rec-2' },
-    });
-    await api.getChatBranchTree('chat-1');
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'GET',
-      path: '/api/v2/chats/chat-1/branches/tree',
-    });
-  });
-});
-
-describe('local-api 智能体', () => {
-  it('listChatAgents 缺省不含已归档，true 时追加 include_archived=true', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({ agents: [], total: 0 });
-    await api.listChatAgents();
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/chat-agents' });
-    await api.listChatAgents(true);
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'GET',
-      path: '/api/v2/chat-agents?include_archived=true',
-    });
-  });
-
-  it('listChatAgentSkills / listChatAgentTools 走各自目录端点', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.listChatAgentSkills();
-    await api.listChatAgentTools();
-    expect(request).toHaveBeenNthCalledWith(1, { method: 'GET', path: '/api/v2/chat-agents/skills' });
-    expect(request).toHaveBeenNthCalledWith(2, { method: 'GET', path: '/api/v2/chat-agents/tools' });
-  });
-
-  it('createChatAgent 透传嵌套 body（技能 / 工具策略）', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    const input = {
-      name: '调研员',
-      skillIds: ['skill-a'],
-      toolPolicy: { mode: 'allowlist' as const, tools: ['tool-a'] },
-      allowExternalSkills: false,
-    };
-    await api.createChatAgent(input);
-    expect(request).toHaveBeenCalledWith({ method: 'POST', path: '/api/v2/chat-agents', body: input });
-  });
-
-  it('updateChatAgent 用 PATCH 且编码 agentId，archiveChatAgent 走 DELETE', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.updateChatAgent('agent/1', { name: '新名字' });
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'PATCH',
-      path: '/api/v2/chat-agents/agent%2F1',
-      body: { name: '新名字' },
-    });
-    await api.archiveChatAgent('agent-1');
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'DELETE',
-      path: '/api/v2/chat-agents/agent-1',
-    });
-  });
-});
-
-describe('local-api 运行中回合', () => {
-  it('getChatLiveStream 拉快照，cancelChatTurn 以空 body POST 取消端点', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.getChatLiveStream('chat-1');
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'GET',
-      path: '/api/v2/chats/chat-1/live-stream',
-    });
-    await api.cancelChatTurn('chat-1');
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'POST',
-      path: '/api/v2/chats/chat-1/cancel',
-      body: {},
-    });
-  });
-});
-
-describe('local-api 项目', () => {
-  it('listProjects / createProject / updateProject / deleteProject 各走 REST 语义', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.listProjects();
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/projects' });
-    await api.createProject({ name: '项目甲', folderPath: '/tmp/proj-a' });
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'POST',
-      path: '/api/v2/projects',
-      body: { name: '项目甲', folderPath: '/tmp/proj-a' },
-    });
-    await api.updateProject('proj-1', { name: '项目乙' });
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'PUT',
-      path: '/api/v2/projects/proj-1',
-      body: { name: '项目乙' },
-    });
-    await api.deleteProject('proj-1');
-    expect(request).toHaveBeenLastCalledWith({ method: 'DELETE', path: '/api/v2/projects/proj-1' });
-  });
-
-  it('getChatProjectContext 拉取会话的项目上下文', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({ project: null });
-    await api.getChatProjectContext('chat-1');
-    expect(request).toHaveBeenCalledWith({
-      method: 'GET',
-      path: '/api/v2/chats/chat-1/project-context',
-    });
-  });
-
-  it('setProjectTrusted 以 PUT body 携带信任旗标', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.setProjectTrusted('proj-1', true);
-    expect(request).toHaveBeenCalledWith({
-      method: 'PUT',
-      path: '/api/v2/projects/proj-1/trust',
-      body: { trusted: true },
-    });
-  });
-
-  it('updateChatProject 走 chat settings PATCH，null 表示移出项目', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.updateChatProject('chat-1', 'proj-1');
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'PATCH',
-      path: '/api/v2/chats/chat-1/settings',
-      body: { projectId: 'proj-1' },
-    });
-    await api.updateChatProject('chat-1', null);
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'PATCH',
-      path: '/api/v2/chats/chat-1/settings',
-      body: { projectId: null },
-    });
-  });
-});
-
-describe('local-api 任务', () => {
-  it('listChatTasks / getTaskProcess / merge / discard 的路径形状', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.listChatTasks('chat-1');
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/chats/chat-1/tasks' });
-    await api.getTaskProcess('task-1');
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/tasks/task-1/process' });
-    await api.mergeTaskWorktree('task-1');
-    expect(request).toHaveBeenLastCalledWith({ method: 'POST', path: '/api/v2/tasks/task-1/merge' });
-    await api.discardTaskWorktree('task-1');
-    expect(request).toHaveBeenLastCalledWith({ method: 'POST', path: '/api/v2/tasks/task-1/discard' });
-  });
-});
-
-describe('local-api LLM 设置与目录', () => {
-  it('getCompatFlags / getProviderPresets / getCatalogProviders 各走只读端点', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.getCompatFlags();
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/compat/flags' });
-    await api.getProviderPresets();
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/llm/presets' });
-    await api.getCatalogProviders();
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/llm/catalog' });
-  });
-
-  it('resolveProviderPreset 无参时路径以空查询串结尾，带参时做查询编码', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({ preset: null });
-    // 无参时尾部多一个空 `?`（模板字符串无条件拼接）——锁定现状，见报告。
-    await api.resolveProviderPreset();
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/llm/presets/resolve?' });
-    await api.resolveProviderPreset('https://llm.example.test/v1', 'model x');
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'GET',
-      path: '/api/v2/llm/presets/resolve?baseUrl=https%3A%2F%2Fllm.example.test%2Fv1&model=model+x',
-    });
-  });
-
-  it('getLlmModels 无 draft / 空 draft 时不带查询串', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.getLlmModels();
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/llm/models' });
-    await api.getLlmModels({});
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/llm/models' });
-  });
-
-  it('getLlmModels 透传 draft 凭证与 refresh 旗标，refresh=false 不下发', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.getLlmModels({
-      baseUrl: 'https://llm.example.test/v1',
-      apiKey: 'sk-test',
-      provider: 'ollama',
-      refresh: true,
-    });
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'GET',
-      path: '/api/v2/llm/models?baseUrl=https%3A%2F%2Fllm.example.test%2Fv1&apiKey=sk-test&provider=ollama&refresh=1',
-    });
-    await api.getLlmModels({ refresh: false });
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/llm/models' });
-  });
-
-  it('getSidecarSandboxPosture 拉取沙箱态势', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({ posture: null });
-    await api.getSidecarSandboxPosture();
-    expect(request).toHaveBeenCalledWith({ method: 'GET', path: '/api/v2/sidecar/sandbox-posture' });
-  });
-
-  it('getLlmSettings / setLlmSettings 读写同一端点', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    await api.getLlmSettings();
-    expect(request).toHaveBeenLastCalledWith({ method: 'GET', path: '/api/v2/local-settings/llm' });
-    const settings = { provider: 'ollama' as const, model: 'test-model' };
-    await api.setLlmSettings(settings);
-    expect(request).toHaveBeenLastCalledWith({
-      method: 'POST',
-      path: '/api/v2/local-settings/llm',
-      body: settings,
-    });
-  });
-
-  it('diagnoseLlmConnection 以 POST body 携带连接参数', async () => {
-    const request = installBridge();
-    request.mockResolvedValue({});
-    const input = { baseUrl: 'https://llm.example.test/v1', apiKey: 'sk-test', model: 'test-model' };
-    await api.diagnoseLlmConnection(input);
-    expect(request).toHaveBeenCalledWith({ method: 'POST', path: '/api/v2/llm/diagnose', body: input });
-  });
-});