@openclaw/whatsapp 2026.8.1-beta.2 → 2026.9.1-beta.1

package/dist/{monitor-BCe5Mm-1.js → monitor-C_Nw23PZ.js}

@@ -1,19 +1,19 @@
 import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-BX2fZUyR.js";
-import { _ as resolveWhatsAppReactionLevel, a as normalizeWhatsAppOutboundPayload, c as prepareWhatsAppOutboundMedia, d as mergeWhatsAppAcceptedSendError, f as normalizeWhatsAppSendResult, h as withWhatsAppLogicalDeliveryActivity, m as rememberWhatsAppPartialSend, p as rememberWhatsAppAcceptedSend, r as sendReactionWhatsApp, s as normalizeWhatsAppPayloadTextPreservingIndentation, u as listWhatsAppSendResultMessageIds } from "./send-prK8F7Vj.js";
+import { c as normalizeWhatsAppPayloadTextPreservingIndentation, d as listWhatsAppSendResultMessageIds, f as mergeWhatsAppAcceptedSendError, g as withWhatsAppLogicalDeliveryActivity, h as rememberWhatsAppPartialSend, l as prepareWhatsAppOutboundMedia, m as rememberWhatsAppAcceptedSend, o as normalizeWhatsAppOutboundPayload, p as normalizeWhatsAppSendResult, r as sendReactionWhatsApp, v as resolveWhatsAppReactionLevel } from "./send-DLMUc2uZ.js";
 import { i as getWhatsAppRuntime } from "./runtime-BLlToOi6.js";
 import { r as getWhatsAppConnectionController } from "./connection-controller-runtime-context-DG0tuYuw.js";
 import { a as markdownToWhatsAppChunks, c as toWhatsappJid, l as toWhatsappJidWithLid, n as isSelfChatMode, o as resolveEquivalentWhatsAppDirectChatJids, r as jidToE164, s as resolveJidToE164 } from "./targets-runtime-TMk0lGuy.js";
 import { t as normalizeE164 } from "./text-runtime-CaKLhowd.js";
 import { a as cacheInboundMessageMeta, i as buildQuotedMessageOptions, n as resolveWhatsAppGroupSessionRoute, o as lookupInboundMessageMeta, r as resolveWhatsAppLegacyGroupSessionKey } from "./group-session-key-DmFc_Cqi.js";
-import { C as getMentionIdentities, D as getSenderIdentity, E as getSelfIdentity, O as identitiesOverlap, S as getComparableIdentityValues, T as getReplyContext, g as readWebSelfId, k as resolveComparableIdentity, o as getWebAuthAgeMs, r as WhatsAppAuthUnstableError, v as readWebSelfIdentityForDecision, w as getPrimaryIdentityId } from "./auth-store-B_DQIdzp.js";
+import { C as getMentionIdentities, D as getSenderIdentity, E as getSelfIdentity, O as identitiesOverlap, S as getComparableIdentityValues, T as getReplyContext, g as readWebSelfId, k as resolveComparableIdentity, o as getWebAuthAgeMs, r as WhatsAppAuthUnstableError, v as readWebSelfIdentityForDecision, w as getPrimaryIdentityId } from "./auth-store-CtpBqH5S.js";
 import { n as resolveWhatsAppGroupsConfigPath } from "./group-config-path-BGyzT9Lg.js";
-import { a as waitForWaConnection, c as isWhatsAppSocketOperationTimeoutError, d as withWhatsAppSocketOperationTimeout, l as resolveWhatsAppSocketOperationTimeoutMs, r as createWaSocket, s as createWhatsAppSocketOperationTimeoutAdapter, u as resolveWhatsAppSocketTiming } from "./socket-close-09FojDO2.js";
+import { a as waitForWaConnection, c as isWhatsAppSocketOperationTimeoutError, d as withWhatsAppSocketOperationTimeout, l as resolveWhatsAppSocketOperationTimeoutMs, r as createWaSocket, s as createWhatsAppSocketOperationTimeoutAdapter, u as resolveWhatsAppSocketTiming } from "./socket-close-2T0_jZTN.js";
 import { n as getStatusCode, t as formatError } from "./session-errors-JuazczrA.js";
 import { t as BufferJSON } from "./session.runtime-Nsqaehbd.js";
-import { a as addWhatsAppImagePreviewFields, c as extractContextInfo, d as extractMediaKind, f as extractMentionedJids, g as resolveInboundMediaMimetype, h as hasInboundUserContent, i as resolveWhatsAppOutboundMentions, l as extractExternalAdReplyContext, n as addWhatsAppOutboundMentionsToContent, o as describeReplyContext, p as extractText, r as mayContainWhatsAppOutboundMention, s as extractContactContext, t as createWebSendApi, u as extractLocationData } from "./send-api-DimZST3E.js";
+import { _ as resolveInboundMediaMimetype, a as addWhatsAppImagePreviewFields, c as extractContextInfo, d as extractMediaKind, f as extractMentionedJids, g as projectWhatsAppInboundMessage, h as hasInboundUserContent, i as resolveWhatsAppOutboundMentions, l as extractExternalAdReplyContext, n as addWhatsAppOutboundMentionsToContent, o as describeReplyContext, p as extractText, r as mayContainWhatsAppOutboundMention, s as extractContactContext, t as createWebSendApi, u as extractLocationData } from "./send-api-BtK45TmZ.js";
 import { t as resolveWhatsAppRuntimeGroupPolicy } from "./runtime-group-policy-DeSRFXEV.js";
-import { c as computeBackoff, d as resolveReconnectPolicy, f as sleepWithAbort, l as newConnectionId, n as WHATSAPP_WATCHDOG_TIMEOUT_ERROR, r as WhatsAppConnectionController, s as DEFAULT_RECONNECT_POLICY, u as resolveHeartbeatSeconds } from "./connection-controller-CUyZgGpf.js";
-import { n as maybeResolveWhatsAppApprovalReaction } from "./approval-reactions-CmtJCxe_.js";
+import { c as computeBackoff, d as resolveReconnectPolicy, f as sleepWithAbort, l as newConnectionId, n as WHATSAPP_WATCHDOG_TIMEOUT_ERROR, r as WhatsAppConnectionController, s as DEFAULT_RECONNECT_POLICY, u as resolveHeartbeatSeconds } from "./connection-controller-CIYuBJrs.js";
+import { n as maybeResolveWhatsAppApprovalReaction } from "./approval-reactions-Jyr1JaAK.js";
 import { t as maybeResolveWhatsAppQuestionReaction } from "./question-reactions-D3eAeB0i.js";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { filterSupplementalContextItems, resolvePinnedMainDmOwnerFromAllowlist } from "openclaw/plugin-sdk/security-runtime";
@@ -28,7 +28,7 @@ import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runt
 import { buildChannelInboundEventContext, createChannelPartialDeliveryError, filterChannelInboundQuoteContext, formatInboundEnvelope, formatInboundEnvelope as formatInboundEnvelope$1, formatInboundMediaUnavailableText, formatLocationText, formatMediaPlaceholderText, hasVisibleInboundReplyDispatch, isChannelPartialDeliveryError, readAgentRunTerminalOutcome, resolveInboundSessionEnvelopeContext, resolveInboundSupplementalSenderAllowed, runChannelInboundEvent, shouldDebounceTextInbound, toInboundMediaFactsWithMetadata, toLocationContext } from "openclaw/plugin-sdk/channel-inbound";
 import { bindIngressLifecycleToReplyOptions, createChannelIngressMonitor, createChannelMessageReplyPipeline, createMessageReceiptFromOutboundResults, listMessageReceiptPlatformIds, resolveChannelMessageSourceReplyDeliveryMode, resolveChannelStreamingBlockEnabled } from "openclaw/plugin-sdk/channel-outbound";
 import { getAgentScopedMediaLocalRoots } from "openclaw/plugin-sdk/media-runtime";
-import { isReasoningReplyPayload, resolveSendableOutboundReplyParts, sendMediaWithLeadingCaption } from "openclaw/plugin-sdk/reply-payload";
+import { isReasoningReplyPayload, resolveSendableOutboundReplyParts, resolveTextChunksWithFallback, sendMediaWithLeadingCaption } from "openclaw/plugin-sdk/reply-payload";
 import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { DisconnectReason, downloadMediaMessage, isHostedLidUser, isHostedPnUser, isJidGroup, isJidGroup as isJidGroup$1, jidDecode, jidEncode, jidNormalizedUser, normalizeMessageContent as normalizeMessageContent$1 } from "baileys";
@@ -56,12 +56,14 @@ import { channelReadyPatch, channelStoppedPatch, createTransportActivityStatusPa
 import { ensureConfiguredBindingRouteReady, resolveConfiguredBindingRoute } from "openclaw/plugin-sdk/conversation-binding-runtime";
 import { resolveAgentIdentity, resolveIdentityNamePrefix as resolveIdentityNamePrefix$1 } from "openclaw/plugin-sdk/agent-runtime";
 import { normalizeGroupActivation, parseActivationCommand } from "openclaw/plugin-sdk/group-activation";
+import { formatAudioTranscriptForAgent } from "openclaw/plugin-sdk/media-understanding-runtime";
 import { hasControlCommand, isControlCommandMessage, shouldComputeCommandAuthorized } from "openclaw/plugin-sdk/command-detection";
 import { createInternalHookEvent, deriveInboundMessageHookContext, fireAndForgetBoundedHook, toInternalMessageReceivedContext, toPluginMessageContext, toPluginMessageReceivedEvent, triggerInternalHook } from "openclaw/plugin-sdk/hook-runtime";
 import { getGlobalHookRunner } from "openclaw/plugin-sdk/plugin-runtime";
 import { resolveBatchedReplyThreadingPolicy } from "openclaw/plugin-sdk/reply-reference";
 import { LocalMediaAccessError, getDefaultLocalRoots, loadWebMedia, loadWebMediaRaw, optimizeImageToJpeg, optimizeImageToPng } from "openclaw/plugin-sdk/web-media";
 import { createChannelApiRetryRunner } from "openclaw/plugin-sdk/retry-runtime";
+import { resolveAgentConfig } from "openclaw/plugin-sdk/agent-scope-runtime";
 //#region extensions/whatsapp/src/inbound/group-conversation.ts
 function resolveWhatsAppGroupConversationId(conversationId) {
 	return resolveGroupSessionKey({
@@ -130,66 +132,10 @@ function buildWhatsAppInboundAdmission(params) {
 async function resolveWhatsAppAdmissionChannelIngress(admission, contextBinding) {
 	return await ingressResolverByAdmission.get(admission)?.(contextBinding);
 }
-function buildDeprecatedFlatWhatsAppInboundAdmission(msg) {
-	const conversationId = msg.conversationId || msg.from;
-	if (!conversationId || !msg.accountId || !msg.chatType) throw new Error("WhatsApp legacy flat inbound messages must include deprecated top-level admission fields.");
-	const accountId = msg.accountId;
-	const admitted = msg.accessControlPassed !== false;
-	const platformSender = msg.platform?.sender;
-	const senderE164 = platformSender?.e164 ?? msg.platform?.senderE164 ?? msg.senderE164;
-	const senderJid = platformSender?.jid ?? msg.platform?.senderJid ?? msg.senderJid;
-	const senderName = platformSender?.name ?? msg.platform?.senderName ?? msg.senderName;
-	const senderId = msg.chatType === "group" ? senderE164 ?? senderJid ?? senderName ?? conversationId : senderE164 ?? conversationId;
-	const reasonCode = admitted ? msg.chatType === "group" ? "group_policy_allowed" : "dm_policy_allowlisted" : "no_policy_match";
-	return buildWhatsAppInboundAdmission({
-		policy: {
-			account: {
-				accountId,
-				enabled: true,
-				sendReadReceipts: true
-			},
-			isSelfChat: false,
-			isSamePhone: () => false
-		},
-		access: {
-			ingress: {
-				admission: admitted ? "dispatch" : "drop",
-				decision: admitted ? "allow" : "block",
-				decisiveGateId: "legacy-flat-compat",
-				reasonCode
-			},
-			senderAccess: {
-				allowed: admitted,
-				decision: admitted ? "allow" : "block",
-				reasonCode,
-				providerMissingFallbackApplied: false
-			},
-			commandAccess: {
-				requested: false,
-				authorized: false,
-				shouldBlockControlCommand: false,
-				reasonCode: "command_authorized"
-			},
-			activationAccess: {
-				ran: false,
-				allowed: admitted,
-				shouldSkip: !admitted,
-				reasonCode: admitted ? "activation_allowed" : "activation_skipped"
-			}
-		},
-		isGroup: msg.chatType === "group",
-		conversationId,
-		senderId
-	});
-}
 function requireWhatsAppInboundAdmission(params) {
 	if (!params.admission) throw new Error("WhatsApp inbound message is missing admission facts");
 	return params.admission;
 }
-function requireAdmittedWhatsAppInboundMessage(msg) {
-	requireWhatsAppInboundAdmission(msg);
-	return msg;
-}
 //#endregion
 //#region extensions/whatsapp/src/inbound-policy.ts
 function normalizeWhatsAppIngressPhone(value) {
@@ -324,353 +270,6 @@ function readWhatsAppBaileysCacheEntry(cache, key) {
 	return entry.value;
 }
 //#endregion
-//#region extensions/whatsapp/src/inbound/message-aliases.ts
-function normalizeQuoteSender(sender) {
-	if (!sender?.displayName && !sender?.jid && !sender?.e164) return;
-	return sender;
-}
-function buildQuoteFromFlatAliases(msg) {
-	if (msg.replyTo) return {
-		context: msg.replyTo,
-		id: msg.replyTo.id,
-		body: msg.replyTo.body,
-		sender: normalizeQuoteSender({
-			displayName: msg.replyTo.sender?.label ?? msg.replyToSender,
-			jid: msg.replyTo.sender?.jid ?? msg.replyToSenderJid,
-			e164: msg.replyTo.sender?.e164 ?? msg.replyToSenderE164
-		})
-	};
-	if (!msg.replyToId && !msg.replyToBody && !msg.replyToSender && !msg.replyToSenderJid && !msg.replyToSenderE164) return;
-	return {
-		id: msg.replyToId,
-		body: msg.replyToBody,
-		sender: normalizeQuoteSender({
-			displayName: msg.replyToSender,
-			jid: msg.replyToSenderJid,
-			e164: msg.replyToSenderE164
-		})
-	};
-}
-function buildGroupFromFlatAliases(msg) {
-	const mentionJids = msg.mentions ?? msg.mentionedJids;
-	if (!msg.groupSubject && !msg.groupParticipants?.length && !mentionJids?.length) return;
-	return {
-		subject: msg.groupSubject,
-		participants: msg.groupParticipants,
-		mentions: mentionJids?.length ? { jids: mentionJids } : void 0
-	};
-}
-function ensureQuote(msg) {
-	return msg.quote ??= {};
-}
-function ensureQuoteSender(msg) {
-	const quote = ensureQuote(msg);
-	return quote.sender ??= {};
-}
-function ensureGroup(msg) {
-	return msg.group ??= {};
-}
-function ensureGroupMentions(msg) {
-	const group = ensureGroup(msg);
-	return group.mentions ??= {};
-}
-function ensureMedia(msg) {
-	return msg.payload.media ??= {};
-}
-function setMediaField(msg, key, value) {
-	if (value === void 0 && !msg.payload.media) return;
-	ensureMedia(msg)[key] = value;
-}
-function defineDeprecatedAccessors(msg, descriptors) {
-	Object.defineProperties(msg, Object.fromEntries(Object.entries(descriptors).map(([key, descriptor]) => [key, {
-		configurable: true,
-		enumerable: true,
-		get: descriptor.get,
-		set: descriptor.set
-	}])));
-	return msg;
-}
-function defineDeprecatedAliasAccessors(msg, descriptors) {
-	defineDeprecatedAccessors(msg, descriptors);
-	return msg;
-}
-function defineDeprecatedStructuredContextPayloadAlias(msg) {
-	const channelStructuredContext = msg.payload.channelStructuredContext ?? msg.payload.untrustedStructuredContext;
-	if (channelStructuredContext !== void 0) msg.payload.channelStructuredContext = channelStructuredContext;
-	Object.defineProperty(msg.payload, "untrustedStructuredContext", {
-		configurable: true,
-		enumerable: true,
-		get: () => msg.payload.channelStructuredContext,
-		set: (value) => {
-			msg.payload.channelStructuredContext = value;
-		}
-	});
-}
-function defineDeprecatedAdmissionTopLevelAccessors(msg) {
-	let fallbackConversationId = msg.conversationId || msg.from;
-	let fallbackAccountId = msg.accountId;
-	let fallbackAccessControlPassed = msg.accessControlPassed;
-	let fallbackChatType = msg.chatType;
-	const conversationId = () => msg.admission?.conversation.id ?? fallbackConversationId;
-	const setConversationId = (value) => {
-		const next = value;
-		fallbackConversationId = next;
-		if (msg.admission) {
-			msg.admission.conversation.id = next;
-			msg.admission.conversation.groupSessionId = resolveWhatsAppGroupConversationId(next);
-		}
-	};
-	return defineDeprecatedAccessors(msg, {
-		from: {
-			get: conversationId,
-			set: setConversationId
-		},
-		conversationId: {
-			get: conversationId,
-			set: setConversationId
-		},
-		accountId: {
-			get: () => msg.admission?.accountId ?? fallbackAccountId,
-			set: (value) => {
-				const next = value;
-				fallbackAccountId = next;
-				if (msg.admission) {
-					msg.admission.accountId = next;
-					msg.admission.account.accountId = next;
-				}
-			}
-		},
-		accessControlPassed: {
-			get: () => {
-				if (msg.admission?.ingress.decisiveGateId === "legacy-flat-compat") return fallbackAccessControlPassed;
-				return msg.admission ? msg.admission.ingress.decision === "allow" : fallbackAccessControlPassed;
-			},
-			set: (value) => {
-				if (!msg.admission) fallbackAccessControlPassed = value;
-			}
-		},
-		chatType: {
-			get: () => msg.admission?.conversation.kind ?? fallbackChatType,
-			set: (value) => {
-				const next = value;
-				fallbackChatType = next;
-				if (msg.admission) msg.admission.conversation.kind = next;
-			}
-		}
-	});
-}
-function withDeprecatedWebInboundMessageFlatAliases(msg) {
-	defineDeprecatedStructuredContextPayloadAlias(msg);
-	return defineDeprecatedAliasAccessors(defineDeprecatedAdmissionTopLevelAccessors(msg), {
-		id: {
-			get: () => msg.event.id,
-			set: (value) => msg.event.id = value
-		},
-		to: {
-			get: () => msg.platform.recipientJid,
-			set: (value) => msg.platform.recipientJid = value
-		},
-		body: {
-			get: () => msg.payload.body,
-			set: (value) => msg.payload.body = value
-		},
-		pushName: {
-			get: () => msg.platform.pushName,
-			set: (value) => msg.platform.pushName = value
-		},
-		timestamp: {
-			get: () => msg.event.timestamp,
-			set: (value) => msg.event.timestamp = value
-		},
-		chatId: {
-			get: () => msg.platform.chatJid,
-			set: (value) => msg.platform.chatJid = value
-		},
-		sender: {
-			get: () => msg.platform.sender,
-			set: (value) => msg.platform.sender = value
-		},
-		senderJid: {
-			get: () => msg.platform.senderJid,
-			set: (value) => msg.platform.senderJid = value
-		},
-		senderE164: {
-			get: () => msg.platform.senderE164,
-			set: (value) => msg.platform.senderE164 = value
-		},
-		senderName: {
-			get: () => msg.platform.senderName,
-			set: (value) => msg.platform.senderName = value
-		},
-		replyTo: {
-			get: () => msg.quote?.context,
-			set: (value) => ensureQuote(msg).context = value
-		},
-		replyToId: {
-			get: () => msg.quote?.id ?? msg.quote?.context?.id,
-			set: (value) => ensureQuote(msg).id = value
-		},
-		replyToBody: {
-			get: () => msg.quote?.body ?? msg.quote?.context?.body,
-			set: (value) => ensureQuote(msg).body = value
-		},
-		replyToSender: {
-			get: () => msg.quote?.context?.sender?.label ?? msg.quote?.sender?.displayName,
-			set: (value) => {
-				const sender = ensureQuoteSender(msg);
-				sender.displayName = value;
-				if (msg.quote?.context?.sender) msg.quote.context.sender.label = value;
-			}
-		},
-		replyToSenderJid: {
-			get: () => msg.quote?.context?.sender?.jid ?? msg.quote?.sender?.jid,
-			set: (value) => {
-				const jid = value;
-				ensureQuoteSender(msg).jid = jid;
-				if (msg.quote?.context?.sender) msg.quote.context.sender.jid = jid;
-			}
-		},
-		replyToSenderE164: {
-			get: () => msg.quote?.context?.sender?.e164 ?? msg.quote?.sender?.e164,
-			set: (value) => {
-				const e164 = value;
-				ensureQuoteSender(msg).e164 = e164;
-				if (msg.quote?.context?.sender) msg.quote.context.sender.e164 = e164;
-			}
-		},
-		groupSubject: {
-			get: () => msg.group?.subject,
-			set: (value) => ensureGroup(msg).subject = value
-		},
-		groupParticipants: {
-			get: () => msg.group?.participants,
-			set: (value) => ensureGroup(msg).participants = value
-		},
-		mentions: {
-			get: () => msg.group?.mentions?.jids,
-			set: (value) => ensureGroupMentions(msg).jids = value
-		},
-		mentionedJids: {
-			get: () => msg.group?.mentions?.jids,
-			set: (value) => ensureGroupMentions(msg).jids = value
-		},
-		self: {
-			get: () => msg.platform.self,
-			set: (value) => msg.platform.self = value
-		},
-		selfJid: {
-			get: () => msg.platform.selfJid,
-			set: (value) => msg.platform.selfJid = value
-		},
-		selfLid: {
-			get: () => msg.platform.selfLid,
-			set: (value) => msg.platform.selfLid = value
-		},
-		selfE164: {
-			get: () => msg.platform.selfE164,
-			set: (value) => msg.platform.selfE164 = value
-		},
-		fromMe: {
-			get: () => msg.platform.fromMe,
-			set: (value) => msg.platform.fromMe = value
-		},
-		location: {
-			get: () => msg.payload.location,
-			set: (value) => msg.payload.location = value
-		},
-		sendComposing: {
-			get: () => msg.platform.sendComposing,
-			set: (value) => msg.platform.sendComposing = value
-		},
-		reply: {
-			get: () => msg.platform.reply,
-			set: (value) => msg.platform.reply = value
-		},
-		sendMedia: {
-			get: () => msg.platform.sendMedia,
-			set: (value) => msg.platform.sendMedia = value
-		},
-		mediaPath: {
-			get: () => msg.payload.media?.path,
-			set: (value) => setMediaField(msg, "path", value)
-		},
-		mediaType: {
-			get: () => msg.payload.media?.type,
-			set: (value) => setMediaField(msg, "type", value)
-		},
-		mediaFileName: {
-			get: () => msg.payload.media?.fileName,
-			set: (value) => setMediaField(msg, "fileName", value)
-		},
-		mediaUrl: {
-			get: () => msg.payload.media?.url,
-			set: (value) => setMediaField(msg, "url", value)
-		},
-		channelStructuredContext: {
-			get: () => msg.payload.channelStructuredContext,
-			set: (value) => msg.payload.channelStructuredContext = value
-		},
-		untrustedStructuredContext: {
-			get: () => msg.payload.channelStructuredContext,
-			set: (value) => msg.payload.channelStructuredContext = value
-		},
-		isBatched: {
-			get: () => msg.event.isBatched,
-			set: (value) => msg.event.isBatched = value
-		}
-	});
-}
-function normalizeLegacyFlatWebInboundMessage(msg) {
-	const media = msg.mediaPath || msg.mediaType || msg.mediaFileName || msg.mediaUrl ? {
-		path: msg.mediaPath,
-		type: msg.mediaType,
-		fileName: msg.mediaFileName,
-		url: msg.mediaUrl
-	} : void 0;
-	return withDeprecatedWebInboundMessageFlatAliases({
-		...msg,
-		admission: msg.admission ?? buildDeprecatedFlatWhatsAppInboundAdmission(msg),
-		event: {
-			id: msg.id,
-			timestamp: msg.timestamp,
-			isBatched: msg.isBatched
-		},
-		payload: {
-			body: msg.body,
-			media,
-			location: msg.location,
-			channelStructuredContext: msg.channelStructuredContext ?? msg.untrustedStructuredContext
-		},
-		platform: {
-			chatJid: msg.chatId,
-			recipientJid: msg.to,
-			sender: msg.sender,
-			senderJid: msg.senderJid,
-			senderE164: msg.senderE164,
-			senderName: msg.senderName,
-			pushName: msg.pushName,
-			self: msg.self,
-			selfJid: msg.selfJid,
-			selfLid: msg.selfLid,
-			selfE164: msg.selfE164,
-			fromMe: msg.fromMe,
-			sendComposing: msg.sendComposing,
-			reply: msg.reply,
-			sendMedia: msg.sendMedia
-		},
-		quote: buildQuoteFromFlatAliases(msg),
-		group: buildGroupFromFlatAliases(msg)
-	});
-}
-function normalizeWebInboundMessage(msg) {
-	if (msg.event && msg.payload && msg.platform) return withDeprecatedWebInboundMessageFlatAliases(msg);
-	if (msg.event || msg.payload || msg.platform || msg.quote || msg.group) throw new Error("WhatsApp inbound messages must be either legacy flat or canonical nested; partial nested contexts are not supported.");
-	return normalizeLegacyFlatWebInboundMessage(msg);
-}
-function normalizeAdmittedWebInboundMessage(msg) {
-	return requireAdmittedWhatsAppInboundMessage(normalizeWebInboundMessage(msg));
-}
-//#endregion
 //#region extensions/whatsapp/src/inbound/durable-payload.ts
 var WhatsAppIngressPermanentError = class extends Error {
 	constructor(reason, message, options) {
@@ -817,8 +416,7 @@ function readGroupMetadataCacheEntry(cache, jid) {
 function createWhatsAppGroupMetadataCacheOwner(params) {
 	const reconnectCache = params.reconnectCache ?? /* @__PURE__ */ new Map();
 	const localCache = /* @__PURE__ */ new Map();
-	const publishedJids = /* @__PURE__ */ new Set();
-	const invalidatedJids = /* @__PURE__ */ new Set();
+	const groupMetadataGenerations = /* @__PURE__ */ new Map();
 	const detachListeners = [];
 	let closed = false;
 	let started = false;
@@ -848,46 +446,51 @@ function createWhatsAppGroupMetadataCacheOwner(params) {
 	});
 	const rememberFullUpdate = (jid, meta) => {
 		if (closed) return;
+		groupMetadataGenerations.set(jid, {});
 		rememberWhatsAppBaileysCacheEntry(params.baileysCache, jid, meta, GROUP_META_TTL_MS);
-		publishedJids.add(jid);
-		invalidatedJids.delete(jid);
 		rememberGroupMetadataCacheEntry(reconnectCache, jid, summarizeForReconnect(meta));
 		localCache.delete(jid);
 	};
 	const forgetFullMetadata = (jid) => {
+		groupMetadataGenerations.set(jid, {});
 		params.baileysCache?.delete(jid);
 		reconnectCache.delete(jid);
 		localCache.delete(jid);
-		publishedJids.delete(jid);
-		invalidatedJids.add(jid);
 	};
 	const get = async (jid) => {
-		const cached = readGroupMetadataCacheEntry(localCache, jid);
-		if (cached) return cached;
-		try {
-			const hydratedEntry = params.baileysCache?.get(jid);
-			const providerMetadata = params.baileysCache ? readWhatsAppBaileysCacheEntry(params.baileysCache, jid) : void 0;
-			const hydratedMetadata = providerMetadata?.participants?.length ? providerMetadata : void 0;
-			const meta = hydratedMetadata ?? await (params.getCurrentSock() ?? params.sock).groupMetadata(jid);
-			if (!hydratedMetadata) rememberWhatsAppBaileysCacheEntry(params.baileysCache, jid, meta, GROUP_META_TTL_MS);
-			publishedJids.add(jid);
-			const entry = await summarize(meta);
-			if (hydratedMetadata && hydratedEntry) entry.expires = hydratedEntry.expiresAt;
-			rememberGroupMetadataCacheEntry(reconnectCache, jid, {
-				subject: entry.subject,
-				expires: entry.expires
-			});
-			rememberGroupMetadataCacheEntry(localCache, jid, entry);
-			return entry;
-		} catch (error) {
-			const hydrated = readGroupMetadataCacheEntry(reconnectCache, jid);
-			if (hydrated) {
-				rememberGroupMetadataCacheEntry(localCache, jid, hydrated);
-				params.logVerbose(`Using cached group metadata for ${jid} after fetch failure: ${String(error)}`);
-				return hydrated;
+		for (;;) {
+			if (closed) return { expires: resolveGroupMetadataExpiresAt() ?? 0 };
+			const cached = readGroupMetadataCacheEntry(localCache, jid);
+			if (cached) return cached;
+			const generation = groupMetadataGenerations.get(jid);
+			try {
+				const hydratedEntry = params.baileysCache?.get(jid);
+				const providerMetadata = params.baileysCache ? readWhatsAppBaileysCacheEntry(params.baileysCache, jid) : void 0;
+				const hydratedMetadata = providerMetadata?.participants?.length ? providerMetadata : void 0;
+				const meta = hydratedMetadata ?? await (params.getCurrentSock() ?? params.sock).groupMetadata(jid);
+				if (closed || groupMetadataGenerations.get(jid) !== generation) continue;
+				const entry = await summarize(meta);
+				if (closed || groupMetadataGenerations.get(jid) !== generation) continue;
+				if (hydratedMetadata && hydratedEntry) entry.expires = hydratedEntry.expiresAt;
+				else rememberWhatsAppBaileysCacheEntry(params.baileysCache, jid, meta, GROUP_META_TTL_MS);
+				groupMetadataGenerations.set(jid, {});
+				rememberGroupMetadataCacheEntry(reconnectCache, jid, {
+					subject: entry.subject,
+					expires: entry.expires
+				});
+				rememberGroupMetadataCacheEntry(localCache, jid, entry);
+				return entry;
+			} catch (error) {
+				if (closed || groupMetadataGenerations.get(jid) !== generation) continue;
+				const hydrated = readGroupMetadataCacheEntry(reconnectCache, jid);
+				if (hydrated) {
+					rememberGroupMetadataCacheEntry(localCache, jid, hydrated);
+					params.logVerbose(`Using cached group metadata for ${jid} after fetch failure: ${String(error)}`);
+					return hydrated;
+				}
+				params.logVerbose(`Failed to fetch group metadata for ${jid}: ${String(error)}`);
+				return { expires: resolveGroupMetadataExpiresAt() ?? 0 };
 			}
-			params.logVerbose(`Failed to fetch group metadata for ${jid}: ${String(error)}`);
-			return { expires: resolveGroupMetadataExpiresAt() ?? 0 };
 		}
 	};
 	const resolveOutboundMentions = async (jid, text) => {
@@ -945,10 +548,10 @@ function createWhatsAppGroupMetadataCacheOwner(params) {
 			try {
 				const groups = await params.sock.groupFetchAllParticipating();
 				if (closed) return;
-				for (const [jid, meta] of Object.entries(groups ?? {})) if (meta && !publishedJids.has(jid) && !invalidatedJids.has(jid)) {
+				for (const [jid, meta] of Object.entries(groups ?? {})) if (meta && !groupMetadataGenerations.has(jid)) {
 					rememberGroupMetadataCacheEntry(reconnectCache, jid, summarizeForReconnect(meta));
 					rememberWhatsAppBaileysCacheEntry(params.baileysCache, jid, meta, GROUP_META_TTL_MS);
-					publishedJids.add(jid);
+					groupMetadataGenerations.set(jid, {});
 				}
 				params.logVerbose(`Hydrated ${Object.keys(groups ?? {}).length} participating groups on connect`);
 			} catch (error) {
@@ -1063,7 +666,7 @@ function createWhatsAppInboundMessageDebouncer(options) {
 							...last.group,
 							mentions: combinedMentions
 						} : void 0;
-						const combinedMessage = attachWhatsAppIngressLifecycle(withDeprecatedWebInboundMessageFlatAliases({
+						const combinedMessage = attachWhatsAppIngressLifecycle({
 							...last,
 							turnAdoptionLifecycle: admissionLifecycle,
 							payload: {
@@ -1076,7 +679,7 @@ function createWhatsAppInboundMessageDebouncer(options) {
 								...last.event,
 								isBatched: true
 							}
-						}), admissionLifecycle);
+						}, admissionLifecycle);
 						await options.onMessage(combinedMessage);
 						await settle();
 						await Promise.all(orderedEntries.map((entry) => options.markRead(entry.readReceipt)));
@@ -1145,8 +748,8 @@ function createWhatsAppInboundMessageDebouncer(options) {
 function unwrapMessage(message) {
 	return normalizeMessageContent$1(message);
 }
-async function downloadInboundMedia(msg, sock, maxBytes = 50 * 1024 * 1024) {
-	const message = unwrapMessage(msg.message);
+async function downloadInboundMedia(msg, sock, maxBytes = 50 * 1024 * 1024, normalizedMessage) {
+	const message = normalizedMessage ?? unwrapMessage(msg.message);
 	if (!message) return;
 	const mimetype = resolveInboundMediaMimetype(message);
 	const fileName = message.documentMessage?.fileName ?? void 0;
@@ -1214,17 +817,18 @@ function logMediaMaterializationFailure(params) {
 }
 async function enrichWhatsAppInboundMessage(params) {
 	const { msg, sock } = params;
-	const location = extractLocationData(msg.message ?? void 0);
+	const messageProjection = projectWhatsAppInboundMessage(msg.message ?? void 0);
+	const location = extractLocationData(messageProjection);
 	const locationText = location ? formatLocationText(location) : void 0;
-	const contactContext = extractContactContext(msg.message ?? void 0);
-	const externalAdReplyContext = extractExternalAdReplyContext(msg.message ?? void 0);
-	let mediaKind = extractMediaKind(msg.message ?? void 0);
-	let body = extractText(msg.message ?? void 0);
+	const contactContext = extractContactContext(messageProjection);
+	const externalAdReplyContext = extractExternalAdReplyContext(messageProjection);
+	let mediaKind = extractMediaKind(messageProjection);
+	let body = extractText(messageProjection);
 	if (locationText) body = [body, locationText].filter(Boolean).join("\n").trim();
 	if (!body && !mediaKind) return null;
 	body = body ?? "";
 	const commandBody = body;
-	const replyContext = describeReplyContext(msg.message);
+	const replyContext = describeReplyContext(messageProjection);
 	let mediaPath;
 	let mediaType = mediaKind ? resolveInboundMediaMimetype(msg.message) : void 0;
 	const nativeMedia = mediaKind ? {
@@ -1240,7 +844,7 @@ async function enrichWhatsAppInboundMessage(params) {
 		mediaFileName = inboundMedia.fileName;
 	};
 	try {
-		await saveInboundMedia(await downloadInboundMedia(msg, sock, maxBytes));
+		await saveInboundMedia(await downloadInboundMedia(msg, sock, maxBytes, messageProjection[0]));
 	} catch (error) {
 		logMediaMaterializationFailure({
 			messageId: msg.key?.id,
@@ -1284,7 +888,8 @@ async function enrichWhatsAppInboundMessage(params) {
 		mediaType,
 		mediaFileName,
 		mediaKind,
-		nativeMedia
+		nativeMedia,
+		mentionedJids: extractMentionedJids(messageProjection)
 	};
 }
 //#endregion
@@ -1617,7 +1222,7 @@ function createWhatsAppMessageDeliveryCoordinator(options) {
 			return normalizeWhatsAppSendResult(await sendTrackedMessage(chatJid, await groupMetadata.applyOutboundMentions(chatJid, previewPayload), optionsValue), "media");
 		};
 		const timestamp = inbound.messageTimestampMs;
-		const mentionedJids = extractMentionedJids(msg.message);
+		const mentionedJids = enriched.mentionedJids;
 		const senderName = msg.pushName ?? void 0;
 		inboundLogger.info({
 			from: inbound.from,
@@ -1660,7 +1265,7 @@ function createWhatsAppMessageDeliveryCoordinator(options) {
 				payload: enriched.externalAdReplyContext
 			}] : []
 		];
-		const inboundMessage = withDeprecatedWebInboundMessageFlatAliases({
+		const inboundMessage = {
 			admission: inbound.access.admission,
 			event: {
 				id: inbound.id,
@@ -1709,7 +1314,7 @@ function createWhatsAppMessageDeliveryCoordinator(options) {
 			turnAdoptionLifecycle: durable.turnAdoptionLifecycle,
 			readReceipt: durable.readReceipt,
 			receiveOrder: durable.receiveOrder
-		});
+		};
 		if (inboundMessage.event.id) {
 			const admission = requireWhatsAppInboundAdmission(inboundMessage);
 			cacheInboundMessageMeta(admission.accountId, inboundMessage.platform.chatJid, inboundMessage.event.id, {
@@ -2263,10 +1868,6 @@ async function monitorWebInbox(options) {
 	}
 	return attachWebInboxToSocket({
 		...options,
-		onMessage: async (msg) => {
-			await options.onMessage(normalizeAdmittedWebInboundMessage(msg));
-		},
-		shouldDebounce: options.shouldDebounce ? (msg) => options.shouldDebounce?.(normalizeAdmittedWebInboundMessage(msg)) ?? true : void 0,
 		socketTiming,
 		sock,
 		recentMessageKeys,
@@ -2700,11 +2301,6 @@ async function maybeBroadcastMessage(params) {
 	return true;
 }
 //#endregion
-//#region extensions/whatsapp/src/auto-reply/monitor/audio-transcript.ts
-function formatWhatsAppAudioTranscriptForAgent(transcript) {
-	return `[Audio transcript (machine-generated, untrusted)]: ${JSON.stringify(transcript)}`;
-}
-//#endregion
 //#region extensions/whatsapp/src/auto-reply/monitor/commands.ts
 function stripMentionsForCommand(text, mentionRegexes, selfE164) {
 	let result = text;
@@ -2901,7 +2497,7 @@ async function applyGroupGating(params) {
 				needsMentionText: true
 			};
 		}
-		const pendingHistoryBody = params.mentionText === void 0 ? void 0 : formatWhatsAppAudioTranscriptForAgent(params.mentionText);
+		const pendingHistoryBody = params.mentionText === void 0 ? void 0 : formatAudioTranscriptForAgent(params.mentionText);
 		return skipGroupMessageAndStoreHistory(params, `Group message stored for context (no mention detected) in ${conversationId}: ${mentionMsg.payload.body}`, pendingHistoryBody);
 	}
 	return { shouldProcess: true };
@@ -3162,7 +2758,8 @@ async function deliverWebReplyInActivityScope(params) {
 	const tableMode = params.tableMode ?? "code";
 	const chunkMode = params.chunkMode ?? "length";
 	const normalizedReply = params.normalizedReplyResult ?? normalizeWhatsAppOutboundPayload(replyResult, { normalizeText: normalizeWhatsAppPayloadTextPreservingIndentation });
-	const textChunks = markdownToWhatsAppChunks(normalizedReply.text ?? "", textLimit, tableMode, chunkMode);
+	const text = normalizedReply.text ?? "";
+	const textChunks = resolveTextChunksWithFallback(text, markdownToWhatsAppChunks(text, textLimit, tableMode, chunkMode));
 	const mediaList = normalizedReply.mediaUrls ?? [];
 	const getQuote = () => {
 		if (!replyResult.replyToId) return;
@@ -3923,8 +3520,7 @@ async function finalizeWhatsAppStatusReaction(params) {
 //#endregion
 //#region extensions/whatsapp/src/auto-reply/monitor/message-line.runtime.ts
 function resolveIdentityNamePrefix(cfg, agentId) {
-	const normalizedAgentId = normalizeAgentId(agentId);
-	const identityName = cfg.agents?.list?.find((agent) => normalizeAgentId(agent.id ?? "") === normalizedAgentId)?.identity?.name?.trim();
+	const identityName = resolveAgentConfig(cfg, agentId)?.identity?.name?.trim();
 	return identityName ? `[${identityName}]` : void 0;
 }
 function resolveMessagePrefix(cfg, agentId, opts) {
@@ -4092,7 +3688,7 @@ async function processMessage(params) {
 		...params.msg,
 		payload: {
 			...params.msg.payload,
-			body: formatWhatsAppAudioTranscriptForAgent(audioTranscript)
+			body: formatAudioTranscriptForAgent(audioTranscript)
 		}
 	} : params.msg;
 	const visibleReplyTo = resolveVisibleWhatsAppReplyContext({
@@ -4323,6 +3919,7 @@ async function processMessage(params) {
 						sessionKey: params.route.sessionKey
 					},
 					ctxPayload,
+					dispatchReplyFromConfig: params.dispatchReplyFromConfig,
 					record: {
 						onRecordError: (err) => {
 							params.replyLogger.warn({
@@ -4357,19 +3954,13 @@ async function processMessage(params) {
 }
 //#endregion
 //#region extensions/whatsapp/src/auto-reply/monitor/on-message.ts
-function readDeprecatedAccessControlPassed(msg) {
-	return msg.accessControlPassed;
-}
 function createWebOnMessageHandler(params) {
-	const hasExplicitlyPassedInboundAccess = (msg) => {
-		if (msg.admission.ingress.decisiveGateId === "legacy-flat-compat") return readDeprecatedAccessControlPassed(msg) === true;
-		return msg.admission.ingress.decision === "allow";
-	};
+	const hasExplicitlyPassedInboundAccess = (msg) => msg.admission.ingress.decision === "allow";
 	const withDirectSenderPeer = (msg, peerId) => {
 		if (requireWhatsAppInboundAdmission(msg).conversation.kind === "group" || msg.platform.sender?.e164 || msg.platform.senderE164 || !peerId.startsWith("+")) return msg;
 		const normalized = normalizeE164(peerId);
 		if (!normalized) return msg;
-		return requireAdmittedWhatsAppInboundMessage(withDeprecatedWebInboundMessageFlatAliases({
+		return {
 			...msg,
 			platform: {
 				...msg.platform,
@@ -4379,7 +3970,7 @@ function createWebOnMessageHandler(params) {
 				},
 				senderE164: normalized
 			}
-		}));
+		};
 	};
 	const processForRoute = async (cfg, msg, route, groupHistoryKey, opts) => {
 		const processParams = {
@@ -4396,7 +3987,8 @@ function createWebOnMessageHandler(params) {
 			replyResolver: params.replyResolver,
 			replyLogger: params.replyLogger,
 			backgroundTasks: params.backgroundTasks,
-			buildContext: params.buildContext
+			buildContext: params.buildContext,
+			dispatchReplyFromConfig: params.dispatchReplyFromConfig
 		};
 		if (opts?.groupHistory !== void 0) processParams.groupHistory = opts.groupHistory;
 		if (opts?.suppressGroupHistoryClear !== void 0) processParams.suppressGroupHistoryClear = opts.suppressGroupHistoryClear;
@@ -4745,15 +4337,12 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 				cfg,
 				channel: "whatsapp"
 			});
-			const shouldDebounce = (msg) => {
-				const admitted = normalizeAdmittedWebInboundMessage(msg);
-				return shouldDebounceTextInbound({
-					text: admitted.payload.commandBody ?? admitted.payload.body,
-					cfg,
-					hasMedia: Boolean(admitted.payload.media?.path || admitted.payload.media?.type),
-					allowDebounce: !(admitted.payload.location || admitted.quote?.id || admitted.quote?.body)
-				});
-			};
+			const shouldDebounce = (msg) => shouldDebounceTextInbound({
+				text: msg.payload.commandBody ?? msg.payload.body,
+				cfg,
+				hasMedia: Boolean(msg.payload.media?.path || msg.payload.media?.type),
+				allowDebounce: !(msg.payload.location || msg.quote?.id || msg.quote?.body)
+			});
 			let connection;
 			try {
 				connection = await controller.openConnection({
@@ -4764,6 +4353,7 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 						return meta?.participants?.length ? meta : void 0;
 					},
 					createListener: async ({ sock, connection: connectionLocal }) => {
+						const pluginChannelRuntime = tuning.channelRuntime;
 						const onMessage = createWebOnMessageHandler({
 							cfg,
 							loadConfig: loadCurrentMonitorConfig,
@@ -4778,7 +4368,8 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 							replyLogger,
 							baseMentionConfig,
 							account,
-							buildContext: tuning.channelRuntime?.inbound.buildContext
+							buildContext: pluginChannelRuntime?.inbound.buildContext,
+							dispatchReplyFromConfig: pluginChannelRuntime?.reply?.dispatchReplyFromConfig
 						});
 						return await (listenerFactory ?? attachWebInboxToSocket)({
 							cfg,
@@ -4805,11 +4396,10 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 							recentMessageKeys,
 							baileysGroupMetaCache,
 							onMessage: async (msg) => {
-								const admitted = normalizeAdmittedWebInboundMessage(msg);
 								const inboundAt = Date.now();
 								controller.noteInbound(inboundAt);
 								statusController.noteInbound(inboundAt);
-								await onMessage(admitted);
+								await onMessage(msg);
 							},
 							onPendingWorkChanged: (pendingWorkCount, at) => {
 								statusController.noteBusy(pendingWorkCount > 0, at);