@senpi/runtime 3.0.180 → 3.0.182

package/dist/host/openclaw-host.js

@@ -0,0 +1,177 @@
+/**
+ * Facts about the OpenClaw host the runtime plugin is loaded into.
+ *
+ * The runtime ships one build to a mixed fleet: OpenClaw 2026.5.7 (protocol 3),
+ * 2026.5.12 (protocol 4, still the legacy plugin runtime) and 2026.10.x (the
+ * "modern" line). Several surfaces differ between the lines (the config write
+ * helpers, the `subagent_spawning` hook, tool search and its dispatcher), so
+ * every version-specific change in the runtime branches on the answers here.
+ *
+ * Everything in this module is pure or reads only what the host hands the
+ * plugin at registration. It does no I/O.
+ */
+/**
+ * First OpenClaw release treated as "modern" (strict config schema,
+ * `runtime.config.mutateConfigFile` only, tool search, no
+ * `subagent_spawning`). It is the same threshold the senpi-agent wrapper uses
+ * (`src/lib/openclawVersion.js`, `MODERN_SINCE = [2026, 8, 1]`), so the
+ * wrapper and the runtime always agree on which line a box runs.
+ */
+export const MODERN_OPENCLAW_SINCE = "2026.8.1";
+const MODERN_SINCE_PARTS = [2026, 8, 1];
+/**
+ * Parses the leading `YYYY.M.D` of an OpenClaw version string.
+ *
+ * Accepts an optional `v` prefix and any suffix (`-beta.3`, build metadata),
+ * so `2026.10.4`, `2026.10.4-beta.1` and `v2026.10.4` all parse to
+ * `[2026, 10, 4]`.
+ *
+ * @param raw - The version string, as `api.runtime.version` reports it.
+ * @returns The three numeric parts, or `null` when the string does not start
+ *   with a date-shaped version.
+ */
+function parseOpenClawVersion(raw) {
+    const m = raw.trim().match(/^v?(\d{4})\.(\d{1,2})\.(\d{1,3})/);
+    if (!m)
+        return null;
+    return [Number(m[1]), Number(m[2]), Number(m[3])];
+}
+/**
+ * Whether a host version is on the modern line (`>= 2026.8.1`).
+ *
+ * A missing or unparsable version is treated as legacy on purpose: legacy
+ * behaviour is what the runtime did before it knew about 10.x, and a wrong
+ * "modern" guess on a 5.x box would switch off paths 5.x relies on (for
+ * example the `writeConfigFile` restart).
+ *
+ * @param version - Host version, typically from {@link hostOpenClawVersion}.
+ * @returns `true` only for a parsable version at or above
+ *   {@link MODERN_OPENCLAW_SINCE}.
+ */
+export function isModernOpenClawHost(version) {
+    if (typeof version !== "string")
+        return false;
+    const parts = parseOpenClawVersion(version);
+    if (!parts)
+        return false;
+    for (let i = 0; i < 3; i++) {
+        if (parts[i] !== MODERN_SINCE_PARTS[i])
+            return parts[i] > MODERN_SINCE_PARTS[i];
+    }
+    return true;
+}
+/**
+ * Returns the host's OpenClaw version as the plugin runtime reports it
+ * (`api.runtime.version`: 5.7 `src/plugins/runtime/types-core.ts:96`, 10.10
+ * `:344`).
+ *
+ * @param api - The plugin API, or any object with the same shape.
+ * @returns The version string, or `undefined` when the host does not expose
+ *   one (or exposes a non-string).
+ */
+export function hostOpenClawVersion(api) {
+    const version = api.runtime?.version;
+    return typeof version === "string" ? version : undefined;
+}
+/**
+ * Reads the host's **live** OpenClaw config.
+ *
+ * `api.config` is the snapshot taken when the plugin registered, so it goes
+ * stale after a hot reload or a `config.patch`. `api.runtime.config.current()`
+ * returns the config the gateway is running with right now (present on 5.7,
+ * 5.12 and 10.x). This prefers `current()` and falls back to the snapshot only
+ * when `current` is missing or throws (a test double, or a host mid-reload).
+ *
+ * @param api - The plugin API.
+ * @returns The live config object, or the registration snapshot, or
+ *   `undefined` when neither exists. The value is the host's own object and
+ *   must be treated as read-only.
+ */
+export function readLiveHostConfig(api) {
+    const current = api.runtime?.config?.current;
+    if (typeof current === "function") {
+        try {
+            return current.call(api.runtime?.config);
+        }
+        catch {
+            // fall through to the registration snapshot
+        }
+    }
+    return api.config;
+}
+/**
+ * Small local record guard, matching OpenClaw's `isRecord` (a non-null,
+ * non-array object).
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Resolves the tool-search mode from a whole OpenClaw config, mirroring the
+ * host's own resolver (10.10 `src/agents/tool-search-config.ts:12-42`; same
+ * semantics as 10.4, where the boolean shortcut was written out).
+ *
+ * - `tools.toolSearch` `undefined` or `true` → `"tools"`; `false` → `"off"`.
+ * - An object: `enabled` is the boolean when given, else true only when some
+ *   key other than `enabled` is set (so `{}` is `"off"`); `mode` is
+ *   `"directory"` only when it equals `"directory"`, else `"tools"`.
+ * - Any other value (string, array, number) → `"off"`.
+ *
+ * On a 5.x host the key does not exist and the result is meaningless; callers
+ * gate on {@link isModernOpenClawHost} first.
+ *
+ * @param config - The whole OpenClaw config (for example from
+ *   {@link readLiveHostConfig}).
+ * @returns The mode the host would resolve for this config.
+ */
+export function resolveToolSearchMode(config) {
+    const tools = isRecord(config) && isRecord(config.tools) ? config.tools : undefined;
+    const toolSearch = tools?.toolSearch;
+    let raw;
+    if (toolSearch === undefined || typeof toolSearch === "boolean") {
+        raw = { enabled: toolSearch ?? true };
+    }
+    else {
+        raw = isRecord(toolSearch) ? toolSearch : {};
+    }
+    const configured = Object.keys(raw).some((key) => key !== "enabled");
+    const enabled = typeof raw.enabled === "boolean" ? raw.enabled : configured;
+    if (!enabled)
+        return "off";
+    return raw.mode === "directory" ? "directory" : "tools";
+}
+let hostFacts;
+/**
+ * Records the host facts for this process. Called once at the top of plugin
+ * registration, before any version-gated hook is registered.
+ *
+ * A second call (the gateway re-registers the plugin on a reload) replaces the
+ * record, so the facts always describe the api of the latest registration.
+ *
+ * @param api - The plugin API handed to `register(api)`.
+ * @returns The stored record.
+ */
+export function initOpenClawHost(api) {
+    const version = hostOpenClawVersion(api);
+    hostFacts = {
+        version,
+        modern: isModernOpenClawHost(version),
+        currentConfig: () => readLiveHostConfig(api),
+    };
+    return hostFacts;
+}
+/**
+ * Returns the host record stored by {@link initOpenClawHost}.
+ *
+ * @returns The record, or `undefined` before registration (unit tests, the
+ *   standalone `run()` entry, scripts). Callers treat `undefined` as "not on
+ *   an OpenClaw host" and keep their legacy behaviour.
+ */
+export function getOpenClawHost() {
+    return hostFacts;
+}
+/** Clears the process-wide host record. Tests only. */
+export function resetOpenClawHostForTests() {
+    hostFacts = undefined;
+}
+//# sourceMappingURL=openclaw-host.js.map

package/dist/host/openclaw-host.js.map

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

package/dist/index.d.ts

@@ -65,6 +65,14 @@ export interface SenpiRuntimePluginConfig {
      * tool is not registered at all.
      */
     widgets?: Record<string, boolean>;
+    /**
+     * OpenClaw 10.x tool-surface aids (src/tool-surface/). `crib: false` turns
+     * off the `senpi__` crib sheet prepended in tool-search directory mode;
+     * absent or `true` keeps it on. Ignored on 5.x hosts.
+     */
+    toolSurface?: {
+        crib?: boolean;
+    };
     skillsManager?: {
         enabled?: boolean;
         /**
@@ -122,13 +130,47 @@ interface PluginApi {
     pluginConfig?: Record<string, unknown>;
     logger: PluginLogger;
     config?: Record<string, unknown>;
+    /**
+     * Which registration pass this is (5.7 `src/plugins/types.ts:2242`, 10.10
+     * `src/plugins/plugin-registration.types.ts:503`). `"cli-metadata"` is the
+     * pass that only collects CLI command roots; on 10.x `runtime` throws on any
+     * read in it. Absent on hosts that predate the field.
+     */
+    registrationMode?: string;
     runtime: {
+        /**
+         * Host OpenClaw version (`PluginRuntimeCore.version`). Read once at
+         * registration by `initOpenClawHost` (src/host/openclaw-host.ts) to decide
+         * between the legacy (5.x) and modern (>= 2026.8.1) code paths.
+         */
+        version?: string;
         state: {
             resolveStateDir(): string;
         };
         config?: {
-            loadConfig(): Promise<unknown>;
-            writeConfigFile(config: unknown): Promise<void>;
+            /** Live config snapshot; present on 5.7, 5.12 and 10.x. */
+            current?(): unknown;
+            /**
+             * Focused config write with an explicit follow-up (10.10
+             * `src/plugins/runtime/types-core.ts:348-370`; `afterWrite` shape from
+             * `src/config/runtime-snapshot.ts:54-57`). The only write helper on 10.x.
+             */
+            mutateConfigFile?(params: {
+                afterWrite: {
+                    mode: "auto";
+                } | {
+                    mode: "restart";
+                    reason: string;
+                } | {
+                    mode: "none";
+                    reason: string;
+                };
+                mutate: (draft: Record<string, unknown>) => void;
+            }): Promise<unknown>;
+            /** 5.x only; removed on 10.x (first gone in 2026.7.2-beta.4). */
+            loadConfig?(): Promise<unknown>;
+            /** 5.x only; removed on 10.x (Box A on 10.10: `hasWriteConfigFile:false`). */
+            writeConfigFile?(config: unknown): Promise<void>;
         };
     };
     registerService(service: {
@@ -172,6 +214,8 @@ interface PluginApi {
         timeoutMs?: number;
     }): void;
 }
+/** Clears {@link legacyTurnClassificationNoticeLogged}. Tests only. */
+export declare function resetLegacyTurnClassificationNoticeForTests(): void;
 /**
  * OpenClaw plugin entry.
  * Boots from internal registry (installed_runtimes.json) in stateDir; does not read runtime list from config.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -14,11 +14,12 @@
 import { readFileSync } from "node:fs";
 import { parse as parseYaml } from "yaml";
 import { join, dirname } from "node:path";
-import { SenpiClient } from "./senpi/client.js";
+import { isMoneyCallTool, SenpiClient, senpiOrderCallsInFlight } from "./senpi/client.js";
+import { MoneyCallTracker, registerMoneyCallHooks } from "./runtime/auto-update/money-call-tracker.js";
 import { buildWalletStatusHint } from "./senpi/strategy-status.js";
 import { bootSkippedStatusLabel, partitionByWalletStatus, readBootWalletStatuses, trackableWalletKeys, } from "./runtime/boot-skip.js";
 import { DeployJobController } from "./deploy/job.js";
-import { registerDeployGatewayMethods } from "./deploy/register.js";
+import { DEPLOY_CAPABILITIES, registerDeployGatewayMethods } from "./deploy/register.js";
 import { createQuantDesk } from "./quant/register.js";
 import { registerUpdateGatewayMethod } from "./runtime/update-register.js";
 import { createStrategiesPublisher } from "./runtime/strategies-telemetry.js";
@@ -48,15 +49,21 @@ import { readEvents } from "./telemetry/event-store.js";
 import { VERSION } from "./version.js";
 import { resolvePackageName } from "./runtime/auto-update/resolve-package-name.js";
 import { runOpenClawPluginsUpdate } from "./runtime/auto-update/run-update-command.js";
+import { UpdateIdleGate } from "./runtime/auto-update/idle-gate.js";
+import { registerIdleGateHooks, resolveUpdateMid } from "./runtime/auto-update/register-idle-gate.js";
+import { resolveUpdateMarkerPath } from "./runtime/auto-update/update-marker.js";
+import { INSTALL_RESULTS_OTEL_FLUSH_MS, INSTALL_RESULTS_OTEL_READY_MS, resolveInstallResultsPath, } from "./runtime/auto-update/install-results.js";
 import { registerSpanHooks } from "./telemetry/spans/index.js";
 import { registerSessionContextSeedHook } from "./prompt/session-context-seed-hook.js";
 import { registerSkillRouterHook } from "./prompt/skill-router-hook.js";
+import { registerCribSheet } from "./tool-surface/crib-hook.js";
 import { getDefaultPiiRedactor, initDefaultPiiRedactor } from "./telemetry/spans/redact-pii.js";
-import { initOtelSdk, shutdownOtelSdk } from "./telemetry/otel-sdk.js";
+import { flushOtelLogs, initOtelSdk, shutdownOtelSdk, waitForOtelInit } from "./telemetry/otel-sdk.js";
 import { getLogLevel, getLogLevelSource, parseLogLevel, setLogLevel, } from "./utils/logger.js";
 import { ExternalScannerIngestError, } from "./scanners/external-scanner-receiver.js";
 import { createLogger } from "./utils/logger.js";
-import { registerToolApprovalGate, resolveToolApprovalsMode, } from "./approvals/tool-approval-gate.js";
+import { PendingApprovalTracker, registerToolApprovalGate, resolveToolApprovalsMode, } from "./approvals/tool-approval-gate.js";
+import { registerTurnContextHooks, turnClassificationAvailable, TurnContextTracker, } from "./approvals/turn-context.js";
 import { registerShowWidgetTool } from "./widgets/index.js";
 import { registerQuantWidgetTurnCap } from "./widgets/turn-cap.js";
 import { EVENT_NAME, SENPI_ERROR_CODE, eventAttrs, scannerUnwiredErrorCode } from "./utils/event-catalog.js";
@@ -74,6 +81,8 @@ import { ingestDispatchMutex, ingestDispatchKey } from "./runtime-api/intake/ing
 import { buildScaffoldErrorRouter } from "./runtime-api/intake/scaffold-error-router.js";
 import { loadRuntimeConfig } from "./runtime/load-runtime-config.js";
 import { errorText } from "./deploy/error-text.js";
+import { initOpenClawHost } from "./host/openclaw-host.js";
+import { hostname } from "node:os";
 import { BOOT_FACTS_CALL_TIMEOUT_MS, planBootFacts, syncBootFacts, } from "./strategy/facts-sync.js";
 /** Initialize all core features (DSL, risk, health) on the given event bus. */
 export function initCore(bus) {
@@ -192,6 +201,39 @@ const RUNTIME_ID_TAKEN = "[E_RUNTIME_ID_TAKEN]";
  * not take it; an apply queues its send here and does not wait.
  */
 const factsSendLock = new KeyedMutex();
+/**
+ * Whether this process has already logged the 5.x "cannot classify runs" notice.
+ *
+ * Module-scoped so a gateway reload (which re-registers the plugin and restarts its service in the
+ * same process) does not repeat it. The 5.x case is a host-version limit with no config fix, so
+ * one info line per process is the whole message; the fixable 10.x case stays an ERROR at every
+ * registration and does not read this latch.
+ */
+let legacyTurnClassificationNoticeLogged = false;
+/** Clears {@link legacyTurnClassificationNoticeLogged}. Tests only. */
+export function resetLegacyTurnClassificationNoticeForTests() {
+    legacyTurnClassificationNoticeLogged = false;
+}
+/**
+ * The whole of `register()` in the `"cli-metadata"` pass: the `senpi` CLI root, under the same
+ * preconditions and with the same metadata as the full pass, and nothing else.
+ *
+ * Reads no `api.runtime`: on 10.x that pass's runtime throws on any read, and the host prints the
+ * throw as `runtime failed during register` on every `openclaw senpi …` call (RT566-04). Logs
+ * nothing: a skipped precondition is reported by the full pass, which follows in the same process.
+ */
+function registerSenpiCliMetadata(api) {
+    const config = api.pluginConfig;
+    if (!config)
+        return;
+    const mcpTransport = api.mcpTransport;
+    const apiKey = resolveSenpiApiKeyFromStore(readSenpiCliStore(), typeof config.apiKey === "string" && config.apiKey.length > 0 ? config.apiKey : undefined);
+    if (!mcpTransport && !apiKey)
+        return;
+    api.registerCli((ctx) => {
+        registerSenpiCli(ctx.program);
+    }, { commands: ["senpi"] });
+}
 /**
  * OpenClaw plugin entry.
  * Boots from internal registry (installed_runtimes.json) in stateDir; does not read runtime list from config.
@@ -231,7 +273,16 @@ const senpiRuntimePlugin = {
             warn: (...args) => api.logger.warn(...args),
             error: (message, meta) => api.logger.error(message, meta),
         };
+        // The cli-metadata pass only collects CLI command roots. 10.x hands it a runtime that throws on
+        // any read (RT566-04), so register the `senpi` root and nothing else — and read no api.runtime.
+        if (api.registrationMode === "cli-metadata") {
+            registerSenpiCliMetadata(api);
+            return;
+        }
         pluginLogger.info("[senpi-runtime] register(api) invoked");
+        // Host facts first: every version-gated registration below reads them.
+        const openClawHost = initOpenClawHost(api);
+        pluginLogger.info(`[senpi-runtime] host OpenClaw ${openClawHost.version ?? "unknown"} (${openClawHost.modern ? "modern" : "legacy"})`);
         const config = api.pluginConfig;
         if (!config) {
             pluginLogger.warn("[senpi-runtime] No plugin config found — skipping registration");
@@ -294,8 +345,8 @@ const senpiRuntimePlugin = {
         // Agent telemetry — gateway hooks emit gen_ai spans (llm/tool/subagent) through
         // the shared tracer; on-site MCP calls emit their own spans from SenpiClient.
         try {
-            registerSpanHooks({ api });
-            pluginLogger.info("[senpi-runtime] gen_ai span hooks registered (9 hooks)");
+            const spanHookCount = registerSpanHooks({ api, modernHost: openClawHost.modern });
+            pluginLogger.info(`[senpi-runtime] gen_ai span hooks registered (${spanHookCount} hooks)`);
         }
         catch (err) {
             pluginLogger.warn("[senpi-runtime] failed to register span hooks", {
@@ -334,14 +385,93 @@ const senpiRuntimePlugin = {
                 err: err instanceof Error ? err.message : String(err),
             });
         }
+        // senpi__ crib sheet (OpenClaw 10.x tool-search directory mode only): the
+        // directory folds every MCP tool into one sentence, so the runtime puts
+        // the names back as prependSystemContext. Registers nothing on 5.x.
+        // Its `before_prompt_build` hook needs the same host grant as the approval
+        // turn classification below; without it 10.x drops the hook, so the line
+        // says the crib is inactive and why instead of "registered".
+        try {
+            if (registerCribSheet({
+                api: api,
+                baseStateDir,
+                pluginConfig: config,
+                logger: pluginLogger,
+            })) {
+                // Registered, so the host is modern; only the hook grant is left to check.
+                const cribHook = turnClassificationAvailable({ modernHost: true, config: api.config, pluginId: api.id });
+                pluginLogger.info(cribHook.available
+                    ? "[senpi-runtime] senpi__ crib sheet registered (directory mode only)"
+                    : `[senpi-runtime] senpi__ crib inactive: ${cribHook.reason}` +
+                        (cribHook.configFix ? `; fix: ${cribHook.configFix}` : ""));
+            }
+        }
+        catch (err) {
+            pluginLogger.warn("[senpi-runtime] failed to register the senpi__ crib sheet", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+        }
         // MCP tool approval gate — state-changing senpi MCP tools require an
         // interactive user approval before executing. Prompts reach senpi-web via
         // the bridge's operator.approvals-scoped gateway connection; allow-always
         // decisions persist in <stateDir>/tool-approvals.json.
         // See docs/mcp-tool-approvals-design.md.
+        // Open trade-approval prompts, read by the self-update idle gate (R2).
+        const pendingApprovalTracker = new PendingApprovalTracker();
+        // The turn kind (chat / cron / heartbeat) and session key of each gated
+        // call, for approval telemetry and the 10.x scheduled-turn block (R6, D13).
+        const turnContextTracker = new TurnContextTracker();
+        // One boot-time fact (D15): can this host classify runs at all? Only then
+        // does the gate stop prompts outside a direct chat turn. Without it every
+        // run reads unknown and keeps the pre-10.x prompt, so a box missing the
+        // setting never blocks chat trades; it is reported loudly instead.
+        let turnClassification = turnClassificationAvailable({
+            modernHost: openClawHost.modern,
+            config: api.config,
+            pluginId: api.id,
+        });
+        try {
+            registerTurnContextHooks({ api, tracker: turnContextTracker });
+        }
+        catch (err) {
+            turnClassification = { available: false, reason: "the turn-context hooks failed to register" };
+            pluginLogger.warn("[senpi-runtime] failed to register the approval turn-context hooks", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+        }
+        // Only the logging and the status flag differ by host; the gate below reads the same boolean
+        // either way. On 10.x it is an ERROR at every registration (a box config to fix, or hooks that
+        // failed to register). On 5.x it is a host limit no config can fix, so it is one info line per
+        // process, logged from the service start below: that runs in the gateway only, so the
+        // `openclaw senpi …` CLI children (deploy.py, close.py, an agent exec) register without
+        // printing it.
+        const turnClassificationHostLimit = !turnClassification.available && !openClawHost.modern;
+        const turnClassificationNotice = turnClassification.available
+            ? undefined
+            : `[senpi-tool-approvals] cannot tell chat turns from scheduled or background runs: ${turnClassification.reason}. ` +
+                "Trade approvals are requested in every run, scheduled ones included, " +
+                (turnClassification.configFix
+                    ? `until the box config is fixed (${turnClassification.configFix}).`
+                    : turnClassificationHostLimit
+                        ? "on this OpenClaw version; a 10.x host lifts this."
+                        : "until the runtime registers its turn-context hooks.");
+        const legacyTurnClassificationNotice = turnClassificationHostLimit ? turnClassificationNotice : undefined;
+        if (turnClassificationNotice !== undefined && !turnClassificationHostLimit) {
+            pluginLogger.error(turnClassificationNotice);
+        }
+        const approvalsHostStatus = turnClassification.available
+            ? { turnClassification: "available" }
+            : {
+                turnClassification: "unavailable",
+                reason: turnClassification.reason,
+                ...(turnClassificationHostLimit ? { hostLimit: true } : {}),
+            };
         try {
             registerToolApprovalGate({
                 api,
+                pendingApprovals: pendingApprovalTracker,
+                turnContext: turnContextTracker,
+                turnClassification: turnClassification.available,
                 mode: resolveToolApprovalsMode({
                     pluginConfig: config,
                     env: process.env,
@@ -533,24 +663,92 @@ const senpiRuntimePlugin = {
         });
         const autoUpdateLogger = withEventLogger(pluginLogger, "[senpi-core][auto-update]");
         const autoUpdateConfig = resolveAutoUpdateConfig(config?.autoUpdate);
+        // OpenClaw 10.x (>= 2026.8.1): restart-to-apply (R2). The runtime cannot
+        // install itself there, so it waits for its spread slot and an idle box,
+        // writes the install marker, and restarts through mutateConfigFile; the
+        // senpi-agent wrapper installs before the next gateway spawn. On 5.7 and
+        // 5.12 the wiring is the in-process install + config-bump restart.
+        const modernHost = openClawHost.modern;
+        let idleGate;
+        if (modernHost) {
+            // Money calls on every route: the runtime's own in-process MCP calls, plus
+            // the agent's senpi__ calls (direct or through the dispatcher), seen at the
+            // tool hooks. A deploy job is read from the controller (this process) and
+            // its journals (any process).
+            const moneyCalls = new MoneyCallTracker();
+            try {
+                registerMoneyCallHooks({
+                    api: api,
+                    tracker: moneyCalls,
+                    isMoneyTool: isMoneyCallTool,
+                });
+            }
+            catch (err) {
+                pluginLogger.warn("[senpi-runtime] failed to register the self-update money-call hooks", {
+                    err: err instanceof Error ? err.message : String(err),
+                });
+            }
+            idleGate = new UpdateIdleGate({
+                pendingApprovals: () => pendingApprovalTracker.count(),
+                ordersInFlight: () => senpiOrderCallsInFlight() + moneyCalls.count(Date.now()),
+                // Read only from ticks, after register() has constructed the controller below.
+                deploysInFlight: () => deployController.inFlight(Date.now()),
+                logger: pluginLogger,
+            });
+            try {
+                registerIdleGateHooks({ api: api, gate: idleGate, logger: pluginLogger });
+            }
+            catch (err) {
+                pluginLogger.warn("[senpi-runtime] failed to register the self-update idle gate hooks", {
+                    err: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        const openclawStateDir = typeof api.runtime?.state?.resolveStateDir === "function" ? api.runtime.state.resolveStateDir() : undefined;
         const autoUpdateCoordinator = new AutoUpdateCoordinator({
             enabled: true,
             config: autoUpdateConfig,
             packageName: PLUGIN_PACKAGE_NAME,
             currentVersion: VERSION,
+            // The version this process loaded; "applied" is decided from it alone.
+            loadedVersion: VERSION,
             stateDir: join(baseStateDir, "auto-update"),
             logger: autoUpdateLogger,
             // Use the resolved npm package name (not a hardcoded plugin id) so
             // the update follows the same npm channel as the version check —
-            // see runtime/auto-update/run-update-command.ts.
-            runUpdateCommand: runOpenClawPluginsUpdate,
+            // see runtime/auto-update/run-update-command.ts. Not on 10.x, which
+            // refuses plugins update while the gateway runs.
+            runUpdateCommand: modernHost ? undefined : runOpenClawPluginsUpdate,
             configFromApi: api.config,
-            loadConfig: api.runtime?.config
+            loadConfig: !modernHost && api.runtime?.config
                 ? () => api.runtime.config.loadConfig()
                 : undefined,
-            writeConfigFile: api.runtime?.config
+            writeConfigFile: !modernHost && api.runtime?.config
                 ? (c) => api.runtime.config.writeConfigFile(c)
                 : undefined,
+            modernHost,
+            mutateConfigFile: modernHost && typeof api.runtime?.config?.mutateConfigFile === "function"
+                ? (p) => api.runtime.config.mutateConfigFile(p)
+                : undefined,
+            readLiveConfig: modernHost ? openClawHost.currentConfig : undefined,
+            idleGate,
+            mid: modernHost
+                ? resolveUpdateMid({
+                    token: apiKey ?? process.env.SENPI_AUTH_TOKEN ?? process.env.SENPI_API_KEY,
+                    env: process.env,
+                    hostname,
+                })
+                : undefined,
+            updateMarkerPath: modernHost && openclawStateDir ? resolveUpdateMarkerPath(openclawStateDir) : undefined,
+            // The wrapper's install outcomes, reported once per coordinator start (gateway only),
+            // with auto-update on or off. The report runs off the start path: it waits for the OTel
+            // init register() started (else the events go to the no-op logger and the file is gone)
+            // and flushes the logs before deleting the file.
+            installResultsPath: modernHost && openclawStateDir ? resolveInstallResultsPath(openclawStateDir) : undefined,
+            installResultsTelemetry: {
+                ready: () => waitForOtelInit(INSTALL_RESULTS_OTEL_READY_MS),
+                flush: () => flushOtelLogs(INSTALL_RESULTS_OTEL_FLUSH_MS),
+            },
             pluginId: api.id,
             // Drive skills-manager off the auto-update tick. Both success and
             // failure branches of auto-update's tick fire this hook so skills
@@ -630,6 +828,11 @@ const senpiRuntimePlugin = {
         api.registerService({
             id: "senpi-runtime",
             async start() {
+                // The 5.x classification notice (see the approval gate above), once per process.
+                if (legacyTurnClassificationNotice !== undefined && !legacyTurnClassificationNoticeLogged) {
+                    legacyTurnClassificationNoticeLogged = true;
+                    pluginLogger.info(legacyTurnClassificationNotice);
+                }
                 // Deploy-journal janitor: stamp anything a restart left unterminated as `interrupted`.
                 // It never re-enters a deploy state machine — discovery is pull-based via
                 // `senpi deploy status`.
@@ -1995,7 +2198,10 @@ const senpiRuntimePlugin = {
             // same clean line over a runtime that cannot tick.
             runtimeIsLive: async (id) => runtimeHandles.has(id) && !unwiredRuntimes.has(id),
             installPendingOnWallet: async (wallet) => installsInFlight.has(wallet.trim().toLowerCase()),
-            logger: { info: (line) => api.logger.info(`[senpi-runtime] ${line}`) },
+            logger: {
+                info: (line) => api.logger.info(`[senpi-runtime] ${line}`),
+                warn: (line) => api.logger.warn(`[senpi-runtime] ${line}`),
+            },
         });
         /**
          * Gateway shim for `senpi.ingestExternalScannerData`.
@@ -2198,6 +2404,8 @@ const senpiRuntimePlugin = {
                     respond(true, {
                         status: status ? { ...status, runtimeId } : null,
                         updater,
+                        approvals: approvalsHostStatus,
+                        deploy: { capabilities: DEPLOY_CAPABILITIES },
                     });
                 }
                 catch (err) {
@@ -2210,7 +2418,7 @@ const senpiRuntimePlugin = {
                 return;
             }
             const statuses = await collectRuntimeHealthStatuses(runtimeHandles, api.logger);
-            respond(true, { statuses, updater });
+            respond(true, { statuses, updater, approvals: approvalsHostStatus, deploy: { capabilities: DEPLOY_CAPABILITIES } });
         }, { scope: "operator.read" });
         api.registerGatewayMethod("senpi.getSystemState", async (ctx) => {
             const respond = ctx.respond;