@cfio/cohort-sync 0.32.0 → 0.32.1

package/dist/index.js

@@ -12279,18 +12279,19 @@ var ATMENTION_RESPONSE_PROMPT = `YOU WERE DIRECTLY @-MENTIONED. RESPOND.
 - Do not stop because Vercel CLI is not authenticated; Cohort deploys through GitHub Actions after merge.`;
 var ROOM_MESSAGE_RESPONSE_PROMPT = `YOU WERE DIRECTLY ASKED IN A COHORT ROOM. RESPOND.
 
-- If you are the Room moderator and a human asks for a roundtable, standup, report-in, or panel response, FIRST use cohort_room_start_moderation_session(room_id, mode, objective, participant_names) to run it as a managed session, then drive it with cohort_room_advance_moderation_session; do not only name agents in prose.
+- If you are the Room moderator and a human asks for a question to be routed, FIRST use cohort_room_start_moderation_session with mode: "moderated_qna", one best participant, and question_text; use cohort_room_advance_moderation_session(action: "followup") for additional experts one at a time, then confirm with the asker before complete.
+- If you are the Room moderator and a human asks for a roundtable, standup, report-in, or panel response, FIRST use cohort_room_start_moderation_session with mode: "round_robin" to run it as a managed session, then drive it with cohort_room_advance_moderation_session; do not only name agents in prose.
 - Otherwise, use the cohort_room_message tool to post a reply in the Room. Do NOT just think silently and exit.
 - Reply in your own voice (see your persona in IDENTITY.md).
-- If the human asks for a roundtable, standup, report-in, or panel response, contribute your own concise update.
+- If the human asks for an answer, answer it. If the human asks for a roundtable, standup, report-in, or panel response, contribute your own concise update.
 - If the moderator asks you to answer, answer. If another agent asks for your report, provide it. If your prompt includes a turn_id, echo it in cohort_room_message.
 - A brief, honest reply is better than no reply. If you genuinely have nothing to add, say so explicitly in the Room \u2014 don't go silent.`;
 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, turn_id?) \u2014 post a message in a Cohort Room; pass turn_id when your prompt included one so the reply is attributed to that moderation turn
-- cohort_room_start_moderation_session(room_id, mode, objective, participant_names) \u2014 moderator only: start a managed round robin or Q&A session
-- cohort_room_advance_moderation_session(session_id, action, ...) \u2014 moderator only: advance, retry, skip, accept, followup, or complete the session
+- cohort_room_start_moderation_session(room_id, mode, objective, participant_names) \u2014 moderator only: start a managed session; round_robin = ask every participant to report in, moderated_qna = route a question to one selected agent
+- cohort_room_advance_moderation_session(session_id, action, ...) \u2014 moderator only: advance, retry, skip, accept, followup, or complete the session; followup asks one additional Q&A expert after the first answer
 - cohort_room_cancel_moderation_session(session_id, reason?) \u2014 moderator only: cancel an in-flight session
 - cohort_room_prompt_agent(roomId, agentName, prompt) \u2014 moderator only, low-level: ask one Room agent to respond (prefer moderation sessions for multi-step workflows)
 - cohort_room_prompt_agents(roomId, agentNames, prompt) \u2014 moderator only, low-level: ask multiple Room agents to respond (prefer moderation sessions for multi-step workflows)
@@ -12322,6 +12323,16 @@ var HANDOFF_ACTION_TERMS = [
   "gather",
   "ask"
 ];
+var QUESTION_ROUTING_TERMS = [
+  "question for the team",
+  "route it",
+  "route this",
+  "ask whoever",
+  "whoever's best suited",
+  "whoever is best suited",
+  "who's best suited",
+  "who is best suited"
+];
 function sanitizePreview(raw) {
   return raw.replace(/<\/?user_comment>/gi, "");
 }
@@ -12337,11 +12348,21 @@ function isHumanHandoffRequest(n) {
   const hasAction = HANDOFF_ACTION_TERMS.some((term) => preview.includes(term));
   return hasTopic && hasAction;
 }
+function isHumanQuestionRoutingRequest(n) {
+  if (n.actorType !== "human") {
+    return false;
+  }
+  const preview = (n.preview ?? "").toLowerCase();
+  return QUESTION_ROUTING_TERMS.some((term) => preview.includes(term)) || /\bhave\s+[a-z][a-z0-9_-]*\s+answer\b/.test(preview);
+}
 function roomMessageCta(n) {
   const roomId = n.roomId ?? "unknown";
   if (n.moderationContext != null && renderModerationContext(n.moderationContext) !== "") {
     return "Follow the MODERATION SESSION block in this message \u2014 it is authoritative.";
   }
+  if (isHumanQuestionRoutingRequest(n)) {
+    return `You are moderating a Room Q&A. FIRST use cohort_room_start_moderation_session(room_id: ${roomId}, mode: "moderated_qna", objective: <one-line objective>, participant_names: [<single best agent>], question_text: <the question>) to route the question to one selected expert. If more expertise is needed after the answer, use cohort_room_advance_moderation_session(action: "followup", target_agent_name: <next expert>, prompt: <follow-up question>) for one additional expert at a time (advance(action: "followup")). Then ask the asker whether the answer resolves the question before complete.`;
+  }
   if (isHumanHandoffRequest(n)) {
     return `You are moderating a Room round robin. FIRST use cohort_room_start_moderation_session(room_id: ${roomId}, mode: "round_robin", objective: <one-line objective>, participant_names: [<agents>]) to run it as a managed moderation session. Do NOT only post @agent prose and do NOT hand-roll turn-taking with cohort_room_prompt_agent. The session prompts each participant for you and tells you when to advance; finish with cohort_room_advance_moderation_session(action: "complete") to record the outcomes.`;
   }
@@ -13990,7 +14011,7 @@ function dumpEvent(event) {
 function positiveNumber(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
 }
-var PLUGIN_VERSION = true ? "0.32.0" : "unknown";
+var PLUGIN_VERSION = true ? "0.32.1" : "unknown";
 function resolveGatewayToken(api) {
   const token2 = api.config?.gateway?.auth?.token;
   return typeof token2 === "string" ? token2 : null;
@@ -15208,16 +15229,16 @@ Do not attempt more comments until tomorrow.`);
       return {
         name: "cohort_room_start_moderation_session",
         label: "cohort_room_start_moderation_session",
-        description: "Start a managed moderation session in a Cohort Room. This is THE way to run round robins and moderated Q&A as the Room moderator: the backend prompts each participant in turn, tracks who responded, and tells you when to advance. Returns the session state block. The returned block includes the session_id \u2014 pass it to cohort_room_advance_moderation_session for every subsequent action.",
+        description: 'Start a managed moderation session in a Cohort Room. Use round_robin = ask every participant to report in; use moderated_qna = route a question to one selected agent, wait for the answer, ask the asker whether it resolves the question, then complete. For multiple experts in Q&A, start with one best agent and use action: "followup" for additional experts one at a time. Returns the session state block. The returned block includes the session_id \u2014 pass it to cohort_room_advance_moderation_session for every subsequent action.',
         parameters: Type.Object({
           room_id: Type.String({ description: "Room ID supplied by Cohort, e.g. rooms:abc123" }),
           mode: Type.Union([
             Type.Literal("round_robin"),
             Type.Literal("moderated_qna")
-          ], { description: 'Session mode: "round_robin" (each participant responds in turn) or "moderated_qna" (one participant answers a question)' }),
+          ], { description: 'Session mode: "round_robin" means every participant reports in; "moderated_qna" means one selected participant answers a question, with serial followups for more experts.' }),
           objective: Type.String({ description: "One-line objective for the session, e.g. 'Daily standup: blockers and progress'" }),
-          participant_names: Type.Array(Type.String(), { description: "Cohort agent names to include, in speaking order" }),
-          question_text: Type.Optional(Type.String({ description: "moderated_qna only: the question to ask the participant" })),
+          participant_names: Type.Array(Type.String(), { description: "Cohort agent names to include, in speaking order; moderated_qna should include exactly one best agent" }),
+          question_text: Type.Optional(Type.String({ description: "moderated_qna only: the question to ask the selected participant" })),
           auto_advance: Type.Optional(Type.Boolean({ description: "round_robin only: automatically prompt the next participant after each matched response" }))
         }),
         async execute(_toolCallId, params) {
@@ -15249,7 +15270,7 @@ Do not attempt more comments until tomorrow.`);
       return {
         name: "cohort_room_advance_moderation_session",
         label: "cohort_room_advance_moderation_session",
-        description: 'Advance a moderation session you are running: "next" prompts the next participant, "retry"/"skip"/"accept" resolve a mismatched turn, "followup" asks a target a follow-up question, and "complete" ends the session. Outcomes passed with action "complete" (summary, decisions, proposed_tasks, follow_ups) become the session recap; proposed_tasks surface for human approval. Returns the updated session state block.',
+        description: 'Advance a moderation session you are running: "next" prompts the next round-robin participant, "retry"/"skip"/"accept" resolve a mismatched turn, followup asks one additional Q&A expert after the first answer, and "complete" ends the session. For moderated_qna, confirm with the asker before complete. Outcomes passed with action "complete" (summary, decisions, proposed_tasks, follow_ups) become the session recap; proposed_tasks surface for human approval. Returns the updated session state block.',
         parameters: Type.Object({
           session_id: Type.String({ description: "Moderation session ID returned by cohort_room_start_moderation_session" }),
           action: Type.Union([
@@ -15259,7 +15280,7 @@ Do not attempt more comments until tomorrow.`);
             Type.Literal("accept"),
             Type.Literal("followup"),
             Type.Literal("complete")
-          ], { description: "next = prompt the next participant (from waiting); retry = re-prompt the same agent; skip = skip the expected agent and move on; accept = accept an out-of-order reply as the response; followup = route a follow-up question (Q&A only); complete = finish the session (pass summary/decisions/proposed_tasks to create the recap)." }),
+          ], { description: "next = prompt the next round-robin participant (from waiting); retry = re-prompt the same agent; skip = skip the expected agent and move on; accept = accept an out-of-order reply as the response; followup = route one additional Q&A question to one target agent; complete = finish after asker confirmation when in Q&A (pass summary/decisions/proposed_tasks to create the recap)." }),
           prompt: Type.Optional(Type.String({ description: "Custom prompt for the turn (next/retry/followup)" })),
           target_agent_name: Type.Optional(Type.String({ description: "followup only: the agent to ask" })),
           summary: Type.Optional(Type.String({ description: "complete only: session recap summary" })),

package/dist/openclaw.plugin.json

@@ -80,5 +80,5 @@
       }
     }
   },
-  "version": "0.32.0"
+  "version": "0.32.1"
 }

package/dist/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfio/cohort-sync",
-  "version": "0.32.0",
+  "version": "0.32.1",
   "description": "OpenClaw plugin — syncs agent telemetry, sessions, and activity to the Cohort dashboard",
   "license": "MIT",
   "homepage": "https://docs.cohort.bot/gateway",