@cfio/cohort-sync 0.31.11 → 0.31.13

package/dist/index.js

@@ -11999,6 +11999,8 @@ var acknowledgeCommandRef = makeFunctionReference("gatewayCommands:acknowledgeCo
 var failCommandRef = makeFunctionReference("gatewayCommands:failCommand");
 var getChannelsForPlugin = makeFunctionReference("cloudGatewayChannels:listForPlugin");
 var addCommentFromPluginRef = makeFunctionReference("comments:addCommentFromPlugin");
+var addRoomMessageFromPluginRef = makeFunctionReference("rooms:addMessageFromPlugin");
+var promptAgentsFromPluginRef = makeFunctionReference("rooms:promptAgentsFromPlugin");
 var transitionFromPluginRef = makeFunctionReference("tasks:transitionFromPlugin");
 async function pushTelemetry(apiKey2, data) {
   if (authCircuitOpen) return;
@@ -12102,6 +12104,55 @@ async function callAddCommentFromPlugin(apiKey2, args) {
     throw err;
   }
 }
+async function callAddRoomMessageFromPlugin(apiKey2, args) {
+  if (authCircuitOpen) {
+    throw new Error(
+      'cohort-sync: API key rejected \u2014 all outbound mutations disabled until gateway restart.\n  1. Create a new key at https://my.cohort.bot/settings/api-keys\n  2. Run: openclaw config set plugins.entries.cohort-sync.config.apiKey "ch_live_..."'
+    );
+  }
+  const c = getClient();
+  if (!c) {
+    throw new Error("Convex client not initialized \u2014 subscription may not be active");
+  }
+  try {
+    return await c.mutation(addRoomMessageFromPluginRef, {
+      apiKeyHash: hashApiKey(apiKey2),
+      roomId: args.roomId,
+      agentName: args.agentName,
+      body: args.content
+    });
+  } catch (err) {
+    if (isUnauthorizedError(err)) {
+      tripAuthCircuit();
+    }
+    throw err;
+  }
+}
+async function callPromptRoomAgentsFromPlugin(apiKey2, args) {
+  if (authCircuitOpen) {
+    throw new Error(
+      'cohort-sync: API key rejected \u2014 all outbound mutations disabled until gateway restart.\n  1. Create a new key at https://my.cohort.bot/settings/api-keys\n  2. Run: openclaw config set plugins.entries.cohort-sync.config.apiKey "ch_live_..."'
+    );
+  }
+  const c = getClient();
+  if (!c) {
+    throw new Error("Convex client not initialized \u2014 subscription may not be active");
+  }
+  try {
+    return await c.mutation(promptAgentsFromPluginRef, {
+      apiKeyHash: hashApiKey(apiKey2),
+      roomId: args.roomId,
+      moderatorAgentName: args.moderatorAgentName,
+      targetAgentNames: args.targetAgentNames,
+      prompt: args.prompt
+    });
+  } catch (err) {
+    if (isUnauthorizedError(err)) {
+      tripAuthCircuit();
+    }
+    throw err;
+  }
+}
 async function callTransitionFromPlugin(apiKey2, args) {
   if (authCircuitOpen) {
     throw new Error(
@@ -12142,6 +12193,7 @@ var ATMENTION_RESPONSE_PROMPT = `YOU WERE DIRECTLY @-MENTIONED. RESPOND.
 var TOOLS_REFERENCE = `
 TOOLS: Use these \u2014 do NOT call the REST API directly.
 - cohort_comment(task_number, comment) \u2014 post a comment
+- cohort_room_message(room_id, message) \u2014 post a message in a Cohort Room
 - cohort_task(task_number) \u2014 fetch full task details + comments
 - cohort_transition(task_number, status) \u2014 change status
 - cohort_assign(task_number, assignee) \u2014 assign/unassign
@@ -12153,6 +12205,11 @@ function buildNotificationMessage(n) {
   let header;
   let cta;
   switch (n.type) {
+    case "room_message":
+      header = `New message in Room "${n.roomName ?? n.roomId ?? "Room"}"
+From: ${n.actorName}`;
+      cta = `Reply in the Room if you can help. Use the cohort_room_message tool (roomId: ${n.roomId ?? "unknown"}).`;
+      break;
     case "comment":
       if (n.isMentioned) {
         header = `You were @mentioned on task #${n.taskNumber} "${n.taskTitle}"
@@ -12181,7 +12238,7 @@ From: ${n.actorName}`;
   }
   let body = "";
   if (n.preview) {
-    if (n.type === "comment") {
+    if (n.type === "comment" || n.type === "room_message") {
       const safe = sanitizePreview(n.preview);
       body = `
 <user_comment>
@@ -12200,7 +12257,7 @@ Comment: "${n.preview}"`;
 Scope: ${truncated}`;
   }
   let prompt;
-  if (n.type === "comment" && n.isMentioned) {
+  if (n.type === "comment" && n.isMentioned || n.type === "room_message") {
     prompt = n.behavioralPrompt ? `${n.behavioralPrompt}
 
 ${ATMENTION_RESPONSE_PROMPT}` : ATMENTION_RESPONSE_PROMPT;
@@ -12209,7 +12266,7 @@ ${ATMENTION_RESPONSE_PROMPT}` : ATMENTION_RESPONSE_PROMPT;
 
 ${DEFAULT_BEHAVIORAL_PROMPT}` : DEFAULT_BEHAVIORAL_PROMPT;
   }
-  const promptBlock = n.type === "comment" ? `
+  const promptBlock = n.type === "comment" || n.type === "room_message" ? `
 
 ---
 ${prompt}` : "";
@@ -12218,6 +12275,7 @@ ${prompt}` : "";
 ${cta}${promptBlock}${TOOLS_REFERENCE}`;
 }
 async function injectNotification(port, hooksToken, n, agentId = "main") {
+  const sessionKey = n.type === "room_message" && n.roomId ? `hook:cohort:room-${n.roomId}` : `hook:cohort:task-${n.taskNumber}`;
   const response = await fetch(`http://localhost:${port}/hooks/agent`, {
     method: "POST",
     headers: {
@@ -12229,7 +12287,7 @@ async function injectNotification(port, hooksToken, n, agentId = "main") {
       name: "Cohort",
       agentId,
       deliver: false,
-      sessionKey: `hook:cohort:task-${n.taskNumber}`
+      sessionKey
     }),
     signal: AbortSignal.timeout(1e4)
   });
@@ -12317,7 +12375,8 @@ async function startNotificationSubscription(port, cfg, hooksToken, logger, gwCl
             try {
               if (hooksToken) {
                 await injectNotification(port, hooksToken, n, openclawAgentId);
-                logger.info(`cohort-sync: injected notification for task #${n.taskNumber} (${agentName})`);
+                const targetLabel = n.type === "room_message" ? `room ${n.roomId ?? n.roomName ?? "unknown"}` : `task #${n.taskNumber}`;
+                logger.info(`cohort-sync: injected notification for ${targetLabel} (${agentName})`);
               } else {
                 throw new Error(
                   `no transport available for notification ${n._id} (gwClient alive: ${gwClient?.isAlive() ?? "null"}, hooksToken: ${!!hooksToken})`
@@ -12332,8 +12391,9 @@ async function startNotificationSubscription(port, cfg, hooksToken, logger, gwCl
               const newFailCount = failCount + 1;
               deliveryFailures.set(n._id, newFailCount);
               if (newFailCount >= MAX_DELIVERY_ATTEMPTS) {
+                const targetLabel = n.type === "room_message" ? `room ${n.roomId ?? n.roomName ?? "unknown"}` : `task #${n.taskNumber}`;
                 logger.error(
-                  `cohort-sync: dead-letter notification ${n._id} for task #${n.taskNumber} (${n.type} from ${n.actorName}) after ${MAX_DELIVERY_ATTEMPTS} failed delivery attempts: ${String(err)}`
+                  `cohort-sync: dead-letter notification ${n._id} for ${targetLabel} (${n.type} from ${n.actorName}) after ${MAX_DELIVERY_ATTEMPTS} failed delivery attempts: ${String(err)}`
                 );
                 try {
                   await c.mutation(markDeliveredByPlugin, {
@@ -13741,7 +13801,7 @@ function dumpEvent(event) {
 function positiveNumber(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
 }
-var PLUGIN_VERSION = true ? "0.31.11" : "unknown";
+var PLUGIN_VERSION = true ? "0.31.13" : "unknown";
 function resolveGatewayToken(api) {
   const token2 = api.config?.gateway?.auth?.token;
   return typeof token2 === "string" ? token2 : null;
@@ -14871,6 +14931,87 @@ Do not attempt more comments until tomorrow.`);
         }
       };
     });
+    api.registerTool((toolCtx) => {
+      const agentId = toolCtx.agentId ?? "main";
+      return {
+        name: "cohort_room_message",
+        label: "cohort_room_message",
+        description: "Post a message in a Cohort Room. Use this to reply when you are participating in a Room chat.",
+        parameters: Type.Object({
+          room_id: Type.String({ description: "Room ID supplied by Cohort, e.g. rooms:abc123" }),
+          message: Type.String({ description: "Message text to post in the Room" })
+        }),
+        async execute(_toolCallId, params) {
+          const rt = getToolRuntime();
+          if (!rt.isReady) {
+            return textResult("cohort_room_message is not ready yet \u2014 the plugin is still starting up. Try again in a few seconds.");
+          }
+          const agentName = rt.resolveAgentName(agentId);
+          const result = await callAddRoomMessageFromPlugin(rt.apiKey, {
+            roomId: params.room_id,
+            agentName,
+            content: params.message
+          });
+          return textResult(`Message posted to Room ${params.room_id}.`, result);
+        }
+      };
+    });
+    api.registerTool((toolCtx) => {
+      const agentId = toolCtx.agentId ?? "main";
+      return {
+        name: "cohort_room_prompt_agent",
+        label: "cohort_room_prompt_agent",
+        description: "Ask one agent in a Cohort Room to respond. Use this when you are the Room moderator and need controlled turn-taking.",
+        parameters: Type.Object({
+          room_id: Type.String({ description: "Room ID supplied by Cohort, e.g. rooms:abc123" }),
+          agent_name: Type.String({ description: "Cohort agent name to prompt, e.g. iris" }),
+          prompt: Type.String({ description: "Prompt to send to the target agent" })
+        }),
+        async execute(_toolCallId, params) {
+          const rt = getToolRuntime();
+          if (!rt.isReady) {
+            return textResult("cohort_room_prompt_agent is not ready yet \u2014 the plugin is still starting up. Try again in a few seconds.");
+          }
+          const moderatorAgentName = rt.resolveAgentName(agentId);
+          const result = await callPromptRoomAgentsFromPlugin(rt.apiKey, {
+            roomId: params.room_id,
+            moderatorAgentName,
+            targetAgentNames: [params.agent_name],
+            prompt: params.prompt
+          });
+          const noun = result.notificationCount === 1 ? "agent" : "agents";
+          return textResult(`Prompt sent to ${result.notificationCount} Room ${noun}.`, result);
+        }
+      };
+    });
+    api.registerTool((toolCtx) => {
+      const agentId = toolCtx.agentId ?? "main";
+      return {
+        name: "cohort_room_prompt_agents",
+        label: "cohort_room_prompt_agents",
+        description: "Ask multiple agents in a Cohort Room to respond in one controlled moderator action.",
+        parameters: Type.Object({
+          room_id: Type.String({ description: "Room ID supplied by Cohort, e.g. rooms:abc123" }),
+          agent_names: Type.Array(Type.String({ description: "Cohort agent name to prompt" })),
+          prompt: Type.String({ description: "Prompt to send to the target agents" })
+        }),
+        async execute(_toolCallId, params) {
+          const rt = getToolRuntime();
+          if (!rt.isReady) {
+            return textResult("cohort_room_prompt_agents is not ready yet \u2014 the plugin is still starting up. Try again in a few seconds.");
+          }
+          const moderatorAgentName = rt.resolveAgentName(agentId);
+          const result = await callPromptRoomAgentsFromPlugin(rt.apiKey, {
+            roomId: params.room_id,
+            moderatorAgentName,
+            targetAgentNames: params.agent_names,
+            prompt: params.prompt
+          });
+          const noun = result.notificationCount === 1 ? "agent" : "agents";
+          return textResult(`Prompt sent to ${result.notificationCount} Room ${noun}.`, result);
+        }
+      };
+    });
     api.registerTool(() => {
       return {
         name: "cohort_context",

package/dist/openclaw.plugin.json

@@ -11,6 +11,9 @@
   "contracts": {
     "tools": [
       "cohort_comment",
+      "cohort_room_message",
+      "cohort_room_prompt_agent",
+      "cohort_room_prompt_agents",
       "cohort_context",
       "cohort_briefing_context",
       "cohort_briefing",
@@ -74,5 +77,5 @@
       }
     }
   },
-  "version": "0.31.11"
+  "version": "0.31.13"
 }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfio/cohort-sync",
-  "version": "0.31.11",
+  "version": "0.31.13",
   "description": "OpenClaw plugin — syncs agent telemetry, sessions, and activity to the Cohort dashboard",
   "type": "module",
   "main": "index.js",

package/openclaw.plugin.json

@@ -9,6 +9,9 @@
   "contracts": {
     "tools": [
       "cohort_comment",
+      "cohort_room_message",
+      "cohort_room_prompt_agent",
+      "cohort_room_prompt_agents",
       "cohort_context",
       "cohort_briefing_context",
       "cohort_briefing",
@@ -72,5 +75,5 @@
       }
     }
   },
-  "version": "0.9.2"
+  "version": "0.9.3"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfio/cohort-sync",
-  "version": "0.31.11",
+  "version": "0.31.13",
   "description": "OpenClaw plugin — syncs agent telemetry, sessions, and activity to the Cohort dashboard",
   "license": "MIT",
   "homepage": "https://docs.cohort.bot/gateway",
@@ -37,7 +37,7 @@
   },
   "devDependencies": {
     "esbuild": "^0.25.11",
-    "vitest": "^2.1.9"
+    "vitest": "^3.2.6"
   },
   "peerDependencies": {
     "openclaw": ">=0.1.0"