@openclaw/whatsapp 2026.10.1 → 2026.10.5-beta.1

package/dist/.setup/{socket-close-DU7eerAa.mjs → socket-close-C9OU9mVN.mjs}

@@ -1,5 +1,5 @@
 import { a as readWebCredsJsonRawSync, o as resolveWebCredsBackupPath, s as resolveWebCredsPath, t as assertWebCredsPathRegularFileOrMissing } from "./creds-files-B8WcOAmE.mjs";
-import { M as writeCredsJsonAtomically, N as writeWebCredsRawAtomically, j as waitForCredsSaveQueueWithTimeout, k as enqueueCredsSave, v as resolveDefaultWebAuthDir, y as restoreCredsFromBackupIfNeeded } from "./auth-store-D2rN-hP5.mjs";
+import { M as writeCredsJsonAtomically, N as writeWebCredsRawAtomically, j as waitForCredsSaveQueueWithTimeout, k as enqueueCredsSave, v as resolveDefaultWebAuthDir, y as restoreCredsFromBackupIfNeeded } from "./auth-store-DOBi5BPe.mjs";
 import { n as getStatusCode } from "./session-errors-B8UcAnZN.mjs";
 import { a as makeWASocket, i as makeCacheableSignalKeyStore, n as createBaileysSignalRepository, r as fetchLatestBaileysVersion, s as useMultiFileAuthState } from "./session.runtime-st1konFI.mjs";
 import { VERSION, formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
@@ -13,7 +13,7 @@ import { parseStrictPositiveInteger, resolveTimerTimeoutMs } from "openclaw/plug
 import { raceWithTimeout, withTimeout } from "openclaw/plugin-sdk/time-runtime";
 import { createDeferred } from "openclaw/plugin-sdk/extension-shared";
 import { FILE_LOCK_STALE_ERROR_CODE, FILE_LOCK_TIMEOUT_ERROR_CODE, acquireFileLock } from "openclaw/plugin-sdk/file-lock";
-import { createNodeProxyAgent } from "openclaw/plugin-sdk/fetch-runtime";
+import { captureEffectAuthority, createNodeProxyAgent } from "openclaw/plugin-sdk/fetch-runtime";
 import { randomUUID } from "node:crypto";
 //#region extensions/whatsapp/src/connection-owner.ts
 const WHATSAPP_CONNECTION_OWNER_BUSY_CODE = "whatsapp_connection_owner_busy";
@@ -40,35 +40,23 @@ async function reserveProcessOwner(params) {
 			const released = createDeferred();
 			const owner = {
 				released: released.promise,
-				resolveReleased: released.resolve,
-				token: Symbol(params.ownerPath)
+				resolveReleased: released.resolve
 			};
 			processOwners.set(params.ownerPath, owner);
 			return owner;
 		}
 		if (!params.waitForLocalOwner) throw new WhatsAppConnectionOwnerBusyError(params.authDir);
-		let timer;
-		let onAbort;
-		const outcome = await Promise.race([
-			current.released.then(() => "released"),
-			new Promise((resolve) => {
-				timer = setTimeout(() => resolve("timed_out"), GATEWAY_LOCAL_OWNER_WAIT_MS);
-				timer.unref?.();
-			}),
-			new Promise((resolve) => {
-				onAbort = () => resolve("aborted");
-				params.signal?.addEventListener("abort", onAbort, { once: true });
-			})
-		]).finally(() => {
-			if (timer) clearTimeout(timer);
-			if (onAbort) params.signal?.removeEventListener("abort", onAbort);
+		const outcome = await raceWithTimeout(current.released.then(() => "released"), GATEWAY_LOCAL_OWNER_WAIT_MS, () => "timed_out", {
+			ref: false,
+			signal: params.signal,
+			onAbort: () => "aborted"
 		});
 		if (outcome === "aborted") throw ownershipCancelledError(params.signal);
 		if (outcome === "timed_out") throw new WhatsAppConnectionOwnerBusyError(params.authDir);
 	}
 }
 function abandonProcessOwner(ownerPath, owner) {
-	if (processOwners.get(ownerPath)?.token !== owner.token) return;
+	if (processOwners.get(ownerPath) !== owner) return;
 	processOwners.delete(ownerPath);
 	owner.resolveReleased();
 }
@@ -84,41 +72,37 @@ async function acquireOwnerLease(params) {
 	});
 	let fileLock;
 	let attempt = 0;
-	while (true) {
-		if (params.signal?.aborted) {
-			abandonProcessOwner(ownerPath, processOwner);
-			throw ownershipCancelledError(params.signal);
-		}
-		try {
-			fileLock = await acquireFileLock(ownerPath, {
-				retries: {
-					retries: 0,
-					factor: 1,
-					minTimeout: 1,
-					maxTimeout: 1
-				},
-				stale: OWNER_LOCK_STALE_MS,
-				staleRecovery: "remove-if-unchanged"
-			});
-			break;
-		} catch (error) {
-			const code = error.code;
-			if (code === FILE_LOCK_STALE_ERROR_CODE) {
-				abandonProcessOwner(ownerPath, processOwner);
-				throw new WhatsAppConnectionOwnerBusyError(params.authDir, { cause: error });
-			}
-			if (code !== FILE_LOCK_TIMEOUT_ERROR_CODE || attempt >= params.retries) {
-				abandonProcessOwner(ownerPath, processOwner);
-				if (code === FILE_LOCK_TIMEOUT_ERROR_CODE) throw new WhatsAppConnectionOwnerBusyError(params.authDir, { cause: error });
-				throw error;
+	try {
+		while (true) {
+			if (params.signal?.aborted) throw ownershipCancelledError(params.signal);
+			try {
+				fileLock = await acquireFileLock(ownerPath, {
+					retries: {
+						retries: 0,
+						factor: 1,
+						minTimeout: 1,
+						maxTimeout: 1
+					},
+					stale: OWNER_LOCK_STALE_MS,
+					staleRecovery: "remove-if-unchanged"
+				});
+				break;
+			} catch (error) {
+				const code = error.code;
+				if (code !== FILE_LOCK_TIMEOUT_ERROR_CODE || attempt >= params.retries) {
+					if (code === FILE_LOCK_TIMEOUT_ERROR_CODE || code === FILE_LOCK_STALE_ERROR_CODE) throw new WhatsAppConnectionOwnerBusyError(params.authDir, { cause: error });
+					throw error;
+				}
+				const delayMs = Math.min(100 * 1.5 ** attempt, 1e3);
+				attempt += 1;
+				await sleepWithAbort(delayMs, params.signal).catch(() => {
+					throw ownershipCancelledError(params.signal);
+				});
 			}
-			const delayMs = Math.min(100 * 1.5 ** attempt, 1e3);
-			attempt += 1;
-			await sleepWithAbort(delayMs, params.signal).catch(() => {
-				abandonProcessOwner(ownerPath, processOwner);
-				throw ownershipCancelledError(params.signal);
-			});
 		}
+	} catch (error) {
+		abandonProcessOwner(ownerPath, processOwner);
+		throw error;
 	}
 	let releasePromise = null;
 	return { release: async () => {
@@ -195,19 +179,28 @@ async function withWhatsAppSocketOperationTimeout(operation, promise, timeoutMs,
 }
 function createWhatsAppSocketOperationTimeoutAdapter(sock, timeoutMs, hooks) {
 	const operationTimeoutMs = resolveWhatsAppSocketOperationTimeoutMs(timeoutMs);
-	return {
-		sendMessage: (jid, content, options) => {
-			return runSerializedSocketSendMessage(sock, () => {
-				const send = options ? sock.sendMessage(jid, content, options) : sock.sendMessage(jid, content);
-				return withWhatsAppSocketOperationTimeout("sendMessage", send, operationTimeoutMs, hooks?.onSendMessageTimeout ? () => hooks.onSendMessageTimeout?.({
-					jid,
-					promise: send
-				}) : void 0);
+	const runOperation = (operation, send, onTimeout) => {
+		const effect = captureEffectAuthority();
+		const run = () => {
+			let active = true;
+			const promise = effect.initiate(() => {
+				if (!active) throw new WhatsAppSocketOperationTimeoutError(operation, operationTimeoutMs);
+				hooks?.assertCurrent?.();
+				return send();
 			});
-		},
-		sendPresenceUpdate: (presence, jid) => {
-			return withWhatsAppSocketOperationTimeout("sendPresenceUpdate", jid === void 0 ? sock.sendPresenceUpdate(presence) : sock.sendPresenceUpdate(presence, jid), operationTimeoutMs);
-		}
+			return withWhatsAppSocketOperationTimeout(operation, promise, operationTimeoutMs, () => {
+				active = false;
+				onTimeout?.(promise);
+			});
+		};
+		return operation === "sendMessage" ? runSerializedSocketSendMessage(sock, run) : run();
+	};
+	return {
+		sendMessage: (jid, content, options) => runOperation("sendMessage", () => options ? sock.sendMessage(jid, content, options) : sock.sendMessage(jid, content), (promise) => hooks?.onSendMessageTimeout?.({
+			jid,
+			promise
+		})),
+		sendPresenceUpdate: (presence, jid) => runOperation("sendPresenceUpdate", () => jid === void 0 ? sock.sendPresenceUpdate(presence) : sock.sendPresenceUpdate(presence, jid))
 	};
 }
 //#endregion
@@ -313,10 +306,6 @@ function resolveEnvWaWebSocketUrl() {
 	if (url.protocol !== "ws:" && url.protocol !== "wss:") throw new Error(`${OPENCLAW_WHATSAPP_WEB_SOCKET_URL_ENV} must use ws:// or wss://.`);
 	return url.toString();
 }
-/**
-* Create a Baileys socket backed by the multi-file auth store we keep on disk.
-* Consumers can opt into QR printing for interactive login flows.
-*/
 async function createWaSocket(printQr, verbose, opts = {}) {
 	return await createWaSocketInternal(printQr, verbose, opts, "normal");
 }
@@ -357,6 +346,11 @@ async function createWaSocketInternal(printQr, verbose, opts, receiveMode) {
 		else pendingSocketAbort = { error };
 		opts.onCredentialPersistenceError?.(error);
 	};
+	const observeCredentialPersistence = (task, reportError = false) => {
+		opts.onCredentialPersistenceTask?.(task);
+		if (reportError) task.then(void 0, reportCredentialPersistenceError);
+		return task;
+	};
 	const persistedSignalKeys = opts.beforeCredentialPersistence ? {
 		...state.keys,
 		async set(data) {
@@ -368,9 +362,7 @@ async function createWaSocketInternal(printQr, verbose, opts, receiveMode) {
 	const signalKeys = opts.beforeCredentialPersistence ? {
 		...cachedSignalKeys,
 		get(type, ids) {
-			const task = Promise.resolve(cachedSignalKeys.get(type, ids));
-			opts.onCredentialPersistenceTask?.(task);
-			return task;
+			return observeCredentialPersistence(Promise.resolve(cachedSignalKeys.get(type, ids)));
 		},
 		set(data) {
 			const task = (async () => {
@@ -381,26 +373,15 @@ async function createWaSocketInternal(printQr, verbose, opts, receiveMode) {
 					throw error;
 				}
 			})();
-			opts.onCredentialPersistenceTask?.(task);
-			return task;
+			return observeCredentialPersistence(task);
 		}
 	} : cachedSignalKeys;
 	const makeSignalRepository = opts.onCredentialPersistenceTask ? (...args) => {
 		const repository = createBaileysSignalRepository(...args);
 		const storeLidPnMappings = repository.lidMapping.storeLIDPNMappings.bind(repository.lidMapping);
-		repository.lidMapping.storeLIDPNMappings = (...storeArgs) => {
-			const task = storeLidPnMappings(...storeArgs);
-			opts.onCredentialPersistenceTask?.(task);
-			task.then(void 0, reportCredentialPersistenceError);
-			return task;
-		};
+		repository.lidMapping.storeLIDPNMappings = (...storeArgs) => observeCredentialPersistence(storeLidPnMappings(...storeArgs), true);
 		const migrateSession = repository.migrateSession.bind(repository);
-		repository.migrateSession = (...migrateArgs) => {
-			const task = migrateSession(...migrateArgs);
-			opts.onCredentialPersistenceTask?.(task);
-			task.then(void 0, reportCredentialPersistenceError);
-			return task;
-		};
+		repository.migrateSession = (...migrateArgs) => observeCredentialPersistence(migrateSession(...migrateArgs), true);
 		return repository;
 	} : void 0;
 	const sock = makeWASocket({

package/dist/.setup/{targets-runtime-Dls-Xh4F.mjs → targets-runtime-D5ryyPxh.mjs}

@@ -79,12 +79,11 @@ function addUniqueString(target, value) {
 	const normalized = value?.trim();
 	if (normalized && !target.includes(normalized)) target.push(normalized);
 }
-async function tryLookupMappedJid(lookup) {
-	if (!lookup) return null;
+async function tryLookupMappedJid(lookup, failureContext = "") {
 	try {
 		return await lookup() ?? null;
 	} catch (err) {
-		if (shouldLogVerbose()) logVerbose(`LID mapping lookup failed: ${String(err)}`);
+		if (shouldLogVerbose()) logVerbose(`LID mapping lookup failed${failureContext}: ${String(err)}`);
 		return null;
 	}
 }
@@ -101,29 +100,25 @@ async function resolveEquivalentWhatsAppDirectChatJids(jid, opts) {
 	const candidates = [];
 	addEquivalentDirectChatCandidate(candidates, normalized);
 	const pnMatch = normalized.match(DIRECT_PN_JID_RE);
+	const match = pnMatch ?? normalized.match(DIRECT_LID_JID_RE);
+	if (!match) return candidates;
+	addEquivalentDirectChatCandidate(candidates, await tryLookupMappedJid(() => pnMatch ? opts?.lidLookup?.getLIDForPN?.(normalized) : opts?.lidLookup?.getPNForLID?.(normalized)));
+	const digits = match[1];
+	const domain = match[2];
+	if (!digits || !domain) return candidates;
 	if (pnMatch) {
-		addEquivalentDirectChatCandidate(candidates, await tryLookupMappedJid(() => opts?.lidLookup?.getLIDForPN?.(normalized)));
-		const phoneDigits = pnMatch[1];
-		const pnDomain = pnMatch[2];
-		if (!phoneDigits || !pnDomain) return candidates;
 		const mappedLocalLid = readLidForwardMapping({
-			phoneDigits,
+			phoneDigits: digits,
 			opts
 		});
-		const localLidDomain = pnDomain.toLowerCase() === "hosted" ? "hosted.lid" : "lid";
+		const localLidDomain = domain.toLowerCase() === "hosted" ? "hosted.lid" : "lid";
 		addUniqueString(candidates, mappedLocalLid ? `${mappedLocalLid}@${localLidDomain}` : null);
-		return candidates;
-	}
-	const lidMatch = normalized.match(DIRECT_LID_JID_RE);
-	if (lidMatch) {
-		addEquivalentDirectChatCandidate(candidates, await tryLookupMappedJid(() => opts?.lidLookup?.getPNForLID?.(normalized)));
-		const lidDomain = lidMatch[2];
-		if (!lidMatch[1] || !lidDomain) return candidates;
+	} else {
 		const e164 = jidToE164(normalized, {
 			...opts,
 			logMissing: false
 		});
-		addUniqueString(candidates, e164 && lidDomain.toLowerCase() === "hosted.lid" ? `${e164.replace(/\D/g, "")}@hosted` : e164 ? toWhatsappJid(e164) : null);
+		addUniqueString(candidates, e164 && domain.toLowerCase() === "hosted.lid" ? `${e164.replace(/\D/g, "")}@hosted` : e164 ? toWhatsappJid(e164) : null);
 	}
 	return candidates;
 }
@@ -172,14 +167,10 @@ async function resolveJidToE164(jid, opts) {
 	const direct = jidToE164(jid, opts);
 	if (direct) return direct;
 	if (!/(@lid|@hosted\.lid)$/.test(jid) || !opts?.lidLookup?.getPNForLID) return null;
-	try {
-		const pnJid = await opts.lidLookup.getPNForLID(jid);
-		if (!pnJid) return null;
-		return jidToE164(pnJid, opts);
-	} catch (err) {
-		if (shouldLogVerbose()) logVerbose(`LID mapping lookup failed for ${jid}: ${String(err)}`);
-		return null;
-	}
+	return await tryLookupMappedJid(async () => {
+		const pnJid = await opts.lidLookup?.getPNForLID?.(jid);
+		return pnJid ? jidToE164(pnJid, opts) : null;
+	}, ` for ${jid}`);
 }
 function protectWhatsAppEscapedMarkers(text) {
 	const placeholders = [];

package/dist/action-runtime-api.js

@@ -1,2 +1,2 @@
-import { t as handleWhatsAppAction } from "./.setup/action-runtime-CE3zGstN.mjs";
+import { t as handleWhatsAppAction } from "./.setup/action-runtime-DUSkWTiZ.mjs";
 export { handleWhatsAppAction };

package/dist/action-runtime.runtime.js

@@ -1,2 +1,2 @@
-import { t as handleWhatsAppAction } from "./.setup/action-runtime-CE3zGstN.mjs";
+import { t as handleWhatsAppAction } from "./.setup/action-runtime-DUSkWTiZ.mjs";
 export { handleWhatsAppAction };

package/dist/agent-tools-api.js

@@ -1,7 +1,7 @@
 import { a as resolveWhatsAppAccount } from "./.setup/accounts-F0vHuze2.mjs";
 import { r as getWhatsAppConnectionController } from "./.setup/connection-controller-runtime-context-hgLJoRc8.mjs";
-import { s as resolveJidToE164 } from "./.setup/targets-runtime-Dls-Xh4F.mjs";
-import { n as registerWhatsAppLoginTool } from "./.setup/agent-tools-login-B7VEvJO7.mjs";
+import { s as resolveJidToE164 } from "./.setup/targets-runtime-D5ryyPxh.mjs";
+import { n as registerWhatsAppLoginTool } from "./.setup/agent-tools-login-CB7OQbli.mjs";
 import { createActionGate, stringEnum } from "openclaw/plugin-sdk/channel-actions";
 import path from "node:path";
 import { resolveOAuthDir } from "openclaw/plugin-sdk/state-paths";
@@ -81,11 +81,7 @@ function resolveCallWindowMs(pcmBytes, sampleRate) {
 }
 async function resolveRequesterE164(params) {
 	const senderId = params.requesterSenderId.trim();
-	if (!senderId.includes("@")) try {
-		return normalizeE164(senderId.replace(/^whatsapp:/i, ""));
-	} catch {
-		return null;
-	}
+	if (!senderId.includes("@")) return normalizeE164(senderId.replace(/^whatsapp:/i, ""));
 	const account = resolveWhatsAppAccount({
 		cfg: params.cfg,
 		accountId: params.accountId
@@ -101,7 +97,7 @@ async function resolveLinkedWhatsAppSelfE164(params) {
 	if (!controller) return null;
 	const identity = controller.getSelfIdentity();
 	if (!identity) return null;
-	if (identity.e164) return normalizeE164(identity.e164);
+	if (identity.e164) return identity.e164;
 	const account = resolveWhatsAppAccount({
 		cfg: params.cfg,
 		accountId: params.accountId

package/dist/api.js

@@ -1,17 +1,17 @@
 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 "./.setup/accounts-F0vHuze2.mjs";
 import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./.setup/account-ids-CB5SOWjc.mjs";
-import { a as normalizeWhatsAppAllowFromEntries, c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, r as isWhatsAppUserTarget, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./.setup/normalize-target-BGra1ZnM.mjs";
-import { t as resolveWhatsAppOutboundTarget } from "./.setup/resolve-outbound-target-CzyNKmrl.mjs";
-import { c as toWhatsappJid, i as markdownToWhatsApp, l as toWhatsappJidWithLid, n as isSelfChatMode, r as jidToE164, s as resolveJidToE164, t as assertWebChannel } from "./.setup/targets-runtime-Dls-Xh4F.mjs";
-import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS, t as whatsappPlugin } from "./.setup/channel-DNgKHMCz.mjs";
-import { i as resolveWhatsAppGroupToolPolicy, r as resolveWhatsAppGroupRequireMention } from "./.setup/shared-CP_zs2U7.mjs";
+import { a as normalizeWhatsAppAllowFromEntries, c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, r as isWhatsAppUserTarget, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./.setup/normalize-target-D67Kc3g6.mjs";
+import { t as resolveWhatsAppOutboundTarget } from "./.setup/resolve-outbound-target-qikGL4r0.mjs";
+import { c as toWhatsappJid, i as markdownToWhatsApp, l as toWhatsappJidWithLid, n as isSelfChatMode, r as jidToE164, s as resolveJidToE164, t as assertWebChannel } from "./.setup/targets-runtime-D5ryyPxh.mjs";
+import { n as WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS, t as whatsappPlugin } from "./.setup/channel-DcHw3Up2.mjs";
+import { i as resolveWhatsAppGroupToolPolicy, r as resolveWhatsAppGroupRequireMention } from "./.setup/shared-SqcOkt51.mjs";
 import { t as whatsappCommandPolicy } from "./.setup/command-policy-BIOSHySD.mjs";
-import { t as whatsappSetupPlugin } from "./.setup/channel.setup-CsS_NAKQ.mjs";
+import { t as whatsappSetupPlugin } from "./.setup/channel.setup-BJWEyQlF.mjs";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./.setup/constants-C7m81BNe.mjs";
-import { d as DEFAULT_WHATSAPP_SOCKET_TIMING, f as createWhatsAppSocketOperationTimeoutAdapter, i as waitForWaConnection, r as createWaSocket } from "./.setup/socket-close-DU7eerAa.mjs";
+import { d as DEFAULT_WHATSAPP_SOCKET_TIMING, f as createWhatsAppSocketOperationTimeoutAdapter, i as waitForWaConnection, r as createWaSocket } from "./.setup/socket-close-C9OU9mVN.mjs";
 import { n as getStatusCode, t as formatError } from "./.setup/session-errors-B8UcAnZN.mjs";
-import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./.setup/directory-config-RYQomHyB.mjs";
-import { _ as resolveInboundMediaMimetype, c as extractContextInfo, m as findMessageSection, o as describeReplyContext, p as extractText, t as createWebSendApi, u as extractLocationData } from "./.setup/send-api-B03VDwZ1.mjs";
+import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./.setup/directory-config-DPLTUAqy.mjs";
+import { _ as resolveInboundMediaMimetype, c as extractContextInfo, m as findMessageSection, o as describeReplyContext, p as extractText, t as createWebSendApi, u as extractLocationData } from "./.setup/send-api-COzRvqXx.mjs";
 import { asBoolean, isRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { formatLocationText } from "openclaw/plugin-sdk/channel-inbound";
 import { normalizeE164, resolveUserPath } from "openclaw/plugin-sdk/text-utility-runtime";
@@ -108,7 +108,6 @@ async function startWhatsAppQaDriverSession(params) {
 	const observedMessages = [];
 	const waiters = /* @__PURE__ */ new Set();
 	let pendingNotificationsWaiter;
-	let closed = false;
 	let closedError;
 	let receivedPendingNotifications = false;
 	const removeWaiter = (waiter) => {
@@ -149,8 +148,7 @@ async function startWhatsAppQaDriverSession(params) {
 		sock.ev.off("connection.update", onConnectionUpdate);
 	};
 	const closeSessionResources = (waiterError) => {
-		if (closed) return;
-		closed = true;
+		if (closedError) return;
 		closedError = waiterError;
 		settlePendingNotifications(waiterError);
 		for (const waiter of waiters) {
@@ -169,8 +167,8 @@ async function startWhatsAppQaDriverSession(params) {
 				resolve();
 				return;
 			}
-			if (closed) {
-				reject(closedError ?? /* @__PURE__ */ new Error("WhatsApp QA driver session closed"));
+			if (closedError) {
+				reject(closedError);
 				return;
 			}
 			const timeoutMs = params.connectionTimeoutMs ?? 45e3;
@@ -224,7 +222,7 @@ async function startWhatsAppQaDriverSession(params) {
 			const predicate = (message) => (!paramsLocal.observedAfter || new Date(message.observedAt).getTime() >= paramsLocal.observedAfter.getTime()) && paramsLocal.match(message);
 			const existing = observedMessages.find(predicate);
 			if (existing) return existing;
-			if (closed) throw closedError ?? /* @__PURE__ */ new Error("WhatsApp QA driver session closed");
+			if (closedError) throw closedError;
 			return await new Promise((resolve, reject) => {
 				const waiter = {
 					predicate,

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as whatsappPlugin } from "./.setup/channel-DNgKHMCz.mjs";
+import { t as whatsappPlugin } from "./.setup/channel-DcHw3Up2.mjs";
 export { whatsappPlugin };

package/dist/contract-api.js

@@ -1,4 +1,4 @@
-import { c as normalizeWhatsAppTarget$1, t as isWhatsAppGroupJid$1 } from "./.setup/normalize-target-BGra1ZnM.mjs";
+import { c as normalizeWhatsAppTarget$1, t as isWhatsAppGroupJid$1 } from "./.setup/normalize-target-D67Kc3g6.mjs";
 import { t as whatsappCommandPolicy$1 } from "./.setup/command-policy-BIOSHySD.mjs";
 import { t as resolveLegacyGroupSessionKey$1 } from "./.setup/group-session-contract-DDnZSsJ1.mjs";
 import { r as isLegacyGroupSessionKey$1, t as canonicalizeLegacySessionKey$1 } from "./.setup/session-contract-DMTm6Q_L.mjs";

package/dist/directory-contract-api.js

@@ -1,4 +1,4 @@
-import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./.setup/directory-config-RYQomHyB.mjs";
+import { n as listWhatsAppDirectoryGroupsFromConfig, r as listWhatsAppDirectoryPeersFromConfig } from "./.setup/directory-config-DPLTUAqy.mjs";
 //#region extensions/whatsapp/directory-contract-api.ts
 const whatsappDirectoryContractPlugin = {
 	id: "whatsapp",

package/dist/doctor-contract-api.js

@@ -69,16 +69,18 @@ const whatsappLegacyStateMigration = {
 		const sources = await listSources(params);
 		const changes = [];
 		const warnings = [];
+		const warn = (message, recoverable = false) => ({
+			changes,
+			warnings: [message],
+			...recoverable ? { warningDisposition: "recoverable" } : {}
+		});
 		if (sources.length === 0) return {
 			changes,
 			warnings
 		};
 		const assertCurrent = params.context.channelIngressQueues?.find((entry) => entry.channelId === "whatsapp")?.assertCurrent;
 		const { backupLegacyStateSource } = runtime_doctor_migrations_exports;
-		if (!assertCurrent || !backupLegacyStateSource) return {
-			changes,
-			warnings: ["WhatsApp credential import requires offline Doctor repair. Update OpenClaw core and run openclaw doctor --fix; original files remain unchanged."]
-		};
+		if (!assertCurrent || !backupLegacyStateSource) return warn("WhatsApp credential import requires offline Doctor repair. Update OpenClaw core and run openclaw doctor --fix; original files remain unchanged.");
 		const backups = [];
 		for (const source of sources) backups.push({
 			source,
@@ -102,16 +104,8 @@ const whatsappLegacyStateMigration = {
 		const targetCreds = path.join(targetDir, "creds.json");
 		const canonical = await credentials.exists(targetCreds) ? await credentials.read(targetCreds) : void 0;
 		const legacy = backups.find(({ source }) => source.name === "creds.json");
-		if (!legacy) return {
-			changes,
-			warnings: ["WhatsApp shared-root key files have no creds.json identity. Kept all original files and private .migrated backups; restore the original creds.json before retrying Doctor."],
-			...canonical ? { warningDisposition: "recoverable" } : {}
-		};
-		if (canonical && !canonical.buffer.equals(legacy.backup.bytes)) return {
-			changes,
-			warnings: ["WhatsApp canonical credentials differ from the legacy shared root. Kept both complete sets and private .migrated backups; choose the intended authDir before removing either set."],
-			warningDisposition: "recoverable"
-		};
+		if (!legacy) return warn("WhatsApp shared-root key files have no creds.json identity. Kept all original files and private .migrated backups; restore the original creds.json before retrying Doctor.", Boolean(canonical));
+		if (canonical && !canonical.buffer.equals(legacy.backup.bytes)) return warn("WhatsApp canonical credentials differ from the legacy shared root. Kept both complete sets and private .migrated backups; choose the intended authDir before removing either set.", true);
 		const targetNames = await fs$1.readdir(path.join(params.oauthDir, targetDir)).catch((error) => {
 			if (extractErrorCode(error) === "ENOENT") return [];
 			throw error;
@@ -126,32 +120,18 @@ const whatsappLegacyStateMigration = {
 			maxEntries: 4096,
 			overflowPolicy: "reject-new"
 		});
-		if (!receiptStore.withCurrent) return {
-			changes,
-			warnings: ["WhatsApp credential import requires current offline storage authority. Update OpenClaw core and rerun Doctor; original credentials remain unchanged."]
-		};
+		if (!receiptStore.withCurrent) return warn("WhatsApp credential import requires current offline storage authority. Update OpenClaw core and rerun Doctor; original credentials remain unchanged.");
 		const receipts = receiptStore.withCurrent({ assertCurrent });
 		const sourceIdentity = legacy.backup.snapshot.sha256;
 		const previous = await receipts.lookup(sourceIdentity);
-		if (previous && (!canonical || previous.targetDigest !== credentialSetDigest(targetFiles))) return {
-			changes,
-			warnings: ["WhatsApp credential migration previously started, but its complete canonical credential set is absent or changed. Kept source files and backups; restore the complete intended account or select its authDir explicitly. Doctor will not recreate credentials after logout."],
-			...canonical ? { warningDisposition: "recoverable" } : {}
-		};
+		if (previous && (!canonical || previous.targetDigest !== credentialSetDigest(targetFiles))) return warn("WhatsApp credential migration previously started, but its complete canonical credential set is absent or changed. Kept source files and backups; restore the complete intended account or select its authDir explicitly. Doctor will not recreate credentials after logout.", Boolean(canonical));
 		if (!canonical) {
 			const sourceNames = new Set(sources.map((source) => source.name));
-			if (targetNames.some((name) => isWhatsAppBaileysAuthFileName(name) && !sourceNames.has(name))) return {
-				changes,
-				warnings: ["WhatsApp default account contains unmatched auth files without creds.json. Kept the incomplete account and legacy credentials separate; choose the intended credential set before retrying Doctor."]
-			};
+			if (targetNames.some((name) => isWhatsAppBaileysAuthFileName(name) && !sourceNames.has(name))) return warn("WhatsApp default account contains unmatched auth files without creds.json. Kept the incomplete account and legacy credentials separate; choose the intended credential set before retrying Doctor.");
 		}
 		for (const { source, backup } of backups) {
 			const relativePath = path.join(targetDir, source.name);
-			if (await credentials.exists(relativePath) && !(await credentials.read(relativePath)).buffer.equals(backup.bytes)) return {
-				changes,
-				warnings: [`WhatsApp auth ${source.name} differs between the default account and legacy shared root. Kept both copies and a private .migrated backup; choose the intended credential set before retrying Doctor.`],
-				...canonical ? { warningDisposition: "recoverable" } : {}
-			};
+			if (await credentials.exists(relativePath) && !(await credentials.read(relativePath)).buffer.equals(backup.bytes)) return warn(`WhatsApp auth ${source.name} differs between the default account and legacy shared root. Kept both copies and a private .migrated backup; choose the intended credential set before retrying Doctor.`, Boolean(canonical));
 		}
 		if (!previous) {
 			const expected = new Map(targetFiles);

package/dist/light-runtime-api.js

@@ -1,5 +1,5 @@
-import { t as createWhatsAppLoginTool } from "./.setup/agent-tools-login-B7VEvJO7.mjs";
-import { b as webAuthExists, c as logoutWeb, h as readWebSelfId, l as pickWebChannel, o as getWebAuthAgeMs, s as logWebSelfId, t as WA_WEB_AUTH_DIR, v as resolveDefaultWebAuthDir } from "./.setup/auth-store-D2rN-hP5.mjs";
+import { t as createWhatsAppLoginTool } from "./.setup/agent-tools-login-CB7OQbli.mjs";
+import { b as webAuthExists, c as logoutWeb, h as readWebSelfId, l as pickWebChannel, o as getWebAuthAgeMs, s as logWebSelfId, t as WA_WEB_AUTH_DIR, v as resolveDefaultWebAuthDir } from "./.setup/auth-store-DOBi5BPe.mjs";
 import { t as getActiveWebListener } from "./.setup/active-listener-CDjoX9QR.mjs";
 import { n as getStatusCode, t as formatError } from "./.setup/session-errors-B8UcAnZN.mjs";
 export { WA_WEB_AUTH_DIR, createWhatsAppLoginTool, formatError, getActiveWebListener, getStatusCode, getWebAuthAgeMs, logWebSelfId, logoutWeb, pickWebChannel, readWebSelfId, resolveDefaultWebAuthDir, webAuthExists };

package/dist/login-qr-runtime.js

@@ -1,12 +1,10 @@
-import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 //#region extensions/whatsapp/login-qr-runtime.ts
-const loadLoginQrModule = createLazyRuntimeModule(() => import("./.setup/login-qr-DFhGc5yH.mjs"));
 async function startWebLoginWithQr(...args) {
-	const { startWebLoginWithQr: startWebLoginWithQrLocal } = await loadLoginQrModule();
+	const { startWebLoginWithQr: startWebLoginWithQrLocal } = await import("./.setup/login-qr-BAWbPonj.mjs");
 	return await startWebLoginWithQrLocal(...args);
 }
 async function waitForWebLogin(...args) {
-	const { waitForWebLogin: waitForWebLoginLocal } = await loadLoginQrModule();
+	const { waitForWebLogin: waitForWebLoginLocal } = await import("./.setup/login-qr-BAWbPonj.mjs");
 	return await waitForWebLoginLocal(...args);
 }
 //#endregion

package/dist/runtime-api.js

@@ -1,16 +1,16 @@
 import { a as readWebCredsJsonRawSync, n as hasWebCredsSync, o as resolveWebCredsBackupPath, s as resolveWebCredsPath } from "./.setup/creds-files-B8WcOAmE.mjs";
-import { n as whatsAppActionRuntime, t as handleWhatsAppAction } from "./.setup/action-runtime-CE3zGstN.mjs";
-import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./.setup/send-CGUsUdoX.mjs";
+import { n as whatsAppActionRuntime, t as handleWhatsAppAction } from "./.setup/action-runtime-DUSkWTiZ.mjs";
+import { i as sendTypingWhatsApp, n as sendPollWhatsApp, r as sendReactionWhatsApp, t as sendMessageWhatsApp } from "./.setup/send-CLBfAzd6.mjs";
 import { a as setWhatsAppRuntime } from "./.setup/runtime-BLlToOi6.mjs";
 import { startWebLoginWithQr, waitForWebLogin } from "./login-qr-runtime.js";
-import { t as createWhatsAppLoginTool } from "./.setup/agent-tools-login-B7VEvJO7.mjs";
-import { A as waitForCredsSaveQueue, M as writeCredsJsonAtomically, _ as readWebSelfIdentityForDecision, a as formatWhatsAppWebAuthStatusState, b as webAuthExists, c as logoutWeb, d as readWebAuthExistsForDecision, f as readWebAuthSnapshot, g as readWebSelfIdentity, h as readWebSelfId, j as waitForCredsSaveQueueWithTimeout, l as pickWebChannel, m as readWebAuthState, n as WHATSAPP_AUTH_UNSTABLE_CODE, o as getWebAuthAgeMs, p as readWebAuthSnapshotBestEffort, r as WhatsAppAuthUnstableError, s as logWebSelfId, t as WA_WEB_AUTH_DIR, u as readWebAuthExistsBestEffort, v as resolveDefaultWebAuthDir, y as restoreCredsFromBackupIfNeeded } from "./.setup/auth-store-D2rN-hP5.mjs";
+import { t as createWhatsAppLoginTool } from "./.setup/agent-tools-login-CB7OQbli.mjs";
+import { A as waitForCredsSaveQueue, M as writeCredsJsonAtomically, _ as readWebSelfIdentityForDecision, a as formatWhatsAppWebAuthStatusState, b as webAuthExists, c as logoutWeb, d as readWebAuthExistsForDecision, f as readWebAuthSnapshot, g as readWebSelfIdentity, h as readWebSelfId, j as waitForCredsSaveQueueWithTimeout, l as pickWebChannel, m as readWebAuthState, n as WHATSAPP_AUTH_UNSTABLE_CODE, o as getWebAuthAgeMs, p as readWebAuthSnapshotBestEffort, r as WhatsAppAuthUnstableError, s as logWebSelfId, t as WA_WEB_AUTH_DIR, u as readWebAuthExistsBestEffort, v as resolveDefaultWebAuthDir, y as restoreCredsFromBackupIfNeeded } from "./.setup/auth-store-DOBi5BPe.mjs";
 import { t as DEFAULT_WEB_MEDIA_BYTES } from "./.setup/constants-C7m81BNe.mjs";
 import { n as resolveWebAccountId, t as getActiveWebListener } from "./.setup/active-listener-CDjoX9QR.mjs";
-import { i as waitForWaConnection, r as createWaSocket, s as newConnectionId } from "./.setup/socket-close-DU7eerAa.mjs";
+import { i as waitForWaConnection, r as createWaSocket, s as newConnectionId } from "./.setup/socket-close-C9OU9mVN.mjs";
 import { n as getStatusCode, t as formatError } from "./.setup/session-errors-B8UcAnZN.mjs";
-import { p as extractText, s as extractContactContext, u as extractLocationData } from "./.setup/send-api-B03VDwZ1.mjs";
-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 "./.setup/monitor-B5DS4PDV.mjs";
-import { t as loginWeb } from "./.setup/login-CV_4V021.mjs";
+import { p as extractText, s as extractContactContext, u as extractLocationData } from "./.setup/send-api-COzRvqXx.mjs";
+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 "./.setup/monitor-CmXEQad9.mjs";
+import { t as loginWeb } from "./.setup/login-DUx5JYuW.mjs";
 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, extractText, formatError, formatWhatsAppWebAuthStatusState, getActiveWebListener, getDefaultLocalRoots, getStatusCode, getWebAuthAgeMs, handleWhatsAppAction, hasWebCredsSync, loadWebMedia, loadWebMediaRaw, logWebSelfId, loginWeb, logoutWeb, monitorWebChannel, monitorWebInbox, newConnectionId, optimizeImageToJpeg, optimizeImageToPng, pickWebChannel, readWebCredsJsonRawSync as 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/setup-entry.js

@@ -5,7 +5,7 @@ var setup_entry_default = defineBundledChannelSetupEntry({
 	importMetaUrl: import.meta.url,
 	features: { legacySessionSurfaces: true },
 	plugin: {
-		specifier: fileURLToPath(new URL(".setup/setup-plugin-api-Bsp7jI-r.mjs", import.meta.url).href),
+		specifier: fileURLToPath(new URL(".setup/setup-plugin-api-8WdNCjRW.mjs", import.meta.url).href),
 		exportName: "whatsappSetupPlugin"
 	},
 	legacySessionSurface: {

package/dist/setup-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as whatsappSetupPlugin } from "./.setup/channel.setup-CsS_NAKQ.mjs";
+import { t as whatsappSetupPlugin } from "./.setup/channel.setup-BJWEyQlF.mjs";
 export { whatsappSetupPlugin };

package/node_modules/baileys/lib/Utils/messages-media.js

@@ -527,10 +527,9 @@ export function extensionForMediaMessage(message) {
     }
     return extension;
 }
-const isNodeRuntime = () => {
+const supportsNodeHttpUpload = () => {
     return (typeof process !== 'undefined' &&
-        process.versions?.node !== null &&
-        typeof process.versions.bun === 'undefined' &&
+        typeof process.versions?.node === 'string' &&
         typeof globalThis.Deno === 'undefined');
 };
 export const uploadWithNodeHttp = async ({ url, filePath, headers, timeoutMs, agent }, redirectCount = 0) => {
@@ -623,15 +622,12 @@ const uploadWithFetch = async ({ url, filePath, headers, timeoutMs, agent }) =>
  * This causes memory issues with large files (e.g., 1GB file = 1GB+ memory usage).
  * See: https://github.com/nodejs/undici/issues/4058
  *
- * Other runtimes (Bun, Deno, browsers) correctly stream the request body without
- * buffering, so we can use the web-standard Fetch API there.
- *
- * ## Future considerations:
- * Once the undici bug is fixed, we can simplify this to use only the Fetch API
- * across all runtimes. Monitor the GitHub issue for updates.
+ * Bun also uses Node HTTP to retain agent routing and replay files on redirects.
+ * Other runtimes use the web-standard Fetch API.
+ * Native fetch cannot consume generic Node agents or replay streamed bodies.
  */
 const uploadMedia = async (params, logger) => {
-    if (isNodeRuntime()) {
+    if (supportsNodeHttpUpload()) {
         logger?.debug('Using Node.js https module for upload (avoids undici buffering bug)');
         return uploadWithNodeHttp(params);
     }
@@ -689,7 +685,7 @@ export const getWAUploadToServer = ({ customUploadHosts, fetchAgent, logger, opt
             }
             catch (error) {
                 const isLast = hostname === hosts[uploadInfo.hosts.length - 1]?.hostname;
-                logger.warn({ trace: error?.stack, uploadResult: result }, `Error in uploading to ${hostname} ${isLast ? '' : ', retrying...'}`);
+                logger.warn({ trace: error?.stack ?? error?.message ?? String(error), uploadResult: result }, `Error in uploading to ${hostname} ${isLast ? '' : ', retrying...'}`);
             }
         }
         if (!urls) {