@openclaw/whatsapp 2026.7.1 → 2026.7.2-beta.1

package/dist/directory-contract-api.js

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

package/dist/doctor-contract-api.js

@@ -1,10 +1,95 @@
 import { t as normalizeCompatibilityConfig$1 } from "./doctor-By3SB4lm.js";
+import { asObjectRecord, defineChannelAliasMigration } from "openclaw/plugin-sdk/runtime-doctor";
 //#region extensions/whatsapp/src/doctor-contract.ts
+const streamingAliasMigration = defineChannelAliasMigration({
+	channelId: "whatsapp",
+	streaming: {
+		defaultMode: "partial",
+		deliveryOnly: true
+	}
+});
+const legacyConfigRules = streamingAliasMigration.legacyConfigRules;
+/** Deep-fills fields missing from target with copies of source values. */
+function fillMissingStreamingFields(target, source) {
+	let filled = false;
+	const value = { ...target };
+	for (const [key, sourceValue] of Object.entries(source)) {
+		if (sourceValue === void 0) continue;
+		const existing = value[key];
+		if (existing === void 0) {
+			value[key] = structuredClone(sourceValue);
+			filled = true;
+			continue;
+		}
+		const existingRecord = asObjectRecord(existing);
+		const sourceRecord = asObjectRecord(sourceValue);
+		if (!existingRecord || !sourceRecord) continue;
+		const merged = fillMissingStreamingFields(existingRecord, sourceRecord);
+		if (merged.filled) {
+			value[key] = merged.value;
+			filled = true;
+		}
+	}
+	return {
+		value,
+		filled
+	};
+}
+function seedMigratedAccountStreaming(params) {
+	const channels = params.cfg.channels;
+	const entry = asObjectRecord(channels?.whatsapp);
+	const accounts = asObjectRecord(entry?.accounts);
+	if (!entry || !accounts) return params.cfg;
+	const rootStreaming = asObjectRecord(entry.streaming);
+	const defaultKey = Object.hasOwn(accounts, "default") ? "default" : Object.keys(accounts).find((key) => key.trim().toLowerCase() === "default");
+	let accountsChanged = false;
+	const nextAccounts = { ...accounts };
+	const seedOrder = Object.keys(accounts).toSorted((left, right) => left === defaultKey ? -1 : right === defaultKey ? 1 : left.localeCompare(right));
+	for (const accountId of seedOrder) {
+		const account = asObjectRecord(nextAccounts[accountId]);
+		const created = asObjectRecord(account?.streaming);
+		if (!account || !created || !params.accountsWithoutStreamingBefore.has(accountId)) continue;
+		const defaultStreaming = defaultKey ? asObjectRecord(asObjectRecord(nextAccounts[defaultKey])?.streaming) : null;
+		const inheritedSource = accountId === defaultKey ? rootStreaming : defaultStreaming ?? rootStreaming;
+		if (!inheritedSource) continue;
+		const seeded = fillMissingStreamingFields(created, inheritedSource);
+		if (!seeded.filled) continue;
+		nextAccounts[accountId] = {
+			...account,
+			streaming: seeded.value
+		};
+		accountsChanged = true;
+		const sourcePath = accountId === defaultKey ? "channels.whatsapp.streaming" : "effective channels.whatsapp streaming defaults";
+		params.changes.push(`Copied ${sourcePath} into channels.whatsapp.accounts.${accountId}.streaming to keep inherited settings while migrating flat streaming keys.`);
+	}
+	if (!accountsChanged) return params.cfg;
+	return {
+		...params.cfg,
+		channels: {
+			...channels,
+			whatsapp: {
+				...entry,
+				accounts: nextAccounts
+			}
+		}
+	};
+}
 function normalizeCompatibilityConfig({ cfg }) {
-	return normalizeCompatibilityConfig$1({ cfg });
+	const ackReaction = normalizeCompatibilityConfig$1({ cfg });
+	const accountsBefore = asObjectRecord(asObjectRecord(ackReaction.config.channels?.whatsapp)?.accounts);
+	const accountsWithoutStreamingBefore = new Set(Object.entries(accountsBefore ?? {}).filter(([, account]) => asObjectRecord(account)?.streaming === void 0).map(([accountId]) => accountId));
+	const aliases = streamingAliasMigration.normalizeChannelConfig({
+		cfg: ackReaction.config,
+		changes: ackReaction.changes
+	});
+	return {
+		config: seedMigratedAccountStreaming({
+			cfg: aliases.config,
+			accountsWithoutStreamingBefore,
+			changes: aliases.changes
+		}),
+		changes: aliases.changes
+	};
 }
 //#endregion
-//#region extensions/whatsapp/doctor-contract-api.ts
-const legacyConfigRules = [];
-//#endregion
 export { legacyConfigRules, normalizeCompatibilityConfig };

package/dist/{group-session-key-BhC1RQOE.js → group-session-key-CLTZeH_F.js}

@@ -1,6 +1,34 @@
-import { r as jidToE164 } from "./targets-runtime-C-GiVn6Y.js";
-import "./text-runtime-DdX6-mC_.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CKOFMPf-.js";
+import { c as normalizeWhatsAppTarget } from "./normalize-target-DSZnHkKF.js";
+import "./normalize-C-Z16y7Q.js";
+import { r as jidToE164 } from "./targets-runtime-Bsh0HR9y.js";
+import "./text-runtime-BTGkMN0o.js";
+import { createChannelApprovalAuth } from "openclaw/plugin-sdk/approval-auth-runtime";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId, resolveThreadSessionKeys } from "openclaw/plugin-sdk/routing";
+//#region extensions/whatsapp/src/approval-auth.ts
+function normalizeWhatsAppApproverId(value) {
+	const normalized = normalizeWhatsAppTarget(String(value));
+	if (!normalized || normalized.endsWith("@g.us")) return;
+	return normalized;
+}
+function normalizeWhatsAppApproverEntry(value) {
+	return String(value).trim() === "*" ? "*" : normalizeWhatsAppApproverId(value);
+}
+const whatsappApproval = createChannelApprovalAuth({
+	channelLabel: "WhatsApp",
+	resolveInputs: ({ cfg, accountId }) => {
+		return { allowFrom: resolveWhatsAppAccount({
+			cfg,
+			accountId
+		}).allowFrom };
+	},
+	normalizeApprover: normalizeWhatsAppApproverEntry,
+	normalizeSenderId: normalizeWhatsAppApproverId,
+	isWildcardAuthorized: ({ purpose, approvers }) => purpose === "action" && approvers.includes("*")
+});
+const getWhatsAppApprovalApprovers = whatsappApproval.resolveApprovers;
+const whatsappApprovalAuth = whatsappApproval.approvalAuth;
+//#endregion
 //#region extensions/whatsapp/src/quoted-message.ts
 const CACHE_TTL_MS = 600 * 1e3;
 const MAX_ENTRIES = 500;
@@ -134,4 +162,4 @@ function resolveWhatsAppGroupSessionRoute(route) {
 	};
 }
 //#endregion
-export { cacheInboundMessageMeta as a, buildQuotedMessageOptions as i, resolveWhatsAppGroupSessionRoute as n, lookupInboundMessageMeta as o, resolveWhatsAppLegacyGroupSessionKey as r, lookupInboundMessageMetaForTarget as s, resolveWhatsAppGroupSessionKey as t };
+export { cacheInboundMessageMeta as a, getWhatsAppApprovalApprovers as c, buildQuotedMessageOptions as i, whatsappApprovalAuth as l, resolveWhatsAppGroupSessionRoute as n, lookupInboundMessageMeta as o, resolveWhatsAppLegacyGroupSessionKey as r, lookupInboundMessageMetaForTarget as s, resolveWhatsAppGroupSessionKey as t };

package/dist/{identity-Dqft3mFA.js → identity-D7L8LCuH.js}

@@ -1,5 +1,5 @@
-import { r as jidToE164 } from "./targets-runtime-C-GiVn6Y.js";
-import { n as normalizeE164 } from "./text-runtime-DdX6-mC_.js";
+import { r as jidToE164 } from "./targets-runtime-Bsh0HR9y.js";
+import { n as normalizeE164 } from "./text-runtime-BTGkMN0o.js";
 //#region extensions/whatsapp/src/identity.ts
 const WHATSAPP_LID_RE = /@(lid|hosted\.lid)$/i;
 function normalizeDeviceScopedJid(jid) {

package/dist/light-runtime-api.js

@@ -1,5 +1,5 @@
-import { n as getStatusCode, t as formatError } from "./session-errors-BAj9D2La.js";
-import { t as createWhatsAppLoginTool } from "./agent-tools-login-BX7eHgDm.js";
-import { c as logoutWeb, g as readWebSelfId, l as pickWebChannel, o as getWebAuthAgeMs, s as logWebSelfId, t as WA_WEB_AUTH_DIR, x as webAuthExists, y as resolveDefaultWebAuthDir } from "./auth-store-Db-wfApd.js";
-import { t as getActiveWebListener } from "./active-listener-B4SDebQ6.js";
+import { t as createWhatsAppLoginTool } from "./agent-tools-login-DfyToBpG.js";
+import { c as logoutWeb, g as readWebSelfId, l as pickWebChannel, o as getWebAuthAgeMs, s as logWebSelfId, t as WA_WEB_AUTH_DIR, x as webAuthExists, y as resolveDefaultWebAuthDir } from "./auth-store-BQi9pZqQ.js";
+import { n as getStatusCode, t as formatError } from "./session-errors-JuazczrA.js";
+import { t as getActiveWebListener } from "./active-listener-5kHap439.js";
 export { WA_WEB_AUTH_DIR, createWhatsAppLoginTool, formatError, getActiveWebListener, getStatusCode, getWebAuthAgeMs, logWebSelfId, logoutWeb, pickWebChannel, readWebSelfId, resolveDefaultWebAuthDir, webAuthExists };

package/dist/{login-C48y0jlx.js → login-DGIoToX8.js}

@@ -1,9 +1,8 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { a as resolveWhatsAppAccount } from "./accounts-4YgwroRU.js";
-import { a as resolveWhatsAppSocketTiming } from "./socket-timing-DhbVFjah.js";
-import { b as restoreCredsFromBackupIfNeeded } from "./auth-store-Db-wfApd.js";
-import { i as renderQrTerminal, t as createWaSocket } from "./session-DriaHt7V.js";
-import { a as closeWaSocketSoon, o as waitForWhatsAppLoginResult } from "./connection-controller-DkbrFSIn.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CKOFMPf-.js";
+import { b as restoreCredsFromBackupIfNeeded } from "./auth-store-BQi9pZqQ.js";
+import { c as resolveWhatsAppSocketTiming, t as createWaSocket, u as renderQrTerminal } from "./session-mxWFn0eS.js";
+import { a as closeWaSocketSoon, o as waitForWhatsAppLoginResult } from "./connection-controller-C1rwfWb4.js";
 import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
 import { logInfo } from "openclaw/plugin-sdk/logging-core";
 import { danger, defaultRuntime, success } from "openclaw/plugin-sdk/runtime-env";
@@ -12,14 +11,47 @@ import { getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
 var login_exports = /* @__PURE__ */ __exportAll({ loginWeb: () => loginWeb });
 const QR_LINK_INSTRUCTION = "Open the WhatsApp app, go to Linked Devices, then scan this QR:";
 const CLEAR_TERMINAL = "\x1B[2J\x1B[H";
-async function loginWeb(verbose, waitForConnection, runtime = defaultRuntime, accountId) {
+async function loginWeb(verbose, waitForConnection, runtime = defaultRuntime, accountId, options) {
 	const cfg = getRuntimeConfig();
 	const account = resolveWhatsAppAccount({
 		cfg,
 		accountId
 	});
 	const socketTiming = resolveWhatsAppSocketTiming(cfg);
-	const restoredFromBackup = await restoreCredsFromBackupIfNeeded(account.authDir);
+	const restoredFromBackup = await restoreCredsFromBackupIfNeeded(account.authDir, { beforeCredentialPersistence: options?.beforeCredentialPersistence });
+	const credentialPersistenceState = { failure: null };
+	let resolveCredentialPersistenceFailure = (_failure) => {};
+	const credentialPersistenceFailurePromise = new Promise((resolve) => {
+		resolveCredentialPersistenceFailure = resolve;
+	});
+	const onCredentialPersistenceError = (error) => {
+		if (credentialPersistenceState.failure) return;
+		credentialPersistenceState.failure = { error };
+		resolveCredentialPersistenceFailure(credentialPersistenceState.failure);
+	};
+	const credentialPersistenceTasks = /* @__PURE__ */ new Set();
+	const onCredentialPersistenceTask = (task) => {
+		credentialPersistenceTasks.add(task);
+		task.then(() => credentialPersistenceTasks.delete(task), () => credentialPersistenceTasks.delete(task));
+	};
+	const waitForCredentialPersistence = async () => {
+		await new Promise((resolve) => {
+			setImmediate(resolve);
+		});
+		while (credentialPersistenceTasks.size > 0) await Promise.allSettled(credentialPersistenceTasks);
+	};
+	const credentialPersistenceOptions = options?.beforeCredentialPersistence ? {
+		beforeCredentialPersistence: async () => {
+			try {
+				await options.beforeCredentialPersistence?.();
+			} catch (error) {
+				onCredentialPersistenceError(error);
+				throw error;
+			}
+		},
+		onCredentialPersistenceError,
+		onCredentialPersistenceTask
+	} : {};
 	let qrVersion = 0;
 	const onQr = (qr) => {
 		const currentQrVersion = ++qrVersion;
@@ -36,7 +68,8 @@ async function loginWeb(verbose, waitForConnection, runtime = defaultRuntime, ac
 	let sock = await createWaSocket(false, verbose, {
 		authDir: account.authDir,
 		...socketTiming,
-		onQr
+		onQr,
+		...credentialPersistenceOptions
 	});
 	logInfo("Waiting for WhatsApp connection...", runtime);
 	try {
@@ -49,10 +82,17 @@ async function loginWeb(verbose, waitForConnection, runtime = defaultRuntime, ac
 			waitForConnection,
 			socketTiming,
 			onQr,
+			...credentialPersistenceOptions,
+			...options?.beforeCredentialPersistence ? {
+				credentialPersistenceFailure: credentialPersistenceFailurePromise,
+				getCredentialPersistenceFailure: () => credentialPersistenceState.failure,
+				waitForCredentialPersistence
+			} : {},
 			onSocketReplaced: (replacementSock) => {
 				sock = replacementSock;
 			}
 		});
+		if (credentialPersistenceState.failure) throw credentialPersistenceState.failure.error;
 		if (result.outcome === "connected") {
 			runtime.log(success(result.restarted ? "✅ Linked after restart; web session ready." : restoredFromBackup ? "✅ Recovered from creds.json.bak; web session ready." : "✅ Linked! Credentials saved for future sends."));
 			return;

package/dist/{login-qr-BjId7dll.js → login-qr-X-CZHOk9.js}

@@ -1,10 +1,9 @@
-import { a as resolveWhatsAppAccount } from "./accounts-4YgwroRU.js";
-import { t as formatError } from "./session-errors-BAj9D2La.js";
-import { a as resolveWhatsAppSocketTiming } from "./socket-timing-DhbVFjah.js";
-import { c as logoutWeb, f as readWebAuthExistsForDecision, g as readWebSelfId, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-Db-wfApd.js";
-import { t as createWaSocket } from "./session-DriaHt7V.js";
-import { t as getActiveWebListener } from "./active-listener-B4SDebQ6.js";
-import { i as closeWaSocket, o as waitForWhatsAppLoginResult, t as WHATSAPP_LOGGED_OUT_QR_MESSAGE } from "./connection-controller-DkbrFSIn.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CKOFMPf-.js";
+import { c as logoutWeb, f as readWebAuthExistsForDecision, g as readWebSelfId, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-BQi9pZqQ.js";
+import { c as resolveWhatsAppSocketTiming, t as createWaSocket } from "./session-mxWFn0eS.js";
+import { t as formatError } from "./session-errors-JuazczrA.js";
+import { t as getActiveWebListener } from "./active-listener-5kHap439.js";
+import { i as closeWaSocket, o as waitForWhatsAppLoginResult, t as WHATSAPP_LOGGED_OUT_QR_MESSAGE } from "./connection-controller-C1rwfWb4.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,6 +1,6 @@
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 //#region extensions/whatsapp/login-qr-runtime.ts
-const loadLoginQrModule = createLazyRuntimeModule(() => import("./login-qr-BjId7dll.js"));
+const loadLoginQrModule = createLazyRuntimeModule(() => import("./login-qr-X-CZHOk9.js"));
 async function startWebLoginWithQr(...args) {
 	const { startWebLoginWithQr: startWebLoginWithQrLocal } = await loadLoginQrModule();
 	return await startWebLoginWithQrLocal(...args);