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