@openclaw/whatsapp 2026.5.18-beta.1 → 2026.5.19-alpha.1

package/dist/{access-control-CTFVk322.js → access-control-Blo69-dW.js}

@@ -1,4 +1,4 @@
-import { a as resolveWhatsAppAccount } from "./accounts-Dn7MUPTZ.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CJNZl-3e.js";
 import { l as isSelfChatMode, n as normalizeE164 } from "./text-runtime-DyR0XOJ4.js";
 import { a as getSelfIdentity, o as getSenderIdentity } from "./identity-CVFJuB0Q.js";
 import { t as resolveWhatsAppRuntimeGroupPolicy } from "./runtime-group-policy-BH_U23qp.js";
@@ -238,6 +238,6 @@ async function checkInboundAccessControl(params) {
 		resolvedAccountId: policy.account.accountId
 	};
 }
-const __testing = { resolveWhatsAppInboundPolicy };
+const testing = { resolveWhatsAppInboundPolicy };
 //#endregion
-export { resolveWhatsAppInboundPolicy as i, checkInboundAccessControl as n, resolveWhatsAppCommandAuthorized as r, __testing as t };
+export { resolveWhatsAppInboundPolicy as i, testing as n, resolveWhatsAppCommandAuthorized as r, checkInboundAccessControl as t };

package/dist/{account-config-CNQ33oav.js → account-config-D3OXPtpW.js}

@@ -7,12 +7,12 @@ function resolveWhatsAppDefaultAccountSharedConfig(cfg) {
 	const { enabled: _ignoredEnabled, name: _ignoredName, authDir: _ignoredAuthDir, selfChatMode: _ignoredSelfChatMode, ...sharedDefaults } = defaultAccount;
 	return sharedDefaults;
 }
-function _resolveWhatsAppAccountConfig(cfg, accountId) {
+function resolveWhatsAppAccountConfigForTest(cfg, accountId) {
 	return resolveAccountEntry(cfg.channels?.whatsapp?.accounts, accountId);
 }
 function resolveMergedNamedWhatsAppAccountConfig(params) {
 	const rootCfg = params.cfg.channels?.whatsapp;
-	const accountConfig = _resolveWhatsAppAccountConfig(params.cfg, params.accountId);
+	const accountConfig = resolveWhatsAppAccountConfigForTest(params.cfg, params.accountId);
 	return {
 		...mergeAccountConfig({
 			channelConfig: rootCfg,

package/dist/{accounts-Dn7MUPTZ.js → accounts-CJNZl-3e.js}

@@ -1,4 +1,4 @@
-import { t as resolveMergedWhatsAppAccountConfig } from "./account-config-CNQ33oav.js";
+import { t as resolveMergedWhatsAppAccountConfig } from "./account-config-D3OXPtpW.js";
 import { n as listConfiguredAccountIds, r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-DgtV_RiP.js";
 import { t as hasWebCredsSync } from "./creds-files-_2V8jzQa.js";
 import fs from "node:fs";

package/dist/action-runtime-api.js

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

package/dist/{action-runtime-CnXRJ7y1.js → action-runtime-cZLWNUXF.js}

@@ -1,7 +1,7 @@
-import { a as resolveWhatsAppAccount } from "./accounts-Dn7MUPTZ.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CJNZl-3e.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-Cn2WKdPM.js";
+import { t as resolveWhatsAppReactionLevel } from "./reaction-level-DeO7ktWb.js";
+import { r as sendReactionWhatsApp } from "./send-BtGELs96.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) {
@@ -71,4 +71,4 @@ async function handleWhatsAppAction(params, cfg) {
 	throw new Error(`Unsupported WhatsApp action: ${action}`);
 }
 //#endregion
-export { whatsAppActionRuntime as n, handleWhatsAppAction as t };
+export { whatsAppActionRuntime as n, resolveAuthorizedWhatsAppOutboundTarget as r, handleWhatsAppAction as t };

package/dist/action-runtime.runtime.js

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

package/dist/api.js

@@ -1,20 +1,20 @@
 import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-DgtV_RiP.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-Dn7MUPTZ.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-CJNZl-3e.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 "./reaction-level-DeO7ktWb.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-DyR0XOJ4.js";
-import "./send-Cn2WKdPM.js";
-import { t as whatsappPlugin } from "./channel-DVEvLLA0.js";
-import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS } from "./outbound-base-Dfj1SAyO.js";
+import "./send-BtGELs96.js";
+import { t as whatsappPlugin } from "./channel-CHsR8MoG.js";
+import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS } from "./outbound-base-ARCS45ql.js";
 import { t as whatsappCommandPolicy } from "./command-policy-O8sRnqUV.js";
-import { a as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint } from "./setup-core-Dm2jMZHy.js";
+import { a as resolveWhatsAppGroupRequireMention, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint } from "./setup-core-P6dnz4Ur.js";
 import "./config-schema-Dmo66Ubb.js";
-import { t as whatsappSetupPlugin } from "./channel.setup-BLFtofME.js";
+import { t as whatsappSetupPlugin } from "./channel.setup-BiuhxbjG.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-yKXGCGU9.js";
-import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-BfyInQuH.js";
-import { t as __testing } from "./access-control-CTFVk322.js";
-import { p as extractText, t as createWebSendApi } from "./send-api-CwheV1Iq.js";
+import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-QH8Oe8bc.js";
+import { n as testing } from "./access-control-Blo69-dW.js";
+import { p as extractText, t as createWebSendApi } from "./send-api-BvUGZEIA.js";
 import { r as waitForWaConnection, t as createWaSocket } from "./session-DqDc1usL.js";
 import "openclaw/plugin-sdk/channel-actions";
 import "openclaw/plugin-sdk/account-resolution";
@@ -126,4 +126,4 @@ async function startWhatsAppQaDriverSession(params) {
 	};
 }
 //#endregion
-export { DEFAULT_WEB_MEDIA_BYTES, DEFAULT_WHATSAPP_MEDIA_MAX_MB, WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS, assertWebChannel, hasAnyWhatsAppAuth, isSelfChatMode, isWhatsAppGroupJid, isWhatsAppUserTarget, jidToE164, listEnabledWhatsAppAccounts, listAccountIds as listWhatsAppAccountIds, listWhatsAppAuthDirs, listWhatsAppDirectoryGroupsFromConfig, listWhatsAppDirectoryPeersFromConfig, looksLikeWhatsAppTargetId, markdownToWhatsApp, normalizeE164, normalizeWhatsAppAllowFromEntries, normalizeWhatsAppMessagingTarget, normalizeWhatsAppTarget, resolveDefaultWhatsAppAccountId, resolveJidToE164, resolveUserPath, resolveWhatsAppAccount, resolveWhatsAppAuthDir, resolveWhatsAppGroupIntroHint, resolveWhatsAppGroupRequireMention, resolveWhatsAppGroupToolPolicy, resolveWhatsAppMediaMaxBytes, resolveWhatsAppOutboundTarget, startWhatsAppQaDriverSession, toWhatsappJid, toWhatsappJidWithLid, __testing as whatsappAccessControlTesting, whatsappCommandPolicy, whatsappPlugin, whatsappSetupPlugin };
+export { DEFAULT_WEB_MEDIA_BYTES, DEFAULT_WHATSAPP_MEDIA_MAX_MB, WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS, assertWebChannel, hasAnyWhatsAppAuth, isSelfChatMode, isWhatsAppGroupJid, isWhatsAppUserTarget, jidToE164, listEnabledWhatsAppAccounts, listAccountIds as listWhatsAppAccountIds, listWhatsAppAuthDirs, listWhatsAppDirectoryGroupsFromConfig, listWhatsAppDirectoryPeersFromConfig, looksLikeWhatsAppTargetId, markdownToWhatsApp, normalizeE164, normalizeWhatsAppAllowFromEntries, normalizeWhatsAppMessagingTarget, normalizeWhatsAppTarget, resolveDefaultWhatsAppAccountId, resolveJidToE164, resolveUserPath, resolveWhatsAppAccount, resolveWhatsAppAuthDir, resolveWhatsAppGroupIntroHint, resolveWhatsAppGroupRequireMention, resolveWhatsAppGroupToolPolicy, resolveWhatsAppMediaMaxBytes, resolveWhatsAppOutboundTarget, startWhatsAppQaDriverSession, toWhatsappJid, toWhatsappJidWithLid, testing as whatsappAccessControlTesting, whatsappCommandPolicy, whatsappPlugin, whatsappSetupPlugin };

package/dist/{channel-DVEvLLA0.js → channel-CHsR8MoG.js}

@@ -1,16 +1,16 @@
 import { t as listAccountIds } from "./account-ids-DgtV_RiP.js";
-import { a as resolveWhatsAppAccount } from "./accounts-Dn7MUPTZ.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CJNZl-3e.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 { r as normalizeWhatsAppPayloadTextPreservingIndentation } from "./outbound-media-contract-CQnjZqsm.js";
+import { t as resolveWhatsAppReactionLevel } from "./reaction-level-DeO7ktWb.js";
+import { r as normalizeWhatsAppPayloadTextPreservingIndentation } from "./outbound-media-contract-ItL7G0Az.js";
 import "./normalize-LMXvL6w0.js";
-import { i as sendTypingWhatsApp, n as sendPollWhatsApp, t as sendMessageWhatsApp } from "./send-Cn2WKdPM.js";
+import { i as sendTypingWhatsApp, n as sendPollWhatsApp, t as sendMessageWhatsApp } from "./send-BtGELs96.js";
 import { t as createWhatsAppLoginTool } from "./agent-tools-login-DpRxLNRB.js";
-import { t as createWhatsAppOutboundBase } from "./outbound-base-Dfj1SAyO.js";
+import { t as createWhatsAppOutboundBase } from "./outbound-base-ARCS45ql.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-Dm2jMZHy.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-P6dnz4Ur.js";
 import { f as readWebAuthExistsForDecision, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-BLGYDyCH.js";
 import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-CtdIArlK.js";
 import { createActionGate as createActionGate$1 } from "openclaw/plugin-sdk/channel-actions";
@@ -87,6 +87,7 @@ function describeWhatsAppMessageActions(params) {
 		accountId: params.accountId ?? void 0
 	}) : hasAnyWhatsAppAccountWithAgentReactionsEnabled(params.cfg)) actions.add("react");
 	if (gate("polls")) actions.add("poll");
+	actions.add("upload-file");
 	return { actions: Array.from(actions) };
 }
 //#endregion
@@ -321,8 +322,8 @@ function collectWhatsAppStatusIssues(accounts) {
 }
 //#endregion
 //#region extensions/whatsapp/src/channel.ts
-const loadWhatsAppDirectoryConfig = createLazyRuntimeModule(() => import("./directory-config-BfyInQuH.js").then((n) => n.t));
-const loadWhatsAppChannelReactAction = createLazyRuntimeModule(() => import("./channel-react-action-UYINADWb.js"));
+const loadWhatsAppDirectoryConfig = createLazyRuntimeModule(() => import("./directory-config-QH8Oe8bc.js").then((n) => n.t));
+const loadWhatsAppChannelReactAction = createLazyRuntimeModule(() => import("./channel-react-action-6n63NhGY.js"));
 function parseWhatsAppExplicitTarget(raw) {
 	const normalized = normalizeWhatsAppTarget(raw);
 	if (!normalized) return null;
@@ -418,14 +419,17 @@ const whatsappPlugin = createChatChannelPlugin({
 				cfg,
 				accountId
 			}),
-			supportsAction: ({ action }) => action === "react",
-			resolveExecutionMode: ({ action }) => action === "react" ? "gateway" : "local",
-			handleAction: async ({ action, params, cfg, accountId, requesterSenderId, toolContext }) => await (await loadWhatsAppChannelReactAction()).handleWhatsAppReactAction({
+			supportsAction: ({ action }) => action === "react" || action === "upload-file",
+			resolveExecutionMode: ({ action }) => action === "react" || action === "upload-file" ? "gateway" : "local",
+			handleAction: async ({ action, params, cfg, accountId, requesterSenderId, mediaAccess, mediaLocalRoots, mediaReadFile, toolContext }) => await (await loadWhatsAppChannelReactAction()).handleWhatsAppMessageAction({
 				action,
 				params,
 				cfg,
 				accountId,
 				requesterSenderId,
+				mediaAccess,
+				mediaLocalRoots,
+				mediaReadFile,
 				toolContext
 			})
 		},

package/dist/channel-plugin-api.js

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

package/dist/channel-react-action-6n63NhGY.js

@@ -0,0 +1,129 @@
+import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-CJNZl-3e.js";
+import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
+import { r as resolveAuthorizedWhatsAppOutboundTarget, t as handleWhatsAppAction } from "./action-runtime-cZLWNUXF.js";
+import "./normalize-LMXvL6w0.js";
+import { t as sendMessageWhatsApp } from "./send-BtGELs96.js";
+import { jsonResult, readStringOrNumberParam, readStringParam as readStringParam$1, resolveReactionMessageId } from "openclaw/plugin-sdk/channel-actions";
+//#region extensions/whatsapp/src/channel-react-action.ts
+const WHATSAPP_CHANNEL = "whatsapp";
+function readUploadFileMediaSource(args) {
+	return readStringParam$1(args, "media", { trim: false }) ?? readStringParam$1(args, "mediaUrl", { trim: false }) ?? readStringParam$1(args, "filePath", { trim: false }) ?? readStringParam$1(args, "path", { trim: false }) ?? readStringParam$1(args, "fileUrl", { trim: false });
+}
+function readUploadFileCaptionText(args) {
+	return readStringParam$1(args, "message", { allowEmpty: true }) ?? readStringParam$1(args, "content", { allowEmpty: true }) ?? readStringParam$1(args, "caption", { allowEmpty: true }) ?? "";
+}
+function readBooleanParam(args, key) {
+	const value = args[key];
+	if (typeof value === "boolean") return value;
+	if (typeof value !== "string") return;
+	const normalized = value.trim().toLowerCase();
+	if (normalized === "true") return true;
+	if (normalized === "false") return false;
+}
+function hasUploadFileBufferPayload(args) {
+	return readStringParam$1(args, "buffer", { trim: false }) !== void 0;
+}
+function extractBase64Payload(encoded) {
+	const match = /^data:[^;]+;base64,(.*)$/i.exec(encoded.trim());
+	return match ? match[1] : encoded;
+}
+function estimateBase64DecodedBytes(encoded) {
+	const compact = extractBase64Payload(encoded).replace(/\s/g, "");
+	if (!compact) return 0;
+	const padding = compact.endsWith("==") ? 2 : compact.endsWith("=") ? 1 : 0;
+	return Math.max(0, Math.floor(compact.length * 3 / 4) - padding);
+}
+function decodeUploadFileMediaPayload(params) {
+	if (params.maxBytes !== void 0) {
+		const estimatedBytes = estimateBase64DecodedBytes(params.encoded);
+		if (estimatedBytes > params.maxBytes) throw new Error(`WhatsApp upload-file buffer exceeds configured media limit (${estimatedBytes} bytes > ${params.maxBytes} bytes).`);
+	}
+	const contentType = readStringParam$1(params.args, "contentType") ?? readStringParam$1(params.args, "mimeType");
+	const fileName = readStringParam$1(params.args, "filename") ?? readStringParam$1(params.args, "fileName");
+	const buffer = Buffer.from(extractBase64Payload(params.encoded), "base64");
+	if (params.maxBytes !== void 0 && buffer.byteLength > params.maxBytes) throw new Error(`WhatsApp upload-file buffer exceeds configured media limit (${buffer.byteLength} bytes > ${params.maxBytes} bytes).`);
+	return {
+		buffer,
+		...contentType ? { contentType } : {},
+		...fileName ? { fileName } : {}
+	};
+}
+async function handleWhatsAppUploadFileAction(params) {
+	const mediaUrl = readUploadFileMediaSource(params.params);
+	const encodedPayload = readStringParam$1(params.params, "buffer", { trim: false });
+	if (!mediaUrl && !hasUploadFileBufferPayload(params.params)) throw new Error("WhatsApp upload-file requires media, mediaUrl, filePath, path, fileUrl, or buffer.");
+	const to = readStringParam$1(params.params, "to", { required: true });
+	const resolved = resolveAuthorizedWhatsAppOutboundTarget({
+		cfg: params.cfg,
+		chatJid: to,
+		accountId: params.accountId ?? void 0,
+		actionLabel: "upload-file"
+	});
+	const account = resolveWhatsAppAccount({
+		cfg: params.cfg,
+		accountId: resolved.accountId
+	});
+	const mediaPayload = encodedPayload ? decodeUploadFileMediaPayload({
+		args: params.params,
+		encoded: encodedPayload,
+		maxBytes: resolveWhatsAppMediaMaxBytes(account)
+	}) : void 0;
+	const result = await sendMessageWhatsApp(resolved.to, readUploadFileCaptionText(params.params), {
+		verbose: false,
+		cfg: params.cfg,
+		...mediaUrl && !mediaPayload ? { mediaUrl } : {},
+		...mediaPayload ? { mediaPayload } : {},
+		mediaAccess: params.mediaAccess,
+		mediaLocalRoots: params.mediaLocalRoots,
+		mediaReadFile: params.mediaReadFile,
+		gifPlayback: readBooleanParam(params.params, "gifPlayback") ?? void 0,
+		audioAsVoice: readBooleanParam(params.params, "asVoice") ?? readBooleanParam(params.params, "audioAsVoice") ?? void 0,
+		forceDocument: readBooleanParam(params.params, "forceDocument") ?? readBooleanParam(params.params, "asDocument") ?? void 0,
+		accountId: resolved.accountId
+	});
+	return jsonResult({
+		ok: true,
+		channel: WHATSAPP_CHANNEL,
+		action: "upload-file",
+		messageId: result.messageId,
+		toJid: result.toJid
+	});
+}
+async function handleWhatsAppMessageAction(params) {
+	if (params.action === "upload-file") return await handleWhatsAppUploadFileAction(params);
+	if (params.action !== "react") throw new Error(`Action ${params.action} is not supported for provider ${WHATSAPP_CHANNEL}.`);
+	const isWhatsAppSource = params.toolContext?.currentChannelProvider === WHATSAPP_CHANNEL;
+	const explicitTarget = readStringParam$1(params.params, "chatJid") ?? readStringParam$1(params.params, "to");
+	const normalizedTarget = explicitTarget ? normalizeWhatsAppTarget(explicitTarget) : null;
+	const normalizedCurrent = isWhatsAppSource && params.toolContext?.currentChannelId ? normalizeWhatsAppTarget(params.toolContext.currentChannelId) : null;
+	const isCrossChat = normalizedTarget != null && (normalizedCurrent == null || normalizedTarget !== normalizedCurrent);
+	const scopedContext = !isWhatsAppSource || isCrossChat || !params.toolContext ? void 0 : {
+		currentChannelId: params.toolContext.currentChannelId ?? void 0,
+		currentChannelProvider: params.toolContext.currentChannelProvider ?? void 0,
+		currentMessageId: params.toolContext.currentMessageId ?? void 0
+	};
+	const messageIdRaw = resolveReactionMessageId({
+		args: params.params,
+		toolContext: scopedContext
+	});
+	if (messageIdRaw == null) readStringParam$1(params.params, "messageId", { required: true });
+	const messageId = String(messageIdRaw);
+	const explicitMessageId = readStringOrNumberParam(params.params, "messageId");
+	const emoji = readStringParam$1(params.params, "emoji", { allowEmpty: true });
+	const remove = typeof params.params.remove === "boolean" ? params.params.remove : void 0;
+	const explicitParticipant = readStringParam$1(params.params, "participant");
+	const inferredParticipant = explicitParticipant || explicitMessageId != null || !isWhatsAppSource || isCrossChat || !isWhatsAppGroupJid(explicitTarget ?? params.toolContext?.currentChannelId ?? "") ? void 0 : typeof params.requesterSenderId === "string" && params.requesterSenderId.trim().length > 0 ? params.requesterSenderId.trim() : void 0;
+	return await handleWhatsAppAction({
+		action: "react",
+		chatJid: readStringParam$1(params.params, "chatJid") ?? readStringParam$1(params.params, "to", { required: true }),
+		messageId,
+		emoji,
+		remove,
+		participant: explicitParticipant ?? inferredParticipant,
+		accountId: params.accountId ?? void 0,
+		fromMe: typeof params.params.fromMe === "boolean" ? params.params.fromMe : void 0
+	}, params.cfg);
+}
+const handleWhatsAppReactAction = handleWhatsAppMessageAction;
+//#endregion
+export { handleWhatsAppMessageAction, handleWhatsAppReactAction };

package/dist/{channel.runtime-Bahb-X2a.js → channel.runtime-n14SNsjm.js}

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

package/dist/{channel.setup-BLFtofME.js → channel.setup-BiuhxbjG.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-Dm2jMZHy.js";
+import { a as resolveWhatsAppGroupRequireMention, i as whatsappSetupWizardProxy, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint, t as whatsappSetupAdapter } from "./setup-core-P6dnz4Ur.js";
 import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-CtdIArlK.js";
 //#region extensions/whatsapp/src/channel.setup.ts
 async function isWhatsAppAuthConfigured(account) {

package/dist/contract-api.js

@@ -3,9 +3,9 @@ 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-BfyInQuH.js";
+import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./directory-config-QH8Oe8bc.js";
 import { t as resolveWhatsAppRuntimeGroupPolicy$1 } from "./runtime-group-policy-BH_U23qp.js";
-import { t as __testing } from "./access-control-CTFVk322.js";
+import { n as testing } from "./access-control-Blo69-dW.js";
 //#region extensions/whatsapp/contract-api.ts
 const canonicalizeLegacySessionKey = canonicalizeLegacySessionKey$1;
 const isLegacyGroupSessionKey = isLegacyGroupSessionKey$1;
@@ -13,7 +13,7 @@ const isWhatsAppGroupJid = isWhatsAppGroupJid$1;
 const normalizeWhatsAppTarget = normalizeWhatsAppTarget$1;
 const resolveLegacyGroupSessionKey = resolveLegacyGroupSessionKey$1;
 const resolveWhatsAppRuntimeGroupPolicy = resolveWhatsAppRuntimeGroupPolicy$1;
-const whatsappAccessControlTesting = __testing;
+const whatsappAccessControlTesting = testing;
 const whatsappCommandPolicy = whatsappCommandPolicy$1;
 //#endregion
 export { canonicalizeLegacySessionKey, collectUnsupportedSecretRefConfigCandidates, isLegacyGroupSessionKey, isWhatsAppGroupJid, listWhatsAppDirectoryGroupsFromConfig, listWhatsAppDirectoryPeersFromConfig, normalizeWhatsAppTarget, resolveLegacyGroupSessionKey, resolveWhatsAppRuntimeGroupPolicy, unsupportedSecretRefSurfacePatterns, whatsappAccessControlTesting, whatsappCommandPolicy };

package/dist/{directory-config-BfyInQuH.js → directory-config-QH8Oe8bc.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
-import { t as resolveMergedWhatsAppAccountConfig } from "./account-config-CNQ33oav.js";
+import { t as resolveMergedWhatsAppAccountConfig } from "./account-config-D3OXPtpW.js";
 import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
 import "./normalize-LMXvL6w0.js";
 import { listResolvedDirectoryGroupEntriesFromMapKeys, listResolvedDirectoryUserEntriesFromAllowFrom } from "openclaw/plugin-sdk/directory-config-runtime";

package/dist/directory-contract-api.js

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

package/dist/{login-CDwsln_y.js → login-DJYp3l4Z.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
-import { a as resolveWhatsAppAccount } from "./accounts-Dn7MUPTZ.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CJNZl-3e.js";
 import { b as restoreCredsFromBackupIfNeeded } from "./auth-store-BLGYDyCH.js";
 import { a as renderQrTerminal, i as resolveWhatsAppSocketTiming, t as createWaSocket } from "./session-DqDc1usL.js";
 import { a as closeWaSocketSoon, o as waitForWhatsAppLoginResult } from "./connection-controller-Cq6sY2mA.js";

package/dist/{login-qr-B63JLtJG.js → login-qr-CipY7q23.js}

@@ -1,4 +1,4 @@
-import { a as resolveWhatsAppAccount } from "./accounts-Dn7MUPTZ.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CJNZl-3e.js";
 import { f as readWebAuthExistsForDecision, g as readWebSelfId, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-BLGYDyCH.js";
 import { i as resolveWhatsAppSocketTiming, t as createWaSocket } from "./session-DqDc1usL.js";
 import { i as closeWaSocket, o as waitForWhatsAppLoginResult, t as WHATSAPP_LOGGED_OUT_QR_MESSAGE } from "./connection-controller-Cq6sY2mA.js";

package/dist/login-qr-runtime.js

@@ -1,7 +1,7 @@
 //#region extensions/whatsapp/login-qr-runtime.ts
 let loginQrModulePromise = null;
 function loadLoginQrModule() {
-	loginQrModulePromise ??= import("./login-qr-B63JLtJG.js");
+	loginQrModulePromise ??= import("./login-qr-CipY7q23.js");
 	return loginQrModulePromise;
 }
 async function startWebLoginWithQr(...args) {

package/dist/{monitor-DSBROC8j.js → monitor-oXSnOpto.js}

@@ -1,15 +1,15 @@
-import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-Dn7MUPTZ.js";
+import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-CJNZl-3e.js";
 import { t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
-import { t as resolveWhatsAppReactionLevel } from "./reaction-level-2m9sWGCw.js";
-import { i as prepareWhatsAppOutboundMedia, o as sendWhatsAppOutboundWithRetry, r as normalizeWhatsAppPayloadTextPreservingIndentation, t as normalizeWhatsAppOutboundPayload } from "./outbound-media-contract-CQnjZqsm.js";
+import { t as resolveWhatsAppReactionLevel } from "./reaction-level-DeO7ktWb.js";
+import { i as prepareWhatsAppOutboundMedia, o as sendWhatsAppOutboundWithRetry, r as normalizeWhatsAppPayloadTextPreservingIndentation, t as normalizeWhatsAppOutboundPayload } from "./outbound-media-contract-ItL7G0Az.js";
 import { n as getStatusCode, t as formatError } from "./session-errors-KYQIoX8M.js";
 import { d as markdownToWhatsApp, f as resolveJidToE164, l as isSelfChatMode, n as normalizeE164, t as convertMarkdownTables$1, u as jidToE164 } from "./text-runtime-DyR0XOJ4.js";
-import { r as sendReactionWhatsApp } from "./send-Cn2WKdPM.js";
+import { r as sendReactionWhatsApp } from "./send-BtGELs96.js";
 import { n as cacheInboundMessageMeta, r as lookupInboundMessageMeta, t as buildQuotedMessageOptions } from "./quoted-message-C5vX90mp.js";
 import { c as logoutWeb, g as readWebSelfId, o as getWebAuthAgeMs, r as WhatsAppAuthUnstableError, v as readWebSelfIdentityForDecision } from "./auth-store-BLGYDyCH.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-CVFJuB0Q.js";
-import { i as resolveWhatsAppInboundPolicy, n as checkInboundAccessControl, r as resolveWhatsAppCommandAuthorized } from "./access-control-CTFVk322.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-CwheV1Iq.js";
+import { i as resolveWhatsAppInboundPolicy, r as resolveWhatsAppCommandAuthorized, t as checkInboundAccessControl } from "./access-control-Blo69-dW.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-BvUGZEIA.js";
 import { i as resolveWhatsAppSocketTiming, r as waitForWaConnection, t as createWaSocket } from "./session-DqDc1usL.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-Cq6sY2mA.js";
 import { resolveAccountEntry } from "openclaw/plugin-sdk/account-core";
@@ -1020,6 +1020,17 @@ function createEchoTracker(params) {
 	};
 }
 //#endregion
+//#region extensions/whatsapp/src/auto-reply/monitor/listener-log.ts
+function formatWhatsAppInboundListeningLog(account) {
+	if (account.groupPolicy === "disabled") return "Listening for WhatsApp inbound messages (DM + groups disabled by groupPolicy).";
+	if (account.groupPolicy === "allowlist" && !account.hasGroupAllowFrom) return "Listening for WhatsApp inbound messages (DM + group inbound blocked by empty groupPolicy allowlist).";
+	const groups = account.groups ?? {};
+	if (Object.keys(groups).length === 0) return `Listening for WhatsApp inbound messages (DM + all groups; ${account.groupPolicy === "allowlist" ? "sender allowlist configured" : "no group allowlist configured"}).`;
+	if (Object.hasOwn(groups, "*")) return "Listening for WhatsApp inbound messages (DM + all groups; wildcard configured).";
+	const explicitGroupCount = Object.keys(groups).length;
+	return `Listening for WhatsApp inbound messages (DM + ${explicitGroupCount} configured ${explicitGroupCount === 1 ? "group" : "groups"}).`;
+}
+//#endregion
 //#region extensions/whatsapp/src/group-session-key.ts
 function resolveWhatsAppGroupAccountThreadId(accountId) {
 	return `whatsapp-account-${normalizeAccountId$1(accountId)}`;
@@ -1298,7 +1309,7 @@ async function applyGroupGating(params) {
 	});
 	const conversationGroupPolicy = inboundPolicy.resolveConversationGroupPolicy(params.conversationId);
 	if (conversationGroupPolicy.allowlistEnabled && !conversationGroupPolicy.allowed) {
-		params.logVerbose(`Skipping group message ${params.conversationId} (not in allowlist)`);
+		params.logVerbose(`Dropping message from unregistered WhatsApp group ${params.conversationId}. Add the group JID to channels.whatsapp.groups, or add "*" there to admit all groups. Sender authorization still applies.`);
 		return { shouldProcess: false };
 	}
 	noteGroupMember(params.groupMemberNames, params.groupHistoryKey, sender.e164 ?? void 0, sender.name ?? void 0);
@@ -3083,13 +3094,40 @@ async function monitorWebChannel(verbose, listenerFactory = attachWebInboxToSock
 					error: String(err)
 				}, "reconnect drain failed");
 			});
-			whatsappLog.info("Listening for personal WhatsApp inbound messages.");
+			const periodicDrainInterval = setInterval(() => {
+				drainPendingDeliveries({
+					drainKey: `whatsapp:${normalizedAccountId}`,
+					logLabel: "WhatsApp periodic drain",
+					cfg,
+					log: reconnectLogger,
+					selectEntry: (entry) => ({
+						match: entry.channel === "whatsapp" && normalizeReconnectAccountId(entry.accountId) === normalizedAccountId,
+						bypassBackoff: false
+					})
+				}).catch((err) => {
+					reconnectLogger.warn({
+						connectionId: connection.connectionId,
+						error: String(err)
+					}, "periodic drain failed");
+				});
+			}, 3e4);
+			const inboundPolicy = resolveWhatsAppInboundPolicy({
+				cfg,
+				accountId: account.accountId,
+				selfE164: selfE164 ?? null
+			});
+			whatsappLog.info(formatWhatsAppInboundListeningLog({
+				groups: inboundPolicy.account.groups,
+				groupPolicy: inboundPolicy.groupPolicy,
+				hasGroupAllowFrom: inboundPolicy.groupAllowFrom.length > 0
+			}));
 			if (process.stdout.isTTY || process.stderr.isTTY) whatsappLog.raw("Ctrl+C to stop.");
 			if (!keepAlive) {
+				clearInterval(periodicDrainInterval);
 				await controller.shutdown();
 				return;
 			}
-			const reason = await controller.waitForClose();
+			const reason = await controller.waitForClose().finally(() => clearInterval(periodicDrainInterval));
 			if (stopRequested() || sigintStop || reason === "aborted") {
 				await controller.shutdown();
 				break;

package/dist/{outbound-adapter-pW4J6iz-.js → outbound-adapter-BT7Dkqni.js}

@@ -1,12 +1,12 @@
 import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-Ba7sH80H.js";
-import { n as normalizeWhatsAppPayloadText } from "./outbound-media-contract-CQnjZqsm.js";
-import { t as createWhatsAppOutboundBase } from "./outbound-base-Dfj1SAyO.js";
+import { n as normalizeWhatsAppPayloadText } from "./outbound-media-contract-ItL7G0Az.js";
+import { t as createWhatsAppOutboundBase } from "./outbound-base-ARCS45ql.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-Cn2WKdPM.js").then((n) => n.a);
+	whatsAppSendModulePromise ??= import("./send-BtGELs96.js").then((n) => n.a);
 	return whatsAppSendModulePromise;
 }
 function normalizeOutboundText(text) {

package/dist/{outbound-base-Dfj1SAyO.js → outbound-base-ARCS45ql.js}

@@ -1,4 +1,4 @@
-import { n as normalizeWhatsAppPayloadText, t as normalizeWhatsAppOutboundPayload } from "./outbound-media-contract-CQnjZqsm.js";
+import { n as normalizeWhatsAppPayloadText, t as normalizeWhatsAppOutboundPayload } from "./outbound-media-contract-ItL7G0Az.js";
 import { p as toWhatsappJid } from "./text-runtime-DyR0XOJ4.js";
 import { i as lookupInboundMessageMetaForTarget } from "./quoted-message-C5vX90mp.js";
 import { DEFAULT_ACCOUNT_ID, listCombinedAccountIds, normalizeOptionalAccountId, resolveListedDefaultAccountId } from "openclaw/plugin-sdk/account-core";

package/dist/{outbound-media-contract-CQnjZqsm.js → outbound-media-contract-ItL7G0Az.js}

@@ -51,8 +51,16 @@ function normalizeWhatsAppOutboundPayload(payload, options) {
 		mediaUrls: mediaUrls.length > 0 ? mediaUrls : void 0
 	};
 }
+function inferWhatsAppMediaKind(media) {
+	if (media.kind === "image" || media.kind === "audio" || media.kind === "video" || media.kind === "document") return media.kind;
+	const contentType = normalizeContentType(media.contentType);
+	if (contentType.startsWith("image/")) return "image";
+	if (contentType.startsWith("audio/")) return "audio";
+	if (contentType.startsWith("video/")) return "video";
+	return "document";
+}
 function normalizeWhatsAppLoadedMedia(media, mediaUrl) {
-	const kind = media.kind === "image" || media.kind === "audio" || media.kind === "video" ? media.kind : "document";
+	const kind = inferWhatsAppMediaKind(media);
 	const mimetype = kind === "audio" && isWhatsAppNativeVoiceAudio({
 		contentType: media.contentType,
 		mediaUrl

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

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

package/dist/{reaction-level-2m9sWGCw.js → reaction-level-DeO7ktWb.js}

@@ -1,4 +1,4 @@
-import { t as resolveMergedWhatsAppAccountConfig } from "./account-config-CNQ33oav.js";
+import { t as resolveMergedWhatsAppAccountConfig } from "./account-config-D3OXPtpW.js";
 import { resolveReactionLevel } from "openclaw/plugin-sdk/status-helpers";
 //#region extensions/whatsapp/src/reaction-level.ts
 /** Resolve the effective reaction level and its implications for WhatsApp. */

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-CnXRJ7y1.js";
+import { n as whatsAppActionRuntime, t as handleWhatsAppAction } from "./action-runtime-cZLWNUXF.js";
 import { n as getStatusCode, t as formatError } from "./session-errors-KYQIoX8M.js";
-import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./send-Cn2WKdPM.js";
+import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./send-BtGELs96.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 waitForCredsSaveQueue, T as writeCredsJsonAtomically, _ as readWebSelfIdentity, a as formatWhatsAppWebAuthStatusState, b as restoreCredsFromBackupIfNeeded, c as logoutWeb, d as readWebAuthExistsBestEffort, f as readWebAuthExistsForDecision, g as readWebSelfId, h as readWebAuthState, l as pickWebChannel, m as readWebAuthSnapshotBestEffort, n as WHATSAPP_AUTH_UNSTABLE_CODE, o as getWebAuthAgeMs, p as readWebAuthSnapshot, r as WhatsAppAuthUnstableError, s as logWebSelfId, t as WA_WEB_AUTH_DIR, u as readCredsJsonRaw, v as readWebSelfIdentityForDecision, w as waitForCredsSaveQueueWithTimeout, x as webAuthExists, y as resolveDefaultWebAuthDir } from "./auth-store-BLGYDyCH.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-CwheV1Iq.js";
+import { c as extractContactContext, d as extractMediaPlaceholder, p as extractText, u as extractLocationData } from "./send-api-BvUGZEIA.js";
 import { n as newConnectionId, r as waitForWaConnection, t as createWaSocket } from "./session-DqDc1usL.js";
 import { n as resolveWebAccountId, t as getActiveWebListener } from "./active-listener-C4ClVut4.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-DSBROC8j.js";
-import { t as loginWeb } from "./login-CDwsln_y.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-oXSnOpto.js";
+import { t as loginWeb } from "./login-DJYp3l4Z.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-Cn2WKdPM.js → send-BtGELs96.js}

@@ -1,9 +1,9 @@
 import { t as __exportAll } from "./rolldown-runtime-CiIaOW0V.js";
 import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-DgtV_RiP.js";
-import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-Dn7MUPTZ.js";
+import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-CJNZl-3e.js";
 import { n as isWhatsAppNewsletterJid } from "./normalize-target-MB6Z_4Bn.js";
 import { t as getRegisteredWhatsAppConnectionController } from "./connection-controller-registry-D_iIGz5m.js";
-import { a as resolveWhatsAppOutboundMediaUrls, i as prepareWhatsAppOutboundMedia, n as normalizeWhatsAppPayloadText, s as resolveWhatsAppDocumentFileName } from "./outbound-media-contract-CQnjZqsm.js";
+import { a as resolveWhatsAppOutboundMediaUrls, i as prepareWhatsAppOutboundMedia, n as normalizeWhatsAppPayloadText, s as resolveWhatsAppDocumentFileName } from "./outbound-media-contract-ItL7G0Az.js";
 import "./normalize-LMXvL6w0.js";
 import { d as markdownToWhatsApp, p as toWhatsappJid } from "./text-runtime-DyR0XOJ4.js";
 import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
@@ -61,8 +61,11 @@ function requireOutboundActiveWebListener(params) {
 async function sendMessageWhatsApp(to, body, options) {
 	let text = options.preserveLeadingWhitespace ? body : normalizeWhatsAppPayloadText(body);
 	const jid = toWhatsappJid(to);
-	const primaryMediaUrl = resolveWhatsAppOutboundMediaUrls(options)[0];
-	if (!text && !primaryMediaUrl) return {
+	const mediaUrls = resolveWhatsAppOutboundMediaUrls(options);
+	const mediaPayload = options.mediaPayload;
+	const primaryMediaUrl = mediaUrls[0] ?? mediaPayload?.fileName;
+	const hasMedia = Boolean(mediaPayload || primaryMediaUrl);
+	if (!text && !hasMedia) return {
 		messageId: "",
 		toJid: jid
 	};
@@ -97,7 +100,24 @@ async function sendMessageWhatsApp(to, body, options) {
 		let documentFileName;
 		let visibleTextAfterVoice;
 		let forceDocumentDelivery = false;
-		if (primaryMediaUrl) {
+		if (mediaPayload) {
+			const media = await prepareWhatsAppOutboundMedia(mediaPayload, primaryMediaUrl);
+			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 = "";
+			} else if (media.kind === "document") {
+				text = caption ?? "";
+				documentFileName = media.fileName;
+			} else text = caption ?? "";
+			if (forceDocumentDelivery) documentFileName ??= resolveWhatsAppDocumentFileName({
+				fileName: media.fileName,
+				mimetype: media.mimetype
+			});
+		} else if (primaryMediaUrl) {
 			const media = await prepareWhatsAppOutboundMedia(await loadOutboundMediaFromUrl(primaryMediaUrl, {
 				maxBytes: resolveWhatsAppMediaMaxBytes(account),
 				optimizeImages: options.forceDocument ? false : void 0,
@@ -121,10 +141,10 @@ async function sendMessageWhatsApp(to, body, options) {
 				mimetype: media.mimetype
 			});
 		}
-		outboundLog.info(`Sending message -> ${redactedJid}${primaryMediaUrl ? " (media)" : ""}`);
+		outboundLog.info(`Sending message -> ${redactedJid}${hasMedia ? " (media)" : ""}`);
 		logger.info({
 			jid: redactedJid,
-			hasMedia: Boolean(primaryMediaUrl)
+			hasMedia
 		}, "sending message");
 		if (!isWhatsAppNewsletterJid(jid)) await active.sendComposingTo(to);
 		const accountId = Boolean(options.accountId?.trim()) ? resolvedAccountId : void 0;
@@ -140,7 +160,7 @@ async function sendMessageWhatsApp(to, body, options) {
 		else await active.sendMessage(to, visibleTextAfterVoice, void 0, void 0);
 		const messageId = result?.messageId ?? "unknown";
 		const durationMs = Date.now() - startedAt;
-		outboundLog.info(`Sent message ${messageId} -> ${redactedJid}${primaryMediaUrl ? " (media)" : ""} (${durationMs}ms)`);
+		outboundLog.info(`Sent message ${messageId} -> ${redactedJid}${hasMedia ? " (media)" : ""} (${durationMs}ms)`);
 		logger.info({
 			jid: redactedJid,
 			messageId
@@ -153,7 +173,7 @@ async function sendMessageWhatsApp(to, body, options) {
 		logger.error({
 			err: String(err),
 			to: redactedTo,
-			hasMedia: Boolean(primaryMediaUrl)
+			hasMedia
 		}, "failed to send via web session");
 		throw err;
 	}

package/dist/{send-api-CwheV1Iq.js → send-api-BvUGZEIA.js}

@@ -1,5 +1,5 @@
 import { n as isWhatsAppNewsletterJid } from "./normalize-target-MB6Z_4Bn.js";
-import { s as resolveWhatsAppDocumentFileName } from "./outbound-media-contract-CQnjZqsm.js";
+import { s as resolveWhatsAppDocumentFileName } from "./outbound-media-contract-ItL7G0Az.js";
 import "./normalize-LMXvL6w0.js";
 import { m as toWhatsappJidWithLid, p as toWhatsappJid, u as jidToE164 } from "./text-runtime-DyR0XOJ4.js";
 import { t as buildQuotedMessageOptions } from "./quoted-message-C5vX90mp.js";

package/dist/{setup-core-Dm2jMZHy.js → setup-core-P6dnz4Ur.js}

@@ -1,5 +1,5 @@
 import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-DgtV_RiP.js";
-import { a as resolveWhatsAppAccount, n as hasAnyWhatsAppAuth } from "./accounts-Dn7MUPTZ.js";
+import { a as resolveWhatsAppAccount, n as hasAnyWhatsAppAuth } from "./accounts-CJNZl-3e.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";
@@ -125,10 +125,10 @@ function resolveWhatsAppConfigPath(params) {
 	return `${resolveWhatsAppGroupScopeBasePath(params)}.${params.field}`;
 }
 async function loadWhatsAppChannelRuntime() {
-	return await import("./channel.runtime-Bahb-X2a.js");
+	return await import("./channel.runtime-n14SNsjm.js");
 }
 async function loadWhatsAppSetupSurface() {
-	return await import("./setup-surface-Dy9RdlqN.js");
+	return await import("./setup-surface-Bq3gnUCD.js");
 }
 const whatsappSetupWizardProxy = createWhatsAppSetupWizardProxy(async () => (await loadWhatsAppSetupSurface()).whatsappSetupWizard);
 const whatsappConfigAdapter = createScopedChannelConfigAdapter({

package/dist/{setup-finalize-B16VRsDw.js → setup-finalize-DYm-2hSc.js}

@@ -1,7 +1,7 @@
 import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-DgtV_RiP.js";
-import { a as resolveWhatsAppAccount, o as resolveWhatsAppAuthDir } from "./accounts-Dn7MUPTZ.js";
+import { a as resolveWhatsAppAccount, o as resolveWhatsAppAuthDir } from "./accounts-CJNZl-3e.js";
 import { a as normalizeWhatsAppAllowFromEntries, o as normalizeWhatsAppAllowFromEntry } from "./normalize-target-MB6Z_4Bn.js";
-import { t as whatsappSetupAdapter } from "./setup-core-Dm2jMZHy.js";
+import { t as whatsappSetupAdapter } from "./setup-core-P6dnz4Ur.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";
@@ -280,7 +280,7 @@ async function finalizeWhatsAppSetup(params) {
 		message: linked ? t("wizard.whatsapp.relinkPrompt") : t("wizard.whatsapp.linkNowPrompt"),
 		initialValue: !linked
 	})) try {
-		const { loginWeb } = await import("./login-CDwsln_y.js").then((n) => n.n);
+		const { loginWeb } = await import("./login-DJYp3l4Z.js").then((n) => n.n);
 		await loginWeb(false, void 0, params.runtime, accountId);
 	} catch (error) {
 		params.runtime.error(`WhatsApp login failed: ${String(error)}`);

package/dist/setup-plugin-api.js

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

package/dist/{setup-surface-Dy9RdlqN.js → setup-surface-Bq3gnUCD.js}

@@ -1,5 +1,5 @@
 import { t as listAccountIds } from "./account-ids-DgtV_RiP.js";
-import { o as resolveWhatsAppAuthDir } from "./accounts-Dn7MUPTZ.js";
+import { o as resolveWhatsAppAuthDir } from "./accounts-CJNZl-3e.js";
 import { a as formatWhatsAppWebAuthStatusState, h as readWebAuthState } from "./auth-store-BLGYDyCH.js";
 import { DEFAULT_ACCOUNT_ID, createSetupTranslator, setSetupChannelEnabled } from "openclaw/plugin-sdk/setup";
 //#region extensions/whatsapp/src/setup-surface.ts
@@ -36,7 +36,7 @@ const whatsappSetupWizard = {
 	},
 	resolveShouldPromptAccountIds: ({ shouldPromptAccountIds }) => shouldPromptAccountIds,
 	credentials: [],
-	finalize: async (params) => await (await import("./setup-finalize-B16VRsDw.js")).finalizeWhatsAppSetup(params),
+	finalize: async (params) => await (await import("./setup-finalize-DYm-2hSc.js")).finalizeWhatsAppSetup(params),
 	disable: (cfg) => setSetupChannelEnabled(cfg, channel, false),
 	onAccountRecorded: (accountId, options) => {
 		options?.onAccountId?.(channel, accountId);

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-pW4J6iz-.js";
+import { t as whatsappOutbound } from "./outbound-adapter-BT7Dkqni.js";
 export { resolveWhatsAppRuntimeGroupPolicy, whatsappOutbound };

package/package.json

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

package/dist/channel-react-action-UYINADWb.js

@@ -1,42 +0,0 @@
-import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-MB6Z_4Bn.js";
-import { t as handleWhatsAppAction } from "./action-runtime-CnXRJ7y1.js";
-import "./normalize-LMXvL6w0.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";
-async function handleWhatsAppReactAction(params) {
-	if (params.action !== "react") throw new Error(`Action ${params.action} is not supported for provider ${WHATSAPP_CHANNEL}.`);
-	const isWhatsAppSource = params.toolContext?.currentChannelProvider === WHATSAPP_CHANNEL;
-	const explicitTarget = readStringParam$1(params.params, "chatJid") ?? readStringParam$1(params.params, "to");
-	const normalizedTarget = explicitTarget ? normalizeWhatsAppTarget(explicitTarget) : null;
-	const normalizedCurrent = isWhatsAppSource && params.toolContext?.currentChannelId ? normalizeWhatsAppTarget(params.toolContext.currentChannelId) : null;
-	const isCrossChat = normalizedTarget != null && (normalizedCurrent == null || normalizedTarget !== normalizedCurrent);
-	const scopedContext = !isWhatsAppSource || isCrossChat || !params.toolContext ? void 0 : {
-		currentChannelId: params.toolContext.currentChannelId ?? void 0,
-		currentChannelProvider: params.toolContext.currentChannelProvider ?? void 0,
-		currentMessageId: params.toolContext.currentMessageId ?? void 0
-	};
-	const messageIdRaw = resolveReactionMessageId({
-		args: params.params,
-		toolContext: scopedContext
-	});
-	if (messageIdRaw == null) readStringParam$1(params.params, "messageId", { required: true });
-	const messageId = String(messageIdRaw);
-	const explicitMessageId = readStringOrNumberParam(params.params, "messageId");
-	const emoji = readStringParam$1(params.params, "emoji", { allowEmpty: true });
-	const remove = typeof params.params.remove === "boolean" ? params.params.remove : void 0;
-	const explicitParticipant = readStringParam$1(params.params, "participant");
-	const inferredParticipant = explicitParticipant || explicitMessageId != null || !isWhatsAppSource || isCrossChat || !isWhatsAppGroupJid(explicitTarget ?? params.toolContext?.currentChannelId ?? "") ? void 0 : typeof params.requesterSenderId === "string" && params.requesterSenderId.trim().length > 0 ? params.requesterSenderId.trim() : void 0;
-	return await handleWhatsAppAction({
-		action: "react",
-		chatJid: readStringParam$1(params.params, "chatJid") ?? readStringParam$1(params.params, "to", { required: true }),
-		messageId,
-		emoji,
-		remove,
-		participant: explicitParticipant ?? inferredParticipant,
-		accountId: params.accountId ?? void 0,
-		fromMe: typeof params.params.fromMe === "boolean" ? params.params.fromMe : void 0
-	}, params.cfg);
-}
-//#endregion
-export { handleWhatsAppReactAction };