@openclaw/discord 2026.3.13 → 2026.5.2-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 (502) hide show
  1. package/account-inspect-api.ts +6 -0
  2. package/action-runtime-api.ts +1 -0
  3. package/api.ts +132 -0
  4. package/channel-config-api.ts +1 -0
  5. package/channel-plugin-api.ts +3 -0
  6. package/config-api.ts +4 -0
  7. package/configured-state.ts +6 -0
  8. package/contract-api.ts +21 -0
  9. package/directory-contract-api.ts +4 -0
  10. package/doctor-contract-api.ts +1 -0
  11. package/index.test.ts +13 -0
  12. package/index.ts +18 -13
  13. package/openclaw.plugin.json +3326 -1
  14. package/package.json +68 -2
  15. package/runtime-api.actions.ts +15 -0
  16. package/runtime-api.lookup.ts +22 -0
  17. package/runtime-api.monitor.ts +50 -0
  18. package/runtime-api.send.ts +79 -0
  19. package/runtime-api.threads.ts +30 -0
  20. package/runtime-api.ts +180 -0
  21. package/runtime-setter-api.ts +3 -0
  22. package/secret-contract-api.ts +4 -0
  23. package/security-audit-contract-api.ts +1 -0
  24. package/security-contract-api.ts +4 -0
  25. package/session-key-api.ts +1 -0
  26. package/setup-entry.ts +9 -0
  27. package/setup-plugin-api.ts +3 -0
  28. package/src/account-inspect.test.ts +126 -0
  29. package/src/account-inspect.ts +132 -0
  30. package/src/accounts.test.ts +247 -0
  31. package/src/accounts.ts +196 -0
  32. package/src/actions/handle-action.guild-admin.ts +411 -0
  33. package/src/actions/handle-action.test.ts +306 -0
  34. package/src/actions/handle-action.ts +372 -0
  35. package/src/actions/runtime.guild.ts +446 -0
  36. package/src/actions/runtime.messaging.messages.ts +205 -0
  37. package/src/actions/runtime.messaging.reactions.ts +67 -0
  38. package/src/actions/runtime.messaging.runtime.ts +69 -0
  39. package/src/actions/runtime.messaging.send.ts +248 -0
  40. package/src/actions/runtime.messaging.shared.ts +97 -0
  41. package/src/actions/runtime.messaging.ts +37 -0
  42. package/src/actions/runtime.moderation-shared.ts +48 -0
  43. package/src/actions/runtime.moderation.authz.test.ts +151 -0
  44. package/src/actions/runtime.moderation.ts +116 -0
  45. package/src/actions/runtime.presence.test.ts +160 -0
  46. package/src/actions/runtime.presence.ts +117 -0
  47. package/src/actions/runtime.shared.ts +83 -0
  48. package/src/actions/runtime.test.ts +1087 -0
  49. package/src/actions/runtime.ts +87 -0
  50. package/src/api-barrel.test.ts +80 -0
  51. package/src/api.test.ts +130 -0
  52. package/src/api.ts +169 -0
  53. package/src/approval-handler.runtime.test.ts +41 -0
  54. package/src/approval-handler.runtime.ts +632 -0
  55. package/src/approval-native.test.ts +330 -0
  56. package/src/approval-native.ts +219 -0
  57. package/src/approval-runtime.ts +14 -0
  58. package/src/approval-shared.ts +53 -0
  59. package/src/audit-core.ts +141 -0
  60. package/src/audit.test.ts +145 -0
  61. package/src/audit.ts +32 -0
  62. package/src/channel-actions.contract.test.ts +45 -0
  63. package/src/channel-actions.runtime.ts +1 -0
  64. package/src/channel-actions.test.ts +275 -0
  65. package/src/channel-actions.ts +203 -0
  66. package/src/channel-api.ts +29 -0
  67. package/src/channel.conversation.ts +159 -0
  68. package/src/channel.loaders.ts +47 -0
  69. package/src/channel.runtime.ts +1 -0
  70. package/src/channel.setup.ts +12 -0
  71. package/src/channel.test.ts +547 -12
  72. package/src/channel.ts +597 -430
  73. package/src/chunk.test.ts +157 -0
  74. package/src/chunk.ts +321 -0
  75. package/src/client.proxy.test.ts +176 -0
  76. package/src/client.test.ts +76 -0
  77. package/src/client.ts +132 -0
  78. package/src/component-custom-id.ts +72 -0
  79. package/src/components-registry.ts +356 -0
  80. package/src/components.builders.ts +409 -0
  81. package/src/components.modal.ts +124 -0
  82. package/src/components.parse.ts +407 -0
  83. package/src/components.test.ts +312 -0
  84. package/src/components.ts +54 -0
  85. package/src/components.types.ts +187 -0
  86. package/src/config-schema.test.ts +325 -0
  87. package/src/config-schema.ts +6 -0
  88. package/src/config-ui-hints.ts +249 -0
  89. package/src/conversation-identity.ts +58 -0
  90. package/src/delivery-retry.ts +56 -0
  91. package/src/directory-cache.ts +116 -0
  92. package/src/directory-config.ts +58 -0
  93. package/src/directory-contract.test.ts +129 -0
  94. package/src/directory-live.test.ts +126 -0
  95. package/src/directory-live.ts +135 -0
  96. package/src/doctor-contract.ts +477 -0
  97. package/src/doctor-shared.ts +5 -0
  98. package/src/doctor.test.ts +405 -0
  99. package/src/doctor.ts +340 -0
  100. package/src/draft-chunking.test.ts +64 -0
  101. package/src/draft-chunking.ts +43 -0
  102. package/src/draft-stream.test.ts +159 -0
  103. package/src/draft-stream.ts +154 -0
  104. package/src/error-body.ts +38 -0
  105. package/src/exec-approvals.test.ts +88 -0
  106. package/src/exec-approvals.ts +110 -0
  107. package/src/gateway-logging.test.ts +98 -0
  108. package/src/gateway-logging.ts +67 -0
  109. package/src/group-policy.ts +113 -0
  110. package/src/guilds.ts +29 -0
  111. package/src/inbound-context.contract.test.ts +11 -0
  112. package/src/interactive-dispatch.ts +104 -0
  113. package/src/internal/api.commands.ts +51 -0
  114. package/src/internal/api.guild.ts +164 -0
  115. package/src/internal/api.interactions.ts +53 -0
  116. package/src/internal/api.messages.ts +113 -0
  117. package/src/internal/api.reactions.ts +38 -0
  118. package/src/internal/api.test.ts +262 -0
  119. package/src/internal/api.ts +61 -0
  120. package/src/internal/api.users.ts +19 -0
  121. package/src/internal/api.webhooks.ts +13 -0
  122. package/src/internal/client.test.ts +408 -0
  123. package/src/internal/client.ts +308 -0
  124. package/src/internal/command-deploy.ts +237 -0
  125. package/src/internal/commands.ts +188 -0
  126. package/src/internal/components.base.ts +65 -0
  127. package/src/internal/components.message.ts +279 -0
  128. package/src/internal/components.modal.ts +95 -0
  129. package/src/internal/components.ts +31 -0
  130. package/src/internal/discord.ts +11 -0
  131. package/src/internal/embeds.ts +35 -0
  132. package/src/internal/entity-cache.ts +98 -0
  133. package/src/internal/event-queue.ts +162 -0
  134. package/src/internal/gateway-close-codes.ts +25 -0
  135. package/src/internal/gateway-dispatch.ts +96 -0
  136. package/src/internal/gateway-identify-limiter.ts +26 -0
  137. package/src/internal/gateway-lifecycle.ts +61 -0
  138. package/src/internal/gateway-rate-limit.ts +104 -0
  139. package/src/internal/gateway.test.ts +603 -0
  140. package/src/internal/gateway.ts +476 -0
  141. package/src/internal/interaction-dispatch.test.ts +148 -0
  142. package/src/internal/interaction-dispatch.ts +162 -0
  143. package/src/internal/interaction-options.ts +98 -0
  144. package/src/internal/interaction-response.ts +53 -0
  145. package/src/internal/interactions.test.ts +325 -0
  146. package/src/internal/interactions.ts +378 -0
  147. package/src/internal/listeners.ts +85 -0
  148. package/src/internal/live-smoke.live.test.ts +26 -0
  149. package/src/internal/modal-fields.ts +95 -0
  150. package/src/internal/payload.ts +69 -0
  151. package/src/internal/rest-body.ts +115 -0
  152. package/src/internal/rest-errors.ts +88 -0
  153. package/src/internal/rest-routes.ts +50 -0
  154. package/src/internal/rest-scheduler.ts +557 -0
  155. package/src/internal/rest.test.ts +673 -0
  156. package/src/internal/rest.ts +322 -0
  157. package/src/internal/schemas.ts +36 -0
  158. package/src/internal/structures.test.ts +43 -0
  159. package/src/internal/structures.ts +280 -0
  160. package/src/internal/test-builders.test-support.ts +163 -0
  161. package/src/internal/voice.ts +49 -0
  162. package/src/media-detection.ts +28 -0
  163. package/src/mentions.test.ts +111 -0
  164. package/src/mentions.ts +147 -0
  165. package/src/monitor/access-groups.ts +55 -0
  166. package/src/monitor/ack-reactions.ts +70 -0
  167. package/src/monitor/acp-bind-here.integration.test.ts +211 -0
  168. package/src/monitor/agent-components-auth.ts +7 -0
  169. package/src/monitor/agent-components-context.ts +154 -0
  170. package/src/monitor/agent-components-data.ts +224 -0
  171. package/src/monitor/agent-components-dm-auth.ts +221 -0
  172. package/src/monitor/agent-components-guild-auth.ts +322 -0
  173. package/src/monitor/agent-components-helpers.runtime.ts +5 -0
  174. package/src/monitor/agent-components-helpers.ts +34 -0
  175. package/src/monitor/agent-components-reply.ts +10 -0
  176. package/src/monitor/agent-components.deps.runtime.ts +2 -0
  177. package/src/monitor/agent-components.dispatch.ts +366 -0
  178. package/src/monitor/agent-components.handlers.ts +303 -0
  179. package/src/monitor/agent-components.modal.ts +160 -0
  180. package/src/monitor/agent-components.plugin-interactive.ts +187 -0
  181. package/src/monitor/agent-components.runtime.ts +14 -0
  182. package/src/monitor/agent-components.system-controls.ts +211 -0
  183. package/src/monitor/agent-components.ts +70 -0
  184. package/src/monitor/agent-components.types.ts +58 -0
  185. package/src/monitor/agent-components.wildcard-controls.ts +168 -0
  186. package/src/monitor/agent-components.wildcard.test.ts +71 -0
  187. package/src/monitor/allow-list.test.ts +14 -0
  188. package/src/monitor/allow-list.ts +633 -0
  189. package/src/monitor/auto-presence.test.ts +156 -0
  190. package/src/monitor/auto-presence.ts +356 -0
  191. package/src/monitor/channel-access.test.ts +99 -0
  192. package/src/monitor/channel-access.ts +102 -0
  193. package/src/monitor/commands.test.ts +24 -0
  194. package/src/monitor/commands.ts +9 -0
  195. package/src/monitor/dm-command-auth.test.ts +197 -0
  196. package/src/monitor/dm-command-auth.ts +158 -0
  197. package/src/monitor/dm-command-decision.test.ts +113 -0
  198. package/src/monitor/dm-command-decision.ts +49 -0
  199. package/src/monitor/exec-approvals.test.ts +226 -0
  200. package/src/monitor/exec-approvals.ts +158 -0
  201. package/src/monitor/format.ts +45 -0
  202. package/src/monitor/gateway-handle.ts +34 -0
  203. package/src/monitor/gateway-metadata.test.ts +29 -0
  204. package/src/monitor/gateway-metadata.ts +298 -0
  205. package/src/monitor/gateway-plugin.test.ts +297 -0
  206. package/src/monitor/gateway-plugin.ts +294 -0
  207. package/src/monitor/gateway-registry.ts +37 -0
  208. package/src/monitor/gateway-supervisor.test.ts +150 -0
  209. package/src/monitor/gateway-supervisor.ts +206 -0
  210. package/src/monitor/inbound-context.test-helpers.ts +37 -0
  211. package/src/monitor/inbound-context.test.ts +106 -0
  212. package/src/monitor/inbound-context.ts +103 -0
  213. package/src/monitor/inbound-dedupe.ts +79 -0
  214. package/src/monitor/inbound-job.test.ts +203 -0
  215. package/src/monitor/inbound-job.ts +118 -0
  216. package/src/monitor/listeners.queue.ts +91 -0
  217. package/src/monitor/listeners.reactions.ts +610 -0
  218. package/src/monitor/listeners.test.ts +200 -0
  219. package/src/monitor/listeners.ts +150 -0
  220. package/src/monitor/message-channel-info.ts +96 -0
  221. package/src/monitor/message-forwarded.ts +107 -0
  222. package/src/monitor/message-handler.batch-gate.test.ts +22 -0
  223. package/src/monitor/message-handler.batch-gate.ts +19 -0
  224. package/src/monitor/message-handler.bot-self-filter.test.ts +68 -0
  225. package/src/monitor/message-handler.context.ts +406 -0
  226. package/src/monitor/message-handler.dm-preflight.ts +123 -0
  227. package/src/monitor/message-handler.draft-preview.ts +246 -0
  228. package/src/monitor/message-handler.hydration.test.ts +80 -0
  229. package/src/monitor/message-handler.hydration.ts +198 -0
  230. package/src/monitor/message-handler.inbound-context.test.ts +59 -0
  231. package/src/monitor/message-handler.module-test-helpers.ts +31 -0
  232. package/src/monitor/message-handler.preflight-channel-access.ts +86 -0
  233. package/src/monitor/message-handler.preflight-channel-context.test.ts +18 -0
  234. package/src/monitor/message-handler.preflight-channel-context.ts +58 -0
  235. package/src/monitor/message-handler.preflight-context.ts +54 -0
  236. package/src/monitor/message-handler.preflight-helpers.ts +164 -0
  237. package/src/monitor/message-handler.preflight-history.ts +23 -0
  238. package/src/monitor/message-handler.preflight-logging.ts +36 -0
  239. package/src/monitor/message-handler.preflight-pluralkit.ts +26 -0
  240. package/src/monitor/message-handler.preflight-runtime.ts +28 -0
  241. package/src/monitor/message-handler.preflight-thread.ts +49 -0
  242. package/src/monitor/message-handler.preflight.acp-bindings.test.ts +369 -0
  243. package/src/monitor/message-handler.preflight.test-helpers.ts +111 -0
  244. package/src/monitor/message-handler.preflight.test.ts +1623 -0
  245. package/src/monitor/message-handler.preflight.ts +679 -0
  246. package/src/monitor/message-handler.preflight.types.ts +110 -0
  247. package/src/monitor/message-handler.process.test.ts +1369 -0
  248. package/src/monitor/message-handler.process.ts +686 -0
  249. package/src/monitor/message-handler.queue.test.ts +496 -0
  250. package/src/monitor/message-handler.routing-preflight.ts +112 -0
  251. package/src/monitor/message-handler.test-harness.ts +99 -0
  252. package/src/monitor/message-handler.test-helpers.ts +75 -0
  253. package/src/monitor/message-handler.ts +274 -0
  254. package/src/monitor/message-media.ts +509 -0
  255. package/src/monitor/message-run-queue.ts +101 -0
  256. package/src/monitor/message-text.ts +171 -0
  257. package/src/monitor/message-utils.test.ts +1157 -0
  258. package/src/monitor/message-utils.ts +32 -0
  259. package/src/monitor/model-picker-preferences.test.ts +67 -0
  260. package/src/monitor/model-picker-preferences.ts +184 -0
  261. package/src/monitor/model-picker.state.ts +364 -0
  262. package/src/monitor/model-picker.test-utils.ts +26 -0
  263. package/src/monitor/model-picker.test.ts +794 -0
  264. package/src/monitor/model-picker.ts +38 -0
  265. package/src/monitor/model-picker.view.ts +695 -0
  266. package/src/monitor/monitor.agent-components.test.ts +375 -0
  267. package/src/monitor/monitor.test.ts +849 -0
  268. package/src/monitor/monitor.threading-utils.test.ts +598 -0
  269. package/src/monitor/native-command-agent-reply.ts +125 -0
  270. package/src/monitor/native-command-arg-ui.ts +233 -0
  271. package/src/monitor/native-command-auth.ts +308 -0
  272. package/src/monitor/native-command-bypass.ts +13 -0
  273. package/src/monitor/native-command-context.test.ts +98 -0
  274. package/src/monitor/native-command-context.ts +103 -0
  275. package/src/monitor/native-command-dispatch.ts +35 -0
  276. package/src/monitor/native-command-model-picker-apply.ts +177 -0
  277. package/src/monitor/native-command-model-picker-interaction.ts +461 -0
  278. package/src/monitor/native-command-model-picker-ui.ts +368 -0
  279. package/src/monitor/native-command-reply.test.ts +68 -0
  280. package/src/monitor/native-command-reply.ts +185 -0
  281. package/src/monitor/native-command-route.ts +91 -0
  282. package/src/monitor/native-command-status.ts +76 -0
  283. package/src/monitor/native-command-ui.ts +26 -0
  284. package/src/monitor/native-command-ui.types.ts +20 -0
  285. package/src/monitor/native-command.args.ts +45 -0
  286. package/src/monitor/native-command.command-arg.test.ts +99 -0
  287. package/src/monitor/native-command.commands-allowfrom.test.ts +490 -0
  288. package/src/monitor/native-command.model-picker.test.ts +767 -0
  289. package/src/monitor/native-command.options.test.ts +369 -0
  290. package/src/monitor/native-command.options.ts +153 -0
  291. package/src/monitor/native-command.plugin-dispatch.test.ts +961 -0
  292. package/src/monitor/native-command.runtime.ts +50 -0
  293. package/src/monitor/native-command.status-direct.test.ts +272 -0
  294. package/src/monitor/native-command.test-helpers.ts +64 -0
  295. package/src/monitor/native-command.think-autocomplete.test.ts +416 -0
  296. package/src/monitor/native-command.ts +700 -0
  297. package/src/monitor/native-command.types.ts +9 -0
  298. package/src/monitor/native-interaction-channel-context.ts +50 -0
  299. package/src/monitor/preflight-audio.runtime.ts +9 -0
  300. package/src/monitor/preflight-audio.test.ts +157 -0
  301. package/src/monitor/preflight-audio.ts +130 -0
  302. package/src/monitor/presence-cache.ts +61 -0
  303. package/src/monitor/presence.test.ts +44 -0
  304. package/src/monitor/presence.ts +50 -0
  305. package/src/monitor/provider-session.runtime.ts +12 -0
  306. package/src/monitor/provider.acp.ts +89 -0
  307. package/src/monitor/provider.allowlist.test.ts +149 -0
  308. package/src/monitor/provider.allowlist.ts +394 -0
  309. package/src/monitor/provider.cleanup.ts +41 -0
  310. package/src/monitor/provider.commands.ts +129 -0
  311. package/src/monitor/provider.config-log.ts +45 -0
  312. package/src/monitor/provider.deploy-errors.ts +362 -0
  313. package/src/monitor/provider.deploy.ts +221 -0
  314. package/src/monitor/provider.interactions.ts +160 -0
  315. package/src/monitor/provider.lifecycle.test.ts +713 -0
  316. package/src/monitor/provider.lifecycle.ts +552 -0
  317. package/src/monitor/provider.proxy.test.ts +745 -0
  318. package/src/monitor/provider.rest-proxy.test.ts +121 -0
  319. package/src/monitor/provider.runtime.ts +1 -0
  320. package/src/monitor/provider.skill-dedupe.test.ts +42 -0
  321. package/src/monitor/provider.startup-log.ts +32 -0
  322. package/src/monitor/provider.startup.test.ts +426 -0
  323. package/src/monitor/provider.startup.ts +323 -0
  324. package/src/monitor/provider.test.ts +1111 -0
  325. package/src/monitor/provider.ts +713 -0
  326. package/src/monitor/reply-context.ts +64 -0
  327. package/src/monitor/reply-delivery.test.ts +244 -0
  328. package/src/monitor/reply-delivery.ts +203 -0
  329. package/src/monitor/rest-fetch.ts +43 -0
  330. package/src/monitor/route-resolution.test.ts +204 -0
  331. package/src/monitor/route-resolution.ts +140 -0
  332. package/src/monitor/sender-identity.ts +81 -0
  333. package/src/monitor/startup-status.test.ts +30 -0
  334. package/src/monitor/startup-status.ts +10 -0
  335. package/src/monitor/status.ts +22 -0
  336. package/src/monitor/system-events.ts +55 -0
  337. package/src/monitor/thread-bindings.config.ts +35 -0
  338. package/src/monitor/thread-bindings.discord-api.test.ts +229 -0
  339. package/src/monitor/thread-bindings.discord-api.ts +310 -0
  340. package/src/monitor/thread-bindings.lifecycle.test.ts +1871 -0
  341. package/src/monitor/thread-bindings.lifecycle.ts +354 -0
  342. package/src/monitor/thread-bindings.manager.ts +553 -0
  343. package/src/monitor/thread-bindings.messages.ts +6 -0
  344. package/src/monitor/thread-bindings.persona.test.ts +34 -0
  345. package/src/monitor/thread-bindings.persona.ts +25 -0
  346. package/src/monitor/thread-bindings.session-adapter.ts +229 -0
  347. package/src/monitor/thread-bindings.session-shared.ts +59 -0
  348. package/src/monitor/thread-bindings.session-updates.ts +35 -0
  349. package/src/monitor/thread-bindings.shared-state.test.ts +36 -0
  350. package/src/monitor/thread-bindings.state.ts +540 -0
  351. package/src/monitor/thread-bindings.ts +48 -0
  352. package/src/monitor/thread-bindings.types.ts +83 -0
  353. package/src/monitor/thread-channel-context.ts +112 -0
  354. package/src/monitor/thread-session-close.test.ts +180 -0
  355. package/src/monitor/thread-session-close.ts +63 -0
  356. package/src/monitor/thread-title.generate.test.ts +197 -0
  357. package/src/monitor/thread-title.test.ts +31 -0
  358. package/src/monitor/thread-title.ts +181 -0
  359. package/src/monitor/threading.auto-thread.test.ts +327 -0
  360. package/src/monitor/threading.auto-thread.ts +287 -0
  361. package/src/monitor/threading.cache.ts +45 -0
  362. package/src/monitor/threading.parent-info.test.ts +156 -0
  363. package/src/monitor/threading.starter.test.ts +260 -0
  364. package/src/monitor/threading.starter.ts +287 -0
  365. package/src/monitor/threading.ts +20 -0
  366. package/src/monitor/threading.types.ts +102 -0
  367. package/src/monitor/timeouts.ts +84 -0
  368. package/src/monitor/typing.test.ts +42 -0
  369. package/src/monitor/typing.ts +17 -0
  370. package/src/monitor.gateway.test.ts +187 -0
  371. package/src/monitor.gateway.ts +75 -0
  372. package/src/monitor.test.ts +1397 -0
  373. package/src/monitor.ts +28 -0
  374. package/src/normalize.test.ts +56 -0
  375. package/src/normalize.ts +86 -0
  376. package/src/outbound-adapter.interactive-order.test.ts +64 -0
  377. package/src/outbound-adapter.test-harness.ts +207 -0
  378. package/src/outbound-adapter.test.ts +696 -0
  379. package/src/outbound-adapter.ts +291 -0
  380. package/src/outbound-approval.ts +29 -0
  381. package/src/outbound-components.ts +81 -0
  382. package/src/outbound-payload.contract.test.ts +38 -0
  383. package/src/outbound-payload.ts +134 -0
  384. package/src/outbound-send-context.ts +92 -0
  385. package/src/outbound-session-route.test.ts +34 -0
  386. package/src/outbound-session-route.ts +72 -0
  387. package/src/pluralkit.test.ts +67 -0
  388. package/src/pluralkit.ts +58 -0
  389. package/src/preview-streaming.ts +32 -0
  390. package/src/probe.intents.test.ts +94 -0
  391. package/src/probe.parse-token.test.ts +43 -0
  392. package/src/probe.runtime.ts +1 -0
  393. package/src/probe.ts +237 -0
  394. package/src/proxy-fetch.ts +92 -0
  395. package/src/proxy-request-client.test.ts +78 -0
  396. package/src/proxy-request-client.ts +21 -0
  397. package/src/recipient-resolution.ts +39 -0
  398. package/src/resolve-allowlist-common.test.ts +36 -0
  399. package/src/resolve-allowlist-common.ts +39 -0
  400. package/src/resolve-channels.test.ts +340 -0
  401. package/src/resolve-channels.ts +369 -0
  402. package/src/resolve-users.test.ts +222 -0
  403. package/src/resolve-users.ts +184 -0
  404. package/src/retry.test.ts +83 -0
  405. package/src/retry.ts +98 -0
  406. package/src/runtime-api.ts +64 -0
  407. package/src/runtime.ts +22 -5
  408. package/src/secret-config-contract.ts +140 -0
  409. package/src/security-audit.runtime.ts +1 -0
  410. package/src/security-audit.test.ts +246 -0
  411. package/src/security-audit.ts +208 -0
  412. package/src/security-contract.ts +47 -0
  413. package/src/security-doctor.test.ts +25 -0
  414. package/src/security-doctor.ts +20 -0
  415. package/src/security.ts +60 -0
  416. package/src/send-target-parsing.ts +14 -0
  417. package/src/send.channels.ts +139 -0
  418. package/src/send.components.test.ts +275 -0
  419. package/src/send.components.ts +381 -0
  420. package/src/send.creates-thread.test.ts +643 -0
  421. package/src/send.emojis-stickers.ts +57 -0
  422. package/src/send.guild.ts +170 -0
  423. package/src/send.message-request.ts +97 -0
  424. package/src/send.messages.test.ts +53 -0
  425. package/src/send.messages.ts +225 -0
  426. package/src/send.outbound.ts +413 -0
  427. package/src/send.permissions.authz.test.ts +188 -0
  428. package/src/send.permissions.ts +283 -0
  429. package/src/send.reactions.ts +155 -0
  430. package/src/send.sends-basic-channel-messages.test.ts +941 -0
  431. package/src/send.shared.ts +447 -0
  432. package/src/send.test-harness.ts +56 -0
  433. package/src/send.ts +82 -0
  434. package/src/send.types.ts +188 -0
  435. package/src/send.typing.test.ts +41 -0
  436. package/src/send.typing.ts +9 -0
  437. package/src/send.voice.ts +134 -0
  438. package/src/send.webhook-activity.test.ts +105 -0
  439. package/src/send.webhook.proxy.test.ts +191 -0
  440. package/src/send.webhook.ts +133 -0
  441. package/src/session-contract.ts +3 -0
  442. package/src/session-key-normalization.test.ts +44 -0
  443. package/src/session-key-normalization.ts +47 -0
  444. package/src/setup-account-state.test.ts +91 -0
  445. package/src/setup-account-state.ts +144 -0
  446. package/src/setup-adapter.ts +12 -0
  447. package/src/setup-core.ts +212 -0
  448. package/src/setup-runtime-helpers.ts +10 -0
  449. package/src/setup-surface.test.ts +137 -0
  450. package/src/setup-surface.ts +129 -0
  451. package/src/shared-interactive.test.ts +153 -0
  452. package/src/shared-interactive.ts +124 -0
  453. package/src/shared.test.ts +165 -0
  454. package/src/shared.ts +190 -0
  455. package/src/status-issues.test.ts +70 -0
  456. package/src/status-issues.ts +169 -0
  457. package/src/subagent-hooks.test.ts +130 -81
  458. package/src/subagent-hooks.ts +184 -122
  459. package/src/target-parsing.ts +53 -0
  460. package/src/target-resolver.ts +129 -0
  461. package/src/targets.test.ts +367 -0
  462. package/src/targets.ts +12 -0
  463. package/src/test-http-helpers.ts +10 -0
  464. package/src/test-support/component-runtime.ts +190 -0
  465. package/src/test-support/config.ts +7 -0
  466. package/src/test-support/configured-binding-runtime.ts +29 -0
  467. package/src/test-support/partial-channel.ts +26 -0
  468. package/src/test-support/provider.test-support.ts +545 -0
  469. package/src/token.test.ts +107 -0
  470. package/src/token.ts +60 -0
  471. package/src/ui-colors.ts +27 -0
  472. package/src/ui.ts +20 -0
  473. package/src/voice/access.test.ts +217 -0
  474. package/src/voice/access.ts +124 -0
  475. package/src/voice/audio.ts +173 -0
  476. package/src/voice/capture-state.test.ts +48 -0
  477. package/src/voice/capture-state.ts +120 -0
  478. package/src/voice/command.test.ts +164 -0
  479. package/src/voice/command.ts +283 -0
  480. package/src/voice/config.ts +8 -0
  481. package/src/voice/manager.e2e.test.ts +928 -0
  482. package/src/voice/manager.ready-listener.test.ts +37 -0
  483. package/src/voice/manager.runtime.ts +11 -0
  484. package/src/voice/manager.ts +691 -0
  485. package/src/voice/prompt.test.ts +16 -0
  486. package/src/voice/prompt.ts +17 -0
  487. package/src/voice/receive-recovery.test.ts +79 -0
  488. package/src/voice/receive-recovery.ts +159 -0
  489. package/src/voice/sanitize.test.ts +34 -0
  490. package/src/voice/sanitize.ts +32 -0
  491. package/src/voice/sdk-runtime.ts +14 -0
  492. package/src/voice/segment.ts +156 -0
  493. package/src/voice/session.ts +50 -0
  494. package/src/voice/speaker-context.ts +127 -0
  495. package/src/voice/tts.ts +125 -0
  496. package/src/voice-message.test.ts +234 -0
  497. package/src/voice-message.ts +444 -0
  498. package/subagent-hooks-api.ts +27 -0
  499. package/test-api.ts +4 -0
  500. package/thread-binding-api.ts +1 -0
  501. package/timeouts.ts +6 -0
  502. package/tsconfig.json +16 -0
@@ -0,0 +1,91 @@
1
+ import { createSubsystemLogger, formatDurationSeconds } from "openclaw/plugin-sdk/runtime-env";
2
+
3
+ export type DiscordListenerLogger = ReturnType<
4
+ typeof import("openclaw/plugin-sdk/runtime-env").createSubsystemLogger
5
+ >;
6
+
7
+ const DISCORD_SLOW_LISTENER_THRESHOLD_MS = 30_000;
8
+
9
+ export const discordEventQueueLog = createSubsystemLogger("discord/event-queue");
10
+
11
+ function formatListenerContextValue(value: unknown): string | null {
12
+ if (value === undefined || value === null) {
13
+ return null;
14
+ }
15
+ if (typeof value === "string") {
16
+ const trimmed = value.trim();
17
+ return trimmed.length > 0 ? trimmed : null;
18
+ }
19
+ if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
20
+ return String(value);
21
+ }
22
+ return null;
23
+ }
24
+
25
+ function formatListenerContextSuffix(context?: Record<string, unknown>): string {
26
+ if (!context) {
27
+ return "";
28
+ }
29
+ const entries = Object.entries(context).flatMap(([key, value]) => {
30
+ const formatted = formatListenerContextValue(value);
31
+ return formatted ? [`${key}=${formatted}`] : [];
32
+ });
33
+ if (entries.length === 0) {
34
+ return "";
35
+ }
36
+ return ` (${entries.join(" ")})`;
37
+ }
38
+
39
+ function logSlowDiscordListener(params: {
40
+ logger: DiscordListenerLogger | undefined;
41
+ listener: string;
42
+ event: string;
43
+ durationMs: number;
44
+ context?: Record<string, unknown>;
45
+ }) {
46
+ if (params.durationMs < DISCORD_SLOW_LISTENER_THRESHOLD_MS) {
47
+ return;
48
+ }
49
+ const duration = formatDurationSeconds(params.durationMs, {
50
+ decimals: 1,
51
+ unit: "seconds",
52
+ });
53
+ const message = `Slow listener detected: ${params.listener} took ${duration} for event ${params.event}`;
54
+ const logger = params.logger ?? discordEventQueueLog;
55
+ logger.warn("Slow listener detected", {
56
+ listener: params.listener,
57
+ event: params.event,
58
+ durationMs: params.durationMs,
59
+ duration,
60
+ ...params.context,
61
+ consoleMessage: `${message}${formatListenerContextSuffix(params.context)}`,
62
+ });
63
+ }
64
+
65
+ export async function runDiscordListenerWithSlowLog(params: {
66
+ logger: DiscordListenerLogger | undefined;
67
+ listener: string;
68
+ event: string;
69
+ run: () => Promise<void>;
70
+ context?: Record<string, unknown>;
71
+ onError?: (err: unknown) => void;
72
+ }) {
73
+ const startedAt = Date.now();
74
+ try {
75
+ await params.run();
76
+ } catch (err) {
77
+ if (params.onError) {
78
+ params.onError(err);
79
+ return;
80
+ }
81
+ throw err;
82
+ } finally {
83
+ logSlowDiscordListener({
84
+ logger: params.logger,
85
+ listener: params.listener,
86
+ event: params.event,
87
+ durationMs: Date.now() - startedAt,
88
+ context: params.context,
89
+ });
90
+ }
91
+ }
@@ -0,0 +1,610 @@
1
+ import type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";
2
+ import { resolveAgentRoute } from "openclaw/plugin-sdk/routing";
3
+ import { danger, logVerbose } from "openclaw/plugin-sdk/runtime-env";
4
+ import {
5
+ readStoreAllowFromForDmPolicy,
6
+ resolveDmGroupAccessWithLists,
7
+ } from "openclaw/plugin-sdk/security-runtime";
8
+ import { enqueueSystemEvent } from "openclaw/plugin-sdk/system-event-runtime";
9
+ import {
10
+ ChannelType,
11
+ type Client,
12
+ MessageReactionAddListener,
13
+ MessageReactionRemoveListener,
14
+ type User,
15
+ } from "../internal/discord.js";
16
+ import {
17
+ isDiscordGroupAllowedByPolicy,
18
+ normalizeDiscordAllowList,
19
+ normalizeDiscordSlug,
20
+ resolveDiscordAllowListMatch,
21
+ resolveDiscordChannelConfigWithFallback,
22
+ resolveDiscordGuildEntry,
23
+ resolveDiscordMemberAccessState,
24
+ resolveGroupDmAllow,
25
+ shouldEmitDiscordReactionNotification,
26
+ } from "./allow-list.js";
27
+ import { formatDiscordReactionEmoji, formatDiscordUserTag } from "./format.js";
28
+ import { runDiscordListenerWithSlowLog, type DiscordListenerLogger } from "./listeners.queue.js";
29
+ import { resolveFetchedDiscordThreadLikeChannelContext } from "./thread-channel-context.js";
30
+
31
+ type LoadedConfig = OpenClawConfig;
32
+ type RuntimeEnv = import("openclaw/plugin-sdk/runtime-env").RuntimeEnv;
33
+
34
+ type DiscordReactionEvent = Parameters<MessageReactionAddListener["handle"]>[0];
35
+
36
+ type DiscordReactionListenerParams = {
37
+ cfg: LoadedConfig;
38
+ runtime: RuntimeEnv;
39
+ logger: DiscordListenerLogger;
40
+ onEvent?: () => void;
41
+ } & DiscordReactionRoutingParams;
42
+
43
+ type DiscordReactionRoutingParams = {
44
+ accountId: string;
45
+ botUserId?: string;
46
+ dmEnabled: boolean;
47
+ groupDmEnabled: boolean;
48
+ groupDmChannels: string[];
49
+ dmPolicy: "open" | "pairing" | "allowlist" | "disabled";
50
+ allowFrom: string[];
51
+ groupPolicy: "open" | "allowlist" | "disabled";
52
+ allowNameMatching: boolean;
53
+ guildEntries?: Record<string, import("./allow-list.js").DiscordGuildEntryResolved>;
54
+ };
55
+
56
+ type DiscordReactionMode = "off" | "own" | "all" | "allowlist";
57
+ type DiscordReactionChannelConfig = ReturnType<typeof resolveDiscordChannelConfigWithFallback>;
58
+ type DiscordReactionIngressAccess = Awaited<ReturnType<typeof authorizeDiscordReactionIngress>>;
59
+ type DiscordFetchedReactionMessage = { author?: User | null } | null;
60
+
61
+ export class DiscordReactionListener extends MessageReactionAddListener {
62
+ constructor(private params: DiscordReactionListenerParams) {
63
+ super();
64
+ }
65
+
66
+ async handle(data: DiscordReactionEvent, client: Client) {
67
+ this.params.onEvent?.();
68
+ await runDiscordReactionHandler({
69
+ data,
70
+ client,
71
+ action: "added",
72
+ handlerParams: this.params,
73
+ listener: this.constructor.name,
74
+ event: this.type,
75
+ });
76
+ }
77
+ }
78
+
79
+ export class DiscordReactionRemoveListener extends MessageReactionRemoveListener {
80
+ constructor(private params: DiscordReactionListenerParams) {
81
+ super();
82
+ }
83
+
84
+ async handle(data: DiscordReactionEvent, client: Client) {
85
+ this.params.onEvent?.();
86
+ await runDiscordReactionHandler({
87
+ data,
88
+ client,
89
+ action: "removed",
90
+ handlerParams: this.params,
91
+ listener: this.constructor.name,
92
+ event: this.type,
93
+ });
94
+ }
95
+ }
96
+
97
+ async function runDiscordReactionHandler(params: {
98
+ data: DiscordReactionEvent;
99
+ client: Client;
100
+ action: "added" | "removed";
101
+ handlerParams: DiscordReactionListenerParams;
102
+ listener: string;
103
+ event: string;
104
+ }): Promise<void> {
105
+ await runDiscordListenerWithSlowLog({
106
+ logger: params.handlerParams.logger,
107
+ listener: params.listener,
108
+ event: params.event,
109
+ run: async () =>
110
+ handleDiscordReactionEvent({
111
+ data: params.data,
112
+ client: params.client,
113
+ action: params.action,
114
+ cfg: params.handlerParams.cfg,
115
+ accountId: params.handlerParams.accountId,
116
+ botUserId: params.handlerParams.botUserId,
117
+ dmEnabled: params.handlerParams.dmEnabled,
118
+ groupDmEnabled: params.handlerParams.groupDmEnabled,
119
+ groupDmChannels: params.handlerParams.groupDmChannels,
120
+ dmPolicy: params.handlerParams.dmPolicy,
121
+ allowFrom: params.handlerParams.allowFrom,
122
+ groupPolicy: params.handlerParams.groupPolicy,
123
+ allowNameMatching: params.handlerParams.allowNameMatching,
124
+ guildEntries: params.handlerParams.guildEntries,
125
+ logger: params.handlerParams.logger,
126
+ }),
127
+ });
128
+ }
129
+
130
+ type DiscordReactionIngressAuthorizationParams = {
131
+ accountId: string;
132
+ user: User;
133
+ memberRoleIds: string[];
134
+ isDirectMessage: boolean;
135
+ isGroupDm: boolean;
136
+ isGuildMessage: boolean;
137
+ channelId: string;
138
+ channelName?: string;
139
+ channelSlug: string;
140
+ dmEnabled: boolean;
141
+ groupDmEnabled: boolean;
142
+ groupDmChannels: string[];
143
+ dmPolicy: "open" | "pairing" | "allowlist" | "disabled";
144
+ allowFrom: string[];
145
+ groupPolicy: "open" | "allowlist" | "disabled";
146
+ allowNameMatching: boolean;
147
+ guildInfo: import("./allow-list.js").DiscordGuildEntryResolved | null;
148
+ channelConfig?: import("./allow-list.js").DiscordChannelConfigResolved | null;
149
+ };
150
+
151
+ async function authorizeDiscordReactionIngress(
152
+ params: DiscordReactionIngressAuthorizationParams,
153
+ ): Promise<{ allowed: true } | { allowed: false; reason: string }> {
154
+ if (params.isDirectMessage && !params.dmEnabled) {
155
+ return { allowed: false, reason: "dm-disabled" };
156
+ }
157
+ if (params.isGroupDm && !params.groupDmEnabled) {
158
+ return { allowed: false, reason: "group-dm-disabled" };
159
+ }
160
+ if (params.isDirectMessage) {
161
+ const storeAllowFrom = await readStoreAllowFromForDmPolicy({
162
+ provider: "discord",
163
+ accountId: params.accountId,
164
+ dmPolicy: params.dmPolicy,
165
+ });
166
+ const access = resolveDmGroupAccessWithLists({
167
+ isGroup: false,
168
+ dmPolicy: params.dmPolicy,
169
+ groupPolicy: params.groupPolicy,
170
+ allowFrom: params.allowFrom,
171
+ groupAllowFrom: [],
172
+ storeAllowFrom,
173
+ isSenderAllowed: (allowEntries) => {
174
+ const allowList = normalizeDiscordAllowList(allowEntries, ["discord:", "user:", "pk:"]);
175
+ const allowMatch = allowList
176
+ ? resolveDiscordAllowListMatch({
177
+ allowList,
178
+ candidate: {
179
+ id: params.user.id,
180
+ name: params.user.username,
181
+ tag: formatDiscordUserTag(params.user),
182
+ },
183
+ allowNameMatching: params.allowNameMatching,
184
+ })
185
+ : { allowed: false };
186
+ return allowMatch.allowed;
187
+ },
188
+ });
189
+ if (access.decision !== "allow") {
190
+ return { allowed: false, reason: access.reason };
191
+ }
192
+ }
193
+ if (
194
+ params.isGroupDm &&
195
+ !resolveGroupDmAllow({
196
+ channels: params.groupDmChannels,
197
+ channelId: params.channelId,
198
+ channelName: params.channelName,
199
+ channelSlug: params.channelSlug,
200
+ })
201
+ ) {
202
+ return { allowed: false, reason: "group-dm-not-allowlisted" };
203
+ }
204
+ if (!params.isGuildMessage) {
205
+ return { allowed: true };
206
+ }
207
+ const channelAllowlistConfigured =
208
+ Boolean(params.guildInfo?.channels) && Object.keys(params.guildInfo?.channels ?? {}).length > 0;
209
+ const channelAllowed = params.channelConfig?.allowed !== false;
210
+ if (
211
+ !isDiscordGroupAllowedByPolicy({
212
+ groupPolicy: params.groupPolicy,
213
+ guildAllowlisted: Boolean(params.guildInfo),
214
+ channelAllowlistConfigured,
215
+ channelAllowed,
216
+ })
217
+ ) {
218
+ return { allowed: false, reason: "guild-policy" };
219
+ }
220
+ if (params.channelConfig?.allowed === false) {
221
+ return { allowed: false, reason: "guild-channel-denied" };
222
+ }
223
+ const { hasAccessRestrictions, memberAllowed } = resolveDiscordMemberAccessState({
224
+ channelConfig: params.channelConfig,
225
+ guildInfo: params.guildInfo,
226
+ memberRoleIds: params.memberRoleIds,
227
+ sender: {
228
+ id: params.user.id,
229
+ name: params.user.username,
230
+ tag: formatDiscordUserTag(params.user),
231
+ },
232
+ allowNameMatching: params.allowNameMatching,
233
+ });
234
+ if (hasAccessRestrictions && !memberAllowed) {
235
+ return { allowed: false, reason: "guild-member-denied" };
236
+ }
237
+ return { allowed: true };
238
+ }
239
+
240
+ async function handleDiscordThreadReactionNotification(params: {
241
+ reactionMode: DiscordReactionMode;
242
+ message: DiscordReactionEvent["message"];
243
+ parentId?: string;
244
+ resolveThreadChannelAccess: () => Promise<{
245
+ access: DiscordReactionIngressAccess;
246
+ channelConfig: DiscordReactionChannelConfig;
247
+ }>;
248
+ shouldNotifyReaction: (options: {
249
+ mode: DiscordReactionMode;
250
+ messageAuthorId?: string;
251
+ channelConfig?: DiscordReactionChannelConfig;
252
+ }) => boolean;
253
+ resolveReactionBase: () => { baseText: string; contextKey: string };
254
+ emitReaction: (text: string, parentPeerId?: string) => void;
255
+ emitReactionWithAuthor: (message: DiscordFetchedReactionMessage) => void;
256
+ }) {
257
+ if (params.reactionMode === "off") {
258
+ return;
259
+ }
260
+
261
+ if (params.reactionMode === "all" || params.reactionMode === "allowlist") {
262
+ const { access, channelConfig } = await params.resolveThreadChannelAccess();
263
+ if (
264
+ !access.allowed ||
265
+ !params.shouldNotifyReaction({ mode: params.reactionMode, channelConfig })
266
+ ) {
267
+ return;
268
+ }
269
+
270
+ const { baseText } = params.resolveReactionBase();
271
+ params.emitReaction(baseText, params.parentId);
272
+ return;
273
+ }
274
+
275
+ const message = await params.message.fetch().catch(() => null);
276
+ const { access, channelConfig } = await params.resolveThreadChannelAccess();
277
+ const messageAuthorId = message?.author?.id ?? undefined;
278
+ if (
279
+ !access.allowed ||
280
+ !params.shouldNotifyReaction({
281
+ mode: params.reactionMode,
282
+ messageAuthorId,
283
+ channelConfig,
284
+ })
285
+ ) {
286
+ return;
287
+ }
288
+
289
+ params.emitReactionWithAuthor(message);
290
+ }
291
+
292
+ async function handleDiscordChannelReactionNotification(params: {
293
+ isGuildMessage: boolean;
294
+ reactionMode: DiscordReactionMode;
295
+ message: DiscordReactionEvent["message"];
296
+ channelConfig: DiscordReactionChannelConfig;
297
+ parentId?: string;
298
+ authorizeReactionIngressForChannel: (
299
+ channelConfig: DiscordReactionChannelConfig,
300
+ ) => Promise<DiscordReactionIngressAccess>;
301
+ shouldNotifyReaction: (options: {
302
+ mode: DiscordReactionMode;
303
+ messageAuthorId?: string;
304
+ channelConfig?: DiscordReactionChannelConfig;
305
+ }) => boolean;
306
+ resolveReactionBase: () => { baseText: string; contextKey: string };
307
+ emitReaction: (text: string, parentPeerId?: string) => void;
308
+ emitReactionWithAuthor: (message: DiscordFetchedReactionMessage) => void;
309
+ }) {
310
+ if (params.isGuildMessage) {
311
+ const access = await params.authorizeReactionIngressForChannel(params.channelConfig);
312
+ if (!access.allowed) {
313
+ return;
314
+ }
315
+ }
316
+
317
+ if (params.reactionMode === "off") {
318
+ return;
319
+ }
320
+
321
+ if (params.reactionMode === "all" || params.reactionMode === "allowlist") {
322
+ if (
323
+ !params.shouldNotifyReaction({
324
+ mode: params.reactionMode,
325
+ channelConfig: params.channelConfig,
326
+ })
327
+ ) {
328
+ return;
329
+ }
330
+
331
+ const { baseText } = params.resolveReactionBase();
332
+ params.emitReaction(baseText, params.parentId);
333
+ return;
334
+ }
335
+
336
+ const message = await params.message.fetch().catch(() => null);
337
+ const messageAuthorId = message?.author?.id ?? undefined;
338
+ if (
339
+ !params.shouldNotifyReaction({
340
+ mode: params.reactionMode,
341
+ messageAuthorId,
342
+ channelConfig: params.channelConfig,
343
+ })
344
+ ) {
345
+ return;
346
+ }
347
+
348
+ params.emitReactionWithAuthor(message);
349
+ }
350
+
351
+ function hasDiscordGuildChannelOverrides(
352
+ guildInfo: import("./allow-list.js").DiscordGuildEntryResolved | null,
353
+ ) {
354
+ return Boolean(guildInfo?.channels && Object.keys(guildInfo.channels).length > 0);
355
+ }
356
+
357
+ function shouldSkipGuildReactionBeforeChannelFetch(params: {
358
+ reactionMode: DiscordReactionMode;
359
+ guildInfo: import("./allow-list.js").DiscordGuildEntryResolved | null;
360
+ groupPolicy: DiscordReactionRoutingParams["groupPolicy"];
361
+ memberRoleIds: string[];
362
+ user: User;
363
+ botUserId?: string;
364
+ allowNameMatching: boolean;
365
+ }) {
366
+ if (params.reactionMode === "off" || params.groupPolicy === "disabled") {
367
+ return true;
368
+ }
369
+ if (params.reactionMode !== "allowlist") {
370
+ return false;
371
+ }
372
+ if (hasDiscordGuildChannelOverrides(params.guildInfo)) {
373
+ return false;
374
+ }
375
+ return !shouldEmitDiscordReactionNotification({
376
+ mode: params.reactionMode,
377
+ botId: params.botUserId,
378
+ userId: params.user.id,
379
+ userName: params.user.username,
380
+ userTag: formatDiscordUserTag(params.user),
381
+ guildInfo: params.guildInfo,
382
+ memberRoleIds: params.memberRoleIds,
383
+ allowNameMatching: params.allowNameMatching,
384
+ });
385
+ }
386
+
387
+ async function handleDiscordReactionEvent(
388
+ params: {
389
+ data: DiscordReactionEvent;
390
+ client: Client;
391
+ action: "added" | "removed";
392
+ cfg: LoadedConfig;
393
+ logger: DiscordListenerLogger;
394
+ } & DiscordReactionRoutingParams,
395
+ ) {
396
+ try {
397
+ const { data, client, action, botUserId, guildEntries } = params;
398
+ if (!("user" in data)) {
399
+ return;
400
+ }
401
+ const user = data.user;
402
+ if (!user || user.bot) {
403
+ return;
404
+ }
405
+ if (botUserId && user.id === botUserId) {
406
+ return;
407
+ }
408
+
409
+ const isGuildMessage = Boolean(data.guild_id);
410
+ const guildInfo = isGuildMessage
411
+ ? resolveDiscordGuildEntry({
412
+ guild: data.guild ?? undefined,
413
+ guildId: data.guild_id ?? undefined,
414
+ guildEntries,
415
+ })
416
+ : null;
417
+ if (isGuildMessage && guildEntries && Object.keys(guildEntries).length > 0 && !guildInfo) {
418
+ return;
419
+ }
420
+ const memberRoleIds = Array.isArray(data.rawMember?.roles)
421
+ ? data.rawMember.roles.map((roleId: string) => roleId)
422
+ : [];
423
+ const reactionMode = guildInfo?.reactionNotifications ?? "own";
424
+ if (
425
+ isGuildMessage &&
426
+ shouldSkipGuildReactionBeforeChannelFetch({
427
+ reactionMode,
428
+ guildInfo,
429
+ groupPolicy: params.groupPolicy,
430
+ memberRoleIds,
431
+ user,
432
+ botUserId,
433
+ allowNameMatching: params.allowNameMatching,
434
+ })
435
+ ) {
436
+ return;
437
+ }
438
+
439
+ const channel = await client.fetchChannel(data.channel_id);
440
+ if (!channel) {
441
+ return;
442
+ }
443
+ const channelContext = await resolveFetchedDiscordThreadLikeChannelContext({
444
+ client,
445
+ channel,
446
+ channelIdFallback: data.channel_id,
447
+ });
448
+ const channelName = channelContext.channelName;
449
+ const channelSlug = channelContext.channelSlug;
450
+ const channelType = channelContext.channelType;
451
+ const isDirectMessage = channelType === ChannelType.DM;
452
+ const isGroupDm = channelType === ChannelType.GroupDM;
453
+ const isThreadChannel = channelContext.isThreadChannel;
454
+ const reactionIngressBase: Omit<DiscordReactionIngressAuthorizationParams, "channelConfig"> = {
455
+ accountId: params.accountId,
456
+ user,
457
+ memberRoleIds,
458
+ isDirectMessage,
459
+ isGroupDm,
460
+ isGuildMessage,
461
+ channelId: data.channel_id,
462
+ channelName,
463
+ channelSlug,
464
+ dmEnabled: params.dmEnabled,
465
+ groupDmEnabled: params.groupDmEnabled,
466
+ groupDmChannels: params.groupDmChannels,
467
+ dmPolicy: params.dmPolicy,
468
+ allowFrom: params.allowFrom,
469
+ groupPolicy: params.groupPolicy,
470
+ allowNameMatching: params.allowNameMatching,
471
+ guildInfo,
472
+ };
473
+ if (!isGuildMessage) {
474
+ const ingressAccess = await authorizeDiscordReactionIngress(reactionIngressBase);
475
+ if (!ingressAccess.allowed) {
476
+ logVerbose(`discord reaction blocked sender=${user.id} (reason=${ingressAccess.reason})`);
477
+ return;
478
+ }
479
+ }
480
+ const parentId = isThreadChannel ? channelContext.threadParentId : channelContext.parentId;
481
+ const parentName = isThreadChannel ? channelContext.threadParentName : undefined;
482
+ const parentSlug = isThreadChannel ? channelContext.threadParentSlug : "";
483
+ let reactionBase: { baseText: string; contextKey: string } | null = null;
484
+ const resolveReactionBase = () => {
485
+ if (reactionBase) {
486
+ return reactionBase;
487
+ }
488
+ const emojiLabel = formatDiscordReactionEmoji(data.emoji);
489
+ const actorLabel = formatDiscordUserTag(user);
490
+ const guildSlug =
491
+ guildInfo?.slug ||
492
+ (data.guild?.name
493
+ ? normalizeDiscordSlug(data.guild.name)
494
+ : (data.guild_id ?? (isGroupDm ? "group-dm" : "dm")));
495
+ const channelLabel = channelSlug
496
+ ? `#${channelSlug}`
497
+ : channelName
498
+ ? `#${normalizeDiscordSlug(channelName)}`
499
+ : `#${data.channel_id}`;
500
+ const baseText = `Discord reaction ${action}: ${emojiLabel} by ${actorLabel} on ${guildSlug} ${channelLabel} msg ${data.message_id}`;
501
+ const contextKey = `discord:reaction:${action}:${data.message_id}:${user.id}:${emojiLabel}`;
502
+ reactionBase = { baseText, contextKey };
503
+ return reactionBase;
504
+ };
505
+ const emitReaction = (text: string, parentPeerId?: string) => {
506
+ const { contextKey } = resolveReactionBase();
507
+ const route = resolveAgentRoute({
508
+ cfg: params.cfg,
509
+ channel: "discord",
510
+ accountId: params.accountId,
511
+ guildId: data.guild_id ?? undefined,
512
+ memberRoleIds,
513
+ peer: {
514
+ kind: isDirectMessage ? "direct" : isGroupDm ? "group" : "channel",
515
+ id: isDirectMessage ? user.id : data.channel_id,
516
+ },
517
+ parentPeer: parentPeerId ? { kind: "channel", id: parentPeerId } : undefined,
518
+ });
519
+ enqueueSystemEvent(text, {
520
+ sessionKey: route.sessionKey,
521
+ contextKey,
522
+ });
523
+ };
524
+ const shouldNotifyReaction = (options: {
525
+ mode: DiscordReactionMode;
526
+ messageAuthorId?: string;
527
+ channelConfig?: DiscordReactionChannelConfig;
528
+ }) =>
529
+ shouldEmitDiscordReactionNotification({
530
+ mode: options.mode,
531
+ botId: botUserId,
532
+ messageAuthorId: options.messageAuthorId,
533
+ userId: user.id,
534
+ userName: user.username,
535
+ userTag: formatDiscordUserTag(user),
536
+ channelConfig: options.channelConfig,
537
+ guildInfo,
538
+ memberRoleIds,
539
+ allowNameMatching: params.allowNameMatching,
540
+ });
541
+ const emitReactionWithAuthor = (message: DiscordFetchedReactionMessage) => {
542
+ const { baseText } = resolveReactionBase();
543
+ const authorLabel = message?.author ? formatDiscordUserTag(message.author) : undefined;
544
+ const text = authorLabel ? `${baseText} from ${authorLabel}` : baseText;
545
+ emitReaction(text, parentId);
546
+ };
547
+ const resolveThreadChannelConfig = () =>
548
+ resolveDiscordChannelConfigWithFallback({
549
+ guildInfo,
550
+ channelId: data.channel_id,
551
+ channelName,
552
+ channelSlug,
553
+ parentId,
554
+ parentName,
555
+ parentSlug,
556
+ scope: "thread",
557
+ });
558
+ const authorizeReactionIngressForChannel = async (
559
+ channelConfig: DiscordReactionChannelConfig,
560
+ ) =>
561
+ await authorizeDiscordReactionIngress({
562
+ ...reactionIngressBase,
563
+ channelConfig,
564
+ });
565
+ const resolveThreadChannelAccess = async () => {
566
+ const channelConfig = resolveThreadChannelConfig();
567
+ const access = await authorizeReactionIngressForChannel(channelConfig);
568
+ return { access, channelConfig };
569
+ };
570
+
571
+ if (isThreadChannel) {
572
+ await handleDiscordThreadReactionNotification({
573
+ reactionMode,
574
+ message: data.message,
575
+ parentId,
576
+ resolveThreadChannelAccess,
577
+ shouldNotifyReaction,
578
+ resolveReactionBase,
579
+ emitReaction,
580
+ emitReactionWithAuthor,
581
+ });
582
+ return;
583
+ }
584
+
585
+ const channelConfig = resolveDiscordChannelConfigWithFallback({
586
+ guildInfo,
587
+ channelId: data.channel_id,
588
+ channelName,
589
+ channelSlug,
590
+ parentId,
591
+ parentName,
592
+ parentSlug,
593
+ scope: "channel",
594
+ });
595
+ await handleDiscordChannelReactionNotification({
596
+ isGuildMessage,
597
+ reactionMode,
598
+ message: data.message,
599
+ channelConfig,
600
+ parentId,
601
+ authorizeReactionIngressForChannel,
602
+ shouldNotifyReaction,
603
+ resolveReactionBase,
604
+ emitReaction,
605
+ emitReactionWithAuthor,
606
+ });
607
+ } catch (err) {
608
+ params.logger.error(danger(`discord reaction handler failed: ${String(err)}`));
609
+ }
610
+ }