@steerable/agent-shell 0.6.52 → 0.6.55

package/dist/sidecar/supervisor.d.ts

@@ -42,7 +42,6 @@ export declare class SidecarSupervisor extends EventEmitter {
     private healthTimer;
     private failedPings;
     private shuttingDown;
-    private quitListener;
     private reverseHandlers;
     private constructor();
     /** Spawn the sidecar and wait for the ready marker. */
@@ -190,7 +189,6 @@ export declare class SidecarSupervisor extends EventEmitter {
     private wrapLinux;
     private wrapWindows;
     private attachListeners;
-    private installAppQuitHook;
     private waitForReady;
     private handleStdoutChunk;
     private handleStderrChunk;

package/dist/sidecar/supervisor.js

@@ -16,7 +16,6 @@ import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { promisify } from 'node:util';
-import { onAppWillQuit, offAppWillQuit } from '../runtime.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 import { resolveWinSpawnHelperPath } from './reverse-spawn.js';
@@ -68,7 +67,6 @@ export class SidecarSupervisor extends EventEmitter {
     healthTimer = null;
     failedPings = 0;
     shuttingDown = false;
-    quitListener = null;
     reverseHandlers = new Map();
     constructor(options) {
         super();
@@ -351,10 +349,6 @@ export class SidecarSupervisor extends EventEmitter {
             return;
         this.shuttingDown = true;
         this.stopHealthTimer();
-        if (this.quitListener) {
-            offAppWillQuit(this.quitListener);
-            this.quitListener = null;
-        }
         const child = this.child;
         if (!child)
             return;
@@ -409,7 +403,6 @@ export class SidecarSupervisor extends EventEmitter {
             this.child = null;
             throw err;
         }
-        this.installAppQuitHook();
         this.startHealthTimer();
         this.emit('ready', this.readyHealth);
     }
@@ -641,13 +634,6 @@ export class SidecarSupervisor extends EventEmitter {
             this.emit('error', err);
         });
     }
-    installAppQuitHook() {
-        const hook = () => {
-            void this.shutdown();
-        };
-        this.quitListener = hook;
-        onAppWillQuit(hook);
-    }
     async waitForReady(timeoutMs) {
         return new Promise((resolve, reject) => {
             const timer = setTimeout(() => {
@@ -903,22 +889,13 @@ export function resolveSidecarPython(pythonExecutable) {
     // build_sidecar.py 的产物布局是 <platform>/python/<exe>（Windows：
     // python/python.exe；POSIX：python/bin/python3，见 build_sidecar.py 的
     // python_binary()）。保留无 python/ 层的旧布局候选做向后兼容。
-    const runtimeBases = [];
-    try {
-        const resourcesPath = process.resourcesPath;
-        if (resourcesPath) {
-            runtimeBases.push(join(resourcesPath, 'python-runtime'));
-        }
-    }
-    catch { /* not in Electron */ }
-    runtimeBases.push(join(__dirname, '..', '..', 'python-runtime'));
-    const candidates = [];
-    for (const base of runtimeBases) {
-        candidates.push(join(base, platformTag, 'python', binaryName));
-        candidates.push(join(base, platformTag, 'python', 'bin', binaryName));
-        candidates.push(join(base, platformTag, binaryName));
-        candidates.push(join(base, platformTag, 'bin', binaryName));
-    }
+    const runtimeBase = join(__dirname, '..', '..', 'python-runtime');
+    const candidates = [
+        join(runtimeBase, platformTag, 'python', binaryName),
+        join(runtimeBase, platformTag, 'python', 'bin', binaryName),
+        join(runtimeBase, platformTag, binaryName),
+        join(runtimeBase, platformTag, 'bin', binaryName),
+    ];
     // Dev-layout convenience: the framework repo root .venv (uv sync). The
     // shell lives inside the framework repo (packages/agent-shell/ts), so the
     // venv is an in-repo ancestor — no sibling-checkout probing. Without this,

package/dist/storage/index.js

@@ -316,7 +316,7 @@ export class SqliteScopedStore {
         // context_summary / context_summary_upto / context_compaction_delegated
         // 列成为无人读写的孤儿列（SQLite 不易 drop，保留无害）。
         // 项目模式（增量迁移）：chat 可绑定 ProjectRegistry 里的项目 id。
-        // 项目记录本身存在 electron-store（agent-projects.json），这里只存外键；
+        // 项目记录本身存在 json-store（agent-projects.json），这里只存外键；
         // 删项目时由路由层把本列置 NULL（会话降级为无项目对话）。
         this.ensureColumn('chat_sessions', 'project_id', 'TEXT');
         // 任务编排（增量迁移）：depends_on 存 JSON string[]——本任务等待的

package/dist/storage/write-lease-error.d.ts

@@ -1,11 +1,2 @@
-interface ElectronExit {
-    app: {
-        exit(code: number): void;
-    };
-    dialog: {
-        showErrorBox(title: string, message: string): void;
-    };
-}
-/** Maps write-lease contention to the desktop's user-facing startup failure. */
-export declare function acquireWriteLeaseOrExit<T>(acquire: () => T, loadElectron?: () => Promise<ElectronExit>, exitProcess?: (code: number) => void): T;
-export {};
+/** Maps write-lease contention to a readable startup failure and process exit. */
+export declare function acquireWriteLeaseOrExit<T>(acquire: () => T, exitProcess?: (code: number) => void): T;

package/dist/storage/write-lease-error.js

@@ -1,6 +1,6 @@
 import { StoreAlreadyOwnedError } from './write-lease.js';
-/** Maps write-lease contention to the desktop's user-facing startup failure. */
-export function acquireWriteLeaseOrExit(acquire, loadElectron = () => import('electron'), exitProcess = (code) => process.exit(code)) {
+/** Maps write-lease contention to a readable startup failure and process exit. */
+export function acquireWriteLeaseOrExit(acquire, exitProcess = (code) => process.exit(code)) {
     try {
         return acquire();
     }
@@ -9,12 +9,7 @@ export function acquireWriteLeaseOrExit(acquire, loadElectron = () => import('el
             console.error(`[bs] 本地数据库正在被另一个进程使用（${error.lockPath}）。\n` +
                 '[bs] 再打开一次桌面应用会回到已经打开的窗口。\n' +
                 '[bs] 如果终端里的 pnpm dev:bs 占着数据库，请先在那个终端按 Ctrl+C 停掉，再重新打开。');
-            void loadElectron()
-                .then(({ app, dialog }) => {
-                dialog.showErrorBox('无法再开一个', '再打开一次应用时，会回到已经打开的窗口。\n\n这次没有回到那个窗口，是因为本地数据库正被另一个进程占用。如果终端里还在跑 pnpm dev:bs，先停掉它，再重新打开。');
-                app.exit(1);
-            })
-                .catch(() => exitProcess(1));
+            queueMicrotask(() => exitProcess(1));
         }
         throw error;
     }

package/dist/tool-router.js

@@ -172,7 +172,8 @@ export class ToolRouter {
         return [
             {
                 name: 'local_exec_shell',
-                description: 'Execute a local shell command',
+                description: 'Execute a shell command in a pseudo-terminal. Set pty to false for a plain pipe. ' +
+                    'When this host is configured with a remote endpoint, the command runs on that host instead of this machine.',
                 mode: 'destructive',
                 inputSchema: {
                     type: 'object',
@@ -180,6 +181,7 @@ export class ToolRouter {
                         command: { type: 'string' },
                         cwd: { type: 'string' },
                         timeout: { type: 'number', description: 'Timeout in milliseconds (e.g. 30000). If a small number like 15 or 30 is provided, it is assumed to be in seconds and automatically multiplied by 1000.' },
+                        pty: { type: 'boolean', description: 'Run in a pseudo-terminal. Defaults to true.' },
                     },
                     required: ['command'],
                 },
@@ -377,32 +379,35 @@ export class ToolRouter {
             },
             {
                 name: 'mcp_list_tools',
-                description: 'List tools from one MCP server',
+                description: 'List tools from one MCP server. Pass command for stdio or url for unauthenticated Streamable HTTP.',
                 mode: 'external',
                 inputSchema: {
                     type: 'object',
                     properties: {
                         command: { type: 'string' },
+                        url: { type: 'string' },
                         args: { type: 'array', items: { type: 'string' } },
                         cwd: { type: 'string' },
                     },
-                    required: ['command'],
+                    additionalProperties: false,
                 },
             },
             {
                 name: 'mcp_tool_exec',
-                description: 'Execute one MCP tool',
+                description: 'Execute one MCP tool. Pass command for stdio or url for unauthenticated Streamable HTTP.',
                 mode: 'external',
                 inputSchema: {
                     type: 'object',
                     properties: {
                         command: { type: 'string' },
+                        url: { type: 'string' },
                         args: { type: 'array', items: { type: 'string' } },
                         cwd: { type: 'string' },
                         toolName: { type: 'string' },
                         toolArgs: { type: 'object' },
                     },
-                    required: ['command', 'toolName'],
+                    required: ['toolName'],
+                    additionalProperties: false,
                 },
             },
             // deferred 层的发现缝（Wave 2 工具分层）：MCP 动态工具不占每轮
@@ -890,6 +895,7 @@ export class ToolRouter {
                     command: String(args.command || ''),
                     cwd: typeof args.cwd === 'string' ? args.cwd : undefined,
                     timeout: typeof args.timeout === 'number' ? args.timeout : undefined,
+                    pty: args.pty !== false,
                 }, projectRoot, context?.additionalWriteRoots ?? null);
             case 'local_read_file':
                 return await this.localExecutor.readLocalFile({
@@ -1257,8 +1263,17 @@ export class ToolRouter {
         return { path: resolved };
     }
     resolveMcpConfig(args) {
+        const command = typeof args.command === 'string' ? args.command.trim() : '';
+        const url = typeof args.url === 'string' ? args.url.trim() : '';
+        if (command && url)
+            throw new Error('MCP 调用只能提供 command 或 url 之一');
+        if (url)
+            return { transport: 'streamable-http', url };
+        if (!command)
+            throw new Error('MCP 调用需要 command（stdio）或 url（Streamable HTTP）');
         return {
-            command: String(args.command || ''),
+            transport: 'stdio',
+            command,
             args: Array.isArray(args.args) ? args.args.map(item => String(item)) : undefined,
             cwd: typeof args.cwd === 'string' ? args.cwd : undefined,
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-shell",
-  "version": "0.6.52",
+  "version": "0.6.55",
   "description": "Steerable framework — product-neutral Node HostRuntime and headless HTTP server shared by Tauri desktop and browser deployments; scenario packs extend it through @steerable/pack-sdk.",
   "license": "Apache-2.0",
   "homepage": "https://steerableframework.com/",
@@ -45,39 +45,32 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@modelcontextprotocol/sdk": "1.30.0",
     "better-sqlite3": "^11.9.1",
     "conf": "10.2.0",
     "dotenv": "^17.4.2",
     "electron-log": "^5.4.3",
-    "electron-store": "^8.1.0",
-    "electron-updater": "^6.8.9",
     "he": "^1.2.0",
     "node-pty": "^1.1.0",
-    "semver": "^7.8.0",
-    "@steerable/agent-harness": "0.6.52",
-    "@steerable/agent-protocol": "0.6.52",
-    "@steerable/pack-sdk": "0.6.52"
+    "@steerable/agent-harness": "0.6.55",
+    "@steerable/pack-sdk": "0.6.55",
+    "@steerable/agent-protocol": "0.6.55"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/he": "^1.2.3",
     "@types/node": "^22.10.5",
-    "@types/semver": "^7.8.0",
-    "electron": "^28.3.3",
-    "esbuild": "^0.25.0",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4"
   },
   "scripts": {
     "gen": "echo agent-shell-ts",
-    "build": "tsc -p tsconfig.json && node copy-skills.mjs && node scripts/build-preload.mjs",
+    "build": "tsc -p tsconfig.json && node copy-skills.mjs",
     "test": "vitest run",
     "lint": "tsc -p tsconfig.json --noEmit && node scripts/check-shell-neutral.mjs && node scripts/check-storage-boundaries.mjs",
     "check:drift": "echo ok",
     "shell:neutral": "node scripts/check-shell-neutral.mjs",
     "storage:boundaries": "node scripts/check-storage-boundaries.mjs",
-    "web": "DEEPPATH_WEB_DIST=${DEEPPATH_WEB_DIST:-../web/app/dist} node dist/server/index.js",
-    "client": "DEEPPATH_FORCE_BUNDLED_WEB=1 DEEPPATH_WEB_DIST=${DEEPPATH_WEB_DIST:-../web/app/dist} node node_modules/electron/cli.js dist/main.js"
+    "web": "DEEPPATH_WEB_DIST=${DEEPPATH_WEB_DIST:-../web/app/dist} node dist/server/index.js"
   }
 }

package/dist/app-update-electron.d.ts

@@ -1,5 +0,0 @@
-/**
- * electron-updater 适配。只在桌面主进程启用更新时加载。
- */
-import type { AppUpdaterPort } from './app-update.js';
-export declare function createElectronAppUpdater(): AppUpdaterPort;

package/dist/app-update-electron.js

@@ -1,66 +0,0 @@
-/**
- * electron-updater 适配。只在桌面主进程启用更新时加载。
- */
-import log from 'electron-log';
-import electronUpdater from 'electron-updater';
-export function createElectronAppUpdater() {
-    const { autoUpdater } = electronUpdater;
-    autoUpdater.logger = log;
-    return {
-        get autoDownload() {
-            return autoUpdater.autoDownload;
-        },
-        set autoDownload(value) {
-            autoUpdater.autoDownload = value;
-        },
-        get autoInstallOnAppQuit() {
-            return autoUpdater.autoInstallOnAppQuit;
-        },
-        set autoInstallOnAppQuit(value) {
-            autoUpdater.autoInstallOnAppQuit = value;
-        },
-        get allowDowngrade() {
-            return autoUpdater.allowDowngrade;
-        },
-        set allowDowngrade(value) {
-            autoUpdater.allowDowngrade = value;
-        },
-        setFeedURL(options) {
-            autoUpdater.setFeedURL(options);
-        },
-        async checkForUpdates() {
-            const result = await autoUpdater.checkForUpdates();
-            if (!result)
-                return null;
-            return {
-                updateInfo: { version: result.updateInfo.version },
-                isUpdateAvailable: result.isUpdateAvailable,
-            };
-        },
-        quitAndInstall(isSilent, isForceRunAfter) {
-            autoUpdater.quitAndInstall(isSilent, isForceRunAfter);
-        },
-        on(event, listener) {
-            if (event === 'download-progress') {
-                autoUpdater.on('download-progress', listener);
-            }
-            else if (event === 'update-downloaded') {
-                autoUpdater.on('update-downloaded', listener);
-            }
-            else {
-                autoUpdater.on('error', listener);
-            }
-        },
-        off(event, listener) {
-            if (event === 'download-progress') {
-                autoUpdater.off('download-progress', listener);
-            }
-            else if (event === 'update-downloaded') {
-                autoUpdater.off('update-downloaded', listener);
-            }
-            else {
-                autoUpdater.off('error', listener);
-            }
-        },
-    };
-}

package/dist/app-update.d.ts

@@ -1,92 +0,0 @@
-/**
- * 桌面自动更新。产品经 `ProductConfig.updates.feedUrl` 注入 generic 通道；
- * 本模块只编排检查、下载和安装，具体传输交给 `AppUpdaterPort`
- * （生产环境是 electron-updater）。
- */
-export declare const APP_UPDATE_CHECK_INTERVAL_MS: number;
-export type AppUpdatePhase = 'disabled' | 'idle' | 'checking' | 'downloading' | 'ready' | 'installing' | 'error';
-export interface AppUpdateState {
-    phase: AppUpdatePhase;
-    version?: string;
-    percent?: number;
-    message?: string;
-}
-/** 渲染层看到的版本与更新状态。`version` 是当前安装版本。 */
-export interface AppReleaseSnapshot {
-    version: string;
-    enabled: boolean;
-    phase: AppUpdatePhase;
-    availableVersion?: string;
-    percent?: number;
-    message?: string;
-}
-export declare function toAppReleaseSnapshot(currentVersion: string, state: AppUpdateState): AppReleaseSnapshot;
-export interface AppUpdateCheckResult {
-    updateInfo: {
-        version: string;
-    };
-    isUpdateAvailable: boolean;
-}
-export interface AppUpdaterPort {
-    autoDownload: boolean;
-    autoInstallOnAppQuit: boolean;
-    allowDowngrade: boolean;
-    setFeedURL(options: {
-        provider: 'generic';
-        url: string;
-    }): void;
-    checkForUpdates(): Promise<AppUpdateCheckResult | null>;
-    quitAndInstall(isSilent?: boolean, isForceRunAfter?: boolean): void;
-    on(event: 'download-progress', listener: (progress: {
-        percent: number;
-    }) => void): void;
-    on(event: 'update-downloaded', listener: (info: {
-        version: string;
-    }) => void): void;
-    on(event: 'error', listener: (error: Error) => void): void;
-    off(event: 'download-progress', listener: (progress: {
-        percent: number;
-    }) => void): void;
-    off(event: 'update-downloaded', listener: (info: {
-        version: string;
-    }) => void): void;
-    off(event: 'error', listener: (error: Error) => void): void;
-}
-export interface AppUpdateOptions {
-    feedUrl?: string;
-    packaged: boolean;
-    currentVersion: string;
-    env: NodeJS.ProcessEnv;
-    updater: AppUpdaterPort;
-    onState?: (state: AppUpdateState) => void;
-    /** 测试注入。缺省写 `env.DEEPPATH_UPDATE_STATUS_FILE`。 */
-    statusFile?: string;
-}
-export declare function appUpdateMenuAction(state: AppUpdateState): 'none' | 'check' | 'install';
-export declare function shouldNotifyUpdateReady(previous: AppUpdatePhase, next: AppUpdateState): boolean;
-export declare class AppUpdateController {
-    private readonly options;
-    private current;
-    private enabled;
-    private started;
-    private disposed;
-    private bound;
-    private candidate;
-    private downloadedVersion;
-    private checkPromise;
-    private cancelTimer;
-    private readonly statusFile;
-    constructor(options: AppUpdateOptions);
-    get state(): AppUpdateState;
-    start(): Promise<AppUpdateState>;
-    checkNow(): Promise<AppUpdateState>;
-    installNow(): AppUpdateState;
-    dispose(): void;
-    private bind;
-    private readonly onProgress;
-    private readonly onDownloaded;
-    private readonly onError;
-    private doCheck;
-    private isNewer;
-    private publish;
-}

package/dist/app-update.js

@@ -1,213 +0,0 @@
-/**
- * 桌面自动更新。产品经 `ProductConfig.updates.feedUrl` 注入 generic 通道；
- * 本模块只编排检查、下载和安装，具体传输交给 `AppUpdaterPort`
- * （生产环境是 electron-updater）。
- */
-import { appendFileSync } from 'node:fs';
-import { gt, valid } from 'semver';
-export const APP_UPDATE_CHECK_INTERVAL_MS = 4 * 60 * 60 * 1000;
-export function toAppReleaseSnapshot(currentVersion, state) {
-    const snapshot = {
-        version: currentVersion,
-        enabled: state.phase !== 'disabled',
-        phase: state.phase,
-    };
-    if (state.version)
-        snapshot.availableVersion = state.version;
-    if (state.percent !== undefined)
-        snapshot.percent = state.percent;
-    if (state.message)
-        snapshot.message = state.message;
-    return snapshot;
-}
-export function appUpdateMenuAction(state) {
-    if (state.phase === 'disabled')
-        return 'none';
-    if (state.phase === 'ready' || state.phase === 'installing')
-        return 'install';
-    return 'check';
-}
-export function shouldNotifyUpdateReady(previous, next) {
-    return previous !== 'ready' && next.phase === 'ready' && Boolean(next.version);
-}
-function resolveFeed(options) {
-    const override = options.env.DEEPPATH_UPDATE_FEED_URL?.trim() ?? '';
-    const feedUrl = override || options.feedUrl?.trim() || '';
-    const forceUnpackaged = options.env.DEEPPATH_APP_UPDATE === '1';
-    if (!feedUrl || (!options.packaged && !forceUnpackaged))
-        return { enabled: false };
-    return { enabled: true, feedUrl };
-}
-function clampPercent(percent) {
-    if (!Number.isFinite(percent))
-        return 0;
-    return Math.min(100, Math.max(0, percent));
-}
-function defaultSchedule(fn, ms) {
-    const timer = setInterval(fn, ms);
-    timer.unref();
-    return () => clearInterval(timer);
-}
-export class AppUpdateController {
-    options;
-    current = { phase: 'disabled' };
-    enabled = false;
-    started = false;
-    disposed = false;
-    bound = false;
-    candidate;
-    downloadedVersion;
-    checkPromise;
-    cancelTimer;
-    statusFile;
-    constructor(options) {
-        this.options = options;
-        this.statusFile = options.statusFile ?? options.env.DEEPPATH_UPDATE_STATUS_FILE;
-    }
-    get state() {
-        return this.current;
-    }
-    async start() {
-        if (this.started)
-            return this.checkPromise ?? this.state;
-        this.started = true;
-        const target = resolveFeed(this.options);
-        if (!target.enabled)
-            return this.publish({ phase: 'disabled' });
-        this.enabled = true;
-        this.options.updater.autoDownload = true;
-        this.options.updater.autoInstallOnAppQuit = true;
-        this.options.updater.allowDowngrade = false;
-        this.options.updater.setFeedURL({ provider: 'generic', url: target.feedUrl });
-        this.bind();
-        const first = this.checkNow();
-        this.cancelTimer = defaultSchedule(() => {
-            void this.checkNow();
-        }, APP_UPDATE_CHECK_INTERVAL_MS);
-        return first;
-    }
-    checkNow() {
-        if (this.disposed || !this.enabled)
-            return Promise.resolve(this.state);
-        if (this.state.phase === 'downloading' || this.state.phase === 'ready' || this.state.phase === 'installing') {
-            return Promise.resolve(this.state);
-        }
-        if (this.checkPromise)
-            return this.checkPromise;
-        this.checkPromise = this.doCheck().finally(() => {
-            this.checkPromise = undefined;
-        });
-        return this.checkPromise;
-    }
-    installNow() {
-        if (this.disposed || this.state.phase !== 'ready' || !this.downloadedVersion)
-            return this.state;
-        const version = this.downloadedVersion;
-        this.publish({ phase: 'installing', version });
-        try {
-            this.options.updater.quitAndInstall(false, true);
-        }
-        catch (error) {
-            return this.publish({
-                phase: 'error',
-                version,
-                message: error instanceof Error ? error.message : String(error),
-            });
-        }
-        return this.state;
-    }
-    dispose() {
-        this.disposed = true;
-        this.cancelTimer?.();
-        this.cancelTimer = undefined;
-        if (!this.bound)
-            return;
-        this.options.updater.off('download-progress', this.onProgress);
-        this.options.updater.off('update-downloaded', this.onDownloaded);
-        this.options.updater.off('error', this.onError);
-        this.bound = false;
-    }
-    bind() {
-        if (this.bound)
-            return;
-        this.bound = true;
-        this.options.updater.on('download-progress', this.onProgress);
-        this.options.updater.on('update-downloaded', this.onDownloaded);
-        this.options.updater.on('error', this.onError);
-    }
-    onProgress = (progress) => {
-        if (this.downloadedVersion)
-            return;
-        this.publish({
-            phase: 'downloading',
-            ...(this.candidate ? { version: this.candidate } : {}),
-            percent: clampPercent(progress.percent),
-        });
-    };
-    onDownloaded = (info) => {
-        if (!this.isNewer(info.version))
-            return;
-        this.downloadedVersion = info.version;
-        this.candidate = info.version;
-        this.publish({ phase: 'ready', version: info.version });
-    };
-    onError = (error) => {
-        const version = this.candidate ?? this.state.version;
-        this.publish({
-            phase: 'error',
-            ...(version ? { version } : {}),
-            message: error instanceof Error ? error.message : String(error),
-        });
-    };
-    async doCheck() {
-        this.downloadedVersion = undefined;
-        this.candidate = undefined;
-        this.publish({ phase: 'checking' });
-        try {
-            const result = await this.options.updater.checkForUpdates();
-            if (this.disposed)
-                return this.state;
-            if (this.downloadedVersion && this.isNewer(this.downloadedVersion)) {
-                if (this.state.phase === 'ready' && this.state.version === this.downloadedVersion)
-                    return this.state;
-                return this.publish({ phase: 'ready', version: this.downloadedVersion });
-            }
-            if (!result)
-                return this.publish({ phase: 'error', message: 'app update: no check result' });
-            const version = result.updateInfo.version;
-            if (!result.isUpdateAvailable)
-                return this.publish({ phase: 'idle' });
-            if (valid(version) === null) {
-                return this.publish({ phase: 'error', message: 'app update: feed version is invalid' });
-            }
-            if (!this.isNewer(version))
-                return this.publish({ phase: 'idle' });
-            this.candidate = version;
-            if (this.state.phase === 'downloading') {
-                return this.publish({ phase: 'downloading', version, percent: this.state.percent ?? 0 });
-            }
-            return this.publish({ phase: 'downloading', version, percent: 0 });
-        }
-        catch (error) {
-            if (this.disposed)
-                return this.state;
-            return this.publish({
-                phase: 'error',
-                ...(this.candidate ? { version: this.candidate } : {}),
-                message: error instanceof Error ? error.message : String(error),
-            });
-        }
-    }
-    isNewer(version) {
-        return valid(version) !== null && valid(this.options.currentVersion) !== null && gt(version, this.options.currentVersion);
-    }
-    publish(state) {
-        if (this.disposed)
-            return this.current;
-        this.current = state;
-        if (this.statusFile)
-            appendFileSync(this.statusFile, `${JSON.stringify(state)}\n`);
-        this.options.onState?.(state);
-        return state;
-    }
-}

package/dist/host/ipc.d.ts

@@ -1,11 +0,0 @@
-/**
- * 包 IPC 绑定器（0.3e）：把包的 IpcContribution 注册到 Electron ipcMain。
- *
- * 命名空间规则：channel 必须以 `<packId>:` 开头——包只能占用自己的
- * 命名空间，注册期 fail fast。handler 统一收单个序列化载荷（renderer
- * 经 preload 透传），返回值经 IPC 结构化克隆回 renderer。
- */
-import type { IpcContribution } from '../scenario/pack.js';
-/** 命名空间校验（纯函数，单测直接覆盖）。 */
-export declare function assertPackChannel(packId: string, channel: string): void;
-export declare function registerPackIpc(packId: string, contributions: readonly IpcContribution[]): void;