@steerable/agent-shell-web 0.6.55 → 0.6.57

package/src/components/settings/McpSettingsPanel.tsx

@@ -10,7 +10,7 @@ import {
   LuTrash2,
 } from 'react-icons/lu';
 import { t } from '@/i18n';
-import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
+import { getHostBridge, hasHostBridge } from '@/lib/host-bridge';
 
 /**
  * McpSettingsPanel — MCP 服务管理面板（JSON 导入 / 手动增改 / 启停 / 测试 /
@@ -19,8 +19,8 @@ import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
  * 渲染在 `/settings?section=plugins` 的 MCP 分类（AgentLayout 右侧内容区）。
  *
  * 数据与状态完全自管理：挂载时拉一次列表，操作后刷新。后端走
- * local-backend REST（`/api/v2/mcp/servers*`），注册表持久化在 main 进程的
- * electron-store（`agent-mcp-servers.json`），无专用 IPC channel。
+ * local-backend REST（`/api/v2/mcp/servers*`），注册表持久化在用户数据目录的
+ * `agent-mcp-servers.json`。
  */
 
 /** GET /api/v2/mcp/servers 返回的服务条目（含工具缓存状态）。 */
@@ -68,11 +68,11 @@ export function McpSettingsPanel() {
   const [error, setError] = useState<string | null>(null);
 
   const fetchMcpServers = useCallback(async () => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     setMcpLoading(true);
     setError(null);
     try {
-      const res = await getElectronBridge()!.localBackend.request<{ servers: McpServerInfo[] }>({
+      const res = await getHostBridge()!.localBackend.request<{ servers: McpServerInfo[] }>({
         method: 'GET',
         path: '/api/v2/mcp/servers',
       });
@@ -116,7 +116,7 @@ export function McpSettingsPanel() {
   };
 
   const handleSaveMcpServer = async () => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     setMcpSaving(true);
     setError(null);
     try {
@@ -142,13 +142,13 @@ export function McpSettingsPanel() {
             bearerTokenEnvVar: mcpFormBearerEnv.trim() || undefined,
           };
       if (mcpEditingId) {
-        await getElectronBridge()!.localBackend.request({
+        await getHostBridge()!.localBackend.request({
           method: 'PUT',
           path: `/api/v2/mcp/servers/${encodeURIComponent(mcpEditingId)}`,
           body,
         });
       } else {
-        await getElectronBridge()!.localBackend.request({
+        await getHostBridge()!.localBackend.request({
           method: 'POST',
           path: '/api/v2/mcp/servers',
           body,
@@ -188,7 +188,7 @@ export function McpSettingsPanel() {
   const handleToggleMcpServer = async (server: McpServerInfo) => {
     setError(null);
     try {
-      await getElectronBridge()!.localBackend.request({
+      await getHostBridge()!.localBackend.request({
         method: 'PUT',
         path: `/api/v2/mcp/servers/${encodeURIComponent(server.id)}`,
         body: { enabled: !server.enabled },
@@ -203,7 +203,7 @@ export function McpSettingsPanel() {
     setMcpDeletingId(server.id);
     setError(null);
     try {
-      await getElectronBridge()!.localBackend.request({
+      await getHostBridge()!.localBackend.request({
         method: 'DELETE',
         path: `/api/v2/mcp/servers/${encodeURIComponent(server.id)}`,
       });
@@ -219,7 +219,7 @@ export function McpSettingsPanel() {
     setMcpTestingId(server.id);
     setError(null);
     try {
-      const res = await getElectronBridge()!.localBackend.request<{
+      const res = await getHostBridge()!.localBackend.request<{
         success: boolean;
         toolCount: number;
         tools: { name: string }[];
@@ -245,7 +245,7 @@ export function McpSettingsPanel() {
     setMcpImporting(true);
     setError(null);
     try {
-      const res = await getElectronBridge()!.localBackend.request<{
+      const res = await getHostBridge()!.localBackend.request<{
         added: { name: string }[];
         skipped: string[];
       }>({

package/src/components/settings/PythonRunnerSettingsPanel.tsx

@@ -2,9 +2,9 @@ import { useEffect, useState } from 'react';
 import { LuCodeXml } from 'react-icons/lu';
 import { t } from '@/i18n';
 import {
-  getElectronBridge,
+  getHostBridge,
   type PythonRunnerSnapshot,
-} from '@/lib/electron-bridge';
+} from '@/lib/host-bridge';
 
 type Source = PythonRunnerSnapshot['source'];
 
@@ -20,7 +20,7 @@ export function PythonRunnerSettingsPanel() {
   const [localPath, setLocalPath] = useState('');
 
   useEffect(() => {
-    const runner = getElectronBridge()?.pythonRunner;
+    const runner = getHostBridge()?.pythonRunner;
     if (!runner) return;
     let alive = true;
     void runner.snapshot().then((next) => {
@@ -39,7 +39,7 @@ export function PythonRunnerSettingsPanel() {
   }, []);
 
   if (!snapshot?.supported) return null;
-  const runner = getElectronBridge()?.pythonRunner;
+  const runner = getHostBridge()?.pythonRunner;
   const busy =
     snapshot.phase === 'downloading'
     || snapshot.phase === 'verifying'

package/src/components/settings/SecuritySettingsPanel.tsx

@@ -1,7 +1,7 @@
 import { useCallback, useEffect, useState } from 'react';
 import { LuLoaderCircle, LuShieldCheck } from 'react-icons/lu';
 import { t } from '@/i18n';
-import { isElectron } from '@/lib/electron-bridge';
+import { hasHostBridge } from '@/lib/host-bridge';
 import {
   getSidecarSandboxPosture,
   type EgressPosture,
@@ -109,7 +109,7 @@ export function SecuritySettingsPanel() {
   const [unavailable, setUnavailable] = useState<string | null>(null);
 
   const fetchPosture = useCallback(async () => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     setLoading(true);
     setUnavailable(null);
     try {
@@ -141,7 +141,7 @@ export function SecuritySettingsPanel() {
         {t('Sidecar process sandbox')}
       </h4>
 
-      {!isElectron() ? (
+      {!hasHostBridge() ? (
         <p className="text-[11px] text-agent-muted-foreground">{t('Open this in the desktop app')}</p>
       ) : loading ? (
         <div className="flex items-center gap-2 py-2 text-xs text-agent-muted-foreground">

package/src/components/settings/SkillsSettingsPanel.tsx

@@ -6,7 +6,7 @@ import {
   LuTrash2,
 } from 'react-icons/lu';
 import { t } from '@/i18n';
-import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
+import { getHostBridge, hasHostBridge } from '@/lib/host-bridge';
 import { getPackHiddenSlashSkills } from '@/packs/registry';
 
 /**
@@ -59,11 +59,11 @@ export function SkillsSettingsPanel() {
   const [error, setError] = useState<string | null>(null);
 
   const fetchSkills = useCallback(async () => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     setSkillsLoading(true);
     setError(null);
     try {
-      const res = await getElectronBridge()!.localBackend.request<{ skills: any[] }>({
+      const res = await getHostBridge()!.localBackend.request<{ skills: any[] }>({
         method: 'GET',
         path: '/api/v2/chat-agents/skills',
       });
@@ -81,9 +81,9 @@ export function SkillsSettingsPanel() {
   }, [fetchSkills]);
 
   const handleBrowseFolder = async () => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     try {
-      const bridge = getElectronBridge();
+      const bridge = getHostBridge();
       if (bridge?.local?.selectDirectory) {
         setImportStatus(t('Opening folder picker...'));
         const result = await bridge.local.selectDirectory();
@@ -110,7 +110,7 @@ export function SkillsSettingsPanel() {
     setError(null);
     setImportStatus(t('Importing local skill...'));
     try {
-      const res = await getElectronBridge()!.localBackend.request<{ success: boolean; name: string }>({
+      const res = await getHostBridge()!.localBackend.request<{ success: boolean; name: string }>({
         method: 'POST',
         path: '/api/v2/chat-agents/skills/import',
         body: { path: trimmed },
@@ -137,7 +137,7 @@ export function SkillsSettingsPanel() {
     setDeletingName(name);
     setError(null);
     try {
-      const res = await getElectronBridge()!.localBackend.request<{ success: boolean }>({
+      const res = await getHostBridge()!.localBackend.request<{ success: boolean }>({
         method: 'DELETE',
         path: `/api/v2/chat-agents/skills/delete/${encodeURIComponent(name)}`,
       });

package/src/components/settings/TelemetrySettingsPanel.tsx

@@ -1,7 +1,7 @@
 import { useCallback, useEffect, useState } from 'react';
 import { LuLoaderCircle, LuActivity } from 'react-icons/lu';
 import { t } from '@/i18n';
-import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
+import { getHostBridge, hasHostBridge } from '@/lib/host-bridge';
 
 /**
  * TelemetrySettingsPanel — W6-6 遥测合规化的桌面 collector 配置面板。
@@ -36,11 +36,11 @@ export function TelemetrySettingsPanel() {
   const [error, setError] = useState<string | null>(null);
 
   const fetchSettings = useCallback(async () => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     setLoading(true);
     setError(null);
     try {
-      const res = await getElectronBridge()!.localBackend.request<TelemetrySettingsWire | null>({
+      const res = await getHostBridge()!.localBackend.request<TelemetrySettingsWire | null>({
         method: 'GET',
         path: '/api/v2/local-settings/telemetry',
       });
@@ -58,12 +58,12 @@ export function TelemetrySettingsPanel() {
   }, [fetchSettings]);
 
   const handleSave = async () => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     setSaving(true);
     setError(null);
     setStatus(null);
     try {
-      const saved = await getElectronBridge()!.localBackend.request<TelemetrySettingsWire>({
+      const saved = await getHostBridge()!.localBackend.request<TelemetrySettingsWire>({
         method: 'POST',
         path: '/api/v2/local-settings/telemetry',
         body: { endpoint: endpoint.trim(), privacyMode },

package/src/components/settings/UsagePanel.tsx

@@ -1,7 +1,7 @@
 import { useCallback, useEffect, useState } from 'react';
 import { LuLoaderCircle, LuChartBar, LuRefreshCw } from 'react-icons/lu';
 import { t } from '@/i18n';
-import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
+import { getHostBridge, hasHostBridge } from '@/lib/host-bridge';
 
 /**
  * UsagePanel — W6-9 用量与成本归因的桌面面板。
@@ -66,11 +66,11 @@ export function UsagePanel() {
   const [error, setError] = useState<string | null>(null);
 
   const fetchSummary = useCallback(async (windowDays: number) => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     setLoading(true);
     setError(null);
     try {
-      const res = await getElectronBridge()!.localBackend.request<UsageSummaryWire>({
+      const res = await getHostBridge()!.localBackend.request<UsageSummaryWire>({
         method: 'GET',
         path: `/api/v2/usage/summary?days=${windowDays}`,
       });

package/src/components/settings/WebSearchSettingsPanel.tsx

@@ -1,7 +1,7 @@
 import { useCallback, useEffect, useState } from 'react';
 import { LuLoaderCircle, LuSearch } from 'react-icons/lu';
 import { t } from '@/i18n';
-import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
+import { getHostBridge, hasHostBridge } from '@/lib/host-bridge';
 
 /**
  * Search backend settings. `ddg` registers `web_search` with no key.
@@ -33,11 +33,11 @@ export function WebSearchSettingsPanel() {
   const [error, setError] = useState<string | null>(null);
 
   const fetchSettings = useCallback(async () => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     setLoading(true);
     setError(null);
     try {
-      const res = await getElectronBridge()!.localBackend.request<WebSearchSettingsWire | null>({
+      const res = await getHostBridge()!.localBackend.request<WebSearchSettingsWire | null>({
         method: 'GET',
         path: '/api/v2/local-settings/web-search',
       });
@@ -55,13 +55,13 @@ export function WebSearchSettingsPanel() {
   }, [fetchSettings]);
 
   const handleSave = async () => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     setSaving(true);
     setError(null);
     setStatus(null);
     try {
       const posted = provider;
-      const saved = await getElectronBridge()!.localBackend.request<WebSearchSettingsWire>({
+      const saved = await getHostBridge()!.localBackend.request<WebSearchSettingsWire>({
         method: 'POST',
         path: '/api/v2/local-settings/web-search',
         body: { provider: posted, apiKey: apiKey.trim() },

package/src/hooks/useChatsAndAgents.ts

@@ -8,7 +8,7 @@
  * adapter:
  *   - It wires the framework hook to the local-backend transport
  *     (`@/lib/local-api`).
- *   - It gates everything behind `isElectron()` so a renderer running in a
+ *   - It gates everything behind `hasHostBridge()` so a renderer running in a
  *     plain browser doesn't fire requests.
  *   - It keeps the legacy `UseChatsAndAgentsResult` shape so callers
  *     (`AgentLayout`, `useChatsAndAgents()` consumers) don't change.
@@ -35,7 +35,7 @@ import {
   type LocalChat,
   type LocalChatAgent,
 } from '@/lib/local-api';
-import { isElectron } from '@/lib/electron-bridge';
+import { hasHostBridge } from '@/lib/host-bridge';
 import { pickDefaultAgentId } from '@/brand';
 
 const CHAT_PAGE_SIZE = 50;
@@ -66,12 +66,12 @@ export interface UseChatsAndAgentsResult {
 }
 
 export function useChatsAndAgents(): UseChatsAndAgentsResult {
-  const isElectronRef = useRef(isElectron());
+  const hasHostBridgeRef = useRef(hasHostBridge());
 
   const transport = useMemo<ChatListTransport<LocalChat, LocalChatAgent>>(
     () => ({
       listChats: async ({ page, pageSize }) => {
-        if (!isElectronRef.current) return { chats: [], hasMore: false };
+        if (!hasHostBridgeRef.current) return { chats: [], hasMore: false };
         const data = await listChats({ page, limit: pageSize });
         return {
           chats: data.chats,
@@ -79,13 +79,13 @@ export function useChatsAndAgents(): UseChatsAndAgentsResult {
         };
       },
       listAgents: async () => {
-        if (!isElectronRef.current) return [];
+        if (!hasHostBridgeRef.current) return [];
         const data = await listChatAgents(false);
         return data.agents;
       },
       createChat: async ({ agentId, projectId }) => {
-        if (!isElectronRef.current) {
-          throw new Error('not in electron');
+        if (!hasHostBridgeRef.current) {
+          throw new Error('not connected to the host');
         }
         const res = await apiCreateChat({
           ...(agentId ? { agentId } : {}),
@@ -94,7 +94,7 @@ export function useChatsAndAgents(): UseChatsAndAgentsResult {
         return res.chatId;
       },
       deleteChat: async (chatId) => {
-        if (!isElectronRef.current) return false;
+        if (!hasHostBridgeRef.current) return false;
         await apiDeleteChat(chatId);
         return true;
       },
@@ -110,7 +110,7 @@ export function useChatsAndAgents(): UseChatsAndAgentsResult {
     pageSize: CHAT_PAGE_SIZE,
     // The renderer mounts before electron decides whether the bridge is live;
     // skip the auto-fetch and trigger it manually after the SSR no-op check.
-    skipInitialLoad: !isElectronRef.current,
+    skipInitialLoad: !hasHostBridgeRef.current,
   });
 
   // Default-select this flavor's builtin expert once the catalog loads.

package/src/hooks/useProjects.ts

@@ -3,7 +3,7 @@
  * 任一侧新建、改名或改目录后调用 refresh，其它订阅者一起更新。
  */
 import { useCallback, useEffect, useSyncExternalStore } from 'react';
-import { isElectron } from '@/lib/electron-bridge';
+import { hasHostBridge } from '@/lib/host-bridge';
 import { hostToolChrome } from '@/lib/host-tools';
 import { listProjects, type LocalProject } from '@/lib/local-api';
 
@@ -36,7 +36,7 @@ export function getProjectsSnapshot(): ProjectsSnapshot {
 /** 重新拉取项目列表并通知所有订阅者。非 Electron 或关掉项目入口时清空。 */
 export async function refreshProjects(): Promise<void> {
   const seq = ++requestSeq;
-  if (!isElectron() || !hostToolChrome('projects')) {
+  if (!hasHostBridge() || !hostToolChrome('projects')) {
     if (snapshot.projects.length > 0 || snapshot.error) {
       snapshot = EMPTY_SNAPSHOT;
       emit();

package/src/i18n/index.tsx

@@ -35,7 +35,7 @@ export function I18nProvider({ children }: { children: ReactNode }) {
       t,
       setLocale: (next) => {
         if (!setLocale(next)) return;
-        window.electron?.setLocale?.(next);
+        window.steerableHost?.setLocale?.(next);
       },
     }),
     [locale],

package/src/layouts/AgentLayout.tsx

@@ -8,7 +8,7 @@ import { AskUserPromptProvider } from '@/components/chat/AskUserPromptProvider';
 import { ApprovalPromptProvider } from '@/components/chat/ApprovalPromptProvider';
 import { InsightsConsentBanner } from '@/components/settings/InsightsSettingsPanel';
 import { trackBehavior } from '@/lib/insights';
-import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
+import { getHostBridge, hasHostBridge } from '@/lib/host-bridge';
 import { deleteChatIfEmpty, pruneEmptyChats } from '@/lib/local-api';
 import { PORTABLE_CHATS_CHANGED_EVENT } from '@/lib/portable';
 import { getPackChatSlots, type PackChatSlotContribution } from '@/packs/registry';
@@ -170,7 +170,7 @@ function AgentLayoutContent() {
     refreshChatsRef.current = data.refreshChats;
   }, [data.refreshChats]);
   useEffect(() => {
-    const bridge = getElectronBridge();
+    const bridge = getHostBridge();
     if (!bridge?.onChatTitleUpdated) return;
     const unsubscribe = bridge.onChatTitleUpdated((payload) => {
       patchChatTitleRef.current(payload.chatId, payload.title);
@@ -181,13 +181,21 @@ function AgentLayoutContent() {
   // 现场补建（见 router.handleStream），随后广播 `chat-created`。这里刷一次
   // 侧栏把这条会话拉出来——否则会出现"URL 能聊、列表里却查无此会话"。
   useEffect(() => {
-    const bridge = getElectronBridge();
+    const bridge = getHostBridge();
     if (!bridge?.onChatCreated) return;
     const unsubscribe = bridge.onChatCreated(() => {
       void refreshChatsRef.current();
     });
     return unsubscribe;
   }, []);
+  useEffect(() => {
+    const bridge = getHostBridge();
+    if (!bridge?.onStoreChanged) return;
+    const unsubscribe = bridge.onStoreChanged(() => {
+      void refreshChatsRef.current();
+    });
+    return unsubscribe;
+  }, []);
   useEffect(() => {
     const onImported = () => {
       void refreshChatsRef.current();
@@ -199,7 +207,7 @@ function AgentLayoutContent() {
   // 空会话不进侧栏：启动时清掉从未发过消息的残骸；离开一段空对话时丢掉它。
   // except / 离开检测都避开当前打开的 chatId，避免和首页首条发送抢跑。
   useEffect(() => {
-    if (!isElectron()) return;
+    if (!hasHostBridge()) return;
     let cancelled = false;
     void pruneEmptyChats(chatId)
       .then((res) => {
@@ -217,7 +225,7 @@ function AgentLayoutContent() {
   useEffect(() => {
     const prev = prevChatIdRef.current;
     prevChatIdRef.current = chatId;
-    if (!isElectron() || !prev || prev === chatId) return;
+    if (!hasHostBridge() || !prev || prev === chatId) return;
     void deleteChatIfEmpty(prev)
       .then((res) => {
         if (res.deleted) return refreshChatsRef.current();
@@ -416,7 +424,7 @@ function AgentLayoutContent() {
   // so this flips the layout state owned by AgentLayout.
   useEffect(() => {
     if (!hostToolChrome('terminal')) return;
-    const bridge = getElectronBridge();
+    const bridge = getHostBridge();
     if (!bridge?.onMenuOpenTerminal) return;
     bridge.onMenuOpenTerminal(() => {
       toggleRightPanel('terminal');

package/src/lib/app-release.ts

@@ -1,5 +1,5 @@
 import { t } from '@/i18n';
-import type { AppReleasePhase, AppReleaseSnapshot } from './electron-bridge';
+import type { AppReleasePhase, AppReleaseSnapshot } from './host-bridge';
 
 export interface AppReleaseView {
   version: string | null;

package/src/lib/attachments.ts

@@ -10,7 +10,7 @@
  * 返回的落盘路径会重写消息正文里的文件引用与图像附件元数据。
  */
 import { t } from '@/i18n';
-import { getElectronBridge } from './electron-bridge';
+import { getHostBridge } from './host-bridge';
 
 export interface AttachmentFile {
   name: string;
@@ -83,7 +83,7 @@ export async function saveChatAttachments(
   files: AttachmentFile[],
 ): Promise<SaveChatAttachmentsResult> {
   if (!chatId || files.length === 0) return { files, failures: [] };
-  const bridge = getElectronBridge();
+  const bridge = getHostBridge();
   if (!bridge?.attachments?.save) return { files, failures: [] };
   try {
     // 有真实路径走 path 拷贝（Electron）；没有则读字节走 data 上传（BS/browser）。

package/src/lib/{browser-dev-electron-mock.ts → browser-dev-host-mock.ts}

@@ -1,8 +1,8 @@
 import type {
-  ElectronBridge,
+  HostBridge,
   LocalBackendRequestInput,
   LocalBackendStreamEvent,
-} from './electron-bridge';
+} from './host-bridge';
 import type {
   ChatAgentWriteInput,
   LocalChat,
@@ -155,7 +155,7 @@ function createInitialState(): BrowserMockState {
           chatId: 'chat-browser-demo',
           role: 'assistant',
           content:
-            'You can debug the chat UI in a normal browser here. This reply comes from the dev mock bridge and does not use Electron IPC.',
+            'You can debug the chat UI in a normal browser here. This reply comes from the dev mock bridge and does not call a live model.',
           minutesAgo: 7,
         }),
         createMessage({
@@ -608,13 +608,13 @@ function cancelStream(streamId: string) {
   state.activeStreams.delete(streamId);
 }
 
-export function installBrowserDevElectronMock() {
-  if (typeof window === 'undefined' || window.electron) return;
+export function installBrowserDevHostMock() {
+  if (typeof window === 'undefined' || window.steerableHost) return;
   // DEV 浏览器预览自动安装；官网静态 demo 构建（app-demo 入口）经 demo flag
   // 显式安装。普通 prod 构建两条路都不通，本模块根本不会进产物。
   if (!import.meta.env.DEV && !isDemoMode()) return;
 
-  window.electron = {
+  window.steerableHost = {
     runtime: 'local',
     platform: 'win32',
     local: {
@@ -622,10 +622,10 @@ export function installBrowserDevElectronMock() {
         canceled: false,
         filePaths: ['C:\\browser-preview\\mock-skill'],
       }),
-      // 浏览器 dev 模式没有 Electron capturePage/clipboard，如实返回失败。
+      // 浏览器 dev 模式没有桌面截图和剪贴板，如实返回失败。
       captureScreenshot: async () => ({
         success: false as const,
-        error: 'Browser dev mode cannot capture a window screenshot (it needs the Electron runtime).',
+        error: 'Browser dev mode cannot capture a window screenshot.',
       }),
     },
     localBackend: {
@@ -644,10 +644,10 @@ export function installBrowserDevElectronMock() {
         suggestedReplyListeners.delete(callback);
       };
     },
-  } satisfies ElectronBridge;
+  } satisfies HostBridge;
 
   console.info(
-    '[browser-dev-electron-mock] Installed mock window.electron bridge.',
+    '[browser-dev-host-mock] Installed mock window.steerableHost bridge.',
     state.source === 'fixture'
       ? { source: state.fixtureMeta?.source, exportedAt: state.fixtureMeta?.exportedAt }
       : { source: 'built-in fallback' },

package/src/lib/chat-transport.ts

@@ -7,7 +7,7 @@
  *   user types in ChatPanel
  *     -> useChatStream.sendUserMessage()
  *     -> transport.stream(input, onEvent)
- *     -> window.electron.localBackend.startStream({ POST /api/v2/chats/:id/run })
+ *     -> window.steerableHost.localBackend.startStream({ POST /api/v2/chats/:id/run })
  *     -> main process forwards each raw SSE chunk via webContents.send
  *     -> preload re-emits as `{ type: 'data'; chunk: string }`
  *     -> we parse the SSE frames with the framework's `SSEParser`, normalise
@@ -52,7 +52,7 @@ import {
   parseSSEData,
 } from '@steerable/agent-ui/state';
 import type { SSEEvent } from '@steerable/agent-protocol';
-import { getElectronBridge } from './electron-bridge';
+import { getHostBridge } from './host-bridge';
 import { t } from '@/i18n';
 import {
   appendDelta,
@@ -214,7 +214,7 @@ class LocalBackendSseAdapter {
 // starts a fresh SSE pipe against /api/v2/chats/:id/run.
 // ---------------------------------------------------------------------------
 
-export interface ElectronChatTransport extends ChatStreamTransport {
+export interface HostChatTransport extends ChatStreamTransport {
   /**
    * 立即取消当前进行中的流（如果有）。
    *
@@ -226,7 +226,7 @@ export interface ElectronChatTransport extends ChatStreamTransport {
   cancelActive: () => void;
 }
 
-export function createElectronChatTransport(chatId: string): ElectronChatTransport {
+export function createHostChatTransport(chatId: string): HostChatTransport {
   // 当前 in-flight 流的 id。startStream resolve 后写入，流结束（end/error）
   // 或被取消后清空。同一 transport 一次只会有一条流（useChatStream 在
   // isStreaming 时拒绝重入）。
@@ -234,7 +234,7 @@ export function createElectronChatTransport(chatId: string): ElectronChatTranspo
 
   return {
     cancelActive: () => {
-      const bridge = getElectronBridge();
+      const bridge = getHostBridge();
       if (active.streamId) {
         bridge?.localBackend.cancelStream(active.streamId);
         active.streamId = null;
@@ -255,15 +255,15 @@ export function createElectronChatTransport(chatId: string): ElectronChatTranspo
     // 轮中转向：仅在 CoreLoop 路径（STEERABLE_USE_CORELOOP=1）且回合仍
     // 运行时生效；否则主进程软失败，useChatStream 保留草稿。
     steer: async (content: string) => {
-      const bridge = getElectronBridge();
+      const bridge = getHostBridge();
       if (!bridge?.localBackend.steerChat) return false;
       return await bridge.localBackend.steerChat(chatId, content);
     },
     stream: async (input: ChatStreamSendInput, onEvent) => {
-      const bridge = getElectronBridge();
+      const bridge = getHostBridge();
       if (!bridge) {
         throw new Error(
-          'Electron bridge unavailable — chat transport requires the desktop shell.',
+          'Host bridge unavailable — chat transport requires the desktop shell.',
         );
       }
 
@@ -348,10 +348,10 @@ export async function regenerateChatMessage(
   chatId: string,
   messageId: string,
 ): Promise<void> {
-  const bridge = getElectronBridge();
+  const bridge = getHostBridge();
   if (!bridge) {
     throw new Error(
-      'Electron bridge unavailable — regenerate requires the desktop shell.',
+      'Host bridge unavailable — regenerate requires the desktop shell.',
     );
   }
   await new Promise<void>((resolve, reject) => {