@emotion-machine/claw-messenger 0.1.15 → 0.1.17

package/README.md

@@ -30,7 +30,7 @@ After installing, add to your config under `channels`:
 ## Features
 
 - **Send & receive** text messages and media (images, video, audio, documents)
-- **iMessage reactions** — love, like, dislike, laugh, emphasize, question (tapback)
+- **iMessage reactions** — six standard tapbacks plus any single Unicode emoji
 - **Group chats** — send to existing groups or create new ones
 - **Typing indicators** — sent and received
 - **DM security policies** — open, pairing-based approval, or allowlist

package/dist/channel.js

@@ -2,19 +2,9 @@ import { DEFAULT_ACCOUNT_ID as OPENCLAW_DEFAULT_ACCOUNT_ID, PAIRING_APPROVED_MES
 import { ClawMessengerConfigSchema } from "./config.js";
 import { isInboundMessageEvent, normalizeInboundMessage, validateInboundRoute, } from "./inbound.js";
 import { getRuntime } from "./runtime.js";
+import { sendReaction } from "./reactions.js";
 import { WsClient } from "./ws/client.js";
 import { normalizeDirectTarget, sendText, sendMedia, sendToGroup, sendGroupMedia, sendToNewGroup, } from "./outbound/send.js";
-const EMOJI_TO_REACTION = {
-    "❤️": "love", "♥️": "love", "🩷": "love", "💕": "love", "😍": "love",
-    "👍": "like", "👍🏻": "like", "👍🏼": "like", "👍🏽": "like", "👍🏾": "like", "👍🏿": "like",
-    "👎": "dislike", "👎🏻": "dislike", "👎🏼": "dislike", "👎🏽": "dislike", "👎🏾": "dislike", "👎🏿": "dislike",
-    "😂": "laugh", "🤣": "laugh", "😆": "laugh",
-    "‼️": "emphasize", "❗": "emphasize", "❕": "emphasize", "⚡": "emphasize",
-    "❓": "question", "❔": "question", "🤔": "question",
-};
-function emojiToReaction(emoji) {
-    return EMOJI_TO_REACTION[emoji];
-}
 // -- Account resolution --
 const FALLBACK_ACCOUNT_ID = "default";
 function hasAccountId(value) {
@@ -192,7 +182,7 @@ export const clawMessengerPlugin = {
     },
     agentPrompt: {
         messageToolHints: () => [
-            "You can react to messages using iMessage tapbacks via the react action. Available: love (❤️), like (👍), dislike (👎), laugh (😂), emphasize (‼️), question (❓).",
+            "You can react to messages via the react action. The six iMessage tapbacks are love (❤️), like (👍), dislike (👎), laugh (😂), emphasize (‼️), and question (❓). Any other single Unicode emoji is sent as a custom reaction.",
             "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",
             "If a user is stuck connecting, the fix is almost always: make sure the Claw Messenger plugin is enabled and the API key is set. Verified setup guides to hand them: OpenClaw setup https://www.clawmessenger.com/blog/openclaw-imessage-setup-guide, Hermes setup https://www.clawmessenger.com/blog/hermes-imessage-setup, troubleshooting https://www.clawmessenger.com/blog/openclaw-imessage-troubleshooting.",
@@ -211,17 +201,14 @@ export const clawMessengerPlugin = {
                 const messageId = params.messageId;
                 if (!messageId)
                     throw new Error("messageId is required for react action");
-                const emoji = params.emoji?.trim() ?? "❤️";
+                const emoji = params.emoji?.trim() || "❤️";
                 const remove = params.remove === true;
-                const reactionType = emojiToReaction(emoji) ?? "love";
-                ws.send({
-                    type: "reaction",
-                    messageId,
-                    reactionType,
-                    remove,
-                });
+                const result = await sendReaction(ws, messageId, emoji, remove);
+                const reaction = result.reactionType === "custom"
+                    ? result.emoji
+                    : result.reactionType;
                 return {
-                    content: [{ type: "text", text: JSON.stringify({ ok: true, action: remove ? "removed" : "added", reaction: reactionType }) }],
+                    content: [{ type: "text", text: JSON.stringify({ ok: true, action: remove ? "removed" : "added", reaction }) }],
                 };
             }
             if (action === "send") {

package/dist/reactions.d.ts

@@ -0,0 +1,21 @@
+export type StandardReactionType = "love" | "like" | "dislike" | "laugh" | "emphasize" | "question";
+export type ReactionType = StandardReactionType | "custom";
+export interface ReactionResult {
+    type: "reaction.result";
+    id?: string;
+    ok: boolean;
+    messageId?: string;
+    reactionType?: ReactionType;
+    emoji?: string;
+    remove?: boolean;
+    error?: string;
+    errorCode?: string;
+    retryable?: boolean;
+}
+interface ReactionWsClient {
+    request(message: Record<string, unknown>): Promise<Record<string, unknown>>;
+}
+export declare function isSingleEmoji(value: string): boolean;
+export declare function reactionFrame(messageId: string, rawEmoji: string, remove?: boolean): Record<string, unknown>;
+export declare function sendReaction(ws: ReactionWsClient, messageId: string, emoji: string, remove?: boolean): Promise<ReactionResult>;
+export {};

package/dist/reactions.js

@@ -0,0 +1,68 @@
+const STANDARD_EMOJI_TO_REACTION = {
+    "❤": "love",
+    "❤️": "love",
+    "♥️": "love",
+    "🩷": "love",
+    "💕": "love",
+    "😍": "love",
+    "👍": "like",
+    "👍🏻": "like",
+    "👍🏼": "like",
+    "👍🏽": "like",
+    "👍🏾": "like",
+    "👍🏿": "like",
+    "👎": "dislike",
+    "👎🏻": "dislike",
+    "👎🏼": "dislike",
+    "👎🏽": "dislike",
+    "👎🏾": "dislike",
+    "👎🏿": "dislike",
+    "😂": "laugh",
+    "🤣": "laugh",
+    "😆": "laugh",
+    "‼": "emphasize",
+    "‼️": "emphasize",
+    "❗": "emphasize",
+    "❕": "emphasize",
+    "⚡": "emphasize",
+    "❓": "question",
+    "❔": "question",
+    "🤔": "question",
+};
+export function isSingleEmoji(value) {
+    if (!value || value !== value.trim() || value.length > 64)
+        return false;
+    const segments = Array.from(new Intl.Segmenter(undefined, { granularity: "grapheme" }).segment(value));
+    if (segments.length !== 1)
+        return false;
+    return (/\p{Extended_Pictographic}/u.test(value)
+        || /^\p{Regional_Indicator}{2}$/u.test(value)
+        || /^[#*0-9]\uFE0F?\u20E3$/u.test(value));
+}
+export function reactionFrame(messageId, rawEmoji, remove = false) {
+    const normalizedMessageId = messageId?.trim();
+    if (!normalizedMessageId)
+        throw new Error("messageId is required for react action");
+    const emoji = rawEmoji?.trim();
+    if (!isSingleEmoji(emoji)) {
+        throw new Error("emoji must contain exactly one Unicode emoji");
+    }
+    const standardReaction = STANDARD_EMOJI_TO_REACTION[emoji];
+    return {
+        type: "reaction",
+        messageId: normalizedMessageId,
+        reactionType: standardReaction ?? "custom",
+        ...(standardReaction ? {} : { emoji }),
+        remove,
+    };
+}
+export async function sendReaction(ws, messageId, emoji, remove = false) {
+    const response = await ws.request(reactionFrame(messageId, emoji, remove));
+    if (response.type !== "reaction.result") {
+        throw new Error("Claw Messenger returned an invalid reaction response");
+    }
+    if (response.ok !== true) {
+        throw new Error(typeof response.error === "string" ? response.error : "Reaction request failed");
+    }
+    return response;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@emotion-machine/claw-messenger",
-  "version": "0.1.15",
-  "description": "iMessage, RCS & SMS channel plugin for OpenClaw agents, powered by Claw Messenger, the Mac-free iMessage API for AI agents. Send and receive real texts from Linux, Docker, Windows, or any cloud. No phone or Mac required.",
+  "version": "0.1.17",
+  "description": "OpenClaw channel plugin for Claw Messenger, a managed, Mac-free iMessage, RCS, and SMS API for AI agents.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",