@steerable/agent-shell 0.6.52 → 0.6.55

package/dist/brand.js

@@ -34,7 +34,7 @@ const SHELL_BRAND = {
     displayName: 'Steerable Shell',
     title: 'Steerable Shell',
     agentName: 'Agent',
-    tagline: '一款本地桌面 AI 伙伴',
+    tagline: 'A local desktop AI partner',
     defaultAgentId: LOCAL_ASSISTANT_AGENT_ID,
 };
 let productBrand = null;

package/dist/host/pack-assembly.d.ts

@@ -1,7 +1,7 @@
 /**
  * 包装配注册表（阶段 2.3）——纯构建期组合的宿主侧机制。
  *
- * 宿主（host/runtime.ts、main.ts、server/index.ts）不再静态 import 任何
+ * 宿主（host/runtime.ts、server/index.ts）不再静态 import 任何
  * 包代码：产品组装根（products/<id>/active.ts）把包的装配函数注册进本
  * 注册表，宿主在装配期逐个调用。产品的 tsc 编译单元只 include 自己的包，
  * 他包代码物理上不进产品 dist。
@@ -10,11 +10,10 @@
  *  - import 期（active.ts 顶层）：迁移/种子/品牌等无宿主依赖的注册；
  *  - 装配期（createHostRuntime 内）：服务/工具/路由等需要宿主能力的部分，
  *    经 {@link PackAssemblyDeps} 注入。
- * 入口差异：CS（main.ts）额外消费 handle.ipc，BS（server/index.ts）额外
- * 消费 handle.httpRoutes——包的入口面贡献由宿主循环驱动，宿主代码里
- * 不出现任何包名。
+ * server/index.ts 消费 handle.httpRoutes——包的入口面贡献由宿主循环驱动，
+ * 宿主代码里不出现任何包名。
  */
-import type { HttpRouteContribution, IpcContribution, ToolContribution } from '../scenario/pack.js';
+import type { HttpRouteContribution, ToolContribution } from '../scenario/pack.js';
 import type { PackDbAccess } from '../storage/driver.js';
 /** 宿主注入包的装配能力面。包不 import 宿主装配模块，全部经回调注入。 */
 export interface PackAssemblyDeps {
@@ -31,7 +30,7 @@ export interface PackAssemblyDeps {
         name: string;
         folderPath: string;
     } | null>;
-    /** 面向全部用户面的事件广播（CS=所有窗口 IPC，BS=SSE 总线）。 */
+    /** 面向全部用户面的事件广播（SSE 总线）。 */
     readonly broadcast: (channel: string, payload: unknown) => void;
     /** 工具贡献注册口（toolRouter.registerToolContributions 的收窄面）。 */
     readonly registerTools: (tools: readonly ToolContribution[]) => void;
@@ -61,20 +60,11 @@ export interface PackAssemblyDeps {
     /** 装配期日志行（进宿主日志）。 */
     readonly onLog: (line: string) => void;
 }
-/** CS 宿主的窗口能力：打开一个加载应用内路由的独立窗口。 */
-export interface PackHostWindowCapabilities {
-    /** route 如 '/<pack>-debug-log'；title 为窗口副标题（宿主拼品牌名）。 */
-    openRouteWindow(route: string, options: {
-        title: string;
-    }): Promise<void>;
-}
 /** 装配产物：宿主按入口面消费。全部槽位可选。 */
 export interface PackAssemblyHandle {
     /** 宿主关停钩子（进程退出时按装配逆序调用）。 */
     readonly dispose?: () => void | Promise<void>;
-    /** CS：包 IPC 贡献（需要宿主窗口能力时经 caps 注入）。 */
-    readonly ipc?: (caps: PackHostWindowCapabilities) => readonly IpcContribution[];
-    /** BS：/host/<packId>/* 路由贡献。 */
+    /** /host/<packId>/* 路由贡献。 */
     readonly httpRoutes?: () => readonly HttpRouteContribution[];
 }
 export type PackAssembly = (deps: PackAssemblyDeps) => PackAssemblyHandle | void;

package/dist/host/pack-assembly.js

@@ -1,7 +1,7 @@
 /**
  * 包装配注册表（阶段 2.3）——纯构建期组合的宿主侧机制。
  *
- * 宿主（host/runtime.ts、main.ts、server/index.ts）不再静态 import 任何
+ * 宿主（host/runtime.ts、server/index.ts）不再静态 import 任何
  * 包代码：产品组装根（products/<id>/active.ts）把包的装配函数注册进本
  * 注册表，宿主在装配期逐个调用。产品的 tsc 编译单元只 include 自己的包，
  * 他包代码物理上不进产品 dist。
@@ -10,9 +10,8 @@
  *  - import 期（active.ts 顶层）：迁移/种子/品牌等无宿主依赖的注册；
  *  - 装配期（createHostRuntime 内）：服务/工具/路由等需要宿主能力的部分，
  *    经 {@link PackAssemblyDeps} 注入。
- * 入口差异：CS（main.ts）额外消费 handle.ipc，BS（server/index.ts）额外
- * 消费 handle.httpRoutes——包的入口面贡献由宿主循环驱动，宿主代码里
- * 不出现任何包名。
+ * server/index.ts 消费 handle.httpRoutes——包的入口面贡献由宿主循环驱动，
+ * 宿主代码里不出现任何包名。
  */
 const assemblies = new Map();
 /** 注册包的装配函数（产品组装根在 import 期调用；重复注册同包抛错）。 */

package/dist/host/runtime.js

@@ -16,6 +16,7 @@ import { LocalScriptRegistry } from '../local-script-registry.js';
 import { TerminalManager } from '../terminal-manager.js';
 import { ToolRouter } from '../tool-router.js';
 import { McpServerRegistry, } from '../mcp-server-registry.js';
+import { mcpExecutor } from '../mcp-executor.js';
 import { ProjectRegistry } from '../project-registry.js';
 import { getProductConfig } from '../product-config.js';
 import { LocalBackendRouter } from '../local-backend/router.js';
@@ -264,6 +265,7 @@ export async function createHostRuntime(options) {
             for (const handle of [...packHandles.values()].reverse()) {
                 await handle.dispose?.();
             }
+            await mcpExecutor.shutdownAll();
             await shutdownHostSidecar();
             await closeStorage();
         },

package/dist/i18n.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 主进程界面文案。与渲染层同一规则：英文是源句，应用层 registerLocale 注入译文。
+ * 本模块不依赖 Electron，菜单在 app ready 时读取。
+ */
+export declare const SOURCE_LOCALE = "en";
+export declare function normalizeLocale(raw: string | null | undefined): string | null;
+export declare function resolveLocale(options: {
+    supported: readonly string[];
+    defaultLocale: string;
+    saved: string | null;
+    system: string | null;
+}): string;
+export declare function registerLocale(locale: string, messages: Record<string, string>): void;
+export declare function configureI18n(options: {
+    locales: readonly string[];
+    defaultLocale: string;
+    systemLocale?: string | null;
+    savedLocale?: string | null;
+}): void;
+export declare function getLocale(): string;
+export declare function setLocale(locale: string): boolean;
+export declare function t(message: string, params?: Record<string, string | number>): string;
+export declare function resetI18nForTests(): void;

package/dist/i18n.js

@@ -0,0 +1,87 @@
+/**
+ * 主进程界面文案。与渲染层同一规则：英文是源句，应用层 registerLocale 注入译文。
+ * 本模块不依赖 Electron，菜单在 app ready 时读取。
+ */
+export const SOURCE_LOCALE = 'en';
+export function normalizeLocale(raw) {
+    if (!raw)
+        return null;
+    const lower = raw.trim().toLowerCase().replace(/_/g, '-');
+    if (!lower)
+        return null;
+    if (lower.startsWith('zh'))
+        return 'zh';
+    if (lower.startsWith('en'))
+        return 'en';
+    const primary = lower.split('-')[0];
+    return primary || null;
+}
+export function resolveLocale(options) {
+    const supported = options.supported.filter((locale) => locale.length > 0);
+    const list = supported.length > 0 ? supported : [SOURCE_LOCALE];
+    const pick = (value) => {
+        if (!value)
+            return null;
+        if (list.includes(value))
+            return value;
+        const normalized = normalizeLocale(value);
+        if (normalized && list.includes(normalized))
+            return normalized;
+        return null;
+    };
+    return (pick(options.saved) ??
+        pick(options.system) ??
+        pick(options.defaultLocale) ??
+        list[0] ??
+        SOURCE_LOCALE);
+}
+function formatMessage(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{(\w+)\}/g, (whole, name) => {
+        const value = params[name];
+        return value === undefined ? whole : String(value);
+    });
+}
+const catalogs = {};
+let locales = [SOURCE_LOCALE];
+let defaultLocale = SOURCE_LOCALE;
+let current = SOURCE_LOCALE;
+export function registerLocale(locale, messages) {
+    const normalized = locale.trim();
+    if (!normalized || normalized === SOURCE_LOCALE)
+        return;
+    catalogs[normalized] = { ...catalogs[normalized], ...messages };
+}
+export function configureI18n(options) {
+    const next = [...new Set(options.locales.filter((locale) => locale.length > 0))];
+    locales = next.length > 0 ? next : [SOURCE_LOCALE];
+    defaultLocale = options.defaultLocale || SOURCE_LOCALE;
+    current = resolveLocale({
+        supported: locales,
+        defaultLocale,
+        saved: options.savedLocale ?? null,
+        system: options.systemLocale ?? null,
+    });
+}
+export function getLocale() {
+    return current;
+}
+export function setLocale(locale) {
+    if (!locales.includes(locale))
+        return false;
+    current = locale;
+    return true;
+}
+export function t(message, params) {
+    const table = current === SOURCE_LOCALE ? undefined : catalogs[current];
+    const template = table?.[message] ?? message;
+    return formatMessage(template, params);
+}
+export function resetI18nForTests() {
+    for (const key of Object.keys(catalogs))
+        delete catalogs[key];
+    locales = [SOURCE_LOCALE];
+    defaultLocale = SOURCE_LOCALE;
+    current = SOURCE_LOCALE;
+}

package/dist/image-attachment.d.ts

@@ -1,4 +1,3 @@
-import type { NativeImageLike } from './runtime.js';
 import type { LlmImage } from './llm/types.js';
 /** Refuse to read source files larger than this (10 MB). */
 export declare const IMAGE_MAX_SOURCE_BYTES: number;
@@ -6,6 +5,34 @@ export declare const IMAGE_MAX_SOURCE_BYTES: number;
 export declare const IMAGE_MAX_DIMENSION = 1568;
 /** Refuse the encoded payload if it still exceeds this after re-encode (5 MB). */
 export declare const IMAGE_MAX_ENCODED_BYTES: number;
+/** A decoded raster that can be cropped, resized, and re-encoded synchronously. */
+export interface DecodedImage {
+    isEmpty(): boolean;
+    getSize(): {
+        width: number;
+        height: number;
+    };
+    crop(rect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): DecodedImage;
+    resize(o: {
+        width?: number;
+        height?: number;
+        quality?: string;
+    }): DecodedImage;
+    toPNG(): Buffer;
+    toJPEG(quality: number): Buffer;
+}
+/**
+ * Optional image decoder. Without one, images pass through as the original
+ * bytes and crop / resize / transcode requests are refused.
+ */
+export interface ImageDecoder {
+    createFromPath(p: string): DecodedImage;
+}
 export interface ImageAttachmentInput {
     path: string;
     name?: string;
@@ -65,9 +92,9 @@ export declare function computeTargetSize(width: number, height: number, maxDime
  * tool result. `_image` is consumed by the CoreLoop as an image content part;
  * it is not a path or model-visible base64 string.
  */
-export declare function processViewImage(input: ViewImageInput, nativeImage?: NativeImageLike | null): ViewImageResult;
+export declare function processViewImage(input: ViewImageInput, decoder?: ImageDecoder | null): ViewImageResult;
 /**
- * Process a batch of image attachments. Synchronous: `nativeImage` decode /
+ * Process a batch of image attachments. Synchronous: decoder decode /
  * resize / encode are all synchronous, and the byte check uses `statSync`.
  */
-export declare function processImageAttachments(files: ImageAttachmentInput[]): ProcessedImageAttachments;
+export declare function processImageAttachments(files: ImageAttachmentInput[], decoder?: ImageDecoder | null): ProcessedImageAttachments;

package/dist/image-attachment.js

@@ -3,9 +3,9 @@
  * actually see, replacing the old behavior of dropping only the file *path*
  * into the prompt text.
  *
- * Runs in the Electron main process and uses `nativeImage` to decode /
- * downscale — no native dependency, works in the packaged app. Two caps are
- * enforced before the image ever reaches the model:
+ * Decoding / downscaling runs only when an {@link ImageDecoder} is supplied;
+ * otherwise the original bytes pass through under the encoded cap. These caps
+ * are enforced before the image ever reaches the model:
  *
  *   - source bytes  (`IMAGE_MAX_SOURCE_BYTES`) — refuse to read huge files;
  *   - long-edge px  (`IMAGE_MAX_DIMENSION`)    — downscale so the provider's
@@ -17,7 +17,6 @@
  * line so the caller can inject it into the model-visible context — the model
  * should know an image was attached even when it was too large to send.
  */
-import { getNativeImage } from './runtime.js';
 import { readFileSync, statSync } from 'fs';
 import { basename, extname } from 'path';
 /** Refuse to read source files larger than this (10 MB). */
@@ -74,7 +73,7 @@ export function computeTargetSize(width, height, maxDimension = IMAGE_MAX_DIMENS
  * tool result. `_image` is consumed by the CoreLoop as an image content part;
  * it is not a path or model-visible base64 string.
  */
-export function processViewImage(input, nativeImage = getNativeImage()) {
+export function processViewImage(input, decoder = null) {
     if (!isImagePath(input.path)) {
         return {
             success: false,
@@ -104,10 +103,10 @@ export function processViewImage(input, nativeImage = getNativeImage()) {
             needsFollowup: true,
         };
     }
-    if (!nativeImage) {
+    if (!decoder) {
         return viewImageWithoutDecoder(input, sourceBytes, maxEdge);
     }
-    let rendered = nativeImage.createFromPath(input.path);
+    let rendered = decoder.createFromPath(input.path);
     if (rendered.isEmpty()) {
         return { success: false, error: '不是可识别的图片', needsFollowup: true };
     }
@@ -262,16 +261,15 @@ function formatMb(bytes) {
     return (bytes / (1024 * 1024)).toFixed(1).replace(/\.0$/, '');
 }
 /**
- * Process a batch of image attachments. Synchronous: `nativeImage` decode /
+ * Process a batch of image attachments. Synchronous: decoder decode /
  * resize / encode are all synchronous, and the byte check uses `statSync`.
  */
-export function processImageAttachments(files) {
+export function processImageAttachments(files, decoder = null) {
     const images = [];
     const notes = [];
     for (const file of files) {
         const label = file.name || basename(file.path);
-        // Existence + source-size guards run before the decoder so they're
-        // exercisable in a non-Electron (test) host too.
+        // Existence + source-size guards run before the decoder.
         let sourceBytes = 0;
         try {
             sourceBytes = statSync(file.path).size;
@@ -284,12 +282,9 @@ export function processImageAttachments(files) {
             notes.push(`- ${label}：源文件 ${formatMb(sourceBytes)}MB 超过 ${formatMb(IMAGE_MAX_SOURCE_BYTES)}MB 上限，未附加`);
             continue;
         }
-        const nativeImage = getNativeImage();
-        if (!nativeImage) {
-            // Tauri and the browser server run plain Node, which has no Electron
-            // nativeImage. The bytes are already a PNG/JPEG the provider can read;
-            // pass them through when they fit the encoded cap. Resize stays on the
-            // Electron path.
+        if (!decoder) {
+            // The bytes are already an image the provider can read; pass them
+            // through when they fit the encoded cap.
             if (sourceBytes > IMAGE_MAX_ENCODED_BYTES) {
                 notes.push(`- ${label}：源文件 ${formatMb(sourceBytes)}MB 超过 ${formatMb(IMAGE_MAX_ENCODED_BYTES)}MB，当前环境不能缩放，未附加`);
                 continue;
@@ -307,7 +302,7 @@ export function processImageAttachments(files) {
             notes.push(`- ${label}（原图）`);
             continue;
         }
-        const image = nativeImage.createFromPath(file.path);
+        const image = decoder.createFromPath(file.path);
         if (image.isEmpty()) {
             notes.push(`- ${label}：不是可识别的图片，未附加`);
             continue;

package/dist/json-store.js

@@ -1,10 +1,7 @@
 /**
- * JSON 键值存储工厂（agent-mcp-servers.json / agent-projects.json / window-state）。
- *
- * 历史上用 electron-store；它只在构造时读 `app.getPath('userData')` 当 cwd，
- * 而 conf（electron-store 的底层，已是本项目直接依赖）API 完全覆盖用到的
- * get/set + name + defaults 子集。统一走 conf + getUserDataDir()，Electron
- * 与 BS server 得到同一个文件路径，两种模式共享同一份数据。
+ * JSON 键值存储工厂（agent-mcp-servers.json / agent-projects.json /
+ * agent-local-scripts.json）。文件在 getUserDataDir() 下，由 conf 读写；
+ * 桌面与 BS server 得到同一个文件路径。
  *
  * conf@10 的 d.ts 是 ESM 风格但包本身没有 `type: module`，NodeNext 下类型
  * 解析会塌成 namespace——所以这里声明用到的最小接口并做一次强转，不依赖

package/dist/local-backend/portable-bundle.d.ts

@@ -69,9 +69,14 @@ export interface PortableWebSearchSection {
 }
 export interface PortableMcpSection {
     name: string;
-    command: string;
-    args: string[];
+    transport: 'stdio' | 'streamable-http';
+    command?: string;
+    args?: string[];
     cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    headersFromEnv?: Record<string, string>;
+    bearerTokenEnvVar?: string;
     enabled: boolean;
     envIncluded: boolean;
     env?: Record<string, string>;
@@ -178,11 +183,20 @@ export declare function webSearchSectionFromSettings(settings: {
 }, includeSecrets: boolean): PortableWebSearchSection;
 export declare function mcpSectionFromServer(server: {
     name: string;
+    transport: 'stdio';
     command: string;
     args: string[];
     cwd?: string;
     enabled: boolean;
     env: Record<string, string>;
+} | {
+    name: string;
+    transport: 'streamable-http';
+    url: string;
+    headers: Record<string, string>;
+    headersFromEnv: Record<string, string>;
+    bearerTokenEnvVar?: string;
+    enabled: boolean;
 }, includeSecrets: boolean): PortableMcpSection;
 /**
  * 把消息正文和 metadata 里的旧附件绝对路径换成新会话里的路径。

package/dist/local-backend/portable-bundle.js

@@ -5,6 +5,7 @@
  * 钥匙（模型 Key、搜索 Key、MCP 环境变量）默认不进包；`includeSecrets`
  * 为 true 时原样写入，导入方要自己确认。
  */
+import { t } from '../i18n.js';
 export const PORTABLE_SCHEMA_VERSION = 1;
 export const PORTABLE_MESSAGE_LIMIT = 1000;
 export const PORTABLE_CONFIG_KIND = 'steerable-config';
@@ -64,19 +65,19 @@ export function readPortableProject(raw) {
 }
 function thinkingLabel(mode) {
     if (mode === 'hidden')
-        return '隐藏';
+        return t('Hide');
     if (mode === 'full')
-        return '完整显示';
+        return t('Show all');
     if (mode === 'peek')
-        return '显示5行';
-    return '未识别的显示档位';
+        return t('Show 5 lines');
+    return t('Unrecognized display mode');
 }
 function execLabel(policy) {
     if (policy === 'full')
-        return '完整权限';
+        return t('Full access');
     if (policy === 'workspace')
-        return '工作区';
-    return '未识别的权限';
+        return t('Workspace');
+    return t('Unrecognized permission');
 }
 export function llmSectionFromSettings(settings, includeSecrets) {
     const apiKey = asString(settings.apiKey);
@@ -106,15 +107,27 @@ export function webSearchSectionFromSettings(settings, includeSecrets) {
     };
 }
 export function mcpSectionFromServer(server, includeSecrets) {
-    return {
-        name: server.name,
-        command: server.command,
-        args: [...server.args],
-        cwd: server.cwd,
-        enabled: server.enabled,
-        envIncluded: includeSecrets,
-        ...(includeSecrets ? { env: { ...server.env } } : {}),
-    };
+    return server.transport === 'stdio'
+        ? {
+            name: server.name,
+            transport: 'stdio',
+            command: server.command,
+            args: [...server.args],
+            cwd: server.cwd,
+            enabled: server.enabled,
+            envIncluded: includeSecrets,
+            ...(includeSecrets ? { env: { ...server.env } } : {}),
+        }
+        : {
+            name: server.name,
+            transport: 'streamable-http',
+            url: server.url,
+            headers: { ...server.headers },
+            headersFromEnv: { ...server.headersFromEnv },
+            bearerTokenEnvVar: server.bearerTokenEnvVar,
+            enabled: server.enabled,
+            envIncluded: false,
+        };
 }
 /**
  * 把消息正文和 metadata 里的旧附件绝对路径换成新会话里的路径。

package/dist/local-backend/portable-service.js

@@ -180,22 +180,36 @@ async function applyMcp(mcp, servers) {
         return 'MCP 注册表不可用';
     for (const server of servers) {
         const name = server.name?.trim();
-        const command = server.command?.trim();
-        if (!name || !command)
+        if (!name)
             continue;
-        const input = {
-            name,
-            command,
-            args: Array.isArray(server.args) ? server.args.map((arg) => String(arg)) : [],
-            cwd: server.cwd,
-            enabled: server.enabled !== false,
-            ...(server.envIncluded && server.env ? { env: server.env } : {}),
-        };
+        const input = server.transport === 'streamable-http'
+            ? {
+                name,
+                transport: 'streamable-http',
+                url: server.url?.trim() ?? '',
+                headers: server.headers ?? {},
+                headersFromEnv: server.headersFromEnv ?? {},
+                bearerTokenEnvVar: server.bearerTokenEnvVar,
+                enabled: server.enabled !== false,
+            }
+            : {
+                name,
+                transport: 'stdio',
+                command: server.command?.trim() ?? '',
+                args: Array.isArray(server.args) ? server.args.map((arg) => String(arg)) : [],
+                cwd: server.cwd,
+                enabled: server.enabled !== false,
+                ...(server.envIncluded && server.env ? { env: server.env } : {}),
+            };
+        if ((input.transport === 'stdio' && !input.command) ||
+            (input.transport === 'streamable-http' && !input.url)) {
+            continue;
+        }
         const existing = mcp.list().find((item) => item.name.toLowerCase() === name.toLowerCase());
         if (existing)
             mcp.update(existing.id, input);
         else
-            mcp.create({ ...input, env: input.env ?? {} });
+            mcp.create(input);
     }
     return null;
 }