@steerable/agent-shell-web 0.6.15 → 0.6.17

package/src/components/settings/llm-vendors.test.ts

@@ -1,171 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import {
-  defaultModelForVendor,
-  FALLBACK_VENDORS,
-  inferVendorId,
-  llmProviderFromWireKind,
-  mergeVendorOptions,
-  modelPickerOptions,
-  modelPickerRows,
-  vendorLabel,
-  type VendorOption,
-} from './llm-vendors';
-import type { LlmSettings } from '@/lib/local-api';
-
-const vendors = mergeVendorOptions([
-  {
-    id: 'deepseek',
-    apiBaseUrl: 'https://api.deepseek.com',
-    envVars: [],
-    wireKind: 'openai_compat',
-    models: ['deepseek-v4-flash', 'deepseek-v4-pro'],
-  },
-  {
-    id: 'anthropic',
-    apiBaseUrl: 'https://api.anthropic.com',
-    envVars: [],
-    wireKind: 'anthropic',
-    models: ['claude-sonnet-4-6'],
-  },
-  {
-    id: 'azure',
-    apiBaseUrl: null,
-    envVars: ['AZURE_API_KEY'],
-    wireKind: 'openai_compat',
-    models: ['gpt-4o'],
-  },
-]);
-
-describe('mergeVendorOptions', () => {
-  it('pins featured vendors and injects ollama / custom', () => {
-    const ids = vendors.map((v) => v.id);
-    expect(ids.slice(0, 2)).toEqual(['deepseek', 'anthropic']);
-    expect(ids).toContain('ollama');
-    expect(ids).toContain('custom');
-    expect(ids).toContain('azure');
-    expect(vendorLabel('alibaba-cn')).toBe('阿里云百炼');
-  });
-
-  it('orders the fallback featured list by common usage', () => {
-    expect(
-      mergeVendorOptions(FALLBACK_VENDORS)
-        .filter((v) => v.featured)
-        .map((v) => v.id),
-    ).toEqual([
-      'deepseek',
-      'alibaba-cn',
-      'moonshotai-cn',
-      'zhipuai',
-      'openai',
-      'anthropic',
-      'google',
-      'openrouter',
-      'xai',
-      'groq',
-      'lmstudio',
-      'ollama',
-      'custom',
-    ]);
-  });
-});
-
-describe('inferVendorId', () => {
-  it('prefers an explicit vendorId when that vendor is listed', () => {
-    expect(
-      inferVendorId({ provider: 'openai-compat', vendorId: 'anthropic', model: 'x' }, vendors),
-    ).toBe('anthropic');
-  });
-
-  it('matches a saved DeepSeek URL back to the catalog vendor', () => {
-    const settings: LlmSettings = {
-      provider: 'openai-compat',
-      model: 'deepseek-v4-flash',
-      baseUrl: 'https://api.deepseek.com',
-    };
-    expect(inferVendorId(settings, vendors)).toBe('deepseek');
-  });
-
-  it('uses ollama for the local provider', () => {
-    expect(
-      inferVendorId(
-        { provider: 'ollama', model: 'llama3.1:8b', baseUrl: 'http://127.0.0.1:11434' },
-        vendors,
-      ),
-    ).toBe('ollama');
-  });
-});
-
-describe('llmProviderFromWireKind', () => {
-  it('maps sidecar kinds onto persisted provider ids', () => {
-    expect(llmProviderFromWireKind('openai_compat')).toBe('openai-compat');
-    expect(llmProviderFromWireKind('anthropic')).toBe('anthropic');
-    expect(llmProviderFromWireKind('google')).toBe('google');
-    expect(llmProviderFromWireKind('openai-responses')).toBe('openai-responses');
-    expect(llmProviderFromWireKind('ollama')).toBe('ollama');
-  });
-});
-
-describe('defaultModelForVendor', () => {
-  it('keeps the current model when it is on the vendor list', () => {
-    const vendor = vendors.find((v) => v.id === 'deepseek') as VendorOption;
-    expect(defaultModelForVendor(vendor, 'deepseek-v4-pro')).toBe('deepseek-v4-pro');
-  });
-
-  it('falls back to the first catalog model', () => {
-    const vendor = vendors.find((v) => v.id === 'deepseek') as VendorOption;
-    expect(defaultModelForVendor(vendor, 'other')).toBe('deepseek-v4-flash');
-  });
-});
-
-describe('modelPickerOptions', () => {
-  const catalog = ['deepseek-chat', 'deepseek-v4-flash', 'deepseek-v4-pro'];
-
-  it('uses the live gateway list and does not mix in catalog ids', () => {
-    expect(
-      modelPickerOptions(['deepseek-chat', 'deepseek-reasoner'], catalog, 'deepseek-chat', 'live'),
-    ).toEqual(['deepseek-chat', 'deepseek-reasoner']);
-  });
-
-  it('keeps the currently selected id even if the gateway omitted it', () => {
-    expect(
-      modelPickerOptions(['deepseek-chat'], catalog, 'deepseek-v4-flash', 'live'),
-    ).toEqual(['deepseek-chat', 'deepseek-v4-flash']);
-  });
-
-  it('falls back to the vendor catalog when the gateway listing is unavailable', () => {
-    expect(modelPickerOptions([], catalog, 'deepseek-chat', 'offline')).toEqual(catalog);
-  });
-});
-
-describe('modelPickerRows', () => {
-  const catalog = ['deepseek-chat', 'deepseek-v4-flash'];
-
-  it('keeps live capability rows and marks a missing current id as unknown', () => {
-    const live = [
-      {
-        id: 'deepseek-v4-pro',
-        name: 'DeepSeek V4 Pro',
-        window: 1_000_000,
-        modalities: ['text'],
-        reasoningLevels: ['high', 'max'],
-        pricing: null,
-        joinedFrom: 'deepseek/deepseek-v4-pro',
-        capabilities: 'known' as const,
-      },
-    ];
-    expect(modelPickerRows(live, catalog, 'deepseek-v4-flash', 'live')).toEqual([
-      { id: 'deepseek-v4-pro', entry: live[0] },
-      {
-        id: 'deepseek-v4-flash',
-        entry: expect.objectContaining({ id: 'deepseek-v4-flash', capabilities: 'unknown' }),
-      },
-    ]);
-  });
-
-  it('does not invent capabilities for the vendor catalog fallback', () => {
-    expect(modelPickerRows([], catalog, 'deepseek-chat', 'offline')).toEqual([
-      { id: 'deepseek-chat', entry: null },
-      { id: 'deepseek-v4-flash', entry: null },
-    ]);
-  });
-});

package/src/components/settings/model-capabilities.test.ts

@@ -1,88 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import type { GatewayModelEntry } from '@/lib/local-api';
-import {
-  formatContextWindow,
-  modelCapabilityChips,
-} from './model-capabilities';
-
-function entry(overrides: Partial<GatewayModelEntry> & Pick<GatewayModelEntry, 'id'>): GatewayModelEntry {
-  return {
-    name: null,
-    window: null,
-    modalities: [],
-    reasoningLevels: [],
-    pricing: null,
-    joinedFrom: null,
-    capabilities: 'unknown',
-    ...overrides,
-  };
-}
-
-describe('formatContextWindow', () => {
-  it('renders million- and thousand-token windows', () => {
-    expect(formatContextWindow(1_000_000)).toBe('1M');
-    expect(formatContextWindow(1_048_576)).toBe('1M');
-    expect(formatContextWindow(131_072)).toBe('131K');
-    expect(formatContextWindow(512)).toBe('512');
-    expect(formatContextWindow(null)).toBeNull();
-  });
-});
-
-describe('modelCapabilityChips', () => {
-  it('shows verified thinking, multimodal, and window chips', () => {
-    const chips = modelCapabilityChips(
-      entry({
-        id: 'gemini-3.5-flash',
-        window: 1_048_576,
-        modalities: ['audio', 'image', 'pdf', 'text', 'video'],
-        reasoningLevels: ['minimal', 'low', 'medium', 'high'],
-        joinedFrom: 'google/gemini-3.5-flash',
-        capabilities: 'known',
-      }),
-    );
-    expect(chips.map((chip) => chip.label)).toEqual([
-      '思考',
-      '图像',
-      'PDF',
-      '音频',
-      '视频',
-      '1M',
-    ]);
-  });
-
-  it('puts reasoning levels on the thinking chip in the selected summary', () => {
-    const chips = modelCapabilityChips(
-      entry({
-        id: 'deepseek-v4-pro',
-        window: 1_000_000,
-        modalities: ['text'],
-        reasoningLevels: ['high', 'max'],
-        joinedFrom: 'deepseek/deepseek-v4-pro',
-        capabilities: 'known',
-      }),
-      { detail: true },
-    );
-    expect(chips.map((chip) => chip.label)).toEqual(['思考（high / max）', '1M']);
-  });
-
-  it('does not invent thinking or image chips from heuristic unknown rows', () => {
-    expect(
-      modelCapabilityChips(
-        entry({
-          id: 'deepseek-flash',
-          window: 131_072,
-          modalities: ['text'],
-          reasoningLevels: [],
-          capabilities: 'unknown',
-        }),
-      ),
-    ).toEqual([
-      expect.objectContaining({ key: 'unknown', label: '未识别' }),
-    ]);
-  });
-
-  it('omits chips when capabilities was not reported', () => {
-    expect(modelCapabilityChips({ id: 'custom-model' } as GatewayModelEntry)).toEqual([]);
-    expect(modelCapabilityChips(null)).toEqual([]);
-  });
-});

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/lib/pending-first-message.test.ts

@@ -1,17 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import {
-  setPendingFirstMessage,
-  takePendingFirstMessage,
-} from './pending-first-message';
-
-describe('pending-first-message（首页首条消息接力）', () => {
-  it('按 chatId 取出一次后清空，错配的 chatId 不消费', () => {
-    setPendingFirstMessage({ chatId: 'chat-a', content: '秋天到了，随便聊一句吧。' });
-    expect(takePendingFirstMessage('chat-b')).toBeNull();
-    expect(takePendingFirstMessage('chat-a')).toEqual({
-      chatId: 'chat-a',
-      content: '秋天到了，随便聊一句吧。',
-    });
-    expect(takePendingFirstMessage('chat-a')).toBeNull();
-  });
-});

package/src/pages/SettingsPage.test.tsx

@@ -1,102 +0,0 @@
-import { cleanup, fireEvent, render, screen } from '@testing-library/react';
-import { MemoryRouter } from 'react-router-dom';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-
-const { save } = vi.hoisted(() => ({ save: vi.fn(async () => {}) }));
-
-vi.mock('@/lib/electron-bridge', () => ({
-  isElectron: () => true,
-}));
-
-vi.mock('@/components/settings/LlmSettingsPanel', async () => {
-  const react = await import('react');
-  return {
-    LlmSettingsPanel: react.forwardRef(function MockLlm(
-      props: { onSaveUiChange?: (ui: { saving: boolean; savedOk: boolean; loading: boolean }) => void },
-      ref,
-    ) {
-      react.useImperativeHandle(ref, () => ({ save }));
-      react.useEffect(() => {
-        props.onSaveUiChange?.({ saving: false, savedOk: false, loading: false });
-      }, [props.onSaveUiChange]);
-      return <div data-testid="llm-panel" />;
-    }),
-  };
-});
-
-vi.mock('@/components/settings/InsightsSettingsPanel', () => ({
-  InsightsSettingsPanel: () => null,
-}));
-vi.mock('@/components/settings/TelemetrySettingsPanel', () => ({
-  TelemetrySettingsPanel: () => null,
-}));
-vi.mock('@/components/settings/UsagePanel', () => ({
-  UsagePanel: () => null,
-}));
-vi.mock('@/components/settings/WebSearchSettingsPanel', () => ({
-  WebSearchSettingsPanel: () => null,
-}));
-vi.mock('@/components/settings/SecuritySettingsPanel', () => ({
-  SecuritySettingsPanel: () => null,
-}));
-vi.mock('@/components/settings/SkillsSettingsPanel', () => ({
-  SkillsSettingsPanel: () => null,
-}));
-vi.mock('@/components/settings/McpSettingsPanel', () => ({
-  McpSettingsPanel: () => null,
-}));
-vi.mock('@/components/settings/AgentsSettingsPanel', () => ({
-  AgentsSettingsPanel: () => null,
-}));
-
-const { SettingsPage } = await import('./SettingsPage');
-
-function renderSettings(search = '') {
-  return render(
-    <MemoryRouter initialEntries={[`/settings${search}`]}>
-      <SettingsPage />
-    </MemoryRouter>,
-  );
-}
-
-afterEach(() => {
-  cleanup();
-  save.mockClear();
-});
-
-describe('SettingsPage header save', () => {
-  it('saves LLM settings from the general settings header', () => {
-    renderSettings();
-    fireEvent.click(screen.getByTestId('settings-header-save'));
-    expect(save).toHaveBeenCalledTimes(1);
-  });
-
-  it('does not show the header save on skills, MCP, or agents pages', () => {
-    const skills = renderSettings('?section=skills');
-    expect(screen.queryByTestId('settings-header-save')).toBeNull();
-    skills.unmount();
-    const mcp = renderSettings('?section=mcp');
-    expect(screen.queryByTestId('settings-header-save')).toBeNull();
-    mcp.unmount();
-    renderSettings('?section=agents');
-    expect(screen.queryByTestId('settings-header-save')).toBeNull();
-  });
-
-  it('orders general sections by how often they are used', () => {
-    renderSettings();
-    expect(screen.getByRole('heading', { name: '帮助改进产品' })).toBeTruthy();
-    expect(
-      [...document.querySelectorAll('[data-testid^="settings-section-"]')].map(
-        (el) => el.getAttribute('data-testid'),
-      ),
-    ).toEqual([
-      'settings-section-llm',
-      'settings-section-web-search',
-      'settings-section-usage',
-      'settings-section-diagnose',
-      'settings-section-security',
-      'settings-section-insights',
-      'settings-section-telemetry',
-    ]);
-  });
-});

package/vite.base.ts

@@ -1,94 +0,0 @@
-/**
- * 产品 web 构建的共享 vite 配置工厂（2.3）。
- *
- * 每个产品（products/<id>/web/）有自己的 vite 入口：index.html +
- * main.tsx（静态注册本产品的包渲染层贡献）+ vite.config.ts（调本工厂）。
- * 产品的编译单元只含自己的包——未激活包代码不进 bundle，不依赖树摇
- * 正确性（物理隔离与 node 侧对称）。
- *
- * Electron 加载产物时走 file:// 协议，必须用相对路径，否则资源 404。
- * dev server 跑在固定端口，主进程的 IS_DEV 分支 loadURL('http://localhost:5173')。
- */
-import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react';
-import tailwindcss from '@tailwindcss/vite';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { existsSync, readFileSync } from 'node:fs';
-
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-
-export interface ProductViteConfigOptions {
-  /** 产品目录（products/<id>/web 的上一级…即 products/<id>）。 */
-  productDir: string;
-  /** 产品 flavor（决定品牌 define 与激活包集合）。 */
-  flavor: string;
-}
-
-export function createProductViteConfig(options: ProductViteConfigOptions) {
-  const { productDir, flavor } = options;
-  const repoRoot = path.resolve(productDir, '../..');
-  // shell 渲染层源码锚到本包自身（3.2 起住在框架仓库
-  // packages/agent-shell/web/src），产品经 `@/` 别名引用。
-  const webSrcDir = path.resolve(HERE, 'src');
-  const readJson = (p: string) => JSON.parse(readFileSync(p, 'utf8'));
-
-  // 产品品牌（3.1）：product.json 的 brand 字段优先（无包产品的品牌
-  // 来源）；否则取激活包 pack.json 的 brand（0.3g 机制，读
-  // products/manifest.json 的 flavor→包映射，第一个带 brand 的包）。
-  // 都没有则用 shell 中性默认（Agent Shell）。
-  const productJsonPath = path.join(productDir, 'product.json');
-  const product = existsSync(productJsonPath) ? readJson(productJsonPath) : {};
-  const manifest = readJson(path.join(repoRoot, 'products/manifest.json'));
-  let packBrand: Record<string, string> | null = null;
-  for (const packId of manifest.flavors?.[flavor] ?? []) {
-    const pack = readJson(path.join(repoRoot, 'packages', `pack-${packId}`, 'pack.json'));
-    if (pack.brand) {
-      packBrand = pack.brand;
-      break;
-    }
-  }
-  const brand = product.brand ?? packBrand;
-
-  return defineConfig({
-    // root 默认取 config 文件所在目录（products/<id>/web）。
-    base: './',
-    plugins: [react(), tailwindcss()],
-    define: {
-      // 显式 define 让 flavor 条件在构建期可静态折叠。
-      'import.meta.env.VITE_APP_FLAVOR': JSON.stringify(flavor),
-      // 品牌 define：产品/包声明覆盖 shell 中性默认（Agent Shell）。
-      // logo 不走 define——资产必须静态 import 才进 bundle，由包 web 模块
-      // 在注册时经 setBrandLogoUrl 注入（本包 src/brand.ts）。
-      'import.meta.env.VITE_BRAND_NAME': JSON.stringify(brand?.displayName ?? 'Steerable Shell'),
-      'import.meta.env.VITE_BRAND_TAGLINE': JSON.stringify(brand?.tagline ?? '一款本地桌面 AI 伙伴'),
-      'import.meta.env.VITE_DEFAULT_AGENT_ID': JSON.stringify(brand?.defaultAgentId ?? 'local-assistant'),
-    },
-    resolve: {
-      alias: {
-        // shell 渲染层源码（产品入口与包 web 模块都以 `@/` 引用它）。
-        '@': webSrcDir,
-      },
-    },
-    // 静态资产（favicon 等中性默认）随 shell web 包分发；产品可在自己的
-    // web root 放 public/ 覆盖（vite 不合并双 publicDir——需要产品级资产
-    // 时在产品 vite.config 里显式覆盖本字段）。
-    publicDir: path.resolve(HERE, 'public'),
-    server: {
-      port: 5173,
-      strictPort: true,
-      host: '127.0.0.1',
-      // 产品 root 在 products/<id>/web；shell 渲染层源码在框架仓库
-      // （3.2 起经 file: 依赖符号链接）——两个根都放行。
-      fs: { allow: [repoRoot, path.resolve(webSrcDir, '..')] },
-    },
-    build: {
-      // 产物落在产品目录：products/<id>/web/dist（打包期被 electron-builder
-      // 映射为包内 web-dist/）。
-      outDir: 'dist',
-      emptyOutDir: true,
-      sourcemap: true,
-      target: 'chrome120',
-    },
-  });
-}