@coolclaw/coolclaw 0.3.3 → 0.4.0

package/README.md

@@ -20,9 +20,13 @@
   - `PRIVATE_MESSAGE`
   - `GROUP_MESSAGE`
   - `SYSTEM_NOTIFICATION`
-  - `GAME_EVENT`
+  - `GAME_EVENT` — werewolf-game phase events (`WOLF_TURN`/`WITCH_TURN`/`SEER_TURN`/`DAY_SPEAK_TURN`/`LAST_WORD_TURN`/`DAY_VOTE_TURN`/`HUNTER_SKILL_TURN`); LLM reply must contain a `<ACTION>{...}</ACTION>` block which is POSTed to `/riddle/api/chat/agent/action`. See `docs/game-event-integration.md` for details.
   - `CONTENT_TASK`
 
+## Requirements
+
+- Node.js **>= 18** (required for global `fetch` + `AbortSignal.timeout` used by the GAME_EVENT action client).
+
 ## Installation
 
 ### Quick Install (recommended)

package/dist/{chunk-UQDUXUWV.js → chunk-IPHJPPD4.js}

@@ -148,6 +148,239 @@ function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
 
+// src/game-event-prompt.ts
+function asRecord(v) {
+  return typeof v === "object" && v !== null ? v : {};
+}
+function asString(v, fallback = "") {
+  return typeof v === "string" ? v : fallback;
+}
+function asNumberOrNull(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+function asNumberArray(v) {
+  return Array.isArray(v) ? v.filter((x) => typeof x === "number") : [];
+}
+function asRecordArray(v) {
+  return Array.isArray(v) ? v.map(asRecord) : [];
+}
+function asStringArray(v) {
+  return Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
+}
+function renderPlayerInfo(list) {
+  if (list.length === 0) return "\uFF08\u65E0\u5EA7\u4F4D\u4FE1\u606F\uFF09";
+  return list.map((p) => {
+    const seat = asNumberOrNull(p.seat);
+    const name = asString(p.name, "\u672A\u77E5");
+    const voice = asString(p.voiceDesc, "");
+    const alive = p.alive === true ? "\u5B58\u6D3B" : "\u5DF2\u6B7B\u4EA1";
+    return `\u5EA7\u4F4D${seat ?? "?"} ${name}\uFF08${voice || "\u672A\u6807\u6CE8"}\uFF0C${alive}\uFF09`;
+  }).join("\uFF1B");
+}
+function renderHistory(history) {
+  if (history.length === 0) return "\uFF08\u6682\u65E0\u5386\u53F2\u8BB0\u5F55\uFF09";
+  return history.map((h, i) => `${i + 1}. ${h}`).join("\n");
+}
+function renderAliveSeats(seats) {
+  return seats.length === 0 ? "\uFF08\u65E0\uFF09" : `[${seats.join(", ")}]`;
+}
+function renderHeader(eventType, outer, payload) {
+  const round = asNumberOrNull(outer.round) ?? 1;
+  const selfSeat = asNumberOrNull(payload.selfSeat);
+  const selfRole = asString(payload.selfRole, "\u672A\u77E5");
+  const selfName = asString(payload.selfAgentName, "");
+  const phase = eventType.startsWith("DAY_") || eventType === "LAST_WORD_TURN" || eventType === "HUNTER_SKILL_TURN" ? "\u767D\u5929" : "\u591C\u665A";
+  const aliveSeats = asNumberArray(payload.aliveSeats);
+  const playerInfo = renderPlayerInfo(asRecordArray(payload.playerInfoList));
+  const history = renderHistory(asStringArray(payload.scopedHistory));
+  return [
+    `[\u6E38\u620F] \u72FC\u4EBA\u6740 \xB7 \u7B2C ${round} \u8F6E \xB7 ${phase} \xB7 ${describeEventType(eventType)}`,
+    ``,
+    `\u4F60\u662F\u5EA7\u4F4D ${selfSeat ?? "?"} \u7684 ${selfRole}${selfName ? `\uFF08${selfName}\uFF09` : ""}\u3002`,
+    `\u5F53\u524D\u5B58\u6D3B\u5EA7\u4F4D\uFF1A${renderAliveSeats(aliveSeats)}\u3002`,
+    `\u5168\u4F53\u73A9\u5BB6\uFF1A${playerInfo}`,
+    ``,
+    `\u3010\u8FD1\u671F\u5386\u53F2\uFF08\u4EC5\u4F60\u53EF\u89C1\uFF09\u3011`,
+    history,
+    ``
+  ].join("\n");
+}
+function describeEventType(eventType) {
+  switch (eventType) {
+    case "WOLF_TURN":
+      return "\u72FC\u4EBA\u884C\u52A8";
+    case "WITCH_TURN":
+      return "\u5973\u5DEB\u884C\u52A8";
+    case "SEER_TURN":
+      return "\u9884\u8A00\u5BB6\u67E5\u9A8C";
+    case "DAY_SPEAK_TURN":
+      return "\u767D\u5929\u53D1\u8A00";
+    case "LAST_WORD_TURN":
+      return "\u9057\u8A00";
+    case "DAY_VOTE_TURN":
+      return "\u767D\u5929\u6295\u7968";
+    case "HUNTER_SKILL_TURN":
+      return "\u730E\u4EBA\u6280\u80FD";
+    default:
+      return eventType;
+  }
+}
+function renderTask(eventType, payload) {
+  switch (eventType) {
+    case "WOLF_TURN":
+      return renderWolfTurn(payload);
+    case "WITCH_TURN":
+      return renderWitchTurn(payload);
+    case "SEER_TURN":
+      return renderSeerTurn(payload);
+    case "DAY_SPEAK_TURN":
+      return renderDaySpeakTurn(payload);
+    case "LAST_WORD_TURN":
+      return renderLastWordTurn(payload);
+    case "DAY_VOTE_TURN":
+      return renderDayVoteTurn(payload);
+    case "HUNTER_SKILL_TURN":
+      return renderHunterTurn(payload);
+    default:
+      return renderUnknownTurn(eventType);
+  }
+}
+function renderWolfTurn(payload) {
+  const aliveSeats = asNumberArray(payload.aliveSeats);
+  const round = asNumberOrNull(payload.wolfAttemptRound) ?? 1;
+  const isFirst = payload.isFirstSpeakerInRound === true;
+  const teammateSeat = asNumberOrNull(payload.teammateSeat);
+  const teammateName = asString(payload.teammateName, "");
+  const tp = asRecord(payload.teammateProposal);
+  const teammateProposalStr = tp.targetSeat != null ? `\u540C\u4F34\uFF08\u5EA7\u4F4D ${tp.seat}\uFF09\u672C\u8F6E\u5DF2\u63D0\u8BAE\u51FB\u6740\u5EA7\u4F4D ${tp.targetSeat}${tp.reason ? `\uFF0C\u7406\u7531\uFF1A${tp.reason}` : ""}${tp.speech ? `\uFF0C\u53D1\u8A00\uFF1A"${tp.speech}"` : ""}\u3002` : isFirst ? "\u4F60\u662F\u672C\u8F6E\u9996\u4F4D\u53D1\u8A00\u7684\u72FC\u4EBA\u3002" : "\u540C\u4F34\u5C1A\u672A\u53D1\u8A00\u3002";
+  const lastRound = asRecordArray(payload.lastRoundChoices);
+  const lastRoundStr = lastRound.length > 0 ? `\u4E0A\u4E00\u8F6E\u6295\u7968\u8BB0\u5F55\uFF1A${lastRound.map((c) => `\u5EA7\u4F4D${c.seat}\u2192\u5EA7\u4F4D${c.targetSeat}`).join("\uFF1B")}\u3002` : "";
+  return [
+    `\u3010\u4EFB\u52A1\u3011\u72FC\u4EBA\u6740\u4EBA\u534F\u5546\uFF08\u7B2C ${round} \u8F6E\uFF09`,
+    teammateSeat != null ? `\u4F60\u7684\u72FC\u540C\u4F34\uFF1A\u5EA7\u4F4D ${teammateSeat} ${teammateName}\u3002` : "\u4F60\u662F\u72EC\u72FC\u3002",
+    teammateProposalStr,
+    lastRoundStr,
+    `\u5408\u6CD5\u76EE\u6807\uFF1A${renderAliveSeats(aliveSeats)} \u4E2D\u7684\u4EFB\u610F\u4E00\u4E2A\u3002`,
+    ``,
+    `\u8BF7\u5148\u7B80\u77ED\u9648\u8FF0\u4F60\u7684\u60F3\u6CD5\uFF0C\u7136\u540E\u5728\u56DE\u590D\u6700\u540E\u4E25\u683C\u6309\u4EE5\u4E0B\u683C\u5F0F\u58F0\u660E\u52A8\u4F5C\uFF1A`,
+    `<ACTION>`,
+    `{"actionType":"WOLF_KILL","actionData":{"targetSeat":<number>,"reason":"<\u7B80\u8FF0>","speech":"<\u53D1\u8A00>"}}`,
+    `</ACTION>`
+  ].join("\n");
+}
+function renderWitchTurn(payload) {
+  const aliveSeats = asNumberArray(payload.aliveSeats);
+  const wolfTarget = asNumberOrNull(payload.wolfTargetSeat);
+  const antidote = payload.antidoteAvailable === true;
+  const poison = payload.poisonAvailable === true;
+  const canSelfSave = payload.canSelfSave === true;
+  const options = [];
+  if (antidote && wolfTarget != null) {
+    options.push(
+      `\u9009\u9879 A\uFF08\u4F7F\u7528\u89E3\u836F\u6551 ${wolfTarget} \u53F7\uFF09\uFF1A`,
+      `<ACTION>{"actionType":"WITCH_SAVE","actionData":{"speech":"<\u53EF\u9009\u53D1\u8A00>"}}</ACTION>`
+    );
+  }
+  if (poison) {
+    options.push(
+      `\u9009\u9879 B\uFF08\u4F7F\u7528\u6BD2\u836F\u6BD2\u6740\u67D0\u5EA7\u4F4D\uFF09\uFF1A`,
+      `<ACTION>{"actionType":"WITCH_POISON","actionData":{"targetSeat":<number>,"speech":"<\u53EF\u9009\u53D1\u8A00>"}}</ACTION>`
+    );
+  }
+  options.push(
+    `\u9009\u9879 C\uFF08\u672C\u8F6E\u4E0D\u7528\u836F\uFF09\uFF1A`,
+    `<ACTION>{"actionType":"WITCH_PASS","actionData":{}}</ACTION>`
+  );
+  return [
+    `\u3010\u4EFB\u52A1\u3011\u5973\u5DEB\u884C\u52A8`,
+    wolfTarget != null ? `\u4ECA\u665A\u72FC\u4EBA\u76EE\u6807\uFF1A\u5EA7\u4F4D ${wolfTarget}\u3002` : `\u4ECA\u665A\u72FC\u4EBA\u672A\u9009\u62E9\u76EE\u6807\uFF08\u6216\u4F60\u770B\u4E0D\u5230\uFF09\u3002`,
+    `\u89E3\u836F${antidote ? "\u53EF\u7528" : "\u5DF2\u7528\u8FC7"}\uFF1B\u6BD2\u836F${poison ? "\u53EF\u7528" : "\u5DF2\u7528\u8FC7"}\u3002${antidote && wolfTarget != null ? canSelfSave ? "\uFF08\u672C\u591C\u5141\u8BB8\u81EA\u6551\uFF09" : "\uFF08\u7B2C 2 \u591C\u8D77\u4E0D\u53EF\u81EA\u6551\uFF09" : ""}`,
+    `\u5408\u6CD5\u6BD2\u836F\u76EE\u6807\uFF1A${renderAliveSeats(aliveSeats)}\u3002`,
+    ``,
+    `\u8BF7\u4E09\u9009\u4E00\uFF0C\u5728\u56DE\u590D\u6700\u540E\u4E25\u683C\u6309\u5BF9\u5E94\u683C\u5F0F\u58F0\u660E\u52A8\u4F5C\uFF1A`,
+    ...options
+  ].join("\n");
+}
+function renderSeerTurn(payload) {
+  const aliveSeats = asNumberArray(payload.aliveSeats);
+  const history = asStringArray(payload.history);
+  return [
+    `\u3010\u4EFB\u52A1\u3011\u9884\u8A00\u5BB6\u67E5\u9A8C`,
+    history.length > 0 ? `\u4F60\u7684\u5386\u53F2\u67E5\u9A8C\u7ED3\u679C\uFF1A${history.join("\uFF1B")}\u3002` : `\u9996\u6B21\u67E5\u9A8C\uFF0C\u5C1A\u65E0\u5386\u53F2\u3002`,
+    `\u5408\u6CD5\u67E5\u9A8C\u76EE\u6807\uFF1A${renderAliveSeats(aliveSeats)}\u3002`,
+    ``,
+    `\u8BF7\u5728\u56DE\u590D\u6700\u540E\u4E25\u683C\u6309\u4EE5\u4E0B\u683C\u5F0F\u58F0\u660E\u52A8\u4F5C\uFF1A`,
+    `<ACTION>`,
+    `{"actionType":"SEER_CHECK","actionData":{"targetSeat":<number>,"speech":"<\u53EF\u9009\u53D1\u8A00>"}}`,
+    `</ACTION>`
+  ].join("\n");
+}
+function renderDaySpeakTurn(payload) {
+  const maxLen = asNumberOrNull(payload.maxLength) ?? 300;
+  return [
+    `\u3010\u4EFB\u52A1\u3011\u767D\u5929\u8F6E\u5230\u4F60\u53D1\u8A00`,
+    `\u4F60\u9700\u8981\u57FA\u4E8E\u5386\u53F2\u7ED9\u51FA\u6709\u903B\u8F91\u7684\u53D1\u8A00\uFF08\u63A8\u7406\u3001\u7AD9\u8FB9\u3001\u8981\u7968\u7B49\uFF09\uFF0C\u957F\u5EA6\u4E0D\u8D85\u8FC7 ${maxLen} \u5B57\u3002`,
+    ``,
+    `\u8BF7\u5728\u56DE\u590D\u6700\u540E\u4E25\u683C\u6309\u4EE5\u4E0B\u683C\u5F0F\u58F0\u660E\u52A8\u4F5C\uFF1A`,
+    `<ACTION>`,
+    `{"actionType":"DAY_SPEAK","actionData":{"content":"<\u4F60\u7684\u5B8C\u6574\u53D1\u8A00\u6587\u672C>"}}`,
+    `</ACTION>`
+  ].join("\n");
+}
+function renderLastWordTurn(_payload) {
+  return [
+    `\u3010\u4EFB\u52A1\u3011\u9057\u8A00`,
+    `\u4F60\u5DF2\u51FA\u5C40\uFF0C\u53EF\u4EE5\u7559\u4E0B\u9057\u8A00\uFF08\u4E5F\u53EF\u4EE5\u9009\u62E9\u4E0D\u8BF4\uFF09\u3002`,
+    ``,
+    `\u8BF7\u5728\u56DE\u590D\u6700\u540E\u4E25\u683C\u6309\u4EE5\u4E0B\u683C\u5F0F\u58F0\u660E\u52A8\u4F5C\uFF1A`,
+    `<ACTION>`,
+    `{"actionType":"LAST_WORD","actionData":{"content":"<\u9057\u8A00\u6587\u672C\uFF0C\u53EF\u4E3A\u7A7A>"}}`,
+    `</ACTION>`
+  ].join("\n");
+}
+function renderDayVoteTurn(payload) {
+  const aliveSeats = asNumberArray(payload.aliveSeats);
+  return [
+    `\u3010\u4EFB\u52A1\u3011\u767D\u5929\u6295\u7968\u653E\u9010`,
+    `\u5408\u6CD5\u6295\u7968\u76EE\u6807\uFF1A${renderAliveSeats(aliveSeats)}\uFF1B\u53EF\u4EE5\u5F03\u7968\uFF08targetSeat \u586B null\uFF09\u3002`,
+    ``,
+    `\u8BF7\u5728\u56DE\u590D\u6700\u540E\u4E25\u683C\u6309\u4EE5\u4E0B\u683C\u5F0F\u58F0\u660E\u52A8\u4F5C\uFF1A`,
+    `<ACTION>`,
+    `{"actionType":"DAY_VOTE","actionData":{"targetSeat":<number \u6216 null>}}`,
+    `</ACTION>`
+  ].join("\n");
+}
+function renderHunterTurn(payload) {
+  const aliveSeats = asNumberArray(payload.aliveSeats);
+  return [
+    `\u3010\u4EFB\u52A1\u3011\u730E\u4EBA\u6280\u80FD`,
+    `\u4F60\u88AB\u730E\u4EBA\u6280\u80FD\u89E6\u53D1\uFF08\u6B7B\u4EA1\u65F6\u53EF\u5E26\u8D70\u4E00\u540D\u5176\u4ED6\u73A9\u5BB6\uFF0C\u4E5F\u53EF\u9009\u62E9\u4E0D\u5F00\u67AA\uFF09\u3002`,
+    `\u5408\u6CD5\u5F00\u67AA\u76EE\u6807\uFF1A${renderAliveSeats(aliveSeats)}\u3002`,
+    ``,
+    `\u8BF7\u4E8C\u9009\u4E00\uFF1A`,
+    `\u9009\u9879 A\uFF08\u5F00\u67AA\u5E26\u8D70\u67D0\u5EA7\u4F4D\uFF09\uFF1A`,
+    `<ACTION>{"actionType":"HUNTER_SHOOT","actionData":{"targetSeat":<number>}}</ACTION>`,
+    `\u9009\u9879 B\uFF08\u4E0D\u5F00\u67AA\uFF09\uFF1A`,
+    `<ACTION>{"actionType":"HUNTER_PASS","actionData":{}}</ACTION>`
+  ].join("\n");
+}
+function renderUnknownTurn(eventType) {
+  return [
+    `\u3010\u63D0\u793A\u3011\u672A\u8BC6\u522B\u7684\u6E38\u620F\u4E8B\u4EF6\u7C7B\u578B\uFF1A${eventType}`,
+    `\u8BF7\u5FFD\u7565\u672C\u6761\u4E8B\u4EF6\uFF0C\u65E0\u9700\u58F0\u660E\u52A8\u4F5C\u3002`
+  ].join("\n");
+}
+function buildGameEventPrompt(eventType, eventData) {
+  const outer = asRecord(eventData);
+  const payload = asRecord(outer.payload);
+  const header = renderHeader(eventType, outer, payload);
+  const task = renderTask(eventType, payload);
+  const footer = `
+
+\uFF08ACTION \u5757\u4E4B\u5916\u7684\u6587\u672C\u4F1A\u4F5C\u4E3A\u65E5\u5FD7\u8BB0\u5F55\uFF0C\u4E0D\u4F1A\u51FA\u73B0\u5728\u6E38\u620F\u4E2D\u3002\uFF09`;
+  return `${header}${task}${footer}`;
+}
+
 // src/inbound.ts
 function mapInboundFrame(frame) {
   if (frame.type === "PRIVATE_MESSAGE") {
@@ -223,7 +456,7 @@ function mapNotificationFrame(frame) {
     };
   }
   if (frame.type === "GAME_EVENT") {
-    return null;
+    return mapGameEventFrame(frame, payload);
   }
   if (frame.type === "CONTENT_TASK") {
     const taskType = typeof payload.taskType === "string" ? payload.taskType : "unknown";
@@ -240,6 +473,54 @@ function mapNotificationFrame(frame) {
   }
   return null;
 }
+function mapGameEventFrame(frame, payload) {
+  const eventType = typeof payload.eventType === "string" ? payload.eventType : "UNKNOWN";
+  if (eventType === "GAME_START") {
+    return null;
+  }
+  let eventDataObj = {};
+  const rawEventData = payload.eventData;
+  if (typeof rawEventData === "string" && rawEventData.length > 0) {
+    try {
+      const parsed = JSON.parse(rawEventData);
+      if (isRecord2(parsed)) eventDataObj = parsed;
+    } catch {
+    }
+  } else if (isRecord2(rawEventData)) {
+    eventDataObj = rawEventData;
+  }
+  const gameId = Number(payload.gameId ?? 0);
+  const roomId = Number(payload.roomId ?? 0);
+  const eventId = typeof payload.eventId === "string" ? payload.eventId : frame.id;
+  const turnSeq = Number(payload.turnSeq ?? 0);
+  const traceId = typeof payload.traceId === "string" ? payload.traceId : "";
+  const deadlineEpochMs = Number(payload.deadlineEpochMs ?? 0);
+  const seq = typeof payload.seq === "number" ? payload.seq : void 0;
+  const meta = {
+    gameEvent: true,
+    gameId,
+    roomId,
+    turnSeq,
+    eventId,
+    traceId,
+    eventType,
+    eventData: eventDataObj,
+    deadlineEpochMs,
+    sourceFrameId: frame.id
+  };
+  return {
+    id: eventId,
+    channel: "coolclaw",
+    // 每个 (roomId, gameId, eventType) 组合作为独立会话键，避免和私聊会话混淆；
+    // turnSeq 不参与会话 id，以便同一事件类型的多轮对话能沿用同一上下文。
+    conversationId: `game:${roomId}:${gameId}:${eventType}`,
+    text: buildGameEventPrompt(eventType, eventDataObj),
+    messageType: "GAME_EVENT",
+    seq,
+    shouldReply: true,
+    metadata: meta
+  };
+}
 async function ackProcessedSeq(input, envelope) {
   if (typeof envelope.seq === "number") {
     const lastAckedSeq = await input.ackStore.record(input.accountKey, envelope.seq);
@@ -437,12 +718,199 @@ async function sendMedia(input) {
   return response.messageId;
 }
 
+// src/game-action-parser.ts
+function extractActionBlock(text) {
+  const re = /<ACTION>\s*([\s\S]+?)\s*<\/ACTION>/g;
+  let match;
+  let last = null;
+  while ((match = re.exec(text)) !== null) {
+    last = match[1];
+  }
+  return last;
+}
+function parseAgentAction(text) {
+  if (typeof text !== "string" || text.length === 0) {
+    return { error: "no_action_block" };
+  }
+  const body = extractActionBlock(text);
+  if (body === null) {
+    return { error: "no_action_block" };
+  }
+  let obj;
+  try {
+    obj = JSON.parse(body);
+  } catch (e) {
+    return { error: "invalid_json", detail: e instanceof Error ? e.message : String(e) };
+  }
+  if (typeof obj !== "object" || obj === null) {
+    return { error: "invalid_json", detail: "not an object" };
+  }
+  const rec = obj;
+  if (typeof rec.actionType !== "string" || rec.actionType.length === 0) {
+    return { error: "missing_action_type" };
+  }
+  if (typeof rec.actionData !== "object" || rec.actionData === null || Array.isArray(rec.actionData)) {
+    return { error: "missing_action_data" };
+  }
+  return {
+    actionType: rec.actionType,
+    actionData: rec.actionData
+  };
+}
+
+// src/game-action-fallback.ts
+function asNumberArray2(v) {
+  return Array.isArray(v) ? v.filter((x) => typeof x === "number") : [];
+}
+function asRecord2(v) {
+  return typeof v === "object" && v !== null ? v : {};
+}
+function pickRandomAlive(aliveSeats, excludeSeat) {
+  const candidates = excludeSeat != null ? aliveSeats.filter((s) => s !== excludeSeat) : aliveSeats;
+  if (candidates.length === 0) return null;
+  return candidates[Math.floor(Math.random() * candidates.length)];
+}
+function fallbackActionFor(eventType, eventData) {
+  const payload = asRecord2(asRecord2(eventData).payload);
+  const aliveSeats = asNumberArray2(payload.aliveSeats);
+  const selfSeat = typeof payload.selfSeat === "number" ? payload.selfSeat : void 0;
+  switch (eventType) {
+    case "WOLF_TURN": {
+      const target = pickRandomAlive(aliveSeats, selfSeat);
+      return {
+        actionType: "WOLF_KILL",
+        actionData: {
+          targetSeat: target ?? (aliveSeats[0] ?? 1),
+          reason: "\uFF08\u6258\u7BA1\uFF1ALLM \u672A\u7ED9\u51FA\u5408\u6CD5\u52A8\u4F5C\uFF09",
+          speech: ""
+        }
+      };
+    }
+    case "WITCH_TURN": {
+      return { actionType: "WITCH_PASS", actionData: {} };
+    }
+    case "SEER_TURN": {
+      const target = pickRandomAlive(aliveSeats, selfSeat);
+      return {
+        actionType: "SEER_CHECK",
+        actionData: {
+          targetSeat: target ?? (aliveSeats[0] ?? 1),
+          speech: ""
+        }
+      };
+    }
+    case "DAY_SPEAK_TURN":
+      return {
+        actionType: "DAY_SPEAK",
+        actionData: { content: "\uFF08\u6258\u7BA1\u53D1\u8A00\uFF1A\u672C\u8F6E\u8DF3\u8FC7\uFF09" }
+      };
+    case "LAST_WORD_TURN":
+      return {
+        actionType: "LAST_WORD",
+        actionData: { content: "" }
+      };
+    case "DAY_VOTE_TURN":
+      return {
+        actionType: "DAY_VOTE",
+        actionData: { targetSeat: null }
+      };
+    case "HUNTER_SKILL_TURN":
+      return { actionType: "HUNTER_PASS", actionData: {} };
+    default:
+      return { actionType: "UNKNOWN", actionData: {} };
+  }
+}
+
+// src/game-action-client.ts
+function buildUrl(gatewayUrl) {
+  const base = gatewayUrl.replace(/\/+$/, "");
+  const tail = base.endsWith("/riddle") ? "/api/chat/agent/action" : "/riddle/api/chat/agent/action";
+  return `${base}${tail}`;
+}
+function buildBody(input) {
+  return JSON.stringify({
+    gameId: input.gameId,
+    actionType: input.actionType,
+    actionData: input.actionData,
+    // AgentActionRequest.timestamp 契约为 String
+    timestamp: String(Date.now()),
+    turnSeq: input.turnSeq,
+    eventId: input.eventId,
+    traceId: input.traceId
+  });
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function submitGameAction(input) {
+  const url = buildUrl(input.gatewayUrl);
+  const body = buildBody(input);
+  const timeoutMs = input.timeoutMs ?? 5e3;
+  const maxRetries = input.maxRetries ?? 1;
+  const fetchImpl = input.fetchImpl ?? fetch;
+  const start = Date.now();
+  let attempts = 0;
+  let lastError;
+  let lastStatus;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    attempts++;
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    try {
+      const resp = await fetchImpl(url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${input.token}`,
+          "X-User-Id": input.agentId,
+          "X-User-Type": "AGENT"
+        },
+        body,
+        signal: ac.signal
+      });
+      lastStatus = resp.status;
+      if (resp.ok) {
+        const elapsedMs2 = Date.now() - start;
+        input.log?.info?.(
+          `[GAME-ACTION] post ok gameId=${input.gameId} eventId=${input.eventId} actionType=${input.actionType} status=${resp.status} elapsedMs=${elapsedMs2} attempts=${attempts}`
+        );
+        return { success: true, status: resp.status, elapsedMs: elapsedMs2, attempts };
+      }
+      let text = "";
+      try {
+        text = (await resp.text()).slice(0, 500);
+      } catch {
+      }
+      lastError = `http_${resp.status}: ${text}`;
+      input.log?.warn?.(
+        `[GAME-ACTION] post non-2xx gameId=${input.gameId} eventId=${input.eventId} status=${resp.status} attempt=${attempt} body=${text}`
+      );
+    } catch (err) {
+      lastError = err instanceof Error ? err.message : String(err);
+      input.log?.warn?.(
+        `[GAME-ACTION] post network error gameId=${input.gameId} eventId=${input.eventId} attempt=${attempt} err=${lastError}`
+      );
+    } finally {
+      clearTimeout(timer);
+    }
+    if (attempt < maxRetries) {
+      await sleep(500 * Math.pow(2, attempt));
+    }
+  }
+  const elapsedMs = Date.now() - start;
+  input.log?.error?.(
+    `[GAME-ACTION] post failed gameId=${input.gameId} eventId=${input.eventId} actionType=${input.actionType} status=${lastStatus ?? "n/a"} attempts=${attempts} elapsedMs=${elapsedMs} err=${lastError ?? "unknown"}`
+  );
+  return { success: false, status: lastStatus, error: lastError, elapsedMs, attempts };
+}
+
 // src/ws-client.ts
 import WebSocket from "ws";
 var CoolclawWsClient = class {
   constructor(options) {
     this.options = options;
   }
+  options;
   socket;
   heartbeatTimer;
   reconnectTimer;
@@ -713,6 +1181,32 @@ function logAckFailure(params) {
   const target = params.target ? ` target=${params.target}` : "";
   params.log(`${params.channel} ack cleanup failed${target}: ${String(params.error)}`);
 }
+async function submitGameActionWithLog(action, meta, account, token, log, source) {
+  if (!account.gatewayUrl || !account.agentId) {
+    log?.error?.(`[GAME-ACTION] submit skipped: missing gatewayUrl/agentId eventId=${meta.eventId}`);
+    return;
+  }
+  log?.info?.(
+    `[GAME-ACTION] submit start source=${source} eventType=${meta.eventType} actionType=${action.actionType} gameId=${meta.gameId} turnSeq=${meta.turnSeq} eventId=${meta.eventId}`
+  );
+  const result = await submitGameAction({
+    gatewayUrl: account.gatewayUrl,
+    token,
+    agentId: String(account.agentId),
+    gameId: meta.gameId,
+    actionType: action.actionType,
+    actionData: action.actionData,
+    turnSeq: meta.turnSeq,
+    eventId: meta.eventId,
+    traceId: meta.traceId,
+    log
+  });
+  if (!result.success) {
+    log?.error?.(
+      `[GAME-ACTION] submit failed source=${source} eventId=${meta.eventId} attempts=${result.attempts} status=${result.status ?? "n/a"} err=${result.error ?? "unknown"}`
+    );
+  }
+}
 var runtimeClients = /* @__PURE__ */ new Map();
 function setRuntimeClient(accountKey, client) {
   runtimeClients.set(accountKey, client);
@@ -866,6 +1360,10 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                         }), channel: "coolclaw", reason: "runtime not available; skipping dispatch" });
                         return;
                       }
+                      const isGameEvent = envelope.metadata?.gameEvent === true;
+                      const gameMeta = isGameEvent ? envelope.metadata : null;
+                      let gameSubmitted = false;
+                      let gameFallbackReason = null;
                       try {
                         const isGroup = envelope.conversationId.startsWith("group:");
                         const peer = isGroup ? { kind: "group", id: envelope.group?.groupId ?? envelope.conversationId } : { kind: "direct", id: envelope.conversationId };
@@ -889,17 +1387,34 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                           ctx.cfg.session?.store,
                           { agentId: route.agentId }
                         );
-                        const senderLabel = envelope.sender ? `${envelope.sender.userType.toLowerCase()}:${envelope.sender.userId}` : "unknown";
+                        const senderLabel = envelope.sender ? `${envelope.sender.userType.toLowerCase()}:${envelope.sender.userId}` : isGameEvent ? `game:${gameMeta.gameId}` : "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) {
+                          deliveryTarget = `coolclaw:agent:${account.agentId}`;
                         } else {
                           deliveryTarget = normalizeCoolclawTarget(envelope.conversationId);
                         }
                         const agentHint = envelope.metadata?.agentHint;
                         const bodyForAgent = agentHint ? envelope.text + agentHint : envelope.text;
+                        if (typeof runtime.channel.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") {
+                          throw new Error(
+                            "CoolClaw requires runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher. Please upgrade OpenClaw to >=2026.3.22."
+                          );
+                        }
+                        if (typeof runtime.channel.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({
                           Body: envelope.text,
                           BodyForAgent: bodyForAgent,
@@ -928,12 +1443,30 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                             ctx.log?.warn(`recordInboundSession failed: ${err instanceof Error ? err.message : String(err)}`);
                           }
                         });
+                        const gameBuffer = [];
                         await runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
                           ctx: ctxPayload,
                           cfg: ctx.cfg,
                           dispatcherOptions: {
                             deliver: async (payload) => {
                               if (!payload.text) return;
+                              if (isGameEvent && gameMeta) {
+                                if (gameSubmitted) return;
+                                gameBuffer.push(String(payload.text));
+                                const full = gameBuffer.join("");
+                                const parsed = parseAgentAction(full);
+                                if ("error" in parsed) return;
+                                gameSubmitted = true;
+                                await submitGameActionWithLog(
+                                  parsed,
+                                  gameMeta,
+                                  account,
+                                  token,
+                                  ctx.log,
+                                  "llm"
+                                );
+                                return;
+                              }
                               try {
                                 let replyTarget;
                                 if (envelope.group) {
@@ -953,8 +1486,36 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                             }
                           }
                         });
+                        if (isGameEvent && gameMeta && !gameSubmitted) {
+                          gameFallbackReason = "no_valid_action_in_llm_output";
+                        }
                       } catch (err) {
-                        ctx.log?.error(`Inbound dispatch error: ${err instanceof Error ? err.message : String(err)}`);
+                        const errMsg = err instanceof Error ? err.message : String(err);
+                        ctx.log?.error(`Inbound dispatch error: ${errMsg}`);
+                        if (isGameEvent && gameMeta && !gameSubmitted) {
+                          gameFallbackReason = `dispatch_error: ${errMsg}`;
+                        }
+                      } finally {
+                        if (isGameEvent && gameMeta && !gameSubmitted) {
+                          try {
+                            const fb = fallbackActionFor(gameMeta.eventType, gameMeta.eventData);
+                            ctx.log?.warn?.(
+                              `[GAME-ACTION] parse fallback eventType=${gameMeta.eventType} eventId=${gameMeta.eventId} reason=${gameFallbackReason ?? "unknown"}`
+                            );
+                            await submitGameActionWithLog(
+                              fb,
+                              gameMeta,
+                              account,
+                              token,
+                              ctx.log,
+                              "fallback"
+                            );
+                          } catch (fbErr) {
+                            ctx.log?.error?.(
+                              `[GAME-ACTION] fallback submit threw eventId=${gameMeta.eventId} err=${fbErr instanceof Error ? fbErr.message : String(fbErr)}`
+                            );
+                          }
+                        }
                       }
                     },
                     sendAck: async (ackFrame) => {

package/dist/{chunk-727FMVYY.js → chunk-NY6UBBGB.js}

@@ -1,7 +1,7 @@
 import {
   coolclawChannelPlugin,
   setCoolclawRuntime
-} from "./chunk-UQDUXUWV.js";
+} from "./chunk-IPHJPPD4.js";
 import {
   runCoolclawSetup
 } from "./chunk-A54AF634.js";
@@ -62,29 +62,41 @@ function splitCsv(value) {
 }
 
 // src/compat.ts
-var SUPPORTED_HOST_MIN = "2026.4.24";
+var SUPPORTED_HOST_MIN = "2026.3.22";
+var MAX_TESTED_VERSION = "2026.5.7";
+function parseVersion(v) {
+  const clean = v.split("-")[0].replace(/\s*\(.*\)/, "").trim();
+  const [y, m, d] = clean.split(".").map(Number);
+  return [y || 0, m || 0, d || 0];
+}
+function cmp(a, b) {
+  const [ay, am, ad] = parseVersion(a);
+  const [by, bm, bd] = parseVersion(b);
+  if (ay !== by) return ay > by ? 1 : -1;
+  if (am !== bm) return am > bm ? 1 : -1;
+  if (ad !== bd) return ad > bd ? 1 : -1;
+  return 0;
+}
 function assertHostCompatibility(hostVersion) {
   if (!hostVersion || hostVersion === "unknown") return;
-  if (isHostVersionSupported(hostVersion)) return;
+  if (cmp(hostVersion, SUPPORTED_HOST_MIN) >= 0) return;
   throw new Error(
     `This version of @coolclaw/coolclaw requires OpenClaw >=${SUPPORTED_HOST_MIN}, but found ${hostVersion}. Please upgrade OpenClaw:
   npm install -g openclaw@latest
 Then reinstall the plugin:
   openclaw plugins install @coolclaw/coolclaw
 
-Or use the one-command installer (requires @coolclaw/coolclaw-cli published to npm):
+Or use the one-command installer:
   npx @coolclaw/coolclaw-cli install`
   );
 }
-function isHostVersionSupported(hostVersion) {
-  const clean = hostVersion.split("-")[0];
-  const host = clean.split(".").map(Number);
-  const min = SUPPORTED_HOST_MIN.split(".").map(Number);
-  for (let i = 0; i < 3; i++) {
-    if (host[i] > min[i]) return true;
-    if (host[i] < min[i]) return false;
+function advisoryHostCompatibility(hostVersion) {
+  if (!hostVersion || hostVersion === "unknown") return;
+  if (cmp(hostVersion, MAX_TESTED_VERSION) > 0) {
+    console.warn(
+      `[coolclaw] Host version ${hostVersion} is newer than the latest tested version (${MAX_TESTED_VERSION}). Proceeding without version gate; please report incompatibilities.`
+    );
   }
-  return true;
 }
 
 // index.ts
@@ -112,6 +124,7 @@ var entry = defineChannelPluginEntry({
   },
   registerFull(api) {
     assertHostCompatibility(api.runtime?.version);
+    advisoryHostCompatibility(api.runtime?.version);
     setCoolclawRuntime(api.runtime);
   }
 });

package/dist/cli-metadata.js

@@ -1,7 +1,7 @@
 import {
   index_default
-} from "./chunk-727FMVYY.js";
-import "./chunk-UQDUXUWV.js";
+} from "./chunk-NY6UBBGB.js";
+import "./chunk-IPHJPPD4.js";
 import "./chunk-A54AF634.js";
 import "./chunk-Q3NF4NWE.js";
 

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   index_default
-} from "./chunk-727FMVYY.js";
-import "./chunk-UQDUXUWV.js";
+} from "./chunk-NY6UBBGB.js";
+import "./chunk-IPHJPPD4.js";
 import "./chunk-A54AF634.js";
 import "./chunk-Q3NF4NWE.js";
 export {

package/dist/setup-entry.js

@@ -1,6 +1,6 @@
 import {
   coolclawChannelPlugin
-} from "./chunk-UQDUXUWV.js";
+} from "./chunk-IPHJPPD4.js";
 import "./chunk-Q3NF4NWE.js";
 
 // setup-entry.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coolclaw/coolclaw",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "OpenClaw native channel plugin for Riddle/CoolClaw chat.",
   "type": "module",
   "files": [
@@ -41,7 +41,7 @@
     "vitest": "latest"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.4.24"
+    "openclaw": ">=2026.3.22 <2027"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -59,9 +59,9 @@
     "runtimeSetupEntry": "./dist/setup-entry.js",
     "install": {
       "npmSpec": "@coolclaw/coolclaw",
-      "expectedIntegrity": "sha512-VwKa0sl2seFbgO6k1kG1pEKdFWYZLiDeoRJR/wR+ClRgsRGOQPkWiLBS0QFPNrPt/uCFKyYRNSKRFEEOED2qIg==",
+      "expectedIntegrity": "sha512-jZn9gMqpzKzbqQBz7GMFkTUdqUBtV1SZRYnYKP9eV/75xbx1RkoCADvhLF5LviH3JWsYd3jzZEV/6fy1H5FNTw==",
       "defaultChoice": "npm",
-      "minHostVersion": ">=2026.4.24"
+      "minHostVersion": ">=2026.3.22"
     },
     "channel": {
       "id": "coolclaw",
@@ -76,13 +76,15 @@
       }
     },
     "compat": {
-      "pluginApi": ">=2026.4.24",
-      "minGatewayVersion": "2026.4.24",
-      "sdkImports": ["openclaw/plugin-sdk/core"]
+      "pluginApi": ">=2026.3.22",
+      "minGatewayVersion": "2026.3.22",
+      "sdkImports": [
+        "openclaw/plugin-sdk/core"
+      ]
     },
     "build": {
-      "openclawVersion": "2026.5.6",
+      "openclawVersion": "2026.5.7",
       "pluginSdkVersion": "2026.4.29"
     }
   }
-}
+}