@steerable/agent-shell 0.6.52 → 0.6.55

package/dist/mcp-server-registry.js

@@ -5,11 +5,11 @@
  * 持久化在 userData/agent-mcp-servers.json。已启用服务的工具会经
  * ToolRouter 以 `mcp__<serverKey>__<toolName>` 一等工具身份暴露给模型。
  *
- * 存储通过 {@link McpServerKvStore} 接口注入：main.ts 用 electron-store
- * 实现，单测用内存实现——本模块不 import electron，保持纯 Node 可测。
+ * 存储通过 {@link McpServerKvStore} 接口注入：宿主用 json-store 实现，
+ * 单测用内存实现。
  */
 import { randomUUID } from 'node:crypto';
-import { mcpExecutor } from './mcp-executor.js';
+import { MAX_MCP_SERVER_TOOLS, mcpExecutor, } from './mcp-executor.js';
 const STORE_KEY = 'mcpServers';
 /** 工具名只允许 [a-z0-9-]；中文名会被剥光，退化为 srv-<id前6位>。 */
 export function sanitizeServerKey(name, id) {
@@ -19,15 +19,90 @@ export function sanitizeServerKey(name, id) {
         .replace(/^-+|-+$/g, '');
     return cleaned || `srv-${id.slice(0, 6)}`;
 }
+function normalizeStoredEntry(entry) {
+    if ('transport' in entry)
+        return entry;
+    const legacy = entry;
+    return { ...legacy, transport: 'stdio' };
+}
+function normalizeTransportInput(input) {
+    if (input.transport === 'streamable-http') {
+        const raw = input;
+        if (typeof raw.command === 'string' && raw.command.trim()) {
+            throw new Error('Streamable HTTP 配置不能包含 command');
+        }
+        const url = parseMcpHttpUrl(input.url);
+        const headers = { ...(input.headers ?? {}) };
+        if (Object.keys(headers).some((name) => name.toLowerCase() === 'authorization')) {
+            throw new Error('Authorization 不允许明文保存；请使用 bearerTokenEnvVar 或 headersFromEnv');
+        }
+        const bearerTokenEnvVar = input.bearerTokenEnvVar?.trim() || undefined;
+        return {
+            transport: 'streamable-http',
+            url,
+            headers,
+            headersFromEnv: { ...(input.headersFromEnv ?? {}) },
+            bearerTokenEnvVar,
+            reconnect: input.reconnect ? { ...input.reconnect } : undefined,
+        };
+    }
+    if ('url' in input && typeof input.url === 'string' && input.url.trim()) {
+        throw new Error('stdio 配置不能包含 url');
+    }
+    const command = input.command.trim();
+    if (!command)
+        throw new Error('启动命令不能为空');
+    return {
+        transport: 'stdio',
+        command,
+        args: (input.args ?? []).map(String),
+        env: { ...(input.env ?? {}) },
+        cwd: input.cwd?.trim() || undefined,
+    };
+}
+function parseMcpHttpUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw.trim());
+    }
+    catch {
+        throw new Error('MCP HTTP URL 无效');
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new Error('MCP HTTP URL 必须使用 http 或 https');
+    }
+    if (url.username || url.password) {
+        throw new Error('MCP HTTP URL 不能包含凭据');
+    }
+    return url.toString();
+}
+function stringRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return {};
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+        key,
+        String(item),
+    ]));
+}
+function stringValue(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
 export class McpServerRegistry {
     store;
+    executor;
     /** serverId → 最近一次 listTools 的结果（内存缓存，重启后由后台刷新重建）。 */
     toolCache = new Map();
-    constructor(store) {
+    constructor(store, executor = mcpExecutor) {
         this.store = store;
+        this.executor = executor;
     }
     list() {
-        return this.store.get(STORE_KEY) ?? [];
+        const stored = this.store.get(STORE_KEY) ?? [];
+        const migrated = stored.map(normalizeStoredEntry);
+        if (migrated.some((entry, index) => entry !== stored[index])) {
+            this.store.set(STORE_KEY, migrated);
+        }
+        return migrated;
     }
     get(idOrName) {
         const needle = idOrName.trim().toLowerCase();
@@ -43,24 +118,18 @@ export class McpServerRegistry {
     }
     create(input) {
         const name = input.name.trim();
-        const command = input.command.trim();
         if (!name)
             throw new Error('服务名称不能为空');
-        if (!command)
-            throw new Error('启动命令不能为空');
         if (this.get(name))
             throw new Error(`已存在同名服务「${name}」`);
         const now = new Date().toISOString();
         const entry = {
             id: randomUUID(),
             name,
-            command,
-            args: (input.args ?? []).map((a) => String(a)),
-            env: { ...(input.env ?? {}) },
-            cwd: input.cwd?.trim() || undefined,
             enabled: input.enabled ?? true,
             createdAt: now,
             updatedAt: now,
+            ...normalizeTransportInput(input),
         };
         this.store.set(STORE_KEY, [...this.list(), entry]);
         return entry;
@@ -77,18 +146,39 @@ export class McpServerRegistry {
         const nameClash = servers.some((s) => s.id !== id && s.name.toLowerCase() === nextName.toLowerCase());
         if (nameClash)
             throw new Error(`已存在同名服务「${nextName}」`);
+        const transport = updates.transport ?? current.transport;
+        const transportInput = transport === 'stdio'
+            ? {
+                name: nextName,
+                transport: 'stdio',
+                command: updates.command ?? (current.transport === 'stdio' ? current.command : ''),
+                args: updates.args ?? (current.transport === 'stdio' ? current.args : []),
+                env: updates.env ?? (current.transport === 'stdio' ? current.env : {}),
+                cwd: updates.cwd ?? (current.transport === 'stdio' ? current.cwd : undefined),
+            }
+            : {
+                name: nextName,
+                transport: 'streamable-http',
+                url: updates.url ?? (current.transport === 'streamable-http' ? current.url : ''),
+                headers: updates.headers ??
+                    (current.transport === 'streamable-http' ? current.headers : {}),
+                headersFromEnv: updates.headersFromEnv ??
+                    (current.transport === 'streamable-http' ? current.headersFromEnv : {}),
+                bearerTokenEnvVar: updates.bearerTokenEnvVar ??
+                    (current.transport === 'streamable-http'
+                        ? current.bearerTokenEnvVar
+                        : undefined),
+                reconnect: updates.reconnect ??
+                    (current.transport === 'streamable-http' ? current.reconnect : undefined),
+            };
         const next = {
-            ...current,
+            id: current.id,
             name: nextName,
-            command: updates.command !== undefined ? updates.command.trim() : current.command,
-            args: updates.args !== undefined ? updates.args.map((a) => String(a)) : current.args,
-            env: updates.env !== undefined ? { ...updates.env } : current.env,
-            cwd: updates.cwd !== undefined ? updates.cwd.trim() || undefined : current.cwd,
             enabled: updates.enabled !== undefined ? updates.enabled : current.enabled,
+            createdAt: current.createdAt,
             updatedAt: new Date().toISOString(),
+            ...normalizeTransportInput(transportInput),
         };
-        if (!next.command)
-            throw new Error('启动命令不能为空');
         servers[idx] = next;
         this.store.set(STORE_KEY, servers);
         // 配置变了，旧工具缓存不可信
@@ -131,10 +221,27 @@ export class McpServerRegistry {
         for (const [name, cfgRaw] of Object.entries(container)) {
             const cfg = (cfgRaw ?? {});
             const command = typeof cfg.command === 'string' ? cfg.command.trim() : '';
-            if (!command || this.get(name)) {
+            const url = typeof cfg.url === 'string' ? cfg.url.trim() : '';
+            if ((!command && !url) || (command && url) || this.get(name)) {
                 result.skipped.push(name);
                 continue;
             }
+            if (url) {
+                const headers = stringRecord(cfg.headers);
+                const headersFromEnv = stringRecord(cfg.envHttpHeaders ?? cfg.env_http_headers ?? cfg.headersFromEnv);
+                const bearerTokenEnvVar = stringValue(cfg.bearerTokenEnvVar ?? cfg.bearer_token_env_var) || undefined;
+                const entry = this.create({
+                    name: name.trim(),
+                    transport: 'streamable-http',
+                    url,
+                    headers,
+                    headersFromEnv,
+                    bearerTokenEnvVar,
+                    enabled: true,
+                });
+                result.added.push(entry);
+                continue;
+            }
             const env = {};
             if (cfg.env && typeof cfg.env === 'object' && !Array.isArray(cfg.env)) {
                 for (const [k, v] of Object.entries(cfg.env)) {
@@ -160,12 +267,48 @@ export class McpServerRegistry {
         return clash ? `${base}-${entry.id.slice(0, 4)}` : base;
     }
     toExecutorConfig(entry) {
-        return {
-            command: entry.command,
-            args: entry.args,
-            env: entry.env,
-            cwd: entry.cwd,
+        return entry.transport === 'stdio'
+            ? {
+                transport: 'stdio',
+                command: entry.command,
+                args: entry.args,
+                env: entry.env,
+                cwd: entry.cwd,
+            }
+            : {
+                transport: 'streamable-http',
+                url: entry.url,
+                headers: entry.headers,
+                headersFromEnv: entry.headersFromEnv,
+                bearerTokenEnvVar: entry.bearerTokenEnvVar,
+                reconnect: entry.reconnect,
+            };
+    }
+    toPublicEntry(entry) {
+        const common = {
+            id: entry.id,
+            name: entry.name,
+            transport: entry.transport,
+            enabled: entry.enabled,
+            createdAt: entry.createdAt,
+            updatedAt: entry.updatedAt,
         };
+        return entry.transport === 'stdio'
+            ? {
+                ...common,
+                command: entry.command,
+                args: [...entry.args],
+                cwd: entry.cwd,
+                envKeys: Object.keys(entry.env).sort(),
+            }
+            : {
+                ...common,
+                url: entry.url,
+                headerNames: Object.keys(entry.headers).sort(),
+                headersFromEnv: { ...entry.headersFromEnv },
+                bearerTokenEnvVar: entry.bearerTokenEnvVar,
+                reconnect: entry.reconnect,
+            };
     }
     getCachedTools(serverId) {
         return this.toolCache.get(serverId) ?? null;
@@ -211,8 +354,24 @@ export class McpServerRegistry {
         const entry = this.list().find((s) => s.id === serverId);
         if (!entry)
             throw new Error('服务不存在');
-        const result = await mcpExecutor.listTools(this.toExecutorConfig(entry));
-        const cached = result.success
+        const applyChanged = (tools) => {
+            if (tools.length > MAX_MCP_SERVER_TOOLS)
+                return;
+            this.toolCache.set(serverId, {
+                tools: tools.map((tool) => ({ ...tool })),
+                fetchedAt: new Date().toISOString(),
+                error: null,
+            });
+        };
+        const result = await this.executor.listTools(this.toExecutorConfig(entry), applyChanged, (error) => {
+            this.toolCache.set(serverId, {
+                tools: [],
+                fetchedAt: new Date().toISOString(),
+                error,
+            });
+        });
+        const overCap = (result.tools?.length ?? 0) > MAX_MCP_SERVER_TOOLS;
+        const cached = result.success && !overCap
             ? {
                 tools: (result.tools ?? []).map((t) => ({
                     name: t.name,
@@ -222,7 +381,13 @@ export class McpServerRegistry {
                 fetchedAt: new Date().toISOString(),
                 error: null,
             }
-            : { tools: [], fetchedAt: new Date().toISOString(), error: result.error ?? '未知错误' };
+            : {
+                tools: [],
+                fetchedAt: new Date().toISOString(),
+                error: overCap
+                    ? `服务工具数超过每服务 ${MAX_MCP_SERVER_TOOLS} 个的上限`
+                    : result.error ?? '未知错误',
+            };
         this.toolCache.set(serverId, cached);
         return cached;
     }

package/dist/product-config.d.ts

@@ -15,13 +15,6 @@ export interface ProductLinks {
     /** 帮助菜单「访问官网」URL。 */
     website?: string;
 }
-export interface ProductUpdates {
-    /**
-     * electron-updater generic 通道根地址（目录，不含 latest*.yml）。
-     * 打包配置里的 publishUrl 由产品组装根注入到这里。空则不检查更新。
-     */
-    feedUrl?: string;
-}
 export interface ProductConfig {
     /**
      * 云端遥测端点（insights flush 的 API base）。空 = 不上报（中性默认）；
@@ -31,13 +24,8 @@ export interface ProductConfig {
     /** 帮助菜单链接；缺省的项不渲染。 */
     links?: ProductLinks;
     /**
-     * 桌面自动更新。缺省不检查。只在已打包的应用里生效，除非
-     * `DEEPPATH_APP_UPDATE=1`。`DEEPPATH_UPDATE_FEED_URL` 可覆盖 feedUrl。
-     */
-    updates?: ProductUpdates;
-    /**
-     * BS 模式的 userData 目录名（~/ 下）。CS 模式由 Electron 按
-     * productName 分目录，不经此字段。
+     * 未设置 `DEEPPATH_USER_DATA_DIR` 时的 userData 目录名（~/ 下）。
+     * Tauri 宿主总是注入该环境变量，不经此字段。
      */
     dataDirName?: string;
     /**
@@ -58,6 +46,11 @@ export interface ProductConfig {
      * STEERABLE_APPROVAL=0 仍是调试逃生口。
      */
     approval?: 'host' | 'off';
+    /**
+     * 白名单外出网询问：host = 弹宿主审批；off = 自动加入当前代理会话。
+     * 缺省 host。自动放行仅存活到代理进程退出，不修改持久白名单。
+     */
+    egressApproval?: 'host' | 'off';
     /**
      * 对话模式。缺省 `['agent','plan']`。只留一种时渲染层不显示切换。
      */
@@ -100,11 +93,20 @@ export interface ProductConfig {
      */
     builtinMcp?: Array<{
         name: string;
+        transport?: 'stdio';
         command: string;
         args?: string[];
         env?: Record<string, string>;
         cwd?: string;
         enabled?: boolean;
+    } | {
+        name: string;
+        transport: 'streamable-http';
+        url: string;
+        headers?: Record<string, string>;
+        headersFromEnv?: Record<string, string>;
+        bearerTokenEnvVar?: string;
+        enabled?: boolean;
     }>;
     /**
      * P3.1 多智能体编排六件套 (agent_spawn / agent_wait / agent_send / agent_interrupt / agent_close / agent_list)。
@@ -116,6 +118,14 @@ export interface ProductConfig {
         maxDepth?: number;
         maxParallel?: number;
     };
+    /**
+     * 界面语言。缺省只有 `en`。译文在应用层语言包，不在本包。
+     * `locales` 是这个产品装进包里的语言；多于一种时设置页才出现切换。
+     */
+    i18n?: {
+        locales: string[];
+        defaultLocale: string;
+    };
 }
 /** shell 内置智能体：只有产品显式 `true` 才开。 */
 export declare function isShellBuiltinAgentEnabled(id: 'local-assistant' | 'all-round-assistant', config?: ProductConfig): boolean;

package/dist/project-registry.d.ts

@@ -8,8 +8,8 @@
  * 源文件夹及其子目录同样可写。
  *
  * 持久化在 userData/agent-projects.json。存储通过 {@link ProjectKvStore}
- * 接口注入：main.ts 用 electron-store 实现，单测用内存实现——本模块不
- * import electron，保持纯 Node 可测（与 mcp-server-registry.ts 同一模式）。
+ * 接口注入：宿主用 json-store 实现，单测用内存实现（与
+ * mcp-server-registry.ts 同一模式）。
  */
 export interface ProjectRecord {
     id: string;
@@ -38,7 +38,7 @@ export interface CreateProjectInput {
     folderPath: string;
     sourceFolders?: string[];
 }
-/** 最小 KV 存储接口，避免本模块直接依赖 electron-store。 */
+/** 最小 KV 存储接口，避免本模块直接依赖具体存储实现。 */
 export interface ProjectKvStore {
     get(key: 'projects'): ProjectRecord[] | undefined;
     set(key: 'projects', value: ProjectRecord[]): void;

package/dist/project-registry.js

@@ -8,8 +8,8 @@
  * 源文件夹及其子目录同样可写。
  *
  * 持久化在 userData/agent-projects.json。存储通过 {@link ProjectKvStore}
- * 接口注入：main.ts 用 electron-store 实现，单测用内存实现——本模块不
- * import electron，保持纯 Node 可测（与 mcp-server-registry.ts 同一模式）。
+ * 接口注入：宿主用 json-store 实现，单测用内存实现（与
+ * mcp-server-registry.ts 同一模式）。
  */
 import { randomUUID } from 'node:crypto';
 const STORE_KEY = 'projects';

package/dist/runtime.d.ts

@@ -1,5 +1,3 @@
-/** Electron 主进程里 `process.versions.electron` 有值；普通 Node（BS server、vitest）没有。 */
-export declare function isElectronRuntime(): boolean;
 /** 应用数据目录（SQLite、JSON store、用户技能目录的根）。 */
 export declare function getUserDataDir(): string;
 /**
@@ -15,59 +13,15 @@ export declare function getDocumentsDir(): string;
 export declare function setAppRootDir(dir: string): void;
 export declare function getAppRootDir(): string;
 /**
- * 注入 preload bundle 绝对路径（产品组装根/入口调用）。重复注入不同值
- * 抛错（组装期笔误，fail fast——与 setAppRootDir 同语义）。
- */
-export declare function setPreloadPath(file: string): void;
-/**
- * 解析窗口应加载的 preload bundle：产品注入优先，其次 shell 自带默认
- * （shellDir 一般为 shell main.js 所在目录）。
- */
-export declare function getPreloadPath(shellDir: string): string;
-/**
- * 产品 web 产物目录（2.3）：产品入口（products/<id>/{main,server}.ts）
- * 用本函数把 DEEPPATH_WEB_DIST 注入环境，shell 的 main/server 据此定位
- * web dist。双平面探测：源码平面入口在 products/<id>/（web dist 在同级
- * web/dist）；编译平面入口在 products/<id>/dist/products/<id>/（web dist
- * 在仓库根的 products/<id>/web/dist）。两处都没有返回 null（打包后的
- * CS 走 app.getAppPath()/web-dist 约定，不经本函数）。
+ * 产品 web 产物目录（2.3）：产品入口（products/<id>/server.ts）用本函数
+ * 把 DEEPPATH_WEB_DIST 注入环境，shell server 据此定位 web dist。双平面
+ * 探测：源码平面入口在 products/<id>/（web dist 在同级 web/dist）；编译
+ * 平面入口在 products/<id>/dist/products/<id>/（web dist 在仓库根的
+ * products/<id>/web/dist）。两处都没有返回 null（打包后的 Tauri 宿主直接
+ * 注入 DEEPPATH_WEB_DIST，不经本函数）。
  */
 export declare function resolveProductWebDist(entryUrl: string): string | null;
-/** 用系统默认应用打开本地路径（Electron `shell.openPath` 的跨宿主等价物）。 */
+/** 用系统默认应用打开本地路径。返回空串表示成功，否则是错误消息。 */
 export declare function shellOpenPath(target: string): Promise<string>;
-/** 用系统浏览器打开 URL（Electron `shell.openExternal` 的跨宿主等价物）。 */
+/** 用系统浏览器打开 URL。 */
 export declare function shellOpenExternal(url: string): Promise<void>;
-/**
- * 注册应用退出钩子（sidecar 的兜底清理）。BS 下没有 app 生命周期——
- * 宿主退出由 server 的 SIGINT/SIGTERM 钩子统一负责，这里 no-op。
- */
-export declare function onAppWillQuit(listener: () => void): void;
-export declare function offAppWillQuit(listener: () => void): void;
-export interface NativeImageInstance {
-    isEmpty(): boolean;
-    getSize(): {
-        width: number;
-        height: number;
-    };
-    crop(rect: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    }): NativeImageInstance;
-    resize(o: {
-        width?: number;
-        height?: number;
-        quality?: string;
-    }): NativeImageInstance;
-    toPNG(): Buffer;
-    toJPEG(quality: number): Buffer;
-}
-export interface NativeImageLike {
-    createFromPath(p: string): NativeImageInstance;
-}
-/**
- * Electron `nativeImage`（图片解码/缩放）。BS / 单测等无 Electron 环境返回
- * null——调用方按"不支持图片解码"降级（image-attachment 已有该分支）。
- */
-export declare function getNativeImage(): NativeImageLike | null;