@cloudrise/openclaw-channel-rocketchat 0.1.15 → 0.1.16

package/README.md

@@ -145,6 +145,10 @@ Then restart the gateway.
 
 ## Features
 
+- **Inbound attachments**: receives images, PDFs/documents, and audio; forwards them to OpenClaw for vision/document understanding and transcription.
+- **Outbound attachments**: can send local file paths as real Rocket.Chat uploads (inline previews when supported).
+- **Reactions**: can react to messages with emoji (via `chat.react`).
+
 - **File attachments**: receives images, PDFs, documents, audio uploaded to Rocket.Chat and passes them to the vision model.
 - **Model prefix**: honors `messages.responsePrefix` (e.g. `({model}) `) so replies can include the model name.
 
@@ -335,4 +339,4 @@ This repository is intended to be publishable (no secrets committed).
 
 ## License
 
-MIT
+MIT

package/index.ts

@@ -11,6 +11,9 @@ import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
 import { rocketChatPlugin } from "./src/channel.js";
 import { setRocketChatRuntime } from "./src/runtime.js";
 
+// Re-export send/react functions for OpenClaw message tool
+export { reactMessageRocketChat, sendMessageRocketChat } from "./src/rocketchat/send.js";
+
 const plugin = {
   id: "rocketchat",
   name: "Rocket.Chat",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudrise/openclaw-channel-rocketchat",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Rocket.Chat channel plugin for OpenClaw (Cloudrise)",
   "license": "MIT",
   "type": "module",

package/src/channel.ts

@@ -15,7 +15,7 @@ import {
 } from "./rocketchat/accounts.js";
 import { normalizeRocketChatBaseUrl } from "./rocketchat/client.js";
 import { monitorRocketChatProvider } from "./rocketchat/monitor.js";
-import { sendMessageRocketChat } from "./rocketchat/send.js";
+import { reactMessageRocketChat, sendMessageRocketChat } from "./rocketchat/send.js";
 import { getRocketChatRuntime } from "./runtime.js";
 
 const meta = {

package/src/rocketchat/client.ts

@@ -333,3 +333,35 @@ export async function uploadRocketChatFile(
     ts: confirmData.message.ts,
   };
 }
+
+/**
+ * React to a message with an emoji.
+ * @param emoji - Emoji name (e.g., "thumbsup", ":rocket:", or unicode "🚀")
+ * @param shouldReact - true to add reaction, false to remove (default: true)
+ */
+export async function reactRocketChatMessage(
+  client: RocketChatClient,
+  messageId: string,
+  emoji: string,
+  shouldReact = true
+): Promise<void> {
+  // Normalize emoji format - RC accepts "thumbsup", ":thumbsup:", or unicode
+  const normalizedEmoji = emoji.startsWith(":") ? emoji : `:${emoji.replace(/:/g, "")}:`;
+  
+  const res = await rcFetch<{ success: boolean }>(
+    client,
+    "/api/v1/chat.react",
+    {
+      method: "POST",
+      body: JSON.stringify({
+        messageId,
+        emoji: normalizedEmoji,
+        shouldReact,
+      }),
+    }
+  );
+  
+  if (!res.success) {
+    throw new Error("Rocket.Chat reaction failed");
+  }
+}

package/src/rocketchat/send.ts

@@ -13,6 +13,7 @@ import {
   fetchRocketChatUserByUsername,
   normalizeRocketChatBaseUrl,
   postRocketChatMessage,
+  reactRocketChatMessage,
   uploadRocketChatFile,
   type RocketChatUser,
 } from "./client.js";
@@ -261,3 +262,58 @@ export async function sendMessageRocketChat(
     roomId: post.rid ?? roomId,
   };
 }
+
+export type RocketChatReactOpts = {
+  accountId?: string;
+  shouldReact?: boolean;
+};
+
+/**
+ * React to a Rocket.Chat message with an emoji.
+ * @param messageId - The message ID to react to
+ * @param emoji - Emoji name (e.g., "thumbsup", ":rocket:", "🚀")
+ */
+export async function reactMessageRocketChat(
+  messageId: string,
+  emoji: string,
+  opts: RocketChatReactOpts = {}
+): Promise<void> {
+  const core = getRocketChatRuntime();
+  const logger = core?.logging?.getChildLogger?.({ module: "rocketchat" });
+  const cfg = core?.config?.loadConfig?.() ?? {};
+
+  const account = resolveRocketChatAccount({ cfg, accountId: opts.accountId });
+
+  const authToken = account.authToken?.trim();
+  if (!authToken) {
+    throw new Error(
+      `Rocket.Chat authToken missing for account "${account.accountId}"`
+    );
+  }
+
+  const userId = account.userId?.trim();
+  if (!userId) {
+    throw new Error(
+      `Rocket.Chat userId missing for account "${account.accountId}"`
+    );
+  }
+
+  const baseUrl = normalizeRocketChatBaseUrl(account.baseUrl);
+  if (!baseUrl) {
+    throw new Error(
+      `Rocket.Chat baseUrl missing for account "${account.accountId}"`
+    );
+  }
+
+  const client = createRocketChatClient({ baseUrl, userId, authToken });
+
+  logger?.debug?.(`Reacting to message ${messageId} with ${emoji}`);
+
+  await reactRocketChatMessage(client, messageId, emoji, opts.shouldReact ?? true);
+
+  core?.channel?.activity?.record?.({
+    channel: "rocketchat",
+    accountId: account.accountId,
+    direction: "outbound",
+  });
+}