@emotion-machine/claw-messenger 0.1.2 → 0.1.3

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",
@@ -145,6 +158,7 @@ export const clawMessengerPlugin = {
             "Use reactions naturally — the way a real person would in iMessage.",
         ],
     },
+    // Legacy API (OpenClaw <2026.3.22): kept for backward compatibility
     actions: {
         listActions: () => ["send", "react"],
         handleAction: async ({ action, params, cfg }) => {
@@ -373,6 +387,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emotion-machine/claw-messenger",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "iMessage, RCS & SMS channel plugin for OpenClaw — no phone or Mac Mini required",
   "type": "module",
   "main": "dist/index.js",