nextclaw 0.5.4 → 0.5.5

package/dist/cli/index.js

@@ -954,6 +954,7 @@ var CliRuntime = class {
   logo;
   restartCoordinator;
   serviceRestartTask = null;
+  selfRelaunchArmed = false;
   constructor(options = {}) {
     this.logo = options.logo ?? LOGO;
     this.restartCoordinator = new RestartCoordinator({
@@ -1002,7 +1003,99 @@ var CliRuntime = class {
       this.serviceRestartTask = null;
     }
   }
+  armManagedServiceRelaunch(params) {
+    const strategy = params.strategy ?? "background-service-or-manual";
+    if (strategy !== "background-service-or-exit" && strategy !== "exit-process") {
+      return;
+    }
+    if (this.selfRelaunchArmed) {
+      return;
+    }
+    const state = readServiceState();
+    if (!state || state.pid !== process.pid) {
+      return;
+    }
+    const uiPort = typeof state.uiPort === "number" && Number.isFinite(state.uiPort) ? state.uiPort : 18791;
+    const delayMs = typeof params.delayMs === "number" && Number.isFinite(params.delayMs) ? Math.max(0, Math.floor(params.delayMs)) : 100;
+    const cliPath = process.env.NEXTCLAW_SELF_RELAUNCH_CLI?.trim() || fileURLToPath2(new URL("./index.js", import.meta.url));
+    const startArgs = [cliPath, "start", "--ui-port", String(uiPort)];
+    const serviceStatePath = resolve4(getDataDir2(), "run", "service.json");
+    const helperScript = [
+      'const { spawnSync } = require("node:child_process");',
+      'const { readFileSync } = require("node:fs");',
+      `const parentPid = ${process.pid};`,
+      `const delayMs = ${delayMs};`,
+      "const maxWaitMs = 120000;",
+      "const retryIntervalMs = 1000;",
+      "const startTimeoutMs = 60000;",
+      `const nodePath = ${JSON.stringify(process.execPath)};`,
+      `const startArgs = ${JSON.stringify(startArgs)};`,
+      `const serviceStatePath = ${JSON.stringify(serviceStatePath)};`,
+      "function isRunning(pid) {",
+      "  try {",
+      "    process.kill(pid, 0);",
+      "    return true;",
+      "  } catch {",
+      "    return false;",
+      "  }",
+      "}",
+      "function hasReplacementService() {",
+      "  try {",
+      '    const raw = readFileSync(serviceStatePath, "utf-8");',
+      "    const state = JSON.parse(raw);",
+      "    const pid = Number(state?.pid);",
+      "    return Number.isFinite(pid) && pid > 0 && pid !== parentPid && isRunning(pid);",
+      "  } catch {",
+      "    return false;",
+      "  }",
+      "}",
+      "function tryStart() {",
+      "  spawnSync(nodePath, startArgs, {",
+      '    stdio: "ignore",',
+      "    env: process.env,",
+      "    timeout: startTimeoutMs",
+      "  });",
+      "}",
+      "setTimeout(() => {",
+      "  const startedAt = Date.now();",
+      "  const tick = () => {",
+      "    if (hasReplacementService()) {",
+      "      process.exit(0);",
+      "      return;",
+      "    }",
+      "    if (Date.now() - startedAt >= maxWaitMs) {",
+      "      process.exit(0);",
+      "      return;",
+      "    }",
+      "    tryStart();",
+      "    if (hasReplacementService()) {",
+      "      process.exit(0);",
+      "      return;",
+      "    }",
+      "    setTimeout(tick, retryIntervalMs);",
+      "  };",
+      "  tick();",
+      "}, delayMs);"
+    ].join("\n");
+    try {
+      const helper = spawn2(process.execPath, ["-e", helperScript], {
+        detached: true,
+        stdio: "ignore",
+        env: process.env
+      });
+      helper.unref();
+      this.selfRelaunchArmed = true;
+      console.warn(`Gateway self-restart armed (${params.reason}).`);
+    } catch (error) {
+      console.error(`Failed to arm gateway self-restart: ${String(error)}`);
+    }
+  }
   async requestRestart(params) {
+    this.armManagedServiceRelaunch({
+      reason: params.reason,
+      strategy: params.strategy,
+      delayMs: params.delayMs
+    });
     const result = await this.restartCoordinator.requestRestart({
       reason: params.reason,
       strategy: params.strategy,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -38,9 +38,9 @@
   "dependencies": {
     "chokidar": "^3.6.0",
     "commander": "^12.1.0",
-    "@nextclaw/core": "^0.5.2",
+    "@nextclaw/core": "^0.5.3",
     "@nextclaw/server": "^0.3.7",
-    "@nextclaw/openclaw-compat": "^0.1.3"
+    "@nextclaw/openclaw-compat": "^0.1.4"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",

package/templates/USAGE.md

@@ -285,8 +285,9 @@ Behavior:
 - If `NEXTCLAW_UPDATE_COMMAND` is set, the CLI executes it (useful for custom update flows).
 - Otherwise it falls back to `npm i -g nextclaw`.
 - If the background service is running, restart it after the update to apply changes.
+- When update is triggered from the running gateway (agent `update.run`), NextClaw arms a self-relaunch helper before exiting, so the service comes back automatically (like an OS reboot flow).
 
-If the gateway is running, you can also ask the agent to update; the agent will call the gateway update tool only when you explicitly request it, and a restart will be scheduled afterward.
+If the gateway is running, you can also ask the agent to update; the agent will call the gateway update tool only when you explicitly request it, and restart/relaunch will be scheduled afterward.
 
 ---