@cfio/cohort-sync 0.31.6 → 0.31.8

package/dist/index.js

@@ -11741,7 +11741,7 @@ function checkRateLimit() {
   return true;
 }
 var MAX_CRON_MESSAGE_LENGTH = 1e3;
-async function executeCommand(cmd, gwClient, cfg, resolveAgentName, logger, cronTimestampTracker) {
+async function executeCommand(cmd, gwClient, cfg, resolveAgentName, logger, cronTimestampTracker, injection) {
   logger.info(`cohort-sync: executing command type=${cmd.type} id=${cmd._id}`);
   if (!checkRateLimit()) {
     logger.warn(`cohort-sync: rate limit exceeded (>${RATE_LIMIT_MAX} commands/min), rejecting command ${cmd._id}`);
@@ -11764,6 +11764,23 @@ async function executeCommand(cmd, gwClient, cfg, resolveAgentName, logger, cron
     process.kill(process.pid, "SIGUSR1");
     return;
   }
+  if (cmd.type === "briefingGenerate") {
+    const requestId = cmd.payload?.briefingRequestId;
+    if (!requestId) {
+      throw new Error("briefingRequestId is required for briefingGenerate");
+    }
+    if (!injection?.port || !injection.hooksToken) {
+      throw new Error("Gateway hooks transport is not available for briefing generation");
+    }
+    const agentName = cmd.payload?.agentId ?? "main";
+    const agentId = reverseResolveAgentName(agentName, cfg.agentNameMap ?? {});
+    await injectBriefingGeneration(injection.port, injection.hooksToken, {
+      requestId,
+      agentId,
+      agentName
+    });
+    return;
+  }
   if (cmd.type.startsWith("cron")) {
     if (!gwClient || !gwClient.isAlive()) {
       logger.warn(`cohort-sync: no gateway client, cannot execute ${cmd.type}`);
@@ -11971,6 +11988,7 @@ var acknowledgeCommandRef = makeFunctionReference("gatewayCommands:acknowledgeCo
 var failCommandRef = makeFunctionReference("gatewayCommands:failCommand");
 var getChannelsForPlugin = makeFunctionReference("cloudGatewayChannels:listForPlugin");
 var addCommentFromPluginRef = makeFunctionReference("comments:addCommentFromPlugin");
+var transitionFromPluginRef = makeFunctionReference("tasks:transitionFromPlugin");
 async function pushTelemetry(apiKey2, data) {
   if (authCircuitOpen) return;
   const c = getClient();
@@ -12073,6 +12091,30 @@ async function callAddCommentFromPlugin(apiKey2, args) {
     throw err;
   }
 }
+async function callTransitionFromPlugin(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(transitionFromPluginRef, {
+      apiKeyHash: hashApiKey(apiKey2),
+      taskNumber: args.taskNumber,
+      agentName: args.agentName,
+      targetStatus: args.targetStatus
+    });
+  } catch (err) {
+    if (isUnauthorizedError(err)) {
+      tripAuthCircuit();
+    }
+    throw err;
+  }
+}
 var DEFAULT_BEHAVIORAL_PROMPT = `BEFORE RESPONDING:
 - Does your planned response address the task's stated scope? If not, do not comment.
 - Do not post acknowledgment-only responses ("got it", "sounds good", "confirmed"). If you have no new information to add, do not comment.
@@ -12184,6 +12226,46 @@ async function injectNotification(port, hooksToken, n, agentId = "main") {
     throw new Error(`/hooks/agent returned ${response.status} ${response.statusText}`);
   }
 }
+function buildBriefingGenerationMessage(args) {
+  return `Generate the Cohort Home briefing requested for ${args.agentName}.
+
+Use your own voice and persona from SOUL.md, IDENTITY.md, and the rest of your agent instructions. First call cohort_briefing_context with request_id "${args.requestId}" to read the prepared workspace context. Then write the final briefing and submit it with cohort_briefing.
+
+Final briefing requirements:
+- Write exactly two short paragraphs.
+- No bullet points or numbered lists.
+- Do not mention "this briefing".
+- Avoid colon-heavy phrasing.
+- Include one concrete high-leverage thing the reader should direct attention to next.
+- Keep it useful, personal, and alive without sounding theatrical.
+
+TOOLS:
+- cohort_briefing_context(request_id) \u2014 fetch the prepared briefing context.
+- cohort_briefing(request_id, content) \u2014 submit the final Home briefing.`;
+}
+async function injectBriefingGeneration(port, hooksToken, args) {
+  const response = await fetch(`http://localhost:${port}/hooks/agent`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${hooksToken}`
+    },
+    body: JSON.stringify({
+      message: buildBriefingGenerationMessage({
+        requestId: args.requestId,
+        agentName: args.agentName
+      }),
+      name: "Cohort",
+      agentId: args.agentId,
+      deliver: false,
+      sessionKey: args.agentId === "main" ? `hook:cohort:briefing-${args.requestId}` : `agent:${args.agentId}:hook:cohort:briefing-${args.requestId}`
+    }),
+    signal: AbortSignal.timeout(1e4)
+  });
+  if (!response.ok) {
+    throw new Error(`/hooks/agent returned ${response.status} ${response.statusText}`);
+  }
+}
 var deliveryFailures = /* @__PURE__ */ new Map();
 var MAX_DELIVERY_ATTEMPTS = 3;
 async function startNotificationSubscription(port, cfg, hooksToken, logger, gwClient, resolvedNameMap) {
@@ -12273,7 +12355,7 @@ async function startNotificationSubscription(port, cfg, hooksToken, logger, gwCl
     unsubscribers.push(unsubscribe);
   }
 }
-function startCommandSubscription(cfg, logger, resolveAgentName, gwClient, cronTimestampTracker) {
+function startCommandSubscription(cfg, logger, resolveAgentName, gwClient, cronTimestampTracker, injection) {
   const c = getClient();
   if (!c) {
     logger.warn("cohort-sync: no ConvexClient \u2014 command subscription skipped");
@@ -12296,7 +12378,15 @@ function startCommandSubscription(cfg, logger, resolveAgentName, gwClient, cronT
               commandId: cmd._id,
               apiKeyHash
             });
-            await executeCommand(cmd, gwClient, cfg, resolveAgentName, logger, cronTimestampTracker);
+            await executeCommand(
+              cmd,
+              gwClient,
+              cfg,
+              resolveAgentName,
+              logger,
+              cronTimestampTracker,
+              injection
+            );
             if (cmd.type === "restart") return;
           } catch (err) {
             if (isUnauthorizedError(err)) {
@@ -13640,7 +13730,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.6" : "unknown";
+var PLUGIN_VERSION = true ? "0.31.8" : "unknown";
 function resolveGatewayToken(api) {
   const token2 = api.config?.gateway?.auth?.token;
   return typeof token2 === "string" ? token2 : null;
@@ -13839,7 +13929,14 @@ async function handleGatewayStart(event, state) {
         state.commandUnsubscriber();
         state.commandUnsubscriber = null;
       }
-      const unsub = startCommandSubscription(cfg, logger, state.resolveAgentName, state.persistentGwClient, state.cronTimestampTracker);
+      const unsub = startCommandSubscription(
+        cfg,
+        logger,
+        state.resolveAgentName,
+        state.persistentGwClient,
+        state.cronTimestampTracker,
+        { port: state.gatewayPort, hooksToken: state.gatewayToken }
+      );
       state.commandUnsubscriber = unsub;
     } catch (err) {
       logger.debug("cohort-sync: gateway client connect failed", { error: String(err) });
@@ -14169,7 +14266,14 @@ function registerHookHandlers(api, logger, getState) {
             state.commandUnsubscriber();
             state.commandUnsubscriber = null;
           }
-          const unsub = startCommandSubscription(cfg, log, state.resolveAgentName, state.persistentGwClient, state.cronTimestampTracker);
+          const unsub = startCommandSubscription(
+            cfg,
+            log,
+            state.resolveAgentName,
+            state.persistentGwClient,
+            state.cronTimestampTracker,
+            { port: state.gatewayPort, hooksToken: state.gatewayToken }
+          );
           state.commandUnsubscriber = unsub;
         } catch (err) {
           log.debug("cohort-sync: gateway client lazy init failed", { error: String(err) });
@@ -14485,7 +14589,14 @@ function initializeHookState(api, cfg) {
     persistentGwClient = client2;
     gwClientInitialized = true;
   }
-  const commandUnsub = startCommandSubscription(cfg, logger, resolveAgentName, persistentGwClient, cronTimestampTracker);
+  const commandUnsub = startCommandSubscription(
+    cfg,
+    logger,
+    resolveAgentName,
+    persistentGwClient,
+    cronTimestampTracker,
+    { port: gatewayPort, hooksToken: gatewayToken }
+  );
   setToolRuntime({
     apiKey: cfg.apiKey,
     apiUrl: cfg.apiUrl,
@@ -14769,6 +14880,86 @@ Do not attempt more comments until tomorrow.`);
         }
       };
     });
+    api.registerTool((toolCtx) => {
+      const agentId = toolCtx.agentId ?? "main";
+      return {
+        name: "cohort_briefing_context",
+        label: "cohort_briefing_context",
+        description: "Fetch the prepared workspace context for a Cohort Home briefing request.",
+        parameters: Type.Object({
+          request_id: Type.String({ description: "Briefing request ID supplied by Cohort." })
+        }),
+        async execute(_toolCallId, params) {
+          const rt = getToolRuntime();
+          if (!rt.isReady) {
+            return textResult("cohort_briefing_context is not ready yet \u2014 the plugin is still starting up.");
+          }
+          try {
+            const response = await fetch(
+              `${rt.apiUrl}/api/v1/briefings/${encodeURIComponent(params.request_id)}/context`,
+              {
+                method: "GET",
+                headers: { "Authorization": `Bearer ${rt.apiKey}` },
+                signal: AbortSignal.timeout(1e4)
+              }
+            );
+            const body = await response.text();
+            if (!response.ok) {
+              return textResult(`Failed to fetch briefing context: ${response.status} ${body.slice(0, 300)}`);
+            }
+            const agentName = rt.resolveAgentName(agentId);
+            return textResult(
+              `Briefing context for ${agentName}:
+
+${body}`,
+              JSON.parse(body)
+            );
+          } catch (err) {
+            return textResult(`Failed to fetch briefing context: ${err instanceof Error ? err.message : String(err)}`);
+          }
+        }
+      };
+    });
+    api.registerTool((toolCtx) => {
+      const agentId = toolCtx.agentId ?? "main";
+      return {
+        name: "cohort_briefing",
+        label: "cohort_briefing",
+        description: "Submit the final generated text for a Cohort Home briefing request.",
+        parameters: Type.Object({
+          request_id: Type.String({ description: "Briefing request ID supplied by Cohort." }),
+          content: Type.String({ description: "Final briefing text. Use exactly two short paragraphs." })
+        }),
+        async execute(_toolCallId, params) {
+          const rt = getToolRuntime();
+          if (!rt.isReady) {
+            return textResult("cohort_briefing is not ready yet \u2014 the plugin is still starting up.");
+          }
+          const agentName = rt.resolveAgentName(agentId);
+          try {
+            const response = await fetch(
+              `${rt.apiUrl}/api/v1/briefings/${encodeURIComponent(params.request_id)}`,
+              {
+                method: "POST",
+                headers: {
+                  "Authorization": `Bearer ${rt.apiKey}`,
+                  "Content-Type": "application/json"
+                },
+                body: JSON.stringify({ agentName, content: params.content }),
+                signal: AbortSignal.timeout(1e4)
+              }
+            );
+            const body = await response.text();
+            if (!response.ok) {
+              return textResult(`Failed to submit briefing: ${response.status} ${body.slice(0, 300)}`);
+            }
+            return textResult("Briefing submitted.", JSON.parse(body));
+          } catch (err) {
+            return textResult(`Failed to submit briefing: ${err instanceof Error ? err.message : String(err)}`);
+          }
+        }
+      };
+    });
     api.registerTool(() => {
       return {
         name: "cohort_task",
@@ -14832,7 +15023,8 @@ Do not attempt more comments until tomorrow.`);
         }
       };
     });
-    api.registerTool(() => {
+    api.registerTool((toolCtx) => {
+      const agentId = toolCtx.agentId ?? "main";
       return {
         name: "cohort_transition",
         label: "cohort_transition",
@@ -14850,21 +15042,13 @@ Do not attempt more comments until tomorrow.`);
           if (!validStatuses.includes(params.status)) {
             return textResult(`Invalid status "${params.status}". Valid statuses: ${validStatuses.join(", ")}`);
           }
+          const agentName = rt.resolveAgentName(agentId);
           try {
-            const res = await fetch(`${rt.apiUrl}/api/v1/tasks/${params.task_number}/transition`, {
-              method: "POST",
-              headers: {
-                "Authorization": `Bearer ${rt.apiKey}`,
-                "Content-Type": "application/json"
-              },
-              body: JSON.stringify({ to: params.status }),
-              signal: AbortSignal.timeout(1e4)
+            await callTransitionFromPlugin(rt.apiKey, {
+              taskNumber: params.task_number,
+              agentName,
+              targetStatus: params.status
             });
-            if (!res.ok) {
-              const body = await res.text();
-              return textResult(`Failed to transition task #${params.task_number} to "${params.status}": ${res.status} ${body.slice(0, 200)}`);
-            }
-            const task = await res.json();
             return textResult(`Task #${params.task_number} transitioned to "${params.status}".`);
           } catch (err) {
             return textResult(`Failed to transition task #${params.task_number}: ${err instanceof Error ? err.message : String(err)}`);
@@ -14872,8 +15056,7 @@ Do not attempt more comments until tomorrow.`);
         }
       };
     });
-    api.registerTool((toolCtx) => {
-      const agentId = toolCtx.agentId ?? "main";
+    api.registerTool(() => {
       return {
         name: "cohort_assign",
         label: "cohort_assign",
@@ -14905,7 +15088,7 @@ Do not attempt more comments until tomorrow.`);
               const body = await res.text();
               return textResult(`Failed to assign task #${params.task_number}: ${res.status} ${body.slice(0, 200)}`);
             }
-            const task = await res.json();
+            await res.json();
             const msg = assignee ? `Task #${params.task_number} assigned to ${assignee}.` : `Task #${params.task_number} unassigned.`;
             return textResult(msg);
           } catch (err) {

package/dist/openclaw.plugin.json

@@ -72,5 +72,5 @@
       }
     }
   },
-  "version": "0.31.6"
+  "version": "0.31.8"
 }

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cfio/cohort-sync",
-  "version": "0.31.6",
+  "version": "0.31.8",
   "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.31.6",
+  "version": "0.31.8",
   "description": "OpenClaw plugin — syncs agent telemetry, sessions, and activity to the Cohort dashboard",
   "license": "MIT",
   "homepage": "https://docs.cohort.bot/gateway",