@steerable/agent-shell-web 0.6.15

package/LICENSE

@@ -0,0 +1,91 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form.
+
+"Work" shall mean the work of authorship made available under the
+License.
+
+"Derivative Works" shall mean any work based on the Work.
+
+"Contribution" shall mean any work of authorship intentionally
+submitted to Licensor for inclusion in the Work.
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor.
+
+2. Grant of Copyright License.
+Subject to the terms and conditions of this License, each Contributor
+hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+royalty-free, irrevocable copyright license to reproduce, prepare
+Derivative Works of, publicly display, publicly perform, sublicense,
+and distribute the Work and such Derivative Works in Source or Object
+form.
+
+3. Grant of Patent License.
+Subject to the terms and conditions of this License, each Contributor
+hereby grants to You a perpetual, worldwide, non-exclusive, no-charge,
+royalty-free, irrevocable patent license to make, have made, use,
+offer to sell, sell, import, and otherwise transfer the Work.
+
+4. Redistribution.
+You may reproduce and distribute copies of the Work or Derivative
+Works thereof in any medium, with or without modifications, and in
+Source or Object form, provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative
+Works a copy of this License; and
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+(c) You must retain, in the Source form of any Derivative Works that
+You distribute, all copyright, patent, trademark, and attribution
+notices from the Source form of the Work; and
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, then any Derivative Works that You distribute must
+include a readable copy of the attribution notices contained within
+such NOTICE file.
+
+5. Submission of Contributions.
+Unless You explicitly state otherwise, any Contribution intentionally
+submitted for inclusion in the Work shall be under the terms and
+conditions of this License.
+
+6. Trademarks.
+This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor.
+
+7. Disclaimer of Warranty.
+Unless required by applicable law or agreed to in writing, Licensor
+provides the Work on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS
+OF ANY KIND.
+
+8. Limitation of Liability.
+In no event and under no legal theory shall any Contributor be liable
+to You for damages arising as a result of this License or out of the
+use or inability to use the Work.
+
+9. Accepting Warranty or Additional Liability.
+While redistributing the Work or Derivative Works thereof, You may
+choose to offer, and charge a fee for, acceptance of support, warranty,
+indemnity, or other liability obligations.

package/README.md

@@ -0,0 +1,20 @@
+# @steerable/agent-shell-web
+
+Product-neutral renderer SPA source for `@steerable/agent-shell` (React + Vite).
+
+This is a **source package**, not a build artifact. Product web entry points
+consume it via the `@/` alias (anchored at this package's `src/`) and the
+`createProductViteConfig` factory exported from `./vite.base`:
+
+```ts
+import { createProductViteConfig } from '@steerable/agent-shell-web/vite.base';
+
+export default createProductViteConfig({ productDir, flavor });
+```
+
+The product's Vite build compiles this package's `src/` into the product's own
+bundle; there is no prebuilt `dist/` here. See
+[`docs/spec/architecture.md`](https://github.com/pathlyapp/steerable-framework/blob/develop/docs/spec/architecture.md)
+for the tier model.
+
+License: Apache-2.0.

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@steerable/agent-shell-web",
+  "version": "0.6.15",
+  "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",
+  "homepage": "https://steerableframework.com/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pathlyapp/steerable-framework.git",
+    "directory": "packages/agent-shell/web"
+  },
+  "bugs": {
+    "url": "https://github.com/pathlyapp/steerable-framework/issues"
+  },
+  "exports": {
+    "./vite.base": "./vite.base.ts",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "public",
+    "vite.base.ts",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/addon-web-links": "^0.12.0",
+    "@xterm/xterm": "^6.0.0",
+    "framer-motion": "^12.38.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-icons": "^5.5.0",
+    "react-markdown": "^10.1.0",
+    "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"
+  },
+  "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"
+  },
+  "scripts": {
+    "gen": "echo agent-shell-web",
+    "build": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "check:drift": "echo ok",
+    "app:build": "vite build --config vite.app.config.ts",
+    "app:build:demo": "vite build --config vite.demo.config.ts",
+    "app:dev": "vite --config vite.app.config.ts"
+  }
+}

package/src/AppShell.tsx

@@ -0,0 +1,24 @@
+import { Outlet } from 'react-router-dom';
+import { isElectron } from './lib/electron-bridge';
+import { isDemoMode } from './lib/demo-flag';
+
+export function AppShell() {
+  return (
+    <div className="flex h-full w-full flex-col bg-agent-canvas text-agent-foreground">
+      <main className="flex flex-1 overflow-hidden">
+        <Outlet />
+      </main>
+      {isDemoMode() ? (
+        <div className="border-t border-agent-border bg-agent-muted px-3 py-1 text-xs text-agent-muted-foreground">
+          Demo &middot; simulated data, no live model
+        </div>
+      ) : (
+        !isElectron() && (
+          <div className="border-t border-agent-border bg-agent-muted px-3 py-1 text-xs text-agent-muted-foreground">
+            Browser preview mode &middot; running outside Electron, IPC bridge unavailable
+          </div>
+        )
+      )}
+    </div>
+  );
+}

package/src/brand.test.ts

@@ -0,0 +1,22 @@
+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/brand.ts

@@ -0,0 +1,48 @@
+/**
+ * 渲染进程品牌单一真源。品牌文案在 web 构建时由产品 vite 配置注入
+ * （VITE_BRAND_* define：product.json brand 优先，其次激活包 pack.json
+ * brand，3.1）；logo 资产由激活包的 web 模块在注册时经
+ * setBrandLogoUrl() 注入（资产静态 import 在包内，只进本产品 bundle）。
+ * 未注入时一律回落到 shell 中性默认（Steerable Shell / generic logo）。
+ * 主进程侧对应物见 src/brand.ts。
+ */
+import shellLogoUrl from '@/assets/logo-generic.png';
+
+/** 当前构建的 flavor（开放字符串，0.3g 起不再是二值联合）。 */
+export const APP_FLAVOR: string = import.meta.env.VITE_APP_FLAVOR ?? 'generic';
+
+export const LOCAL_ASSISTANT_AGENT_ID = 'local-assistant';
+
+export const BRAND_NAME: string = import.meta.env.VITE_BRAND_NAME ?? 'Steerable Shell';
+
+/** shell 默认 logo（中性通用图标）；包品牌 logo 由包 web 模块注册覆盖。 */
+let brandLogoUrl: string = shellLogoUrl;
+
+/**
+ * 注册产品品牌 logo（包的 register*Renderer() 在 bootstrap 前调用）。
+ * 重复注册抛错（组装期笔误，fail fast——与 node 侧 setProductBrand 同语义）。
+ */
+export function setBrandLogoUrl(url: string): void {
+  if (brandLogoUrl !== shellLogoUrl && brandLogoUrl !== url) {
+    throw new Error('[brand] logo already set');
+  }
+  brandLogoUrl = url;
+}
+
+/** 当前产品品牌 logo（bootstrap 之后读取——包的注册已完成）。 */
+export function getBrandLogoUrl(): string {
+  return brandLogoUrl;
+}
+
+/** 首页 / 新对话未选手动专家时绑定的内置智能体（包品牌可覆盖）。 */
+export const DEFAULT_AGENT_ID: string =
+  import.meta.env.VITE_DEFAULT_AGENT_ID ?? LOCAL_ASSISTANT_AGENT_ID;
+
+/**
+ * 从当前可见专家目录里挑默认 id：优先当前构建的默认智能体（包品牌经
+ * VITE_DEFAULT_AGENT_ID 注入），缺席则退回列表第一项。
+ */
+export function pickDefaultAgentId(agents: ReadonlyArray<{ id: string }>): string | null {
+  if (agents.length === 0) return null;
+  return agents.some((agent) => agent.id === DEFAULT_AGENT_ID) ? DEFAULT_AGENT_ID : agents[0].id;
+}

package/src/components/AgentSidebar.test.tsx

@@ -0,0 +1,127 @@
+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');
+  });
+});