@senpi/runtime 1.0.95-dev.20260408174401

package/dist/runtime/auto-update/coordinator.js

@@ -0,0 +1,336 @@
+import { runCommand } from "./command-runner.js";
+import { evaluateGatewayRestartCapability } from "./gateway-restart.js";
+import { classifyUpdate, parseSemver } from "./policy.js";
+import { evaluatePreflight } from "./preflight.js";
+import { AutoUpdateStateStore } from "./state-store.js";
+import { createDefaultAutoUpdateState, } from "./types.js";
+import { NpmVersionSource } from "./version-source.js";
+/**
+ * Central lifecycle manager for the plugin auto-update feature.
+ *
+ * Polls the npm registry on a configurable interval, classifies the
+ * version delta, and either notifies the user or applies the update
+ * automatically depending on the resolved {@link AutoUpdateMode}.
+ *
+ * After a successful update, the coordinator evaluates whether the
+ * OpenClaw gateway can be restarted via a config-file bump and either
+ * triggers the restart or asks the user to do so manually.
+ *
+ * Thread-safety is enforced via a `runToken` / `stopped` flag pair
+ * so that `stop()` reliably prevents any in-flight tick from
+ * rescheduling.
+ */
+export class AutoUpdateCoordinator {
+    options;
+    store;
+    versionSource;
+    runUpdateCommand;
+    timer = null;
+    running = false;
+    stopped = true;
+    runToken = 0;
+    state;
+    snapshot;
+    preflightReasons = [];
+    constructor(options) {
+        this.options = options;
+        this.store = new AutoUpdateStateStore(options.stateDir, options.logger);
+        this.versionSource = options.versionSource ?? new NpmVersionSource();
+        this.runUpdateCommand = options.runUpdateCommand ?? defaultRunUpdateCommand;
+        this.state = createDefaultAutoUpdateState(options.currentVersion, options.config.mode);
+        this.snapshot = this.buildSnapshot("disabled", "not-started");
+        if (!parseSemver(options.currentVersion)) {
+            options.logger.warn(`[senpi-auto-update] currentVersion "${options.currentVersion}" is not valid semver; update detection will not work`);
+        }
+    }
+    /** Run preflight checks, load persisted state, and schedule the first version poll. */
+    async start() {
+        this.runToken += 1;
+        this.stopped = false;
+        const { logger, config } = this.options;
+        if (!this.options.enabled || !config.enabled) {
+            this.stopped = true;
+            this.snapshot = this.buildSnapshot("disabled", "auto-update-disabled");
+            logger.info(`[senpi-auto-update] disabled by config (pluginEnabled=${String(this.options.enabled)}, configEnabled=${String(config.enabled)})`);
+            return;
+        }
+        logger.info(`[senpi-auto-update] starting | localVersion=${this.options.currentVersion} package=${this.options.packageName} mode=${config.mode} pollInterval=${config.pollIntervalMinutes}m startupDelay=${config.startupDelaySeconds}s failureBackoff=${config.failureBackoffMinutes}m maxBackoff=${config.maxBackoffMinutes}m`);
+        const preflight = evaluatePreflight({
+            configuredMode: config.mode,
+            canUpdatePlugin: this.options.canUpdatePlugin ?? true,
+        });
+        this.preflightReasons = preflight.reasons;
+        logger.info(`[senpi-auto-update] preflight result | ok=${String(preflight.ok)} effectiveMode=${preflight.effectiveMode} reasons=${preflight.reasons.join(",") || "none"}`);
+        this.state = await this.store.load(this.options.currentVersion, preflight.effectiveMode);
+        this.state.effectiveMode = preflight.effectiveMode;
+        try {
+            await this.store.save(this.state);
+        }
+        catch (error) {
+            this.options.logger.warn(`[senpi-auto-update] failed to persist initial state: ${formatErr(error)}`);
+        }
+        this.snapshot = this.buildSnapshot("healthy", "started");
+        const delayMs = config.startupDelaySeconds * 1000;
+        logger.info(`[senpi-auto-update] first check scheduled | delayMs=${delayMs} nextCheckAt=${new Date(Date.now() + delayMs).toISOString()}`);
+        this.scheduleNext(delayMs, this.runToken);
+    }
+    /** Cancel the next scheduled poll and prevent in-flight ticks from rescheduling. */
+    async stop() {
+        this.runToken += 1;
+        this.stopped = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Return the latest point-in-time snapshot for health/state gateway RPCs. */
+    getSnapshot() {
+        return this.snapshot;
+    }
+    /** Schedule the next `tick` after `delayMs`, guarded by stop/token checks. */
+    scheduleNext(delayMs, token) {
+        if (this.stopped || token !== this.runToken) {
+            this.options.logger.info(`[senpi-auto-update] scheduleNext skipped (stopped=${String(this.stopped)} tokenMatch=${String(token === this.runToken)})`);
+            return;
+        }
+        if (this.timer)
+            clearTimeout(this.timer);
+        const now = Date.now();
+        const waitMs = Math.max(1_000, delayMs);
+        const nextCheckAt = new Date(now + waitMs).toISOString();
+        this.options.logger.info(`[senpi-auto-update] next check scheduled | delayMs=${waitMs} nextCheckAt=${nextCheckAt}`);
+        this.snapshot = {
+            ...this.snapshot,
+            nextCheckAt,
+        };
+        this.timer = setTimeout(() => {
+            void this.tick(token);
+        }, waitMs);
+    }
+    /** Single poll cycle: run the check, persist state, and schedule the next cycle. */
+    async tick(token) {
+        if (this.running || this.stopped || token !== this.runToken) {
+            this.options.logger.info(`[senpi-auto-update] tick skipped (running=${String(this.running)} stopped=${String(this.stopped)} tokenMatch=${String(token === this.runToken)})`);
+            return;
+        }
+        this.running = true;
+        this.options.logger.info(`[senpi-auto-update] tick started | localVersion=${this.options.currentVersion}`);
+        const state = this.state;
+        try {
+            await this.runTick(state);
+            state.consecutiveFailures = 0;
+            state.lastFailureAt = undefined;
+            state.lastFailureReason = undefined;
+            await this.persistState(state);
+            const nextDelayMs = this.options.config.pollIntervalMinutes * 60_000;
+            this.options.logger.info(`[senpi-auto-update] tick succeeded, scheduling next | nextDelayMs=${nextDelayMs}`);
+            if (!this.stopped && token === this.runToken) {
+                this.scheduleNext(nextDelayMs, token);
+            }
+        }
+        catch (error) {
+            state.consecutiveFailures += 1;
+            state.lastFailureAt = new Date().toISOString();
+            state.lastFailureReason = formatErr(error);
+            await this.persistState(state);
+            const base = this.options.config.failureBackoffMinutes * 60_000;
+            const max = this.options.config.maxBackoffMinutes * 60_000;
+            const backoff = Math.min(max, base * Math.max(1, state.consecutiveFailures));
+            this.options.logger.info(`[senpi-auto-update] tick failed, backing off | error=${formatErr(error)} consecutiveFailures=${state.consecutiveFailures} backoffMs=${backoff}`);
+            this.snapshot = this.buildSnapshot("degraded", this.snapshot.lastAction, formatErr(error));
+            if (!this.stopped && token === this.runToken) {
+                this.scheduleNext(backoff, token);
+            }
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    /** Core update logic: fetch latest version, classify, and take action. */
+    async runTick(state) {
+        const { logger } = this.options;
+        state.lastCheckedAt = new Date().toISOString();
+        logger.info(`[senpi-auto-update] fetching latest version from npm | package=${this.options.packageName} localVersion=${this.options.currentVersion}`);
+        const latest = await this.versionSource.getLatestVersion(this.options.packageName);
+        state.latestVersionLastSeen = latest;
+        const updateType = classifyUpdate(this.options.currentVersion, latest);
+        const willUpdate = updateType !== "none" && updateType !== "major";
+        logger.info(`[senpi-auto-update] version check result | localVersion=${this.options.currentVersion} remoteVersion=${latest} updateType=${updateType} willUpdate=${String(willUpdate)}`);
+        if (updateType === "none") {
+            this.snapshot = this.buildSnapshot("healthy", `no-update:${latest}`);
+            return;
+        }
+        if (updateType === "major") {
+            await this.handleMajorAvailable(state, latest);
+            return;
+        }
+        if (!this.isAllowedByPolicy(updateType)) {
+            logger.info(`[senpi-auto-update] update blocked by policy | updateType=${updateType} remoteVersion=${latest}`);
+            this.snapshot = this.buildSnapshot("healthy", `policy-blocked:${updateType}:${latest}`);
+            return;
+        }
+        if (state.effectiveMode !== "auto-apply") {
+            await this.notifyUpdateAvailable(state, latest, updateType);
+            return;
+        }
+        await this.runUpdateTransaction(state, latest, updateType);
+    }
+    isAllowedByPolicy(kind) {
+        if (kind === "patch")
+            return this.options.config.allowPatch;
+        if (kind === "minor")
+            return this.options.config.allowMinor;
+        return false;
+    }
+    async handleMajorAvailable(state, latest) {
+        if (state.lastNotifiedMajorVersion === latest) {
+            this.snapshot = this.buildSnapshot("healthy", `major-seen:${latest}`);
+            return;
+        }
+        await this.options.notify(`Senpi update available: v${latest} (major).\n` +
+            `Auto-update will not apply major versions.\n` +
+            `Please review changelog and run: openclaw plugins update ${this.options.packageName}`);
+        state.lastNotifiedMajorVersion = latest;
+        this.snapshot = this.buildSnapshot("healthy", `major-notified:${latest}`);
+    }
+    async notifyUpdateAvailable(state, latest, kind) {
+        if (state.lastNotifiedUpdateVersion === latest) {
+            this.snapshot = this.buildSnapshot("healthy", `update-seen:${kind}:${latest}`);
+            return;
+        }
+        await this.options.notify(`Senpi update available: v${latest} (${kind}).\n` +
+            `Auto-update mode is notify-only.\n` +
+            `Run: openclaw plugins update ${this.options.packageName}`);
+        state.lastNotifiedUpdateVersion = latest;
+        this.snapshot = this.buildSnapshot("healthy", `update-notified:${kind}:${latest}`);
+    }
+    /**
+     * Install the update, stop runtimes, evaluate restart capability,
+     * and either trigger a gateway restart or notify the user to do so manually.
+     *
+     * Execution order is critical:
+     * 1. Run `openclaw plugins update` — writes new files to disk but the running
+     *    process still executes the old code, so runtimes are unaffected.
+     *    If this step fails the transaction is aborted and the user is notified;
+     *    runtimes remain running and `lastAppliedVersion` is NOT advanced.
+     * 2. Record success for observability (`lastAppliedVersion` / `lastSuccessAt`).
+     * 3. Stop runtimes (best-effort — errors are logged but do not abort the flow).
+     * 4. Evaluate gateway restart capability and trigger the config-file bump,
+     *    or ask the user to restart manually when a bump is not possible.
+     */
+    async runUpdateTransaction(state, latest, kind) {
+        state.lastAttemptAt = new Date().toISOString();
+        await this.options.notify(`Senpi auto-update in progress: ${this.options.currentVersion} -> ${latest} (${kind}).`);
+        // Step 1: run the package update.  Throw (to tick's catch) on failure so
+        // runtimes stay up and lastAppliedVersion is never advanced for this version.
+        try {
+            await this.runUpdateCommand(this.options.packageName);
+        }
+        catch (err) {
+            const reason = formatErr(err);
+            await this.options.notify(`Senpi auto-update failed: ${this.options.currentVersion} -> ${latest}.\n` +
+                `Reason: ${reason}\n` +
+                `Will retry after backoff.`).catch(() => { });
+            throw err;
+        }
+        // Step 2: record success before touching runtimes.
+        state.lastSuccessAt = new Date().toISOString();
+        state.lastAppliedVersion = latest;
+        // Step 3: stop runtimes (best-effort).  A failed stop is logged but must
+        // not abort the gateway restart — the gateway itself will clean up on reload.
+        try {
+            await this.options.stopRuntimesForUpdate();
+        }
+        catch (err) {
+            this.options.logger.error(`[senpi-auto-update] stopRuntimesForUpdate threw; proceeding with gateway restart anyway | err=${formatErr(err)}`);
+        }
+        const capability = await evaluateGatewayRestartCapability({
+            configFromApi: this.options.configFromApi,
+            loadConfig: this.options.loadConfig,
+            writeConfigFile: this.options.writeConfigFile,
+            pluginId: this.options.pluginId,
+        });
+        state.restartCapability = capability.capable ? "capable" : "not-capable";
+        state.restartCapabilityReasons = capability.reasons;
+        state.restartCapabilityMode = capability.mode;
+        if (!capability.capable || !capability.config || !this.options.writeConfigFile) {
+            await this.options.notify(`Senpi updated to v${latest}, but automatic gateway restart is not available.\n` +
+                `Please restart OpenClaw gateway manually.\n` +
+                `Reason(s): ${capability.reasons.join(", ") || "unknown"}`);
+            this.snapshot = this.buildSnapshot("degraded", `updated-manual-restart:${latest}`);
+            return;
+        }
+        const nowIso = new Date().toISOString();
+        try {
+            const { triggerGatewayRestartViaConfigBump } = await import("./gateway-restart.js");
+            await triggerGatewayRestartViaConfigBump({
+                loadedConfig: capability.config,
+                writeConfigFile: this.options.writeConfigFile,
+                pluginId: this.options.pluginId,
+                triggerValue: nowIso,
+            });
+            state.lastRestartTriggerAt = nowIso;
+            state.lastRestartTriggerMode = capability.mode ?? "unknown";
+            await this.options.notify(`Senpi updated to v${latest}. Gateway restart requested via config reload (${state.lastRestartTriggerMode}).`);
+            this.snapshot = this.buildSnapshot("healthy", `updated-restart-requested:${latest}`);
+        }
+        catch (error) {
+            const reason = formatErr(error);
+            await this.options.notify(`Senpi updated to v${latest}, but restart trigger failed.\n` +
+                `Please restart OpenClaw gateway manually.\n` +
+                `Reason: ${reason}`);
+            state.restartCapability = "not-capable";
+            state.restartCapabilityReasons = [
+                ...state.restartCapabilityReasons,
+                `restart-trigger-failed:${reason}`,
+            ];
+            this.snapshot = this.buildSnapshot("degraded", `updated-restart-failed:${latest}`, reason);
+        }
+    }
+    /** Assemble a read-only snapshot from current state for external consumers. */
+    buildSnapshot(health, lastAction, lastError = null) {
+        const state = this.state;
+        return {
+            enabled: this.options.enabled && this.options.config.enabled,
+            configuredMode: this.options.config.mode,
+            effectiveMode: state.effectiveMode,
+            health,
+            currentVersion: this.options.currentVersion,
+            latestVersion: state.latestVersionLastSeen || this.options.currentVersion,
+            lastCheckedAt: state.lastCheckedAt || null,
+            lastAction,
+            lastError: lastError
+                ?? (health === "degraded" || health === "unhealthy"
+                    ? (state.lastFailureReason ?? null)
+                    : null),
+            consecutiveFailures: state.consecutiveFailures,
+            nextCheckAt: this.snapshot?.nextCheckAt ?? null,
+            preflightReasons: this.preflightReasons,
+            restartCapability: state.restartCapability,
+            restartCapabilityReasons: state.restartCapabilityReasons,
+            lastRestartTriggerAt: state.lastRestartTriggerAt ?? null,
+            lastRestartTriggerMode: state.lastRestartTriggerMode ?? null,
+        };
+    }
+    async persistState(state) {
+        try {
+            await this.store.save(state);
+        }
+        catch (error) {
+            this.options.logger.warn(`[senpi-auto-update] failed to persist state: ${formatErr(error)}`);
+        }
+    }
+}
+/** Default update command: `openclaw plugins update <packageName>`. */
+async function defaultRunUpdateCommand(packageName) {
+    const result = await runCommand("openclaw", ["plugins", "update", packageName], {
+        timeoutMs: 120_000,
+    });
+    if (result.code !== 0) {
+        throw new Error(result.stderr || `openclaw plugins update failed with code ${result.code}`);
+    }
+}
+function formatErr(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/runtime/auto-update/coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.js","sourceRoot":"","sources":["../../../src/runtime/auto-update/coordinator.ts"],"names":[],"mappings":"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"}

package/dist/runtime/auto-update/gateway-restart.d.ts

@@ -0,0 +1,49 @@
+/** OpenClaw gateway reload modes that determine how config changes are applied. */
+export type GatewayReloadMode = "off" | "restart" | "hot" | "hybrid";
+/**
+ * Result of evaluating whether the auto-updater can trigger an automatic
+ * gateway restart after a plugin update. When `capable` is `false`,
+ * `reasons` explains why (e.g. wrong reload mode, missing config helpers).
+ */
+export interface GatewayRestartCapability {
+    capable: boolean;
+    reasons: string[];
+    mode?: GatewayReloadMode;
+    config?: Record<string, unknown>;
+}
+/** Inputs required to evaluate gateway restart capability. */
+export interface RestartCapabilityInputs {
+    /** Snapshot of the OpenClaw config captured at plugin construction time (may be stale). */
+    configFromApi?: unknown;
+    /** Loads the live OpenClaw config from disk -- preferred over `configFromApi` when available. */
+    loadConfig?: () => Promise<unknown>;
+    /** Writes a modified OpenClaw config back to disk to trigger a config-change reload. */
+    writeConfigFile?: (config: unknown) => Promise<void>;
+    pluginId: string;
+}
+/**
+ * Determine whether the gateway can be restarted automatically.
+ *
+ * Restart is only possible when:
+ * - The OpenClaw config is accessible (via `loadConfig` or `configFromApi`).
+ * - `gateway.reload.mode` is `"restart"` or `"hybrid"`.
+ * - Both `loadConfig` and `writeConfigFile` helpers are available.
+ * - The plugin entry exists under `plugins.entries.<pluginId>`.
+ *
+ * Prefers `loadConfig()` (fresh) over `configFromApi` (stale snapshot).
+ */
+export declare function evaluateGatewayRestartCapability(inputs: RestartCapabilityInputs): Promise<GatewayRestartCapability>;
+/**
+ * Write a `lastRestartTrigger` timestamp into the plugin's `autoUpdate`
+ * config block, causing OpenClaw's config-file watcher to detect a change
+ * and restart the gateway (when reload mode is `restart` or `hybrid`).
+ *
+ * @throws When the plugin config path cannot be resolved in the config tree.
+ */
+export declare function triggerGatewayRestartViaConfigBump(options: {
+    loadedConfig: unknown;
+    writeConfigFile: (config: unknown) => Promise<void>;
+    pluginId: string;
+    triggerValue: string;
+}): Promise<void>;
+//# sourceMappingURL=gateway-restart.d.ts.map

package/dist/runtime/auto-update/gateway-restart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-restart.d.ts","sourceRoot":"","sources":["../../../src/runtime/auto-update/gateway-restart.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,2FAA2F;IAC3F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,wFAAwF;IACxF,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0BD;;;;;;;;;;GAUG;AACH,wBAAsB,gCAAgC,CACpD,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAyCnC;AAMD;;;;;;GAMG;AACH,wBAAsB,kCAAkC,CAAC,OAAO,EAAE;IAChE,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB"}

package/dist/runtime/auto-update/gateway-restart.js

@@ -0,0 +1,105 @@
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function readGatewayReloadMode(config) {
+    const root = asRecord(config);
+    const gateway = asRecord(root?.gateway);
+    const reload = asRecord(gateway?.reload);
+    const mode = reload?.mode;
+    return mode === "off" || mode === "restart" || mode === "hot" || mode === "hybrid"
+        ? mode
+        : undefined;
+}
+function hasWritablePluginPath(config, pluginId) {
+    const root = asRecord(config);
+    const plugins = asRecord(root?.plugins);
+    const entries = asRecord(plugins?.entries);
+    if (!entries)
+        return false;
+    return asRecord(entries[pluginId]) !== undefined;
+}
+/**
+ * Determine whether the gateway can be restarted automatically.
+ *
+ * Restart is only possible when:
+ * - The OpenClaw config is accessible (via `loadConfig` or `configFromApi`).
+ * - `gateway.reload.mode` is `"restart"` or `"hybrid"`.
+ * - Both `loadConfig` and `writeConfigFile` helpers are available.
+ * - The plugin entry exists under `plugins.entries.<pluginId>`.
+ *
+ * Prefers `loadConfig()` (fresh) over `configFromApi` (stale snapshot).
+ */
+export async function evaluateGatewayRestartCapability(inputs) {
+    const reasons = [];
+    const writeConfigFile = inputs.writeConfigFile;
+    const loadConfig = inputs.loadConfig;
+    let config;
+    if (loadConfig) {
+        try {
+            config = asRecord(await loadConfig());
+        }
+        catch {
+            // fall through to configFromApi snapshot
+        }
+    }
+    if (!config) {
+        config = asRecord(inputs.configFromApi);
+    }
+    if (!config) {
+        reasons.push("openclaw-config-unavailable");
+    }
+    const mode = readGatewayReloadMode(config);
+    if (!mode)
+        reasons.push("gateway.reload.mode-unavailable");
+    if (mode === "off")
+        reasons.push("gateway.reload.mode=off");
+    if (mode === "hot")
+        reasons.push("gateway.reload.mode=hot");
+    if (mode !== "restart" && mode !== "hybrid") {
+        reasons.push("restart-reload-mode-required");
+    }
+    if (!loadConfig)
+        reasons.push("runtime.config.loadConfig-unavailable");
+    if (!writeConfigFile)
+        reasons.push("runtime.config.writeConfigFile-unavailable");
+    if (config && !hasWritablePluginPath(config, inputs.pluginId)) {
+        reasons.push(`plugins.entries.${inputs.pluginId}-missing`);
+    }
+    const capable = reasons.length === 0;
+    return {
+        capable,
+        reasons,
+        mode,
+        config,
+    };
+}
+function cloneConfig(input) {
+    return JSON.parse(JSON.stringify(input));
+}
+/**
+ * Write a `lastRestartTrigger` timestamp into the plugin's `autoUpdate`
+ * config block, causing OpenClaw's config-file watcher to detect a change
+ * and restart the gateway (when reload mode is `restart` or `hybrid`).
+ *
+ * @throws When the plugin config path cannot be resolved in the config tree.
+ */
+export async function triggerGatewayRestartViaConfigBump(options) {
+    const root = asRecord(options.loadedConfig);
+    if (!root)
+        throw new Error("openclaw config is not an object");
+    const next = cloneConfig(root);
+    const plugins = asRecord(next.plugins);
+    const entries = asRecord(plugins?.entries);
+    const entry = entries ? asRecord(entries[options.pluginId]) : undefined;
+    const pluginConfig = entry ? asRecord(entry.config) : undefined;
+    if (!plugins || !entries || !entry || !pluginConfig) {
+        throw new Error(`plugins.entries.${options.pluginId}.config is not available`);
+    }
+    const autoUpdate = asRecord(pluginConfig.autoUpdate) ?? {};
+    autoUpdate.lastRestartTrigger = options.triggerValue;
+    pluginConfig.autoUpdate = autoUpdate;
+    await options.writeConfigFile(next);
+}
+//# sourceMappingURL=gateway-restart.js.map

package/dist/runtime/auto-update/gateway-restart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-restart.js","sourceRoot":"","sources":["../../../src/runtime/auto-update/gateway-restart.ts"],"names":[],"mappings":"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"}

package/dist/runtime/auto-update/policy.d.ts

@@ -0,0 +1,24 @@
+import type { AutoUpdateKind } from "./types.js";
+/** Parsed major.minor.patch triple from a semver string. */
+export interface SemverTriple {
+    major: number;
+    minor: number;
+    patch: number;
+}
+/**
+ * Extract the major, minor, and patch numbers from a semver string.
+ *
+ * Accepts optional `v` prefix and pre-release / build-metadata suffixes
+ * (e.g. `"v1.2.3-beta.1+build.42"`). Returns `null` when the input
+ * does not match the `MAJOR.MINOR.PATCH` pattern.
+ */
+export declare function parseSemver(input: string): SemverTriple | null;
+/**
+ * Compare two semver strings and return the kind of update (or `"none"`).
+ *
+ * Returns `"major"`, `"minor"`, or `"patch"` when `latest` is ahead of
+ * `current` in the respective component. Returns `"none"` when the
+ * versions are equal, `latest` is older, or either string is unparseable.
+ */
+export declare function classifyUpdate(current: string, latest: string): AutoUpdateKind;
+//# sourceMappingURL=policy.d.ts.map

package/dist/runtime/auto-update/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/runtime/auto-update/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQ9D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAW9E"}

package/dist/runtime/auto-update/policy.js

@@ -0,0 +1,42 @@
+/**
+ * Extract the major, minor, and patch numbers from a semver string.
+ *
+ * Accepts optional `v` prefix and pre-release / build-metadata suffixes
+ * (e.g. `"v1.2.3-beta.1+build.42"`). Returns `null` when the input
+ * does not match the `MAJOR.MINOR.PATCH` pattern.
+ */
+export function parseSemver(input) {
+    const match = /^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(input.trim());
+    if (!match)
+        return null;
+    return {
+        major: Number.parseInt(match[1], 10),
+        minor: Number.parseInt(match[2], 10),
+        patch: Number.parseInt(match[3], 10),
+    };
+}
+/**
+ * Compare two semver strings and return the kind of update (or `"none"`).
+ *
+ * Returns `"major"`, `"minor"`, or `"patch"` when `latest` is ahead of
+ * `current` in the respective component. Returns `"none"` when the
+ * versions are equal, `latest` is older, or either string is unparseable.
+ */
+export function classifyUpdate(current, latest) {
+    const from = parseSemver(current);
+    const to = parseSemver(latest);
+    if (!from || !to)
+        return "none";
+    if (to.major > from.major)
+        return "major";
+    if (to.major < from.major)
+        return "none";
+    if (to.minor > from.minor)
+        return "minor";
+    if (to.minor < from.minor)
+        return "none";
+    if (to.patch > from.patch)
+        return "patch";
+    return "none";
+}
+//# sourceMappingURL=policy.js.map

package/dist/runtime/auto-update/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/runtime/auto-update/policy.ts"],"names":[],"mappings":"AASA;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,KAAK,GAAG,oCAAoC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACpC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACpC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAc;IAC5D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAEhC,IAAI,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/runtime/auto-update/preflight.d.ts

@@ -0,0 +1,16 @@
+import type { AutoUpdateMode, AutoUpdatePreflightResult } from "./types.js";
+/** Inputs for the preflight environment capability check. */
+export interface AutoUpdatePreflightInput {
+    /** Mode the user (or defaults) configured. */
+    configuredMode: AutoUpdateMode;
+    /** Whether the `openclaw plugins update` CLI command is available. */
+    canUpdatePlugin: boolean;
+}
+/**
+ * Check whether the runtime environment can support the configured
+ * {@link AutoUpdateMode}. If `auto-apply` is requested but the plugin
+ * update command is unavailable, the effective mode is downgraded to
+ * `notify-only` and the reason is recorded.
+ */
+export declare function evaluatePreflight(input: AutoUpdatePreflightInput): AutoUpdatePreflightResult;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/runtime/auto-update/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../src/runtime/auto-update/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5E,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,cAAc,EAAE,cAAc,CAAC;IAC/B,sEAAsE;IACtE,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,wBAAwB,GAAG,yBAAyB,CAc5F"}

package/dist/runtime/auto-update/preflight.js

@@ -0,0 +1,20 @@
+/**
+ * Check whether the runtime environment can support the configured
+ * {@link AutoUpdateMode}. If `auto-apply` is requested but the plugin
+ * update command is unavailable, the effective mode is downgraded to
+ * `notify-only` and the reason is recorded.
+ */
+export function evaluatePreflight(input) {
+    const reasons = [];
+    let effectiveMode = input.configuredMode;
+    if (input.configuredMode === "auto-apply" && !input.canUpdatePlugin) {
+        effectiveMode = "notify-only";
+        reasons.push("plugin-update-command-not-available");
+    }
+    return {
+        ok: true,
+        effectiveMode,
+        reasons,
+    };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/runtime/auto-update/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../src/runtime/auto-update/preflight.ts"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAA+B;IAC/D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,aAAa,GAAmB,KAAK,CAAC,cAAc,CAAC;IAEzD,IAAI,KAAK,CAAC,cAAc,KAAK,YAAY,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QACpE,aAAa,GAAG,aAAa,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;QACR,aAAa;QACb,OAAO;KACR,CAAC;AACJ,CAAC"}