metheus-governance-mcp-cli 0.2.293 → 0.2.294

package/cli.mjs

@@ -151,6 +151,9 @@ import {
   selectPendingArchiveComments,
   printRunnerResult,
 } from "./lib/runner-helpers.mjs";
+import {
+  normalizeRunnerRecentLocalInboundReceiptMap,
+} from "./lib/runner-local-inbound-receipts.mjs";
 import {
   normalizeRunnerConversationDecisionBundle,
   validateRunnerConversationDecisionBundle,
@@ -1966,88 +1969,6 @@ function prefersRunnerStateRecord(candidate, current) {
   return false;
 }
 
-function normalizeRunnerRecentLocalInboundReceiptRecord(rawReceipt, fallbackKey = "") {
-  const receipt = safeObject(rawReceipt);
-  const chatID = String(receipt.chat_id || receipt.chatID || "").trim();
-  const messageID = intFromRawAllowZero(receipt.message_id ?? receipt.messageID, 0);
-  const receiptKey = String(fallbackKey || `${chatID}:${messageID}`).trim();
-  if (!receiptKey || !chatID || !(messageID > 0)) {
-    return null;
-  }
-  const normalized = {
-    chat_id: chatID,
-    message_id: messageID,
-    receipt_origin: firstNonEmptyString([
-      receipt.receipt_origin,
-      receipt.receiptOrigin,
-      receipt.source_origin,
-      receipt.sourceOrigin,
-      "local_telegram_inbound",
-    ]),
-    receipt_route_key: firstNonEmptyString([
-      receipt.receipt_route_key,
-      receipt.receiptRouteKey,
-      receipt.source_route_key,
-      receipt.sourceRouteKey,
-    ]),
-    receipt_bot_username: normalizeTelegramMentionUsername(
-      firstNonEmptyString([
-        receipt.receipt_bot_username,
-        receipt.receiptBotUsername,
-        receipt.source_bot_username,
-        receipt.sourceBotUsername,
-      ]),
-    ),
-    kind: firstNonEmptyString([receipt.kind, "telegram_message"]),
-    sender: firstNonEmptyString([receipt.sender, receipt.from_name, receipt.fromName]),
-    sender_username: firstNonEmptyString([
-      receipt.sender_username,
-      receipt.senderUsername,
-      receipt.from_username,
-      receipt.fromUsername,
-    ]),
-    sender_is_bot: Boolean(receipt.sender_is_bot ?? receipt.senderIsBot ?? false),
-    body: firstNonEmptyString([receipt.body, receipt.text]),
-    occurred_at: firstNonEmptyString([receipt.occurred_at, receipt.occurredAt]),
-    received_at: firstNonEmptyString([receipt.received_at, receipt.receivedAt, new Date().toISOString()]),
-  };
-  const senderID = firstNonEmptyString([receipt.sender_id, receipt.senderID, receipt.from_id, receipt.fromID]);
-  if (senderID) {
-    normalized.sender_id = senderID;
-  }
-  const updateID = intFromRawAllowZero(receipt.update_id ?? receipt.updateID, 0);
-  if (updateID > 0) {
-    normalized.update_id = updateID;
-  }
-  const messageThreadID = intFromRawAllowZero(receipt.message_thread_id ?? receipt.messageThreadID, 0);
-  if (messageThreadID > 0) {
-    normalized.message_thread_id = messageThreadID;
-  }
-  const replyToMessageID = intFromRawAllowZero(receipt.reply_to_message_id ?? receipt.replyToMessageID, 0);
-  if (replyToMessageID > 0) {
-    normalized.reply_to_message_id = replyToMessageID;
-  }
-  const chatType = firstNonEmptyString([receipt.chat_type, receipt.chatType]);
-  if (chatType) {
-    normalized.chat_type = chatType;
-  }
-  const chatTitle = firstNonEmptyString([receipt.chat_title, receipt.chatTitle]);
-  if (chatTitle) {
-    normalized.chat_title = chatTitle;
-  }
-  return [receiptKey, normalized];
-}
-
-function normalizeRunnerRecentLocalInboundReceiptMap(rawReceipts) {
-  const normalizedEntries = [];
-  for (const [key, value] of Object.entries(safeObject(rawReceipts))) {
-    const normalizedEntry = normalizeRunnerRecentLocalInboundReceiptRecord(value, key);
-    if (!normalizedEntry) continue;
-    normalizedEntries.push(normalizedEntry);
-  }
-  return Object.fromEntries(normalizedEntries);
-}
-
 function mergeRunnerStateRecords(preferred, fallback) {
   const primary = safeObject(preferred);
   const secondary = safeObject(fallback);

package/lib/local-ai-adapters.mjs

@@ -2143,6 +2143,11 @@ export function buildLocalBotPrompt(payload, { terse = true } = {}) {
         "Do not mention another managed bot unless the contract explicitly names that bot in assignments or next_responders.",
         "Without a matching contract, mentioned bots will not act.",
         "When delegating to another managed bot, use contract.type=\"delegation\" with actionable=true, assignments, and next_responders.",
+        "Decision bundle consistency rules:",
+        "- If execution_contract_type is \"delegation\", conversation_intent_mode must be \"delegated_single_lead\".",
+        "- If execution_contract_type is \"delegation\", initial_responders must contain only the lead bot. Delegated target bots belong in next_expected_responders, not initial_responders.",
+        "- If multiple bots should each answer the opening human message, do not set should_close_after_reply=true on the first reply. Keep should_close_after_reply=false and list the remaining bots in next_expected_responders until the multi-bot opening is complete.",
+        "- Never combine conversation_intent_mode=\"multi_bot_direct\" with execution_contract_type=\"delegation\".",
         "Each assignment must declare whether it is a conversational contribution or a real execution task.",
         "Use assignment.mode=\"conversation_contribution\" for opinions, discussion, review, comparison, synthesis, greetings, or other room-visible contributions that do not require workspace artifacts.",
         "Use assignment.mode=\"execution_task\" only when the delegated bot must change workspace files, create artifacts, update ctxpack, or produce other concrete project outputs. If it is an execution task, also set artifacts_required=true.",

package/lib/runner-local-inbound-receipts.mjs

@@ -0,0 +1,212 @@
+import {
+  buildCanonicalHumanInboundKey,
+} from "./runner-helpers.mjs";
+
+function safeObject(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return {};
+  }
+  return value;
+}
+
+function ensureArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+
+function intFromRawAllowZero(raw, fallback = 0) {
+  if (raw === null || raw === undefined || raw === "") {
+    return fallback;
+  }
+  const parsed = Number.parseInt(String(raw).trim(), 10);
+  return Number.isFinite(parsed) ? parsed : fallback;
+}
+
+function firstNonEmptyString(values) {
+  for (const value of ensureArray(values)) {
+    const normalized = String(value ?? "").trim();
+    if (normalized) return normalized;
+  }
+  return "";
+}
+
+function normalizeMentionSelector(value) {
+  return String(value || "").trim().replace(/^@+/, "").toLowerCase();
+}
+
+function buildRunnerInboundTargetSelectorSuffix(selector) {
+  const normalizedSelector = normalizeMentionSelector(selector);
+  return normalizedSelector ? `:${normalizedSelector}` : "";
+}
+
+export function buildRunnerRecentLocalInboundReceiptKey(chatID, messageID) {
+  return `${String(chatID || "").trim()}:${intFromRawAllowZero(messageID, 0)}`;
+}
+
+export function normalizeRunnerRecentLocalInboundReceiptEntry(rawReceipt, fallbackKey = "") {
+  const receipt = safeObject(rawReceipt);
+  const chatID = String(receipt.chat_id || receipt.chatID || "").trim();
+  const messageID = intFromRawAllowZero(receipt.message_id ?? receipt.messageID, 0);
+  const receiptKey = String(fallbackKey || buildRunnerRecentLocalInboundReceiptKey(chatID, messageID)).trim();
+  if (!receiptKey || !chatID || !(messageID > 0)) {
+    return null;
+  }
+  const normalized = {
+    chat_id: chatID,
+    message_id: messageID,
+    receipt_origin: firstNonEmptyString([
+      receipt.receipt_origin,
+      receipt.receiptOrigin,
+      receipt.source_origin,
+      receipt.sourceOrigin,
+      "local_telegram_inbound",
+    ]),
+    receipt_route_key: firstNonEmptyString([
+      receipt.receipt_route_key,
+      receipt.receiptRouteKey,
+      receipt.source_route_key,
+      receipt.sourceRouteKey,
+    ]),
+    receipt_bot_username: normalizeMentionSelector(
+      firstNonEmptyString([
+        receipt.receipt_bot_username,
+        receipt.receiptBotUsername,
+        receipt.source_bot_username,
+        receipt.sourceBotUsername,
+      ]),
+    ),
+    kind: firstNonEmptyString([receipt.kind, "telegram_message"]),
+    sender: firstNonEmptyString([receipt.sender, receipt.from_name, receipt.fromName]),
+    sender_username: firstNonEmptyString([
+      receipt.sender_username,
+      receipt.senderUsername,
+      receipt.from_username,
+      receipt.fromUsername,
+    ]),
+    sender_is_bot: Boolean(receipt.sender_is_bot ?? receipt.senderIsBot ?? false),
+    body: firstNonEmptyString([receipt.body, receipt.text]),
+    occurred_at: firstNonEmptyString([receipt.occurred_at, receipt.occurredAt]),
+    received_at: firstNonEmptyString([receipt.received_at, receipt.receivedAt, new Date().toISOString()]),
+  };
+  const senderID = firstNonEmptyString([receipt.sender_id, receipt.senderID, receipt.from_id, receipt.fromID]);
+  if (senderID) {
+    normalized.sender_id = senderID;
+  }
+  const updateID = intFromRawAllowZero(receipt.update_id ?? receipt.updateID, 0);
+  if (updateID > 0) {
+    normalized.update_id = updateID;
+  }
+  const messageThreadID = intFromRawAllowZero(receipt.message_thread_id ?? receipt.messageThreadID, 0);
+  if (messageThreadID > 0) {
+    normalized.message_thread_id = messageThreadID;
+  }
+  const replyToMessageID = intFromRawAllowZero(receipt.reply_to_message_id ?? receipt.replyToMessageID, 0);
+  if (replyToMessageID > 0) {
+    normalized.reply_to_message_id = replyToMessageID;
+  }
+  const replyToFromUsername = firstNonEmptyString([
+    receipt.reply_to_from_username,
+    receipt.replyToFromUsername,
+    receipt.reply_to_username,
+    receipt.replyToUsername,
+  ]);
+  if (replyToFromUsername) {
+    normalized.reply_to_from_username = replyToFromUsername;
+  }
+  if (receipt.reply_to_from_is_bot === true || receipt.replyToFromIsBot === true) {
+    normalized.reply_to_from_is_bot = true;
+  }
+  const chatType = firstNonEmptyString([receipt.chat_type, receipt.chatType]);
+  if (chatType) {
+    normalized.chat_type = chatType;
+  }
+  const chatTitle = firstNonEmptyString([receipt.chat_title, receipt.chatTitle]);
+  if (chatTitle) {
+    normalized.chat_title = chatTitle;
+  }
+  const canonicalHumanMessageKey = String(buildCanonicalHumanInboundKey({
+    chat_id: normalized.chat_id,
+    message_id: normalized.message_id,
+    message_thread_id: normalized.message_thread_id,
+    reply_to_message_id: normalized.reply_to_message_id,
+    kind: normalized.kind,
+    sender_id: normalized.sender_id,
+    sender_username: normalized.sender_username,
+    sender_is_bot: normalized.sender_is_bot === true,
+    body: normalized.body,
+    occurred_at: normalized.occurred_at,
+    canonical_human_message_key: firstNonEmptyString([
+      receipt.canonical_human_message_key,
+      receipt.canonicalHumanMessageKey,
+    ]),
+  }) || "").trim();
+  if (canonicalHumanMessageKey) {
+    normalized.canonical_human_message_key = canonicalHumanMessageKey;
+  }
+  return [receiptKey, normalized];
+}
+
+export function normalizeRunnerRecentLocalInboundReceipt(rawReceipt, fallbackKey = "") {
+  const normalizedEntry = normalizeRunnerRecentLocalInboundReceiptEntry(rawReceipt, fallbackKey);
+  return normalizedEntry ? safeObject(normalizedEntry[1]) : {};
+}
+
+export function normalizeRunnerRecentLocalInboundReceiptMap(rawReceipts) {
+  const normalizedEntries = [];
+  for (const [key, value] of Object.entries(safeObject(rawReceipts))) {
+    const normalizedEntry = normalizeRunnerRecentLocalInboundReceiptEntry(value, key);
+    if (!normalizedEntry) continue;
+    normalizedEntries.push(normalizedEntry);
+  }
+  return Object.fromEntries(normalizedEntries);
+}
+
+export function buildRunnerLocalInboundReceiptKey(receiptRaw, { resolveTargetSelector = null } = {}) {
+  const receipt = normalizeRunnerRecentLocalInboundReceipt(receiptRaw);
+  const canonicalHumanKey = String(receipt.canonical_human_message_key || "").trim();
+  if (canonicalHumanKey) {
+    return `human:${canonicalHumanKey}`;
+  }
+  const chatID = String(receipt.chat_id || "").trim();
+  const messageID = intFromRawAllowZero(receipt.message_id, 0);
+  if (!chatID || !(messageID > 0)) {
+    return "";
+  }
+  const targetSelector = typeof resolveTargetSelector === "function"
+    ? normalizeMentionSelector(resolveTargetSelector(receiptRaw))
+    : normalizeMentionSelector(receipt.receipt_bot_username || "");
+  return `${chatID}:${messageID}${buildRunnerInboundTargetSelectorSuffix(targetSelector)}`;
+}
+
+export function findRecentTelegramInboundReceipt(rawMap, {
+  chatID = "",
+  messageID = 0,
+  canonicalHumanMessageKey = "",
+} = {}) {
+  const normalizedChatID = String(chatID || "").trim();
+  const normalizedMessageID = intFromRawAllowZero(messageID, 0);
+  const normalizedCanonicalHumanMessageKey = String(canonicalHumanMessageKey || "").trim();
+  if (!normalizedChatID || (!(normalizedMessageID > 0) && !normalizedCanonicalHumanMessageKey)) {
+    return {};
+  }
+  if (normalizedMessageID > 0) {
+    const exactReceipt = normalizeRunnerRecentLocalInboundReceipt(
+      safeObject(safeObject(rawMap)[buildRunnerRecentLocalInboundReceiptKey(normalizedChatID, normalizedMessageID)]),
+    );
+    if (Object.keys(exactReceipt).length > 0) {
+      return exactReceipt;
+    }
+  }
+  if (!normalizedCanonicalHumanMessageKey) {
+    return {};
+  }
+  for (const value of Object.values(safeObject(rawMap))) {
+    const normalizedReceipt = normalizeRunnerRecentLocalInboundReceipt(value);
+    if (
+      String(normalizedReceipt.chat_id || "").trim() === normalizedChatID
+      && String(normalizedReceipt.canonical_human_message_key || "").trim() === normalizedCanonicalHumanMessageKey
+    ) {
+      return normalizedReceipt;
+    }
+  }
+  return {};
+}

package/lib/runner-orchestration-decision-bundle.mjs

@@ -132,6 +132,14 @@ export function validateRunnerConversationDecisionBundle(bundleRaw) {
       bundle,
     };
   }
+  if (bundle.should_close_after_reply === true && bundle.initial_responders.length > 1) {
+    return {
+      ok: false,
+      status: "contradictory_multi_initial_close_state",
+      reason: "should_close_after_reply cannot be true when multiple initial_responders are expected to answer the opening turn",
+      bundle,
+    };
+  }
   if (
     bundle.conversation_intent_mode === "single_bot"
     && bundle.allowed_responders.length > 1
@@ -154,6 +162,28 @@ export function validateRunnerConversationDecisionBundle(bundleRaw) {
       bundle,
     };
   }
+  if (
+    bundle.conversation_intent_mode === "delegated_single_lead"
+    && bundle.initial_responders.length !== 1
+  ) {
+    return {
+      ok: false,
+      status: "invalid_delegated_single_lead_initial_responders",
+      reason: "delegated_single_lead requires exactly one initial responder",
+      bundle,
+    };
+  }
+  if (
+    bundle.execution_contract_type === "delegation"
+    && bundle.conversation_intent_mode === "multi_bot_direct"
+  ) {
+    return {
+      ok: false,
+      status: "contradictory_delegation_intent_mode",
+      reason: "multi_bot_direct cannot be combined with a delegation contract",
+      bundle,
+    };
+  }
   if (bundle.visible_handoff_required === true && bundle.visible_handoff_targets.length === 0) {
     return {
       ok: false,

package/lib/runner-orchestration-entrypoints.mjs

@@ -11,6 +11,9 @@ import {
   resolveRunnerAuthoritativeTriggerDecision,
   shouldRunnerTriggerProceed,
 } from "./runner-trigger.mjs";
+import {
+  buildRunnerLocalInboundReceiptKey,
+} from "./runner-local-inbound-receipts.mjs";
 
 function safeObject(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -116,31 +119,6 @@ function buildRunnerArchiveSourceMessageKey(recordRaw) {
   return `${chatID}:${messageID}${buildRunnerInboundTargetSelectorSuffix(resolveRunnerArchiveSourceTargetSelector(recordRaw))}`;
 }
 
-function buildRunnerLocalInboundReceiptKey(receiptRaw) {
-  const receipt = safeObject(receiptRaw);
-  const canonicalHumanKey = buildCanonicalHumanInboundKey({
-    chat_id: receipt.chat_id,
-    message_id: receipt.message_id,
-    message_thread_id: receipt.message_thread_id,
-    reply_to_message_id: receipt.reply_to_message_id,
-    kind: receipt.kind,
-    sender_id: receipt.sender_id,
-    sender_username: receipt.sender_username,
-    sender_is_bot: receipt.sender_is_bot === true,
-    body: receipt.body,
-    occurred_at: receipt.occurred_at,
-  });
-  if (canonicalHumanKey) {
-    return `human:${canonicalHumanKey}`;
-  }
-  const chatID = String(receipt.chat_id || receipt.chatID || "").trim();
-  const messageID = intFromRawAllowZero(receipt.message_id || receipt.messageID, 0);
-  if (!chatID || !(messageID > 0)) {
-    return "";
-  }
-  return `${chatID}:${messageID}${buildRunnerInboundTargetSelectorSuffix(resolveRunnerLocalInboundReceiptTargetSelector(receiptRaw))}`;
-}
-
 function buildRunnerReceiptReplaySortTime(receiptRaw) {
   const receipt = safeObject(receiptRaw);
   const receiptTime = Date.parse(firstNonEmptyString([
@@ -190,7 +168,9 @@ function buildRunnerReceiptBackedPendingArchiveComments({
   const latestReceiptsByKey = new Map();
   for (const receiptRaw of ensureArray(currentPollLocalInboundReceipts)) {
     const receipt = safeObject(receiptRaw);
-    const receiptKey = buildRunnerLocalInboundReceiptKey(receipt);
+    const receiptKey = buildRunnerLocalInboundReceiptKey(receipt, {
+      resolveTargetSelector: resolveRunnerLocalInboundReceiptTargetSelector,
+    });
     if (!receiptKey) {
       continue;
     }

package/lib/runner-orchestration-intent-contracts.mjs

@@ -21,36 +21,6 @@ function escapeRegexText(value) {
   return String(value || "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
-function detectDirectedManagedReplyTarget({
-  text,
-  currentBotSelector = "",
-  managedMentions = [],
-}) {
-  const normalizedText = String(text || "").trim();
-  const currentSelector = String(currentBotSelector || "").trim().toLowerCase();
-  if (!normalizedText || !currentSelector) {
-    return "";
-  }
-  const instructionPattern = /(?:\b(?:say|tell|greet|reply|answer|introduce|mention)\b|인사(?:해|하)|말(?:해|하)|얘기(?:해|하)|전달(?:해|하)|전해|알려|소개(?:해|하)|답(?:해|하)|응답(?:해|하)|말씀(?:해|하))/i;
-  if (!instructionPattern.test(normalizedText)) {
-    return "";
-  }
-  const candidates = ensureArray(managedMentions)
-    .map((item) => String(item || "").trim().toLowerCase())
-    .filter((item) => item && item !== currentSelector);
-  for (const selector of candidates) {
-    const escapedSelector = escapeRegexText(String(selector || "").replace(/^@+/, ""));
-    const targetPattern = new RegExp(
-      `(?:@${escapedSelector}\\s*(?:에게|한테|께|보고)?|(?:to|for)\\s+@${escapedSelector}\\b)`,
-      "i",
-    );
-    if (targetPattern.test(normalizedText)) {
-      return selector;
-    }
-  }
-  return "";
-}
-
 const DIRECTED_MANAGED_REPLY_ENGLISH_ACTION_PATTERN = "\\b(?:say|tell|greet|reply|answer|introduce|mention)\\b";
 const DIRECTED_MANAGED_REPLY_KOREAN_ACTION_PATTERN = "(?:\\uC778\\uC0AC|\\uB9D0|\\uC804\\uB2EC|\\uB2F5|\\uC18C\\uAC1C|\\uC5B8\\uAE09)";
 const DIRECTED_MANAGED_REPLY_ACTION_PATTERN = `(?:${DIRECTED_MANAGED_REPLY_ENGLISH_ACTION_PATTERN}|${DIRECTED_MANAGED_REPLY_KOREAN_ACTION_PATTERN})`;

package/lib/runner-orchestration-visibility.mjs

@@ -8,6 +8,10 @@ import {
 import {
   resolveRunnerAuthoritativeTriggerDecision,
 } from "./runner-trigger.mjs";
+import {
+  findRecentTelegramInboundReceipt,
+  normalizeRunnerRecentLocalInboundReceipt,
+} from "./runner-local-inbound-receipts.mjs";
 
 function safeObject(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -106,106 +110,6 @@ function doesTelegramEnvelopeMatchCanonicalHumanMessage(rawEnvelope, canonicalHu
   return String(envelope.canonical_human_message_key || "").trim() === normalizedCanonicalHumanMessageKey;
 }
 
-function normalizeRunnerRecentLocalInboundReceipt(rawReceipt) {
-  const receipt = safeObject(rawReceipt);
-  const chatID = String(receipt.chat_id || receipt.chatID || "").trim();
-  const messageID = intFromRawAllowZero(receipt.message_id ?? receipt.messageID, 0);
-  if (!chatID || !(messageID > 0)) {
-    return {};
-  }
-  const normalized = {
-    chat_id: chatID,
-    message_id: messageID,
-    ...(intFromRawAllowZero(receipt.message_thread_id ?? receipt.messageThreadID, 0) > 0
-      ? { message_thread_id: intFromRawAllowZero(receipt.message_thread_id ?? receipt.messageThreadID, 0) }
-      : {}),
-    ...(intFromRawAllowZero(receipt.reply_to_message_id ?? receipt.replyToMessageID, 0) > 0
-      ? { reply_to_message_id: intFromRawAllowZero(receipt.reply_to_message_id ?? receipt.replyToMessageID, 0) }
-      : {}),
-    ...(String(receipt.kind || "").trim()
-      ? { kind: String(receipt.kind || "").trim().toLowerCase() }
-      : {}),
-    ...(String(receipt.sender || "").trim()
-      ? { sender: String(receipt.sender || "").trim() }
-      : {}),
-    ...(normalizeMentionSelector(receipt.sender_username || receipt.senderUsername || "")
-      ? { sender_username: normalizeMentionSelector(receipt.sender_username || receipt.senderUsername || "") }
-      : {}),
-    ...(String(receipt.sender_id || receipt.senderID || "").trim()
-      ? { sender_id: String(receipt.sender_id || receipt.senderID || "").trim() }
-      : {}),
-    sender_is_bot: receipt.sender_is_bot === true || receipt.senderIsBot === true,
-    ...(String(receipt.body || "").trim()
-      ? { body: String(receipt.body || "").trim() }
-      : {}),
-    ...(String(receipt.occurred_at || receipt.occurredAt || "").trim()
-      ? { occurred_at: String(receipt.occurred_at || receipt.occurredAt || "").trim() }
-      : {}),
-    ...(String(receipt.receipt_origin || receipt.receiptOrigin || "").trim()
-      ? { receipt_origin: String(receipt.receipt_origin || receipt.receiptOrigin || "").trim().toLowerCase() }
-      : {}),
-    ...(String(receipt.receipt_route_key || receipt.receiptRouteKey || "").trim()
-      ? { receipt_route_key: String(receipt.receipt_route_key || receipt.receiptRouteKey || "").trim() }
-      : {}),
-    ...(normalizeMentionSelector(receipt.receipt_bot_username || receipt.receiptBotUsername || "")
-      ? { receipt_bot_username: normalizeMentionSelector(receipt.receipt_bot_username || receipt.receiptBotUsername || "") }
-      : {}),
-  };
-  const canonicalHumanMessageKey = buildCanonicalHumanInboundKey({
-    chat_id: normalized.chat_id,
-    message_id: normalized.message_id,
-    message_thread_id: normalized.message_thread_id,
-    reply_to_message_id: normalized.reply_to_message_id,
-    kind: normalized.kind,
-    sender_id: normalized.sender_id,
-    sender_username: normalized.sender_username,
-    sender_is_bot: normalized.sender_is_bot === true,
-    body: normalized.body,
-    occurred_at: normalized.occurred_at,
-    canonical_human_message_key: firstNonEmptyString([
-      receipt.canonical_human_message_key,
-      receipt.canonicalHumanMessageKey,
-    ]),
-  });
-  if (canonicalHumanMessageKey) {
-    normalized.canonical_human_message_key = canonicalHumanMessageKey;
-  }
-  return normalized;
-}
-
-function findRecentTelegramInboundReceipt(rawMap, {
-  chatID = "",
-  messageID = 0,
-  canonicalHumanMessageKey = "",
-} = {}) {
-  const normalizedChatID = String(chatID || "").trim();
-  const normalizedMessageID = intFromRawAllowZero(messageID, 0);
-  const normalizedCanonicalHumanMessageKey = normalizeCanonicalHumanMessageKey(canonicalHumanMessageKey);
-  if (!normalizedChatID || (!(normalizedMessageID > 0) && !normalizedCanonicalHumanMessageKey)) {
-    return {};
-  }
-  if (normalizedMessageID > 0) {
-    const key = `${normalizedChatID}:${normalizedMessageID}`;
-    const exactReceipt = normalizeRunnerRecentLocalInboundReceipt(safeObject(safeObject(rawMap)[key]));
-    if (Object.keys(exactReceipt).length > 0) {
-      return exactReceipt;
-    }
-  }
-  if (!normalizedCanonicalHumanMessageKey) {
-    return {};
-  }
-  for (const value of Object.values(safeObject(rawMap))) {
-    const normalizedReceipt = normalizeRunnerRecentLocalInboundReceipt(value);
-    if (
-      String(normalizedReceipt.chat_id || "").trim() === normalizedChatID
-      && String(normalizedReceipt.canonical_human_message_key || "").trim() === normalizedCanonicalHumanMessageKey
-    ) {
-      return normalizedReceipt;
-    }
-  }
-  return {};
-}
-
 function buildTelegramMessageEnvelopeFromRecentReceipt(rawReceipt) {
   const receipt = normalizeRunnerRecentLocalInboundReceipt(rawReceipt);
   if (!Object.keys(receipt).length) {

package/lib/runner-orchestration.mjs

@@ -896,57 +896,6 @@ function doesTelegramEnvelopeMatchMessage(rawEnvelope, {
     && intFromRawAllowZero(envelope.message_id, 0) === normalizedMessageID;
 }
 
-function normalizeRunnerRecentLocalInboundReceipt(rawReceipt) {
-  const receipt = safeObject(rawReceipt);
-  const chatID = String(receipt.chat_id || receipt.chatID || "").trim();
-  const messageID = intFromRawAllowZero(receipt.message_id ?? receipt.messageID, 0);
-  if (!chatID || !(messageID > 0)) {
-    return {};
-  }
-  return {
-    chat_id: chatID,
-    message_id: messageID,
-    ...(intFromRawAllowZero(receipt.message_thread_id ?? receipt.messageThreadID, 0) > 0
-      ? { message_thread_id: intFromRawAllowZero(receipt.message_thread_id ?? receipt.messageThreadID, 0) }
-      : {}),
-    ...(intFromRawAllowZero(receipt.reply_to_message_id ?? receipt.replyToMessageID, 0) > 0
-      ? { reply_to_message_id: intFromRawAllowZero(receipt.reply_to_message_id ?? receipt.replyToMessageID, 0) }
-      : {}),
-    ...(String(receipt.kind || "").trim()
-      ? { kind: String(receipt.kind || "").trim().toLowerCase() }
-      : {}),
-    ...(String(receipt.sender || "").trim()
-      ? { sender: String(receipt.sender || "").trim() }
-      : {}),
-    ...(normalizeMentionSelector(receipt.sender_username || receipt.senderUsername || "")
-      ? { sender_username: normalizeMentionSelector(receipt.sender_username || receipt.senderUsername || "") }
-      : {}),
-    sender_is_bot: receipt.sender_is_bot === true || receipt.senderIsBot === true,
-    ...(String(receipt.body || "").trim()
-      ? { body: String(receipt.body || "").trim() }
-      : {}),
-    ...(String(receipt.receipt_origin || receipt.receiptOrigin || "").trim()
-      ? { receipt_origin: String(receipt.receipt_origin || receipt.receiptOrigin || "").trim().toLowerCase() }
-      : {}),
-    ...(String(receipt.receipt_route_key || receipt.receiptRouteKey || "").trim()
-      ? { receipt_route_key: String(receipt.receipt_route_key || receipt.receiptRouteKey || "").trim() }
-      : {}),
-    ...(normalizeMentionSelector(receipt.receipt_bot_username || receipt.receiptBotUsername || "")
-      ? { receipt_bot_username: normalizeMentionSelector(receipt.receipt_bot_username || receipt.receiptBotUsername || "") }
-      : {}),
-  };
-}
-
-function findRecentTelegramInboundReceipt(rawMap, { chatID = "", messageID = 0 } = {}) {
-  const normalizedChatID = String(chatID || "").trim();
-  const normalizedMessageID = intFromRawAllowZero(messageID, 0);
-  if (!normalizedChatID || !(normalizedMessageID > 0)) {
-    return {};
-  }
-  const key = `${normalizedChatID}:${normalizedMessageID}`;
-  return normalizeRunnerRecentLocalInboundReceipt(safeObject(safeObject(rawMap)[key]));
-}
-
 export function resolveRunnerHumanInboundVisibility(args) {
   return resolveRunnerHumanInboundVisibilityImpl(args);
 }

package/lib/runner-runtime.mjs

@@ -2,6 +2,11 @@ import {
   mergeRecentTelegramMessageEnvelopes,
   normalizeTelegramMessageEnvelope,
 } from "./runner-helpers.mjs";
+import {
+  buildRunnerRecentLocalInboundReceiptKey,
+  normalizeRunnerRecentLocalInboundReceipt,
+  normalizeRunnerRecentLocalInboundReceiptEntry,
+} from "./runner-local-inbound-receipts.mjs";
 
 function safeObject(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -203,7 +208,7 @@ function buildRunnerLocalInboundOwnerMap({
   return owners;
 }
 
-function resolveRunnerLocalInboundArtifactOwners({
+export function resolveRunnerLocalInboundArtifactOwners({
   update,
   routeKey,
   route,
@@ -233,15 +238,15 @@ function resolveRunnerLocalInboundArtifactOwners({
       .filter(Boolean),
   ));
   if (explicitMentions.length > 0) {
+    const explicitOwners = explicitMentions
+      .map((selector) => ownersBySelector.get(selector))
+      .filter((owner) => owner && owner.routeKey);
     if (normalizedUpdate.fromIsBot !== true) {
-      if (currentBotSelector && explicitMentions.includes(currentBotSelector) && currentOwner) {
-        return [currentOwner];
+      if (explicitOwners.length > 0) {
+        return explicitOwners;
       }
       return [];
     }
-    const explicitOwners = explicitMentions
-      .map((selector) => ownersBySelector.get(selector))
-      .filter((owner) => owner && owner.routeKey);
     if (explicitOwners.length > 0) {
       return explicitOwners;
     }
@@ -443,115 +448,6 @@ const RUNNER_RECENT_LOCAL_INBOUND_ENVELOPE_LIMIT = 200;
 const RUNNER_RECENT_LOCAL_INBOUND_RECEIPT_LIMIT = 200;
 const RUNNER_TELEGRAM_BOT_CAPABILITY_REFRESH_MS = 6 * 60 * 60 * 1000;
 
-function buildRunnerRecentLocalInboundReceiptKey(chatID, messageID) {
-  return `${String(chatID || "").trim()}:${intFromRawAllowZero(messageID, 0)}`;
-}
-
-function normalizeRunnerRecentLocalInboundReceipt(rawReceipt, fallbackKey = "") {
-  const receipt = safeObject(rawReceipt);
-  const chatID = String(receipt.chat_id || receipt.chatID || "").trim();
-  const messageID = intFromRawAllowZero(receipt.message_id ?? receipt.messageID, 0);
-  const receiptKey = String(fallbackKey || buildRunnerRecentLocalInboundReceiptKey(chatID, messageID)).trim();
-  if (!receiptKey || !chatID || !(messageID > 0)) {
-    return null;
-  }
-  const normalized = {
-    chat_id: chatID,
-    message_id: messageID,
-    receipt_origin: firstNonEmptyString([
-      receipt.receipt_origin,
-      receipt.receiptOrigin,
-      receipt.source_origin,
-      receipt.sourceOrigin,
-      "local_telegram_inbound",
-    ]),
-    receipt_route_key: firstNonEmptyString([
-      receipt.receipt_route_key,
-      receipt.receiptRouteKey,
-      receipt.source_route_key,
-      receipt.sourceRouteKey,
-    ]),
-    receipt_bot_username: normalizeMentionSelector(
-      firstNonEmptyString([
-        receipt.receipt_bot_username,
-        receipt.receiptBotUsername,
-        receipt.source_bot_username,
-        receipt.sourceBotUsername,
-      ]),
-    ),
-    kind: firstNonEmptyString([receipt.kind, "telegram_message"]),
-    sender: firstNonEmptyString([receipt.sender, receipt.from_name, receipt.fromName]),
-    sender_username: firstNonEmptyString([
-      receipt.sender_username,
-      receipt.senderUsername,
-      receipt.from_username,
-      receipt.fromUsername,
-    ]),
-    sender_is_bot: Boolean(receipt.sender_is_bot ?? receipt.senderIsBot ?? false),
-    body: firstNonEmptyString([receipt.body, receipt.text]),
-    occurred_at: firstNonEmptyString([receipt.occurred_at, receipt.occurredAt]),
-    received_at: firstNonEmptyString([receipt.received_at, receipt.receivedAt, new Date().toISOString()]),
-  };
-  const senderID = firstNonEmptyString([receipt.sender_id, receipt.senderID, receipt.from_id, receipt.fromID]);
-  if (senderID) {
-    normalized.sender_id = senderID;
-  }
-  const updateID = intFromRawAllowZero(receipt.update_id ?? receipt.updateID, 0);
-  if (updateID > 0) {
-    normalized.update_id = updateID;
-  }
-  const messageThreadID = intFromRawAllowZero(receipt.message_thread_id ?? receipt.messageThreadID, 0);
-  if (messageThreadID > 0) {
-    normalized.message_thread_id = messageThreadID;
-  }
-  const replyToMessageID = intFromRawAllowZero(receipt.reply_to_message_id ?? receipt.replyToMessageID, 0);
-  if (replyToMessageID > 0) {
-    normalized.reply_to_message_id = replyToMessageID;
-  }
-  const replyToFromUsername = firstNonEmptyString([
-    receipt.reply_to_from_username,
-    receipt.replyToFromUsername,
-    receipt.reply_to_username,
-    receipt.replyToUsername,
-  ]);
-  if (replyToFromUsername) {
-    normalized.reply_to_from_username = replyToFromUsername;
-  }
-  if (receipt.reply_to_from_is_bot === true || receipt.replyToFromIsBot === true) {
-    normalized.reply_to_from_is_bot = true;
-  }
-  const chatType = firstNonEmptyString([receipt.chat_type, receipt.chatType]);
-  if (chatType) {
-    normalized.chat_type = chatType;
-  }
-  const chatTitle = firstNonEmptyString([receipt.chat_title, receipt.chatTitle]);
-  if (chatTitle) {
-    normalized.chat_title = chatTitle;
-  }
-  const canonicalHumanMessageKey = String(
-    safeObject(normalizeTelegramMessageEnvelope({
-      chat_id: normalized.chat_id,
-      message_id: normalized.message_id,
-      message_thread_id: normalized.message_thread_id,
-      reply_to_message_id: normalized.reply_to_message_id,
-      kind: normalized.kind,
-      sender_id: normalized.sender_id,
-      sender_username: normalized.sender_username,
-      sender_is_bot: normalized.sender_is_bot === true,
-      body: normalized.body,
-      occurred_at: normalized.occurred_at,
-      canonical_human_message_key: firstNonEmptyString([
-        receipt.canonical_human_message_key,
-        receipt.canonicalHumanMessageKey,
-      ]),
-    })).canonical_human_message_key || "",
-  ).trim();
-  if (canonicalHumanMessageKey) {
-    normalized.canonical_human_message_key = canonicalHumanMessageKey;
-  }
-  return [receiptKey, normalized];
-}
-
 function buildRunnerLocalInboundEnvelopeFromReceipt(rawReceipt) {
   const receipt = safeObject(rawReceipt);
   return normalizeTelegramMessageEnvelope({
@@ -590,7 +486,7 @@ function buildRunnerLocalInboundArtifacts(updates, routeKey, route, bot, destina
         const chatID = String(update.chatID || "").trim();
         const messageID = intFromRawAllowZero(update.messageID, 0);
         const receiptKey = buildRunnerRecentLocalInboundReceiptKey(chatID, messageID);
-        const receiptEntry = normalizeRunnerRecentLocalInboundReceipt({
+        const receiptEntry = normalizeRunnerRecentLocalInboundReceiptEntry({
           update_id: intFromRawAllowZero(update.updateID, 0),
           chat_id: chatID,
           chat_type: update.chatType,
@@ -664,9 +560,9 @@ function buildRunnerRecentLocalInboundReceipts(routeStateRaw, localInboundArtifa
   const routeState = safeObject(routeStateRaw);
   const merged = new Map();
   for (const [key, value] of Object.entries(safeObject(routeState.recent_local_inbound_receipts))) {
-    const normalizedEntry = normalizeRunnerRecentLocalInboundReceipt(value, key);
-    if (!normalizedEntry) continue;
-    merged.set(normalizedEntry[0], normalizedEntry[1]);
+        const normalizedEntry = normalizeRunnerRecentLocalInboundReceiptEntry(value, key);
+        if (!normalizedEntry) continue;
+        merged.set(normalizedEntry[0], normalizedEntry[1]);
   }
   for (const artifact of ensureArray(localInboundArtifacts)) {
     const normalizedEntry = ensureArray(safeObject(artifact).receiptEntry);

package/lib/selftest-runner-scenarios.mjs

@@ -93,6 +93,18 @@ import {
   buildRunnerRouteDuplicateStateFromComment,
   buildRunnerRouteStateFromComment,
 } from "./runner-helpers.mjs";
+import {
+  validateRunnerConversationDecisionBundle,
+} from "./runner-orchestration-decision-bundle.mjs";
+import {
+  resolveRunnerLocalInboundArtifactOwners,
+} from "./runner-runtime.mjs";
+import {
+  buildRunnerLocalInboundReceiptKey,
+  findRecentTelegramInboundReceipt,
+  normalizeRunnerRecentLocalInboundReceiptEntry,
+  normalizeRunnerRecentLocalInboundReceiptMap,
+} from "./runner-local-inbound-receipts.mjs";
 import {
   buildRunnerInheritedRootReferenceRecorderResult,
   buildRunnerRootThreadRecorderFailure,
@@ -22509,9 +22521,128 @@ export async function runSelftestRunnerScenarios(push, deps) {
     [{ id: "comment-3", body: botReplyArchiveComment }],
     { chatID: "-100123", messageID: 4321, parseArchivedChatComment },
   );
-  push(
-    "archive_bot_reply_dedupe_by_chat_and_message_id",
-    String(existingBotReplyRecord?.id || "") === "comment-3",
-    `comment_id=${String(existingBotReplyRecord?.id || "(none)")}`,
-  );
-}
+  push(
+    "archive_bot_reply_dedupe_by_chat_and_message_id",
+    String(existingBotReplyRecord?.id || "") === "comment-3",
+    `comment_id=${String(existingBotReplyRecord?.id || "(none)")}`,
+  );
+
+  try {
+    const owners = resolveRunnerLocalInboundArtifactOwners({
+      update: {
+        fromIsBot: false,
+        mentionUsernames: ["RyoAI_bot", "RyoAI2_bot", "RyoAI3_bot"],
+      },
+      routeKey: "telegram-monitor-ryoai-bot-2::project::telegram::monitor::dest::actor",
+      route: {
+        botName: "RyoAI_bot",
+      },
+      bot: {
+        username: "RyoAI_bot",
+      },
+      managedConversationBots: [
+        {
+          username: "RyoAI2_bot",
+          routeKey: "telegram-monitor-ryoai2-bot-2::project::telegram::monitor::dest::actor",
+        },
+        {
+          username: "RyoAI3_bot",
+          routeKey: "telegram-monitor-ryoai3-bot::project::telegram::monitor::dest::actor",
+        },
+      ],
+    });
+    push(
+      "runner_runtime_fans_out_human_multi_mention_receipts_to_all_explicit_managed_routes",
+      ensureArray(owners).length === 3
+        && ensureArray(owners).map((item) => String(safeSelftestObject(item).botUsername || "").trim().toLowerCase()).join(",") === "ryoai_bot,ryoai2_bot,ryoai3_bot",
+      `owners=${ensureArray(owners).map((item) => `${String(safeSelftestObject(item).botUsername || "(none)")}:${String(safeSelftestObject(item).routeKey || "(none)")}`).join("|")}`,
+    );
+  } catch (err) {
+    push("runner_runtime_fans_out_human_multi_mention_receipts_to_all_explicit_managed_routes", false, String(err?.message || err));
+  }
+
+  try {
+    const normalizedEntry = normalizeRunnerRecentLocalInboundReceiptEntry({
+      chat_id: "-100123",
+      message_id: 321,
+      kind: "telegram_message",
+      sender_username: "tester",
+      sender_is_bot: false,
+      body: "@RyoAI_bot @RyoAI2_bot hi",
+      occurred_at: "2026-04-06T00:00:00.000Z",
+      receipt_bot_username: "RyoAI_bot",
+    });
+    const normalizedReceipt = safeSelftestObject(ensureArray(normalizedEntry)[1]);
+    const canonicalKey = String(normalizedReceipt.canonical_human_message_key || "").trim();
+    const receiptMap = normalizeRunnerRecentLocalInboundReceiptMap({
+      "-100123:321": {
+        chat_id: "-100123",
+        message_id: 321,
+        kind: "telegram_message",
+        sender_username: "tester",
+        sender_is_bot: false,
+        body: "@RyoAI_bot @RyoAI2_bot hi",
+        occurred_at: "2026-04-06T00:00:00.000Z",
+        receipt_bot_username: "RyoAI_bot",
+      },
+    });
+    const foundByCanonical = findRecentTelegramInboundReceipt(receiptMap, {
+      chatID: "-100123",
+      canonicalHumanMessageKey: canonicalKey,
+    });
+    const archiveReceiptKey = buildRunnerLocalInboundReceiptKey(normalizedReceipt, {
+      resolveTargetSelector: () => "RyoAI_bot",
+    });
+    push(
+      "runner_local_inbound_receipt_helpers_share_canonical_normalization",
+      Boolean(normalizedEntry)
+        && Boolean(canonicalKey)
+        && String(safeSelftestObject(foundByCanonical).canonical_human_message_key || "") === canonicalKey
+        && archiveReceiptKey === `human:${canonicalKey}`,
+      `canonical=${canonicalKey || "(none)"} archive_key=${archiveReceiptKey || "(none)"} found=${String(safeSelftestObject(foundByCanonical).canonical_human_message_key || "(none)")}`,
+    );
+  } catch (err) {
+    push("runner_local_inbound_receipt_helpers_share_canonical_normalization", false, String(err?.message || err));
+  }
+
+  try {
+    const contradictoryDirectValidation = validateRunnerConversationDecisionBundle({
+      schema_version: "runner_conversation_decision.v1",
+      decision_type: "reply_outcome",
+      conversation_intent_mode: "multi_bot_direct",
+      allowed_responders: ["ryoai_bot", "ryoai2_bot", "ryoai3_bot"],
+      initial_responders: ["ryoai_bot", "ryoai2_bot", "ryoai3_bot"],
+      selected_bot_usernames: ["ryoai_bot"],
+      execution_contract_type: "direct_result",
+      execution_contract_targets: ["ryoai_bot"],
+      next_expected_responders: [],
+      should_close_after_reply: true,
+      turn_kind: "direct_reply",
+      actionable_for_current_route: false,
+    });
+    const contradictoryDelegationValidation = validateRunnerConversationDecisionBundle({
+      schema_version: "runner_conversation_decision.v1",
+      decision_type: "reply_outcome",
+      conversation_intent_mode: "multi_bot_direct",
+      allowed_responders: ["ryoai_bot", "ryoai2_bot"],
+      initial_responders: ["ryoai_bot", "ryoai2_bot"],
+      selected_bot_usernames: ["ryoai_bot", "ryoai2_bot"],
+      execution_contract_type: "delegation",
+      execution_contract_targets: ["ryoai2_bot"],
+      next_expected_responders: ["ryoai2_bot"],
+      should_close_after_reply: false,
+      turn_kind: "delegation_kickoff",
+      actionable_for_current_route: true,
+    });
+    push(
+      "runner_decision_bundle_validation_rejects_contradictory_multi_bot_opening_contracts",
+      contradictoryDirectValidation.ok !== true
+        && String(contradictoryDirectValidation.status || "") === "contradictory_multi_initial_close_state"
+        && contradictoryDelegationValidation.ok !== true
+        && String(contradictoryDelegationValidation.status || "") === "contradictory_delegation_intent_mode",
+      `direct=${String(contradictoryDirectValidation.status || "(none)")}:${String(contradictoryDirectValidation.reason || "(none)")} delegation=${String(contradictoryDelegationValidation.status || "(none)")}:${String(contradictoryDelegationValidation.reason || "(none)")}`,
+    );
+  } catch (err) {
+    push("runner_decision_bundle_validation_rejects_contradictory_multi_bot_opening_contracts", false, String(err?.message || err));
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metheus-governance-mcp-cli",
-  "version": "0.2.293",
+  "version": "0.2.294",
   "description": "Metheus Governance MCP CLI (setup + stdio proxy)",
   "type": "module",
   "files": [