@coolclaw/coolclaw 1.0.13 → 1.0.15

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-3RAQ3GUM.js → chunk-R4H3YAWU.js}

@@ -356,6 +356,16 @@ function isRecord2(value) {
 }
 
 // src/inbound.ts
+var ARENA_REPORT_SHARE_NOTIFY_TYPE = "ARENA_REPORT_SHARE_REQUEST";
+var ARENA_MODEL_QUERY_NOTIFY_TYPE = "ARENA_MODEL_QUERY_REQUEST";
+var REPORT_SHARE_DEDUPE_LIMIT = 500;
+var MODEL_QUERY_DEDUPE_LIMIT = 500;
+var processedArenaReportShareEventIds = /* @__PURE__ */ new Set();
+var processedArenaReportShareEventOrder = [];
+var inFlightArenaReportShareEventIds = /* @__PURE__ */ new Map();
+var processedArenaModelQueryEventIds = /* @__PURE__ */ new Set();
+var processedArenaModelQueryEventOrder = [];
+var inFlightArenaModelQueryEventIds = /* @__PURE__ */ new Map();
 function mapInboundFrame(frame) {
   if (frame.type === "PRIVATE_MESSAGE") {
     const payload = assertPrivatePayload(frame.payload);
@@ -416,9 +426,73 @@ async function handleInboundFrame(input) {
     await ackFrameSeq(input);
     return;
   }
-  await input.dispatch(envelope);
+  let dedupeState = null;
+  if (isArenaReportShareEnvelope(envelope)) {
+    dedupeState = {
+      eventId: String(envelope.metadata.eventId),
+      processed: processedArenaReportShareEventIds,
+      inFlight: inFlightArenaReportShareEventIds,
+      remember: rememberArenaReportShareEventId
+    };
+  } else if (isArenaModelQueryEnvelope(envelope)) {
+    dedupeState = {
+      eventId: String(envelope.metadata.eventId),
+      processed: processedArenaModelQueryEventIds,
+      inFlight: inFlightArenaModelQueryEventIds,
+      remember: rememberArenaModelQueryEventId
+    };
+  }
+  if (dedupeState) {
+    if (dedupeState.processed.has(dedupeState.eventId)) {
+      await ackFrameSeq(input);
+      return;
+    }
+    const inFlight = dedupeState.inFlight.get(dedupeState.eventId);
+    if (inFlight) {
+      await inFlight;
+      if (dedupeState.processed.has(dedupeState.eventId)) {
+        await ackFrameSeq(input);
+        return;
+      }
+    }
+  }
+  let inFlightDeferred = null;
+  if (dedupeState) {
+    inFlightDeferred = createDeferred();
+    inFlightDeferred.promise.catch(() => void 0);
+    dedupeState.inFlight.set(dedupeState.eventId, inFlightDeferred.promise);
+  }
+  try {
+    await input.dispatch(envelope);
+    if (dedupeState) {
+      dedupeState.remember(dedupeState.eventId);
+      inFlightDeferred?.resolve();
+    }
+  } catch (error) {
+    inFlightDeferred?.reject(error);
+    throw error;
+  } finally {
+    if (dedupeState) {
+      dedupeState.inFlight.delete(dedupeState.eventId);
+    }
+  }
   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 isArenaModelQueryEnvelope(envelope) {
+  return envelope.metadata?.arenaModelQueryRequest === true && typeof envelope.metadata.eventId === "string" && envelope.metadata.eventId.length > 0 && typeof envelope.metadata.callbackUrl === "string" && envelope.metadata.callbackUrl.length > 0;
+}
 function mapNotificationFrame(frame) {
   const payload = isRecord3(frame.payload) ? frame.payload : {};
   const seq = typeof payload.seq === "number" ? payload.seq : void 0;
@@ -454,7 +528,13 @@ 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);
+    }
+    if (notifyType === ARENA_MODEL_QUERY_NOTIFY_TYPE) {
+      return mapArenaModelQueryFrame(frame, payload, seq);
+    }
+    const postId = payload.postId != null ? String(payload.postId) : "";
     return {
       id: frame.id,
       channel: "coolclaw",
@@ -468,6 +548,82 @@ function mapNotificationFrame(frame) {
   }
   return null;
 }
+function mapArenaModelQueryFrame(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 modelQueryPayload = isRecord3(payload.payload) ? payload.payload : {};
+  const roomId = Number(modelQueryPayload.roomId ?? 0);
+  const seatNumber = Number(modelQueryPayload.seatNumber ?? 0);
+  const seatEpoch = modelQueryPayload.seatEpoch != null ? String(modelQueryPayload.seatEpoch) : "";
+  const callbackUrl = typeof modelQueryPayload.callbackUrl === "string" ? modelQueryPayload.callbackUrl : "";
+  if (!callbackUrl) {
+    return null;
+  }
+  const deadlineEpochMs = Number(modelQueryPayload.deadlineEpochMs ?? 0);
+  return {
+    id: eventId,
+    channel: "coolclaw",
+    conversationId: `notification:arena_model_query:${eventId}`,
+    text: "/model",
+    messageType: frame.type,
+    seq,
+    shouldReply: true,
+    metadata: {
+      sourceFrameId: frame.id,
+      payload: frame.payload,
+      modelQueryPayload,
+      arenaModelQueryRequest: true,
+      eventId,
+      traceId,
+      roomId,
+      seatNumber,
+      seatEpoch,
+      callbackUrl,
+      deadlineEpochMs
+    }
+  };
+}
+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 rememberArenaModelQueryEventId(eventId) {
+  if (processedArenaModelQueryEventIds.has(eventId)) return;
+  processedArenaModelQueryEventIds.add(eventId);
+  processedArenaModelQueryEventOrder.push(eventId);
+  while (processedArenaModelQueryEventOrder.length > MODEL_QUERY_DEDUPE_LIMIT) {
+    const expired = processedArenaModelQueryEventOrder.shift();
+    if (expired) processedArenaModelQueryEventIds.delete(expired);
+  }
+}
 function mapGameEventFrame(frame, payload) {
   const eventType = typeof payload.eventType === "string" ? payload.eventType : "UNKNOWN";
   const agentTask = normalizeAgentTask(payload.agentTask);
@@ -940,6 +1096,117 @@ function parseErrorReason(error) {
   return error.error;
 }
 
+// src/arena-model-query.ts
+function parseArenaModelCurrent(rawText) {
+  if (!rawText) return null;
+  const match = /^\s*Current\s*[:：]\s*(.+)$/im.exec(rawText);
+  if (!match) return null;
+  const firstToken = match[1].trim().split(/\s+/)[0] ?? "";
+  const normalized = trimModelToken(firstToken);
+  if (!normalized || normalized.length > 255 || normalized.endsWith("/")) return null;
+  if (/^(usage|help|available|models?|current)$/i.test(normalized)) return null;
+  return normalized;
+}
+async function submitArenaModelQueryCallback(input) {
+  const start = Date.now();
+  const rawHash = input.rawText ? sha256Hex(input.rawText) : "";
+  const rawPreview = rawResponsePreview(input.rawText) ?? "";
+  try {
+    if (!input.meta.callbackUrl || !input.token) {
+      input.log?.warn?.(
+        `[ARENA-MODEL] callback skipped eventId=${input.meta.eventId} reason=missing_callback_or_token rawHash=${rawHash} rawPreview=${rawPreview}`
+      );
+      return { ok: false, error: "missing_callback_or_token" };
+    }
+    const fetchImpl = input.fetchImpl ?? globalThis.fetch;
+    if (typeof fetchImpl !== "function") {
+      input.log?.warn?.(`[ARENA-MODEL] callback skipped eventId=${input.meta.eventId} reason=fetch_unavailable`);
+      return { ok: false, error: "fetch_unavailable" };
+    }
+    const response = await fetchImpl(input.meta.callbackUrl, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${input.token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        eventId: input.meta.eventId,
+        roomId: input.meta.roomId,
+        seatNumber: input.meta.seatNumber,
+        seatEpoch: input.meta.seatEpoch,
+        rawText: input.rawText
+      })
+    });
+    const body = await readJsonObject(response);
+    const data = isRecord4(body.data) ? body.data : body;
+    const accepted = data.accepted === true;
+    const result = { ok: response.ok, status: response.status, accepted };
+    const level = response.ok ? "info" : "warn";
+    input.log?.[level]?.(
+      `[ARENA-MODEL] callback status=${response.status} accepted=${accepted} eventId=${input.meta.eventId} roomId=${input.meta.roomId} seatEpoch=${input.meta.seatEpoch} elapsedMs=${Date.now() - start} rawHash=${rawHash} rawPreview=${rawPreview}`
+    );
+    return result;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    input.log?.warn?.(
+      `[ARENA-MODEL] callback failed eventId=${input.meta.eventId} roomId=${input.meta.roomId} seatEpoch=${input.meta.seatEpoch} elapsedMs=${Date.now() - start} err=${message} rawHash=${rawHash} rawPreview=${rawPreview}`
+    );
+    return { ok: false, error: message };
+  }
+}
+function createArenaModelQueryReplyCollector(input) {
+  const blocks = [];
+  let submitted = false;
+  const submit = input.submit ?? ((rawText) => submitArenaModelQueryCallback({
+    meta: input.meta,
+    token: input.token,
+    rawText,
+    log: input.log
+  }));
+  async function submitOnce(rawText, reason) {
+    if (submitted) return;
+    submitted = true;
+    input.log?.info?.(
+      `[ARENA-MODEL] dispatch submit reason=${reason} eventId=${input.meta.eventId} roomId=${input.meta.roomId} seatEpoch=${input.meta.seatEpoch} blocks=${blocks.length} parsed=${parseArenaModelCurrent(rawText) ? "true" : "false"}`
+    );
+    await submit(rawText);
+  }
+  return {
+    async deliver(text) {
+      if (submitted || !text) return;
+      blocks.push(text);
+      const full = blocks.join("");
+      input.log?.info?.(
+        `[ARENA-MODEL] dispatch block eventId=${input.meta.eventId} roomId=${input.meta.roomId} seatEpoch=${input.meta.seatEpoch} blocks=${blocks.length} parsed=${parseArenaModelCurrent(full) ? "true" : "false"}`
+      );
+      if (parseArenaModelCurrent(full)) {
+        await submitOnce(full, "parsed");
+      }
+    },
+    async finalize() {
+      if (submitted) return;
+      await submitOnce(blocks.join(""), "final");
+    }
+  };
+}
+function trimModelToken(token) {
+  let value = token.trim();
+  value = value.replace(/^[`"'“”‘’<({\[【]+/, "");
+  value = value.replace(/[`"'“”‘’>)}\]】。．.，,；;:：]+$/g, "");
+  return value.trim();
+}
+async function readJsonObject(response) {
+  try {
+    const body = await response.json();
+    return isRecord4(body) ? body : {};
+  } catch {
+    return {};
+  }
+}
+function isRecord4(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/ws-client.ts
 import WebSocket from "ws";
 var CoolclawWsClient = class {
@@ -1152,18 +1419,18 @@ var CoolclawWsClient = class {
   }
 };
 function readPingInterval(payload) {
-  if (!isRecord4(payload) || typeof payload.pingIntervalMs !== "number" || payload.pingIntervalMs <= 0) {
+  if (!isRecord5(payload) || typeof payload.pingIntervalMs !== "number" || payload.pingIntervalMs <= 0) {
     return void 0;
   }
   return payload.pingIntervalMs;
 }
 function readErrorMessage(payload) {
-  if (isRecord4(payload) && typeof payload.message === "string") {
+  if (isRecord5(payload) && typeof payload.message === "string") {
     return payload.message;
   }
   return "CoolClaw request failed";
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null;
 }
 
@@ -1319,6 +1586,18 @@ function isNoReplyText(text) {
   const lastLine = lines.at(-1)?.toUpperCase();
   return lastLine ? noReplyTokens.has(lastLine) : false;
 }
+function shouldSuppressCoolclawTextDelivery(envelope) {
+  return envelope.metadata?.gameEvent === true || isArenaReportShareEnvelope(envelope) || isArenaModelQueryEnvelope(envelope);
+}
+async function finalizeArenaModelQueryAfterDispatchError(params) {
+  if (!params.collector) {
+    return false;
+  }
+  const errMsg = params.error instanceof Error ? params.error.message : String(params.error);
+  params.log?.warn?.(`[ARENA-MODEL] dispatch failed; submitting fallback callback eventId=${params.eventId ?? ""} err=${errMsg}`);
+  await params.collector.finalize();
+  return true;
+}
 var runtimeClients = /* @__PURE__ */ new Map();
 function setRuntimeClient(accountKey, client) {
   runtimeClients.set(accountKey, client);
@@ -1467,18 +1746,38 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                     ackStore,
                     dispatch: async (envelope) => {
                       const isGameEvent = envelope.metadata?.gameEvent === true;
+                      const isArenaReportShare = isArenaReportShareEnvelope(envelope);
+                      const isArenaModelQuery = isArenaModelQueryEnvelope(envelope);
+                      const suppressChatTextDelivery = shouldSuppressCoolclawTextDelivery(envelope);
                       const gameMeta = isGameEvent ? envelope.metadata : null;
+                      const modelQueryMeta = isArenaModelQuery ? envelope.metadata : null;
                       let gameSubmitted = false;
                       let gameFallbackReason = null;
                       let gameModelActionType;
                       let gameValidationReason;
                       let gameModelActionRejected;
                       const gameBuffer = [];
+                      const modelQueryCollector = modelQueryMeta ? createArenaModelQueryReplyCollector({
+                        meta: modelQueryMeta,
+                        token,
+                        log: ctx.log
+                      }) : null;
                       if (isGameEvent && gameMeta) {
                         ctx.log?.info?.(
                           `[GAME-TASK] dispatch start gameId=${gameMeta.gameId} roomId=${gameMeta.roomId} eventType=${gameMeta.eventType} eventId=${gameMeta.eventId} promptPolicyVersion=${gameMeta.promptPolicyVersion ?? ""} renderedPromptHash=${gameMeta.renderedPromptHash ?? ""} conversationId=${envelope.conversationId}`
                         );
                       }
+                      if (modelQueryMeta) {
+                        let callbackHost = "";
+                        try {
+                          callbackHost = new URL(modelQueryMeta.callbackUrl).host;
+                        } catch {
+                          callbackHost = "invalid";
+                        }
+                        ctx.log?.info?.(
+                          `[ARENA-MODEL] inbound eventId=${modelQueryMeta.eventId} traceId=${modelQueryMeta.traceId ?? ""} roomId=${modelQueryMeta.roomId} seatEpoch=${modelQueryMeta.seatEpoch} callbackHost=${callbackHost} conversationId=${envelope.conversationId}`
+                        );
+                      }
                       const runtime = getCoolclawRuntime();
                       let runtimeChannel;
                       try {
@@ -1501,6 +1800,15 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                           }
                           return;
                         }
+                        if (modelQueryMeta) {
+                          await submitArenaModelQueryCallback({
+                            meta: modelQueryMeta,
+                            token,
+                            rawText: "",
+                            log: ctx.log
+                          });
+                          return;
+                        }
                         throw err;
                       }
                       try {
@@ -1526,13 +1834,13 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                           ctx.cfg.session?.store,
                           { agentId: route.agentId }
                         );
-                        const senderLabel = envelope.sender ? `${envelope.sender.userType.toLowerCase()}:${envelope.sender.userId}` : isGameEvent ? `game:${gameMeta.gameId}` : "unknown";
+                        const senderLabel = envelope.sender ? `${envelope.sender.userType.toLowerCase()}:${envelope.sender.userId}` : isGameEvent ? `game:${gameMeta.gameId}` : modelQueryMeta ? `arena-model:${modelQueryMeta.roomId}` : "unknown";
                         let deliveryTarget;
                         if (envelope.group) {
                           deliveryTarget = `coolclaw:group:${envelope.group.groupId}`;
                         } else if (envelope.sender) {
                           deliveryTarget = `coolclaw:${envelope.sender.userType.toLowerCase()}:${envelope.sender.userId}`;
-                        } else if (isGameEvent) {
+                        } else if (isGameEvent || isArenaModelQuery) {
                           deliveryTarget = `coolclaw:agent:${account.agentId}`;
                         } else {
                           deliveryTarget = normalizeCoolclawTarget(envelope.conversationId);
@@ -1596,6 +1904,10 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                               if (!payload.text) return;
                               const replyText = String(payload.text);
                               if (!isGameEvent && isNoReplyText(replyText)) return;
+                              if (modelQueryCollector) {
+                                await modelQueryCollector.deliver(replyText);
+                                return;
+                              }
                               if (isGameEvent && gameMeta) {
                                 if (gameSubmitted) return;
                                 gameBuffer.push(String(payload.text));
@@ -1635,6 +1947,14 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                                 }
                                 return;
                               }
+                              if (isArenaReportShare) {
+                                ctx.log?.info?.(`[ARENA-REPORT-SHARE] ignored non-chat completion text eventId=${envelope.metadata.eventId ?? ""}`);
+                                return;
+                              }
+                              if (suppressChatTextDelivery) {
+                                ctx.log?.error?.(`[ARENA-MODEL] chat delivery blocked eventId=${envelope.metadata.eventId ?? ""}`);
+                                return;
+                              }
                               try {
                                 let replyTarget;
                                 if (envelope.group) {
@@ -1659,9 +1979,20 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                             gameFallbackReason = "no_valid_action_in_llm_output";
                           }
                         }
+                        if (modelQueryCollector) {
+                          await modelQueryCollector.finalize();
+                        }
                       } catch (err) {
                         const errMsg = err instanceof Error ? err.message : String(err);
                         ctx.log?.error(`Inbound dispatch error: ${errMsg}`);
+                        if (await finalizeArenaModelQueryAfterDispatchError({
+                          collector: modelQueryCollector,
+                          eventId: modelQueryMeta?.eventId,
+                          error: err,
+                          log: ctx.log
+                        })) {
+                          return;
+                        }
                         if (isGameEvent && gameMeta && !gameSubmitted) {
                           gameFallbackReason = `dispatch_error: ${errMsg}`;
                         }
@@ -1856,6 +2187,9 @@ var coolclawChannelPlugin = createChatChannelPlugin({
   }
 });
 function buildBodyForAgent(envelope) {
+  if (isArenaReportShareEnvelope(envelope)) {
+    return buildArenaReportShareBodyForAgent(envelope);
+  }
   if (!envelope.group) {
     if (envelope.sender && envelope.recipient) {
       return buildPrivateBodyForAgent(envelope);
@@ -1901,6 +2235,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-ITAZ7RTC.js → chunk-RCPRLBZL.js}

@@ -3,7 +3,7 @@ import {
   coolclawChannelPlugin,
   defaultBindingFile,
   setCoolclawRuntime
-} from "./chunk-3RAQ3GUM.js";
+} from "./chunk-R4H3YAWU.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-ITAZ7RTC.js";
-import "./chunk-3RAQ3GUM.js";
+} from "./chunk-RCPRLBZL.js";
+import "./chunk-R4H3YAWU.js";
 
 // cli-metadata.ts
 var cli_metadata_default = index_default;

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   index_default
-} from "./chunk-ITAZ7RTC.js";
-import "./chunk-3RAQ3GUM.js";
+} from "./chunk-RCPRLBZL.js";
+import "./chunk-R4H3YAWU.js";
 export {
   index_default as default
 };

package/dist/setup-entry.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coolclaw/coolclaw",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "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-lRGll+tauQxhgsqtOWlEkM+MKZwDQpib/s1A4mZSQB+PDRsvMzuXKQiX0ipEUQo1/HPjlLgDRkM/5A6GX45kag==",
+      "expectedIntegrity": "sha512-W0ARihskllfGJhQE00/znWvLszcLNgSa1FZPblBs176iVJ/o6jR+7N3Khl8njWMtrvd1v3nkrB4eIuvEiIg4vg==",
       "defaultChoice": "npm",
       "minHostVersion": ">=2026.3.22"
     },