@desplega.ai/agent-swarm 2.14.0 → 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 (344) hide show
  1. package/dist/acp-adapter-7jv7w8jh.js +17 -0
  2. package/dist/{acp-targets-23exz4z4.js → acp-targets-0ebmg3et.js} +10 -10
  3. package/dist/{actions-zcr25x27.js → actions-0ds9dx6c.js} +28 -28
  4. package/dist/{agent-fs-provision-7fa9e12e.js → agent-fs-provision-zpbxa9jc.js} +4 -4
  5. package/dist/{amp-adapter-s7ytmv6b.js → amp-adapter-awh5nn7a.js} +3 -3
  6. package/dist/{anthropic-messages-vdd1zmha.js → anthropic-messages-gtgp9r85.js} +17 -17
  7. package/dist/{app-5d3sz1hy.js → app-nzejkvpp.js} +10 -10
  8. package/dist/{approval-notifications-7qgkzkzx.js → approval-notifications-hbqtb2w3.js} +11 -11
  9. package/dist/{assistant-p2yvhc3j.js → assistant-1paft129.js} +29 -29
  10. package/dist/{boot-args-schema-ry6cb0p7.js → boot-args-schema-zs435mfx.js} +1 -1
  11. package/dist/{boot-reembed-2hkm3vz2.js → boot-reembed-7xq2qgg4.js} +1 -1
  12. package/dist/{boot-reembed-c9643ms3.js → boot-reembed-91qrd4mz.js} +1 -1
  13. package/dist/{boot-scrub-sweep-3ycxr51t.js → boot-scrub-sweep-3h5xscw6.js} +2 -2
  14. package/dist/{boot-seeds-2hzvvzg0.js → boot-seeds-xkxqa8zc.js} +4 -4
  15. package/dist/{boxd-9py3x0jb.js → boxd-464x3w4m.js} +3 -3
  16. package/dist/{claude-adapter-dnkww93e.js → claude-adapter-6d8eyf2f.js} +12 -13
  17. package/dist/{claude-managed-adapter-yk0cr5x6.js → claude-managed-adapter-jzxcaf9m.js} +4 -4
  18. package/dist/{claude-managed-setup-4byxpp47.js → claude-managed-setup-5fcx0qh3.js} +10 -10
  19. package/dist/{claude-sdk-session-4wf3dbvs.js → claude-sdk-session-11vhz1hc.js} +11442 -12786
  20. package/dist/{cli-2ckwgs7q.js → cli-02ba8qx5.js} +1 -1
  21. package/dist/{cli-wvgg7r4j.js → cli-08gfvs58.js} +2 -2
  22. package/dist/{cli-ad00h1st.js → cli-0dkpdvnn.js} +10 -10
  23. package/dist/{cli-879txsac.js → cli-0mq8kxfx.js} +4 -4
  24. package/dist/{cli-rp1n2xpd.js → cli-0nvqg1hb.js} +1 -1
  25. package/dist/{cli-qrwjk4xy.js → cli-0qyfna7a.js} +5 -5
  26. package/dist/cli-0vxbrxr3.js +1006 -0
  27. package/dist/{cli-vxmmttmt.js → cli-132h67ps.js} +52 -52
  28. package/dist/{cli-yd7e590v.js → cli-1e13gvfn.js} +14 -14
  29. package/dist/cli-1hj68b3h.js +30 -0
  30. package/dist/{cli-hzhv7yac.js → cli-1zbj28py.js} +1 -1
  31. package/dist/{cli-0k7ppk9k.js → cli-20mkgwev.js} +43 -38
  32. package/dist/{cli-ejnhs815.js → cli-288k5ep1.js} +11 -11
  33. package/dist/{cli-njvpngc6.js → cli-2n7qdqfv.js} +3 -3
  34. package/dist/{cli-r04ve9xw.js → cli-2r62jy9s.js} +1 -1
  35. package/dist/{cli-9j1t3kf6.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-6ajyhxh7.js → cli-3bcsc3m7.js} +2 -2
  39. package/dist/{cli-jgq9xptq.js → cli-3g0vbq46.js} +4 -4
  40. package/dist/{cli-69szn7w7.js → cli-3ktfe5jx.js} +71 -47
  41. package/dist/{cli-yjb3cddd.js → cli-44r66df2.js} +1 -1
  42. package/dist/{cli-mv8ft7b0.js → cli-4y2bekkn.js} +3 -3
  43. package/dist/cli-547fsc36.js +15 -0
  44. package/dist/{cli-6p8p2e6r.js → cli-5pyes68e.js} +1278 -23
  45. package/dist/{cli-930zbczq.js → cli-5t00r6c9.js} +3 -3
  46. package/dist/{cli-kc7vd07m.js → cli-5xjdft4s.js} +3601 -1700
  47. package/dist/{cli-4dyzzkfb.js → cli-643skca1.js} +954 -180
  48. package/dist/{cli-vr4eyq6p.js → cli-6a77m17n.js} +540 -412
  49. package/dist/{cli-v41kn3cd.js → cli-6prwz0zn.js} +4427 -5566
  50. package/dist/{cli-1nfabrt4.js → cli-6xrbpj5j.js} +4 -4
  51. package/dist/{cli-meydjstb.js → cli-6yhjqd6k.js} +4965 -69
  52. package/dist/{cli-6yy4fepf.js → cli-727sq1f9.js} +4 -4
  53. package/dist/{cli-snxhtehz.js → cli-7abeph0b.js} +7 -8
  54. package/dist/{cli-ty3gha1p.js → cli-7b9bwrfg.js} +2 -2
  55. package/dist/{cli-g6a696c0.js → cli-7dwsn9y5.js} +4 -4
  56. package/dist/{cli-r9d2tya0.js → cli-7qkbab03.js} +5 -5
  57. package/dist/{cli-7ca8hczj.js → cli-7svwhw1a.js} +1 -1
  58. package/dist/{cli-ze1ndjs4.js → cli-83kf2y60.js} +8 -8
  59. package/dist/{cli-rs1rzwp4.js → cli-8crn0510.js} +1 -1
  60. package/dist/{cli-wym6rxgt.js → cli-8kemtj1r.js} +10 -15
  61. package/dist/{cli-md4tn21h.js → cli-967jrz7j.js} +40 -26
  62. package/dist/{cli-jcnc5ret.js → cli-976m0zcw.js} +38 -28
  63. package/dist/{cli-cbg0j1yt.js → cli-98sea4d9.js} +3 -3
  64. package/dist/{cli-xh5fpmg8.js → cli-9txap41q.js} +101 -18
  65. package/dist/{cli-24wervhz.js → cli-aktk3qt6.js} +3 -3
  66. package/dist/{cli-096aftq6.js → cli-b70cpf8f.js} +7 -7
  67. package/dist/{cli-2ap1the6.js → cli-by7s3n4p.js} +1 -1
  68. package/dist/{cli-w4bvtxet.js → cli-byzq8xht.js} +7 -7
  69. package/dist/{cli-phe2vcw5.js → cli-d1zkys4j.js} +150 -99
  70. package/dist/cli-dr6x9qdk.js +15 -0
  71. package/dist/cli-dt931hb8.js +9740 -0
  72. package/dist/{cli-0e914dp9.js → cli-e1wprqnd.js} +3 -3
  73. package/dist/{cli-2ayk9gn8.js → cli-e2wzzw17.js} +2 -2
  74. package/dist/{cli-1jx0srjt.js → cli-e9p9h14n.js} +1921 -80
  75. package/dist/{cli-2savn6mm.js → cli-eaqxkeq0.js} +10 -10
  76. package/dist/{cli-dw9rtjm3.js → cli-etykr11s.js} +3061 -727
  77. package/dist/{cli-73rmgm45.js → cli-f07sgaax.js} +2 -2
  78. package/dist/{cli-gc6b94tj.js → cli-fe8he9cy.js} +2 -2
  79. package/dist/{cli-s4pccby1.js → cli-h0edykd1.js} +1 -1
  80. package/dist/cli-h5cveb69.js +15 -0
  81. package/dist/{cli-gcyws2bp.js → cli-hamdfjtx.js} +2 -2
  82. package/dist/{cli-jwnac23b.js → cli-hh5m39pt.js} +1 -1
  83. package/dist/{cli-f9g96z28.js → cli-j8fmn3wv.js} +11 -11
  84. package/dist/cli-jngvszex.js +1514 -0
  85. package/dist/{cli-8vbxjzk0.js → cli-k791mabe.js} +6 -6
  86. package/dist/{cli-9fwznq4p.js → cli-k9m8fckz.js} +7 -7
  87. package/dist/{cli-39t9d248.js → cli-kz8rar0g.js} +1 -1
  88. package/dist/{cli-rzbsh6bw.js → cli-n15fhd43.js} +1 -1
  89. package/dist/{cli-wvbaq052.js → cli-nmdy8bzf.js} +10 -3
  90. package/dist/{cli-t9pzz2eq.js → cli-ntmjzyte.js} +4 -1
  91. package/dist/{cli-adzmmcvf.js → cli-ny8f5g7t.js} +2 -2
  92. package/dist/cli-p0g0erm9.js +15 -0
  93. package/dist/{cli-2zjxake1.js → cli-pgdqhdkw.js} +4 -4
  94. package/dist/cli-ph1jce1b.js +16 -0
  95. package/dist/{cli-v4z5v3jd.js → cli-phantfg3.js} +480 -328
  96. package/dist/{cli-2414h5r9.js → cli-rb1z91g8.js} +10221 -1397
  97. package/dist/{cli-a49frv85.js → cli-redtbppc.js} +1 -1
  98. package/dist/{cli-91amj3md.js → cli-s7bfz1ye.js} +15 -15
  99. package/dist/{cli-kg63yp1r.js → cli-sf5kp73f.js} +18 -18
  100. package/dist/{cli-fww016hh.js → cli-sq32dgfe.js} +1373 -7129
  101. package/dist/{cli-enavhq6r.js → cli-tbrjvrrg.js} +1 -1
  102. package/dist/{cli-84xn7bgz.js → cli-tdd9dvw6.js} +1 -1
  103. package/dist/{cli-qkbevqer.js → cli-tjrrabez.js} +3 -3
  104. package/dist/{cli-q457ga28.js → cli-tkrp183j.js} +11 -11
  105. package/dist/{cli-7w1fs01q.js → cli-trvtxwzt.js} +2 -2
  106. package/dist/{cli-ayxxkk3p.js → cli-v1rhq77v.js} +8 -8
  107. package/dist/{cli-9j47sgzy.js → cli-v3jxx8dv.js} +2 -2
  108. package/dist/{cli-f2rwt43y.js → cli-v84kb7af.js} +13 -13
  109. package/dist/{cli-3mhdmcd4.js → cli-vp2ksaq9.js} +1 -1
  110. package/dist/{cli-b0m3bg0f.js → cli-vrb8pvrf.js} +6 -6
  111. package/dist/cli-vxxdf2ma.js +15 -0
  112. package/dist/{cli-wd7b5hgc.js → cli-w81s97bn.js} +1 -1
  113. package/dist/{cli-bqfx72e6.js → cli-wkzrknpt.js} +1 -1
  114. package/dist/{cli-cg1q8ymp.js → cli-wqpvfq2m.js} +1 -1
  115. package/dist/{cli-pq0kv31y.js → cli-wsh5vfa7.js} +9 -9
  116. package/dist/{cli-shyhb4t5.js → cli-wtwe8vng.js} +39 -39
  117. package/dist/{cli-3wsabyt0.js → cli-ww8wxfzx.js} +2 -2
  118. package/dist/{cli-e8trbfx1.js → cli-x80zagf5.js} +1 -1
  119. package/dist/{cli-r495stwd.js → cli-xd6ntv7x.js} +2 -2
  120. package/dist/{cli-0h6m6z5g.js → cli-xmc2nrtv.js} +1 -1
  121. package/dist/{cli-q5n3deaf.js → cli-ytgtqsy9.js} +1 -1
  122. package/dist/{cli-srq69pn1.js → cli-yvnnyjxm.js} +1 -1
  123. package/dist/{cli-krk8y8c7.js → cli-z0c98h7h.js} +1747 -439
  124. package/dist/{cli-mw1tmn3x.js → cli-z0effej1.js} +7 -7
  125. package/dist/{cli-7g5qj2ca.js → cli-zcb64xzv.js} +1 -1
  126. package/dist/{cli-m0ea8ggd.js → cli-zdkcp8p0.js} +2 -2
  127. package/dist/{cli-37p61fcg.js → cli-zgsd2w2k.js} +20 -22
  128. package/dist/{cli-tc165vrb.js → cli-zmfs06hg.js} +7 -6
  129. package/dist/{cli-edxfzgah.js → cli-zvsy4abb.js} +4 -4
  130. package/dist/{cli-z8t4485r.js → cli-zyf288rw.js} +2 -2
  131. package/dist/cli.js +58 -59
  132. package/dist/{codex-adapter-eq61radw.js → codex-adapter-seht4h9t.js} +9 -9
  133. package/dist/{codex-hook-8nmepvz6.js → codex-hook-w5nmtrn2.js} +2 -2
  134. package/dist/{codex-login-vbd9707w.js → codex-login-67qarfcg.js} +1 -1
  135. package/dist/{codex-session-runner-rfx355h4.js → codex-session-runner-tq95x3gq.js} +10 -10
  136. package/dist/{commands-d1z0sx62.js → commands-0awwqxq5.js} +3 -3
  137. package/dist/{controller-9hz6d8x3.js → controller-hgjx521c.js} +4 -4
  138. package/dist/{controllers-connect-tz07d2xr.js → controllers-connect-j4kdmhfj.js} +28 -28
  139. package/dist/core-8fw1gwg7.js +41 -0
  140. package/dist/{cursor-adapter-ef22ze3j.js → cursor-adapter-0rg8wk6j.js} +2 -2
  141. package/dist/{db-gd81d68c.js → db-8xs2js3s.js} +3 -3
  142. package/dist/{db-vrckks6q.js → db-dd6hj211.js} +2 -2
  143. package/dist/{devin-adapter-kdt6a2bh.js → devin-adapter-tn1twrha.js} +1 -1
  144. package/dist/{devtools-qxfgbsqz.js → devtools-b8qts77k.js} +1 -1
  145. package/dist/{dispatcher-76as8w2t.js → dispatcher-v7drd034.js} +24 -24
  146. package/dist/{docker-51ta7jsh.js → docker-6007r2fj.js} +2 -2
  147. package/dist/{dsh-adapter-ypfvcdyz.js → dsh-adapter-ah8npj2x.js} +2 -2
  148. package/dist/{e2b-dm9r8hpy.js → e2b-hg80w0qr.js} +2 -2
  149. package/dist/{e2b-05kn3kpq.js → e2b-z1g7vpz6.js} +4 -4
  150. package/dist/{easter-egg-3d-sg21j15g.js → easter-egg-3d-8n4w3s9k.js} +1 -1
  151. package/dist/{embedding-space-zsdw37bb.js → embedding-space-0p921zt3.js} +5 -5
  152. package/dist/{embeddings-p4e3e1m6.js → embeddings-9s7kbrc6.js} +1 -1
  153. package/dist/emscripten-module-Q67P5WYC-3sde6cre.js +2458 -0
  154. package/dist/{event-bus-tvf2grf4.js → event-bus-pawddp92.js} +1 -1
  155. package/dist/{execute-nztd0af0.js → execute-x0fy9j0m.js} +1 -1
  156. package/dist/{external-channel-717yzn4d.js → external-channel-ktfvn29c.js} +2 -2
  157. package/dist/ffi-cbfmmtqk.js +85 -0
  158. package/dist/fx-adapter-15vjxvgm.js +20 -0
  159. package/dist/getMachineId-bsd-2rd3pnz7.js +36 -0
  160. package/dist/getMachineId-bsd-3p48mkt1.js +36 -0
  161. package/dist/{getMachineId-bsd-637a7rbk.js → getMachineId-bsd-bk6tmeen.js} +5 -5
  162. package/dist/getMachineId-bsd-pssqgwmm.js +37 -0
  163. package/dist/getMachineId-bsd-v218x3xd.js +36 -0
  164. package/dist/getMachineId-bsd-wbxcazef.js +36 -0
  165. package/dist/getMachineId-bsd-x0942pbz.js +36 -0
  166. package/dist/getMachineId-darwin-5qsy4qcg.js +36 -0
  167. package/dist/getMachineId-darwin-6v7zsshx.js +37 -0
  168. package/dist/getMachineId-darwin-fcc3fjag.js +36 -0
  169. package/dist/getMachineId-darwin-pg84hftj.js +36 -0
  170. package/dist/{getMachineId-darwin-9vytrcnn.js → getMachineId-darwin-tyyevt26.js} +5 -5
  171. package/dist/getMachineId-darwin-wagmbf0d.js +36 -0
  172. package/dist/getMachineId-darwin-zvkmwr3y.js +36 -0
  173. package/dist/{getMachineId-linux-mkzsvyyz.js → getMachineId-linux-2ncg1epd.js} +3 -3
  174. package/dist/getMachineId-linux-2tmt2ptc.js +29 -0
  175. package/dist/getMachineId-linux-empwyp2y.js +29 -0
  176. package/dist/getMachineId-linux-fanqd45b.js +29 -0
  177. package/dist/getMachineId-linux-h6fyga0x.js +29 -0
  178. package/dist/getMachineId-linux-tbhgz1k9.js +29 -0
  179. package/dist/getMachineId-linux-zrbyw7dt.js +29 -0
  180. package/dist/getMachineId-unsupported-29g9dkgv.js +19 -0
  181. package/dist/getMachineId-unsupported-8xfq8djv.js +19 -0
  182. package/dist/getMachineId-unsupported-8y9cag1p.js +19 -0
  183. package/dist/getMachineId-unsupported-a6sjrm02.js +19 -0
  184. package/dist/getMachineId-unsupported-bp3w7ds0.js +19 -0
  185. package/dist/{getMachineId-unsupported-4cfs2n11.js → getMachineId-unsupported-sj6fk8sw.js} +3 -3
  186. package/dist/getMachineId-unsupported-v0p5gdxp.js +19 -0
  187. package/dist/getMachineId-win-hc996p0x.js +38 -0
  188. package/dist/{getMachineId-win-154s3qma.js → getMachineId-win-msq9ad87.js} +6 -6
  189. package/dist/getMachineId-win-tajyqwd6.js +38 -0
  190. package/dist/getMachineId-win-tzc163da.js +38 -0
  191. package/dist/getMachineId-win-xdaa0mgq.js +38 -0
  192. package/dist/getMachineId-win-xk6p98m5.js +38 -0
  193. package/dist/getMachineId-win-xtk658fm.js +38 -0
  194. package/dist/{google-generative-ai-sw77egmr.js → google-generative-ai-nzndg246.js} +1 -1
  195. package/dist/{google-vertex-rrw93g8h.js → google-vertex-ragh3nnw.js} +1 -1
  196. package/dist/grok-adapter-77httan0.js +20 -0
  197. package/dist/handlers-c1jp5b6h.js +39 -0
  198. package/dist/heartbeat-5yaj6dym.js +49 -0
  199. package/dist/{hook-ctz0xmp3.js → hook-2jttae8s.js} +10 -11
  200. package/dist/hook-c99nycyh.js +21 -0
  201. package/dist/{http-zregegrx.js → http-7y9dbfrr.js} +155 -122
  202. package/dist/{index-kzdqn3dd.js → index-6g9rdcrj.js} +3036 -758
  203. package/dist/index-7dwh9kxh.js +41 -0
  204. package/dist/{index-ym9fgxad.js → index-8p03vx1h.js} +8 -8
  205. package/dist/{index-maddg9ys.js → index-cw8nxnba.js} +4330 -15375
  206. package/dist/{index-fdym6ryb.js → index-dm7c6hw5.js} +28 -28
  207. package/dist/index-fqf82sbk.js +10584 -0
  208. package/dist/{index-126v2d0t.js → index-g7rthzrv.js} +11 -2923
  209. package/dist/{index-x9qf8dg7.js → index-h9xnzfhx.js} +21 -20
  210. package/dist/{index-42jq9yy3.js → index-jvfp0j47.js} +516 -10
  211. package/dist/{index-mtnbhe12.js → index-q60mhcpd.js} +23631 -19921
  212. package/dist/{index-evay0xyk.js → index-qxcfv8vq.js} +1 -1
  213. package/dist/{index-rz8ve510.js → index-t274qhhs.js} +6 -6
  214. package/dist/{index-kdmkfjt7.js → index-t4n9z755.js} +3491 -2487
  215. package/dist/{index-7dgxveck.js → index-tcegcysh.js} +5 -5
  216. package/dist/{index-whysn1wf.js → index-tn1m3q9b.js} +3 -3
  217. package/dist/index-wp9tarbt.js +43 -0
  218. package/dist/{index-5kx15d19.js → index-xhp7yp3t.js} +1 -1
  219. package/dist/index-z6np2405.js +38 -0
  220. package/dist/{k8s-ejkk0aw7.js → k8s-mr1r12th.js} +2 -2
  221. package/dist/{keepalive-zdqay870.js → keepalive-7eyb8y4t.js} +4 -4
  222. package/dist/lead-50cgn8s1.js +81 -0
  223. package/dist/{maintenance-t5ndg11m.js → maintenance-tdrd8nwv.js} +1 -1
  224. package/dist/module-ES6BEMUI-6htewwha.js +1210 -0
  225. package/dist/{node-0as4n1ef.js → node-gbx1t3pa.js} +1 -1
  226. package/dist/{oauth-refresh-sweep-y9zyd7t6.js → oauth-refresh-sweep-f4c7g37h.js} +3 -3
  227. package/dist/{object-webhooks-mkca91s0.js → object-webhooks-p190rdxp.js} +7 -7
  228. package/dist/{onboard-ss995244.js → onboard-56h4sks6.js} +7 -7
  229. package/dist/{opencode-adapter-mwpz0278.js → opencode-adapter-xg3yxfr0.js} +8 -8
  230. package/dist/{otel-impl-6n6vva3x.js → otel-impl-kepzgm4n.js} +36360 -9179
  231. package/dist/{pending-2sxh1t6j.js → pending-xgv316w0.js} +25 -25
  232. package/dist/{pi-mono-adapter-sfb7zy43.js → pi-mono-adapter-txe0syzb.js} +19 -22
  233. package/dist/{pricing-refresh-h79bg4cf.js → pricing-refresh-041zpyhf.js} +2 -2
  234. package/dist/{rbac-roles-ckq0czp4.js → rbac-roles-8f3jbcaf.js} +2 -2
  235. package/dist/{rbac-roles-jg2e260w.js → rbac-roles-cw7rrw5b.js} +3 -3
  236. package/dist/{render-v2-ymbshmn0.js → render-v2-2ezw4mzt.js} +10 -10
  237. package/dist/{resume-jdhnt4jk.js → resume-p14wdx8m.js} +13 -13
  238. package/dist/{runtime-y28jhhnf.js → runtime-he7c9g1r.js} +1 -1
  239. package/dist/{session-access-k4ta5hvp.js → session-access-8jvq86fj.js} +5 -5
  240. package/dist/{session-source-backfill-528j4s8j.js → session-source-backfill-6fe3hcgb.js} +3 -3
  241. package/dist/{setup-d6pj82fr.js → setup-6v0bn4r1.js} +3 -3
  242. package/dist/thread-buffer-8860v1ta.js +40 -0
  243. package/dist/{token-util-pjgekqxr.js → token-util-hnzceyn9.js} +1 -1
  244. package/dist/{token-pgr2w4s3.js → token-xnc02n6w.js} +21 -14
  245. package/dist/{tree-visibility-kjxv3nxk.js → tree-visibility-g1a8ff4r.js} +2 -2
  246. package/dist/{user-merge-jobs-rabbncf6.js → user-merge-jobs-vjsps179.js} +3 -3
  247. package/dist/{virtual-modules-22k51txd.js → virtual-modules-mreda4fp.js} +3 -3
  248. package/dist/{work-objects-xtjbar3r.js → work-objects-hfw15e35.js} +26 -26
  249. package/dist/{worker-follow-up-fg48vk6d.js → worker-follow-up-gbaz2ydz.js} +24 -24
  250. package/dist/worker-hkm8ftqp.js +81 -0
  251. package/dist/{x-vfsqypht.js → x-k29vmskt.js} +2 -2
  252. package/openapi.json +57 -1
  253. package/package.json +39 -39
  254. package/src/be/db/model-profiles.ts +103 -12
  255. package/src/be/db/tasks/read.ts +5 -0
  256. package/src/be/db.ts +14 -4
  257. package/src/be/model-group-resolution.ts +134 -0
  258. package/src/be/model-tier-resolution.ts +120 -17
  259. package/src/be/model-validation.ts +9 -1
  260. package/src/be/runtime-pools/routing.ts +22 -8
  261. package/src/be/scripts/extract-schema.ts +7 -0
  262. package/src/be/swarm-config-guard.ts +17 -7
  263. package/src/commands/onboard/agent-fs-version.ts +1 -1
  264. package/src/extensions/contract-types.generated.ts +1 -1
  265. package/src/http/db-query.ts +8 -2
  266. package/src/http/operator-actor.ts +3 -8
  267. package/src/http/poll.ts +20 -1
  268. package/src/http/repos.ts +3 -1
  269. package/src/http/schedules.ts +23 -3
  270. package/src/http/tasks.ts +11 -1
  271. package/src/prompts/base-prompt.ts +10 -6
  272. package/src/prompts/session-templates.ts +3 -3
  273. package/src/providers/acp-targets.ts +1 -1
  274. package/src/providers/amp-adapter.ts +11 -9
  275. package/src/providers/cursor-adapter.ts +1 -1
  276. package/src/realtime/browser.generated.txt +1 -1
  277. package/src/scheduler/schedule-task.ts +1 -0
  278. package/src/scripts-runtime/types/swarm-extension.d.ts +2 -0
  279. package/src/slack/config.ts +4 -0
  280. package/src/slack/render-v2.ts +2 -1
  281. package/src/slack/responses.ts +2 -1
  282. package/src/tasks/follow-up-gate.ts +142 -38
  283. package/src/tasks/worker-follow-up.ts +126 -37
  284. package/src/tests/amp-adapter.test.ts +57 -9
  285. package/src/tests/base-prompt.test.ts +36 -2
  286. package/src/tests/db-retention-defaults.test.ts +28 -3
  287. package/src/tests/entrypoint-repo-autoclone-args.test.ts +10 -0
  288. package/src/tests/follow-up-gate-shadow.test.ts +268 -10
  289. package/src/tests/linear-outbound-sync.test.ts +59 -25
  290. package/src/tests/operator-actor-keyless.test.ts +103 -0
  291. package/src/tests/profile-tier-alias.test.ts +9 -3
  292. package/src/tests/runner-repo-clone-args.test.ts +15 -6
  293. package/src/tests/workflow-system-one-extraction.test.ts +21 -0
  294. package/src/tests/workflow-wait-filter.test.ts +7 -7
  295. package/src/tests/worktree-reaper.test.ts +15 -4
  296. package/src/tools/schedules/create-schedule.ts +20 -3
  297. package/src/tools/schedules/patch-schedule.ts +30 -4
  298. package/src/tools/schedules/update-schedule.ts +30 -4
  299. package/src/tools/send-task.ts +17 -3
  300. package/src/tools/slack-post.ts +7 -2
  301. package/src/tools/slack-reply.ts +6 -2
  302. package/src/tools/task-action.ts +16 -3
  303. package/src/tools/utils.ts +1 -1
  304. package/src/types.ts +10 -0
  305. package/src/utils/amp-models.ts +20 -4
  306. package/src/utils/secret-scrubber.ts +6 -4
  307. package/src/workflows/engine.ts +36 -8
  308. package/src/workflows/executors/agent-task.ts +13 -2
  309. package/src/workflows/executors/code-match.ts +11 -31
  310. package/src/workflows/executors/script.ts +13 -0
  311. package/src/workflows/executors/system-one-extraction.ts +9 -6
  312. package/src/workflows/executors/wait.ts +1 -1
  313. package/src/workflows/foreach-driver.ts +5 -1
  314. package/src/workflows/model-validation.ts +13 -1
  315. package/src/workflows/predicate-sandbox.ts +171 -0
  316. package/src/workflows/retry-poller.ts +1 -1
  317. package/src/workflows/wait-filter.ts +14 -192
  318. package/templates/skills/heartbeat-runbook/content.md +1 -0
  319. package/templates/skills/slack-interaction/content.md +4 -0
  320. package/templates/skills/swarm-docs/content.md +1 -0
  321. package/dist/acp-adapter-99n6z9ky.js +0 -17
  322. package/dist/cli-5ss6qqt9.js +0 -45
  323. package/dist/cli-dzzh58sy.js +0 -6996
  324. package/dist/cli-j9ccfveb.js +0 -1849
  325. package/dist/cli-mna6pmfx.js +0 -1485
  326. package/dist/cli-r8ddn0hf.js +0 -25583
  327. package/dist/core-dynsv289.js +0 -41
  328. package/dist/fx-adapter-9k0hptnz.js +0 -20
  329. package/dist/grok-adapter-skdj2pce.js +0 -20
  330. package/dist/handlers-5btjqkz6.js +0 -39
  331. package/dist/heartbeat-vfb1gy84.js +0 -49
  332. package/dist/hook-eh52p7yd.js +0 -22
  333. package/dist/index-7w8p6em0.js +0 -41
  334. package/dist/index-t56y945n.js +0 -4
  335. package/dist/index-vfemrwwk.js +0 -10002
  336. package/dist/index-vz4semsx.js +0 -38
  337. package/dist/index-y3s0xp2v.js +0 -43
  338. package/dist/lead-6cscw8a5.js +0 -82
  339. package/dist/thread-buffer-9w6x5zec.js +0 -40
  340. package/dist/worker-g4aj93dt.js +0 -82
  341. package/dist/{azure-openai-responses-jeaas6x0.js → azure-openai-responses-e76k86gf.js} +4 -4
  342. package/dist/{openai-codex-responses-70g39cgz.js → openai-codex-responses-z2h941b8.js} +4 -4
  343. package/dist/{openai-completions-cv3hp4h5.js → openai-completions-5bxdkeg9.js} +4 -4
  344. package/dist/{openai-responses-trsvnks6.js → openai-responses-dzf3e8r5.js} +4 -4
@@ -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 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';
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';
@@ -1,6 +1,6 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
- import { scrubObject } from "../utils/secret-scrubber";
3
+ import { createSweepScrubber, scrubObject } from "../utils/secret-scrubber";
4
4
  import { executeReadOnlyQueryBounded } from "./db-query-bounded";
5
5
  import {
6
6
  assertSingleStatement,
@@ -139,7 +139,13 @@ export async function handleDbQuery(
139
139
  );
140
140
  // Rows can hold secrets pasted into free text (task output, logs, events).
141
141
  // The MCP tool gets this from the registrar; the HTTP route does it here.
142
- dbQueryRoute.respond(res, 200, scrubObject(result));
142
+ // The scrub is synchronous, so one sweep scrubber per request stays valid; it
143
+ // skips the rules a clean row cannot trigger (rows run to MBs on this route).
144
+ dbQueryRoute.respond(
145
+ res,
146
+ 200,
147
+ scrubObject(result, undefined, undefined, createSweepScrubber()),
148
+ );
143
149
  } catch (err: unknown) {
144
150
  if (err instanceof DbQueryConcurrencyCapError) {
145
151
  // Machine-readable code + Retry-After so a caller can back off instead
@@ -57,14 +57,9 @@ export function getOperatorActor(req: IncomingMessage, res: ServerResponse): Ide
57
57
  const rawKey = extractBearer(req);
58
58
  const swarmKey = getApiKey();
59
59
 
60
- // If no key is configured server-side, the public-route guard already
61
- // skipped the bearer check. We still need *some* fingerprint for the audit
62
- // event — fall back to a stable placeholder so callers see consistent shapes.
63
- if (!swarmKey) {
64
- return { kind: "operator", id: fingerprintApiKey("") };
65
- }
66
-
67
- if (!rawKey || !verifyTokenEquality(swarmKey, rawKey)) {
60
+ // With no swarm key configured there is no operator credential to match, so
61
+ // a non-user caller (such as an agent session token) is refused here too.
62
+ if (!swarmKey || !rawKey || !verifyTokenEquality(swarmKey, rawKey)) {
68
63
  jsonError(res, "Unauthorized", 401);
69
64
  return null;
70
65
  }
package/src/http/poll.ts CHANGED
@@ -26,6 +26,7 @@ import {
26
26
  updateAgentStatusFromCapacity,
27
27
  upsertChannelActivityCursor,
28
28
  } from "../be/db";
29
+ import { resolveGroupForAgent } from "../be/model-group-resolution";
29
30
  import { checkProfileForAgent } from "../be/model-profile-check";
30
31
  import {
31
32
  modelTierOverridesDiffer,
@@ -669,13 +670,31 @@ export async function handlePoll(
669
670
  profileOk.set(memoKey, ok);
670
671
  return ok;
671
672
  };
673
+ // A model group task waits, the same way, for an agent with a member that
674
+ // passes; otherwise claim would hard-stop it with [model-group-unavailable].
675
+ const groupOk = new Map<string, boolean>();
676
+ const passesGroupCheck = async (
677
+ group: string,
678
+ vcsRepo: string | null | undefined,
679
+ ): Promise<boolean> => {
680
+ const memoKey = JSON.stringify([group, vcsRepo ?? null]);
681
+ const cached = groupOk.get(memoKey);
682
+ if (cached !== undefined) return cached;
683
+ const ok =
684
+ (await resolveGroupForAgent(group, myAgentId, { vcsRepo, includeRepoSecrets }))
685
+ .kind !== "none";
686
+ groupOk.set(memoKey, ok);
687
+ return ok;
688
+ };
672
689
  // The filter runs inside the paginated scan, so incompatible rows never use up the limit.
673
690
  const unassignedIds = await getUnassignedTaskIdsForAgent(
674
691
  myAgentId,
675
692
  5,
676
693
  async (task) =>
677
694
  (await poolTaskRunsOnHarness(task, harness)) &&
678
- (!task.profile || (await passesProfileCheck(task.profile, task.vcsRepo))),
695
+ (task.profile
696
+ ? await passesProfileCheck(task.profile, task.vcsRepo)
697
+ : !task.modelGroup || (await passesGroupCheck(task.modelGroup, task.vcsRepo))),
679
698
  );
680
699
  // Budget admission gate (Phase 3). Pool path is workers-only —
681
700
  // per-agent budgets matter most here, but we still check global.
package/src/http/repos.ts CHANGED
@@ -102,7 +102,9 @@ const updateRepo = route({
102
102
  404: { description: "Repo not found", schema: z.object({ error: z.string() }) },
103
103
  409: { description: "Duplicate repo", schema: z.object({ error: z.string() }) },
104
104
  },
105
- rbac: { permission: "repo.merge-policy.write" },
105
+ // `url`, `clonePath` and `hooks` changes gate on `repo.exec-config.write` instead; the
106
+ // handler decides per changed field inside the update transaction.
107
+ rbac: { permission: "repo.merge-policy.write", alsoAdmits: ["repo.exec-config.write"] },
106
108
  });
107
109
 
108
110
  const deleteRepo = route({
@@ -17,6 +17,7 @@ import {
17
17
  withFavoriteFlags,
18
18
  } from "../be/db";
19
19
  import {
20
+ modelGroupRefError,
20
21
  modelProfileRefError,
21
22
  scheduleProfileUpdate,
22
23
  taskProfileError,
@@ -65,6 +66,8 @@ const scheduleUpdateBodySchema = z.object({
65
66
  modelTier: ModelTierSchema.nullable().optional(),
66
67
  /** Model profile for every fired task. Exclusive with model/modelTier; setting one clears the other. */
67
68
  profile: z.string().nullable().optional(),
69
+ /** Model group for every fired task. Exclusive with model/modelTier/profile; setting one clears the others. */
70
+ modelGroup: z.string().nullable().optional(),
68
71
  /** Accept a `model` the catalog does not list (a custom id). Without it an unknown id is a 400. */
69
72
  allowCustomModel: z.boolean().optional(),
70
73
  nextRunAt: z.string().nullable().optional(),
@@ -128,6 +131,8 @@ const createSchedule = route({
128
131
  modelTier: ModelTierSchema.optional(),
129
132
  /** Model profile for every fired task. Exclusive with model/modelTier. */
130
133
  profile: z.string().optional(),
134
+ /** Model group for every fired task. Exclusive with model/modelTier/profile. */
135
+ modelGroup: z.string().optional(),
131
136
  /** Accept a `model` the catalog does not list (a custom id). Without it an unknown id is a 400. */
132
137
  allowCustomModel: z.boolean().optional(),
133
138
  scheduleType: z.enum(["recurring", "one_time"]).optional(),
@@ -430,6 +435,7 @@ export async function handleSchedules(
430
435
  profile: body.profile,
431
436
  model: body.model,
432
437
  modelTier: body.modelTier,
438
+ modelGroup: body.modelGroup,
433
439
  agentId: body.targetAgentId,
434
440
  });
435
441
  if (profileError) {
@@ -484,6 +490,7 @@ export async function handleSchedules(
484
490
  timezone: body.timezone,
485
491
  ...splitLegacyModelAlias({ model: body.model, modelTier: body.modelTier }),
486
492
  profile: body.profile?.trim() || undefined,
493
+ modelGroup: body.modelGroup?.trim() || undefined,
487
494
  scheduleType: body.scheduleType,
488
495
  targetType: body.targetType,
489
496
  workflowId: body.workflowId,
@@ -499,7 +506,11 @@ export async function handleSchedules(
499
506
 
500
507
  createSchedule.respond(res, 201, schedule);
501
508
  } catch (error) {
502
- // The profile was deleted between taskProfileError and the insert.
509
+ // The profile or group was deleted between taskProfileError and the insert.
510
+ if (modelGroupRefError(error)) {
511
+ jsonError(res, `Unknown model group "${body.modelGroup}".`, 400);
512
+ return true;
513
+ }
503
514
  if (modelProfileRefError(error) === "missing") {
504
515
  jsonError(res, `Unknown model profile "${body.profile}".`, 400);
505
516
  return true;
@@ -691,7 +702,12 @@ export async function handleSchedules(
691
702
  if (parsed.body.modelTier !== undefined || normalizedModel.modelTier) {
692
703
  body.modelTier = normalizedModel.modelTier ?? null;
693
704
  }
694
- } else if (agentChanged && existing.model && !profileUpdate.fields.profile) {
705
+ } else if (
706
+ agentChanged &&
707
+ existing.model &&
708
+ !profileUpdate.fields.profile &&
709
+ !profileUpdate.fields.modelGroup
710
+ ) {
695
711
  // Harness only: the stored id already passed the catalog check when it was written.
696
712
  const modelError = await explicitModelErrorForAgent({
697
713
  model: existing.model,
@@ -842,7 +858,11 @@ export async function handleSchedules(
842
858
  try {
843
859
  schedule = await updateScheduledTask(parsed.params.id, body);
844
860
  } catch (error) {
845
- // The profile was deleted between scheduleProfileUpdate and the write.
861
+ // The profile or group was deleted between scheduleProfileUpdate and the write.
862
+ if (modelGroupRefError(error)) {
863
+ jsonError(res, `Unknown model group "${body.modelGroup}".`, 400);
864
+ return true;
865
+ }
846
866
  if (modelProfileRefError(error) !== "missing") throw error;
847
867
  jsonError(res, `Unknown model profile "${body.profile}".`, 400);
848
868
  return true;
package/src/http/tasks.ts CHANGED
@@ -45,6 +45,7 @@ import {
45
45
  import {
46
46
  getModelProfileByName,
47
47
  hasUnreadableCredentialAllowlist,
48
+ modelGroupRefError,
48
49
  modelProfileRefError,
49
50
  taskProfileError,
50
51
  } from "../be/db/model-profiles";
@@ -180,6 +181,7 @@ const AgentTaskSummarySchema = AgentTaskSchema.pick({
180
181
  resolvedEffort: true,
181
182
  profile: true,
182
183
  resolvedProfile: true,
184
+ modelGroup: true,
183
185
  provider: true,
184
186
  requestedByUserId: true,
185
187
  progress: true,
@@ -398,6 +400,8 @@ const createTask = route({
398
400
  effort: ReasoningEffortSchema.optional(),
399
401
  /** Model profile name, applied at claim. Exclusive with `model` and `modelTier`. */
400
402
  profile: z.string().trim().min(1).optional(),
403
+ /** Model group name, resolved per agent at claim. Exclusive with `model`, `modelTier` and `profile`. */
404
+ modelGroup: z.string().trim().min(1).optional(),
401
405
  /**
402
406
  * Create in `draft` status instead of the normal pending/unassigned/offered
403
407
  * status (#1240) — the task exists and is visible to its owner, but is not
@@ -1279,6 +1283,7 @@ export async function handleTasks(
1279
1283
  // the worker loads config from, so the profile check judges the same pool.
1280
1284
  const profileError = await taskProfileError({
1281
1285
  profile: parsed.body.profile,
1286
+ modelGroup: parsed.body.modelGroup,
1282
1287
  ...splitLegacyModelAlias({ model: parsed.body.model, modelTier: parsed.body.modelTier }),
1283
1288
  agentId: defaultAgentId,
1284
1289
  vcsRepo: vcsRepo ?? parentTask?.vcsRepo,
@@ -1349,6 +1354,7 @@ export async function handleTasks(
1349
1354
  }),
1350
1355
  effort: parsed.body.effort,
1351
1356
  profile: parsed.body.profile,
1357
+ modelGroup: parsed.body.modelGroup,
1352
1358
  },
1353
1359
  { origin: "rest", allowCustomModel: parsed.body.allowCustomModel },
1354
1360
  );
@@ -1412,7 +1418,11 @@ export async function handleTasks(
1412
1418
  jsonError(res, error.message, 400);
1413
1419
  return true;
1414
1420
  }
1415
- // The profile was deleted between taskProfileError and the insert.
1421
+ // The profile or group was deleted between taskProfileError and the insert.
1422
+ if (modelGroupRefError(error)) {
1423
+ jsonError(res, `Unknown model group "${parsed.body.modelGroup}"`, 400);
1424
+ return true;
1425
+ }
1416
1426
  if (modelProfileRefError(error) === "missing") {
1417
1427
  jsonError(res, `Unknown model profile "${parsed.body.profile}"`, 400);
1418
1428
  return true;
@@ -78,6 +78,9 @@ function claudeMdSourcePath(provider: string): string {
78
78
  return provider === "claude" ? "~/.claude/CLAUDE.md" : "/workspace/CLAUDE.md";
79
79
  }
80
80
 
81
+ /** Public guide for the per-repo merge policy and the swarm auto-merger. */
82
+ const REPO_MERGE_POLICY_DOCS_URL = "https://docs.agent-swarm.dev/docs/guides/repo-merge-policy";
83
+
81
84
  /** Providers that get the repo CLAUDE.md inlined until native loading is verified. */
82
85
  const REPO_CLAUDE_MD_INLINE_PROVIDERS: ReadonlySet<string> = new Set(["opencode"]);
83
86
 
@@ -583,15 +586,16 @@ function renderToolsAndSkillsVars(input: {
583
586
  };
584
587
  }
585
588
 
586
- /** The mergePolicy record's swarm auto-merge line, or "" when the repo has no record. */
589
+ /**
590
+ * The mergePolicy record's swarm auto-merge line, or "" when the repo has no record.
591
+ * It points at the live record and the guide instead of printing the threshold,
592
+ * classes or risky paths: those are tunable and a prompt copy goes stale.
593
+ */
587
594
  function renderSwarmAutoMerge(policy: RepoMergePolicy | undefined): string {
588
595
  const auto = policy?.autoMerge;
589
596
  if (!auto) return "";
590
597
  if (!auto.enabled) return "\n- Swarm auto-merge: off";
591
- const parts = [`Swarm auto-merge: on (minimum score ${auto.threshold})`];
592
- if (auto.classes.length > 0) parts.push(`classes: ${auto.classes.join(", ")}`);
593
- if (auto.riskyPaths.length > 0) parts.push(`never for paths: ${auto.riskyPaths.join(", ")}`);
594
- return `\n- ${parts.join("; ")}`;
598
+ return `\n- Swarm auto-merge: on. The swarm auto-merger merges PRs that pass its scoring. The live threshold, classes and risky paths are in this repo's \`mergePolicy.autoMerge\` (\`get-repos\`); process: ${REPO_MERGE_POLICY_DOCS_URL}`;
595
599
  }
596
600
 
597
601
  /**
@@ -661,7 +665,7 @@ async function renderRepositoryVars(
661
665
  section += `If ANY check fails, fix the issue before pushing. Do NOT push code with failing checks.\nDo NOT use \`--no-verify\` or any flag that bypasses git hooks.\n\n`;
662
666
  }
663
667
  const mergePolicy = await resolveTemplateAsync("system.agent.repository.merge_policy", {
664
- agents_may_merge: agentsMayMerge(g) ? "Allowed" : "Not allowed (default)",
668
+ agents_may_merge: agentsMayMerge(g) ? "allowed" : "not allowed (default)",
665
669
  swarm_auto_merge: renderSwarmAutoMerge(g.mergePolicy),
666
670
  merge_checks:
667
671
  g.mergeChecks.length > 0
@@ -620,17 +620,17 @@ registerTemplate({
620
620
  eventType: "system.agent.repository.merge_policy",
621
621
  header: "",
622
622
  defaultBody: `**Merge Policy:**
623
- - Auto-merge: {{agents_may_merge}}{{swarm_auto_merge}}{{merge_checks}}`,
623
+ - Agent hand-merge: {{agents_may_merge}}{{swarm_auto_merge}}{{merge_checks}}`,
624
624
  variables: [
625
625
  {
626
626
  name: "agents_may_merge",
627
627
  description:
628
- "'Allowed' or 'Not allowed (default)': the repo's mergePolicy.agentsMayMerge, else its allowMerge guideline.",
628
+ "Whether an agent may merge a PR itself, 'allowed' or 'not allowed (default)': the repo's mergePolicy.agentsMayMerge, else its allowMerge guideline. Separate from swarm auto-merge.",
629
629
  },
630
630
  {
631
631
  name: "swarm_auto_merge",
632
632
  description:
633
- "Lines for the repo's mergePolicy record (swarm auto-merge state, classes, threshold, risky paths). Empty when the repo has no record.",
633
+ "The swarm auto-merge line for the repo's mergePolicy record: on or off, plus a pointer to the live record and the merge-policy guide (no threshold, it changes). Empty when the repo has no record.",
634
634
  },
635
635
  {
636
636
  name: "merge_checks",
@@ -480,7 +480,7 @@ const qwenTargetProfile: AcpTargetProfile = {
480
480
  * Kiro CLI reads its prompt from a Kiro agent config, not from a flag or an
481
481
  * env var, so the swarm system prompt is not injected (as with OpenCode).
482
482
  * Kiro advertises no ACP config options (checked on 2.29.1), so the model
483
- * rides on argv as `--model`, which `kiro-cli acp` still accepts in 3.4.0.
483
+ * rides on argv as `--model`, which `kiro-cli acp` still accepts in 3.5.0.
484
484
  */
485
485
  const kiroTargetProfile: AcpTargetProfile = {
486
486
  target: "kiro",
@@ -4,6 +4,8 @@ import { tmpdir } from "node:os";
4
4
  import { join } from "node:path";
5
5
  import { contextBoundNoteThreshold, createContextBoundNote } from "../hooks/context-bound-note";
6
6
  import {
7
+ AMP_MODE_EFFORTS,
8
+ AMP_MODE_MODELS,
7
9
  type AmpMode,
8
10
  type AmpModelSelection,
9
11
  ampBillsCacheWrites,
@@ -45,7 +47,7 @@ import type {
45
47
  * default; the image installs exactly this version and the per-task settings
46
48
  * set `amp.updates.mode: "disabled"`. Bump it deliberately, with a live run.
47
49
  */
48
- export const AMP_PACKAGE = "@ampcode/cli@0.0.1795017641-g2e763e";
50
+ export const AMP_PACKAGE = "@ampcode/cli@0.0.1795089646-g8be92a";
49
51
 
50
52
  /** MCP server name. Amp exposes its tools as `agent_swarm` / `store_progress` (dashes become underscores). */
51
53
  const AMP_MCP_SERVER_NAME = "agent-swarm";
@@ -84,9 +86,9 @@ function ampEffort(level: ReasoningEffort): string {
84
86
  }
85
87
 
86
88
  /**
87
- * The per-task plugin: one agent mode that extends a built-in mode, appends the
88
- * swarm system prompt as `instructions`, and optionally pins a model and an
89
- * effort. Amp has no system-prompt flag, so this is the supported route (live
89
+ * The per-task plugin: one agent mode on the pinned model (else the model of
90
+ * the selected mode) that appends the swarm system prompt as `instructions`,
91
+ * with an optional effort. Amp rejects `extends` and built-in agents here. Amp has no system-prompt flag, so this is the supported route (live
90
92
  * verified: the instructions reach the model). The values are a JSON literal,
91
93
  * never code, so a prompt cannot break out of the string.
92
94
  *
@@ -103,10 +105,11 @@ export function buildAmpPlugin(options: {
103
105
  steeringInbox?: string;
104
106
  }): string {
105
107
  const config = JSON.stringify({
106
- baseMode: options.baseMode,
107
108
  instructions: options.instructions,
108
- model: options.pin ?? null,
109
- reasoningEffort: options.reasoningEffort ?? null,
109
+ model: options.pin ?? AMP_MODE_MODELS[options.baseMode],
110
+ reasoningEffort:
111
+ options.reasoningEffort ??
112
+ (options.pin ? null : (AMP_MODE_EFFORTS[options.baseMode] ?? null)),
110
113
  steeringInbox: options.steeringInbox ?? null,
111
114
  });
112
115
  return `// @amp-agent-mode key=${AMP_PLUGIN_MODE_KEY} label=Agent Swarm
@@ -181,9 +184,8 @@ export default function (amp: any) {
181
184
  key: ${JSON.stringify(AMP_PLUGIN_MODE_KEY)},
182
185
  label: "Agent Swarm",
183
186
  agent: amp.createAgent({
184
- extends: CONFIG.baseMode,
187
+ model: CONFIG.model,
185
188
  ...(CONFIG.instructions ? { instructions: CONFIG.instructions } : {}),
186
- ...(CONFIG.model ? { model: CONFIG.model } : {}),
187
189
  ...(CONFIG.reasoningEffort ? { reasoningEffort: CONFIG.reasoningEffort } : {}),
188
190
  display: { label: "Agent Swarm" },
189
191
  }).definition,
@@ -35,7 +35,7 @@ import type {
35
35
  } from "./types";
36
36
 
37
37
  /** Pinned in package.json and Dockerfile.worker; bump all three together. */
38
- export const CURSOR_SDK_VERSION = "1.4.1";
38
+ export const CURSOR_SDK_VERSION = "1.4.2";
39
39
 
40
40
  /** MCP server name; Cursor reports its tools as `mcp` calls with this `providerIdentifier`. */
41
41
  const CURSOR_MCP_SERVER_NAME = "agent-swarm";