@openclaw/whatsapp 2026.6.5-beta.2 → 2026.6.5-beta.3

package/dist/api.js

@@ -3,33 +3,144 @@ import { a as resolveWhatsAppAccount, i as listWhatsAppAuthDirs, n as hasAnyWhat
 import { a as normalizeWhatsAppAllowFromEntries, c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, r as isWhatsAppUserTarget, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./normalize-target-bVWjgftN.js";
 import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-CcdugbDf.js";
 import "./send-DSlVXKL_.js";
+import { n as getStatusCode, t as formatError } from "./session-errors-CbsoQqoy.js";
 import { c as assertWebChannel, d as markdownToWhatsApp, f as resolveJidToE164, l as isSelfChatMode, m as toWhatsappJidWithLid, n as normalizeE164, p as toWhatsappJid, r as resolveUserPath, u as jidToE164 } from "./text-runtime-Dk37KYHj.js";
-import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS, t as whatsappPlugin } from "./channel-CK_4OwYn.js";
+import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS, t as whatsappPlugin } from "./channel-DpreE7Jm.js";
 import { t as whatsappCommandPolicy } from "./command-policy-BIOSHySD.js";
-import { a as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint } from "./setup-core-DLXi32yR.js";
+import { a as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint } from "./setup-core-B4mgubMj.js";
 import "./config-schema-CROZuhT-.js";
-import { t as whatsappSetupPlugin } from "./channel.setup-I-zFGu02.js";
+import { t as whatsappSetupPlugin } from "./channel.setup-D5dt8amX.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-HU41RHGI.js";
 import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-Dijefxc3.js";
 import { n as testing } from "./access-control-C53zKYSN.js";
-import { m as extractText, t as createWebSendApi } from "./send-api-Bjn-h80j.js";
+import { d as normalizeMessageContent, f as resolveInboundMediaMimetype, g as extractLocationData, h as extractContextInfo, p as describeReplyContext, t as createWebSendApi, y as extractText } from "./send-api-CFbAgIbn.js";
 import { r as waitForWaConnection, t as createWaSocket } from "./session-CoxlXm2K.js";
 import "openclaw/plugin-sdk/channel-actions";
 import "openclaw/plugin-sdk/account-resolution";
 import "openclaw/plugin-sdk/core";
 import "openclaw/plugin-sdk/account-id";
+import { formatLocationText } from "openclaw/plugin-sdk/channel-inbound";
 //#region extensions/whatsapp/src/qa-driver.runtime.ts
+function isRecord(value) {
+	return Boolean(value && typeof value === "object");
+}
+function readString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function readBoolean(value) {
+	return typeof value === "boolean" ? value : void 0;
+}
+function findMessageSection(message, sectionNames) {
+	if (!isRecord(message)) return;
+	const queue = [{
+		depth: 0,
+		value: message
+	}];
+	const seen = /* @__PURE__ */ new Set();
+	while (queue.length > 0) {
+		const current = queue.shift();
+		if (!current || seen.has(current.value)) continue;
+		seen.add(current.value);
+		for (const sectionName of sectionNames) {
+			const section = current.value[sectionName];
+			if (isRecord(section)) return section;
+		}
+		if (current.depth >= 4) continue;
+		for (const wrapperName of [
+			"botInvokeMessage",
+			"documentWithCaptionMessage",
+			"ephemeralMessage",
+			"groupMentionedMessage",
+			"viewOnceMessage",
+			"viewOnceMessageV2",
+			"viewOnceMessageV2Extension"
+		]) {
+			const wrapper = current.value[wrapperName];
+			if (isRecord(wrapper) && isRecord(wrapper.message)) queue.push({
+				depth: current.depth + 1,
+				value: wrapper.message
+			});
+		}
+	}
+}
+function readReaction(message) {
+	const reaction = findMessageSection(message, ["reactionMessage"]);
+	if (!reaction) return;
+	const emoji = readString(reaction.text) ?? "";
+	const key = isRecord(reaction.key) ? reaction.key : void 0;
+	return {
+		emoji,
+		fromMe: readBoolean(key?.fromMe),
+		messageId: readString(key?.id),
+		participant: readString(key?.participant)
+	};
+}
+function readPoll(message) {
+	const poll = findMessageSection(message, [
+		"pollCreationMessage",
+		"pollCreationMessageV2",
+		"pollCreationMessageV3"
+	]);
+	if (!poll) return;
+	return {
+		options: (Array.isArray(poll.options) ? poll.options : []).map((option) => isRecord(option) ? readString(option.optionName) : void 0).filter((option) => Boolean(option)),
+		question: readString(poll.name)
+	};
+}
+function readMedia(message) {
+	const normalizedMessage = isRecord(message) ? normalizeMessageContent(message) : void 0;
+	for (const sectionName of [
+		"imageMessage",
+		"videoMessage",
+		"audioMessage",
+		"documentMessage",
+		"stickerMessage"
+	]) {
+		const section = findMessageSection(normalizedMessage ?? message, [sectionName]);
+		if (!section) continue;
+		const mediaMessage = { [sectionName]: section };
+		return {
+			fileName: readString(section.fileName),
+			mediaType: resolveInboundMediaMimetype(mediaMessage)
+		};
+	}
+}
+function readQuotedMessage(message) {
+	const contextInfo = extractContextInfo(message.message ?? void 0);
+	const replyContext = describeReplyContext(message.message);
+	if (!contextInfo && !replyContext) return;
+	if (!contextInfo?.stanzaId && !contextInfo?.participant && !replyContext?.body) return;
+	return {
+		messageId: replyContext?.id ?? contextInfo?.stanzaId ?? void 0,
+		participant: replyContext?.sender?.jid ?? contextInfo?.participant ?? void 0,
+		text: replyContext?.body
+	};
+}
 function normalizeObservedMessage(message, authDir) {
 	if (message.key.fromMe) return null;
-	const text = extractText(message.message ?? void 0);
-	if (!text) return null;
+	const extractedText = extractText(message.message ?? void 0);
+	const location = extractLocationData(message.message);
+	const text = [extractedText, location ? formatLocationText(location) : void 0].filter(Boolean).join("\n").trim() || void 0;
+	const reaction = readReaction(message.message);
+	const poll = readPoll(message.message);
+	const media = readMedia(message.message);
+	const quoted = readQuotedMessage(message);
+	const kind = reaction ? "reaction" : poll ? "poll" : media ? "media" : location ? "location" : text ? "text" : "unknown";
+	if (!text && kind === "unknown") return null;
 	const fromJid = message.key.remoteJid ?? void 0;
 	return {
 		fromJid,
 		fromPhoneE164: fromJid ? jidToE164(fromJid, { authDir }) : null,
+		hasMedia: media ? true : void 0,
+		kind,
+		mediaFileName: media?.fileName,
+		mediaType: media?.mediaType,
 		messageId: message.key.id ?? void 0,
 		observedAt: (/* @__PURE__ */ new Date()).toISOString(),
-		text
+		poll,
+		quoted,
+		reaction,
+		text: text ?? ""
 	};
 }
 function closeSocket(sock) {
@@ -41,16 +152,39 @@ function closeSocket(sock) {
 	const maybeClose = sock.ws?.close;
 	if (typeof maybeClose === "function") maybeClose.call(sock.ws);
 }
+function createConnectionClosedError(update) {
+	const reason = update.lastDisconnect?.error;
+	const status = getStatusCode(reason);
+	const details = reason ? `: ${formatError(reason)}` : "";
+	const statusLabel = typeof status === "number" ? ` (status ${status})` : "";
+	return /* @__PURE__ */ new Error(`WhatsApp QA driver connection closed${statusLabel}${details}`);
+}
 async function startWhatsAppQaDriverSession(params) {
 	const sock = await createWaSocket(false, false, { authDir: params.authDir });
 	const observedMessages = [];
+	const pendingNotificationsWaiters = [];
 	const waiters = [];
 	let closed = false;
+	let closedError;
+	let receivedPendingNotifications = false;
 	const removeWaiter = (waiter) => {
 		const index = waiters.indexOf(waiter);
 		if (index >= 0) waiters.splice(index, 1);
 		clearTimeout(waiter.timeout);
 	};
+	const removePendingNotificationsWaiter = (waiter) => {
+		const index = pendingNotificationsWaiters.indexOf(waiter);
+		if (index >= 0) pendingNotificationsWaiters.splice(index, 1);
+		clearTimeout(waiter.timeout);
+	};
+	const markPendingNotificationsReceived = () => {
+		if (receivedPendingNotifications) return;
+		receivedPendingNotifications = true;
+		for (const waiter of pendingNotificationsWaiters.slice()) {
+			removePendingNotificationsWaiter(waiter);
+			waiter.resolve();
+		}
+	};
 	const observe = (message) => {
 		observedMessages.push(message);
 		for (const waiter of waiters.slice()) {
@@ -65,12 +199,23 @@ async function startWhatsAppQaDriverSession(params) {
 			if (observed) observe(observed);
 		}
 	};
+	const onConnectionUpdate = (event) => {
+		if (event.receivedPendingNotifications === true) markPendingNotificationsReceived();
+		if (event.connection === "close") closeSessionResources(createConnectionClosedError(event));
+	};
 	const removeMessageListener = () => {
-		sock.ev.off?.("messages.upsert", onMessagesUpsert);
+		const evWithOff = sock.ev;
+		evWithOff.off?.("messages.upsert", onMessagesUpsert);
+		evWithOff.off?.("connection.update", onConnectionUpdate);
 	};
 	const closeSessionResources = (waiterError) => {
 		if (closed) return;
 		closed = true;
+		closedError = waiterError;
+		for (const waiter of pendingNotificationsWaiters.slice()) {
+			removePendingNotificationsWaiter(waiter);
+			if (waiterError) waiter.reject(waiterError);
+		}
 		for (const waiter of waiters.slice()) {
 			removeWaiter(waiter);
 			if (waiterError) waiter.reject(waiterError);
@@ -79,15 +224,37 @@ async function startWhatsAppQaDriverSession(params) {
 		closeSocket(sock);
 	};
 	sock.ev.on("messages.upsert", onMessagesUpsert);
+	sock.ev.on("connection.update", onConnectionUpdate);
 	try {
 		await waitForWaConnection(sock, { timeoutMs: params.connectionTimeoutMs ?? 45e3 });
+		if (params.waitForPendingNotifications) await new Promise((resolve, reject) => {
+			if (receivedPendingNotifications) {
+				resolve();
+				return;
+			}
+			if (closed) {
+				reject(closedError ?? /* @__PURE__ */ new Error("WhatsApp QA driver session closed"));
+				return;
+			}
+			const timeoutMs = params.connectionTimeoutMs ?? 45e3;
+			const waiter = {
+				resolve,
+				reject,
+				timeout: setTimeout(() => {
+					removePendingNotificationsWaiter(waiter);
+					reject(/* @__PURE__ */ new Error(`timed out after ${timeoutMs}ms waiting for WhatsApp QA driver pending notifications`));
+				}, timeoutMs)
+			};
+			pendingNotificationsWaiters.push(waiter);
+		});
 	} catch (error) {
 		closeSessionResources(error instanceof Error ? error : /* @__PURE__ */ new Error("failed starting WhatsApp QA driver session"));
 		throw error;
 	}
 	const sendApi = createWebSendApi({
 		sock,
-		defaultAccountId: "qa-driver"
+		defaultAccountId: "qa-driver",
+		authDir: params.authDir
 	});
 	return {
 		async close() {
@@ -96,15 +263,35 @@ async function startWhatsAppQaDriverSession(params) {
 		getObservedMessages() {
 			return [...observedMessages];
 		},
-		async sendText(to, text) {
-			return { messageId: (await sendApi.sendMessage(to, text)).messageId };
+		async sendContact(to, contact) {
+			return { messageId: (await sendApi.sendContact(to, contact)).messageId };
+		},
+		async sendLocation(to, location) {
+			return { messageId: (await sendApi.sendLocation(to, location)).messageId };
+		},
+		async sendMedia(to, text, mediaBuffer, mediaType, options) {
+			return { messageId: (await sendApi.sendMessage(to, text, mediaBuffer, mediaType, options)).messageId };
+		},
+		async sendPoll(to, poll) {
+			return { messageId: (await sendApi.sendPoll(to, poll)).messageId };
+		},
+		async sendReaction(chatJid, messageId, emoji, options) {
+			return { messageId: (await sendApi.sendReaction(chatJid, messageId, emoji, options.fromMe, options.participant)).messageId };
+		},
+		async sendSticker(to, stickerBuffer, options) {
+			return { messageId: (await sendApi.sendSticker(to, stickerBuffer, options)).messageId };
+		},
+		async sendText(to, text, options) {
+			return { messageId: (await sendApi.sendMessage(to, text, void 0, void 0, options)).messageId };
 		},
 		async waitForMessage(paramsLocal) {
-			const existing = observedMessages.find(paramsLocal.match);
+			const predicate = (message) => (!paramsLocal.observedAfter || new Date(message.observedAt).getTime() >= paramsLocal.observedAfter.getTime()) && paramsLocal.match(message);
+			const existing = observedMessages.find(predicate);
 			if (existing) return existing;
+			if (closed) throw closedError ?? /* @__PURE__ */ new Error("WhatsApp QA driver session closed");
 			return await new Promise((resolve, reject) => {
 				const waiter = {
-					predicate: paramsLocal.match,
+					predicate,
 					resolve,
 					reject,
 					timeout: setTimeout(() => {

package/dist/{channel-CK_4OwYn.js → channel-DpreE7Jm.js}

@@ -9,7 +9,7 @@ import { p as toWhatsappJid } from "./text-runtime-Dk37KYHj.js";
 import { t as createWhatsAppLoginTool } from "./agent-tools-login-BX7eHgDm.js";
 import { i as lookupInboundMessageMetaForTarget } from "./quoted-message-CveINB35.js";
 import { t as whatsappCommandPolicy } from "./command-policy-BIOSHySD.js";
-import { a as resolveWhatsAppGroupRequireMention, c as resolveWhatsAppMentionStripRegexes, i as whatsappSetupWizardProxy, l as formatWhatsAppConfigAllowFromEntries, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, r as loadWhatsAppChannelRuntime, s as resolveWhatsAppGroupIntroHint, t as whatsappSetupAdapter } from "./setup-core-DLXi32yR.js";
+import { a as resolveWhatsAppGroupRequireMention, c as resolveWhatsAppMentionStripRegexes, i as whatsappSetupWizardProxy, l as formatWhatsAppConfigAllowFromEntries, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, r as loadWhatsAppChannelRuntime, s as resolveWhatsAppGroupIntroHint, t as whatsappSetupAdapter } from "./setup-core-B4mgubMj.js";
 import { f as readWebAuthExistsForDecision, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-B2ZibndQ.js";
 import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-D_BmQUR9.js";
 import { createActionGate as createActionGate$1 } from "openclaw/plugin-sdk/channel-actions";

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as whatsappPlugin } from "./channel-CK_4OwYn.js";
+import { t as whatsappPlugin } from "./channel-DpreE7Jm.js";
 export { whatsappPlugin };

package/dist/{channel.runtime-DIAo-4Bj.js → channel.runtime-B534_h4x.js}

@@ -1,9 +1,9 @@
 import { startWebLoginWithQr as startWebLoginWithQr$1, waitForWebLogin as waitForWebLogin$1 } from "./login-qr-runtime.js";
 import { c as logoutWeb$1, d as readWebAuthExistsBestEffort$1, f as readWebAuthExistsForDecision$1, g as readWebSelfId$1, h as readWebAuthState$1, m as readWebAuthSnapshotBestEffort$1, o as getWebAuthAgeMs$1, p as readWebAuthSnapshot$1, s as logWebSelfId$1, x as webAuthExists$1 } from "./auth-store-B2ZibndQ.js";
 import { t as getActiveWebListener$1 } from "./active-listener-CFwkn3ho.js";
-import { t as monitorWebChannel$1 } from "./monitor-CFUAZhBS.js";
+import { t as monitorWebChannel$1 } from "./monitor-CmA9YhPe.js";
 import { t as loginWeb$1 } from "./login-Bflq347x.js";
-import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-YtBXJFy0.js";
+import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-DaWJR5kG.js";
 //#region extensions/whatsapp/src/channel.runtime.ts
 function getActiveWebListener(...args) {
 	return getActiveWebListener$1(...args);

package/dist/{channel.setup-I-zFGu02.js → channel.setup-D5dt8amX.js}

@@ -1,4 +1,4 @@
-import { a as resolveWhatsAppGroupRequireMention, i as whatsappSetupWizardProxy, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint, t as whatsappSetupAdapter } from "./setup-core-DLXi32yR.js";
+import { a as resolveWhatsAppGroupRequireMention, i as whatsappSetupWizardProxy, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint, t as whatsappSetupAdapter } from "./setup-core-B4mgubMj.js";
 import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-D_BmQUR9.js";
 //#region extensions/whatsapp/src/channel.setup.ts
 async function isWhatsAppAuthConfigured(account) {

package/dist/{monitor-CFUAZhBS.js → monitor-CmA9YhPe.js}

@@ -9,7 +9,7 @@ import { c as logoutWeb, g as readWebSelfId, o as getWebAuthAgeMs, r as WhatsApp
 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-xoLLdqEv.js";
 import { n as resolveWhatsAppGroupsConfigPath } from "./group-config-path-BGyzT9Lg.js";
 import { i as resolveWhatsAppInboundPolicy, r as resolveWhatsAppCommandAuthorized, t as checkInboundAccessControl } from "./access-control-C53zKYSN.js";
-import { a as mayContainWhatsAppOutboundMention, c as describeReplyContext, d as extractLocationData, f as extractMediaPlaceholder, h as hasInboundUserContent, i as addWhatsAppOutboundMentionsToContent, l as extractContactContext, m as extractText, n as listWhatsAppSendResultMessageIds, o as resolveWhatsAppOutboundMentions, p as extractMentionedJids, r as normalizeWhatsAppSendResult, s as addWhatsAppImagePreviewFields, t as createWebSendApi, u as extractContextInfo } from "./send-api-Bjn-h80j.js";
+import { _ as extractMediaPlaceholder, a as mayContainWhatsAppOutboundMention, b as hasInboundUserContent, c as DisconnectReason, d as normalizeMessageContent, f as resolveInboundMediaMimetype, g as extractLocationData, 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 extractMentionedJids, y as extractText } from "./send-api-CFbAgIbn.js";
 import { a as resolveWhatsAppSocketTiming, r as waitForWaConnection, t as createWaSocket } from "./session-CoxlXm2K.js";
 import { t as BufferJSON } from "./session.runtime-CyooSQvj.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-BnRkIjlP.js";
@@ -30,8 +30,8 @@ import { DEFAULT_ACCOUNT_ID as DEFAULT_ACCOUNT_ID$1, DEFAULT_MAIN_KEY, buildAgen
 import { asDateTimestampMs, parseStrictFiniteNumber, resolveExpiresAtMsFromDurationMs } from "openclaw/plugin-sdk/number-runtime";
 import { recordInboundSession } from "openclaw/plugin-sdk/conversation-runtime";
 import { loadSessionStore, resolveStorePath, updateLastRoute, updateSessionStore } from "openclaw/plugin-sdk/session-store-runtime";
-import { DisconnectReason, downloadMediaMessage, isJidGroup, normalizeMessageContent as normalizeMessageContent$1 } from "baileys";
 import { buildChannelInboundEventContext, filterChannelInboundQuoteContext, formatInboundEnvelope, formatInboundEnvelope as formatInboundEnvelope$1, formatLocationText, hasVisibleInboundReplyDispatch, resolveInboundSessionEnvelopeContext, runChannelInboundEvent, toInboundMediaFacts, toLocationContext } from "openclaw/plugin-sdk/channel-inbound";
+import { saveMediaStream } from "openclaw/plugin-sdk/media-store";
 import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
 import { createHash } from "node:crypto";
 import { dispatchReplyWithBufferedBlockDispatcher, finalizeInboundContext, resolveChunkMode, resolveTextChunkLimit } from "openclaw/plugin-sdk/reply-runtime";
@@ -43,7 +43,6 @@ import { drainPendingDeliveries } from "openclaw/plugin-sdk/delivery-queue-runti
 import { DEFAULT_GROUP_HISTORY_LIMIT, buildHistoryContextFromEntries, buildInboundHistoryFromEntries, createChannelHistoryWindow } from "openclaw/plugin-sdk/reply-history";
 import { enqueueSystemEvent } from "openclaw/plugin-sdk/system-event-runtime";
 import { createClaimableDedupe } from "openclaw/plugin-sdk/persistent-dedupe";
-import { saveMediaStream } from "openclaw/plugin-sdk/media-store";
 import { getRuntimeConfig as getRuntimeConfig$1, getRuntimeConfigSourceSnapshot } 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";
@@ -204,24 +203,12 @@ var WhatsAppInboundMediaLimitExceededError = class extends Error {
 	}
 };
 function unwrapMessage(message) {
-	return normalizeMessageContent$1(message);
-}
-/**
-* Resolve the MIME type for an inbound media message.
-* Falls back to WhatsApp's standard formats when Baileys omits the MIME.
-*/
-function resolveMediaMimetype(message) {
-	const explicit = message.imageMessage?.mimetype ?? message.videoMessage?.mimetype ?? message.documentMessage?.mimetype ?? message.audioMessage?.mimetype ?? message.stickerMessage?.mimetype ?? void 0;
-	if (explicit) return explicit;
-	if (message.audioMessage) return "audio/ogg; codecs=opus";
-	if (message.imageMessage) return "image/jpeg";
-	if (message.videoMessage) return "video/mp4";
-	if (message.stickerMessage) return "image/webp";
+	return normalizeMessageContent(message);
 }
 async function downloadInboundMedia(msg, sock, maxBytes = 50 * 1024 * 1024) {
 	const message = unwrapMessage(msg.message);
 	if (!message) return;
-	const mimetype = resolveMediaMimetype(message);
+	const mimetype = resolveInboundMediaMimetype(message);
 	const fileName = message.documentMessage?.fileName ?? void 0;
 	if (!message.imageMessage && !message.videoMessage && !message.documentMessage && !message.audioMessage && !message.stickerMessage) return;
 	try {
@@ -958,6 +945,19 @@ async function attachWebInboxToSocket(options) {
 			logWhatsAppVerbose(options.verbose, `Failed to hydrate participating groups on connect: ${error}`);
 		}
 	})();
+	const sendApi = createWebSendApi({
+		sock: {
+			sendMessage: (jid, content, optionsLocal) => sendTrackedMessage(jid, content, optionsLocal),
+			sendPresenceUpdate: async (presenceLocal, jid) => {
+				const currentSock = getCurrentSock();
+				if (!currentSock) throw new Error(RECONNECT_IN_PROGRESS_ERROR);
+				return currentSock.sendPresenceUpdate(presenceLocal, jid);
+			}
+		},
+		defaultAccountId: options.accountId,
+		resolveOutboundMentions: ({ jid, text }) => resolveOutboundMentionsForGroup(jid, text),
+		authDir: options.authDir
+	});
 	return {
 		close: async () => {
 			try {
@@ -981,19 +981,10 @@ async function attachWebInboxToSocket(options) {
 				error: "closed"
 			});
 		},
-		...createWebSendApi({
-			sock: {
-				sendMessage: (jid, content, optionsLocal) => sendTrackedMessage(jid, content, optionsLocal),
-				sendPresenceUpdate: async (presenceLocal, jid) => {
-					const currentSock = getCurrentSock();
-					if (!currentSock) throw new Error(RECONNECT_IN_PROGRESS_ERROR);
-					return currentSock.sendPresenceUpdate(presenceLocal, jid);
-				}
-			},
-			defaultAccountId: options.accountId,
-			resolveOutboundMentions: ({ jid, text }) => resolveOutboundMentionsForGroup(jid, text),
-			authDir: options.authDir
-		})
+		sendComposingTo: sendApi.sendComposingTo,
+		sendMessage: sendApi.sendMessage,
+		sendPoll: sendApi.sendPoll,
+		sendReaction: sendApi.sendReaction
 	};
 }
 async function monitorWebInbox(options) {

package/dist/runtime-api.js

@@ -7,10 +7,10 @@ import { startWebLoginWithQr, waitForWebLogin } from "./login-qr-runtime.js";
 import { t as createWhatsAppLoginTool } from "./agent-tools-login-BX7eHgDm.js";
 import { C as waitForCredsSaveQueue, T as writeCredsJsonAtomically, _ as readWebSelfIdentity, a as formatWhatsAppWebAuthStatusState, b as restoreCredsFromBackupIfNeeded, c as logoutWeb, d as readWebAuthExistsBestEffort, f as readWebAuthExistsForDecision, g as readWebSelfId, h as readWebAuthState, l as pickWebChannel, m as readWebAuthSnapshotBestEffort, n as WHATSAPP_AUTH_UNSTABLE_CODE, o as getWebAuthAgeMs, p as readWebAuthSnapshot, r as WhatsAppAuthUnstableError, s as logWebSelfId, t as WA_WEB_AUTH_DIR, u as readCredsJsonRaw, v as readWebSelfIdentityForDecision, w as waitForCredsSaveQueueWithTimeout, x as webAuthExists, y as resolveDefaultWebAuthDir } from "./auth-store-B2ZibndQ.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-HU41RHGI.js";
-import { d as extractLocationData, f as extractMediaPlaceholder, l as extractContactContext, m as extractText } from "./send-api-Bjn-h80j.js";
+import { _ as extractMediaPlaceholder, g as extractLocationData, m as extractContactContext, y as extractText } from "./send-api-CFbAgIbn.js";
 import { n as newConnectionId, r as waitForWaConnection, t as createWaSocket } from "./session-CoxlXm2K.js";
 import { n as resolveWebAccountId, t as getActiveWebListener } from "./active-listener-CFwkn3ho.js";
-import { a as loadWebMediaRaw, c as monitorWebInbox, i as loadWebMedia, l as resetWebInboundDedupe, n as LocalMediaAccessError, o as optimizeImageToJpeg, r as getDefaultLocalRoots, s as optimizeImageToPng, t as monitorWebChannel } from "./monitor-CFUAZhBS.js";
+import { a as loadWebMediaRaw, c as monitorWebInbox, i as loadWebMedia, l as resetWebInboundDedupe, n as LocalMediaAccessError, o as optimizeImageToJpeg, r as getDefaultLocalRoots, s as optimizeImageToPng, t as monitorWebChannel } from "./monitor-CmA9YhPe.js";
 import { t as loginWeb } from "./login-Bflq347x.js";
 import { HEARTBEAT_PROMPT, HEARTBEAT_TOKEN, SILENT_REPLY_TOKEN, stripHeartbeatToken } from "openclaw/plugin-sdk/reply-runtime";
 export { DEFAULT_WEB_MEDIA_BYTES, HEARTBEAT_PROMPT, HEARTBEAT_TOKEN, LocalMediaAccessError, SILENT_REPLY_TOKEN, WA_WEB_AUTH_DIR, WHATSAPP_AUTH_UNSTABLE_CODE, WhatsAppAuthUnstableError, createWaSocket, createWhatsAppLoginTool, extractContactContext, extractLocationData, extractMediaPlaceholder, extractText, formatError, formatWhatsAppWebAuthStatusState, getActiveWebListener, getDefaultLocalRoots, getStatusCode, getWebAuthAgeMs, handleWhatsAppAction, hasWebCredsSync, loadWebMedia, loadWebMediaRaw, logWebSelfId, loginWeb, logoutWeb, monitorWebChannel, monitorWebInbox, newConnectionId, optimizeImageToJpeg, optimizeImageToPng, pickWebChannel, readCredsJsonRaw, readWebAuthExistsBestEffort, readWebAuthExistsForDecision, readWebAuthSnapshot, readWebAuthSnapshotBestEffort, readWebAuthState, readWebSelfId, readWebSelfIdentity, readWebSelfIdentityForDecision, resetWebInboundDedupe, resolveDefaultWebAuthDir, resolveWebAccountId, resolveWebCredsBackupPath, resolveWebCredsPath, restoreCredsFromBackupIfNeeded, sendMessageWhatsApp, sendPollWhatsApp, sendReactionWhatsApp, sendTypingWhatsApp, setWhatsAppRuntime, startWebLoginWithQr, stripHeartbeatToken, waitForCredsSaveQueue, waitForCredsSaveQueueWithTimeout, waitForWaConnection, waitForWebLogin, webAuthExists, whatsAppActionRuntime, writeCredsJsonAtomically };

package/dist/{send-api-Bjn-h80j.js → send-api-CFbAgIbn.js}

@@ -8,8 +8,9 @@ import { normalizeLowercaseStringOrEmpty, normalizeStringEntries, uniqueStrings
 import { createMessageReceiptFromOutboundResults, listMessageReceiptPlatformIds } from "openclaw/plugin-sdk/channel-outbound";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
 import { getImageMetadata, resizeToJpeg } from "openclaw/plugin-sdk/media-runtime";
-import { extractMessageContent, getContentType, normalizeMessageContent } from "baileys";
 import { formatLocationText } from "openclaw/plugin-sdk/channel-inbound";
+import { DisconnectReason, downloadMediaMessage, extractMessageContent, getContentType, isJidGroup, normalizeMessageContent, normalizeMessageContent as normalizeMessageContent$1 } from "baileys";
+import "openclaw/plugin-sdk/media-store";
 import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
 //#region extensions/whatsapp/src/vcard.ts
 const ALLOWED_VCARD_KEYS = new Set([
@@ -364,6 +365,20 @@ function hasInboundUserContent(rawMessage) {
 	return false;
 }
 //#endregion
+//#region extensions/whatsapp/src/inbound/media-mimetype.ts
+/**
+* Resolve the MIME type for an inbound media message.
+* Falls back to WhatsApp's standard formats when Baileys omits the MIME.
+*/
+function resolveInboundMediaMimetype(message) {
+	const explicit = message.imageMessage?.mimetype ?? message.videoMessage?.mimetype ?? message.documentMessage?.mimetype ?? message.audioMessage?.mimetype ?? message.stickerMessage?.mimetype ?? void 0;
+	if (explicit) return explicit;
+	if (message.audioMessage) return "audio/ogg; codecs=opus";
+	if (message.imageMessage) return "image/jpeg";
+	if (message.videoMessage) return "video/mp4";
+	if (message.stickerMessage) return "image/webp";
+}
+//#endregion
 //#region extensions/whatsapp/src/image-preview.ts
 const WHATSAPP_IMAGE_THUMBNAIL_SIDE = 32;
 const WHATSAPP_IMAGE_THUMBNAIL_QUALITY = 50;
@@ -644,6 +659,12 @@ function createWebSendApi(params) {
 		text,
 		mentionedJids: []
 	};
+	const sendStructuredMessage = async (to, content, kind) => {
+		const jid = resolveOutboundJid(to);
+		const result = await params.sock.sendMessage(jid, content);
+		recordWhatsAppOutbound(params.defaultAccountId);
+		return normalizeWhatsAppSendResult(result, kind);
+	};
 	return {
 		sendMessage: async (to, text, mediaBuffer, mediaTypeInput, sendOptions) => {
 			let mediaType = mediaTypeInput;
@@ -711,14 +732,34 @@ function createWebSendApi(params) {
 			return combineWhatsAppSendResults(mediaBuffer ? "media" : "text", results);
 		},
 		sendPoll: async (to, poll) => {
-			const jid = resolveOutboundJid(to);
-			const result = await params.sock.sendMessage(jid, { poll: {
+			return await sendStructuredMessage(to, { poll: {
 				name: poll.question,
 				values: poll.options,
 				selectableCount: poll.maxSelections ?? 1
-			} });
-			recordWhatsAppOutbound(params.defaultAccountId);
-			return normalizeWhatsAppSendResult(result, "poll");
+			} }, "poll");
+		},
+		sendContact: async (to, contact) => {
+			return await sendStructuredMessage(to, { contacts: {
+				displayName: contact.displayName,
+				contacts: [{
+					displayName: contact.displayName,
+					vcard: contact.vcard
+				}]
+			} }, "contact");
+		},
+		sendLocation: async (to, location) => {
+			return await sendStructuredMessage(to, { location: {
+				degreesLatitude: location.degreesLatitude,
+				degreesLongitude: location.degreesLongitude,
+				name: location.name,
+				address: location.address
+			} }, "location");
+		},
+		sendSticker: async (to, stickerBuffer, options) => {
+			return await sendStructuredMessage(to, {
+				sticker: stickerBuffer,
+				mimetype: options?.mimetype ?? "image/webp"
+			}, "sticker");
 		},
 		sendReaction: async (chatJid, messageId, emoji, fromMe, participant) => {
 			const jid = resolveOutboundJid(chatJid);
@@ -740,4 +781,4 @@ function createWebSendApi(params) {
 	};
 }
 //#endregion
-export { mayContainWhatsAppOutboundMention as a, describeReplyContext as c, extractLocationData as d, extractMediaPlaceholder as f, hasInboundUserContent as h, addWhatsAppOutboundMentionsToContent as i, extractContactContext as l, extractText as m, listWhatsAppSendResultMessageIds as n, resolveWhatsAppOutboundMentions as o, extractMentionedJids as p, normalizeWhatsAppSendResult as r, addWhatsAppImagePreviewFields as s, createWebSendApi as t, extractContextInfo as u };
+export { extractMediaPlaceholder as _, mayContainWhatsAppOutboundMention as a, hasInboundUserContent as b, DisconnectReason as c, normalizeMessageContent$1 as d, resolveInboundMediaMimetype as f, extractLocationData as g, extractContextInfo as h, addWhatsAppOutboundMentionsToContent as i, downloadMediaMessage as l, extractContactContext as m, listWhatsAppSendResultMessageIds as n, resolveWhatsAppOutboundMentions as o, describeReplyContext as p, normalizeWhatsAppSendResult as r, addWhatsAppImagePreviewFields as s, createWebSendApi as t, isJidGroup as u, extractMentionedJids as v, extractText as y };

package/dist/{setup-core-DLXi32yR.js → setup-core-B4mgubMj.js}

@@ -99,10 +99,10 @@ async function applyWhatsAppSecurityConfigFixes(params) {
 //#region extensions/whatsapp/src/shared.ts
 const WHATSAPP_CHANNEL = "whatsapp";
 async function loadWhatsAppChannelRuntime() {
-	return await import("./channel.runtime-DIAo-4Bj.js");
+	return await import("./channel.runtime-B534_h4x.js");
 }
 async function loadWhatsAppSetupSurface() {
-	return await import("./setup-surface-YtBXJFy0.js");
+	return await import("./setup-surface-DaWJR5kG.js");
 }
 const whatsappSetupWizardProxy = createWhatsAppSetupWizardProxy(async () => (await loadWhatsAppSetupSurface()).whatsappSetupWizard);
 const whatsappConfigAdapter = createScopedChannelConfigAdapter({

package/dist/{setup-finalize-B-g0GzHp.js → setup-finalize-B2EnzoZx.js}

@@ -2,7 +2,7 @@ import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-CB5SOWjc.js"
 import { r as hasWebCredsSync } from "./creds-files-B1kSWtBg.js";
 import { a as resolveWhatsAppAccount, o as resolveWhatsAppAuthDir } from "./accounts-DgViSyJx.js";
 import { a as normalizeWhatsAppAllowFromEntries, o as normalizeWhatsAppAllowFromEntry } from "./normalize-target-bVWjgftN.js";
-import { t as whatsappSetupAdapter } from "./setup-core-DLXi32yR.js";
+import { t as whatsappSetupAdapter } from "./setup-core-B4mgubMj.js";
 import { DEFAULT_ACCOUNT_ID, createSetupTranslator, splitSetupEntries } from "openclaw/plugin-sdk/setup";
 import { formatCliCommand, formatDocsLink } from "openclaw/plugin-sdk/setup-tools";
 //#region extensions/whatsapp/src/setup-finalize.ts

package/dist/setup-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as whatsappSetupPlugin } from "./channel.setup-I-zFGu02.js";
+import { t as whatsappSetupPlugin } from "./channel.setup-D5dt8amX.js";
 export { whatsappSetupPlugin };

package/dist/{setup-surface-YtBXJFy0.js → setup-surface-DaWJR5kG.js}

@@ -36,7 +36,7 @@ const whatsappSetupWizard = {
 	},
 	resolveShouldPromptAccountIds: ({ shouldPromptAccountIds }) => shouldPromptAccountIds,
 	credentials: [],
-	finalize: async (params) => await (await import("./setup-finalize-B-g0GzHp.js")).finalizeWhatsAppSetup(params),
+	finalize: async (params) => await (await import("./setup-finalize-B2EnzoZx.js")).finalizeWhatsAppSetup(params),
 	disable: (cfg) => setSetupChannelEnabled(cfg, channel, false),
 	onAccountRecorded: (accountId, options) => {
 		options?.onAccountId?.(channel, accountId);

package/npm-shrinkwrap.json

@@ -1,19 +1,19 @@
 {
   "name": "@openclaw/whatsapp",
-  "version": "2026.6.5-beta.2",
+  "version": "2026.6.5-beta.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/whatsapp",
-      "version": "2026.6.5-beta.2",
+      "version": "2026.6.5-beta.3",
       "dependencies": {
         "audio-decode": "2.2.3",
         "baileys": "7.0.0-rc13",
         "typebox": "1.1.39"
       },
       "peerDependencies": {
-        "openclaw": ">=2026.6.5-beta.2"
+        "openclaw": ">=2026.6.5-beta.3"
       },
       "peerDependenciesMeta": {
         "openclaw": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/whatsapp",
-  "version": "2026.6.5-beta.2",
+  "version": "2026.6.5-beta.3",
   "description": "OpenClaw WhatsApp channel plugin for WhatsApp Web chats.",
   "repository": {
     "type": "git",
@@ -13,7 +13,7 @@
     "typebox": "1.1.39"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.6.5-beta.2"
+    "openclaw": ">=2026.6.5-beta.3"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -56,10 +56,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.6.5-beta.2"
+      "pluginApi": ">=2026.6.5-beta.3"
     },
     "build": {
-      "openclawVersion": "2026.6.5-beta.2"
+      "openclawVersion": "2026.6.5-beta.3"
     },
     "release": {
       "publishToClawHub": true,