@openclaw/whatsapp 2026.7.2-beta.7 → 2026.7.33

package/dist/{channel-Dg62olhy.js → .setup/channel-9WGjBznd.mjs}

@@ -1,50 +1,69 @@
-import { a as resolveWhatsAppAccount } from "./accounts-CSqLvCY5.js";
-import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-CB5SOWjc.js";
-import { c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, n as isWhatsAppNewsletterJid, o as normalizeWhatsAppAllowFromEntry, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./normalize-target-CugRyONv.js";
-import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-1GqbT1uX.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-D37ddk22.js";
-import { i as getWhatsAppRuntime } from "./runtime-BLlToOi6.js";
-import "./normalize-C7Hkc_vE.js";
-import { c as toWhatsappJid } from "./targets-runtime-TMk0lGuy.js";
-import "./text-runtime-CaKLhowd.js";
-import { t as createWhatsAppLoginTool } from "./agent-tools-login-DE9MU98T.js";
-import { c as getWhatsAppApprovalApprovers, l as whatsappApprovalAuth, s as lookupInboundMessageMetaForTarget, t as resolveWhatsAppGroupSessionKey } from "./group-session-key-DVMZlO3x.js";
-import { a as resolveWhatsAppGroupRequireMention, c as loadWhatsAppChannelRuntime, i as whatsappSetupContract, l as readWhatsAppAccountLinkState, n as whatsappSetupWizardProxy, o as resolveWhatsAppGroupToolPolicy, r as whatsappSetupAdapter, s as formatWhatsAppConfigAllowFromEntries, t as createWhatsAppPluginBase } from "./shared-CAxd15bp.js";
-import { t as whatsappCommandPolicy } from "./command-policy-BIOSHySD.js";
-import { f as readWebAuthExistsForDecision, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-DcEpIOmE.js";
-import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-CAMTrs2U.js";
+import { r as resolveDefaultWhatsAppAccountId, t as listAccountIds } from "./account-ids-CB5SOWjc.mjs";
+import { a as resolveWhatsAppAccount } from "./accounts-Dw16pdNl.mjs";
+import { c as normalizeWhatsAppTarget, i as looksLikeWhatsAppTargetId, n as isWhatsAppNewsletterJid, o as normalizeWhatsAppAllowFromEntry, s as normalizeWhatsAppMessagingTarget, t as isWhatsAppGroupJid } from "./normalize-target-bVWjgftN.mjs";
+import { t as resolveWhatsAppOutboundTarget } from "./resolve-outbound-target-oI7VpU4w.mjs";
+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-BQjMC41n.mjs";
+import "./normalize-eddWWsNV.mjs";
+import { n as getWhatsAppRuntime } from "./runtime-BfAdAEYT.mjs";
+import { s as toWhatsappJid } from "./targets-runtime-C-GiVn6Y.mjs";
+import "./text-runtime-CUrq1mFq.mjs";
+import { s as lookupInboundMessageMetaForTarget, t as resolveWhatsAppGroupSessionKey } from "./group-session-key-CEwPRRRK.mjs";
+import { t as whatsappCommandPolicy } from "./command-policy-BIOSHySD.mjs";
+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--FfzntMG.mjs";
+import { f as readWebAuthExistsForDecision, n as WHATSAPP_AUTH_UNSTABLE_CODE } from "./auth-store-BZKGa0tW.mjs";
+import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-D_BmQUR9.mjs";
 import { createActionGate as createActionGate$1 } from "openclaw/plugin-sdk/channel-actions";
-import { normalizeOptionalAccountId } from "openclaw/plugin-sdk/account-core";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { asString, collectIssuesForEnabledAccounts, createComputedAccountStatusAdapter, createDefaultChannelRuntimeState, isRecord as isRecord$1, readAccountStatusSnapshot } from "openclaw/plugin-sdk/status-helpers";
+import { DEFAULT_ACCOUNT_ID, listCombinedAccountIds, normalizeOptionalAccountId, resolveListedDefaultAccountId } 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 { formatCliCommand } from "openclaw/plugin-sdk/cli-runtime";
 import { buildChannelOutboundSessionRoute } from "openclaw/plugin-sdk/core";
-import { chunkText } from "openclaw/plugin-sdk/reply-chunking";
-import { createMessageReceiptFromOutboundResults, defineChannelMessageAdapter, resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
-import { sendTextMediaPayload } from "openclaw/plugin-sdk/reply-payload";
+import { buildApprovalReactionPromptPayloadForRequest } from "openclaw/plugin-sdk/approval-reaction-runtime";
+import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 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, createNativeApprovalMessagingTargetResolvers } 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 { questionGatewayRuntime } from "openclaw/plugin-sdk/question-gateway-runtime";
+import { createChannelApproverDmTargetResolver, createChannelNativeOriginTargetResolver, createNativeApprovalChannelRouteGates, createNativeApprovalForwardingFallbackSuppressor } from "openclaw/plugin-sdk/approval-native-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";
-const { normalizeForwardTarget: normalizeWhatsAppForwardTarget, normalizeTarget: normalizeWhatsAppApprovalTarget, resolveSessionTarget: resolveSessionWhatsAppOriginTarget, resolveTurnSourceTarget: resolveTurnSourceWhatsAppOriginTarget } = createNativeApprovalMessagingTargetResolvers({
-	channel: "whatsapp",
-	normalizeTo: normalizeWhatsAppMessagingTarget
-});
 function isWhatsAppApprovalTransportEnabled(params) {
 	return resolveWhatsAppAccount({
 		cfg: params.cfg,
 		accountId: params.accountId
 	}).enabled;
 }
+function normalizeWhatsAppForwardTarget(target) {
+	if (normalizeLowercaseStringOrEmpty(target.channel) !== "whatsapp") return null;
+	const to = normalizeWhatsAppMessagingTarget(target.to);
+	if (!to) return null;
+	return {
+		to,
+		accountId: normalizeOptionalString(target.accountId),
+		threadId: target.threadId ?? null
+	};
+}
+function resolveTurnSourceWhatsAppOriginTarget(request) {
+	if (normalizeLowercaseStringOrEmpty(request.request.turnSourceChannel) !== "whatsapp") return null;
+	const to = normalizeWhatsAppMessagingTarget(request.request.turnSourceTo ?? "");
+	if (!to) return null;
+	return {
+		to,
+		accountId: normalizeOptionalString(request.request.turnSourceAccountId)
+	};
+}
+function resolveSessionWhatsAppOriginTarget(sessionTarget) {
+	const to = normalizeWhatsAppMessagingTarget(sessionTarget.to);
+	return to ? {
+		to,
+		accountId: normalizeOptionalString(sessionTarget.accountId)
+	} : null;
+}
 const { canApprovalPotentiallyRouteToChannel: canApprovalPotentiallyRouteToWhatsApp, canAnyApprovalPotentiallyRouteToChannel: canAnyApprovalPotentiallyRouteToWhatsApp, isSessionApprovalEligible: isWhatsAppSessionApprovalEligible, isExplicitTargetEligible: isWhatsAppExplicitTargetEligible, shouldHandleApprovalRequest: shouldHandleWhatsAppApprovalRequest } = createNativeApprovalChannelRouteGates({
 	channel: "whatsapp",
 	defaultForwardingMode: DEFAULT_APPROVAL_FORWARDING_MODE,
@@ -59,7 +78,13 @@ const resolveWhatsAppOriginTargetBase = createChannelNativeOriginTargetResolver(
 	shouldHandleRequest: shouldHandleWhatsAppApprovalRequest,
 	resolveTurnSourceTarget: resolveTurnSourceWhatsAppOriginTarget,
 	resolveSessionTarget: resolveSessionWhatsAppOriginTarget,
-	normalizeTarget: normalizeWhatsAppApprovalTarget
+	normalizeTarget: (target) => {
+		const to = normalizeWhatsAppMessagingTarget(target.to);
+		return to ? {
+			...target,
+			to
+		} : null;
+	}
 });
 function resolveWhatsAppOriginTarget(params) {
 	const target = resolveWhatsAppOriginTargetBase(params);
@@ -96,26 +121,10 @@ const shouldSuppressWhatsAppForwardingFallback = createNativeApprovalForwardingF
 	resolveApproverDmTargets: resolveWhatsAppApproverDmTargets
 });
 function buildWhatsAppExecPendingPayload(params) {
-	const payload = buildApprovalReactionPromptPayloadForRequest(params);
-	return {
-		...payload,
-		presentation: buildTypedApprovalPresentation({
-			approvalId: params.request.id,
-			approvalKind: "exec",
-			allowedDecisions: payload.allowedDecisions
-		})
-	};
+	return buildApprovalReactionPromptPayloadForRequest(params);
 }
 function buildWhatsAppPluginPendingPayload(params) {
-	const payload = buildApprovalReactionPromptPayloadForRequest(params);
-	return {
-		...payload,
-		presentation: buildTypedApprovalPresentation({
-			approvalId: params.request.id,
-			approvalKind: "plugin",
-			allowedDecisions: payload.allowedDecisions
-		})
-	};
+	return buildApprovalReactionPromptPayloadForRequest(params);
 }
 const whatsappApprovalCapability = createChannelApprovalCapability({
 	...whatsappApprovalAuth,
@@ -191,13 +200,12 @@ const whatsappApprovalCapability = createChannelApprovalCapability({
 			accountId,
 			nativeSessionOnly: true
 		}),
-		shouldHandle: ({ cfg, accountId, context, approvalKind, request }) => Boolean(context) && shouldHandleWhatsAppApprovalRequest({
+		shouldHandle: ({ cfg, accountId, context, request }) => Boolean(context) && shouldHandleWhatsAppApprovalRequest({
 			cfg,
 			accountId,
-			approvalKind,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-DrA59QSA.js")).whatsappApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-DtJZbu3y.mjs")).whatsappApprovalNativeRuntime
 	})
 });
 //#endregion
@@ -253,7 +261,15 @@ const WHATSAPP_LEGACY_OUTBOUND_SEND_DEP_KEYS = ["sendWhatsApp"];
 function resolveQuoteLookupAccountId(cfg, accountId) {
 	const explicitAccountId = normalizeOptionalAccountId(accountId);
 	if (explicitAccountId) return explicitAccountId;
-	return resolveDefaultWhatsAppAccountId(cfg ?? {});
+	const channelCfg = cfg?.channels?.whatsapp;
+	const configuredIds = listCombinedAccountIds({
+		configuredAccountIds: channelCfg?.accounts && typeof channelCfg.accounts === "object" ? Object.keys(channelCfg.accounts).filter(Boolean) : [],
+		fallbackAccountIdWhenEmpty: DEFAULT_ACCOUNT_ID
+	});
+	return resolveListedDefaultAccountId({
+		accountIds: configuredIds,
+		configuredDefaultAccountId: normalizeOptionalAccountId(channelCfg?.defaultAccount)
+	});
 }
 function createWhatsAppOutboundBase({ chunker, sendMessageWhatsApp, sendPollWhatsApp, shouldLogVerbose, resolveTarget, normalizeText = normalizeWhatsAppPayloadText, skipEmptyText = true }) {
 	const resolveQuotedMessageKey = (params) => {
@@ -266,8 +282,7 @@ function createWhatsAppOutboundBase({ chunker, sendMessageWhatsApp, sendPollWhat
 			remoteJid: cachedMeta?.remoteJid ?? targetJid,
 			fromMe: cachedMeta?.fromMe ?? false,
 			participant: cachedMeta?.participant,
-			messageText: cachedMeta?.body,
-			media: cachedMeta?.media
+			messageText: cachedMeta?.body
 		};
 	};
 	const outbound = {
@@ -364,8 +379,6 @@ function createWhatsAppOutboundBase({ chunker, sendMessageWhatsApp, sendPollWhat
 }
 //#endregion
 //#region extensions/whatsapp/src/channel-outbound.ts
-const loadWhatsAppApprovalReactionsModule = createLazyRuntimeModule(() => import("./approval-reactions-Cu66aYdq.js").then((n) => n.t));
-const loadWhatsAppQuestionReactionsModule = createLazyRuntimeModule(() => import("./question-reactions-CRsnyoMK.js").then((n) => n.n));
 function normalizeWhatsAppChannelPayloadText(text) {
 	return normalizeWhatsAppPayloadTextPreservingIndentation(text);
 }
@@ -373,21 +386,6 @@ function normalizeWhatsAppChannelSendText(text) {
 	const normalized = normalizeWhatsAppChannelPayloadText(text);
 	return normalized.trim() ? normalized : "";
 }
-async function prepareWhatsAppApprovalPayloadForDelivery(params) {
-	const questionPayload = questionGatewayRuntime.prepareReactionPayloadForDelivery({
-		payload: params.payload,
-		presentation: params.presentation
-	});
-	if (questionPayload) return questionPayload;
-	return (await loadWhatsAppApprovalReactionsModule()).prepareWhatsAppApprovalPayloadForDelivery({
-		payload: params.payload,
-		presentation: params.presentation
-	});
-}
-async function registerDeliveredWhatsAppApprovalPayload(params) {
-	(await loadWhatsAppQuestionReactionsModule()).registerWhatsAppQuestionReactionTargetForDeliveredPayload(params);
-	(await loadWhatsAppApprovalReactionsModule()).registerWhatsAppApprovalReactionTargetForDeliveredPayload(params);
-}
 const whatsappChannelOutbound = {
 	...createWhatsAppOutboundBase({
 		chunker: chunkText,
@@ -405,8 +403,6 @@ const whatsappChannelOutbound = {
 		normalizeText: normalizeWhatsAppChannelSendText
 	}),
 	sendTextOnlyErrorPayloads: true,
-	renderPresentation: prepareWhatsAppApprovalPayloadForDelivery,
-	afterDeliverPayload: registerDeliveredWhatsAppApprovalPayload,
 	normalizePayload: ({ payload }) => ({
 		...payload,
 		text: normalizeWhatsAppChannelPayloadText(payload.text)
@@ -445,17 +441,9 @@ const whatsappMessageAdapter = defineChannelMessageAdapter({
 	} }
 });
 //#endregion
-//#region extensions/whatsapp/src/group-intro.ts
-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.channels?.whatsapp?.enabled === false) return {
+	if (params.cfg.web?.enabled === false) return {
 		ok: false,
 		reason: "whatsapp-disabled"
 	};
@@ -513,16 +501,23 @@ 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;
+const RECENT_DISCONNECT_WARNING_WINDOW_MS = 9e5;
+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);
@@ -544,7 +539,7 @@ function isRecentDisconnect(disconnect, now = Date.now()) {
 function collectWhatsAppStatusIssues(accounts) {
 	return collectIssuesForEnabledAccounts({
 		accounts,
-		readAccount: (value) => readAccountStatusSnapshot(value, WHATSAPP_ACCOUNT_STATUS_FIELDS),
+		readAccount: readWhatsAppAccountStatus,
 		collectIssues: ({ account, accountId, issues }) => {
 			const linked = account.linked === true;
 			const statusState = asString(account.statusState);
@@ -565,16 +560,6 @@ function collectWhatsAppStatusIssues(accounts) {
 				});
 				return;
 			}
-			if (healthState === "logged-out") {
-				issues.push({
-					channel: "whatsapp",
-					accountId,
-					kind: "auth",
-					message: `Session logged out${lastError ? `: ${lastError}` : "."}`,
-					fix: `Run: ${formatCliCommand("openclaw channels login")} (scan QR on the gateway host).`
-				});
-				return;
-			}
 			if (!linked) {
 				issues.push({
 					channel: "whatsapp",
@@ -607,6 +592,16 @@ function collectWhatsAppStatusIssues(accounts) {
 				});
 				return;
 			}
+			if (healthState === "logged-out") {
+				issues.push({
+					channel: "whatsapp",
+					accountId,
+					kind: "auth",
+					message: `Linked session logged out${lastError ? `: ${lastError}` : "."}`,
+					fix: `Run: ${formatCliCommand("openclaw channels login")} (scan QR on the gateway host).`
+				});
+				return;
+			}
 			if (linked && running && connected && reconnectAttempts != null && reconnectAttempts > 0 && isRecentDisconnect(lastDisconnect)) {
 				issues.push({
 					channel: "whatsapp",
@@ -629,8 +624,8 @@ function collectWhatsAppStatusIssues(accounts) {
 }
 //#endregion
 //#region extensions/whatsapp/src/channel.ts
-const loadWhatsAppDirectoryConfig = createLazyRuntimeModule(() => import("./directory-config-DalGrfGN.js").then((n) => n.t));
-const loadWhatsAppChannelReactAction = createLazyRuntimeModule(() => import("./channel-react-action-J_YtyMGX.js"));
+const loadWhatsAppDirectoryConfig = createLazyRuntimeModule(() => import("./directory-config-B7Obxrq2.mjs").then((n) => n.t));
+const loadWhatsAppChannelReactAction = createLazyRuntimeModule(() => import("./channel-react-action-mvIbAFhn.mjs"));
 function resolveWhatsAppTargetInfo(raw) {
 	const normalized = normalizeWhatsAppTarget(raw);
 	if (!normalized) return null;
@@ -639,10 +634,6 @@ function resolveWhatsAppTargetInfo(raw) {
 		chatType: isWhatsAppGroupJid(normalized) ? "group" : isWhatsAppNewsletterJid(normalized) ? "channel" : "direct"
 	};
 }
-function resolveWhatsAppMessageActionTarget(params) {
-	const chatJid = params.args.chatJid;
-	return typeof chatJid === "string" ? normalizeWhatsAppMessagingTarget(chatJid) : void 0;
-}
 const whatsappPlugin = createChatChannelPlugin({
 	pairing: {
 		idLabel: "whatsappSenderId",
@@ -660,15 +651,15 @@ const whatsappPlugin = createChatChannelPlugin({
 		...createWhatsAppPluginBase({
 			groups: {
 				resolveRequireMention: resolveWhatsAppGroupRequireMention,
-				resolveToolPolicy: resolveWhatsAppGroupToolPolicy
+				resolveToolPolicy: resolveWhatsAppGroupToolPolicy,
+				resolveGroupIntroHint: resolveWhatsAppGroupIntroHint
 			},
 			setupWizard: whatsappSetupWizardProxy,
 			setup: whatsappSetupAdapter,
-			setupContract: whatsappSetupContract,
-			isConfigured: (account) => Boolean(account.authDir),
-			isLinked: async (account) => await readWhatsAppAccountLinkState(account.authDir)
+			isConfigured: async (account) => {
+				return await (await loadWhatsAppChannelRuntime()).readWebAuthState(account.authDir) === "linked";
+			}
 		}),
-		agentTools: () => [createWhatsAppLoginTool()],
 		allowlist: buildDmGroupAccountAllowlistAdapter({
 			channelId: "whatsapp",
 			resolveAccount: resolveWhatsAppAccount,
@@ -734,15 +725,9 @@ const whatsappPlugin = createChatChannelPlugin({
 				};
 			},
 			listPeers: async (params) => (await loadWhatsAppDirectoryConfig()).listWhatsAppDirectoryPeersFromConfig(params),
-			listGroups: async (params) => (await loadWhatsAppDirectoryConfig()).listWhatsAppDirectoryGroupsFromConfig(params),
-			listGroupsLive: async (params) => (await loadWhatsAppDirectoryConfig()).listWhatsAppDirectoryGroupsLive(params)
+			listGroups: async (params) => (await loadWhatsAppDirectoryConfig()).listWhatsAppDirectoryGroupsFromConfig(params)
 		},
 		actions: {
-			messageActionTargetAliases: { react: {
-				aliases: ["chatJid", "messageId"],
-				deliveryTargetAliases: ["chatJid"],
-				resolveDeliveryTarget: resolveWhatsAppMessageActionTarget
-			} },
 			describeMessageTool: ({ cfg, accountId }) => describeWhatsAppMessageActions({
 				cfg,
 				accountId
@@ -780,7 +765,7 @@ const whatsappPlugin = createChatChannelPlugin({
 				});
 			}
 		},
-		status: createComputedAccountStatusAdapter({
+		status: createAsyncComputedAccountStatusAdapter({
 			defaultRuntime: createDefaultChannelRuntimeState(DEFAULT_ACCOUNT_ID$1, {
 				connected: false,
 				reconnectAttempts: 0,
@@ -806,9 +791,10 @@ const whatsappPlugin = createChatChannelPlugin({
 						lid: null
 					}
 				};
-				const linked = snapshot.healthState === "logged-out" ? false : typeof snapshot.linked === "boolean" ? snapshot.linked : auth.state === "unstable" ? void 0 : auth.state === "linked";
+				const linked = typeof snapshot.linked === "boolean" ? snapshot.linked : auth.state === "unstable" ? void 0 : auth.state === "linked";
 				const summaryAuthState = auth.state === "unstable" ? auth.state : linked === true ? "linked" : linked === false ? "not-linked" : void 0;
 				const statusState = summaryAuthState === void 0 ? void 0 : summaryAuthState;
+				const configured = auth.state === "unstable" ? typeof snapshot.configured === "boolean" ? snapshot.configured : true : typeof linked === "boolean" ? linked : auth.state === "linked";
 				const authAgeMs = typeof linked === "boolean" && linked ? auth.authAgeMs : null;
 				const self = typeof linked === "boolean" && linked ? auth.selfId : {
 					e164: null,
@@ -816,7 +802,7 @@ const whatsappPlugin = createChatChannelPlugin({
 					lid: null
 				};
 				return {
-					configured: Boolean(account.authDir),
+					configured,
 					...statusState ? { statusState } : {},
 					...typeof linked === "boolean" ? { linked } : {},
 					authAgeMs,
@@ -836,18 +822,16 @@ const whatsappPlugin = createChatChannelPlugin({
 					...snapshot.terminalDisconnect ? { terminalDisconnect: snapshot.terminalDisconnect } : {}
 				};
 			},
-			resolveAccountSnapshot: ({ account, runtime }) => {
-				const locallyRevoked = runtime?.healthState === "logged-out";
+			resolveAccountSnapshot: async ({ account, runtime }) => {
+				const authState = await (await loadWhatsAppChannelRuntime()).readWebAuthState(account.authDir);
 				return {
 					accountId: account.accountId,
 					name: account.name,
 					enabled: account.enabled,
-					configured: Boolean(account.authDir),
+					configured: true,
 					extra: {
-						...locallyRevoked ? {
-							statusState: "not-linked",
-							linked: false
-						} : {},
+						statusState: authState,
+						...authState === "linked" ? { linked: true } : authState === "not-linked" ? { linked: false } : {},
 						connected: runtime?.connected ?? false,
 						reconnectAttempts: runtime?.reconnectAttempts,
 						lastConnectedAt: runtime?.lastConnectedAt ?? null,
@@ -864,6 +848,7 @@ const whatsappPlugin = createChatChannelPlugin({
 					}
 				};
 			},
+			resolveAccountState: ({ configured }) => configured ? "linked" : "not linked",
 			logSelfId: ({ account, runtime, includeChannelPrefix }) => {
 				loadWhatsAppChannelRuntime().then((runtimeExports) => runtimeExports.logWebSelfId(account.authDir, runtime, includeChannelPrefix));
 			}

package/dist/{channel-react-action-J_YtyMGX.js → .setup/channel-react-action-mvIbAFhn.mjs}

@@ -1,10 +1,9 @@
-import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-CSqLvCY5.js";
-import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-CugRyONv.js";
-import { r as resolveAuthorizedWhatsAppOutboundTarget, t as handleWhatsAppAction } from "./action-runtime-BzfDFPbH.js";
-import { t as sendMessageWhatsApp } from "./send-D37ddk22.js";
-import "./normalize-C7Hkc_vE.js";
+import { a as resolveWhatsAppAccount, s as resolveWhatsAppMediaMaxBytes } from "./accounts-Dw16pdNl.mjs";
+import { c as normalizeWhatsAppTarget, t as isWhatsAppGroupJid } from "./normalize-target-bVWjgftN.mjs";
+import { r as resolveAuthorizedWhatsAppOutboundTarget, t as handleWhatsAppAction } from "./action-runtime-DLK_9v4r.mjs";
+import { t as sendMessageWhatsApp } from "./send-BQjMC41n.mjs";
+import "./normalize-eddWWsNV.mjs";
 import { jsonResult, readStringOrNumberParam, readStringParam as readStringParam$1, resolveReactionMessageId } from "openclaw/plugin-sdk/channel-actions";
-import { canonicalizeBase64, estimateBase64DecodedBytes } from "openclaw/plugin-sdk/media-runtime";
 import { readBooleanParam } from "openclaw/plugin-sdk/boolean-param";
 //#region extensions/whatsapp/src/channel-react-action.ts
 const WHATSAPP_CHANNEL = "whatsapp";
@@ -24,19 +23,23 @@ function readWhatsAppActionChatJid(params) {
 	return normalizeWhatsAppTarget(params.toolContext.currentChannelId) ?? void 0;
 }
 function extractBase64Payload(encoded) {
-	return /^data:[^;]+;base64,(.*)$/is.exec(encoded.trim())?.[1] ?? encoded;
+	const match = /^data:[^;]+;base64,(.*)$/i.exec(encoded.trim());
+	return match ? match[1] : encoded;
+}
+function estimateBase64DecodedBytes(encoded) {
+	const compact = extractBase64Payload(encoded).replace(/\s/g, "");
+	if (!compact) return 0;
+	const padding = compact.endsWith("==") ? 2 : compact.endsWith("=") ? 1 : 0;
+	return Math.max(0, Math.floor(compact.length * 3 / 4) - padding);
 }
 function decodeUploadFileMediaPayload(params) {
-	const payload = extractBase64Payload(params.encoded);
 	if (params.maxBytes !== void 0) {
-		const estimatedBytes = estimateBase64DecodedBytes(payload);
+		const estimatedBytes = estimateBase64DecodedBytes(params.encoded);
 		if (estimatedBytes > params.maxBytes) throw new Error(`WhatsApp upload-file buffer exceeds configured media limit (${estimatedBytes} bytes > ${params.maxBytes} bytes).`);
 	}
 	const contentType = readStringParam$1(params.args, "contentType") ?? readStringParam$1(params.args, "mimeType");
 	const fileName = readStringParam$1(params.args, "filename") ?? readStringParam$1(params.args, "fileName");
-	const canonicalPayload = canonicalizeBase64(payload);
-	if (!canonicalPayload) throw new Error("WhatsApp upload-file buffer must be valid base64 or a base64 data URL.");
-	const buffer = Buffer.from(canonicalPayload, "base64");
+	const buffer = Buffer.from(extractBase64Payload(params.encoded), "base64");
 	if (params.maxBytes !== void 0 && buffer.byteLength > params.maxBytes) throw new Error(`WhatsApp upload-file buffer exceeds configured media limit (${buffer.byteLength} bytes > ${params.maxBytes} bytes).`);
 	return {
 		buffer,

package/dist/{channel.runtime-BP0xNmLi.js → .setup/channel.runtime-DmmMgRJQ.mjs}

@@ -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-DcEpIOmE.js";
-import { t as getActiveWebListener$1 } from "./active-listener-BEjWsCNM.js";
-import { t as monitorWebChannel$1 } from "./monitor-CfkaUSL2.js";
-import { t as loginWeb$1 } from "./login-CvY2Dhch.js";
-import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-BkVcd769.js";
+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-BZKGa0tW.mjs";
+import { t as getActiveWebListener$1 } from "./active-listener-CloPBx0S.mjs";
+import { t as monitorWebChannel$1 } from "./monitor-Dh6Di_YO.mjs";
+import { t as loginWeb$1 } from "./login-7b3M0iBp.mjs";
+import { whatsappSetupWizard as whatsappSetupWizard$1 } from "./setup-surface-Zvj2cLzz.mjs";
 //#region extensions/whatsapp/src/channel.runtime.ts
 function getActiveWebListener(...args) {
 	return getActiveWebListener$1(...args);

package/dist/.setup/channel.setup-ByBYSeLd.mjs

@@ -0,0 +1,22 @@
+import { a as resolveWhatsAppGroupRequireMention, i as whatsappSetupWizardProxy, n as createWhatsAppPluginBase, o as resolveWhatsAppGroupToolPolicy, s as resolveWhatsAppGroupIntroHint, t as whatsappSetupAdapter } from "./setup-core--FfzntMG.mjs";
+import { t as detectWhatsAppLegacyStateMigrations } from "./state-migrations-D_BmQUR9.mjs";
+//#region extensions/whatsapp/src/channel.setup.ts
+async function isWhatsAppAuthConfigured(account) {
+	const { readWebAuthState } = await import("./auth-store-BZKGa0tW.mjs").then((n) => n.i);
+	return await readWebAuthState(account.authDir) === "linked";
+}
+const whatsappSetupPlugin = {
+	...createWhatsAppPluginBase({
+		groups: {
+			resolveRequireMention: resolveWhatsAppGroupRequireMention,
+			resolveToolPolicy: resolveWhatsAppGroupToolPolicy,
+			resolveGroupIntroHint: resolveWhatsAppGroupIntroHint
+		},
+		setupWizard: whatsappSetupWizardProxy,
+		setup: whatsappSetupAdapter,
+		isConfigured: isWhatsAppAuthConfigured
+	}),
+	lifecycle: { detectLegacyStateMigrations: ({ oauthDir }) => detectWhatsAppLegacyStateMigrations({ oauthDir }) }
+};
+//#endregion
+export { whatsappSetupPlugin as t };

package/dist/.setup/config-schema-mBX2nmn1.mjs

@@ -0,0 +1,47 @@
+import { WhatsAppConfigSchema, buildChannelConfigSchema } 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."
+	},
+	dmPolicy: {
+		label: "WhatsApp DM Policy",
+		help: "Direct message access control (\"pairing\" recommended). \"open\" requires channels.whatsapp.allowFrom=[\"*\"]."
+	},
+	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)."
+	},
+	configWrites: {
+		label: "WhatsApp Config Writes",
+		help: "Allow WhatsApp to write config in response to channel events/commands (default: 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."
+	},
+	mentionPatterns: {
+		label: "WhatsApp Mention Pattern Policy",
+		help: "Scopes configured groupChat mentionPatterns to selected WhatsApp conversation IDs such as 123@g.us."
+	},
+	"mentionPatterns.mode": {
+		label: "WhatsApp Mention Pattern Mode",
+		help: "\"allow\" enables configured regex mention patterns unless denyIn matches; \"deny\" disables them unless allowIn matches."
+	},
+	"mentionPatterns.allowIn": {
+		label: "WhatsApp Mention Pattern Allowlist",
+		help: "WhatsApp conversation IDs where configured regex mention patterns are enabled when mode is deny."
+	},
+	"mentionPatterns.denyIn": {
+		label: "WhatsApp Mention Pattern Denylist",
+		help: "WhatsApp conversation IDs where configured regex mention patterns are disabled."
+	}
+} });
+//#endregion
+export { WhatsAppChannelConfigSchema as t };