@cfio/cohort-sync 0.13.0 → 0.15.0

package/dist/index.js

@@ -11700,14 +11700,16 @@ async function executeCommand(cmd, gwClient, cfg, resolveAgentName, logger) {
     throw new Error(`Cron message exceeds maximum length of ${MAX_CRON_MESSAGE_LENGTH} characters`);
   }
   if (cmd.type === "restart") {
-    if (gwClient && gwClient.isAlive()) {
-      logger.warn(`cohort-sync: RESTART command received (id=${cmd._id}), issuing graceful gateway restart`);
-      await gwClient.request("gateway.restart", { reason: "Cohort restart command" });
-    } else {
-      logger.warn(`cohort-sync: RESTART command received (id=${cmd._id}), no gateway client \u2014 falling back to SIGTERM`);
-      await new Promise((r) => setTimeout(r, 500));
-      process.kill(process.pid, "SIGTERM");
+    if (cfg.commandsRestartEnabled !== true) {
+      throw new Error(
+        "Gateway restart is not authorized. Set `commands.restart: true` in your OpenClaw config and restart the gateway once. See https://docs.cohort.bot/gateway/restart"
+      );
     }
+    logger.warn(
+      `cohort-sync: RESTART command received (id=${cmd._id}), sending SIGUSR1 for graceful in-process restart`
+    );
+    await new Promise((r) => setTimeout(r, 500));
+    process.kill(process.pid, "SIGUSR1");
     return;
   }
   if (cmd.type.startsWith("cron")) {
@@ -13370,7 +13372,7 @@ function dumpCtx(ctx) {
 function dumpEvent(event) {
   return dumpCtx(event);
 }
-var PLUGIN_VERSION = true ? "0.13.0" : "unknown";
+var PLUGIN_VERSION = true ? "0.15.0" : "unknown";
 function resolveGatewayToken(api) {
   const token = api.config?.gateway?.auth?.token;
   return typeof token === "string" ? token : null;
@@ -13576,7 +13578,7 @@ async function handleGatewayStart(event, state) {
       tracker.updateStatus(agentName, "idle");
       const snapshot = tracker.getTelemetrySnapshot(agentName);
       if (snapshot) {
-        await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
+        await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, commandsRestartEnabled: cfg.commandsRestartEnabled, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
         tracker.markTelemetryPushed(agentName);
       }
     } catch (err) {
@@ -13590,7 +13592,7 @@ async function handleGatewayStart(event, state) {
       const agentName = state.resolveAgentName(agentId);
       const snapshot = tracker.getTelemetrySnapshot(agentName);
       if (snapshot) {
-        await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} }).catch(() => {
+        await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, commandsRestartEnabled: cfg.commandsRestartEnabled, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} }).catch(() => {
         });
       }
     }
@@ -13668,7 +13670,7 @@ function registerHookHandlers(api, logger, getState) {
       if (tracker.shouldPushTelemetry(agentName)) {
         const snapshot = tracker.getTelemetrySnapshot(agentName);
         if (snapshot) {
-          await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
+          await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, commandsRestartEnabled: cfg.commandsRestartEnabled, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
           tracker.markTelemetryPushed(agentName);
         }
       }
@@ -13730,7 +13732,7 @@ function registerHookHandlers(api, logger, getState) {
       if (tracker.shouldPushTelemetry(agentName)) {
         const snapshot = tracker.getTelemetrySnapshot(agentName);
         if (snapshot) {
-          await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
+          await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, commandsRestartEnabled: cfg.commandsRestartEnabled, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
           tracker.markTelemetryPushed(agentName);
         }
       }
@@ -13758,7 +13760,7 @@ function registerHookHandlers(api, logger, getState) {
       if (tracker.shouldPushTelemetry(agentName)) {
         const snapshot = tracker.getTelemetrySnapshot(agentName);
         if (snapshot) {
-          await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
+          await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, commandsRestartEnabled: cfg.commandsRestartEnabled, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
           tracker.markTelemetryPushed(agentName);
         }
       }
@@ -13800,7 +13802,7 @@ function registerHookHandlers(api, logger, getState) {
       if (tracker.shouldPushTelemetry(agentName)) {
         const snapshot = tracker.getTelemetrySnapshot(agentName);
         if (snapshot) {
-          await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
+          await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, commandsRestartEnabled: cfg.commandsRestartEnabled, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
           tracker.markTelemetryPushed(agentName);
         }
       }
@@ -13986,28 +13988,36 @@ function registerHookHandlers(api, logger, getState) {
       state.logger.warn(`cohort-sync: before_reset activity failed: ${String(err)}`);
     }
   });
-  api.on("gateway_stop", async (_event, _ctx) => {
+  api.on("gateway_stop", async (event, _ctx) => {
     const state = getState();
     if (!state) return;
     const { cfg, tracker, logger: log, config } = state;
-    log.debug("cohort-sync: hook: gateway_stop", { bridgeState: Object.fromEntries(getChannelAgentBridge()) });
+    const reason = typeof event?.reason === "string" ? event.reason : "";
+    const isRestart = reason.toLowerCase().includes("restart");
+    log.debug("cohort-sync: hook: gateway_stop", {
+      reason,
+      isRestart,
+      bridgeState: Object.fromEntries(getChannelAgentBridge())
+    });
     if (state.keepaliveInterval) {
       clearInterval(state.keepaliveInterval);
       state.keepaliveInterval = null;
     }
     state.activityBatch.drain();
-    const shutdownConfigIds = (config?.agents?.list ?? []).map((a) => a.id);
-    const allAgentIds = shutdownConfigIds.includes("main") ? shutdownConfigIds : ["main", ...shutdownConfigIds];
-    for (const agentId of allAgentIds) {
-      const agentName = state.resolveAgentName(agentId);
-      try {
-        tracker.updateStatus(agentName, "unreachable");
-        const snapshot = tracker.getTelemetrySnapshot(agentName);
-        if (snapshot) {
-          await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
+    if (!isRestart) {
+      const shutdownConfigIds = (config?.agents?.list ?? []).map((a) => a.id);
+      const allAgentIds = shutdownConfigIds.includes("main") ? shutdownConfigIds : ["main", ...shutdownConfigIds];
+      for (const agentId of allAgentIds) {
+        const agentName = state.resolveAgentName(agentId);
+        try {
+          tracker.updateStatus(agentName, "unreachable");
+          const snapshot = tracker.getTelemetrySnapshot(agentName);
+          if (snapshot) {
+            await pushTelemetry(cfg.apiKey, { ...snapshot, pluginVersion: PLUGIN_VERSION, commandsRestartEnabled: cfg.commandsRestartEnabled, ...state.latestPluginVersion ? { latestPluginVersion: state.latestPluginVersion } : {} });
+          }
+        } catch (err) {
+          log.warn(`cohort-sync: final unreachable push failed for ${agentName}: ${String(err)}`);
         }
-      } catch (err) {
-        log.warn(`cohort-sync: final unreachable push failed for ${agentName}: ${String(err)}`);
       }
     }
     saveSessionsToDisk(tracker, state.stateFilePath);
@@ -14016,14 +14026,18 @@ function registerHookHandlers(api, logger, getState) {
       state.persistentGwClient = null;
       state.gwClientInitialized = false;
     }
-    try {
-      await markAllUnreachable(cfg, log);
-    } catch (err) {
-      log.warn(`cohort-sync: markAllUnreachable failed: ${String(err)}`);
+    if (!isRestart) {
+      try {
+        await markAllUnreachable(cfg, log);
+      } catch (err) {
+        log.warn(`cohort-sync: markAllUnreachable failed: ${String(err)}`);
+      }
     }
     tracker.clear();
     closeBridge();
-    log.info("cohort-sync: gateway stopped, all resources cleaned up");
+    log.info(
+      isRestart ? "cohort-sync: gateway restarting, resources cleaned up (agents kept online)" : "cohort-sync: gateway stopped, all resources cleaned up"
+    );
   });
 }
 function initializeHookState(api, cfg) {
@@ -14475,11 +14489,13 @@ Do not attempt more comments until tomorrow.`);
         }
         api.logger.info(`cohort-sync: activated (api: ${apiUrl2})`);
         if (!sharedHookState) {
+          const commandsRestartEnabled = api.config?.commands?.restart === true;
           sharedHookState = initializeHookState(api, {
             apiUrl: apiUrl2,
             apiKey: apiKey2,
             stateDir: svcCtx.stateDir,
-            agentNameMap: cfg?.agentNameMap
+            agentNameMap: cfg?.agentNameMap,
+            commandsRestartEnabled
           });
         }
       },

package/dist/openclaw.plugin.json

@@ -55,5 +55,5 @@
       }
     }
   },
-  "version": "0.13.0"
+  "version": "0.15.0"
 }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfio/cohort-sync",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "OpenClaw plugin — syncs agent telemetry, sessions, and activity to the Cohort dashboard",
   "type": "module",
   "main": "index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfio/cohort-sync",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "OpenClaw plugin — syncs agent telemetry, sessions, and activity to the Cohort dashboard",
   "license": "MIT",
   "homepage": "https://docs.cohort.bot/gateway",