@cfio/cohort-sync 0.31.7 → 0.31.9

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}`);
@@ -12209,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) {
@@ -12298,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");
@@ -12321,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)) {
@@ -13665,11 +13730,15 @@ function dumpEvent(event) {
 function positiveNumber(value) {
   return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
 }
-var PLUGIN_VERSION = true ? "0.31.7" : "unknown";
+var PLUGIN_VERSION = true ? "0.31.9" : "unknown";
 function resolveGatewayToken(api) {
   const token2 = api.config?.gateway?.auth?.token;
   return typeof token2 === "string" ? token2 : null;
 }
+function resolveHooksToken(api) {
+  const token2 = api.config?.hooks?.token;
+  return typeof token2 === "string" ? token2 : null;
+}
 function registerCronEventHandlers(client2, cfg, resolveAgentName, cronTimestampTracker, logger) {
   if (client2.availableEvents.has("cron")) {
     let debounceTimer = null;
@@ -13853,6 +13922,7 @@ async function handleGatewayStart(event, state) {
   logger.debug("cohort-sync: gateway start: bridge after seed", { bridge: Object.fromEntries(getChannelAgentBridge()) });
   state.gatewayPort = event.port;
   const token2 = resolveGatewayToken(api);
+  const hooksToken = resolveHooksToken(api);
   if (token2) {
     state.gatewayToken = token2;
     logger.debug("cohort-sync: gateway client connecting", { port: event.port, hasToken: true });
@@ -13864,7 +13934,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.commandUnsubscriber = unsub;
     } catch (err) {
       logger.debug("cohort-sync: gateway client connect failed", { error: String(err) });
@@ -13916,7 +13993,7 @@ async function handleGatewayStart(event, state) {
   await startNotificationSubscription(
     event.port,
     cfg,
-    api.config.hooks?.token,
+    hooksToken ?? void 0,
     logger,
     state.persistentGwClient,
     resolvedNameMap
@@ -14194,7 +14271,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) });
@@ -14501,6 +14585,7 @@ function initializeHookState(api, cfg) {
   });
   const gatewayPort = api.config?.gateway?.port ?? null;
   const gatewayToken = resolveGatewayToken(api);
+  const hooksToken = resolveHooksToken(api);
   const cronTimestampTracker = new CronTimestampTracker();
   const cronRunStarts = /* @__PURE__ */ new Map();
   let persistentGwClient = null;
@@ -14510,7 +14595,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 }
+  );
   setToolRuntime({
     apiKey: cfg.apiKey,
     apiUrl: cfg.apiUrl,
@@ -14794,6 +14886,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",

package/dist/openclaw.plugin.json

@@ -72,5 +72,5 @@
       }
     }
   },
-  "version": "0.31.7"
+  "version": "0.31.9"
 }

package/dist/package.json

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