@steerable/agent-shell 0.6.53 → 0.6.56

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;

package/dist/host/ipc.js

@@ -1,20 +0,0 @@
-/**
- * 包 IPC 绑定器（0.3e）：把包的 IpcContribution 注册到 Electron ipcMain。
- *
- * 命名空间规则：channel 必须以 `<packId>:` 开头——包只能占用自己的
- * 命名空间，注册期 fail fast。handler 统一收单个序列化载荷（renderer
- * 经 preload 透传），返回值经 IPC 结构化克隆回 renderer。
- */
-import { ipcMain } from 'electron';
-/** 命名空间校验（纯函数，单测直接覆盖）。 */
-export function assertPackChannel(packId, channel) {
-    if (!channel.startsWith(`${packId}:`)) {
-        throw new Error(`[pack-ipc] channel "${channel}" must be namespaced under "${packId}:"`);
-    }
-}
-export function registerPackIpc(packId, contributions) {
-    for (const contribution of contributions) {
-        assertPackChannel(packId, contribution.channel);
-        ipcMain.handle(contribution.channel, (_event, payload) => contribution.handler(payload));
-    }
-}

package/dist/main.d.ts

@@ -1 +0,0 @@
-export {};