@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,700 @@
1
+ import { ApplicationCommandOptionType } from "discord-api-types/v10";
2
+ import { resolveNativeCommandSessionTargets } from "openclaw/plugin-sdk/command-auth-native";
3
+ import type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";
4
+ import { buildPairingReply } from "openclaw/plugin-sdk/conversation-runtime";
5
+ import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
6
+ import { getAgentScopedMediaLocalRoots } from "openclaw/plugin-sdk/media-runtime";
7
+ import {
8
+ buildCommandTextFromArgs,
9
+ findCommandByNativeName,
10
+ parseCommandArgs,
11
+ resolveCommandArgMenu,
12
+ serializeCommandArgs,
13
+ type ChatCommandDefinition,
14
+ type NativeCommandSpec,
15
+ } from "openclaw/plugin-sdk/native-command-registry";
16
+ import { resolveChunkMode, resolveTextChunkLimit } from "openclaw/plugin-sdk/reply-chunking";
17
+ import { createSubsystemLogger, logVerbose } from "openclaw/plugin-sdk/runtime-env";
18
+ import { resolveOpenProviderRuntimeGroupPolicy } from "openclaw/plugin-sdk/runtime-group-policy";
19
+ import {
20
+ resolveDiscordAccountAllowFrom,
21
+ resolveDiscordAccountDmPolicy,
22
+ resolveDiscordMaxLinesPerMessage,
23
+ } from "../accounts.js";
24
+ import {
25
+ Button,
26
+ Command,
27
+ StringSelectMenu,
28
+ type ButtonInteraction,
29
+ type CommandInteraction,
30
+ type CommandOptions,
31
+ type StringSelectMenuInteraction,
32
+ } from "../internal/discord.js";
33
+ import {
34
+ resolveDiscordChannelConfigWithFallback,
35
+ resolveDiscordChannelPolicyCommandAuthorizer,
36
+ resolveDiscordGuildEntry,
37
+ resolveDiscordOwnerAccess,
38
+ } from "./allow-list.js";
39
+ import { resolveDiscordChannelTopicSafe } from "./channel-access.js";
40
+ import { resolveDiscordDmCommandAccess } from "./dm-command-auth.js";
41
+ import { handleDiscordDmCommandDecision } from "./dm-command-decision.js";
42
+ import { dispatchDiscordNativeAgentReply } from "./native-command-agent-reply.js";
43
+ import {
44
+ resolveDiscordGuildNativeCommandAuthorized,
45
+ resolveDiscordNativeAutocompleteAuthorized,
46
+ resolveDiscordNativeCommandAllowlistAccess,
47
+ resolveDiscordNativeGroupDmAccess,
48
+ } from "./native-command-auth.js";
49
+ import {
50
+ shouldBypassConfiguredAcpEnsure,
51
+ shouldBypassConfiguredAcpGuildGuards,
52
+ } from "./native-command-bypass.js";
53
+ import { buildDiscordNativeCommandContext } from "./native-command-context.js";
54
+ import type { DispatchDiscordCommandInteractionResult } from "./native-command-dispatch.js";
55
+ import {
56
+ DISCORD_EMPTY_VISIBLE_REPLY_WARNING,
57
+ deliverDiscordInteractionReply,
58
+ hasRenderableReplyPayload,
59
+ safeDiscordInteractionCall,
60
+ } from "./native-command-reply.js";
61
+ import { maybeDeliverDiscordDirectStatus } from "./native-command-status.js";
62
+ import {
63
+ buildDiscordCommandArgMenu,
64
+ createDiscordCommandArgFallbackButton as createDiscordCommandArgFallbackButtonUi,
65
+ createDiscordModelPickerFallbackButton as createDiscordModelPickerFallbackButtonUi,
66
+ createDiscordModelPickerFallbackSelect as createDiscordModelPickerFallbackSelectUi,
67
+ replyWithDiscordModelPickerProviders,
68
+ resolveDiscordNativeChoiceContext,
69
+ shouldOpenDiscordModelPickerFromCommand,
70
+ type DiscordCommandArgContext,
71
+ type DiscordModelPickerContext,
72
+ } from "./native-command-ui.js";
73
+ import { createNativeCommandDefinition, readDiscordCommandArgs } from "./native-command.args.js";
74
+ import {
75
+ buildDiscordCommandOptions,
76
+ truncateDiscordCommandDescriptionLocalizations,
77
+ truncateDiscordCommandDescription,
78
+ } from "./native-command.options.js";
79
+ import { nativeCommandRuntime } from "./native-command.runtime.js";
80
+ import type { DiscordCommandArgs, DiscordConfig } from "./native-command.types.js";
81
+ import { resolveDiscordNativeInteractionChannelContext } from "./native-interaction-channel-context.js";
82
+ import { resolveDiscordSenderIdentity } from "./sender-identity.js";
83
+ import type { ThreadBindingManager } from "./thread-bindings.js";
84
+
85
+ const log = createSubsystemLogger("discord/native-command");
86
+ export { __testing } from "./native-command.runtime.js";
87
+
88
+ export function createDiscordNativeCommand(params: {
89
+ command: NativeCommandSpec;
90
+ cfg: OpenClawConfig;
91
+ discordConfig: DiscordConfig;
92
+ accountId: string;
93
+ sessionPrefix: string;
94
+ ephemeralDefault: boolean;
95
+ threadBindings: ThreadBindingManager;
96
+ }): Command {
97
+ const {
98
+ command,
99
+ cfg,
100
+ discordConfig,
101
+ accountId,
102
+ sessionPrefix,
103
+ ephemeralDefault,
104
+ threadBindings,
105
+ } = params;
106
+ const fallbackCommandDefinition = createNativeCommandDefinition(command);
107
+ const commandDefinition =
108
+ nativeCommandRuntime.matchPluginCommand(`/${command.name}`) !== null
109
+ ? fallbackCommandDefinition
110
+ : (findCommandByNativeName(command.name, "discord", {
111
+ includeBundledChannelFallback: false,
112
+ }) ?? fallbackCommandDefinition);
113
+ const argDefinitions = commandDefinition.args ?? command.args;
114
+ const commandOptions = buildDiscordCommandOptions({
115
+ command: commandDefinition,
116
+ cfg,
117
+ authorizeChoiceContext: async (interaction) =>
118
+ await resolveDiscordNativeAutocompleteAuthorized({
119
+ interaction,
120
+ cfg,
121
+ discordConfig,
122
+ accountId,
123
+ }),
124
+ resolveChoiceContext: async (interaction) =>
125
+ resolveDiscordNativeChoiceContext({
126
+ interaction,
127
+ cfg,
128
+ accountId,
129
+ threadBindings,
130
+ }),
131
+ });
132
+ const options = commandOptions
133
+ ? (commandOptions satisfies CommandOptions)
134
+ : command.acceptsArgs
135
+ ? ([
136
+ {
137
+ name: "input",
138
+ description: "Command input",
139
+ type: ApplicationCommandOptionType.String,
140
+ required: false,
141
+ },
142
+ ] satisfies CommandOptions)
143
+ : undefined;
144
+
145
+ return new (class extends Command {
146
+ name = command.name;
147
+ description = truncateDiscordCommandDescription({
148
+ value: command.description,
149
+ label: `command:${command.name}`,
150
+ });
151
+ descriptionLocalizations = truncateDiscordCommandDescriptionLocalizations({
152
+ value: command.descriptionLocalizations,
153
+ label: `command:${command.name}`,
154
+ });
155
+ defer = false;
156
+ ephemeral = ephemeralDefault;
157
+ options = options;
158
+
159
+ async run(interaction: CommandInteraction) {
160
+ const deferred = await safeDiscordInteractionCall("interaction defer", () =>
161
+ interaction.defer({ ephemeral: this.ephemeral }),
162
+ );
163
+ if (deferred === null) {
164
+ return;
165
+ }
166
+ const commandArgs = argDefinitions?.length
167
+ ? readDiscordCommandArgs(interaction, argDefinitions)
168
+ : command.acceptsArgs
169
+ ? parseCommandArgs(commandDefinition, interaction.options.getString("input") ?? "")
170
+ : undefined;
171
+ const commandArgsWithRaw = commandArgs
172
+ ? ({
173
+ ...commandArgs,
174
+ raw: serializeCommandArgs(commandDefinition, commandArgs) ?? commandArgs.raw,
175
+ } satisfies DiscordCommandArgs)
176
+ : undefined;
177
+ const prompt = buildCommandTextFromArgs(commandDefinition, commandArgsWithRaw);
178
+ await dispatchDiscordCommandInteraction({
179
+ interaction,
180
+ prompt,
181
+ command: commandDefinition,
182
+ commandArgs: commandArgsWithRaw,
183
+ cfg,
184
+ discordConfig,
185
+ accountId,
186
+ sessionPrefix,
187
+ // Slash commands are deferred up front, so all later responses must use
188
+ // follow-up/edit semantics instead of the initial reply endpoint.
189
+ preferFollowUp: true,
190
+ threadBindings,
191
+ responseEphemeral: ephemeralDefault,
192
+ });
193
+ }
194
+ })();
195
+ }
196
+
197
+ async function dispatchDiscordCommandInteraction(params: {
198
+ interaction: CommandInteraction | ButtonInteraction | StringSelectMenuInteraction;
199
+ prompt: string;
200
+ command: ChatCommandDefinition;
201
+ commandArgs?: DiscordCommandArgs;
202
+ cfg: OpenClawConfig;
203
+ discordConfig: DiscordConfig;
204
+ accountId: string;
205
+ sessionPrefix: string;
206
+ preferFollowUp: boolean;
207
+ threadBindings: ThreadBindingManager;
208
+ responseEphemeral?: boolean;
209
+ suppressReplies?: boolean;
210
+ }): Promise<DispatchDiscordCommandInteractionResult> {
211
+ const {
212
+ interaction,
213
+ prompt,
214
+ command,
215
+ commandArgs,
216
+ cfg,
217
+ discordConfig,
218
+ accountId,
219
+ sessionPrefix,
220
+ preferFollowUp,
221
+ threadBindings,
222
+ responseEphemeral,
223
+ suppressReplies,
224
+ } = params;
225
+ const commandName = command.nativeName ?? command.key;
226
+ const respond = async (content: string, options?: { ephemeral?: boolean }) => {
227
+ const ephemeral = options?.ephemeral ?? responseEphemeral;
228
+ const payload = {
229
+ content,
230
+ ...(ephemeral !== undefined ? { ephemeral } : {}),
231
+ };
232
+ await safeDiscordInteractionCall("interaction reply", async () => {
233
+ if (preferFollowUp) {
234
+ await interaction.followUp(payload);
235
+ return;
236
+ }
237
+ await interaction.reply(payload);
238
+ });
239
+ };
240
+
241
+ const useAccessGroups = cfg.commands?.useAccessGroups !== false;
242
+ const user = interaction.user;
243
+ if (!user) {
244
+ return { accepted: false };
245
+ }
246
+ const sender = resolveDiscordSenderIdentity({ author: user, pluralkitInfo: null });
247
+ const channel = interaction.channel;
248
+ const {
249
+ isDirectMessage,
250
+ isGroupDm,
251
+ isThreadChannel,
252
+ channelName,
253
+ channelSlug,
254
+ rawChannelId,
255
+ threadParentId,
256
+ threadParentName,
257
+ threadParentSlug,
258
+ } = await resolveDiscordNativeInteractionChannelContext({
259
+ channel,
260
+ client: interaction.client,
261
+ hasGuild: Boolean(interaction.guild),
262
+ channelIdFallback: "",
263
+ });
264
+ const memberRoleIds = Array.isArray(interaction.rawData.member?.roles)
265
+ ? interaction.rawData.member.roles.map((roleId: string) => roleId)
266
+ : [];
267
+ const allowNameMatching = isDangerousNameMatchingEnabled(discordConfig);
268
+ const configuredDmAllowFrom =
269
+ resolveDiscordAccountAllowFrom({
270
+ cfg,
271
+ accountId,
272
+ }) ?? [];
273
+ const { ownerAllowList, ownerAllowed: ownerOk } = resolveDiscordOwnerAccess({
274
+ allowFrom: configuredDmAllowFrom,
275
+ sender: {
276
+ id: sender.id,
277
+ name: sender.name,
278
+ tag: sender.tag,
279
+ },
280
+ allowNameMatching,
281
+ });
282
+ const commandsAllowFromAccess = resolveDiscordNativeCommandAllowlistAccess({
283
+ cfg,
284
+ accountId,
285
+ sender: {
286
+ id: sender.id,
287
+ name: sender.name,
288
+ tag: sender.tag,
289
+ },
290
+ chatType: isDirectMessage
291
+ ? "direct"
292
+ : isThreadChannel
293
+ ? "thread"
294
+ : interaction.guild
295
+ ? "channel"
296
+ : "group",
297
+ conversationId: rawChannelId || undefined,
298
+ guildId: interaction.guild?.id,
299
+ });
300
+ const guildInfo = resolveDiscordGuildEntry({
301
+ guild: interaction.guild ?? undefined,
302
+ guildId: interaction.guild?.id ?? undefined,
303
+ guildEntries: discordConfig?.guilds,
304
+ });
305
+ const channelConfig = interaction.guild
306
+ ? resolveDiscordChannelConfigWithFallback({
307
+ guildInfo,
308
+ channelId: rawChannelId,
309
+ channelName,
310
+ channelSlug,
311
+ parentId: threadParentId,
312
+ parentName: threadParentName,
313
+ parentSlug: threadParentSlug,
314
+ scope: isThreadChannel ? "thread" : "channel",
315
+ })
316
+ : null;
317
+ let nativeRouteStatePromise:
318
+ | ReturnType<typeof nativeCommandRuntime.resolveDiscordNativeInteractionRouteState>
319
+ | undefined;
320
+ const getNativeRouteState = () =>
321
+ (nativeRouteStatePromise ??= nativeCommandRuntime.resolveDiscordNativeInteractionRouteState({
322
+ cfg,
323
+ accountId,
324
+ guildId: interaction.guild?.id ?? undefined,
325
+ memberRoleIds,
326
+ isDirectMessage,
327
+ isGroupDm,
328
+ directUserId: user.id,
329
+ conversationId: rawChannelId || "unknown",
330
+ parentConversationId: threadParentId,
331
+ threadBinding: isThreadChannel ? threadBindings.getByThreadId(rawChannelId) : undefined,
332
+ enforceConfiguredBindingReadiness: !shouldBypassConfiguredAcpEnsure(commandName),
333
+ }));
334
+ const canBypassConfiguredAcpGuildGuards = async () => {
335
+ if (!interaction.guild || !shouldBypassConfiguredAcpGuildGuards(commandName)) {
336
+ return false;
337
+ }
338
+ const routeState = await getNativeRouteState();
339
+ return (
340
+ routeState.effectiveRoute.matchedBy === "binding.channel" ||
341
+ routeState.boundSessionKey != null ||
342
+ routeState.configuredBinding != null ||
343
+ routeState.configuredRoute != null
344
+ );
345
+ };
346
+ if (channelConfig?.enabled === false && !(await canBypassConfiguredAcpGuildGuards())) {
347
+ await respond("This channel is disabled.");
348
+ return { accepted: false };
349
+ }
350
+ if (
351
+ interaction.guild &&
352
+ channelConfig?.allowed === false &&
353
+ !(await canBypassConfiguredAcpGuildGuards())
354
+ ) {
355
+ await respond("This channel is not allowed.");
356
+ return { accepted: false };
357
+ }
358
+ if (useAccessGroups && interaction.guild) {
359
+ const { groupPolicy } = resolveOpenProviderRuntimeGroupPolicy({
360
+ providerConfigPresent: cfg.channels?.discord !== undefined,
361
+ groupPolicy: discordConfig?.groupPolicy,
362
+ defaultGroupPolicy: cfg.channels?.defaults?.groupPolicy,
363
+ });
364
+ const policyAuthorizer = resolveDiscordChannelPolicyCommandAuthorizer({
365
+ groupPolicy,
366
+ guildInfo,
367
+ channelConfig,
368
+ });
369
+ if (!policyAuthorizer.allowed && !(await canBypassConfiguredAcpGuildGuards())) {
370
+ await respond("This channel is not allowed.");
371
+ return { accepted: false };
372
+ }
373
+ }
374
+ const dmEnabled = discordConfig?.dm?.enabled ?? true;
375
+ const dmPolicy = resolveDiscordAccountDmPolicy({ cfg, accountId }) ?? "pairing";
376
+ let commandAuthorized = true;
377
+ if (isDirectMessage) {
378
+ if (!dmEnabled || dmPolicy === "disabled") {
379
+ await respond("Discord DMs are disabled.");
380
+ return { accepted: false };
381
+ }
382
+ const dmAccess = await resolveDiscordDmCommandAccess({
383
+ accountId,
384
+ dmPolicy,
385
+ configuredAllowFrom: configuredDmAllowFrom,
386
+ sender: {
387
+ id: sender.id,
388
+ name: sender.name,
389
+ tag: sender.tag,
390
+ },
391
+ allowNameMatching,
392
+ useAccessGroups,
393
+ cfg,
394
+ rest: interaction.client.rest,
395
+ });
396
+ commandAuthorized = dmAccess.commandAuthorized;
397
+ if (dmAccess.decision !== "allow") {
398
+ await handleDiscordDmCommandDecision({
399
+ dmAccess,
400
+ accountId,
401
+ sender: {
402
+ id: user.id,
403
+ tag: sender.tag,
404
+ name: sender.name,
405
+ },
406
+ onPairingCreated: async (code) => {
407
+ await respond(
408
+ buildPairingReply({
409
+ channel: "discord",
410
+ idLine: `Your Discord user id: ${user.id}`,
411
+ code,
412
+ }),
413
+ { ephemeral: true },
414
+ );
415
+ },
416
+ onUnauthorized: async () => {
417
+ await respond("You are not authorized to use this command.", { ephemeral: true });
418
+ },
419
+ });
420
+ return { accepted: false };
421
+ }
422
+ }
423
+ const groupDmAccess = resolveDiscordNativeGroupDmAccess({
424
+ isGroupDm,
425
+ groupEnabled: discordConfig?.dm?.groupEnabled,
426
+ groupChannels: discordConfig?.dm?.groupChannels,
427
+ channelId: rawChannelId,
428
+ channelName,
429
+ channelSlug,
430
+ });
431
+ if (!groupDmAccess.allowed) {
432
+ await respond(
433
+ groupDmAccess.reason === "disabled"
434
+ ? "Discord group DMs are disabled."
435
+ : "This group DM is not allowed.",
436
+ );
437
+ return { accepted: false };
438
+ }
439
+ if (!isDirectMessage) {
440
+ commandAuthorized = resolveDiscordGuildNativeCommandAuthorized({
441
+ cfg,
442
+ discordConfig,
443
+ useAccessGroups,
444
+ commandsAllowFromAccess,
445
+ guildInfo,
446
+ channelConfig,
447
+ memberRoleIds,
448
+ sender,
449
+ allowNameMatching,
450
+ ownerAllowListConfigured: ownerAllowList != null,
451
+ ownerAllowed: ownerOk,
452
+ });
453
+ if (!commandAuthorized && !(await canBypassConfiguredAcpGuildGuards())) {
454
+ await respond("You are not authorized to use this command.", { ephemeral: true });
455
+ return { accepted: false };
456
+ }
457
+ }
458
+
459
+ const menuNeedsModelContext =
460
+ !(commandArgs?.raw && !commandArgs.values) &&
461
+ command.args?.some(
462
+ (arg) => typeof arg.choices === "function" && commandArgs?.values?.[arg.name] == null,
463
+ );
464
+ const menuModelContext = menuNeedsModelContext
465
+ ? await resolveDiscordNativeChoiceContext({
466
+ interaction: interaction as CommandInteraction,
467
+ cfg,
468
+ accountId,
469
+ threadBindings,
470
+ })
471
+ : null;
472
+ const menu = resolveCommandArgMenu({
473
+ command,
474
+ args: commandArgs,
475
+ cfg,
476
+ provider: menuModelContext?.provider,
477
+ model: menuModelContext?.model,
478
+ });
479
+ if (menu) {
480
+ const menuPayload = buildDiscordCommandArgMenu({
481
+ command,
482
+ menu,
483
+ interaction: interaction as CommandInteraction,
484
+ ctx: {
485
+ cfg,
486
+ discordConfig,
487
+ accountId,
488
+ sessionPrefix,
489
+ threadBindings,
490
+ },
491
+ safeInteractionCall: safeDiscordInteractionCall,
492
+ dispatchCommandInteraction: dispatchDiscordCommandInteraction,
493
+ });
494
+ if (preferFollowUp) {
495
+ await safeDiscordInteractionCall("interaction follow-up", () =>
496
+ interaction.followUp({
497
+ content: menuPayload.content,
498
+ components: menuPayload.components,
499
+ ephemeral: true,
500
+ }),
501
+ );
502
+ return { accepted: true };
503
+ }
504
+ await safeDiscordInteractionCall("interaction reply", () =>
505
+ interaction.reply({
506
+ content: menuPayload.content,
507
+ components: menuPayload.components,
508
+ ephemeral: true,
509
+ }),
510
+ );
511
+ return { accepted: true };
512
+ }
513
+
514
+ const pluginMatch = nativeCommandRuntime.matchPluginCommand(prompt);
515
+ if (pluginMatch && commandName !== "status") {
516
+ if (suppressReplies) {
517
+ return { accepted: true };
518
+ }
519
+ const channelId = rawChannelId || "unknown";
520
+ const messageThreadId = !isDirectMessage && isThreadChannel ? channelId : undefined;
521
+ const pluginThreadParentId = !isDirectMessage && isThreadChannel ? threadParentId : undefined;
522
+ const { effectiveRoute } = await getNativeRouteState();
523
+ const pluginReply = await nativeCommandRuntime.executePluginCommand({
524
+ command: pluginMatch.command,
525
+ args: pluginMatch.args,
526
+ senderId: sender.id,
527
+ channel: "discord",
528
+ channelId,
529
+ isAuthorizedSender: commandAuthorized,
530
+ sessionKey: effectiveRoute.sessionKey,
531
+ commandBody: prompt,
532
+ config: cfg,
533
+ from: isDirectMessage
534
+ ? `discord:${user.id}`
535
+ : isGroupDm
536
+ ? `discord:group:${channelId}`
537
+ : `discord:channel:${channelId}`,
538
+ to: `slash:${user.id}`,
539
+ accountId,
540
+ messageThreadId,
541
+ threadParentId: pluginThreadParentId,
542
+ });
543
+ if (!hasRenderableReplyPayload(pluginReply)) {
544
+ await respond(DISCORD_EMPTY_VISIBLE_REPLY_WARNING);
545
+ return { accepted: true, effectiveRoute };
546
+ }
547
+ await deliverDiscordInteractionReply({
548
+ interaction,
549
+ payload: pluginReply,
550
+ textLimit: resolveTextChunkLimit(cfg, "discord", accountId, {
551
+ fallbackLimit: 2000,
552
+ }),
553
+ maxLinesPerMessage: resolveDiscordMaxLinesPerMessage({ cfg, discordConfig, accountId }),
554
+ preferFollowUp,
555
+ responseEphemeral,
556
+ chunkMode: resolveChunkMode(cfg, "discord", accountId),
557
+ });
558
+ return { accepted: true, effectiveRoute };
559
+ }
560
+
561
+ const pickerCommandContext = shouldOpenDiscordModelPickerFromCommand({
562
+ command,
563
+ commandArgs,
564
+ });
565
+ if (pickerCommandContext) {
566
+ await replyWithDiscordModelPickerProviders({
567
+ interaction,
568
+ cfg,
569
+ command: pickerCommandContext,
570
+ userId: user.id,
571
+ accountId,
572
+ threadBindings,
573
+ preferFollowUp,
574
+ safeInteractionCall: safeDiscordInteractionCall,
575
+ });
576
+ return { accepted: true };
577
+ }
578
+
579
+ const isGuild = Boolean(interaction.guild);
580
+ const channelId = rawChannelId || "unknown";
581
+ const interactionId = interaction.rawData.id;
582
+ const routeState = await getNativeRouteState();
583
+ if (routeState.bindingReadiness && !routeState.bindingReadiness.ok) {
584
+ const configuredBinding = routeState.configuredBinding;
585
+ if (configuredBinding) {
586
+ logVerbose(
587
+ `discord native command: configured ACP binding unavailable for channel ${configuredBinding.record.conversation.conversationId}: ${routeState.bindingReadiness.error}`,
588
+ );
589
+ await respond("Configured ACP binding is unavailable right now. Please try again.");
590
+ return { accepted: false };
591
+ }
592
+ }
593
+ const boundSessionKey = routeState.boundSessionKey;
594
+ const effectiveRoute = routeState.effectiveRoute;
595
+ const { sessionKey, commandTargetSessionKey } = resolveNativeCommandSessionTargets({
596
+ agentId: effectiveRoute.agentId,
597
+ sessionPrefix,
598
+ userId: user.id,
599
+ targetSessionKey: effectiveRoute.sessionKey,
600
+ boundSessionKey,
601
+ });
602
+ const mediaLocalRoots = getAgentScopedMediaLocalRoots(cfg, effectiveRoute.agentId);
603
+ const directStatusResult = await maybeDeliverDiscordDirectStatus({
604
+ commandName,
605
+ suppressReplies,
606
+ resolveDirectStatusReplyForSession: nativeCommandRuntime.resolveDirectStatusReplyForSession,
607
+ cfg,
608
+ discordConfig,
609
+ accountId,
610
+ sessionKey,
611
+ commandTargetSessionKey,
612
+ channel: "discord",
613
+ senderId: sender.id,
614
+ senderIsOwner: ownerOk,
615
+ isAuthorizedSender: commandAuthorized,
616
+ isGroup: isGuild || isGroupDm,
617
+ defaultGroupActivation: () =>
618
+ !isGuild ? "always" : channelConfig?.requireMention === false ? "always" : "mention",
619
+ interaction,
620
+ mediaLocalRoots,
621
+ preferFollowUp,
622
+ responseEphemeral,
623
+ effectiveRoute,
624
+ respond,
625
+ });
626
+ if (directStatusResult) {
627
+ return directStatusResult;
628
+ }
629
+ const ctxPayload = buildDiscordNativeCommandContext({
630
+ prompt,
631
+ commandArgs: commandArgs ?? {},
632
+ sessionKey,
633
+ commandTargetSessionKey,
634
+ accountId: effectiveRoute.accountId,
635
+ interactionId,
636
+ channelId,
637
+ threadParentId,
638
+ memberRoleIds,
639
+ guildId: interaction.guild?.id,
640
+ guildName: interaction.guild?.name,
641
+ channelTopic: resolveDiscordChannelTopicSafe(channel),
642
+ channelConfig,
643
+ guildInfo,
644
+ allowNameMatching,
645
+ commandAuthorized,
646
+ isDirectMessage,
647
+ isGroupDm,
648
+ isGuild,
649
+ isThreadChannel,
650
+ user: {
651
+ id: user.id,
652
+ username: user.username,
653
+ globalName: user.globalName,
654
+ },
655
+ sender: { id: sender.id, name: sender.name, tag: sender.tag },
656
+ });
657
+
658
+ await dispatchDiscordNativeAgentReply({
659
+ cfg,
660
+ discordConfig,
661
+ accountId,
662
+ interaction,
663
+ ctxPayload,
664
+ effectiveRoute,
665
+ channelConfig,
666
+ mediaLocalRoots,
667
+ preferFollowUp,
668
+ responseEphemeral,
669
+ suppressReplies,
670
+ log,
671
+ });
672
+
673
+ return { accepted: true, effectiveRoute };
674
+ }
675
+
676
+ export function createDiscordCommandArgFallbackButton(params: DiscordCommandArgContext): Button {
677
+ return createDiscordCommandArgFallbackButtonUi({
678
+ ctx: params,
679
+ safeInteractionCall: safeDiscordInteractionCall,
680
+ dispatchCommandInteraction: dispatchDiscordCommandInteraction,
681
+ });
682
+ }
683
+
684
+ export function createDiscordModelPickerFallbackButton(params: DiscordModelPickerContext): Button {
685
+ return createDiscordModelPickerFallbackButtonUi({
686
+ ctx: params,
687
+ safeInteractionCall: safeDiscordInteractionCall,
688
+ dispatchCommandInteraction: dispatchDiscordCommandInteraction,
689
+ });
690
+ }
691
+
692
+ export function createDiscordModelPickerFallbackSelect(
693
+ params: DiscordModelPickerContext,
694
+ ): StringSelectMenu {
695
+ return createDiscordModelPickerFallbackSelectUi({
696
+ ctx: params,
697
+ safeInteractionCall: safeDiscordInteractionCall,
698
+ dispatchCommandInteraction: dispatchDiscordCommandInteraction,
699
+ });
700
+ }
@@ -0,0 +1,9 @@
1
+ import type { OpenClawConfig } from "openclaw/plugin-sdk/config-types";
2
+ import type { CommandArgValues } from "openclaw/plugin-sdk/native-command-registry";
3
+
4
+ export type DiscordConfig = NonNullable<OpenClawConfig["channels"]>["discord"];
5
+
6
+ export type DiscordCommandArgs = {
7
+ raw?: string;
8
+ values?: CommandArgValues;
9
+ };