@openclaw/whatsapp 2026.7.2-beta.3 → 2026.7.2-beta.5

package/dist/{monitor-_jqDKBXj.js → monitor-B7phZF9w.js}

@@ -1,42 +1,40 @@
-import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-ejK8sXPU.js";
-import { a as normalizeWhatsAppOutboundPayload, c as prepareWhatsAppOutboundMedia, r as sendReactionWhatsApp, s as normalizeWhatsAppPayloadTextPreservingIndentation, u as resolveWhatsAppReactionLevel } from "./send-SB-4JrVZ.js";
-import { n as getWhatsAppRuntime } from "./runtime-BfAdAEYT.js";
-import { r as getWhatsAppConnectionController } from "./connection-controller-runtime-context-9mEeAvu1.js";
-import { a as resolveEquivalentWhatsAppDirectChatJids, c as toWhatsappJidWithLid, i as markdownToWhatsApp, n as isSelfChatMode, o as resolveJidToE164, r as jidToE164, s as toWhatsappJid } from "./targets-runtime-Bsh0HR9y.js";
-import { n as normalizeE164, t as convertMarkdownTables$1 } from "./text-runtime-BTGkMN0o.js";
-import { a as cacheInboundMessageMeta, i as buildQuotedMessageOptions, n as resolveWhatsAppGroupSessionRoute, o as lookupInboundMessageMeta, r as resolveWhatsAppLegacyGroupSessionKey } from "./group-session-key-Dh8WZun_.js";
-import { g as readWebSelfId, o as getWebAuthAgeMs, r as WhatsAppAuthUnstableError, v as readWebSelfIdentityForDecision } from "./auth-store-BQi9pZqQ.js";
-import { a as getSelfIdentity, c as resolveComparableIdentity, i as getReplyContext, n as getMentionIdentities, o as getSenderIdentity, r as getPrimaryIdentityId, s as identitiesOverlap, t as getComparableIdentityValues } from "./identity-D7L8LCuH.js";
+import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-CSqLvCY5.js";
+import { a as normalizeWhatsAppOutboundPayload, c as prepareWhatsAppOutboundMedia, r as sendReactionWhatsApp, s as normalizeWhatsAppPayloadTextPreservingIndentation, u as resolveWhatsAppReactionLevel } from "./send-BTXJAyK4.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-DVMZlO3x.js";
+import { g as readWebSelfId, o as getWebAuthAgeMs, r as WhatsAppAuthUnstableError, v as readWebSelfIdentityForDecision } from "./auth-store-DcEpIOmE.js";
+import { a as getSelfIdentity, c as resolveComparableIdentity, i as getReplyContext, n as getMentionIdentities, o as getSenderIdentity, r as getPrimaryIdentityId, s as identitiesOverlap, t as getComparableIdentityValues } from "./identity-CPrT5aEU.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-jNGyZY4T.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-DridEuzz.js";
 import { n as getStatusCode, t as formatError } from "./session-errors-JuazczrA.js";
 import { t as BufferJSON } from "./session.runtime-Nsqaehbd.js";
-import { c as requireWhatsAppInboundAdmission, i as resolveWhatsAppInboundPolicy, l as resolveWhatsAppGroupConversationId, o as buildDeprecatedFlatWhatsAppInboundAdmission, r as resolveWhatsAppCommandAuthorized, s as requireAdmittedWhatsAppInboundMessage, t as checkInboundAccessControl } from "./access-control-tjy_em01.js";
-import { _ as extractLocationData, a as mayContainWhatsAppOutboundMention, b as extractText, c as DisconnectReason, d as normalizeMessageContent, f as resolveInboundMediaMimetype, g as extractExternalAdReplyContext, h as extractContextInfo, i as addWhatsAppOutboundMentionsToContent, l as downloadMediaMessage, m as extractContactContext, n as listWhatsAppSendResultMessageIds, o as resolveWhatsAppOutboundMentions, p as describeReplyContext, r as normalizeWhatsAppSendResult, s as addWhatsAppImagePreviewFields, t as createWebSendApi, u as isJidGroup, v as extractMediaPlaceholder, x as hasInboundUserContent, y as extractMentionedJids } from "./send-api-BG0MgoFI.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-HGaffeFb.js";
-import { n as maybeResolveWhatsAppApprovalReaction } from "./approval-reactions-CrZFAyf-.js";
-import { t as maybeResolveWhatsAppQuestionReaction } from "./question-reactions-C0qJ6wGA.js";
-import { resolveAccountEntry } from "openclaw/plugin-sdk/account-core";
+import { c as requireWhatsAppInboundAdmission, i as resolveWhatsAppInboundPolicy, l as resolveWhatsAppGroupConversationId, o as buildDeprecatedFlatWhatsAppInboundAdmission, r as resolveWhatsAppCommandAuthorized, s as requireAdmittedWhatsAppInboundMessage, t as checkInboundAccessControl } from "./access-control-pZcxTmd5.js";
+import { _ as extractMediaKind, a as mayContainWhatsAppOutboundMention, b as hasInboundUserContent, c as DisconnectReason, d as normalizeMessageContent, f as describeReplyContext, g as extractLocationData, h as extractExternalAdReplyContext, i as addWhatsAppOutboundMentionsToContent, l as downloadMediaMessage, m as extractContextInfo, n as listWhatsAppSendResultMessageIds, o as resolveWhatsAppOutboundMentions, p as extractContactContext, r as normalizeWhatsAppSendResult, s as addWhatsAppImagePreviewFields, t as createWebSendApi, u as isJidGroup, v as extractMentionedJids, x as resolveInboundMediaMimetype, y as extractText } from "./send-api-BY_AkSiB.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-BOB2MVKY.js";
+import { n as maybeResolveWhatsAppApprovalReaction } from "./approval-reactions-Cu66aYdq.js";
+import { t as maybeResolveWhatsAppQuestionReaction } from "./question-reactions-CRsnyoMK.js";
 import { normalizeLowercaseStringOrEmpty, normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { filterSupplementalContextItems, resolvePinnedMainDmOwnerFromAllowlist } from "openclaw/plugin-sdk/security-runtime";
-import { DEFAULT_TIMING, createAckReactionHandle, createStatusReactionController, logAckFailure, removeAckReactionHandleAfterReply, shouldAckReactionForWhatsApp } from "openclaw/plugin-sdk/channel-feedback";
+import { createAckReactionHandle, createStatusReactionController, logAckFailure, removeAckReactionHandleAfterReply, shouldAckReactionForWhatsApp } from "openclaw/plugin-sdk/channel-feedback";
 import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
 import { getChildLogger } from "openclaw/plugin-sdk/logging-core";
 import { resolveMarkdownTableMode as resolveMarkdownTableMode$1 } from "openclaw/plugin-sdk/markdown-table-runtime";
 import { createSubsystemLogger, defaultRuntime, formatDurationPrecise, getChildLogger as getChildLogger$1, logVerbose, logVerbose as logVerbose$1, registerUnhandledRejectionHandler, shouldLogVerbose, shouldLogVerbose as shouldLogVerbose$1, warn } from "openclaw/plugin-sdk/runtime-env";
 import { registerChannelRuntimeContext } from "openclaw/plugin-sdk/channel-runtime-context";
-import { DEFAULT_INGRESS_RETRY_DEAD_LETTER_MIN_AGE_MS, DEFAULT_INGRESS_RETRY_MAX_ATTEMPTS, bindIngressLifecycleToReplyOptions, createChannelIngressDrain, createChannelMessageReplyPipeline, createMessageReceiptFromOutboundResults, deliverInboundReplyWithMessageSendContext, resolveChannelMessageSourceReplyDeliveryMode, resolveChannelStreamingBlockEnabled } from "openclaw/plugin-sdk/channel-outbound";
+import { bindIngressLifecycleToReplyOptions, createChannelIngressMonitor, createChannelMessageReplyPipeline, createMessageReceiptFromOutboundResults, 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 { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
-import { LocalMediaAccessError, getDefaultLocalRoots, loadWebMedia as loadWebMedia$1, loadWebMediaRaw, optimizeImageToJpeg, optimizeImageToPng } from "openclaw/plugin-sdk/web-media";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
-import { chunkMarkdownTextWithMode } from "openclaw/plugin-sdk/reply-chunking";
-import { DEFAULT_ACCOUNT_ID as DEFAULT_ACCOUNT_ID$1, DEFAULT_MAIN_KEY, buildAgentMainSessionKey, buildAgentSessionKey, buildGroupHistoryKey, deriveLastRoutePolicy, normalizeAccountId as normalizeAccountId$1, normalizeAgentId, resolveAgentRoute, resolveInboundLastRouteSessionKey } from "openclaw/plugin-sdk/routing";
+import { buildChannelInboundEventContext, filterChannelInboundQuoteContext, formatInboundEnvelope, formatInboundEnvelope as formatInboundEnvelope$1, formatInboundMediaUnavailableText, formatLocationText, formatMediaPlaceholderText, hasVisibleInboundReplyDispatch, isChannelPartialDeliveryError, resolveInboundSessionEnvelopeContext, resolveInboundSupplementalSenderAllowed, runChannelInboundEvent, shouldDebounceTextInbound, toInboundMediaFacts, toLocationContext } from "openclaw/plugin-sdk/channel-inbound";
+import { DEFAULT_ACCOUNT_ID, DEFAULT_MAIN_KEY, buildAgentMainSessionKey, buildAgentSessionKey, buildGroupHistoryKey, deriveLastRoutePolicy, normalizeAccountId, normalizeAgentId, resolveAgentRoute, resolveInboundLastRouteSessionKey } from "openclaw/plugin-sdk/routing";
 import { asDateTimestampMs, parseStrictFiniteNumber, resolveExpiresAtMsFromDurationMs } from "openclaw/plugin-sdk/number-runtime";
 import { createHash } from "node:crypto";
+import { fanInChannelIngressLifecycles } from "openclaw/plugin-sdk/channel-ingress-runtime";
 import { getSessionEntry, patchSessionEntry, resolveStorePath, resolveStorePath as resolveStorePath$1, updateLastRoute } from "openclaw/plugin-sdk/session-store-runtime";
-import { buildChannelInboundEventContext, filterChannelInboundQuoteContext, formatInboundEnvelope, formatInboundEnvelope as formatInboundEnvelope$1, formatInboundMediaUnavailableText, formatLocationText, hasVisibleInboundReplyDispatch, resolveInboundSessionEnvelopeContext, resolveInboundSupplementalSenderAllowed, runChannelInboundEvent, shouldDebounceTextInbound, toInboundMediaFacts, toLocationContext } from "openclaw/plugin-sdk/channel-inbound";
 import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
 import { resolveChunkMode, resolveTextChunkLimit } from "openclaw/plugin-sdk/reply-runtime";
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-runtime";
@@ -46,7 +44,7 @@ import { DEFAULT_GROUP_HISTORY_LIMIT, buildHistoryContextFromEntries, buildInbou
 import { enqueueSystemEvent } from "openclaw/plugin-sdk/system-event-runtime";
 import { createDedupeCache } from "openclaw/plugin-sdk/dedupe-runtime";
 import { saveMediaStream } from "openclaw/plugin-sdk/media-store";
-import { getRuntimeConfig as getRuntimeConfig$1, getRuntimeConfigSourceSnapshot } from "openclaw/plugin-sdk/runtime-config-snapshot";
+import { getRuntimeConfig as getRuntimeConfig$1 } from "openclaw/plugin-sdk/runtime-config-snapshot";
 import { resolveChannelContextVisibilityMode } from "openclaw/plugin-sdk/context-visibility-runtime";
 import { buildMentionRegexes, implicitMentionKindWhen, normalizeMentionText, resolveInboundMentionDecision } from "openclaw/plugin-sdk/channel-mention-gating";
 import { createConnectedChannelStatusPatch, createTransportActivityStatusPatch } from "openclaw/plugin-sdk/gateway-runtime";
@@ -57,6 +55,7 @@ import { hasControlCommand, isControlCommandMessage, shouldComputeCommandAuthori
 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";
 //#region extensions/whatsapp/src/inbound/message-aliases.ts
 function normalizeQuoteSender(sender) {
@@ -128,6 +127,18 @@ 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;
@@ -179,6 +190,7 @@ function defineDeprecatedAdmissionTopLevelAccessors(msg) {
 	});
 }
 function withDeprecatedWebInboundMessageFlatAliases(msg) {
+	defineDeprecatedStructuredContextPayloadAlias(msg);
 	return defineDeprecatedAliasAccessors(defineDeprecatedAdmissionTopLevelAccessors(msg), {
 		id: {
 			get: () => msg.event.id,
@@ -324,9 +336,13 @@ function withDeprecatedWebInboundMessageFlatAliases(msg) {
 			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.untrustedStructuredContext,
-			set: (value) => msg.payload.untrustedStructuredContext = value
+			get: () => msg.payload.channelStructuredContext,
+			set: (value) => msg.payload.channelStructuredContext = value
 		},
 		isBatched: {
 			get: () => msg.event.isBatched,
@@ -353,7 +369,7 @@ function normalizeLegacyFlatWebInboundMessage(msg) {
 			body: msg.body,
 			media,
 			location: msg.location,
-			untrustedStructuredContext: msg.untrustedStructuredContext
+			channelStructuredContext: msg.channelStructuredContext ?? msg.untrustedStructuredContext
 		},
 		platform: {
 			chatJid: msg.chatId,
@@ -441,6 +457,8 @@ const WHATSAPP_DURABLE_INBOUND_PENDING_MAX_ENTRIES = 450;
 const WHATSAPP_DURABLE_INBOUND_COMPLETED_MAX_ENTRIES = 5e3;
 const WHATSAPP_DURABLE_INBOUND_PENDING_TTL_MS = 720 * 60 * 60 * 1e3;
 const WHATSAPP_DURABLE_INBOUND_COMPLETED_TTL_MS = 10080 * 60 * 1e3;
+const WHATSAPP_DURABLE_INBOUND_PRUNE_INTERVAL_MS = 3600 * 1e3;
+const WHATSAPP_DURABLE_INBOUND_PAYLOAD_VERSION = 1;
 function hashNamespacePart(value) {
 	return createHash("sha256").update(value).digest("hex").slice(0, 24);
 }
@@ -466,59 +484,62 @@ function createWhatsAppDurableInboundQueue(accountId) {
 		stateDir: getWhatsAppRuntime().state.resolveStateDir()
 	});
 }
-/** Raw receive chokepoint: append first, then let the drain normalize and dispatch. */
-async function enqueueWhatsAppDurableInbound(params) {
-	const facts = inspectWhatsAppIngressMessage(params.message);
-	const receivedAt = params.receivedAt ?? Date.now();
-	await params.queue.prune({
-		pendingTtlMs: WHATSAPP_DURABLE_INBOUND_PENDING_TTL_MS,
-		completedTtlMs: WHATSAPP_DURABLE_INBOUND_COMPLETED_TTL_MS,
-		failedTtlMs: WHATSAPP_DURABLE_INBOUND_PENDING_TTL_MS,
-		pendingMaxEntries: WHATSAPP_DURABLE_INBOUND_PENDING_MAX_ENTRIES,
-		completedMaxEntries: WHATSAPP_DURABLE_INBOUND_COMPLETED_MAX_ENTRIES,
-		failedMaxEntries: WHATSAPP_DURABLE_INBOUND_PENDING_MAX_ENTRIES
-	});
-	return await params.queue.enqueue(facts.eventId, {
-		message: serializeWhatsAppDurableInboundMessage(params.message),
-		upsertType: params.upsertType,
-		...params.skipStaleAppend === void 0 ? {} : { skipStaleAppend: params.skipStaleAppend },
-		...params.skipRecentOutboundEcho === void 0 ? {} : { skipRecentOutboundEcho: params.skipRecentOutboundEcho },
-		receivedAt,
-		...params.receiveOrder === void 0 ? {} : { receiveOrder: params.receiveOrder }
-	}, {
-		receivedAt,
-		laneKey: facts.laneKey
-	});
-}
 function resolveWhatsAppIngressNonRetryableFailure(error) {
 	return error instanceof WhatsAppIngressPermanentError ? {
 		reason: error.reason,
 		message: error.message
 	} : null;
 }
-/** Core drain with per-conversation lanes and completion at reply-lane adoption. */
-function createWhatsAppIngressDrain(params) {
-	return createChannelIngressDrain({
+/** Shared monitor with per-conversation lanes and completion at reply-lane adoption. */
+function createWhatsAppIngressMonitor(params) {
+	return createChannelIngressMonitor({
 		queue: params.queue,
-		retryPolicy: {
-			maxAttempts: DEFAULT_INGRESS_RETRY_MAX_ATTEMPTS,
-			deadLetterMinAgeMs: DEFAULT_INGRESS_RETRY_DEAD_LETTER_MIN_AGE_MS
+		inspect: (admission) => inspectWhatsAppIngressMessage(admission.message),
+		payload: {
+			version: WHATSAPP_DURABLE_INBOUND_PAYLOAD_VERSION,
+			serialize: (admission, { receivedAt }) => ({
+				...admission,
+				message: serializeWhatsAppDurableInboundMessage(admission.message),
+				receivedAt
+			}),
+			deserialize: (payload) => ({
+				...payload,
+				message: deserializeWhatsAppDurableInboundMessage(payload.message)
+			}),
+			encode: ({ body }) => body,
+			decode: (payload) => ({
+				version: WHATSAPP_DURABLE_INBOUND_PAYLOAD_VERSION,
+				body: payload
+			}),
+			createClaimError: (kind) => new WhatsAppIngressPermanentError(kind === "invalid-version" ? "invalid-payload" : "event-id-mismatch", kind === "invalid-version" ? "WhatsApp ingress row has an invalid payload version" : "WhatsApp ingress row identity does not match its transport message key")
 		},
-		resolveNonRetryableFailure: resolveWhatsAppIngressNonRetryableFailure,
-		deriveLaneKey: (record) => {
-			try {
-				return inspectWhatsAppIngressMessage(deserializeWhatsAppDurableInboundMessage(record.payload.message)).laneKey;
-			} catch {
-				return record.id;
-			}
+		deliver: (admission, lifecycle) => params.dispatch(admission, lifecycle),
+		pollIntervalMs: params.pollIntervalMs,
+		retention: {
+			pruneIntervalMs: WHATSAPP_DURABLE_INBOUND_PRUNE_INTERVAL_MS,
+			pendingTtlMs: WHATSAPP_DURABLE_INBOUND_PENDING_TTL_MS,
+			pendingMaxEntries: WHATSAPP_DURABLE_INBOUND_PENDING_MAX_ENTRIES,
+			completedTtlMs: WHATSAPP_DURABLE_INBOUND_COMPLETED_TTL_MS,
+			completedMaxEntries: WHATSAPP_DURABLE_INBOUND_COMPLETED_MAX_ENTRIES,
+			failedTtlMs: WHATSAPP_DURABLE_INBOUND_PENDING_TTL_MS,
+			failedMaxEntries: WHATSAPP_DURABLE_INBOUND_PENDING_MAX_ENTRIES
+		},
+		drain: {
+			resolveNonRetryableFailure: resolveWhatsAppIngressNonRetryableFailure,
+			deriveLaneKey: (record) => {
+				try {
+					return inspectWhatsAppIngressMessage(deserializeWhatsAppDurableInboundMessage(record.payload.message)).laneKey;
+				} catch {
+					return record.id;
+				}
+			},
+			...params.onLog ? { onLog: params.onLog } : {}
 		},
-		...params.onLog ? { onLog: params.onLog } : {},
 		...params.abortSignal ? { abortSignal: params.abortSignal } : {},
-		dispatchClaimedEvent: async (record, lifecycle) => {
-			const message = deserializeWhatsAppDurableInboundMessage(record.payload.message);
-			if (inspectWhatsAppIngressMessage(message).eventId !== record.id) throw new WhatsAppIngressPermanentError("event-id-mismatch", "WhatsApp ingress row id does not match its transport message key");
-			return await params.dispatch(message, record.payload, lifecycle);
-		}
+		admissionMode: "while-running",
+		createStoppedError: () => /* @__PURE__ */ new Error("WhatsApp ingress monitor is stopped."),
+		...params.onError ? { onError: params.onError } : {},
+		...params.onActivityChange ? { onActivityChange: params.onActivityChange } : {}
 	});
 }
 //#endregion
@@ -738,6 +759,7 @@ async function attachWebInboxToSocket(options) {
 	const pendingDebounceKeys = /* @__PURE__ */ new Set();
 	const activeInboundFlushes = /* @__PURE__ */ new Set();
 	const pendingMessageHandlers = /* @__PURE__ */ new Set();
+	let durableIngressActive = false;
 	const debounceWorkWaiters = /* @__PURE__ */ new Set();
 	const notifyDebounceWork = () => {
 		if (debounceWorkWaiters.size === 0) return;
@@ -759,7 +781,7 @@ async function attachWebInboxToSocket(options) {
 	};
 	let nextReceiveOrder = 0;
 	const publishPendingWorkState = (at = Date.now()) => {
-		options.onPendingWorkChanged?.(pendingMessageHandlers.size + pendingDebounceKeys.size + activeInboundFlushes.size, at);
+		options.onPendingWorkChanged?.(pendingMessageHandlers.size + pendingDebounceKeys.size + activeInboundFlushes.size + (durableIngressActive ? 1 : 0), at);
 	};
 	const buildInboundDebounceKey = (msg) => {
 		const admission = requireWhatsAppInboundAdmission(msg);
@@ -774,48 +796,6 @@ async function attachWebInboxToSocket(options) {
 		if (timestampDiff !== 0) return timestampDiff;
 		return (a.receiveOrder ?? 0) - (b.receiveOrder ?? 0);
 	});
-	const buildFlushIngressLifecycle = (entries) => {
-		const lifecycles = entries.map((entry) => entry.turnAdoptionLifecycle).filter((lifecycle) => lifecycle !== void 0);
-		const [firstLifecycle] = lifecycles;
-		if (!firstLifecycle) return {
-			lifecycle: void 0,
-			settle: async () => {},
-			abandon: async () => {}
-		};
-		let handedOff = false;
-		const adoptAll = async () => {
-			for (const lifecycle of lifecycles) await lifecycle.onAdopted();
-		};
-		return {
-			lifecycle: {
-				abortSignal: lifecycles.length === 1 ? firstLifecycle.abortSignal : AbortSignal.any(lifecycles.map((lifecycle) => lifecycle.abortSignal)),
-				onAdopted: async () => {
-					handedOff = true;
-					await adoptAll();
-				},
-				onDeferred: () => {
-					handedOff = true;
-					for (const lifecycle of lifecycles) lifecycle.onDeferred();
-				},
-				onAdoptionFinalizing: () => {
-					for (const lifecycle of lifecycles) lifecycle.onAdoptionFinalizing();
-				},
-				onAbandoned: async () => {
-					handedOff = true;
-					await Promise.all(lifecycles.map((lifecycle) => Promise.resolve(lifecycle.onAbandoned())));
-				}
-			},
-			settle: async () => {
-				if (!handedOff) await adoptAll();
-			},
-			abandon: async () => {
-				if (!handedOff) {
-					handedOff = true;
-					await Promise.all(lifecycles.map((lifecycle) => Promise.resolve(lifecycle.onAbandoned())));
-				}
-			}
-		};
-	};
 	const debouncer = createInboundDebouncer({
 		debounceMs: inboundDebounceMs,
 		buildKey: (msg) => msg.debounceKey ?? buildInboundDebounceKey(msg),
@@ -832,7 +812,7 @@ async function attachWebInboxToSocket(options) {
 				const orderedEntries = orderDebouncedInboundEntries(entries);
 				const last = orderedEntries.at(-1);
 				if (!last) return;
-				const { lifecycle, settle, abandon } = buildFlushIngressLifecycle(orderedEntries);
+				const { lifecycle, settle, abandon } = fanInChannelIngressLifecycles(orderedEntries.map((entry) => entry.turnAdoptionLifecycle));
 				try {
 					if (orderedEntries.length === 1) {
 						await options.onMessage(attachWhatsAppIngressLifecycle(last, lifecycle));
@@ -1192,17 +1172,19 @@ async function attachWebInboxToSocket(options) {
 		const locationText = location ? formatLocationText(location) : void 0;
 		const contactContext = extractContactContext(msg.message ?? void 0);
 		const externalAdReplyContext = extractExternalAdReplyContext(msg.message ?? void 0);
-		const mediaPlaceholder = extractMediaPlaceholder(msg.message ?? void 0);
+		let mediaKind = extractMediaKind(msg.message ?? void 0);
 		let body = extractText(msg.message ?? void 0);
 		if (locationText) body = [body, locationText].filter(Boolean).join("\n").trim();
-		if (!body) {
-			body = mediaPlaceholder;
-			if (!body) return null;
-		}
+		if (!body && !mediaKind) return null;
+		body = body ?? "";
 		const commandBody = body;
 		const replyContext = describeReplyContext(msg.message);
 		let mediaPath;
-		let mediaType;
+		let mediaType = mediaKind ? resolveInboundMediaMimetype(msg.message) : void 0;
+		const nativeMedia = mediaKind ? {
+			contentType: mediaType,
+			kind: mediaKind
+		} : void 0;
 		let mediaFileName;
 		const maxBytes = (typeof options.mediaMaxMb === "number" && options.mediaMaxMb > 0 ? options.mediaMaxMb : 50) * 1024 * 1024;
 		const saveInboundMedia = async (inboundMedia) => {
@@ -1217,12 +1199,13 @@ async function attachWebInboxToSocket(options) {
 			logWhatsAppVerbose(options.verbose, `Inbound media download failed: ${String(err)}`);
 			body = formatInboundMediaUnavailableText({
 				body,
-				mediaPlaceholder,
 				notice: "[whatsapp attachment unavailable]"
 			});
 		}
-		if (!mediaPath && replyContext) try {
+		if (!mediaPath && !mediaKind && replyContext?.media) try {
 			await saveInboundMedia(await downloadQuotedInboundMedia(msg, sock, maxBytes));
+			mediaKind = replyContext.media.kind ?? void 0;
+			mediaType = mediaType ?? replyContext.media.contentType ?? void 0;
 		} catch (err) {
 			logWhatsAppVerbose(options.verbose, `Quoted media download failed: ${String(err)}`);
 			body = formatInboundMediaUnavailableText({
@@ -1239,7 +1222,9 @@ async function attachWebInboxToSocket(options) {
 			replyContext,
 			mediaPath,
 			mediaType,
-			mediaFileName
+			mediaFileName,
+			mediaKind,
+			nativeMedia
 		};
 	};
 	const enqueueInboundMessage = async (msg, inbound, enriched, durable) => {
@@ -1274,10 +1259,11 @@ async function attachWebInboxToSocket(options) {
 			mediaFileName: enriched.mediaFileName,
 			timestamp
 		}, "inbound message");
-		const media = enriched.mediaPath || enriched.mediaType || enriched.mediaFileName ? {
+		const media = enriched.mediaPath || enriched.mediaType || enriched.mediaFileName || enriched.mediaKind ? {
 			path: enriched.mediaPath,
 			type: enriched.mediaType,
-			fileName: enriched.mediaFileName
+			fileName: enriched.mediaFileName,
+			kind: enriched.mediaKind
 		} : void 0;
 		const groupMentions = mentionedJids ? { jids: mentionedJids } : void 0;
 		const group = inbound.group && (inbound.groupSubject || inbound.groupParticipants?.length || groupMentions) ? {
@@ -1285,17 +1271,26 @@ async function attachWebInboxToSocket(options) {
 			participants: inbound.groupParticipants,
 			mentions: groupMentions
 		} : void 0;
-		const untrustedStructuredContext = [...enriched.contactContext ? [{
-			label: "WhatsApp contact",
-			source: "whatsapp",
-			type: enriched.contactContext.kind,
-			payload: enriched.contactContext
-		}] : [], ...enriched.externalAdReplyContext ? [{
-			label: "WhatsApp external ad reply",
-			source: "whatsapp",
-			type: "external_ad_reply",
-			payload: enriched.externalAdReplyContext
-		}] : []];
+		const channelStructuredContext = [
+			...enriched.nativeMedia ? [{
+				label: "WhatsApp media",
+				source: "whatsapp",
+				type: "media",
+				payload: enriched.nativeMedia
+			}] : [],
+			...enriched.contactContext ? [{
+				label: "WhatsApp contact",
+				source: "whatsapp",
+				type: enriched.contactContext.kind,
+				payload: enriched.contactContext
+			}] : [],
+			...enriched.externalAdReplyContext ? [{
+				label: "WhatsApp external ad reply",
+				source: "whatsapp",
+				type: "external_ad_reply",
+				payload: enriched.externalAdReplyContext
+			}] : []
+		];
 		const inboundMessage = withDeprecatedWebInboundMessageFlatAliases({
 			admission: inbound.access.admission,
 			event: {
@@ -1306,7 +1301,7 @@ async function attachWebInboxToSocket(options) {
 				body: enriched.body,
 				commandBody: enriched.commandBody,
 				location: enriched.location ?? void 0,
-				untrustedStructuredContext: untrustedStructuredContext.length > 0 ? untrustedStructuredContext : void 0,
+				channelStructuredContext: channelStructuredContext.length > 0 ? channelStructuredContext : void 0,
 				media
 			},
 			platform: {
@@ -1334,6 +1329,7 @@ async function attachWebInboxToSocket(options) {
 				context: enriched.replyContext,
 				id: enriched.replyContext.id,
 				body: enriched.replyContext.body,
+				media: enriched.replyContext.media,
 				sender: {
 					displayName: enriched.replyContext.sender?.label ?? void 0,
 					jid: enriched.replyContext.sender?.jid ?? void 0,
@@ -1360,16 +1356,21 @@ async function attachWebInboxToSocket(options) {
 				participant: inboundMessage.platform.senderJid,
 				participantE164: admission.conversation.kind === "direct" ? inboundMessage.platform.senderE164 : void 0,
 				body: inboundMessage.payload.body,
+				media: enriched.nativeMedia,
 				fromMe: inboundMessage.platform.fromMe
 			});
 		}
 		await debouncer.enqueue(inboundMessage);
 	};
-	const processWhatsAppInboundMessage = async (msg, context) => {
+	const processDurableInboundMessage = async (admission, lifecycle) => {
+		const { message: msg, ...context } = admission;
 		rememberBaileysMessage(msg.key?.remoteJid, msg.key?.id, msg.message);
+		const remoteJid = msg.key?.remoteJid;
+		const id = msg.key?.id;
+		const durableId = remoteJid && id ? createHash("sha256").update(`${remoteJid}\n${id}`).digest("hex") : void 0;
+		const preparation = durableId ? preparedInboundByDurableId.get(durableId) : void 0;
+		if (durableId) preparedInboundByDurableId.delete(durableId);
 		if (context.skipRecentOutboundEcho === true) return "completed";
-		const preparation = context.eventId ? preparedInboundByDurableId.get(context.eventId) : void 0;
-		if (context.eventId) preparedInboundByDurableId.delete(context.eventId);
 		const prepared = await preparation;
 		if (prepared === null) return "completed";
 		const inbound = prepared ?? await normalizeInboundMessage(msg);
@@ -1397,85 +1398,21 @@ async function attachWebInboxToSocket(options) {
 		await enqueueInboundMessage(msg, inbound, enriched, {
 			readReceipt: deliveryReadReceipt,
 			receiveOrder: context.receiveOrder ?? context.receivedAt,
-			turnAdoptionLifecycle: context.lifecycle
+			turnAdoptionLifecycle: lifecycle
 		});
 		return "deferred";
 	};
-	let durableDrainPass;
-	let durableDrainRequested = false;
-	let durableDrainClosed = false;
-	const requestDurableInboundDrain = () => {
-		if (durableDrainClosed) return Promise.resolve();
-		durableDrainRequested = true;
-		if (!durableDrainPass) {
-			let passFailed = false;
-			const task = (async () => {
-				await durableInboundDrain.recoverStaleClaims();
-				while (durableDrainRequested) {
-					durableDrainRequested = false;
-					if ((await durableInboundDrain.drainOnce()).started > 0) {
-						await durableInboundDrain.waitForIdle();
-						durableDrainRequested = true;
-					}
-				}
-			})().catch((error) => {
-				passFailed = true;
-				throw error;
-			});
-			durableDrainPass = task;
-			pendingMessageHandlers.add(task);
+	const durableInboundMonitor = createWhatsAppIngressMonitor({
+		queue: durableInboundQueue,
+		dispatch: async (admission, lifecycle) => ({ kind: await processDurableInboundMessage(admission, lifecycle) }),
+		pollIntervalMs: WHATSAPP_INGRESS_DRAIN_INTERVAL_MS,
+		onLog: (message) => inboundLogger.warn({ message }, "whatsapp ingress drain"),
+		onError: (error) => inboundLogger.error({ error: formatError(error) }, "whatsapp durable inbound drain failed"),
+		onActivityChange: (active) => {
+			durableIngressActive = active;
 			publishPendingWorkState();
-			task.finally(() => {
-				if (durableDrainPass === task) durableDrainPass = void 0;
-				pendingMessageHandlers.delete(task);
-				publishPendingWorkState();
-				if (durableDrainRequested && !passFailed) requestDurableInboundDrain().catch((error) => {
-					inboundLogger.error({ error: formatError(error) }, "whatsapp durable inbound drain failed");
-				});
-			}).catch(() => void 0);
-		}
-		return durableDrainPass;
-	};
-	const requestDrainAfterLaneSettlement = () => {
-		requestDurableInboundDrain().catch((error) => {
-			inboundLogger.error({ error: formatError(error) }, "whatsapp durable inbound drain failed");
-		});
-	};
-	const continueDrainAfterLaneSettlement = (lifecycle) => ({
-		abortSignal: lifecycle.abortSignal,
-		onAdopted: async () => {
-			await lifecycle.onAdopted();
-			requestDrainAfterLaneSettlement();
-		},
-		onDeferred: lifecycle.onDeferred,
-		onAdoptionFinalizing: lifecycle.onAdoptionFinalizing,
-		onAbandoned: async () => {
-			await lifecycle.onAbandoned();
-			requestDrainAfterLaneSettlement();
 		}
 	});
-	const durableInboundDrain = createWhatsAppIngressDrain({
-		queue: durableInboundQueue,
-		dispatch: async (msg, payload, lifecycle) => {
-			const remoteJid = msg.key?.remoteJid;
-			const id = msg.key?.id;
-			return { kind: await processWhatsAppInboundMessage(msg, {
-				...payload,
-				...remoteJid && id ? { eventId: createWhatsAppDurableInboundMessageId({
-					remoteJid,
-					id
-				}) } : {},
-				lifecycle: continueDrainAfterLaneSettlement(lifecycle)
-			}) };
-		},
-		onLog: (message) => inboundLogger.warn({ message }, "whatsapp ingress drain")
-	});
-	const durableDrainTimer = setInterval(() => {
-		requestDurableInboundDrain().catch((error) => {
-			inboundLogger.error({ error: formatError(error) }, "whatsapp durable inbound drain failed");
-		});
-	}, WHATSAPP_INGRESS_DRAIN_INTERVAL_MS);
-	durableDrainTimer.unref?.();
 	const handleMessagesUpsert = async (upsert) => {
 		if (upsert.type !== "notify" && upsert.type !== "append") return;
 		for (const msg of upsert.messages ?? []) {
@@ -1496,10 +1433,7 @@ async function attachWebInboxToSocket(options) {
 			const skipRecentOutboundEcho = shouldSkipRecentOutboundEcho(msg);
 			const remoteJid = msg.key?.remoteJid;
 			const id = msg.key?.id;
-			const durableId = remoteJid && id ? createWhatsAppDurableInboundMessageId({
-				remoteJid,
-				id
-			}) : void 0;
+			const durableId = remoteJid && id ? createHash("sha256").update(`${remoteJid}\n${id}`).digest("hex") : void 0;
 			let resolvePrepared;
 			if (durableId && !preparedInboundByDurableId.has(durableId)) {
 				if (preparedInboundByDurableId.size >= 1e3) {
@@ -1515,54 +1449,34 @@ async function attachWebInboxToSocket(options) {
 				if (!keepForDrain && durableId && resolvePrepared) preparedInboundByDurableId.delete(durableId);
 			};
 			let result;
-			let appendError;
-			for (const delayMs of [
-				0,
-				100,
-				300
-			]) {
-				if (delayMs > 0) await new Promise((resolve) => {
-					setTimeout(resolve, delayMs);
-				});
-				try {
-					result = await enqueueWhatsAppDurableInbound({
-						queue: durableInboundQueue,
-						message: msg,
-						upsertType: upsert.type,
-						skipStaleAppend,
-						skipRecentOutboundEcho,
-						receivedAt,
-						receiveOrder
-					});
-					appendError = void 0;
-					break;
-				} catch (error) {
-					appendError = error;
-				}
-			}
-			if (result === void 0) {
+			try {
+				result = await durableInboundMonitor.admit({
+					message: msg,
+					upsertType: upsert.type,
+					skipStaleAppend,
+					skipRecentOutboundEcho,
+					receivedAt,
+					receiveOrder
+				}, { receivedAt });
+			} catch (error) {
 				finishPreparation(void 0);
-				const formattedError = formatError(appendError);
+				const formattedError = formatError(error);
 				inboundLogger.error({ error: formattedError }, "failed persisting durable WhatsApp inbound after retries; message dropped");
 				inboundConsoleLog.error(`Failed persisting durable WhatsApp inbound after retries; message dropped: ${formattedError}`);
 				continue;
 			}
-			if (result.kind === "completed") {
+			if (result.kind === "durable" && result.queueResult.kind === "completed") {
 				finishPreparation(void 0);
 				const inbound = await normalizeInboundMessage(msg);
 				if (inbound) await maybeMarkNonSelfChatReadReceipt(inbound, buildReadReceiptTarget(inbound));
-			} else {
-				if (result.kind === "accepted") try {
-					finishPreparation(skipRecentOutboundEcho ? null : await normalizeInboundMessage(msg), true);
-				} catch (error) {
-					finishPreparation(void 0);
-					throw error;
-				}
-				else finishPreparation(void 0);
-				requestDurableInboundDrain().catch((error) => {
-					inboundLogger.error({ error: formatError(error) }, "whatsapp durable inbound drain failed");
-				});
+			} else if (result.kind === "durable" && result.queueResult.kind === "accepted") if (skipRecentOutboundEcho) finishPreparation(null);
+			else try {
+				finishPreparation(await normalizeInboundMessage(msg), true);
+			} catch (error) {
+				finishPreparation(void 0);
+				inboundLogger.warn({ error: formatError(error) }, "failed preparing WhatsApp inbound identity; durable drain will normalize again");
 			}
+			else finishPreparation(void 0);
 		}
 	};
 	const handleMessagesUpsertEvent = (upsert) => {
@@ -1588,7 +1502,6 @@ async function attachWebInboxToSocket(options) {
 	};
 	const drainInboundBeforeSocketClose = async () => {
 		groupMetadataCacheClosed = true;
-		clearInterval(durableDrainTimer);
 		for (;;) {
 			await drainDebouncedInboundMessages();
 			if (pendingMessageHandlers.size === 0) break;
@@ -1597,12 +1510,12 @@ async function attachWebInboxToSocket(options) {
 			if (pendingMessageHandlers.size === 0 && pendingDebounceKeys.size === 0 && activeInboundFlushes.size === 0) break;
 		}
 		await drainDebouncedInboundMessages();
-		try {
-			await durableInboundDrain.waitForIdle();
-		} finally {
-			durableDrainClosed = true;
-			durableInboundDrain.dispose();
+		for (;;) {
+			await durableInboundMonitor.waitForIdle();
+			if (pendingDebounceKeys.size === 0 && activeInboundFlushes.size === 0) break;
+			await drainDebouncedInboundMessages();
 		}
+		await durableInboundMonitor.stop();
 	};
 	const drainInboundBeforeSocketCloseWithTimeout = async () => {
 		let timeout = null;
@@ -1615,8 +1528,7 @@ async function attachWebInboxToSocket(options) {
 			})]);
 		} finally {
 			if (timeout) clearTimeout(timeout);
-			durableDrainClosed = true;
-			durableInboundDrain.dispose();
+			durableInboundMonitor.stop();
 		}
 	};
 	const handleConnectionUpdate = (update) => {
@@ -1675,10 +1587,7 @@ async function attachWebInboxToSocket(options) {
 	const detachGroupParticipantsUpdate = attachSockListener("group-participants.update", ((update) => {
 		forgetFullGroupMetadata(update.id);
 	}));
-	requestDurableInboundDrain().catch((err) => {
-		inboundLogger.error({ error: String(err) }, "failed replaying durable WhatsApp inbound");
-		inboundConsoleLog.error(`Failed replaying durable WhatsApp inbound: ${String(err)}`);
-	});
+	durableInboundMonitor.start();
 	(async () => {
 		try {
 			const groups = await sock.groupFetchAllParticipating();
@@ -1736,7 +1645,7 @@ async function attachWebInboxToSocket(options) {
 	};
 }
 async function monitorWebInbox(options) {
-	const socketTiming = options.socketTiming ?? resolveWhatsAppSocketTiming(options.cfg);
+	const socketTiming = options.socketTiming ?? resolveWhatsAppSocketTiming();
 	const recentMessageKeys = options.recentMessageKeys ?? /* @__PURE__ */ new Map();
 	const baileysGroupMetaCache = options.baileysGroupMetaCache ?? /* @__PURE__ */ new Map();
 	const sock = await createWaSocket(false, options.verbose, {
@@ -1794,12 +1703,13 @@ function isBotMentionedFromTargets(msg, mentionCfg, targets) {
 	const isGroupConversation = requireWhatsAppInboundAdmission(msg).conversation.kind === "group";
 	const isSelfChat = explicitSelfChatOverride ? Boolean(mentionCfg.isSelfChat) : isSelfChatMode(targets.self.e164, mentionCfg.allowFrom) && !isGroupConversation;
 	const hasMentions = targets.normalizedMentions.length > 0;
-	if (hasMentions && !isSelfChat) {
+	const hasNativeMentionsOutsideSelfChat = hasMentions && !isSelfChat;
+	if (hasNativeMentionsOutsideSelfChat) {
 		for (const mention of targets.normalizedMentions) if (identitiesOverlap(targets.self, mention)) return true;
-		return false;
 	} else if (hasMentions && isSelfChat) {}
 	const bodyClean = clean(msg.payload.body);
 	if (mentionCfg.mentionRegexes.some((re) => re.test(bodyClean))) return true;
+	if (hasNativeMentionsOutsideSelfChat) return false;
 	if (targets.self.e164) {
 		const selfDigits = targets.self.e164.replace(/\D/g, "");
 		if (selfDigits) {
@@ -1980,8 +1890,7 @@ function formatWhatsAppInboundListeningLog(account) {
 const DEFAULT_WHATSAPP_ACK_REACTION = "👀";
 function resolveWhatsAppAckEmoji(params) {
 	if (!params.ackConfig) return "";
-	if (params.ackConfig.emoji !== void 0) return params.ackConfig.emoji.trim();
-	return resolveAgentIdentityEmoji(params.cfg, params.agentId) ?? DEFAULT_WHATSAPP_ACK_REACTION;
+	return (typeof params.ackConfig === "string" ? params.ackConfig : params.ackConfig.emoji)?.trim() || resolveAgentIdentityEmoji(params.cfg, params.agentId) || DEFAULT_WHATSAPP_ACK_REACTION;
 }
 function resolveAgentIdentityEmoji(cfg, agentId) {
 	return resolveAgentIdentity(cfg, agentId)?.emoji?.trim() || void 0;
@@ -1989,7 +1898,7 @@ function resolveAgentIdentityEmoji(cfg, agentId) {
 //#endregion
 //#region extensions/whatsapp/src/auto-reply/monitor/group-activation.ts
 function hasNamedWhatsAppAccounts(cfg) {
-	return Object.keys(cfg.channels?.whatsapp?.accounts ?? {}).some((accountId) => normalizeAccountId$1(accountId) !== DEFAULT_ACCOUNT_ID$1);
+	return Object.keys(cfg.channels?.whatsapp?.accounts ?? {}).some((accountId) => normalizeAccountId(accountId) !== DEFAULT_ACCOUNT_ID);
 }
 function isActivationOnlyEntry(entry) {
 	return entry?.groupActivation !== void 0 && typeof entry?.sessionId !== "string" && typeof entry?.updatedAt !== "number";
@@ -2012,7 +1921,7 @@ async function resolveGroupActivationFor(params) {
 		...sessionScope,
 		sessionKey: params.sessionKey
 	});
-	const activation = (normalizeAccountId$1(params.accountId) === DEFAULT_ACCOUNT_ID$1 && hasNamedWhatsAppAccounts(params.cfg) && isActivationOnlyEntry(scopedEntry) ? void 0 : scopedEntry?.groupActivation) ?? legacyEntry?.groupActivation;
+	const activation = (normalizeAccountId(params.accountId) === DEFAULT_ACCOUNT_ID && hasNamedWhatsAppAccounts(params.cfg) && isActivationOnlyEntry(scopedEntry) ? void 0 : scopedEntry?.groupActivation) ?? legacyEntry?.groupActivation;
 	if (activation !== void 0 && scopedEntry?.groupActivation === void 0) {
 		if (scopedEntry) await patchSessionEntry({
 			...sessionScope,
@@ -2034,33 +1943,41 @@ async function resolveGroupActivationFor(params) {
 	return normalizeGroupActivation(activation) ?? defaultActivation;
 }
 //#endregion
-//#region extensions/whatsapp/src/auto-reply/monitor/ack-reaction.ts
-async function maybeSendAckReaction(params) {
-	if (!params.msg.event.id) return null;
+//#region extensions/whatsapp/src/auto-reply/monitor/reaction-participant.ts
+function resolveReactionParticipant(msg) {
+	const sender = getSenderIdentity(msg);
+	return sender.jid ?? sender.lid ?? void 0;
+}
+//#endregion
+//#region extensions/whatsapp/src/auto-reply/monitor/reaction-eligibility.ts
+const DISABLED_REACTION = { status: "disabled" };
+async function resolveWhatsAppReactionEligibility(params) {
+	const messageId = params.msg.event.id;
+	if (!messageId) return DISABLED_REACTION;
 	const admission = requireWhatsAppInboundAdmission(params.msg);
 	const accountId = admission.accountId;
 	if (resolveWhatsAppReactionLevel({
 		cfg: params.cfg,
 		accountId
-	}).level === "off") return null;
-	const ackConfig = params.cfg.channels?.whatsapp?.ackReaction;
+	}).level === "off") return DISABLED_REACTION;
+	const scope = params.cfg.messages?.ackReactionScope ?? "group-mentions";
+	if (scope === "off" || scope === "none") return DISABLED_REACTION;
 	const emoji = resolveWhatsAppAckEmoji({
 		cfg: params.cfg,
 		agentId: params.agentId,
-		ackConfig
+		ackConfig: params.cfg.messages?.ackReaction
 	});
-	const directEnabled = ackConfig?.direct ?? true;
-	const groupMode = ackConfig?.group ?? "mentions";
+	const directEnabled = scope === "all" || scope === "direct";
+	const groupMode = scope === "all" || scope === "group-all" ? "always" : scope === "direct" ? "never" : "mentions";
 	const isGroup = admission.conversation.kind === "group";
-	const conversationIdForCheck = admission.conversation.id;
 	const activation = isGroup ? await resolveGroupActivationFor({
 		cfg: params.cfg,
 		accountId,
 		agentId: params.agentId,
 		sessionKey: params.sessionKey,
-		conversationId: conversationIdForCheck
+		conversationId: admission.conversation.id
 	}) : null;
-	const shouldSendReaction = () => shouldAckReactionForWhatsApp({
+	if (!shouldAckReactionForWhatsApp({
 		emoji,
 		isDirect: admission.conversation.kind === "direct",
 		isGroup,
@@ -2068,32 +1985,50 @@ async function maybeSendAckReaction(params) {
 		groupMode,
 		wasMentioned: (params.msg.groupMention?.wasMentioned ?? params.msg.wasMentioned) === true,
 		groupActivated: activation === "always"
+	})) return DISABLED_REACTION;
+	const participant = resolveReactionParticipant(params.msg);
+	return {
+		status: "prepared",
+		chatId: params.msg.platform.chatJid,
+		messageId,
+		emoji,
+		reactionOptions: {
+			verbose: params.verbose,
+			fromMe: false,
+			...participant ? { participant } : {},
+			accountId,
+			cfg: params.cfg
+		}
+	};
+}
+//#endregion
+//#region extensions/whatsapp/src/auto-reply/monitor/ack-reaction.ts
+async function maybeSendAckReaction(params) {
+	const eligibility = await resolveWhatsAppReactionEligibility({
+		cfg: params.cfg,
+		msg: params.msg,
+		agentId: params.agentId,
+		sessionKey: params.sessionKey,
+		verbose: params.verbose
 	});
-	if (!shouldSendReaction()) return null;
+	if (eligibility.status === "disabled") return null;
+	const { chatId, messageId, emoji, reactionOptions } = eligibility;
 	params.info({
-		chatId: params.msg.platform.chatJid,
-		messageId: params.msg.event.id,
+		chatId,
+		messageId,
 		emoji
 	}, "sending ack reaction");
-	const sender = getSenderIdentity(params.msg);
-	const reactionOptions = {
-		verbose: params.verbose,
-		fromMe: false,
-		...sender.jid ? { participant: sender.jid } : {},
-		accountId,
-		cfg: params.cfg
-	};
 	return createAckReactionHandle({
 		ackReactionValue: emoji,
-		send: () => sendReactionWhatsApp(params.msg.platform.chatJid, params.msg.event.id, emoji, reactionOptions),
-		remove: () => sendReactionWhatsApp(params.msg.platform.chatJid, params.msg.event.id, "", reactionOptions),
+		send: () => sendReactionWhatsApp(chatId, messageId, emoji, reactionOptions),
+		remove: () => sendReactionWhatsApp(chatId, messageId, "", reactionOptions),
 		onSendError: (err) => {
 			params.warn({
 				error: formatError(err),
-				chatId: params.msg.platform.chatJid,
-				messageId: params.msg.event.id
+				chatId,
+				messageId
 			}, "failed to send ack reaction");
-			logVerbose(`WhatsApp ack reaction failed for chat ${params.msg.platform.chatJid}: ${formatError(err)}`);
+			logVerbose(`WhatsApp ack reaction failed for chat ${chatId}: ${formatError(err)}`);
 		}
 	});
 }
@@ -2249,7 +2184,13 @@ function recordPendingGroupHistoryEntry(params) {
 			body: params.body ?? params.msg.payload.body,
 			timestamp: params.msg.event.timestamp,
 			id: params.msg.event.id,
-			senderJid: senderIdentity.jid ?? params.msg.platform.senderJid
+			senderJid: senderIdentity.jid ?? params.msg.platform.senderJid,
+			...params.body === void 0 && params.msg.payload.media ? { media: [{
+				path: params.msg.payload.media.path,
+				url: params.msg.payload.media.url ?? params.msg.payload.media.path,
+				contentType: params.msg.payload.media.type,
+				kind: params.msg.payload.media.kind ?? void 0
+			}] } : {}
 		}
 	});
 }
@@ -2585,7 +2526,7 @@ async function deliverWebReply(params) {
 	const tableMode = params.tableMode ?? "code";
 	const chunkMode = params.chunkMode ?? "length";
 	const normalizedReply = params.normalizedReplyResult ?? normalizeWhatsAppOutboundPayload(replyResult, { normalizeText: normalizeWhatsAppPayloadTextPreservingIndentation });
-	const textChunks = chunkMarkdownTextWithMode(markdownToWhatsApp(convertMarkdownTables$1(normalizedReply.text ?? "", tableMode)), textLimit, chunkMode);
+	const textChunks = markdownToWhatsAppChunks(normalizedReply.text ?? "", textLimit, tableMode, chunkMode);
 	const mediaList = normalizedReply.mediaUrls ?? [];
 	const getQuote = () => {
 		if (!replyResult.replyToId) return;
@@ -2595,7 +2536,8 @@ async function deliverWebReply(params) {
 			remoteJid: msg.platform.chatJid,
 			fromMe: cached?.fromMe ?? false,
 			participant: cached?.participant ?? (isGroupConversation ? msg.platform.senderJid : void 0),
-			messageText: cached?.body ?? ""
+			messageText: cached?.body ?? "",
+			media: cached?.media
 		});
 	};
 	const sendWithRetry = async (fn, label) => {
@@ -2643,7 +2585,7 @@ async function deliverWebReply(params) {
 		mediaUrls: mediaList,
 		caption: remainingText.shift() || "",
 		send: async ({ mediaUrl, caption }) => {
-			const media = await prepareWhatsAppOutboundMedia(await loadWebMedia$1(mediaUrl, {
+			const media = await prepareWhatsAppOutboundMedia(await loadWebMedia(mediaUrl, {
 				maxBytes: maxMediaBytes,
 				localRoots: params.mediaLocalRoots
 			}), mediaUrl);
@@ -2749,8 +2691,10 @@ function resolveVisibleWhatsAppGroupHistory(params) {
 function resolveVisibleWhatsAppReplyContext(params) {
 	const replyTo = getReplyContext(params.msg, params.authDir);
 	if (!replyTo) return null;
+	const admission = requireWhatsAppInboundAdmission(params.msg);
+	const previewBody = [replyTo.body, formatMediaPlaceholderText(replyTo.media ? [replyTo.media] : [])].filter(Boolean).join("\n");
 	const senderAllowed = resolveInboundSupplementalSenderAllowed({
-		isGroup: requireWhatsAppInboundAdmission(params.msg).conversation.kind === "group",
+		isGroup: admission.conversation.kind === "group",
 		groupPolicy: params.groupPolicy,
 		allowFrom: params.groupAllowFrom,
 		isSenderAllowed: (allowFrom) => isWhatsAppSupplementalSenderAllowed({
@@ -2759,12 +2703,16 @@ function resolveVisibleWhatsAppReplyContext(params) {
 			sender: replyTo.sender
 		})
 	});
-	return filterChannelInboundQuoteContext(params.mode, {
+	const visible = filterChannelInboundQuoteContext(params.mode, {
 		id: replyTo.id,
-		body: replyTo.body,
+		body: previewBody,
 		sender: replyTo.sender?.label ?? void 0,
 		senderAllowed
-	}) ? replyTo : null;
+	});
+	return visible ? {
+		...replyTo,
+		body: visible.body ?? ""
+	} : null;
 }
 //#endregion
 //#region extensions/whatsapp/src/auto-reply/monitor/inbound-dispatch.ts
@@ -2780,14 +2728,16 @@ function normalizeErrForLog(err) {
 function whatsAppReplyDeliveryVisibility(visibleReplySent) {
 	return { visibleReplySent };
 }
-function whatsAppReplyDeliveryVisibilityFromDurableResult(result) {
-	return whatsAppReplyDeliveryVisibility(result.visibleReplySent === true);
+function isWhatsAppVisibleDeliveryError(error) {
+	return typeof error === "object" && error !== null && !Array.isArray(error) && error.visibleReplySent === true || isChannelPartialDeliveryError(error) && error.deliveryResult.visibleReplySent;
 }
 function readTrimmedString(value) {
 	return typeof value === "string" ? value.trim() : "";
 }
 function markWhatsAppReplyDeliveryErrorVisibleAfterFlush(error, flushResult) {
-	return flushResult.delivered > 0 ? markWhatsAppVisibleDeliveryError(error) : error;
+	if (flushResult.delivered === 0) return error;
+	if (isWhatsAppVisibleDeliveryError(error)) return error;
+	return markWhatsAppVisibleDeliveryError(new Error("deferred WhatsApp media delivery failed after an earlier visible send", { cause: error }));
 }
 function logWhatsAppReplyDeliveryError(params) {
 	const admission = requireWhatsAppInboundAdmission(params.msg);
@@ -2839,31 +2789,58 @@ function shouldDeferWhatsAppMediaOnlyPayload(params) {
 }
 function createWhatsAppMediaOnlyReplyCoalescer(params) {
 	const pendingMediaOnlyPayloads = [];
-	const flushExceptDuplicateMedia = async (mediaUrls) => {
+	const flushWhere = async (shouldFlush) => {
 		const flushResult = {
 			delivered: 0,
 			droppedDuplicateMedia: 0
 		};
-		const pending = pendingMediaOnlyPayloads.splice(0);
-		for (const candidate of pending) {
-			if (mediaUrls && hasWhatsAppMediaUrlOverlap(candidate.mediaUrls, mediaUrls)) {
-				flushResult.droppedDuplicateMedia += 1;
-				continue;
-			}
-			try {
-				if ((await params.deliver(candidate)).visibleReplySent) flushResult.delivered += 1;
-			} catch (error) {
-				throw markWhatsAppReplyDeliveryErrorVisibleAfterFlush(error, flushResult);
-			}
+		const candidates = [];
+		const retained = [];
+		for (const pending of pendingMediaOnlyPayloads.splice(0)) if (shouldFlush(pending)) candidates.push(pending);
+		else retained.push(pending);
+		pendingMediaOnlyPayloads.push(...retained);
+		for (const [index, candidate] of candidates.entries()) try {
+			const delivery = await params.deliver(candidate);
+			candidate.resolveFinalization(delivery);
+			if (delivery.visibleReplySent) flushResult.delivered += 1;
+		} catch (error) {
+			const visibleError = markWhatsAppReplyDeliveryErrorVisibleAfterFlush(error, flushResult);
+			candidate.rejectFinalization(error);
+			for (const remaining of candidates.slice(index + 1)) remaining.rejectFinalization(new Error("deferred WhatsApp media delivery was not attempted", { cause: error }));
+			throw visibleError;
 		}
 		return flushResult;
 	};
 	return {
 		defer(pending) {
-			pendingMediaOnlyPayloads.push(pending);
+			let resolveFinalization;
+			let rejectFinalization;
+			const finalization = new Promise((resolve, reject) => {
+				resolveFinalization = resolve;
+				rejectFinalization = reject;
+			});
+			pendingMediaOnlyPayloads.push({
+				...pending,
+				resolveFinalization,
+				rejectFinalization
+			});
+			return finalization;
+		},
+		flushNonDuplicateMedia: (mediaUrls) => flushWhere((pending) => !hasWhatsAppMediaUrlOverlap(pending.mediaUrls, mediaUrls)),
+		dropDuplicateMedia(mediaUrls) {
+			const flushResult = {
+				delivered: 0,
+				droppedDuplicateMedia: 0
+			};
+			const retained = [];
+			for (const pending of pendingMediaOnlyPayloads.splice(0)) if (hasWhatsAppMediaUrlOverlap(pending.mediaUrls, mediaUrls)) {
+				pending.resolveFinalization(whatsAppReplyDeliveryVisibility(false));
+				flushResult.droppedDuplicateMedia += 1;
+			} else retained.push(pending);
+			pendingMediaOnlyPayloads.push(...retained);
+			return flushResult;
 		},
-		flushExceptDuplicateMedia,
-		flushAll: () => flushExceptDuplicateMedia()
+		flushAll: () => flushWhere(() => true)
 	};
 }
 function logWhatsAppMediaOnlyFlushResult(result) {
@@ -2873,7 +2850,7 @@ function logWhatsAppMediaOnlyFlushResult(result) {
 }
 function resolveWhatsAppResponsePrefix(params) {
 	const configuredResponsePrefix = params.cfg.messages?.responsePrefix;
-	return params.pipelineResponsePrefix ?? (configuredResponsePrefix === void 0 && params.isSelfChat ? resolveIdentityNamePrefix$1(params.cfg, params.agentId) : void 0);
+	return params.pipelineResponsePrefix ?? (configuredResponsePrefix === "auto" ? resolveIdentityNamePrefix$1(params.cfg, params.agentId) : configuredResponsePrefix) ?? (params.isSelfChat ? resolveIdentityNamePrefix$1(params.cfg, params.agentId) : void 0);
 }
 async function buildWhatsAppInboundContext(params) {
 	const admission = requireWhatsAppInboundAdmission(params.msg);
@@ -2885,14 +2862,16 @@ async function buildWhatsAppInboundContext(params) {
 			sender: entry.sender,
 			body: entry.body,
 			timestamp: entry.timestamp,
-			messageId: entry.id
+			messageId: entry.id,
+			media: entry.media
 		})),
 		limit: params.groupHistory?.length ?? 1
 	}) : void 0;
-	const media = toInboundMediaFacts(params.msg.payload.media?.path || params.msg.payload.media?.url ? [{
+	const media = toInboundMediaFacts(params.msg.payload.media ? [{
 		path: params.msg.payload.media?.path,
 		url: params.msg.payload.media?.url ?? params.msg.payload.media?.path,
-		contentType: params.msg.payload.media?.type
+		contentType: params.msg.payload.media?.type,
+		kind: params.msg.payload.media?.kind
 	}] : void 0, { transcribed: (_entry, index) => params.mediaTranscribedIndexes?.includes(index) === true });
 	return buildChannelInboundEventContext({
 		channel: "whatsapp",
@@ -2903,7 +2882,7 @@ async function buildWhatsAppInboundContext(params) {
 				sender: params.visibleReplyTo.sender?.label ?? void 0
 			} : void 0,
 			groupSystemPrompt: params.groupSystemPrompt,
-			untrustedContext: params.msg.payload.untrustedStructuredContext
+			channelStructuredContext: params.msg.payload.channelStructuredContext
 		},
 		media,
 		messageId: params.msg.event.id,
@@ -2935,6 +2914,7 @@ async function buildWhatsAppInboundContext(params) {
 			rawBody: params.rawBody ?? params.msg.payload.body,
 			commandBody: params.command?.body ?? params.msg.payload.body
 		},
+		sessionTranscript: { historyLimit: conversationKind === "group" ? params.groupHistoryLimit ?? params.groupHistory?.length ?? 0 : 0 },
 		access: {
 			...wasMentioned !== void 0 ? { mentions: {
 				canDetectMention: conversationKind === "group",
@@ -2995,11 +2975,6 @@ function createWhatsAppReplyPlan(params) {
 	const conversationId = admission.conversation.id;
 	const conversationKind = admission.conversation.kind;
 	const statusReactionController = params.statusReactionController ?? null;
-	const statusReactionTiming = {
-		...DEFAULT_TIMING,
-		...params.cfg.messages?.statusReactions?.timing
-	};
-	const removeAckAfterReply = params.cfg.messages?.removeAckAfterReply ?? false;
 	const textLimit = params.maxMediaTextChunkLimit ?? resolveTextChunkLimit(params.cfg, "whatsapp");
 	const chunkMode = resolveChunkMode(params.cfg, "whatsapp", params.route.accountId);
 	const tableMode = resolveMarkdownTableMode$1({
@@ -3016,7 +2991,20 @@ function createWhatsAppReplyPlan(params) {
 	const disableBlockStreaming = sourceRepliesAreToolOnly ? true : resolveWhatsAppDisableBlockStreaming(params.cfg);
 	let didSendReply = false;
 	let didLogHeartbeatStrip = false;
-	const deliverNormalizedPayload = async (normalizedDeliveryPayload, info) => {
+	const recordDeliveredPayload = (payload) => {
+		didSendReply = true;
+		const shouldLog = payload.text ? true : void 0;
+		params.rememberSentText(payload.text, {
+			combinedBody: params.context.Body,
+			combinedBodySessionKey: params.route.sessionKey,
+			logVerboseMessage: shouldLog
+		});
+		if (shouldLogVerbose$1()) {
+			const reply = resolveSendableOutboundReplyParts(payload);
+			logVerbose$1(`Reply body: ${payload.text != null ? reply.text : "<media>"}${reply.hasMedia ? " (media)" : ""} -> ${conversationId}`);
+		}
+	};
+	const deliverNormalizedPayload = async (normalizedDeliveryPayload, info, options) => {
 		const reply = resolveSendableOutboundReplyParts(normalizedDeliveryPayload);
 		if (!reply.hasMedia && !reply.text.trim()) return whatsAppReplyDeliveryVisibility(false);
 		if (!(await params.deliverReply({
@@ -3043,15 +3031,11 @@ function createWhatsAppReplyPlan(params) {
 			}, "auto-reply was not accepted by WhatsApp provider");
 			return whatsAppReplyDeliveryVisibility(false);
 		}
-		didSendReply = true;
-		const shouldLog = normalizedDeliveryPayload.text ? true : void 0;
-		params.rememberSentText(normalizedDeliveryPayload.text, {
-			combinedBody: params.context.Body,
-			combinedBodySessionKey: params.route.sessionKey,
-			logVerboseMessage: shouldLog
-		});
-		const fromDisplay = conversationId;
-		if (shouldLogVerbose$1()) logVerbose$1(`Reply body: ${normalizedDeliveryPayload.text != null ? reply.text : "<media>"}${reply.hasMedia ? " (media)" : ""} -> ${fromDisplay}`);
+		if (options?.recordDelivery !== false) try {
+			recordDeliveredPayload(normalizedDeliveryPayload);
+		} catch (error) {
+			throw markWhatsAppVisibleDeliveryError(error);
+		}
 		return whatsAppReplyDeliveryVisibility(true);
 	};
 	const mediaOnlyCoalescer = createWhatsAppMediaOnlyReplyCoalescer({ deliver: async (pending) => {
@@ -3072,90 +3056,82 @@ function createWhatsAppReplyPlan(params) {
 			onSettled: async () => {
 				const flushResult = await mediaOnlyCoalescer.flushAll();
 				logWhatsAppMediaOnlyFlushResult(flushResult);
-				return whatsAppReplyDeliveryVisibility(flushResult.delivered > 0);
+				return whatsAppReplyDeliveryVisibility(didSendReply || flushResult.delivered > 0);
 			},
 			onReplyStart: params.msg.platform.sendComposing
 		},
 		delivery: {
-			deliver: async (payload, info) => {
+			preparePayload: async (payload, info) => {
 				const deliveryPayload = resolveWhatsAppDeliverablePayload(payload, info);
-				if (!deliveryPayload) return whatsAppReplyDeliveryVisibility(false);
+				if (!deliveryPayload) return null;
 				const normalizedOutboundPayload = normalizeWhatsAppOutboundPayload(deliveryPayload, { normalizeText: normalizeWhatsAppPayloadTextPreservingIndentation });
 				const normalizedDeliveryPayload = deliveryPayload.text === void 0 ? {
 					...normalizedOutboundPayload,
 					text: void 0
 				} : normalizedOutboundPayload;
 				const reply = resolveSendableOutboundReplyParts(normalizedDeliveryPayload);
-				if (!reply.hasMedia && !reply.text.trim()) return whatsAppReplyDeliveryVisibility(false);
-				if (!reply.hasMedia) {
-					const flushResult = await mediaOnlyCoalescer.flushAll();
-					logWhatsAppMediaOnlyFlushResult(flushResult);
-					try {
-						const durable = await deliverInboundReplyWithMessageSendContext({
-							cfg: params.cfg,
-							channel: "whatsapp",
-							accountId: params.route.accountId,
-							agentId: params.route.agentId,
-							ctxPayload: params.context,
-							payload: normalizedDeliveryPayload,
-							info,
-							to: conversationId,
-							replyToId: resolveWhatsAppDurableReplyToId({
-								context: params.context,
-								info,
-								msg: params.msg,
-								payload: normalizedDeliveryPayload
-							}),
-							formatting: {
-								textLimit,
-								tableMode,
-								chunkMode
-							}
-						});
-						if (durable.status === "failed") {
-							if (durable.sentBeforeError === true) throw markWhatsAppVisibleDeliveryError(durable.error);
-							throw durable.error;
-						}
-						if (durable.status === "handled_visible") {
-							didSendReply = true;
-							const shouldLog = normalizedDeliveryPayload.text ? true : void 0;
-							params.rememberSentText(normalizedDeliveryPayload.text, {
-								combinedBody: params.context.Body,
-								combinedBodySessionKey: params.route.sessionKey,
-								logVerboseMessage: shouldLog
-							});
-							return whatsAppReplyDeliveryVisibilityFromDurableResult(durable.delivery);
-						}
-						if (durable.status === "handled_no_send") return flushResult.delivered > 0 ? whatsAppReplyDeliveryVisibility(true) : whatsAppReplyDeliveryVisibilityFromDurableResult(durable.delivery);
-						const deliveryResult = await deliverNormalizedPayload(normalizedDeliveryPayload, info);
-						return flushResult.delivered > 0 && !deliveryResult.visibleReplySent ? whatsAppReplyDeliveryVisibility(true) : deliveryResult;
-					} catch (error) {
-						throw markWhatsAppReplyDeliveryErrorVisibleAfterFlush(error, flushResult);
+				if (!reply.hasMedia && !reply.text.trim()) return normalizedDeliveryPayload;
+				const mediaUrls = getWhatsAppPayloadMediaUrls(normalizedDeliveryPayload);
+				logWhatsAppMediaOnlyFlushResult(reply.hasMedia ? shouldDeferWhatsAppMediaOnlyPayload({
+					info,
+					mediaUrls,
+					reply
+				}) ? {
+					delivered: 0,
+					droppedDuplicateMedia: 0
+				} : await mediaOnlyCoalescer.flushNonDuplicateMedia(mediaUrls) : await mediaOnlyCoalescer.flushAll());
+				return normalizedDeliveryPayload;
+			},
+			durable: (payload, info) => {
+				const reply = resolveSendableOutboundReplyParts(payload);
+				if (reply.hasMedia || !reply.text.trim()) return false;
+				return {
+					to: conversationId,
+					replyToId: resolveWhatsAppDurableReplyToId({
+						context: params.context,
+						info,
+						msg: params.msg,
+						payload
+					}),
+					formatting: {
+						textLimit,
+						tableMode,
+						chunkMode
 					}
-				}
+				};
+			},
+			deliver: async (payload, info) => {
+				const normalizedDeliveryPayload = payload;
+				const reply = resolveSendableOutboundReplyParts(normalizedDeliveryPayload);
+				if (!reply.hasMedia && !reply.text.trim()) return whatsAppReplyDeliveryVisibility(false);
+				if (!reply.hasMedia) return await deliverNormalizedPayload(normalizedDeliveryPayload, info, { recordDelivery: false });
 				const mediaUrls = getWhatsAppPayloadMediaUrls(normalizedDeliveryPayload);
 				if (shouldDeferWhatsAppMediaOnlyPayload({
 					info,
 					mediaUrls,
 					reply
-				})) {
-					mediaOnlyCoalescer.defer({
+				})) return {
+					visibleReplySent: false,
+					finalization: mediaOnlyCoalescer.defer({
 						info,
 						mediaUrls,
 						payload: normalizedDeliveryPayload
-					});
-					return whatsAppReplyDeliveryVisibility(false);
-				}
-				const flushResult = await mediaOnlyCoalescer.flushExceptDuplicateMedia(mediaUrls);
-				logWhatsAppMediaOnlyFlushResult(flushResult);
+					})
+				};
 				try {
-					const deliveryResult = await deliverNormalizedPayload(normalizedDeliveryPayload, info);
-					return flushResult.delivered > 0 && !deliveryResult.visibleReplySent ? whatsAppReplyDeliveryVisibility(true) : deliveryResult;
+					const result = await deliverNormalizedPayload(normalizedDeliveryPayload, info);
+					if (result.visibleReplySent) logWhatsAppMediaOnlyFlushResult(mediaOnlyCoalescer.dropDuplicateMedia(mediaUrls));
+					return result;
 				} catch (error) {
-					throw markWhatsAppReplyDeliveryErrorVisibleAfterFlush(error, flushResult);
+					if (isWhatsAppVisibleDeliveryError(error)) logWhatsAppMediaOnlyFlushResult(mediaOnlyCoalescer.dropDuplicateMedia(mediaUrls));
+					throw error;
 				}
 			},
+			onDelivered: (payload, _info, result) => {
+				if (!resolveSendableOutboundReplyParts(payload).hasMedia && result?.visibleReplySent === true) recordDeliveredPayload(payload);
+			},
 			onError: (err, info) => {
+				if (didSendReply) markWhatsAppVisibleDeliveryError(err);
 				logWhatsAppReplyDeliveryError({
 					err,
 					info,
@@ -3189,13 +3165,10 @@ function createWhatsAppReplyPlan(params) {
 		finalize: (dispatchResult) => {
 			const didQueueVisibleReply = hasVisibleInboundReplyDispatch(dispatchResult);
 			const didDeliverVisibleReply = didSendReply || dispatchResult.observedReplyDelivery === true;
-			if (!didQueueVisibleReply) {
+			if (!didQueueVisibleReply && !didDeliverVisibleReply) {
 				if (statusReactionController) finalizeWhatsAppStatusReaction({
 					controller: statusReactionController,
-					outcome: "error",
-					hasFinalResponse: false,
-					removeAckAfterReply,
-					timing: statusReactionTiming
+					outcome: "error"
 				});
 				if (params.shouldClearGroupHistory) params.groupHistories.set(params.groupHistoryKey, []);
 				logVerbose$1("Skipping auto-reply: silent token or no text/media returned from resolver");
@@ -3203,10 +3176,7 @@ function createWhatsAppReplyPlan(params) {
 			}
 			if (statusReactionController) finalizeWhatsAppStatusReaction({
 				controller: statusReactionController,
-				outcome: didDeliverVisibleReply ? "done" : "error",
-				hasFinalResponse: didDeliverVisibleReply,
-				removeAckAfterReply,
-				timing: statusReactionTiming
+				outcome: didDeliverVisibleReply ? "done" : "error"
 			});
 			if (params.shouldClearGroupHistory) params.groupHistories.set(params.groupHistoryKey, []);
 			return didDeliverVisibleReply;
@@ -3214,29 +3184,8 @@ function createWhatsAppReplyPlan(params) {
 	};
 }
 async function finalizeWhatsAppStatusReaction(params) {
-	if (params.outcome === "done") {
-		await params.controller.setDone();
-		if (params.removeAckAfterReply) {
-			await new Promise((resolve) => {
-				setTimeout(resolve, params.timing.doneHoldMs);
-			});
-			await params.controller.clear();
-		} else await params.controller.restoreInitial();
-		return;
-	}
-	await params.controller.setError();
-	if (params.hasFinalResponse) {
-		if (params.removeAckAfterReply) {
-			await new Promise((resolve) => {
-				setTimeout(resolve, params.timing.errorHoldMs);
-			});
-			await params.controller.clear();
-		} else await params.controller.restoreInitial();
-		return;
-	}
-	if (params.removeAckAfterReply) await new Promise((resolve) => {
-		setTimeout(resolve, params.timing.errorHoldMs);
-	});
+	if (params.outcome === "done") await params.controller.setDone();
+	else await params.controller.setError();
 	await params.controller.restoreInitial();
 }
 //#endregion
@@ -3250,7 +3199,7 @@ function resolveIdentityNamePrefix(cfg, agentId) {
 	return identityName ? `[${identityName}]` : void 0;
 }
 function resolveMessagePrefix(cfg, agentId, opts) {
-	const configured = opts?.configured ?? cfg.messages?.messagePrefix;
+	const configured = opts?.configured;
 	if (configured !== void 0) return configured;
 	if (opts?.hasAllowFrom === true) return "";
 	return resolveIdentityNamePrefix(cfg, agentId) ?? opts?.fallback ?? "[openclaw]";
@@ -3267,7 +3216,7 @@ function formatReplyContext(msg) {
 function buildInboundLine(params) {
 	const { cfg, msg, agentId, previousTimestamp, envelope } = params;
 	const messagePrefix = resolveMessagePrefix(cfg, agentId, {
-		configured: cfg.channels?.whatsapp?.messagePrefix,
+		configured: cfg.channels?.whatsapp?.responsePrefix,
 		hasAllowFrom: (cfg.channels?.whatsapp?.allowFrom?.length ?? 0) > 0
 	});
 	const admission = requireWhatsAppInboundAdmission(msg);
@@ -3297,66 +3246,30 @@ function buildInboundLine(params) {
 //#region extensions/whatsapp/src/auto-reply/monitor/status-reaction.ts
 async function createWhatsAppStatusReactionController(params) {
 	if (!params.msg.event.id) return null;
-	const statusReactionsConfig = params.cfg.messages?.statusReactions;
-	if (statusReactionsConfig?.enabled !== true) return null;
-	const admission = requireWhatsAppInboundAdmission(params.msg);
-	const accountId = admission.accountId;
-	if (resolveWhatsAppReactionLevel({
-		cfg: params.cfg,
-		accountId
-	}).level === "off") return null;
-	const ackConfig = params.cfg.channels?.whatsapp?.ackReaction;
-	const ackEmoji = resolveWhatsAppAckEmoji({
-		cfg: params.cfg,
-		agentId: params.agentId,
-		ackConfig
-	});
-	if (!ackEmoji) return null;
-	const directEnabled = ackConfig?.direct ?? true;
-	const groupMode = ackConfig?.group ?? "mentions";
-	const isGroup = admission.conversation.kind === "group";
-	const conversationIdForCheck = admission.conversation.id;
-	const activation = isGroup ? await resolveGroupActivationFor({
+	if ((params.cfg.messages?.statusReactions)?.enabled !== true) return null;
+	const eligibility = await resolveWhatsAppReactionEligibility({
 		cfg: params.cfg,
-		accountId,
+		msg: params.msg,
 		agentId: params.agentId,
 		sessionKey: params.sessionKey,
-		conversationId: conversationIdForCheck
-	}) : null;
-	if (!shouldAckReactionForWhatsApp({
-		emoji: ackEmoji,
-		isDirect: admission.conversation.kind === "direct",
-		isGroup,
-		directEnabled,
-		groupMode,
-		wasMentioned: (params.msg.groupMention?.wasMentioned ?? params.msg.wasMentioned) === true,
-		groupActivated: activation === "always"
-	})) return null;
-	const sender = getSenderIdentity(params.msg);
-	const reactionOptions = {
-		verbose: params.verbose,
-		fromMe: false,
-		...sender.jid ? { participant: sender.jid } : {},
-		accountId,
-		cfg: params.cfg
-	};
-	const chatId = params.msg.platform.chatJid;
-	const msgId = params.msg.event.id;
+		verbose: params.verbose
+	});
+	if (eligibility.status === "disabled") return null;
+	const { chatId, messageId, emoji: initialEmoji, reactionOptions } = eligibility;
 	return createStatusReactionController({
 		enabled: true,
 		adapter: {
 			setReaction: async (emoji) => {
-				await sendReactionWhatsApp(chatId, msgId, emoji, reactionOptions);
+				await sendReactionWhatsApp(chatId, messageId, emoji, reactionOptions);
 			},
 			clearReaction: async () => {
-				await sendReactionWhatsApp(chatId, msgId, "", reactionOptions);
+				await sendReactionWhatsApp(chatId, messageId, "", reactionOptions);
 			}
 		},
-		initialEmoji: ackEmoji,
-		emojis: statusReactionsConfig.emojis,
-		timing: statusReactionsConfig.timing,
+		initialEmoji,
+		emojis: void 0,
 		onError: (err) => {
-			logVerbose(`WhatsApp status-reaction error for chat ${chatId}/${msgId}: ${String(err)}`);
+			logVerbose(`WhatsApp status-reaction error for chat ${chatId}/${messageId}: ${String(err)}`);
 		}
 	});
 }
@@ -3423,13 +3336,16 @@ async function processMessage(params) {
 		sessionKey: params.route.sessionKey
 	});
 	let audioTranscript = params.preflightAudioTranscript ?? void 0;
-	const hasAudioBody = params.msg.payload.media?.type?.startsWith("audio/") === true && params.msg.payload.body === "<media:audio>";
+	const hasAudioBody = (params.msg.payload.media?.kind === "audio" || params.msg.payload.media?.type?.startsWith("audio/") === true) && !params.msg.payload.body.trim();
 	if (params.preflightAudioTranscript === void 0 && hasAudioBody && params.msg.payload.media?.path) try {
 		const { transcribeFirstAudio } = await import("./audio-preflight.runtime-C_glQhZY.js");
 		audioTranscript = await transcribeFirstAudio({
 			ctx: {
-				MediaPaths: [params.msg.payload.media?.path],
-				MediaTypes: params.msg.payload.media?.type ? [params.msg.payload.media?.type] : void 0,
+				media: [{
+					path: params.msg.payload.media.path,
+					contentType: params.msg.payload.media.type,
+					kind: params.msg.payload.media.kind ?? void 0
+				}],
 				From: conversationId,
 				To: params.msg.platform.recipientJid,
 				Provider: "whatsapp",
@@ -3441,7 +3357,7 @@ async function processMessage(params) {
 			cfg: params.cfg
 		});
 	} catch {
-		if (shouldLogVerbose$1()) logVerbose$1("whatsapp: audio preflight transcription failed, using placeholder");
+		if (shouldLogVerbose$1()) logVerbose$1("whatsapp: audio preflight transcription failed, keeping structured audio");
 	}
 	const msgForAgent = audioTranscript !== void 0 ? {
 		...params.msg,
@@ -3479,7 +3395,8 @@ async function processMessage(params) {
 			entries: history.map((m) => ({
 				sender: m.sender,
 				body: m.body,
-				timestamp: m.timestamp
+				timestamp: m.timestamp,
+				media: m.media
 			})),
 			currentMessage: combinedBody,
 			excludeLast: false,
@@ -3488,7 +3405,7 @@ async function processMessage(params) {
 					channel: "WhatsApp",
 					from: conversationId,
 					timestamp: entry.timestamp,
-					body: entry.body,
+					body: [entry.body, formatMediaPlaceholderText(entry.media ?? [])].filter(Boolean).join("\n"),
 					chatType: "group",
 					senderLabel: entry.sender,
 					envelope: envelopeOptions
@@ -3582,6 +3499,7 @@ async function processMessage(params) {
 			authorized: commandAuthorized
 		},
 		groupHistory: visibleGroupHistory,
+		groupHistoryLimit: params.groupHistoryLimit,
 		groupMemberRoster: params.groupMemberNames.get(params.groupHistoryKey),
 		groupSystemPrompt: conversationSystemPrompt,
 		msg: params.msg,
@@ -3704,7 +3622,7 @@ async function processMessage(params) {
 	});
 	const didSendReply = turnResult.dispatched ? finalizeReply?.(turnResult.dispatchResult) ?? false : false;
 	removeAckReactionHandleAfterReply({
-		removeAfterReply: Boolean(params.cfg.messages?.removeAckAfterReply && didSendReply),
+		removeAfterReply: false,
 		ackReaction,
 		onError: (err) => {
 			logAckFailure({
@@ -3744,6 +3662,7 @@ function createWebOnMessageHandler(params) {
 			route,
 			groupHistoryKey,
 			groupHistories: params.groupHistories,
+			groupHistoryLimit: params.groupHistoryLimit,
 			groupMemberNames: params.groupMemberNames,
 			connectionId: params.connectionId,
 			verbose: params.verbose,
@@ -3811,7 +3730,7 @@ function createWebOnMessageHandler(params) {
 			peerId
 		}) : route.sessionKey;
 		let preflightAudioTranscript;
-		const hasAudioBody = msg.payload.media?.type?.startsWith("audio/") === true && msg.payload.body === "<media:audio>";
+		const hasAudioBody = (msg.payload.media?.kind === "audio" || msg.payload.media?.type?.startsWith("audio/") === true) && !msg.payload.body.trim();
 		const canRunEarlyAudioPreflight = conversationKind === "group" || canRunDirectEarlyAudioPreflight;
 		let ackAlreadySent = false;
 		let ackReaction = null;
@@ -3837,8 +3756,11 @@ function createWebOnMessageHandler(params) {
 				const { transcribeFirstAudio } = await import("./audio-preflight.runtime-C_glQhZY.js");
 				preflightAudioTranscript = await transcribeFirstAudio({
 					ctx: {
-						MediaPaths: [msg.payload.media?.path],
-						MediaTypes: msg.payload.media?.type ? [msg.payload.media?.type] : void 0,
+						media: [{
+							path: msg.payload.media.path,
+							contentType: msg.payload.media.type,
+							kind: msg.payload.media.kind ?? void 0
+						}],
 						From: conversationId,
 						To: msg.platform.recipientJid,
 						Provider: "whatsapp",
@@ -4009,8 +3931,7 @@ function resolveWebMonitorConfigSnapshot(params) {
 				...params.cfg.channels,
 				whatsapp: {
 					...params.cfg.channels?.whatsapp,
-					ackReaction: account.ackReaction,
-					messagePrefix: account.messagePrefix,
+					responsePrefix: account.messagePrefix,
 					allowFrom: account.allowFrom,
 					groupAllowFrom: account.groupAllowFrom,
 					groupPolicy: account.groupPolicy,
@@ -4024,23 +3945,11 @@ function resolveWebMonitorConfigSnapshot(params) {
 		account
 	};
 }
-function normalizeReconnectAccountId(accountId) {
-	return (accountId ?? "").trim() || "default";
-}
 function isNoListenerReconnectError(lastError) {
 	return typeof lastError === "string" && /No active WhatsApp Web listener/i.test(lastError);
 }
-function resolveExplicitWhatsAppDebounceOverride(params) {
-	const channel = params.sourceCfg?.channels?.whatsapp;
-	if (!channel) return;
-	const accountId = normalizeReconnectAccountId(params.accountId);
-	const accountDebounce = resolveAccountEntry(channel.accounts, accountId)?.debounceMs;
-	if (accountDebounce !== void 0) return accountDebounce;
-	if (accountId !== "default") {
-		const defaultAccountDebounce = resolveAccountEntry(channel.accounts, "default")?.debounceMs;
-		if (defaultAccountDebounce !== void 0) return defaultAccountDebounce;
-	}
-	return channel.debounceMs;
+function normalizeReconnectAccountId(accountId) {
+	return (accountId ?? "").trim() || "default";
 }
 function isRetryableAuthUnstableError(error) {
 	return error instanceof WhatsAppAuthUnstableError || typeof error === "object" && error !== null && "code" in error && error.code === "whatsapp-auth-unstable";
@@ -4062,10 +3971,8 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 		module: "web-reconnect",
 		runId
 	});
-	const baseCfg = getRuntimeConfig$1();
-	const sourceCfg = getRuntimeConfigSourceSnapshot();
 	const { cfg, account } = resolveWebMonitorConfigSnapshot({
-		cfg: baseCfg,
+		cfg: getRuntimeConfig$1(),
 		accountId: tuning.accountId
 	});
 	const loadCurrentMonitorConfig = () => resolveWebMonitorConfigSnapshot({
@@ -4075,7 +3982,7 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 	const maxMediaBytes = resolveWhatsAppMediaMaxBytes(account);
 	const heartbeatSeconds = resolveHeartbeatSeconds(cfg, tuning.heartbeatSeconds);
 	const reconnectPolicy = resolveReconnectPolicy(cfg, tuning.reconnect);
-	const socketTiming = resolveWhatsAppSocketTiming(cfg, tuning.socketTiming);
+	const socketTiming = resolveWhatsAppSocketTiming(tuning.socketTiming);
 	const baseMentionConfig = buildMentionConfig(cfg);
 	const groupHistoryLimit = account.historyLimit ?? cfg.channels?.whatsapp?.historyLimit ?? cfg.messages?.groupChat?.historyLimit ?? DEFAULT_GROUP_HISTORY_LIMIT;
 	const groupHistories = /* @__PURE__ */ new Map();
@@ -4123,12 +4030,7 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 			const connectionId = newConnectionId();
 			const inboundDebounceMs = resolveInboundDebounceMs({
 				cfg,
-				channel: "whatsapp",
-				overrideMs: resolveExplicitWhatsAppDebounceOverride({
-					cfg,
-					sourceCfg,
-					accountId: account.accountId
-				})
+				channel: "whatsapp"
 			});
 			const shouldDebounce = (msg) => {
 				const normalized = normalizeWebInboundMessage(msg);
@@ -4474,4 +4376,4 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 	}
 }
 //#endregion
-export { loadWebMediaRaw as a, monitorWebInbox as c, loadWebMedia$1 as i, resetWebInboundDedupe as l, LocalMediaAccessError as n, optimizeImageToJpeg as o, getDefaultLocalRoots as r, optimizeImageToPng as s, monitorWebChannel as t };
+export { loadWebMediaRaw as a, monitorWebInbox as c, loadWebMedia as i, resetWebInboundDedupe as l, LocalMediaAccessError as n, optimizeImageToJpeg as o, getDefaultLocalRoots as r, optimizeImageToPng as s, monitorWebChannel as t };