@steerable/agent-shell 0.6.53 → 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/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.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);

package/dist/local-backend/router.js

@@ -163,7 +163,7 @@ function buildLocalAgent() {
         platform: process.platform,
         hostname: 'localhost',
         shell: process.platform === 'win32' ? 'powershell' : 'zsh',
-        osVersion: process.versions.electron || null,
+        osVersion: null,
         osArch: process.arch,
         isOnline: true,
         lastHeartbeat: now,
@@ -461,7 +461,7 @@ export class LocalBackendRouter {
             return { status: 200, data: { deletedChatIds } };
         }
         // ───── 项目模式：projects CRUD ─────
-        // 项目记录存 electron-store（agent-projects.json），chat.project_id 存
+        // 项目记录存 json-store（agent-projects.json），chat.project_id 存
         // SQLite。删除项目不删会话——会话降级为无项目对话。
         if ((pathname === '/api/v2/projects' || pathname.startsWith('/api/v2/projects/')) &&
             !getResolvedHostTools().projects.capability) {

package/dist/local-backend/skills/10-goal/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: goal
-displayName: 目标跟踪
+displayName: Goal tracking
 description: 把一句话需求变成有验收标准的目标，用 todo_write 建清单、执行中更新状态、收尾逐条给出证据。适合多步骤、跨回合、需要明确「到底做完没有」的任务。
 priority: 500
 tags: [workflow, planning, goal]

package/dist/local-backend/skills/11-loop/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: loop
-displayName: 循环执行
+displayName: Repeat on a schedule
 description: 按固定间隔或自选节奏重复执行同一件事（如「每 5 分钟查一次构建状态」）。支持本轮内有限次循环和 task_run 后台长循环，必须先定好间隔、终止条件与最大次数。
 priority: 500
 tags: [workflow, automation, loop]

package/dist/local-backend/skills/12-create-skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: create-skill
-displayName: 创建技能
+displayName: Create a skill
 description: 按本产品的 SKILL.md 规范创建一个新的本地技能，含目录结构、frontmatter 字段、写作要求。写到项目 skills/ 目录后自动出现在 Skill 设置与 / 菜单。用户说「做个技能 / 写个 skill / 把这套流程固化下来」时使用。
 priority: 500
 tags: [skill, authoring, meta]
@@ -40,7 +40,7 @@ disable-model-invocation: true
 ```markdown
 ---
 name: my-skill
-displayName: 我的技能
+displayName: My skill
 description: 做什么 + 什么时候用，一句话说清。
 priority: 500
 tags: [workflow]

package/dist/local-script-registry.js

@@ -1,9 +1,9 @@
-import Store from 'electron-store';
 import { randomUUID } from 'crypto';
+import { createJsonStore } from './json-store.js';
 export class LocalScriptRegistry {
     store;
     constructor() {
-        this.store = new Store({
+        this.store = createJsonStore({
             name: 'agent-local-scripts',
             defaults: {
                 localScripts: [],

package/dist/mcp-server-registry.d.ts

@@ -5,8 +5,8 @@
  * 持久化在 userData/agent-mcp-servers.json。已启用服务的工具会经
  * ToolRouter 以 `mcp__<serverKey>__<toolName>` 一等工具身份暴露给模型。
  *
- * 存储通过 {@link McpServerKvStore} 接口注入：main.ts 用 electron-store
- * 实现，单测用内存实现——本模块不 import electron，保持纯 Node 可测。
+ * 存储通过 {@link McpServerKvStore} 接口注入：宿主用 json-store 实现，
+ * 单测用内存实现。
  */
 import { type McpExecutorLike, type McpServerConfig } from './mcp-executor.js';
 interface McpServerCommon {
@@ -74,7 +74,7 @@ export interface UpdateMcpServerInput {
     reconnect?: StreamableHttpMcpServerEntry['reconnect'];
     enabled?: boolean;
 }
-/** 最小 KV 存储接口，避免本模块直接依赖 electron-store。 */
+/** 最小 KV 存储接口，避免本模块直接依赖具体存储实现。 */
 export interface McpServerKvStore {
     get(key: 'mcpServers'): McpServerEntry[] | undefined;
     set(key: 'mcpServers', value: McpServerEntry[]): void;

package/dist/mcp-server-registry.js

@@ -5,8 +5,8 @@
  * 持久化在 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 { MAX_MCP_SERVER_TOOLS, mcpExecutor, } from './mcp-executor.js';

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;
     /**
@@ -130,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;