@steerable/agent-shell-web 0.6.15 → 0.6.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-shell-web",
-  "version": "0.6.15",
+  "version": "0.6.17",
   "type": "module",
   "description": "Steerable framework — product-neutral renderer SPA source for @steerable/agent-shell (React + Vite). Consumed by product web entry points via the `@/` alias (anchored at this package's src/) and the createProductViteConfig factory. Published as a source package (src/ + vite.base.ts), not a build artifact.",
   "license": "Apache-2.0",
@@ -14,13 +14,19 @@
     "url": "https://github.com/pathlyapp/steerable-framework/issues"
   },
   "exports": {
-    "./vite.base": "./vite.base.ts",
+    "./vite.base": {
+      "types": "./vite.base.d.ts",
+      "default": "./vite.base.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
     "public",
-    "vite.base.ts",
+    "vite.base.js",
+    "vite.base.d.ts",
     "README.md"
   ],
   "publishConfig": {
@@ -28,6 +34,8 @@
     "provenance": true
   },
   "dependencies": {
+    "@tailwindcss/vite": "^4.3.0",
+    "@vitejs/plugin-react": "^4.7.0",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/addon-web-links": "^0.12.0",
     "@xterm/xterm": "^6.0.0",
@@ -39,25 +47,24 @@
     "react-router-dom": "^6.30.0",
     "rehype-raw": "^7.0.0",
     "remark-gfm": "^4.0.1",
-    "@steerable/agent-protocol": "0.6.15",
-    "@steerable/agent-ui": "0.6.15"
+    "tailwindcss": "^4.3.0",
+    "vite": "^5.4.21",
+    "@steerable/agent-protocol": "0.6.17",
+    "@steerable/agent-ui": "0.6.17",
+    "@steerable/pack-sdk": "0.6.17"
   },
   "devDependencies": {
-    "@tailwindcss/vite": "^4.3.0",
     "@testing-library/react": "^16.1.0",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
-    "@vitejs/plugin-react": "^4.7.0",
     "happy-dom": "^15.11.7",
-    "tailwindcss": "^4.3.0",
     "typescript": "^5.8.3",
-    "vite": "^5.4.21",
-    "vitest": "^3.2.4",
-    "@steerable/pack-sdk": "0.6.15"
+    "vitest": "^3.2.4"
   },
   "scripts": {
     "gen": "echo agent-shell-web",
-    "build": "tsc --noEmit",
+    "build": "tsc --noEmit && npm run build:vite-base",
+    "build:vite-base": "tsc vite.base.ts --module esnext --target es2022 --moduleResolution bundler --declaration --skipLibCheck --outDir .",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "lint": "tsc --noEmit",

package/vite.base.d.ts

@@ -0,0 +1,7 @@
+export interface ProductViteConfigOptions {
+    /** 产品目录（products/<id>/web 的上一级…即 products/<id>）。 */
+    productDir: string;
+    /** 产品 flavor（决定品牌 define 与激活包集合）。 */
+    flavor: string;
+}
+export declare function createProductViteConfig(options: ProductViteConfigOptions): import("vite").UserConfig;

package/vite.base.js

@@ -0,0 +1,83 @@
+/**
+ * 产品 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 function createProductViteConfig(options) {
+    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) => 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 = 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',
+        },
+    });
+}

package/src/brand.test.ts

@@ -1,22 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { LOCAL_ASSISTANT_AGENT_ID, pickDefaultAgentId } from './brand';
-
-describe('pickDefaultAgentId', () => {
-  const catalog = [
-    { id: LOCAL_ASSISTANT_AGENT_ID },
-    { id: 'data-analyst' },
-    { id: 'all-round-assistant' },
-  ];
-
-  it('returns null when the catalog is empty', () => {
-    expect(pickDefaultAgentId([])).toBeNull();
-  });
-
-  it('prefers the build-time default (shell: 电脑操作员) even when it is not first', () => {
-    expect(pickDefaultAgentId(catalog)).toBe(LOCAL_ASSISTANT_AGENT_ID);
-  });
-
-  it('falls back to the first visible agent when the build default is absent', () => {
-    expect(pickDefaultAgentId([{ id: 'writer' }, { id: 'reader' }])).toBe('writer');
-  });
-});

package/src/components/AgentSidebar.test.tsx

@@ -1,127 +0,0 @@
-import { cleanup, fireEvent, render, screen } from '@testing-library/react';
-import { MemoryRouter, Outlet, Route, Routes, useLocation } from 'react-router-dom';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import type { UseChatsAndAgentsResult } from '@/hooks/useChatsAndAgents';
-import type { LocalChat, LocalChatAgent } from '@/lib/local-api';
-
-vi.mock('@/lib/electron-bridge', () => ({
-  isElectron: () => false,
-  getElectronBridge: () => null,
-}));
-
-vi.mock('@/brand', () => ({
-  BRAND_NAME: '测试助手',
-  getBrandLogoUrl: () => 'data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg"/>',
-}));
-
-const { AgentSidebar } = await import('./AgentSidebar');
-
-afterEach(() => cleanup());
-
-const agent: LocalChatAgent = {
-  id: 'local-assistant',
-  slug: 'local-assistant',
-  name: '电脑操作员',
-  icon: null,
-  color: '#4f46e5',
-  description: null,
-  rolePrompt: null,
-  isBuiltin: true,
-};
-
-const existingChat: LocalChat = {
-  id: 'chat-with-content',
-  projectId: null,
-  userId: 'local',
-  title: '已经聊过的对话',
-  agentId: agent.id,
-  createdAt: '2026-01-01T00:00:00.000Z',
-  updatedAt: '2026-01-01T00:01:00.000Z',
-  isPinned: false,
-  systemPrompt: null,
-  pinnedRefs: null,
-};
-
-function LocationProbe() {
-  const loc = useLocation();
-  return (
-    <div data-testid="loc">
-      {loc.pathname}
-      {loc.search}
-    </div>
-  );
-}
-
-function renderSidebar(
-  initialEntry: string,
-  createChat = vi.fn(),
-) {
-  const data: UseChatsAndAgentsResult = {
-    chats: [existingChat],
-    agents: [agent],
-    isLoading: false,
-    error: null,
-    selectedAgentId: agent.id,
-    setSelectedAgentId: vi.fn(),
-    refreshChats: vi.fn(async () => {}),
-    refreshAgents: vi.fn(async () => {}),
-    createChat,
-    deleteChat: vi.fn(async () => true),
-    patchChatTitle: vi.fn(),
-    isLoadingMoreChats: false,
-    hasMoreChats: false,
-    loadMoreChats: vi.fn(async () => {}),
-  };
-
-  render(
-    <MemoryRouter initialEntries={[initialEntry]}>
-      <Routes>
-        <Route
-          element={
-            <>
-              <AgentSidebar
-                data={data}
-                rightPanel={null}
-                onToggleRightPanel={() => {}}
-                chatSlots={[]}
-                onCollapse={() => {}}
-              />
-              <LocationProbe />
-              <Outlet />
-            </>
-          }
-        >
-          <Route path="/" element={<div />} />
-          <Route path="/agent" element={<div />} />
-          <Route path="/agent/:chatId" element={<div />} />
-          <Route path="/settings" element={<div />} />
-        </Route>
-      </Routes>
-    </MemoryRouter>,
-  );
-
-  return { createChat };
-}
-
-describe('AgentSidebar 新对话不落库', () => {
-  it('打开落地页且不调用 createChat', () => {
-    const { createChat } = renderSidebar('/agent/chat-with-content');
-    fireEvent.click(screen.getByTestId('sidebar-new-chat'));
-    expect(createChat).not.toHaveBeenCalled();
-    expect(screen.getByTestId('loc').textContent).toBe('/agent');
-  });
-
-  it('连点两次也不会多出侧栏行', () => {
-    renderSidebar('/agent');
-    const before = screen.getAllByTestId('sidebar-chat-row').length;
-    fireEvent.click(screen.getByTestId('sidebar-new-chat'));
-    fireEvent.click(screen.getByTestId('sidebar-new-chat'));
-    expect(screen.getAllByTestId('sidebar-chat-row')).toHaveLength(before);
-  });
-
-  it('打开智能体管理页', () => {
-    renderSidebar('/agent');
-    fireEvent.click(screen.getByTestId('sidebar-agent-settings'));
-    expect(screen.getByTestId('loc').textContent).toBe('/settings?section=agents');
-  });
-});

package/src/components/ChatHeader.test.tsx

@@ -1,230 +0,0 @@
-/**
- * ChatHeader 任务角标契约：后台任务在面板关着的时候也要能被看见，
- * 且只有一件事等着处理时点角标要能跳过任务列表这一层。
- *   - 无任务 → 按钮保持素净，不显示计数；
- *   - 有任务 → 按钮上色 + 计数，配色按「该不该现在看一眼」取最高优先级
- *     （运行中 > 待合并 > 失败 > 全部跑完）；
- *   - 唯一失败任务 → 点角标直接开推理过程，不经弹层；
- *   - 唯一待合并任务 → 点角标开弹层并展开该行（合并/丢弃按钮在那儿）；
- *   - 有任务在跑或多件待处理 → 仍然先给列表，用户得先挑。
- * 列表本身的订阅与刷新归 useChatTasks，见 chat/useChatTasks.test.ts。
- */
-import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import type { LocalChat, LocalTask } from '@/lib/local-api';
-import { ChatHeader } from './ChatHeader';
-
-afterEach(() => {
-  cleanup();
-  delete (window as { electron?: unknown }).electron;
-});
-
-const CHAT: LocalChat = {
-  id: 'chat_1',
-  projectId: null,
-  userId: 'u1',
-  title: '循环任务',
-  agentId: null,
-  createdAt: '2026-09-13T01:00:00.000Z',
-  updatedAt: '2026-09-13T01:00:00.000Z',
-  isPinned: false,
-  systemPrompt: null,
-  pinnedRefs: null,
-};
-
-function makeTask(overrides: Partial<LocalTask> = {}): LocalTask {
-  return {
-    id: 'task-1',
-    chatId: 'chat_1',
-    task: '每 5 分钟问好',
-    status: 'completed',
-    answer: '你好',
-    error: null,
-    worktreePath: null,
-    worktreeBranch: null,
-    worktreeState: null,
-    createdAt: '2026-09-13T01:00:00.000Z',
-    updatedAt: '2026-09-13T01:01:00.000Z',
-    ...overrides,
-  };
-}
-
-/** 弹层自带订阅：展开它的用例需要一个能应答 GET /tasks 的 bridge。 */
-function installBridge(tasks: LocalTask[]) {
-  (window as { electron?: unknown }).electron = {
-    localBackend: {
-      request: vi.fn((input: { method: string; path: string }) => {
-        if (input.method === 'GET' && input.path.endsWith('/tasks')) {
-          return Promise.resolve({ tasks });
-        }
-        return Promise.reject(new Error(`unexpected request: ${input.path}`));
-      }),
-    },
-    onTaskUpdated: () => () => {},
-  };
-}
-
-function taskButton() {
-  return screen.getByRole('button', { name: /后台任务/ });
-}
-
-describe('ChatHeader 后台任务角标', () => {
-  it('没有任务时不显示计数', () => {
-    render(<ChatHeader chat={CHAT} agent={null} tasks={[]} />);
-
-    expect(taskButton().getAttribute('data-task-state')).toBeNull();
-    expect(taskButton().textContent).toBe('');
-  });
-
-  it('有运行中的任务时显示运行中计数并标成 running', () => {
-    render(
-      <ChatHeader
-        chat={CHAT}
-        agent={null}
-        tasks={[
-          makeTask({ id: 'a', status: 'running' }),
-          makeTask({ id: 'b', status: 'running' }),
-          makeTask({ id: 'c', status: 'completed' }),
-        ]}
-      />,
-    );
-
-    expect(taskButton().getAttribute('data-task-state')).toBe('running');
-    expect(taskButton().textContent).toBe('2');
-    expect(taskButton().getAttribute('title')).toBe('共 3 个后台任务（2 个运行中）');
-  });
-
-  it('等依赖的任务也算在推进中', () => {
-    render(
-      <ChatHeader chat={CHAT} agent={null} tasks={[makeTask({ id: 'a', status: 'blocked' })]} />,
-    );
-
-    expect(taskButton().getAttribute('data-task-state')).toBe('running');
-    expect(taskButton().getAttribute('title')).toBe('共 1 个后台任务（1 个等依赖）');
-  });
-
-  it('待合并的 worktree 任务优先于失败任务上色', () => {
-    render(
-      <ChatHeader
-        chat={CHAT}
-        agent={null}
-        tasks={[
-          makeTask({ id: 'a', status: 'completed', worktreeState: 'pending' }),
-          makeTask({ id: 'b', status: 'failed', error: '炸了' }),
-        ]}
-      />,
-    );
-
-    expect(taskButton().getAttribute('data-task-state')).toBe('review');
-    expect(taskButton().textContent).toBe('1');
-    expect(taskButton().getAttribute('title')).toBe('共 2 个后台任务（1 个待合并，1 个失败）');
-  });
-
-  it('只有失败任务时标成 failed', () => {
-    render(
-      <ChatHeader
-        chat={CHAT}
-        agent={null}
-        tasks={[makeTask({ id: 'a', status: 'failed', error: '炸了' })]}
-      />,
-    );
-
-    expect(taskButton().getAttribute('data-task-state')).toBe('failed');
-  });
-
-  it('全部跑完时显示总数，不再抢注意力', () => {
-    render(
-      <ChatHeader chat={CHAT} agent={null} tasks={[makeTask({ id: 'a' }), makeTask({ id: 'b' })]} />,
-    );
-
-    expect(taskButton().getAttribute('data-task-state')).toBe('idle');
-    expect(taskButton().textContent).toBe('2');
-  });
-});
-
-describe('ChatHeader 角标直达', () => {
-  it('唯一失败任务：点角标直接开推理过程，不开弹层', () => {
-    const onInspectTask = vi.fn();
-    render(
-      <ChatHeader
-        chat={CHAT}
-        agent={null}
-        onInspectTask={onInspectTask}
-        tasks={[makeTask({ id: 'a', status: 'failed', task: '跑测试', error: '炸了' })]}
-      />,
-    );
-
-    expect(taskButton().getAttribute('data-task-shortcut')).toBe('process');
-    expect(taskButton().getAttribute('title')).toContain('点击查看推理过程');
-
-    fireEvent.click(taskButton());
-
-    expect(onInspectTask).toHaveBeenCalledWith({
-      id: 'a',
-      chatId: 'chat_1',
-      title: '跑测试',
-    });
-    expect(document.querySelector('[data-task-panel-modal]')).toBeNull();
-  });
-
-  it('唯一待合并任务：点角标开弹层并展开该行', async () => {
-    const task = makeTask({
-      id: 'a',
-      status: 'completed',
-      worktreeState: 'pending',
-      worktreePath: '/tmp/wt',
-      worktreeBranch: 'steerable/a',
-    });
-    installBridge([task]);
-    render(<ChatHeader chat={CHAT} agent={null} onInspectTask={vi.fn()} tasks={[task]} />);
-
-    expect(taskButton().getAttribute('data-task-shortcut')).toBe('expand');
-    expect(taskButton().getAttribute('title')).toContain('点击处理 worktree');
-
-    fireEvent.click(taskButton());
-
-    // 展开态的标志：worktree 的「合并到主仓」按钮直接可见，不用再点一次。
-    await waitFor(() => expect(document.querySelector('[data-task-merge]')).not.toBeNull());
-  });
-
-  it('有任务在跑时不直达——先给列表', () => {
-    const onInspectTask = vi.fn();
-    render(
-      <ChatHeader
-        chat={CHAT}
-        agent={null}
-        onInspectTask={onInspectTask}
-        tasks={[
-          makeTask({ id: 'a', status: 'failed', error: '炸了' }),
-          makeTask({ id: 'b', status: 'running' }),
-        ]}
-      />,
-    );
-
-    expect(taskButton().getAttribute('data-task-shortcut')).toBeNull();
-    expect(taskButton().getAttribute('title')).not.toContain('点击');
-  });
-
-  it('多件待处理时不直达——用户得先挑', () => {
-    const onInspectTask = vi.fn();
-    installBridge([]);
-    render(
-      <ChatHeader
-        chat={CHAT}
-        agent={null}
-        onInspectTask={onInspectTask}
-        tasks={[
-          makeTask({ id: 'a', status: 'failed', error: '炸了' }),
-          makeTask({ id: 'b', status: 'failed', error: '也炸了' }),
-        ]}
-      />,
-    );
-
-    expect(taskButton().getAttribute('data-task-shortcut')).toBeNull();
-
-    fireEvent.click(taskButton());
-
-    expect(onInspectTask).not.toHaveBeenCalled();
-    expect(document.querySelector('[data-task-panel-modal]')).not.toBeNull();
-  });
-});