@desplega.ai/agent-swarm 2.7.8 → 2.7.10

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 (380) hide show
  1. package/dist/acp-adapter-srfhs1s9.js +16 -0
  2. package/dist/{actions-4m1ct4nh.js → actions-b8aqhrsg.js} +20 -19
  3. package/dist/{amp-adapter-txqh7eqj.js → amp-adapter-4c165vgn.js} +3 -3
  4. package/dist/{anthropic-messages-xey2skwx.js → anthropic-messages-jkva0zps.js} +68 -78
  5. package/dist/app-m9khefrh.js +20 -0
  6. package/dist/{assistant-gd08kr9e.js → assistant-rh4v3ntz.js} +22 -21
  7. package/dist/{azure-openai-responses-26t7j9ra.js → azure-openai-responses-wgtqkbr3.js} +5 -10
  8. package/dist/{boot-args-schema-tjrkpbvm.js → boot-args-schema-hwkc8bzv.js} +1 -1
  9. package/dist/{boot-reembed-21hbck22.js → boot-reembed-5y6yw9sj.js} +1 -1
  10. package/dist/{boot-reembed-mdxd3wgp.js → boot-reembed-fdyk55h4.js} +1 -1
  11. package/dist/{boot-scrub-sweep-qy0zr9t2.js → boot-scrub-sweep-r5r8kqsn.js} +4 -4
  12. package/dist/{boot-seeds-n46eaxdv.js → boot-seeds-8f9zt5cm.js} +5 -4
  13. package/dist/{boxd-nv507va8.js → boxd-qbkxy6ap.js} +1 -1
  14. package/dist/{claude-adapter-j37w2eds.js → claude-adapter-s5df247c.js} +8 -8
  15. package/dist/{claude-managed-adapter-8jvcma9a.js → claude-managed-adapter-h74d06yz.js} +4 -4
  16. package/dist/{claude-managed-setup-rzkjmgc1.js → claude-managed-setup-9gsmwzyx.js} +4 -4
  17. package/dist/{claude-sdk-session-4k7w73t0.js → claude-sdk-session-dq1j4nz9.js} +7901 -7718
  18. package/dist/{cli-s4ss5g59.js → cli-0m7rtm11.js} +5 -5
  19. package/dist/{cli-fzachfnf.js → cli-16phend6.js} +5 -5
  20. package/dist/{cli-yqefz277.js → cli-18qt3few.js} +1 -1
  21. package/dist/{cli-snpj5zbj.js → cli-1z4qggfe.js} +9 -36
  22. package/dist/{cli-s0qnd4wv.js → cli-28fq781p.js} +1 -1
  23. package/dist/{cli-1p89xny0.js → cli-2r0jcc3k.js} +1 -1
  24. package/dist/{cli-66ww7fer.js → cli-2tsfpc70.js} +1 -1
  25. package/dist/{cli-rvtm68yy.js → cli-2xv18ywz.js} +2 -2
  26. package/dist/{cli-kyr67fgx.js → cli-36wdfzgn.js} +18608 -9089
  27. package/dist/{cli-t60ajbbp.js → cli-38yww4e9.js} +20 -20
  28. package/dist/{cli-5xaqj21p.js → cli-3kd08rej.js} +1 -1
  29. package/dist/{cli-ae7mrdf9.js → cli-3vjhs18n.js} +4 -6
  30. package/dist/{cli-ssnjfg5p.js → cli-3xcwp3z8.js} +8 -10
  31. package/dist/{cli-rjknb2ae.js → cli-3xddv0rk.js} +6 -6
  32. package/dist/{cli-az48n0nr.js → cli-4caa1x7d.js} +67 -64
  33. package/dist/cli-4vwxp550.js +9321 -0
  34. package/dist/{cli-pz4rk021.js → cli-54vrpgm0.js} +1 -1
  35. package/dist/{cli-gvx71kqv.js → cli-55bkx8hh.js} +3 -3
  36. package/dist/{cli-r9jqcehk.js → cli-5mpy301f.js} +38 -2
  37. package/dist/{cli-bb0mmdk8.js → cli-5wfz00be.js} +35 -12
  38. package/dist/{cli-btfsp3mv.js → cli-5xcb8gxq.js} +9 -11
  39. package/dist/{cli-4t50yq3j.js → cli-6m6b4bep.js} +29 -12
  40. package/dist/cli-6pzk82fd.js +778 -0
  41. package/dist/{cli-8sdejs1f.js → cli-7wz05bx3.js} +797 -255
  42. package/dist/{cli-mkk9rnzz.js → cli-8bpgbr8k.js} +54 -7
  43. package/dist/{cli-fyhr5h4s.js → cli-8ewkreqd.js} +17 -13
  44. package/dist/{cli-p3vsj0d3.js → cli-an1knn2k.js} +15 -10
  45. package/dist/{cli-0ykgn1h5.js → cli-bxz823sz.js} +2 -2
  46. package/dist/{cli-jdv6ypxs.js → cli-bzvs88tv.js} +2 -2
  47. package/dist/{cli-bshb7jas.js → cli-cr14kftt.js} +3 -3
  48. package/dist/{cli-njwac61j.js → cli-cyn9v8zr.js} +12 -2
  49. package/dist/{cli-a22h291q.js → cli-d6521kb5.js} +1 -1
  50. package/dist/{cli-1b7btd38.js → cli-d84byzn8.js} +869 -5
  51. package/dist/{cli-84rj785g.js → cli-eb2azq8n.js} +9 -9
  52. package/dist/{cli-1cxrbkk6.js → cli-ed6yqpf1.js} +7 -9
  53. package/dist/{cli-wx3rhnm0.js → cli-eddnyg3t.js} +1 -1
  54. package/dist/{cli-ga786dzg.js → cli-eqk5p56g.js} +18 -17
  55. package/dist/{cli-mthwvjre.js → cli-f2zenhja.js} +1 -1
  56. package/dist/{cli-ferkkrg9.js → cli-fjggej24.js} +2 -2
  57. package/dist/{cli-g7s47cc5.js → cli-fsgttth8.js} +123 -102
  58. package/dist/{cli-269q28a1.js → cli-g1px1g2e.js} +27 -6
  59. package/dist/{cli-sq4n7af4.js → cli-h49ejvmc.js} +4 -6
  60. package/dist/{cli-5j0m12ns.js → cli-hfkwwy1h.js} +51 -15
  61. package/dist/{cli-agfm16v9.js → cli-hg42n3hx.js} +12 -12
  62. package/dist/{cli-yndmfxb3.js → cli-hxpyc9sn.js} +3 -3
  63. package/dist/{cli-w4xnbm46.js → cli-j7d73g1y.js} +414 -145
  64. package/dist/{cli-gazw7kpa.js → cli-jg24scat.js} +8 -10
  65. package/dist/{cli-5ja3b75e.js → cli-jrp1dt73.js} +1 -1
  66. package/dist/{cli-98rw5dt5.js → cli-jrzkw01m.js} +2 -2
  67. package/dist/{cli-583frbyr.js → cli-kchjb7qy.js} +1 -1
  68. package/dist/{cli-xr8908my.js → cli-kx4c8j05.js} +32 -17
  69. package/dist/{cli-fmjd0t1y.js → cli-m0cy2vyf.js} +2 -2
  70. package/dist/{cli-c0kqky8y.js → cli-m5akxq8q.js} +1 -1
  71. package/dist/{cli-ycscb2ar.js → cli-m88rpzkh.js} +2 -2
  72. package/dist/{cli-ppjxh6ah.js → cli-mp9aa8g5.js} +10 -12
  73. package/dist/{cli-xq9r2wtt.js → cli-mr97t7cc.js} +679 -247
  74. package/dist/{cli-z75yxkjh.js → cli-n07eecjs.js} +3 -3
  75. package/dist/{cli-7cx2m6t2.js → cli-n515ex5z.js} +16 -16
  76. package/dist/{cli-fy6x31ps.js → cli-n5yexkdg.js} +1 -0
  77. package/dist/{cli-bbw9wj9m.js → cli-n9abj89w.js} +17 -16
  78. package/dist/{cli-ypff1qwp.js → cli-n9ftpys4.js} +7 -7
  79. package/dist/{cli-32m9eda8.js → cli-nj3x45rw.js} +111 -109
  80. package/dist/{cli-6vcp76qk.js → cli-p74md7t8.js} +42 -23
  81. package/dist/{cli-rjcbm574.js → cli-pr0eze3x.js} +2 -2
  82. package/dist/{cli-dq8x79v8.js → cli-pyrxt9gw.js} +198 -3
  83. package/dist/{cli-m0hmeqma.js → cli-q581b386.js} +5 -5
  84. package/dist/{cli-8rpcng8j.js → cli-rjyghzg4.js} +8 -10
  85. package/dist/cli-rkc97c6a.js +39 -0
  86. package/dist/{cli-msg9m2ny.js → cli-rt0ag4x1.js} +9 -11
  87. package/dist/{cli-qd57hhhh.js → cli-rvhdmjvt.js} +6 -10
  88. package/dist/{cli-318r69gq.js → cli-t73cas91.js} +440 -9
  89. package/dist/{cli-q4ebh7h7.js → cli-td33w98c.js} +6 -6
  90. package/dist/{cli-zkky4t5g.js → cli-tmft5dz2.js} +2 -2
  91. package/dist/{cli-q26b9wre.js → cli-tph5wt3y.js} +4 -4
  92. package/dist/{cli-3e4snnzf.js → cli-ttbqe3q4.js} +1 -1
  93. package/dist/{cli-wemma3jd.js → cli-v2fwbnsk.js} +7 -7
  94. package/dist/cli-w3bk0dgv.js +5266 -0
  95. package/dist/{cli-8h0ayw8c.js → cli-x9exydey.js} +6 -6
  96. package/dist/{cli-85gzce7b.js → cli-xbtq4d6s.js} +287 -75
  97. package/dist/{cli-eyg1pa00.js → cli-xd5ebp64.js} +7 -7
  98. package/dist/{cli-g83s9ewh.js → cli-xfjrc279.js} +1 -1
  99. package/dist/{cli-7axf41jq.js → cli-xncjscpm.js} +40 -42
  100. package/dist/{cli-9m8hdawy.js → cli-xvymtmv4.js} +4 -4
  101. package/dist/{cli-81p9jd57.js → cli-yab6sh8p.js} +9 -3
  102. package/dist/{cli-srye3vdt.js → cli-ybjdc978.js} +1 -1
  103. package/dist/{cli-z1srzaf6.js → cli-yz7v0sh4.js} +70 -5
  104. package/dist/{cli-nbsf8yvn.js → cli-z9cs5m0w.js} +9 -9
  105. package/dist/{cli-k5671be5.js → cli-zcfpsfzf.js} +5 -5
  106. package/dist/{cli-vf078p3e.js → cli-zfqg6fzn.js} +1 -1
  107. package/dist/{cli-tpksw2nr.js → cli-zjphdj1a.js} +461 -108
  108. package/dist/cli.js +32 -52
  109. package/dist/{cloudflare-workers-ai-system-one-ef2a980q.js → cloudflare-workers-ai-system-one-9y1zx3pt.js} +2 -2
  110. package/dist/{codex-adapter-88z6psm4.js → codex-adapter-yr60sme6.js} +7 -7
  111. package/dist/{codex-login-74wa4hmq.js → codex-login-bcda78ge.js} +2 -2
  112. package/dist/{codex-session-runner-zwbcwzvx.js → codex-session-runner-pch8x584.js} +8 -8
  113. package/dist/{commands-7amxs716.js → commands-phjfbkv0.js} +3 -3
  114. package/dist/{controller-5rkkc37m.js → controller-jkx994pz.js} +4 -4
  115. package/dist/{controllers-connect-m7d4vxxb.js → controllers-connect-c4448kwa.js} +25 -24
  116. package/dist/{cursor-adapter-x1q18693.js → cursor-adapter-ndebqnm8.js} +2 -2
  117. package/dist/{db-athc68zt.js → db-ef32tbfc.js} +6 -2
  118. package/dist/{db-h2fsfve3.js → db-ez6egt6v.js} +3 -3
  119. package/dist/{devin-adapter-r9phbnc9.js → devin-adapter-z46ep5ph.js} +1 -1
  120. package/dist/{dispatcher-b1yz2bnn.js → dispatcher-g3tt9hs9.js} +19 -18
  121. package/dist/{docker-c1a3gqmf.js → docker-866qpzt9.js} +2 -2
  122. package/dist/{dsh-adapter-e33bkxq9.js → dsh-adapter-tcyn3099.js} +2 -2
  123. package/dist/{e2b-fr12yccx.js → e2b-jkwfhbcv.js} +2 -2
  124. package/dist/{e2b-x6ywzak3.js → e2b-s16txnpx.js} +2 -3
  125. package/dist/{easter-egg-3d-pv5qnzc8.js → easter-egg-3d-e36hk5td.js} +1 -1
  126. package/dist/{embedding-space-b4txbwrk.js → embedding-space-4kyh5qqj.js} +6 -6
  127. package/dist/{embeddings-m6zn6tad.js → embeddings-6a8v4a6t.js} +1 -1
  128. package/dist/{event-bus-g0ka3pbw.js → event-bus-e66gh7cc.js} +1 -1
  129. package/dist/{execute-68nwny8m.js → execute-3cbg0twf.js} +1 -1
  130. package/dist/{external-channel-gkckmhzh.js → external-channel-se646snz.js} +2 -2
  131. package/dist/fx-adapter-yw795hqq.js +19 -0
  132. package/dist/{google-generative-ai-v94hr7h0.js → google-generative-ai-h7s3e9kk.js} +7 -12
  133. package/dist/{google-vertex-g7vr6cf8.js → google-vertex-fhxaafzw.js} +7 -12
  134. package/dist/grok-adapter-ttmcss2j.js +19 -0
  135. package/dist/handlers-17wha3ze.js +33 -0
  136. package/dist/heartbeat-gwewgdms.js +42 -0
  137. package/dist/{hook-q5fv0jy2.js → hook-g3nhexsy.js} +16 -11
  138. package/dist/{hook-w0q2wcrv.js → hook-hq93y5ej.js} +5 -5
  139. package/dist/{http-bxat8dg3.js → http-5a9p4h6y.js} +808 -285
  140. package/dist/{index-pxn30mse.js → index-0eny15vj.js} +8 -8
  141. package/dist/{index-6cxzwfen.js → index-0rvk3vd4.js} +71 -71
  142. package/dist/{index-fvzke5kx.js → index-1qw6f2dc.js} +10 -10
  143. package/dist/{index-cqhqpgrv.js → index-3c5pxbge.js} +1 -1
  144. package/dist/{index-k7fj52d3.js → index-6haqt3v5.js} +12302 -11048
  145. package/dist/index-8arwq8mw.js +34 -0
  146. package/dist/{index-h7f61sy9.js → index-e5pfbsys.js} +3 -3
  147. package/dist/{index-bxrexmfy.js → index-hgn3c961.js} +14 -13
  148. package/dist/{index-h39zbx67.js → index-m5gx1xd6.js} +68 -68
  149. package/dist/{index-5fx3b3kw.js → index-rvccek1w.js} +9 -9
  150. package/dist/{index-fm0czesf.js → index-s72rqgsx.js} +1 -1
  151. package/dist/index-tpw054az.js +38 -0
  152. package/dist/{index-514d9pf6.js → index-w7em4ktq.js} +8 -8
  153. package/dist/index-waq75j2j.js +31 -0
  154. package/dist/{keepalive-qnt21cv0.js → keepalive-1j4n4dmk.js} +4 -4
  155. package/dist/lead-re73kdgc.js +72 -0
  156. package/dist/{llama-cpp-classify-s5c47rwh.js → llama-cpp-classify-nfgswa1m.js} +2 -2
  157. package/dist/{maintenance-btdr68y4.js → maintenance-dmghacy5.js} +1 -1
  158. package/dist/{mistral-conversations-3gjpdb4b.js → mistral-conversations-a45tx39a.js} +29 -51
  159. package/dist/{oauth-refresh-sweep-vczabeh4.js → oauth-refresh-sweep-yy06c03c.js} +3 -3
  160. package/dist/{onboard-k33ezyq8.js → onboard-52f9t5dm.js} +68 -16
  161. package/dist/{openai-codex-responses-8pbxq9h5.js → openai-codex-responses-k9gapdze.js} +7 -11
  162. package/dist/{openai-completions-rm00s912.js → openai-completions-xd579js7.js} +50 -58
  163. package/dist/{openai-decisions-8v957r2r.js → openai-decisions-q3hh60wr.js} +2 -2
  164. package/dist/{openai-responses-agxpf96k.js → openai-responses-4d5dx3c7.js} +5 -10
  165. package/dist/{opencode-adapter-3dst2ka7.js → opencode-adapter-krnh9jkn.js} +6 -6
  166. package/dist/{openrouter-images-3ecegv0d.js → openrouter-images-xr9gme9x.js} +4 -3
  167. package/dist/{otel-impl-13am7a65.js → otel-impl-xjqz6wjj.js} +2 -2
  168. package/dist/{pi-messages-pchtw4he.js → pi-messages-hjbv8v10.js} +28 -12
  169. package/dist/{pi-mono-adapter-c53de1gd.js → pi-mono-adapter-dbxyp0qv.js} +23 -26
  170. package/dist/{pricing-refresh-9fcbnq3f.js → pricing-refresh-ctdr74pd.js} +3 -3
  171. package/dist/{rbac-roles-66j5h4y5.js → rbac-roles-ehv8s10n.js} +12 -3
  172. package/dist/{rbac-roles-gw0p9h3j.js → rbac-roles-q0gr8eyj.js} +16 -2
  173. package/dist/{render-v2-fg8bmdn4.js → render-v2-5b6chvcq.js} +9 -4
  174. package/dist/{resume-1c8kr3nh.js → resume-5a5d2845.js} +7 -7
  175. package/dist/{runtime-tzf9j7tc.js → runtime-khxszyfp.js} +1 -1
  176. package/dist/{session-access-d0atq10j.js → session-access-gj0bjhqg.js} +4 -4
  177. package/dist/{session-source-backfill-0vscqmsa.js → session-source-backfill-2sy0krfk.js} +3 -3
  178. package/dist/{setup-tvfa7rwe.js → setup-7ssfakk1.js} +1 -1
  179. package/dist/{typesafe-system-one-0bmqcxfg.js → typesafe-system-one-f2en2knd.js} +2 -2
  180. package/dist/virtual-modules-pjj0knwf.js +362 -0
  181. package/dist/{work-objects-ks71xqeb.js → work-objects-bf3syvhq.js} +22 -21
  182. package/dist/{worker-follow-up-bfx0h9hg.js → worker-follow-up-38xevga6.js} +19 -18
  183. package/dist/worker-r8mz7a65.js +72 -0
  184. package/dist/{x-vmmye1kb.js → x-2fyrt5pp.js} +2 -2
  185. package/openapi.json +1169 -257
  186. package/package.json +9 -11
  187. package/src/apps/catalog.generated.json +354 -82
  188. package/src/apps/page-validator.ts +134 -2
  189. package/src/assets/key.ts +77 -4
  190. package/src/be/connector-codes.ts +21 -6
  191. package/src/be/db/session-labels.ts +57 -0
  192. package/src/be/db/session-tree.ts +51 -7
  193. package/src/be/db/slack-trees.ts +146 -0
  194. package/src/be/db/tasks/read.ts +124 -7
  195. package/src/be/db-client.ts +8 -2
  196. package/src/be/db.ts +99 -86
  197. package/src/be/event-loop-lag.ts +146 -0
  198. package/src/be/improvements.ts +416 -0
  199. package/src/be/mcp-overflow-sweep.ts +2 -1
  200. package/src/be/memory/providers/sqlite-store.ts +39 -8
  201. package/src/be/migrations/274_improvements.sql +27 -0
  202. package/src/be/migrations/275_task_dispatched_by.sql +8 -0
  203. package/src/be/migrations/278_slack_render_v2_reconcile.sql +108 -0
  204. package/src/be/rbac-roles.ts +123 -1
  205. package/src/be/swarm-config-guard.ts +3 -0
  206. package/src/be/users.ts +58 -1
  207. package/src/cli.tsx +5 -25
  208. package/src/commands/codex-login.ts +1 -1
  209. package/src/commands/context-preamble.ts +258 -0
  210. package/src/commands/e2b.ts +0 -1
  211. package/src/commands/onboard/agent-fs-version.ts +1 -1
  212. package/src/commands/onboard/compose-generator.ts +0 -1
  213. package/src/commands/onboard/dashboard-url.ts +31 -0
  214. package/src/commands/onboard/steps/generate.tsx +17 -1
  215. package/src/commands/onboard/steps/post-dashboard.tsx +9 -3
  216. package/src/commands/onboard.tsx +19 -6
  217. package/src/commands/runner.ts +117 -96
  218. package/src/extensions/catalog.generated.json +3 -3
  219. package/src/extensions/contract-types.generated.ts +1 -1
  220. package/src/heartbeat/heartbeat.ts +5 -4
  221. package/src/hooks/hook.ts +13 -5
  222. package/src/http/all-routes.ts +1 -0
  223. package/src/http/approval-requests.ts +2 -44
  224. package/src/http/auth.ts +5 -4
  225. package/src/http/codex-oauth-accounts.ts +31 -23
  226. package/src/http/codex-oauth-device.ts +1 -1
  227. package/src/http/codex-oauth-keep-warm.ts +1 -1
  228. package/src/http/core.ts +9 -3
  229. package/src/http/improvements.ts +317 -0
  230. package/src/http/index.ts +12 -6
  231. package/src/http/memory.ts +9 -4
  232. package/src/http/operator-actor.ts +2 -1
  233. package/src/http/person-responder.ts +66 -0
  234. package/src/http/sessions.ts +65 -10
  235. package/src/http/tasks.ts +1 -1
  236. package/src/http/user-roles.ts +11 -2
  237. package/src/http/users.ts +194 -104
  238. package/src/http/utils.ts +18 -0
  239. package/src/http/webhooks.ts +48 -0
  240. package/src/integrations/chat-sdk/commands.ts +167 -31
  241. package/src/integrations/chat-sdk/inbound.ts +10 -8
  242. package/src/integrations/chat-sdk/message-text.ts +117 -0
  243. package/src/providers/acp-targets.ts +1 -1
  244. package/src/providers/amp-adapter.ts +1 -1
  245. package/src/providers/codex-adapter.ts +8 -1
  246. package/src/providers/codex-models.ts +4 -3
  247. package/src/providers/codex-oauth/auth-json.ts +14 -18
  248. package/src/providers/codex-oauth/storage.ts +2 -2
  249. package/src/providers/cursor-adapter.ts +1 -1
  250. package/src/providers/dsh-adapter.ts +1 -1
  251. package/src/rbac/legacy-policy.ts +2 -0
  252. package/src/rbac/permissions.ts +10 -0
  253. package/src/scheduler/scheduler.ts +4 -1
  254. package/src/scripts-runtime/executors/quickjs-runner.ts +2 -0
  255. package/src/scripts-runtime/executors/quickjs-structured-clone.ts +180 -0
  256. package/src/scripts-runtime/quickjs-compat.ts +0 -1
  257. package/src/scripts-runtime/types/swarm-extension.d.ts +2 -0
  258. package/src/server.ts +2 -0
  259. package/src/slack/ack.ts +20 -14
  260. package/src/slack/app.ts +332 -10
  261. package/src/slack/handlers.ts +9 -2
  262. package/src/slack/index.ts +7 -1
  263. package/src/slack/lifecycle-lock.ts +29 -0
  264. package/src/slack/render-v2.ts +466 -229
  265. package/src/slack/socket-fence.ts +64 -0
  266. package/src/slack/watcher.ts +42 -8
  267. package/src/tests/api-drain-worker-e2e.test.ts +69 -2
  268. package/src/tests/apps-catalog-drift.test.ts +35 -0
  269. package/src/tests/apps-catalog-table.test.ts +203 -0
  270. package/src/tests/apps-element-assembly.test.ts +28 -0
  271. package/src/tests/apps-schema-form.test.ts +151 -0
  272. package/src/tests/apps-smart-links.test.ts +151 -0
  273. package/src/tests/apps-table-filters-migration.test.ts +96 -0
  274. package/src/tests/apps-table-selection-migration.test.ts +95 -0
  275. package/src/tests/chat-sdk-commands.test.ts +359 -2
  276. package/src/tests/chat-sdk-inbound.test.ts +20 -0
  277. package/src/tests/chat-sdk-slack.test.ts +189 -1
  278. package/src/tests/chatgpt-subscription-session-bench.test.ts +2 -2
  279. package/src/tests/claude-worker-parity.test.ts +2 -2
  280. package/src/tests/codex-adapter.test.ts +30 -0
  281. package/src/tests/codex-login.test.ts +2 -2
  282. package/src/tests/codex-oauth-accounts.test.ts +48 -12
  283. package/src/tests/codex-oauth-credential-info.test.ts +77 -1
  284. package/src/tests/codex-oauth-device.test.ts +1 -1
  285. package/src/tests/codex-oauth-keep-warm.test.ts +2 -2
  286. package/src/tests/codex-oauth.test.ts +25 -4
  287. package/src/tests/codex-pool.test.ts +2 -2
  288. package/src/tests/db-client-busy-retry.test.ts +69 -18
  289. package/src/tests/db-client.test.ts +26 -1
  290. package/src/tests/db-task-read-contract.test.ts +4 -0
  291. package/src/tests/db-task-write-contract.test.ts +2 -0
  292. package/src/tests/deploy-one-box.test.ts +39 -1
  293. package/src/tests/docs-index-footprint.test.js +3 -3
  294. package/src/tests/dsh-adapter.test.ts +1 -1
  295. package/src/tests/event-loop-lag.test.ts +184 -0
  296. package/src/tests/extensions-example-comms-adherence-gate.test.ts +115 -0
  297. package/src/tests/fixtures/onboard/content.compose.yml.txt +0 -4
  298. package/src/tests/fixtures/onboard/dev.compose.yml.txt +0 -3
  299. package/src/tests/fixtures/onboard/full-all.compose.yml.txt +0 -11
  300. package/src/tests/fixtures/onboard/full.compose.yml.txt +0 -11
  301. package/src/tests/fixtures/onboard/research.compose.yml.txt +0 -3
  302. package/src/tests/fixtures/onboard/solo.compose.yml.txt +0 -1
  303. package/src/tests/fixtures/prs-app-definition.json.txt +784 -0
  304. package/src/tests/fixtures/prs-filters-migration.patch.json.txt +318 -0
  305. package/src/tests/fixtures/prs-selection-migration.patch.json.txt +373 -0
  306. package/src/tests/fixtures/runner-identity-refresh.ts +3 -0
  307. package/src/tests/fixtures/runner-legacy-resume-prompt.ts +3 -0
  308. package/src/tests/fixtures/runner-task-start-reads.ts +140 -0
  309. package/src/tests/github-webhook-early-ack.test.ts +144 -0
  310. package/src/tests/hook-ping-me-order.test.ts +85 -0
  311. package/src/tests/http-api-integration.test.ts +2 -0
  312. package/src/tests/http-log-scrubbing.test.ts +68 -2
  313. package/src/tests/improvements-payload.test.ts +200 -0
  314. package/src/tests/improvements-route.test.ts +419 -0
  315. package/src/tests/install-sh-setup-url.test.ts +190 -0
  316. package/src/tests/kv-storage.test.ts +92 -1
  317. package/src/tests/memory-key-paths.test.ts +57 -0
  318. package/src/tests/memory-retrieval-purge.test.ts +19 -0
  319. package/src/tests/onboard-dashboard-output.test.ts +109 -0
  320. package/src/tests/onboard-dashboard-url.test.ts +83 -0
  321. package/src/tests/operator-granted-credentials.test.ts +561 -0
  322. package/src/tests/operator-granted-role-wire.test.ts +222 -0
  323. package/src/tests/quickjs-compat.test.ts +1 -1
  324. package/src/tests/rbac-engine.test.ts +2 -0
  325. package/src/tests/runner-context-preamble.test.ts +552 -0
  326. package/src/tests/runner-context-usage.test.ts +0 -1
  327. package/src/tests/runner-legacy-options.test.ts +55 -0
  328. package/src/tests/runner-slot-reconcile.test.ts +38 -0
  329. package/src/tests/runner-task-start-reads.test.ts +58 -0
  330. package/src/tests/script-connections.test.ts +3 -0
  331. package/src/tests/script-executor-conformance.test.ts +188 -0
  332. package/src/tests/send-task-dispatched-by.test.ts +129 -0
  333. package/src/tests/session-dispatched-tasks.test.ts +115 -0
  334. package/src/tests/session-sharing.test.ts +198 -9
  335. package/src/tests/sessions-tree.test.ts +133 -2
  336. package/src/tests/slack-app-icon.test.ts +4 -0
  337. package/src/tests/slack-dm-implicit-mention.test.ts +236 -0
  338. package/src/tests/slack-file-tools-attachments.test.ts +96 -3
  339. package/src/tests/slack-reaction-config.test.ts +39 -0
  340. package/src/tests/slack-read-boundaries.test.ts +4 -3
  341. package/src/tests/slack-render-v2-query-plans.test.ts +262 -3
  342. package/src/tests/slack-render-v2-reconcile.test.ts +201 -0
  343. package/src/tests/slack-render-v2.test.ts +47 -0
  344. package/src/tests/slack-socket-watchdog.test.ts +748 -0
  345. package/src/tests/submit-improvement-tool.test.ts +82 -0
  346. package/src/tests/tool-annotations.test.ts +1 -1
  347. package/src/tests/vcs-identity-inheritance.test.ts +85 -0
  348. package/src/tools/manage-user.ts +88 -58
  349. package/src/tools/send-task.ts +3 -0
  350. package/src/tools/slack-read.ts +61 -33
  351. package/src/tools/submit-improvement.ts +68 -0
  352. package/src/tools/tool-config.ts +3 -0
  353. package/src/tools/utils.ts +16 -7
  354. package/src/types.ts +5 -0
  355. package/src/utils/request-auth-context.ts +6 -1
  356. package/templates/extensions/comms-adherence-gate/README.md +25 -0
  357. package/templates/extensions/comms-adherence-gate/hooks.ts +100 -11
  358. package/templates/extensions/comms-adherence-gate/manifest.json +1 -1
  359. package/templates/skills/apps/SKILL.md +29 -11
  360. package/templates/skills/apps/content.md +29 -11
  361. package/templates/skills/swarm-scripts/SKILL.md +1 -1
  362. package/templates/skills/swarm-scripts/content.md +1 -1
  363. package/templates/skills/work-on-task/SKILL.md +1 -1
  364. package/templates/skills/work-on-task/content.md +1 -1
  365. package/dist/acp-adapter-vg5hqkvj.js +0 -16
  366. package/dist/app-e00m45gn.js +0 -17
  367. package/dist/cli-5c4hjzne.js +0 -873
  368. package/dist/cli-ae0dnfee.js +0 -20222
  369. package/dist/cli-nn3ysbqk.js +0 -428
  370. package/dist/cli-pc5znp64.js +0 -364
  371. package/dist/fx-adapter-m5jbgd5q.js +0 -19
  372. package/dist/grok-adapter-csvv7sac.js +0 -19
  373. package/dist/handlers-8x5gfbzx.js +0 -32
  374. package/dist/heartbeat-6c2y3267.js +0 -41
  375. package/dist/index-hpfte8jd.js +0 -33
  376. package/dist/index-ncf7yb5s.js +0 -30
  377. package/dist/index-vte6dyeh.js +0 -37
  378. package/dist/lead-4bvftzm6.js +0 -71
  379. package/dist/virtual-modules-efxcp740.js +0 -59
  380. package/dist/worker-e7v2bvm9.js +0 -71
@@ -1,4 +1,4 @@
1
1
  // Generated by scripts/bundle-extension-types.ts. Do not edit.
2
2
  // biome-ignore-all lint/suspicious/noTemplateCurlyInString: Type declarations contain literal template placeholders.
3
3
  export const EXTENSION_TYPE_DEFINITIONS =
4
- '// biome-ignore-all lint/suspicious/noConfusingVoidType: Extension handlers may explicitly return no result.\ndeclare module "swarm-extension" {\n export type CreateTaskOptions = {\n key?: string | undefined;\n agentId?: string | null | undefined;\n creatorAgentId?: string | undefined;\n source?:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "mcp"\n | "api"\n | "ui"\n | "system"\n | "comb"\n | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n taskType?: string | undefined;\n tags?: string[] | undefined;\n priority?: number | undefined;\n dependsOn?: string[] | undefined;\n offeredTo?: string | undefined;\n status?: "draft" | "backlog" | "unassigned" | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n overrideSlackContext?: boolean | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | undefined;\n workflowRunStepId?: string | undefined;\n sourceTaskId?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n inheritParentOutputSchema?: boolean | undefined;\n inheritParentRequester?: boolean | undefined;\n inheritParentRoutingAffinity?: boolean | undefined;\n inheritParentFollowUpConfig?: boolean | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n requestedByUserId?: string | undefined;\n contextKey?: string | undefined;\n bypassTrackerContextDedup?: boolean | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n };\n\n export type AgentTask = {\n id: string;\n key: string;\n agentId: string | null;\n task: string;\n status:\n | "skipped"\n | "draft"\n | "backlog"\n | "unassigned"\n | "offered"\n | "reviewing"\n | "pending"\n | "in_progress"\n | "paused"\n | "completed"\n | "failed"\n | "cancelled"\n | "superseded";\n source:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "mcp"\n | "api"\n | "ui"\n | "system"\n | "comb";\n tags: string[];\n priority: number;\n dependsOn: string[];\n createdAt: string;\n lastUpdatedAt: string;\n slackReplySent: boolean;\n wasPaused: boolean;\n creatorAgentId?: string | undefined;\n title?: string | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n poolWakeAt?: string | undefined;\n taskType?: string | undefined;\n offeredTo?: string | undefined;\n offeredAt?: string | undefined;\n acceptedAt?: string | undefined;\n rejectionReason?: string | undefined;\n finishedAt?: string | undefined;\n notifiedAt?: string | undefined;\n failureReason?: string | undefined;\n output?: string | undefined;\n progress?: string | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackProgressMessageTs?: string | undefined;\n slackTreeRootMessageTs?: string | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n claudeSessionId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n resolvedModel?: string | undefined;\n modelSource?: string | undefined;\n modelAlias?: string | undefined;\n resolvedEffort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n resolvedProfile?: string | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | null | undefined;\n workflowRunStepId?: string | null | undefined;\n contextKey?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n deferredAt?: string | undefined;\n compactionCount?: number | undefined;\n peakContextPercent?: number | undefined;\n peakContextTokens?: number | undefined;\n contextWindowSize?: number | undefined;\n credentialKeySuffix?: string | undefined;\n credentialKeyType?: string | undefined;\n requestedByUserId?: string | undefined;\n swarmVersion?: string | undefined;\n provider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n providerMeta?: Record<string, unknown> | undefined;\n harnessVariant?: string | undefined;\n harnessVariantMeta?: Record<string, unknown> | undefined;\n totalCostUsd?: number | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n routingAffinityInvalid?: boolean | undefined;\n };\n\n export type ActiveSession = {\n id: string;\n agentId: string;\n taskId: string | null;\n triggerType: string;\n inboxMessageId: string | null;\n taskDescription: string | null;\n runnerSessionId: string | null;\n providerSessionId: string | null;\n startedAt: string;\n lastHeartbeatAt: string;\n runtimeInstanceId?: string | null | undefined;\n };\n\n export type SteerMode = "steer" | "queue";\n\n export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "mcp" | "extension" | "script-sdk";\n };\n\n import type { SwarmSdk } from "swarm-sdk";\n import type { z } from "zod";\n export type Runtime = "api" | "worker";\n export interface ExtensionScriptAsset {\n name: string;\n file: string;\n description: string;\n intent?: string;\n }\n export interface ExtensionScheduleAsset {\n name: string;\n description?: string;\n script: string;\n cronExpression?: string;\n intervalMs?: number;\n timezone?: string;\n args?: Record<string, unknown>;\n }\n export interface ExtensionWorkflowAsset {\n file: string;\n }\n export interface ExtensionSkillAsset {\n dir: string;\n }\n export interface ExtensionManifest {\n $schema?: string;\n name: string;\n description: string;\n version: string;\n runtime: Runtime;\n assets: {\n hooks: string;\n scripts?: readonly ExtensionScriptAsset[];\n schedules?: readonly ExtensionScheduleAsset[];\n workflows?: readonly ExtensionWorkflowAsset[];\n skills?: readonly ExtensionSkillAsset[];\n };\n homepage?: string;\n author?: string;\n }\n export interface HooksModule {\n default: SwarmExtension;\n config?: z.ZodTypeAny;\n }\n export interface ExtensionState {\n get<T = unknown>(key: string): Promise<T | null>;\n set<T>(key: string, value: T): Promise<void>;\n incr(key: string, by?: number): Promise<number>;\n del(key: string): Promise<void>;\n }\n export interface ExtensionLogger {\n debug(message: string, data?: unknown): void;\n info(message: string, data?: unknown): void;\n warn(message: string, data?: unknown): void;\n error(message: string, data?: unknown): void;\n }\n type ConfigFor<M extends ExtensionManifest> = M extends {\n config: infer C extends z.ZodTypeAny;\n }\n ? z.infer<C>\n : Record<string, unknown>;\n export interface ApiCtx<Config = Record<string, unknown>> {\n swarm: SwarmSdk;\n state: ExtensionState;\n config: Config;\n log: ExtensionLogger;\n signal: AbortSignal;\n event: {\n name: keyof SwarmEventMap;\n at: string;\n extension: {\n id: string;\n version: number;\n };\n };\n }\n export interface WorkerCtx<Config = Record<string, unknown>>\n extends Omit<ApiCtx<Config>, "swarm"> {\n swarm: SwarmSdk;\n worker: {\n agentId: string;\n taskId: string;\n harness: string;\n };\n }\n export type CtxFor<M extends ExtensionManifest> = M["runtime"] extends "api"\n ? ApiCtx<ConfigFor<M>>\n : WorkerCtx<ConfigFor<M>>;\n export type PreResult<Modify> =\n | void\n | {\n action: "continue";\n }\n | {\n action: "modify";\n data: Modify;\n }\n | {\n action: "block";\n reason: string;\n };\n export type TaskCreateOrigin =\n | "rest"\n | "app"\n | "mcp"\n | "slack"\n | "schedule"\n | "workflow"\n | "webhook"\n | "followUp"\n | `extension:${string}`;\n export interface TaskCreateEvent {\n options: CreateTaskOptions;\n description: string;\n origin: TaskCreateOrigin;\n requestInfo?: RequestInfo;\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n trigger: "mention" | "thread-buffer";\n messages: {\n ts: string;\n userId: string;\n text: string;\n }[];\n };\n }\n /** A pre.task.create hook blocked a task before it was created. */\n export interface TaskBlockedEvent {\n /** The extension that blocked, or whose model/agent rewrite was rejected. */\n extension: {\n id: string;\n name: string;\n };\n /** The scrubbed block reason. */\n reason: string;\n origin: TaskCreateOrigin;\n source?: AgentTask["source"];\n requester: {\n userId?: string;\n agentId?: string;\n slackUserId?: string;\n };\n context?: {\n contextKey?: string;\n scheduleId?: string;\n workflowRunId?: string;\n workflowRunStepId?: string;\n parentTaskId?: string;\n vcsRepo?: string;\n vcsNumber?: number;\n slackChannelId?: string;\n slackThreadTs?: string;\n };\n /** The original task description, scrubbed and cut to 500 characters. */\n description: string;\n }\n export type TaskCreateModify = Partial<\n Pick<\n CreateTaskOptions,\n | "agentId"\n | "creatorAgentId"\n | "source"\n | "taskType"\n | "tags"\n | "priority"\n | "dependsOn"\n | "offeredTo"\n | "vcsProvider"\n | "vcsRepo"\n | "vcsEventType"\n | "vcsNumber"\n | "vcsCommentId"\n | "vcsAuthor"\n | "vcsUrl"\n | "vcsInstallationId"\n | "vcsNodeId"\n | "agentmailInboxId"\n | "agentmailMessageId"\n | "agentmailThreadId"\n | "mentionMessageId"\n | "mentionChannelId"\n | "dir"\n | "model"\n | "modelTier"\n | "effort"\n | "outputSchema"\n | "followUpConfig"\n | "bypassTrackerContextDedup"\n >\n > & {\n description?: string;\n };\n export interface TaskFollowUpEvent {\n completedTask: AgentTask;\n status: "completed" | "failed";\n output?: string;\n failureReason?: string;\n workerAgentId: string;\n leadAgentId: string;\n summary: string;\n }\n export interface TaskSteerEvent {\n task: AgentTask;\n message: string;\n mode: SteerMode;\n source: SteeringSource;\n sender: {\n kind: "user" | "agent" | "system";\n userId?: string;\n agentId?: string;\n };\n messageTimestamps?: string[];\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n channelId: string;\n threadTs: string;\n userId?: string;\n };\n }\n export interface TaskSteerModify {\n message: string;\n }\n export type TaskFollowUpModify = Partial<\n Pick<CreateTaskOptions, "agentId" | "priority" | "followUpConfig">\n > & {\n description?: string;\n };\n export interface SlackRouteEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n botMentioned: boolean;\n threadContext?: {\n channelId: string;\n threadTs: string;\n };\n }\n export interface SlackRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n };\n }\n /** A Chat SDK message after its thread buffer flushed, before routing. */\n export interface ChatRouteEvent {\n /** Adapter name, such as `telegram` or `slack`. */\n adapter: string;\n channelId: string;\n /** The Chat SDK thread id, prefixed with the adapter name. */\n threadId: string;\n /** The first buffered sender. */\n userId: string;\n userName?: string;\n /** The buffered messages, joined. */\n text: string;\n /** True for an @mention and for a reply to one of the bot\'s messages. */\n botMentioned: boolean;\n isDirectMessage: boolean;\n /** Platform chat type, such as Telegram `private`, `group`, `supergroup` or `channel`. */\n chatType?: string;\n /** Set for a Telegram supergroup with topics. */\n isForum?: boolean;\n /** A buffered message replies to one of the bot\'s own messages. */\n replyToBot: boolean;\n /** Set when earlier swarm tasks exist in this thread. */\n threadContext?: {\n adapter: string;\n threadId: string;\n };\n }\n export interface ChatRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n }\n | {\n kind: "workflow";\n workflowId: string;\n };\n }\n export type HeartbeatClassification = "no-session" | "stale-session" | "fresh-stalled";\n export type HeartbeatAction = "supersede-resume" | "fail" | "record";\n export interface HeartbeatRemediateEvent {\n task: AgentTask;\n session?: ActiveSession;\n classification: HeartbeatClassification;\n proposedAction: HeartbeatAction;\n reason: string;\n taskAgeMs: number;\n sessionHeartbeatAgeMs?: number;\n }\n export interface HeartbeatRemediateModify {\n proposedAction: HeartbeatAction;\n }\n export interface ToolCallEvent {\n tool: string;\n args: unknown;\n requestInfo: RequestInfo;\n }\n export interface ToolCallModify {\n args: unknown;\n }\n export interface TaskEvent {\n task: AgentTask;\n }\n export interface TaskCompletedEvent extends TaskEvent {\n output: string;\n }\n export interface TaskFailedEvent extends TaskEvent {\n failureReason: string;\n }\n export interface TaskSupersededEvent extends TaskEvent {\n supersededBy: string;\n }\n export interface TaskProgressEvent extends TaskEvent {\n progress: string;\n }\n export interface SlackMessageEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n taskId?: string;\n }\n /** A Chat SDK message the swarm received or sent. */\n export interface ChatMessageEvent {\n adapter: string;\n channelId: string;\n threadId: string;\n /** The sender, for an inbound message. */\n userId?: string;\n text: string;\n direction: "inbound" | "outbound";\n taskId?: string;\n messageId?: string;\n }\n /**\n * A person answered an approval request. Fires for workflow and standalone\n * requests. Timeouts and cancellations do not emit it today.\n */\n export interface ApprovalResolvedEvent {\n requestId: string;\n status: "approved" | "rejected" | "timeout" | "cancelled";\n responses: Record<string, unknown> | null;\n /** Set when a workflow human-in-the-loop step asked. Absent for a standalone request. */\n workflowRunId?: string;\n workflowRunStepId?: string;\n /** The task whose agent asked, for a standalone request. */\n sourceTaskId?: string;\n }\n /** A task was refused because a daily spend budget is used up. */\n export interface TaskBudgetRefusedEvent extends TaskEvent {\n /** The agent the task was refused for. */\n agentId: string;\n /** Which budget refused it. The matching spend and budget fields are set. */\n cause: "agent" | "global" | "user";\n agentSpendUsd?: number;\n agentBudgetUsd?: number;\n globalSpendUsd?: number;\n globalBudgetUsd?: number;\n userSpendUsd?: number;\n userBudgetUsd?: number;\n /** ISO 8601 time the daily budget resets. */\n resetAt: string;\n }\n /** An inbound AgentMail message. */\n export interface EmailReceivedEvent {\n inboxId: string;\n /** The From header as sent. */\n from: string;\n subject: string;\n /** The text body, or the HTML when there is no text, cut to 500 characters with `...` appended. */\n body: string;\n threadId: string;\n messageId: string;\n }\n /** An inbound Kapso (WhatsApp) message. */\n export interface KapsoMessageEvent {\n phoneNumberId: string;\n conversationId?: string;\n messageId: string;\n from?: string;\n /** Kapso message type, such as `text` or `image`. */\n type?: string;\n /** The text, or a placeholder naming the type for a non-text message. */\n text: string;\n }\n export type VcsProvider = "github" | "gitlab" | "azure-devops" | "bitbucket";\n /**\n * The provider object the event is about, as the provider names it. GitLab\n * calls a pull request a merge request, and a comment a `note`.\n */\n export type VcsEventKind =\n | "pull_request"\n | "merge_request"\n | "issue"\n | "issue_comment"\n | "note"\n | "pull_request_review"\n | "pipeline";\n /**\n * A webhook event from a connected code host. `action` is the provider\'s own\n * value: `opened`, `closed`, `synchronize`, `merge`, `created`, `commented`, or,\n * for a pipeline, its status such as `success` or `failed`. Fields a kind does\n * not carry are absent.\n */\n export interface VcsEvent {\n provider: VcsProvider;\n kind: VcsEventKind;\n action: string;\n /** `owner/name` on GitHub and GitLab, `workspace/repo_slug` on Bitbucket, the repository URL on Azure DevOps. */\n repo: string;\n /** The PR, merge request, or issue number. Absent for a pipeline outside a merge request. */\n number?: number;\n title?: string;\n body?: string | null;\n /** Login of the user behind the event. Set for pull requests, merge requests, and Azure DevOps comments. */\n author?: string;\n url?: string;\n merged?: boolean;\n changedFiles?: number;\n /** The review verdict, on a pull request review. */\n reviewState?: string;\n }\n export interface ToolCallCompletedEvent extends ToolCallEvent {\n result: unknown;\n durationMs: number;\n }\n export interface SwarmEventMap {\n "pre.task.create": {\n event: TaskCreateEvent;\n modify: TaskCreateModify;\n result: PreResult<TaskCreateModify>;\n };\n "pre.task.followUp": {\n event: TaskFollowUpEvent;\n modify: TaskFollowUpModify;\n result: PreResult<TaskFollowUpModify>;\n };\n "pre.task.steer": {\n event: TaskSteerEvent;\n modify: TaskSteerModify;\n result: PreResult<TaskSteerModify>;\n };\n "pre.slack.route": {\n event: SlackRouteEvent;\n modify: SlackRouteModify;\n result: PreResult<SlackRouteModify>;\n };\n "pre.chat.route": {\n event: ChatRouteEvent;\n modify: ChatRouteModify;\n result: PreResult<ChatRouteModify>;\n };\n "pre.heartbeat.remediate": {\n event: HeartbeatRemediateEvent;\n modify: HeartbeatRemediateModify;\n result: PreResult<HeartbeatRemediateModify>;\n };\n "pre.tool.call": {\n event: ToolCallEvent;\n modify: ToolCallModify;\n result: PreResult<ToolCallModify>;\n };\n "post.task.created": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.blocked": {\n event: TaskBlockedEvent;\n modify: never;\n result: void;\n };\n "post.task.completed": {\n event: TaskCompletedEvent;\n modify: never;\n result: void;\n };\n "post.task.failed": {\n event: TaskFailedEvent;\n modify: never;\n result: void;\n };\n "post.task.cancelled": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.superseded": {\n event: TaskSupersededEvent;\n modify: never;\n result: void;\n };\n "post.task.progress": {\n event: TaskProgressEvent;\n modify: never;\n result: void;\n };\n "post.slack.message": {\n event: SlackMessageEvent;\n modify: never;\n result: void;\n };\n "post.chat.message": {\n event: ChatMessageEvent;\n modify: never;\n result: void;\n };\n "post.approval.resolved": {\n event: ApprovalResolvedEvent;\n modify: never;\n result: void;\n };\n "post.task.budgetRefused": {\n event: TaskBudgetRefusedEvent;\n modify: never;\n result: void;\n };\n "post.email.received": {\n event: EmailReceivedEvent;\n modify: never;\n result: void;\n };\n "post.kapso.message": {\n event: KapsoMessageEvent;\n modify: never;\n result: void;\n };\n "post.vcs.event": {\n event: VcsEvent;\n modify: never;\n result: void;\n };\n "post.tool.call": {\n event: ToolCallCompletedEvent;\n modify: never;\n result: void;\n };\n }\n export interface ExtensionApi<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > {\n on<E extends keyof SwarmEventMap>(\n event: E,\n handler: (\n event: SwarmEventMap[E]["event"],\n ctx: CtxFor<M>,\n ) => Promise<SwarmEventMap[E]["result"]> | SwarmEventMap[E]["result"],\n opts?: {\n priority?: number;\n },\n ): void;\n }\n export type SwarmExtension<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > = (api: ExtensionApi<M>) => void;\n export { block, modify } from "./contract-runtime";\n}\n';
4
+ '// biome-ignore-all lint/suspicious/noConfusingVoidType: Extension handlers may explicitly return no result.\ndeclare module "swarm-extension" {\n export type CreateTaskOptions = {\n key?: string | undefined;\n agentId?: string | null | undefined;\n creatorAgentId?: string | undefined;\n source?:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "mcp"\n | "api"\n | "ui"\n | "system"\n | "comb"\n | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n taskType?: string | undefined;\n tags?: string[] | undefined;\n priority?: number | undefined;\n dependsOn?: string[] | undefined;\n offeredTo?: string | undefined;\n status?: "draft" | "backlog" | "unassigned" | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n overrideSlackContext?: boolean | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | undefined;\n workflowRunStepId?: string | undefined;\n sourceTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n inheritParentOutputSchema?: boolean | undefined;\n inheritParentRequester?: boolean | undefined;\n inheritParentRoutingAffinity?: boolean | undefined;\n inheritParentFollowUpConfig?: boolean | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n requestedByUserId?: string | undefined;\n contextKey?: string | undefined;\n bypassTrackerContextDedup?: boolean | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n };\n\n export type AgentTask = {\n id: string;\n key: string;\n agentId: string | null;\n task: string;\n status:\n | "skipped"\n | "draft"\n | "backlog"\n | "unassigned"\n | "offered"\n | "reviewing"\n | "pending"\n | "in_progress"\n | "paused"\n | "completed"\n | "failed"\n | "cancelled"\n | "superseded";\n source:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "mcp"\n | "api"\n | "ui"\n | "system"\n | "comb";\n tags: string[];\n priority: number;\n dependsOn: string[];\n createdAt: string;\n lastUpdatedAt: string;\n slackReplySent: boolean;\n wasPaused: boolean;\n creatorAgentId?: string | undefined;\n title?: string | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n poolWakeAt?: string | undefined;\n taskType?: string | undefined;\n offeredTo?: string | undefined;\n offeredAt?: string | undefined;\n acceptedAt?: string | undefined;\n rejectionReason?: string | undefined;\n finishedAt?: string | undefined;\n notifiedAt?: string | undefined;\n failureReason?: string | undefined;\n output?: string | undefined;\n progress?: string | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackProgressMessageTs?: string | undefined;\n slackTreeRootMessageTs?: string | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n claudeSessionId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n resolvedModel?: string | undefined;\n modelSource?: string | undefined;\n modelAlias?: string | undefined;\n resolvedEffort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n resolvedProfile?: string | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | null | undefined;\n workflowRunStepId?: string | null | undefined;\n contextKey?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n deferredAt?: string | undefined;\n compactionCount?: number | undefined;\n peakContextPercent?: number | undefined;\n peakContextTokens?: number | undefined;\n contextWindowSize?: number | undefined;\n credentialKeySuffix?: string | undefined;\n credentialKeyType?: string | undefined;\n requestedByUserId?: string | undefined;\n swarmVersion?: string | undefined;\n provider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n providerMeta?: Record<string, unknown> | undefined;\n harnessVariant?: string | undefined;\n harnessVariantMeta?: Record<string, unknown> | undefined;\n totalCostUsd?: number | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n routingAffinityInvalid?: boolean | undefined;\n };\n\n export type ActiveSession = {\n id: string;\n agentId: string;\n taskId: string | null;\n triggerType: string;\n inboxMessageId: string | null;\n taskDescription: string | null;\n runnerSessionId: string | null;\n providerSessionId: string | null;\n startedAt: string;\n lastHeartbeatAt: string;\n runtimeInstanceId?: string | null | undefined;\n };\n\n export type SteerMode = "steer" | "queue";\n\n export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "mcp" | "extension" | "script-sdk";\n };\n\n import type { SwarmSdk } from "swarm-sdk";\n import type { z } from "zod";\n export type Runtime = "api" | "worker";\n export interface ExtensionScriptAsset {\n name: string;\n file: string;\n description: string;\n intent?: string;\n }\n export interface ExtensionScheduleAsset {\n name: string;\n description?: string;\n script: string;\n cronExpression?: string;\n intervalMs?: number;\n timezone?: string;\n args?: Record<string, unknown>;\n }\n export interface ExtensionWorkflowAsset {\n file: string;\n }\n export interface ExtensionSkillAsset {\n dir: string;\n }\n export interface ExtensionManifest {\n $schema?: string;\n name: string;\n description: string;\n version: string;\n runtime: Runtime;\n assets: {\n hooks: string;\n scripts?: readonly ExtensionScriptAsset[];\n schedules?: readonly ExtensionScheduleAsset[];\n workflows?: readonly ExtensionWorkflowAsset[];\n skills?: readonly ExtensionSkillAsset[];\n };\n homepage?: string;\n author?: string;\n }\n export interface HooksModule {\n default: SwarmExtension;\n config?: z.ZodTypeAny;\n }\n export interface ExtensionState {\n get<T = unknown>(key: string): Promise<T | null>;\n set<T>(key: string, value: T): Promise<void>;\n incr(key: string, by?: number): Promise<number>;\n del(key: string): Promise<void>;\n }\n export interface ExtensionLogger {\n debug(message: string, data?: unknown): void;\n info(message: string, data?: unknown): void;\n warn(message: string, data?: unknown): void;\n error(message: string, data?: unknown): void;\n }\n type ConfigFor<M extends ExtensionManifest> = M extends {\n config: infer C extends z.ZodTypeAny;\n }\n ? z.infer<C>\n : Record<string, unknown>;\n export interface ApiCtx<Config = Record<string, unknown>> {\n swarm: SwarmSdk;\n state: ExtensionState;\n config: Config;\n log: ExtensionLogger;\n signal: AbortSignal;\n event: {\n name: keyof SwarmEventMap;\n at: string;\n extension: {\n id: string;\n version: number;\n };\n };\n }\n export interface WorkerCtx<Config = Record<string, unknown>>\n extends Omit<ApiCtx<Config>, "swarm"> {\n swarm: SwarmSdk;\n worker: {\n agentId: string;\n taskId: string;\n harness: string;\n };\n }\n export type CtxFor<M extends ExtensionManifest> = M["runtime"] extends "api"\n ? ApiCtx<ConfigFor<M>>\n : WorkerCtx<ConfigFor<M>>;\n export type PreResult<Modify> =\n | void\n | {\n action: "continue";\n }\n | {\n action: "modify";\n data: Modify;\n }\n | {\n action: "block";\n reason: string;\n };\n export type TaskCreateOrigin =\n | "rest"\n | "app"\n | "mcp"\n | "slack"\n | "schedule"\n | "workflow"\n | "webhook"\n | "followUp"\n | `extension:${string}`;\n export interface TaskCreateEvent {\n options: CreateTaskOptions;\n description: string;\n origin: TaskCreateOrigin;\n requestInfo?: RequestInfo;\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n trigger: "mention" | "thread-buffer";\n messages: {\n ts: string;\n userId: string;\n text: string;\n }[];\n };\n }\n /** A pre.task.create hook blocked a task before it was created. */\n export interface TaskBlockedEvent {\n /** The extension that blocked, or whose model/agent rewrite was rejected. */\n extension: {\n id: string;\n name: string;\n };\n /** The scrubbed block reason. */\n reason: string;\n origin: TaskCreateOrigin;\n source?: AgentTask["source"];\n requester: {\n userId?: string;\n agentId?: string;\n slackUserId?: string;\n };\n context?: {\n contextKey?: string;\n scheduleId?: string;\n workflowRunId?: string;\n workflowRunStepId?: string;\n parentTaskId?: string;\n vcsRepo?: string;\n vcsNumber?: number;\n slackChannelId?: string;\n slackThreadTs?: string;\n };\n /** The original task description, scrubbed and cut to 500 characters. */\n description: string;\n }\n export type TaskCreateModify = Partial<\n Pick<\n CreateTaskOptions,\n | "agentId"\n | "creatorAgentId"\n | "source"\n | "taskType"\n | "tags"\n | "priority"\n | "dependsOn"\n | "offeredTo"\n | "vcsProvider"\n | "vcsRepo"\n | "vcsEventType"\n | "vcsNumber"\n | "vcsCommentId"\n | "vcsAuthor"\n | "vcsUrl"\n | "vcsInstallationId"\n | "vcsNodeId"\n | "agentmailInboxId"\n | "agentmailMessageId"\n | "agentmailThreadId"\n | "mentionMessageId"\n | "mentionChannelId"\n | "dir"\n | "model"\n | "modelTier"\n | "effort"\n | "outputSchema"\n | "followUpConfig"\n | "bypassTrackerContextDedup"\n >\n > & {\n description?: string;\n };\n export interface TaskFollowUpEvent {\n completedTask: AgentTask;\n status: "completed" | "failed";\n output?: string;\n failureReason?: string;\n workerAgentId: string;\n leadAgentId: string;\n summary: string;\n }\n export interface TaskSteerEvent {\n task: AgentTask;\n message: string;\n mode: SteerMode;\n source: SteeringSource;\n sender: {\n kind: "user" | "agent" | "system";\n userId?: string;\n agentId?: string;\n };\n messageTimestamps?: string[];\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n channelId: string;\n threadTs: string;\n userId?: string;\n };\n }\n export interface TaskSteerModify {\n message: string;\n }\n export type TaskFollowUpModify = Partial<\n Pick<CreateTaskOptions, "agentId" | "priority" | "followUpConfig">\n > & {\n description?: string;\n };\n export interface SlackRouteEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n botMentioned: boolean;\n threadContext?: {\n channelId: string;\n threadTs: string;\n };\n }\n export interface SlackRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n };\n }\n /** A Chat SDK message after its thread buffer flushed, before routing. */\n export interface ChatRouteEvent {\n /** Adapter name, such as `telegram` or `slack`. */\n adapter: string;\n channelId: string;\n /** The Chat SDK thread id, prefixed with the adapter name. */\n threadId: string;\n /** The first buffered sender. */\n userId: string;\n userName?: string;\n /** The buffered messages, joined. */\n text: string;\n /** True for an @mention and for a reply to one of the bot\'s messages. */\n botMentioned: boolean;\n isDirectMessage: boolean;\n /** Platform chat type, such as Telegram `private`, `group`, `supergroup` or `channel`. */\n chatType?: string;\n /** Set for a Telegram supergroup with topics. */\n isForum?: boolean;\n /** A buffered message replies to one of the bot\'s own messages. */\n replyToBot: boolean;\n /** Set when earlier swarm tasks exist in this thread. */\n threadContext?: {\n adapter: string;\n threadId: string;\n };\n }\n export interface ChatRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n }\n | {\n kind: "workflow";\n workflowId: string;\n };\n }\n export type HeartbeatClassification = "no-session" | "stale-session" | "fresh-stalled";\n export type HeartbeatAction = "supersede-resume" | "fail" | "record";\n export interface HeartbeatRemediateEvent {\n task: AgentTask;\n session?: ActiveSession;\n classification: HeartbeatClassification;\n proposedAction: HeartbeatAction;\n reason: string;\n taskAgeMs: number;\n sessionHeartbeatAgeMs?: number;\n }\n export interface HeartbeatRemediateModify {\n proposedAction: HeartbeatAction;\n }\n export interface ToolCallEvent {\n tool: string;\n args: unknown;\n requestInfo: RequestInfo;\n }\n export interface ToolCallModify {\n args: unknown;\n }\n export interface TaskEvent {\n task: AgentTask;\n }\n export interface TaskCompletedEvent extends TaskEvent {\n output: string;\n }\n export interface TaskFailedEvent extends TaskEvent {\n failureReason: string;\n }\n export interface TaskSupersededEvent extends TaskEvent {\n supersededBy: string;\n }\n export interface TaskProgressEvent extends TaskEvent {\n progress: string;\n }\n export interface SlackMessageEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n taskId?: string;\n }\n /** A Chat SDK message the swarm received or sent. */\n export interface ChatMessageEvent {\n adapter: string;\n channelId: string;\n threadId: string;\n /** The sender, for an inbound message. */\n userId?: string;\n text: string;\n direction: "inbound" | "outbound";\n taskId?: string;\n messageId?: string;\n }\n /**\n * A person answered an approval request. Fires for workflow and standalone\n * requests. Timeouts and cancellations do not emit it today.\n */\n export interface ApprovalResolvedEvent {\n requestId: string;\n status: "approved" | "rejected" | "timeout" | "cancelled";\n responses: Record<string, unknown> | null;\n /** Set when a workflow human-in-the-loop step asked. Absent for a standalone request. */\n workflowRunId?: string;\n workflowRunStepId?: string;\n /** The task whose agent asked, for a standalone request. */\n sourceTaskId?: string;\n }\n /** A task was refused because a daily spend budget is used up. */\n export interface TaskBudgetRefusedEvent extends TaskEvent {\n /** The agent the task was refused for. */\n agentId: string;\n /** Which budget refused it. The matching spend and budget fields are set. */\n cause: "agent" | "global" | "user";\n agentSpendUsd?: number;\n agentBudgetUsd?: number;\n globalSpendUsd?: number;\n globalBudgetUsd?: number;\n userSpendUsd?: number;\n userBudgetUsd?: number;\n /** ISO 8601 time the daily budget resets. */\n resetAt: string;\n }\n /** An inbound AgentMail message. */\n export interface EmailReceivedEvent {\n inboxId: string;\n /** The From header as sent. */\n from: string;\n subject: string;\n /** The text body, or the HTML when there is no text, cut to 500 characters with `...` appended. */\n body: string;\n threadId: string;\n messageId: string;\n }\n /** An inbound Kapso (WhatsApp) message. */\n export interface KapsoMessageEvent {\n phoneNumberId: string;\n conversationId?: string;\n messageId: string;\n from?: string;\n /** Kapso message type, such as `text` or `image`. */\n type?: string;\n /** The text, or a placeholder naming the type for a non-text message. */\n text: string;\n }\n export type VcsProvider = "github" | "gitlab" | "azure-devops" | "bitbucket";\n /**\n * The provider object the event is about, as the provider names it. GitLab\n * calls a pull request a merge request, and a comment a `note`.\n */\n export type VcsEventKind =\n | "pull_request"\n | "merge_request"\n | "issue"\n | "issue_comment"\n | "note"\n | "pull_request_review"\n | "pipeline";\n /**\n * A webhook event from a connected code host. `action` is the provider\'s own\n * value: `opened`, `closed`, `synchronize`, `merge`, `created`, `commented`, or,\n * for a pipeline, its status such as `success` or `failed`. Fields a kind does\n * not carry are absent.\n */\n export interface VcsEvent {\n provider: VcsProvider;\n kind: VcsEventKind;\n action: string;\n /** `owner/name` on GitHub and GitLab, `workspace/repo_slug` on Bitbucket, the repository URL on Azure DevOps. */\n repo: string;\n /** The PR, merge request, or issue number. Absent for a pipeline outside a merge request. */\n number?: number;\n title?: string;\n body?: string | null;\n /** Login of the user behind the event. Set for pull requests, merge requests, and Azure DevOps comments. */\n author?: string;\n url?: string;\n merged?: boolean;\n changedFiles?: number;\n /** The review verdict, on a pull request review. */\n reviewState?: string;\n }\n export interface ToolCallCompletedEvent extends ToolCallEvent {\n result: unknown;\n durationMs: number;\n }\n export interface SwarmEventMap {\n "pre.task.create": {\n event: TaskCreateEvent;\n modify: TaskCreateModify;\n result: PreResult<TaskCreateModify>;\n };\n "pre.task.followUp": {\n event: TaskFollowUpEvent;\n modify: TaskFollowUpModify;\n result: PreResult<TaskFollowUpModify>;\n };\n "pre.task.steer": {\n event: TaskSteerEvent;\n modify: TaskSteerModify;\n result: PreResult<TaskSteerModify>;\n };\n "pre.slack.route": {\n event: SlackRouteEvent;\n modify: SlackRouteModify;\n result: PreResult<SlackRouteModify>;\n };\n "pre.chat.route": {\n event: ChatRouteEvent;\n modify: ChatRouteModify;\n result: PreResult<ChatRouteModify>;\n };\n "pre.heartbeat.remediate": {\n event: HeartbeatRemediateEvent;\n modify: HeartbeatRemediateModify;\n result: PreResult<HeartbeatRemediateModify>;\n };\n "pre.tool.call": {\n event: ToolCallEvent;\n modify: ToolCallModify;\n result: PreResult<ToolCallModify>;\n };\n "post.task.created": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.blocked": {\n event: TaskBlockedEvent;\n modify: never;\n result: void;\n };\n "post.task.completed": {\n event: TaskCompletedEvent;\n modify: never;\n result: void;\n };\n "post.task.failed": {\n event: TaskFailedEvent;\n modify: never;\n result: void;\n };\n "post.task.cancelled": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.superseded": {\n event: TaskSupersededEvent;\n modify: never;\n result: void;\n };\n "post.task.progress": {\n event: TaskProgressEvent;\n modify: never;\n result: void;\n };\n "post.slack.message": {\n event: SlackMessageEvent;\n modify: never;\n result: void;\n };\n "post.chat.message": {\n event: ChatMessageEvent;\n modify: never;\n result: void;\n };\n "post.approval.resolved": {\n event: ApprovalResolvedEvent;\n modify: never;\n result: void;\n };\n "post.task.budgetRefused": {\n event: TaskBudgetRefusedEvent;\n modify: never;\n result: void;\n };\n "post.email.received": {\n event: EmailReceivedEvent;\n modify: never;\n result: void;\n };\n "post.kapso.message": {\n event: KapsoMessageEvent;\n modify: never;\n result: void;\n };\n "post.vcs.event": {\n event: VcsEvent;\n modify: never;\n result: void;\n };\n "post.tool.call": {\n event: ToolCallCompletedEvent;\n modify: never;\n result: void;\n };\n }\n export interface ExtensionApi<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > {\n on<E extends keyof SwarmEventMap>(\n event: E,\n handler: (\n event: SwarmEventMap[E]["event"],\n ctx: CtxFor<M>,\n ) => Promise<SwarmEventMap[E]["result"]> | SwarmEventMap[E]["result"],\n opts?: {\n priority?: number;\n },\n ): void;\n }\n export type SwarmExtension<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > = (api: ExtensionApi<M>) => void;\n export { block, modify } from "./contract-runtime";\n}\n';
@@ -51,6 +51,7 @@ import {
51
51
  upsertKv,
52
52
  } from "../be/db";
53
53
  import { repointTrackerSyncBySwarmId } from "../be/db-queries/tracker";
54
+ import { withLoopPath } from "../be/event-loop-lag";
54
55
  import { poolTaskRunsOnHarness } from "../be/model-validation";
55
56
  import {
56
57
  countActiveRuntimeInstancesForAgent,
@@ -2031,8 +2032,8 @@ export function startHeartbeat(intervalMs = defaultIntervalMs()): void {
2031
2032
  // `finally` but has no `catch`, so a throw anywhere inside it escapes as an
2032
2033
  // unhandled rejection unless it is caught here.
2033
2034
  setTimeout(() => {
2034
- runRebootSweep()
2035
- .then(() => runHeartbeatSweep())
2035
+ withLoopPath("heartbeat.boot-sweep", () => runRebootSweep())
2036
+ .then(() => withLoopPath("heartbeat.sweep", () => runHeartbeatSweep()))
2036
2037
  .catch((err) =>
2037
2038
  console.error(
2038
2039
  "[Heartbeat] boot sweep failed:",
@@ -2042,7 +2043,7 @@ export function startHeartbeat(intervalMs = defaultIntervalMs()): void {
2042
2043
  }, 5000);
2043
2044
 
2044
2045
  heartbeatInterval = setInterval(() => {
2045
- runHeartbeatSweep().catch((err) =>
2046
+ withLoopPath("heartbeat.sweep", () => runHeartbeatSweep()).catch((err) =>
2046
2047
  console.error(
2047
2048
  "[Heartbeat] sweep failed:",
2048
2049
  scrubSecrets(err instanceof Error ? err.message : String(err)),
@@ -2163,7 +2164,7 @@ export function startHeartbeatChecklist(intervalMs = heartbeatChecklistIntervalM
2163
2164
 
2164
2165
  // Recurring checklist starts from the second interval onward
2165
2166
  checklistInterval = setInterval(() => {
2166
- checkHeartbeatChecklist().catch((err) =>
2167
+ withLoopPath("heartbeat.checklist", () => checkHeartbeatChecklist()).catch((err) =>
2167
2168
  console.error(
2168
2169
  "[Heartbeat] checklist check failed:",
2169
2170
  scrubSecrets(err instanceof Error ? err.message : String(err)),
package/src/hooks/hook.ts CHANGED
@@ -1033,11 +1033,20 @@ export async function handleHook(): Promise<void> {
1033
1033
  return lines.join("\n");
1034
1034
  };
1035
1035
 
1036
- // Ping the server to indicate activity
1037
- await ping();
1036
+ const isToolEvent = msg.hook_event_name === "PreToolUse" || msg.hook_event_name === "PostToolUse";
1038
1037
 
1039
- // Get current agent info
1040
- const agentInfo = await getAgentInfo();
1038
+ // Ping the server to indicate activity, then get current agent info.
1039
+ // Ping can move an `offline` agent to `idle`; the status line printed on
1040
+ // non-tool events shows that status, so those events keep the order. Tool
1041
+ // events print no status line and only read `busy`, which ping never sets,
1042
+ // so they issue both requests together and save one round trip per call.
1043
+ let agentInfo: AgentWithInbox | undefined;
1044
+ if (isToolEvent) {
1045
+ [, agentInfo] = await Promise.all([ping(), getAgentInfo()]);
1046
+ } else {
1047
+ await ping();
1048
+ agentInfo = await getAgentInfo();
1049
+ }
1041
1050
 
1042
1051
  // A block must be the only stdout of the event, so a cancelled task is
1043
1052
  // checked before the status line goes out.
@@ -1054,7 +1063,6 @@ export async function handleHook(): Promise<void> {
1054
1063
 
1055
1064
  // Output agent status with system tray. Skipped on tool events: their plain
1056
1065
  // stdout never reaches the model and would break a JSON decision.
1057
- const isToolEvent = msg.hook_event_name === "PreToolUse" || msg.hook_event_name === "PostToolUse";
1058
1066
  if (agentInfo && !isToolEvent) {
1059
1067
  // Base status line
1060
1068
  console.log(
@@ -72,6 +72,7 @@ import "./trackers/jira";
72
72
  import "./trackers/linear";
73
73
  import "./ranking";
74
74
  import "./used-by";
75
+ import "./improvements";
75
76
  import "./fleet-benchmark";
76
77
  import "./user-roles";
77
78
  import "./users";
@@ -43,7 +43,8 @@ import {
43
43
  } from "../workflows/approval-notifications";
44
44
  import { workflowEventBus } from "../workflows/event-bus";
45
45
  import { ensureConfigAdmin, runConfigWriteSideEffects } from "./config";
46
- import { agentFirstPrincipal, authUser, authUserId } from "./request-principal";
46
+ import { type ApprovalResponder, approvalResponder, responderKey } from "./person-responder";
47
+ import { agentFirstPrincipal, authUserId } from "./request-principal";
47
48
  import { bodyTask, route } from "./route-def";
48
49
  import { jsonError } from "./utils";
49
50
 
@@ -931,49 +932,6 @@ async function approvalCallerPrincipal(
931
932
  return { principal, resolvedBy };
932
933
  }
933
934
 
934
- type ApprovalResponder = { kind: "user"; user: User } | { kind: "operator" };
935
-
936
- const AGENT_RESPONSE_REFUSED =
937
- "Agents cannot answer approval requests. A person must respond with a user token or the dashboard.";
938
-
939
- /**
940
- * The person answering an approval request, taken from the credential and
941
- * never from the request body. Every agent identity is refused: an `aseph_`
942
- * session token, the shared key with an `X-Agent-ID`, and a page session with
943
- * no signed-in user (page code is agent-authored, so it cannot vouch for a
944
- * person). The shared key alone is the operator.
945
- */
946
- async function approvalResponder(
947
- req: IncomingMessage,
948
- ): Promise<{ ok: true; responder: ApprovalResponder } | { ok: false; message: string }> {
949
- const auth = getRequestAuth(req);
950
- const rawAgentId = req.headers["x-agent-id"];
951
- const headerAgentId = Array.isArray(rawAgentId) ? rawAgentId[0] : rawAgentId;
952
- const principal = await agentFirstPrincipal(req, headerAgentId);
953
-
954
- if (principal.kind !== "user" && principal.kind !== "agent" && auth?.page) {
955
- return {
956
- ok: false,
957
- message: "A page session without a signed-in user cannot answer approval requests.",
958
- };
959
- }
960
- const user = authUser(auth);
961
- const responder: ApprovalResponder | null =
962
- principal.kind === "user" && user
963
- ? { kind: "user", user }
964
- : principal.kind === "operator"
965
- ? { kind: "operator" }
966
- : null;
967
-
968
- const decision = can({ principal, verb: "approval.respond", source: "http" });
969
- if (!decision.allow || !responder) return { ok: false, message: AGENT_RESPONSE_REFUSED };
970
- return { ok: true, responder };
971
- }
972
-
973
- function responderKey(responder: ApprovalResponder): string {
974
- return responder.kind === "user" ? responder.user.id : "operator";
975
- }
976
-
977
935
  function userMatchesListed(user: Pick<User, "id" | "email">, listed: string): boolean {
978
936
  if (listed === user.id) return true;
979
937
  return !!user.email && listed.toLowerCase() === user.email.toLowerCase();
package/src/http/auth.ts CHANGED
@@ -4,7 +4,7 @@ import {
4
4
  findUserById,
5
5
  fingerprintApiKey,
6
6
  resolveSessionToken,
7
- resolveUserByToken,
7
+ resolveUserToken,
8
8
  } from "../be/users";
9
9
  import type { User } from "../types";
10
10
  import { verifyPageSession } from "../utils/page-session";
@@ -54,9 +54,10 @@ export async function resolveHttpRequestAuth(
54
54
  }
55
55
 
56
56
  if (bearer.startsWith("aswt_")) {
57
- const user = await resolveUserByToken(bearer);
58
- if (isActiveUser(user)) {
59
- return { kind: "user", userId: user.id, user };
57
+ const resolved = await resolveUserToken(bearer);
58
+ const user = resolved?.user ?? null;
59
+ if (resolved && isActiveUser(user)) {
60
+ return { kind: "user", userId: user.id, user, tokenId: resolved.tokenId };
60
61
  }
61
62
  }
62
63
 
@@ -2,7 +2,6 @@ import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
3
  import { decryptSecret, getEncryptionKey } from "../be/crypto";
4
4
  import { deleteKv, deleteSwarmConfigByKey, getDbClient, getKeyStatuses, getKv } from "../be/db";
5
- import { retirePoolKeyStatus } from "../be/db/api-keys";
6
5
  import { deriveCodexKeySuffix } from "../providers/codex-oauth/auth-json";
7
6
  import { decodeJwt, extractChatgptPlanType } from "../providers/codex-oauth/flow";
8
7
  import { MAX_CODEX_OAUTH_SLOT } from "../providers/codex-oauth/storage";
@@ -92,11 +91,6 @@ function readCredentials(row: AccountRow): z.infer<typeof AccountCredentialsSche
92
91
  }
93
92
  }
94
93
 
95
- function accountSuffix(row: AccountRow): string | null {
96
- const credentials = readCredentials(row);
97
- return credentials ? deriveCodexKeySuffix(credentials.access, credentials.accountId) : null;
98
- }
99
-
100
94
  async function accountsResponse(): Promise<CodexAccountsResponse> {
101
95
  const rows = await accountRows();
102
96
  const statuses = await getKeyStatuses("CODEX_OAUTH", "global", null);
@@ -116,18 +110,24 @@ async function accountsResponse(): Promise<CodexAccountsResponse> {
116
110
  accounts.push(account);
117
111
  continue;
118
112
  }
119
- account.suffix = deriveCodexKeySuffix(credentials.access, credentials.accountId);
113
+ account.suffix = deriveCodexKeySuffix(credentials.access, credentials.accountId, row.slot);
120
114
  account.plan = extractChatgptPlanType(credentials.access);
121
115
  const profile = decodeJwt(credentials.access)?.["https://api.openai.com/profile"];
122
116
  if (profile && typeof profile === "object" && "email" in profile) {
123
117
  account.email = typeof profile.email === "string" && profile.email ? profile.email : null;
124
118
  }
125
- const status = statuses.find((entry) => entry.keySuffix === account.suffix);
119
+ // Pool availability reads Codex rows by keyIndex, so a row stored at this
120
+ // slot under an older suffix format still decides whether it is benched.
121
+ const slotStatuses = statuses.filter(
122
+ (entry) => entry.keySuffix === account.suffix || entry.keyIndex === row.slot,
123
+ );
124
+ const status = slotStatuses.find((entry) => entry.keySuffix === account.suffix);
126
125
  const marker = await getKv(CODEX_AUTH_WATCH_NAMESPACE, codexAuthBenchMarkerKey(account.suffix));
127
- const statusBenched =
128
- status &&
129
- status.consecutiveAuthFailures >= CODEX_AUTH_FAILURE_BENCH_THRESHOLD &&
130
- status.status === "rate_limited";
126
+ const statusBenched = slotStatuses.some(
127
+ (entry) =>
128
+ entry.consecutiveAuthFailures >= CODEX_AUTH_FAILURE_BENCH_THRESHOLD &&
129
+ entry.status === "rate_limited",
130
+ );
131
131
  account.status = marker || statusBenched ? "needs_login" : status ? "ok" : "unchecked";
132
132
  accounts.push(account);
133
133
  }
@@ -165,17 +165,25 @@ export async function handleCodexOAuthAccounts(
165
165
  const account = rows.find((row) => row.slot === parsed.params.slot);
166
166
  if (!account || !(await deleteSwarmConfigByKey("global", null, account.key))) return null;
167
167
  // A new sign-in takes the first free slot, so it must not inherit this
168
- // account's auth bench (keyed by slot) or its bench marker.
169
- const suffix = accountSuffix(account);
170
- if (suffix) {
171
- const remaining = rows.flatMap((row) => {
172
- const keySuffix = row === account ? null : accountSuffix(row);
173
- return keySuffix ? [{ keySuffix, keyIndex: row.slot }] : [];
174
- });
175
- await retirePoolKeyStatus("CODEX_OAUTH", suffix, remaining);
176
- if (!remaining.some((row) => row.keySuffix === suffix)) {
177
- await deleteKv(CODEX_AUTH_WATCH_NAMESPACE, codexAuthBenchMarkerKey(suffix));
178
- }
168
+ // account's auth bench or its bench marker. Suffixes carry the slot, so
169
+ // every status row at this slot index is this account's, including rows
170
+ // stored under the pre-slot suffix format.
171
+ const credentials = readCredentials(account);
172
+ const suffix = credentials
173
+ ? deriveCodexKeySuffix(credentials.access, credentials.accountId, account.slot)
174
+ : null;
175
+ const retired = await getDbClient().query<{ keySuffix: string }>(
176
+ `DELETE FROM api_key_status
177
+ WHERE keyType = 'CODEX_OAUTH' AND scope = 'global' AND scopeId = ''
178
+ AND (keyIndex = ? OR keySuffix = ?)
179
+ RETURNING keySuffix`,
180
+ [account.slot, suffix],
181
+ );
182
+ for (const keySuffix of new Set([
183
+ ...(suffix ? [suffix] : []),
184
+ ...retired.map((r) => r.keySuffix),
185
+ ])) {
186
+ await deleteKv(CODEX_AUTH_WATCH_NAMESPACE, codexAuthBenchMarkerKey(keySuffix));
179
187
  }
180
188
  return account.key;
181
189
  });
@@ -218,7 +218,7 @@ async function completeFlow(
218
218
  // OpenAI just issued this token. Record the account as checked, so the
219
219
  // account list says "Signed in" now: a worker's Codex check is a presence
220
220
  // check and reports no per-account result.
221
- const keySuffix = deriveCodexKeySuffix(credentials.access, credentials.accountId);
221
+ const keySuffix = deriveCodexKeySuffix(credentials.access, credentials.accountId, slot);
222
222
  const checked = [{ keyIndex: slot, keySuffix, ok: true }];
223
223
  await recordKeyValidation("CODEX_OAUTH", checked, "global", null, { retireAbsent: false });
224
224
  await updateOnboardingAiFromCodexDevice({ status: "complete" });
@@ -106,7 +106,7 @@ export async function handleCodexOAuthKeepWarm(
106
106
  const results: SlotOutcome[] = [];
107
107
 
108
108
  for (const { slot, creds } of slots) {
109
- const keySuffix = deriveCodexKeySuffix(creds.access, creds.accountId);
109
+ const keySuffix = deriveCodexKeySuffix(creds.access, creds.accountId, slot);
110
110
 
111
111
  if (await getKv(CODEX_AUTH_WATCH_NAMESPACE, codexAuthBenchMarkerKey(keySuffix))) {
112
112
  results.push({ slot, keySuffix, outcome: "skipped-benched" });
package/src/http/core.ts CHANGED
@@ -41,7 +41,8 @@ import { restartChatSdkIfConfigChanged } from "../integrations/chat-sdk/runtime"
41
41
  import { initJira, resetJira } from "../jira";
42
42
  import { initLinear, resetLinear } from "../linear";
43
43
  import { can, decideAdmission, isRbacEnabled } from "../rbac";
44
- import { startSlackApp, stopSlackApp } from "../slack";
44
+ import { startSlackApp, stopSlackAppUnderLifecycleLock } from "../slack";
45
+ import { runSlackLifecycleExclusive } from "../slack/lifecycle-lock";
45
46
  import type { AgentStatus } from "../types";
46
47
  import { isMultiRuntimeEnabled } from "../utils/multi-runtime";
47
48
  import {
@@ -180,7 +181,11 @@ export async function reloadGlobalConfigsAndIntegrations(): Promise<ReloadConfig
180
181
  // request's frame they capture that request's auth slot for their whole
181
182
  // lifetime, and their later DB writes get attributed to whichever user
182
183
  // happened to save config.
183
- return runWithoutRequestAuth(() => reloadGlobalConfigsAndIntegrationsInner());
184
+ // The shared Slack lifecycle lock keeps the socket watchdog from restarting
185
+ // the Slack app while a reload tears it down and rebuilds it.
186
+ return runWithoutRequestAuth(() =>
187
+ runSlackLifecycleExclusive(() => reloadGlobalConfigsAndIntegrationsInner()),
188
+ );
184
189
  }
185
190
 
186
191
  async function reloadGlobalConfigsAndIntegrationsInner(): Promise<ReloadConfigResult> {
@@ -201,7 +206,8 @@ async function reloadGlobalConfigsAndIntegrationsInner(): Promise<ReloadConfigRe
201
206
 
202
207
  // Retire the old transport before any other integration can fail during
203
208
  // reload. HTTP/invalid selection must never leave the previous socket live.
204
- await stopSlackApp();
209
+ // The reload already holds the Slack lifecycle lock (see the caller).
210
+ await stopSlackAppUnderLifecycleLock();
205
211
 
206
212
  // File-storage provider selection reads process.env once and memoizes; the
207
213
  // env we just (re)hydrated may flip it (local-fs → agent-fs after late