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

package/dist/{monitor-_jqDKBXj.js → monitor-CBVNJ2lb.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-CxPuEFi-.js";
+import { a as normalizeWhatsAppOutboundPayload, c as prepareWhatsAppOutboundMedia, r as sendReactionWhatsApp, s as normalizeWhatsAppPayloadTextPreservingIndentation, u as resolveWhatsAppReactionLevel } from "./send-DhJVN30g.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-CKFrhoX4.js";
+import { t as normalizeE164 } from "./text-runtime-CU_IlbK5.js";
+import { a as cacheInboundMessageMeta, i as buildQuotedMessageOptions, n as resolveWhatsAppGroupSessionRoute, o as lookupInboundMessageMeta, r as resolveWhatsAppLegacyGroupSessionKey } from "./group-session-key-DJSdYfnb.js";
+import { g as readWebSelfId, o as getWebAuthAgeMs, r as WhatsAppAuthUnstableError, v as readWebSelfIdentityForDecision } from "./auth-store-DirYMTbo.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-BM4_wZeM.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-BoSHhQNJ.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 { c as requireWhatsAppInboundAdmission, i as resolveWhatsAppInboundPolicy, l as resolveWhatsAppGroupConversationId, o as buildDeprecatedFlatWhatsAppInboundAdmission, r as resolveWhatsAppCommandAuthorized, s as requireAdmittedWhatsAppInboundMessage, t as checkInboundAccessControl } from "./access-control-CRz_v6bR.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-CpHwbor_.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-BVRExqrB.js";
+import { n as maybeResolveWhatsAppApprovalReaction } from "./approval-reactions-P2HXjmln.js";
+import { t as maybeResolveWhatsAppQuestionReaction } from "./question-reactions-CaOrSYzU.js";
 import { resolveAccountEntry } from "openclaw/plugin-sdk/account-core";
 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, deliverInboundReplyWithMessageSendContext, 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 { buildChannelInboundEventContext, filterChannelInboundQuoteContext, formatInboundEnvelope, formatInboundEnvelope as formatInboundEnvelope$1, formatInboundMediaUnavailableText, formatLocationText, formatMediaPlaceholderText, hasVisibleInboundReplyDispatch, resolveInboundSessionEnvelopeContext, resolveInboundSupplementalSenderAllowed, runChannelInboundEvent, shouldDebounceTextInbound, toInboundMediaFacts, toLocationContext } from "openclaw/plugin-sdk/channel-inbound";
 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 { asDateTimestampMs, parseStrictFiniteNumber, resolveExpiresAtMsFromDurationMs } from "openclaw/plugin-sdk/number-runtime";
 import { createHash } from "node:crypto";
 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";
@@ -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) {
@@ -441,6 +440,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);
 }
@@ -470,14 +471,6 @@ function createWhatsAppDurableInboundQueue(accountId) {
 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,
@@ -496,29 +489,52 @@ function resolveWhatsAppIngressNonRetryableFailure(error) {
 		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: (message) => inspectWhatsAppIngressMessage(message),
+		payload: {
+			version: WHATSAPP_DURABLE_INBOUND_PAYLOAD_VERSION,
+			serialize: (message, { receivedAt }) => ({
+				message: serializeWhatsAppDurableInboundMessage(message),
+				receivedAt
+			}),
+			deserialize: (payload) => 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: (message, lifecycle, claim) => params.dispatch(message, claim.payload, 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 +754,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 +776,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);
@@ -1192,17 +1209,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 +1236,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 +1259,9 @@ async function attachWebInboxToSocket(options) {
 			replyContext,
 			mediaPath,
 			mediaType,
-			mediaFileName
+			mediaFileName,
+			mediaKind,
+			nativeMedia
 		};
 	};
 	const enqueueInboundMessage = async (msg, inbound, enriched, durable) => {
@@ -1274,10 +1296,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 +1308,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 untrustedStructuredContext = [
+			...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: {
@@ -1334,6 +1366,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,12 +1393,13 @@ 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 (msg, context) => {
 		rememberBaileysMessage(msg.key?.remoteJid, msg.key?.id, msg.message);
 		if (context.skipRecentOutboundEcho === true) return "completed";
 		const preparation = context.eventId ? preparedInboundByDurableId.get(context.eventId) : void 0;
@@ -1401,81 +1435,28 @@ async function attachWebInboxToSocket(options) {
 		});
 		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);
-			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({
+	const durableInboundMonitor = createWhatsAppIngressMonitor({
 		queue: durableInboundQueue,
 		dispatch: async (msg, payload, lifecycle) => {
 			const remoteJid = msg.key?.remoteJid;
 			const id = msg.key?.id;
-			return { kind: await processWhatsAppInboundMessage(msg, {
+			return { kind: await processDurableInboundMessage(msg, {
 				...payload,
 				...remoteJid && id ? { eventId: createWhatsAppDurableInboundMessageId({
 					remoteJid,
 					id
 				}) } : {},
-				lifecycle: continueDrainAfterLaneSettlement(lifecycle)
+				lifecycle
 			}) };
 		},
-		onLog: (message) => inboundLogger.warn({ message }, "whatsapp ingress drain")
+		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();
+		}
 	});
-	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 ?? []) {
@@ -1559,9 +1540,7 @@ async function attachWebInboxToSocket(options) {
 					throw error;
 				}
 				else finishPreparation(void 0);
-				requestDurableInboundDrain().catch((error) => {
-					inboundLogger.error({ error: formatError(error) }, "whatsapp durable inbound drain failed");
-				});
+				durableInboundMonitor.requestDrain();
 			}
 		}
 	};
@@ -1588,7 +1567,6 @@ async function attachWebInboxToSocket(options) {
 	};
 	const drainInboundBeforeSocketClose = async () => {
 		groupMetadataCacheClosed = true;
-		clearInterval(durableDrainTimer);
 		for (;;) {
 			await drainDebouncedInboundMessages();
 			if (pendingMessageHandlers.size === 0) break;
@@ -1597,12 +1575,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 +1593,7 @@ async function attachWebInboxToSocket(options) {
 			})]);
 		} finally {
 			if (timeout) clearTimeout(timeout);
-			durableDrainClosed = true;
-			durableInboundDrain.dispose();
+			durableInboundMonitor.stop();
 		}
 	};
 	const handleConnectionUpdate = (update) => {
@@ -1675,10 +1652,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 +1710,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 +1768,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 +1955,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;
@@ -2034,6 +2008,12 @@ async function resolveGroupActivationFor(params) {
 	return normalizeGroupActivation(activation) ?? defaultActivation;
 }
 //#endregion
+//#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/ack-reaction.ts
 async function maybeSendAckReaction(params) {
 	if (!params.msg.event.id) return null;
@@ -2043,14 +2023,16 @@ async function maybeSendAckReaction(params) {
 		cfg: params.cfg,
 		accountId
 	}).level === "off") return null;
-	const ackConfig = params.cfg.channels?.whatsapp?.ackReaction;
+	const ackConfig = params.cfg.messages?.ackReaction;
+	const scope = params.cfg.messages?.ackReactionScope ?? "group-mentions";
+	if (scope === "off" || scope === "none") return null;
 	const emoji = resolveWhatsAppAckEmoji({
 		cfg: params.cfg,
 		agentId: params.agentId,
 		ackConfig
 	});
-	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({
@@ -2075,11 +2057,11 @@ async function maybeSendAckReaction(params) {
 		messageId: params.msg.event.id,
 		emoji
 	}, "sending ack reaction");
-	const sender = getSenderIdentity(params.msg);
+	const participant = resolveReactionParticipant(params.msg);
 	const reactionOptions = {
 		verbose: params.verbose,
 		fromMe: false,
-		...sender.jid ? { participant: sender.jid } : {},
+		...participant ? { participant } : {},
 		accountId,
 		cfg: params.cfg
 	};
@@ -2249,7 +2231,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 +2573,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 +2583,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 +2632,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 +2738,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 +2750,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
@@ -2873,7 +2868,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 +2880,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",
@@ -2935,6 +2932,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 +2993,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({
@@ -3192,10 +3185,7 @@ function createWhatsAppReplyPlan(params) {
 			if (!didQueueVisibleReply) {
 				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 +3193,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 +3201,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 +3216,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 +3233,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,23 +3263,24 @@ 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;
+	if ((params.cfg.messages?.statusReactions)?.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 ackConfig = params.cfg.messages?.ackReaction;
+	const scope = params.cfg.messages?.ackReactionScope ?? "group-mentions";
+	if (scope === "off" || scope === "none") return null;
 	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 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({
@@ -3332,11 +3299,11 @@ async function createWhatsAppStatusReactionController(params) {
 		wasMentioned: (params.msg.groupMention?.wasMentioned ?? params.msg.wasMentioned) === true,
 		groupActivated: activation === "always"
 	})) return null;
-	const sender = getSenderIdentity(params.msg);
+	const participant = resolveReactionParticipant(params.msg);
 	const reactionOptions = {
 		verbose: params.verbose,
 		fromMe: false,
-		...sender.jid ? { participant: sender.jid } : {},
+		...participant ? { participant } : {},
 		accountId,
 		cfg: params.cfg
 	};
@@ -3353,8 +3320,7 @@ async function createWhatsAppStatusReactionController(params) {
 			}
 		},
 		initialEmoji: ackEmoji,
-		emojis: statusReactionsConfig.emojis,
-		timing: statusReactionsConfig.timing,
+		emojis: void 0,
 		onError: (err) => {
 			logVerbose(`WhatsApp status-reaction error for chat ${chatId}/${msgId}: ${String(err)}`);
 		}
@@ -3423,13 +3389,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 +3410,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 +3448,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 +3458,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 +3552,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 +3675,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 +3715,7 @@ function createWebOnMessageHandler(params) {
 			route,
 			groupHistoryKey,
 			groupHistories: params.groupHistories,
+			groupHistoryLimit: params.groupHistoryLimit,
 			groupMemberNames: params.groupMemberNames,
 			connectionId: params.connectionId,
 			verbose: params.verbose,
@@ -3811,7 +3783,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 +3809,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 +3984,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,
@@ -4075,7 +4049,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();
@@ -4474,4 +4448,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 };