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

package/dist/{question-reactions-C0qJ6wGA.js → question-reactions-CaOrSYzU.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { a as resolveWhatsAppAccount } from "./accounts-ejK8sXPU.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CxPuEFi-.js";
 import { questionGatewayRuntime } from "openclaw/plugin-sdk/question-gateway-runtime";
 //#region extensions/whatsapp/src/question-reactions.ts
 var question_reactions_exports = /* @__PURE__ */ __exportAll({

package/dist/runtime-BLlToOi6.js

@@ -0,0 +1,21 @@
+import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
+//#region extensions/whatsapp/src/runtime.ts
+const runtimeStore = createPluginRuntimeStore({
+	pluginId: "whatsapp",
+	errorMessage: "WhatsApp runtime not initialized"
+});
+const channelRuntimeStore = createPluginRuntimeStore({
+	key: "plugin-runtime:whatsapp:channel-context-owner",
+	errorMessage: "WhatsApp channel runtime not initialized"
+});
+/** Injects current helpers while preserving the process-lifetime channel context owner. */
+function setWhatsAppRuntime(next) {
+	if (!channelRuntimeStore.tryGetRuntime()) channelRuntimeStore.setRuntime(next.channel);
+	runtimeStore.setRuntime(next);
+}
+const getWhatsAppRuntime = runtimeStore.getRuntime;
+const getOptionalWhatsAppRuntime = runtimeStore.tryGetRuntime;
+const getWhatsAppChannelRuntime = channelRuntimeStore.getRuntime;
+const getOptionalWhatsAppChannelRuntime = channelRuntimeStore.tryGetRuntime;
+//#endregion
+export { setWhatsAppRuntime as a, getWhatsAppRuntime as i, getOptionalWhatsAppRuntime as n, getWhatsAppChannelRuntime as r, getOptionalWhatsAppChannelRuntime as t };

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-p0V390gA.js";
-import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./send-SB-4JrVZ.js";
-import { r as setWhatsAppRuntime } from "./runtime-BfAdAEYT.js";
+import { n as whatsAppActionRuntime, t as handleWhatsAppAction } from "./action-runtime-CHU7xb6o.js";
+import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./send-DhJVN30g.js";
+import { a as setWhatsAppRuntime } from "./runtime-BLlToOi6.js";
 import { startWebLoginWithQr, waitForWebLogin } from "./login-qr-runtime.js";
 import { t as createWhatsAppLoginTool } from "./agent-tools-login-DfyToBpG.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-BQi9pZqQ.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-DirYMTbo.js";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./constants-HU41RHGI.js";
-import { n as resolveWebAccountId, t as getActiveWebListener } from "./active-listener-BbdlXooT.js";
-import { a as waitForWaConnection, i as newConnectionId, r as createWaSocket } from "./socket-close-jNGyZY4T.js";
+import { n as resolveWebAccountId, t as getActiveWebListener } from "./active-listener-BEjWsCNM.js";
+import { a as waitForWaConnection, i as newConnectionId, r as createWaSocket } from "./socket-close-BoSHhQNJ.js";
 import { n as getStatusCode, t as formatError } from "./session-errors-JuazczrA.js";
-import { _ as extractLocationData, b as extractText, m as extractContactContext, v as extractMediaPlaceholder } from "./send-api-BG0MgoFI.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-_jqDKBXj.js";
-import { t as loginWeb } from "./login-ifOXCBjo.js";
+import { g as extractLocationData, p as extractContactContext, y as extractText } from "./send-api-CpHwbor_.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-CBVNJ2lb.js";
+import { t as loginWeb } from "./login-BKUm7KSk.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 };
+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, 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/runtime-setter-api.js

@@ -1,2 +1,2 @@
-import { r as setWhatsAppRuntime } from "./runtime-BfAdAEYT.js";
+import { a as setWhatsAppRuntime } from "./runtime-BLlToOi6.js";
 export { setWhatsAppRuntime };

package/dist/{send-SB-4JrVZ.js → send-DhJVN30g.js}

@@ -1,28 +1,27 @@
-import { a as resolveWhatsAppAccount, c as resolveMergedWhatsAppAccountConfig, s as resolveWhatsAppMediaMaxBytes } from "./accounts-ejK8sXPU.js";
+import { a as resolveWhatsAppAccount, c as resolveMergedWhatsAppAccountConfig, s as resolveWhatsAppMediaMaxBytes } from "./accounts-CxPuEFi-.js";
 import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-CB5SOWjc.js";
 import { n as isWhatsAppNewsletterJid } from "./normalize-target-DSZnHkKF.js";
-import { r as getWhatsAppConnectionController } from "./connection-controller-runtime-context-9mEeAvu1.js";
+import { r as getWhatsAppConnectionController } from "./connection-controller-runtime-context-DG0tuYuw.js";
 import "./normalize-C-Z16y7Q.js";
-import { i as markdownToWhatsApp, s as toWhatsappJid } from "./targets-runtime-Bsh0HR9y.js";
-import { a as sanitizeAssistantVisibleTextWithProfile, i as sanitizeAssistantVisibleText, o as stripToolCallXmlTags } from "./text-runtime-BTGkMN0o.js";
+import { a as markdownToWhatsAppChunks, c as toWhatsappJid } from "./targets-runtime-CKFrhoX4.js";
+import { a as stripToolCallXmlTags, i as sanitizeAssistantVisibleTextWithProfile, r as sanitizeAssistantVisibleText } from "./text-runtime-CU_IlbK5.js";
 import path from "node:path";
 import { normalizeUniqueStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
-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 { PlatformMessageNotDispatchedError } from "openclaw/plugin-sdk/error-runtime";
 import { redactIdentifier } from "openclaw/plugin-sdk/logging-core";
-import { convertMarkdownTables, resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
+import { resolveMarkdownTableMode } from "openclaw/plugin-sdk/markdown-table-runtime";
+import { loadOutboundMediaFromUrl } from "openclaw/plugin-sdk/outbound-media";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { normalizePollInput } from "openclaw/plugin-sdk/poll-runtime";
+import { resolveChunkMode, resolveTextChunkLimit } from "openclaw/plugin-sdk/reply-chunking";
 import { createSubsystemLogger, getChildLogger as getChildLogger$1 } from "openclaw/plugin-sdk/runtime-env";
-import { extensionForMime } from "openclaw/plugin-sdk/media-mime";
+import { extensionForMime, mediaKindFromMime, normalizeMimeType } from "openclaw/plugin-sdk/media-mime";
 import { sanitizeForPlainText } from "openclaw/plugin-sdk/channel-outbound";
-import { MEDIA_FFMPEG_MAX_AUDIO_DURATION_SECS, runFfmpeg } from "openclaw/plugin-sdk/media-runtime";
+import { MEDIA_FFMPEG_MAX_AUDIO_DURATION_SECS, transcodeAudioBufferToOpus } from "openclaw/plugin-sdk/media-runtime";
 import { resolveOutboundMediaUrls } from "openclaw/plugin-sdk/reply-payload";
-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) {
@@ -95,11 +94,8 @@ function normalizeWhatsAppOutboundPayload(payload, options) {
 }
 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";
+	const inferredKind = mediaKindFromMime(normalizeMimeType(media.contentType));
+	return !inferredKind || inferredKind === "sticker" || inferredKind === "unknown" ? "document" : inferredKind;
 }
 function normalizeWhatsAppLoadedMedia(media, mediaUrl) {
 	const kind = inferWhatsAppMediaKind(media);
@@ -135,55 +131,23 @@ async function prepareWhatsAppOutboundMedia(media, mediaUrl) {
 		mimetype: WHATSAPP_VOICE_MIMETYPE
 	};
 }
-function normalizeContentType(value) {
-	return value?.split(";", 1)[0]?.trim().toLowerCase() ?? "";
-}
 function isWhatsAppNativeVoiceAudio(params) {
-	const contentType = normalizeContentType(params.contentType);
+	const contentType = normalizeMimeType(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);
+	return await transcodeAudioBufferToOpus({
+		audioBuffer: params.buffer,
+		inputFileName: params.fileName,
+		tempPrefix: "whatsapp-voice-",
+		outputFileName: WHATSAPP_VOICE_FILE_NAME,
+		maxDurationSeconds: MEDIA_FFMPEG_MAX_AUDIO_DURATION_SECS,
+		sampleRateHz: WHATSAPP_VOICE_SAMPLE_RATE_HZ,
+		channels: 1,
+		bitrate: WHATSAPP_VOICE_BITRATE
 	});
 }
 function deriveWhatsAppDocumentFileName(mediaUrl) {
@@ -197,25 +161,6 @@ function deriveWhatsAppDocumentFileName(mediaUrl) {
 	}
 }
 //#endregion
-//#region extensions/whatsapp/src/outbound-media.runtime.ts
-async function loadOutboundMediaFromUrl(mediaUrl, options = {}) {
-	const readFile = options.mediaAccess?.readFile ?? options.mediaReadFile;
-	const localRoots = options.mediaAccess?.localRoots?.length && options.mediaAccess.localRoots.length > 0 ? options.mediaAccess.localRoots : options.mediaLocalRoots && options.mediaLocalRoots.length > 0 ? options.mediaLocalRoots : void 0;
-	const sharedOptions = {
-		...options.maxBytes !== void 0 ? { maxBytes: options.maxBytes } : {},
-		...options.optimizeImages !== void 0 ? { optimizeImages: options.optimizeImages } : {}
-	};
-	return await loadWebMedia(mediaUrl, readFile ? {
-		...sharedOptions,
-		localRoots: "any",
-		readFile,
-		hostReadCapability: true
-	} : {
-		...sharedOptions,
-		...localRoots ? { localRoots } : {}
-	});
-}
-//#endregion
 //#region extensions/whatsapp/src/send.ts
 const outboundLog = createSubsystemLogger("gateway/channels/whatsapp").child("outbound");
 function supportsForcedDocumentDelivery(kind) {
@@ -295,8 +240,14 @@ async function sendMessageWhatsApp(to, body, options) {
 		channel: "whatsapp",
 		accountId: resolvedAccountId ?? options.accountId
 	});
-	text = convertMarkdownTables(text ?? "", tableMode);
-	text = markdownToWhatsApp(text);
+	const accountIdForFormatting = resolvedAccountId ?? options.accountId;
+	const textLimit = Math.min(resolveTextChunkLimit(cfg, "whatsapp", accountIdForFormatting, { fallbackLimit: 4e3 }), 4096);
+	const textChunks = markdownToWhatsAppChunks(text, textLimit, tableMode, resolveChunkMode(cfg, "whatsapp", accountIdForFormatting));
+	text = textChunks.shift() ?? "";
+	if (!text && !hasMedia) return {
+		messageId: "",
+		toJid: jid
+	};
 	const redactedTo = redactIdentifier(to);
 	const logger = getChildLogger$1({
 		module: "web-outbound",
@@ -352,16 +303,19 @@ async function sendMessageWhatsApp(to, body, options) {
 		const result = sendOptions ? await active.sendMessage(to, text, mediaBuffer, mediaType, sendOptions) : await active.sendMessage(to, text, mediaBuffer, mediaType);
 		const messageId = result?.messageId ?? "unknown";
 		const sentRemoteJid = resolveActualSentRemoteJid(result, jid);
-		if (visibleTextAfterVoice) {
+		const trailingTextChunks = [visibleTextAfterVoice, ...textChunks].filter((chunk) => Boolean(chunk));
+		if (trailingTextChunks.length > 0) {
 			await options.onDeliveryResult?.({
 				messageId,
 				toJid: sentRemoteJid
 			});
-			const captionResult = sendOptions ? await active.sendMessage(to, visibleTextAfterVoice, void 0, void 0, sendOptions) : await active.sendMessage(to, visibleTextAfterVoice, void 0, void 0);
-			await options.onDeliveryResult?.({
-				messageId: captionResult?.messageId ?? "unknown",
-				toJid: resolveActualSentRemoteJid(captionResult, jid)
-			});
+			for (const trailingText of trailingTextChunks) {
+				const trailingResult = sendOptions ? await active.sendMessage(to, trailingText, void 0, void 0, sendOptions) : await active.sendMessage(to, trailingText, void 0, void 0);
+				await options.onDeliveryResult?.({
+					messageId: trailingResult?.messageId ?? "unknown",
+					toJid: resolveActualSentRemoteJid(trailingResult, jid)
+				});
+			}
 		}
 		const durationMs = Date.now() - startedAt;
 		outboundLog.info(`Sent message ${messageId} -> ${redactedJid}${hasMedia ? " (media)" : ""} (${durationMs}ms)`);

package/dist/{send-api-BG0MgoFI.js → send-api-CpHwbor_.js}

@@ -1,16 +1,16 @@
 import { n as isWhatsAppNewsletterJid } from "./normalize-target-DSZnHkKF.js";
-import { l as resolveWhatsAppDocumentFileName } from "./send-SB-4JrVZ.js";
+import { l as resolveWhatsAppDocumentFileName } from "./send-DhJVN30g.js";
 import "./normalize-C-Z16y7Q.js";
-import { c as toWhatsappJidWithLid, r as jidToE164, s as toWhatsappJid } from "./targets-runtime-Bsh0HR9y.js";
-import "./text-runtime-BTGkMN0o.js";
-import { i as buildQuotedMessageOptions } from "./group-session-key-Dh8WZun_.js";
-import { c as resolveComparableIdentity } from "./identity-D7L8LCuH.js";
+import { c as toWhatsappJid, l as toWhatsappJidWithLid, r as jidToE164 } from "./targets-runtime-CKFrhoX4.js";
+import "./text-runtime-CU_IlbK5.js";
+import { i as buildQuotedMessageOptions } from "./group-session-key-DJSdYfnb.js";
+import { c as resolveComparableIdentity } from "./identity-BM4_wZeM.js";
 import { normalizeLowercaseStringOrEmpty, normalizeStringEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { logVerbose } from "openclaw/plugin-sdk/runtime-env";
 import { createMessageReceiptFromOutboundResults, listMessageReceiptPlatformIds } from "openclaw/plugin-sdk/channel-outbound";
 import { getImageMetadata, resizeToJpeg } from "openclaw/plugin-sdk/media-runtime";
-import { DisconnectReason, downloadMediaMessage, extractMessageContent, getContentType, isJidGroup, normalizeMessageContent, normalizeMessageContent as normalizeMessageContent$1 } from "baileys";
 import { formatLocationText } from "openclaw/plugin-sdk/channel-inbound";
+import { DisconnectReason, downloadMediaMessage, extractMessageContent, getContentType, isJidGroup, normalizeMessageContent, normalizeMessageContent as normalizeMessageContent$1 } from "baileys";
 import { recordChannelActivity } from "openclaw/plugin-sdk/channel-activity-runtime";
 //#region extensions/whatsapp/src/vcard.ts
 const ALLOWED_VCARD_KEYS = /* @__PURE__ */ new Set([
@@ -73,6 +73,20 @@ function normalizeVcardPhone(value) {
 	return trimmed;
 }
 //#endregion
+//#region extensions/whatsapp/src/inbound/media-mimetype.ts
+/**
+* Resolve the MIME type for an inbound media message.
+* Falls back to WhatsApp's standard formats when Baileys omits the MIME.
+*/
+function resolveInboundMediaMimetype(message) {
+	const explicit = message.imageMessage?.mimetype ?? message.videoMessage?.mimetype ?? message.documentMessage?.mimetype ?? message.audioMessage?.mimetype ?? message.stickerMessage?.mimetype ?? void 0;
+	if (explicit) return explicit;
+	if (message.audioMessage) return "audio/ogg; codecs=opus";
+	if (message.imageMessage) return "image/jpeg";
+	if (message.videoMessage) return "video/mp4";
+	if (message.stickerMessage) return "image/webp";
+}
+//#endregion
 //#region extensions/whatsapp/src/inbound/extract.ts
 function getFutureProofInnerMessage(message) {
 	const contentType = getContentType(message);
@@ -170,14 +184,14 @@ function extractExternalAdReplyContext(rawMessage) {
 		body
 	} : void 0;
 }
-function extractMediaPlaceholder(rawMessage) {
+function extractMediaKind(rawMessage) {
 	const message = unwrapMessage(rawMessage);
 	if (!message) return;
-	if (message.imageMessage) return "<media:image>";
-	if (message.videoMessage) return message.videoMessage.gifPlayback === true ? "<media:gif>" : "<media:video>";
-	if (message.audioMessage) return "<media:audio>";
-	if (message.documentMessage) return "<media:document>";
-	if (message.stickerMessage) return "<media:sticker>";
+	if (message.imageMessage) return "image";
+	if (message.videoMessage) return "video";
+	if (message.audioMessage) return "audio";
+	if (message.documentMessage) return "document";
+	if (message.stickerMessage) return "sticker";
 }
 function extractContactPlaceholder(rawMessage) {
 	const contactContext = extractContactContext(rawMessage);
@@ -275,9 +289,13 @@ function describeReplyContext(rawMessage) {
 	if (!quoted) return null;
 	const location = extractLocationData(quoted);
 	const locationText = location ? formatLocationText(location) : void 0;
-	let body = [extractText(quoted), locationText].filter(Boolean).join("\n").trim();
-	if (!body) body = extractMediaPlaceholder(quoted);
-	if (!body) {
+	const body = [extractText(quoted), locationText].filter(Boolean).join("\n").trim();
+	const mediaKind = extractMediaKind(quoted);
+	const media = mediaKind ? {
+		kind: mediaKind,
+		contentType: resolveInboundMediaMimetype(quoted)
+	} : void 0;
+	if (!body && !media) {
 		const quotedType = quoted ? getContentType(quoted) : void 0;
 		logVerbose(`Quoted message missing extractable body${quotedType ? ` (type ${quotedType})` : ""}`);
 		return null;
@@ -289,7 +307,8 @@ function describeReplyContext(rawMessage) {
 	});
 	return {
 		id: contextInfo?.stanzaId || void 0,
-		body,
+		body: body ?? "",
+		media,
 		sender
 	};
 }
@@ -307,26 +326,12 @@ function hasInteractiveResponseContent(message) {
 function hasInboundUserContent(rawMessage) {
 	if (!rawMessage) return false;
 	if (extractText(rawMessage)) return true;
-	if (extractMediaPlaceholder(rawMessage)) return true;
+	if (extractMediaKind(rawMessage)) return true;
 	if (extractLocationData(rawMessage)) return true;
 	for (const candidate of buildMessageChain(rawMessage)) if (hasInteractiveResponseContent(candidate)) return true;
 	return false;
 }
 //#endregion
-//#region extensions/whatsapp/src/inbound/media-mimetype.ts
-/**
-* Resolve the MIME type for an inbound media message.
-* Falls back to WhatsApp's standard formats when Baileys omits the MIME.
-*/
-function resolveInboundMediaMimetype(message) {
-	const explicit = message.imageMessage?.mimetype ?? message.videoMessage?.mimetype ?? message.documentMessage?.mimetype ?? message.audioMessage?.mimetype ?? message.stickerMessage?.mimetype ?? void 0;
-	if (explicit) return explicit;
-	if (message.audioMessage) return "audio/ogg; codecs=opus";
-	if (message.imageMessage) return "image/jpeg";
-	if (message.videoMessage) return "video/mp4";
-	if (message.stickerMessage) return "image/webp";
-}
-//#endregion
 //#region extensions/whatsapp/src/image-preview.ts
 const WHATSAPP_IMAGE_THUMBNAIL_SIDE = 32;
 const WHATSAPP_IMAGE_THUMBNAIL_QUALITY = 50;
@@ -673,7 +678,8 @@ function createWebSendApi(params) {
 				remoteJid: sendOptions?.quotedMessageKey?.remoteJid,
 				fromMe: sendOptions?.quotedMessageKey?.fromMe,
 				participant: sendOptions?.quotedMessageKey?.participant,
-				messageText: sendOptions?.quotedMessageKey?.messageText
+				messageText: sendOptions?.quotedMessageKey?.messageText,
+				media: sendOptions?.quotedMessageKey?.media
 			});
 			const results = [normalizeWhatsAppSendResult(quotedOpts ? await params.sock.sendMessage(jid, payload, quotedOpts) : await params.sock.sendMessage(jid, payload), mediaBuffer ? "media" : "text")];
 			if (shouldSendAudioText) {
@@ -735,4 +741,4 @@ function createWebSendApi(params) {
 	};
 }
 //#endregion
-export { extractLocationData as _, mayContainWhatsAppOutboundMention as a, extractText as b, DisconnectReason as c, normalizeMessageContent$1 as d, resolveInboundMediaMimetype as f, extractExternalAdReplyContext as g, extractContextInfo as h, addWhatsAppOutboundMentionsToContent as i, downloadMediaMessage as l, extractContactContext as m, listWhatsAppSendResultMessageIds as n, resolveWhatsAppOutboundMentions as o, describeReplyContext as p, normalizeWhatsAppSendResult as r, addWhatsAppImagePreviewFields as s, createWebSendApi as t, isJidGroup as u, extractMediaPlaceholder as v, hasInboundUserContent as x, extractMentionedJids as y };
+export { extractMediaKind as _, mayContainWhatsAppOutboundMention as a, hasInboundUserContent as b, DisconnectReason as c, normalizeMessageContent$1 as d, describeReplyContext as f, extractLocationData as g, extractExternalAdReplyContext as h, addWhatsAppOutboundMentionsToContent as i, downloadMediaMessage as l, extractContextInfo as m, listWhatsAppSendResultMessageIds as n, resolveWhatsAppOutboundMentions as o, extractContactContext as p, normalizeWhatsAppSendResult as r, addWhatsAppImagePreviewFields as s, createWebSendApi as t, isJidGroup as u, extractMentionedJids as v, resolveInboundMediaMimetype as x, extractText as y };

package/dist/{setup-finalize-Cc-4iWGj.js → setup-finalize-9XzKdFq6.js}

@@ -1,8 +1,8 @@
-import { a as resolveWhatsAppAccount, o as resolveWhatsAppAuthDir } from "./accounts-ejK8sXPU.js";
+import { a as resolveWhatsAppAccount, o as resolveWhatsAppAuthDir } from "./accounts-CxPuEFi-.js";
 import { r as resolveDefaultWhatsAppAccountId } from "./account-ids-CB5SOWjc.js";
 import { r as hasWebCredsSync } from "./creds-files-B1kSWtBg.js";
 import { a as normalizeWhatsAppAllowFromEntries, o as normalizeWhatsAppAllowFromEntry } from "./normalize-target-DSZnHkKF.js";
-import { t as whatsappSetupAdapter } from "./setup-core-BbIgEl2M.js";
+import { r as whatsappSetupAdapter } from "./shared-CuqHFnKd.js";
 import { DEFAULT_ACCOUNT_ID, createSetupTranslator, splitSetupEntries } from "openclaw/plugin-sdk/setup";
 import { formatCliCommand, formatDocsLink } from "openclaw/plugin-sdk/setup-tools";
 //#region extensions/whatsapp/src/setup-finalize.ts
@@ -295,7 +295,7 @@ async function finalizeWhatsAppSetup(params) {
 		};
 		let loginWeb;
 		try {
-			({loginWeb} = await import("./login-ifOXCBjo.js").then((n) => n.n));
+			({loginWeb} = await import("./login-BKUm7KSk.js").then((n) => n.n));
 		} catch (error) {
 			await reportLoginFailure(error);
 		}

package/dist/setup-plugin-api.js

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

package/dist/{setup-surface-DhnXEZir.js → setup-surface-Kv3mPki2.js}

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

package/dist/{setup-core-BbIgEl2M.js → shared-CuqHFnKd.js}

@@ -1,8 +1,8 @@
-import { a as resolveWhatsAppAccount, n as hasAnyWhatsAppAuth } from "./accounts-ejK8sXPU.js";
+import { a as resolveWhatsAppAccount, n as hasAnyWhatsAppAuth } from "./accounts-CxPuEFi-.js";
 import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-CB5SOWjc.js";
 import { a as normalizeWhatsAppAllowFromEntries } from "./normalize-target-DSZnHkKF.js";
-import { t as WhatsAppChannelConfigSchema } from "./config-schema-BZ8h1hWA.js";
-import { n as whatsappDoctor } from "./doctor-By3SB4lm.js";
+import { t as WhatsAppChannelConfigSchema } from "./config-schema-C6IeKIC0.js";
+import { n as whatsappDoctor } from "./doctor-CwzVXKoE.js";
 import { t as resolveWhatsAppConfigPath } from "./group-config-path-BGyzT9Lg.js";
 import { t as resolveLegacyGroupSessionKey } from "./group-session-contract-DDnZSsJ1.js";
 import { n as unsupportedSecretRefSurfacePatterns, t as collectUnsupportedSecretRefConfigCandidates } from "./security-contract-nAzD945y.js";
@@ -11,12 +11,24 @@ import { normalizeUniqueStringEntries } from "openclaw/plugin-sdk/string-coerce-
 import { normalizeE164 } from "openclaw/plugin-sdk/account-resolution";
 import { createChannelPluginBase } from "openclaw/plugin-sdk/core";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
+import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { buildChannelGroupsScopeTree, collectOpenGroupPolicyRouteAllowlistWarnings, createAllowlistProviderGroupPolicyWarningCollector, resolveScopeRequireMention, resolveScopeToolsPolicy } from "openclaw/plugin-sdk/channel-policy";
+import { defineChannelSetupContract } from "openclaw/plugin-sdk/channel-setup";
+import { applyAccountNameToChannelSection, migrateBaseNameToDefaultAccount, normalizeAccountId as normalizeAccountId$1 } from "openclaw/plugin-sdk/setup";
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { adaptScopedAccountAccessor, createScopedChannelConfigAdapter, createScopedDmSecurityResolver } from "openclaw/plugin-sdk/channel-config-helpers";
 import { createDelegatedSetupWizardProxy } from "openclaw/plugin-sdk/setup-runtime";
 import { readChannelAllowFromStore } from "openclaw/plugin-sdk/channel-pairing";
-import { applyAccountNameToChannelSection, migrateBaseNameToDefaultAccount, normalizeAccountId as normalizeAccountId$1 } from "openclaw/plugin-sdk/setup";
+//#region extensions/whatsapp/src/channel-runtime-loader.ts
+const loadWhatsAppAuthStore = createLazyRuntimeModule(() => import("./auth-store-DirYMTbo.js").then((n) => n.i));
+async function isWhatsAppAuthConfigured(authDir) {
+	return await (await loadWhatsAppAuthStore()).readWebAuthState(authDir) === "linked";
+}
+const loadWhatsAppChannelRuntime = createLazyRuntimeModule(async () => {
+	await loadWhatsAppAuthStore();
+	return await import("./channel.runtime-DdKuhlNu.js");
+});
+//#endregion
 //#region extensions/whatsapp/src/config-accessors.ts
 function formatWhatsAppConfigAllowFromEntries(allowFrom) {
 	return normalizeWhatsAppAllowFromEntries(allowFrom);
@@ -41,6 +53,62 @@ function resolveWhatsAppGroupToolPolicy(params) {
 	});
 }
 //#endregion
+//#region extensions/whatsapp/src/setup-core.ts
+const channel = "whatsapp";
+const whatsappSetupAdapter = {
+	singleAccountKeysToMove: ["authDir"],
+	resolveAccountId: ({ accountId }) => normalizeAccountId$1(accountId),
+	applyAccountName: ({ cfg, accountId, name }) => applyAccountNameToChannelSection({
+		cfg,
+		channelKey: channel,
+		accountId,
+		name,
+		alwaysUseAccounts: true
+	}),
+	applyAccountConfig: ({ cfg, accountId, input }) => {
+		const setupInput = input;
+		const next = migrateBaseNameToDefaultAccount({
+			cfg: applyAccountNameToChannelSection({
+				cfg,
+				channelKey: channel,
+				accountId,
+				name: setupInput.name,
+				alwaysUseAccounts: true
+			}),
+			channelKey: channel,
+			alwaysUseAccounts: true
+		});
+		const entry = {
+			...next.channels?.whatsapp?.accounts?.[accountId],
+			...setupInput.authDir ? { authDir: setupInput.authDir } : {},
+			enabled: true
+		};
+		return {
+			...next,
+			channels: {
+				...next.channels,
+				whatsapp: {
+					...next.channels?.whatsapp,
+					accounts: {
+						...next.channels?.whatsapp?.accounts,
+						[accountId]: entry
+					}
+				}
+			}
+		};
+	}
+};
+const whatsappSetupContract = defineChannelSetupContract({
+	fields: { authDir: {
+		kind: "string",
+		cli: {
+			flags: "--auth-dir <path>",
+			description: "WhatsApp auth directory override"
+		}
+	} },
+	legacyAdapter: whatsappSetupAdapter
+});
+//#endregion
 //#region extensions/whatsapp/src/security-fix.ts
 function applyGroupAllowFromFromStore(params) {
 	const next = structuredClone(params.cfg ?? {});
@@ -83,11 +151,8 @@ async function applyWhatsAppSecurityConfigFixes(params) {
 //#endregion
 //#region extensions/whatsapp/src/shared.ts
 const WHATSAPP_CHANNEL = "whatsapp";
-async function loadWhatsAppChannelRuntime() {
-	return await import("./channel.runtime-CjkhQzk8.js");
-}
 async function loadWhatsAppSetupSurface() {
-	return await import("./setup-surface-DhnXEZir.js");
+	return await import("./setup-surface-Kv3mPki2.js");
 }
 const whatsappSetupWizardProxy = createWhatsAppSetupWizardProxy(async () => (await loadWhatsAppSetupSurface()).whatsappSetupWizard);
 const whatsappConfigAdapter = createScopedChannelConfigAdapter({
@@ -191,7 +256,7 @@ function createWhatsAppPluginBase(params) {
 			docsLabel: "whatsapp",
 			blurb: "works with your own number; recommend a separate phone + eSIM.",
 			systemImage: "message",
-			showConfigured: false,
+			exposure: { configured: false },
 			quickstartAllowFrom: true,
 			forceAccountBinding: true,
 			preferSessionLookupForAnnounceTarget: true
@@ -213,7 +278,7 @@ function createWhatsAppPluginBase(params) {
 		},
 		reload: {
 			configPrefixes: [
-				"web",
+				"channels.whatsapp.enabled",
 				"channels.whatsapp.accounts",
 				"channels.whatsapp.selfChatMode"
 			],
@@ -223,7 +288,7 @@ function createWhatsAppPluginBase(params) {
 		configSchema: WhatsAppChannelConfigSchema,
 		config: {
 			...whatsappConfigAdapter,
-			isEnabled: (account, cfg) => account.enabled && cfg.web?.enabled !== false,
+			isEnabled: (account) => account.enabled,
 			disabledReason: () => "disabled",
 			isConfigured: params.isConfigured,
 			hasPersistedAuthState: ({ cfg }) => hasAnyWhatsAppAuth(cfg),
@@ -245,6 +310,7 @@ function createWhatsAppPluginBase(params) {
 		},
 		doctor: whatsappDoctor,
 		setup: params.setup,
+		...params.setupContract ? { setupContract: params.setupContract } : {},
 		groups: params.groups
 	});
 	return {
@@ -274,48 +340,4 @@ function createWhatsAppPluginBase(params) {
 	};
 }
 //#endregion
-//#region extensions/whatsapp/src/setup-core.ts
-const channel = "whatsapp";
-const whatsappSetupAdapter = {
-	resolveAccountId: ({ accountId }) => normalizeAccountId$1(accountId),
-	applyAccountName: ({ cfg, accountId, name }) => applyAccountNameToChannelSection({
-		cfg,
-		channelKey: channel,
-		accountId,
-		name,
-		alwaysUseAccounts: true
-	}),
-	applyAccountConfig: ({ cfg, accountId, input }) => {
-		const next = migrateBaseNameToDefaultAccount({
-			cfg: applyAccountNameToChannelSection({
-				cfg,
-				channelKey: channel,
-				accountId,
-				name: input.name,
-				alwaysUseAccounts: true
-			}),
-			channelKey: channel,
-			alwaysUseAccounts: true
-		});
-		const entry = {
-			...next.channels?.whatsapp?.accounts?.[accountId],
-			...input.authDir ? { authDir: input.authDir } : {},
-			enabled: true
-		};
-		return {
-			...next,
-			channels: {
-				...next.channels,
-				whatsapp: {
-					...next.channels?.whatsapp,
-					accounts: {
-						...next.channels?.whatsapp?.accounts,
-						[accountId]: entry
-					}
-				}
-			}
-		};
-	}
-};
-//#endregion
-export { resolveWhatsAppGroupRequireMention as a, whatsappSetupWizardProxy as i, createWhatsAppPluginBase as n, resolveWhatsAppGroupToolPolicy as o, loadWhatsAppChannelRuntime as r, formatWhatsAppConfigAllowFromEntries as s, whatsappSetupAdapter as t };
+export { resolveWhatsAppGroupRequireMention as a, isWhatsAppAuthConfigured as c, whatsappSetupContract as i, loadWhatsAppChannelRuntime as l, whatsappSetupWizardProxy as n, resolveWhatsAppGroupToolPolicy as o, whatsappSetupAdapter as r, formatWhatsAppConfigAllowFromEntries as s, createWhatsAppPluginBase as t };