@openclaw-cloud/agent-controller 3.6.1 → 3.6.3

package/dist/commands/self-update.js

@@ -6,20 +6,7 @@ import { config } from '../config.js';
 import { withEaccesRetry, installAcSelf, AC_PACKAGE, } from '../utils/openclaw-ops.js';
 import { runOpenclawStackUpdate } from '../utils/openclaw-stack-update.js';
 import { logCollector } from '../connection.js';
-/**
- * Run the explicit-version self-update flow. Throws when `installOpenclaw`
- * or `installAcSelf` fail outright — per-plugin failures are recorded in
- * the result rather than thrown. The caller is responsible for translating
- * thrown errors into an AgentResponse / process exit.
- *
- * IMPORTANT: when `acChanged` is true, this function does NOT call
- * `removeLockFile()` and does NOT sleep — both are now the caller's job
- * (handler defers them to the next tick AFTER `api.publishResponse` so the
- * backend sees a real `success: true` response before the supervisor picks
- * up the missing lock and restarts the process). The CLI entrypoint
- * (`runSelfUpdateCli`) handles this directly since there's no response to
- * publish.
- */
+/** Callers own lock removal: the WS handler delays it to give the response a chance to publish. */
 export async function runExplicitSelfUpdate(currentVersion, payload) {
     let runtimeChanged = false;
     let pluginSummary;
@@ -31,7 +18,6 @@ export async function runExplicitSelfUpdate(currentVersion, payload) {
         targetOpenclaw: payload.openclaw?.version,
         pluginCount: payload.openclaw?.plugins?.length ?? 0,
     });
-    // 1) openclaw runtime + plugins (one gateway restart at the end)
     if (payload.openclaw) {
         const stack = await runOpenclawStackUpdate({
             version: payload.openclaw.version,
@@ -42,10 +28,6 @@ export async function runExplicitSelfUpdate(currentVersion, payload) {
         pluginSummary = stack.pluginSummary;
         gatewayRestarted = stack.gatewayRestarted;
     }
-    // 2) agent-controller swap LAST. Note: we run `npm install -g` here but
-    //    do NOT remove the lockfile or sleep — the WS handler defers that
-    //    work until AFTER the AgentResponse is published. The CLI path runs
-    //    this same function and handles the lockfile + sleep itself.
     if (payload.agentController?.version) {
         acChanged = await installAcSelf(payload.agentController.version, currentVersion);
         if (acChanged) {
@@ -54,11 +36,7 @@ export async function runExplicitSelfUpdate(currentVersion, payload) {
     }
     return { runtimeChanged, pluginSummary, gatewayRestarted, acChanged };
 }
-// ---------------------------------------------------------------------------
-// Legacy channel-based path — preserved for old backends that publish
-// `self_update` with an empty payload (and for the CLI fallback when the
-// runtime-targets endpoint is unreachable).
-// ---------------------------------------------------------------------------
+// Empty-payload self_update from older backends still uses the release channel.
 export async function selfUpdate(currentVersion) {
     const channel = getReleaseChannel();
     const tag = channel === 'stable' ? 'latest' : channel;
@@ -75,26 +53,14 @@ export async function selfUpdate(currentVersion) {
     removeLockFile();
     await new Promise((resolve) => setTimeout(resolve, 30_000));
 }
-// ---------------------------------------------------------------------------
-// CLI entrypoint — try the new on-demand /api/agent/runtime-targets path
-// first; fall back to the legacy channel-based path if the backend is
-// unreachable, returns an empty payload, or returns a non-2xx response.
-//
-// `fetchRuntimeTargets` is exported because it is the ONE implementation of
-// "ask the backend what this agent should be running"; utils/plugin-reconcile.ts
-// reuses it so a reconcile install picks the same plugin version a self-update
-// would.
-// ---------------------------------------------------------------------------
+// Reconciliation shares this target lookup so it selects the same versions as self-update.
 export async function fetchRuntimeTargets() {
     const backendUrl = config.backendUrl;
     const token = config.agentToken;
     if (!backendUrl || !token)
         return null;
     try {
-        // Through AgentApi rather than a hand-rolled fetch, so this request shows
-        // up in debugLog tracing like every other backend call. The swallow is
-        // deliberate: any failure (401, 500, network, empty body) means "no
-        // explicit targets", and the caller falls back to the channel-based path.
+        // Unavailable or invalid targets deliberately fall back to the legacy release-channel path.
         const api = createAgentApi(backendUrl, token);
         const data = (await api.get('/api/agent/runtime-targets'));
         if (!data || (!data.openclaw && !data.agentController))
@@ -105,23 +71,12 @@ export async function fetchRuntimeTargets() {
         return null;
     }
 }
-/**
- * Top-level CLI entrypoint invoked by `agent-controller self-update`.
- * Tries the new explicit-payload flow first; falls back to legacy when
- * the backend has no runtime-targets endpoint or no override configured.
- *
- * Unlike the WS handler path (handlers/self-update.ts), the CLI has no
- * AgentResponse to publish, so we keep the original
- * `removeLockFile() + sleep(30s)` tail when the agent-controller actually
- * changed — that's the supervisor handoff signal.
- */
+/** The CLI has no response to publish, so it can hand off to the supervisor directly. */
 export async function runSelfUpdateCli(currentVersion) {
     const targets = await fetchRuntimeTargets();
     if (targets) {
         const channel = getReleaseChannel();
         console.log(`Current version: ${currentVersion} (channel: ${channel})`);
-        // Summary line — describe what the backend wants us to install, skipping
-        // subparts the payload didn't include.
         const pluginCount = targets.openclaw?.plugins?.length ?? 0;
         const summaryParts = [];
         if (targets.openclaw) {
@@ -135,9 +90,6 @@ export async function runSelfUpdateCli(currentVersion) {
         if (summaryParts.length > 0) {
             console.log(`Backend targets: ${summaryParts.join(', ')}`);
         }
-        // Intent lines — printed BEFORE runExplicitSelfUpdate runs. The runtime
-        // step may end up being a no-op (skip); the post-call result lines below
-        // resolve that ambiguity.
         if (targets.openclaw) {
             console.log(`Installing openclaw runtime ${targets.openclaw.version}...`);
         }
@@ -148,7 +100,6 @@ export async function runSelfUpdateCli(currentVersion) {
             console.log(`Installing agent-controller ${targets.agentController.version}...`);
         }
         const result = await runExplicitSelfUpdate(currentVersion, targets);
-        // Result lines — what actually happened.
         if (targets.openclaw) {
             if (result.runtimeChanged) {
                 console.log(`openclaw runtime installed at ${targets.openclaw.version}`);

package/dist/commands/self-update.js.map

@@ -1 +1 @@
-{"version":3,"file":"self-update.js","sourceRoot":"","sources":["../../src/commands/self-update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"self-update.js","sourceRoot":"","sources":["../../src/commands/self-update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EACL,eAAe,EACf,aAAa,EACb,UAAU,GAEX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmBhD,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,cAAsB,EACtB,OAA0B;IAE1B,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,IAAI,aAA+C,CAAC;IACpD,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,YAAY,EAAE,IAAI,CAChB,2BAA2B,EAC3B,MAAM,EACN,6CAA6C,cAAc,GAAG,EAC9D;QACE,cAAc;QACd,QAAQ,EAAE,OAAO,CAAC,eAAe,EAAE,OAAO;QAC1C,cAAc,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO;QACzC,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;KACpD,CACF,CAAC;IAEF,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC;YACzC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;YACjC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;YACjC,WAAW,EAAE,aAAa;SAC3B,CAAC,CAAC;QACH,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;QACtC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QACpC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,eAAe,EAAE,OAAO,EAAE,CAAC;QACrC,SAAS,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACjF,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,EAAE,IAAI,CAChB,0BAA0B,EAC1B,MAAM,EACN,iCAAiC,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,EAClE,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAC9E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;AACxE,CAAC;AAED,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,cAAsB;IACrD,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,oBAAoB,cAAc,cAAc,OAAO,GAAG,CAAC,CAAC;IAExE,MAAM,aAAa,GAAG,MAAM,eAAe,CACzC,GAAG,EAAE,CAAC,SAAS,CAAC,YAAY,UAAU,IAAI,GAAG,UAAU,EAAE,MAAM,CAAC,EAChE,sBAAsB,CACvB,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,KAAK,aAAa,EAAE,CAAC,CAAC;IAE1D,IAAI,cAAc,KAAK,aAAa,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,iBAAiB,cAAc,OAAO,aAAa,KAAK,CAAC,CAAC;IACtE,MAAM,eAAe,CACnB,GAAG,EAAE,CAAC,SAAS,CAAC,kBAAkB,UAAU,IAAI,GAAG,EAAE,EAAE,OAAO,CAAC,EAC/D,gBAAgB,CACjB,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,2BAA2B,aAAa,8CAA8C,CACvF,CAAC;IACF,cAAc,EAAE,CAAC;IACjB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,2FAA2F;AAE3F,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;IAChC,IAAI,CAAC,UAAU,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,CAAC;QACH,4FAA4F;QAC5F,MAAM,GAAG,GAAG,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAsC,CAAC;QAChG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC;YAAE,OAAO,IAAI,CAAC;QACpE,OAAO,IAAyB,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,cAAsB;IAC3D,MAAM,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC5C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,oBAAoB,cAAc,cAAc,OAAO,GAAG,CAAC,CAAC;QAExE,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,YAAY,CAAC,IAAI,CACf,WAAW,GAAG,CAAC;gBACb,CAAC,CAAC,YAAY,OAAO,CAAC,QAAQ,CAAC,OAAO,KAAK,WAAW,aAAa;gBACnE,CAAC,CAAC,YAAY,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAC3C,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,YAAY,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,oBAAoB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,+BAA+B,OAAO,CAAC,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,cAAc,WAAW,eAAe,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,+BAA+B,OAAO,CAAC,eAAe,CAAC,OAAO,KAAK,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAEpE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,iCAAiC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,+BAA+B,OAAO,CAAC,QAAQ,CAAC,OAAO,WAAW,CAAC,CAAC;YAClF,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;YAC/B,OAAO,CAAC,GAAG,CACT,4BAA4B,CAAC,CAAC,SAAS,CAAC,MAAM,eAAe,CAAC,CAAC,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC,MAAM,CAAC,MAAM,SAAS,CACnH,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CACT,2BAA2B,OAAO,CAAC,eAAe,CAAC,OAAO,8CAA8C,CACzG,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,+BAA+B,OAAO,CAAC,eAAe,CAAC,OAAO,WAAW,CAAC,CAAC;YACzF,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,cAAc,EAAE,CAAC;YACjB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;IACtF,MAAM,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,CAAC"}

package/dist/commands/stop-cli.d.ts

@@ -1,6 +1,2 @@
-/**
- * Internal seam — wraps `process.kill` so tests can swap in a stub without
- * mocking the global. Exported for testing only.
- */
 export declare const _killProcess: (pid: number, signal: NodeJS.Signals) => void;
 export declare function runStopCli(): Promise<void>;

package/dist/commands/stop-cli.js

@@ -1,31 +1,8 @@
 import { isLockFilePresent, readLockFilePid } from '../lockfile.js';
 import { logCollector } from '../connection.js';
 import { toErrorMessage } from '../utils/response.js';
-// ---------------------------------------------------------------------------
-// CLI entrypoint for `agent-controller stop`. The WS handler at
-// src/handlers/stop.ts gracefully shuts down the running agent-controller
-// process — the CLI can't do that directly because it's a separate
-// short-lived process, so we signal the running daemon instead.
-//
-// Strategy (option B from the design discussion):
-//   1. Read the lockfile (~/.openclaw/agent-controller/agent-controller.lock
-//      or /opt/openclaw-cloud/agent-controller/agent-controller.lock) to
-//      find the daemon PID.
-//   2. Send SIGTERM. The daemon's normal shutdown path runs.
-//   3. Exit 0 once the signal is sent — we don't wait for the daemon to
-//      actually exit because the supervisor (systemd/launchd/k8s) will
-//      decide whether to restart it.
-//
-// Failure modes:
-//   - No lockfile / daemon not running → exit 0 with a "not running" log
-//   - Lockfile exists but PID is gone (stale) → exit 0, hint to remove lock
-//   - kill(pid, SIGTERM) throws → exit 1 (permission, etc.)
-// ---------------------------------------------------------------------------
+// The CLI is a separate process: signal the lockfile PID and leave restart policy to the supervisor.
 const STOP_SIGNAL = 'SIGTERM';
-/**
- * Internal seam — wraps `process.kill` so tests can swap in a stub without
- * mocking the global. Exported for testing only.
- */
 export const _killProcess = (pid, signal) => {
     process.kill(pid, signal);
 };

package/dist/commands/stop-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"stop-cli.js","sourceRoot":"","sources":["../../src/commands/stop-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,8EAA8E;AAC9E,gEAAgE;AAChE,0EAA0E;AAC1E,mEAAmE;AACnE,gEAAgE;AAChE,EAAE;AACF,kDAAkD;AAClD,6EAA6E;AAC7E,yEAAyE;AACzE,4BAA4B;AAC5B,6DAA6D;AAC7D,wEAAwE;AACxE,uEAAuE;AACvE,qCAAqC;AACrC,EAAE;AACF,iBAAiB;AACjB,yEAAyE;AACzE,4EAA4E;AAC5E,4DAA4D;AAC5D,8EAA8E;AAE9E,MAAM,WAAW,GAAmB,SAAS,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,MAAsB,EAAQ,EAAE;IACxE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,YAAY,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAErE,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CACT,gFAAgF;YAC9E,wEAAwE,CAC3E,CAAC;QACF,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,WAAW,6BAA6B,GAAG,MAAM,CAAC,CAAC;IACjF,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAA4B,CAAC;QACvC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CACT,kBAAkB,GAAG,4DAA4D,CAClF,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,+BAA+B,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;QAC5D,YAAY,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"stop-cli.js","sourceRoot":"","sources":["../../src/commands/stop-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qGAAqG;AAErG,MAAM,WAAW,GAAmB,SAAS,CAAC;AAE9C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,MAAsB,EAAQ,EAAE;IACxE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,YAAY,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAErE,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CACT,gFAAgF;YAC9E,wEAAwE,CAC3E,CAAC;QACF,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,WAAW,6BAA6B,GAAG,MAAM,CAAC,CAAC;IACjF,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,GAA4B,CAAC;QACvC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CACT,kBAAkB,GAAG,4DAA4D,CAClF,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,+BAA+B,GAAG,KAAK,GAAG,EAAE,CAAC,CAAC;QAC5D,YAAY,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC"}

package/dist/config-file.d.ts

@@ -1,13 +1,7 @@
-/** VM provisioner writes env here */
 export declare const VM_ENV_PATH = "/opt/openclaw-cloud/agent-controller/.env";
 export declare function getConfigDir(): string;
 export declare function getConfigPath(): string;
-/**
- * Serialize a dict to `KEY=VALUE` lines and write it 0600, creating the parent
- * directory. The one writer for every env file we own (`agent.env` and the VM
- * provisioner's `.env`) — these files carry AGENT_TOKEN and provider API keys,
- * so the mode is not optional.
- */
+/** Env files carry AGENT_TOKEN and provider keys, so mode 0600 is mandatory. */
 export declare function writeEnvFile(filePath: string, vars: Record<string, string>): Promise<void>;
 export declare function saveEnvFile(config: {
     centrifugoUrl: string;
@@ -17,20 +11,9 @@ export declare function saveEnvFile(config: {
     gatewayToken?: string | null;
 }): Promise<void>;
 /**
- * Parse `KEY=VALUE` lines into a dict. Blank lines, `#` comments and lines
- * without `=` are skipped; only the first `=` separates, so values may contain
- * more. On a duplicate key the FIRST occurrence wins, mirroring `loadEnvFile`'s
- * "already set, don't overwrite" precedence.
- *
- * Deliberately does NOT filter through `ENV_KEYS`: that allowlist governs what
- * this process imports into `process.env`, not what is allowed to live in the
- * file. Callers that rewrite an env file must see every key, or they would drop
- * the ones only systemd or `apiKeyHelper` read.
+ * First occurrence wins, matching loadEnvFile precedence. Do not filter through ENV_KEYS:
+ * rewriting must preserve keys consumed only by systemd or apiKeyHelper.
  */
 export declare function parseEnvContent(content: string): Record<string, string>;
-/**
- * Read and parse an env file. A missing or unreadable file yields `{}` — the
- * caller decides what that means. The counterpart to `writeEnvFile`.
- */
 export declare function readEnvFile(filePath: string): Promise<Record<string, string>>;
 export declare function loadEnvFile(): Promise<void>;

package/dist/config-file.js

@@ -26,7 +26,6 @@ const ENV_KEYS = [
     'MOCK_TASK_DELAY_MS',
     'MOCK_TASK_TEXT',
 ];
-/** VM provisioner writes env here */
 export const VM_ENV_PATH = '/opt/openclaw-cloud/agent-controller/.env';
 export function getConfigDir() {
     return path.join(config.stateDir, 'agent-controller');
@@ -34,12 +33,7 @@ export function getConfigDir() {
 export function getConfigPath() {
     return path.join(getConfigDir(), 'agent.env');
 }
-/**
- * Serialize a dict to `KEY=VALUE` lines and write it 0600, creating the parent
- * directory. The one writer for every env file we own (`agent.env` and the VM
- * provisioner's `.env`) — these files carry AGENT_TOKEN and provider API keys,
- * so the mode is not optional.
- */
+/** Env files carry AGENT_TOKEN and provider keys, so mode 0600 is mandatory. */
 export async function writeEnvFile(filePath, vars) {
     await fs.mkdir(path.dirname(filePath), { recursive: true });
     const content = Object.entries(vars)
@@ -61,15 +55,8 @@ export async function saveEnvFile(config) {
     console.log(`  Config saved to ${getConfigPath()}`);
 }
 /**
- * Parse `KEY=VALUE` lines into a dict. Blank lines, `#` comments and lines
- * without `=` are skipped; only the first `=` separates, so values may contain
- * more. On a duplicate key the FIRST occurrence wins, mirroring `loadEnvFile`'s
- * "already set, don't overwrite" precedence.
- *
- * Deliberately does NOT filter through `ENV_KEYS`: that allowlist governs what
- * this process imports into `process.env`, not what is allowed to live in the
- * file. Callers that rewrite an env file must see every key, or they would drop
- * the ones only systemd or `apiKeyHelper` read.
+ * First occurrence wins, matching loadEnvFile precedence. Do not filter through ENV_KEYS:
+ * rewriting must preserve keys consumed only by systemd or apiKeyHelper.
  */
 export function parseEnvContent(content) {
     const vars = {};
@@ -86,10 +73,6 @@ export function parseEnvContent(content) {
     }
     return vars;
 }
-/**
- * Read and parse an env file. A missing or unreadable file yields `{}` — the
- * caller decides what that means. The counterpart to `writeEnvFile`.
- */
 export async function readEnvFile(filePath) {
     try {
         return parseEnvContent(await fs.readFile(filePath, 'utf-8'));
@@ -106,9 +89,7 @@ async function loadFile(filePath) {
     }
 }
 export async function loadEnvFile() {
-    // 1. User config dir (~/.openclaw/agent-controller/agent.env)
     await loadFile(getConfigPath());
-    // 2. VM provisioner path (/opt/openclaw-cloud/agent-controller/.env)
     await loadFile(VM_ENV_PATH);
 }
 //# sourceMappingURL=config-file.js.map

package/dist/config-file.js.map

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

package/dist/config.d.ts

@@ -1,49 +1,27 @@
 export declare const config: {
-    /** Base state directory — ~/.openclaw or OPENCLAW_STATE_DIR */
     readonly stateDir: string;
-    /** Debug mode (AC_DEBUG or DEBUG) */
     readonly debug: boolean;
-    /** Agent UUID (required for main entry, optional in CLI) */
     readonly agentId: string | undefined;
-    /** Bearer token for backend API */
     readonly agentToken: string | undefined;
-    /** Centrifugo WS endpoint */
     readonly centrifugoUrl: string | undefined;
-    /** Backend API URL — BACKEND_URL takes priority, fallback to BACKEND_INTERNAL_URL */
     readonly backendUrl: string | undefined;
-    /** Agent provider type */
     readonly agentProvider: string;
-    /** OpenClaw Gateway WS URL */
     readonly gatewayWsUrl: string;
-    /** OpenClaw Gateway auth token */
     readonly gatewayToken: string;
-    /** Release channel — beta or stable */
     readonly releaseChannel: "beta" | "stable";
-    /** Workspace directory override */
     readonly workspaceDir: string | undefined;
-    /** Deploy type — 'vm' or undefined */
     readonly agentDeployType: string | undefined;
-    /** HOME directory */
     readonly home: string;
-    /** Anthropic API key (claude-code provider) */
     readonly anthropicApiKey: string | undefined;
-    /** Anthropic auth token — alternative to API key (claude-code provider) */
     readonly anthropicAuthToken: string | undefined;
-    /** Claude Code OAuth token — issued by `claude login` (claude-code provider) */
     readonly claudeCodeOauthToken: string | undefined;
-    /** Workspace directory for the claude-code provider */
     readonly claudeWorkspaceDir: string;
-    /** Optional CLAUDE.md content for the claude-code workspace (set by bootstrap). */
     readonly claudeMdContent: string | undefined;
     /** Bearer token the openclaw Slack relay client must present (defense-in-depth on loopback). */
     readonly slackRelayAuthToken: string | undefined;
-    /** Optional port override for the local Slack relay WS server (default 8788). */
     readonly slackRelayPort: number | undefined;
-    /** Idle poll interval for the mock board worker (mock provider only). */
     readonly mockBoardPollMs: number;
-    /** Simulated "thinking" delay before the mock board worker submits. */
     readonly mockTaskDelayMs: number;
-    /** Text the mock board worker submits as the agent's reply. */
     readonly mockTaskText: string;
 };
 export declare function requireConfig<K extends keyof typeof config>(key: K): NonNullable<(typeof config)[K]>;

package/dist/config.js

@@ -1,16 +1,6 @@
 import os from 'node:os';
 import path from 'node:path';
-/**
- * Central configuration object — single source of truth for all env vars.
- *
- * IMPORTANT: This module must be imported AFTER config-file.ts loadEnvFile()
- * has run, because loadEnvFile() populates process.env from .env files.
- * The main entry point (index.ts) and CLI commands call loadEnvFile() before
- * importing anything that depends on config.
- *
- * For platform-specific values (APPDATA/USERPROFILE on Windows), access
- * process.env directly.
- */
+// Load env files before consuming config; platform-specific variables remain direct process.env reads.
 function stateDir() {
     return process.env.OPENCLAW_STATE_DIR?.trim() || path.join(os.homedir(), '.openclaw');
 }
@@ -19,76 +9,58 @@ function positiveIntEnv(name, fallback) {
     return Number.isInteger(parsed) && parsed > 0 ? parsed : fallback;
 }
 export const config = {
-    /** Base state directory — ~/.openclaw or OPENCLAW_STATE_DIR */
     get stateDir() {
         return stateDir();
     },
-    /** Debug mode (AC_DEBUG or DEBUG) */
     get debug() {
         return !!(process.env.AC_DEBUG || process.env.DEBUG);
     },
-    /** Agent UUID (required for main entry, optional in CLI) */
     get agentId() {
         return process.env.AGENT_ID;
     },
-    /** Bearer token for backend API */
     get agentToken() {
         return process.env.AGENT_TOKEN;
     },
-    /** Centrifugo WS endpoint */
     get centrifugoUrl() {
         return process.env.CENTRIFUGO_URL;
     },
-    /** Backend API URL — BACKEND_URL takes priority, fallback to BACKEND_INTERNAL_URL */
     get backendUrl() {
         return process.env.BACKEND_URL || process.env.BACKEND_INTERNAL_URL || undefined;
     },
-    /** Agent provider type */
     get agentProvider() {
         return process.env.AGENT_PROVIDER ?? 'openclaw';
     },
-    /** OpenClaw Gateway WS URL */
     get gatewayWsUrl() {
         return process.env.OPENCLAW_GATEWAY_WS ?? 'ws://localhost:18789';
     },
-    /** OpenClaw Gateway auth token */
     get gatewayToken() {
         return process.env.OPENCLAW_GATEWAY_TOKEN ?? '';
     },
-    /** Release channel — beta or stable */
     get releaseChannel() {
         const raw = process.env.AC_RELEASE_CHANNEL?.trim().toLowerCase();
         return raw === 'beta' ? 'beta' : 'stable';
     },
-    /** Workspace directory override */
     get workspaceDir() {
         return process.env.WORKSPACE_DIR?.trim() || undefined;
     },
-    /** Deploy type — 'vm' or undefined */
     get agentDeployType() {
         return process.env.AGENT_DEPLOY_TYPE;
     },
-    /** HOME directory */
     get home() {
         return process.env.HOME ?? '/root';
     },
-    /** Anthropic API key (claude-code provider) */
     get anthropicApiKey() {
         return process.env.ANTHROPIC_API_KEY;
     },
-    /** Anthropic auth token — alternative to API key (claude-code provider) */
     get anthropicAuthToken() {
         return process.env.ANTHROPIC_AUTH_TOKEN;
     },
-    /** Claude Code OAuth token — issued by `claude login` (claude-code provider) */
     get claudeCodeOauthToken() {
         return process.env.CLAUDE_CODE_OAUTH_TOKEN;
     },
-    /** Workspace directory for the claude-code provider */
     get claudeWorkspaceDir() {
         return process.env.CLAUDE_WORKSPACE_DIR ?? '/home/ubuntu/.claude/workspace';
     },
-    /** Optional CLAUDE.md content for the claude-code workspace (set by bootstrap). */
     get claudeMdContent() {
         return process.env.CLAUDE_MD_CONTENT?.trim() || undefined;
     },
@@ -96,7 +68,6 @@ export const config = {
     get slackRelayAuthToken() {
         return process.env.SLACK_RELAY_AUTH_TOKEN?.trim() || undefined;
     },
-    /** Optional port override for the local Slack relay WS server (default 8788). */
     get slackRelayPort() {
         const raw = process.env.SLACK_RELAY_PORT?.trim();
         if (!raw)
@@ -104,20 +75,16 @@ export const config = {
         const parsed = Number.parseInt(raw, 10);
         return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
     },
-    /** Idle poll interval for the mock board worker (mock provider only). */
     get mockBoardPollMs() {
         return positiveIntEnv('MOCK_BOARD_POLL_MS', 7_000);
     },
-    /** Simulated "thinking" delay before the mock board worker submits. */
     get mockTaskDelayMs() {
         return positiveIntEnv('MOCK_TASK_DELAY_MS', 1_500);
     },
-    /** Text the mock board worker submits as the agent's reply. */
     get mockTaskText() {
         return process.env.MOCK_TASK_TEXT?.trim() || 'Mock agent completed the task.';
     },
 };
-/* ── Strict accessors (throw on missing) ────────────────────── */
 export function requireConfig(key) {
     const value = config[key];
     if (value === undefined || value === null || value === '') {

package/dist/config.js.map

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

package/dist/connection.js

@@ -23,19 +23,8 @@ import { handleUpdateConfig } from './handlers/update-config.js';
 import { createMemoryHandlers } from './handlers/memory.js';
 import { toErrorMessage } from './utils/response.js';
 import { LogCollector } from './utils/log-collector.js';
-// ---------------------------------------------------------------------------
-// Log collector singleton — initialized in createConnection()
-// ---------------------------------------------------------------------------
 export let logCollector;
-// ---------------------------------------------------------------------------
-// Centrifuge state mappers
-//
-// The centrifuge library exposes `.state` as a string-valued enum
-// (`State.Connected = 'connected'`, etc.) on both clients and subscriptions.
-// We coerce defensively to the CentrifugoStatus string-literal contract so
-// any unexpected enum value (library upgrade, runtime edge case) maps to a
-// safe "down" state rather than throwing — heartbeats must never crash.
-// ---------------------------------------------------------------------------
+// Unexpected Centrifuge states must map to down; library changes must not crash heartbeats.
 export function mapClientState(raw) {
     if (raw === 'connected')
         return 'connected';
@@ -50,9 +39,6 @@ export function mapSubState(raw) {
         return 'subscribing';
     return 'unsubscribed';
 }
-// ---------------------------------------------------------------------------
-// Chat response types — moved to module scope to avoid re-creation on every message
-// ---------------------------------------------------------------------------
 const CHAT_RESPONSE_TYPES = new Set([
     'chat_sessions_response',
     'chat_history_response',
@@ -60,9 +46,6 @@ const CHAT_RESPONSE_TYPES = new Set([
     'chat_delta',
     'chat_typing',
 ]);
-// ---------------------------------------------------------------------------
-// Handlers
-// ---------------------------------------------------------------------------
 function buildHandlers(opts) {
     return {
         diagnostics: handleDiagnostics,
@@ -86,9 +69,6 @@ function buildHandlers(opts) {
         ...(opts.knowledgeGraphManager ? createMemoryHandlers(opts.knowledgeGraphManager) : {}),
     };
 }
-// ---------------------------------------------------------------------------
-// Step 1: Create Centrifuge client (no subscriptions yet)
-// ---------------------------------------------------------------------------
 function createClient(opts) {
     const getToken = async () => {
         console.log('Fetching connection token...');
@@ -102,7 +82,6 @@ function createClient(opts) {
             throw err;
         }
     };
-    // Ensure Centrifugo URL includes /connection/websocket path
     let wsUrl = opts.url;
     if (!wsUrl.includes('/connection/websocket')) {
         wsUrl = wsUrl.replace(/\/+$/, '') + '/connection/websocket';
@@ -132,9 +111,6 @@ function createClient(opts) {
     });
     return client;
 }
-// ---------------------------------------------------------------------------
-// Step 2: Subscribe to a channel with subscription token auth
-// ---------------------------------------------------------------------------
 function subscribeToChannel(client, channel, opts) {
     const sub = client.newSubscription(channel, {
         getToken: async () => {
@@ -165,9 +141,6 @@ function subscribeToChannel(client, channel, opts) {
     sub.subscribe();
     return sub;
 }
-// ---------------------------------------------------------------------------
-// Step 3: Wire up system command channel (agent:<agentId>)
-// ---------------------------------------------------------------------------
 function attachCommandHandlers(sub, channel, opts, markEvent) {
     const handlers = buildHandlers(opts);
     let commandQueue = Promise.resolve();
@@ -242,9 +215,6 @@ function attachCommandHandlers(sub, channel, opts, markEvent) {
     });
     return () => commandQueue;
 }
-// ---------------------------------------------------------------------------
-// Step 4: Wire up chat command channel (chat:<agentId>)
-// ---------------------------------------------------------------------------
 function attachChatHandlers(sub, channel, opts, markEvent) {
     sub.on('publication', (ctx) => {
         markEvent();
@@ -284,25 +254,18 @@ function attachChatHandlers(sub, channel, opts, markEvent) {
         }
     });
 }
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
 export function createConnection(opts) {
-    // Initialize log collector singleton
     logCollector = new LogCollector(opts.api, { flushIntervalMs: 5000, maxBatchSize: 50 });
     const commandChannel = `agent:${opts.agentId}`;
     const chatChannel = `chat:${opts.agentId}`;
     const client = createClient(opts);
-    // Track the most recent inbound publication across BOTH channels — this is
-    // the truest "WS is alive end-to-end" signal we can give the backend.
+    // Either inbound channel proves command transport is alive; an HTTP heartbeat alone cannot.
     let lastEventAt = null;
     const markEvent = () => {
         lastEventAt = new Date().toISOString();
     };
-    // System commands channel (serialized queue)
     const commandSub = subscribeToChannel(client, commandChannel, opts);
     const drainCommands = attachCommandHandlers(commandSub, commandChannel, opts, markEvent);
-    // Chat commands channel (concurrent, fire-and-forget)
     const chatSub = subscribeToChannel(client, chatChannel, opts);
     attachChatHandlers(chatSub, chatChannel, opts, markEvent);
     const getCentrifugoStatus = () => {