@kodelyth/discord 2026.5.39 → 2026.5.42

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 (639) hide show
  1. package/account-inspect-api.ts +6 -0
  2. package/action-runtime-api.ts +1 -0
  3. package/api.ts +130 -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/dist/account-inspect-Dqw-enky.js +81 -0
  11. package/dist/account-inspect-api.js +10 -0
  12. package/dist/accounts-B7OBFePq.js +224 -0
  13. package/dist/action-runtime-api.js +2 -0
  14. package/dist/agent-components.runtime-DVY_1VB4.js +4 -0
  15. package/dist/allow-list-B0s7evD7.js +354 -0
  16. package/dist/api-CXAcv9nZ.js +130 -0
  17. package/dist/api.js +23 -0
  18. package/dist/approval-handler.runtime-B9xUAF3n.js +426 -0
  19. package/dist/audit-DoiK49WO.js +24 -0
  20. package/dist/audit-core-BGrq3G7r.js +105 -0
  21. package/dist/channel-U_aeoFwW.js +795 -0
  22. package/dist/channel-actions-BxEBnEuv.js +173 -0
  23. package/dist/channel-actions.runtime-CPtpH-yl.js +263 -0
  24. package/dist/channel-api-BfjklLby.js +21 -0
  25. package/dist/channel-config-api.js +2 -0
  26. package/dist/channel-plugin-api.js +2 -0
  27. package/dist/channel.setup-BUSC0apv.js +337 -0
  28. package/dist/components-luonoe13.js +909 -0
  29. package/dist/config-api-DSYGqaLQ.js +2 -0
  30. package/dist/config-schema-DIqJBGwC.js +357 -0
  31. package/dist/configured-state.js +6 -0
  32. package/dist/contract-api.js +8 -0
  33. package/dist/conversation-identity-DXAm0_Mk.js +270 -0
  34. package/dist/directory-config-CYbuMmPS.js +49 -0
  35. package/dist/directory-contract-api.js +2 -0
  36. package/dist/directory-live-DX4dLRpJ.js +159 -0
  37. package/dist/doctor-bbKSvGVD.js +244 -0
  38. package/dist/doctor-contract-Btjt6NJD.js +383 -0
  39. package/dist/doctor-contract-api.js +2 -0
  40. package/dist/gateway-registry-BKSpa4GB.js +74 -0
  41. package/dist/handle-action.guild-admin-B5BArS2n.js +286 -0
  42. package/dist/inbound-context-WAOqhGlT.js +48 -0
  43. package/dist/inbound-event-delivery-C-1Ji3WP.js +65 -0
  44. package/dist/index.js +26 -0
  45. package/dist/manager.runtime-DXHynKE4.js +2356 -0
  46. package/dist/message-handler-mXzc3tA_.js +381 -0
  47. package/dist/message-handler.preflight-BPD1a347.js +1113 -0
  48. package/dist/message-handler.process-GUa3aV8z.js +1438 -0
  49. package/dist/message-utils-dUbem16p.js +549 -0
  50. package/dist/outbound-adapter-C18OAc1y.js +536 -0
  51. package/dist/pluralkit-D1Q2x0w5.js +22 -0
  52. package/dist/preflight-audio-CZtpWcIm.js +72 -0
  53. package/dist/preflight-audio.runtime-Brx_0_xW.js +7 -0
  54. package/dist/preview-streaming-D_slNIiO.js +8 -0
  55. package/dist/probe-D--Ca4JF.js +139 -0
  56. package/dist/probe.runtime-DQBchZzv.js +2 -0
  57. package/dist/provider-B2-31CIT.js +9565 -0
  58. package/dist/provider-session.runtime-BwzzSsrH.js +6 -0
  59. package/dist/provider.runtime-CP3oHLls.js +2 -0
  60. package/dist/resolve-allowlist-common-CqxPLcJO.js +34 -0
  61. package/dist/resolve-channels-0LX4pUbB.js +265 -0
  62. package/dist/resolve-users-CztOv0Qs.js +120 -0
  63. package/dist/runtime-DUaw66V_.js +1073 -0
  64. package/dist/runtime-api.actions.js +3 -0
  65. package/dist/runtime-api.js +30 -0
  66. package/dist/runtime-api.lookup.js +7 -0
  67. package/dist/runtime-api.monitor-CvVKvEXW.js +5 -0
  68. package/dist/runtime-api.monitor.js +8 -0
  69. package/dist/runtime-api.send.js +6 -0
  70. package/dist/runtime-api.threads.js +6 -0
  71. package/dist/runtime-fC6f4UF2.js +8 -0
  72. package/dist/runtime-setter-api.js +2 -0
  73. package/dist/secret-config-contract-B6WW5V88.js +115 -0
  74. package/dist/secret-contract-api.js +2 -0
  75. package/dist/security-audit-CnyIQKz6.js +120 -0
  76. package/dist/security-audit-contract-api.js +2 -0
  77. package/dist/security-audit.runtime-CQSkjNLu.js +2 -0
  78. package/dist/security-contract-DLvYOgLM.js +26 -0
  79. package/dist/security-contract-api.js +2 -0
  80. package/dist/security-doctor-DepqtNCI.js +18 -0
  81. package/dist/send-DCtPCHGk.js +881 -0
  82. package/dist/send.components-Bcgxvm52.js +474 -0
  83. package/dist/send.outbound-S9t0UuHc.js +330 -0
  84. package/dist/send.receipt-CDn3GBWC.js +3119 -0
  85. package/dist/send.shared-D4iBnAmn.js +669 -0
  86. package/dist/sender-identity-CxCe3_1a.js +43 -0
  87. package/dist/session-contract-Dwhw3RTY.js +6 -0
  88. package/dist/session-key-api.js +2 -0
  89. package/dist/session-key-normalization-CP8dPUid.js +23 -0
  90. package/dist/setup-entry.js +11 -0
  91. package/dist/setup-plugin-api.js +2 -0
  92. package/dist/shared-AIlvuZXt.js +171 -0
  93. package/dist/subagent-hooks-8bK-mgiU.js +120 -0
  94. package/dist/subagent-hooks-api.js +22 -0
  95. package/dist/system-events-Ba1TklaL.js +34 -0
  96. package/dist/target-resolver-BrtFQtoK.js +82 -0
  97. package/dist/targets-DWLLZE2l.js +3 -0
  98. package/dist/test-api.js +45 -0
  99. package/dist/thread-binding-api.js +4 -0
  100. package/dist/thread-bindings-9aKRmZv0.js +255 -0
  101. package/dist/thread-bindings.discord-api-ssGH5wc2.js +244 -0
  102. package/dist/thread-bindings.manager-0YBHGemk.js +534 -0
  103. package/dist/thread-bindings.session-updates-DJZGIwaU.js +54 -0
  104. package/dist/thread-bindings.state-eTFl-PqJ.js +318 -0
  105. package/dist/timeouts-CEwuGaWT.js +52 -0
  106. package/dist/timeouts.js +2 -0
  107. package/dist/typing-BmJKRpCS.js +14 -0
  108. package/doctor-contract-api.ts +1 -0
  109. package/index.test.ts +13 -0
  110. package/index.ts +24 -0
  111. package/klaw.plugin.json +2 -3822
  112. package/package.json +4 -4
  113. package/runtime-api.actions.ts +15 -0
  114. package/runtime-api.lookup.ts +22 -0
  115. package/runtime-api.monitor.ts +50 -0
  116. package/runtime-api.send.ts +79 -0
  117. package/runtime-api.threads.ts +31 -0
  118. package/runtime-api.ts +181 -0
  119. package/runtime-setter-api.ts +3 -0
  120. package/secret-contract-api.ts +4 -0
  121. package/security-audit-contract-api.ts +1 -0
  122. package/security-contract-api.ts +4 -0
  123. package/session-key-api.ts +1 -0
  124. package/setup-entry.ts +9 -0
  125. package/setup-plugin-api.ts +3 -0
  126. package/src/account-inspect.test.ts +126 -0
  127. package/src/account-inspect.ts +128 -0
  128. package/src/accounts.test.ts +381 -0
  129. package/src/accounts.ts +205 -0
  130. package/src/actions/handle-action.guild-admin.ts +421 -0
  131. package/src/actions/handle-action.test.ts +480 -0
  132. package/src/actions/handle-action.ts +402 -0
  133. package/src/actions/runtime.guild.ts +446 -0
  134. package/src/actions/runtime.messaging.messages.ts +226 -0
  135. package/src/actions/runtime.messaging.reactions.ts +67 -0
  136. package/src/actions/runtime.messaging.runtime.ts +73 -0
  137. package/src/actions/runtime.messaging.send.ts +336 -0
  138. package/src/actions/runtime.messaging.shared.ts +97 -0
  139. package/src/actions/runtime.messaging.ts +37 -0
  140. package/src/actions/runtime.moderation-shared.ts +48 -0
  141. package/src/actions/runtime.moderation.authz.test.ts +151 -0
  142. package/src/actions/runtime.moderation.ts +116 -0
  143. package/src/actions/runtime.presence.test.ts +165 -0
  144. package/src/actions/runtime.presence.ts +117 -0
  145. package/src/actions/runtime.shared.ts +86 -0
  146. package/src/actions/runtime.test.ts +1337 -0
  147. package/src/actions/runtime.ts +87 -0
  148. package/src/api-barrel.test.ts +78 -0
  149. package/src/api.test.ts +152 -0
  150. package/src/api.ts +215 -0
  151. package/src/approval-handler.runtime.test.ts +41 -0
  152. package/src/approval-handler.runtime.ts +633 -0
  153. package/src/approval-native.test.ts +330 -0
  154. package/src/approval-native.ts +219 -0
  155. package/src/approval-runtime.ts +14 -0
  156. package/src/approval-shared.ts +50 -0
  157. package/src/audit-core.ts +178 -0
  158. package/src/audit.test.ts +204 -0
  159. package/src/audit.ts +32 -0
  160. package/src/channel-actions.contract.test.ts +45 -0
  161. package/src/channel-actions.runtime.ts +1 -0
  162. package/src/channel-actions.test.ts +504 -0
  163. package/src/channel-actions.ts +254 -0
  164. package/src/channel-api.ts +29 -0
  165. package/src/channel.conversation.ts +159 -0
  166. package/src/channel.loaders.ts +50 -0
  167. package/src/channel.message-adapter.test.ts +230 -0
  168. package/src/channel.runtime.ts +1 -0
  169. package/src/channel.setup.ts +12 -0
  170. package/src/channel.test.ts +828 -0
  171. package/src/channel.ts +728 -0
  172. package/src/chunk.test.ts +170 -0
  173. package/src/chunk.ts +321 -0
  174. package/src/client.proxy.test.ts +177 -0
  175. package/src/client.test.ts +83 -0
  176. package/src/client.ts +143 -0
  177. package/src/component-custom-id.ts +72 -0
  178. package/src/components-registry.ts +356 -0
  179. package/src/components.builders.ts +409 -0
  180. package/src/components.modal.ts +124 -0
  181. package/src/components.parse.ts +407 -0
  182. package/src/components.test.ts +345 -0
  183. package/src/components.ts +54 -0
  184. package/src/components.types.ts +187 -0
  185. package/src/config-schema.test.ts +439 -0
  186. package/src/config-schema.ts +6 -0
  187. package/src/config-ui-hints.ts +354 -0
  188. package/src/conversation-identity.ts +58 -0
  189. package/src/delivery-retry.ts +52 -0
  190. package/src/directory-cache.ts +116 -0
  191. package/src/directory-config.ts +58 -0
  192. package/src/directory-contract.test.ts +129 -0
  193. package/src/directory-live.test.ts +141 -0
  194. package/src/directory-live.ts +135 -0
  195. package/src/doctor-contract.ts +477 -0
  196. package/src/doctor-shared.ts +5 -0
  197. package/src/doctor.test.ts +393 -0
  198. package/src/doctor.ts +340 -0
  199. package/src/draft-chunking.test.ts +64 -0
  200. package/src/draft-chunking.ts +43 -0
  201. package/src/draft-stream.test.ts +193 -0
  202. package/src/draft-stream.ts +162 -0
  203. package/src/durable-delivery.test.ts +103 -0
  204. package/src/error-body.ts +38 -0
  205. package/src/exec-approvals.test.ts +88 -0
  206. package/src/exec-approvals.ts +110 -0
  207. package/src/gateway-logging.test.ts +98 -0
  208. package/src/gateway-logging.ts +67 -0
  209. package/src/group-policy.ts +113 -0
  210. package/src/guilds.ts +29 -0
  211. package/src/inbound-context.contract.test.ts +11 -0
  212. package/src/inbound-event-delivery.ts +135 -0
  213. package/src/interactive-dispatch.ts +104 -0
  214. package/src/internal/api.commands.ts +51 -0
  215. package/src/internal/api.guild.ts +164 -0
  216. package/src/internal/api.interactions.ts +53 -0
  217. package/src/internal/api.messages.ts +113 -0
  218. package/src/internal/api.reactions.ts +38 -0
  219. package/src/internal/api.test.ts +260 -0
  220. package/src/internal/api.ts +61 -0
  221. package/src/internal/api.users.ts +19 -0
  222. package/src/internal/api.webhooks.ts +13 -0
  223. package/src/internal/client.test.ts +472 -0
  224. package/src/internal/client.ts +310 -0
  225. package/src/internal/command-deploy.test.ts +197 -0
  226. package/src/internal/command-deploy.ts +352 -0
  227. package/src/internal/commands.ts +188 -0
  228. package/src/internal/components.base.ts +65 -0
  229. package/src/internal/components.message.ts +279 -0
  230. package/src/internal/components.modal.ts +95 -0
  231. package/src/internal/components.ts +31 -0
  232. package/src/internal/discord.ts +11 -0
  233. package/src/internal/embeds.ts +35 -0
  234. package/src/internal/entity-cache.ts +98 -0
  235. package/src/internal/event-queue.ts +185 -0
  236. package/src/internal/gateway-close-codes.ts +25 -0
  237. package/src/internal/gateway-dispatch.ts +96 -0
  238. package/src/internal/gateway-identify-limiter.ts +26 -0
  239. package/src/internal/gateway-lifecycle.test.ts +114 -0
  240. package/src/internal/gateway-lifecycle.ts +75 -0
  241. package/src/internal/gateway-rate-limit.ts +104 -0
  242. package/src/internal/gateway.test.ts +676 -0
  243. package/src/internal/gateway.ts +479 -0
  244. package/src/internal/interaction-dispatch.test.ts +148 -0
  245. package/src/internal/interaction-dispatch.ts +162 -0
  246. package/src/internal/interaction-options.ts +98 -0
  247. package/src/internal/interaction-response.ts +53 -0
  248. package/src/internal/interactions.test.ts +329 -0
  249. package/src/internal/interactions.ts +378 -0
  250. package/src/internal/listeners.ts +91 -0
  251. package/src/internal/live-smoke.live.test.ts +26 -0
  252. package/src/internal/modal-fields.ts +95 -0
  253. package/src/internal/payload.ts +69 -0
  254. package/src/internal/rest-body.ts +115 -0
  255. package/src/internal/rest-errors.ts +88 -0
  256. package/src/internal/rest-routes.ts +50 -0
  257. package/src/internal/rest-scheduler.ts +557 -0
  258. package/src/internal/rest.test.ts +681 -0
  259. package/src/internal/rest.ts +322 -0
  260. package/src/internal/schemas.ts +36 -0
  261. package/src/internal/structures.test.ts +43 -0
  262. package/src/internal/structures.ts +280 -0
  263. package/src/internal/test-builders.test-support.ts +167 -0
  264. package/src/internal/voice.ts +49 -0
  265. package/src/media-detection.ts +28 -0
  266. package/src/mentions.test.ts +111 -0
  267. package/src/mentions.ts +147 -0
  268. package/src/monitor/ack-reactions.ts +70 -0
  269. package/src/monitor/acp-bind-here.integration.test.ts +219 -0
  270. package/src/monitor/agent-components-auth.ts +7 -0
  271. package/src/monitor/agent-components-context.ts +154 -0
  272. package/src/monitor/agent-components-data.ts +224 -0
  273. package/src/monitor/agent-components-dm-auth.ts +177 -0
  274. package/src/monitor/agent-components-guild-auth.ts +322 -0
  275. package/src/monitor/agent-components-helpers.runtime.ts +3 -0
  276. package/src/monitor/agent-components-helpers.ts +34 -0
  277. package/src/monitor/agent-components-reply.ts +10 -0
  278. package/src/monitor/agent-components.deps.runtime.ts +2 -0
  279. package/src/monitor/agent-components.dispatch.ts +359 -0
  280. package/src/monitor/agent-components.handlers.ts +303 -0
  281. package/src/monitor/agent-components.modal.ts +160 -0
  282. package/src/monitor/agent-components.plugin-interactive.ts +187 -0
  283. package/src/monitor/agent-components.runtime.ts +14 -0
  284. package/src/monitor/agent-components.system-controls.ts +215 -0
  285. package/src/monitor/agent-components.ts +70 -0
  286. package/src/monitor/agent-components.types.ts +58 -0
  287. package/src/monitor/agent-components.wildcard-controls.ts +171 -0
  288. package/src/monitor/agent-components.wildcard.test.ts +71 -0
  289. package/src/monitor/allow-list.test.ts +14 -0
  290. package/src/monitor/allow-list.ts +631 -0
  291. package/src/monitor/auto-presence.test.ts +184 -0
  292. package/src/monitor/auto-presence.ts +356 -0
  293. package/src/monitor/channel-access.test.ts +113 -0
  294. package/src/monitor/channel-access.ts +102 -0
  295. package/src/monitor/commands.test.ts +24 -0
  296. package/src/monitor/commands.ts +9 -0
  297. package/src/monitor/dm-command-auth.test.ts +274 -0
  298. package/src/monitor/dm-command-auth.ts +259 -0
  299. package/src/monitor/dm-command-decision.test.ts +108 -0
  300. package/src/monitor/dm-command-decision.ts +49 -0
  301. package/src/monitor/exec-approvals.test.ts +225 -0
  302. package/src/monitor/exec-approvals.ts +158 -0
  303. package/src/monitor/format.ts +45 -0
  304. package/src/monitor/gateway-handle.ts +33 -0
  305. package/src/monitor/gateway-metadata.test.ts +29 -0
  306. package/src/monitor/gateway-metadata.ts +298 -0
  307. package/src/monitor/gateway-plugin.test.ts +320 -0
  308. package/src/monitor/gateway-plugin.ts +302 -0
  309. package/src/monitor/gateway-registry.ts +37 -0
  310. package/src/monitor/gateway-supervisor.test.ts +157 -0
  311. package/src/monitor/gateway-supervisor.ts +206 -0
  312. package/src/monitor/inbound-context.test-helpers.ts +37 -0
  313. package/src/monitor/inbound-context.test.ts +112 -0
  314. package/src/monitor/inbound-context.ts +95 -0
  315. package/src/monitor/inbound-dedupe.ts +79 -0
  316. package/src/monitor/inbound-job.test.ts +216 -0
  317. package/src/monitor/inbound-job.ts +118 -0
  318. package/src/monitor/listeners.queue.ts +91 -0
  319. package/src/monitor/listeners.reactions.ts +594 -0
  320. package/src/monitor/listeners.test.ts +209 -0
  321. package/src/monitor/listeners.ts +150 -0
  322. package/src/monitor/message-channel-info.ts +96 -0
  323. package/src/monitor/message-forwarded.ts +114 -0
  324. package/src/monitor/message-handler.batch-gate.test.ts +22 -0
  325. package/src/monitor/message-handler.batch-gate.ts +19 -0
  326. package/src/monitor/message-handler.bot-self-filter.test.ts +68 -0
  327. package/src/monitor/message-handler.context.ts +492 -0
  328. package/src/monitor/message-handler.dm-preflight.ts +119 -0
  329. package/src/monitor/message-handler.draft-preview.ts +426 -0
  330. package/src/monitor/message-handler.hydration.test.ts +80 -0
  331. package/src/monitor/message-handler.hydration.ts +198 -0
  332. package/src/monitor/message-handler.inbound-context.test.ts +61 -0
  333. package/src/monitor/message-handler.module-test-helpers.ts +31 -0
  334. package/src/monitor/message-handler.preflight-channel-access.ts +86 -0
  335. package/src/monitor/message-handler.preflight-channel-context.test.ts +18 -0
  336. package/src/monitor/message-handler.preflight-channel-context.ts +58 -0
  337. package/src/monitor/message-handler.preflight-context.ts +54 -0
  338. package/src/monitor/message-handler.preflight-helpers.ts +164 -0
  339. package/src/monitor/message-handler.preflight-history.ts +23 -0
  340. package/src/monitor/message-handler.preflight-logging.ts +36 -0
  341. package/src/monitor/message-handler.preflight-pluralkit.ts +26 -0
  342. package/src/monitor/message-handler.preflight-runtime.ts +28 -0
  343. package/src/monitor/message-handler.preflight-thread.ts +49 -0
  344. package/src/monitor/message-handler.preflight.acp-bindings.test.ts +371 -0
  345. package/src/monitor/message-handler.preflight.test-helpers.ts +114 -0
  346. package/src/monitor/message-handler.preflight.test.ts +2255 -0
  347. package/src/monitor/message-handler.preflight.ts +822 -0
  348. package/src/monitor/message-handler.preflight.types.ts +115 -0
  349. package/src/monitor/message-handler.process.test.ts +2520 -0
  350. package/src/monitor/message-handler.process.ts +1027 -0
  351. package/src/monitor/message-handler.queue.test.ts +680 -0
  352. package/src/monitor/message-handler.routing-preflight.ts +112 -0
  353. package/src/monitor/message-handler.test-harness.ts +99 -0
  354. package/src/monitor/message-handler.test-helpers.ts +75 -0
  355. package/src/monitor/message-handler.ts +309 -0
  356. package/src/monitor/message-media.ts +536 -0
  357. package/src/monitor/message-run-queue.ts +101 -0
  358. package/src/monitor/message-text.ts +171 -0
  359. package/src/monitor/message-utils.test.ts +1234 -0
  360. package/src/monitor/message-utils.ts +34 -0
  361. package/src/monitor/model-picker-preferences.test.ts +67 -0
  362. package/src/monitor/model-picker-preferences.ts +184 -0
  363. package/src/monitor/model-picker.state.ts +364 -0
  364. package/src/monitor/model-picker.test-utils.ts +26 -0
  365. package/src/monitor/model-picker.test.ts +869 -0
  366. package/src/monitor/model-picker.ts +38 -0
  367. package/src/monitor/model-picker.view.ts +722 -0
  368. package/src/monitor/monitor.agent-components.test.ts +410 -0
  369. package/src/monitor/monitor.test.ts +919 -0
  370. package/src/monitor/monitor.threading-utils.test.ts +614 -0
  371. package/src/monitor/native-command-agent-reply.ts +125 -0
  372. package/src/monitor/native-command-arg-ui.ts +233 -0
  373. package/src/monitor/native-command-auth.ts +309 -0
  374. package/src/monitor/native-command-bypass.ts +13 -0
  375. package/src/monitor/native-command-context.test.ts +105 -0
  376. package/src/monitor/native-command-context.ts +109 -0
  377. package/src/monitor/native-command-dispatch.ts +35 -0
  378. package/src/monitor/native-command-model-picker-apply.ts +209 -0
  379. package/src/monitor/native-command-model-picker-interaction.ts +516 -0
  380. package/src/monitor/native-command-model-picker-ui.ts +357 -0
  381. package/src/monitor/native-command-reply.test.ts +68 -0
  382. package/src/monitor/native-command-reply.ts +185 -0
  383. package/src/monitor/native-command-route.ts +91 -0
  384. package/src/monitor/native-command-status.ts +76 -0
  385. package/src/monitor/native-command-ui.ts +26 -0
  386. package/src/monitor/native-command-ui.types.ts +20 -0
  387. package/src/monitor/native-command.args.ts +45 -0
  388. package/src/monitor/native-command.command-arg.test.ts +108 -0
  389. package/src/monitor/native-command.commands-allowfrom.test.ts +504 -0
  390. package/src/monitor/native-command.model-picker.test.ts +930 -0
  391. package/src/monitor/native-command.options.test.ts +379 -0
  392. package/src/monitor/native-command.options.ts +153 -0
  393. package/src/monitor/native-command.plugin-dispatch.test.ts +1212 -0
  394. package/src/monitor/native-command.runtime.ts +51 -0
  395. package/src/monitor/native-command.status-direct.test.ts +278 -0
  396. package/src/monitor/native-command.test-helpers.ts +64 -0
  397. package/src/monitor/native-command.think-autocomplete.test.ts +411 -0
  398. package/src/monitor/native-command.ts +747 -0
  399. package/src/monitor/native-command.types.ts +9 -0
  400. package/src/monitor/native-interaction-channel-context.ts +50 -0
  401. package/src/monitor/preflight-audio.runtime.ts +9 -0
  402. package/src/monitor/preflight-audio.test.ts +157 -0
  403. package/src/monitor/preflight-audio.ts +130 -0
  404. package/src/monitor/presence-cache.ts +61 -0
  405. package/src/monitor/presence.test.ts +61 -0
  406. package/src/monitor/presence.ts +50 -0
  407. package/src/monitor/provider-session.runtime.ts +12 -0
  408. package/src/monitor/provider.acp.ts +89 -0
  409. package/src/monitor/provider.allowlist.test.ts +217 -0
  410. package/src/monitor/provider.allowlist.ts +398 -0
  411. package/src/monitor/provider.cleanup.ts +41 -0
  412. package/src/monitor/provider.commands.ts +129 -0
  413. package/src/monitor/provider.config-log.ts +45 -0
  414. package/src/monitor/provider.deploy-errors.ts +362 -0
  415. package/src/monitor/provider.deploy.ts +221 -0
  416. package/src/monitor/provider.interactions.ts +160 -0
  417. package/src/monitor/provider.lifecycle.test.ts +734 -0
  418. package/src/monitor/provider.lifecycle.ts +562 -0
  419. package/src/monitor/provider.proxy.test.ts +804 -0
  420. package/src/monitor/provider.rest-proxy.test.ts +389 -0
  421. package/src/monitor/provider.runtime.ts +1 -0
  422. package/src/monitor/provider.skill-dedupe.test.ts +42 -0
  423. package/src/monitor/provider.startup-log.ts +32 -0
  424. package/src/monitor/provider.startup.test.ts +440 -0
  425. package/src/monitor/provider.startup.ts +323 -0
  426. package/src/monitor/provider.test.ts +1173 -0
  427. package/src/monitor/provider.ts +688 -0
  428. package/src/monitor/reply-context.ts +64 -0
  429. package/src/monitor/reply-delivery.test.ts +474 -0
  430. package/src/monitor/reply-delivery.ts +212 -0
  431. package/src/monitor/reply-safety.ts +96 -0
  432. package/src/monitor/rest-fetch.ts +94 -0
  433. package/src/monitor/route-resolution.test.ts +209 -0
  434. package/src/monitor/route-resolution.ts +140 -0
  435. package/src/monitor/sender-identity.ts +81 -0
  436. package/src/monitor/startup-status.test.ts +30 -0
  437. package/src/monitor/startup-status.ts +10 -0
  438. package/src/monitor/status.ts +22 -0
  439. package/src/monitor/system-events.ts +55 -0
  440. package/src/monitor/thread-bindings.config.ts +35 -0
  441. package/src/monitor/thread-bindings.discord-api.test.ts +250 -0
  442. package/src/monitor/thread-bindings.discord-api.ts +310 -0
  443. package/src/monitor/thread-bindings.lifecycle.test.ts +1994 -0
  444. package/src/monitor/thread-bindings.lifecycle.ts +354 -0
  445. package/src/monitor/thread-bindings.manager.ts +551 -0
  446. package/src/monitor/thread-bindings.messages.ts +6 -0
  447. package/src/monitor/thread-bindings.persona.test.ts +34 -0
  448. package/src/monitor/thread-bindings.persona.ts +25 -0
  449. package/src/monitor/thread-bindings.session-adapter.ts +229 -0
  450. package/src/monitor/thread-bindings.session-shared.ts +59 -0
  451. package/src/monitor/thread-bindings.session-updates.ts +35 -0
  452. package/src/monitor/thread-bindings.shared-state.test.ts +39 -0
  453. package/src/monitor/thread-bindings.state.ts +540 -0
  454. package/src/monitor/thread-bindings.ts +48 -0
  455. package/src/monitor/thread-bindings.types.ts +83 -0
  456. package/src/monitor/thread-channel-context.ts +112 -0
  457. package/src/monitor/thread-session-close.test.ts +180 -0
  458. package/src/monitor/thread-session-close.ts +63 -0
  459. package/src/monitor/thread-title.generate.test.ts +209 -0
  460. package/src/monitor/thread-title.test.ts +31 -0
  461. package/src/monitor/thread-title.ts +181 -0
  462. package/src/monitor/threading.auto-thread.test.ts +330 -0
  463. package/src/monitor/threading.auto-thread.ts +287 -0
  464. package/src/monitor/threading.cache.ts +45 -0
  465. package/src/monitor/threading.parent-info.test.ts +156 -0
  466. package/src/monitor/threading.starter.test.ts +279 -0
  467. package/src/monitor/threading.starter.ts +288 -0
  468. package/src/monitor/threading.ts +20 -0
  469. package/src/monitor/threading.types.ts +102 -0
  470. package/src/monitor/timeouts.ts +84 -0
  471. package/src/monitor/typing.test.ts +42 -0
  472. package/src/monitor/typing.ts +17 -0
  473. package/src/monitor.gateway.test.ts +187 -0
  474. package/src/monitor.gateway.ts +75 -0
  475. package/src/monitor.test.ts +1416 -0
  476. package/src/monitor.ts +28 -0
  477. package/src/network-config.test.ts +92 -0
  478. package/src/network-config.ts +79 -0
  479. package/src/normalize.test.ts +56 -0
  480. package/src/normalize.ts +86 -0
  481. package/src/outbound-adapter.interactive-order.test.ts +82 -0
  482. package/src/outbound-adapter.test-harness.ts +207 -0
  483. package/src/outbound-adapter.test.ts +804 -0
  484. package/src/outbound-adapter.ts +326 -0
  485. package/src/outbound-approval.ts +29 -0
  486. package/src/outbound-components.ts +86 -0
  487. package/src/outbound-payload.contract.test.ts +49 -0
  488. package/src/outbound-payload.ts +208 -0
  489. package/src/outbound-send-context.ts +89 -0
  490. package/src/outbound-session-route.test.ts +42 -0
  491. package/src/outbound-session-route.ts +72 -0
  492. package/src/pluralkit.test.ts +67 -0
  493. package/src/pluralkit.ts +58 -0
  494. package/src/preview-streaming.ts +18 -0
  495. package/src/probe.intents.test.ts +94 -0
  496. package/src/probe.parse-token.test.ts +43 -0
  497. package/src/probe.runtime.ts +1 -0
  498. package/src/probe.ts +237 -0
  499. package/src/proxy-fetch.ts +92 -0
  500. package/src/proxy-request-client.test.ts +100 -0
  501. package/src/proxy-request-client.ts +21 -0
  502. package/src/recipient-resolution.ts +39 -0
  503. package/src/resolve-allowlist-common.test.ts +40 -0
  504. package/src/resolve-allowlist-common.ts +39 -0
  505. package/src/resolve-channels.test.ts +341 -0
  506. package/src/resolve-channels.ts +369 -0
  507. package/src/resolve-users.test.ts +243 -0
  508. package/src/resolve-users.ts +184 -0
  509. package/src/retry.test.ts +83 -0
  510. package/src/retry.ts +98 -0
  511. package/src/runtime-api.ts +61 -0
  512. package/src/runtime-config.ts +16 -0
  513. package/src/runtime.ts +23 -0
  514. package/src/secret-config-contract.ts +140 -0
  515. package/src/security-audit.runtime.ts +1 -0
  516. package/src/security-audit.test.ts +245 -0
  517. package/src/security-audit.ts +208 -0
  518. package/src/security-contract.ts +47 -0
  519. package/src/security-doctor.test.ts +25 -0
  520. package/src/security-doctor.ts +20 -0
  521. package/src/security.ts +60 -0
  522. package/src/send-target-parsing.ts +14 -0
  523. package/src/send.channels.ts +139 -0
  524. package/src/send.components.test.ts +330 -0
  525. package/src/send.components.ts +391 -0
  526. package/src/send.creates-thread.test.ts +681 -0
  527. package/src/send.emojis-stickers.ts +57 -0
  528. package/src/send.guild.ts +170 -0
  529. package/src/send.message-request.ts +112 -0
  530. package/src/send.messages.test.ts +59 -0
  531. package/src/send.messages.ts +229 -0
  532. package/src/send.outbound.ts +459 -0
  533. package/src/send.permissions.authz.test.ts +190 -0
  534. package/src/send.permissions.ts +283 -0
  535. package/src/send.reactions.ts +155 -0
  536. package/src/send.receipt.ts +69 -0
  537. package/src/send.sends-basic-channel-messages.test.ts +1068 -0
  538. package/src/send.shared.ts +469 -0
  539. package/src/send.test-harness.ts +56 -0
  540. package/src/send.ts +82 -0
  541. package/src/send.types.ts +191 -0
  542. package/src/send.typing.test.ts +41 -0
  543. package/src/send.typing.ts +9 -0
  544. package/src/send.voice.ts +136 -0
  545. package/src/send.webhook-activity.test.ts +152 -0
  546. package/src/send.webhook.proxy.test.ts +210 -0
  547. package/src/send.webhook.ts +137 -0
  548. package/src/session-contract.ts +3 -0
  549. package/src/session-key-normalization.test.ts +44 -0
  550. package/src/session-key-normalization.ts +47 -0
  551. package/src/setup-account-state.test.ts +113 -0
  552. package/src/setup-account-state.ts +141 -0
  553. package/src/setup-adapter.ts +14 -0
  554. package/src/setup-core.ts +215 -0
  555. package/src/setup-runtime-helpers.ts +10 -0
  556. package/src/setup-surface.test.ts +137 -0
  557. package/src/setup-surface.ts +132 -0
  558. package/src/shared-interactive.test.ts +153 -0
  559. package/src/shared-interactive.ts +161 -0
  560. package/src/shared.test.ts +186 -0
  561. package/src/shared.ts +197 -0
  562. package/src/status-issues.test.ts +97 -0
  563. package/src/status-issues.ts +198 -0
  564. package/src/subagent-hooks.test.ts +465 -0
  565. package/src/subagent-hooks.ts +232 -0
  566. package/src/target-parsing.ts +70 -0
  567. package/src/target-resolver.ts +129 -0
  568. package/src/targets.test.ts +393 -0
  569. package/src/targets.ts +12 -0
  570. package/src/test-http-helpers.ts +10 -0
  571. package/src/test-support/component-runtime.ts +194 -0
  572. package/src/test-support/config.ts +7 -0
  573. package/src/test-support/configured-binding-runtime.ts +29 -0
  574. package/src/test-support/partial-channel.ts +26 -0
  575. package/src/test-support/provider.test-support.ts +547 -0
  576. package/src/token.test.ts +174 -0
  577. package/src/token.ts +107 -0
  578. package/src/ui-colors.ts +27 -0
  579. package/src/ui.ts +20 -0
  580. package/src/voice/access.test.ts +288 -0
  581. package/src/voice/access.ts +126 -0
  582. package/src/voice/audio.test.ts +47 -0
  583. package/src/voice/audio.ts +249 -0
  584. package/src/voice/capture-state.test.ts +48 -0
  585. package/src/voice/capture-state.ts +120 -0
  586. package/src/voice/command.test.ts +170 -0
  587. package/src/voice/command.ts +284 -0
  588. package/src/voice/config.ts +8 -0
  589. package/src/voice/ingress.ts +164 -0
  590. package/src/voice/manager.e2e.test.ts +3286 -0
  591. package/src/voice/manager.ready-listener.test.ts +54 -0
  592. package/src/voice/manager.runtime.ts +14 -0
  593. package/src/voice/manager.ts +1155 -0
  594. package/src/voice/prompt.test.ts +30 -0
  595. package/src/voice/prompt.ts +22 -0
  596. package/src/voice/realtime.ts +1370 -0
  597. package/src/voice/receive-recovery.test.ts +81 -0
  598. package/src/voice/receive-recovery.ts +159 -0
  599. package/src/voice/sanitize.test.ts +34 -0
  600. package/src/voice/sanitize.ts +29 -0
  601. package/src/voice/sdk-runtime.ts +14 -0
  602. package/src/voice/segment.ts +160 -0
  603. package/src/voice/session.ts +81 -0
  604. package/src/voice/speaker-context.ts +127 -0
  605. package/src/voice/tts.ts +151 -0
  606. package/src/voice-message.test.ts +376 -0
  607. package/src/voice-message.ts +474 -0
  608. package/subagent-hooks-api.ts +27 -0
  609. package/test-api.ts +4 -0
  610. package/thread-binding-api.ts +1 -0
  611. package/timeouts.ts +6 -0
  612. package/tsconfig.json +16 -0
  613. package/account-inspect-api.js +0 -7
  614. package/action-runtime-api.js +0 -7
  615. package/api.js +0 -7
  616. package/channel-config-api.js +0 -7
  617. package/channel-plugin-api.js +0 -7
  618. package/configured-state.js +0 -7
  619. package/contract-api.js +0 -7
  620. package/directory-contract-api.js +0 -7
  621. package/doctor-contract-api.js +0 -7
  622. package/index.js +0 -7
  623. package/runtime-api.actions.js +0 -7
  624. package/runtime-api.js +0 -7
  625. package/runtime-api.lookup.js +0 -7
  626. package/runtime-api.monitor.js +0 -7
  627. package/runtime-api.send.js +0 -7
  628. package/runtime-api.threads.js +0 -7
  629. package/runtime-setter-api.js +0 -7
  630. package/secret-contract-api.js +0 -7
  631. package/security-audit-contract-api.js +0 -7
  632. package/security-contract-api.js +0 -7
  633. package/session-key-api.js +0 -7
  634. package/setup-entry.js +0 -7
  635. package/setup-plugin-api.js +0 -7
  636. package/subagent-hooks-api.js +0 -7
  637. package/test-api.js +0 -7
  638. package/thread-binding-api.js +0 -7
  639. package/timeouts.js +0 -7
@@ -0,0 +1,393 @@
1
+ import type { KlawConfig } from "klaw/plugin-sdk/config-contracts";
2
+ import { beforeEach, describe, expect, it, vi } from "vitest";
3
+ import {
4
+ resetDiscordDirectoryCacheForTest,
5
+ resolveDiscordDirectoryUserId,
6
+ } from "./directory-cache.js";
7
+ import * as directoryLive from "./directory-live.js";
8
+ import {
9
+ resolveDiscordGroupRequireMention,
10
+ resolveDiscordGroupToolPolicy,
11
+ } from "./group-policy.js";
12
+ import { normalizeDiscordMessagingTarget } from "./normalize.js";
13
+ import { parseDiscordTarget, resolveDiscordChannelId, resolveDiscordTarget } from "./targets.js";
14
+
15
+ function expectTargetFields(
16
+ target: unknown,
17
+ expected: { kind: string; id: string; normalized?: string },
18
+ ): void {
19
+ if (!target || typeof target !== "object") {
20
+ throw new Error("Expected target record");
21
+ }
22
+ const actual = target as Record<string, unknown>;
23
+ expect(actual.kind).toBe(expected.kind);
24
+ expect(actual.id).toBe(expected.id);
25
+ if (expected.normalized !== undefined) {
26
+ expect(actual.normalized).toBe(expected.normalized);
27
+ }
28
+ }
29
+
30
+ describe("parseDiscordTarget", () => {
31
+ it("parses user mention and prefixes", () => {
32
+ const cases = [
33
+ { input: "<@123>", id: "123", normalized: "user:123" },
34
+ { input: "<@!456>", id: "456", normalized: "user:456" },
35
+ { input: "user:789", id: "789", normalized: "user:789" },
36
+ { input: "discord:987", id: "987", normalized: "user:987" },
37
+ { input: "discord:user:987", id: "987", normalized: "user:987" },
38
+ ] as const;
39
+ for (const testCase of cases) {
40
+ expectTargetFields(parseDiscordTarget(testCase.input), {
41
+ kind: "user",
42
+ id: testCase.id,
43
+ normalized: testCase.normalized,
44
+ });
45
+ }
46
+ });
47
+
48
+ it("parses channel targets", () => {
49
+ const cases = [
50
+ { input: "channel:555", id: "555", normalized: "channel:555" },
51
+ { input: "discord:channel:555", id: "555", normalized: "channel:555" },
52
+ { input: "general", id: "general", normalized: "channel:general" },
53
+ ] as const;
54
+ for (const testCase of cases) {
55
+ expectTargetFields(parseDiscordTarget(testCase.input), {
56
+ kind: "channel",
57
+ id: testCase.id,
58
+ normalized: testCase.normalized,
59
+ });
60
+ }
61
+ });
62
+
63
+ it("accepts numeric ids when a default kind is provided", () => {
64
+ expectTargetFields(parseDiscordTarget("123", { defaultKind: "channel" }), {
65
+ kind: "channel",
66
+ id: "123",
67
+ normalized: "channel:123",
68
+ });
69
+ });
70
+
71
+ it("rejects invalid parse targets", () => {
72
+ const cases = [
73
+ { input: "123", expectedMessage: /Ambiguous Discord recipient/ },
74
+ { input: "@bob", expectedMessage: /Discord DMs require a user id/ },
75
+ ] as const;
76
+ for (const testCase of cases) {
77
+ expect(() => parseDiscordTarget(testCase.input), testCase.input).toThrow(
78
+ testCase.expectedMessage,
79
+ );
80
+ }
81
+ });
82
+
83
+ it("guides ambiguous numeric recipients with all supported explicit formats", () => {
84
+ expect(() => parseDiscordTarget("123456789")).toThrow(
85
+ 'Ambiguous Discord recipient "123456789". For DMs use "user:123456789" or "<@123456789>"; for channels use "channel:123456789".',
86
+ );
87
+ });
88
+ });
89
+
90
+ describe("resolveDiscordChannelId", () => {
91
+ it("strips channel: prefix and accepts raw ids", () => {
92
+ expect(resolveDiscordChannelId("channel:123")).toBe("123");
93
+ expect(resolveDiscordChannelId("123")).toBe("123");
94
+ });
95
+
96
+ it("rejects user targets", () => {
97
+ expect(() => resolveDiscordChannelId("user:123")).toThrow(/channel id is required/i);
98
+ });
99
+ });
100
+
101
+ describe("resolveDiscordTarget", () => {
102
+ const cfg = { channels: { discord: {} } } as KlawConfig;
103
+
104
+ beforeEach(() => {
105
+ vi.restoreAllMocks();
106
+ resetDiscordDirectoryCacheForTest();
107
+ });
108
+
109
+ it("returns a resolved user for usernames", async () => {
110
+ vi.spyOn(directoryLive, "listDiscordDirectoryPeersLive").mockResolvedValueOnce([
111
+ { kind: "user", id: "user:999", name: "Jane" } as const,
112
+ ]);
113
+
114
+ expectTargetFields(await resolveDiscordTarget("jane", { cfg, accountId: "default" }), {
115
+ kind: "user",
116
+ id: "999",
117
+ normalized: "user:999",
118
+ });
119
+ });
120
+
121
+ it("falls back to parsing when lookup misses", async () => {
122
+ vi.spyOn(directoryLive, "listDiscordDirectoryPeersLive").mockResolvedValueOnce([]);
123
+ expectTargetFields(await resolveDiscordTarget("general", { cfg, accountId: "default" }), {
124
+ kind: "channel",
125
+ id: "general",
126
+ });
127
+ });
128
+
129
+ it("does not call directory lookup for explicit user ids", async () => {
130
+ const listPeers = vi.spyOn(directoryLive, "listDiscordDirectoryPeersLive");
131
+ expectTargetFields(await resolveDiscordTarget("user:123", { cfg, accountId: "default" }), {
132
+ kind: "user",
133
+ id: "123",
134
+ });
135
+ expect(listPeers).not.toHaveBeenCalled();
136
+ });
137
+
138
+ it("treats bare numeric ids in allowFrom as users even when channels are the default", async () => {
139
+ const listPeers = vi.spyOn(directoryLive, "listDiscordDirectoryPeersLive");
140
+ const cfg = {
141
+ channels: {
142
+ discord: {
143
+ accounts: {
144
+ default: {
145
+ allowFrom: ["123"],
146
+ },
147
+ },
148
+ },
149
+ },
150
+ } as KlawConfig;
151
+
152
+ expectTargetFields(
153
+ await resolveDiscordTarget("123", { cfg, accountId: "default" }, { defaultKind: "channel" }),
154
+ { kind: "user", id: "123", normalized: "user:123" },
155
+ );
156
+ expect(listPeers).not.toHaveBeenCalled();
157
+ });
158
+
159
+ it("uses legacy dm.allowFrom when disambiguating bare numeric ids", async () => {
160
+ const cfg = {
161
+ channels: {
162
+ discord: {
163
+ accounts: {
164
+ default: {
165
+ dm: { allowFrom: ["456"] },
166
+ },
167
+ },
168
+ },
169
+ },
170
+ } as KlawConfig;
171
+
172
+ expectTargetFields(
173
+ await resolveDiscordTarget("456", { cfg, accountId: "default" }, { defaultKind: "channel" }),
174
+ { kind: "user", id: "456", normalized: "user:456" },
175
+ );
176
+ });
177
+
178
+ it("prefers top-level allowFrom over legacy dm.allowFrom for bare numeric ids", async () => {
179
+ const cfg = {
180
+ channels: {
181
+ discord: {
182
+ accounts: {
183
+ default: {
184
+ allowFrom: ["123"],
185
+ dm: { allowFrom: ["456"] },
186
+ },
187
+ },
188
+ },
189
+ },
190
+ } as KlawConfig;
191
+
192
+ expectTargetFields(
193
+ await resolveDiscordTarget("456", { cfg, accountId: "default" }, { defaultKind: "channel" }),
194
+ { kind: "channel", id: "456", normalized: "channel:456" },
195
+ );
196
+ });
197
+
198
+ it("uses account legacy dm.allowFrom before inherited root allowFrom for bare numeric ids", async () => {
199
+ const cfg = {
200
+ channels: {
201
+ discord: {
202
+ allowFrom: ["123"],
203
+ accounts: {
204
+ work: {
205
+ dm: { allowFrom: ["456"] },
206
+ },
207
+ },
208
+ },
209
+ },
210
+ } as KlawConfig;
211
+
212
+ expectTargetFields(
213
+ await resolveDiscordTarget("456", { cfg, accountId: "work" }, { defaultKind: "channel" }),
214
+ { kind: "user", id: "456", normalized: "user:456" },
215
+ );
216
+ expectTargetFields(
217
+ await resolveDiscordTarget("123", { cfg, accountId: "work" }, { defaultKind: "channel" }),
218
+ { kind: "channel", id: "123", normalized: "channel:123" },
219
+ );
220
+ });
221
+
222
+ it("caches username lookups under the configured default account when accountId is omitted", async () => {
223
+ const cfg = {
224
+ channels: {
225
+ discord: {
226
+ defaultAccount: "work",
227
+ accounts: {
228
+ work: {
229
+ token: "discord-work",
230
+ },
231
+ },
232
+ },
233
+ },
234
+ } as KlawConfig;
235
+
236
+ vi.spyOn(directoryLive, "listDiscordDirectoryPeersLive").mockResolvedValueOnce([
237
+ { kind: "user", id: "user:999", name: "Jane" } as const,
238
+ ]);
239
+
240
+ expectTargetFields(await resolveDiscordTarget("jane", { cfg }), {
241
+ kind: "user",
242
+ id: "999",
243
+ normalized: "user:999",
244
+ });
245
+ expect(resolveDiscordDirectoryUserId({ accountId: "work", handle: "jane" })).toBe("999");
246
+ expect(resolveDiscordDirectoryUserId({ accountId: "default", handle: "jane" })).toBeUndefined();
247
+ });
248
+ });
249
+
250
+ describe("normalizeDiscordMessagingTarget", () => {
251
+ it("defaults raw numeric ids to channels", () => {
252
+ expect(normalizeDiscordMessagingTarget("123")).toBe("channel:123");
253
+ });
254
+ });
255
+
256
+ describe("discord group policy", () => {
257
+ it("prefers channel policy, then guild policy, with sender-specific overrides", () => {
258
+ const discordCfg = {
259
+ channels: {
260
+ discord: {
261
+ token: "discord-test",
262
+ guilds: {
263
+ guild1: {
264
+ requireMention: false,
265
+ tools: { allow: ["message.guild"] },
266
+ toolsBySender: {
267
+ "id:user:guild-admin": { allow: ["sessions.list"] },
268
+ },
269
+ channels: {
270
+ "123": {
271
+ requireMention: true,
272
+ tools: { allow: ["message.channel"] },
273
+ toolsBySender: {
274
+ "id:user:channel-admin": { deny: ["exec"] },
275
+ },
276
+ },
277
+ },
278
+ },
279
+ },
280
+ },
281
+ },
282
+ } as any;
283
+
284
+ expect(
285
+ resolveDiscordGroupRequireMention({ cfg: discordCfg, groupSpace: "guild1", groupId: "123" }),
286
+ ).toBe(true);
287
+ expect(
288
+ resolveDiscordGroupRequireMention({
289
+ cfg: discordCfg,
290
+ groupSpace: "guild1",
291
+ groupId: "missing",
292
+ }),
293
+ ).toBe(false);
294
+ expect(
295
+ resolveDiscordGroupToolPolicy({
296
+ cfg: discordCfg,
297
+ groupSpace: "guild1",
298
+ groupId: "123",
299
+ senderId: "user:channel-admin",
300
+ }),
301
+ ).toEqual({ deny: ["exec"] });
302
+ expect(
303
+ resolveDiscordGroupToolPolicy({
304
+ cfg: discordCfg,
305
+ groupSpace: "guild1",
306
+ groupId: "123",
307
+ senderId: "user:someone",
308
+ }),
309
+ ).toEqual({ allow: ["message.channel"] });
310
+ expect(
311
+ resolveDiscordGroupToolPolicy({
312
+ cfg: discordCfg,
313
+ groupSpace: "guild1",
314
+ groupId: "missing",
315
+ senderId: "user:guild-admin",
316
+ }),
317
+ ).toEqual({ allow: ["sessions.list"] });
318
+ expect(
319
+ resolveDiscordGroupToolPolicy({
320
+ cfg: discordCfg,
321
+ groupSpace: "guild1",
322
+ groupId: "missing",
323
+ senderId: "user:someone",
324
+ }),
325
+ ).toEqual({ allow: ["message.guild"] });
326
+ });
327
+
328
+ it("honors account-scoped guild and channel overrides", () => {
329
+ const discordCfg = {
330
+ channels: {
331
+ discord: {
332
+ token: "discord-test",
333
+ guilds: {
334
+ guild1: {
335
+ requireMention: true,
336
+ tools: { allow: ["message.root"] },
337
+ },
338
+ },
339
+ accounts: {
340
+ work: {
341
+ token: "discord-work",
342
+ guilds: {
343
+ guild1: {
344
+ requireMention: false,
345
+ tools: { allow: ["message.account"] },
346
+ channels: {
347
+ "123": {
348
+ requireMention: true,
349
+ tools: { allow: ["message.account-channel"] },
350
+ },
351
+ },
352
+ },
353
+ },
354
+ },
355
+ },
356
+ },
357
+ },
358
+ } as any;
359
+
360
+ expect(
361
+ resolveDiscordGroupRequireMention({
362
+ cfg: discordCfg,
363
+ accountId: "work",
364
+ groupSpace: "guild1",
365
+ groupId: "missing",
366
+ }),
367
+ ).toBe(false);
368
+ expect(
369
+ resolveDiscordGroupRequireMention({
370
+ cfg: discordCfg,
371
+ accountId: "work",
372
+ groupSpace: "guild1",
373
+ groupId: "123",
374
+ }),
375
+ ).toBe(true);
376
+ expect(
377
+ resolveDiscordGroupToolPolicy({
378
+ cfg: discordCfg,
379
+ accountId: "work",
380
+ groupSpace: "guild1",
381
+ groupId: "missing",
382
+ }),
383
+ ).toEqual({ allow: ["message.account"] });
384
+ expect(
385
+ resolveDiscordGroupToolPolicy({
386
+ cfg: discordCfg,
387
+ accountId: "work",
388
+ groupSpace: "guild1",
389
+ groupId: "123",
390
+ }),
391
+ ).toEqual({ allow: ["message.account-channel"] });
392
+ });
393
+ });
package/src/targets.ts ADDED
@@ -0,0 +1,12 @@
1
+ import {
2
+ parseDiscordTarget,
3
+ type DiscordTarget,
4
+ type DiscordTargetKind,
5
+ type DiscordTargetParseOptions,
6
+ resolveDiscordChannelId,
7
+ } from "./target-parsing.js";
8
+ import { resolveDiscordTarget } from "./target-resolver.js";
9
+
10
+ export { parseDiscordTarget, resolveDiscordChannelId };
11
+ export type { DiscordTarget, DiscordTargetKind, DiscordTargetParseOptions };
12
+ export { resolveDiscordTarget };
@@ -0,0 +1,10 @@
1
+ export function jsonResponse(body: unknown, status = 200): Response {
2
+ return new Response(JSON.stringify(body), { status });
3
+ }
4
+
5
+ export function urlToString(url: Request | URL | string): string {
6
+ if (typeof url === "string") {
7
+ return url;
8
+ }
9
+ return "url" in url ? url.url : String(url);
10
+ }
@@ -0,0 +1,194 @@
1
+ import {
2
+ parsePluginBindingApprovalCustomId,
3
+ resolvePinnedMainDmOwnerFromAllowlist,
4
+ } from "klaw/plugin-sdk/conversation-runtime";
5
+ import { isSingleUseReplyToMode } from "klaw/plugin-sdk/reply-reference";
6
+ import { vi, type Mock } from "vitest";
7
+
8
+ type UnknownMock = Mock<(...args: unknown[]) => unknown>;
9
+ type AsyncUnknownMock = Mock<(...args: unknown[]) => Promise<unknown>>;
10
+ type DispatchReplyWithBufferedBlockDispatcherFn =
11
+ typeof import("klaw/plugin-sdk/reply-dispatch-runtime").dispatchReplyWithBufferedBlockDispatcher;
12
+ type DispatchReplyMock = Mock<DispatchReplyWithBufferedBlockDispatcherFn>;
13
+
14
+ type DiscordComponentRuntimeMocks = {
15
+ buildPluginBindingResolvedTextMock: UnknownMock;
16
+ dispatchPluginInteractiveHandlerMock: AsyncUnknownMock;
17
+ dispatchReplyMock: DispatchReplyMock;
18
+ enqueueSystemEventMock: UnknownMock;
19
+ readAllowFromStoreMock: AsyncUnknownMock;
20
+ readSessionUpdatedAtMock: UnknownMock;
21
+ recordInboundSessionMock: AsyncUnknownMock;
22
+ resolveStorePathMock: UnknownMock;
23
+ resolvePluginConversationBindingApprovalMock: AsyncUnknownMock;
24
+ upsertPairingRequestMock: AsyncUnknownMock;
25
+ };
26
+
27
+ const runtimeMocks = vi.hoisted(
28
+ (): DiscordComponentRuntimeMocks => ({
29
+ buildPluginBindingResolvedTextMock: vi.fn(),
30
+ dispatchPluginInteractiveHandlerMock: vi.fn(),
31
+ dispatchReplyMock: vi.fn<DispatchReplyWithBufferedBlockDispatcherFn>(),
32
+ enqueueSystemEventMock: vi.fn(),
33
+ readAllowFromStoreMock: vi.fn(),
34
+ readSessionUpdatedAtMock: vi.fn(),
35
+ recordInboundSessionMock: vi.fn(),
36
+ resolveStorePathMock: vi.fn(),
37
+ resolvePluginConversationBindingApprovalMock: vi.fn(),
38
+ upsertPairingRequestMock: vi.fn(),
39
+ }),
40
+ );
41
+
42
+ export const readAllowFromStoreMock: AsyncUnknownMock = runtimeMocks.readAllowFromStoreMock;
43
+ export const dispatchPluginInteractiveHandlerMock: AsyncUnknownMock =
44
+ runtimeMocks.dispatchPluginInteractiveHandlerMock;
45
+ export const dispatchReplyMock: DispatchReplyMock = runtimeMocks.dispatchReplyMock;
46
+ export const enqueueSystemEventMock: UnknownMock = runtimeMocks.enqueueSystemEventMock;
47
+ export const upsertPairingRequestMock: AsyncUnknownMock = runtimeMocks.upsertPairingRequestMock;
48
+ export const recordInboundSessionMock: AsyncUnknownMock = runtimeMocks.recordInboundSessionMock;
49
+ export const readSessionUpdatedAtMock: UnknownMock = runtimeMocks.readSessionUpdatedAtMock;
50
+ export const resolveStorePathMock: UnknownMock = runtimeMocks.resolveStorePathMock;
51
+ const resolvePluginConversationBindingApprovalMock: AsyncUnknownMock =
52
+ runtimeMocks.resolvePluginConversationBindingApprovalMock;
53
+ const buildPluginBindingResolvedTextMock: UnknownMock =
54
+ runtimeMocks.buildPluginBindingResolvedTextMock;
55
+
56
+ async function readChannelIngressStoreAllowFromForDmPolicy(params: {
57
+ provider: string;
58
+ accountId: string;
59
+ dmPolicy?: string | null;
60
+ shouldRead?: boolean | null;
61
+ }) {
62
+ if (
63
+ params.shouldRead === false ||
64
+ params.dmPolicy === "allowlist" ||
65
+ params.dmPolicy === "open"
66
+ ) {
67
+ return [];
68
+ }
69
+ return await readAllowFromStoreMock(params.provider, params.accountId);
70
+ }
71
+
72
+ vi.mock("../monitor/agent-components-helpers.runtime.js", () => {
73
+ return {
74
+ readChannelIngressStoreAllowFromForDmPolicy,
75
+ resolvePinnedMainDmOwnerFromAllowlist,
76
+ upsertChannelPairingRequest: (...args: unknown[]) => upsertPairingRequestMock(...args),
77
+ };
78
+ });
79
+
80
+ vi.mock("../monitor/agent-components.runtime.js", () => {
81
+ return {
82
+ buildPluginBindingResolvedText: (...args: unknown[]) =>
83
+ buildPluginBindingResolvedTextMock(...args),
84
+ createReplyReferencePlanner: vi.fn(
85
+ (params: {
86
+ existingId?: string;
87
+ hasReplied?: boolean;
88
+ replyToMode?: "off" | "first" | "all" | "batched";
89
+ startId?: string;
90
+ }) => {
91
+ let hasReplied = params.hasReplied ?? false;
92
+ let nextId = params.existingId ?? params.startId;
93
+ return {
94
+ hasReplied() {
95
+ return hasReplied;
96
+ },
97
+ markSent() {
98
+ hasReplied = true;
99
+ },
100
+ use() {
101
+ if (params.replyToMode === "off") {
102
+ return undefined;
103
+ }
104
+ if (isSingleUseReplyToMode(params.replyToMode ?? "off") && hasReplied) {
105
+ return undefined;
106
+ }
107
+ const value = nextId;
108
+ hasReplied = true;
109
+ nextId = undefined;
110
+ return value;
111
+ },
112
+ };
113
+ },
114
+ ),
115
+ dispatchPluginInteractiveHandler: (...args: unknown[]) =>
116
+ dispatchPluginInteractiveHandlerMock(...args),
117
+ dispatchReplyWithBufferedBlockDispatcher: dispatchReplyMock,
118
+ finalizeInboundContext: vi.fn((ctx) => ctx),
119
+ parsePluginBindingApprovalCustomId,
120
+ recordInboundSession: (...args: unknown[]) => recordInboundSessionMock(...args),
121
+ resolveChunkMode: vi.fn(() => "sentences"),
122
+ resolvePluginConversationBindingApproval: (...args: unknown[]) =>
123
+ resolvePluginConversationBindingApprovalMock(...args),
124
+ resolveTextChunkLimit: vi.fn(() => 2000),
125
+ };
126
+ });
127
+
128
+ vi.mock("../interactive-dispatch.js", () => {
129
+ return {
130
+ dispatchDiscordPluginInteractiveHandler: (...args: unknown[]) =>
131
+ dispatchPluginInteractiveHandlerMock(...args),
132
+ };
133
+ });
134
+
135
+ vi.mock("../monitor/agent-components.deps.runtime.js", () => {
136
+ return {
137
+ enqueueSystemEvent: (...args: unknown[]) => enqueueSystemEventMock(...args),
138
+ readSessionUpdatedAt: (...args: unknown[]) => readSessionUpdatedAtMock(...args),
139
+ resolveStorePath: (...args: unknown[]) => resolveStorePathMock(...args),
140
+ };
141
+ });
142
+
143
+ vi.mock("../interactive-dispatch.js", async () => {
144
+ const actual = await vi.importActual<typeof import("../interactive-dispatch.js")>(
145
+ "../interactive-dispatch.js",
146
+ );
147
+ return {
148
+ ...actual,
149
+ dispatchDiscordPluginInteractiveHandler: (...args: unknown[]) =>
150
+ dispatchPluginInteractiveHandlerMock(...args),
151
+ };
152
+ });
153
+
154
+ export function resetDiscordComponentRuntimeMocks() {
155
+ dispatchPluginInteractiveHandlerMock.mockReset().mockResolvedValue({
156
+ matched: false,
157
+ handled: false,
158
+ duplicate: false,
159
+ });
160
+ dispatchReplyMock.mockClear();
161
+ enqueueSystemEventMock.mockClear();
162
+ readAllowFromStoreMock.mockClear().mockResolvedValue([]);
163
+ readSessionUpdatedAtMock.mockClear().mockReturnValue(undefined);
164
+ upsertPairingRequestMock.mockClear().mockResolvedValue({ code: "PAIRCODE", created: true });
165
+ recordInboundSessionMock.mockClear().mockResolvedValue(undefined);
166
+ resolveStorePathMock.mockClear().mockReturnValue("/tmp/klaw-sessions-test.json");
167
+ resolvePluginConversationBindingApprovalMock.mockReset().mockResolvedValue({
168
+ status: "approved",
169
+ binding: {
170
+ bindingId: "binding-1",
171
+ pluginId: "klaw-codex-app-server",
172
+ pluginName: "Klaw App Server",
173
+ pluginRoot: "/plugins/codex",
174
+ channel: "discord",
175
+ accountId: "default",
176
+ conversationId: "user:123456789",
177
+ boundAt: Date.now(),
178
+ },
179
+ request: {
180
+ id: "approval-1",
181
+ pluginId: "klaw-codex-app-server",
182
+ pluginName: "Klaw App Server",
183
+ pluginRoot: "/plugins/codex",
184
+ requestedAt: Date.now(),
185
+ conversation: {
186
+ channel: "discord",
187
+ accountId: "default",
188
+ conversationId: "user:123456789",
189
+ },
190
+ },
191
+ decision: "allow-once",
192
+ });
193
+ buildPluginBindingResolvedTextMock.mockReset().mockReturnValue("Binding approved.");
194
+ }
@@ -0,0 +1,7 @@
1
+ import type { KlawConfig } from "klaw/plugin-sdk/config-contracts";
2
+
3
+ export const EMPTY_DISCORD_TEST_CONFIG = {} as KlawConfig;
4
+
5
+ export const EMPTY_DISCORD_TEST_OPTS = {
6
+ cfg: EMPTY_DISCORD_TEST_CONFIG,
7
+ };
@@ -0,0 +1,29 @@
1
+ type ConfiguredBindingConversationRuntimeModule = {
2
+ ensureConfiguredBindingRouteReady: (...args: never[]) => unknown;
3
+ resolveConfiguredBindingRoute: (...args: never[]) => unknown;
4
+ };
5
+
6
+ export async function createConfiguredBindingConversationRuntimeModuleMock<
7
+ TModule extends ConfiguredBindingConversationRuntimeModule,
8
+ >(
9
+ params: {
10
+ ensureConfiguredBindingRouteReadyMock: (
11
+ ...args: Parameters<TModule["ensureConfiguredBindingRouteReady"]>
12
+ ) => ReturnType<TModule["ensureConfiguredBindingRouteReady"]>;
13
+ resolveConfiguredBindingRouteMock: (
14
+ ...args: Parameters<TModule["resolveConfiguredBindingRoute"]>
15
+ ) => ReturnType<TModule["resolveConfiguredBindingRoute"]>;
16
+ },
17
+ loadActual: () => Promise<TModule>,
18
+ ) {
19
+ const actual = await loadActual();
20
+ return {
21
+ ...actual,
22
+ ensureConfiguredBindingRouteReady: (
23
+ ...args: Parameters<TModule["ensureConfiguredBindingRouteReady"]>
24
+ ) => params.ensureConfiguredBindingRouteReadyMock(...args),
25
+ resolveConfiguredBindingRoute: (
26
+ ...args: Parameters<TModule["resolveConfiguredBindingRoute"]>
27
+ ) => params.resolveConfiguredBindingRouteMock(...args),
28
+ } satisfies TModule;
29
+ }
@@ -0,0 +1,26 @@
1
+ const DISCORD_PARTIAL_CHANNEL_RAW_DATA_ERROR =
2
+ "Cannot access rawData on partial Channel. Use fetch() to populate data.";
3
+
4
+ export function defineThrowingDiscordChannelGetter(
5
+ channel: object,
6
+ key: string,
7
+ message = DISCORD_PARTIAL_CHANNEL_RAW_DATA_ERROR,
8
+ ) {
9
+ Object.defineProperty(channel, key, {
10
+ configurable: true,
11
+ enumerable: true,
12
+ get() {
13
+ throw new Error(message);
14
+ },
15
+ });
16
+ }
17
+
18
+ export function createPartialDiscordChannelWithThrowingGetters<T extends object>(
19
+ channel: T,
20
+ keys: readonly string[],
21
+ ): T {
22
+ for (const key of keys) {
23
+ defineThrowingDiscordChannelGetter(channel, key);
24
+ }
25
+ return channel;
26
+ }