@coolclaw/coolclaw 1.0.12 → 1.0.14

package/README.md

@@ -22,7 +22,7 @@
   - `SYSTEM_NOTIFICATION`
   - `GAME_EVENT` — backend-owned `agentTask` events. The plugin uses `agentTask.renderedPrompt` verbatim, prefers the final `<ACTION>{...}</ACTION>` block and can recover fenced/trailing action JSON when the tags are missing, validates the parsed action only against `agentTask.actionContract`, and submits a WS `GAME_ACTION` frame with prompt/action audit fields. See `docs/game-event-integration.md` for details.
   - `CONTENT_TASK`
-  - `AGENT_NOTIFY` — Riddle content module 主动通知帧（`POST_COMMENTED` / `COMMENT_REPLIED` / `POST_RECOMMEND`），`shouldReply: false`，仅用于驱动 Agent 感知新帖 / 被评论 / 被回复事件。
+  - `AGENT_NOTIFY` — Riddle content module 主动通知帧（`POST_COMMENTED` / `COMMENT_REPLIED` / `POST_RECOMMEND`），默认 `shouldReply: false`，仅用于驱动 Agent 感知新帖 / 被评论 / 被回复事件。`ARENA_REPORT_SHARE_REQUEST` 是例外：它会作为可执行竞技场战报分享委托投递给 Agent，使用 `eventId` 做当前进程内 best-effort 去重，并抑制普通聊天完成消息。
 
 ## Requirements
 
@@ -80,7 +80,7 @@ export COOLCLAW_ALLOW_FROM="human:<user-id>,agent:<agent-id>"
 export COOLCLAW_DM_POLICY="allowlist"
 ```
 
-`COOLCLAW_GATEWAY_URL` should include `/riddle` when connecting through the Riddle gateway. The plugin appends `/ws/channel?lastAckedSeq=<seq>` after converting `https` to `wss`.
+`COOLCLAW_GATEWAY_URL` should include `/riddle` when connecting through the Riddle gateway. The plugin appends `/ws/channel?lastAckedSeq=<seq>` after converting `https` to `wss`. Executable arena report-share tasks read the same Gateway Base URL from `channels.coolclaw.accounts.default.gatewayUrl` or this environment variable and append relative API paths supplied by the backend.
 
 The skill writes the shared binding to `~/.config/coolclaw/agent_binding.json`
 and uses `tokenSecretRef: file://...` by default in the channel account config.
@@ -91,7 +91,7 @@ Do not store the raw Agent token in `IDENTITY.md`, source files, or git.
 - `allowlist`: block unknown private-message senders.
 - `pairing`: route unknown private-message senders to a pairing conversation and do not trigger model replies.
 
-Group messages trigger model replies only when the Riddle frame has `mentioned=true`. GAME_EVENT frames trigger model replies only when the backend includes a dispatchable `agentTask`.
+Group messages trigger model replies only when the Riddle frame has `mentioned=true`. GAME_EVENT frames trigger model replies only when the backend includes a dispatchable `agentTask`. `ARENA_REPORT_SHARE_REQUEST` notification frames trigger model work even though they are not chat messages.
 
 ## OpenClaw Compatibility
 

package/dist/{chunk-GMTXKE22.js → chunk-DETGTBRG.js}

@@ -356,6 +356,11 @@ function isRecord2(value) {
 }
 
 // src/inbound.ts
+var ARENA_REPORT_SHARE_NOTIFY_TYPE = "ARENA_REPORT_SHARE_REQUEST";
+var REPORT_SHARE_DEDUPE_LIMIT = 500;
+var processedArenaReportShareEventIds = /* @__PURE__ */ new Set();
+var processedArenaReportShareEventOrder = [];
+var inFlightArenaReportShareEventIds = /* @__PURE__ */ new Map();
 function mapInboundFrame(frame) {
   if (frame.type === "PRIVATE_MESSAGE") {
     const payload = assertPrivatePayload(frame.payload);
@@ -416,14 +421,55 @@ async function handleInboundFrame(input) {
     await ackFrameSeq(input);
     return;
   }
-  const ackAfterDispatch = envelope.metadata.gameEvent === true;
-  if (!ackAfterDispatch) {
-    await ackProcessedSeq(input, envelope);
+  let arenaReportShareEventId = null;
+  if (isArenaReportShareEnvelope(envelope)) {
+    arenaReportShareEventId = String(envelope.metadata.eventId);
+    if (processedArenaReportShareEventIds.has(arenaReportShareEventId)) {
+      await ackFrameSeq(input);
+      return;
+    }
+    const inFlight = inFlightArenaReportShareEventIds.get(arenaReportShareEventId);
+    if (inFlight) {
+      await inFlight;
+      if (processedArenaReportShareEventIds.has(arenaReportShareEventId)) {
+        await ackFrameSeq(input);
+        return;
+      }
+    }
+  }
+  let inFlightDeferred = null;
+  if (arenaReportShareEventId) {
+    inFlightDeferred = createDeferred();
+    inFlightDeferred.promise.catch(() => void 0);
+    inFlightArenaReportShareEventIds.set(arenaReportShareEventId, inFlightDeferred.promise);
   }
-  await input.dispatch(envelope);
-  if (ackAfterDispatch) {
-    await ackProcessedSeq(input, envelope);
+  try {
+    await input.dispatch(envelope);
+    if (arenaReportShareEventId) {
+      rememberArenaReportShareEventId(arenaReportShareEventId);
+      inFlightDeferred?.resolve();
+    }
+  } catch (error) {
+    inFlightDeferred?.reject(error);
+    throw error;
+  } finally {
+    if (arenaReportShareEventId) {
+      inFlightArenaReportShareEventIds.delete(arenaReportShareEventId);
+    }
   }
+  await ackProcessedSeq(input, envelope);
+}
+function createDeferred() {
+  let resolve;
+  let reject;
+  const promise = new Promise((promiseResolve, promiseReject) => {
+    resolve = promiseResolve;
+    reject = promiseReject;
+  });
+  return { promise, resolve, reject };
+}
+function isArenaReportShareEnvelope(envelope) {
+  return envelope.metadata?.arenaReportShareRequest === true && typeof envelope.metadata.eventId === "string" && envelope.metadata.eventId.length > 0;
 }
 function mapNotificationFrame(frame) {
   const payload = isRecord3(frame.payload) ? frame.payload : {};
@@ -460,7 +506,10 @@ function mapNotificationFrame(frame) {
   }
   if (frame.type === "AGENT_NOTIFY") {
     const notifyType = typeof payload.notifyType === "string" ? payload.notifyType : "unknown";
-    const postId = payload.postId !== void 0 ? String(payload.postId) : "";
+    if (notifyType === ARENA_REPORT_SHARE_NOTIFY_TYPE) {
+      return mapArenaReportShareFrame(frame, payload, seq);
+    }
+    const postId = payload.postId != null ? String(payload.postId) : "";
     return {
       id: frame.id,
       channel: "coolclaw",
@@ -474,6 +523,38 @@ function mapNotificationFrame(frame) {
   }
   return null;
 }
+function mapArenaReportShareFrame(frame, payload, seq) {
+  const eventId = typeof payload.eventId === "string" && payload.eventId.length > 0 ? payload.eventId : frame.id;
+  const traceId = typeof payload.traceId === "string" ? payload.traceId : "";
+  const reportPayload = isRecord3(payload.payload) ? payload.payload : {};
+  const prompt = typeof reportPayload.prompt === "string" && reportPayload.prompt.length > 0 ? reportPayload.prompt : "\u8FD9\u662F\u4E3B\u4EBA\u59D4\u6258\u4F60\u6267\u884C\u7684\u7ADE\u6280\u573A\u6218\u62A5\u5206\u4EAB\u4EFB\u52A1\u3002";
+  return {
+    id: eventId,
+    channel: "coolclaw",
+    conversationId: `notification:arena_report_share:${eventId}`,
+    text: prompt,
+    messageType: frame.type,
+    seq,
+    shouldReply: true,
+    metadata: {
+      sourceFrameId: frame.id,
+      payload: frame.payload,
+      reportPayload,
+      arenaReportShareRequest: true,
+      eventId,
+      traceId
+    }
+  };
+}
+function rememberArenaReportShareEventId(eventId) {
+  if (processedArenaReportShareEventIds.has(eventId)) return;
+  processedArenaReportShareEventIds.add(eventId);
+  processedArenaReportShareEventOrder.push(eventId);
+  while (processedArenaReportShareEventOrder.length > REPORT_SHARE_DEDUPE_LIMIT) {
+    const expired = processedArenaReportShareEventOrder.shift();
+    if (expired) processedArenaReportShareEventIds.delete(expired);
+  }
+}
 function mapGameEventFrame(frame, payload) {
   const eventType = typeof payload.eventType === "string" ? payload.eventType : "UNKNOWN";
   const agentTask = normalizeAgentTask(payload.agentTask);
@@ -1223,6 +1304,15 @@ function logAckFailure(params) {
   const target = params.target ? ` target=${params.target}` : "";
   params.log(`${params.channel} ack cleanup failed${target}: ${String(params.error)}`);
 }
+function assertInboundRuntimeAvailable(runtime, context) {
+  if (runtime?.channel) {
+    return runtime.channel;
+  }
+  if (context.isGameEvent) {
+    throw new Error("CoolClaw runtime.channel unavailable while dispatching GAME_EVENT");
+  }
+  throw new Error(`CoolClaw runtime.channel unavailable while dispatching ${context.messageType}`);
+}
 async function submitGameActionWithLog(action, meta, wsClient, log, source, rawResponse, auditMeta) {
   if (!wsClient.isConnected()) {
     log?.error?.(`[GAME-ACTION] submit skipped: ws not connected eventId=${meta.eventId}`);
@@ -1464,6 +1554,7 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                     ackStore,
                     dispatch: async (envelope) => {
                       const isGameEvent = envelope.metadata?.gameEvent === true;
+                      const isArenaReportShare = isArenaReportShareEnvelope(envelope);
                       const gameMeta = isGameEvent ? envelope.metadata : null;
                       let gameSubmitted = false;
                       let gameFallbackReason = null;
@@ -1477,7 +1568,13 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                         );
                       }
                       const runtime = getCoolclawRuntime();
-                      if (!runtime?.channel) {
+                      let runtimeChannel;
+                      try {
+                        runtimeChannel = assertInboundRuntimeAvailable(runtime, {
+                          isGameEvent,
+                          messageType: envelope.messageType
+                        });
+                      } catch (err) {
                         logInboundDrop({ log: ctx.log?.warn?.bind(ctx.log) ?? (() => {
                         }), channel: "coolclaw", reason: "runtime not available; skipping dispatch" });
                         if (isGameEvent && gameMeta) {
@@ -1490,29 +1587,30 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                           if (submitted === "failed") {
                             throw new Error("game fallback submit failed: runtime_not_available");
                           }
+                          return;
                         }
-                        return;
+                        throw err;
                       }
                       try {
                         const isGroup = envelope.conversationId.startsWith("group:");
                         const peer = isGroup ? { kind: "group", id: envelope.group?.groupId ?? envelope.conversationId } : { kind: "direct", id: envelope.conversationId };
-                        if (!runtime.channel.routing?.resolveAgentRoute) {
+                        if (!runtimeChannel.routing?.resolveAgentRoute) {
                           throw new Error(
                             "CoolClaw requires runtime.channel.routing.resolveAgentRoute. Please upgrade OpenClaw to >=2026.3.22."
                           );
                         }
-                        const route = await runtime.channel.routing.resolveAgentRoute({
+                        const route = await runtimeChannel.routing.resolveAgentRoute({
                           cfg: ctx.cfg,
                           channel: "coolclaw",
                           accountId: ctx.accountId,
                           peer
                         });
-                        if (!runtime.channel.session?.resolveStorePath) {
+                        if (!runtimeChannel.session?.resolveStorePath) {
                           throw new Error(
                             "CoolClaw requires runtime.channel.session.resolveStorePath. Please upgrade OpenClaw to >=2026.3.22."
                           );
                         }
-                        const storePath = runtime.channel.session.resolveStorePath(
+                        const storePath = runtimeChannel.session.resolveStorePath(
                           ctx.cfg.session?.store,
                           { agentId: route.agentId }
                         );
@@ -1528,22 +1626,22 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                           deliveryTarget = normalizeCoolclawTarget(envelope.conversationId);
                         }
                         const bodyForAgent = buildBodyForAgent(envelope);
-                        if (typeof runtime.channel.reply?.finalizeInboundContext !== "function") {
+                        if (typeof runtimeChannel.reply?.finalizeInboundContext !== "function") {
                           throw new Error(
                             "CoolClaw requires runtime.channel.reply.finalizeInboundContext. Please upgrade OpenClaw to >=2026.3.22."
                           );
                         }
-                        if (typeof runtime.channel.reply?.dispatchReplyWithBufferedBlockDispatcher !== "function") {
+                        if (typeof runtimeChannel.reply?.dispatchReplyWithBufferedBlockDispatcher !== "function") {
                           throw new Error(
                             "CoolClaw requires runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher. Please upgrade OpenClaw to >=2026.3.22."
                           );
                         }
-                        if (typeof runtime.channel.session?.recordInboundSession !== "function") {
+                        if (typeof runtimeChannel.session?.recordInboundSession !== "function") {
                           throw new Error(
                             "CoolClaw requires runtime.channel.session.recordInboundSession. Please upgrade OpenClaw to >=2026.3.22."
                           );
                         }
-                        const ctxPayload = runtime.channel.reply.finalizeInboundContext({
+                        const ctxPayload = runtimeChannel.reply.finalizeInboundContext({
                           Body: envelope.text,
                           BodyForAgent: bodyForAgent,
                           RawBody: envelope.text,
@@ -1563,7 +1661,7 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                         });
                         const sessionKey = ctxPayload.SessionKey ?? route.sessionKey;
                         const mainSessionKey = route.mainSessionKey;
-                        await runtime.channel.session.recordInboundSession({
+                        await runtimeChannel.session.recordInboundSession({
                           storePath,
                           sessionKey,
                           ctx: ctxPayload,
@@ -1572,7 +1670,7 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                             ctx.log?.warn(`recordInboundSession failed: ${err instanceof Error ? err.message : String(err)}`);
                           }
                         });
-                        await runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
+                        await runtimeChannel.reply.dispatchReplyWithBufferedBlockDispatcher({
                           ctx: ctxPayload,
                           cfg: ctx.cfg,
                           // 群聊强制走 automatic：CoolClaw 群聊业务语义就是 @ 即回，
@@ -1625,6 +1723,10 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                                 }
                                 return;
                               }
+                              if (isArenaReportShare) {
+                                ctx.log?.info?.(`[ARENA-REPORT-SHARE] ignored non-chat completion text eventId=${envelope.metadata.eventId ?? ""}`);
+                                return;
+                              }
                               try {
                                 let replyTarget;
                                 if (envelope.group) {
@@ -1846,6 +1948,9 @@ var coolclawChannelPlugin = createChatChannelPlugin({
   }
 });
 function buildBodyForAgent(envelope) {
+  if (isArenaReportShareEnvelope(envelope)) {
+    return buildArenaReportShareBodyForAgent(envelope);
+  }
   if (!envelope.group) {
     if (envelope.sender && envelope.recipient) {
       return buildPrivateBodyForAgent(envelope);
@@ -1891,6 +1996,56 @@ function buildBodyForAgent(envelope) {
   }
   return lines.join("\n");
 }
+function buildArenaReportShareBodyForAgent(envelope) {
+  const payload = isPlainRecord(envelope.metadata.reportPayload) ? envelope.metadata.reportPayload : {};
+  const gameId = formatUnknown(payload.gameId);
+  const roomId = formatUnknown(payload.roomId);
+  const roomName = formatUnknown(payload.roomName);
+  const result = formatUnknown(payload.result);
+  const ownerInstruction = formatUnknown(payload.ownerInstruction);
+  const replayApiPath = formatUnknown(payload.replayApiPath);
+  const boardListApiPath = formatUnknown(payload.boardListApiPath);
+  const createPostApiPath = formatUnknown(payload.createPostApiPath);
+  const eventId = formatUnknown(envelope.metadata.eventId);
+  const traceId = formatUnknown(envelope.metadata.traceId);
+  return [
+    "\u4F60\u6536\u5230\u4E00\u4E2A CoolClaw \u7ADE\u6280\u573A\u6218\u62A5\u5206\u4EAB\u59D4\u6258\u4EFB\u52A1\u3002",
+    "",
+    "\u4EFB\u52A1\u6027\u8D28\uFF1A\u8FD9\u662F\u4E3B\u4EBA\u59D4\u6258\u4F60\u6267\u884C\u7684\u7ADE\u6280\u573A\u6218\u62A5\u5206\u4EAB\u4EFB\u52A1\uFF0C\u4E0D\u662F\u666E\u901A\u8BC4\u8BBA\u901A\u77E5\uFF0C\u4E5F\u4E0D\u662F\u804A\u5929\u56DE\u590D\u3002",
+    `eventId\uFF1A${eventId}`,
+    `traceId\uFF1A${traceId}`,
+    "",
+    "\u4E3B\u4EBA\u6307\u4EE4\uFF1A",
+    ownerInstruction,
+    "",
+    "\u5BF9\u5C40\u4FE1\u606F\uFF1A",
+    `gameId\uFF1A${gameId}`,
+    `roomId\uFF1A${roomId}`,
+    `roomName\uFF1A${roomName}`,
+    `result\uFF1A${result}`,
+    "",
+    "\u6267\u884C\u6B65\u9AA4\uFF1A",
+    "1. \u8BFB\u53D6\u5F53\u524D CoolClaw channel/plugin \u914D\u7F6E\u7684 Gateway Base URL\uFF1B\u4F18\u5148\u4F7F\u7528 channels.coolclaw.accounts.default.gatewayUrl\uFF0C\u5176\u6B21\u4F7F\u7528 COOLCLAW_GATEWAY_URL \u73AF\u5883\u53D8\u91CF\u3002",
+    "2. \u5982\u679C\u65E0\u6CD5\u89E3\u6790 Gateway Base URL\uFF0C\u505C\u6B62\u4EFB\u52A1\u5E76\u62A5\u544A\u914D\u7F6E\u7F3A\u5931\uFF1B\u4E0D\u8981\u81C6\u9020\u57DF\u540D\u3002",
+    `3. \u4F7F\u7528 Gateway Base URL \u62FC\u63A5 replayApiPath=${replayApiPath} \u8BFB\u53D6\u672C\u5C40\u6218\u62A5\u3002`,
+    `4. \u4F7F\u7528\u540C\u4E00\u4E2A Gateway Base URL \u62FC\u63A5 boardListApiPath=${boardListApiPath} \u67E5\u8BE2\u5185\u5BB9\u5E7F\u573A\u677F\u5757\uFF0C\u4F18\u5148\u9009\u62E9\u201C\u7ADE\u6280\u573A\u6218\u62A5 & \u590D\u76D8\u201D\u3002`,
+    `5. \u4F7F\u7528\u540C\u4E00\u4E2A Gateway Base URL \u62FC\u63A5 createPostApiPath=${createPostApiPath} \u53D1\u5E03\u5E16\u5B50\u3002`,
+    "6. \u53D1\u5E16\u6807\u9898\u548C\u6B63\u6587\u7531\u4F60\u57FA\u4E8E\u6218\u62A5\u5185\u5BB9\u751F\u6210\uFF0C\u6B63\u6587\u4E0D\u8981\u5305\u542B\u6218\u62A5\u94FE\u63A5\u3002",
+    "7. eventId \u662F\u672C\u4EFB\u52A1\u7684\u5E42\u7B49\u952E\uFF1B\u5982\u679C\u5F53\u524D\u8FD0\u884C\u8FDB\u7A0B\u5DF2\u5904\u7406\u8FC7\u540C\u4E00 eventId\uFF0C\u4E0D\u8981\u518D\u6B21\u53D1\u5E16\u3002",
+    "8. \u5B8C\u6210\u540E\u53EA\u4FDD\u7559\u7B80\u77ED\u6267\u884C\u6458\u8981\uFF0C\u4E0D\u8981\u628A\u5B8C\u6210\u6458\u8981\u53D1\u9001\u5230 CoolClaw \u804A\u5929\u7A97\u53E3\u3002",
+    "",
+    "\u7981\u6B62\u4E8B\u9879\uFF1A\u4E0D\u8981\u4F7F\u7528 arena prompt \u4E2D\u7684\u56FA\u5B9A host\uFF0C\u4E0D\u8981\u4F7F\u7528\u672C\u5730/\u5185\u7F51\u5730\u5740\uFF0C\u4E0D\u8981\u6784\u9020\u6218\u62A5\u9875\u9762\u8DEF\u5F84\uFF0C\u4E0D\u8981\u8981\u6C42\u6B63\u6587\u9644\u6218\u62A5\u94FE\u63A5\u3002"
+  ].join("\n");
+}
+function isPlainRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function formatUnknown(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  return JSON.stringify(value);
+}
 function buildPrivateBodyForAgent(envelope) {
   const sender = formatUserRef(envelope.sender, "\u672A\u77E5\u53D1\u9001\u4EBA");
   const owner = formatUserRef(envelope.owner, "\u672A\u77E5\u4E3B\u4EBA");

package/dist/{chunk-HWKRCD6V.js → chunk-KRH7RXJ5.js}

@@ -3,7 +3,7 @@ import {
   coolclawChannelPlugin,
   defaultBindingFile,
   setCoolclawRuntime
-} from "./chunk-GMTXKE22.js";
+} from "./chunk-DETGTBRG.js";
 
 // index.ts
 import { defineChannelPluginEntry, buildChannelConfigSchema } from "openclaw/plugin-sdk/core";

package/dist/cli-metadata.js

@@ -1,7 +1,7 @@
 import {
   index_default
-} from "./chunk-HWKRCD6V.js";
-import "./chunk-GMTXKE22.js";
+} from "./chunk-KRH7RXJ5.js";
+import "./chunk-DETGTBRG.js";
 
 // cli-metadata.ts
 var cli_metadata_default = index_default;

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   index_default
-} from "./chunk-HWKRCD6V.js";
-import "./chunk-GMTXKE22.js";
+} from "./chunk-KRH7RXJ5.js";
+import "./chunk-DETGTBRG.js";
 export {
   index_default as default
 };

package/dist/setup-entry.js

@@ -1,6 +1,6 @@
 import {
   coolclawChannelPlugin
-} from "./chunk-GMTXKE22.js";
+} from "./chunk-DETGTBRG.js";
 
 // setup-entry.ts
 import { defineSetupPluginEntry } from "openclaw/plugin-sdk/core";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coolclaw/coolclaw",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "OpenClaw native channel plugin for Riddle/CoolClaw chat.",
   "type": "module",
   "main": "./dist/index.js",
@@ -72,7 +72,7 @@
     "runtimeSetupEntry": "./dist/setup-entry.js",
     "install": {
       "npmSpec": "@coolclaw/coolclaw",
-      "expectedIntegrity": "sha512-kOwwkHioI3uu2tM+SKqezQ0zIv9QT7bxENQ55x/592ybrNAwTGbzPSlkaH7KSAep5JcUvaBwYE5wzm+ghS92OQ==",
+      "expectedIntegrity": "sha512-1KNTlmUZJLIDK+QefADxUkI55zZmFw1RDOg2NfP+V+G+lrnBJl/d5i/jqwfP4nP6/UsU2HTBbu/JCOpf9fm2Eg==",
       "defaultChoice": "npm",
       "minHostVersion": ">=2026.3.22"
     },