@openclaw/whatsapp 2026.7.2-beta.7 → 2026.8.1-beta.3

package/dist/{send-api-7wk6eQyW.js → send-api-obOSm2cC.js}

@@ -1,17 +1,15 @@
 import { n as isWhatsAppNewsletterJid } from "./normalize-target-CugRyONv.js";
-import { l as resolveWhatsAppDocumentFileName } from "./send-D37ddk22.js";
+import { _ as resolveWhatsAppDocumentFileName, f as mergeWhatsAppAcceptedSendError, m as rememberWhatsAppAcceptedSend, p as normalizeWhatsAppSendResult, u as combineWhatsAppSendResults } from "./send-CwvTU4RI.js";
 import "./normalize-C7Hkc_vE.js";
 import { c as toWhatsappJid, l as toWhatsappJidWithLid, r as jidToE164 } from "./targets-runtime-TMk0lGuy.js";
 import "./text-runtime-CaKLhowd.js";
-import { i as buildQuotedMessageOptions } from "./group-session-key-DVMZlO3x.js";
-import { c as resolveComparableIdentity } from "./identity-CPrT5aEU.js";
-import { normalizeLowercaseStringOrEmpty, normalizeStringEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { i as buildQuotedMessageOptions } from "./group-session-key-DmFc_Cqi.js";
+import { k as resolveComparableIdentity } from "./auth-store-CtpBqH5S.js";
+import { isRecord, normalizeLowercaseStringOrEmpty, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
-import { createMessageReceiptFromOutboundResults, listMessageReceiptPlatformIds } from "openclaw/plugin-sdk/channel-outbound";
-import { getImageMetadata, resizeToJpeg } from "openclaw/plugin-sdk/media-runtime";
 import { formatLocationText } from "openclaw/plugin-sdk/channel-inbound";
-import { DisconnectReason, downloadMediaMessage, extractMessageContent, getContentType, isJidGroup, normalizeMessageContent, normalizeMessageContent as normalizeMessageContent$1 } from "baileys";
-import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
+import { getImageMetadata, resizeToJpeg } from "openclaw/plugin-sdk/media-runtime";
+import { extractMessageContent, getContentType, normalizeMessageContent } from "baileys";
 //#region extensions/whatsapp/src/vcard.ts
 const ALLOWED_VCARD_KEYS = /* @__PURE__ */ new Set([
 	"FN",
@@ -79,11 +77,11 @@ function normalizeVcardPhone(value) {
 * 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;
+	const explicit = message.imageMessage?.mimetype ?? message.videoMessage?.mimetype ?? message.ptvMessage?.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.videoMessage || message.ptvMessage) return "video/mp4";
 	if (message.stickerMessage) return "image/webp";
 }
 //#endregion
@@ -99,7 +97,7 @@ function getFutureProofInnerMessage(message) {
 		}
 	}
 }
-function buildMessageChain(message) {
+function projectWhatsAppInboundMessage(message) {
 	const chain = [];
 	let current = normalizeMessageContent(message);
 	while (current && chain.length < 4) {
@@ -108,8 +106,24 @@ function buildMessageChain(message) {
 	}
 	return chain;
 }
+function isWhatsAppInboundMessageProjection(message) {
+	return Array.isArray(message);
+}
+function resolveWhatsAppInboundMessageProjection(message) {
+	return isWhatsAppInboundMessageProjection(message) ? message : projectWhatsAppInboundMessage(message);
+}
+function findMessageSection(rawMessage, sectionNames) {
+	const chain = projectWhatsAppInboundMessage(rawMessage);
+	for (const name of sectionNames) for (const message of chain) {
+		const value = message[name];
+		if (isRecord(value)) return {
+			name,
+			value
+		};
+	}
+}
 function unwrapMessage(message) {
-	return buildMessageChain(message).at(-1);
+	return resolveWhatsAppInboundMessageProjection(message).at(-1);
 }
 function extractContextInfoFromMessage(message) {
 	const contentType = getContentType(message);
@@ -134,29 +148,30 @@ function extractContextInfoFromMessage(message) {
 	}
 }
 function extractContextInfo(message) {
-	for (const candidate of buildMessageChain(message)) {
+	for (const candidate of resolveWhatsAppInboundMessageProjection(message)) {
 		const contextInfo = extractContextInfoFromMessage(candidate);
 		if (contextInfo) return contextInfo;
 	}
 }
-function extractMentionedJids(rawMessage) {
-	const message = unwrapMessage(rawMessage);
-	if (!message) return;
-	const flattened = [
-		message.extendedTextMessage?.contextInfo?.mentionedJid,
-		message.imageMessage?.contextInfo?.mentionedJid,
-		message.videoMessage?.contextInfo?.mentionedJid,
-		message.documentMessage?.contextInfo?.mentionedJid,
-		message.audioMessage?.contextInfo?.mentionedJid,
-		message.stickerMessage?.contextInfo?.mentionedJid,
-		message.buttonsResponseMessage?.contextInfo?.mentionedJid,
-		message.listResponseMessage?.contextInfo?.mentionedJid
-	].flatMap((arr) => arr ?? []).filter(Boolean);
-	if (flattened.length === 0) return;
-	return uniqueStrings(flattened);
-}
-function extractText(rawMessage) {
-	const message = unwrapMessage(rawMessage);
+function extractMentionedJids(message) {
+	const mentionedJids = extractContextInfo(message)?.mentionedJid?.filter(Boolean);
+	if (!mentionedJids?.length) return;
+	return uniqueStrings(mentionedJids);
+}
+function extractNativeFlowResponseText(response) {
+	const paramsJson = response?.nativeFlowResponseMessage?.paramsJson;
+	if (!paramsJson) return;
+	try {
+		const params = JSON.parse(paramsJson);
+		if (!isRecord(params)) return;
+		return [params.title, params.id].find((value) => typeof value === "string" && Boolean(value.trim()));
+	} catch {
+		return;
+	}
+}
+function extractText(source) {
+	const projection = resolveWhatsAppInboundMessageProjection(source);
+	const message = unwrapMessage(projection);
 	if (!message) return;
 	const extracted = extractMessageContent(message);
 	const candidates = [message, extracted && extracted !== message ? extracted : void 0];
@@ -165,14 +180,30 @@ function extractText(rawMessage) {
 		if (typeof candidate.conversation === "string" && candidate.conversation.trim()) return candidate.conversation.trim();
 		const extended = candidate.extendedTextMessage?.text;
 		if (extended?.trim()) return extended.trim();
-		const caption = candidate.imageMessage?.caption ?? candidate.videoMessage?.caption ?? candidate.documentMessage?.caption;
+		const caption = candidate.imageMessage?.caption ?? candidate.videoMessage?.caption ?? candidate.ptvMessage?.caption ?? candidate.documentMessage?.caption;
 		if (caption?.trim()) return caption.trim();
+		const interactiveSelection = [
+			candidate.buttonsResponseMessage?.selectedDisplayText,
+			candidate.buttonsResponseMessage?.selectedButtonId,
+			candidate.listResponseMessage?.title,
+			candidate.listResponseMessage?.singleSelectReply?.selectedRowId,
+			candidate.templateButtonReplyMessage?.selectedDisplayText,
+			candidate.templateButtonReplyMessage?.selectedId,
+			candidate.interactiveResponseMessage?.body?.text,
+			extractNativeFlowResponseText(candidate.interactiveResponseMessage)
+		].find((value) => Boolean(value?.trim()));
+		if (interactiveSelection) return interactiveSelection.trim();
+		const poll = candidate.pollCreationMessage ?? candidate.pollCreationMessageV2 ?? candidate.pollCreationMessageV3 ?? candidate.pollCreationMessageV5;
+		if (poll) {
+			const pollText = [poll.name?.trim(), ...(poll.options ?? []).map((option) => option.optionName?.trim()).filter((option) => Boolean(option)).map((option) => `- ${option}`)].filter(Boolean).join("\n");
+			if (pollText) return pollText;
+		}
 	}
-	const contactPlaceholder = extractContactPlaceholder(message) ?? (extracted && extracted !== message ? extractContactPlaceholder(extracted) : void 0);
+	const contactPlaceholder = extractContactPlaceholder(projection) ?? (extracted && extracted !== message ? extractContactPlaceholder(extracted) : void 0);
 	if (contactPlaceholder) return contactPlaceholder;
 }
-function extractExternalAdReplyContext(rawMessage) {
-	const message = unwrapMessage(rawMessage);
+function extractExternalAdReplyContext(source) {
+	const message = unwrapMessage(source);
 	const adReply = message?.imageMessage?.contextInfo?.externalAdReply ?? message?.videoMessage?.contextInfo?.externalAdReply;
 	if (!adReply) return;
 	const title = adReply.title?.trim() || void 0;
@@ -184,24 +215,24 @@ function extractExternalAdReplyContext(rawMessage) {
 		body
 	} : void 0;
 }
-function extractMediaKind(rawMessage) {
-	const message = unwrapMessage(rawMessage);
+function extractMediaKind(source) {
+	const message = unwrapMessage(source);
 	if (!message) return;
 	if (message.imageMessage) return "image";
-	if (message.videoMessage) return "video";
+	if (message.videoMessage || message.ptvMessage) return "video";
 	if (message.audioMessage) return "audio";
 	if (message.documentMessage) return "document";
 	if (message.stickerMessage) return "sticker";
 }
-function extractContactPlaceholder(rawMessage) {
-	const contactContext = extractContactContext(rawMessage);
+function extractContactPlaceholder(source) {
+	const contactContext = extractContactContext(source);
 	if (!contactContext) return;
 	if (contactContext.kind === "contact") return "<contact>";
 	const suffix = contactContext.total === 1 ? "contact" : "contacts";
 	return `<contacts: ${contactContext.total} ${suffix}>`;
 }
-function extractContactContext(rawMessage) {
-	const message = unwrapMessage(rawMessage);
+function extractContactContext(source) {
+	const message = unwrapMessage(source);
 	if (!message) return;
 	const contact = message.contactMessage ?? void 0;
 	if (contact) {
@@ -237,8 +268,8 @@ function describeContact(input) {
 		phones: parsed.phones
 	};
 }
-function extractLocationData(rawMessage) {
-	const message = unwrapMessage(rawMessage);
+function extractLocationData(source) {
+	const message = unwrapMessage(source);
 	if (!message) return null;
 	const live = message.liveLocationMessage ?? void 0;
 	if (live) {
@@ -281,10 +312,11 @@ function extractLocationData(rawMessage) {
 	}
 	return null;
 }
-function describeReplyContext(rawMessage) {
-	const message = unwrapMessage(rawMessage);
+function describeReplyContext(source) {
+	const projection = resolveWhatsAppInboundMessageProjection(source);
+	const message = unwrapMessage(projection);
 	if (!message) return null;
-	const contextInfo = extractContextInfo(message);
+	const contextInfo = extractContextInfo(projection.length === 1 && projection[0] === message ? projection : projectWhatsAppInboundMessage(message));
 	const quoted = normalizeMessageContent(contextInfo?.quotedMessage);
 	if (!quoted && !contextInfo?.stanzaId) return null;
 	const senderJid = contextInfo?.participant ?? void 0;
@@ -297,10 +329,11 @@ function describeReplyContext(rawMessage) {
 		body: "[quoted message unavailable]",
 		sender
 	};
-	const location = extractLocationData(quoted);
+	const quotedProjection = projectWhatsAppInboundMessage(quoted);
+	const location = extractLocationData(quotedProjection);
 	const locationText = location ? formatLocationText(location) : void 0;
-	const body = [extractText(quoted), locationText].filter(Boolean).join("\n").trim();
-	const mediaKind = extractMediaKind(quoted);
+	const body = [extractText(quotedProjection), locationText].filter(Boolean).join("\n").trim();
+	const mediaKind = extractMediaKind(quotedProjection);
 	const media = mediaKind ? {
 		kind: mediaKind,
 		contentType: resolveInboundMediaMimetype(quoted)
@@ -328,12 +361,13 @@ function hasInteractiveResponseContent(message) {
 * `messages.upsert` stream as real messages but should not trigger pairing
 * access-control side effects.
 */
-function hasInboundUserContent(rawMessage) {
-	if (!rawMessage) return false;
-	if (extractText(rawMessage)) return true;
-	if (extractMediaKind(rawMessage)) return true;
-	if (extractLocationData(rawMessage)) return true;
-	for (const candidate of buildMessageChain(rawMessage)) if (hasInteractiveResponseContent(candidate)) return true;
+function hasInboundUserContent(source) {
+	const projection = resolveWhatsAppInboundMessageProjection(source);
+	if (projection.length === 0) return false;
+	if (extractText(projection)) return true;
+	if (extractMediaKind(projection)) return true;
+	if (extractLocationData(projection)) return true;
+	for (const candidate of projection) if (hasInteractiveResponseContent(candidate)) return true;
 	return false;
 }
 //#endregion
@@ -542,75 +576,7 @@ function addWhatsAppOutboundMentionsToContent(content, mentionedJids) {
 	} : content;
 }
 //#endregion
-//#region extensions/whatsapp/src/inbound/send-result.ts
-function resolveWhatsAppReceiptKind(kind) {
-	if (kind === "media" || kind === "text") return kind;
-	return "unknown";
-}
-function toReceiptSourceResult(key) {
-	return {
-		channel: "whatsapp",
-		messageId: key.id,
-		...key.remoteJid ? { toJid: key.remoteJid } : {},
-		meta: {
-			fromMe: key.fromMe,
-			participant: key.participant
-		}
-	};
-}
-function createWhatsAppSendReceipt(kind, keys) {
-	return createMessageReceiptFromOutboundResults({
-		kind: resolveWhatsAppReceiptKind(kind),
-		results: keys.map(toReceiptSourceResult)
-	});
-}
-function normalizeKey(key) {
-	const id = typeof key?.id === "string" ? key.id.trim() : "";
-	if (!id) return;
-	return {
-		id,
-		remoteJid: key?.remoteJid,
-		fromMe: key?.fromMe,
-		participant: key?.participant
-	};
-}
-function normalizeWhatsAppSendResult(result, kind) {
-	const key = normalizeKey(result?.key);
-	return {
-		kind,
-		messageId: key?.id ?? "unknown",
-		receipt: createWhatsAppSendReceipt(kind, key ? [key] : []),
-		keys: key ? [key] : [],
-		providerAccepted: Boolean(key)
-	};
-}
-function combineWhatsAppSendResults(kind, results) {
-	const messageIds = uniqueStrings(results.flatMap(listWhatsAppSendResultMessageIds));
-	const keys = results.flatMap((result) => result.keys);
-	return {
-		kind,
-		messageId: messageIds[0] ?? "unknown",
-		receipt: createWhatsAppSendReceipt(kind, keys),
-		keys,
-		providerAccepted: results.some((result) => result.providerAccepted)
-	};
-}
-function listWhatsAppSendResultMessageIds(result) {
-	const receiptIds = result.receipt ? listMessageReceiptPlatformIds(result.receipt) : [];
-	if (receiptIds.length > 0) return receiptIds;
-	const keyIds = normalizeStringEntries(result.keys.map((key) => key.id));
-	if (keyIds.length > 0) return uniqueStrings(keyIds);
-	return [];
-}
-//#endregion
 //#region extensions/whatsapp/src/inbound/send-api.ts
-function recordWhatsAppOutbound(accountId) {
-	recordChannelActivity({
-		channel: "whatsapp",
-		accountId,
-		direction: "outbound"
-	});
-}
 function supportsForcedDocumentMediaType(mediaType) {
 	return mediaType.startsWith("image/") || mediaType.startsWith("video/");
 }
@@ -623,11 +589,30 @@ function createWebSendApi(params) {
 		text,
 		mentionedJids: []
 	};
+	const runAcceptedSend = async (kind, accountId, send) => {
+		const results = [];
+		try {
+			await send((result, sendKind) => {
+				rememberWhatsAppAcceptedSend({
+					accountId,
+					result: normalizeWhatsAppSendResult(result, sendKind),
+					results
+				});
+			});
+			return combineWhatsAppSendResults(kind, results);
+		} catch (error) {
+			throw mergeWhatsAppAcceptedSendError({
+				error,
+				kind,
+				results
+			});
+		}
+	};
 	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 await runAcceptedSend(kind, params.defaultAccountId, async (capture) => {
+			capture(await params.sock.sendMessage(jid, content), kind);
+		});
 	};
 	return {
 		sendMessage: async (to, text, mediaBuffer, mediaTypeInput, sendOptions) => {
@@ -683,18 +668,22 @@ function createWebSendApi(params) {
 				remoteJid: sendOptions?.quotedMessageKey?.remoteJid,
 				fromMe: sendOptions?.quotedMessageKey?.fromMe,
 				participant: sendOptions?.quotedMessageKey?.participant,
+				destinationJid: jid,
+				requestedJid: toWhatsappJid(to),
+				lookupTargetJid: sendOptions?.quotedMessageKey?.lookupTargetJid,
 				messageText: sendOptions?.quotedMessageKey?.messageText,
 				media: sendOptions?.quotedMessageKey?.media
 			});
-			const results = [normalizeWhatsAppSendResult(quotedOpts ? await params.sock.sendMessage(jid, payload, quotedOpts) : await params.sock.sendMessage(jid, payload), mediaBuffer ? "media" : "text")];
-			if (shouldSendAudioText) {
-				const resolvedAudioText = await resolveMentions(jid, text);
-				const textPayload = addWhatsAppOutboundMentionsToContent({ text: resolvedAudioText.text }, resolvedAudioText.mentionedJids);
-				const textResult = quotedOpts ? await params.sock.sendMessage(jid, textPayload, quotedOpts) : await params.sock.sendMessage(jid, textPayload);
-				results.push(normalizeWhatsAppSendResult(textResult, "text"));
-			}
-			recordWhatsAppOutbound(sendOptions?.accountId ?? params.defaultAccountId);
-			return combineWhatsAppSendResults(mediaBuffer ? "media" : "text", results);
+			const kind = mediaBuffer ? "media" : "text";
+			const accountId = sendOptions?.accountId ?? params.defaultAccountId;
+			return await runAcceptedSend(kind, accountId, async (capture) => {
+				const sendPayload = async (content) => quotedOpts ? await params.sock.sendMessage(jid, content, quotedOpts) : await params.sock.sendMessage(jid, content);
+				capture(await sendPayload(payload), kind);
+				if (shouldSendAudioText) {
+					const resolvedAudioText = await resolveMentions(jid, text);
+					capture(await sendPayload(addWhatsAppOutboundMentionsToContent({ text: resolvedAudioText.text }, resolvedAudioText.mentionedJids)), "text");
+				}
+			});
 		},
 		sendPoll: async (to, poll) => {
 			return await sendStructuredMessage(to, { poll: {
@@ -746,4 +735,4 @@ function createWebSendApi(params) {
 	};
 }
 //#endregion
-export { extractMediaKind as _, mayContainWhatsAppOutboundMention as a, hasInboundUserContent as b, DisconnectReason as c, normalizeMessageContent$1 as d, describeReplyContext as f, extractLocationData as g, extractExternalAdReplyContext as h, addWhatsAppOutboundMentionsToContent as i, downloadMediaMessage as l, extractContextInfo as m, listWhatsAppSendResultMessageIds as n, resolveWhatsAppOutboundMentions as o, extractContactContext as p, normalizeWhatsAppSendResult as r, addWhatsAppImagePreviewFields as s, createWebSendApi as t, isJidGroup as u, extractMentionedJids as v, resolveInboundMediaMimetype as x, extractText as y };
+export { resolveInboundMediaMimetype as _, addWhatsAppImagePreviewFields as a, extractContextInfo as c, extractMediaKind as d, extractMentionedJids as f, projectWhatsAppInboundMessage as g, hasInboundUserContent as h, resolveWhatsAppOutboundMentions as i, extractExternalAdReplyContext as l, findMessageSection as m, addWhatsAppOutboundMentionsToContent as n, describeReplyContext as o, extractText as p, mayContainWhatsAppOutboundMention as r, extractContactContext as s, createWebSendApi as t, extractLocationData as u };

package/dist/setup-entry.js

@@ -2,18 +2,11 @@ import { defineBundledChannelSetupEntry } from "openclaw/plugin-sdk/channel-entr
 //#region extensions/whatsapp/setup-entry.ts
 var setup_entry_default = defineBundledChannelSetupEntry({
 	importMetaUrl: import.meta.url,
-	features: {
-		legacyStateMigrations: true,
-		legacySessionSurfaces: true
-	},
+	features: { legacySessionSurfaces: true },
 	plugin: {
 		specifier: "./setup-plugin-api.js",
 		exportName: "whatsappSetupPlugin"
 	},
-	legacyStateMigrations: {
-		specifier: "./legacy-state-migrations-api.js",
-		exportName: "detectWhatsAppLegacyStateMigrations"
-	},
 	legacySessionSurface: {
 		specifier: "./legacy-session-surface-api.js",
 		exportName: "whatsappLegacySessionSurface"

package/dist/{setup-finalize-BZucx24W.js → setup-finalize-n4K2I2gJ.js}

@@ -1,8 +1,8 @@
-import { a as resolveWhatsAppAccount, o as resolveWhatsAppAuthDir } from "./accounts-CSqLvCY5.js";
+import { a as resolveWhatsAppAccount, o as resolveWhatsAppAuthDir } from "./accounts-BX2fZUyR.js";
 import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-CB5SOWjc.js";
-import { r as hasWebCredsSync } from "./creds-files-B1kSWtBg.js";
+import { r as hasWebCredsSync } from "./creds-files-W6B3EMZ8.js";
 import { a as normalizeWhatsAppAllowFromEntries, o as normalizeWhatsAppAllowFromEntry } from "./normalize-target-CugRyONv.js";
-import { r as whatsappSetupAdapter } from "./shared-CAxd15bp.js";
+import { r as whatsappSetupAdapter } from "./shared-wg42NKFB.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
@@ -295,7 +295,7 @@ async function finalizeWhatsAppSetup(params) {
 		};
 		let loginWeb;
 		try {
-			({loginWeb} = await import("./login-CvY2Dhch.js").then((n) => n.n));
+			({loginWeb} = await import("./login-BkpKpndm.js").then((n) => n.n));
 		} catch (error) {
 			await reportLoginFailure(error);
 		}

package/dist/setup-plugin-api.js

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

package/dist/{setup-surface-BkVcd769.js → setup-surface-Cwn3zyxK.js}

@@ -1,6 +1,6 @@
-import { o as resolveWhatsAppAuthDir } from "./accounts-CSqLvCY5.js";
+import { o as resolveWhatsAppAuthDir } from "./accounts-BX2fZUyR.js";
 import { t as listAccountIds } from "./account-ids-CB5SOWjc.js";
-import { a as formatWhatsAppWebAuthStatusState, h as readWebAuthState } from "./auth-store-DcEpIOmE.js";
+import { a as formatWhatsAppWebAuthStatusState, h as readWebAuthState } from "./auth-store-CtpBqH5S.js";
 import { DEFAULT_ACCOUNT_ID, createSetupTranslator, setSetupChannelEnabled } from "openclaw/plugin-sdk/setup";
 //#region extensions/whatsapp/src/setup-surface.ts
 const t = createSetupTranslator();
@@ -36,7 +36,7 @@ const whatsappSetupWizard = {
 	},
 	resolveShouldPromptAccountIds: ({ shouldPromptAccountIds }) => shouldPromptAccountIds,
 	credentials: [],
-	finalize: async (params) => await (await import("./setup-finalize-BZucx24W.js")).finalizeWhatsAppSetup(params),
+	finalize: async (params) => await (await import("./setup-finalize-n4K2I2gJ.js")).finalizeWhatsAppSetup(params),
 	disable: (cfg) => setSetupChannelEnabled(cfg, channel, false),
 	onAccountRecorded: (accountId, options) => {
 		options?.onAccountId?.(channel, accountId);

package/dist/{shared-CAxd15bp.js → shared-wg42NKFB.js}

@@ -1,4 +1,4 @@
-import { a as resolveWhatsAppAccount, n as hasAnyWhatsAppAuth } from "./accounts-CSqLvCY5.js";
+import { a as resolveWhatsAppAccount, n as hasAnyWhatsAppAuth } from "./accounts-BX2fZUyR.js";
 import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-CB5SOWjc.js";
 import { a as normalizeWhatsAppAllowFromEntries } from "./normalize-target-CugRyONv.js";
 import { t as WhatsAppChannelConfigSchema } from "./config-schema-BQP5YCeK.js";
@@ -12,7 +12,7 @@ import { normalizeE164 } from "openclaw/plugin-sdk/account-resolution";
 import { createChannelPluginBase } from "openclaw/plugin-sdk/core";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
-import { buildChannelGroupsScopeTree, collectOpenGroupPolicyRouteAllowlistWarnings, createAllowlistProviderGroupPolicyWarningCollector, resolveScopeRequireMention, resolveScopeToolsPolicy } from "openclaw/plugin-sdk/channel-policy";
+import { buildChannelGroupsScopeTree, collectOpenGroupPolicyRouteAllowlistWarnings, createAllowlistProviderGroupPolicyWarningCollector, createConditionalWarningCollector, resolveScopeRequireMention, resolveScopeToolsPolicy } from "openclaw/plugin-sdk/channel-policy";
 import { defineChannelSetupContract } from "openclaw/plugin-sdk/channel-setup";
 import { createPatchedAccountSetupAdapter } from "openclaw/plugin-sdk/setup";
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
@@ -20,14 +20,14 @@ import { adaptScopedAccountAccessor, createScopedChannelConfigAdapter, createSco
 import { createDelegatedSetupWizardProxy } from "openclaw/plugin-sdk/setup-runtime";
 import { readChannelAllowFromStore } from "openclaw/plugin-sdk/channel-pairing";
 //#region extensions/whatsapp/src/channel-runtime-loader.ts
-const loadWhatsAppAuthStore = createLazyRuntimeModule(() => import("./auth-store-DcEpIOmE.js").then((n) => n.i));
+const loadWhatsAppAuthStore = createLazyRuntimeModule(() => import("./auth-store-CtpBqH5S.js").then((n) => n.i));
 async function readWhatsAppAccountLinkState(authDir) {
 	const state = await (await loadWhatsAppAuthStore()).readWebAuthState(authDir);
 	return state === "unstable" ? "unknown" : state;
 }
 const loadWhatsAppChannelRuntime = createLazyRuntimeModule(async () => {
 	await loadWhatsAppAuthStore();
-	return await import("./channel.runtime-BP0xNmLi.js");
+	return await import("./channel.runtime-X3JC2gaq.js");
 });
 //#endregion
 //#region extensions/whatsapp/src/config-accessors.ts
@@ -115,7 +115,7 @@ async function applyWhatsAppSecurityConfigFixes(params) {
 //#region extensions/whatsapp/src/shared.ts
 const WHATSAPP_CHANNEL = "whatsapp";
 async function loadWhatsAppSetupSurface() {
-	return await import("./setup-surface-BkVcd769.js");
+	return await import("./setup-surface-Cwn3zyxK.js");
 }
 const whatsappSetupWizardProxy = createWhatsAppSetupWizardProxy(async () => (await loadWhatsAppSetupSurface()).whatsappSetupWizard);
 const whatsappConfigAdapter = createScopedChannelConfigAdapter({
@@ -209,6 +209,12 @@ function createWhatsAppPluginBase(params) {
 			}
 		})
 	});
+	const collectWhatsAppOpenGroupFindings = createConditionalWarningCollector.findings({
+		collectWarnings: collectWhatsAppSecurityWarnings,
+		checkId: "channels.whatsapp.groups.open",
+		severity: "critical",
+		title: "WhatsApp security warning"
+	});
 	const base = createChannelPluginBase({
 		id: WHATSAPP_CHANNEL,
 		meta: {
@@ -270,11 +276,10 @@ function createWhatsAppPluginBase(params) {
 		security: {
 			applyConfigFixes: applyWhatsAppSecurityConfigFixes,
 			resolveDmPolicy: whatsappResolveDmPolicy,
-			collectWarnings: collectWhatsAppSecurityWarnings
+			collectWarnings: collectWhatsAppOpenGroupFindings
 		},
 		doctor: whatsappDoctor,
-		setup: params.setup,
-		...params.setupContract ? { setupContract: params.setupContract } : {},
+		setupContract: params.setupContract,
 		groups: params.groups
 	});
 	return {

package/dist/{socket-close-DridEuzz.js → socket-close-2T0_jZTN.js}

@@ -1,8 +1,9 @@
-import { o as resolveWebCredsBackupPath, s as resolveWebCredsPath, t as assertWebCredsPathRegularFileOrMissing } from "./creds-files-B1kSWtBg.js";
-import { E as writeWebCredsRawAtomically, S as enqueueCredsSave, T as writeCredsJsonAtomically, b as restoreCredsFromBackupIfNeeded, u as readCredsJsonRaw, w as waitForCredsSaveQueueWithTimeout, y as resolveDefaultWebAuthDir } from "./auth-store-DcEpIOmE.js";
+import { c as resolveWebCredsPath, s as resolveWebCredsBackupPath, t as assertWebCredsPathRegularFileOrMissing } from "./creds-files-W6B3EMZ8.js";
+import { A as enqueueCredsSave, M as waitForCredsSaveQueueWithTimeout, N as writeCredsJsonAtomically, P as writeWebCredsRawAtomically, b as restoreCredsFromBackupIfNeeded, u as readCredsJsonRaw, y as resolveDefaultWebAuthDir } from "./auth-store-CtpBqH5S.js";
 import { n as getStatusCode } from "./session-errors-JuazczrA.js";
 import { a as makeWASocket, i as makeCacheableSignalKeyStore, n as createBaileysSignalRepository, r as fetchLatestBaileysVersion, s as useMultiFileAuthState } from "./session.runtime-Nsqaehbd.js";
 import { VERSION, formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
+import { toErrorObject } from "openclaw/plugin-sdk/error-runtime";
 import { danger, getChildLogger, success, toPinoLikeLogger } from "openclaw/plugin-sdk/runtime-env";
 import { renderQrTerminal } from "openclaw/plugin-sdk/media-runtime";
 import { ensureDir, resolveUserPath } from "openclaw/plugin-sdk/text-utility-runtime";
@@ -541,7 +542,7 @@ async function waitForWaConnection(sock, options = { timeout: "none" }) {
 			}
 			if (update.connection === "close") {
 				cleanup();
-				reject(toLintErrorObject(update.lastDisconnect?.error ?? update.lastDisconnect ?? /* @__PURE__ */ new Error("Connection closed"), "Non-Error rejection"));
+				reject(toErrorObject(update.lastDisconnect?.error ?? update.lastDisconnect ?? /* @__PURE__ */ new Error("Connection closed"), "Non-Error rejection"));
 			}
 		};
 		sock.ev.on("connection.update", handler);
@@ -558,13 +559,6 @@ async function waitForWaConnection(sock, options = { timeout: "none" }) {
 function newConnectionId() {
 	return randomUUID();
 }
-function toLintErrorObject(value, fallbackMessage) {
-	if (value instanceof Error) return value;
-	if (typeof value === "string") return new Error(value);
-	const error = new Error(fallbackMessage, { cause: value });
-	if (typeof value === "object" && value !== null || typeof value === "function") Object.assign(error, value);
-	return error;
-}
 function createConnectionTimeoutError(timeoutMs) {
 	const error = /* @__PURE__ */ new Error(`WhatsApp connection timed out after ${timeoutMs}ms`);
 	Object.assign(error, { output: { statusCode: 408 } });

package/openclaw.plugin.json

@@ -1,5 +1,9 @@
 {
   "id": "whatsapp",
+  "doctorContract": {
+    "configRepair": true,
+    "stateMigrations": true
+  },
   "name": "WhatsApp",
   "description": "OpenClaw WhatsApp channel plugin for WhatsApp Web chats.",
   "icon": "https://cdn.simpleicons.org/whatsapp",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/whatsapp",
-  "version": "2026.7.2-beta.7",
+  "version": "2026.8.1-beta.3",
   "description": "OpenClaw WhatsApp channel plugin for WhatsApp Web chats.",
   "repository": {
     "type": "git",
@@ -13,7 +13,7 @@
     "typebox": "1.3.6"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.7"
+    "openclaw": ">=2026.8.1-beta.3"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -27,7 +27,6 @@
     "setupEntry": "./dist/setup-entry.js",
     "setupFeatures": {
       "configPromotion": true,
-      "legacyStateMigrations": true,
       "legacySessionSurfaces": true
     },
     "channel": {
@@ -66,10 +65,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.7"
+      "pluginApi": ">=2026.8.1-beta.3"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7"
+      "openclawVersion": "2026.8.1-beta.3"
     },
     "release": {
       "publishToClawHub": true,

package/skills/wacli/SKILL.md

@@ -20,7 +20,7 @@ metadata:
             {
               "id": "go",
               "kind": "go",
-              "module": "github.com/steipete/wacli/cmd/wacli@latest",
+              "module": "github.com/openclaw/wacli/cmd/wacli@latest",
               "bins": ["wacli"],
               "label": "Install wacli (go)",
             },
@@ -53,6 +53,12 @@ Find chats + messages
 - `wacli messages search "query" --limit 20 --chat <jid>`
 - `wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31`
 
+Inspect / verify messages
+
+- `wacli messages show --chat <jid> --id <message_id> --json --full`
+- `messages show` requires both `--chat` and `--id`; do not pass the message ID as a positional argument.
+- After sending, verify the stored message when exact formatting matters, especially multiline text.
+
 History backfill
 
 - `wacli history backfill --chat <jid> --requests 2 --count 50`
@@ -62,6 +68,7 @@ Send
 - Text: `wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"`
 - Group: `wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."`
 - File: `wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"`
+- Multiline: `--message` is literal by default; pass `--message-escapes` to interpret `\n`, `\r`, `\t`.
 
 Notes