@openclaw-cloud/agent-controller 2.4.0-beta.2 → 2.4.0-beta.3

package/bin/agent-controller.js

@@ -43,13 +43,19 @@ if (command === '--version' || command === '-v') {
 } else if (command === 'channel-server' || command === 'channel_server') {
   const { runChannelServer } = await import('../dist/commands/channel-server.js');
   await runChannelServer(process.argv.slice(3));
+} else if (command === 'plugin-update' || command === 'plugin_update') {
+  const { runPluginUpdateCli } = await import('../dist/commands/plugin-update-cli.js');
+  await runPluginUpdateCli(process.argv.slice(3));
+} else if (command === 'agent-update' || command === 'agent_update') {
+  const { runAgentUpdateCli } = await import('../dist/commands/agent-update-cli.js');
+  await runAgentUpdateCli(process.argv.slice(3));
 } else if (command === undefined) {
   const { main } = await import('../dist/index.js');
   main();
 } else {
   console.error(`Unknown command: ${command}`);
   console.error(
-    'Available: --version, self-update, backup, knowledge-sync, heartbeat, bootstrap, update-config, install-deps, install, uninstall, channel-server',
+    'Available: --version, self-update, backup, knowledge-sync, heartbeat, bootstrap, update-config, install-deps, install, uninstall, channel-server, plugin-update, agent-update',
   );
   process.exit(2);
 }

package/dist/commands/agent-update-cli.d.ts

@@ -0,0 +1 @@
+export declare function runAgentUpdateCli(args: string[]): Promise<void>;

package/dist/commands/agent-update-cli.js

@@ -0,0 +1,104 @@
+import { installOpenclaw, installPlugins, } from '../utils/openclaw-ops.js';
+import { restartGateway } from '../utils/gateway-restart.js';
+import { logCollector } from '../connection.js';
+import { toErrorMessage } from '../utils/response.js';
+// ---------------------------------------------------------------------------
+// CLI entrypoint for
+//   agent-controller agent-update <openclaw-version> [plugin@v ...]
+// Mirrors the WS handler at src/handlers/agent-update.ts: install runtime,
+// install plugins (per-plugin failures recorded but don't abort the batch),
+// then a single best-effort gateway restart if anything actually changed.
+// ---------------------------------------------------------------------------
+const USAGE = 'Usage: agent-controller agent-update <openclaw-version> [plugin1@v1 plugin2@v2 ...]';
+function parsePluginToken(token) {
+    const at = token.lastIndexOf('@');
+    if (at <= 0)
+        return null;
+    const id = token.slice(0, at).trim();
+    const version = token.slice(at + 1).trim();
+    if (!id || !version)
+        return null;
+    return { id, version };
+}
+function parseArgs(args) {
+    if (args.length < 1)
+        return null;
+    const openclawVersion = args[0]?.trim() ?? '';
+    if (!openclawVersion)
+        return null;
+    const plugins = [];
+    for (const token of args.slice(1)) {
+        const p = parsePluginToken(token);
+        if (!p)
+            return null;
+        plugins.push(p);
+    }
+    return { openclawVersion, plugins };
+}
+function logSummary(runtimeChanged, summary) {
+    console.log(`[agent-update] runtime ${runtimeChanged ? 'installed' : 'unchanged'}`);
+    if (summary) {
+        if (summary.installed.length > 0) {
+            console.log(`[agent-update] plugins installed: ${summary.installed.join(', ')}`);
+        }
+        if (summary.skipped.length > 0) {
+            console.log(`[agent-update] plugins skipped: ${summary.skipped.join(', ')}`);
+        }
+        if (summary.failed.length > 0) {
+            for (const f of summary.failed) {
+                console.error(`[agent-update] plugin failed: ${f.id} — ${f.error}`);
+            }
+        }
+    }
+}
+export async function runAgentUpdateCli(args) {
+    const parsed = parseArgs(args);
+    if (!parsed) {
+        console.error(USAGE);
+        process.exit(2);
+    }
+    const { openclawVersion, plugins } = parsed;
+    logCollector?.push('agent_update_cli_start', 'info', 'agent-update CLI invoked', {
+        version: openclawVersion,
+        pluginCount: plugins.length,
+    });
+    let runtimeChanged = false;
+    let pluginSummary;
+    try {
+        console.log(`[agent-update] installing openclaw@${openclawVersion}...`);
+        runtimeChanged = await installOpenclaw(openclawVersion);
+        if (plugins.length > 0) {
+            console.log(`[agent-update] installing ${plugins.length} plugin(s)...`);
+            pluginSummary = await installPlugins(plugins);
+        }
+    }
+    catch (err) {
+        const msg = toErrorMessage(err);
+        console.error(`[agent-update] failed: ${msg}`);
+        logCollector?.push('agent_update_cli_failed', 'error', 'agent-update CLI failed', {
+            version: openclawVersion,
+            error: msg,
+        });
+        process.exit(1);
+    }
+    logSummary(runtimeChanged, pluginSummary);
+    const installedCount = pluginSummary?.installed.length ?? 0;
+    const anyChanged = runtimeChanged || installedCount > 0;
+    if (anyChanged) {
+        console.log('[agent-update] restarting gateway...');
+        try {
+            await restartGateway();
+            console.log('[agent-update] gateway restarted');
+        }
+        catch (err) {
+            const msg = toErrorMessage(err);
+            console.error(`[agent-update] gateway restart failed (treating as warning): ${msg}`);
+            logCollector?.push('agent_update_cli_restart_failed', 'warn', 'Gateway restart failed after CLI agent-update', { version: openclawVersion, error: msg });
+        }
+    }
+    else {
+        console.log('[agent-update] nothing changed, skipping gateway restart');
+    }
+    console.log('[agent-update] done');
+}
+//# sourceMappingURL=agent-update-cli.js.map

package/dist/commands/agent-update-cli.js.map

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

package/dist/commands/plugin-update-cli.d.ts

@@ -0,0 +1 @@
+export declare function runPluginUpdateCli(args: string[]): Promise<void>;

package/dist/commands/plugin-update-cli.js

@@ -0,0 +1,77 @@
+import { installPlugin } from '../utils/openclaw-ops.js';
+import { restartGateway } from '../utils/gateway-restart.js';
+import { logCollector } from '../connection.js';
+import { toErrorMessage } from '../utils/response.js';
+// ---------------------------------------------------------------------------
+// CLI entrypoint for `agent-controller plugin-update <id> <version>`
+// (also accepts `<id>@<version>` shorthand). Mirrors the behaviour of the WS
+// handler at src/handlers/plugin-update.ts: install, then best-effort restart
+// the gateway. Restart failures degrade to a warning — the install already
+// succeeded so we exit 0.
+// ---------------------------------------------------------------------------
+const USAGE = 'Usage: agent-controller plugin-update <id> <version>\n' +
+    '       agent-controller plugin-update <id>@<version>';
+function parseArgs(args) {
+    if (args.length === 1) {
+        const at = args[0].lastIndexOf('@');
+        // Reject leading-@ so `@scope/name` without version doesn't slip through.
+        if (at <= 0)
+            return null;
+        const id = args[0].slice(0, at).trim();
+        const version = args[0].slice(at + 1).trim();
+        if (!id || !version)
+            return null;
+        return { id, version };
+    }
+    if (args.length === 2) {
+        const id = args[0]?.trim() ?? '';
+        const version = args[1]?.trim() ?? '';
+        if (!id || !version)
+            return null;
+        return { id, version };
+    }
+    return null;
+}
+export async function runPluginUpdateCli(args) {
+    const parsed = parseArgs(args);
+    if (!parsed) {
+        console.error(USAGE);
+        process.exit(2);
+    }
+    const { id, version } = parsed;
+    logCollector?.push('plugin_update_cli_start', 'info', 'plugin-update CLI invoked', {
+        id,
+        version,
+    });
+    try {
+        console.log(`[plugin-update] installing ${id}@${version}...`);
+        const installed = await installPlugin(id, version);
+        if (!installed) {
+            console.log(`[plugin-update] ${id}@${version} already installed, nothing to do`);
+            console.log('[plugin-update] done');
+            return;
+        }
+        console.log('[plugin-update] restarting gateway...');
+        try {
+            await restartGateway();
+            console.log('[plugin-update] gateway restarted');
+        }
+        catch (err) {
+            const msg = toErrorMessage(err);
+            console.error(`[plugin-update] gateway restart failed (treating as warning): ${msg}`);
+            logCollector?.push('plugin_update_cli_restart_failed', 'warn', 'Gateway restart failed after CLI plugin install', { id, version, error: msg });
+        }
+        console.log('[plugin-update] done');
+    }
+    catch (err) {
+        const msg = toErrorMessage(err);
+        console.error(`[plugin-update] failed: ${msg}`);
+        logCollector?.push('plugin_update_cli_failed', 'error', 'plugin-update CLI failed', {
+            id,
+            version,
+            error: msg,
+        });
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=plugin-update-cli.js.map

package/dist/commands/plugin-update-cli.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw-cloud/agent-controller",
-  "version": "2.4.0-beta.2",
+  "version": "2.4.0-beta.3",
   "type": "module",
   "main": "dist/index.js",
   "bin": {