@openclaw/whatsapp 2026.7.1 → 2026.7.2-beta.2

package/dist/{auth-store-Db-wfApd.js → auth-store-BQi9pZqQ.js}

@@ -1,22 +1,22 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { a as readWebCredsJsonRawSync, c as statWebCredsFileSync, i as readWebCredsJsonRaw, o as resolveWebCredsBackupPath, s as resolveWebCredsPath, t as assertWebCredsPathRegularFileOrMissing } from "./creds-files-B1kSWtBg.js";
-import { r as resolveUserPath } from "./text-runtime-DdX6-mC_.js";
-import { c as resolveComparableIdentity } from "./identity-Dqft3mFA.js";
+import { r as resolveUserPath } from "./text-runtime-BTGkMN0o.js";
+import { c as resolveComparableIdentity } from "./identity-D7L8LCuH.js";
 import path from "node:path";
 import { resolveOAuthDir as resolveOAuthDir$1 } from "openclaw/plugin-sdk/state-paths";
 import { replaceFileAtomic } from "openclaw/plugin-sdk/security-runtime";
 import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
 import { defaultRuntime, getChildLogger, info, success } from "openclaw/plugin-sdk/runtime-env";
-import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 import fs from "node:fs/promises";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/routing";
 import { enqueueKeyedTask } from "openclaw/plugin-sdk/keyed-async-queue";
+import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 //#region extensions/whatsapp/src/creds-persistence.ts
 const CREDS_FILE_MODE = 384;
 const CREDS_SAVE_FLUSH_TIMEOUT_MS = 15e3;
 const credsSaveQueues = /* @__PURE__ */ new Map();
 async function stringifyCreds(creds) {
-	const { BufferJSON } = await import("./session.runtime-CyooSQvj.js").then((n) => n.a);
+	const { BufferJSON } = await import("./session.runtime-Nsqaehbd.js").then((n) => n.o);
 	return JSON.stringify(creds, BufferJSON.replacer);
 }
 async function writeWebCredsRawAtomically(params) {
@@ -130,8 +130,9 @@ function isValidJson(raw) {
 		return false;
 	}
 }
-async function restoreCredsFromBackupIfNeeded(authDir) {
+async function restoreCredsFromBackupIfNeeded(authDir, options) {
 	const logger = getChildLogger({ module: "web-session" });
+	let restore;
 	try {
 		const credsPath = resolveWebCredsPath(authDir);
 		const backupPath = resolveWebCredsBackupPath(authDir);
@@ -144,12 +145,21 @@ async function restoreCredsFromBackupIfNeeded(authDir) {
 		if (raw && isValidJson(raw)) return false;
 		const backupRaw = readCredsJsonRaw(backupPath);
 		if (!backupRaw || !isValidJson(backupRaw)) return false;
-		await writeWebCredsRawAtomically({
-			filePath: credsPath,
+		restore = {
 			content: backupRaw,
+			credsPath
+		};
+	} catch {
+		return false;
+	}
+	await options?.beforeCredentialPersistence?.();
+	try {
+		await writeWebCredsRawAtomically({
+			filePath: restore.credsPath,
+			content: restore.content,
 			tempPrefix: ".creds.restore"
 		});
-		logger.warn({ credsPath }, "restored corrupted WhatsApp creds.json from backup");
+		logger.warn({ credsPath: restore.credsPath }, "restored corrupted WhatsApp creds.json from backup");
 		return true;
 	} catch {}
 	return false;
@@ -230,13 +240,13 @@ function isBaileysAuthFileName(name) {
 	if (!name.endsWith(".json")) return false;
 	return /^(app-state-sync|session|sender-key|pre-key)-/.test(name);
 }
-async function clearBaileysAuthFiles(authDir) {
+async function clearBaileysAuthFiles(authDir, beforeCredentialPersistence) {
 	const rootStats = await fs.lstat(authDir).catch(() => null);
 	if (!rootStats?.isDirectory() || rootStats.isSymbolicLink()) return;
-	const entries = await fs.readdir(authDir, { withFileTypes: true });
-	await Promise.all(entries.map(async (entry) => {
-		if (!entry.isFile()) return;
-		if (!isBaileysAuthFileName(entry.name)) return;
+	const credentialFiles = (await fs.readdir(authDir, { withFileTypes: true })).filter((entry) => entry.isFile() && isBaileysAuthFileName(entry.name));
+	if (credentialFiles.length === 0) return;
+	await beforeCredentialPersistence?.();
+	await Promise.all(credentialFiles.map(async (entry) => {
 		await fs.rm(path.join(authDir, entry.name), { force: true });
 	}));
 }
@@ -302,14 +312,16 @@ async function logoutWeb(params) {
 			runtime.log(info("Skipped WhatsApp Web credential cleanup outside the managed legacy auth directory."));
 			return false;
 		}
-		await clearBaileysAuthFiles(resolvedAuthDir);
+		await clearBaileysAuthFiles(resolvedAuthDir, params.beforeCredentialPersistence);
 	} else {
 		const ownership = await classifyWebAuthDirOwnership(resolvedAuthDir);
-		if (ownership.kind === "owned") await fs.rm(ownership.authDir, {
-			recursive: true,
-			force: true
-		});
-		else if (ownership.kind === "unsafe-owned") {
+		if (ownership.kind === "owned") {
+			await params.beforeCredentialPersistence?.();
+			await fs.rm(ownership.authDir, {
+				recursive: true,
+				force: true
+			});
+		} else if (ownership.kind === "unsafe-owned") {
 			runtime.log(info("Skipped WhatsApp Web credential cleanup because the auth directory crosses a symlink boundary."));
 			return false;
 		} else {

package/dist/call-tool-api.js

@@ -1,6 +1,6 @@
-import { a as resolveWhatsAppAccount } from "./accounts-4YgwroRU.js";
-import { t as getRegisteredWhatsAppConnectionController } from "./connection-controller-registry-TSX_udJp.js";
-import { o as resolveJidToE164 } from "./targets-runtime-C-GiVn6Y.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CKOFMPf-.js";
+import { n as getWhatsAppConnectionController } from "./connection-controller-runtime-context-CbTsqmPT.js";
+import { o as resolveJidToE164 } from "./targets-runtime-Bsh0HR9y.js";
 import { createActionGate, stringEnum } from "openclaw/plugin-sdk/channel-actions";
 import path from "node:path";
 import { resolveOAuthDir } from "openclaw/plugin-sdk/state-paths";
@@ -11,6 +11,7 @@ import { Type } from "typebox";
 import fs from "node:fs/promises";
 import { mulawToPcm } from "openclaw/plugin-sdk/realtime-voice";
 import { detectBinary } from "openclaw/plugin-sdk/setup-tools";
+import { jsonResult as jsonResult$1 } from "openclaw/plugin-sdk/tool-results";
 //#region extensions/whatsapp/src/agent-tools-call.ts
 const MEOWCALLER_COMMAND = "meowcaller";
 const SESSION_DATABASE = "wa-voip.db";
@@ -33,15 +34,6 @@ const defaultDependencies = {
 	detectMeowCaller: () => detectBinary(MEOWCALLER_COMMAND),
 	resolveStateDir: (accountId) => path.join(resolveOAuthDir(), "whatsapp-calls", normalizeAccountId(accountId))
 };
-function jsonResult$1(payload) {
-	return {
-		content: [{
-			type: "text",
-			text: JSON.stringify(payload, null, 2)
-		}],
-		details: payload
-	};
-}
 async function isRegularFile(filePath) {
 	try {
 		return (await fs.stat(filePath)).isFile();
@@ -101,14 +93,14 @@ async function resolveRequesterE164(params) {
 		cfg: params.cfg,
 		accountId: params.accountId
 	});
-	const lidLookup = getRegisteredWhatsAppConnectionController(params.accountId)?.getCurrentSock()?.signalRepository.lidMapping;
+	const lidLookup = getWhatsAppConnectionController(params.accountId)?.getCurrentSock()?.signalRepository.lidMapping;
 	return await resolveJidToE164(senderId, {
 		authDir: account.authDir,
 		lidLookup
 	});
 }
 async function resolveLinkedWhatsAppSelfE164(params) {
-	const controller = getRegisteredWhatsAppConnectionController(params.accountId);
+	const controller = getWhatsAppConnectionController(params.accountId);
 	if (!controller) return null;
 	const identity = controller.getSelfIdentity();
 	if (!identity) return null;

package/dist/{channel-BWp7h1uY.js → channel-DbadDUDD.js}

@@ -1,36 +1,37 @@
 import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-CB5SOWjc.js";
-import { a as resolveWhatsAppAccount } from "./accounts-4YgwroRU.js";
-import { c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, n as isWhatsAppNewsletterJid, o as normalizeWhatsAppAllowFromEntry, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./normalize-target-bVWjgftN.js";
-import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-CcdugbDf.js";
-import { a as normalizeWhatsAppOutboundPayload, g as resolveWhatsAppReactionLevel, h as whatsappApprovalAuth, i as sendTypingWhatsApp, m as getWhatsAppApprovalApprovers, n as sendPollWhatsApp, o as normalizeWhatsAppPayloadText, s as normalizeWhatsAppPayloadTextPreservingIndentation, t as sendMessageWhatsApp } from "./send-C5CpFcBG.js";
-import "./normalize-Bxwqo-bW.js";
+import { a as resolveWhatsAppAccount } from "./accounts-CKOFMPf-.js";
+import { c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, n as isWhatsAppNewsletterJid, o as normalizeWhatsAppAllowFromEntry, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./normalize-target-DSZnHkKF.js";
+import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-BR97fAbB.js";
+import { a as normalizeWhatsAppOutboundPayload, i as sendTypingWhatsApp, n as sendPollWhatsApp, o as normalizeWhatsAppPayloadText, s as normalizeWhatsAppPayloadTextPreservingIndentation, t as sendMessageWhatsApp, u as resolveWhatsAppReactionLevel } from "./send-D9Ydnn4o.js";
 import { n as getWhatsAppRuntime } from "./runtime-BfAdAEYT.js";
-import { s as toWhatsappJid } from "./targets-runtime-C-GiVn6Y.js";
-import "./text-runtime-DdX6-mC_.js";
-import { t as createWhatsAppLoginTool } from "./agent-tools-login-BX7eHgDm.js";
-import { s as lookupInboundMessageMetaForTarget, t as resolveWhatsAppGroupSessionKey } from "./group-session-key-BhC1RQOE.js";
+import "./normalize-C-Z16y7Q.js";
+import { s as toWhatsappJid } from "./targets-runtime-Bsh0HR9y.js";
+import "./text-runtime-BTGkMN0o.js";
+import { t as createWhatsAppLoginTool } from "./agent-tools-login-DfyToBpG.js";
+import { c as getWhatsAppApprovalApprovers, l as whatsappApprovalAuth, s as lookupInboundMessageMetaForTarget, t as resolveWhatsAppGroupSessionKey } from "./group-session-key-CLTZeH_F.js";
 import { t as whatsappCommandPolicy } from "./command-policy-BIOSHySD.js";
-import { a as resolveWhatsAppGroupRequireMention, c as resolveWhatsAppMentionStripRegexes, i as whatsappSetupWizardProxy, l as formatWhatsAppConfigAllowFromEntries, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, r as loadWhatsAppChannelRuntime, s as resolveWhatsAppGroupIntroHint, t as whatsappSetupAdapter } from "./setup-core-DH-DFPLY.js";
-import { f as readWebAuthExistsForDecision, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-Db-wfApd.js";
-import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-D_BmQUR9.js";
+import { a as resolveWhatsAppGroupRequireMention, i as whatsappSetupWizardProxy, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, r as loadWhatsAppChannelRuntime, s as formatWhatsAppConfigAllowFromEntries, t as whatsappSetupAdapter } from "./setup-core-3aSOoK2T.js";
+import { f as readWebAuthExistsForDecision, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-BQi9pZqQ.js";
+import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-CAMTrs2U.js";
 import { createActionGate as createActionGate$1 } from "openclaw/plugin-sdk/channel-actions";
-import { DEFAULT_ACCOUNT_ID, listCombinedAccountIds, normalizeOptionalAccountId, resolveListedDefaultAccountId } from "openclaw/plugin-sdk/account-core";
+import { normalizeOptionalAccountId } from "openclaw/plugin-sdk/account-core";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { createMessageReceiptFromOutboundResults, defineChannelMessageAdapter, resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
-import { asString, collectIssuesForEnabledAccounts, createAsyncComputedAccountStatusAdapter, createDefaultChannelRuntimeState, isRecord as isRecord$1 } from "openclaw/plugin-sdk/status-helpers";
+import { asString, collectIssuesForEnabledAccounts, createAsyncComputedAccountStatusAdapter, createDefaultChannelRuntimeState, isRecord as isRecord$1, readAccountStatusSnapshot } from "openclaw/plugin-sdk/status-helpers";
 import { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
 import { buildChannelOutboundSessionRoute } from "openclaw/plugin-sdk/core";
-import { buildApprovalReactionPromptPayloadForRequest } from "openclaw/plugin-sdk/approval-reaction-runtime";
-import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
+import { createMessageReceiptFromOutboundResults, defineChannelMessageAdapter, resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
+import { sendTextMediaPayload } from "openclaw/plugin-sdk/reply-payload";
 import { DEFAULT_ACCOUNT_ID as DEFAULT_ACCOUNT_ID$1 } from "openclaw/plugin-sdk/account-id";
 import { buildDmGroupAccountAllowlistAdapter } from "openclaw/plugin-sdk/allowlist-config-edit";
 import { createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
+import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { createChannelApprovalCapability } from "openclaw/plugin-sdk/approval-delivery-runtime";
 import { createLazyChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
 import { createChannelApproverDmTargetResolver, createChannelNativeOriginTargetResolver, createNativeApprovalChannelRouteGates, createNativeApprovalForwardingFallbackSuppressor } from "openclaw/plugin-sdk/approval-native-runtime";
+import { buildApprovalReactionPromptPayloadForRequest } from "openclaw/plugin-sdk/approval-reaction-runtime";
+import { buildTypedApprovalPresentation } from "openclaw/plugin-sdk/approval-reply-runtime";
 import { chunkText } from "openclaw/plugin-sdk/reply-chunking";
 import { attachChannelToResult, createAttachedChannelResultAdapter } from "openclaw/plugin-sdk/channel-send-result";
-import { sendTextMediaPayload } from "openclaw/plugin-sdk/reply-payload";
 //#region extensions/whatsapp/src/approval-native.ts
 const DEFAULT_APPROVAL_FORWARDING_MODE = "session";
 function isWhatsAppApprovalTransportEnabled(params) {
@@ -122,10 +123,26 @@ const shouldSuppressWhatsAppForwardingFallback = createNativeApprovalForwardingF
 	resolveApproverDmTargets: resolveWhatsAppApproverDmTargets
 });
 function buildWhatsAppExecPendingPayload(params) {
-	return buildApprovalReactionPromptPayloadForRequest(params);
+	const payload = buildApprovalReactionPromptPayloadForRequest(params);
+	return {
+		...payload,
+		presentation: buildTypedApprovalPresentation({
+			approvalId: params.request.id,
+			approvalKind: "exec",
+			allowedDecisions: payload.allowedDecisions
+		})
+	};
 }
 function buildWhatsAppPluginPendingPayload(params) {
-	return buildApprovalReactionPromptPayloadForRequest(params);
+	const payload = buildApprovalReactionPromptPayloadForRequest(params);
+	return {
+		...payload,
+		presentation: buildTypedApprovalPresentation({
+			approvalId: params.request.id,
+			approvalKind: "plugin",
+			allowedDecisions: payload.allowedDecisions
+		})
+	};
 }
 const whatsappApprovalCapability = createChannelApprovalCapability({
 	...whatsappApprovalAuth,
@@ -201,12 +218,13 @@ const whatsappApprovalCapability = createChannelApprovalCapability({
 			accountId,
 			nativeSessionOnly: true
 		}),
-		shouldHandle: ({ cfg, accountId, context, request }) => Boolean(context) && shouldHandleWhatsAppApprovalRequest({
+		shouldHandle: ({ cfg, accountId, context, approvalKind, request }) => Boolean(context) && shouldHandleWhatsAppApprovalRequest({
 			cfg,
 			accountId,
+			approvalKind,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-DNWS4aYQ.js")).whatsappApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-CBiGQuZ5.js")).whatsappApprovalNativeRuntime
 	})
 });
 //#endregion
@@ -262,14 +280,7 @@ const WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS = ["sendWhatsApp"];
 function resolveQuoteLookupAccountId(cfg, accountId) {
 	const explicitAccountId = normalizeOptionalAccountId(accountId);
 	if (explicitAccountId) return explicitAccountId;
-	const channelCfg = cfg?.channels?.whatsapp;
-	return resolveListedDefaultAccountId({
-		accountIds: listCombinedAccountIds({
-			configuredAccountIds: channelCfg?.accounts && typeof channelCfg.accounts === "object" ? Object.keys(channelCfg.accounts).filter(Boolean) : [],
-			fallbackAccountIdWhenEmpty: DEFAULT_ACCOUNT_ID
-		}),
-		configuredDefaultAccountId: normalizeOptionalAccountId(channelCfg?.defaultAccount)
-	});
+	return resolveDefaultWhatsAppAccountId(cfg ?? {});
 }
 function createWhatsAppOutboundBase({ chunker, sendMessageWhatsApp, sendPollWhatsApp, shouldLogVerbose, resolveTarget, normalizeText = normalizeWhatsAppPayloadText, skipEmptyText = true }) {
 	const resolveQuotedMessageKey = (params) => {
@@ -379,6 +390,7 @@ function createWhatsAppOutboundBase({ chunker, sendMessageWhatsApp, sendPollWhat
 }
 //#endregion
 //#region extensions/whatsapp/src/channel-outbound.ts
+const loadWhatsAppApprovalReactionsModule = createLazyRuntimeModule(() => import("./approval-reactions-BGQoz25s.js").then((n) => n.t));
 function normalizeWhatsAppChannelPayloadText(text) {
 	return normalizeWhatsAppPayloadTextPreservingIndentation(text);
 }
@@ -386,6 +398,15 @@ function normalizeWhatsAppChannelSendText(text) {
 	const normalized = normalizeWhatsAppChannelPayloadText(text);
 	return normalized.trim() ? normalized : "";
 }
+async function prepareWhatsAppApprovalPayloadForDelivery(params) {
+	return (await loadWhatsAppApprovalReactionsModule()).prepareWhatsAppApprovalPayloadForDelivery({
+		payload: params.payload,
+		presentation: params.presentation
+	});
+}
+async function registerDeliveredWhatsAppApprovalPayload(params) {
+	(await loadWhatsAppApprovalReactionsModule()).registerWhatsAppApprovalReactionTargetForDeliveredPayload(params);
+}
 const whatsappChannelOutbound = {
 	...createWhatsAppOutboundBase({
 		chunker: chunkText,
@@ -403,6 +424,8 @@ const whatsappChannelOutbound = {
 		normalizeText: normalizeWhatsAppChannelSendText
 	}),
 	sendTextOnlyErrorPayloads: true,
+	renderPresentation: prepareWhatsAppApprovalPayloadForDelivery,
+	afterDeliverPayload: registerDeliveredWhatsAppApprovalPayload,
 	normalizePayload: ({ payload }) => ({
 		...payload,
 		text: normalizeWhatsAppChannelPayloadText(payload.text)
@@ -441,6 +464,23 @@ const whatsappMessageAdapter = defineChannelMessageAdapter({
 	} }
 });
 //#endregion
+//#region extensions/whatsapp/src/group-intro.ts
+const WHATSAPP_GROUP_INTRO_HINT = "WhatsApp IDs: SenderId is the participant JID (group participant id).";
+/**
+* @deprecated Core never consumed the group intro hint adapter; this export
+* remains only for the plugin API surface and is removed after the next
+* release train together with ChannelGroupAdapter.resolveGroupIntroHint.
+*/
+function resolveWhatsAppGroupIntroHint() {
+	return WHATSAPP_GROUP_INTRO_HINT;
+}
+function resolveWhatsAppMentionStripRegexes(ctx) {
+	const selfE164 = (ctx.To ?? "").replace(/^whatsapp:/i, "");
+	if (!selfE164) return [];
+	const escaped = selfE164.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	return [new RegExp(escaped, "g"), new RegExp(`@${escaped}`, "g")];
+}
+//#endregion
 //#region extensions/whatsapp/src/heartbeat.ts
 async function checkWhatsAppHeartbeatReady(params) {
 	if (params.cfg.web?.enabled === false) return {
@@ -501,23 +541,16 @@ function resolveWhatsAppOutboundSessionRoute(params) {
 }
 //#endregion
 //#region extensions/whatsapp/src/status-issues.ts
+const WHATSAPP_ACCOUNT_STATUS_FIELDS = [
+	"statusState",
+	"linked",
+	"reconnectAttempts",
+	"lastDisconnect",
+	"lastInboundAt",
+	"lastError",
+	"healthState"
+];
 const RECENT_DISCONNECT_WARNING_WINDOW_MS = 900 * 1e3;
-function readWhatsAppAccountStatus(value) {
-	if (!isRecord$1(value)) return null;
-	return {
-		accountId: value.accountId,
-		statusState: value.statusState,
-		enabled: value.enabled,
-		linked: value.linked,
-		connected: value.connected,
-		running: value.running,
-		reconnectAttempts: value.reconnectAttempts,
-		lastDisconnect: value.lastDisconnect,
-		lastInboundAt: value.lastInboundAt,
-		lastError: value.lastError,
-		healthState: value.healthState
-	};
-}
 function readLastDisconnect(value) {
 	if (typeof value === "string") {
 		const error = asString(value);
@@ -539,7 +572,7 @@ function isRecentDisconnect(disconnect, now = Date.now()) {
 function collectWhatsAppStatusIssues(accounts) {
 	return collectIssuesForEnabledAccounts({
 		accounts,
-		readAccount: readWhatsAppAccountStatus,
+		readAccount: (value) => readAccountStatusSnapshot(value, WHATSAPP_ACCOUNT_STATUS_FIELDS),
 		collectIssues: ({ account, accountId, issues }) => {
 			const linked = account.linked === true;
 			const statusState = asString(account.statusState);
@@ -624,8 +657,8 @@ function collectWhatsAppStatusIssues(accounts) {
 }
 //#endregion
 //#region extensions/whatsapp/src/channel.ts
-const loadWhatsAppDirectoryConfig = createLazyRuntimeModule(() => import("./directory-config-Dijefxc3.js").then((n) => n.t));
-const loadWhatsAppChannelReactAction = createLazyRuntimeModule(() => import("./channel-react-action-CKJHL_Wf.js"));
+const loadWhatsAppDirectoryConfig = createLazyRuntimeModule(() => import("./directory-config-CLBQrjtC.js").then((n) => n.t));
+const loadWhatsAppChannelReactAction = createLazyRuntimeModule(() => import("./channel-react-action-PoRWfP9x.js"));
 function resolveWhatsAppTargetInfo(raw) {
 	const normalized = normalizeWhatsAppTarget(raw);
 	if (!normalized) return null;
@@ -651,8 +684,7 @@ const whatsappPlugin = createChatChannelPlugin({
 		...createWhatsAppPluginBase({
 			groups: {
 				resolveRequireMention: resolveWhatsAppGroupRequireMention,
-				resolveToolPolicy: resolveWhatsAppGroupToolPolicy,
-				resolveGroupIntroHint: resolveWhatsAppGroupIntroHint
+				resolveToolPolicy: resolveWhatsAppGroupToolPolicy
 			},
 			setupWizard: whatsappSetupWizardProxy,
 			setup: whatsappSetupAdapter,
@@ -895,4 +927,4 @@ const whatsappPlugin = createChatChannelPlugin({
 	}
 });
 //#endregion
-export { WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS as n, whatsappPlugin as t };
+export { resolveWhatsAppGroupIntroHint as n, WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS as r, whatsappPlugin as t };

package/dist/channel-config-api.js

@@ -1,2 +1,2 @@
-import { t as WhatsAppChannelConfigSchema } from "./config-schema-mBX2nmn1.js";
+import { t as WhatsAppChannelConfigSchema } from "./config-schema-BZ8h1hWA.js";
 export { WhatsAppChannelConfigSchema };

package/dist/channel-plugin-api.js

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

package/dist/{channel-react-action-CKJHL_Wf.js → channel-react-action-PoRWfP9x.js}

@@ -1,8 +1,8 @@
-import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-4YgwroRU.js";
-import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-bVWjgftN.js";
-import { r as resolveAuthorizedWhatsAppOutboundTarget, t as handleWhatsAppAction } from "./action-runtime-DPahAqxV.js";
-import { t as sendMessageWhatsApp } from "./send-C5CpFcBG.js";
-import "./normalize-Bxwqo-bW.js";
+import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-CKOFMPf-.js";
+import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-DSZnHkKF.js";
+import { r as resolveAuthorizedWhatsAppOutboundTarget, t as handleWhatsAppAction } from "./action-runtime-Bf-12TIH.js";
+import { t as sendMessageWhatsApp } from "./send-D9Ydnn4o.js";
+import "./normalize-C-Z16y7Q.js";
 import { jsonResult, readStringOrNumberParam, readStringParam as readStringParam$1, resolveReactionMessageId } from "openclaw/plugin-sdk/channel-actions";
 import { readBooleanParam } from "openclaw/plugin-sdk/boolean-param";
 //#region extensions/whatsapp/src/channel-react-action.ts
@@ -23,8 +23,8 @@ function readWhatsAppActionChatJid(params) {
 	return normalizeWhatsAppTarget(params.toolContext.currentChannelId) ?? void 0;
 }
 function extractBase64Payload(encoded) {
-	const match = /^data:[^;]+;base64,(.*)$/i.exec(encoded.trim());
-	return match ? match[1] : encoded;
+	const payload = /^data:[^;]+;base64,(.*)$/i.exec(encoded.trim())?.[1];
+	return payload !== void 0 ? payload : encoded;
 }
 function estimateBase64DecodedBytes(encoded) {
 	const compact = extractBase64Payload(encoded).replace(/\s/g, "");

package/dist/{channel.runtime-CAssfx9p.js → channel.runtime-BDDy4Lhz.js}

@@ -1,9 +1,9 @@
 import { startWebLoginWithQr as startWebLoginWithQr$1, waitForWebLogin as waitForWebLogin$1 } from "./login-qr-runtime.js";
-import { c as logoutWeb$1, d as readWebAuthExistsBestEffort$1, f as readWebAuthExistsForDecision$1, g as readWebSelfId$1, h as readWebAuthState$1, m as readWebAuthSnapshotBestEffort$1, o as getWebAuthAgeMs$1, p as readWebAuthSnapshot$1, s as logWebSelfId$1, x as webAuthExists$1 } from "./auth-store-Db-wfApd.js";
-import { t as getActiveWebListener$1 } from "./active-listener-B4SDebQ6.js";
-import { t as monitorWebChannel$1 } from "./monitor-DD8bXohk.js";
-import { t as loginWeb$1 } from "./login-C48y0jlx.js";
-import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-DlWb0Z09.js";
+import { c as logoutWeb$1, d as readWebAuthExistsBestEffort$1, f as readWebAuthExistsForDecision$1, g as readWebSelfId$1, h as readWebAuthState$1, m as readWebAuthSnapshotBestEffort$1, o as getWebAuthAgeMs$1, p as readWebAuthSnapshot$1, s as logWebSelfId$1, x as webAuthExists$1 } from "./auth-store-BQi9pZqQ.js";
+import { t as getActiveWebListener$1 } from "./active-listener-5kHap439.js";
+import { t as monitorWebChannel$1 } from "./monitor-BZ8QvCeV.js";
+import { t as loginWeb$1 } from "./login-DGIoToX8.js";
+import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-CiKGdNJv.js";
 //#region extensions/whatsapp/src/channel.runtime.ts
 function getActiveWebListener(...args) {
 	return getActiveWebListener$1(...args);

package/dist/{channel.setup-CURc5rEt.js → channel.setup-BZ-po8fg.js}

@@ -1,16 +1,15 @@
-import { a as resolveWhatsAppGroupRequireMention, i as whatsappSetupWizardProxy, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint, t as whatsappSetupAdapter } from "./setup-core-DH-DFPLY.js";
-import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-D_BmQUR9.js";
+import { a as resolveWhatsAppGroupRequireMention, i as whatsappSetupWizardProxy, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, t as whatsappSetupAdapter } from "./setup-core-3aSOoK2T.js";
+import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-CAMTrs2U.js";
 //#region extensions/whatsapp/src/channel.setup.ts
 async function isWhatsAppAuthConfigured(account) {
-	const { readWebAuthState } = await import("./auth-store-Db-wfApd.js").then((n) => n.i);
+	const { readWebAuthState } = await import("./auth-store-BQi9pZqQ.js").then((n) => n.i);
 	return await readWebAuthState(account.authDir) === "linked";
 }
 const whatsappSetupPlugin = {
 	...createWhatsAppPluginBase({
 		groups: {
 			resolveRequireMention: resolveWhatsAppGroupRequireMention,
-			resolveToolPolicy: resolveWhatsAppGroupToolPolicy,
-			resolveGroupIntroHint: resolveWhatsAppGroupIntroHint
+			resolveToolPolicy: resolveWhatsAppGroupToolPolicy
 		},
 		setupWizard: whatsappSetupWizardProxy,
 		setup: whatsappSetupAdapter,

package/dist/config-schema-BZ8h1hWA.js

@@ -0,0 +1,40 @@
+import { createChannelConfigUiHints } from "openclaw/plugin-sdk/channel-core";
+import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema";
+import { WhatsAppConfigSchema } from "openclaw/plugin-sdk/bundled-channel-config-schema";
+//#endregion
+//#region extensions/whatsapp/src/config-schema.ts
+const WhatsAppChannelConfigSchema = buildChannelConfigSchema(WhatsAppConfigSchema, { uiHints: {
+	"": {
+		label: "WhatsApp",
+		help: "WhatsApp channel provider configuration for access policy and message batching behavior. Use this section to tune responsiveness and direct-message routing safety for WhatsApp chats."
+	},
+	...createChannelConfigUiHints({
+		channelLabel: "WhatsApp",
+		dmPolicy: { channelKey: "whatsapp" }
+	}),
+	selfChatMode: {
+		label: "WhatsApp Self-Phone Mode",
+		help: "Same-phone setup (bot uses your personal WhatsApp number)."
+	},
+	debounceMs: {
+		label: "WhatsApp Message Debounce (ms)",
+		help: "Debounce window (ms) for batching rapid consecutive messages from the same sender (0 to disable)."
+	},
+	...createChannelConfigUiHints({
+		channelLabel: "WhatsApp",
+		configWrites: true
+	}),
+	"actions.calls": {
+		label: "WhatsApp Voice Calls",
+		help: "Expose the experimental requester-bound WhatsApp voice-call tool. Default: false. Requires a separately paired MeowCaller CLI."
+	},
+	...createChannelConfigUiHints({
+		channelLabel: "WhatsApp",
+		mentionPatterns: {
+			targetDescription: "WhatsApp conversation IDs",
+			policyTargetDescription: "WhatsApp conversation IDs such as 123@g.us"
+		}
+	})
+} });
+//#endregion
+export { WhatsAppChannelConfigSchema as t };

package/dist/{connection-controller-DkbrFSIn.js → connection-controller-C1rwfWb4.js}

@@ -1,12 +1,15 @@
-import { n as registerWhatsAppConnectionController, r as unregisterWhatsAppConnectionController } from "./connection-controller-registry-TSX_udJp.js";
-import { n as getStatusCode, t as formatError } from "./session-errors-BAj9D2La.js";
-import { t as DEFAULT_WHATSAPP_SOCKET_TIMING } from "./socket-timing-DhbVFjah.js";
-import { c as logoutWeb, f as readWebAuthExistsForDecision, r as WhatsAppAuthUnstableError } from "./auth-store-Db-wfApd.js";
-import { c as resolveComparableIdentity } from "./identity-Dqft3mFA.js";
-import { r as waitForWaConnection, t as createWaSocket } from "./session-DriaHt7V.js";
+import { n as getWhatsAppRuntime } from "./runtime-BfAdAEYT.js";
+import { t as WHATSAPP_CONNECTION_CONTROLLER_CAPABILITY } from "./connection-controller-runtime-context-CbTsqmPT.js";
+import { c as logoutWeb, f as readWebAuthExistsForDecision, r as WhatsAppAuthUnstableError } from "./auth-store-BQi9pZqQ.js";
+import { c as resolveComparableIdentity } from "./identity-D7L8LCuH.js";
+import { i as DEFAULT_WHATSAPP_SOCKET_TIMING, r as waitForWaConnection, t as createWaSocket } from "./session-mxWFn0eS.js";
+import { n as getStatusCode, t as formatError } from "./session-errors-JuazczrA.js";
 import { computeBackoff, info, sleepWithAbort } from "openclaw/plugin-sdk/runtime-env";
+import { registerChannelRuntimeContext } from "openclaw/plugin-sdk/channel-runtime-context";
 import { clamp } from "openclaw/plugin-sdk/text-utility-runtime";
 import { randomUUID } from "node:crypto";
+//#region extensions/whatsapp/src/reconnect.ts
+const DEFAULT_HEARTBEAT_SECONDS = 60;
 const DEFAULT_RECONNECT_POLICY = {
 	initialMs: 2e3,
 	maxMs: 3e4,
@@ -17,7 +20,7 @@ const DEFAULT_RECONNECT_POLICY = {
 function resolveHeartbeatSeconds(cfg, overrideSeconds) {
 	const candidate = overrideSeconds ?? cfg.web?.heartbeatSeconds;
 	if (typeof candidate === "number" && candidate > 0) return candidate;
-	return 60;
+	return DEFAULT_HEARTBEAT_SECONDS;
 }
 function resolveReconnectPolicy(cfg, overrides) {
 	const reconnectOverrides = cfg.web?.reconnect ?? {};
@@ -103,6 +106,21 @@ function closeWaSocketSoon(sock, delayMs = 500) {
 		closeWaSocket(sock);
 	}, delayMs);
 }
+async function waitForLoginSocket(params) {
+	if (!params.credentialPersistenceFailure) {
+		await params.wait();
+		return;
+	}
+	const outcome = await Promise.race([params.wait().then(() => ({ kind: "connected" })), params.credentialPersistenceFailure.then((failure) => ({
+		kind: "credential-persistence-failed",
+		failure
+	}))]);
+	if (outcome.kind === "credential-persistence-failed") throw outcome.failure.error;
+}
+function throwIfCredentialPersistenceFailed(getFailure) {
+	const failure = getFailure?.();
+	if (failure) throw failure.error;
+}
 async function waitForWhatsAppLoginResult(params) {
 	const wait = params.waitForConnection ?? waitForWaConnection;
 	const createSocket = params.createSocket ?? createWaSocket;
@@ -116,7 +134,10 @@ async function waitForWhatsAppLoginResult(params) {
 			currentSock = await createSocket(false, params.verbose, {
 				authDir: params.authDir,
 				...params.socketTiming,
-				onQr: params.onQr
+				onQr: params.onQr,
+				beforeCredentialPersistence: params.beforeCredentialPersistence,
+				onCredentialPersistenceError: params.onCredentialPersistenceError,
+				onCredentialPersistenceTask: params.onCredentialPersistenceTask
 			});
 			params.onSocketReplaced?.(currentSock);
 			return null;
@@ -130,8 +151,14 @@ async function waitForWhatsAppLoginResult(params) {
 		}
 	};
 	while (true) try {
-		await wait(currentSock, { timeout: "none" });
+		await waitForLoginSocket({
+			wait: async () => await wait(currentSock, { timeout: "none" }),
+			credentialPersistenceFailure: params.credentialPersistenceFailure
+		});
+		await params.waitForCredentialPersistence?.();
+		throwIfCredentialPersistenceFailed(params.getCredentialPersistenceFailure);
 		const persistedAuth = await readWebAuthExistsForDecision(params.authDir);
+		throwIfCredentialPersistenceFailed(params.getCredentialPersistenceFailure);
 		if (persistedAuth.outcome === "unstable") return {
 			outcome: "failed",
 			message: WHATSAPP_LOGIN_AUTH_UNSTABLE_MESSAGE,
@@ -169,7 +196,8 @@ async function waitForWhatsAppLoginResult(params) {
 			if (!await logoutWeb({
 				authDir: params.authDir,
 				isLegacyAuthDir: params.isLegacyAuthDir,
-				runtime: params.runtime
+				runtime: params.runtime,
+				beforeCredentialPersistence: params.beforeCredentialPersistence
 			})) {
 				const existingAuth = await readWebAuthExistsForDecision(params.authDir);
 				if (existingAuth.outcome === "unstable") return {
@@ -200,6 +228,7 @@ var WhatsAppConnectionController = class {
 	constructor(params) {
 		this.disconnectRetryController = new AbortController();
 		this.current = null;
+		this.runtimeContextLease = null;
 		this.reconnectAttempts = 0;
 		this.lastHandledInboundAt = null;
 		this.accountId = params.accountId;
@@ -304,6 +333,7 @@ var WhatsAppConnectionController = class {
 				...params.cachedGroupMetadata ? { cachedGroupMetadata: params.cachedGroupMetadata } : {}
 			});
 			await waitForWaConnection(sock, { timeoutMs: this.socketTiming.connectTimeoutMs });
+			const channelRuntime = getWhatsAppRuntime().channel;
 			this.socketRef.current = sock;
 			connection = createLiveConnection({
 				connectionId: params.connectionId,
@@ -318,7 +348,16 @@ var WhatsAppConnectionController = class {
 			connection.listener = listener;
 			this.current = connection;
 			connection.unregisterTransportActivity = this.attachTransportActivityListener(sock);
-			registerWhatsAppConnectionController(this.accountId, this);
+			const previousRuntimeContextLease = this.runtimeContextLease;
+			this.runtimeContextLease = registerChannelRuntimeContext({
+				channelRuntime,
+				channelId: "whatsapp",
+				accountId: this.accountId,
+				capability: WHATSAPP_CONNECTION_CONTROLLER_CAPABILITY,
+				context: this,
+				abortSignal: this.abortSignal
+			});
+			previousRuntimeContextLease?.dispose();
 			this.startTimers(connection, {
 				onHeartbeat: params.onHeartbeat,
 				onWatchdogTimeout: params.onWatchdogTimeout
@@ -441,7 +480,8 @@ var WhatsAppConnectionController = class {
 	async shutdown() {
 		this.stopDisconnectRetries();
 		await this.closeCurrentConnection();
-		unregisterWhatsAppConnectionController(this.accountId, this);
+		this.runtimeContextLease?.dispose();
+		this.runtimeContextLease = null;
 	}
 	startTimers(connection, hooks) {
 		if (!this.keepAlive) return;