@steerable/agent-shell-web 0.6.19 → 0.6.20

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

@@ -1,282 +0,0 @@
-/**
- * chat-transport：Electron IPC SSE → 框架 ChatStreamTransport 的适配。
- * 分两层锁定：
- *   - LocalBackendSseAdapter（经 __test__ 导出）：legacy 帧归一化、
- *     budget_exhausted 降级护栏（已有内容流过时降级为普通结束，避免
- *     框架 hook 把已渲染文本冲掉）、done 恰好一次、turn_timeline 旁路。
- *   - createElectronChatTransport：请求形状（路径编码、metadata 并入
- *     body）、错误路径（startStream 拒绝 / error 载荷都会 reject 并
- *     发 error 事件）、cancelActive 双路径（有 streamId 走 cancelStream，
- *     否则按 chatId 打取消端点）、steer 的软失败。
- * 桥走真实的 window.electron 路径，不 mock 模块。
- */
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import type { SSEEvent } from '@steerable/agent-protocol';
-import {
-  createElectronChatTransport,
-  regenerateChatMessage,
-  __test__,
-} from './chat-transport';
-
-const { LocalBackendSseAdapter } = __test__;
-
-afterEach(() => {
-  delete (window as { electron?: unknown }).electron;
-});
-
-function collectEvents(): { events: SSEEvent[]; onEvent: (e: SSEEvent) => void } {
-  const events: SSEEvent[] = [];
-  return { events, onEvent: (e) => events.push(e) };
-}
-
-function ofType<T extends SSEEvent['type']>(events: SSEEvent[], type: T) {
-  return events.filter((e) => e.type === type);
-}
-
-describe('LocalBackendSseAdapter 帧归一化', () => {
-  it('content 帧按序透出，并附带 turn_timeline 旁路事件', () => {
-    const { events, onEvent } = collectEvents();
-    const adapter = new LocalBackendSseAdapter(onEvent);
-    adapter.feed('data: {"content":"你好"}\n\n');
-    adapter.feed('data: {"content":"世界"}\n\n');
-    const contents = ofType(events, 'content').map((e) => (e as { content: string }).content);
-    expect(contents).toEqual(['你好', '世界']);
-    const timelines = events.filter(
-      (e) => e.type === 'agent' && (e as { event?: string }).event === 'turn_timeline',
-    );
-    expect(timelines.length).toBe(2);
-    const last = timelines[1] as unknown as {
-      payload: { blocks: Array<{ type: string; content: string }> };
-    };
-    expect(last.payload.blocks).toEqual([{ type: 'text', content: '你好世界' }]);
-  });
-
-  it('[DONE] 帧触发一次 done；之后再 end 不重复', () => {
-    const { events, onEvent } = collectEvents();
-    const adapter = new LocalBackendSseAdapter(onEvent);
-    adapter.feed('data: {"content":"x"}\n\ndata: [DONE]\n\n');
-    adapter.end();
-    expect(ofType(events, 'done')).toHaveLength(1);
-  });
-
-  it('没有 [DONE] 时 end() 补发一次 done', () => {
-    const { events, onEvent } = collectEvents();
-    const adapter = new LocalBackendSseAdapter(onEvent);
-    adapter.feed('data: {"content":"x"}\n\n');
-    adapter.end();
-    expect(ofType(events, 'done')).toHaveLength(1);
-  });
-
-  // fixture 与服务端 router.ts onNotice 的真实发射形状一致（budget.kind + message）。
-  it('budget_exhausted 在没有任何内容流过时原样透出、不结束流', () => {
-    const { events, onEvent } = collectEvents();
-    const adapter = new LocalBackendSseAdapter(onEvent);
-    adapter.feed(
-      'data: {"type":"budget_exhausted","budget":{"kind":"tokens"},"message":"budget_exhausted: tokens"}\n\n',
-    );
-    expect(ofType(events, 'budget_exhausted')).toHaveLength(1);
-    expect(ofType(events, 'done')).toHaveLength(0);
-  });
-
-  it('budget_exhausted 在已有内容流过时降级为普通结束（护栏）', () => {
-    const { events, onEvent } = collectEvents();
-    const adapter = new LocalBackendSseAdapter(onEvent);
-    adapter.feed('data: {"content":"半截回答"}\n\n');
-    adapter.feed(
-      'data: {"type":"budget_exhausted","budget":{"kind":"tokens"},"message":"budget_exhausted: tokens"}\n\n',
-    );
-    // 原事件被吞，替换为 suppression 标记 + done。
-    expect(ofType(events, 'budget_exhausted')).toHaveLength(0);
-    const suppressed = events.filter(
-      (e) =>
-        e.type === 'agent' &&
-        (e as { event?: string }).event === 'budget_exhausted_suppressed',
-    );
-    expect(suppressed).toHaveLength(1);
-    expect(ofType(events, 'done')).toHaveLength(1);
-  });
-
-  it('executed_actions 帧透出并同步进时间线', () => {
-    const { events, onEvent } = collectEvents();
-    const adapter = new LocalBackendSseAdapter(onEvent);
-    adapter.feed(
-      'data: {"type":"executed_actions","actions":[{"id":"t1","toolName":"bash","status":"done"}]}\n\n',
-    );
-    const executed = events.filter(
-      (e) => e.type === 'agent' && (e as { event?: string }).event === 'executed_actions',
-    );
-    expect(executed).toHaveLength(1);
-    const timelines = events.filter(
-      (e) => e.type === 'agent' && (e as { event?: string }).event === 'turn_timeline',
-    );
-    expect(timelines).toHaveLength(1);
-  });
-});
-
-describe('createElectronChatTransport', () => {
-  function installStreamBridge() {
-    const captured: {
-      input?: { method: string; path: string; body?: unknown };
-      cb?: (payload: { type: string; chunk?: string; status?: number; error?: string }) => void;
-    } = {};
-    const cancelStream = vi.fn();
-    const request = vi.fn().mockResolvedValue({});
-    const startStream = vi.fn(
-      (
-        input: { method: string; path: string; body?: unknown },
-        cb: (payload: { type: string; chunk?: string; status?: number; error?: string }) => void,
-      ) => {
-        captured.input = input;
-        captured.cb = cb;
-        return Promise.resolve('stream-1');
-      },
-    );
-    (window as { electron?: unknown }).electron = {
-      localBackend: { request, startStream, cancelStream },
-    };
-    return { captured, cancelStream, request, startStream };
-  }
-
-  it('桥缺失时 stream 直接拒绝', async () => {
-    const transport = createElectronChatTransport('chat-1');
-    await expect(
-      transport.stream({ content: 'hi' }, () => {}),
-    ).rejects.toThrow(/Electron bridge unavailable/);
-  });
-
-  it('请求形状：路径编码 chatId，metadata 并入 body', async () => {
-    const { captured } = installStreamBridge();
-    const transport = createElectronChatTransport('chat 1');
-    const { onEvent } = collectEvents();
-    const p = transport.stream({ content: 'hi', metadata: { foo: 1 } }, onEvent);
-    await vi.waitFor(() => expect(captured.cb).toBeDefined());
-    expect(captured.input).toEqual({
-      method: 'POST',
-      path: '/api/v2/chats/chat%201/run',
-      body: { message: 'hi', foo: 1 },
-    });
-    captured.cb!({ type: 'end', status: 200 });
-    await p;
-  });
-
-  it('data → end 载荷驱动适配器，end 后 stream resolve 且返回取消句柄', async () => {
-    const { captured, cancelStream } = installStreamBridge();
-    const transport = createElectronChatTransport('chat-1');
-    const { events, onEvent } = collectEvents();
-    const p = transport.stream({ content: 'hi' }, onEvent);
-    await vi.waitFor(() => expect(captured.cb).toBeDefined());
-    captured.cb!({ type: 'data', chunk: 'data: {"content":"x"}\n\n' });
-    captured.cb!({ type: 'end', status: 200 });
-    const cancel = await p;
-    expect(ofType(events, 'content')).toHaveLength(1);
-    expect(ofType(events, 'done')).toHaveLength(1);
-    // 流已结束，契约句柄此时取消仍指向记忆中的 streamId（空操作语义见文件头）。
-    if (typeof cancel !== 'function') throw new Error('expected a cancel handle');
-    cancel();
-    expect(cancelStream).toHaveBeenCalledWith('stream-1');
-  });
-
-  it('startStream 拒绝时发 error 事件并 reject', async () => {
-    const { startStream } = installStreamBridge();
-    startStream.mockRejectedValueOnce(new Error('ipc dead'));
-    const transport = createElectronChatTransport('chat-1');
-    const { events, onEvent } = collectEvents();
-    await expect(transport.stream({ content: 'hi' }, onEvent)).rejects.toThrow('ipc dead');
-    expect(ofType(events, 'error')).toHaveLength(1);
-  });
-
-  it('error 载荷发 error 事件并 reject', async () => {
-    const { captured } = installStreamBridge();
-    const transport = createElectronChatTransport('chat-1');
-    const { events, onEvent } = collectEvents();
-    const p = transport.stream({ content: 'hi' }, onEvent);
-    await vi.waitFor(() => expect(captured.cb).toBeDefined());
-    captured.cb!({ type: 'error', error: 'agent crashed' });
-    await expect(p).rejects.toThrow('agent crashed');
-    expect(ofType(events, 'error')).toEqual([{ type: 'error', message: 'agent crashed' }]);
-  });
-
-  it('cancelActive 有进行中流时走 cancelStream，否则按 chatId 打取消端点', async () => {
-    const { captured, cancelStream, request } = installStreamBridge();
-    const transport = createElectronChatTransport('chat-1');
-    const { onEvent } = collectEvents();
-    const p = transport.stream({ content: 'hi' }, onEvent);
-    await vi.waitFor(() => expect(captured.cb).toBeDefined());
-    // startStream 已 resolve，streamId 已登记——取消走 IPC。
-    transport.cancelActive();
-    expect(cancelStream).toHaveBeenCalledWith('stream-1');
-    captured.cb!({ type: 'end', status: 200 });
-    await p;
-    // 流已结束后再取消：改打 HTTP 取消端点（fire-and-forget）。
-    transport.cancelActive();
-    expect(request).toHaveBeenCalledWith({
-      method: 'POST',
-      path: '/api/v2/chats/chat-1/cancel',
-      body: {},
-    });
-  });
-
-  it('steer 在桥无 steerChat 能力时软失败为 false', async () => {
-    installStreamBridge();
-    const transport = createElectronChatTransport('chat-1');
-    await expect(transport.steer!('换个方向')).resolves.toBe(false);
-  });
-
-  it('steer 透传桥的返回值', async () => {
-    const steerChat = vi.fn().mockResolvedValue(true);
-    (window as { electron?: unknown }).electron = { localBackend: { steerChat } };
-    const transport = createElectronChatTransport('chat-1');
-    await expect(transport.steer!('换个方向')).resolves.toBe(true);
-    expect(steerChat).toHaveBeenCalledWith('chat-1', '换个方向');
-  });
-});
-
-describe('regenerateChatMessage', () => {
-  function installRegenerateBridge() {
-    const captured: {
-      cb?: (payload: { type: string; chunk?: string; status?: number; error?: string }) => void;
-    } = {};
-    const startStream = vi.fn(
-      (
-        _input: unknown,
-        cb: (payload: { type: string; chunk?: string; status?: number; error?: string }) => void,
-      ) => {
-        captured.cb = cb;
-        return Promise.resolve('stream-r');
-      },
-    );
-    (window as { electron?: unknown }).electron = { localBackend: { startStream } };
-    return captured;
-  }
-
-  it('2xx 结束 → resolve', async () => {
-    const captured = installRegenerateBridge();
-    const p = regenerateChatMessage('chat-1', 'msg-1');
-    await vi.waitFor(() => expect(captured.cb).toBeDefined());
-    captured.cb!({ type: 'end', status: 200 });
-    await expect(p).resolves.toBeUndefined();
-  });
-
-  it('error 帧 + 非 2xx 结束 → 以后端的拒绝文案 reject', async () => {
-    const captured = installRegenerateBridge();
-    const p = regenerateChatMessage('chat-1', 'msg-1');
-    await vi.waitFor(() => expect(captured.cb).toBeDefined());
-    captured.cb!({ type: 'data', chunk: 'event: error\ndata: {"message":"该回复不可重新生成"}\n\n' });
-    captured.cb!({ type: 'end', status: 400 });
-    await expect(p).rejects.toThrow('该回复不可重新生成');
-  });
-
-  it('非 2xx 且无 error 帧 → 带状态码的兜底文案', async () => {
-    const captured = installRegenerateBridge();
-    const p = regenerateChatMessage('chat-1', 'msg-1');
-    await vi.waitFor(() => expect(captured.cb).toBeDefined());
-    captured.cb!({ type: 'end', status: 500 });
-    await expect(p).rejects.toThrow('重新生成失败（HTTP 500）');
-  });
-
-  it('桥缺失时拒绝', async () => {
-    await expect(regenerateChatMessage('chat-1', 'msg-1')).rejects.toThrow(
-      /Electron bridge unavailable/,
-    );
-  });
-});

package/src/lib/date-groups.test.ts

@@ -1,62 +0,0 @@
-/**
- * date-groups：侧栏会话分组的标签与排序权重。
- * 锁定分档边界（今天 / 昨天 / 2–3 天前 / 同年 M月D日 / 跨年 YYYY年M月D日）
- * 与 priority 的单调性（越小越新）。测试日期一律相对今天构造（正午锚定），
- * 避免硬编码日期随时间腐化或在午夜前后抖动。
- */
-import { describe, expect, it } from 'vitest';
-import { getDateGroupLabel, getDateGroupPriority } from './date-groups';
-
-/** 构造 n 天前的日期（锚在正午，避开跨午夜的边界抖动）。 */
-function daysAgo(n: number): Date {
-  const d = new Date();
-  d.setHours(12, 0, 0, 0);
-  d.setDate(d.getDate() - n);
-  return d;
-}
-
-describe('getDateGroupLabel 分档', () => {
-  it('今天与昨天有专用标签', () => {
-    expect(getDateGroupLabel(daysAgo(0))).toBe('今天');
-    expect(getDateGroupLabel(daysAgo(1))).toBe('昨天');
-  });
-
-  it('2–3 天前折叠为「N天前」', () => {
-    expect(getDateGroupLabel(daysAgo(2))).toBe('2天前');
-    expect(getDateGroupLabel(daysAgo(3))).toBe('3天前');
-  });
-
-  it('4 天起按年份分档：同年 M月D日，跨年 YYYY年M月D日', () => {
-    const d = daysAgo(10);
-    const today = new Date();
-    if (d.getFullYear() === today.getFullYear()) {
-      expect(getDateGroupLabel(d)).toBe(`${d.getMonth() + 1}月${d.getDate()}日`);
-    } else {
-      expect(getDateGroupLabel(d)).toBe(
-        `${d.getFullYear()}年${d.getMonth() + 1}月${d.getDate()}日`,
-      );
-    }
-  });
-
-  it('确定的过去年份一定走跨年格式', () => {
-    expect(getDateGroupLabel(new Date(2000, 0, 5))).toBe('2000年1月5日');
-  });
-});
-
-describe('getDateGroupPriority 排序权重', () => {
-  it('各档位的权重值', () => {
-    expect(getDateGroupPriority('今天')).toBe(1);
-    expect(getDateGroupPriority('昨天')).toBe(2);
-    expect(getDateGroupPriority('3天前')).toBe(5);
-    expect(getDateGroupPriority('9月1日')).toBe(100);
-    expect(getDateGroupPriority('2025年9月1日')).toBe(1000);
-  });
-
-  it('按权重排序后组序为 今天 → 昨天 → N天前 → 月日 → 跨年', () => {
-    const labels = ['2024年3月2日', '9月1日', '3天前', '昨天', '2天前', '今天'];
-    const sorted = [...labels].sort(
-      (a, b) => getDateGroupPriority(a) - getDateGroupPriority(b),
-    );
-    expect(sorted).toEqual(['今天', '昨天', '2天前', '3天前', '9月1日', '2024年3月2日']);
-  });
-});

package/src/lib/demo-flag.test.ts

@@ -1,17 +0,0 @@
-/**
- * demo-flag：静态演示构建（steerableframework.com/demo/）的模块级开关。
- * 正常应用构建从不调用 markDemoMode()，所以缺省必须为 false；
- * 标记一旦置位不可逆（没有 unmark——页面生命周期内不需要）。
- */
-import { describe, expect, it } from 'vitest';
-import { isDemoMode, markDemoMode } from './demo-flag';
-
-describe('demo-flag', () => {
-  it('缺省 false，markDemoMode 后置 true 且保持', () => {
-    expect(isDemoMode()).toBe(false);
-    markDemoMode();
-    expect(isDemoMode()).toBe(true);
-    markDemoMode();
-    expect(isDemoMode()).toBe(true);
-  });
-});

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

@@ -1,54 +0,0 @@
-/**
- * electron-bridge 的桥选择逻辑：window.electron（Electron preload）优先，
- * 否则 window.__DEEPPATH_BS__（BS 服务器托管）落到 HTTP 实现，
- * 两者皆无则是纯浏览器演示态（null）。SPA 必须在三种形态下都不崩。
- */
-import { afterEach, describe, expect, it } from 'vitest';
-import { getElectronBridge, isElectron } from './electron-bridge';
-
-afterEach(() => {
-  delete (window as { electron?: unknown }).electron;
-  delete (window as { __DEEPPATH_BS__?: unknown }).__DEEPPATH_BS__;
-});
-
-describe('getElectronBridge / isElectron', () => {
-  it('两种桥都不存在时返回 null（纯浏览器演示态）', () => {
-    expect(getElectronBridge()).toBeNull();
-    expect(isElectron()).toBe(false);
-  });
-
-  it('window.electron 存在时原样返回', () => {
-    const fake = { runtime: 'local', platform: 'darwin' };
-    (window as { electron?: unknown }).electron = fake;
-    expect(getElectronBridge()).toBe(fake);
-    expect(isElectron()).toBe(true);
-  });
-
-  it('仅 __DEEPPATH_BS__ 时落到 HTTP 桥，平台取自注入的引导信息', () => {
-    (window as { __DEEPPATH_BS__?: unknown }).__DEEPPATH_BS__ = {
-      platform: 'linux',
-      flavor: 'generic',
-      brandName: 'Test',
-    };
-    const bridge = getElectronBridge();
-    expect(bridge).not.toBeNull();
-    expect(bridge!.runtime).toBe('local');
-    expect(bridge!.platform).toBe('linux');
-    // HTTP 桥的传输面齐全（fetch 实现，无需 Electron）。
-    expect(typeof bridge!.localBackend.request).toBe('function');
-    expect(isElectron()).toBe(true);
-    // 单例：再次取桥是同一个对象。
-    expect(getElectronBridge()).toBe(bridge);
-  });
-
-  it('window.electron 优先于 __DEEPPATH_BS__', () => {
-    const fake = { runtime: 'local', platform: 'darwin' };
-    (window as { electron?: unknown }).electron = fake;
-    (window as { __DEEPPATH_BS__?: unknown }).__DEEPPATH_BS__ = {
-      platform: 'linux',
-      flavor: 'generic',
-      brandName: 'Test',
-    };
-    expect(getElectronBridge()).toBe(fake);
-  });
-});

package/src/lib/exec-policy.test.ts

@@ -1,71 +0,0 @@
-/**
- * exec-policy：会话级命令执行沙箱档位的解析与持久化。
- * 锁定三点：只有精确字符串 'full' 才放开沙箱（其余一律落回 workspace）；
- * localStorage 缺失时（SSR / 无存储环境）读回缺省、写入静默不抛；
- * 有存储时读写往返不漂移。持久化路径用 vi.stubGlobal 装内存实现来测，
- * 缺失路径用 stubGlobal(..., undefined) 模拟。
- */
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import {
-  EXEC_POLICY_STORAGE_KEY,
-  parseExecPolicy,
-  persistExecPolicy,
-  readStoredExecPolicy,
-} from './exec-policy';
-
-afterEach(() => {
-  vi.unstubAllGlobals();
-});
-
-/** 装一个最小内存 localStorage，返回底层 Map 便于断言。 */
-function stubLocalStorage() {
-  const store = new Map<string, string>();
-  vi.stubGlobal('localStorage', {
-    getItem: (k: string) => (store.has(k) ? store.get(k)! : null),
-    setItem: (k: string, v: string) => void store.set(k, String(v)),
-    removeItem: (k: string) => void store.delete(k),
-    clear: () => store.clear(),
-  });
-  return store;
-}
-
-describe('parseExecPolicy', () => {
-  it("只有精确的 'full' 解析为 full", () => {
-    expect(parseExecPolicy('full')).toBe('full');
-  });
-
-  it('其余一律落回 workspace（含大小写变体与 falsy）', () => {
-    for (const value of ['workspace', 'FULL', 'Full', '', null, undefined, 0, 1, {}]) {
-      expect(parseExecPolicy(value)).toBe('workspace');
-    }
-  });
-});
-
-describe('readStoredExecPolicy / persistExecPolicy', () => {
-  it('localStorage 缺失时读回缺省 workspace，写入静默不抛', () => {
-    // vitest.setup 会装内存 localStorage；stub 成 undefined 模拟 SSR 环境。
-    vi.stubGlobal('localStorage', undefined);
-    expect(readStoredExecPolicy()).toBe('workspace');
-    expect(() => persistExecPolicy('full')).not.toThrow();
-  });
-
-  it('无存储值时默认 workspace', () => {
-    stubLocalStorage();
-    expect(readStoredExecPolicy()).toBe('workspace');
-  });
-
-  it('持久化后可读回，且写在约定的 key 上', () => {
-    const store = stubLocalStorage();
-    persistExecPolicy('full');
-    expect(store.get(EXEC_POLICY_STORAGE_KEY)).toBe('full');
-    expect(readStoredExecPolicy()).toBe('full');
-    persistExecPolicy('workspace');
-    expect(readStoredExecPolicy()).toBe('workspace');
-  });
-
-  it('存储里是非法值时读回 workspace', () => {
-    const store = stubLocalStorage();
-    store.set(EXEC_POLICY_STORAGE_KEY, 'everything');
-    expect(readStoredExecPolicy()).toBe('workspace');
-  });
-});