@emotion-machine/claw-messenger 0.1.2 → 0.1.5

package/README.md

@@ -10,7 +10,7 @@ openclaw plugins install @emotion-machine/claw-messenger
 
 ## Configuration
 
-After installing, add to your OpenClaw config under `channels`:
+After installing, add to your config under `channels`:
 
 ```json5
 {
@@ -61,4 +61,4 @@ The plugin registers two tools your agent can call:
 
 ## License
 
-UNLICENSED
+UNLICENSED

package/dist/channel.d.ts

@@ -14,5 +14,10 @@ export declare function getConnectionStatus(): {
     preferredService: string;
     accountId: string;
 };
+export declare function createGroup(to: string[], text: string): Promise<{
+    ok: boolean;
+    messageId: string;
+    chatId: string;
+}>;
 export declare const clawMessengerPlugin: ChannelPlugin<ResolvedAccount>;
 export {};

package/dist/channel.js

@@ -41,6 +41,19 @@ export function getConnectionStatus() {
         accountId: account.accountId,
     };
 }
+export async function createGroup(to, text) {
+    const runtime = getRuntime();
+    const cfg = runtime.config.loadConfig();
+    const account = resolveAccount(cfg);
+    const ws = wsClients.get(account.accountId);
+    if (!ws)
+        throw new Error("Not connected to claw-messenger");
+    if (!Array.isArray(to) || to.length < 2) {
+        throw new Error("Group requires at least 2 recipients");
+    }
+    const result = await sendToNewGroup(ws, to, text, account.preferredService);
+    return { ok: true, ...result };
+}
 // -- Channel Plugin --
 const meta = {
     label: "Claw Messenger",
@@ -143,8 +156,10 @@ 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
     actions: {
         listActions: () => ["send", "react"],
         handleAction: async ({ action, params, cfg }) => {
@@ -373,6 +388,19 @@ export const clawMessengerPlugin = {
         },
     },
 };
+// OpenClaw 2026.3.22+ message-action-discovery API.
+// Added as a runtime property because the ChannelPlugin type from older SDK
+// versions doesn't include it. Newer OpenClaw calls this; older versions ignore it.
+clawMessengerPlugin.describeMessageTool = (cfg) => {
+    const account = resolveAccount(cfg);
+    const ws = wsClients.get(account.accountId);
+    const connected = Boolean(ws?.connected);
+    return {
+        actions: connected ? ["send", "react"] : [],
+        capabilities: [],
+        schema: null,
+    };
+};
 // -- Inbound message handler --
 async function handleInboundMessage(data, accountId, account, ctx) {
     const from = data.from;

package/dist/index.js

@@ -1,6 +1,6 @@
 import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
 import { Type } from "@sinclair/typebox";
-import { clawMessengerPlugin, getConnectionStatus } from "./channel.js";
+import { clawMessengerPlugin, getConnectionStatus, createGroup } from "./channel.js";
 import { setRuntime, getRuntime } from "./runtime.js";
 const VALID_SERVICES = ["iMessage", "RCS", "SMS"];
 const plugin = {
@@ -56,6 +56,32 @@ const plugin = {
                 };
             },
         });
+        api.registerTool({
+            name: "claw_messenger_create_group",
+            label: "Create iMessage/RCS/SMS Group",
+            description: "Create a new group chat and send the first message. Pass an array of E.164 phone numbers (at least 2) and the initial message text. Returns the chatId to use for future messages to this group.",
+            parameters: Type.Object({
+                to: Type.Array(Type.String(), {
+                    description: "Array of E.164 phone numbers (e.g. [\"+12125551234\", \"+14155559876\"])",
+                    minItems: 2,
+                }),
+                text: Type.String({ description: "The initial message to send to the group" }),
+            }),
+            async execute(_toolCallId, params) {
+                const { to, text } = params;
+                try {
+                    const result = await createGroup(to, text);
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(result) }],
+                    };
+                }
+                catch (err) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({ ok: false, error: err.message }) }],
+                    };
+                }
+            },
+        });
         // -- Auto-Reply Commands --
         api.registerCommand({
             name: "cm-status",

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;
@@ -87,7 +98,9 @@ export class WsClient {
         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
@@ -108,15 +121,27 @@ export class WsClient {
             this.opts.log?.(`Disconnected (code=${event.code})`);
             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.2",
+  "version": "0.1.5",
   "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": {