@desplega.ai/agent-swarm 2.13.5 → 2.14.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (551) hide show
  1. package/dist/acp-adapter-7jv7w8jh.js +17 -0
  2. package/dist/{acp-targets-w8dbs4nr.js → acp-targets-0ebmg3et.js} +10 -10
  3. package/dist/{actions-8zrcbjrx.js → actions-0ds9dx6c.js} +63 -42
  4. package/dist/{agent-fs-provision-cbt2ttds.js → agent-fs-provision-zpbxa9jc.js} +4 -4
  5. package/dist/{amp-adapter-8x6zp8w4.js → amp-adapter-awh5nn7a.js} +3 -3
  6. package/dist/{anthropic-messages-vdd1zmha.js → anthropic-messages-gtgp9r85.js} +17 -17
  7. package/dist/{app-zfa9dwjw.js → app-nzejkvpp.js} +10 -10
  8. package/dist/{approval-notifications-rv92zmza.js → approval-notifications-hbqtb2w3.js} +11 -11
  9. package/dist/{assistant-q7s7rm1q.js → assistant-1paft129.js} +42 -37
  10. package/dist/{boot-args-schema-g27kpzr1.js → boot-args-schema-zs435mfx.js} +1 -1
  11. package/dist/{boot-reembed-1mjs52nt.js → boot-reembed-7xq2qgg4.js} +1 -1
  12. package/dist/{boot-reembed-m62dpdkg.js → boot-reembed-91qrd4mz.js} +1 -1
  13. package/dist/{boot-scrub-sweep-ss1vcamw.js → boot-scrub-sweep-3h5xscw6.js} +2 -2
  14. package/dist/{boot-seeds-hwnvgbb3.js → boot-seeds-xkxqa8zc.js} +4 -4
  15. package/dist/{boxd-y0szhp0g.js → boxd-464x3w4m.js} +4 -4
  16. package/dist/{claude-adapter-0rjmbhjk.js → claude-adapter-6d8eyf2f.js} +12 -13
  17. package/dist/{claude-managed-adapter-6k032agg.js → claude-managed-adapter-jzxcaf9m.js} +4 -4
  18. package/dist/{claude-managed-setup-6czvve8q.js → claude-managed-setup-5fcx0qh3.js} +10 -10
  19. package/dist/{claude-sdk-session-pr0znb81.js → claude-sdk-session-11vhz1hc.js} +12720 -13882
  20. package/dist/{cli-kr0jpw9c.js → cli-02ba8qx5.js} +1 -1
  21. package/dist/{cli-ywy8yz6t.js → cli-08gfvs58.js} +2 -2
  22. package/dist/{cli-0qt3epg4.js → cli-0dkpdvnn.js} +10 -10
  23. package/dist/{cli-s8dhq7rj.js → cli-0mq8kxfx.js} +5 -5
  24. package/dist/{cli-ybte1fqc.js → cli-0nvqg1hb.js} +1 -1
  25. package/dist/{cli-f9xw9pr4.js → cli-0qyfna7a.js} +5 -5
  26. package/dist/cli-0vxbrxr3.js +1006 -0
  27. package/dist/{cli-ehg90jd1.js → cli-132h67ps.js} +64 -59
  28. package/dist/{cli-f7b9nyvk.js → cli-1e13gvfn.js} +17 -17
  29. package/dist/cli-1hj68b3h.js +30 -0
  30. package/dist/{cli-srktrbby.js → cli-1zbj28py.js} +1 -1
  31. package/dist/{cli-q41qar56.js → cli-20mkgwev.js} +173 -46
  32. package/dist/{cli-v09eza21.js → cli-288k5ep1.js} +15 -15
  33. package/dist/{cli-abby987g.js → cli-2n7qdqfv.js} +3 -3
  34. package/dist/{cli-kezzteka.js → cli-2r62jy9s.js} +1 -1
  35. package/dist/{cli-qmx8bnt4.js → cli-3179w2rz.js} +2 -2
  36. package/dist/cli-3a3hm1z8.js +15 -0
  37. package/dist/cli-3bagv8rt.js +37 -0
  38. package/dist/{cli-zxa1vmx7.js → cli-3bcsc3m7.js} +2 -2
  39. package/dist/{cli-j69pzrrz.js → cli-3g0vbq46.js} +5 -5
  40. package/dist/{cli-69szn7w7.js → cli-3ktfe5jx.js} +71 -47
  41. package/dist/{cli-69zzpjgh.js → cli-44r66df2.js} +1 -1
  42. package/dist/{cli-grbngev5.js → cli-466jjrwe.js} +11 -2
  43. package/dist/{cli-1jq2em7b.js → cli-4y2bekkn.js} +10 -9
  44. package/dist/cli-547fsc36.js +15 -0
  45. package/dist/{cli-6p8p2e6r.js → cli-5pyes68e.js} +1278 -23
  46. package/dist/{cli-ewk3sg68.js → cli-5t00r6c9.js} +3 -3
  47. package/dist/{cli-wzecestt.js → cli-5xjdft4s.js} +4063 -1835
  48. package/dist/{cli-4dyzzkfb.js → cli-643skca1.js} +954 -180
  49. package/dist/{cli-vr4eyq6p.js → cli-6a77m17n.js} +540 -412
  50. package/dist/{cli-v41kn3cd.js → cli-6prwz0zn.js} +4427 -5566
  51. package/dist/{cli-ks06cd0n.js → cli-6xrbpj5j.js} +8 -8
  52. package/dist/{cli-meydjstb.js → cli-6yhjqd6k.js} +4965 -69
  53. package/dist/{cli-bvamr9g0.js → cli-727sq1f9.js} +4 -4
  54. package/dist/{cli-snxhtehz.js → cli-7abeph0b.js} +7 -8
  55. package/dist/{cli-ty3gha1p.js → cli-7b9bwrfg.js} +2 -2
  56. package/dist/{cli-vbge4rsp.js → cli-7dwsn9y5.js} +4 -4
  57. package/dist/{cli-1kvcsd2f.js → cli-7qkbab03.js} +76 -8
  58. package/dist/{cli-8b4rpnwj.js → cli-7svwhw1a.js} +1 -1
  59. package/dist/{cli-jdq3jmny.js → cli-83kf2y60.js} +8 -10
  60. package/dist/{cli-tgc1kgg3.js → cli-84wxwt3z.js} +1 -1
  61. package/dist/{cli-sejvnjvw.js → cli-8crn0510.js} +1 -1
  62. package/dist/{cli-19d6v8er.js → cli-8kemtj1r.js} +172 -18
  63. package/dist/{cli-qrvk9nka.js → cli-967jrz7j.js} +40 -26
  64. package/dist/{cli-cp163xga.js → cli-976m0zcw.js} +72 -50
  65. package/dist/{cli-887vhew6.js → cli-98sea4d9.js} +2716 -2643
  66. package/dist/{cli-xh5fpmg8.js → cli-9txap41q.js} +101 -18
  67. package/dist/{cli-nrt048ys.js → cli-aktk3qt6.js} +40 -3
  68. package/dist/{cli-t0n9svkb.js → cli-b70cpf8f.js} +12 -7
  69. package/dist/{cli-2ap1the6.js → cli-by7s3n4p.js} +1 -1
  70. package/dist/{cli-tt7dkwjj.js → cli-byzq8xht.js} +7 -7
  71. package/dist/{cli-55h8m1x3.js → cli-d1zkys4j.js} +150 -99
  72. package/dist/cli-dr6x9qdk.js +15 -0
  73. package/dist/cli-dt931hb8.js +9740 -0
  74. package/dist/{cli-emdfd8fh.js → cli-dy754erz.js} +9 -1
  75. package/dist/{cli-2wzkvfgm.js → cli-e1wprqnd.js} +3 -3
  76. package/dist/{cli-pedm2kht.js → cli-e2wzzw17.js} +2 -2
  77. package/dist/{cli-1jx0srjt.js → cli-e9p9h14n.js} +1921 -80
  78. package/dist/{cli-evy3egte.js → cli-eaqxkeq0.js} +14 -103
  79. package/dist/{cli-he5nxaa8.js → cli-etykr11s.js} +3062 -728
  80. package/dist/{cli-3vw6dd4g.js → cli-f07sgaax.js} +2 -2
  81. package/dist/{cli-z1vam71h.js → cli-fe8he9cy.js} +2 -2
  82. package/dist/{cli-94gx6ze9.js → cli-h0edykd1.js} +1 -1
  83. package/dist/cli-h5cveb69.js +15 -0
  84. package/dist/{cli-5tq15aa7.js → cli-hamdfjtx.js} +2 -2
  85. package/dist/{cli-kwj3131p.js → cli-hh5m39pt.js} +1 -1
  86. package/dist/{cli-tvyt8w6n.js → cli-j8fmn3wv.js} +11 -11
  87. package/dist/cli-jngvszex.js +1514 -0
  88. package/dist/{cli-9n6g14vs.js → cli-k791mabe.js} +6 -6
  89. package/dist/{cli-6msnpj1z.js → cli-k9m8fckz.js} +10 -10
  90. package/dist/{cli-2vp0z049.js → cli-kz8rar0g.js} +1 -1
  91. package/dist/{cli-94mxerrp.js → cli-n15fhd43.js} +1 -1
  92. package/dist/{cli-htb5bpz2.js → cli-nmdy8bzf.js} +10 -3
  93. package/dist/{cli-t9pzz2eq.js → cli-ntmjzyte.js} +4 -1
  94. package/dist/{cli-avax5mp9.js → cli-ny8f5g7t.js} +19 -7
  95. package/dist/cli-p0g0erm9.js +15 -0
  96. package/dist/{cli-n79j1vxc.js → cli-pgdqhdkw.js} +4 -4
  97. package/dist/cli-ph1jce1b.js +16 -0
  98. package/dist/{cli-ced4azn1.js → cli-phantfg3.js} +771 -401
  99. package/dist/{cli-ebpq3c5z.js → cli-rb1z91g8.js} +10221 -1397
  100. package/dist/{cli-a49frv85.js → cli-redtbppc.js} +1 -1
  101. package/dist/{cli-cmbb2t8a.js → cli-s7bfz1ye.js} +15 -15
  102. package/dist/{cli-8pd1t17c.js → cli-sf5kp73f.js} +18 -18
  103. package/dist/{cli-zbbtp02a.js → cli-sq32dgfe.js} +1837 -7206
  104. package/dist/{cli-k0nebh10.js → cli-tbrjvrrg.js} +1 -1
  105. package/dist/{cli-4gaf3tx5.js → cli-tdd9dvw6.js} +1 -1
  106. package/dist/{cli-7ypg8hka.js → cli-tjrrabez.js} +3 -3
  107. package/dist/{cli-q1h041y8.js → cli-tkrp183j.js} +11 -11
  108. package/dist/{cli-srre41gb.js → cli-trvtxwzt.js} +2 -2
  109. package/dist/{cli-ffn0a515.js → cli-v1rhq77v.js} +68 -25
  110. package/dist/{cli-t879ww0y.js → cli-v3jxx8dv.js} +2 -2
  111. package/dist/{cli-b42yfn17.js → cli-v84kb7af.js} +14 -14
  112. package/dist/{cli-sa02jsqt.js → cli-vp2ksaq9.js} +1 -1
  113. package/dist/{cli-b0m3bg0f.js → cli-vrb8pvrf.js} +6 -6
  114. package/dist/cli-vxxdf2ma.js +15 -0
  115. package/dist/{cli-x2adbg4j.js → cli-w81s97bn.js} +1 -1
  116. package/dist/{cli-4vynxtrb.js → cli-wkzrknpt.js} +10 -3
  117. package/dist/{cli-fw67mnyc.js → cli-wqpvfq2m.js} +1 -1
  118. package/dist/{cli-prz1p3ft.js → cli-wsh5vfa7.js} +9 -9
  119. package/dist/{cli-hd5bm1e1.js → cli-wtwe8vng.js} +45 -45
  120. package/dist/{cli-34fygf87.js → cli-ww8wxfzx.js} +2 -2
  121. package/dist/{cli-e8trbfx1.js → cli-x80zagf5.js} +1 -1
  122. package/dist/{cli-zntvmqmm.js → cli-xd6ntv7x.js} +2 -2
  123. package/dist/{cli-vcpyttcw.js → cli-xmc2nrtv.js} +1 -1
  124. package/dist/{cli-z40t85ms.js → cli-ytgtqsy9.js} +1 -1
  125. package/dist/{cli-r3dxpmyt.js → cli-yvnnyjxm.js} +1 -1
  126. package/dist/{cli-zzq96q57.js → cli-z0c98h7h.js} +2450 -554
  127. package/dist/{cli-ryem5cfq.js → cli-z0effej1.js} +217 -27
  128. package/dist/{cli-0h8skzss.js → cli-zcb64xzv.js} +4 -3
  129. package/dist/{cli-5web09sb.js → cli-zdkcp8p0.js} +8 -10
  130. package/dist/{cli-z3x7h79n.js → cli-zgsd2w2k.js} +20 -22
  131. package/dist/{cli-7r9tvk8v.js → cli-zmfs06hg.js} +15 -9
  132. package/dist/{cli-3860pmrq.js → cli-zvsy4abb.js} +4 -4
  133. package/dist/{cli-5n9w2xzx.js → cli-zyf288rw.js} +2 -2
  134. package/dist/cli.js +64 -65
  135. package/dist/{codex-adapter-bn7eaxk5.js → codex-adapter-seht4h9t.js} +9 -9
  136. package/dist/{codex-hook-nnmezjg9.js → codex-hook-w5nmtrn2.js} +3 -3
  137. package/dist/{codex-login-ktfg1cxk.js → codex-login-67qarfcg.js} +1 -1
  138. package/dist/{codex-session-runner-j1e9hffc.js → codex-session-runner-tq95x3gq.js} +10 -10
  139. package/dist/{commands-amhpafrr.js → commands-0awwqxq5.js} +3 -3
  140. package/dist/{controller-tw7g10j2.js → controller-hgjx521c.js} +4 -4
  141. package/dist/{controllers-connect-2ssqz7f4.js → controllers-connect-j4kdmhfj.js} +28 -29
  142. package/dist/core-8fw1gwg7.js +41 -0
  143. package/dist/{cursor-adapter-d6knjmwa.js → cursor-adapter-0rg8wk6j.js} +2 -2
  144. package/dist/{db-fd6xxm77.js → db-8xs2js3s.js} +3 -3
  145. package/dist/{db-sc59379z.js → db-dd6hj211.js} +4 -2
  146. package/dist/{devin-adapter-3bp6rape.js → devin-adapter-tn1twrha.js} +1 -1
  147. package/dist/{devtools-qxfgbsqz.js → devtools-b8qts77k.js} +1 -1
  148. package/dist/{dispatcher-a2gdqz8c.js → dispatcher-v7drd034.js} +24 -25
  149. package/dist/{docker-a59g3ebm.js → docker-6007r2fj.js} +2 -2
  150. package/dist/dsh-adapter-ah8npj2x.js +11 -0
  151. package/dist/{e2b-qnxyfea6.js → e2b-hg80w0qr.js} +3 -3
  152. package/dist/{e2b-cn7cvjqy.js → e2b-z1g7vpz6.js} +16 -5
  153. package/dist/{easter-egg-3d-a0pphy71.js → easter-egg-3d-8n4w3s9k.js} +1 -1
  154. package/dist/{embedding-space-qepzrach.js → embedding-space-0p921zt3.js} +13 -23
  155. package/dist/{embeddings-d7vr881x.js → embeddings-9s7kbrc6.js} +1 -1
  156. package/dist/emscripten-module-Q67P5WYC-3sde6cre.js +2458 -0
  157. package/dist/{event-bus-7gbsr0g4.js → event-bus-pawddp92.js} +1 -1
  158. package/dist/{execute-6afts2bn.js → execute-x0fy9j0m.js} +1 -1
  159. package/dist/{external-channel-881zq1x4.js → external-channel-ktfvn29c.js} +2 -2
  160. package/dist/ffi-cbfmmtqk.js +85 -0
  161. package/dist/fx-adapter-15vjxvgm.js +20 -0
  162. package/dist/getMachineId-bsd-2rd3pnz7.js +36 -0
  163. package/dist/getMachineId-bsd-3p48mkt1.js +36 -0
  164. package/dist/{getMachineId-bsd-637a7rbk.js → getMachineId-bsd-bk6tmeen.js} +5 -5
  165. package/dist/getMachineId-bsd-pssqgwmm.js +37 -0
  166. package/dist/getMachineId-bsd-v218x3xd.js +36 -0
  167. package/dist/getMachineId-bsd-wbxcazef.js +36 -0
  168. package/dist/getMachineId-bsd-x0942pbz.js +36 -0
  169. package/dist/getMachineId-darwin-5qsy4qcg.js +36 -0
  170. package/dist/getMachineId-darwin-6v7zsshx.js +37 -0
  171. package/dist/getMachineId-darwin-fcc3fjag.js +36 -0
  172. package/dist/getMachineId-darwin-pg84hftj.js +36 -0
  173. package/dist/{getMachineId-darwin-9vytrcnn.js → getMachineId-darwin-tyyevt26.js} +5 -5
  174. package/dist/getMachineId-darwin-wagmbf0d.js +36 -0
  175. package/dist/getMachineId-darwin-zvkmwr3y.js +36 -0
  176. package/dist/{getMachineId-linux-mkzsvyyz.js → getMachineId-linux-2ncg1epd.js} +3 -3
  177. package/dist/getMachineId-linux-2tmt2ptc.js +29 -0
  178. package/dist/getMachineId-linux-empwyp2y.js +29 -0
  179. package/dist/getMachineId-linux-fanqd45b.js +29 -0
  180. package/dist/getMachineId-linux-h6fyga0x.js +29 -0
  181. package/dist/getMachineId-linux-tbhgz1k9.js +29 -0
  182. package/dist/getMachineId-linux-zrbyw7dt.js +29 -0
  183. package/dist/getMachineId-unsupported-29g9dkgv.js +19 -0
  184. package/dist/getMachineId-unsupported-8xfq8djv.js +19 -0
  185. package/dist/getMachineId-unsupported-8y9cag1p.js +19 -0
  186. package/dist/getMachineId-unsupported-a6sjrm02.js +19 -0
  187. package/dist/getMachineId-unsupported-bp3w7ds0.js +19 -0
  188. package/dist/{getMachineId-unsupported-4cfs2n11.js → getMachineId-unsupported-sj6fk8sw.js} +3 -3
  189. package/dist/getMachineId-unsupported-v0p5gdxp.js +19 -0
  190. package/dist/getMachineId-win-hc996p0x.js +38 -0
  191. package/dist/{getMachineId-win-154s3qma.js → getMachineId-win-msq9ad87.js} +6 -6
  192. package/dist/getMachineId-win-tajyqwd6.js +38 -0
  193. package/dist/getMachineId-win-tzc163da.js +38 -0
  194. package/dist/getMachineId-win-xdaa0mgq.js +38 -0
  195. package/dist/getMachineId-win-xk6p98m5.js +38 -0
  196. package/dist/getMachineId-win-xtk658fm.js +38 -0
  197. package/dist/{google-generative-ai-sw77egmr.js → google-generative-ai-nzndg246.js} +1 -1
  198. package/dist/{google-vertex-rrw93g8h.js → google-vertex-ragh3nnw.js} +1 -1
  199. package/dist/grok-adapter-77httan0.js +20 -0
  200. package/dist/handlers-c1jp5b6h.js +39 -0
  201. package/dist/heartbeat-5yaj6dym.js +49 -0
  202. package/dist/{hook-a7eh6zty.js → hook-2jttae8s.js} +13 -14
  203. package/dist/hook-c99nycyh.js +21 -0
  204. package/dist/{http-6aw5wanc.js → http-7y9dbfrr.js} +870 -219
  205. package/dist/{index-kzdqn3dd.js → index-6g9rdcrj.js} +3036 -758
  206. package/dist/index-7dwh9kxh.js +41 -0
  207. package/dist/{index-ym9fgxad.js → index-8p03vx1h.js} +8 -8
  208. package/dist/{index-maddg9ys.js → index-cw8nxnba.js} +4330 -15375
  209. package/dist/{index-yq9hhhhy.js → index-dm7c6hw5.js} +28 -29
  210. package/dist/index-fqf82sbk.js +10584 -0
  211. package/dist/{index-126v2d0t.js → index-g7rthzrv.js} +11 -2923
  212. package/dist/{index-z2g9469g.js → index-h9xnzfhx.js} +114 -33
  213. package/dist/{index-42jq9yy3.js → index-jvfp0j47.js} +516 -10
  214. package/dist/{index-3j803vnb.js → index-q60mhcpd.js} +25094 -20637
  215. package/dist/index-qxcfv8vq.js +17 -0
  216. package/dist/{index-rz8ve510.js → index-t274qhhs.js} +6 -6
  217. package/dist/{index-kdmkfjt7.js → index-t4n9z755.js} +3491 -2487
  218. package/dist/{index-7dgxveck.js → index-tcegcysh.js} +5 -5
  219. package/dist/{index-whysn1wf.js → index-tn1m3q9b.js} +3 -3
  220. package/dist/index-wp9tarbt.js +43 -0
  221. package/dist/{index-xhad0n8m.js → index-xhp7yp3t.js} +1 -1
  222. package/dist/index-z6np2405.js +38 -0
  223. package/dist/{k8s-36gfn847.js → k8s-mr1r12th.js} +2 -2
  224. package/dist/{keepalive-zhbmztqw.js → keepalive-7eyb8y4t.js} +4 -5
  225. package/dist/lead-50cgn8s1.js +81 -0
  226. package/dist/{maintenance-rsp0591h.js → maintenance-tdrd8nwv.js} +1 -1
  227. package/dist/module-ES6BEMUI-6htewwha.js +1210 -0
  228. package/dist/{node-0as4n1ef.js → node-gbx1t3pa.js} +1 -1
  229. package/dist/{node-rxte5hc6.js → node-jkdd5w7m.js} +1 -1
  230. package/dist/{oauth-refresh-sweep-w3cqmxq7.js → oauth-refresh-sweep-f4c7g37h.js} +3 -4
  231. package/dist/{object-webhooks-331hay92.js → object-webhooks-p190rdxp.js} +7 -7
  232. package/dist/{onboard-n2w80m2n.js → onboard-56h4sks6.js} +12 -10
  233. package/dist/{opencode-adapter-z98127cz.js → opencode-adapter-xg3yxfr0.js} +8 -8
  234. package/dist/{otel-impl-xsk35tvf.js → otel-impl-kepzgm4n.js} +36360 -9179
  235. package/dist/{pending-2e6trkxd.js → pending-xgv316w0.js} +25 -26
  236. package/dist/{pi-mono-adapter-wh6yndtm.js → pi-mono-adapter-txe0syzb.js} +19 -22
  237. package/dist/{pricing-refresh-9355dj1t.js → pricing-refresh-041zpyhf.js} +2 -2
  238. package/dist/{rbac-roles-8eajw4s6.js → rbac-roles-8f3jbcaf.js} +2 -2
  239. package/dist/{rbac-roles-58y3m912.js → rbac-roles-cw7rrw5b.js} +3 -3
  240. package/dist/{render-v2-7gskkmd4.js → render-v2-2ezw4mzt.js} +10 -10
  241. package/dist/{resume-0drnmpja.js → resume-p14wdx8m.js} +13 -13
  242. package/dist/{runtime-d2tcmqte.js → runtime-he7c9g1r.js} +1 -1
  243. package/dist/{session-access-0ztys6bd.js → session-access-8jvq86fj.js} +5 -5
  244. package/dist/{session-source-backfill-cdm5s046.js → session-source-backfill-6fe3hcgb.js} +3 -3
  245. package/dist/{setup-pqwb9tcc.js → setup-6v0bn4r1.js} +15 -6
  246. package/dist/thread-buffer-8860v1ta.js +40 -0
  247. package/dist/{token-util-pjgekqxr.js → token-util-hnzceyn9.js} +1 -1
  248. package/dist/{token-pgr2w4s3.js → token-xnc02n6w.js} +21 -14
  249. package/dist/{tree-visibility-rwz67mje.js → tree-visibility-g1a8ff4r.js} +2 -2
  250. package/dist/{user-merge-jobs-mxrhamwt.js → user-merge-jobs-vjsps179.js} +3 -3
  251. package/dist/{virtual-modules-71y1gsmg.js → virtual-modules-mreda4fp.js} +3 -3
  252. package/dist/{work-objects-3k4ykt9j.js → work-objects-hfw15e35.js} +29 -33
  253. package/dist/{worker-follow-up-y0h64xpr.js → worker-follow-up-gbaz2ydz.js} +24 -25
  254. package/dist/worker-hkm8ftqp.js +81 -0
  255. package/dist/{x-d27jj7z7.js → x-k29vmskt.js} +2 -2
  256. package/openapi.json +303 -20
  257. package/package.json +45 -45
  258. package/src/apps/definition.ts +76 -24
  259. package/src/apps/row-store.ts +67 -0
  260. package/src/apps/script-types.ts +131 -21
  261. package/src/apps/store.ts +4 -1
  262. package/src/be/db/model-profiles.ts +103 -12
  263. package/src/be/db/script-runs.ts +33 -0
  264. package/src/be/db/slack-card-groups.ts +147 -0
  265. package/src/be/db/slack-trees.ts +26 -0
  266. package/src/be/db/task-idempotency.ts +63 -0
  267. package/src/be/db/tasks/read.ts +7 -0
  268. package/src/be/db/tasks/write.ts +4 -2
  269. package/src/be/db/workflow-idempotency.ts +6 -1
  270. package/src/be/db/workflows/read.ts +79 -0
  271. package/src/be/db.ts +65 -151
  272. package/src/be/improvements.ts +24 -2
  273. package/src/be/mcp-proxy.ts +45 -11
  274. package/src/be/memory/embedding-space.ts +10 -20
  275. package/src/be/memory/index.ts +35 -0
  276. package/src/be/memory/providers/openai-embedding.ts +10 -0
  277. package/src/be/migrations/348_task_deferred_until.sql +4 -0
  278. package/src/be/migrations/354_durable_objects.sql +9 -0
  279. package/src/be/migrations/356_slack_outcome_card_groups.sql +14 -0
  280. package/src/be/migrations/357_task_idempotency_keys.sql +27 -0
  281. package/src/be/migrations/362_favorites_app.sql +36 -0
  282. package/src/be/model-group-resolution.ts +134 -0
  283. package/src/be/model-tier-resolution.ts +120 -17
  284. package/src/be/model-validation.ts +9 -1
  285. package/src/be/repo-checked-update.ts +58 -5
  286. package/src/be/requester-timezone.ts +10 -0
  287. package/src/be/runtime-pools/routing.ts +22 -8
  288. package/src/be/script-connections.ts +5 -1
  289. package/src/be/script-credential-broker.ts +29 -2
  290. package/src/be/scripts/durable.ts +204 -0
  291. package/src/be/scripts/extract-schema.ts +36 -4
  292. package/src/be/scripts/run-credential.ts +1 -8
  293. package/src/be/scripts/typecheck.ts +32 -7
  294. package/src/be/seed-scripts/catalog/memory-eval.ts +11 -2
  295. package/src/be/seed-scripts/catalog/tool-usage.ts +27 -8
  296. package/src/be/swarm-config-guard.ts +104 -14
  297. package/src/be/users.ts +33 -12
  298. package/src/comb/review-batch.ts +16 -5
  299. package/src/commands/context-preamble.ts +237 -0
  300. package/src/commands/e2b.ts +14 -0
  301. package/src/commands/entrypoint-mcp-config.ts +231 -0
  302. package/src/commands/onboard/agent-fs-version.ts +1 -1
  303. package/src/commands/onboard/compose-generator.ts +2 -1
  304. package/src/commands/onboard/env-generator.ts +16 -7
  305. package/src/commands/runner.ts +23 -7
  306. package/src/commands/setup.tsx +17 -3
  307. package/src/extensions/contract-types.generated.ts +1 -1
  308. package/src/hooks/hook.ts +8 -2
  309. package/src/hooks/native-tool-hooks.ts +4 -2
  310. package/src/http/apps.ts +82 -42
  311. package/src/http/comb.ts +21 -5
  312. package/src/http/config.ts +8 -4
  313. package/src/http/db-query.ts +8 -2
  314. package/src/http/heartbeat.ts +5 -0
  315. package/src/http/index.ts +12 -6
  316. package/src/http/kv.ts +7 -5
  317. package/src/http/mcp-oauth.ts +16 -0
  318. package/src/http/mcp-servers.ts +43 -3
  319. package/src/http/memory.ts +28 -1
  320. package/src/http/metrics.ts +11 -4
  321. package/src/http/onboarding.ts +12 -1
  322. package/src/http/operator-actor.ts +3 -8
  323. package/src/http/poll.ts +20 -1
  324. package/src/http/repos.ts +30 -12
  325. package/src/http/request-principal.ts +27 -1
  326. package/src/http/schedules.ts +59 -11
  327. package/src/http/script-connection-proxy.ts +3 -1
  328. package/src/http/script-runs.ts +21 -10
  329. package/src/http/scripts.ts +177 -26
  330. package/src/http/session-cost-recompute.ts +9 -4
  331. package/src/http/skills.ts +70 -0
  332. package/src/http/status.ts +2 -0
  333. package/src/http/tasks.ts +103 -15
  334. package/src/http/trackers/jira.ts +18 -3
  335. package/src/http/trackers/linear.ts +3 -0
  336. package/src/kv-limits.ts +2 -0
  337. package/src/kv-reserved-namespaces.ts +25 -2
  338. package/src/prompts/base-prompt.ts +10 -6
  339. package/src/prompts/session-templates.ts +52 -3
  340. package/src/prompts/session-turns.ts +30 -0
  341. package/src/providers/acp-targets.ts +1 -1
  342. package/src/providers/amp-adapter.ts +11 -9
  343. package/src/providers/claude-managed-adapter.ts +14 -0
  344. package/src/providers/claude-sdk-session.ts +14 -1
  345. package/src/providers/cursor-adapter.ts +1 -1
  346. package/src/providers/dsh-adapter.ts +1 -1
  347. package/src/providers/opencode-adapter.ts +3 -5
  348. package/src/providers/runtime-dependencies.ts +11 -8
  349. package/src/rbac/legacy-policy.ts +7 -0
  350. package/src/rbac/permissions.ts +27 -0
  351. package/src/realtime/browser.generated.txt +1 -1
  352. package/src/scheduler/schedule-task.ts +1 -0
  353. package/src/scheduler/scheduler.ts +36 -18
  354. package/src/script-workflows/executor.ts +37 -8
  355. package/src/script-workflows/supervisor.ts +14 -0
  356. package/src/scripts-runtime/ctx.ts +5 -1
  357. package/src/scripts-runtime/durable-object-base.ts +19 -0
  358. package/src/scripts-runtime/eval-harness.ts +46 -1
  359. package/src/scripts-runtime/executors/native.ts +13 -1
  360. package/src/scripts-runtime/executors/quickjs-bundle.ts +20 -1
  361. package/src/scripts-runtime/executors/quickjs-prelude.ts +40 -1
  362. package/src/scripts-runtime/executors/quickjs-runner.ts +26 -3
  363. package/src/scripts-runtime/executors/quickjs-worker.ts +2 -1
  364. package/src/scripts-runtime/executors/types.ts +26 -0
  365. package/src/scripts-runtime/extract-signature.ts +96 -1
  366. package/src/scripts-runtime/loader.ts +11 -5
  367. package/src/scripts-runtime/mcp-client.ts +1 -1
  368. package/src/scripts-runtime/sdk-allowlist.ts +1 -0
  369. package/src/scripts-runtime/swarm-config.ts +7 -0
  370. package/src/scripts-runtime/swarm-sdk.ts +4 -1
  371. package/src/scripts-runtime/types/stdlib.d.ts +19 -0
  372. package/src/scripts-runtime/types/swarm-extension.d.ts +3 -0
  373. package/src/scripts-runtime/types/swarm-sdk.d.ts +19 -0
  374. package/src/slack/actions.ts +24 -0
  375. package/src/slack/assistant.ts +8 -0
  376. package/src/slack/blocks.ts +35 -0
  377. package/src/slack/channel-activity.ts +7 -0
  378. package/src/slack/config.ts +4 -0
  379. package/src/slack/enrich.ts +46 -54
  380. package/src/slack/files.ts +173 -23
  381. package/src/slack/handlers.test.ts +17 -19
  382. package/src/slack/handlers.ts +15 -14
  383. package/src/slack/render-v2.ts +265 -19
  384. package/src/slack/responses.ts +62 -5
  385. package/src/slack/session-mirror.ts +10 -5
  386. package/src/slack/task-output.ts +25 -14
  387. package/src/slack/templates.ts +9 -0
  388. package/src/slack/thread-participants.ts +64 -24
  389. package/src/slack/watcher.ts +4 -4
  390. package/src/slack/work-objects.ts +1 -1
  391. package/src/stdio.ts +5 -0
  392. package/src/tasks/follow-up-gate.ts +142 -38
  393. package/src/tasks/worker-follow-up.ts +126 -37
  394. package/src/tests/agents-list-model-display.test.ts +4 -0
  395. package/src/tests/amp-adapter.test.ts +57 -9
  396. package/src/tests/apps-script-types.test.ts +63 -16
  397. package/src/tests/apps-sort-order.test.ts +87 -0
  398. package/src/tests/base-prompt.test.ts +36 -2
  399. package/src/tests/bedrock-model-groups.test.ts +4 -0
  400. package/src/tests/channel-activity.test.ts +9 -0
  401. package/src/tests/chatgpt-subscription-model-groups.test.ts +4 -0
  402. package/src/tests/claude-hook-output.test.ts +2 -0
  403. package/src/tests/claude-managed-adapter.test.ts +15 -3
  404. package/src/tests/claude-sdk-stderr.test.ts +28 -0
  405. package/src/tests/codex-gpt6-release.test.ts +4 -0
  406. package/src/tests/comb-review-batch.test.ts +17 -4
  407. package/src/tests/comb-status.test.ts +1 -0
  408. package/src/tests/db-client.test.ts +11 -5
  409. package/src/tests/db-retention-defaults.test.ts +28 -3
  410. package/src/tests/db-task-read-contract.test.ts +1 -0
  411. package/src/tests/db-task-write-contract.test.ts +2 -2
  412. package/src/tests/defer-task.test.ts +23 -1
  413. package/src/tests/dsh-adapter.test.ts +1 -1
  414. package/src/tests/e2b-dispatch.test.ts +13 -1
  415. package/src/tests/entrypoint-mcp-config.test.ts +642 -0
  416. package/src/tests/entrypoint-repo-autoclone-args.test.ts +10 -0
  417. package/src/tests/fixtures/onboard/content.env.txt +2 -2
  418. package/src/tests/fixtures/onboard/dev.env.txt +2 -2
  419. package/src/tests/fixtures/onboard/full-all.env.txt +2 -2
  420. package/src/tests/fixtures/onboard/full.env.txt +2 -2
  421. package/src/tests/fixtures/onboard/research.env.txt +2 -2
  422. package/src/tests/fixtures/onboard/solo.env.txt +2 -2
  423. package/src/tests/fixtures/runner-missing-dependency.ts +2 -1
  424. package/src/tests/follow-up-gate-shadow.test.ts +268 -10
  425. package/src/tests/fx-adapter.test.ts +4 -5
  426. package/src/tests/hook-mcp-config-precedence.test.ts +59 -0
  427. package/src/tests/hook-ping-me-order.test.ts +1 -0
  428. package/src/tests/hook-runtime-close.test.ts +1 -0
  429. package/src/tests/improvements-payload.test.ts +2 -2
  430. package/src/tests/linear-outbound-sync.test.ts +59 -25
  431. package/src/tests/model-groups-live-catalog.test.ts +4 -0
  432. package/src/tests/oauth-credential-bindings.test.ts +8 -3
  433. package/src/tests/oauth-refresh-failure.test.ts +15 -3
  434. package/src/tests/onboard-env.test.ts +1 -1
  435. package/src/tests/openai-compatible-providers.test.ts +5 -0
  436. package/src/tests/openapi-route-headers.test.ts +2 -1
  437. package/src/tests/operator-actor-keyless.test.ts +103 -0
  438. package/src/tests/opus-5-5-registry.test.ts +4 -0
  439. package/src/tests/profile-tier-alias.test.ts +9 -3
  440. package/src/tests/provider-runtime-dependencies.test.ts +26 -15
  441. package/src/tests/routing-affinity-inventory.test.ts +11 -0
  442. package/src/tests/runner-context-preamble.test.ts +202 -0
  443. package/src/tests/runner-repo-clone-args.test.ts +125 -0
  444. package/src/tests/scheduler-occurrence.test.ts +60 -9
  445. package/src/tests/script-connections-mcp.test.ts +6 -3
  446. package/src/tests/script-connections.test.ts +4 -0
  447. package/src/tests/scripts-namespaces.test.ts +3 -1
  448. package/src/tests/secret-scrubber.test.ts +8 -2
  449. package/src/tests/session-cost-recompute-unit.test.ts +39 -0
  450. package/src/tests/session-costs-recompute-all-providers.test.ts +6 -3
  451. package/src/tests/session-route-posture.test.ts +7 -1
  452. package/src/tests/slack-file-tools-attachments.test.ts +14 -9
  453. package/src/tests/slack-identity-resolution.test.ts +10 -3
  454. package/src/tests/slack-inline-output.test.ts +10 -8
  455. package/src/tests/slack-render-v2.test.ts +9 -4
  456. package/src/tests/slack-steering.test.ts +8 -2
  457. package/src/tests/slack-thread-participants.test.ts +11 -1
  458. package/src/tests/sonnet-5-5-registry.test.ts +4 -0
  459. package/src/tests/swarm-config-encryption.test.ts +5 -8
  460. package/src/tests/ui-spec-script-actions-config.test.ts +7 -3
  461. package/src/tests/workflow-system-one-extraction.test.ts +21 -0
  462. package/src/tests/workflow-triggers-v2.test.ts +35 -11
  463. package/src/tests/workflow-wait-filter.test.ts +7 -7
  464. package/src/tests/worktree-reaper.test.ts +15 -4
  465. package/src/tools/app-patch.ts +6 -2
  466. package/src/tools/app-upsert.ts +8 -4
  467. package/src/tools/defer-task.ts +17 -77
  468. package/src/tools/kv/kv-get.ts +2 -0
  469. package/src/tools/kv/kv-list.ts +11 -5
  470. package/src/tools/kv/kv-set.ts +1 -3
  471. package/src/tools/repos/update-repo.ts +37 -19
  472. package/src/tools/schedules/create-schedule.ts +20 -3
  473. package/src/tools/schedules/patch-schedule.ts +30 -4
  474. package/src/tools/schedules/run-schedule-now.ts +21 -1
  475. package/src/tools/schedules/update-schedule.ts +30 -4
  476. package/src/tools/script-apis.ts +9 -4
  477. package/src/tools/script-common.ts +2 -2
  478. package/src/tools/script-run.ts +8 -0
  479. package/src/tools/script-upsert.ts +1 -1
  480. package/src/tools/send-task.ts +17 -3
  481. package/src/tools/slack-download-file.ts +15 -12
  482. package/src/tools/slack-post.ts +14 -3
  483. package/src/tools/slack-read.ts +3 -1
  484. package/src/tools/slack-reply.ts +22 -2
  485. package/src/tools/slack-start-thread.ts +8 -1
  486. package/src/tools/slack-upload-file.ts +99 -96
  487. package/src/tools/swarm-config/set-config.ts +3 -1
  488. package/src/tools/swarm-x.ts +0 -2
  489. package/src/tools/task-action.ts +16 -3
  490. package/src/tools/utils.ts +4 -1
  491. package/src/types.ts +18 -2
  492. package/src/utils/amp-models.ts +20 -4
  493. package/src/utils/constants.ts +20 -0
  494. package/src/utils/deferral-time.ts +61 -0
  495. package/src/utils/request-auth-context.ts +15 -16
  496. package/src/utils/secret-scrubber.ts +7 -5
  497. package/src/workflows/engine.ts +42 -19
  498. package/src/workflows/executors/agent-task.ts +13 -2
  499. package/src/workflows/executors/code-match.ts +11 -31
  500. package/src/workflows/executors/script.ts +13 -0
  501. package/src/workflows/executors/swarm-script.ts +0 -2
  502. package/src/workflows/executors/system-one-extraction.ts +9 -6
  503. package/src/workflows/executors/wait.ts +1 -1
  504. package/src/workflows/foreach-driver.ts +11 -13
  505. package/src/workflows/input.ts +24 -1
  506. package/src/workflows/model-validation.ts +13 -1
  507. package/src/workflows/node-timeout.ts +18 -0
  508. package/src/workflows/predicate-sandbox.ts +171 -0
  509. package/src/workflows/retry-poller.ts +3 -2
  510. package/src/workflows/triggers.ts +21 -11
  511. package/src/workflows/wait-filter.ts +14 -192
  512. package/src/x/composio.ts +10 -1
  513. package/templates/skills/apps/SKILL.md +4 -2
  514. package/templates/skills/apps/content.md +4 -2
  515. package/templates/skills/code-quality/content.md +4 -4
  516. package/templates/skills/heartbeat-runbook/content.md +1 -0
  517. package/templates/skills/scheduled-task-resilience/SKILL.md +2 -0
  518. package/templates/skills/scheduled-task-resilience/content.md +2 -0
  519. package/templates/skills/slack-interaction/content.md +4 -0
  520. package/templates/skills/swarm-docs/content.md +8 -0
  521. package/templates/skills/swarm-scripts/SKILL.md +44 -0
  522. package/templates/skills/swarm-scripts/content.md +44 -0
  523. package/dist/acp-adapter-tbt61zkm.js +0 -17
  524. package/dist/cli-5ss6qqt9.js +0 -45
  525. package/dist/cli-b9ygp1kz.js +0 -459
  526. package/dist/cli-dzzh58sy.js +0 -6996
  527. package/dist/cli-j9ccfveb.js +0 -1849
  528. package/dist/cli-kj0hyr43.js +0 -51
  529. package/dist/cli-m8f4379k.js +0 -173
  530. package/dist/cli-mna6pmfx.js +0 -1485
  531. package/dist/cli-r8ddn0hf.js +0 -25583
  532. package/dist/core-bwp98v4w.js +0 -42
  533. package/dist/dsh-adapter-43ygwqn7.js +0 -9
  534. package/dist/fx-adapter-cr2hq17y.js +0 -20
  535. package/dist/grok-adapter-ayddnbsc.js +0 -20
  536. package/dist/handlers-7ghs84x2.js +0 -41
  537. package/dist/heartbeat-4c022m6a.js +0 -50
  538. package/dist/hook-4k84x499.js +0 -22
  539. package/dist/index-dtt0d634.js +0 -44
  540. package/dist/index-hmszyqkk.js +0 -42
  541. package/dist/index-j6rm1rtn.js +0 -39
  542. package/dist/index-rwwhsmjg.js +0 -13
  543. package/dist/index-t56y945n.js +0 -4
  544. package/dist/index-vfemrwwk.js +0 -10002
  545. package/dist/lead-g2j4q39z.js +0 -83
  546. package/dist/thread-buffer-epx3san4.js +0 -42
  547. package/dist/worker-09gqn9xy.js +0 -83
  548. package/dist/{azure-openai-responses-jeaas6x0.js → azure-openai-responses-e76k86gf.js} +4 -4
  549. package/dist/{openai-codex-responses-70g39cgz.js → openai-codex-responses-z2h941b8.js} +4 -4
  550. package/dist/{openai-completions-cv3hp4h5.js → openai-completions-5bxdkeg9.js} +4 -4
  551. package/dist/{openai-responses-trsvnks6.js → openai-responses-dzf3e8r5.js} +4 -4
@@ -0,0 +1,231 @@
1
+ /** Worker boot step; deliberately standalone so both worker images can run it before setup. */
2
+ export interface McpConfigDependencies {
3
+ env: Record<string, string | undefined>;
4
+ fetch: (url: string, init: RequestInit) => Promise<Response>;
5
+ /** Absent file reads as null; any other failure rejects. */
6
+ readTextFile: (path: string) => Promise<string | null>;
7
+ writeTextFile: (path: string, content: string) => Promise<void>;
8
+ log: (message: string) => void;
9
+ }
10
+
11
+ const defaults: McpConfigDependencies = {
12
+ env: process.env,
13
+ fetch: (url, init) => fetch(url, init),
14
+ readTextFile: async (path) => {
15
+ const file = Bun.file(path);
16
+ return (await file.exists()) ? file.text() : null;
17
+ },
18
+ writeTextFile: async (path, content) => {
19
+ await Bun.write(path, content);
20
+ },
21
+ log: (message) => console.log(message),
22
+ };
23
+
24
+ export interface McpConfigInputs {
25
+ /** Swarm API key, piped on stdin by the shell shim so it never reaches argv. */
26
+ apiKey: string;
27
+ /** Resolved control-plane base URL; the entrypoint keeps it shell-local, so it is an argument. */
28
+ mcpUrl: string;
29
+ homeDir: string;
30
+ workspaceDir: string;
31
+ }
32
+
33
+ interface AgentSwarmServer {
34
+ type: "http";
35
+ url: string;
36
+ headers: Record<string, string>;
37
+ }
38
+
39
+ interface AgentmailServer {
40
+ command: string;
41
+ args: string[];
42
+ env: Record<string, string>;
43
+ }
44
+
45
+ interface McpConfigFile {
46
+ mcpServers: { "agent-swarm": AgentSwarmServer; agentmail?: AgentmailServer };
47
+ }
48
+
49
+ /** The old `jq -n` base object: swarm HTTP server, optional X-Agent-ID, optional agentmail. */
50
+ function buildMcpConfig(options: {
51
+ mcpUrl: string;
52
+ apiKey: string;
53
+ agentId?: string;
54
+ agentmailApiKey?: string;
55
+ }): McpConfigFile {
56
+ const headers: Record<string, string> = { Authorization: `Bearer ${options.apiKey}` };
57
+ if (options.agentId) headers["X-Agent-ID"] = options.agentId;
58
+ const config: McpConfigFile = {
59
+ mcpServers: {
60
+ "agent-swarm": { type: "http", url: `${options.mcpUrl}/mcp`, headers },
61
+ },
62
+ };
63
+ if (options.agentmailApiKey) {
64
+ config.mcpServers.agentmail = {
65
+ command: "npx",
66
+ args: ["-y", "agentmail-mcp"],
67
+ env: { AGENTMAIL_API_KEY: options.agentmailApiKey },
68
+ };
69
+ }
70
+ return config;
71
+ }
72
+
73
+ /** Match the old `jq .servers | length` count: arrays and objects only; anything else fails. */
74
+ function installedServerNames(payload: unknown): string[] {
75
+ if (typeof payload !== "object" || payload === null || Array.isArray(payload)) return [];
76
+ const servers = (payload as { servers?: unknown }).servers;
77
+ if (servers === null || servers === undefined) return [];
78
+ if (typeof servers === "string" || typeof servers === "number") {
79
+ throw new Error("MCP servers payload is not iterable");
80
+ }
81
+ const entries = Array.isArray(servers) ? servers : Object.values(servers);
82
+ return entries.map(serverName);
83
+ }
84
+
85
+ function serverName(entry: unknown): string {
86
+ if (typeof entry !== "object" || entry === null) {
87
+ throw new Error("MCP server entry is not a JSON object");
88
+ }
89
+ const name = (entry as { name?: unknown }).name;
90
+ // `"mcp__" + null` is `"mcp__"` in jq, so a missing name still yields a pattern.
91
+ if (name === null || name === undefined) return "";
92
+ if (typeof name !== "string") throw new Error("MCP server name is not a string");
93
+ return name;
94
+ }
95
+
96
+ /** The old `jq --slurpfile` merge: append `mcp__<name>__*` patterns, sort and dedupe. */
97
+ function mergePermissionPatterns(
98
+ settings: unknown,
99
+ serverNames: string[],
100
+ ): Record<string, unknown> {
101
+ if (typeof settings !== "object" || Array.isArray(settings)) {
102
+ throw new Error("settings.json is not a JSON object");
103
+ }
104
+ // jq assigns into `null` by creating the object, so a literal null file still
105
+ // ends up with a permissions object.
106
+ const root = (settings ?? {}) as Record<string, unknown>;
107
+ const permissions = root.permissions;
108
+ if (
109
+ permissions !== null &&
110
+ permissions !== undefined &&
111
+ (typeof permissions !== "object" || Array.isArray(permissions))
112
+ ) {
113
+ throw new Error("settings.json permissions is not a JSON object");
114
+ }
115
+ const permissionObject = (permissions ?? {}) as Record<string, unknown>;
116
+ const allow = permissionObject.allow;
117
+ if (allow !== null && allow !== undefined && !Array.isArray(allow)) {
118
+ throw new Error("settings.json permissions.allow is not an array");
119
+ }
120
+ const patterns = new Set<unknown>(allow ?? []);
121
+ for (const name of serverNames) patterns.add(`mcp__${name}__*`);
122
+ const merged = [...patterns];
123
+ // jq `unique` sorts. Settings entries are strings, so the default sort matches.
124
+ merged.sort();
125
+ return { ...root, permissions: { ...permissionObject, allow: merged } };
126
+ }
127
+
128
+ async function fetchInstalledServers(
129
+ mcpUrl: string,
130
+ agentId: string,
131
+ apiKey: string,
132
+ probe: McpConfigDependencies["fetch"],
133
+ ): Promise<unknown> {
134
+ try {
135
+ // resolveSecrets=false: the entrypoint only needs names; the per-session
136
+ // dispatcher re-fetches the servers with fresh credentials (issue #369).
137
+ const response = await probe(
138
+ `${mcpUrl}/api/agents/${agentId}/mcp-servers?resolveSecrets=false`,
139
+ { headers: { Authorization: `Bearer ${apiKey}` }, redirect: "manual" },
140
+ );
141
+ // Match `curl -sf`: HTTP errors and empty bodies leave nothing to parse.
142
+ if (!response.ok) return null;
143
+ const body = await response.text();
144
+ return body === "" ? null : JSON.parse(body);
145
+ } catch {
146
+ // Best-effort, like the old `|| true`: the file writes still run.
147
+ return null;
148
+ }
149
+ }
150
+
151
+ /**
152
+ * Write `/workspace/.mcp.json` and register the installed MCP servers' permission
153
+ * patterns in `~/.claude/settings.json`. Resolved credentials are never baked
154
+ * into the project config: the provider dispatcher injects them per session.
155
+ */
156
+ export async function configureMcpConfig(
157
+ inputs: McpConfigInputs,
158
+ dependencies: Partial<McpConfigDependencies> = {},
159
+ ): Promise<boolean> {
160
+ const {
161
+ env,
162
+ fetch: probe,
163
+ readTextFile,
164
+ writeTextFile,
165
+ log,
166
+ } = {
167
+ ...defaults,
168
+ ...dependencies,
169
+ };
170
+ try {
171
+ // Managed agents read MCP servers from the Anthropic agent definition instead.
172
+ if (env.HARNESS_PROVIDER === "claude-managed") {
173
+ log("Skipping local .mcp.json (claude-managed reads MCP from agent definition)");
174
+ return true;
175
+ }
176
+
177
+ log(`Creating MCP config in ${inputs.workspaceDir}...`);
178
+ const mcpUrl = inputs.mcpUrl;
179
+ const agentId = env.AGENT_ID;
180
+ const config = buildMcpConfig({
181
+ mcpUrl,
182
+ apiKey: inputs.apiKey,
183
+ agentId,
184
+ agentmailApiKey: env.AGENTMAIL_API_KEY,
185
+ });
186
+
187
+ let serverNames: string[] = [];
188
+ if (agentId && inputs.apiKey) {
189
+ log("Fetching installed MCP server names (for permission patterns only)...");
190
+ const payload = await fetchInstalledServers(mcpUrl, agentId, inputs.apiKey, probe);
191
+ serverNames = installedServerNames(payload);
192
+ if (serverNames.length > 0) {
193
+ log(
194
+ `Found ${serverNames.length} installed MCP server(s) — will be injected per-session, not baked into .mcp.json`,
195
+ );
196
+ }
197
+ }
198
+
199
+ await writeTextFile(`${inputs.workspaceDir}/.mcp.json`, `${JSON.stringify(config, null, 2)}\n`);
200
+
201
+ if (serverNames.length > 0) {
202
+ const settingsPath = `${inputs.homeDir}/.claude/settings.json`;
203
+ const current = await readTextFile(settingsPath);
204
+ if (current !== null) {
205
+ log("Adding MCP server permission patterns to settings.json");
206
+ // jq --slurpfile reads a blank file as an empty array, so `$settings[0]`
207
+ // is null and the merge repairs the file instead of failing.
208
+ const settings = current.trim() === "" ? null : (JSON.parse(current) as unknown);
209
+ const updated = mergePermissionPatterns(settings, serverNames);
210
+ await writeTextFile(settingsPath, `${JSON.stringify(updated, null, 2)}\n`);
211
+ }
212
+ }
213
+ return true;
214
+ } catch (error) {
215
+ const reason = error instanceof Error ? error.message : String(error);
216
+ log(`[entrypoint] FATAL: MCP config step failed: ${reason}; exiting.`);
217
+ return false;
218
+ }
219
+ }
220
+
221
+ if (import.meta.main) {
222
+ const apiKey = (await Bun.stdin.text()).replace(/\r?\n$/, "");
223
+ process.exitCode = (await configureMcpConfig({
224
+ apiKey,
225
+ mcpUrl: Bun.argv[4] ?? "",
226
+ homeDir: Bun.argv[2] ?? process.env.HOME ?? "/home/worker",
227
+ workspaceDir: Bun.argv[3] ?? "/workspace",
228
+ }))
229
+ ? 0
230
+ : 1;
231
+ }
@@ -2,4 +2,4 @@
2
2
  * agent-fs image tag bundled by `agent-swarm onboard --yes`.
3
3
  * `bun run bump:agent-fs` rewrites it together with the other pins.
4
4
  */
5
- export const AGENT_FS_VERSION = "0.18.33";
5
+ export const AGENT_FS_VERSION = "0.18.35";
@@ -11,7 +11,8 @@ const DEFAULT_WORKER_MAX_CONCURRENT_TASKS = 1;
11
11
  // suppression comments in one place.
12
12
 
13
13
  // Image tag for the API and agent images. Blank or unset resolves to `latest`,
14
- // which moves on every commit to main; operators pin a release in .env.
14
+ // which moves on every commit to main. env-generator.ts writes this CLI's
15
+ // release to .env, so a generated install starts pinned.
15
16
  // biome-ignore lint/suspicious/noTemplateCurlyInString: Docker Compose env var syntax
16
17
  const IMAGE_TAG_EXPRESSION = "${AGENT_SWARM_VERSION:-latest}";
17
18
  // Host address for published ports, from AGENT_SWARM_BIND_ADDRESS in .env. Blank
@@ -1,11 +1,17 @@
1
+ import pkg from "../../../package.json";
1
2
  import { expandServices } from "./service-names.ts";
2
3
  import type { OnboardState } from "./types.ts";
3
4
 
4
5
  /**
5
6
  * Generate a .env file string from onboard wizard state.
6
7
  * Uses real values from state (not placeholders).
8
+ * `imageVersion` is the default AGENT_SWARM_VERSION pin: this CLI's release.
7
9
  */
8
- export function generateEnv(state: OnboardState, env: NodeJS.ProcessEnv = process.env): string {
10
+ export function generateEnv(
11
+ state: OnboardState,
12
+ env: NodeJS.ProcessEnv = process.env,
13
+ imageVersion: string = pkg.version,
14
+ ): string {
9
15
  const expanded = expandServices(state.services, state.agentIds);
10
16
  const lines: string[] = [];
11
17
 
@@ -16,12 +22,15 @@ export function generateEnv(state: OnboardState, env: NodeJS.ProcessEnv = proces
16
22
  lines.push(`MCP_BASE_URL=http://localhost:${port}`);
17
23
  lines.push("APP_URL=https://app.agent-swarm.dev");
18
24
 
19
- // Image pin. Blank resolves to `latest`, which moves on every commit to main
20
- // and is not a release. Left blank so a fresh install behaves as before;
21
- // operators set a published release from
22
- // https://github.com/desplega-ai/agent-swarm/releases before depending on it.
23
- lines.push("# Pin a release, e.g. AGENT_SWARM_VERSION=1.150.0. Blank tracks `latest`.");
24
- lines.push("AGENT_SWARM_VERSION=");
25
+ // Image pin. Defaults to this CLI's own release, so the API and agent images
26
+ // match the agent-fs and TEI pins that ship in the same release. Blank would
27
+ // resolve to `latest`, which moves on every commit to main and is not a
28
+ // release. AGENT_SWARM_VERSION in the installer's environment overrides it.
29
+ const pinned = env.AGENT_SWARM_VERSION?.trim() || imageVersion;
30
+ lines.push(
31
+ "# Image release for the API and agents. Change it to upgrade. Blank tracks `latest`.",
32
+ );
33
+ lines.push(`AGENT_SWARM_VERSION=${pinned}`);
25
34
 
26
35
  // Install path — read by src/telemetry.ts at boot to attribute the
27
36
  // "which entry point produced this install" cohort. Boolean/enum only,
@@ -132,6 +132,7 @@ import { buildAttachmentsSection } from "./attachments-section.ts";
132
132
  import {
133
133
  buildContextPreamble,
134
134
  buildResumeContextPreamble,
135
+ buildSessionFollowUpPreamble,
135
136
  prependContextPreamble,
136
137
  } from "./context-preamble.ts";
137
138
  import {
@@ -546,6 +547,14 @@ export async function ensureRepoForTask(
546
547
 
547
548
  let warning: string | null = null;
548
549
 
550
+ // git, gh and glab would read a leading "-" as an option (clone, and the fetch of an
551
+ // existing clone), not as the repo, the target or the branch.
552
+ if (url.startsWith("-") || clonePath.startsWith("-") || defaultBranch.startsWith("-")) {
553
+ throw new Error(
554
+ `Refusing to use repo ${name}: its url, clonePath and defaultBranch must not start with "-"`,
555
+ );
556
+ }
557
+
549
558
  if (!gitHeadExists) {
550
559
  console.log(`[${role}] Cloning ${name} to ${clonePath}...`);
551
560
  const provider = detectVcsProvider(url);
@@ -554,7 +563,7 @@ export async function ensureRepoForTask(
554
563
  } else if (provider === "gitlab") {
555
564
  await Bun.$`glab repo clone ${url} ${clonePath} -- --branch ${defaultBranch} --single-branch`.quiet();
556
565
  } else {
557
- await Bun.$`git clone --branch ${defaultBranch} --single-branch ${url} ${clonePath}`.quiet();
566
+ await Bun.$`git clone --branch ${defaultBranch} --single-branch -- ${url} ${clonePath}`.quiet();
558
567
  }
559
568
  // Validate the clone actually created the directory
560
569
  if (!existsSync(clonePath)) {
@@ -7465,14 +7474,14 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
7465
7474
 
7466
7475
  console.log(`\n[${role}] === Resuming paused task (iteration ${iteration}) ===`);
7467
7476
  console.log(`[${role}] Logging to: ${logFile}`);
7468
- console.log(`[${role}] Prompt: ${resumePrompt.slice(0, 100)}...`);
7477
+ console.log(`[${role}] Prompt: ${scrubSecrets(resumePrompt).slice(0, 100)}...`);
7469
7478
 
7470
7479
  const metadata = {
7471
7480
  type: metadataType,
7472
7481
  sessionId,
7473
7482
  iteration,
7474
7483
  timestamp: new Date().toISOString(),
7475
- prompt: resumePrompt,
7484
+ prompt: scrubSecrets(resumePrompt),
7476
7485
  trigger: "task_resumed",
7477
7486
  resumedTaskId: task.id,
7478
7487
  };
@@ -7909,8 +7918,13 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
7909
7918
  "task" in trigger.task
7910
7919
  ? (trigger.task as { task: string; id?: string; contextKey?: string })
7911
7920
  : null;
7912
- const taskObj = trigger.task as { parentTaskId?: string; taskType?: string } | undefined;
7921
+ const taskObj = trigger.task as
7922
+ | { parentTaskId?: string; taskType?: string; source?: string }
7923
+ | undefined;
7913
7924
  const isResumeTask = taskObj?.taskType === "resume";
7925
+ // A Sessions message to the Lead reads against the session's last Lead
7926
+ // turns, not one parent: a fresh session per message keeps no transcript.
7927
+ const isSessionFollowUp = isLead && !isResumeTask && taskObj?.source === "ui";
7914
7928
  const taskVcsRepo = (trigger.task as { vcsRepo?: string } | undefined)?.vcsRepo;
7915
7929
 
7916
7930
  // The prompt enrichment below needs several API reads that do not
@@ -7938,7 +7952,9 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
7938
7952
  taskObj?.parentTaskId && apiUrl
7939
7953
  ? isResumeTask
7940
7954
  ? buildResumeContextPreamble(apiUrl, apiKey, taskObj.parentTaskId)
7941
- : buildContextPreamble(apiUrl, apiKey, taskObj.parentTaskId)
7955
+ : isSessionFollowUp
7956
+ ? buildSessionFollowUpPreamble(apiUrl, apiKey, taskObj.parentTaskId)
7957
+ : buildContextPreamble(apiUrl, apiKey, taskObj.parentTaskId)
7942
7958
  : null,
7943
7959
  fetchProfileSyncRejectionBanner({
7944
7960
  ...apiConfig,
@@ -8163,7 +8179,7 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
8163
8179
 
8164
8180
  console.log(`\n[${role}] === Iteration ${iteration} ===`);
8165
8181
  console.log(`[${role}] Logging to: ${logFile}`);
8166
- console.log(`[${role}] Prompt: ${triggerPrompt.slice(0, 100)}...`);
8182
+ console.log(`[${role}] Prompt: ${scrubSecrets(triggerPrompt).slice(0, 100)}...`);
8167
8183
  if (effectiveCwd) {
8168
8184
  console.log(`[${role}] Working directory: ${effectiveCwd}`);
8169
8185
  }
@@ -8173,7 +8189,7 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
8173
8189
  sessionId,
8174
8190
  iteration,
8175
8191
  timestamp: new Date().toISOString(),
8176
- prompt: triggerPrompt,
8192
+ prompt: scrubSecrets(triggerPrompt),
8177
8193
  trigger: trigger.type,
8178
8194
  };
8179
8195
  await Bun.write(logFile, `${JSON.stringify(metadata)}\n`);
@@ -204,12 +204,15 @@ export function Setup({ dryRun = false, restore = false, yes = false }: SetupPro
204
204
  gitignoreContent = await gitignoreFile.text();
205
205
  }
206
206
 
207
+ // Match whole lines: a substring hit (a comment, a `!` rule) does not ignore
208
+ // anything. `.mcp.json` and its backup hold the API bearer token.
209
+ const ignoreLines = new Set(gitignoreContent.split(/\r?\n/).map((line) => line.trim()));
207
210
  const entriesToAdd: string[] = [];
208
- if (!gitignoreContent.includes(".claude")) {
211
+ if (!ignoreLines.has(".claude") && !ignoreLines.has(".claude/")) {
209
212
  entriesToAdd.push(".claude");
210
213
  }
211
- if (!gitignoreContent.includes(".mcp.json")) {
212
- entriesToAdd.push(".mcp.json");
214
+ for (const entry of [".mcp.json", ".mcp.json.bak"]) {
215
+ if (!ignoreLines.has(entry)) entriesToAdd.push(entry);
213
216
  }
214
217
 
215
218
  if (entriesToAdd.length > 0) {
@@ -223,6 +226,17 @@ export function Setup({ dryRun = false, restore = false, yes = false }: SetupPro
223
226
  } else {
224
227
  addLog(".gitignore already contains required entries");
225
228
  }
229
+
230
+ // An ignore rule does not untrack a file that is already committed.
231
+ const tracked = await Bun.$`git -C ${cwd} ls-files .mcp.json .mcp.json.bak`
232
+ .quiet()
233
+ .nothrow();
234
+ const trackedFiles = tracked.stdout.toString().trim();
235
+ if (trackedFiles) {
236
+ addLog(
237
+ `Warning: ${trackedFiles.split("\n").join(", ")} is tracked by git and will hold the API token. Run: git rm --cached ${trackedFiles.split("\n").join(" ")}`,
238
+ );
239
+ }
226
240
  } else {
227
241
  addLog("Not a git repository (skipping .gitignore update)");
228
242
  }
@@ -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 | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\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 slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | 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 fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | 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 | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\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 | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\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 statusKind?:\n | "error"\n | "workflow"\n | "external"\n | "agent"\n | "runner"\n | "deferred"\n | "cascade"\n | "user"\n | "system"\n | "graceful_shutdown"\n | "context_limits"\n | "manual_supersede"\n | "crash_recovery"\n | "provider_fallback"\n | "workflow_retry"\n | 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 slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | 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 fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | 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 | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\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 | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\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" | "app-page";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n auditSourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "native" | "mcp" | "extension" | "script-sdk";\n harness?: string | undefined;\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 /** Tool-call sources this extension\'s tool handlers receive. Default `["mcp"]`. */\n toolSources?: readonly ToolSource[];\n }\n /** `mcp`: swarm MCP tools. `native`: harness built-ins reported by a worker shim. */\n export type ToolSource = "mcp" | "native";\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 /** Secret-scrubbed on native calls: a secret reads as `[REDACTED:<name>]`. */\n args: unknown;\n requestInfo: RequestInfo;\n /** Native calls only: the harness\'s own tool name, such as `Bash`. */\n nativeTool?: string;\n /** Native calls only: the harness\'s own argument shape, secret-scrubbed. */\n rawArgs?: unknown;\n /** Native calls only: the harness\'s call id, and its parent for a nested call. */\n toolCallId?: string;\n parentToolCallId?: string;\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 /** Native calls only: the harness reported the call as failed. */\n isError?: boolean;\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 | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\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 slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | 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 modelGroup?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | 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 | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\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 | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\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 statusKind?:\n | "error"\n | "workflow"\n | "external"\n | "agent"\n | "runner"\n | "deferred"\n | "cascade"\n | "user"\n | "system"\n | "graceful_shutdown"\n | "context_limits"\n | "manual_supersede"\n | "crash_recovery"\n | "provider_fallback"\n | "workflow_retry"\n | 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 slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | 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 modelGroup?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | 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 deferredUntil?: 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 | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\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 | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\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" | "app-page";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n auditSourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "native" | "mcp" | "extension" | "script-sdk";\n harness?: string | undefined;\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 /** Tool-call sources this extension\'s tool handlers receive. Default `["mcp"]`. */\n toolSources?: readonly ToolSource[];\n }\n /** `mcp`: swarm MCP tools. `native`: harness built-ins reported by a worker shim. */\n export type ToolSource = "mcp" | "native";\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 /** Secret-scrubbed on native calls: a secret reads as `[REDACTED:<name>]`. */\n args: unknown;\n requestInfo: RequestInfo;\n /** Native calls only: the harness\'s own tool name, such as `Bash`. */\n nativeTool?: string;\n /** Native calls only: the harness\'s own argument shape, secret-scrubbed. */\n rawArgs?: unknown;\n /** Native calls only: the harness\'s call id, and its parent for a nested call. */\n toolCallId?: string;\n parentToolCallId?: string;\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 /** Native calls only: the harness reported the call as failed. */\n isError?: boolean;\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';
package/src/hooks/hook.ts CHANGED
@@ -63,11 +63,16 @@ type McpServerConfig = {
63
63
  };
64
64
  };
65
65
 
66
+ /**
67
+ * The worker-owned `/workspace/.mcp.json` wins over the project's, as in the
68
+ * session MCP config. The project file is used only when the workspace file
69
+ * has no swarm entry (a local setup with no `/workspace`).
70
+ */
66
71
  export async function loadHookMcpConfig(
67
72
  projectDir: string,
68
73
  workspaceDir = "/workspace",
69
74
  ): Promise<McpServerConfig | undefined> {
70
- for (const configDir of new Set([projectDir, workspaceDir])) {
75
+ for (const configDir of new Set([workspaceDir, projectDir])) {
71
76
  try {
72
77
  const mcpFile = Bun.file(`${configDir}/.mcp.json`);
73
78
  if (!(await mcpFile.exists())) continue;
@@ -551,7 +556,8 @@ export async function runSessionSummaryFromStdin(): Promise<void> {
551
556
  */
552
557
  export async function handleHook(): Promise<void> {
553
558
  const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
554
- const mcpConfig = await loadHookMcpConfig(projectDir);
559
+ // HOOK_WORKSPACE_DIR lets tests keep a worker's real /workspace/.mcp.json out of the hook.
560
+ const mcpConfig = await loadHookMcpConfig(projectDir, process.env.HOOK_WORKSPACE_DIR);
555
561
 
556
562
  let msg: HookMessage;
557
563
  try {
@@ -127,7 +127,9 @@ export async function nativeHooksActive(
127
127
  const key = cacheKey(target);
128
128
  const file = join(tmpdir(), `agent-swarm-native-hooks-${key}.json`);
129
129
  const cached = memoryStatus.get(key) ?? readStatusFile(file);
130
- if (cached && cached.until > now()) return cached.native;
130
+ // The shim never writes an expiry more than STATUS_TTL_MS ahead, so a later one is a miss.
131
+ const at = now();
132
+ if (cached && cached.until > at && cached.until <= at + STATUS_TTL_MS) return cached.native;
131
133
 
132
134
  let entry: StatusEntry;
133
135
  try {
@@ -143,7 +145,7 @@ export async function nativeHooksActive(
143
145
  }
144
146
  memoryStatus.set(key, entry);
145
147
  try {
146
- writeFileSync(file, JSON.stringify(entry));
148
+ writeFileSync(file, JSON.stringify(entry), { mode: 0o600 });
147
149
  } catch {
148
150
  // An unwritable temp dir only costs the cache.
149
151
  }