@steerable/agent-shell 0.6.53 → 0.6.55

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 {};