@emotion-machine/claw-messenger 0.1.3 → 0.1.6

package/dist/channel.js

@@ -156,6 +156,7 @@ export const clawMessengerPlugin = {
         messageToolHints: () => [
             "You can react to messages using iMessage tapbacks via the react action. Available: love (❤️), like (👍), dislike (👎), laugh (😂), emphasize (‼️), question (❓).",
             "Use reactions naturally — the way a real person would in iMessage.",
+            "If you encounter connection issues, the server is WebSocket-only — do NOT test with HTTP. Full API docs and troubleshooting: https://clawmessenger.com/docs",
         ],
     },
     // Legacy API (OpenClaw <2026.3.22): kept for backward compatibility

package/dist/ws/client.d.ts

@@ -1,6 +1,10 @@
 /**
  * WebSocket client with reconnection and request/response correlation.
  * Connects to claw-messenger server with API key auth.
+ *
+ * Uses the `ws` npm package instead of the native WebSocket to avoid
+ * Node 22+ HTTP/2 compatibility issues (native WebSocket silently fails
+ * against HTTP/2 servers like Render.com).
  */
 type MessageHandler = (message: Record<string, unknown>) => void;
 export interface WsClientOptions {

package/dist/ws/client.js

@@ -1,11 +1,22 @@
 /**
  * WebSocket client with reconnection and request/response correlation.
  * Connects to claw-messenger server with API key auth.
+ *
+ * Uses the `ws` npm package instead of the native WebSocket to avoid
+ * Node 22+ HTTP/2 compatibility issues (native WebSocket silently fails
+ * against HTTP/2 servers like Render.com).
  */
+import WebSocket from "ws";
 const MAX_RECONNECT_DELAY_MS = 30_000;
+const MAX_RECONNECT_ATTEMPTS = 50;
 const PING_INTERVAL_MS = 30_000;
 const REQUEST_TIMEOUT_MS = 30_000;
 const PONG_TIMEOUT_MS = 10_000;
+/** Close codes that indicate the client should NOT reconnect. */
+const NO_RECONNECT_CODES = new Set([
+    1008, // Policy violation — connection limit reached (evicted)
+    4003, // Subscription inactive (cancelled/expired)
+]);
 export class WsClient {
     ws = null;
     opts;
@@ -84,10 +95,23 @@ export class WsClient {
         }
         url.searchParams.set("key", this.opts.apiKey);
         this.opts.log?.(`Connecting to ${url.origin}${url.pathname}...`);
+        // Close the previous socket if it's still open, so we don't leak
+        // connections on the server. Set this.ws to null first so the old
+        // socket's onclose handler sees it's stale and skips reconnect.
+        if (this.ws && this.ws.readyState !== WebSocket.CLOSED) {
+            const oldWs = this.ws;
+            this.ws = null;
+            try {
+                oldWs.close(1000, "Replaced by new connection");
+            }
+            catch { }
+        }
         const ws = new WebSocket(url.toString());
         this.ws = ws;
         ws.onopen = () => {
-            this.reconnectAttempt = 0;
+            // Don't reset reconnectAttempt here — reset on first successful
+            // message exchange instead, so eviction loops can't keep the
+            // counter at 0 and bypass backoff.
             this.lastPongAt = Date.now();
             this.opts.log?.("Connected");
             // Reject stale pending requests from previous connection
@@ -106,17 +130,36 @@ export class WsClient {
         };
         ws.onclose = (event) => {
             this.opts.log?.(`Disconnected (code=${event.code})`);
+            // Only handle close for the CURRENT socket. If this.ws has been
+            // replaced by a newer connection (or set to null during replacement),
+            // this is a stale socket and we must NOT reconnect.
+            if (ws !== this.ws) {
+                this.opts.log?.("Stale socket closed — ignoring (newer connection exists)");
+                return;
+            }
             this._clearTimers();
             this.opts.onDisconnect?.();
-            if (!this.stopped) {
-                this._scheduleReconnect();
+            if (this.stopped)
+                return;
+            if (NO_RECONNECT_CODES.has(event.code)) {
+                this.opts.log?.(`Not reconnecting (code=${event.code}: ${event.reason})`);
+                this.stopped = true;
+                return;
+            }
+            if (this.reconnectAttempt >= MAX_RECONNECT_ATTEMPTS) {
+                this.opts.log?.(`Max reconnect attempts (${MAX_RECONNECT_ATTEMPTS}) reached — giving up`);
+                this.stopped = true;
+                return;
             }
+            this._scheduleReconnect();
         };
         ws.onerror = (event) => {
             this.opts.log?.(`WebSocket error`);
         };
     }
     _handleMessage(data) {
+        // Connection is stable — reset backoff counter
+        this.reconnectAttempt = 0;
         // Check if this is a response to a pending request
         const id = data.id;
         if (id && this.pendingRequests.has(id)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emotion-machine/claw-messenger",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "iMessage, RCS & SMS channel plugin for OpenClaw — no phone or Mac Mini required",
   "type": "module",
   "main": "dist/index.js",
@@ -50,10 +50,12 @@
   },
   "dependencies": {
     "@sinclair/typebox": "^0.34.48",
+    "ws": "^8.18.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",
+    "@types/ws": "^8.5.0",
     "typescript": "^5.5.0"
   },
   "engines": {