@steerable/agent-shell-web 0.6.55 → 0.6.56

package/src/pages/AgentPage.tsx

@@ -2,10 +2,10 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useNavigate, useOutletContext, useParams, useSearchParams } from "react-router-dom";
 import { useChatStream, type SteerOutcome } from "@steerable/agent-ui";
 import type { ChatMessage, SSEEvent } from "@steerable/agent-protocol";
-import { getElectronBridge, isElectron } from "@/lib/electron-bridge";
+import { getHostBridge, hasHostBridge } from "@/lib/host-bridge";
 import { trackBehavior } from "@/lib/insights";
 import {
-  createElectronChatTransport,
+  createHostChatTransport,
   regenerateChatMessage,
 } from "@/lib/chat-transport";
 import { ChatHeader } from "@/components/ChatHeader";
@@ -264,12 +264,12 @@ function AgentChatLoader({
   useEffect(() => {
     let cancelled = false;
     void (async () => {
-      if (!isElectron()) {
+      if (!hasHostBridge()) {
         if (!cancelled) setInitialMessages([]);
         return;
       }
       try {
-        const bridge = getElectronBridge()!;
+        const bridge = getHostBridge()!;
         const [response, live] = await Promise.all([
           bridge.localBackend.request<{
             messages?: ChatMessageWithMetadata[];
@@ -387,7 +387,7 @@ function AgentChatView({
     ? (projects.find((p) => p.id === chat.projectId) ?? null)
     : null;
   const transport = useMemo(
-    () => createElectronChatTransport(chatId),
+    () => createHostChatTransport(chatId),
     [chatId],
   );
 
@@ -890,7 +890,7 @@ function AgentChatView({
         updateRemoteFollowUps(() => []);
         void (async () => {
           try {
-            const response = await getElectronBridge()?.localBackend.request<{
+            const response = await getHostBridge()?.localBackend.request<{
               messages?: ChatMessageWithMetadata[];
             }>({
               method: "GET",
@@ -923,7 +923,7 @@ function AgentChatView({
   ]);
 
   useEffect(() => {
-    const bridge = getElectronBridge();
+    const bridge = getHostBridge();
     if (!bridge?.onSuggestedReplies) return;
     return bridge.onSuggestedReplies((payload) => {
       if (payload.chatId !== chatId) return;
@@ -1048,8 +1048,8 @@ function AgentChatView({
   // 分享当前对话：截取整个聊天面板区域（含 header + 消息 + 输入框），
   // 由主进程 capturePage 后写入系统剪贴板，用户可直接粘贴到任何地方。
   const handleShare = useCallback(async (): Promise<boolean> => {
-    if (!isElectron()) return false;
-    const bridge = getElectronBridge()!;
+    if (!hasHostBridge()) return false;
+    const bridge = getHostBridge()!;
     const panel = document.querySelector('.chat-panel-container');
     const rect = panel?.getBoundingClientRect();
     const result = await bridge.local?.captureScreenshot(
@@ -1173,7 +1173,7 @@ function AgentChatView({
         header={
           <ChatHeader
             chat={chat}
-            onBranchSwitched={isElectron() ? onBranchTick : undefined}
+            onBranchSwitched={hasHostBridge() ? onBranchTick : undefined}
             onInspectTask={ctx.inspectTask}
             tasks={tasks}
             chatSlots={ctx.chatSlots}
@@ -1183,7 +1183,7 @@ function AgentChatView({
           />
         }
         onRegenerate={
-          isElectron()
+          hasHostBridge()
             ? async (messageId) => {
                 // 后端 regenerate 流跑完后桌面 store 已是新分支投影；
                 // bump tick 重挂消息列表。
@@ -1217,11 +1217,11 @@ function AgentChatView({
         finishedTasks={finishedTasks}
         onInspectTask={handleInspectTask}
         onDismissFinishedTask={dismissFinished}
-        onShare={isElectron() ? handleShare : undefined}
+        onShare={hasHostBridge() ? handleShare : undefined}
         suggestedReplies={visibleSuggestedReplies}
         onSelectSuggestion={handleSelectSuggestion}
         onOpenSettings={
-          isElectron() && settingsChrome("llm")
+          hasHostBridge() && settingsChrome("llm")
             ? () => setLlmSettingsOpen(true)
             : undefined
         }
@@ -1232,7 +1232,7 @@ function AgentChatView({
             onSelectModel={setModelOverride}
             onSelectEffort={setEffortOverride}
             onOpenSettings={
-              isElectron() && settingsChrome("llm")
+              hasHostBridge() && settingsChrome("llm")
                 ? () => setLlmSettingsOpen(true)
                 : undefined
             }
@@ -1298,7 +1298,7 @@ function AgentChatView({
           </>
         }
       />
-      {isElectron() && settingsChrome("llm") && (
+      {hasHostBridge() && settingsChrome("llm") && (
         <LocalLlmSettingsModal
           open={llmSettingsOpen}
           onClose={() => setLlmSettingsOpen(false)}
@@ -1466,7 +1466,7 @@ function EmptyChatGate() {
             value={inputValue}
             onChange={setInputValue}
             onSubmit={handleSubmit}
-            disabled={!isElectron() || isCreating}
+            disabled={!hasHostBridge() || isCreating}
             placeholder={
               mode === "plan"
                 ? t("Describe your goal. The Agent will make a plan first…")
@@ -1478,7 +1478,7 @@ function EmptyChatGate() {
             selectedAgentId={ctx.selectedAgentId}
             onSelectAgent={handleSelectAgent}
             onOpenSettings={
-              isElectron() && settingsChrome("llm")
+              hasHostBridge() && settingsChrome("llm")
                 ? () => setLlmSettingsOpen(true)
                 : undefined
             }
@@ -1489,15 +1489,15 @@ function EmptyChatGate() {
                 onSelectModel={setModelOverride}
                 onSelectEffort={setEffortOverride}
                 onOpenSettings={
-                  isElectron() && settingsChrome("llm")
+                  hasHostBridge() && settingsChrome("llm")
                     ? () => setLlmSettingsOpen(true)
                     : undefined
                 }
-                disabled={!isElectron() || isCreating}
+                disabled={!hasHostBridge() || isCreating}
               />
             }
             leadingChrome={
-              isElectron() && showProjectsChrome ? (
+              hasHostBridge() && showProjectsChrome ? (
                 <ProjectPickerButton
                   projects={projects}
                   value={selectedProjectId}
@@ -1527,15 +1527,15 @@ function EmptyChatGate() {
             {createError}
           </p>
         )}
-        {!isElectron() && (
+        {!hasHostBridge() && (
           <p className="text-xs text-agent-destructive">
             {t(
-              "Browser preview mode: no Electron IPC bridge, so the chat list and streaming responses are unavailable.",
+              "Browser preview mode: no host bridge, so the chat list and streaming responses are unavailable.",
             )}
           </p>
         )}
       </div>
-      {isElectron() && settingsChrome("llm") && (
+      {hasHostBridge() && settingsChrome("llm") && (
         <LocalLlmSettingsModal
           open={llmSettingsOpen}
           onClose={() => setLlmSettingsOpen(false)}

package/src/pages/SettingsPage.tsx

@@ -16,7 +16,7 @@ import {
   LuShieldCheck,
 } from 'react-icons/lu';
 import { useOutletContext, useSearchParams } from 'react-router-dom';
-import { isElectron } from '@/lib/electron-bridge';
+import { hasHostBridge } from '@/lib/host-bridge';
 import { getLocale, t } from '@/i18n';
 import { useAppRelease } from '@/components/SidebarRelease';
 import { AgentsSettingsPanel } from '@/components/settings/AgentsSettingsPanel';
@@ -228,7 +228,7 @@ export function SettingsPage() {
     if (isPortableEnabled()) {
       list.push({ id: 'portable', label: t('Backup and migration'), Icon: LuDownload });
     }
-    if (isElectron()) {
+    if (hasHostBridge()) {
       list.push({ id: 'python-runner', label: t('Python runtime'), Icon: LuCodeXml });
     }
     if (release.version) {
@@ -347,9 +347,9 @@ export function SettingsPage() {
           ) : null}
 
           <div ref={contentRef} className="min-w-0 flex-1 max-w-3xl space-y-4">
-            {!isElectron() && (
+            {!hasHostBridge() && (
               <p className="rounded-agent-md border border-agent-destructive/20 bg-agent-destructive/10 p-2.5 text-xs text-agent-destructive">
-                {t('Browser preview mode: no Electron IPC bridge, so some settings are unavailable.')}
+                {t('Browser preview mode: no host bridge, so some settings are unavailable.')}
               </p>
             )}
 

package/src/lib/electron-bridge.ts

@@ -1,389 +0,0 @@
-/**
- * Host-neutral bridge used by the renderer in desktop and browser modes.
- *
- * Implementations are `tauri-bridge.ts` (desktop) and `http-bridge.ts`
- * (browser server); both must satisfy {@link HostBridge}.
- *
- * `window.electron` and `getElectronBridge()` remain compatibility aliases for
- * existing products. New integrations should use `window.steerableHost` and
- * `getHostBridge()`.
- */
-
-import type { SSEEvent } from '@steerable/agent-protocol';
-import { getHttpBridge } from './http-bridge';
-import { getTauriBridge } from './tauri-bridge';
-
-export type LocalBackendRequestInput = {
-  method: string;
-  path: string;
-  body?: unknown;
-};
-
-export type LocalBackendStreamEvent =
-  | { type: 'data'; chunk: string; parsed?: SSEEvent }
-  | { type: 'end'; status: number }
-  | { type: 'error'; error: string };
-
-/**
- * W4-1: mirror of the approval algebra's decision variants
- * (`steerable_agent_runtime.approval.APPROVAL_KINDS` minus `timed_out`,
- * which the sidecar synthesizes itself on timeout).
- */
-export type ApprovalDecisionKind =
-  | 'allow_once'
-  | 'allow_for_session'
-  | 'allow_always'
-  | 'deny_once'
-  | 'deny_for_session'
-  | 'deny_always'
-  | 'abort';
-
-export interface ApprovalPromptRequest {
-  requestId: string;
-  toolName: string;
-  arguments: Record<string, unknown>;
-  mode: string;
-  category: string;
-  round: number;
-  /** 发起审批的对话。缺省时卡片不绑定会话（旧请求）。 */
-  chatId?: string;
-}
-
-/**
- * W8: mirror of the sidecar's `ask_user.request` reverse-call payload
- * (`HostAskUserHandler` in steerable_sidecar.host_tools). `questions`
- * entries match `AskUserQuestionsPayload['questions'][number]` from
- * `@steerable/agent-protocol`; kept structurally typed here so the
- * renderer's compile graph stays free of main-process imports.
- */
-export interface AskUserPromptRequest {
-  requestId: string;
-  intro: string;
-  questions: Array<Record<string, unknown>>;
-  /** 发起提问的对话。缺省时卡片不绑定会话（旧请求）。 */
-  chatId?: string;
-}
-
-/**
- * Mirror of `TerminalSession` / `TerminalSpawnOptions` in
- * `src/terminal-manager.ts`. Kept inline (rather than cross-imported)
- * for the same reason as the rest of this file — we don't want the
- * renderer's compile graph to pull in main-process modules.
- */
-export interface TerminalSession {
-  id: string;
-  shell: string;
-  pid: number;
-  cwd: string;
-  cols: number;
-  rows: number;
-}
-
-export interface TerminalSpawnOptions {
-  shell?: string;
-  cwd?: string;
-  env?: Record<string, string>;
-  cols?: number;
-  rows?: number;
-}
-
-export type AppReleasePhase =
-  | 'disabled'
-  | 'idle'
-  | 'checking'
-  | 'downloading'
-  | 'ready'
-  | 'installing'
-  | 'error';
-
-/**
- * 桌面版本与更新。`version` 是当前安装版本，`availableVersion` 是待安装版本。
- * 与主进程 `AppReleaseSnapshot` 对齐。
- */
-export interface AppReleaseSnapshot {
-  version: string;
-  enabled: boolean;
-  phase: AppReleasePhase;
-  availableVersion?: string;
-  percent?: number;
-  message?: string;
-}
-
-export type PythonRunnerPhase =
-  | 'idle'
-  | 'downloading'
-  | 'verifying'
-  | 'extracting'
-  | 'ready'
-  | 'error';
-
-export interface PythonRunnerSnapshot {
-  supported: boolean;
-  source: 'default' | 'url' | 'local';
-  phase: PythonRunnerPhase;
-  percent?: number;
-  downloadedBytes?: number;
-  totalBytes?: number;
-  message?: string;
-  defaultUrl?: string;
-  configuredUrl?: string;
-  activeRunner?: string;
-  configuredRunner?: string;
-  restartRequired: boolean;
-}
-
-export interface HostBridge {
-  runtime: 'local';
-  platform: NodeJS.Platform;
-  local?: {
-    selectDirectory: (options?: {
-      title?: string;
-    }) => Promise<{ canceled: boolean; filePaths: string[] }>;
-    saveTextFile?: (options: {
-      title?: string;
-      defaultPath?: string;
-      content: string;
-    }) => Promise<{ canceled: boolean; filePath?: string }>;
-    /** 截取窗口（或指定 DIP 区域）并写入系统剪贴板。 */
-    captureScreenshot: (rect?: {
-      x: number;
-      y: number;
-      width: number;
-      height: number;
-    }) => Promise<
-      | { success: true; width: number; height: number }
-      | { success: false; error: string }
-    >;
-  };
-  localBackend: {
-    request: <T>(input: LocalBackendRequestInput) => Promise<T>;
-    startStream: (
-      input: LocalBackendRequestInput,
-      onEvent: (payload: LocalBackendStreamEvent) => void,
-    ) => Promise<string | null>;
-    cancelStream: (streamId: string) => void;
-    /** 轮中转向：注入一条用户消息到运行中的 CoreLoop 回合；false = 无可转向回合。 */
-    steerChat?: (chatId: string, content: string) => Promise<boolean>;
-  };
-  /** 会话附件：把源文件路径 / base64 字节拷贝进会话空间（`attachments:save`）。 */
-  attachments?: {
-    save: (input: {
-      chatId: string;
-      files: Array<{ path?: string; name?: string; data?: string }>;
-    }) => Promise<{
-      files: Array<{ name: string; path: string; size: number; error?: string }>;
-    }>;
-  };
-  /**
-   * App menu IPC — `Cmd+N` / 文件 → 新建对话 fires `menu:new-chat`
-   * (see src/main.ts:createMenu). Renderer subscribes via
-   * `onMenuNewChat(cb)` and *must* call `offMenuNewChat()` on unmount
-   * to clear the listener (otherwise multiple AgentSidebar mounts
-   * during HMR would queue up duplicate callbacks).
-   */
-  /** 把当前界面语言告诉主进程，以便重建应用菜单。浏览器预览里没有。 */
-  setLocale?: (locale: string) => void;
-  onMenuNewChat?: (callback: () => void) => void;
-  offMenuNewChat?: () => void;
-  /**
-   * App menu IPC — `Cmd+T` / 视图 → 打开终端 fires `menu:open-terminal`.
-   * The terminal is a toggleable panel inside AgentLayout (not a separate
-   * window, not a route), so the renderer just flips layout state. Same
-   * subscribe/off pairing as `onMenuNewChat`.
-   */
-  onMenuOpenTerminal?: (callback: () => void) => void;
-  offMenuOpenTerminal?: () => void;
-  /**
-   * App menu IPC — `Cmd+V` / 编辑 → 粘贴 fires `menu:paste`.
-   * WKWebView does not expose that pasteboard to the page, so the renderer
-   * reads it through `readClipboard`.
-   */
-  onMenuPaste?: (callback: () => void) => void;
-  offMenuPaste?: () => void;
-  /**
-   * OS pasteboard. `files` are copied paths or a screenshot PNG.
-   * Text is empty when the pasteboard holds files, so the path is not
-   * inserted into the composer as well.
-   */
-  readClipboard?: () => Promise<{
-    text: string;
-    files: Array<{
-      name: string;
-      path?: string;
-      dataBase64?: string;
-      mime?: string;
-    }>;
-  }>;
-  /** Plain text from the OS pasteboard. Empty when the clipboard has no text. */
-  readClipboardText?: () => Promise<string>;
-  /**
-   * 异步 AI 标题就绪通知。Backend 在每条 chat 首条助手回复完成后 fire-and-forget
-   * 跑 LLM 生成标题；完成时通过这个通道把 `{chatId, title}` 推过来。返回的函数
-   * 解除订阅（preload 用 add/remove 配对，不是 removeAllListeners——可以多处订阅）。
-   */
-  onChatTitleUpdated?: (
-    callback: (payload: { chatId: string; title: string }) => void,
-  ) => () => void;
-  /**
-   * 回合追问建议就绪。Backend 在助手回复完成后推 `{chatId, messageId, suggestions}`
-   * （先启发式、后 LLM 替换）。返回解除订阅函数。
-   */
-  onSuggestedReplies?: (
-    callback: (payload: {
-      chatId: string;
-      messageId: string;
-      suggestions: string[];
-    }) => void,
-  ) => () => void;
-  /**
-   * 会话补建通知。Backend 在「向一个本地不存在的 chatId 首次发送」时按 URL
-   * 里的 id 现场补建会话（见 router.handleStream），随后广播 `chat-created`
-   * （{chatId, agentId}）；渲染端据此 refresh 一次侧栏，避免"URL 能聊、列表
-   * 里却找不到这条会话"。返回解除订阅函数。
-   */
-  onChatCreated?: (
-    callback: (payload: { chatId: string; agentId?: string | null }) => void,
-  ) => () => void;
-  /**
-   * 4.6a 后台任务状态推送。任务到达终态或 worktree 合并/丢弃完成时主进程
-   * 广播；载荷只有 chatId/taskId，面板收到后重新拉列表。
-   */
-  onTaskUpdated?: (
-    callback: (payload: { chatId: string; taskId: string }) => void,
-  ) => () => void;
-  /**
-   * 场景包广播事件订阅（3.1 通用化）：按通道名订阅主进程/BS 后端的
-   * 广播事件，载荷由订阅方（包）自行收窄校验。shell 不知道包的事件
-   * 语义——包的通道名约定带包前缀（如 `<pack>:updated`）。返回解除
-   * 订阅函数。
-   */
-  onPackEvent?: (
-    channel: string,
-    callback: (payload: unknown) => void,
-  ) => () => void;
-  /**
-   * 后台任务推理时间线推送。任务流的 reasoning / 工具 / 文本增量经主进程
-   * 广播；右侧过程栏订阅后不用轮询。
-   */
-  onTaskProcess?: (
-    callback: (payload: {
-      chatId: string;
-      taskId: string;
-      timeline: unknown;
-      live: boolean;
-    }) => void,
-  ) => () => void;
-  /**
-   * W4-1 审批代数：sidecar ApprovalExecutor 的请示经主进程广播到 renderer。
-   * onRequest 订阅返回 unsubscribe；decide 把用户的 7 变体决定送回主进程。
-   */
-  approval?: {
-    onRequest: (callback: (request: ApprovalPromptRequest) => void) => () => void;
-    decide: (decision: {
-      requestId: string;
-      kind: ApprovalDecisionKind;
-      reason?: string;
-    }) => Promise<void>;
-    pending: () => Promise<ApprovalPromptRequest[]>;
-  };
-  /**
-   * W8 结构化提问：sidecar ask_user 工具的请示经主进程/BS 服务器广播到
-   * renderer。onRequest 订阅返回 unsubscribe；answer 把答案映射送回
-   * （空映射 = 用户未作答，模型自行推进）。
-   */
-  askUser?: {
-    onRequest: (callback: (request: AskUserPromptRequest) => void) => () => void;
-    answer: (reply: {
-      requestId: string;
-      answers: Record<string, string | string[]>;
-    }) => Promise<void>;
-    pending: () => Promise<AskUserPromptRequest[]>;
-  };
-  terminal?: {
-    /** Ensures a session exists (reuses last one if alive). */
-    ensure: (options?: TerminalSpawnOptions) => Promise<TerminalSession>;
-    write: (id: string, data: string) => Promise<boolean>;
-    resize: (id: string, cols: number, rows: number) => Promise<boolean>;
-    onData: (
-      callback: (payload: { sessionId: string; chunk: string }) => void,
-    ) => () => void;
-    onExit: (
-      callback: (payload: {
-        sessionId: string;
-        code: number;
-        signal: string | null;
-      }) => void,
-    ) => () => void;
-  };
-  /**
-   * 桌面版本与更新。Electron / Tauri 提供；浏览器预览没有这一段。
-   */
-  app?: {
-    snapshot: () => Promise<AppReleaseSnapshot>;
-    check: () => Promise<AppReleaseSnapshot>;
-    install: () => Promise<AppReleaseSnapshot>;
-    onState: (callback: (snapshot: AppReleaseSnapshot) => void) => () => void;
-  };
-  /** Desktop-only Python child interpreter management for run_code. */
-  pythonRunner?: {
-    snapshot: () => Promise<PythonRunnerSnapshot>;
-    download: (url?: string) => Promise<PythonRunnerSnapshot>;
-    cancel: () => Promise<PythonRunnerSnapshot>;
-    pickLocal: () => Promise<string | null>;
-    useLocal: (path: string) => Promise<PythonRunnerSnapshot>;
-    useDefault: () => Promise<PythonRunnerSnapshot>;
-    restart: () => Promise<void>;
-    onState: (callback: (snapshot: PythonRunnerSnapshot) => void) => () => void;
-  };
-  // 场景包的 invoke 命名空间（如包 preload 贡献的 `<pack>` / `<pack>Mock`）
-  // 不进本接口——包用自己的结构化收窄访问器（见各包 web/bridge.ts），
-  // shell 桥接口保持产品中立（3.1）。
-}
-
-/** @deprecated Use `HostBridge`. */
-export type ElectronBridge = HostBridge;
-
-declare global {
-  interface Window {
-    steerableHost?: HostBridge;
-    electron?: ElectronBridge;
-    __TAURI_INTERNALS__?: object;
-    /**
-     * BS server（src/server/）托管 index.html 时注入的引导信息；存在即代表
-     * 当前跑在浏览器-服务器模式，getElectronBridge() 会返回 HTTP 实现。
-     */
-    __DEEPPATH_BS__?: {
-      platform: NodeJS.Platform;
-      flavor: string;
-      brandName: string;
-    };
-  }
-}
-
-export function getHostBridge(): HostBridge | null {
-  if (typeof window === 'undefined') return null;
-  if (window.steerableHost) return window.steerableHost;
-  if (window.electron) return window.electron;
-  if (window.__TAURI_INTERNALS__ && window.__DEEPPATH_BS__) {
-    return getTauriBridge();
-  }
-  if (window.__DEEPPATH_BS__) return getHttpBridge();
-  return null;
-}
-
-/** @deprecated Use `getHostBridge`. */
-export const getElectronBridge = getHostBridge;
-
-export function isDesktopHost(): boolean {
-  if (typeof window === 'undefined') return false;
-  return Boolean(
-    window.steerableHost ||
-      window.electron ||
-      (window.__TAURI_INTERNALS__ && window.__DEEPPATH_BS__),
-  );
-}
-
-/** @deprecated Use `isDesktopHost` when desktop-only behavior is required. */
-export function isElectron(): boolean {
-  return getHostBridge() !== null;
-}