@coolclaw/coolclaw 1.0.2 → 1.0.5

package/README.md

@@ -20,13 +20,13 @@
   - `PRIVATE_MESSAGE`
   - `GROUP_MESSAGE`
   - `SYSTEM_NOTIFICATION`
-  - `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.
+  - `GAME_EVENT` — backend-owned `agentTask` events. The plugin uses `agentTask.renderedPrompt` verbatim, validates the parsed `<ACTION>{...}</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 感知新帖 / 被评论 / 被回复事件。
 
 ## Requirements
 
-- Node.js **>= 18** (required for global `fetch` + `AbortSignal.timeout` used by the GAME_EVENT action client).
+- Node.js **>= 18**.
 
 ## Installation
 
@@ -99,7 +99,7 @@ The channel account config written by setup uses `tokenSecretRef: file://...` by
 - `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`. MVP notification frames are dispatched as notifications and do not trigger model replies by default.
+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`.
 
 ## OpenClaw Compatibility
 

package/dist/{chunk-TS5TXH6P.js → chunk-EE5BK65S.js}

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

package/dist/{chunk-QNBJDZKJ.js → chunk-QKB2R55C.js}

@@ -120,6 +120,134 @@ var FileAckStore = class {
   }
 };
 
+// src/agent-task.ts
+import { createHash } from "crypto";
+function normalizeAgentTask(value) {
+  if (!isRecord(value)) return null;
+  const actionContract = normalizeActionContract(value.actionContract);
+  const fallbackAction = isRecord(value.fallbackAction) ? value.fallbackAction : null;
+  return {
+    agentTaskVersion: readNumber(value.agentTaskVersion),
+    promptPolicyVersion: readString(value.promptPolicyVersion),
+    requiresReply: value.requiresReply === true,
+    renderedPrompt: readString(value.renderedPrompt) ?? "",
+    renderedPromptHash: readString(value.renderedPromptHash),
+    actionFormat: readString(value.actionFormat),
+    conversationKey: readString(value.conversationKey),
+    actionContract,
+    fallbackAction,
+    diagnostics: isRecord(value.diagnostics) ? value.diagnostics : void 0
+  };
+}
+function isDispatchableAgentTask(task) {
+  return task.requiresReply === true && task.renderedPrompt.trim().length > 0 && allowedActionTypes(task).length > 0;
+}
+function validateAgentAction(action, task) {
+  if (!isRecord(action.actionData)) {
+    return { ok: false, reason: "invalid_action_shape" };
+  }
+  const allowed = allowedActionTypes(task);
+  if (allowed.length === 0) {
+    return { ok: false, reason: "missing_contract" };
+  }
+  const option = task.actionContract.options.find((candidate) => candidate.actionType === action.actionType);
+  if (!option) {
+    return { ok: false, reason: "disallowed_action_type" };
+  }
+  if (!matchesActionDataSchema(action.actionData, option.actionDataSchema)) {
+    return { ok: false, reason: "invalid_action_shape" };
+  }
+  return { ok: true, action };
+}
+function backendFallbackAction(task) {
+  const fallback = task.fallbackAction;
+  if (!isRecord(fallback) || typeof fallback.actionType !== "string") return null;
+  if (!isRecord(fallback.actionData)) return null;
+  const parsed = {
+    actionType: fallback.actionType,
+    actionData: fallback.actionData
+  };
+  const validated = validateAgentAction(parsed, task);
+  return validated.ok ? validated.action : null;
+}
+function sha256Hex(text) {
+  return createHash("sha256").update(text).digest("hex");
+}
+function rawResponsePreview(text, maxChars = 5e3) {
+  if (text.length === 0) return void 0;
+  return text.length <= maxChars ? text : `${text.slice(0, maxChars)}...`;
+}
+function normalizeActionContract(value) {
+  if (!isRecord(value)) return { options: [] };
+  const options = Array.isArray(value.options) ? value.options.flatMap((option) => normalizeActionOption(option)) : [];
+  return {
+    options,
+    finalOutputRules: Array.isArray(value.finalOutputRules) ? value.finalOutputRules.filter((rule) => typeof rule === "string") : void 0
+  };
+}
+function normalizeActionOption(value) {
+  if (!isRecord(value) || typeof value.actionType !== "string" || value.actionType.length === 0) {
+    return [];
+  }
+  return [{
+    actionType: value.actionType,
+    actionDataSchema: isRecord(value.actionDataSchema) ? value.actionDataSchema : void 0,
+    description: readString(value.description)
+  }];
+}
+function allowedActionTypes(task) {
+  return task.actionContract.options.map((option) => option.actionType);
+}
+function matchesActionDataSchema(actionData, schema) {
+  if (!schema || Object.keys(schema).length === 0) return true;
+  if (typeof schema.type === "string" && schema.type !== "object") return false;
+  const properties = isRecord(schema.properties) ? schema.properties : {};
+  const required = Array.isArray(schema.required) ? schema.required.filter((field) => typeof field === "string" && field.length > 0) : [];
+  for (const field of required) {
+    if (!Object.prototype.hasOwnProperty.call(actionData, field)) return false;
+    if (!matchesSchemaValue(actionData[field], properties[field], true)) return false;
+  }
+  for (const [field, value] of Object.entries(actionData)) {
+    const propertySchema = properties[field];
+    if (propertySchema !== void 0 && !matchesSchemaValue(value, propertySchema, false)) {
+      return false;
+    }
+  }
+  return true;
+}
+function matchesSchemaValue(value, schema, required) {
+  if (value == null) return !required;
+  if (!isRecord(schema)) return true;
+  if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+    return false;
+  }
+  switch (schema.type) {
+    case "integer":
+      return typeof value === "number" && Number.isInteger(value);
+    case "number":
+      return typeof value === "number" && Number.isFinite(value);
+    case "string":
+      return typeof value === "string" && (typeof schema.minLength !== "number" || value.length >= schema.minLength) && (typeof schema.maxLength !== "number" || value.length <= schema.maxLength);
+    case "boolean":
+      return typeof value === "boolean";
+    case "object":
+      return isRecord(value);
+    case "array":
+      return Array.isArray(value);
+    default:
+      return true;
+  }
+}
+function readString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function readNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/frame-codec.ts
 import { randomUUID } from "crypto";
 var CoolclawFrameDecodeError = class extends Error {
@@ -147,7 +275,7 @@ function decodeFrame(raw) {
   } catch (error) {
     throw new CoolclawFrameDecodeError(`Invalid CoolClaw frame JSON: ${error.message}`);
   }
-  if (!isRecord(value)) {
+  if (!isRecord2(value)) {
     throw new CoolclawFrameDecodeError("Invalid CoolClaw frame: expected object");
   }
   if (!("v" in value)) {
@@ -182,304 +310,10 @@ function decodeFrame(raw) {
   }
   return frame;
 }
-function isRecord(value) {
+function isRecord2(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, selfSeat) {
-  if (list.length === 0) return "\uFF08\u65E0\u5EA7\u4F4D\u4FE1\u606F\uFF09";
-  return list.map((p) => {
-    const seat = asNumberOrNull(p.seat);
-    const playerStatus = p.alive === true ? "\u5B58\u6D3B" : p.alive === false ? "\u5DF2\u6B7B\u4EA1" : "\u53C2\u8D5B";
-    if (seat != null && selfSeat != null && seat === selfSeat) {
-      const name = asString(p.name, "\u672A\u77E5");
-      const voice = asString(p.voiceDesc, "");
-      return `\u5EA7\u4F4D${seat}\uFF08\u4F60\u81EA\u5DF1\uFF0C${name}${voice ? `\uFF0C${voice}` : ""}\uFF0C${playerStatus}\uFF09`;
-    }
-    return `\u5EA7\u4F4D${seat ?? "?"}\uFF08${playerStatus}\uFF09`;
-  }).join("\uFF1B");
-}
-function stripAudioSuffix(line) {
-  return line.replace(/\s*:audio=https?:\/\/\S+/g, "").replace(/\s*:cb=[^\s|]+/g, "");
-}
-function renderHistory(history) {
-  if (history.length === 0) return "\uFF08\u6682\u65E0\u5386\u53F2\u8BB0\u5F55\uFF09";
-  return history.map((h, i) => `${i + 1}. ${stripAudioSuffix(h)}`).join("\n");
-}
-function renderAliveSeats(seats) {
-  return seats.length === 0 ? "\uFF08\u65E0\uFF09" : `[${seats.join(", ")}]`;
-}
-function asMvpCandidates(v) {
-  if (!Array.isArray(v)) return [];
-  return v.flatMap((item) => {
-    if (typeof item === "number" && Number.isFinite(item)) {
-      return [{ agentId: item, seatNumber: null }];
-    }
-    const record = asRecord(item);
-    const agentId = asNumberOrNull(record.agentId) ?? asNumberOrNull(record.targetAgentId);
-    if (agentId == null) return [];
-    const seatNumber = asNumberOrNull(record.seatNumber) ?? asNumberOrNull(record.seat);
-    return [{ agentId, seatNumber }];
-  });
-}
-function renderMvpCandidateList(candidates, selfAgentId) {
-  if (candidates.length === 0) return "\uFF08\u5019\u9009\u4FE1\u606F\u7F3A\u5931\uFF1B\u7B49\u5F85\u5E73\u53F0\u8D85\u65F6\u515C\u5E95\uFF09";
-  return candidates.map((candidate) => {
-    const seat = candidate.seatNumber == null ? "?" : candidate.seatNumber;
-    const selfMark = selfAgentId != null && candidate.agentId === selfAgentId ? "\uFF08\u4F60\u81EA\u5DF1\uFF0C\u4E0D\u80FD\u6295\u7ED9\u81EA\u5DF1\uFF09" : "";
-    return `- \u5EA7\u4F4D${seat} / Agent ${candidate.agentId}${selfMark}`;
-  }).join("\n");
-}
-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 === "MVP_VOTE_REQUEST" ? "\u8D5B\u540E" : eventType.startsWith("DAY_") || eventType === "LAST_WORD_TURN" || eventType === "HUNTER_SKILL_TURN" ? "\u767D\u5929" : "\u591C\u665A";
-  const aliveSeats = asNumberArray(payload.aliveSeats);
-  const seatsLabel = eventType === "MVP_VOTE_REQUEST" ? "MVP \u5019\u9009\u5EA7\u4F4D" : "\u5F53\u524D\u5B58\u6D3B\u5EA7\u4F4D";
-  const playerInfo = renderPlayerInfo(asRecordArray(payload.playerInfoList), selfSeat);
-  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`,
-    `${seatsLabel}\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";
-    case "MVP_VOTE_REQUEST":
-      return "MVP \u6295\u7968";
-    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);
-    case "MVP_VOTE_REQUEST":
-      return renderMvpVoteRequest(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 tp = asRecord(payload.teammateProposal);
-  const tpSeat = asNumberOrNull(tp.seat);
-  const tpTarget = asNumberOrNull(tp.targetSeat);
-  const tpSpeech = asString(tp.speech, "").trim();
-  let teammateBlock;
-  if (tpTarget != null) {
-    const speechLine = tpSpeech ? `
-===== \u72FC\u961F\u53CB\u53D1\u8A00\u5F00\u59CB =====
-${tpSpeech}
-===== \u72FC\u961F\u53CB\u53D1\u8A00\u7ED3\u675F =====` : "";
-    teammateBlock = `\u540C\u4F34\uFF08\u5EA7\u4F4D ${tpSeat ?? "?"}\uFF09\u672C\u8F6E\u5DF2\u63D0\u8BAE\u51FB\u6740\u5EA7\u4F4D ${tpTarget}\u3002${speechLine}`;
-  } else {
-    teammateBlock = 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}\u3002` : "\u4F60\u662F\u72EC\u72FC\u3002",
-    teammateBlock,
-    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 renderMvpVoteRequest(payload) {
-  const candidates = asMvpCandidates(payload.candidates);
-  const selfAgentId = asNumberOrNull(payload.selfAgentId);
-  const round = asNumberOrNull(payload.round) ?? 1;
-  const deadlineSeconds = asNumberOrNull(payload.deadlineSeconds);
-  return [
-    `\u3010\u4EFB\u52A1\u3011\u8D5B\u540E MVP \u6295\u7968\uFF08\u7B2C ${round} \u8F6E\uFF09`,
-    deadlineSeconds != null ? `\u8BF7\u5728 ${deadlineSeconds} \u79D2\u5185\u4ECE\u5019\u9009\u5BF9\u8C61\u91CC\u9009\u51FA\u4F60\u8BA4\u4E3A\u672C\u5C40\u8D21\u732E\u6700\u5927\u7684 Agent\u3002` : `\u8BF7\u4ECE\u5019\u9009\u5BF9\u8C61\u91CC\u9009\u51FA\u4F60\u8BA4\u4E3A\u672C\u5C40\u8D21\u732E\u6700\u5927\u7684 Agent\u3002`,
-    `\u5019\u9009\u5BF9\u8C61\uFF08targetAgentId \u5FC5\u987B\u4ECE\u8FD9\u91CC\u9009\uFF0C\u4E0D\u80FD\u6295\u7ED9\u81EA\u5DF1\uFF09\uFF1A`,
-    renderMvpCandidateList(candidates, selfAgentId),
-    ``,
-    `\u8BF7\u7EFC\u5408\u53D1\u8A00\u3001\u6295\u7968\u3001\u5173\u952E\u884C\u52A8\u548C\u80DC\u8D1F\u8D21\u732E\uFF0C\u7B80\u77ED\u8BF4\u660E\u7406\u7531\uFF0C\u7136\u540E\u5728\u56DE\u590D\u6700\u540E\u4E25\u683C\u6309\u4EE5\u4E0B\u683C\u5F0F\u58F0\u660E\u52A8\u4F5C\uFF1A`,
-    `<ACTION>`,
-    `{"actionType":"MVP_VOTE","actionData":{"targetAgentId":<number>,"round":${round},"reason":"<\u7B80\u8FF0>"}}`,
-    `</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 nestedPayload = asRecord(outer.payload);
-  const payload = Object.keys(nestedPayload).length > 0 ? nestedPayload : outer;
-  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") {
@@ -533,12 +367,21 @@ function mapInboundFrame(frame) {
 }
 async function handleInboundFrame(input) {
   const envelope = mapInboundFrame(input.frame);
-  if (!envelope) return;
-  await ackProcessedSeq(input, envelope);
+  if (!envelope) {
+    await ackFrameSeq(input);
+    return;
+  }
+  const ackAfterDispatch = envelope.metadata.gameEvent === true;
+  if (!ackAfterDispatch) {
+    await ackProcessedSeq(input, envelope);
+  }
   await input.dispatch(envelope);
+  if (ackAfterDispatch) {
+    await ackProcessedSeq(input, envelope);
+  }
 }
 function mapNotificationFrame(frame) {
-  const payload = isRecord2(frame.payload) ? frame.payload : {};
+  const payload = isRecord3(frame.payload) ? frame.payload : {};
   const seq = typeof payload.seq === "number" ? payload.seq : void 0;
   if (frame.type === "SYSTEM_NOTIFICATION") {
     const title = typeof payload.title === "string" ? payload.title : "System";
@@ -588,7 +431,8 @@ function mapNotificationFrame(frame) {
 }
 function mapGameEventFrame(frame, payload) {
   const eventType = typeof payload.eventType === "string" ? payload.eventType : "UNKNOWN";
-  if (eventType === "GAME_START") {
+  const agentTask = normalizeAgentTask(payload.agentTask);
+  if (!agentTask || !isDispatchableAgentTask(agentTask)) {
     return null;
   }
   let eventDataObj = {};
@@ -596,10 +440,10 @@ function mapGameEventFrame(frame, payload) {
   if (typeof rawEventData === "string" && rawEventData.length > 0) {
     try {
       const parsed = JSON.parse(rawEventData);
-      if (isRecord2(parsed)) eventDataObj = parsed;
+      if (isRecord3(parsed)) eventDataObj = parsed;
     } catch {
     }
-  } else if (isRecord2(rawEventData)) {
+  } else if (isRecord3(rawEventData)) {
     eventDataObj = rawEventData;
   }
   const gameId = Number(payload.gameId ?? 0);
@@ -618,16 +462,17 @@ function mapGameEventFrame(frame, payload) {
     traceId,
     eventType,
     eventData: eventDataObj,
+    agentTask,
+    promptPolicyVersion: agentTask.promptPolicyVersion,
+    renderedPromptHash: agentTask.renderedPromptHash,
     deadlineEpochMs,
     sourceFrameId: frame.id
   };
   return {
     id: eventId,
     channel: "coolclaw",
-    // 每个 (roomId, gameId, eventType) 组合作为独立会话键，避免和私聊会话混淆；
-    // turnSeq 不参与会话 id，以便同一事件类型的多轮对话能沿用同一上下文。
-    conversationId: `game:${roomId}:${gameId}:${eventType}`,
-    text: buildGameEventPrompt(eventType, eventDataObj),
+    conversationId: agentTask.conversationKey ?? `game:${roomId}:${gameId}:task:${eventId}`,
+    text: agentTask.renderedPrompt,
     messageType: "GAME_EVENT",
     seq,
     shouldReply: true,
@@ -636,52 +481,64 @@ function mapGameEventFrame(frame, payload) {
 }
 async function ackProcessedSeq(input, envelope) {
   if (typeof envelope.seq === "number") {
-    const lastAckedSeq = await input.ackStore.record(input.accountKey, envelope.seq);
-    await input.sendAck(createFrame("ACK", { lastAckedSeq }));
+    await ackSeq(input, envelope.seq);
   }
 }
+async function ackFrameSeq(input) {
+  const payload = isRecord3(input.frame.payload) ? input.frame.payload : {};
+  const seq = typeof payload.seq === "number" ? payload.seq : void 0;
+  if (typeof seq === "number") {
+    await ackSeq(input, seq);
+  }
+}
+async function ackSeq(input, seq) {
+  const current = await input.ackStore.getLastAckedSeq(input.accountKey);
+  const lastAckedSeq = seq <= current ? current : seq;
+  await input.sendAck(createFrame("ACK", { lastAckedSeq }));
+  await input.ackStore.record(input.accountKey, seq);
+}
 function assertPrivatePayload(value) {
-  if (!isRecord2(value) || !isUserRef(value.sender) || !isUserRef(value.recipient)) {
+  if (!isRecord3(value) || !isUserRef(value.sender) || !isUserRef(value.recipient)) {
     throw new Error("Invalid PRIVATE_MESSAGE payload");
   }
   return {
-    seq: readNumber(value, "seq"),
-    messageId: readString(value, "messageId"),
-    conversationId: readString(value, "conversationId"),
+    seq: readNumber2(value, "seq"),
+    messageId: readString2(value, "messageId"),
+    conversationId: readString2(value, "conversationId"),
     sender: value.sender,
     recipient: value.recipient,
-    messageType: readString(value, "messageType"),
-    content: readString(value, "content"),
+    messageType: readString2(value, "messageType"),
+    content: readString2(value, "content"),
     mentioned: readBoolean(value, "mentioned"),
-    sentAt: readString(value, "sentAt")
+    sentAt: readString2(value, "sentAt")
   };
 }
 function assertGroupPayload(value) {
-  if (!isRecord2(value) || !isUserRef(value.sender)) {
+  if (!isRecord3(value) || !isUserRef(value.sender)) {
     throw new Error("Invalid GROUP_MESSAGE payload");
   }
   return {
-    seq: readNumber(value, "seq"),
-    messageId: readString(value, "messageId"),
-    groupId: readString(value, "groupId"),
-    groupName: readString(value, "groupName"),
-    conversationId: readString(value, "conversationId"),
+    seq: readNumber2(value, "seq"),
+    messageId: readString2(value, "messageId"),
+    groupId: readString2(value, "groupId"),
+    groupName: readString2(value, "groupName"),
+    conversationId: readString2(value, "conversationId"),
     sender: value.sender,
-    messageType: readString(value, "messageType"),
-    content: readString(value, "content"),
+    messageType: readString2(value, "messageType"),
+    content: readString2(value, "content"),
     mentioned: readBoolean(value, "mentioned"),
-    sentAt: readString(value, "sentAt"),
+    sentAt: readString2(value, "sentAt"),
     agentHint: readOptionalString(value, "agentHint")
   };
 }
-function readString(source, key) {
+function readString2(source, key) {
   const value = source[key];
   if (typeof value !== "string" || value.length === 0) {
     throw new Error(`Invalid inbound payload: missing ${key}`);
   }
   return value;
 }
-function readNumber(source, key) {
+function readNumber2(source, key) {
   const value = source[key];
   if (typeof value !== "number" || !Number.isInteger(value)) {
     throw new Error(`Invalid inbound payload: missing ${key}`);
@@ -706,9 +563,9 @@ function readOptionalString(source, key) {
   return value;
 }
 function isUserRef(value) {
-  return isRecord2(value) && typeof value.userId === "string" && (value.userType === "HUMAN" || value.userType === "AGENT") && (value.displayName === void 0 || typeof value.displayName === "string");
+  return isRecord3(value) && typeof value.userId === "string" && (value.userType === "HUMAN" || value.userType === "AGENT") && (value.displayName === void 0 || typeof value.displayName === "string");
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null;
 }
 
@@ -833,13 +690,23 @@ async function sendMedia(input) {
 async function sendGameAction(input) {
   const frame = createFrame("GAME_ACTION", {
     gameId: input.gameId,
+    roomId: input.roomId,
+    eventType: input.eventType,
     actionType: input.actionType,
     actionData: input.actionData,
     // AgentActionRequest.timestamp 契约为 String
     timestamp: String(Date.now()),
     turnSeq: input.turnSeq,
     eventId: input.eventId,
-    traceId: input.traceId
+    traceId: input.traceId,
+    promptPolicyVersion: input.promptPolicyVersion,
+    renderedPromptHash: input.renderedPromptHash,
+    parseSource: input.parseSource,
+    rawResponseHash: input.rawResponseHash,
+    rawResponsePreview: input.rawResponsePreview,
+    modelActionRejected: input.modelActionRejected,
+    modelActionType: input.modelActionType,
+    validationReason: input.validationReason
   });
   const response = await input.client.request(frame);
   if (response.ok === false) {
@@ -849,7 +716,7 @@ async function sendGameAction(input) {
 
 // src/game-action-parser.ts
 function extractActionBlock(text) {
-  const re = /<ACTION>\s*([\s\S]+?)\s*<\/ACTION>/g;
+  const re = /<ACTION>\s*([\s\S]+?)\s*<\/ACTION>/gi;
   let match;
   let last = null;
   while ((match = re.exec(text)) !== null) {
@@ -857,6 +724,11 @@ function extractActionBlock(text) {
   }
   return last;
 }
+function normalizeActionBlock(body) {
+  const trimmed = body.trim();
+  const fenced = /^```(?:json)?\s*([\s\S]*?)\s*```$/i.exec(trimmed);
+  return fenced ? fenced[1].trim() : trimmed;
+}
 function parseAgentAction(text) {
   if (typeof text !== "string" || text.length === 0) {
     return { error: "no_action_block" };
@@ -867,7 +739,7 @@ function parseAgentAction(text) {
   }
   let obj;
   try {
-    obj = JSON.parse(body);
+    obj = JSON.parse(normalizeActionBlock(body));
   } catch (e) {
     return { error: "invalid_json", detail: e instanceof Error ? e.message : String(e) };
   }
@@ -887,105 +759,44 @@ function parseAgentAction(text) {
   };
 }
 
-// src/game-action-fallback.ts
-function asNumberArray2(v) {
-  return Array.isArray(v) ? v.filter((x) => typeof x === "number") : [];
-}
-function asNumberOrNull2(v) {
-  return typeof v === "number" && Number.isFinite(v) ? v : null;
-}
-function asRecord2(v) {
-  return typeof v === "object" && v !== null ? v : {};
-}
-function hasKeys(record) {
-  return Object.keys(record).length > 0;
-}
-function candidateAgentIds(v) {
-  if (!Array.isArray(v)) return [];
-  return v.flatMap((item) => {
-    if (typeof item === "number" && Number.isFinite(item)) return [item];
-    const record = asRecord2(item);
-    const agentId = asNumberOrNull2(record.agentId) ?? asNumberOrNull2(record.targetAgentId);
-    return agentId == null ? [] : [agentId];
-  });
+// src/game-action-audit.ts
+function normalizeAuditText(value, maxChars = 256) {
+  if (!value) return void 0;
+  return value.length <= maxChars ? value : value.slice(0, maxChars);
 }
-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 pickRandomAgent(candidates, excludeAgentId) {
-  const eligible = excludeAgentId == null ? candidates : candidates.filter((candidate) => candidate !== excludeAgentId);
-  if (eligible.length === 0) return candidates[0] ?? null;
-  return eligible[Math.floor(Math.random() * eligible.length)];
-}
-function fallbackActionFor(eventType, eventData) {
-  const outer = asRecord2(eventData);
-  const nestedPayload = asRecord2(outer.payload);
-  const payload = hasKeys(nestedPayload) ? nestedPayload : outer;
-  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: {} };
-    case "MVP_VOTE_REQUEST": {
-      const selfAgentId = asNumberOrNull2(payload.selfAgentId);
-      const candidates = candidateAgentIds(payload.candidates);
-      const targetAgentId = pickRandomAgent(candidates, selfAgentId);
-      if (targetAgentId == null) {
-        return { actionType: "UNKNOWN", actionData: {} };
-      }
-      return {
-        actionType: "MVP_VOTE",
-        actionData: {
-          targetAgentId,
-          round: asNumberOrNull2(payload.round) ?? asNumberOrNull2(outer.round) ?? 1,
-          reason: "\uFF08\u6258\u7BA1\uFF1ALLM \u672A\u7ED9\u51FA\u5408\u6CD5 MVP \u6295\u7968\uFF09"
-        }
-      };
-    }
-    default:
-      return { actionType: "UNKNOWN", actionData: {} };
+function inferRejectedModelAction(rawResponse, task) {
+  if (rawResponse.trim().length === 0) {
+    return {
+      modelActionRejected: false,
+      validationReason: "no_model_output"
+    };
+  }
+  const parsed = parseAgentAction(rawResponse);
+  if ("error" in parsed) {
+    return {
+      modelActionRejected: true,
+      validationReason: parseErrorReason(parsed)
+    };
   }
+  const validation = validateAgentAction(parsed, task);
+  if (!validation.ok) {
+    return {
+      modelActionRejected: true,
+      modelActionType: parsed.actionType,
+      validationReason: validation.reason
+    };
+  }
+  return {
+    modelActionRejected: true,
+    modelActionType: parsed.actionType,
+    validationReason: "valid_action_not_submitted"
+  };
+}
+function parseErrorReason(error) {
+  if (error.error === "invalid_json") {
+    return normalizeAuditText(`invalid_json:${error.detail}`) ?? "invalid_json";
+  }
+  return error.error;
 }
 
 // src/ws-client.ts
@@ -1200,18 +1011,18 @@ var CoolclawWsClient = class {
   }
 };
 function readPingInterval(payload) {
-  if (!isRecord3(payload) || typeof payload.pingIntervalMs !== "number" || payload.pingIntervalMs <= 0) {
+  if (!isRecord4(payload) || typeof payload.pingIntervalMs !== "number" || payload.pingIntervalMs <= 0) {
     return void 0;
   }
   return payload.pingIntervalMs;
 }
 function readErrorMessage(payload) {
-  if (isRecord3(payload) && typeof payload.message === "string") {
+  if (isRecord4(payload) && typeof payload.message === "string") {
     return payload.message;
   }
   return "CoolClaw request failed";
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null;
 }
 
@@ -1265,35 +1076,75 @@ 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, wsClient, log, source) {
+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}`);
-    return;
+    return false;
   }
+  const responseHash = rawResponse && rawResponse.length > 0 ? sha256Hex(rawResponse) : void 0;
   log?.info?.(
-    `[GAME-ACTION] submit start source=${source} eventType=${meta.eventType} actionType=${action.actionType} gameId=${meta.gameId} turnSeq=${meta.turnSeq} eventId=${meta.eventId}`
+    `[GAME-ACTION] submit start source=${source} eventType=${meta.eventType} actionType=${action.actionType} gameId=${meta.gameId} roomId=${meta.roomId} turnSeq=${meta.turnSeq} eventId=${meta.eventId} promptPolicyVersion=${meta.promptPolicyVersion ?? ""} renderedPromptHash=${meta.renderedPromptHash ?? ""} rawResponseHash=${responseHash ?? ""}`
   );
   const start = Date.now();
   try {
     await sendGameAction({
       client: wsClient,
       gameId: meta.gameId,
+      roomId: meta.roomId,
+      eventType: meta.eventType,
       actionType: action.actionType,
       actionData: action.actionData,
       turnSeq: meta.turnSeq,
       eventId: meta.eventId,
-      traceId: meta.traceId
+      traceId: meta.traceId,
+      promptPolicyVersion: meta.promptPolicyVersion,
+      renderedPromptHash: meta.renderedPromptHash,
+      parseSource: source,
+      rawResponseHash: responseHash,
+      rawResponsePreview: rawResponse ? rawResponsePreview(rawResponse) : void 0,
+      modelActionRejected: auditMeta?.modelActionRejected,
+      modelActionType: auditMeta?.modelActionType,
+      validationReason: normalizeAuditText(auditMeta?.validationReason)
     });
     log?.info?.(
-      `[GAME-ACTION] submit ok source=${source} gameId=${meta.gameId} eventId=${meta.eventId} elapsedMs=${Date.now() - start}`
+      `[GAME-ACTION] submit ok source=${source} gameId=${meta.gameId} eventId=${meta.eventId} promptPolicyVersion=${meta.promptPolicyVersion ?? ""} renderedPromptHash=${meta.renderedPromptHash ?? ""} rawResponseHash=${responseHash ?? ""} elapsedMs=${Date.now() - start}`
     );
+    return true;
   } catch (err) {
     const errMsg = err instanceof Error ? err.message : String(err);
     log?.error?.(
       `[GAME-ACTION] submit failed source=${source} eventId=${meta.eventId} elapsedMs=${Date.now() - start} err=${errMsg}`
     );
+    return false;
   }
 }
+async function submitBackendFallbackWithLog(params) {
+  const fb = backendFallbackAction(params.meta.agentTask);
+  if (!fb) {
+    params.log?.warn?.(
+      `[GAME-ACTION] backend fallback unavailable eventType=${params.meta.eventType} eventId=${params.meta.eventId} reason=${params.reason} promptPolicyVersion=${params.meta.promptPolicyVersion ?? ""} renderedPromptHash=${params.meta.renderedPromptHash ?? ""}`
+    );
+    return false;
+  }
+  const inferred = inferRejectedModelAction(params.rawResponse ?? "", params.meta.agentTask);
+  const auditMeta = {
+    modelActionRejected: params.auditMeta?.modelActionRejected ?? inferred.modelActionRejected,
+    modelActionType: params.auditMeta?.modelActionType ?? inferred.modelActionType,
+    validationReason: params.auditMeta?.validationReason ?? params.reason ?? inferred.validationReason
+  };
+  params.log?.warn?.(
+    `[GAME-ACTION] backend fallback eventType=${params.meta.eventType} eventId=${params.meta.eventId} reason=${auditMeta.validationReason ?? "unknown"} promptPolicyVersion=${params.meta.promptPolicyVersion ?? ""} renderedPromptHash=${params.meta.renderedPromptHash ?? ""} rawResponseHash=${params.rawResponse ? sha256Hex(params.rawResponse) : ""}`
+  );
+  return submitGameActionWithLog(
+    fb,
+    params.meta,
+    params.wsClient,
+    params.log,
+    "backend_fallback",
+    params.rawResponse || void 0,
+    auditMeta
+  );
+}
 var runtimeClients = /* @__PURE__ */ new Map();
 function setRuntimeClient(accountKey, client) {
   runtimeClients.set(accountKey, client);
@@ -1441,16 +1292,36 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                     accountKey,
                     ackStore,
                     dispatch: async (envelope) => {
+                      const isGameEvent = envelope.metadata?.gameEvent === true;
+                      const gameMeta = isGameEvent ? envelope.metadata : null;
+                      let gameSubmitted = false;
+                      let gameFallbackReason = null;
+                      let gameModelActionType;
+                      let gameValidationReason;
+                      let gameModelActionRejected;
+                      const gameBuffer = [];
+                      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}`
+                        );
+                      }
                       const runtime = getCoolclawRuntime();
                       if (!runtime?.channel) {
                         logInboundDrop({ log: ctx.log?.warn?.bind(ctx.log) ?? (() => {
                         }), channel: "coolclaw", reason: "runtime not available; skipping dispatch" });
+                        if (isGameEvent && gameMeta) {
+                          const submitted = await submitBackendFallbackWithLog({
+                            meta: gameMeta,
+                            wsClient,
+                            log: ctx.log,
+                            reason: "runtime_not_available"
+                          });
+                          if (!submitted) {
+                            throw new Error("game fallback submit failed: runtime_not_available");
+                          }
+                        }
                         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 };
@@ -1530,7 +1401,6 @@ 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,
@@ -1549,14 +1419,36 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                                 const full = gameBuffer.join("");
                                 const parsed = parseAgentAction(full);
                                 if ("error" in parsed) return;
-                                gameSubmitted = true;
-                                await submitGameActionWithLog(
-                                  parsed,
+                                const validation = validateAgentAction(parsed, gameMeta.agentTask);
+                                if (!validation.ok) {
+                                  gameModelActionRejected = true;
+                                  gameModelActionType = parsed.actionType;
+                                  gameValidationReason = validation.reason;
+                                  gameFallbackReason = validation.reason;
+                                  ctx.log?.warn?.(
+                                    `[GAME-ACTION] rejected model action reason=${validation.reason} actionType=${parsed.actionType} eventType=${gameMeta.eventType} eventId=${gameMeta.eventId} promptPolicyVersion=${gameMeta.promptPolicyVersion ?? ""} renderedPromptHash=${gameMeta.renderedPromptHash ?? ""} rawResponseHash=${sha256Hex(full)}`
+                                  );
+                                  return;
+                                }
+                                const submitted = await submitGameActionWithLog(
+                                  validation.action,
                                   gameMeta,
                                   wsClient,
                                   ctx.log,
-                                  "llm"
+                                  "llm",
+                                  full,
+                                  {
+                                    modelActionRejected: false,
+                                    modelActionType: validation.action.actionType
+                                  }
                                 );
+                                if (submitted) {
+                                  gameSubmitted = true;
+                                } else {
+                                  gameFallbackReason = `llm_action_submit_failed:${validation.action.actionType}`;
+                                  gameModelActionRejected = false;
+                                  gameModelActionType = validation.action.actionType;
+                                }
                                 return;
                               }
                               try {
@@ -1579,7 +1471,9 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                           }
                         });
                         if (isGameEvent && gameMeta && !gameSubmitted) {
-                          gameFallbackReason = "no_valid_action_in_llm_output";
+                          if (!gameFallbackReason) {
+                            gameFallbackReason = "no_valid_action_in_llm_output";
+                          }
                         }
                       } catch (err) {
                         const errMsg = err instanceof Error ? err.message : String(err);
@@ -1588,23 +1482,42 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                           gameFallbackReason = `dispatch_error: ${errMsg}`;
                         }
                       } finally {
+                        if (isGameEvent && gameMeta) {
+                          const rawResponse = gameBuffer.join("");
+                          ctx.log?.info?.(
+                            `[GAME-TASK] model-output eventId=${gameMeta.eventId} promptPolicyVersion=${gameMeta.promptPolicyVersion ?? ""} renderedPromptHash=${gameMeta.renderedPromptHash ?? ""} rawHash=${rawResponse ? sha256Hex(rawResponse) : ""} rawPreview=${rawResponsePreview(rawResponse) ?? ""}`
+                          );
+                        }
                         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,
+                            const rawResponse = gameBuffer.join("");
+                            const inferred = inferRejectedModelAction(rawResponse, gameMeta.agentTask);
+                            gameModelActionRejected = gameModelActionRejected ?? inferred.modelActionRejected;
+                            gameModelActionType = gameModelActionType ?? inferred.modelActionType;
+                            gameValidationReason = gameValidationReason ?? inferred.validationReason;
+                            if (!gameFallbackReason || gameFallbackReason === "no_valid_action_in_llm_output") {
+                              gameFallbackReason = gameValidationReason ?? inferred.validationReason ?? gameFallbackReason;
+                            }
+                            const submitted = await submitBackendFallbackWithLog({
+                              meta: gameMeta,
                               wsClient,
-                              ctx.log,
-                              "fallback"
-                            );
+                              log: ctx.log,
+                              reason: gameFallbackReason ?? gameValidationReason ?? inferred.validationReason ?? "unknown",
+                              rawResponse: rawResponse || void 0,
+                              auditMeta: {
+                                modelActionRejected: gameModelActionRejected,
+                                modelActionType: gameModelActionType,
+                                validationReason: gameFallbackReason ?? gameValidationReason ?? inferred.validationReason
+                              }
+                            });
+                            if (!submitted) {
+                              throw new Error(`game fallback submit failed: ${gameFallbackReason ?? "unknown"}`);
+                            }
                           } catch (fbErr) {
                             ctx.log?.error?.(
                               `[GAME-ACTION] fallback submit threw eventId=${gameMeta.eventId} err=${fbErr instanceof Error ? fbErr.message : String(fbErr)}`
                             );
+                            throw fbErr;
                           }
                         }
                       }
@@ -1616,6 +1529,7 @@ var coolclawChannelPlugin = createChatChannelPlugin({
                       } catch (err) {
                         logAckFailure({ log: ctx.log?.warn?.bind(ctx.log) ?? (() => {
                         }), channel: "coolclaw", error: err });
+                        throw err;
                       }
                     }
                   });

package/dist/cli-metadata.js

@@ -1,7 +1,7 @@
 import {
   index_default
-} from "./chunk-TS5TXH6P.js";
-import "./chunk-QNBJDZKJ.js";
+} from "./chunk-EE5BK65S.js";
+import "./chunk-QKB2R55C.js";
 
 // cli-metadata.ts
 var cli_metadata_default = index_default;

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   index_default
-} from "./chunk-TS5TXH6P.js";
-import "./chunk-QNBJDZKJ.js";
+} from "./chunk-EE5BK65S.js";
+import "./chunk-QKB2R55C.js";
 export {
   index_default as default
 };

package/dist/setup-entry.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coolclaw/coolclaw",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "description": "OpenClaw native channel plugin for Riddle/CoolClaw chat.",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,7 +38,8 @@
   "scripts": {
     "build": "tsup index.ts setup-entry.ts cli-metadata.ts --format esm --dts --out-dir dist --clean --splitting",
     "test": "vitest run",
-    "lint": "tsc --noEmit"
+    "lint": "tsc --noEmit",
+    "prepack": "npm run build"
   },
   "dependencies": {
     "ws": "^8.20.1",
@@ -71,7 +72,7 @@
     "runtimeSetupEntry": "./dist/setup-entry.js",
     "install": {
       "npmSpec": "@coolclaw/coolclaw",
-      "expectedIntegrity": "sha512-imrUEvouY9fCFzZT2GNJBKsuYaJm9boaC6SVKJu5pGXvrDWrYrWmxA/buWiw5ATlJvrIvZZxF3jAk7b9BMnMzA==",
+      "expectedIntegrity": "sha512-6q6+KPGtAkHBZGsHgqEXJtnwLdVoZNLrZNbxZmzKisZvItoE2y+Acl9v3bNtqtEK/DR5NLahyloy7FMRVt9Upg==",
       "defaultChoice": "npm",
       "minHostVersion": ">=2026.3.22"
     },