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

package/dist/{send-D37ddk22.js → send-prK8F7Vj.js}

@@ -1,4 +1,4 @@
-import { a as resolveWhatsAppAccount, c as resolveMergedWhatsAppAccountConfig, s as resolveWhatsAppMediaMaxBytes } from "./accounts-CSqLvCY5.js";
+import { a as resolveWhatsAppAccount, c as resolveMergedWhatsAppAccountConfig, s as resolveWhatsAppMediaMaxBytes } from "./accounts-BX2fZUyR.js";
 import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-CB5SOWjc.js";
 import { n as isWhatsAppNewsletterJid } from "./normalize-target-CugRyONv.js";
 import { r as getWhatsAppConnectionController } from "./connection-controller-runtime-context-DG0tuYuw.js";
@@ -6,7 +6,7 @@ import "./normalize-C7Hkc_vE.js";
 import { a as markdownToWhatsAppChunks, c as toWhatsappJid } from "./targets-runtime-TMk0lGuy.js";
 import { a as stripToolCallXmlTags, i as sanitizeAssistantVisibleTextWithProfile, r as sanitizeAssistantVisibleText } from "./text-runtime-CaKLhowd.js";
 import path from "node:path";
-import { normalizeUniqueStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { normalizeStringEntries, normalizeUniqueStringEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveReactionLevel } from "openclaw/plugin-sdk/status-helpers";
 import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
 import { generateSecureUuid } from "openclaw/plugin-sdk/core";
@@ -17,9 +17,12 @@ import { loadOutboundMediaFromUrl } from "openclaw/plugin-sdk/outbound-media";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { normalizePollInput } from "openclaw/plugin-sdk/poll-runtime";
 import { resolveChunkMode, resolveTextChunkLimit } from "openclaw/plugin-sdk/reply-chunking";
-import { createSubsystemLogger, getChildLogger as getChildLogger$1 } from "openclaw/plugin-sdk/runtime-env";
+import { createSubsystemLogger as createSubsystemLogger$1, getChildLogger as getChildLogger$1 } from "openclaw/plugin-sdk/runtime-env";
 import { extensionForMime, mediaKindFromMime, mimeTypeFromFilePath, normalizeMimeType } from "openclaw/plugin-sdk/media-mime";
-import { sanitizeForPlainText } from "openclaw/plugin-sdk/channel-outbound";
+import { AsyncLocalStorage } from "node:async_hooks";
+import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
+import { createChannelPartialDeliveryError, isChannelPartialDeliveryError } from "openclaw/plugin-sdk/channel-inbound";
+import { createMessageReceiptFromOutboundResults, listMessageReceiptPlatformIds, sanitizeForPlainText } from "openclaw/plugin-sdk/channel-outbound";
 import { MEDIA_FFMPEG_MAX_AUDIO_DURATION_SECS, transcodeAudioBufferToOpus } from "openclaw/plugin-sdk/media-runtime";
 import { resolveOutboundMediaUrls } from "openclaw/plugin-sdk/reply-payload";
 //#region extensions/whatsapp/src/reaction-level.ts
@@ -54,6 +57,245 @@ function stripAsciiControlCharacters(value) {
 	return stripped;
 }
 //#endregion
+//#region extensions/whatsapp/src/inbound/send-result.ts
+const activityAccountedWhatsAppSendResults = /* @__PURE__ */ new WeakSet();
+const logicalWhatsAppDeliveryActivity = new AsyncLocalStorage();
+/** Keep all separately produced platform sends inside one logical reply accounting scope. */
+async function withWhatsAppLogicalDeliveryActivity(run) {
+	if (logicalWhatsAppDeliveryActivity.getStore()) return await run();
+	return await logicalWhatsAppDeliveryActivity.run({ accountedAccountIds: /* @__PURE__ */ new Set() }, run);
+}
+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 mergeWhatsAppReceiptSourceMetadata(sources) {
+	const defined = sources.filter((source) => Boolean(source));
+	const preferred = defined[0];
+	if (!preferred) return;
+	const merged = /* @__PURE__ */ new Map();
+	const meta = /* @__PURE__ */ new Map();
+	for (const source of defined.toReversed()) {
+		for (const [key, value] of Object.entries(source)) if (key !== "meta" && value !== void 0) merged.set(key, value);
+		for (const [key, value] of Object.entries(source.meta ?? {})) if (value !== void 0) meta.set(key, value);
+	}
+	const mergedSource = Object.assign({}, preferred, Object.fromEntries(merged));
+	if (meta.size > 0) mergedSource.meta = Object.fromEntries(meta);
+	else delete mergedSource.meta;
+	return mergedSource;
+}
+function enrichWhatsAppDeliveryReceipt(params) {
+	const seenPartIds = /* @__PURE__ */ new Set();
+	const parts = params.receipt.parts.flatMap((part) => {
+		if (seenPartIds.has(part.platformMessageId)) return [];
+		seenPartIds.add(part.platformMessageId);
+		const matchingParts = params.sources.flatMap((source) => source.parts.filter((candidate) => candidate.platformMessageId === part.platformMessageId));
+		const matchingRawSources = params.sources.flatMap((source) => source.raw?.filter((raw) => raw.messageId === part.platformMessageId) ?? []);
+		const raw = mergeWhatsAppReceiptSourceMetadata([
+			part.raw,
+			...matchingParts.map((candidate) => candidate.raw),
+			...matchingRawSources
+		]);
+		const threadId = part.threadId ?? matchingParts.find((candidate) => candidate.threadId)?.threadId;
+		const replyToId = part.replyToId ?? matchingParts.find((candidate) => candidate.replyToId)?.replyToId;
+		return [{
+			...part,
+			...threadId ? { threadId } : {},
+			...replyToId ? { replyToId } : {},
+			...raw ? { raw } : {}
+		}];
+	});
+	const threadId = params.receipt.threadId ?? params.sources.find((source) => source.threadId)?.threadId;
+	const replyToId = params.receipt.replyToId ?? params.sources.find((source) => source.replyToId)?.replyToId;
+	const editToken = params.receipt.editToken ?? params.sources.find((source) => source.editToken)?.editToken;
+	const deleteToken = params.receipt.deleteToken ?? params.sources.find((source) => source.deleteToken)?.deleteToken;
+	return {
+		...params.receipt,
+		parts,
+		raw: parts.map((part) => part.raw ?? {
+			channel: "whatsapp",
+			messageId: part.platformMessageId
+		}),
+		...threadId ? { threadId } : {},
+		...replyToId ? { replyToId } : {},
+		...editToken ? { editToken } : {},
+		...deleteToken ? { deleteToken } : {}
+	};
+}
+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 createWhatsAppProviderNotAcceptedError(kind) {
+	const cause = /* @__PURE__ */ new Error("Baileys returned no accepted message key.");
+	return new PlatformMessageNotDispatchedError(`WhatsApp ${kind} send was not accepted by the provider: ${cause.message}`, { cause });
+}
+function normalizeWhatsAppSendResult(result, kind) {
+	const key = normalizeKey(result?.key);
+	if (!key) throw createWhatsAppProviderNotAcceptedError(kind);
+	return {
+		kind,
+		messageId: key.id,
+		receipt: createWhatsAppSendReceipt(kind, [key]),
+		keys: [key],
+		providerAccepted: true
+	};
+}
+/** Refuse synthetic ids from listener boundaries before callers create durable receipts. */
+function requireWhatsAppAcceptedSendResult(result) {
+	if (result.providerAccepted && result.messageId !== "unknown" && result.keys.some((key) => key.id === result.messageId) && listWhatsAppSendResultMessageIds(result).includes(result.messageId)) return result;
+	throw createWhatsAppProviderNotAcceptedError(result.kind);
+}
+/** Persist accepted provider facts before account bookkeeping or later platform sends can fail. */
+function rememberWhatsAppAcceptedSend(params) {
+	const accepted = requireWhatsAppAcceptedSendResult(params.result);
+	params.results.push(accepted);
+	if (params.results.length === 1) {
+		const deliveryActivity = logicalWhatsAppDeliveryActivity.getStore();
+		const alreadyAccounted = activityAccountedWhatsAppSendResults.has(accepted) || Boolean(deliveryActivity?.accountedAccountIds.has(params.accountId));
+		activityAccountedWhatsAppSendResults.add(accepted);
+		if (!alreadyAccounted) {
+			deliveryActivity?.accountedAccountIds.add(params.accountId);
+			recordChannelActivity({
+				channel: "whatsapp",
+				accountId: params.accountId,
+				direction: "outbound"
+			});
+		}
+	}
+	return accepted;
+}
+/** Nested owners already attempted activity accounting before exposing accepted delivery. */
+function rememberWhatsAppPartialSend(params) {
+	if (!isChannelPartialDeliveryError(params.error)) return false;
+	const delivery = params.error.deliveryResult;
+	const messageIds = uniqueStrings([...delivery.receipt ? listMessageReceiptPlatformIds(delivery.receipt) : [], ...normalizeStringEntries(delivery.messageIds ?? [])]).filter((messageId) => messageId !== "unknown");
+	const existingIds = new Set(params.results.flatMap(listWhatsAppSendResultMessageIds));
+	const acceptedIds = messageIds.filter((messageId) => !existingIds.has(messageId));
+	const messageId = acceptedIds[0];
+	if (!messageId) return false;
+	const receiptSources = [];
+	if (delivery.receipt) receiptSources.push({
+		channel: "whatsapp",
+		messageId,
+		receipt: delivery.receipt
+	});
+	const receiptIds = new Set(delivery.receipt ? listMessageReceiptPlatformIds(delivery.receipt) : []);
+	for (const acceptedId of acceptedIds) if (!receiptIds.has(acceptedId)) receiptSources.push({
+		channel: "whatsapp",
+		messageId: acceptedId
+	});
+	const receipt = createMessageReceiptFromOutboundResults({
+		kind: resolveWhatsAppReceiptKind(params.kind),
+		results: receiptSources
+	});
+	const accepted = requireWhatsAppAcceptedSendResult({
+		kind: params.kind,
+		messageId,
+		receipt,
+		keys: acceptedIds.map((id) => ({ id })),
+		providerAccepted: true
+	});
+	activityAccountedWhatsAppSendResults.add(accepted);
+	params.results.push(accepted);
+	return true;
+}
+/** Merge accepted local sends with nested partial receipts without inventing provider ids. */
+function mergeWhatsAppAcceptedSendError(params) {
+	const nested = isChannelPartialDeliveryError(params.error) ? params.error.deliveryResult : void 0;
+	const receiptSources = [];
+	const recordedIds = /* @__PURE__ */ new Set();
+	for (const result of params.results) {
+		const resultIds = listWhatsAppSendResultMessageIds(result);
+		if (resultIds.every((messageId) => recordedIds.has(messageId))) continue;
+		receiptSources.push({
+			channel: "whatsapp",
+			messageId: result.messageId,
+			...result.receipt ? { receipt: result.receipt } : {}
+		});
+		for (const messageId of resultIds) recordedIds.add(messageId);
+	}
+	const unrecordedNestedIds = uniqueStrings([...nested?.receipt ? listMessageReceiptPlatformIds(nested.receipt) : [], ...normalizeStringEntries(nested?.messageIds ?? [])]).filter((messageId) => messageId !== "unknown").filter((messageId) => !recordedIds.has(messageId));
+	const nestedMessageId = unrecordedNestedIds[0];
+	if (nested?.receipt && nestedMessageId) {
+		receiptSources.push({
+			channel: "whatsapp",
+			messageId: nestedMessageId,
+			receipt: nested.receipt
+		});
+		for (const messageId of listMessageReceiptPlatformIds(nested.receipt)) recordedIds.add(messageId);
+	}
+	for (const messageId of unrecordedNestedIds) if (!recordedIds.has(messageId)) receiptSources.push({
+		channel: "whatsapp",
+		messageId
+	});
+	const receipt = enrichWhatsAppDeliveryReceipt({
+		receipt: createMessageReceiptFromOutboundResults({
+			kind: resolveWhatsAppReceiptKind(params.kind),
+			results: receiptSources
+		}),
+		sources: [...params.results.flatMap((result) => result.receipt ? [result.receipt] : []), ...nested?.receipt ? [nested.receipt] : []]
+	});
+	const messageIds = listMessageReceiptPlatformIds(receipt);
+	if (messageIds.length === 0) return params.error;
+	let cause = params.error;
+	const visitedPartialErrors = /* @__PURE__ */ new Set();
+	while (isChannelPartialDeliveryError(cause) && cause instanceof Error && cause.cause !== void 0 && !visitedPartialErrors.has(cause)) {
+		visitedPartialErrors.add(cause);
+		cause = cause.cause;
+	}
+	return createChannelPartialDeliveryError(cause, {
+		...nested,
+		messageIds,
+		receipt,
+		visibleReplySent: true
+	});
+}
+function combineWhatsAppSendResults(kind, results) {
+	const messageId = uniqueStrings(results.flatMap(listWhatsAppSendResultMessageIds))[0];
+	if (!messageId) throw createWhatsAppProviderNotAcceptedError(kind);
+	const keys = results.flatMap((result) => result.keys);
+	const combined = {
+		kind,
+		messageId,
+		receipt: createWhatsAppSendReceipt(kind, keys),
+		keys,
+		providerAccepted: results.some((result) => result.providerAccepted)
+	};
+	if (results.some((result) => activityAccountedWhatsAppSendResults.has(result))) activityAccountedWhatsAppSendResults.add(combined);
+	return combined;
+}
+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/outbound-media-contract.ts
 const WHATSAPP_VOICE_FILE_NAME = "voice.ogg";
 const WHATSAPP_VOICE_SAMPLE_RATE_HZ = 48e3;
@@ -101,7 +343,7 @@ function inferWhatsAppMediaKind(media, resolvedContentType) {
 function normalizeWhatsAppLoadedMedia(media, mediaUrl) {
 	const filenameMimeType = mimeTypeFromFilePath(media.fileName);
 	const normalizedContentType = normalizeMimeType(media.contentType);
-	const resolvedContentType = !normalizedContentType || normalizedContentType === "application/octet-stream" ? filenameMimeType ?? media.contentType : media.contentType;
+	const resolvedContentType = !normalizedContentType || normalizedContentType === "application/octet-stream" ? filenameMimeType ?? normalizedContentType : normalizedContentType;
 	const kind = inferWhatsAppMediaKind(media, resolvedContentType);
 	const mimetype = kind === "audio" && isWhatsAppNativeVoiceAudio({
 		contentType: media.contentType,
@@ -167,13 +409,13 @@ function deriveWhatsAppDocumentFileName(mediaUrl) {
 }
 //#endregion
 //#region extensions/whatsapp/src/send.ts
-const outboundLog = createSubsystemLogger("gateway/channels/whatsapp").child("outbound");
+const outboundLog = createSubsystemLogger$1("gateway/channels/whatsapp").child("outbound");
 function supportsForcedDocumentDelivery(kind) {
 	return kind === "image" || kind === "video";
 }
 function buildWhatsAppMediaSendState(params) {
 	const { media, caption } = params;
-	const forceDocumentDelivery = Boolean(params.forceDocument && supportsForcedDocumentDelivery(media.kind));
+	const forceDocumentDelivery = Boolean(params.forceDocument && supportsForcedDocumentDelivery(media.kind)) || media.kind === "document" && (media.mimetype.startsWith("image/") || media.mimetype.startsWith("video/"));
 	let text = caption ?? "";
 	let documentFileName = media.kind === "document" ? media.fileName : void 0;
 	let visibleTextAfterVoice;
@@ -219,6 +461,9 @@ function resolveActualSentRemoteJid(result, fallbackJid) {
 	return fallbackJid;
 }
 async function sendMessageWhatsApp(to, body, options) {
+	return await withWhatsAppLogicalDeliveryActivity(() => sendMessageWhatsAppInActivityScope(to, body, options));
+}
+async function sendMessageWhatsAppInActivityScope(to, body, options) {
 	let text = options.preserveLeadingWhitespace ? body : normalizeWhatsAppPayloadText(body);
 	const jid = toWhatsappJid(to);
 	const mediaUrls = resolveAdditiveWhatsAppMediaUrls(options);
@@ -259,6 +504,7 @@ async function sendMessageWhatsApp(to, body, options) {
 		correlationId,
 		to: redactedTo
 	});
+	const acceptedResults = [];
 	try {
 		const redactedJid = redactIdentifier(jid);
 		let mediaBuffer;
@@ -295,7 +541,14 @@ async function sendMessageWhatsApp(to, body, options) {
 		}, "sending message");
 		if (!isWhatsAppNewsletterJid(jid)) {
 			await active.assertSendReady?.(to);
-			await active.sendComposingTo(to);
+			try {
+				await active.sendComposingTo(to);
+			} catch (err) {
+				logger.warn({
+					err: String(err),
+					jid: redactedJid
+				}, "failed to send composing presence; continuing message delivery");
+			}
 		}
 		const accountId = Boolean(options.accountId?.trim()) ? resolvedAccountId : void 0;
 		const sendOptions = options.gifPlayback || forceDocumentDelivery || accountId || documentFileName || options.quotedMessageKey ? {
@@ -305,8 +558,9 @@ async function sendMessageWhatsApp(to, body, options) {
 			...options.quotedMessageKey ? { quotedMessageKey: options.quotedMessageKey } : {},
 			accountId
 		} : void 0;
-		const result = sendOptions ? await active.sendMessage(to, text, mediaBuffer, mediaType, sendOptions) : await active.sendMessage(to, text, mediaBuffer, mediaType);
-		const messageId = result?.messageId ?? "unknown";
+		const result = requireWhatsAppAcceptedSendResult(sendOptions ? await active.sendMessage(to, text, mediaBuffer, mediaType, sendOptions) : await active.sendMessage(to, text, mediaBuffer, mediaType));
+		acceptedResults.push(result);
+		const messageId = result.messageId;
 		const sentRemoteJid = resolveActualSentRemoteJid(result, jid);
 		const trailingTextChunks = [visibleTextAfterVoice, ...textChunks].filter((chunk) => Boolean(chunk));
 		if (trailingTextChunks.length > 0) {
@@ -315,9 +569,10 @@ async function sendMessageWhatsApp(to, body, options) {
 				toJid: sentRemoteJid
 			});
 			for (const trailingText of trailingTextChunks) {
-				const trailingResult = sendOptions ? await active.sendMessage(to, trailingText, void 0, void 0, sendOptions) : await active.sendMessage(to, trailingText, void 0, void 0);
+				const trailingResult = requireWhatsAppAcceptedSendResult(sendOptions ? await active.sendMessage(to, trailingText, void 0, void 0, sendOptions) : await active.sendMessage(to, trailingText, void 0, void 0));
+				acceptedResults.push(trailingResult);
 				await options.onDeliveryResult?.({
-					messageId: trailingResult?.messageId ?? "unknown",
+					messageId: trailingResult.messageId,
 					toJid: resolveActualSentRemoteJid(trailingResult, jid)
 				});
 			}
@@ -338,7 +593,12 @@ async function sendMessageWhatsApp(to, body, options) {
 			to: redactedTo,
 			hasMedia
 		}, "failed to send via web session");
-		throw err;
+		const firstAccepted = acceptedResults[0];
+		throw mergeWhatsAppAcceptedSendError({
+			error: err,
+			kind: firstAccepted?.kind ?? (hasMedia ? "media" : "text"),
+			results: acceptedResults
+		});
 	}
 }
 async function sendTypingWhatsApp(to, options) {
@@ -413,7 +673,8 @@ async function sendPollWhatsApp(to, poll, options) {
 			maxSelections: normalized.maxSelections
 		}, "sending poll");
 		if (!isWhatsAppNewsletterJid(jid)) await active.assertSendReady?.(to);
-		const messageId = (await active.sendPoll(to, normalized))?.messageId ?? "unknown";
+		const result = requireWhatsAppAcceptedSendResult(await active.sendPoll(to, normalized));
+		const messageId = result.messageId;
 		const durationMs = Date.now() - startedAt;
 		outboundLog.info(`Sent poll ${messageId} -> ${redactedJid} (${durationMs}ms)`);
 		logger.info({
@@ -422,7 +683,7 @@ async function sendPollWhatsApp(to, poll, options) {
 		}, "sent poll");
 		return {
 			messageId,
-			toJid: jid
+			toJid: resolveActualSentRemoteJid(result, jid)
 		};
 	} catch (err) {
 		logger.error({
@@ -433,4 +694,4 @@ async function sendPollWhatsApp(to, poll, options) {
 	}
 }
 //#endregion
-export { normalizeWhatsAppOutboundPayload as a, prepareWhatsAppOutboundMedia as c, sendTypingWhatsApp as i, resolveWhatsAppDocumentFileName as l, sendPollWhatsApp as n, normalizeWhatsAppPayloadText as o, sendReactionWhatsApp as r, normalizeWhatsAppPayloadTextPreservingIndentation as s, sendMessageWhatsApp as t, resolveWhatsAppReactionLevel as u };
+export { resolveWhatsAppReactionLevel as _, normalizeWhatsAppOutboundPayload as a, prepareWhatsAppOutboundMedia as c, mergeWhatsAppAcceptedSendError as d, normalizeWhatsAppSendResult as f, resolveWhatsAppDocumentFileName as g, withWhatsAppLogicalDeliveryActivity as h, sendTypingWhatsApp as i, combineWhatsAppSendResults as l, rememberWhatsAppPartialSend as m, sendPollWhatsApp as n, normalizeWhatsAppPayloadText as o, rememberWhatsAppAcceptedSend as p, sendReactionWhatsApp as r, normalizeWhatsAppPayloadTextPreservingIndentation as s, sendMessageWhatsApp as t, listWhatsAppSendResultMessageIds 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-D3n71Uyx.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-Dp9M3ZPX.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-D6_rfxTZ.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-Cmvd967u.js";
 export { whatsappSetupPlugin };

package/dist/{setup-surface-BkVcd769.js → setup-surface-BCZszf3l.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-B_DQIdzp.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-D3n71Uyx.js")).finalizeWhatsAppSetup(params),
 	disable: (cfg) => setSetupChannelEnabled(cfg, channel, false),
 	onAccountRecorded: (accountId, options) => {
 		options?.onAccountId?.(channel, accountId);

package/dist/{shared-CAxd15bp.js → shared-Dp9M3ZPX.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";
@@ -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-B_DQIdzp.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-RxuNGZ7w.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-BCZszf3l.js");
 }
 const whatsappSetupWizardProxy = createWhatsAppSetupWizardProxy(async () => (await loadWhatsAppSetupSurface()).whatsappSetupWizard);
 const whatsappConfigAdapter = createScopedChannelConfigAdapter({
@@ -273,8 +273,7 @@ function createWhatsAppPluginBase(params) {
 			collectWarnings: collectWhatsAppSecurityWarnings
 		},
 		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-09FojDO2.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-B_DQIdzp.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.2",
   "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.2"
   },
   "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.2"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7"
+      "openclawVersion": "2026.8.1-beta.2"
     },
     "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