@cloudrise/openclaw-channel-rocketchat 0.1.14 → 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.14",
+  "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

@@ -245,7 +245,7 @@ export type RocketChatUploadResult = {
  * Upload a file to a Rocket.Chat room.
  * RC 8.x uses a two-step process:
  *   1. POST /api/v1/rooms.media/{roomId} → returns file._id
- *   2. POST /api/v1/chat.sendMessage with file reference
+ *   2. POST /api/v1/rooms.mediaConfirm/{roomId}/{fileId} → creates displayable message
  */
 export async function uploadRocketChatFile(
   client: RocketChatClient,
@@ -300,39 +300,68 @@ export async function uploadRocketChatFile(
     throw new Error("Rocket.Chat media upload failed: no file ID returned");
   }
   
-  // Step 2: Send message with file reference
-  const messagePayload = {
-    message: {
-      rid: opts.roomId,
-      msg: opts.description ?? "",
-      file: { _id: uploadData.file._id },
-      ...(opts.tmid && { tmid: opts.tmid }),
-    },
-  };
+  // Step 2: Confirm media upload (generates thumbnail, dimensions, etc.)
+  const confirmUrl = `${client.baseUrl}/api/v1/rooms.mediaConfirm/${opts.roomId}/${uploadData.file._id}`;
+  
+  const confirmPayload: Record<string, string> = {};
+  if (opts.description) confirmPayload.msg = opts.description;
+  if (opts.tmid) confirmPayload.tmid = opts.tmid;
   
-  const sendRes = await client.fetch(`${client.baseUrl}/api/v1/chat.sendMessage`, {
+  const confirmRes = await client.fetch(confirmUrl, {
     method: "POST",
     headers: {
       "X-Auth-Token": client.authToken,
       "X-User-Id": client.userId,
       "Content-Type": "application/json",
     },
-    body: JSON.stringify(messagePayload),
+    body: JSON.stringify(confirmPayload),
   });
   
-  if (!sendRes.ok) {
-    const text = await sendRes.text().catch(() => "");
-    throw new Error(`Rocket.Chat send message error ${sendRes.status}: ${text}`);
+  if (!confirmRes.ok) {
+    const text = await confirmRes.text().catch(() => "");
+    throw new Error(`Rocket.Chat media confirm error ${confirmRes.status}: ${text}`);
   }
   
-  const sendData = await sendRes.json() as { 
+  const confirmData = await confirmRes.json() as { 
     message: { _id: string; rid: string; ts: string }; 
     success: boolean 
   };
   
   return {
-    _id: sendData.message._id,
-    rid: sendData.message.rid,
-    ts: sendData.message.ts,
+    _id: confirmData.message._id,
+    rid: confirmData.message.rid,
+    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",
+  });
+}