@kodelyth/discord 2026.5.42 → 2026.6.2

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 (514) hide show
  1. package/klaw.plugin.json +3822 -2
  2. package/package.json +18 -6
  3. package/account-inspect-api.ts +0 -6
  4. package/action-runtime-api.ts +0 -1
  5. package/api.ts +0 -130
  6. package/channel-config-api.ts +0 -1
  7. package/channel-plugin-api.ts +0 -3
  8. package/config-api.ts +0 -4
  9. package/configured-state.ts +0 -6
  10. package/contract-api.ts +0 -21
  11. package/directory-contract-api.ts +0 -4
  12. package/doctor-contract-api.ts +0 -1
  13. package/index.test.ts +0 -13
  14. package/index.ts +0 -24
  15. package/runtime-api.actions.ts +0 -15
  16. package/runtime-api.lookup.ts +0 -22
  17. package/runtime-api.monitor.ts +0 -50
  18. package/runtime-api.send.ts +0 -79
  19. package/runtime-api.threads.ts +0 -31
  20. package/runtime-api.ts +0 -181
  21. package/runtime-setter-api.ts +0 -3
  22. package/secret-contract-api.ts +0 -4
  23. package/security-audit-contract-api.ts +0 -1
  24. package/security-contract-api.ts +0 -4
  25. package/session-key-api.ts +0 -1
  26. package/setup-entry.ts +0 -9
  27. package/setup-plugin-api.ts +0 -3
  28. package/src/account-inspect.test.ts +0 -126
  29. package/src/account-inspect.ts +0 -128
  30. package/src/accounts.test.ts +0 -381
  31. package/src/accounts.ts +0 -205
  32. package/src/actions/handle-action.guild-admin.ts +0 -421
  33. package/src/actions/handle-action.test.ts +0 -480
  34. package/src/actions/handle-action.ts +0 -402
  35. package/src/actions/runtime.guild.ts +0 -446
  36. package/src/actions/runtime.messaging.messages.ts +0 -226
  37. package/src/actions/runtime.messaging.reactions.ts +0 -67
  38. package/src/actions/runtime.messaging.runtime.ts +0 -73
  39. package/src/actions/runtime.messaging.send.ts +0 -336
  40. package/src/actions/runtime.messaging.shared.ts +0 -97
  41. package/src/actions/runtime.messaging.ts +0 -37
  42. package/src/actions/runtime.moderation-shared.ts +0 -48
  43. package/src/actions/runtime.moderation.authz.test.ts +0 -151
  44. package/src/actions/runtime.moderation.ts +0 -116
  45. package/src/actions/runtime.presence.test.ts +0 -165
  46. package/src/actions/runtime.presence.ts +0 -117
  47. package/src/actions/runtime.shared.ts +0 -86
  48. package/src/actions/runtime.test.ts +0 -1337
  49. package/src/actions/runtime.ts +0 -87
  50. package/src/api-barrel.test.ts +0 -78
  51. package/src/api.test.ts +0 -152
  52. package/src/api.ts +0 -215
  53. package/src/approval-handler.runtime.test.ts +0 -41
  54. package/src/approval-handler.runtime.ts +0 -633
  55. package/src/approval-native.test.ts +0 -330
  56. package/src/approval-native.ts +0 -219
  57. package/src/approval-runtime.ts +0 -14
  58. package/src/approval-shared.ts +0 -50
  59. package/src/audit-core.ts +0 -178
  60. package/src/audit.test.ts +0 -204
  61. package/src/audit.ts +0 -32
  62. package/src/channel-actions.contract.test.ts +0 -45
  63. package/src/channel-actions.runtime.ts +0 -1
  64. package/src/channel-actions.test.ts +0 -504
  65. package/src/channel-actions.ts +0 -254
  66. package/src/channel-api.ts +0 -29
  67. package/src/channel.conversation.ts +0 -159
  68. package/src/channel.loaders.ts +0 -50
  69. package/src/channel.message-adapter.test.ts +0 -230
  70. package/src/channel.runtime.ts +0 -1
  71. package/src/channel.setup.ts +0 -12
  72. package/src/channel.test.ts +0 -828
  73. package/src/channel.ts +0 -728
  74. package/src/chunk.test.ts +0 -170
  75. package/src/chunk.ts +0 -321
  76. package/src/client.proxy.test.ts +0 -177
  77. package/src/client.test.ts +0 -83
  78. package/src/client.ts +0 -143
  79. package/src/component-custom-id.ts +0 -72
  80. package/src/components-registry.ts +0 -356
  81. package/src/components.builders.ts +0 -409
  82. package/src/components.modal.ts +0 -124
  83. package/src/components.parse.ts +0 -407
  84. package/src/components.test.ts +0 -345
  85. package/src/components.ts +0 -54
  86. package/src/components.types.ts +0 -187
  87. package/src/config-schema.test.ts +0 -439
  88. package/src/config-schema.ts +0 -6
  89. package/src/config-ui-hints.ts +0 -354
  90. package/src/conversation-identity.ts +0 -58
  91. package/src/delivery-retry.ts +0 -52
  92. package/src/directory-cache.ts +0 -116
  93. package/src/directory-config.ts +0 -58
  94. package/src/directory-contract.test.ts +0 -129
  95. package/src/directory-live.test.ts +0 -141
  96. package/src/directory-live.ts +0 -135
  97. package/src/doctor-contract.ts +0 -477
  98. package/src/doctor-shared.ts +0 -5
  99. package/src/doctor.test.ts +0 -393
  100. package/src/doctor.ts +0 -340
  101. package/src/draft-chunking.test.ts +0 -64
  102. package/src/draft-chunking.ts +0 -43
  103. package/src/draft-stream.test.ts +0 -193
  104. package/src/draft-stream.ts +0 -162
  105. package/src/durable-delivery.test.ts +0 -103
  106. package/src/error-body.ts +0 -38
  107. package/src/exec-approvals.test.ts +0 -88
  108. package/src/exec-approvals.ts +0 -110
  109. package/src/gateway-logging.test.ts +0 -98
  110. package/src/gateway-logging.ts +0 -67
  111. package/src/group-policy.ts +0 -113
  112. package/src/guilds.ts +0 -29
  113. package/src/inbound-context.contract.test.ts +0 -11
  114. package/src/inbound-event-delivery.ts +0 -135
  115. package/src/interactive-dispatch.ts +0 -104
  116. package/src/internal/api.commands.ts +0 -51
  117. package/src/internal/api.guild.ts +0 -164
  118. package/src/internal/api.interactions.ts +0 -53
  119. package/src/internal/api.messages.ts +0 -113
  120. package/src/internal/api.reactions.ts +0 -38
  121. package/src/internal/api.test.ts +0 -260
  122. package/src/internal/api.ts +0 -61
  123. package/src/internal/api.users.ts +0 -19
  124. package/src/internal/api.webhooks.ts +0 -13
  125. package/src/internal/client.test.ts +0 -472
  126. package/src/internal/client.ts +0 -310
  127. package/src/internal/command-deploy.test.ts +0 -197
  128. package/src/internal/command-deploy.ts +0 -352
  129. package/src/internal/commands.ts +0 -188
  130. package/src/internal/components.base.ts +0 -65
  131. package/src/internal/components.message.ts +0 -279
  132. package/src/internal/components.modal.ts +0 -95
  133. package/src/internal/components.ts +0 -31
  134. package/src/internal/discord.ts +0 -11
  135. package/src/internal/embeds.ts +0 -35
  136. package/src/internal/entity-cache.ts +0 -98
  137. package/src/internal/event-queue.ts +0 -185
  138. package/src/internal/gateway-close-codes.ts +0 -25
  139. package/src/internal/gateway-dispatch.ts +0 -96
  140. package/src/internal/gateway-identify-limiter.ts +0 -26
  141. package/src/internal/gateway-lifecycle.test.ts +0 -114
  142. package/src/internal/gateway-lifecycle.ts +0 -75
  143. package/src/internal/gateway-rate-limit.ts +0 -104
  144. package/src/internal/gateway.test.ts +0 -676
  145. package/src/internal/gateway.ts +0 -479
  146. package/src/internal/interaction-dispatch.test.ts +0 -148
  147. package/src/internal/interaction-dispatch.ts +0 -162
  148. package/src/internal/interaction-options.ts +0 -98
  149. package/src/internal/interaction-response.ts +0 -53
  150. package/src/internal/interactions.test.ts +0 -329
  151. package/src/internal/interactions.ts +0 -378
  152. package/src/internal/listeners.ts +0 -91
  153. package/src/internal/live-smoke.live.test.ts +0 -26
  154. package/src/internal/modal-fields.ts +0 -95
  155. package/src/internal/payload.ts +0 -69
  156. package/src/internal/rest-body.ts +0 -115
  157. package/src/internal/rest-errors.ts +0 -88
  158. package/src/internal/rest-routes.ts +0 -50
  159. package/src/internal/rest-scheduler.ts +0 -557
  160. package/src/internal/rest.test.ts +0 -681
  161. package/src/internal/rest.ts +0 -322
  162. package/src/internal/schemas.ts +0 -36
  163. package/src/internal/structures.test.ts +0 -43
  164. package/src/internal/structures.ts +0 -280
  165. package/src/internal/test-builders.test-support.ts +0 -167
  166. package/src/internal/voice.ts +0 -49
  167. package/src/media-detection.ts +0 -28
  168. package/src/mentions.test.ts +0 -111
  169. package/src/mentions.ts +0 -147
  170. package/src/monitor/ack-reactions.ts +0 -70
  171. package/src/monitor/acp-bind-here.integration.test.ts +0 -219
  172. package/src/monitor/agent-components-auth.ts +0 -7
  173. package/src/monitor/agent-components-context.ts +0 -154
  174. package/src/monitor/agent-components-data.ts +0 -224
  175. package/src/monitor/agent-components-dm-auth.ts +0 -177
  176. package/src/monitor/agent-components-guild-auth.ts +0 -322
  177. package/src/monitor/agent-components-helpers.runtime.ts +0 -3
  178. package/src/monitor/agent-components-helpers.ts +0 -34
  179. package/src/monitor/agent-components-reply.ts +0 -10
  180. package/src/monitor/agent-components.deps.runtime.ts +0 -2
  181. package/src/monitor/agent-components.dispatch.ts +0 -359
  182. package/src/monitor/agent-components.handlers.ts +0 -303
  183. package/src/monitor/agent-components.modal.ts +0 -160
  184. package/src/monitor/agent-components.plugin-interactive.ts +0 -187
  185. package/src/monitor/agent-components.runtime.ts +0 -14
  186. package/src/monitor/agent-components.system-controls.ts +0 -215
  187. package/src/monitor/agent-components.ts +0 -70
  188. package/src/monitor/agent-components.types.ts +0 -58
  189. package/src/monitor/agent-components.wildcard-controls.ts +0 -171
  190. package/src/monitor/agent-components.wildcard.test.ts +0 -71
  191. package/src/monitor/allow-list.test.ts +0 -14
  192. package/src/monitor/allow-list.ts +0 -631
  193. package/src/monitor/auto-presence.test.ts +0 -184
  194. package/src/monitor/auto-presence.ts +0 -356
  195. package/src/monitor/channel-access.test.ts +0 -113
  196. package/src/monitor/channel-access.ts +0 -102
  197. package/src/monitor/commands.test.ts +0 -24
  198. package/src/monitor/commands.ts +0 -9
  199. package/src/monitor/dm-command-auth.test.ts +0 -274
  200. package/src/monitor/dm-command-auth.ts +0 -259
  201. package/src/monitor/dm-command-decision.test.ts +0 -108
  202. package/src/monitor/dm-command-decision.ts +0 -49
  203. package/src/monitor/exec-approvals.test.ts +0 -225
  204. package/src/monitor/exec-approvals.ts +0 -158
  205. package/src/monitor/format.ts +0 -45
  206. package/src/monitor/gateway-handle.ts +0 -33
  207. package/src/monitor/gateway-metadata.test.ts +0 -29
  208. package/src/monitor/gateway-metadata.ts +0 -298
  209. package/src/monitor/gateway-plugin.test.ts +0 -320
  210. package/src/monitor/gateway-plugin.ts +0 -302
  211. package/src/monitor/gateway-registry.ts +0 -37
  212. package/src/monitor/gateway-supervisor.test.ts +0 -157
  213. package/src/monitor/gateway-supervisor.ts +0 -206
  214. package/src/monitor/inbound-context.test-helpers.ts +0 -37
  215. package/src/monitor/inbound-context.test.ts +0 -112
  216. package/src/monitor/inbound-context.ts +0 -95
  217. package/src/monitor/inbound-dedupe.ts +0 -79
  218. package/src/monitor/inbound-job.test.ts +0 -216
  219. package/src/monitor/inbound-job.ts +0 -118
  220. package/src/monitor/listeners.queue.ts +0 -91
  221. package/src/monitor/listeners.reactions.ts +0 -594
  222. package/src/monitor/listeners.test.ts +0 -209
  223. package/src/monitor/listeners.ts +0 -150
  224. package/src/monitor/message-channel-info.ts +0 -96
  225. package/src/monitor/message-forwarded.ts +0 -114
  226. package/src/monitor/message-handler.batch-gate.test.ts +0 -22
  227. package/src/monitor/message-handler.batch-gate.ts +0 -19
  228. package/src/monitor/message-handler.bot-self-filter.test.ts +0 -68
  229. package/src/monitor/message-handler.context.ts +0 -492
  230. package/src/monitor/message-handler.dm-preflight.ts +0 -119
  231. package/src/monitor/message-handler.draft-preview.ts +0 -426
  232. package/src/monitor/message-handler.hydration.test.ts +0 -80
  233. package/src/monitor/message-handler.hydration.ts +0 -198
  234. package/src/monitor/message-handler.inbound-context.test.ts +0 -61
  235. package/src/monitor/message-handler.module-test-helpers.ts +0 -31
  236. package/src/monitor/message-handler.preflight-channel-access.ts +0 -86
  237. package/src/monitor/message-handler.preflight-channel-context.test.ts +0 -18
  238. package/src/monitor/message-handler.preflight-channel-context.ts +0 -58
  239. package/src/monitor/message-handler.preflight-context.ts +0 -54
  240. package/src/monitor/message-handler.preflight-helpers.ts +0 -164
  241. package/src/monitor/message-handler.preflight-history.ts +0 -23
  242. package/src/monitor/message-handler.preflight-logging.ts +0 -36
  243. package/src/monitor/message-handler.preflight-pluralkit.ts +0 -26
  244. package/src/monitor/message-handler.preflight-runtime.ts +0 -28
  245. package/src/monitor/message-handler.preflight-thread.ts +0 -49
  246. package/src/monitor/message-handler.preflight.acp-bindings.test.ts +0 -371
  247. package/src/monitor/message-handler.preflight.test-helpers.ts +0 -114
  248. package/src/monitor/message-handler.preflight.test.ts +0 -2255
  249. package/src/monitor/message-handler.preflight.ts +0 -822
  250. package/src/monitor/message-handler.preflight.types.ts +0 -115
  251. package/src/monitor/message-handler.process.test.ts +0 -2520
  252. package/src/monitor/message-handler.process.ts +0 -1027
  253. package/src/monitor/message-handler.queue.test.ts +0 -680
  254. package/src/monitor/message-handler.routing-preflight.ts +0 -112
  255. package/src/monitor/message-handler.test-harness.ts +0 -99
  256. package/src/monitor/message-handler.test-helpers.ts +0 -75
  257. package/src/monitor/message-handler.ts +0 -309
  258. package/src/monitor/message-media.ts +0 -536
  259. package/src/monitor/message-run-queue.ts +0 -101
  260. package/src/monitor/message-text.ts +0 -171
  261. package/src/monitor/message-utils.test.ts +0 -1234
  262. package/src/monitor/message-utils.ts +0 -34
  263. package/src/monitor/model-picker-preferences.test.ts +0 -67
  264. package/src/monitor/model-picker-preferences.ts +0 -184
  265. package/src/monitor/model-picker.state.ts +0 -364
  266. package/src/monitor/model-picker.test-utils.ts +0 -26
  267. package/src/monitor/model-picker.test.ts +0 -869
  268. package/src/monitor/model-picker.ts +0 -38
  269. package/src/monitor/model-picker.view.ts +0 -722
  270. package/src/monitor/monitor.agent-components.test.ts +0 -410
  271. package/src/monitor/monitor.test.ts +0 -919
  272. package/src/monitor/monitor.threading-utils.test.ts +0 -614
  273. package/src/monitor/native-command-agent-reply.ts +0 -125
  274. package/src/monitor/native-command-arg-ui.ts +0 -233
  275. package/src/monitor/native-command-auth.ts +0 -309
  276. package/src/monitor/native-command-bypass.ts +0 -13
  277. package/src/monitor/native-command-context.test.ts +0 -105
  278. package/src/monitor/native-command-context.ts +0 -109
  279. package/src/monitor/native-command-dispatch.ts +0 -35
  280. package/src/monitor/native-command-model-picker-apply.ts +0 -209
  281. package/src/monitor/native-command-model-picker-interaction.ts +0 -516
  282. package/src/monitor/native-command-model-picker-ui.ts +0 -357
  283. package/src/monitor/native-command-reply.test.ts +0 -68
  284. package/src/monitor/native-command-reply.ts +0 -185
  285. package/src/monitor/native-command-route.ts +0 -91
  286. package/src/monitor/native-command-status.ts +0 -76
  287. package/src/monitor/native-command-ui.ts +0 -26
  288. package/src/monitor/native-command-ui.types.ts +0 -20
  289. package/src/monitor/native-command.args.ts +0 -45
  290. package/src/monitor/native-command.command-arg.test.ts +0 -108
  291. package/src/monitor/native-command.commands-allowfrom.test.ts +0 -504
  292. package/src/monitor/native-command.model-picker.test.ts +0 -930
  293. package/src/monitor/native-command.options.test.ts +0 -379
  294. package/src/monitor/native-command.options.ts +0 -153
  295. package/src/monitor/native-command.plugin-dispatch.test.ts +0 -1212
  296. package/src/monitor/native-command.runtime.ts +0 -51
  297. package/src/monitor/native-command.status-direct.test.ts +0 -278
  298. package/src/monitor/native-command.test-helpers.ts +0 -64
  299. package/src/monitor/native-command.think-autocomplete.test.ts +0 -411
  300. package/src/monitor/native-command.ts +0 -747
  301. package/src/monitor/native-command.types.ts +0 -9
  302. package/src/monitor/native-interaction-channel-context.ts +0 -50
  303. package/src/monitor/preflight-audio.runtime.ts +0 -9
  304. package/src/monitor/preflight-audio.test.ts +0 -157
  305. package/src/monitor/preflight-audio.ts +0 -130
  306. package/src/monitor/presence-cache.ts +0 -61
  307. package/src/monitor/presence.test.ts +0 -61
  308. package/src/monitor/presence.ts +0 -50
  309. package/src/monitor/provider-session.runtime.ts +0 -12
  310. package/src/monitor/provider.acp.ts +0 -89
  311. package/src/monitor/provider.allowlist.test.ts +0 -217
  312. package/src/monitor/provider.allowlist.ts +0 -398
  313. package/src/monitor/provider.cleanup.ts +0 -41
  314. package/src/monitor/provider.commands.ts +0 -129
  315. package/src/monitor/provider.config-log.ts +0 -45
  316. package/src/monitor/provider.deploy-errors.ts +0 -362
  317. package/src/monitor/provider.deploy.ts +0 -221
  318. package/src/monitor/provider.interactions.ts +0 -160
  319. package/src/monitor/provider.lifecycle.test.ts +0 -734
  320. package/src/monitor/provider.lifecycle.ts +0 -562
  321. package/src/monitor/provider.proxy.test.ts +0 -804
  322. package/src/monitor/provider.rest-proxy.test.ts +0 -389
  323. package/src/monitor/provider.runtime.ts +0 -1
  324. package/src/monitor/provider.skill-dedupe.test.ts +0 -42
  325. package/src/monitor/provider.startup-log.ts +0 -32
  326. package/src/monitor/provider.startup.test.ts +0 -440
  327. package/src/monitor/provider.startup.ts +0 -323
  328. package/src/monitor/provider.test.ts +0 -1173
  329. package/src/monitor/provider.ts +0 -688
  330. package/src/monitor/reply-context.ts +0 -64
  331. package/src/monitor/reply-delivery.test.ts +0 -474
  332. package/src/monitor/reply-delivery.ts +0 -212
  333. package/src/monitor/reply-safety.ts +0 -96
  334. package/src/monitor/rest-fetch.ts +0 -94
  335. package/src/monitor/route-resolution.test.ts +0 -209
  336. package/src/monitor/route-resolution.ts +0 -140
  337. package/src/monitor/sender-identity.ts +0 -81
  338. package/src/monitor/startup-status.test.ts +0 -30
  339. package/src/monitor/startup-status.ts +0 -10
  340. package/src/monitor/status.ts +0 -22
  341. package/src/monitor/system-events.ts +0 -55
  342. package/src/monitor/thread-bindings.config.ts +0 -35
  343. package/src/monitor/thread-bindings.discord-api.test.ts +0 -250
  344. package/src/monitor/thread-bindings.discord-api.ts +0 -310
  345. package/src/monitor/thread-bindings.lifecycle.test.ts +0 -1994
  346. package/src/monitor/thread-bindings.lifecycle.ts +0 -354
  347. package/src/monitor/thread-bindings.manager.ts +0 -551
  348. package/src/monitor/thread-bindings.messages.ts +0 -6
  349. package/src/monitor/thread-bindings.persona.test.ts +0 -34
  350. package/src/monitor/thread-bindings.persona.ts +0 -25
  351. package/src/monitor/thread-bindings.session-adapter.ts +0 -229
  352. package/src/monitor/thread-bindings.session-shared.ts +0 -59
  353. package/src/monitor/thread-bindings.session-updates.ts +0 -35
  354. package/src/monitor/thread-bindings.shared-state.test.ts +0 -39
  355. package/src/monitor/thread-bindings.state.ts +0 -540
  356. package/src/monitor/thread-bindings.ts +0 -48
  357. package/src/monitor/thread-bindings.types.ts +0 -83
  358. package/src/monitor/thread-channel-context.ts +0 -112
  359. package/src/monitor/thread-session-close.test.ts +0 -180
  360. package/src/monitor/thread-session-close.ts +0 -63
  361. package/src/monitor/thread-title.generate.test.ts +0 -209
  362. package/src/monitor/thread-title.test.ts +0 -31
  363. package/src/monitor/thread-title.ts +0 -181
  364. package/src/monitor/threading.auto-thread.test.ts +0 -330
  365. package/src/monitor/threading.auto-thread.ts +0 -287
  366. package/src/monitor/threading.cache.ts +0 -45
  367. package/src/monitor/threading.parent-info.test.ts +0 -156
  368. package/src/monitor/threading.starter.test.ts +0 -279
  369. package/src/monitor/threading.starter.ts +0 -288
  370. package/src/monitor/threading.ts +0 -20
  371. package/src/monitor/threading.types.ts +0 -102
  372. package/src/monitor/timeouts.ts +0 -84
  373. package/src/monitor/typing.test.ts +0 -42
  374. package/src/monitor/typing.ts +0 -17
  375. package/src/monitor.gateway.test.ts +0 -187
  376. package/src/monitor.gateway.ts +0 -75
  377. package/src/monitor.test.ts +0 -1416
  378. package/src/monitor.ts +0 -28
  379. package/src/network-config.test.ts +0 -92
  380. package/src/network-config.ts +0 -79
  381. package/src/normalize.test.ts +0 -56
  382. package/src/normalize.ts +0 -86
  383. package/src/outbound-adapter.interactive-order.test.ts +0 -82
  384. package/src/outbound-adapter.test-harness.ts +0 -207
  385. package/src/outbound-adapter.test.ts +0 -804
  386. package/src/outbound-adapter.ts +0 -326
  387. package/src/outbound-approval.ts +0 -29
  388. package/src/outbound-components.ts +0 -86
  389. package/src/outbound-payload.contract.test.ts +0 -49
  390. package/src/outbound-payload.ts +0 -208
  391. package/src/outbound-send-context.ts +0 -89
  392. package/src/outbound-session-route.test.ts +0 -42
  393. package/src/outbound-session-route.ts +0 -72
  394. package/src/pluralkit.test.ts +0 -67
  395. package/src/pluralkit.ts +0 -58
  396. package/src/preview-streaming.ts +0 -18
  397. package/src/probe.intents.test.ts +0 -94
  398. package/src/probe.parse-token.test.ts +0 -43
  399. package/src/probe.runtime.ts +0 -1
  400. package/src/probe.ts +0 -237
  401. package/src/proxy-fetch.ts +0 -92
  402. package/src/proxy-request-client.test.ts +0 -100
  403. package/src/proxy-request-client.ts +0 -21
  404. package/src/recipient-resolution.ts +0 -39
  405. package/src/resolve-allowlist-common.test.ts +0 -40
  406. package/src/resolve-allowlist-common.ts +0 -39
  407. package/src/resolve-channels.test.ts +0 -341
  408. package/src/resolve-channels.ts +0 -369
  409. package/src/resolve-users.test.ts +0 -243
  410. package/src/resolve-users.ts +0 -184
  411. package/src/retry.test.ts +0 -83
  412. package/src/retry.ts +0 -98
  413. package/src/runtime-api.ts +0 -61
  414. package/src/runtime-config.ts +0 -16
  415. package/src/runtime.ts +0 -23
  416. package/src/secret-config-contract.ts +0 -140
  417. package/src/security-audit.runtime.ts +0 -1
  418. package/src/security-audit.test.ts +0 -245
  419. package/src/security-audit.ts +0 -208
  420. package/src/security-contract.ts +0 -47
  421. package/src/security-doctor.test.ts +0 -25
  422. package/src/security-doctor.ts +0 -20
  423. package/src/security.ts +0 -60
  424. package/src/send-target-parsing.ts +0 -14
  425. package/src/send.channels.ts +0 -139
  426. package/src/send.components.test.ts +0 -330
  427. package/src/send.components.ts +0 -391
  428. package/src/send.creates-thread.test.ts +0 -681
  429. package/src/send.emojis-stickers.ts +0 -57
  430. package/src/send.guild.ts +0 -170
  431. package/src/send.message-request.ts +0 -112
  432. package/src/send.messages.test.ts +0 -59
  433. package/src/send.messages.ts +0 -229
  434. package/src/send.outbound.ts +0 -459
  435. package/src/send.permissions.authz.test.ts +0 -190
  436. package/src/send.permissions.ts +0 -283
  437. package/src/send.reactions.ts +0 -155
  438. package/src/send.receipt.ts +0 -69
  439. package/src/send.sends-basic-channel-messages.test.ts +0 -1068
  440. package/src/send.shared.ts +0 -469
  441. package/src/send.test-harness.ts +0 -56
  442. package/src/send.ts +0 -82
  443. package/src/send.types.ts +0 -191
  444. package/src/send.typing.test.ts +0 -41
  445. package/src/send.typing.ts +0 -9
  446. package/src/send.voice.ts +0 -136
  447. package/src/send.webhook-activity.test.ts +0 -152
  448. package/src/send.webhook.proxy.test.ts +0 -210
  449. package/src/send.webhook.ts +0 -137
  450. package/src/session-contract.ts +0 -3
  451. package/src/session-key-normalization.test.ts +0 -44
  452. package/src/session-key-normalization.ts +0 -47
  453. package/src/setup-account-state.test.ts +0 -113
  454. package/src/setup-account-state.ts +0 -141
  455. package/src/setup-adapter.ts +0 -14
  456. package/src/setup-core.ts +0 -215
  457. package/src/setup-runtime-helpers.ts +0 -10
  458. package/src/setup-surface.test.ts +0 -137
  459. package/src/setup-surface.ts +0 -132
  460. package/src/shared-interactive.test.ts +0 -153
  461. package/src/shared-interactive.ts +0 -161
  462. package/src/shared.test.ts +0 -186
  463. package/src/shared.ts +0 -197
  464. package/src/status-issues.test.ts +0 -97
  465. package/src/status-issues.ts +0 -198
  466. package/src/subagent-hooks.test.ts +0 -465
  467. package/src/subagent-hooks.ts +0 -232
  468. package/src/target-parsing.ts +0 -70
  469. package/src/target-resolver.ts +0 -129
  470. package/src/targets.test.ts +0 -393
  471. package/src/targets.ts +0 -12
  472. package/src/test-http-helpers.ts +0 -10
  473. package/src/test-support/component-runtime.ts +0 -194
  474. package/src/test-support/config.ts +0 -7
  475. package/src/test-support/configured-binding-runtime.ts +0 -29
  476. package/src/test-support/partial-channel.ts +0 -26
  477. package/src/test-support/provider.test-support.ts +0 -547
  478. package/src/token.test.ts +0 -174
  479. package/src/token.ts +0 -107
  480. package/src/ui-colors.ts +0 -27
  481. package/src/ui.ts +0 -20
  482. package/src/voice/access.test.ts +0 -288
  483. package/src/voice/access.ts +0 -126
  484. package/src/voice/audio.test.ts +0 -47
  485. package/src/voice/audio.ts +0 -249
  486. package/src/voice/capture-state.test.ts +0 -48
  487. package/src/voice/capture-state.ts +0 -120
  488. package/src/voice/command.test.ts +0 -170
  489. package/src/voice/command.ts +0 -284
  490. package/src/voice/config.ts +0 -8
  491. package/src/voice/ingress.ts +0 -164
  492. package/src/voice/manager.e2e.test.ts +0 -3286
  493. package/src/voice/manager.ready-listener.test.ts +0 -54
  494. package/src/voice/manager.runtime.ts +0 -14
  495. package/src/voice/manager.ts +0 -1155
  496. package/src/voice/prompt.test.ts +0 -30
  497. package/src/voice/prompt.ts +0 -22
  498. package/src/voice/realtime.ts +0 -1370
  499. package/src/voice/receive-recovery.test.ts +0 -81
  500. package/src/voice/receive-recovery.ts +0 -159
  501. package/src/voice/sanitize.test.ts +0 -34
  502. package/src/voice/sanitize.ts +0 -29
  503. package/src/voice/sdk-runtime.ts +0 -14
  504. package/src/voice/segment.ts +0 -160
  505. package/src/voice/session.ts +0 -81
  506. package/src/voice/speaker-context.ts +0 -127
  507. package/src/voice/tts.ts +0 -151
  508. package/src/voice-message.test.ts +0 -376
  509. package/src/voice-message.ts +0 -474
  510. package/subagent-hooks-api.ts +0 -27
  511. package/test-api.ts +0 -4
  512. package/thread-binding-api.ts +0 -1
  513. package/timeouts.ts +0 -6
  514. package/tsconfig.json +0 -16
@@ -1,828 +0,0 @@
1
- import { readFile } from "node:fs/promises";
2
- import { resolve } from "node:path";
3
- import { ChannelType } from "discord-api-types/v10";
4
- import { createStartAccountContext } from "klaw/plugin-sdk/channel-test-helpers";
5
- import type { PluginRuntime } from "klaw/plugin-sdk/core";
6
- import { afterEach, beforeAll, beforeEach, describe, expect, it, vi } from "vitest";
7
- import type { ResolvedDiscordAccount } from "./accounts.js";
8
- import * as directoryLive from "./directory-live.js";
9
- import type { KlawConfig } from "./runtime-api.js";
10
- import * as sendModule from "./send.js";
11
- import { createDiscordSendReceipt } from "./send.receipt.js";
12
- import { EMPTY_DISCORD_TEST_CONFIG } from "./test-support/config.js";
13
- let discordPlugin: typeof import("./channel.js").discordPlugin;
14
- let setDiscordRuntime: typeof import("./runtime.js").setDiscordRuntime;
15
-
16
- const probeDiscordMock = vi.hoisted(() => vi.fn());
17
- const monitorDiscordProviderMock = vi.hoisted(() => vi.fn());
18
- const auditDiscordChannelPermissionsMock = vi.hoisted(() => vi.fn());
19
- const collectDiscordAuditChannelIdsMock = vi.hoisted(() =>
20
- vi.fn(() => ({ channelIds: [], unresolvedChannels: 0 })),
21
- );
22
- const sleepWithAbortMock = vi.hoisted(() => vi.fn(async () => undefined));
23
-
24
- function discordTestSendResult(messageId: string, channelId = "channel:thread-123") {
25
- return {
26
- messageId,
27
- channelId,
28
- receipt: createDiscordSendReceipt({ platformMessageIds: [messageId], channelId, kind: "text" }),
29
- };
30
- }
31
-
32
- vi.mock("klaw/plugin-sdk/runtime-env", async () => {
33
- const actual = await vi.importActual<typeof import("klaw/plugin-sdk/runtime-env")>(
34
- "klaw/plugin-sdk/runtime-env",
35
- );
36
- return {
37
- ...actual,
38
- sleepWithAbort: sleepWithAbortMock,
39
- };
40
- });
41
-
42
- vi.mock("./probe.js", () => {
43
- return {
44
- probeDiscord: probeDiscordMock,
45
- };
46
- });
47
-
48
- vi.mock("./monitor/provider.runtime.js", () => {
49
- return {
50
- monitorDiscordProvider: monitorDiscordProviderMock,
51
- };
52
- });
53
-
54
- vi.mock("./audit.js", () => {
55
- return {
56
- auditDiscordChannelPermissions: auditDiscordChannelPermissionsMock,
57
- collectDiscordAuditChannelIds: collectDiscordAuditChannelIdsMock,
58
- };
59
- });
60
-
61
- function createCfg(): KlawConfig {
62
- return {
63
- channels: {
64
- discord: {
65
- enabled: true,
66
- token: "discord-token",
67
- },
68
- },
69
- } as KlawConfig;
70
- }
71
-
72
- function resolveAccount(cfg: KlawConfig, accountId = "default"): ResolvedDiscordAccount {
73
- return discordPlugin.config.resolveAccount(cfg, accountId);
74
- }
75
-
76
- function startDiscordAccount(cfg: KlawConfig, accountId = "default") {
77
- return discordPlugin.gateway!.startAccount!(
78
- createStartAccountContext({
79
- account: resolveAccount(cfg, accountId),
80
- cfg,
81
- }),
82
- );
83
- }
84
-
85
- function installDiscordRuntime(discord: Record<string, unknown>) {
86
- setDiscordRuntime({
87
- channel: {
88
- discord,
89
- },
90
- logging: {
91
- shouldLogVerbose: () => false,
92
- },
93
- } as unknown as PluginRuntime);
94
- }
95
-
96
- type MockWithCalls = {
97
- mock: { calls: unknown[][] };
98
- };
99
-
100
- function objectArgAt(
101
- mock: MockWithCalls,
102
- callIndex: number,
103
- argIndex: number,
104
- ): Record<string, unknown> {
105
- const value = mock.mock.calls[callIndex]?.[argIndex];
106
- if (value === undefined || value === null || typeof value !== "object" || Array.isArray(value)) {
107
- throw new Error(`expected call ${callIndex} argument ${argIndex} to be an object`);
108
- }
109
- return value as Record<string, unknown>;
110
- }
111
-
112
- function argAt(mock: MockWithCalls, callIndex: number, argIndex: number): unknown {
113
- const call = mock.mock.calls[callIndex];
114
- if (!call || !(argIndex in call)) {
115
- throw new Error(`expected call ${callIndex} argument ${argIndex}`);
116
- }
117
- return call[argIndex];
118
- }
119
-
120
- function recordField(value: unknown, field: string): Record<string, unknown> {
121
- if (value === undefined || value === null || typeof value !== "object" || Array.isArray(value)) {
122
- throw new Error(`expected ${field} to be an object`);
123
- }
124
- return value as Record<string, unknown>;
125
- }
126
-
127
- afterEach(() => {
128
- probeDiscordMock.mockReset();
129
- monitorDiscordProviderMock.mockReset();
130
- auditDiscordChannelPermissionsMock.mockReset();
131
- collectDiscordAuditChannelIdsMock.mockReset();
132
- collectDiscordAuditChannelIdsMock.mockReturnValue({
133
- channelIds: [],
134
- unresolvedChannels: 0,
135
- });
136
- sleepWithAbortMock.mockReset();
137
- sleepWithAbortMock.mockResolvedValue(undefined);
138
- });
139
-
140
- beforeEach(async () => {
141
- vi.useRealTimers();
142
- installDiscordRuntime({});
143
- });
144
-
145
- beforeAll(async () => {
146
- ({ discordPlugin } = await import("./channel.js"));
147
- ({ setDiscordRuntime } = await import("./runtime.js"));
148
- });
149
-
150
- describe("discordPlugin outbound", () => {
151
- it("avoids local require calls for bundled-only sibling modules", async () => {
152
- const source = await readFile(
153
- resolve(process.cwd(), "extensions/discord/src/channel.ts"),
154
- "utf8",
155
- );
156
- expect(source).not.toContain('require("./ui.js")');
157
- expect(source).not.toContain('require("./channel-actions.js")');
158
- });
159
-
160
- it("prefers final assistant text for text-only cron announce delivery", () => {
161
- expect(discordPlugin.outbound?.preferFinalAssistantVisibleText).toBe(true);
162
- });
163
-
164
- it("routes read and search actions through the gateway", () => {
165
- expect(discordPlugin.actions?.resolveExecutionMode?.({ action: "read" as never })).toBe(
166
- "gateway",
167
- );
168
- expect(discordPlugin.actions?.resolveExecutionMode?.({ action: "search" as never })).toBe(
169
- "gateway",
170
- );
171
- expect(discordPlugin.actions?.resolveExecutionMode?.({ action: "send" as never })).toBe(
172
- "local",
173
- );
174
- });
175
-
176
- it("adds Discord mention formatting to agent prompt hints", () => {
177
- const hints = discordPlugin.agentPrompt?.messageToolHints?.({} as never) ?? [];
178
-
179
- expect(hints).toContain(
180
- "- Discord mentions: use canonical outbound syntax: users `<@USER_ID>`, channels `<#CHANNEL_ID>`, and roles `<@&ROLE_ID>`. Plain `@name` text only pings when a configured `mentionAliases` entry rewrites it; do not use the legacy `<@!USER_ID>` nickname form.",
181
- );
182
- });
183
-
184
- it("preserves normalized explicit Discord targets for delivery routing", () => {
185
- const parseExplicitTarget = discordPlugin.messaging?.parseExplicitTarget;
186
- if (!parseExplicitTarget) {
187
- throw new Error("Expected discordPlugin.messaging.parseExplicitTarget to be defined");
188
- }
189
-
190
- expect(parseExplicitTarget({ raw: "user:123" })).toEqual({
191
- to: "user:123",
192
- chatType: "direct",
193
- });
194
- expect(parseExplicitTarget({ raw: "<@!456>" })).toEqual({
195
- to: "user:456",
196
- chatType: "direct",
197
- });
198
- expect(parseExplicitTarget({ raw: "channel:789" })).toEqual({
199
- to: "channel:789",
200
- chatType: "channel",
201
- });
202
- expect(parseExplicitTarget({ raw: "1470130713209602050" })).toEqual({
203
- to: "channel:1470130713209602050",
204
- chatType: "channel",
205
- });
206
- });
207
-
208
- it("resolves Discord usernames through the messaging target resolver", async () => {
209
- vi.spyOn(directoryLive, "listDiscordDirectoryPeersLive").mockResolvedValueOnce([
210
- { kind: "user", id: "user:999", name: "Jane" } as const,
211
- ]);
212
- const resolveTarget = discordPlugin.messaging?.targetResolver?.resolveTarget;
213
- if (!resolveTarget) {
214
- throw new Error(
215
- "Expected discordPlugin.messaging.targetResolver.resolveTarget to be defined",
216
- );
217
- }
218
-
219
- await expect(
220
- resolveTarget({
221
- cfg: createCfg(),
222
- accountId: "default",
223
- input: "jane",
224
- normalized: "channel:jane",
225
- preferredKind: "user",
226
- }),
227
- ).resolves.toEqual({
228
- to: "user:999",
229
- kind: "user",
230
- display: "jane",
231
- source: "directory",
232
- });
233
- });
234
-
235
- it("honors per-account replyToMode overrides", () => {
236
- const resolveReplyToMode = discordPlugin.threading?.resolveReplyToMode;
237
- if (!resolveReplyToMode) {
238
- throw new Error("Expected discordPlugin.threading.resolveReplyToMode to be defined");
239
- }
240
-
241
- const cfg = {
242
- channels: {
243
- discord: {
244
- replyToMode: "all",
245
- token: "discord-token",
246
- accounts: {
247
- work: {
248
- token: "discord-token-work",
249
- replyToMode: "first",
250
- },
251
- },
252
- },
253
- },
254
- } as KlawConfig;
255
-
256
- expect(resolveReplyToMode({ cfg, accountId: "work" })).toBe("first");
257
- expect(resolveReplyToMode({ cfg, accountId: "default" })).toBe("all");
258
- });
259
-
260
- it("inherits Discord gateway READY timeout settings per account", () => {
261
- const cfg = {
262
- channels: {
263
- discord: {
264
- token: "discord-token",
265
- gatewayReadyTimeoutMs: 90_000,
266
- gatewayRuntimeReadyTimeoutMs: 120_000,
267
- accounts: {
268
- work: {
269
- token: "discord-token-work",
270
- gatewayReadyTimeoutMs: 60_000,
271
- },
272
- },
273
- },
274
- },
275
- } as KlawConfig;
276
-
277
- expect(resolveAccount(cfg).config.gatewayReadyTimeoutMs).toBe(90_000);
278
- expect(resolveAccount(cfg).config.gatewayRuntimeReadyTimeoutMs).toBe(120_000);
279
- expect(resolveAccount(cfg, "work").config.gatewayReadyTimeoutMs).toBe(60_000);
280
- expect(resolveAccount(cfg, "work").config.gatewayRuntimeReadyTimeoutMs).toBe(120_000);
281
- });
282
-
283
- it("forwards full media send context to sendMessageDiscord", async () => {
284
- const sendMessageDiscord = vi.fn(async () => ({ messageId: "m1" }));
285
- const mediaReadFile = vi.fn(async () => Buffer.from("media"));
286
-
287
- const result = await discordPlugin.outbound!.sendMedia!({
288
- cfg: EMPTY_DISCORD_TEST_CONFIG,
289
- to: "channel:123",
290
- text: "hi",
291
- mediaUrl: "/tmp/image.png",
292
- mediaLocalRoots: ["/tmp/agent-root"],
293
- mediaReadFile,
294
- accountId: "work",
295
- threadId: "thread-123",
296
- replyToId: "reply-123",
297
- deps: {
298
- discord: sendMessageDiscord,
299
- },
300
- });
301
-
302
- expect(argAt(sendMessageDiscord, 0, 0)).toBe("channel:thread-123");
303
- expect(argAt(sendMessageDiscord, 0, 1)).toBe("hi");
304
- const sendOptions = objectArgAt(sendMessageDiscord, 0, 2);
305
- expect(sendOptions.mediaUrl).toBe("/tmp/image.png");
306
- expect(sendOptions.mediaLocalRoots).toEqual(["/tmp/agent-root"]);
307
- expect(sendOptions.mediaReadFile).toBe(mediaReadFile);
308
- expect(sendOptions.replyTo).toBe("reply-123");
309
- expect(result.channel).toBe("discord");
310
- expect(result.messageId).toBe("m1");
311
- });
312
-
313
- it("splits text and video into separate sends for attached outbound delivery", async () => {
314
- const sendMessageDiscord = vi
315
- .fn()
316
- .mockResolvedValueOnce(discordTestSendResult("text-1"))
317
- .mockResolvedValueOnce(discordTestSendResult("video-1"));
318
-
319
- const result = await discordPlugin.outbound!.sendMedia!({
320
- cfg: EMPTY_DISCORD_TEST_CONFIG,
321
- to: "channel:123",
322
- text: "done - tiny cyber-lobster clip incoming",
323
- mediaUrl: "/tmp/molty.mp4",
324
- accountId: "work",
325
- replyToId: "reply-123",
326
- threadId: "thread-123",
327
- deps: {
328
- discord: sendMessageDiscord,
329
- },
330
- });
331
-
332
- expect(sendMessageDiscord).toHaveBeenCalledTimes(2);
333
- expect(argAt(sendMessageDiscord, 0, 0)).toBe("channel:thread-123");
334
- expect(argAt(sendMessageDiscord, 0, 1)).toBe("done - tiny cyber-lobster clip incoming");
335
- expect(objectArgAt(sendMessageDiscord, 0, 2).replyTo).toBe("reply-123");
336
- expect(argAt(sendMessageDiscord, 1, 0)).toBe("channel:thread-123");
337
- expect(argAt(sendMessageDiscord, 1, 1)).toBe("");
338
- expect(objectArgAt(sendMessageDiscord, 1, 2).mediaUrl).toBe("/tmp/molty.mp4");
339
- expect(result.channel).toBe("discord");
340
- expect(result.messageId).toBe("video-1");
341
- });
342
-
343
- it("threads poll sends through the thread target", async () => {
344
- const sendPollDiscord = vi.fn(async () => discordTestSendResult("poll-1"));
345
- const sendPollSpy = vi.spyOn(sendModule, "sendPollDiscord").mockImplementation(sendPollDiscord);
346
- try {
347
- const result = await discordPlugin.outbound!.sendPoll!({
348
- cfg: EMPTY_DISCORD_TEST_CONFIG,
349
- to: "channel:123",
350
- poll: {
351
- question: "Best shell?",
352
- options: ["molty", "molter"],
353
- },
354
- accountId: "work",
355
- threadId: "thread-123",
356
- });
357
-
358
- expect(argAt(sendPollDiscord, 0, 0)).toBe("channel:thread-123");
359
- expect(argAt(sendPollDiscord, 0, 1)).toEqual({
360
- question: "Best shell?",
361
- options: ["molty", "molter"],
362
- });
363
- expect(objectArgAt(sendPollDiscord, 0, 2).accountId).toBe("work");
364
- const pollResult = result as { channel?: string; messageId?: string };
365
- expect(pollResult.channel).toBe("discord");
366
- expect(pollResult.messageId).toBe("poll-1");
367
- } finally {
368
- sendPollSpy.mockRestore();
369
- }
370
- });
371
-
372
- it("forwards heartbeat typing through the run config and attached target", async () => {
373
- const sendTypingDiscord = vi.fn(async () => ({ ok: true, channelId: "thread-123" }));
374
- const sendTypingSpy = vi
375
- .spyOn(sendModule, "sendTypingDiscord")
376
- .mockImplementation(sendTypingDiscord);
377
- try {
378
- const cfg = createCfg();
379
-
380
- await discordPlugin.heartbeat!.sendTyping!({
381
- cfg,
382
- to: "channel:123",
383
- accountId: "work",
384
- threadId: "thread-123",
385
- });
386
-
387
- expect(sendTypingDiscord).toHaveBeenCalledWith("thread-123", {
388
- cfg,
389
- accountId: "work",
390
- });
391
- } finally {
392
- sendTypingSpy.mockRestore();
393
- }
394
- });
395
-
396
- it("uses direct Discord probe helpers for status probes", async () => {
397
- const runtimeProbeDiscord = vi.fn(async () => {
398
- throw new Error("runtime Discord probe should not be used");
399
- });
400
- installDiscordRuntime({
401
- probeDiscord: runtimeProbeDiscord,
402
- });
403
- probeDiscordMock.mockResolvedValue({
404
- ok: true,
405
- bot: { username: "Bob" },
406
- application: {
407
- intents: {
408
- messageContent: "limited",
409
- guildMembers: "disabled",
410
- presence: "disabled",
411
- },
412
- },
413
- elapsedMs: 1,
414
- });
415
-
416
- const cfg = createCfg();
417
- const account = resolveAccount(cfg);
418
-
419
- await discordPlugin.status!.probeAccount!({
420
- account,
421
- timeoutMs: 5000,
422
- cfg,
423
- });
424
-
425
- expect(probeDiscordMock).toHaveBeenCalledWith("discord-token", 5000, {
426
- includeApplication: true,
427
- });
428
- expect(runtimeProbeDiscord).not.toHaveBeenCalled();
429
- });
430
-
431
- it("reports missing voice permissions in targeted capabilities diagnostics", async () => {
432
- const fetchPermissionsSpy = vi
433
- .spyOn(sendModule, "fetchChannelPermissionsDiscord")
434
- .mockResolvedValueOnce({
435
- channelId: "222",
436
- guildId: "123",
437
- permissions: ["ViewChannel", "SendMessages"],
438
- raw: "0",
439
- isDm: false,
440
- channelType: ChannelType.GuildVoice,
441
- });
442
- try {
443
- const cfg = createCfg();
444
- const diagnostics = await discordPlugin.status!.buildCapabilitiesDiagnostics!({
445
- account: resolveAccount(cfg),
446
- timeoutMs: 5000,
447
- cfg,
448
- target: "channel:222",
449
- });
450
-
451
- expect(argAt(fetchPermissionsSpy, 0, 0)).toBe("222");
452
- expect(objectArgAt(fetchPermissionsSpy, 0, 1).token).toBe("discord-token");
453
- const permissions = recordField(diagnostics?.details?.permissions, "permissions");
454
- expect(permissions.channelId).toBe("222");
455
- expect(permissions.missingRequired).toEqual(["Connect", "Speak", "ReadMessageHistory"]);
456
- expect(diagnostics?.lines?.map((line) => line.text).join("\n")).toContain(
457
- "Missing required: Connect, Speak, ReadMessageHistory",
458
- );
459
- } finally {
460
- fetchPermissionsSpy.mockRestore();
461
- }
462
- });
463
-
464
- it("uses direct Discord startup helpers for async startup enrichment", async () => {
465
- const runtimeProbeDiscord = vi.fn(async () => {
466
- throw new Error("runtime Discord probe should not be used");
467
- });
468
- const runtimeMonitorDiscordProvider = vi.fn(async () => {
469
- throw new Error("runtime Discord monitor should not be used");
470
- });
471
- installDiscordRuntime({
472
- probeDiscord: runtimeProbeDiscord,
473
- monitorDiscordProvider: runtimeMonitorDiscordProvider,
474
- });
475
- probeDiscordMock.mockResolvedValue({
476
- ok: true,
477
- bot: { username: "Bob" },
478
- application: {
479
- intents: {
480
- messageContent: "limited",
481
- guildMembers: "disabled",
482
- presence: "disabled",
483
- },
484
- },
485
- elapsedMs: 1,
486
- });
487
- monitorDiscordProviderMock.mockResolvedValue(undefined);
488
-
489
- const cfg = createCfg();
490
- await startDiscordAccount(cfg);
491
-
492
- await vi.waitFor(() =>
493
- expect(probeDiscordMock).toHaveBeenCalledWith("discord-token", 2500, {
494
- includeApplication: true,
495
- }),
496
- );
497
- const monitorParams = objectArgAt(monitorDiscordProviderMock, 0, 0);
498
- expect(monitorParams.token).toBe("discord-token");
499
- expect(monitorParams.accountId).toBe("default");
500
- expect(sleepWithAbortMock).not.toHaveBeenCalled();
501
- expect(runtimeProbeDiscord).not.toHaveBeenCalled();
502
- expect(runtimeMonitorDiscordProvider).not.toHaveBeenCalled();
503
- });
504
-
505
- it("fails loudly before provider startup when a token SecretRef is configured but unresolved", async () => {
506
- const cfg = {
507
- channels: {
508
- discord: {
509
- token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },
510
- },
511
- },
512
- } as unknown as KlawConfig;
513
-
514
- await expect(startDiscordAccount(cfg)).rejects.toThrow(
515
- 'Discord bot token configured for account "default" is unavailable',
516
- );
517
- expect(probeDiscordMock).not.toHaveBeenCalled();
518
- expect(monitorDiscordProviderMock).not.toHaveBeenCalled();
519
- });
520
-
521
- it("does not block Discord monitor startup on the startup probe", async () => {
522
- let resolveProbe:
523
- | ((value: {
524
- ok: true;
525
- bot: { username: string };
526
- application: { intents: { messageContent: "limited" } };
527
- elapsedMs: number;
528
- }) => void)
529
- | undefined;
530
- probeDiscordMock.mockReturnValue(
531
- new Promise((resolve) => {
532
- resolveProbe = resolve;
533
- }),
534
- );
535
- monitorDiscordProviderMock.mockResolvedValue(undefined);
536
-
537
- const cfg = createCfg();
538
- const statusPatches: Array<Record<string, unknown>> = [];
539
- const ctx = createStartAccountContext({
540
- account: resolveAccount(cfg),
541
- cfg,
542
- statusPatchSink: (next) => statusPatches.push({ ...next }),
543
- });
544
-
545
- await discordPlugin.gateway!.startAccount!(ctx);
546
-
547
- const monitorParams = objectArgAt(monitorDiscordProviderMock, 0, 0);
548
- expect(monitorParams.token).toBe("discord-token");
549
- expect(monitorParams.accountId).toBe("default");
550
- await vi.waitFor(() =>
551
- expect(probeDiscordMock).toHaveBeenCalledWith("discord-token", 2500, {
552
- includeApplication: true,
553
- }),
554
- );
555
- expect(statusPatches.filter((patch) => "bot" in patch || "application" in patch)).toEqual([]);
556
-
557
- if (!resolveProbe) {
558
- throw new Error("Expected Discord startup probe resolver to be initialized");
559
- }
560
- resolveProbe({
561
- ok: true,
562
- bot: { username: "AsyncBob" },
563
- application: { intents: { messageContent: "limited" } },
564
- elapsedMs: 1,
565
- });
566
-
567
- await vi.waitFor(() =>
568
- expect(
569
- statusPatches
570
- .filter(
571
- (patch) => (patch.bot as { username?: string } | undefined)?.username === "AsyncBob",
572
- )
573
- .map((patch) => ({
574
- bot: patch.bot,
575
- application: patch.application,
576
- })),
577
- ).toEqual([
578
- {
579
- bot: { username: "AsyncBob" },
580
- application: { intents: { messageContent: "limited" } },
581
- },
582
- ]),
583
- );
584
- });
585
-
586
- it("clears stale Discord probe metadata when the async startup probe degrades", async () => {
587
- probeDiscordMock.mockResolvedValue({
588
- ok: false,
589
- status: 401,
590
- error: "getMe failed (401)",
591
- elapsedMs: 1,
592
- });
593
- monitorDiscordProviderMock.mockResolvedValue(undefined);
594
-
595
- const cfg = createCfg();
596
- const statusPatches: Array<Record<string, unknown>> = [];
597
- const ctx = createStartAccountContext({
598
- account: resolveAccount(cfg),
599
- cfg,
600
- statusPatchSink: (next) => statusPatches.push({ ...next }),
601
- });
602
- ctx.setStatus({
603
- accountId: "default",
604
- bot: { username: "OldBot" },
605
- application: { intents: { messageContent: "enabled" } },
606
- });
607
-
608
- await discordPlugin.gateway!.startAccount!(ctx);
609
-
610
- await vi.waitFor(() =>
611
- expect(
612
- statusPatches
613
- .filter(
614
- (patch) =>
615
- "bot" in patch &&
616
- "application" in patch &&
617
- patch.bot === undefined &&
618
- patch.application === undefined,
619
- )
620
- .map((patch) => ({
621
- bot: patch.bot,
622
- application: patch.application,
623
- })),
624
- ).toEqual([{ bot: undefined, application: undefined }]),
625
- );
626
- });
627
-
628
- it("clears stale Discord probe metadata when the async startup probe throws", async () => {
629
- probeDiscordMock.mockRejectedValue(new Error("probe timed out"));
630
- monitorDiscordProviderMock.mockResolvedValue(undefined);
631
-
632
- const cfg = createCfg();
633
- const statusPatches: Array<Record<string, unknown>> = [];
634
- const ctx = createStartAccountContext({
635
- account: resolveAccount(cfg),
636
- cfg,
637
- statusPatchSink: (next) => statusPatches.push({ ...next }),
638
- });
639
- ctx.setStatus({
640
- accountId: "default",
641
- bot: { username: "OldBot" },
642
- application: { intents: { messageContent: "enabled" } },
643
- });
644
-
645
- await discordPlugin.gateway!.startAccount!(ctx);
646
-
647
- await vi.waitFor(() =>
648
- expect(
649
- statusPatches
650
- .filter(
651
- (patch) =>
652
- "bot" in patch &&
653
- "application" in patch &&
654
- patch.bot === undefined &&
655
- patch.application === undefined,
656
- )
657
- .map((patch) => ({
658
- bot: patch.bot,
659
- application: patch.application,
660
- })),
661
- ).toEqual([{ bot: undefined, application: undefined }]),
662
- );
663
- });
664
-
665
- it("stagger starts later accounts in multi-bot setups", async () => {
666
- probeDiscordMock.mockResolvedValue({
667
- ok: true,
668
- bot: { username: "Cherry" },
669
- application: {
670
- intents: {
671
- messageContent: "limited",
672
- guildMembers: "disabled",
673
- presence: "disabled",
674
- },
675
- },
676
- elapsedMs: 1,
677
- });
678
- monitorDiscordProviderMock.mockResolvedValue(undefined);
679
-
680
- const cfg = {
681
- channels: {
682
- discord: {
683
- accounts: {
684
- // "alpha" sorts before "zeta" so alpha is index 0, zeta is index 1
685
- alpha: { token: "Bot alpha-token", enabled: true },
686
- zeta: { token: "Bot zeta-token", enabled: true },
687
- },
688
- },
689
- },
690
- } as KlawConfig;
691
-
692
- // First account (index 0) — no delay
693
- await startDiscordAccount(cfg, "alpha");
694
- expect(sleepWithAbortMock).not.toHaveBeenCalled();
695
-
696
- // Second account (index 1) — 10s delay
697
- const zetaContext = createStartAccountContext({
698
- account: resolveAccount(cfg, "zeta"),
699
- cfg,
700
- });
701
- await discordPlugin.gateway!.startAccount!(zetaContext);
702
- expect(sleepWithAbortMock).toHaveBeenCalledWith(10_000, zetaContext.abortSignal);
703
- });
704
- });
705
-
706
- describe("discordPlugin bindings", () => {
707
- it("derives DM current conversation ids from direct sender context", () => {
708
- const result = discordPlugin.bindings?.resolveCommandConversation?.({
709
- accountId: "default",
710
- chatType: "direct",
711
- from: "discord:123456789012345678",
712
- originatingTo: "channel:dm-channel-1",
713
- fallbackTo: "channel:dm-channel-1",
714
- });
715
-
716
- expect(result).toEqual({
717
- conversationId: "user:123456789012345678",
718
- });
719
- });
720
-
721
- it("preserves user-prefixed current conversation ids for DM binds", () => {
722
- const result = discordPlugin.bindings?.resolveCommandConversation?.({
723
- accountId: "default",
724
- originatingTo: "user:123456789012345678",
725
- });
726
-
727
- expect(result).toEqual({
728
- conversationId: "user:123456789012345678",
729
- });
730
- });
731
-
732
- it("preserves channel-prefixed current conversation ids for channel binds", () => {
733
- const result = discordPlugin.bindings?.resolveCommandConversation?.({
734
- accountId: "default",
735
- originatingTo: "channel:987654321098765432",
736
- });
737
-
738
- expect(result).toEqual({
739
- conversationId: "channel:987654321098765432",
740
- });
741
- });
742
-
743
- it("preserves channel-prefixed parent ids for thread binds", () => {
744
- const result = discordPlugin.bindings?.resolveCommandConversation?.({
745
- accountId: "default",
746
- originatingTo: "channel:thread-42",
747
- threadId: "thread-42",
748
- threadParentId: "parent-9",
749
- });
750
-
751
- expect(result).toEqual({
752
- conversationId: "thread-42",
753
- parentConversationId: "channel:parent-9",
754
- });
755
- });
756
- });
757
-
758
- describe("discordPlugin security", () => {
759
- it("normalizes dm allowlist entries with trimmed prefixes and mentions", () => {
760
- const resolveDmPolicy = discordPlugin.security?.resolveDmPolicy;
761
- if (!resolveDmPolicy) {
762
- throw new Error("resolveDmPolicy unavailable");
763
- }
764
-
765
- const cfg = {
766
- channels: {
767
- discord: {
768
- token: "discord-token",
769
- dm: { policy: "allowlist", allowFrom: [" discord:<@!123456789> "] },
770
- },
771
- },
772
- } as KlawConfig;
773
-
774
- const result = resolveDmPolicy({
775
- cfg,
776
- account: discordPlugin.config.resolveAccount(cfg, "default"),
777
- });
778
- if (!result) {
779
- throw new Error("discord resolveDmPolicy returned null");
780
- }
781
-
782
- expect(result.policy).toBe("allowlist");
783
- expect(result.allowFrom).toEqual([" discord:<@!123456789> "]);
784
- expect(result.policyPath).toBe("channels.discord.dmPolicy");
785
- expect(result.allowFromPath).toBe("channels.discord.");
786
- expect(result.normalizeEntry?.(" discord:<@!123456789> ")).toBe("123456789");
787
- expect(result.normalizeEntry?.(" user:987654321 ")).toBe("987654321");
788
- });
789
- });
790
-
791
- describe("discordPlugin groups", () => {
792
- it("uses plugin-owned group policy resolvers", () => {
793
- const cfg = {
794
- channels: {
795
- discord: {
796
- token: "discord-test",
797
- guilds: {
798
- guild1: {
799
- requireMention: false,
800
- tools: { allow: ["message.guild"] },
801
- channels: {
802
- "123": {
803
- requireMention: true,
804
- tools: { allow: ["message.channel"] },
805
- },
806
- },
807
- },
808
- },
809
- },
810
- },
811
- } as KlawConfig;
812
-
813
- expect(
814
- discordPlugin.groups?.resolveRequireMention?.({
815
- cfg,
816
- groupSpace: "guild1",
817
- groupId: "123",
818
- }),
819
- ).toBe(true);
820
- expect(
821
- discordPlugin.groups?.resolveToolPolicy?.({
822
- cfg,
823
- groupSpace: "guild1",
824
- groupId: "123",
825
- }),
826
- ).toEqual({ allow: ["message.channel"] });
827
- });
828
- });