@openclaw/whatsapp 2026.5.2-beta.2 → 2026.5.3-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (301) hide show
  1. package/dist/access-control-BQ3tCkH8.js +288 -0
  2. package/dist/account-config-CNQ33oav.js +47 -0
  3. package/dist/account-ids-DG18xddX.js +5 -0
  4. package/dist/accounts-BDqgpFEB.js +116 -0
  5. package/dist/action-runtime-DTGNgG-i.js +74 -0
  6. package/dist/action-runtime-api.js +2 -0
  7. package/dist/action-runtime.runtime.js +2 -0
  8. package/dist/active-listener-N7GFKsuN.js +11 -0
  9. package/dist/agent-tools-login-DpRxLNRB.js +89 -0
  10. package/dist/api.js +148 -0
  11. package/dist/audio-preflight.runtime-Bcdsl_ri.js +7 -0
  12. package/dist/auth-presence.js +32 -0
  13. package/dist/auth-store-BjCb50Ry.js +381 -0
  14. package/dist/channel-DQ-5Xoj9.js +542 -0
  15. package/dist/channel-config-api.js +2 -0
  16. package/dist/channel-plugin-api.js +2 -0
  17. package/dist/channel-react-action-Df20qAy9.js +42 -0
  18. package/dist/channel.runtime-DKXRnA8x.js +55 -0
  19. package/dist/channel.setup-DOHR2BGp.js +20 -0
  20. package/dist/command-policy-O8sRnqUV.js +8 -0
  21. package/dist/config-schema-Dmo66Ubb.js +27 -0
  22. package/dist/connection-controller-BiHAsTM8.js +596 -0
  23. package/dist/connection-controller-registry-D_iIGz5m.js +22 -0
  24. package/dist/constants-DLGCIbfl.js +4 -0
  25. package/dist/constants.js +2 -0
  26. package/dist/contract-api.js +19 -0
  27. package/dist/creds-files-_2V8jzQa.js +19 -0
  28. package/dist/directory-config-DVs4ffXu.js +37 -0
  29. package/dist/directory-contract-api.js +2 -0
  30. package/dist/doctor-A9tXm9Om.js +48 -0
  31. package/dist/doctor-contract-api.js +10 -0
  32. package/dist/group-session-contract-B8QBn0I2.js +15 -0
  33. package/dist/identity-QHAlV7Fu.js +75 -0
  34. package/dist/index.js +18 -0
  35. package/dist/legacy-session-surface-api.js +8 -0
  36. package/dist/legacy-state-migrations-api.js +2 -0
  37. package/dist/light-runtime-api.js +5 -0
  38. package/dist/login-DymdrKca.js +52 -0
  39. package/dist/login-qr-DIS0Iv-7.js +378 -0
  40. package/dist/login-qr-api.js +2 -0
  41. package/dist/login-qr-runtime.js +16 -0
  42. package/dist/monitor-C4Fhg_lD.js +3349 -0
  43. package/dist/normalize-CWYiGkXw.js +2 -0
  44. package/dist/normalize-target-BPVHNsM5.js +74 -0
  45. package/dist/outbound-adapter-BssVnZdz.js +29 -0
  46. package/dist/outbound-base-Bq1UYEK5.js +119 -0
  47. package/dist/outbound-media-contract-CGss_QHy.js +163 -0
  48. package/dist/outbound-payload-test-api.js +2 -0
  49. package/dist/quoted-message-TENQzyxV.js +108 -0
  50. package/dist/reaction-level-CRVEVAfi.js +16 -0
  51. package/dist/reply-resolver.runtime-BRCgoO4C.js +2 -0
  52. package/dist/resolve-outbound-target-CN-Wo6IY.js +39 -0
  53. package/dist/rolldown-runtime-RkAeH_Qm.js +27 -0
  54. package/dist/runtime-6fZ67abR.js +8 -0
  55. package/dist/runtime-api.js +15 -0
  56. package/dist/runtime-group-policy-Gp1lQ0at.js +11 -0
  57. package/dist/secret-contract-api.js +5 -0
  58. package/dist/security-contract-DqH8JDX6.js +26 -0
  59. package/dist/security-contract-api.js +2 -0
  60. package/dist/send-CIyLFxdZ.js +234 -0
  61. package/dist/session-contract-B0efQf9P.js +27 -0
  62. package/dist/session-errors-CSuKZPub.js +63 -0
  63. package/dist/session.runtime-C1eSE_KK.js +13 -0
  64. package/dist/setup-core-DZKvpzbH.js +46 -0
  65. package/dist/setup-entry.js +23 -0
  66. package/dist/setup-plugin-api.js +2 -0
  67. package/dist/setup-surface-ieFnIW4g.js +344 -0
  68. package/dist/shared-D_wzSVar.js +307 -0
  69. package/dist/state-migrations-DnCdvoYD.js +39 -0
  70. package/dist/targets.js +2 -0
  71. package/dist/test-api.js +3 -0
  72. package/dist/text-runtime-C1zNiZeO.js +116 -0
  73. package/package.json +14 -6
  74. package/action-runtime-api.ts +0 -1
  75. package/action-runtime.runtime.ts +0 -1
  76. package/api.ts +0 -213
  77. package/auth-presence.ts +0 -80
  78. package/channel-config-api.ts +0 -1
  79. package/channel-plugin-api.ts +0 -3
  80. package/config-api.ts +0 -4
  81. package/constants.ts +0 -1
  82. package/contract-api.ts +0 -29
  83. package/directory-contract-api.ts +0 -4
  84. package/doctor-contract-api.ts +0 -8
  85. package/index.test.ts +0 -13
  86. package/index.ts +0 -16
  87. package/legacy-session-surface-api.ts +0 -6
  88. package/legacy-state-migrations-api.ts +0 -1
  89. package/light-runtime-api.ts +0 -12
  90. package/login-qr-api.ts +0 -1
  91. package/login-qr-runtime.ts +0 -23
  92. package/outbound-payload-test-api.ts +0 -1
  93. package/runtime-api.ts +0 -84
  94. package/secret-contract-api.ts +0 -4
  95. package/security-contract-api.ts +0 -4
  96. package/setup-entry.test.ts +0 -21
  97. package/setup-entry.ts +0 -21
  98. package/setup-plugin-api.ts +0 -3
  99. package/src/account-config.ts +0 -77
  100. package/src/account-ids.ts +0 -13
  101. package/src/account-types.ts +0 -5
  102. package/src/accounts.test.ts +0 -182
  103. package/src/accounts.ts +0 -176
  104. package/src/accounts.whatsapp-auth.test.ts +0 -59
  105. package/src/action-runtime-target-auth.ts +0 -27
  106. package/src/action-runtime.test.ts +0 -330
  107. package/src/action-runtime.ts +0 -76
  108. package/src/active-listener.test.ts +0 -65
  109. package/src/active-listener.ts +0 -17
  110. package/src/agent-tools-login.test.ts +0 -81
  111. package/src/agent-tools-login.ts +0 -113
  112. package/src/approval-auth.test.ts +0 -24
  113. package/src/approval-auth.ts +0 -27
  114. package/src/auth-store.runtime.ts +0 -1
  115. package/src/auth-store.test.ts +0 -311
  116. package/src/auth-store.ts +0 -502
  117. package/src/auto-reply/config.runtime.ts +0 -16
  118. package/src/auto-reply/constants.ts +0 -1
  119. package/src/auto-reply/deliver-reply.test.ts +0 -843
  120. package/src/auto-reply/deliver-reply.ts +0 -279
  121. package/src/auto-reply/loggers.ts +0 -6
  122. package/src/auto-reply/mentions.ts +0 -131
  123. package/src/auto-reply/monitor/ack-reaction.test.ts +0 -170
  124. package/src/auto-reply/monitor/ack-reaction.ts +0 -99
  125. package/src/auto-reply/monitor/audio-preflight.runtime.ts +0 -9
  126. package/src/auto-reply/monitor/broadcast.ts +0 -153
  127. package/src/auto-reply/monitor/commands.ts +0 -19
  128. package/src/auto-reply/monitor/echo.ts +0 -64
  129. package/src/auto-reply/monitor/group-activation.runtime.ts +0 -1
  130. package/src/auto-reply/monitor/group-activation.test.ts +0 -189
  131. package/src/auto-reply/monitor/group-activation.ts +0 -73
  132. package/src/auto-reply/monitor/group-gating.audio-preflight.test.ts +0 -103
  133. package/src/auto-reply/monitor/group-gating.runtime.ts +0 -8
  134. package/src/auto-reply/monitor/group-gating.ts +0 -217
  135. package/src/auto-reply/monitor/group-members.test.ts +0 -56
  136. package/src/auto-reply/monitor/group-members.ts +0 -65
  137. package/src/auto-reply/monitor/inbound-context.test.ts +0 -97
  138. package/src/auto-reply/monitor/inbound-context.ts +0 -92
  139. package/src/auto-reply/monitor/inbound-dispatch.runtime.ts +0 -21
  140. package/src/auto-reply/monitor/inbound-dispatch.test.ts +0 -895
  141. package/src/auto-reply/monitor/inbound-dispatch.ts +0 -422
  142. package/src/auto-reply/monitor/last-route.test.ts +0 -37
  143. package/src/auto-reply/monitor/last-route.ts +0 -61
  144. package/src/auto-reply/monitor/message-line.runtime.ts +0 -38
  145. package/src/auto-reply/monitor/message-line.ts +0 -54
  146. package/src/auto-reply/monitor/on-message.audio-preflight.test.ts +0 -354
  147. package/src/auto-reply/monitor/on-message.ts +0 -291
  148. package/src/auto-reply/monitor/peer.ts +0 -17
  149. package/src/auto-reply/monitor/process-message.audio-preflight.test.ts +0 -420
  150. package/src/auto-reply/monitor/process-message.test.ts +0 -355
  151. package/src/auto-reply/monitor/process-message.ts +0 -531
  152. package/src/auto-reply/monitor/runtime-api.ts +0 -30
  153. package/src/auto-reply/monitor-state.test.ts +0 -64
  154. package/src/auto-reply/monitor-state.ts +0 -106
  155. package/src/auto-reply/monitor.ts +0 -600
  156. package/src/auto-reply/reply-resolver.runtime.ts +0 -1
  157. package/src/auto-reply/types.ts +0 -48
  158. package/src/auto-reply/util.ts +0 -63
  159. package/src/auto-reply/web-auto-reply-monitor.test.ts +0 -687
  160. package/src/auto-reply/web-auto-reply-utils.test.ts +0 -392
  161. package/src/auto-reply.broadcast-groups.combined.test.ts +0 -246
  162. package/src/auto-reply.broadcast-groups.test-harness.ts +0 -47
  163. package/src/auto-reply.impl.ts +0 -6
  164. package/src/auto-reply.test-harness.ts +0 -421
  165. package/src/auto-reply.ts +0 -1
  166. package/src/auto-reply.web-auto-reply.compresses-common-formats-jpeg-cap.test.ts +0 -427
  167. package/src/auto-reply.web-auto-reply.connection-and-logging.e2e.test.ts +0 -908
  168. package/src/auto-reply.web-auto-reply.last-route.test.ts +0 -184
  169. package/src/channel-actions.runtime.ts +0 -7
  170. package/src/channel-actions.test.ts +0 -216
  171. package/src/channel-actions.ts +0 -84
  172. package/src/channel-outbound.test.ts +0 -131
  173. package/src/channel-outbound.ts +0 -36
  174. package/src/channel-react-action.runtime.ts +0 -7
  175. package/src/channel-react-action.test.ts +0 -294
  176. package/src/channel-react-action.ts +0 -84
  177. package/src/channel.runtime.ts +0 -117
  178. package/src/channel.setup.test.ts +0 -461
  179. package/src/channel.setup.ts +0 -28
  180. package/src/channel.ts +0 -334
  181. package/src/command-policy.ts +0 -7
  182. package/src/config-accessors.test.ts +0 -34
  183. package/src/config-accessors.ts +0 -22
  184. package/src/config-schema.test.ts +0 -121
  185. package/src/config-schema.ts +0 -6
  186. package/src/config-ui-hints.ts +0 -24
  187. package/src/connection-controller-registry.test.ts +0 -27
  188. package/src/connection-controller-registry.ts +0 -49
  189. package/src/connection-controller.test.ts +0 -282
  190. package/src/connection-controller.ts +0 -679
  191. package/src/creds-files.ts +0 -19
  192. package/src/creds-persistence.ts +0 -102
  193. package/src/directory-config.test.ts +0 -60
  194. package/src/directory-config.ts +0 -40
  195. package/src/directory-contract.test.ts +0 -56
  196. package/src/doctor-contract.ts +0 -11
  197. package/src/doctor.test.ts +0 -74
  198. package/src/doctor.ts +0 -56
  199. package/src/group-intro.ts +0 -15
  200. package/src/group-policy.test.ts +0 -36
  201. package/src/group-policy.ts +0 -40
  202. package/src/group-session-contract.ts +0 -20
  203. package/src/group-session-key.test.ts +0 -53
  204. package/src/group-session-key.ts +0 -41
  205. package/src/heartbeat.ts +0 -34
  206. package/src/identity.ts +0 -164
  207. package/src/inbound/access-control.test-harness.ts +0 -37
  208. package/src/inbound/access-control.test.ts +0 -375
  209. package/src/inbound/access-control.ts +0 -237
  210. package/src/inbound/dedupe.ts +0 -132
  211. package/src/inbound/extract.test.ts +0 -282
  212. package/src/inbound/extract.ts +0 -488
  213. package/src/inbound/lifecycle.ts +0 -39
  214. package/src/inbound/media.node.test.ts +0 -83
  215. package/src/inbound/media.ts +0 -102
  216. package/src/inbound/monitor.ts +0 -890
  217. package/src/inbound/runtime-api.ts +0 -7
  218. package/src/inbound/save-media.runtime.ts +0 -1
  219. package/src/inbound/send-api.test.ts +0 -307
  220. package/src/inbound/send-api.ts +0 -141
  221. package/src/inbound/send-result.ts +0 -61
  222. package/src/inbound/types.ts +0 -106
  223. package/src/inbound-context.contract.test.ts +0 -32
  224. package/src/inbound-policy.ts +0 -231
  225. package/src/inbound.media.test.ts +0 -320
  226. package/src/inbound.test.ts +0 -290
  227. package/src/inbound.ts +0 -9
  228. package/src/login-qr.test.ts +0 -483
  229. package/src/login-qr.ts +0 -542
  230. package/src/login.coverage.test.ts +0 -133
  231. package/src/login.test.ts +0 -89
  232. package/src/login.ts +0 -70
  233. package/src/logout.test.ts +0 -162
  234. package/src/media.test.ts +0 -480
  235. package/src/media.ts +0 -10
  236. package/src/monitor-inbox.allows-messages-from-senders-allowfrom-list.test-support.ts +0 -400
  237. package/src/monitor-inbox.append-upsert.test-support.ts +0 -133
  238. package/src/monitor-inbox.behavior.test.ts +0 -5
  239. package/src/monitor-inbox.blocks-messages-from-unauthorized-senders-not-allowfrom.test-support.ts +0 -362
  240. package/src/monitor-inbox.captures-media-path-image-messages.test-support.ts +0 -306
  241. package/src/monitor-inbox.streams-inbound-messages.test-support.ts +0 -729
  242. package/src/monitor-inbox.test-harness.ts +0 -304
  243. package/src/normalize-target.ts +0 -112
  244. package/src/normalize.ts +0 -6
  245. package/src/outbound-adapter.poll.test.ts +0 -62
  246. package/src/outbound-adapter.sendpayload.test.ts +0 -195
  247. package/src/outbound-adapter.ts +0 -36
  248. package/src/outbound-base.test.ts +0 -560
  249. package/src/outbound-base.ts +0 -244
  250. package/src/outbound-media-contract.ts +0 -278
  251. package/src/outbound-media.runtime.ts +0 -36
  252. package/src/outbound-payload.contract.test.ts +0 -61
  253. package/src/outbound-send-deps.ts +0 -1
  254. package/src/outbound-test-support.ts +0 -16
  255. package/src/pairing-security.test-harness.ts +0 -59
  256. package/src/qr-image.ts +0 -1
  257. package/src/qr-terminal.ts +0 -1
  258. package/src/quoted-message.test.ts +0 -83
  259. package/src/quoted-message.ts +0 -184
  260. package/src/reaction-level.test.ts +0 -94
  261. package/src/reaction-level.ts +0 -21
  262. package/src/reconnect.test.ts +0 -51
  263. package/src/reconnect.ts +0 -55
  264. package/src/resolve-outbound-target.test.ts +0 -265
  265. package/src/resolve-outbound-target.ts +0 -54
  266. package/src/resolve-target.test.ts +0 -97
  267. package/src/runtime-api.ts +0 -59
  268. package/src/runtime-group-policy.ts +0 -16
  269. package/src/runtime.ts +0 -9
  270. package/src/security-contract.ts +0 -47
  271. package/src/security-fix.ts +0 -71
  272. package/src/send.test.ts +0 -515
  273. package/src/send.ts +0 -287
  274. package/src/session-contract.test.ts +0 -31
  275. package/src/session-contract.ts +0 -43
  276. package/src/session-errors.ts +0 -125
  277. package/src/session-route.ts +0 -26
  278. package/src/session.runtime.ts +0 -8
  279. package/src/session.test.ts +0 -559
  280. package/src/session.ts +0 -330
  281. package/src/setup-core.ts +0 -52
  282. package/src/setup-finalize.ts +0 -446
  283. package/src/setup-surface.test.ts +0 -367
  284. package/src/setup-surface.ts +0 -69
  285. package/src/setup-test-helpers.ts +0 -216
  286. package/src/shared.ts +0 -291
  287. package/src/socket-timing.test.ts +0 -49
  288. package/src/socket-timing.ts +0 -38
  289. package/src/state-migrations.ts +0 -54
  290. package/src/status-issues.test.ts +0 -137
  291. package/src/status-issues.ts +0 -185
  292. package/src/system-prompt.test.ts +0 -199
  293. package/src/system-prompt.ts +0 -31
  294. package/src/targets-runtime.ts +0 -180
  295. package/src/test-helpers.ts +0 -690
  296. package/src/text-runtime.test.ts +0 -162
  297. package/src/text-runtime.ts +0 -11
  298. package/src/vcard.ts +0 -84
  299. package/targets.ts +0 -5
  300. package/test-api.ts +0 -2
  301. package/tsconfig.json +0 -16
package/src/channel.ts DELETED
@@ -1,334 +0,0 @@
1
- import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
2
- import { buildDmGroupAccountAllowlistAdapter } from "openclaw/plugin-sdk/allowlist-config-edit";
3
- import { createChatChannelPlugin, type ChannelPlugin } from "openclaw/plugin-sdk/channel-core";
4
- import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
5
- import {
6
- createAsyncComputedAccountStatusAdapter,
7
- createDefaultChannelRuntimeState,
8
- } from "openclaw/plugin-sdk/status-helpers";
9
- import { resolveWhatsAppAccount, type ResolvedWhatsAppAccount } from "./accounts.js";
10
- import { createWhatsAppLoginTool } from "./agent-tools-login.js";
11
- import { whatsappApprovalAuth } from "./approval-auth.js";
12
- import type { WebChannelStatus } from "./auto-reply/types.js";
13
- import {
14
- describeWhatsAppMessageActions,
15
- resolveWhatsAppAgentReactionGuidance,
16
- } from "./channel-actions.js";
17
- import { whatsappChannelOutbound } from "./channel-outbound.js";
18
- import { whatsappCommandPolicy } from "./command-policy.js";
19
- import { formatWhatsAppConfigAllowFromEntries } from "./config-accessors.js";
20
- import {
21
- resolveWhatsAppGroupIntroHint,
22
- resolveWhatsAppMentionStripRegexes,
23
- } from "./group-intro.js";
24
- import {
25
- resolveWhatsAppGroupRequireMention,
26
- resolveWhatsAppGroupToolPolicy,
27
- } from "./group-policy.js";
28
- import { checkWhatsAppHeartbeatReady } from "./heartbeat.js";
29
- import {
30
- isWhatsAppGroupJid,
31
- looksLikeWhatsAppTargetId,
32
- normalizeWhatsAppMessagingTarget,
33
- normalizeWhatsAppTarget,
34
- } from "./normalize.js";
35
- import { getWhatsAppRuntime } from "./runtime.js";
36
- import { sendTypingWhatsApp } from "./send.js";
37
- import { resolveWhatsAppOutboundSessionRoute } from "./session-route.js";
38
- import { whatsappSetupAdapter } from "./setup-core.js";
39
- import {
40
- createWhatsAppPluginBase,
41
- loadWhatsAppChannelRuntime,
42
- whatsappSetupWizardProxy,
43
- } from "./shared.js";
44
- import { detectWhatsAppLegacyStateMigrations } from "./state-migrations.js";
45
- import { collectWhatsAppStatusIssues } from "./status-issues.js";
46
-
47
- const loadWhatsAppDirectoryConfig = createLazyRuntimeModule(() => import("./directory-config.js"));
48
- const loadWhatsAppChannelReactAction = createLazyRuntimeModule(
49
- () => import("./channel-react-action.js"),
50
- );
51
-
52
- function parseWhatsAppExplicitTarget(raw: string) {
53
- const normalized = normalizeWhatsAppTarget(raw);
54
- if (!normalized) {
55
- return null;
56
- }
57
- return {
58
- to: normalized,
59
- chatType: isWhatsAppGroupJid(normalized) ? ("group" as const) : ("direct" as const),
60
- };
61
- }
62
-
63
- export const whatsappPlugin: ChannelPlugin<ResolvedWhatsAppAccount> =
64
- createChatChannelPlugin<ResolvedWhatsAppAccount>({
65
- pairing: {
66
- idLabel: "whatsappSenderId",
67
- },
68
- outbound: whatsappChannelOutbound,
69
- threading: {
70
- scopedAccountReplyToMode: {
71
- resolveAccount: (cfg, accountId) => resolveWhatsAppAccount({ cfg, accountId }),
72
- resolveReplyToMode: (account) => account.replyToMode,
73
- },
74
- },
75
- base: {
76
- ...createWhatsAppPluginBase({
77
- groups: {
78
- resolveRequireMention: resolveWhatsAppGroupRequireMention,
79
- resolveToolPolicy: resolveWhatsAppGroupToolPolicy,
80
- resolveGroupIntroHint: resolveWhatsAppGroupIntroHint,
81
- },
82
- setupWizard: whatsappSetupWizardProxy,
83
- setup: whatsappSetupAdapter,
84
- isConfigured: async (account) => {
85
- const channelRuntime = await loadWhatsAppChannelRuntime();
86
- return (await channelRuntime.readWebAuthState(account.authDir)) === "linked";
87
- },
88
- }),
89
- agentTools: () => [createWhatsAppLoginTool()],
90
- allowlist: buildDmGroupAccountAllowlistAdapter({
91
- channelId: "whatsapp",
92
- resolveAccount: resolveWhatsAppAccount,
93
- normalize: ({ values }) => formatWhatsAppConfigAllowFromEntries(values),
94
- resolveDmAllowFrom: (account) => account.allowFrom,
95
- resolveGroupAllowFrom: (account) => account.groupAllowFrom,
96
- resolveDmPolicy: (account) => account.dmPolicy,
97
- resolveGroupPolicy: (account) => account.groupPolicy,
98
- }),
99
- mentions: {
100
- stripRegexes: ({ ctx }) => resolveWhatsAppMentionStripRegexes(ctx),
101
- },
102
- commands: whatsappCommandPolicy,
103
- agentPrompt: {
104
- reactionGuidance: ({ cfg, accountId }) => {
105
- const level = resolveWhatsAppAgentReactionGuidance({
106
- cfg,
107
- accountId: accountId ?? undefined,
108
- });
109
- return level ? { level, channelLabel: "WhatsApp" } : undefined;
110
- },
111
- },
112
- messaging: {
113
- targetPrefixes: ["whatsapp"],
114
- normalizeTarget: normalizeWhatsAppMessagingTarget,
115
- resolveOutboundSessionRoute: (params) => resolveWhatsAppOutboundSessionRoute(params),
116
- parseExplicitTarget: ({ raw }) => parseWhatsAppExplicitTarget(raw),
117
- inferTargetChatType: ({ to }) => parseWhatsAppExplicitTarget(to)?.chatType,
118
- targetResolver: {
119
- looksLikeId: looksLikeWhatsAppTargetId,
120
- hint: "<E.164|group JID>",
121
- },
122
- },
123
- directory: {
124
- self: async ({ cfg, accountId }) => {
125
- const account = resolveWhatsAppAccount({ cfg, accountId });
126
- const { e164, jid } = (await loadWhatsAppChannelRuntime()).readWebSelfId(account.authDir);
127
- const id = e164 ?? jid;
128
- if (!id) {
129
- return null;
130
- }
131
- return {
132
- kind: "user",
133
- id,
134
- name: account.name,
135
- raw: { e164, jid },
136
- };
137
- },
138
- listPeers: async (params) =>
139
- (await loadWhatsAppDirectoryConfig()).listWhatsAppDirectoryPeersFromConfig(params),
140
- listGroups: async (params) =>
141
- (await loadWhatsAppDirectoryConfig()).listWhatsAppDirectoryGroupsFromConfig(params),
142
- },
143
- actions: {
144
- describeMessageTool: ({ cfg, accountId }) =>
145
- describeWhatsAppMessageActions({ cfg, accountId }),
146
- supportsAction: ({ action }) => action === "react",
147
- resolveExecutionMode: ({ action }) => (action === "react" ? "gateway" : "local"),
148
- handleAction: async ({ action, params, cfg, accountId, requesterSenderId, toolContext }) =>
149
- await (
150
- await loadWhatsAppChannelReactAction()
151
- ).handleWhatsAppReactAction({
152
- action,
153
- params,
154
- cfg,
155
- accountId,
156
- requesterSenderId,
157
- toolContext,
158
- }),
159
- },
160
- approvalCapability: whatsappApprovalAuth,
161
- auth: {
162
- login: async ({ cfg, accountId, runtime, verbose }) => {
163
- const resolvedAccountId =
164
- accountId?.trim() ||
165
- whatsappPlugin.config.defaultAccountId?.(cfg) ||
166
- DEFAULT_ACCOUNT_ID;
167
- await (
168
- await loadWhatsAppChannelRuntime()
169
- ).loginWeb(Boolean(verbose), undefined, runtime, resolvedAccountId);
170
- },
171
- },
172
- lifecycle: {
173
- detectLegacyStateMigrations: ({ oauthDir }) =>
174
- detectWhatsAppLegacyStateMigrations({ oauthDir }),
175
- },
176
- heartbeat: {
177
- checkReady: async ({ cfg, accountId, deps }) =>
178
- await checkWhatsAppHeartbeatReady({ cfg, accountId: accountId ?? undefined, deps }),
179
- sendTyping: async ({ cfg, to, accountId }) => {
180
- await sendTypingWhatsApp(to, {
181
- cfg,
182
- ...(accountId ? { accountId } : {}),
183
- });
184
- },
185
- },
186
- status: createAsyncComputedAccountStatusAdapter<ResolvedWhatsAppAccount>({
187
- defaultRuntime: createDefaultChannelRuntimeState(DEFAULT_ACCOUNT_ID, {
188
- connected: false,
189
- reconnectAttempts: 0,
190
- lastConnectedAt: null,
191
- lastDisconnect: null,
192
- lastInboundAt: null,
193
- lastMessageAt: null,
194
- lastEventAt: null,
195
- healthState: "stopped",
196
- }),
197
- collectStatusIssues: collectWhatsAppStatusIssues,
198
- buildChannelSummary: async ({ account, snapshot }) => {
199
- const channelRuntime = await loadWhatsAppChannelRuntime();
200
- const authDir = account.authDir;
201
- const auth = authDir
202
- ? await channelRuntime.readWebAuthSnapshot(authDir)
203
- : {
204
- state: "not-linked" as const,
205
- authAgeMs: null,
206
- selfId: { e164: null, jid: null, lid: null },
207
- };
208
- const linked =
209
- typeof snapshot.linked === "boolean"
210
- ? snapshot.linked
211
- : auth.state === "unstable"
212
- ? undefined
213
- : auth.state === "linked";
214
- const summaryAuthState =
215
- auth.state === "unstable"
216
- ? auth.state
217
- : linked === true
218
- ? "linked"
219
- : linked === false
220
- ? "not-linked"
221
- : undefined;
222
- const statusState = summaryAuthState === undefined ? undefined : summaryAuthState;
223
- const configured =
224
- auth.state === "unstable"
225
- ? typeof snapshot.configured === "boolean"
226
- ? snapshot.configured
227
- : true
228
- : typeof linked === "boolean"
229
- ? linked
230
- : auth.state === "linked";
231
- const authAgeMs = typeof linked === "boolean" && linked ? auth.authAgeMs : null;
232
- const self =
233
- typeof linked === "boolean" && linked
234
- ? auth.selfId
235
- : { e164: null, jid: null, lid: null };
236
- return {
237
- configured,
238
- ...(statusState ? { statusState } : {}),
239
- ...(typeof linked === "boolean" ? { linked } : {}),
240
- authAgeMs,
241
- self,
242
- running: snapshot.running ?? false,
243
- connected: snapshot.connected ?? false,
244
- lastConnectedAt: snapshot.lastConnectedAt ?? null,
245
- lastDisconnect: snapshot.lastDisconnect ?? null,
246
- reconnectAttempts: snapshot.reconnectAttempts,
247
- lastInboundAt: snapshot.lastInboundAt ?? snapshot.lastMessageAt ?? null,
248
- lastMessageAt: snapshot.lastMessageAt ?? null,
249
- lastEventAt: snapshot.lastEventAt ?? null,
250
- lastError: snapshot.lastError ?? null,
251
- healthState: snapshot.healthState ?? undefined,
252
- };
253
- },
254
- resolveAccountSnapshot: async ({ account, runtime }) => {
255
- const channelRuntime = await loadWhatsAppChannelRuntime();
256
- const authState = await channelRuntime.readWebAuthState(account.authDir);
257
- return {
258
- accountId: account.accountId,
259
- name: account.name,
260
- enabled: account.enabled,
261
- configured: true,
262
- extra: {
263
- statusState: authState,
264
- ...(authState === "linked"
265
- ? { linked: true }
266
- : authState === "not-linked"
267
- ? { linked: false }
268
- : {}),
269
- connected: runtime?.connected ?? false,
270
- reconnectAttempts: runtime?.reconnectAttempts,
271
- lastConnectedAt: runtime?.lastConnectedAt ?? null,
272
- lastDisconnect: runtime?.lastDisconnect ?? null,
273
- lastInboundAt: runtime?.lastInboundAt ?? runtime?.lastMessageAt ?? null,
274
- lastMessageAt: runtime?.lastMessageAt ?? null,
275
- lastEventAt: runtime?.lastEventAt ?? null,
276
- healthState: runtime?.healthState ?? undefined,
277
- dmPolicy: account.dmPolicy,
278
- allowFrom: account.allowFrom,
279
- },
280
- };
281
- },
282
- resolveAccountState: ({ configured }) => (configured ? "linked" : "not linked"),
283
- logSelfId: ({ account, runtime, includeChannelPrefix }) => {
284
- void loadWhatsAppChannelRuntime().then((runtimeExports) =>
285
- runtimeExports.logWebSelfId(account.authDir, runtime, includeChannelPrefix),
286
- );
287
- },
288
- }),
289
- gateway: {
290
- startAccount: async (ctx) => {
291
- const account = ctx.account;
292
- const { e164, jid } = (await loadWhatsAppChannelRuntime()).readWebSelfId(account.authDir);
293
- const identity = e164 ? e164 : jid ? `jid ${jid}` : "unknown";
294
- ctx.log?.info(`[${account.accountId}] starting provider (${identity})`);
295
- return (await loadWhatsAppChannelRuntime()).monitorWebChannel(
296
- getWhatsAppRuntime().logging.shouldLogVerbose(),
297
- undefined,
298
- true,
299
- undefined,
300
- ctx.runtime,
301
- ctx.abortSignal,
302
- {
303
- statusSink: (next: WebChannelStatus) =>
304
- ctx.setStatus({ accountId: ctx.accountId, ...next }),
305
- accountId: account.accountId,
306
- },
307
- );
308
- },
309
- loginWithQrStart: async ({ accountId, force, timeoutMs, verbose }) =>
310
- await (
311
- await loadWhatsAppChannelRuntime()
312
- ).startWebLoginWithQr({
313
- accountId,
314
- force,
315
- timeoutMs,
316
- verbose,
317
- }),
318
- loginWithQrWait: async ({ accountId, timeoutMs, currentQrDataUrl }) =>
319
- await (
320
- await loadWhatsAppChannelRuntime()
321
- ).waitForWebLogin({ accountId, timeoutMs, currentQrDataUrl }),
322
- logoutAccount: async ({ account, runtime }) => {
323
- const cleared = await (
324
- await loadWhatsAppChannelRuntime()
325
- ).logoutWeb({
326
- authDir: account.authDir,
327
- isLegacyAuthDir: account.isLegacyAuthDir,
328
- runtime,
329
- });
330
- return { cleared, loggedOut: cleared };
331
- },
332
- },
333
- },
334
- });
@@ -1,7 +0,0 @@
1
- import type { ChannelPlugin } from "openclaw/plugin-sdk/core";
2
-
3
- export const whatsappCommandPolicy: NonNullable<ChannelPlugin["commands"]> = {
4
- enforceOwnerForCommands: true,
5
- preferSenderE164ForCommands: true,
6
- skipWhenConfigEmpty: true,
7
- };
@@ -1,34 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import {
3
- formatWhatsAppConfigAllowFromEntries,
4
- resolveWhatsAppConfigAllowFrom,
5
- resolveWhatsAppConfigDefaultTo,
6
- } from "./config-accessors.js";
7
-
8
- describe("whatsapp config accessors", () => {
9
- it("reads merged allowFrom/defaultTo from resolved account config", () => {
10
- const cfg = {
11
- channels: {
12
- whatsapp: {
13
- defaultTo: " root:chat ",
14
- allowFrom: ["+49111"],
15
- accounts: {
16
- alt: {
17
- defaultTo: " alt:chat ",
18
- allowFrom: ["+49222", "+49333"],
19
- },
20
- },
21
- },
22
- },
23
- };
24
-
25
- expect(resolveWhatsAppConfigAllowFrom({ cfg, accountId: "alt" })).toEqual(["+49222", "+49333"]);
26
- expect(resolveWhatsAppConfigDefaultTo({ cfg, accountId: "alt" })).toBe("alt:chat");
27
- });
28
-
29
- it("normalizes allowFrom entries like the channel plugin", () => {
30
- expect(
31
- formatWhatsAppConfigAllowFromEntries([" whatsapp:+49123 ", "*", "49124@s.whatsapp.net"]),
32
- ).toEqual(["+49123", "*", "+49124"]);
33
- });
34
- });
@@ -1,22 +0,0 @@
1
- import type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";
2
- import { resolveWhatsAppAccount } from "./accounts.js";
3
- import { normalizeWhatsAppAllowFromEntries } from "./normalize-target.js";
4
-
5
- export function resolveWhatsAppConfigAllowFrom(params: {
6
- cfg: OpenClawConfig;
7
- accountId?: string | null;
8
- }): string[] {
9
- return [...(resolveWhatsAppAccount(params).allowFrom ?? [])];
10
- }
11
-
12
- export function formatWhatsAppConfigAllowFromEntries(allowFrom: Array<string | number>): string[] {
13
- return normalizeWhatsAppAllowFromEntries(allowFrom);
14
- }
15
-
16
- export function resolveWhatsAppConfigDefaultTo(params: {
17
- cfg: OpenClawConfig;
18
- accountId?: string | null;
19
- }): string | undefined {
20
- const defaultTo = resolveWhatsAppAccount(params).defaultTo?.trim();
21
- return defaultTo || undefined;
22
- }
@@ -1,121 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import { WhatsAppConfigSchema } from "../config-api.js";
3
-
4
- function expectWhatsAppConfigValid(config: unknown) {
5
- const res = WhatsAppConfigSchema.safeParse(config);
6
- expect(res.success).toBe(true);
7
- return res;
8
- }
9
-
10
- describe("whatsapp config schema", () => {
11
- it('rejects dmPolicy="open" without allowFrom "*"', () => {
12
- const res = WhatsAppConfigSchema.safeParse({
13
- dmPolicy: "open",
14
- allowFrom: ["+15555550123"],
15
- });
16
-
17
- expect(res.success).toBe(false);
18
- if (!res.success) {
19
- expect(res.error.issues[0]?.path.join(".")).toBe("allowFrom");
20
- }
21
- });
22
-
23
- it('accepts dmPolicy="open" with allowFrom "*"', () => {
24
- const res = WhatsAppConfigSchema.safeParse({ dmPolicy: "open", allowFrom: ["*"] });
25
-
26
- expect(res.success).toBe(true);
27
- if (res.success) {
28
- expect(res.data.dmPolicy).toBe("open");
29
- }
30
- });
31
-
32
- it("defaults dm/group policy", () => {
33
- const res = WhatsAppConfigSchema.safeParse({});
34
-
35
- expect(res.success).toBe(true);
36
- if (res.success) {
37
- expect(res.data.dmPolicy).toBe("pairing");
38
- expect(res.data.groupPolicy).toBe("allowlist");
39
- }
40
- });
41
-
42
- it("accepts historyLimit overrides per account", () => {
43
- const res = WhatsAppConfigSchema.safeParse({
44
- historyLimit: 9,
45
- accounts: { work: { historyLimit: 4 } },
46
- });
47
-
48
- expect(res.success).toBe(true);
49
- if (res.success) {
50
- expect(res.data.historyLimit).toBe(9);
51
- expect(res.data.accounts?.work?.historyLimit).toBe(4);
52
- }
53
- });
54
-
55
- it("accepts textChunkLimit", () => {
56
- const res = expectWhatsAppConfigValid({
57
- allowFrom: ["+15555550123"],
58
- textChunkLimit: 4444,
59
- });
60
-
61
- if (res.success) {
62
- expect(res.data.textChunkLimit).toBe(4444);
63
- }
64
- });
65
-
66
- it("accepts enabled", () => {
67
- expectWhatsAppConfigValid({
68
- enabled: true,
69
- });
70
- });
71
-
72
- it("keeps inherited account defaults unset at account scope", () => {
73
- const res = expectWhatsAppConfigValid({
74
- dmPolicy: "allowlist",
75
- groupPolicy: "open",
76
- debounceMs: 250,
77
- allowFrom: ["+15550001111"],
78
- accounts: {
79
- work: {
80
- allowFrom: ["+15550002222"],
81
- },
82
- },
83
- });
84
-
85
- if (!res.success) {
86
- return;
87
- }
88
- expect(res.data.dmPolicy).toBe("allowlist");
89
- expect(res.data.groupPolicy).toBe("open");
90
- expect(res.data.debounceMs).toBe(250);
91
- expect(res.data.accounts?.work?.dmPolicy).toBeUndefined();
92
- expect(res.data.accounts?.work?.groupPolicy).toBeUndefined();
93
- expect(res.data.accounts?.work?.debounceMs).toBeUndefined();
94
- });
95
-
96
- it("accepts allowlist accounts inheriting allowFrom from accounts.default", () => {
97
- expectWhatsAppConfigValid({
98
- accounts: {
99
- default: {
100
- allowFrom: ["+15550001111"],
101
- },
102
- work: {
103
- dmPolicy: "allowlist",
104
- },
105
- },
106
- });
107
- });
108
-
109
- it("accepts allowlist accounts inheriting allowFrom from mixed-case accounts.Default", () => {
110
- expectWhatsAppConfigValid({
111
- accounts: {
112
- Default: {
113
- allowFrom: ["+15550001111"],
114
- },
115
- work: {
116
- dmPolicy: "allowlist",
117
- },
118
- },
119
- });
120
- });
121
- });
@@ -1,6 +0,0 @@
1
- import { buildChannelConfigSchema, WhatsAppConfigSchema } from "../config-api.js";
2
- import { whatsAppChannelConfigUiHints } from "./config-ui-hints.js";
3
-
4
- export const WhatsAppChannelConfigSchema = buildChannelConfigSchema(WhatsAppConfigSchema, {
5
- uiHints: whatsAppChannelConfigUiHints,
6
- });
@@ -1,24 +0,0 @@
1
- import type { ChannelConfigUiHint } from "openclaw/plugin-sdk/core";
2
-
3
- export const whatsAppChannelConfigUiHints = {
4
- "": {
5
- label: "WhatsApp",
6
- 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.",
7
- },
8
- dmPolicy: {
9
- label: "WhatsApp DM Policy",
10
- help: 'Direct message access control ("pairing" recommended). "open" requires channels.whatsapp.allowFrom=["*"].',
11
- },
12
- selfChatMode: {
13
- label: "WhatsApp Self-Phone Mode",
14
- help: "Same-phone setup (bot uses your personal WhatsApp number).",
15
- },
16
- debounceMs: {
17
- label: "WhatsApp Message Debounce (ms)",
18
- help: "Debounce window (ms) for batching rapid consecutive messages from the same sender (0 to disable).",
19
- },
20
- configWrites: {
21
- label: "WhatsApp Config Writes",
22
- help: "Allow WhatsApp to write config in response to channel events/commands (default: true).",
23
- },
24
- } satisfies Record<string, ChannelConfigUiHint>;
@@ -1,27 +0,0 @@
1
- import { describe, expect, it, vi } from "vitest";
2
-
3
- type RegistryModule = typeof import("./connection-controller-registry.js");
4
-
5
- const registryModuleUrl = new URL("./connection-controller-registry.ts", import.meta.url).href;
6
-
7
- async function importRegistryModule(cacheBust: string): Promise<RegistryModule> {
8
- return (await import(`${registryModuleUrl}?t=${cacheBust}`)) as RegistryModule;
9
- }
10
-
11
- describe("WhatsApp connection controller registry", () => {
12
- it("shares registered controllers across duplicate module instances", async () => {
13
- const first = await importRegistryModule(`first-${Date.now()}`);
14
- const second = await importRegistryModule(`second-${Date.now()}`);
15
- const controller = {
16
- getActiveListener: vi.fn(() => null),
17
- };
18
-
19
- first.registerWhatsAppConnectionController("work", controller);
20
-
21
- try {
22
- expect(second.getRegisteredWhatsAppConnectionController("work")).toBe(controller);
23
- } finally {
24
- first.unregisterWhatsAppConnectionController("work", controller);
25
- }
26
- });
27
- });
@@ -1,49 +0,0 @@
1
- import type { ActiveWebListener } from "./inbound/types.js";
2
-
3
- type WhatsAppConnectionControllerHandle = {
4
- getActiveListener(): ActiveWebListener | null;
5
- };
6
-
7
- type ConnectionRegistryState = {
8
- controllers: Map<string, WhatsAppConnectionControllerHandle>;
9
- };
10
-
11
- const CONNECTION_REGISTRY_KEY = Symbol.for("openclaw.whatsapp.connectionControllerRegistry");
12
-
13
- function getConnectionRegistryState(): ConnectionRegistryState {
14
- const globalState = globalThis as typeof globalThis & {
15
- [CONNECTION_REGISTRY_KEY]?: ConnectionRegistryState;
16
- };
17
- const existing = globalState[CONNECTION_REGISTRY_KEY];
18
- if (existing) {
19
- return existing;
20
- }
21
- const created: ConnectionRegistryState = {
22
- controllers: new Map<string, WhatsAppConnectionControllerHandle>(),
23
- };
24
- globalState[CONNECTION_REGISTRY_KEY] = created;
25
- return created;
26
- }
27
-
28
- export function getRegisteredWhatsAppConnectionController(
29
- accountId: string,
30
- ): WhatsAppConnectionControllerHandle | null {
31
- return getConnectionRegistryState().controllers.get(accountId) ?? null;
32
- }
33
-
34
- export function registerWhatsAppConnectionController(
35
- accountId: string,
36
- controller: WhatsAppConnectionControllerHandle,
37
- ): void {
38
- getConnectionRegistryState().controllers.set(accountId, controller);
39
- }
40
-
41
- export function unregisterWhatsAppConnectionController(
42
- accountId: string,
43
- controller: WhatsAppConnectionControllerHandle,
44
- ): void {
45
- const controllers = getConnectionRegistryState().controllers;
46
- if (controllers.get(accountId) === controller) {
47
- controllers.delete(accountId);
48
- }
49
- }