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

package/dist/action-runtime-api.js

@@ -1,2 +1,2 @@
-import { t as handleWhatsAppAction } from "./action-runtime-Dig47HuK.js";
+import { t as handleWhatsAppAction } from "./action-runtime-fgfdJlPZ.js";
 export { handleWhatsAppAction };

package/dist/{action-runtime-Dig47HuK.js → action-runtime-fgfdJlPZ.js}

@@ -1,7 +1,7 @@
 import { a as resolveWhatsAppAccount } from "./accounts-B4oR6Dhx.js";
-import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-BKcv4ofn.js";
+import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-Ba7sH80H.js";
 import { t as resolveWhatsAppReactionLevel } from "./reaction-level-2m9sWGCw.js";
-import { r as sendReactionWhatsApp } from "./send-DG5fpuQZ.js";
+import { r as sendReactionWhatsApp } from "./send-CByjzdb_.js";
 import { ToolAuthorizationError, createActionGate, jsonResult, readReactionParams, readStringParam } from "openclaw/plugin-sdk/channel-actions";
 //#region extensions/whatsapp/src/action-runtime-target-auth.ts
 function resolveAuthorizedWhatsAppOutboundTarget(params) {

package/dist/action-runtime.runtime.js

@@ -1,2 +1,2 @@
-import { t as handleWhatsAppAction } from "./action-runtime-Dig47HuK.js";
+import { t as handleWhatsAppAction } from "./action-runtime-fgfdJlPZ.js";
 export { handleWhatsAppAction };

package/dist/api.js

@@ -1,20 +1,20 @@
 import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-DG18xddX.js";
 import { a as resolveWhatsAppAccount, i as listWhatsAppAuthDirs, n as hasAnyWhatsAppAuth, o as resolveWhatsAppAuthDir, r as listEnabledWhatsAppAccounts, s as resolveWhatsAppMediaMaxBytes, t as DEFAULT_WHATSAPP_MEDIA_MAX_MB } from "./accounts-B4oR6Dhx.js";
-import { a as normalizeWhatsAppAllowFromEntries, c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, r as isWhatsAppUserTarget, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./normalize-target-ePanEpfY.js";
-import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-BKcv4ofn.js";
+import { a as normalizeWhatsAppAllowFromEntries, c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, r as isWhatsAppUserTarget, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
+import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-Ba7sH80H.js";
 import "./reaction-level-2m9sWGCw.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-CMxQczvs.js";
-import "./send-DG5fpuQZ.js";
-import { t as whatsappPlugin } from "./channel-BG0Lv4c9.js";
-import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS } from "./outbound-base-Cs2ntgBb.js";
+import "./send-CByjzdb_.js";
+import { t as whatsappPlugin } from "./channel-DBm3MwQ7.js";
+import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS } from "./outbound-base-BMgWLjp4.js";
 import { t as whatsappCommandPolicy } from "./command-policy-O8sRnqUV.js";
-import { a as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint } from "./setup-core-B5F7F8bE.js";
+import { a as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint } from "./setup-core-BFErZldJ.js";
 import "./config-schema-Dmo66Ubb.js";
-import { t as whatsappSetupPlugin } from "./channel.setup-BiyPwedi.js";
+import { t as whatsappSetupPlugin } from "./channel.setup-JfQ9Dv9K.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-yKXGCGU9.js";
-import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-ClsMAYen.js";
+import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-BLFmeNGN.js";
 import { t as __testing } from "./access-control-Di_o41dj.js";
-import { p as extractText, t as createWebSendApi } from "./send-api-DYiQpIng.js";
+import { p as extractText, t as createWebSendApi } from "./send-api-BNbwVO4e.js";
 import { r as waitForWaConnection, t as createWaSocket } from "./session-B4Rnsd-V.js";
 import "openclaw/plugin-sdk/channel-actions";
 import "openclaw/plugin-sdk/account-resolution";

package/dist/{channel-BG0Lv4c9.js → channel-DBm3MwQ7.js}

@@ -1,16 +1,16 @@
 import { t as listAccountIds } from "./account-ids-DG18xddX.js";
 import { a as resolveWhatsAppAccount } from "./accounts-B4oR6Dhx.js";
-import { c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, n as isWhatsAppNewsletterJid, o as normalizeWhatsAppAllowFromEntry, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./normalize-target-ePanEpfY.js";
-import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-BKcv4ofn.js";
+import { c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, n as isWhatsAppNewsletterJid, o as normalizeWhatsAppAllowFromEntry, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
+import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-Ba7sH80H.js";
 import { t as resolveWhatsAppReactionLevel } from "./reaction-level-2m9sWGCw.js";
-import "./normalize-f31evwm8.js";
-import { r as normalizeWhatsAppPayloadTextPreservingIndentation } from "./outbound-media-contract-DwACmTqZ.js";
-import { i as sendTypingWhatsApp, n as sendPollWhatsApp, t as sendMessageWhatsApp } from "./send-DG5fpuQZ.js";
+import "./normalize-BZBRXai6.js";
+import { r as normalizeWhatsAppPayloadTextPreservingIndentation } from "./outbound-media-contract-BW560jdu.js";
+import { i as sendTypingWhatsApp, n as sendPollWhatsApp, t as sendMessageWhatsApp } from "./send-CByjzdb_.js";
 import { t as createWhatsAppLoginTool } from "./agent-tools-login-DpRxLNRB.js";
-import { t as createWhatsAppOutboundBase } from "./outbound-base-Cs2ntgBb.js";
+import { t as createWhatsAppOutboundBase } from "./outbound-base-BMgWLjp4.js";
 import { t as getWhatsAppRuntime } from "./runtime-6fZ67abR.js";
 import { t as whatsappCommandPolicy } from "./command-policy-O8sRnqUV.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-B5F7F8bE.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-BFErZldJ.js";
 import { d as readWebAuthExistsForDecision, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-Cr3tg0Jm.js";
 import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-CtdIArlK.js";
 import { createActionGate as createActionGate$1 } from "openclaw/plugin-sdk/channel-actions";
@@ -321,8 +321,8 @@ function collectWhatsAppStatusIssues(accounts) {
 }
 //#endregion
 //#region extensions/whatsapp/src/channel.ts
-const loadWhatsAppDirectoryConfig = createLazyRuntimeModule(() => import("./directory-config-ClsMAYen.js").then((n) => n.t));
-const loadWhatsAppChannelReactAction = createLazyRuntimeModule(() => import("./channel-react-action-Q1STHXmW.js"));
+const loadWhatsAppDirectoryConfig = createLazyRuntimeModule(() => import("./directory-config-BLFmeNGN.js").then((n) => n.t));
+const loadWhatsAppChannelReactAction = createLazyRuntimeModule(() => import("./channel-react-action-SxUVHy5Q.js"));
 function parseWhatsAppExplicitTarget(raw) {
 	const normalized = normalizeWhatsAppTarget(raw);
 	if (!normalized) return null;

package/dist/channel-plugin-api.js

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

package/dist/{channel-react-action-Q1STHXmW.js → channel-react-action-SxUVHy5Q.js}

@@ -1,6 +1,6 @@
-import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-ePanEpfY.js";
-import { t as handleWhatsAppAction } from "./action-runtime-Dig47HuK.js";
-import "./normalize-f31evwm8.js";
+import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
+import { t as handleWhatsAppAction } from "./action-runtime-fgfdJlPZ.js";
+import "./normalize-BZBRXai6.js";
 import { readStringOrNumberParam, readStringParam as readStringParam$1, resolveReactionMessageId } from "openclaw/plugin-sdk/channel-actions";
 //#region extensions/whatsapp/src/channel-react-action.ts
 const WHATSAPP_CHANNEL = "whatsapp";

package/dist/{channel.runtime-ChxB8Ns0.js → channel.runtime-BrKncUJI.js}

@@ -1,9 +1,9 @@
 import { startWebLoginWithQr as startWebLoginWithQr$1, waitForWebLogin as waitForWebLogin$1 } from "./login-qr-runtime.js";
 import { a as getWebAuthAgeMs$1, b as webAuthExists$1, d as readWebAuthExistsForDecision$1, f as readWebAuthSnapshot$1, h as readWebSelfId$1, m as readWebAuthState$1, o as logWebSelfId$1, p as readWebAuthSnapshotBestEffort$1, s as logoutWeb$1, u as readWebAuthExistsBestEffort$1 } from "./auth-store-Cr3tg0Jm.js";
 import { t as getActiveWebListener$1 } from "./active-listener-D2NHQ5Og.js";
-import { t as monitorWebChannel$1 } from "./monitor-BVvWWOfi.js";
+import { t as monitorWebChannel$1 } from "./monitor-D4UnxxWO.js";
 import { t as loginWeb$1 } from "./login-CxQb0cqz.js";
-import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-7163OZHk.js";
+import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-B5pabs1e.js";
 //#region extensions/whatsapp/src/channel.runtime.ts
 function getActiveWebListener(...args) {
 	return getActiveWebListener$1(...args);

package/dist/{channel.setup-BiyPwedi.js → channel.setup-JfQ9Dv9K.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-B5F7F8bE.js";
+import { a as resolveWhatsAppGroupRequireMention, i as whatsappSetupWizardProxy, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint, t as whatsappSetupAdapter } from "./setup-core-BFErZldJ.js";
 import { m as readWebAuthState } from "./auth-store-Cr3tg0Jm.js";
 import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-CtdIArlK.js";
 //#region extensions/whatsapp/src/channel.setup.ts

package/dist/contract-api.js

@@ -1,9 +1,9 @@
-import { c as normalizeWhatsAppTarget$1, t as isWhatsAppGroupJid$1 } from "./normalize-target-ePanEpfY.js";
+import { c as normalizeWhatsAppTarget$1, t as isWhatsAppGroupJid$1 } from "./normalize-target-MB6Z_4Bn.js";
 import { t as whatsappCommandPolicy$1 } from "./command-policy-O8sRnqUV.js";
 import { t as resolveLegacyGroupSessionKey$1 } from "./group-session-contract-DdqigLJl.js";
 import { n as unsupportedSecretRefSurfacePatterns, t as collectUnsupportedSecretRefConfigCandidates } from "./security-contract-CvfWex9e.js";
 import { r as isLegacyGroupSessionKey$1, t as canonicalizeLegacySessionKey$1 } from "./session-contract-B0efQf9P.js";
-import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-ClsMAYen.js";
+import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-BLFmeNGN.js";
 import { t as resolveWhatsAppRuntimeGroupPolicy$1 } from "./runtime-group-policy-BH_U23qp.js";
 import { t as __testing } from "./access-control-Di_o41dj.js";
 //#region extensions/whatsapp/contract-api.ts

package/dist/{directory-config-ClsMAYen.js → directory-config-BLFmeNGN.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
 import { t as resolveMergedWhatsAppAccountConfig } from "./account-config-CNQ33oav.js";
-import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-ePanEpfY.js";
-import "./normalize-f31evwm8.js";
+import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
+import "./normalize-BZBRXai6.js";
 import { listResolvedDirectoryGroupEntriesFromMapKeys, listResolvedDirectoryUserEntriesFromAllowFrom } from "openclaw/plugin-sdk/directory-config-runtime";
 //#region extensions/whatsapp/src/directory-config.ts
 var directory_config_exports = /* @__PURE__ */ __exportAll({

package/dist/directory-contract-api.js

@@ -1,2 +1,2 @@
-import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-ClsMAYen.js";
+import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-BLFmeNGN.js";
 export { listWhatsAppDirectoryGroupsFromConfig, listWhatsAppDirectoryPeersFromConfig };

package/dist/{monitor-BVvWWOfi.js → monitor-D4UnxxWO.js}

@@ -1,15 +1,15 @@
 import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-B4oR6Dhx.js";
-import { t as isWhatsAppGroupJid } from "./normalize-target-ePanEpfY.js";
+import { t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
 import { t as resolveWhatsAppReactionLevel } from "./reaction-level-2m9sWGCw.js";
 import { n as getStatusCode, t as formatError } from "./session-errors-CSuKZPub.js";
 import { d as markdownToWhatsApp, f as resolveJidToE164, l as isSelfChatMode, n as normalizeE164, t as convertMarkdownTables$1, u as jidToE164 } from "./text-runtime-CMxQczvs.js";
-import { i as prepareWhatsAppOutboundMedia, o as sendWhatsAppOutboundWithRetry, r as normalizeWhatsAppPayloadTextPreservingIndentation, t as normalizeWhatsAppOutboundPayload } from "./outbound-media-contract-DwACmTqZ.js";
-import { r as sendReactionWhatsApp } from "./send-DG5fpuQZ.js";
+import { i as prepareWhatsAppOutboundMedia, o as sendWhatsAppOutboundWithRetry, r as normalizeWhatsAppPayloadTextPreservingIndentation, t as normalizeWhatsAppOutboundPayload } from "./outbound-media-contract-BW560jdu.js";
+import { r as sendReactionWhatsApp } from "./send-CByjzdb_.js";
 import { n as cacheInboundMessageMeta, r as lookupInboundMessageMeta, t as buildQuotedMessageOptions } from "./quoted-message-BQsRXnac.js";
 import { _ as readWebSelfIdentityForDecision, a as getWebAuthAgeMs, h as readWebSelfId, r as WhatsAppAuthUnstableError, s as logoutWeb } from "./auth-store-Cr3tg0Jm.js";
 import { a as getSelfIdentity, c as resolveComparableIdentity, i as getReplyContext, n as getMentionIdentities, o as getSenderIdentity, r as getPrimaryIdentityId, s as identitiesOverlap, t as getComparableIdentityValues } from "./identity-BNDkpR8N.js";
 import { i as resolveWhatsAppInboundPolicy, n as checkInboundAccessControl, r as resolveWhatsAppCommandAuthorized } from "./access-control-Di_o41dj.js";
-import { a as mayContainWhatsAppOutboundMention, c as extractContactContext, d as extractMediaPlaceholder, f as extractMentionedJids, i as addWhatsAppOutboundMentionsToContent, l as extractContextInfo, m as hasInboundUserContent, n as listWhatsAppSendResultMessageIds, o as resolveWhatsAppOutboundMentions, p as extractText, r as normalizeWhatsAppSendResult, s as describeReplyContext, t as createWebSendApi, u as extractLocationData } from "./send-api-DYiQpIng.js";
+import { a as mayContainWhatsAppOutboundMention, c as extractContactContext, d as extractMediaPlaceholder, f as extractMentionedJids, i as addWhatsAppOutboundMentionsToContent, l as extractContextInfo, m as hasInboundUserContent, n as listWhatsAppSendResultMessageIds, o as resolveWhatsAppOutboundMentions, p as extractText, r as normalizeWhatsAppSendResult, s as describeReplyContext, t as createWebSendApi, u as extractLocationData } from "./send-api-BNbwVO4e.js";
 import { i as resolveWhatsAppSocketTiming, r as waitForWaConnection, t as createWaSocket } from "./session-B4Rnsd-V.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-YqKi6Ekq.js";
 import { resolveAccountEntry } from "openclaw/plugin-sdk/account-core";

package/dist/normalize-BZBRXai6.js

@@ -0,0 +1,2 @@
+import "./normalize-target-MB6Z_4Bn.js";
+export {};

package/dist/{normalize-target-ePanEpfY.js → normalize-target-MB6Z_4Bn.js}

@@ -14,12 +14,15 @@ function stripWhatsAppTargetPrefixes(value) {
 		if (candidate === before) return candidate;
 	}
 }
-function isWhatsAppGroupJid(value) {
-	const candidate = stripWhatsAppTargetPrefixes(value);
-	if (!normalizeLowercaseStringOrEmpty(candidate).endsWith("@g.us")) return false;
+function normalizeWhatsAppGroupJid(value) {
+	const candidate = stripWhatsAppTargetPrefixes(value).replace(/^group:/i, "").trim();
+	if (!normalizeLowercaseStringOrEmpty(candidate).endsWith("@g.us")) return null;
 	const localPart = candidate.slice(0, candidate.length - 5);
-	if (!localPart || localPart.includes("@")) return false;
-	return /^[0-9]+(-[0-9]+)*$/.test(localPart);
+	if (!localPart || localPart.includes("@")) return null;
+	return /^[0-9]+(-[0-9]+)*$/.test(localPart) ? `${localPart}@g.us` : null;
+}
+function isWhatsAppGroupJid(value) {
+	return normalizeWhatsAppGroupJid(value) !== null;
 }
 function isWhatsAppNewsletterJid(value) {
 	const candidate = stripWhatsAppTargetPrefixes(value);
@@ -41,7 +44,8 @@ function extractUserJidPhone(jid) {
 function normalizeWhatsAppTarget(value) {
 	const candidate = stripWhatsAppTargetPrefixes(value);
 	if (!candidate) return null;
-	if (isWhatsAppGroupJid(candidate)) return `${candidate.slice(0, candidate.length - 5)}@g.us`;
+	const groupJid = normalizeWhatsAppGroupJid(candidate);
+	if (groupJid) return groupJid;
 	if (isWhatsAppNewsletterJid(candidate)) {
 		const match = candidate.match(WHATSAPP_NEWSLETTER_JID_RE);
 		return match ? `${match[1]}@newsletter` : null;

package/dist/{outbound-adapter-QDdZXpZB.js → outbound-adapter-C0p1kFXz.js}

@@ -1,12 +1,12 @@
-import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-BKcv4ofn.js";
-import { n as normalizeWhatsAppPayloadText } from "./outbound-media-contract-DwACmTqZ.js";
-import { t as createWhatsAppOutboundBase } from "./outbound-base-Cs2ntgBb.js";
+import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-Ba7sH80H.js";
+import { n as normalizeWhatsAppPayloadText } from "./outbound-media-contract-BW560jdu.js";
+import { t as createWhatsAppOutboundBase } from "./outbound-base-BMgWLjp4.js";
 import { shouldLogVerbose } from "openclaw/plugin-sdk/runtime-env";
 import { chunkText } from "openclaw/plugin-sdk/reply-chunking";
 //#region extensions/whatsapp/src/outbound-adapter.ts
 let whatsAppSendModulePromise;
 function loadWhatsAppSendModule() {
-	whatsAppSendModulePromise ??= import("./send-DG5fpuQZ.js").then((n) => n.a);
+	whatsAppSendModulePromise ??= import("./send-CByjzdb_.js").then((n) => n.a);
 	return whatsAppSendModulePromise;
 }
 function normalizeOutboundText(text) {

package/dist/{outbound-base-Cs2ntgBb.js → outbound-base-BMgWLjp4.js}

@@ -1,5 +1,5 @@
 import { p as toWhatsappJid } from "./text-runtime-CMxQczvs.js";
-import { n as normalizeWhatsAppPayloadText, t as normalizeWhatsAppOutboundPayload } from "./outbound-media-contract-DwACmTqZ.js";
+import { n as normalizeWhatsAppPayloadText, t as normalizeWhatsAppOutboundPayload } from "./outbound-media-contract-BW560jdu.js";
 import { i as lookupInboundMessageMetaForTarget } from "./quoted-message-BQsRXnac.js";
 import { DEFAULT_ACCOUNT_ID, listCombinedAccountIds, normalizeOptionalAccountId, resolveListedDefaultAccountId } from "openclaw/plugin-sdk/account-core";
 import { createAttachedChannelResultAdapter } from "openclaw/plugin-sdk/channel-send-result";
@@ -67,7 +67,7 @@ function createWhatsAppOutboundBase({ chunker, sendMessageWhatsApp, sendPollWhat
 					quotedMessageKey
 				});
 			},
-			sendMedia: async ({ cfg, to, text, mediaUrl, mediaAccess, mediaLocalRoots, mediaReadFile, audioAsVoice, accountId, deps, gifPlayback, replyToId }) => {
+			sendMedia: async ({ cfg, to, text, mediaUrl, mediaAccess, mediaLocalRoots, mediaReadFile, audioAsVoice, accountId, deps, gifPlayback, forceDocument, replyToId }) => {
 				const send = resolveOutboundSendDep(deps, "whatsapp", { legacyKeys: WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS }) ?? sendMessageWhatsApp;
 				const quotedMessageKey = resolveQuotedMessageKey({
 					accountId: resolveQuoteLookupAccountId(cfg, accountId),
@@ -84,6 +84,7 @@ function createWhatsAppOutboundBase({ chunker, sendMessageWhatsApp, sendPollWhat
 					...audioAsVoice === void 0 ? {} : { audioAsVoice },
 					accountId: accountId ?? void 0,
 					gifPlayback,
+					forceDocument,
 					quotedMessageKey
 				});
 			},

package/dist/{outbound-media-contract-DwACmTqZ.js → outbound-media-contract-BW560jdu.js}

@@ -46,7 +46,7 @@ function normalizeWhatsAppLoadedMedia(media, mediaUrl) {
 		contentType: media.contentType,
 		mediaUrl
 	}) ? WHATSAPP_VOICE_MIMETYPE : media.contentType ?? "application/octet-stream";
-	const fileName = kind === "document" ? media.fileName ?? deriveWhatsAppDocumentFileName(mediaUrl) ?? "file" : void 0;
+	const fileName = kind === "document" ? media.fileName ?? deriveWhatsAppDocumentFileName(mediaUrl) ?? "file" : media.fileName;
 	return {
 		buffer: media.buffer,
 		kind,

package/dist/outbound-payload-test-api.js

@@ -1,2 +1,2 @@
-import { t as whatsappOutbound } from "./outbound-adapter-QDdZXpZB.js";
+import { t as whatsappOutbound } from "./outbound-adapter-C0p1kFXz.js";
 export { whatsappOutbound };

package/dist/{resolve-outbound-target-BKcv4ofn.js → resolve-outbound-target-Ba7sH80H.js}

@@ -1,4 +1,4 @@
-import { c as normalizeWhatsAppTarget, n as isWhatsAppNewsletterJid, t as isWhatsAppGroupJid } from "./normalize-target-ePanEpfY.js";
+import { c as normalizeWhatsAppTarget, n as isWhatsAppNewsletterJid, t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
 import { missingTargetError } from "openclaw/plugin-sdk/channel-feedback";
 //#region extensions/whatsapp/src/resolve-outbound-target.ts
 function whatsappAllowFromPolicyError(target) {

package/dist/runtime-api.js

@@ -1,16 +1,16 @@
 import { n as resolveWebCredsBackupPath, r as resolveWebCredsPath, t as hasWebCredsSync } from "./creds-files-_2V8jzQa.js";
-import { n as whatsAppActionRuntime, t as handleWhatsAppAction } from "./action-runtime-Dig47HuK.js";
+import { n as whatsAppActionRuntime, t as handleWhatsAppAction } from "./action-runtime-fgfdJlPZ.js";
 import { n as getStatusCode, t as formatError } from "./session-errors-CSuKZPub.js";
-import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./send-DG5fpuQZ.js";
+import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./send-CByjzdb_.js";
 import { startWebLoginWithQr, waitForWebLogin } from "./login-qr-runtime.js";
 import { t as createWhatsAppLoginTool } from "./agent-tools-login-DpRxLNRB.js";
 import { n as setWhatsAppRuntime } from "./runtime-6fZ67abR.js";
 import { C as waitForCredsSaveQueueWithTimeout, S as waitForCredsSaveQueue, _ as readWebSelfIdentityForDecision, a as getWebAuthAgeMs, b as webAuthExists, c as pickWebChannel, d as readWebAuthExistsForDecision, f as readWebAuthSnapshot, g as readWebSelfIdentity, h as readWebSelfId, i as formatWhatsAppWebAuthStatusState, l as readCredsJsonRaw, m as readWebAuthState, n as WHATSAPP_AUTH_UNSTABLE_CODE, o as logWebSelfId, p as readWebAuthSnapshotBestEffort, r as WhatsAppAuthUnstableError, s as logoutWeb, t as WA_WEB_AUTH_DIR, u as readWebAuthExistsBestEffort, v as resolveDefaultWebAuthDir, w as writeCredsJsonAtomically, y as restoreCredsFromBackupIfNeeded } from "./auth-store-Cr3tg0Jm.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-yKXGCGU9.js";
-import { c as extractContactContext, d as extractMediaPlaceholder, p as extractText, u as extractLocationData } from "./send-api-DYiQpIng.js";
+import { c as extractContactContext, d as extractMediaPlaceholder, p as extractText, u as extractLocationData } from "./send-api-BNbwVO4e.js";
 import { n as newConnectionId, r as waitForWaConnection, t as createWaSocket } from "./session-B4Rnsd-V.js";
 import { n as resolveWebAccountId, t as getActiveWebListener } from "./active-listener-D2NHQ5Og.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-BVvWWOfi.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-D4UnxxWO.js";
 import { t as loginWeb } from "./login-CxQb0cqz.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-DG5fpuQZ.js → send-CByjzdb_.js}

@@ -1,11 +1,11 @@
 import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
 import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-DG18xddX.js";
 import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-B4oR6Dhx.js";
-import { n as isWhatsAppNewsletterJid } from "./normalize-target-ePanEpfY.js";
+import { n as isWhatsAppNewsletterJid } from "./normalize-target-MB6Z_4Bn.js";
 import { t as getRegisteredWhatsAppConnectionController } from "./connection-controller-registry-D_iIGz5m.js";
-import "./normalize-f31evwm8.js";
+import "./normalize-BZBRXai6.js";
 import { d as markdownToWhatsApp, p as toWhatsappJid } from "./text-runtime-CMxQczvs.js";
-import { a as resolveWhatsAppOutboundMediaUrls, i as prepareWhatsAppOutboundMedia, n as normalizeWhatsAppPayloadText } from "./outbound-media-contract-DwACmTqZ.js";
+import { a as resolveWhatsAppOutboundMediaUrls, i as prepareWhatsAppOutboundMedia, n as normalizeWhatsAppPayloadText } from "./outbound-media-contract-BW560jdu.js";
 import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
 import { generateSecureUuid } from "openclaw/plugin-sdk/core";
 import { redactIdentifier } from "openclaw/plugin-sdk/logging-core";
@@ -18,13 +18,17 @@ import { loadWebMedia } from "openclaw/plugin-sdk/web-media";
 async function loadOutboundMediaFromUrl(mediaUrl, options = {}) {
 	const readFile = options.mediaAccess?.readFile ?? options.mediaReadFile;
 	const localRoots = options.mediaAccess?.localRoots?.length && options.mediaAccess.localRoots.length > 0 ? options.mediaAccess.localRoots : options.mediaLocalRoots && options.mediaLocalRoots.length > 0 ? options.mediaLocalRoots : void 0;
-	return await loadWebMedia(mediaUrl, readFile ? {
+	const sharedOptions = {
 		...options.maxBytes !== void 0 ? { maxBytes: options.maxBytes } : {},
+		...options.optimizeImages !== void 0 ? { optimizeImages: options.optimizeImages } : {}
+	};
+	return await loadWebMedia(mediaUrl, readFile ? {
+		...sharedOptions,
 		localRoots: "any",
 		readFile,
 		hostReadCapability: true
 	} : {
-		...options.maxBytes !== void 0 ? { maxBytes: options.maxBytes } : {},
+		...sharedOptions,
 		...localRoots ? { localRoots } : {}
 	});
 }
@@ -37,6 +41,9 @@ var send_exports = /* @__PURE__ */ __exportAll({
 	sendTypingWhatsApp: () => sendTypingWhatsApp
 });
 const outboundLog = createSubsystemLogger("gateway/channels/whatsapp").child("outbound");
+function supportsForcedDocumentDelivery(kind) {
+	return kind === "image" || kind === "video";
+}
 function resolveOutboundWhatsAppAccountId(params) {
 	const explicitAccountId = params.accountId?.trim();
 	if (explicitAccountId) return explicitAccountId;
@@ -89,9 +96,11 @@ async function sendMessageWhatsApp(to, body, options) {
 		let mediaType;
 		let documentFileName;
 		let visibleTextAfterVoice;
+		let forceDocumentDelivery = false;
 		if (primaryMediaUrl) {
 			const media = await prepareWhatsAppOutboundMedia(await loadOutboundMediaFromUrl(primaryMediaUrl, {
 				maxBytes: resolveWhatsAppMediaMaxBytes(account),
+				optimizeImages: options.forceDocument ? false : void 0,
 				mediaAccess: options.mediaAccess,
 				mediaLocalRoots: options.mediaLocalRoots,
 				mediaReadFile: options.mediaReadFile
@@ -99,6 +108,7 @@ async function sendMessageWhatsApp(to, body, options) {
 			const caption = text || void 0;
 			mediaBuffer = media.buffer;
 			mediaType = media.mimetype;
+			forceDocumentDelivery = Boolean(options.forceDocument && supportsForcedDocumentDelivery(media.kind));
 			if (media.kind === "audio" && caption) {
 				visibleTextAfterVoice = caption;
 				text = "";
@@ -106,6 +116,7 @@ async function sendMessageWhatsApp(to, body, options) {
 				text = caption ?? "";
 				documentFileName = media.fileName;
 			} else text = caption ?? "";
+			if (forceDocumentDelivery) documentFileName ??= media.fileName ?? "file";
 		}
 		outboundLog.info(`Sending message -> ${redactedJid}${primaryMediaUrl ? " (media)" : ""}`);
 		logger.info({
@@ -114,8 +125,9 @@ async function sendMessageWhatsApp(to, body, options) {
 		}, "sending message");
 		if (!isWhatsAppNewsletterJid(jid)) await active.sendComposingTo(to);
 		const accountId = Boolean(options.accountId?.trim()) ? resolvedAccountId : void 0;
-		const sendOptions = options.gifPlayback || accountId || documentFileName || options.quotedMessageKey ? {
+		const sendOptions = options.gifPlayback || forceDocumentDelivery || accountId || documentFileName || options.quotedMessageKey ? {
 			...options.gifPlayback ? { gifPlayback: true } : {},
+			...forceDocumentDelivery ? { asDocument: true } : {},
 			...documentFileName ? { fileName: documentFileName } : {},
 			...options.quotedMessageKey ? { quotedMessageKey: options.quotedMessageKey } : {},
 			accountId

package/dist/{send-api-DYiQpIng.js → send-api-BNbwVO4e.js}

@@ -1,5 +1,5 @@
-import { n as isWhatsAppNewsletterJid } from "./normalize-target-ePanEpfY.js";
-import "./normalize-f31evwm8.js";
+import { n as isWhatsAppNewsletterJid } from "./normalize-target-MB6Z_4Bn.js";
+import "./normalize-BZBRXai6.js";
 import { m as toWhatsappJidWithLid, p as toWhatsappJid, u as jidToE164 } from "./text-runtime-CMxQczvs.js";
 import { t as buildQuotedMessageOptions } from "./quoted-message-BQsRXnac.js";
 import { c as resolveComparableIdentity } from "./identity-BNDkpR8N.js";
@@ -602,6 +602,9 @@ function recordWhatsAppOutbound(accountId) {
 		direction: "outbound"
 	});
 }
+function supportsForcedDocumentMediaType(mediaType) {
+	return mediaType.startsWith("image/") || mediaType.startsWith("video/");
+}
 function createWebSendApi(params) {
 	const resolveOutboundJid = (recipient) => params.authDir ? toWhatsappJidWithLid(recipient, { authDir: params.authDir }) : toWhatsappJid(recipient);
 	const resolveMentions = async (jid, text) => params.resolveOutboundMentions ? await params.resolveOutboundMentions({
@@ -621,7 +624,13 @@ function createWebSendApi(params) {
 				text,
 				mentionedJids: []
 			} : await resolveMentions(jid, text);
-			if (mediaBuffer && mediaType) if (mediaType.startsWith("image/")) payload = {
+			if (mediaBuffer && mediaType) if (sendOptions?.asDocument === true && supportsForcedDocumentMediaType(mediaType)) payload = {
+				document: mediaBuffer,
+				fileName: sendOptions?.fileName?.trim() || "file",
+				caption: resolvedPayloadText.text || void 0,
+				mimetype: mediaType
+			};
+			else if (mediaType.startsWith("image/")) payload = {
 				image: mediaBuffer,
 				caption: resolvedPayloadText.text || void 0,
 				mimetype: mediaType

package/dist/{setup-core-B5F7F8bE.js → setup-core-BFErZldJ.js}

@@ -1,6 +1,6 @@
 import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-DG18xddX.js";
 import { a as resolveWhatsAppAccount, n as hasAnyWhatsAppAuth } from "./accounts-B4oR6Dhx.js";
-import { a as normalizeWhatsAppAllowFromEntries } from "./normalize-target-ePanEpfY.js";
+import { a as normalizeWhatsAppAllowFromEntries } from "./normalize-target-MB6Z_4Bn.js";
 import { t as WhatsAppChannelConfigSchema } from "./config-schema-Dmo66Ubb.js";
 import { n as whatsappDoctor } from "./doctor-A9tXm9Om.js";
 import { t as resolveLegacyGroupSessionKey } from "./group-session-contract-DdqigLJl.js";
@@ -125,10 +125,10 @@ function resolveWhatsAppConfigPath(params) {
 	return `${resolveWhatsAppGroupScopeBasePath(params)}.${params.field}`;
 }
 async function loadWhatsAppChannelRuntime() {
-	return await import("./channel.runtime-ChxB8Ns0.js");
+	return await import("./channel.runtime-BrKncUJI.js");
 }
 async function loadWhatsAppSetupSurface() {
-	return await import("./setup-surface-7163OZHk.js");
+	return await import("./setup-surface-B5pabs1e.js");
 }
 const whatsappSetupWizardProxy = createWhatsAppSetupWizardProxy(async () => (await loadWhatsAppSetupSurface()).whatsappSetupWizard);
 const whatsappConfigAdapter = createScopedChannelConfigAdapter({

package/dist/{setup-finalize-B62sUNjU.js → setup-finalize-CnTB-PeX.js}

@@ -1,7 +1,7 @@
 import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-DG18xddX.js";
 import { a as resolveWhatsAppAccount, o as resolveWhatsAppAuthDir } from "./accounts-B4oR6Dhx.js";
-import { a as normalizeWhatsAppAllowFromEntries, o as normalizeWhatsAppAllowFromEntry } from "./normalize-target-ePanEpfY.js";
-import { t as whatsappSetupAdapter } from "./setup-core-B5F7F8bE.js";
+import { a as normalizeWhatsAppAllowFromEntries, o as normalizeWhatsAppAllowFromEntry } from "./normalize-target-MB6Z_4Bn.js";
+import { t as whatsappSetupAdapter } from "./setup-core-BFErZldJ.js";
 import path from "node:path";
 import { DEFAULT_ACCOUNT_ID, createSetupTranslator, pathExists, splitSetupEntries } from "openclaw/plugin-sdk/setup";
 import { formatCliCommand, formatDocsLink } from "openclaw/plugin-sdk/setup-tools";

package/dist/setup-plugin-api.js

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

package/dist/{setup-surface-7163OZHk.js → setup-surface-B5pabs1e.js}

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

package/dist/targets.js

@@ -1,2 +1,2 @@
-import { c as normalizeWhatsAppTarget, r as isWhatsAppUserTarget, t as isWhatsAppGroupJid } from "./normalize-target-ePanEpfY.js";
+import { c as normalizeWhatsAppTarget, r as isWhatsAppUserTarget, t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
 export { isWhatsAppGroupJid, isWhatsAppUserTarget, normalizeWhatsAppTarget };

package/dist/test-api.js

@@ -1,3 +1,3 @@
 import { t as resolveWhatsAppRuntimeGroupPolicy } from "./runtime-group-policy-BH_U23qp.js";
-import { t as whatsappOutbound } from "./outbound-adapter-QDdZXpZB.js";
+import { t as whatsappOutbound } from "./outbound-adapter-C0p1kFXz.js";
 export { resolveWhatsAppRuntimeGroupPolicy, whatsappOutbound };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/whatsapp",
-  "version": "2026.5.16-beta.3",
+  "version": "2026.5.16-beta.4",
   "description": "OpenClaw WhatsApp channel plugin",
   "repository": {
     "type": "git",
@@ -20,7 +20,7 @@
     "openclaw": "workspace:*"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.16-beta.3"
+    "openclaw": ">=2026.5.16-beta.4"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -63,10 +63,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.5.16-beta.3"
+      "pluginApi": ">=2026.5.16-beta.4"
     },
     "build": {
-      "openclawVersion": "2026.5.16-beta.3"
+      "openclawVersion": "2026.5.16-beta.4"
     },
     "release": {
       "publishToClawHub": true,

package/dist/normalize-f31evwm8.js

@@ -1,2 +0,0 @@
-import "./normalize-target-ePanEpfY.js";
-export {};