@openclaw/whatsapp 2026.5.27 → 2026.5.28-beta.1

package/dist/{login-qr-CdhkC9Ij.js → login-qr-6DdwGlkz.js}

@@ -1,7 +1,7 @@
 import { a as resolveWhatsAppAccount } from "./accounts-BMGM1RtF.js";
 import { f as readWebAuthExistsForDecision, g as readWebSelfId, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-BrKb0mwT.js";
-import { i as resolveWhatsAppSocketTiming, t as createWaSocket } from "./session-CDgpDc0l.js";
-import { i as closeWaSocket, o as waitForWhatsAppLoginResult, t as WHATSAPP_LOGGED_OUT_QR_MESSAGE } from "./connection-controller-ja6z4F_k.js";
+import { i as resolveWhatsAppSocketTiming, t as createWaSocket } from "./session-D8UW2Vbn.js";
+import { i as closeWaSocket, o as waitForWhatsAppLoginResult, t as WHATSAPP_LOGGED_OUT_QR_MESSAGE } from "./connection-controller-BZuzYCGM.js";
 import { logInfo } from "openclaw/plugin-sdk/logging-core";
 import { danger, defaultRuntime, info, success } from "openclaw/plugin-sdk/runtime-env";
 import { renderQrPngDataUrl } from "openclaw/plugin-sdk/media-runtime";

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-CdhkC9Ij.js");
+	loginQrModulePromise ??= import("./login-qr-6DdwGlkz.js");
 	return loginQrModulePromise;
 }
 async function startWebLoginWithQr(...args) {

package/dist/{monitor-BdKlBuaK.js → monitor-CzL4sZSN.js}

@@ -1,20 +1,18 @@
 import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-BMGM1RtF.js";
 import { t as isWhatsAppGroupJid } from "./normalize-target-bVWjgftN.js";
-import { t as resolveWhatsAppReactionLevel } from "./reaction-level-BF3d5IgO.js";
-import { o as maybeResolveWhatsAppApprovalReaction, r as sendReactionWhatsApp } from "./send-D0iPQBMX.js";
+import { a as normalizeWhatsAppOutboundPayload, c as prepareWhatsAppOutboundMedia, d as maybeResolveWhatsAppApprovalReaction, g as resolveWhatsAppReactionLevel, l as sendWhatsAppOutboundWithRetry, r as sendReactionWhatsApp, s as normalizeWhatsAppPayloadTextPreservingIndentation } from "./send-C4LG-Cl6.js";
 import { n as getWhatsAppRuntime } from "./runtime-BfAdAEYT.js";
-import { i as prepareWhatsAppOutboundMedia, o as sendWhatsAppOutboundWithRetry, r as normalizeWhatsAppPayloadTextPreservingIndentation, t as normalizeWhatsAppOutboundPayload } from "./outbound-media-contract-B3Y-9slb.js";
-import { n as getStatusCode, t as formatError } from "./session-errors-BAj9D2La.js";
+import { n as getStatusCode, t as formatError } from "./session-errors-CbsoQqoy.js";
 import { d as markdownToWhatsApp, f as resolveJidToE164, l as isSelfChatMode, n as normalizeE164, t as convertMarkdownTables$1, u as jidToE164 } from "./text-runtime-Dk37KYHj.js";
 import { n as cacheInboundMessageMeta, r as lookupInboundMessageMeta, t as buildQuotedMessageOptions } from "./quoted-message-CveINB35.js";
 import { c as logoutWeb, g as readWebSelfId, o as getWebAuthAgeMs, r as WhatsAppAuthUnstableError, v as readWebSelfIdentityForDecision } from "./auth-store-BrKb0mwT.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-xoLLdqEv.js";
 import { n as resolveWhatsAppGroupsConfigPath } from "./group-config-path-BGyzT9Lg.js";
-import { i as resolveWhatsAppInboundPolicy, r as resolveWhatsAppCommandAuthorized, t as checkInboundAccessControl } from "./access-control-tKMSybhe.js";
-import { a as mayContainWhatsAppOutboundMention, c as describeReplyContext, d as extractLocationData, f as extractMediaPlaceholder, h as hasInboundUserContent, i as addWhatsAppOutboundMentionsToContent, l as extractContactContext, m as extractText, n as listWhatsAppSendResultMessageIds, o as resolveWhatsAppOutboundMentions, p as extractMentionedJids, r as normalizeWhatsAppSendResult, s as addWhatsAppImagePreviewFields, t as createWebSendApi, u as extractContextInfo } from "./send-api-3hUuzYv1.js";
-import { i as resolveWhatsAppSocketTiming, r as waitForWaConnection, t as createWaSocket } from "./session-CDgpDc0l.js";
+import { i as resolveWhatsAppInboundPolicy, r as resolveWhatsAppCommandAuthorized, t as checkInboundAccessControl } from "./access-control-Z0fYaWrx.js";
+import { a as mayContainWhatsAppOutboundMention, c as describeReplyContext, d as extractLocationData, f as extractMediaPlaceholder, h as hasInboundUserContent, i as addWhatsAppOutboundMentionsToContent, l as extractContactContext, m as extractText, n as listWhatsAppSendResultMessageIds, o as resolveWhatsAppOutboundMentions, p as extractMentionedJids, r as normalizeWhatsAppSendResult, s as addWhatsAppImagePreviewFields, t as createWebSendApi, u as extractContextInfo } from "./send-api-C66vkRl9.js";
+import { i as resolveWhatsAppSocketTiming, r as waitForWaConnection, t as createWaSocket } from "./session-D8UW2Vbn.js";
 import { t as BufferJSON } from "./session.runtime-LZFdq3yb.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-ja6z4F_k.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-BZuzYCGM.js";
 import { resolveAccountEntry } from "openclaw/plugin-sdk/account-core";
 import { normalizeLowercaseStringOrEmpty, normalizeStringEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createChannelMessageReplyPipeline, createDurableInboundReceiveJournal, createMessageReceiptFromOutboundResults, deliverInboundReplyWithMessageSendContext, resolveChannelMessageSourceReplyDeliveryMode } from "openclaw/plugin-sdk/channel-outbound";
@@ -2501,7 +2499,9 @@ const WHATSAPP_MESSAGE_RECEIVED_HOOK_LIMITS = {
 };
 function readWhatsAppMessageReceivedHookOptIn(value) {
 	if (!value || typeof value !== "object") return;
-	return value.pluginHooks?.messageReceived === true ? true : void 0;
+	const pluginHooks = value.pluginHooks;
+	if (pluginHooks?.messageReceived === void 0) return;
+	return pluginHooks.messageReceived;
 }
 function shouldEmitWhatsAppMessageReceivedHooks(params) {
 	const channelConfig = params.cfg.channels?.whatsapp;

package/dist/runtime-api.js

@@ -1,16 +1,16 @@
 import { o as resolveWebCredsBackupPath, r as hasWebCredsSync, s as resolveWebCredsPath } from "./creds-files-B1kSWtBg.js";
-import { n as whatsAppActionRuntime, t as handleWhatsAppAction } from "./action-runtime-ClWX76J7.js";
-import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./send-D0iPQBMX.js";
+import { n as whatsAppActionRuntime, t as handleWhatsAppAction } from "./action-runtime-BdhkGtaP.js";
+import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./send-C4LG-Cl6.js";
 import { r as setWhatsAppRuntime } from "./runtime-BfAdAEYT.js";
-import { n as getStatusCode, t as formatError } from "./session-errors-BAj9D2La.js";
+import { n as getStatusCode, t as formatError } from "./session-errors-CbsoQqoy.js";
 import { startWebLoginWithQr, waitForWebLogin } from "./login-qr-runtime.js";
-import { t as createWhatsAppLoginTool } from "./agent-tools-login-BDzvb3ee.js";
+import { t as createWhatsAppLoginTool } from "./agent-tools-login-BX7eHgDm.js";
 import { C as waitForCredsSaveQueue, T as writeCredsJsonAtomically, _ as readWebSelfIdentity, a as formatWhatsAppWebAuthStatusState, b as restoreCredsFromBackupIfNeeded, c as logoutWeb, d as readWebAuthExistsBestEffort, f as readWebAuthExistsForDecision, g as readWebSelfId, h as readWebAuthState, l as pickWebChannel, m as readWebAuthSnapshotBestEffort, n as WHATSAPP_AUTH_UNSTABLE_CODE, o as getWebAuthAgeMs, p as readWebAuthSnapshot, r as WhatsAppAuthUnstableError, s as logWebSelfId, t as WA_WEB_AUTH_DIR, u as readCredsJsonRaw, v as readWebSelfIdentityForDecision, w as waitForCredsSaveQueueWithTimeout, x as webAuthExists, y as resolveDefaultWebAuthDir } from "./auth-store-BrKb0mwT.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-HU41RHGI.js";
-import { d as extractLocationData, f as extractMediaPlaceholder, l as extractContactContext, m as extractText } from "./send-api-3hUuzYv1.js";
-import { n as newConnectionId, r as waitForWaConnection, t as createWaSocket } from "./session-CDgpDc0l.js";
-import { n as resolveWebAccountId, t as getActiveWebListener } from "./active-listener-B4SDebQ6.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-BdKlBuaK.js";
-import { t as loginWeb } from "./login-1rs_uPW-.js";
+import { d as extractLocationData, f as extractMediaPlaceholder, l as extractContactContext, m as extractText } from "./send-api-C66vkRl9.js";
+import { n as newConnectionId, r as waitForWaConnection, t as createWaSocket } from "./session-D8UW2Vbn.js";
+import { n as resolveWebAccountId, t as getActiveWebListener } from "./active-listener-CFwkn3ho.js";
+import { a as loadWebMediaRaw, c as monitorWebInbox, i as loadWebMedia, l as resetWebInboundDedupe, n as LocalMediaAccessError, o as optimizeImageToJpeg, r as getDefaultLocalRoots, s as optimizeImageToPng, t as monitorWebChannel } from "./monitor-CzL4sZSN.js";
+import { t as loginWeb } from "./login-1yyBrXTL.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-D0iPQBMX.js → send-C4LG-Cl6.js}

@@ -1,12 +1,16 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { t as resolveMergedWhatsAppAccountConfig } from "./account-config-6PTOSfaI.js";
 import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-CB5SOWjc.js";
 import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-BMGM1RtF.js";
 import { c as normalizeWhatsAppTarget, n as isWhatsAppNewsletterJid } from "./normalize-target-bVWjgftN.js";
 import "./normalize-Bxwqo-bW.js";
 import { t as getOptionalWhatsAppRuntime } from "./runtime-BfAdAEYT.js";
-import { t as getRegisteredWhatsAppConnectionController } from "./connection-controller-registry-TSX_udJp.js";
-import { a as resolveWhatsAppOutboundMediaUrls, i as prepareWhatsAppOutboundMedia, n as normalizeWhatsAppPayloadText, s as resolveWhatsAppDocumentFileName } from "./outbound-media-contract-B3Y-9slb.js";
-import { d as markdownToWhatsApp, p as toWhatsappJid } from "./text-runtime-Dk37KYHj.js";
+import { r as getRegisteredWhatsAppConnectionController, t as formatError } from "./session-errors-CbsoQqoy.js";
+import { a as sanitizeAssistantVisibleTextWithProfile, d as markdownToWhatsApp, i as sanitizeAssistantVisibleText, o as sleep, p as toWhatsappJid, s as stripToolCallXmlTags } from "./text-runtime-Dk37KYHj.js";
+import path from "node:path";
+import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { sanitizeForPlainText } from "openclaw/plugin-sdk/channel-outbound";
+import { writeExternalFileWithinRoot } from "openclaw/plugin-sdk/security-runtime";
+import { resolveReactionLevel } from "openclaw/plugin-sdk/status-helpers";
 import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
 import { generateSecureUuid } from "openclaw/plugin-sdk/core";
 import { redactIdentifier } from "openclaw/plugin-sdk/logging-core";
@@ -16,7 +20,23 @@ import { normalizePollInput } from "openclaw/plugin-sdk/poll-runtime";
 import { createSubsystemLogger, getChildLogger as getChildLogger$1 } from "openclaw/plugin-sdk/runtime-env";
 import { createApprovalReactionTargetStore, listApprovalReactionBindings, resolveApprovalReactionTarget } from "openclaw/plugin-sdk/approval-reaction-runtime";
 import { createResolvedApproverActionAuthAdapter, resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
+import { extensionForMime } from "openclaw/plugin-sdk/media-mime";
+import { MEDIA_FFMPEG_MAX_AUDIO_DURATION_SECS, runFfmpeg } from "openclaw/plugin-sdk/media-runtime";
+import { resolvePreferredOpenClawTmpDir, withTempWorkspace } from "openclaw/plugin-sdk/temp-path";
 import { loadWebMedia } from "openclaw/plugin-sdk/web-media";
+//#region extensions/whatsapp/src/reaction-level.ts
+/** Resolve the effective reaction level and its implications for WhatsApp. */
+function resolveWhatsAppReactionLevel(params) {
+	return resolveReactionLevel({
+		value: resolveMergedWhatsAppAccountConfig({
+			cfg: params.cfg,
+			accountId: params.accountId
+		}).reactionLevel,
+		defaultLevel: "minimal",
+		invalidFallback: "minimal"
+	});
+}
+//#endregion
 //#region extensions/whatsapp/src/approval-auth.ts
 function normalizeWhatsAppApproverId(value) {
 	const normalized = normalizeWhatsAppTarget(String(value));
@@ -254,6 +274,180 @@ async function maybeResolveWhatsAppApprovalReaction(params) {
 	}
 }
 //#endregion
+//#region extensions/whatsapp/src/document-filename.ts
+const WHATSAPP_DEFAULT_DOCUMENT_FILE_NAME = "file";
+function resolveWhatsAppDefaultDocumentFileName(mimetype) {
+	const extension = extensionForMime(mimetype);
+	return extension ? `${WHATSAPP_DEFAULT_DOCUMENT_FILE_NAME}${extension}` : WHATSAPP_DEFAULT_DOCUMENT_FILE_NAME;
+}
+function resolveWhatsAppDocumentFileName(params) {
+	const fallbackName = resolveWhatsAppDefaultDocumentFileName(params.mimetype);
+	return params.fileName?.replace(/[\x00-\x1f\x7f]/g, "").trim() || fallbackName;
+}
+//#endregion
+//#region extensions/whatsapp/src/outbound-media-contract.ts
+const WHATSAPP_VOICE_FILE_NAME = "voice.ogg";
+const WHATSAPP_VOICE_SAMPLE_RATE_HZ = 48e3;
+const WHATSAPP_VOICE_BITRATE = "64k";
+const WHATSAPP_VOICE_MIMETYPE = "audio/ogg; codecs=opus";
+function stripWhatsAppPluralToolXml(text) {
+	return stripToolCallXmlTags(text, { stripFunctionCallsXmlPayloads: true });
+}
+function finalizeWhatsAppVisibleText(text) {
+	return sanitizeForPlainText(stripWhatsAppPluralToolXml(text));
+}
+function normalizeWhatsAppPayloadText(text) {
+	return finalizeWhatsAppVisibleText(sanitizeAssistantVisibleText(text ?? "")).trimStart();
+}
+function stripLeadingBlankLines(text) {
+	return text.replace(/^(?:[ \t]*\r?\n)+/, "");
+}
+function normalizeWhatsAppPayloadTextPreservingIndentation(text) {
+	const normalized = stripLeadingBlankLines(finalizeWhatsAppVisibleText(sanitizeAssistantVisibleTextWithProfile(stripLeadingBlankLines(text ?? ""), "history")));
+	return normalized.trim() ? normalized : "";
+}
+function resolveWhatsAppOutboundMediaUrls(payload) {
+	return uniqueStrings([payload.mediaUrl?.trim(), ...(payload.mediaUrls ? [...payload.mediaUrls] : []).map((entry) => entry.trim()).filter((entry) => Boolean(entry))].filter((entry) => Boolean(entry)));
+}
+function normalizeWhatsAppOutboundPayload(payload, options) {
+	const mediaUrls = resolveWhatsAppOutboundMediaUrls(payload);
+	const normalizeText = options?.normalizeText ?? normalizeWhatsAppPayloadText;
+	return {
+		...payload,
+		text: normalizeText(payload.text),
+		mediaUrl: mediaUrls[0],
+		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 = inferWhatsAppMediaKind(media);
+	const mimetype = kind === "audio" && isWhatsAppNativeVoiceAudio({
+		contentType: media.contentType,
+		mediaUrl
+	}) ? WHATSAPP_VOICE_MIMETYPE : media.contentType ?? "application/octet-stream";
+	const fileName = kind === "document" ? resolveWhatsAppDocumentFileName({
+		fileName: media.fileName ?? deriveWhatsAppDocumentFileName(mediaUrl),
+		mimetype
+	}) : media.fileName;
+	return {
+		buffer: media.buffer,
+		kind,
+		mimetype,
+		...fileName ? { fileName } : {}
+	};
+}
+async function prepareWhatsAppOutboundMedia(media, mediaUrl) {
+	const normalized = normalizeWhatsAppLoadedMedia(media, mediaUrl);
+	if (normalized.kind !== "audio") return normalized;
+	if (isWhatsAppNativeVoiceAudio({
+		contentType: media.contentType,
+		fileName: media.fileName,
+		mediaUrl
+	})) return normalized;
+	return {
+		buffer: await transcodeToWhatsAppVoiceOpus({
+			buffer: media.buffer,
+			fileName: media.fileName ?? deriveWhatsAppDocumentFileName(mediaUrl) ?? "audio"
+		}),
+		kind: "audio",
+		mimetype: WHATSAPP_VOICE_MIMETYPE
+	};
+}
+function normalizeContentType(value) {
+	return value?.split(";", 1)[0]?.trim().toLowerCase() ?? "";
+}
+function isWhatsAppNativeVoiceAudio(params) {
+	const contentType = normalizeContentType(params.contentType);
+	if (contentType === "audio/ogg" || contentType === "audio/opus") return true;
+	const fileName = params.fileName ?? deriveWhatsAppDocumentFileName(params.mediaUrl) ?? "";
+	const ext = path.extname(fileName).toLowerCase();
+	return ext === ".ogg" || ext === ".opus";
+}
+async function transcodeToWhatsAppVoiceOpus(params) {
+	return await withTempWorkspace({
+		rootDir: resolvePreferredOpenClawTmpDir(),
+		prefix: "whatsapp-voice-"
+	}, async (workspace) => {
+		const ext = path.extname(params.fileName).toLowerCase();
+		const inputExt = ext && ext.length <= 12 ? ext : ".audio";
+		const inputPath = await workspace.write(`input${inputExt}`, params.buffer);
+		await writeExternalFileWithinRoot({
+			rootDir: workspace.dir,
+			path: WHATSAPP_VOICE_FILE_NAME,
+			write: async (outputPath) => {
+				await runFfmpeg([
+					"-hide_banner",
+					"-loglevel",
+					"error",
+					"-y",
+					"-i",
+					inputPath,
+					"-vn",
+					"-sn",
+					"-dn",
+					"-t",
+					String(MEDIA_FFMPEG_MAX_AUDIO_DURATION_SECS),
+					"-ar",
+					String(WHATSAPP_VOICE_SAMPLE_RATE_HZ),
+					"-ac",
+					"1",
+					"-c:a",
+					"libopus",
+					"-b:a",
+					WHATSAPP_VOICE_BITRATE,
+					"-f",
+					"ogg",
+					outputPath
+				]);
+			}
+		});
+		return await workspace.read(WHATSAPP_VOICE_FILE_NAME);
+	});
+}
+function deriveWhatsAppDocumentFileName(mediaUrl) {
+	if (!mediaUrl) return;
+	try {
+		const parsed = new URL(mediaUrl);
+		const fileName = path.posix.basename(parsed.pathname);
+		return fileName ? decodeURIComponent(fileName) : void 0;
+	} catch {
+		return (mediaUrl.split(/[?#]/, 1)[0] ?? "").split(/[\\/]/).pop() || void 0;
+	}
+}
+function isRetryableWhatsAppOutboundError(error) {
+	return /closed|reset|timed\s*out|disconnect/i.test(formatError(error));
+}
+async function sendWhatsAppOutboundWithRetry(params) {
+	const maxAttempts = params.maxAttempts ?? 3;
+	let lastError;
+	for (let attempt = 1; attempt <= maxAttempts; attempt += 1) try {
+		return await params.send();
+	} catch (error) {
+		lastError = error;
+		const errorText = formatError(error);
+		const isLastAttempt = attempt === maxAttempts;
+		if (!isRetryableWhatsAppOutboundError(error) || isLastAttempt) throw error;
+		const backoffMs = 500 * attempt;
+		await params.onRetry?.({
+			attempt,
+			maxAttempts,
+			backoffMs,
+			error,
+			errorText
+		});
+		await sleep(backoffMs);
+	}
+	throw lastError;
+}
+//#endregion
 //#region extensions/whatsapp/src/outbound-media.runtime.ts
 async function loadOutboundMediaFromUrl(mediaUrl, options = {}) {
 	const readFile = options.mediaAccess?.readFile ?? options.mediaReadFile;
@@ -274,12 +468,6 @@ async function loadOutboundMediaFromUrl(mediaUrl, options = {}) {
 }
 //#endregion
 //#region extensions/whatsapp/src/send.ts
-var send_exports = /* @__PURE__ */ __exportAll({
-	sendMessageWhatsApp: () => sendMessageWhatsApp,
-	sendPollWhatsApp: () => sendPollWhatsApp,
-	sendReactionWhatsApp: () => sendReactionWhatsApp,
-	sendTypingWhatsApp: () => sendTypingWhatsApp
-});
 const outboundLog = createSubsystemLogger("gateway/channels/whatsapp").child("outbound");
 function supportsForcedDocumentDelivery(kind) {
 	return kind === "image" || kind === "video";
@@ -520,4 +708,4 @@ async function sendPollWhatsApp(to, poll, options) {
 	}
 }
 //#endregion
-export { send_exports as a, unregisterWhatsAppApprovalReactionTarget as c, sendTypingWhatsApp as i, getWhatsAppApprovalApprovers as l, sendPollWhatsApp as n, maybeResolveWhatsAppApprovalReaction as o, sendReactionWhatsApp as r, registerWhatsAppApprovalReactionTarget as s, sendMessageWhatsApp as t, whatsappApprovalAuth as u };
+export { normalizeWhatsAppOutboundPayload as a, prepareWhatsAppOutboundMedia as c, maybeResolveWhatsAppApprovalReaction as d, registerWhatsAppApprovalReactionTarget as f, resolveWhatsAppReactionLevel as g, whatsappApprovalAuth as h, sendTypingWhatsApp as i, sendWhatsAppOutboundWithRetry as l, getWhatsAppApprovalApprovers as m, sendPollWhatsApp as n, normalizeWhatsAppPayloadText as o, unregisterWhatsAppApprovalReactionTarget as p, sendReactionWhatsApp as r, normalizeWhatsAppPayloadTextPreservingIndentation as s, sendMessageWhatsApp as t, resolveWhatsAppDocumentFileName as u };

package/dist/{send-api-3hUuzYv1.js → send-api-C66vkRl9.js}

@@ -1,6 +1,6 @@
 import { n as isWhatsAppNewsletterJid } from "./normalize-target-bVWjgftN.js";
+import { u as resolveWhatsAppDocumentFileName } from "./send-C4LG-Cl6.js";
 import "./normalize-Bxwqo-bW.js";
-import { s as resolveWhatsAppDocumentFileName } from "./outbound-media-contract-B3Y-9slb.js";
 import { m as toWhatsappJidWithLid, p as toWhatsappJid, u as jidToE164 } from "./text-runtime-Dk37KYHj.js";
 import { t as buildQuotedMessageOptions } from "./quoted-message-CveINB35.js";
 import { c as resolveComparableIdentity } from "./identity-xoLLdqEv.js";

package/dist/{session-CDgpDc0l.js → session-D8UW2Vbn.js}

@@ -1,5 +1,5 @@
 import { o as resolveWebCredsBackupPath, s as resolveWebCredsPath, t as assertWebCredsPathRegularFileOrMissing } from "./creds-files-B1kSWtBg.js";
-import { n as getStatusCode } from "./session-errors-BAj9D2La.js";
+import { n as getStatusCode } from "./session-errors-CbsoQqoy.js";
 import { E as writeWebCredsRawAtomically, S as enqueueCredsSave, T as writeCredsJsonAtomically, b as restoreCredsFromBackupIfNeeded, u as readCredsJsonRaw, w as waitForCredsSaveQueueWithTimeout, y as resolveDefaultWebAuthDir } from "./auth-store-BrKb0mwT.js";
 import { a as makeWASocket, i as makeCacheableSignalKeyStore, n as DisconnectReason, r as fetchLatestBaileysVersion, s as useMultiFileAuthState } from "./session.runtime-LZFdq3yb.js";
 import { VERSION, formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
@@ -7,8 +7,7 @@ import { danger, getChildLogger, success, toPinoLikeLogger } from "openclaw/plug
 import { renderQrTerminal } from "openclaw/plugin-sdk/media-runtime";
 import { ensureDir, resolveUserPath } from "openclaw/plugin-sdk/text-utility-runtime";
 import { randomUUID } from "node:crypto";
-import { HttpsProxyAgent } from "https-proxy-agent";
-import { createHttp1EnvHttpProxyAgent, createHttp1ProxyAgent, resolveActiveManagedProxyTlsOptions, resolveEnvHttpProxyUrl, shouldUseEnvHttpProxyForUrl } from "openclaw/plugin-sdk/fetch-runtime";
+import { createHttp1EnvHttpProxyAgent, createHttp1ProxyAgent, createNodeProxyAgent } from "openclaw/plugin-sdk/fetch-runtime";
 //#region extensions/whatsapp/src/socket-timing.ts
 const DEFAULT_WHATSAPP_SOCKET_TIMING = {
 	keepAliveIntervalMs: 25e3,
@@ -60,7 +59,7 @@ async function safeSaveCreds(authDir, saveCreds, logger) {
 	}
 }
 async function printTerminalQr(qr) {
-	const output = await renderQrTerminal(qr);
+	const output = await renderQrTerminal(qr, { small: true });
 	process.stdout.write(output.endsWith("\n") ? output : `${output}\n`);
 }
 /**
@@ -137,13 +136,13 @@ async function createWaSocket(printQr, verbose, opts = {}) {
 	return sock;
 }
 async function resolveEnvProxyAgent(logger) {
-	if (!shouldUseEnvHttpProxyForUrl(WHATSAPP_WEBSOCKET_PROXY_TARGET)) return;
-	const proxyUrl = resolveEnvHttpProxyUrl("https");
-	if (!proxyUrl) return;
-	const proxyTls = resolveActiveManagedProxyTlsOptions({ proxyUrl });
-	const proxyAgentOptions = proxyTls?.ca ? { ca: proxyTls.ca } : void 0;
 	try {
-		const agent = new HttpsProxyAgent(proxyUrl, proxyAgentOptions);
+		const agent = createNodeProxyAgent({
+			mode: "env",
+			targetUrl: WHATSAPP_WEBSOCKET_PROXY_TARGET,
+			protocol: "https"
+		});
+		if (!agent) return;
 		logger.info("Using ambient env proxy for WhatsApp WebSocket connection");
 		return agent;
 	} catch (error) {
@@ -163,6 +162,10 @@ async function resolveEnvFetchDispatcher(logger, agent) {
 	}
 }
 function resolveProxyUrlFromAgent(agent) {
+	if (typeof agent === "object" && agent !== null && "getProxyForUrl" in agent && typeof agent.getProxyForUrl === "function") {
+		const proxyUrl = agent.getProxyForUrl(WHATSAPP_WEBSOCKET_PROXY_TARGET);
+		return typeof proxyUrl === "string" && proxyUrl.length > 0 ? proxyUrl : void 0;
+	}
 	if (typeof agent !== "object" || agent === null || !("proxy" in agent)) return;
 	const proxy = agent.proxy;
 	if (proxy instanceof URL) return proxy.toString();

package/dist/{session-errors-BAj9D2La.js → session-errors-CbsoQqoy.js}

@@ -1,3 +1,24 @@
+//#region extensions/whatsapp/src/connection-controller-registry.ts
+const CONNECTION_REGISTRY_KEY = Symbol.for("openclaw.whatsapp.connectionControllerRegistry");
+function getConnectionRegistryState() {
+	const globalState = globalThis;
+	const existing = globalState[CONNECTION_REGISTRY_KEY];
+	if (existing) return existing;
+	const created = { controllers: /* @__PURE__ */ new Map() };
+	globalState[CONNECTION_REGISTRY_KEY] = created;
+	return created;
+}
+function getRegisteredWhatsAppConnectionController(accountId) {
+	return getConnectionRegistryState().controllers.get(accountId) ?? null;
+}
+function registerWhatsAppConnectionController(accountId, controller) {
+	getConnectionRegistryState().controllers.set(accountId, controller);
+}
+function unregisterWhatsAppConnectionController(accountId, controller) {
+	const controllers = getConnectionRegistryState().controllers;
+	if (controllers.get(accountId) === controller) controllers.delete(accountId);
+}
+//#endregion
 //#region extensions/whatsapp/src/session-errors.ts
 function safeStringify(value, limit = 800) {
 	try {
@@ -60,4 +81,4 @@ function formatError(err) {
 	return safeStringify(err);
 }
 //#endregion
-export { getStatusCode as n, formatError as t };
+export { unregisterWhatsAppConnectionController as a, registerWhatsAppConnectionController as i, getStatusCode as n, getRegisteredWhatsAppConnectionController as r, formatError as t };

package/dist/{setup-core-cgB2JDjU.js → setup-core-C2os03mR.js}

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

package/dist/{setup-finalize-CCZdGnko.js → setup-finalize-IDTrWXtX.js}

@@ -2,7 +2,7 @@ import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-CB5SOWjc.js"
 import { r as hasWebCredsSync } from "./creds-files-B1kSWtBg.js";
 import { a as resolveWhatsAppAccount, o as resolveWhatsAppAuthDir } from "./accounts-BMGM1RtF.js";
 import { a as normalizeWhatsAppAllowFromEntries, o as normalizeWhatsAppAllowFromEntry } from "./normalize-target-bVWjgftN.js";
-import { t as whatsappSetupAdapter } from "./setup-core-cgB2JDjU.js";
+import { t as whatsappSetupAdapter } from "./setup-core-C2os03mR.js";
 import { DEFAULT_ACCOUNT_ID, createSetupTranslator, splitSetupEntries } from "openclaw/plugin-sdk/setup";
 import { formatCliCommand, formatDocsLink } from "openclaw/plugin-sdk/setup-tools";
 //#region extensions/whatsapp/src/setup-finalize.ts
@@ -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-1rs_uPW-.js").then((n) => n.n);
+		const { loginWeb } = await import("./login-1yyBrXTL.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-CtTHpu8o.js";
+import { t as whatsappSetupPlugin } from "./channel.setup-BNqtW-u1.js";
 export { whatsappSetupPlugin };

package/dist/{setup-surface-BouY1WI8.js → setup-surface-BOhQVZqy.js}

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

package/npm-shrinkwrap.json

@@ -1,20 +1,19 @@
 {
   "name": "@openclaw/whatsapp",
-  "version": "2026.5.27",
+  "version": "2026.5.28-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/whatsapp",
-      "version": "2026.5.27",
+      "version": "2026.5.28-beta.1",
       "dependencies": {
         "audio-decode": "2.2.3",
         "baileys": "7.0.0-rc13",
-        "https-proxy-agent": "9.0.0",
         "typebox": "1.1.38"
       },
       "peerDependencies": {
-        "openclaw": ">=2026.5.27"
+        "openclaw": ">=2026.5.28-beta.1"
       },
       "peerDependenciesMeta": {
         "openclaw": {
@@ -240,15 +239,6 @@
         "url": "https://github.com/sponsors/eshaz"
       }
     },
-    "node_modules/agent-base": {
-      "version": "9.0.0",
-      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-9.0.0.tgz",
-      "integrity": "sha512-TQf59BsZnytt8GdJKLPfUZ54g/iaUL2OWDSFCCvMOhsHduDQxO8xC4PNeyIkVcA5KwL2phPSv0douC0fgWzmnA==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 20"
-      }
-    },
     "node_modules/async-mutex": {
       "version": "0.5.0",
       "resolved": "https://registry.npmjs.org/async-mutex/-/async-mutex-0.5.0.tgz",
@@ -434,19 +424,6 @@
       "integrity": "sha512-MvG/clsADq1GPM2KGo2nyfaWVyn9naPiXrqIe4jYjXNZQt238kWyOGrsyc/DmRAQ+Re6yeo6yX/yoNCG5KAEVg==",
       "license": "MIT"
     },
-    "node_modules/https-proxy-agent": {
-      "version": "9.0.0",
-      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-9.0.0.tgz",
-      "integrity": "sha512-/MVmHp58WkOypgFhCLk4fzpPcFQvTJ/e6LBI7irpIO2HfxUbpmYoHF+KzipzJpxxzJu7aJNWQ0xojJ/dzV2G5g==",
-      "license": "MIT",
-      "dependencies": {
-        "agent-base": "9.0.0",
-        "debug": "^4.3.4"
-      },
-      "engines": {
-        "node": ">= 20"
-      }
-    },
     "node_modules/ieee754": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",

package/openclaw.plugin.json

@@ -346,6 +346,15 @@
             },
             "additionalProperties": false
           },
+          "pluginHooks": {
+            "type": "object",
+            "properties": {
+              "messageReceived": {
+                "type": "boolean"
+              }
+            },
+            "additionalProperties": false
+          },
           "accounts": {
             "type": "object",
             "propertyNames": {
@@ -667,6 +676,15 @@
                   },
                   "additionalProperties": false
                 },
+                "pluginHooks": {
+                  "type": "object",
+                  "properties": {
+                    "messageReceived": {
+                      "type": "boolean"
+                    }
+                  },
+                  "additionalProperties": false
+                },
                 "name": {
                   "type": "string"
                 },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/whatsapp",
-  "version": "2026.5.27",
+  "version": "2026.5.28-beta.1",
   "description": "OpenClaw WhatsApp channel plugin for WhatsApp Web chats.",
   "repository": {
     "type": "git",
@@ -10,11 +10,10 @@
   "dependencies": {
     "audio-decode": "2.2.3",
     "baileys": "7.0.0-rc13",
-    "https-proxy-agent": "9.0.0",
     "typebox": "1.1.38"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.27"
+    "openclaw": ">=2026.5.28-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -57,10 +56,10 @@
       "minHostVersion": ">=2026.4.25"
     },
     "compat": {
-      "pluginApi": ">=2026.5.27"
+      "pluginApi": ">=2026.5.28-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.27"
+      "openclawVersion": "2026.5.28-beta.1"
     },
     "release": {
       "publishToClawHub": true,
@@ -79,7 +78,6 @@
   "bundledDependencies": [
     "audio-decode",
     "baileys",
-    "https-proxy-agent",
     "typebox"
   ]
 }

package/dist/connection-controller-registry-TSX_udJp.js

@@ -1,22 +0,0 @@
-//#region extensions/whatsapp/src/connection-controller-registry.ts
-const CONNECTION_REGISTRY_KEY = Symbol.for("openclaw.whatsapp.connectionControllerRegistry");
-function getConnectionRegistryState() {
-	const globalState = globalThis;
-	const existing = globalState[CONNECTION_REGISTRY_KEY];
-	if (existing) return existing;
-	const created = { controllers: /* @__PURE__ */ new Map() };
-	globalState[CONNECTION_REGISTRY_KEY] = created;
-	return created;
-}
-function getRegisteredWhatsAppConnectionController(accountId) {
-	return getConnectionRegistryState().controllers.get(accountId) ?? null;
-}
-function registerWhatsAppConnectionController(accountId, controller) {
-	getConnectionRegistryState().controllers.set(accountId, controller);
-}
-function unregisterWhatsAppConnectionController(accountId, controller) {
-	const controllers = getConnectionRegistryState().controllers;
-	if (controllers.get(accountId) === controller) controllers.delete(accountId);
-}
-//#endregion
-export { registerWhatsAppConnectionController as n, unregisterWhatsAppConnectionController as r, getRegisteredWhatsAppConnectionController as t };