fix: add gateway_stop hook to prevent EADDRINUSE on hot restart

Author: 1bcMax

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/clawrouter",
-  "version": "0.3.38",
+  "version": "0.3.39",
   "description": "Smart LLM router — save 78% on inference costs. 30+ models, one wallet, x402 micropayments.",
   "type": "module",
   "main": "dist/index.js",

package.json

@@ -181,6 +181,9 @@ function injectAuthProfile(logger: { info: (msg: string) => void }): void {
   }
 }
 
+// Store active proxy handle for cleanup on gateway_stop
+let activeProxyHandle: Awaited<ReturnType<typeof startProxy>> | null = null;
+
 /**
  * Start the x402 proxy in the background.
  * Called from register() because OpenClaw's loader only invokes register(),
@@ -249,6 +252,7 @@ async function startProxyInBackground(api: OpenClawPluginApi): Promise<void> {
   });
 
   setActiveProxy(proxy);
+  activeProxyHandle = proxy;
   api.logger.info(`BlockRun provider active — ${proxy.baseUrl}/v1 (smart routing enabled)`);
 }
 
@@ -298,7 +302,22 @@ const plugin: OpenClawPluginDefinition = {
     if (!defaults.model) defaults.model = {};
     (defaults.model as Record<string, unknown>).primary = "blockrun/auto";
 
-    api.logger.info("BlockRun provider registered (default: blockrun/auto)");
+    api.logger.info("BlockRun provider registered (30+ models via x402)");
+
+    // Register cleanup hook for gateway hot restarts (prevents EADDRINUSE on port 8402)
+    api.on("gateway_stop", async () => {
+      if (activeProxyHandle) {
+        try {
+          await activeProxyHandle.close();
+          api.logger.info("BlockRun proxy closed for gateway restart");
+        } catch (err) {
+          api.logger.warn(
+            `Failed to close proxy: ${err instanceof Error ? err.message : String(err)}`,
+          );
+        }
+        activeProxyHandle = null;
+      }
+    });
 
     // Start x402 proxy in background (fire-and-forget)
     // OpenClaw only calls register(), not activate() — so all init goes here.