@desplega.ai/agent-swarm 2.14.0 → 2.14.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (411) hide show
  1. package/dist/acp-adapter-q1vz4hh2.js +17 -0
  2. package/dist/{acp-targets-23exz4z4.js → acp-targets-d44eerh4.js} +10 -10
  3. package/dist/{actions-zcr25x27.js → actions-z4k4bvss.js} +28 -28
  4. package/dist/{agent-fs-provision-7fa9e12e.js → agent-fs-provision-aan1cgpx.js} +4 -4
  5. package/dist/{amp-adapter-s7ytmv6b.js → amp-adapter-wac3py0p.js} +3 -3
  6. package/dist/{anthropic-messages-vdd1zmha.js → anthropic-messages-njt2r5m4.js} +28 -27
  7. package/dist/{app-5d3sz1hy.js → app-wax6qz5e.js} +10 -10
  8. package/dist/{approval-notifications-7qgkzkzx.js → approval-notifications-6fvkhnma.js} +11 -11
  9. package/dist/{assistant-p2yvhc3j.js → assistant-e8fe08zx.js} +29 -29
  10. package/dist/{azure-openai-responses-jeaas6x0.js → azure-openai-responses-6ewf9rwp.js} +6 -6
  11. package/dist/{boot-args-schema-ry6cb0p7.js → boot-args-schema-rv97cmnt.js} +1 -1
  12. package/dist/{boot-reembed-c9643ms3.js → boot-reembed-bcn7frk9.js} +1 -1
  13. package/dist/{boot-reembed-2hkm3vz2.js → boot-reembed-xakrdy6y.js} +1 -1
  14. package/dist/{boot-scrub-sweep-3ycxr51t.js → boot-scrub-sweep-20t8akhf.js} +2 -2
  15. package/dist/{boot-seeds-2hzvvzg0.js → boot-seeds-48rr6r29.js} +4 -4
  16. package/dist/{boxd-9py3x0jb.js → boxd-tjpxwecx.js} +3 -3
  17. package/dist/{claude-adapter-dnkww93e.js → claude-adapter-0wzwntrj.js} +12 -13
  18. package/dist/{claude-managed-adapter-yk0cr5x6.js → claude-managed-adapter-4xcgt46w.js} +4 -4
  19. package/dist/{claude-managed-setup-4byxpp47.js → claude-managed-setup-91cyktw7.js} +7 -7
  20. package/dist/{claude-sdk-session-4wf3dbvs.js → claude-sdk-session-ngj4dce5.js} +11144 -12464
  21. package/dist/{cli-gcyws2bp.js → cli-021hrewp.js} +2 -2
  22. package/dist/{cli-wvgg7r4j.js → cli-08gfvs58.js} +2 -2
  23. package/dist/{cli-2zjxake1.js → cli-0kyjrbaa.js} +4 -4
  24. package/dist/{cli-rp1n2xpd.js → cli-0nvqg1hb.js} +1 -1
  25. package/dist/{cli-vxmmttmt.js → cli-0nz04gqv.js} +50 -50
  26. package/dist/{cli-vr4eyq6p.js → cli-0rrft7s3.js} +538 -410
  27. package/dist/{cli-mw1tmn3x.js → cli-1d9q7qrn.js} +7 -7
  28. package/dist/{cli-84xn7bgz.js → cli-1t5vhrpv.js} +1 -1
  29. package/dist/{cli-hzhv7yac.js → cli-1zbj28py.js} +1 -1
  30. package/dist/{cli-z8t4485r.js → cli-2ja7eadd.js} +2 -2
  31. package/dist/{cli-r04ve9xw.js → cli-2r62jy9s.js} +1 -1
  32. package/dist/{cli-9fwznq4p.js → cli-3ffzr65w.js} +7 -7
  33. package/dist/{cli-2ckwgs7q.js → cli-3kdgm393.js} +5 -5
  34. package/dist/{cli-jwnac23b.js → cli-3vc518cw.js} +1 -1
  35. package/dist/{cli-6p8p2e6r.js → cli-5188hq0a.js} +1286 -31
  36. package/dist/{cli-zcghfsdg.js → cli-53gt8wfv.js} +1 -1
  37. package/dist/{cli-930zbczq.js → cli-5njmmmer.js} +3 -3
  38. package/dist/{cli-dw9rtjm3.js → cli-5rw7nt99.js} +3061 -727
  39. package/dist/{cli-6c61yjwy.js → cli-5xx353cy.js} +7554 -1534
  40. package/dist/{cli-2ap1the6.js → cli-65k149j5.js} +2 -2
  41. package/dist/{cli-v41kn3cd.js → cli-6prwz0zn.js} +4427 -5566
  42. package/dist/{cli-yd7e590v.js → cli-6zpn5hmp.js} +12 -12
  43. package/dist/{cli-ty3gha1p.js → cli-7b9bwrfg.js} +2 -2
  44. package/dist/{cli-2414h5r9.js → cli-7dpdq7yh.js} +11428 -1914
  45. package/dist/{cli-r9d2tya0.js → cli-7qkbab03.js} +5 -5
  46. package/dist/{cli-7ca8hczj.js → cli-7svwhw1a.js} +1 -1
  47. package/dist/cli-7wwewkf4.js +37 -0
  48. package/dist/{cli-ejnhs815.js → cli-83hynhes.js} +17 -13
  49. package/dist/{cli-rs1rzwp4.js → cli-8crn0510.js} +1 -1
  50. package/dist/{cli-f2rwt43y.js → cli-8ee7xt75.js} +13 -13
  51. package/dist/{cli-9j47sgzy.js → cli-8ef94zm2.js} +2 -2
  52. package/dist/{cli-9fvk9mv8.js → cli-8gr1bg9t.js} +1 -1
  53. package/dist/{cli-b0m3bg0f.js → cli-9j1qcs0b.js} +1 -1
  54. package/dist/{cli-ad00h1st.js → cli-9mvfvggt.js} +7 -7
  55. package/dist/{cli-xh5fpmg8.js → cli-9txap41q.js} +101 -18
  56. package/dist/{cli-24wervhz.js → cli-aktk3qt6.js} +3 -3
  57. package/dist/{cli-6ajyhxh7.js → cli-an8bpy60.js} +2 -2
  58. package/dist/{cli-meydjstb.js → cli-azptj8xe.js} +5591 -69
  59. package/dist/cli-c0rt16vk.js +15 -0
  60. package/dist/{cli-w4bvtxet.js → cli-c6vhcknq.js} +7 -7
  61. package/dist/{cli-2savn6mm.js → cli-cczffwak.js} +7 -7
  62. package/dist/{cli-ze1ndjs4.js → cli-cgmka83w.js} +3 -3
  63. package/dist/{cli-kc7vd07m.js → cli-d13qgcct.js} +3699 -1733
  64. package/dist/{cli-k3facve0.js → cli-d5nvy1jy.js} +1 -1
  65. package/dist/{cli-edxfzgah.js → cli-dev6f0px.js} +4 -4
  66. package/dist/{cli-0e914dp9.js → cli-dzhht0vq.js} +3 -3
  67. package/dist/{cli-m0ea8ggd.js → cli-e13kbyq0.js} +2 -2
  68. package/dist/{cli-73rmgm45.js → cli-e2k0ej0d.js} +2 -2
  69. package/dist/cli-ek8b88kv.js +9740 -0
  70. package/dist/{cli-0k7ppk9k.js → cli-ertcjw6z.js} +281 -46
  71. package/dist/{cli-qrwjk4xy.js → cli-f3ta4e67.js} +5 -5
  72. package/dist/{cli-1nfabrt4.js → cli-f4xv7s0t.js} +7 -7
  73. package/dist/{cli-phe2vcw5.js → cli-fdam1t9b.js} +171 -104
  74. package/dist/{cli-gc6b94tj.js → cli-fe8he9cy.js} +2 -2
  75. package/dist/{cli-spfz393q.js → cli-feh37wgs.js} +598 -219
  76. package/dist/{cli-ebqx630g.js → cli-fjzjtqna.js} +35 -18
  77. package/dist/{cli-37p61fcg.js → cli-fs9t2m2k.js} +18 -20
  78. package/dist/{cli-7w1fs01q.js → cli-g03x26q6.js} +2 -2
  79. package/dist/{cli-879txsac.js → cli-gnkzh8ed.js} +4 -4
  80. package/dist/{cli-v4z5v3jd.js → cli-gy0r7gb8.js} +514 -337
  81. package/dist/{cli-s4pccby1.js → cli-h0edykd1.js} +1 -1
  82. package/dist/{cli-pq0kv31y.js → cli-h364asjc.js} +9 -9
  83. package/dist/{cli-69szn7w7.js → cli-h3xcfp4c.js} +93 -54
  84. package/dist/{cli-jcnc5ret.js → cli-h8k5801a.js} +73 -27
  85. package/dist/{cli-6yy4fepf.js → cli-h96yp7xv.js} +4 -4
  86. package/dist/{cli-q5n3deaf.js → cli-hab0bvrh.js} +1 -1
  87. package/dist/{cli-g6a696c0.js → cli-j3wqt73b.js} +4 -4
  88. package/dist/{cli-wym6rxgt.js → cli-jfgaz10x.js} +10 -15
  89. package/dist/{cli-shyhb4t5.js → cli-jrhvywah.js} +53 -52
  90. package/dist/{cli-qkbevqer.js → cli-jrxt5j0n.js} +3 -3
  91. package/dist/{cli-7b7rxz22.js → cli-jw7n9pct.js} +5 -2
  92. package/dist/{cli-8vbxjzk0.js → cli-k9kfck3s.js} +3 -3
  93. package/dist/{cli-yjb3cddd.js → cli-kkwq5b12.js} +1 -1
  94. package/dist/{cli-39t9d248.js → cli-kz8rar0g.js} +1 -1
  95. package/dist/{cli-rzbsh6bw.js → cli-n15fhd43.js} +1 -1
  96. package/dist/{cli-1jx0srjt.js → cli-nc842kc9.js} +1921 -80
  97. package/dist/{cli-9j1t3kf6.js → cli-nmj4phcg.js} +2 -2
  98. package/dist/{cli-t9pzz2eq.js → cli-ntmjzyte.js} +4 -1
  99. package/dist/{cli-adzmmcvf.js → cli-praaw1wh.js} +2 -2
  100. package/dist/{cli-f9g96z28.js → cli-q44p4869.js} +11 -11
  101. package/dist/{cli-fww016hh.js → cli-q58qt9dw.js} +1711 -7287
  102. package/dist/{cli-njvpngc6.js → cli-qqz5z36e.js} +3 -3
  103. package/dist/{cli-096aftq6.js → cli-r7rpy2xz.js} +7 -7
  104. package/dist/cli-rcqgr0hs.js +30 -0
  105. package/dist/{cli-ph95yejc.js → cli-rjc464jg.js} +2 -2
  106. package/dist/{cli-md4tn21h.js → cli-rw3m83j4.js} +40 -26
  107. package/dist/cli-rwcj6wt3.js +1291 -0
  108. package/dist/{cli-srq69pn1.js → cli-ryn4y478.js} +1 -1
  109. package/dist/{cli-jgq9xptq.js → cli-s48k2rzx.js} +4 -4
  110. package/dist/{cli-cbg0j1yt.js → cli-s90wcbk9.js} +3 -3
  111. package/dist/{cli-2ayk9gn8.js → cli-svcy72s5.js} +2 -2
  112. package/dist/{cli-4dyzzkfb.js → cli-swtwbg85.js} +944 -170
  113. package/dist/{cli-mv8ft7b0.js → cli-t1bqpzgz.js} +3 -3
  114. package/dist/{cli-tc165vrb.js → cli-t5jbjq61.js} +4 -3
  115. package/dist/{cli-enavhq6r.js → cli-tbrjvrrg.js} +1 -1
  116. package/dist/{cli-mz7ycqn8.js → cli-td2h8zej.js} +6 -6
  117. package/dist/{cli-9t7syepg.js → cli-ttatvwn6.js} +1 -1
  118. package/dist/{cli-ayxxkk3p.js → cli-txxcf9s1.js} +8 -8
  119. package/dist/{cli-q4z9s6zs.js → cli-v7az4d1g.js} +2 -2
  120. package/dist/cli-vqt44168.js +14 -0
  121. package/dist/{cli-q457ga28.js → cli-vs9h3vw2.js} +14 -14
  122. package/dist/{cli-snxhtehz.js → cli-w2fg8kjc.js} +7 -8
  123. package/dist/{cli-wd7b5hgc.js → cli-w81s97bn.js} +1 -1
  124. package/dist/{cli-bqfx72e6.js → cli-wkzrknpt.js} +1 -1
  125. package/dist/{cli-cg1q8ymp.js → cli-wqpvfq2m.js} +1 -1
  126. package/dist/{cli-kg63yp1r.js → cli-wz7qj1jy.js} +19 -19
  127. package/dist/{cli-3wsabyt0.js → cli-x5t54ytt.js} +2 -2
  128. package/dist/{cli-r495stwd.js → cli-xd6ntv7x.js} +2 -2
  129. package/dist/{cli-wvbaq052.js → cli-xphbv66z.js} +10 -3
  130. package/dist/{cli-a49frv85.js → cli-xxgqn93n.js} +3753 -1186
  131. package/dist/{cli-91amj3md.js → cli-z209g721.js} +111 -87
  132. package/dist/{cli-3mhdmcd4.js → cli-z5andw8k.js} +1 -1
  133. package/dist/{cli-7g5qj2ca.js → cli-zcb64xzv.js} +1 -1
  134. package/dist/{cli-0h6m6z5g.js → cli-zr2sc5tr.js} +1 -1
  135. package/dist/{cli-krk8y8c7.js → cli-zrm0610v.js} +1833 -518
  136. package/dist/cli.js +73 -73
  137. package/dist/{cloudflare-workers-ai-system-one-w3m0fbf8.js → cloudflare-workers-ai-system-one-kb0tq22h.js} +2 -2
  138. package/dist/{codex-adapter-eq61radw.js → codex-adapter-0c1ynrmt.js} +9 -9
  139. package/dist/{codex-hook-8nmepvz6.js → codex-hook-w5nmtrn2.js} +2 -2
  140. package/dist/{codex-login-vbd9707w.js → codex-login-67qarfcg.js} +1 -1
  141. package/dist/{codex-session-runner-rfx355h4.js → codex-session-runner-z4t9z7yy.js} +10 -10
  142. package/dist/{commands-d1z0sx62.js → commands-h0jxqdhk.js} +3 -3
  143. package/dist/{controller-9hz6d8x3.js → controller-4ygy66hv.js} +4 -4
  144. package/dist/{controllers-connect-tz07d2xr.js → controllers-connect-ynbvv8pv.js} +28 -28
  145. package/dist/core-mj9fzrcm.js +41 -0
  146. package/dist/{cursor-adapter-ef22ze3j.js → cursor-adapter-9e4d6658.js} +2 -2
  147. package/dist/{db-gd81d68c.js → db-bg0hxjq1.js} +3 -3
  148. package/dist/{db-vrckks6q.js → db-q12gmpns.js} +2 -2
  149. package/dist/{devin-adapter-kdt6a2bh.js → devin-adapter-tn1twrha.js} +1 -1
  150. package/dist/{devtools-qxfgbsqz.js → devtools-t8my9az6.js} +1 -1
  151. package/dist/{dispatcher-76as8w2t.js → dispatcher-v5dbfscq.js} +24 -24
  152. package/dist/{docker-51ta7jsh.js → docker-6007r2fj.js} +2 -2
  153. package/dist/{dsh-adapter-ypfvcdyz.js → dsh-adapter-z3fneea1.js} +2 -2
  154. package/dist/{e2b-05kn3kpq.js → e2b-k3kb8b52.js} +4 -4
  155. package/dist/{e2b-dm9r8hpy.js → e2b-p269awh6.js} +5 -5
  156. package/dist/{easter-egg-3d-sg21j15g.js → easter-egg-3d-y49v5z90.js} +1 -1
  157. package/dist/{embedding-space-zsdw37bb.js → embedding-space-mjt5ksq0.js} +5 -5
  158. package/dist/{embeddings-p4e3e1m6.js → embeddings-td9hgnc5.js} +1 -1
  159. package/dist/emscripten-module-Q67P5WYC-3sde6cre.js +2458 -0
  160. package/dist/{event-bus-tvf2grf4.js → event-bus-pawddp92.js} +1 -1
  161. package/dist/{execute-nztd0af0.js → execute-z8nc8bba.js} +1 -1
  162. package/dist/{external-channel-717yzn4d.js → external-channel-pjenc2ag.js} +2 -2
  163. package/dist/ffi-cbfmmtqk.js +85 -0
  164. package/dist/fx-adapter-pjeztp0n.js +20 -0
  165. package/dist/getMachineId-bsd-hjs2tbdp.js +36 -0
  166. package/dist/getMachineId-darwin-kzbvr8s3.js +40 -0
  167. package/dist/getMachineId-linux-embmcq2c.js +26 -0
  168. package/dist/getMachineId-unsupported-jvznc6d4.js +20 -0
  169. package/dist/getMachineId-win-qr8z0b13.js +36 -0
  170. package/dist/{google-generative-ai-sw77egmr.js → google-generative-ai-tf3w7557.js} +11 -16
  171. package/dist/{google-vertex-rrw93g8h.js → google-vertex-9pj87bd8.js} +15 -17
  172. package/dist/grok-adapter-davbhx8t.js +20 -0
  173. package/dist/handlers-rf130hnp.js +39 -0
  174. package/dist/heartbeat-9hmvqxk0.js +49 -0
  175. package/dist/hook-0b1jqs2t.js +21 -0
  176. package/dist/{hook-ctz0xmp3.js → hook-1n0sjv8p.js} +10 -11
  177. package/dist/{http-zregegrx.js → http-vykejyjx.js} +432 -170
  178. package/dist/{index-7dgxveck.js → index-07d66kdm.js} +3 -3
  179. package/dist/index-0hgjxqz8.js +10584 -0
  180. package/dist/{index-rz8ve510.js → index-0nt39qwy.js} +2 -2
  181. package/dist/{index-ym9fgxad.js → index-2xbxq71g.js} +2 -2
  182. package/dist/{index-42jq9yy3.js → index-3j8hffkb.js} +12327 -7450
  183. package/dist/index-8w09aggw.js +43 -0
  184. package/dist/{index-5kx15d19.js → index-b3wy4jzs.js} +1 -1
  185. package/dist/{index-kzdqn3dd.js → index-dt9vr7tb.js} +3143 -760
  186. package/dist/{index-maddg9ys.js → index-ezfas4jj.js} +5858 -15337
  187. package/dist/index-g2jntx15.js +38 -0
  188. package/dist/{index-x9qf8dg7.js → index-j6sqtb83.js} +105 -75
  189. package/dist/{index-m6g8q65g.js → index-na0tczq0.js} +9268 -10220
  190. package/dist/{index-whysn1wf.js → index-p9dkwhwe.js} +1 -1
  191. package/dist/{index-126v2d0t.js → index-pe2etczf.js} +6 -2918
  192. package/dist/{index-mtnbhe12.js → index-q60mhcpd.js} +23631 -19921
  193. package/dist/index-qffex5k4.js +41 -0
  194. package/dist/index-qrp11tp9.js +4 -0
  195. package/dist/{index-kdmkfjt7.js → index-ryyrg0d8.js} +3426 -2333
  196. package/dist/{index-t17p395x.js → index-sf06w57a.js} +13 -13
  197. package/dist/{index-evay0xyk.js → index-vybnwd5v.js} +1 -1
  198. package/dist/{index-fdym6ryb.js → index-wsf1f5pe.js} +28 -28
  199. package/dist/{k8s-ejkk0aw7.js → k8s-mr1r12th.js} +2 -2
  200. package/dist/{keepalive-zdqay870.js → keepalive-86z0tzzf.js} +4 -4
  201. package/dist/lead-edmwagkn.js +81 -0
  202. package/dist/{llama-cpp-classify-yvb8vh7w.js → llama-cpp-classify-wd7htn1x.js} +2 -2
  203. package/dist/{maintenance-t5ndg11m.js → maintenance-19h6tfwz.js} +1 -1
  204. package/dist/{mistral-conversations-w4bncwbt.js → mistral-conversations-txjmc64f.js} +7 -7
  205. package/dist/module-ES6BEMUI-44w9s1dx.js +1210 -0
  206. package/dist/{multipart-parser-xevcstye.js → multipart-parser-xqbgwrav.js} +1 -1
  207. package/dist/{node-0as4n1ef.js → node-q4628t0b.js} +1 -1
  208. package/dist/{oauth-refresh-sweep-y9zyd7t6.js → oauth-refresh-sweep-6nmyrv32.js} +3 -3
  209. package/dist/{object-webhooks-mkca91s0.js → object-webhooks-2kynmdf8.js} +7 -7
  210. package/dist/{onboard-ss995244.js → onboard-zbpm96mn.js} +7 -7
  211. package/dist/{openai-codex-responses-70g39cgz.js → openai-codex-responses-6ckhys6r.js} +35 -29
  212. package/dist/{openai-completions-cv3hp4h5.js → openai-completions-c9dsq9jh.js} +15 -15
  213. package/dist/{openai-decisions-fyq1p9f9.js → openai-decisions-9vzvv10c.js} +2 -2
  214. package/dist/{openai-responses-trsvnks6.js → openai-responses-bhfmt9sa.js} +6 -6
  215. package/dist/{opencode-adapter-mwpz0278.js → opencode-adapter-fyqcbdra.js} +8 -8
  216. package/dist/{openrouter-images-0jj12a2q.js → openrouter-images-hkk5p580.js} +3 -3
  217. package/dist/otel-impl-txa20w1h.js +11178 -0
  218. package/dist/{pending-2sxh1t6j.js → pending-4rxawq8y.js} +25 -25
  219. package/dist/{pi-messages-zk3g4esn.js → pi-messages-py3f96p7.js} +5 -5
  220. package/dist/{pi-mono-adapter-sfb7zy43.js → pi-mono-adapter-rnsed1xa.js} +24 -27
  221. package/dist/{pricing-refresh-h79bg4cf.js → pricing-refresh-4314hwtw.js} +2 -2
  222. package/dist/{rbac-roles-ckq0czp4.js → rbac-roles-fztcm8ky.js} +2 -2
  223. package/dist/{rbac-roles-jg2e260w.js → rbac-roles-msqt7a3k.js} +3 -3
  224. package/dist/{render-v2-ymbshmn0.js → render-v2-w49wtecg.js} +10 -10
  225. package/dist/{resume-jdhnt4jk.js → resume-gwgtp4m3.js} +13 -13
  226. package/dist/{runtime-y28jhhnf.js → runtime-kkebz8yq.js} +1 -1
  227. package/dist/{session-access-k4ta5hvp.js → session-access-kjb19m2w.js} +5 -5
  228. package/dist/{session-source-backfill-528j4s8j.js → session-source-backfill-805p4wqr.js} +3 -3
  229. package/dist/{setup-d6pj82fr.js → setup-q8y168c8.js} +3 -3
  230. package/dist/thread-buffer-yqbffd0t.js +40 -0
  231. package/dist/{token-util-pjgekqxr.js → token-util-hnzceyn9.js} +1 -1
  232. package/dist/{token-pgr2w4s3.js → token-xnc02n6w.js} +21 -14
  233. package/dist/{tree-visibility-kjxv3nxk.js → tree-visibility-qj323994.js} +2 -2
  234. package/dist/{typesafe-system-one-qkvkgrcz.js → typesafe-system-one-avrdb4zm.js} +2 -2
  235. package/dist/{user-merge-jobs-rabbncf6.js → user-merge-jobs-qfp40f2s.js} +3 -3
  236. package/dist/{virtual-modules-22k51txd.js → virtual-modules-nzxegw0a.js} +7 -7
  237. package/dist/{work-objects-xtjbar3r.js → work-objects-hs089w60.js} +26 -26
  238. package/dist/{worker-follow-up-fg48vk6d.js → worker-follow-up-zwgg20sr.js} +24 -24
  239. package/dist/worker-kg4g7rnx.js +81 -0
  240. package/dist/{x-vfsqypht.js → x-k29vmskt.js} +2 -2
  241. package/openapi.json +59 -3
  242. package/package.json +53 -52
  243. package/plugin/commands/create-pr.md +5 -2
  244. package/plugin/pi-skills/create-pr/SKILL.md +5 -2
  245. package/src/apps/sync.ts +7 -2
  246. package/src/be/db/model-profiles.ts +103 -12
  247. package/src/be/db/tasks/read.ts +5 -0
  248. package/src/be/db/workflow-runs.ts +12 -8
  249. package/src/be/db.ts +18 -5
  250. package/src/be/migrations/367_workflow_run_principal.sql +5 -0
  251. package/src/be/model-group-resolution.ts +134 -0
  252. package/src/be/model-tier-resolution.ts +120 -17
  253. package/src/be/model-validation.ts +9 -1
  254. package/src/be/runtime-pools/routing.ts +22 -8
  255. package/src/be/scripts/extract-schema.ts +7 -0
  256. package/src/be/swarm-config-guard.ts +20 -7
  257. package/src/be/task-auto-title-listener.ts +2 -2
  258. package/src/commands/onboard/agent-fs-version.ts +1 -1
  259. package/src/extensions/contract-types.generated.ts +1 -1
  260. package/src/extensions/post-bridge.ts +27 -28
  261. package/src/http/active-sessions.ts +7 -0
  262. package/src/http/agents.ts +7 -0
  263. package/src/http/api-keys.ts +7 -0
  264. package/src/http/approval-requests.ts +4 -0
  265. package/src/http/budgets.ts +2 -0
  266. package/src/http/codex-oauth-keep-warm.ts +6 -2
  267. package/src/http/config.ts +1 -0
  268. package/src/http/context.ts +4 -0
  269. package/src/http/db-query.ts +11 -2
  270. package/src/http/events.ts +2 -0
  271. package/src/http/fs.ts +1 -0
  272. package/src/http/integrations.ts +4 -0
  273. package/src/http/mcp-bridge.ts +1 -0
  274. package/src/http/memory.ts +3 -0
  275. package/src/http/metrics.ts +16 -0
  276. package/src/http/oauth-locks.ts +8 -0
  277. package/src/http/operator-actor.ts +3 -8
  278. package/src/http/page-proxy.ts +16 -0
  279. package/src/http/pages.ts +9 -0
  280. package/src/http/poll.ts +21 -1
  281. package/src/http/pricing.ts +2 -0
  282. package/src/http/prompt-templates.ts +34 -0
  283. package/src/http/repos.ts +3 -1
  284. package/src/http/schedules.ts +33 -3
  285. package/src/http/script-runs.ts +24 -0
  286. package/src/http/scripts.ts +1 -0
  287. package/src/http/session-data.ts +2 -0
  288. package/src/http/status.ts +1 -0
  289. package/src/http/tasks.ts +28 -1
  290. package/src/http/trackers/jira.ts +2 -0
  291. package/src/http/trackers/linear.ts +4 -0
  292. package/src/http/users.ts +18 -0
  293. package/src/http/webhooks.ts +12 -0
  294. package/src/http/workflow-events.ts +26 -6
  295. package/src/http/workflows.ts +40 -0
  296. package/src/http/x.ts +4 -0
  297. package/src/linear/app.ts +3 -2
  298. package/src/linear/client.ts +5 -1
  299. package/src/linear/host.ts +40 -0
  300. package/src/linear/oauth.ts +3 -2
  301. package/src/linear/sync.ts +4 -3
  302. package/src/otel-impl.ts +8 -5
  303. package/src/prompts/base-prompt.ts +10 -6
  304. package/src/prompts/session-templates.ts +3 -3
  305. package/src/providers/acp-targets.ts +1 -1
  306. package/src/providers/amp-adapter.ts +11 -9
  307. package/src/providers/cursor-adapter.ts +1 -1
  308. package/src/rbac/legacy-policy.ts +2 -0
  309. package/src/rbac/permissions.ts +5 -0
  310. package/src/realtime/browser.generated.txt +1 -1
  311. package/src/scheduler/schedule-task.ts +1 -0
  312. package/src/scripts-runtime/quickjs-compat.ts +44 -10
  313. package/src/scripts-runtime/types/swarm-extension.d.ts +2 -0
  314. package/src/slack/config.ts +4 -0
  315. package/src/slack/render-v2.ts +52 -24
  316. package/src/slack/responses.ts +2 -1
  317. package/src/slack/reviewed-deliverables.ts +251 -0
  318. package/src/tasks/follow-up-gate.ts +142 -38
  319. package/src/tasks/worker-follow-up.ts +126 -37
  320. package/src/tests/amp-adapter.test.ts +57 -9
  321. package/src/tests/base-prompt.test.ts +36 -2
  322. package/src/tests/check-pr-body.test.ts +408 -93
  323. package/src/tests/compose-dev-object-store.test.ts +13 -0
  324. package/src/tests/compose-example-object-store.test.ts +67 -0
  325. package/src/tests/db-query.test.ts +8 -4
  326. package/src/tests/db-retention-defaults.test.ts +28 -3
  327. package/src/tests/e2b-dispatch.test.ts +7 -1
  328. package/src/tests/entrypoint-repo-autoclone-args.test.ts +10 -0
  329. package/src/tests/follow-up-gate-shadow.test.ts +268 -10
  330. package/src/tests/linear-outbound-sync.test.ts +59 -25
  331. package/src/tests/operator-actor-keyless.test.ts +103 -0
  332. package/src/tests/otel-event-loop-and-logs.test.ts +1 -1
  333. package/src/tests/profile-tier-alias.test.ts +9 -3
  334. package/src/tests/quickjs-compat.test.ts +40 -4
  335. package/src/tests/rbac-route-verbs-e2e.test.ts +142 -0
  336. package/src/tests/runner-repo-clone-args.test.ts +15 -6
  337. package/src/tests/script-connections.test.ts +2 -0
  338. package/src/tests/slack-render-v2.test.ts +52 -8
  339. package/src/tests/workflow-definition-pinning.test.ts +2 -0
  340. package/src/tests/workflow-hitl-routing.test.ts +67 -5
  341. package/src/tests/workflow-replay.test.ts +13 -1
  342. package/src/tests/workflow-system-one-extraction.test.ts +21 -0
  343. package/src/tests/workflow-wait-filter.test.ts +7 -7
  344. package/src/tests/worktree-reaper.test.ts +15 -4
  345. package/src/tests/x402-client.test.ts +82 -0
  346. package/src/tools/memory-rate.ts +2 -2
  347. package/src/tools/prompt-templates/delete.ts +22 -1
  348. package/src/tools/prompt-templates/set.ts +15 -1
  349. package/src/tools/schedules/create-schedule.ts +20 -3
  350. package/src/tools/schedules/patch-schedule.ts +30 -4
  351. package/src/tools/schedules/update-schedule.ts +30 -4
  352. package/src/tools/send-task.ts +17 -3
  353. package/src/tools/slack-post.ts +7 -2
  354. package/src/tools/slack-reply.ts +6 -2
  355. package/src/tools/task-action.ts +16 -3
  356. package/src/tools/utils.ts +1 -1
  357. package/src/types.ts +10 -0
  358. package/src/utils/amp-models.ts +20 -4
  359. package/src/utils/constants.ts +5 -4
  360. package/src/utils/secret-scrubber.ts +6 -4
  361. package/src/utils/task-citations.ts +11 -0
  362. package/src/workflows/engine.ts +41 -8
  363. package/src/workflows/executors/agent-task.ts +13 -2
  364. package/src/workflows/executors/code-match.ts +11 -31
  365. package/src/workflows/executors/script.ts +13 -0
  366. package/src/workflows/executors/sub-workflow.ts +5 -7
  367. package/src/workflows/executors/swarm-script.ts +4 -5
  368. package/src/workflows/executors/system-one-extraction.ts +9 -6
  369. package/src/workflows/executors/wait.ts +1 -1
  370. package/src/workflows/foreach-driver.ts +5 -1
  371. package/src/workflows/model-validation.ts +13 -1
  372. package/src/workflows/predicate-sandbox.ts +171 -0
  373. package/src/workflows/resume.ts +21 -4
  374. package/src/workflows/retry-poller.ts +1 -1
  375. package/src/workflows/run-principal.ts +51 -0
  376. package/src/workflows/wait-filter.ts +14 -192
  377. package/src/x402/client.ts +38 -17
  378. package/templates/skills/code-quality/content.md +1 -1
  379. package/templates/skills/heartbeat-runbook/content.md +1 -0
  380. package/templates/skills/pages/content.md +36 -12
  381. package/templates/skills/slack-interaction/content.md +4 -0
  382. package/templates/skills/swarm-docs/content.md +47 -41
  383. package/templates/skills/swarm-scripts/SKILL.md +1 -1
  384. package/templates/skills/swarm-scripts/content.md +1 -1
  385. package/dist/acp-adapter-99n6z9ky.js +0 -17
  386. package/dist/cli-5ss6qqt9.js +0 -45
  387. package/dist/cli-dzzh58sy.js +0 -6996
  388. package/dist/cli-e8trbfx1.js +0 -15
  389. package/dist/cli-j9ccfveb.js +0 -1849
  390. package/dist/cli-mna6pmfx.js +0 -1485
  391. package/dist/cli-r8ddn0hf.js +0 -25583
  392. package/dist/core-dynsv289.js +0 -41
  393. package/dist/fx-adapter-9k0hptnz.js +0 -20
  394. package/dist/getMachineId-bsd-637a7rbk.js +0 -36
  395. package/dist/getMachineId-darwin-9vytrcnn.js +0 -36
  396. package/dist/getMachineId-linux-mkzsvyyz.js +0 -29
  397. package/dist/getMachineId-unsupported-4cfs2n11.js +0 -19
  398. package/dist/getMachineId-win-154s3qma.js +0 -38
  399. package/dist/grok-adapter-skdj2pce.js +0 -20
  400. package/dist/handlers-5btjqkz6.js +0 -39
  401. package/dist/heartbeat-vfb1gy84.js +0 -49
  402. package/dist/hook-eh52p7yd.js +0 -22
  403. package/dist/index-7w8p6em0.js +0 -41
  404. package/dist/index-t56y945n.js +0 -4
  405. package/dist/index-vfemrwwk.js +0 -10002
  406. package/dist/index-vz4semsx.js +0 -38
  407. package/dist/index-y3s0xp2v.js +0 -43
  408. package/dist/lead-6cscw8a5.js +0 -82
  409. package/dist/otel-impl-6n6vva3x.js +0 -28205
  410. package/dist/thread-buffer-9w6x5zec.js +0 -40
  411. package/dist/worker-g4aj93dt.js +0 -82
@@ -8,10 +8,15 @@
8
8
  * Precedence (first hit wins):
9
9
  * 1. task `model` → modelSource "model"
10
10
  * 2. task `profile` → "profile:task"
11
+ * 2b. task `modelGroup` → "profile:group": the group's first member that
12
+ * runs on the claiming agent (`resolveGroupForAgent`); none is a hard stop
11
13
  * 3. the claiming worker's MODEL_TIER_* → "worker-env" (agents.modelTierOverrides)
12
14
  * 4. swarm_config MODEL_TIER_<PROV>_<TIER> → "tier-config"
13
- * 5. DEFAULT_MODEL_TIER_MAP → "tier-default", or "profile:tier-alias" when the
14
- * seeded `<harness>-<tier>` profile exists (its model, same as the map unless edited).
15
+ * 5. DEFAULT_MODEL_TIER_MAP → "tier-default", or "profile:group" when the
16
+ * model group named after the tier has a member that runs on the agent (an untouched
17
+ * seed, which lists only `<harness>-<tier>` there, stays "profile:tier-alias"), else
18
+ * "profile:tier-alias" when the seeded `<harness>-<tier>` profile exists (its model,
19
+ * same as the map unless edited).
15
20
  * A worker-env or tier-config win logs a deprecation line: edit the profile instead.
16
21
  * 6. the agent's default profile → "profile:agent-default" (no model, no tier,
17
22
  * no repo-scoped MODEL_OVERRIDE on the task's repo)
@@ -53,7 +58,7 @@ import {
53
58
  parseModelTier,
54
59
  type ReasoningEffort,
55
60
  } from "../types";
56
- import { getDbClient } from "./db";
61
+ import { createLogEntry, getDbClient } from "./db";
57
62
  import {
58
63
  getAgentDefaultProfileName,
59
64
  getModelProfileByName,
@@ -76,6 +81,12 @@ import {
76
81
  type ModelCatalogEntry,
77
82
  type ModelCatalogFacts,
78
83
  } from "./model-catalog-store";
84
+ import {
85
+ formatGroupSkips,
86
+ type GroupMemberSkip,
87
+ groupUnavailableMessage,
88
+ resolveGroupForAgent,
89
+ } from "./model-group-resolution";
79
90
  import { tierConfigKey } from "./model-tier-keys";
80
91
  import { loadModelsDevCache } from "./modelsdev-cache";
81
92
 
@@ -90,7 +101,8 @@ export type ModelSource =
90
101
  | "fallback:cli-unsupported:model"
91
102
  | "profile:task"
92
103
  | "profile:agent-default"
93
- | "profile:tier-alias";
104
+ | "profile:tier-alias"
105
+ | "profile:group";
94
106
 
95
107
  export interface TaskModelResolution {
96
108
  resolvedModel: string;
@@ -563,15 +575,16 @@ type ClaimProfile = {
563
575
  /**
564
576
  * Resolve a model profile for a claim. Null when the profile does not apply:
565
577
  * an agent default or tier alias that is missing, on another harness, or
566
- * unresolved falls through to the tier chain. For a task's own `profile` each
567
- * is a hard stop. An unreadable credential allowlist is a hard stop for all.
578
+ * unresolved falls through to the tier chain. For a task's own `profile` or
579
+ * group member each is a hard stop. An unreadable credential allowlist is a
580
+ * hard stop for all.
568
581
  */
569
582
  async function resolveClaimProfile(
570
583
  name: string,
571
- source: "profile:task" | "profile:agent-default" | "profile:tier-alias",
584
+ source: "profile:task" | "profile:agent-default" | "profile:tier-alias" | "profile:group",
572
585
  harness: ProviderName | null,
573
586
  ): Promise<ClaimProfile | { modelUnsupported: string } | null> {
574
- const isTask = source === "profile:task";
587
+ const isTask = source === "profile:task" || source === "profile:group";
575
588
  const profile = await getModelProfileByName(name);
576
589
  if (!profile) {
577
590
  return isTask
@@ -625,20 +638,51 @@ async function resolveClaimProfile(
625
638
  */
626
639
  async function resolveTierAlias(
627
640
  resolved: TaskModelResolution | TaskModelHarnessMismatch | null,
628
- task: { modelTier?: string | null },
641
+ task: { id: string; modelTier?: string | null; vcsRepo?: string | null },
642
+ agentId: string,
629
643
  harness: ProviderName | null,
644
+ includeRepoSecrets: boolean,
630
645
  ): Promise<ClaimProfile | { modelUnsupported: string } | null> {
631
646
  const tier = parseModelTier(task.modelTier);
632
647
  if (!resolved || "harnessMismatch" in resolved || !tier || !harness) return null;
633
- const name = `${harness}-${tier}`;
648
+ const seeded = `${harness}-${tier}`;
634
649
  if (resolved.modelSource === "worker-env" || resolved.modelSource === "tier-config") {
635
650
  console.log(
636
- `[model-tier] deprecated: ${resolved.modelSource} override for ${name}; edit profile ${name} instead`,
651
+ `[model-tier] deprecated: ${resolved.modelSource} override for ${seeded}; edit profile ${seeded} instead`,
637
652
  );
638
653
  return null;
639
654
  }
640
655
  if (resolved.modelSource !== "tier-default") return null;
641
- const picked = await resolveClaimProfile(name, "profile:tier-alias", harness);
656
+ // The group named after the tier decides first. No member that runs here
657
+ // falls back to the seeded profile, so a tier task never hard-fails where it
658
+ // ran before the group existed.
659
+ const group = await resolveGroupForAgent(tier, agentId, {
660
+ vcsRepo: task.vcsRepo,
661
+ includeRepoSecrets,
662
+ });
663
+ let name = seeded;
664
+ let picked: ClaimProfile | { modelUnsupported: string } | null = null;
665
+ if (group.kind === "resolved") {
666
+ picked = await resolveClaimProfile(group.member, "profile:tier-alias", harness);
667
+ if (picked && "profile" in picked) {
668
+ name = group.member;
669
+ // An untouched seed lists only the seeded profile on this harness: it
670
+ // stays a tier alias, so its hops keep walking the profile's fallbacks.
671
+ // Anything else is a group resolution, recorded as `profile:group` so a
672
+ // provider-error hop walks the group order (`fallbackGroupOf`).
673
+ const untouched = group.onHarness.length === 1 && group.onHarness[0] === seeded;
674
+ if (!untouched) {
675
+ picked = { ...picked, resolution: { ...picked.resolution, modelSource: "profile:group" } };
676
+ }
677
+ if (group.member !== seeded) {
678
+ await logGroupResolution(task.id, agentId, tier, group.member, group.skipped);
679
+ }
680
+ }
681
+ }
682
+ if (!picked || !("profile" in picked)) {
683
+ picked = await resolveClaimProfile(seeded, "profile:tier-alias", harness);
684
+ name = seeded;
685
+ }
642
686
  if (!picked || !("profile" in picked)) return picked;
643
687
  // A seed copied from a stale MODEL_TIER_* row can name another harness's model.
644
688
  // The tier chain skipped that value, so the alias skips it too.
@@ -658,6 +702,53 @@ async function resolveTierAlias(
658
702
  return picked;
659
703
  }
660
704
 
705
+ async function logGroupResolution(
706
+ taskId: string,
707
+ agentId: string,
708
+ group: string,
709
+ member: string,
710
+ skipped: GroupMemberSkip[],
711
+ ): Promise<void> {
712
+ await createLogEntry({
713
+ eventType: "task_model_group_resolved",
714
+ taskId,
715
+ agentId,
716
+ newValue: member,
717
+ metadata: { group, member, skipped },
718
+ });
719
+ }
720
+
721
+ /**
722
+ * A task's own `modelGroup` at claim: the first member that runs on the agent,
723
+ * then that member as a profile. A missing group or no passing member is a
724
+ * hard stop, as for a task's own profile.
725
+ */
726
+ async function resolveClaimGroup(
727
+ group: string,
728
+ task: { id: string; vcsRepo?: string | null },
729
+ agentId: string,
730
+ harness: ProviderName | null,
731
+ includeRepoSecrets: boolean,
732
+ ): Promise<ClaimProfile | { modelUnsupported: string } | null> {
733
+ const resolution = await resolveGroupForAgent(group, agentId, {
734
+ vcsRepo: task.vcsRepo,
735
+ includeRepoSecrets,
736
+ });
737
+ if (resolution.kind === "missing") {
738
+ return { modelUnsupported: `[model-group-missing] Model group "${group}" no longer exists.` };
739
+ }
740
+ if (resolution.kind === "none") {
741
+ return { modelUnsupported: groupUnavailableMessage(group, harness, resolution.skipped) };
742
+ }
743
+ if (resolution.skipped.length > 0) {
744
+ console.log(
745
+ `[model-group] task ${task.id}: ${group} → ${resolution.member} (skipped: ${formatGroupSkips(resolution.skipped)})`,
746
+ );
747
+ }
748
+ await logGroupResolution(task.id, agentId, group, resolution.member, resolution.skipped);
749
+ return await resolveClaimProfile(resolution.member, "profile:group", harness);
750
+ }
751
+
661
752
  /**
662
753
  * Resolve and record the model for a task the given agent is claiming. Runs
663
754
  * inside the claim transaction. Returns the fields to merge into the trigger.
@@ -670,6 +761,7 @@ export async function recordClaimModelResolution(
670
761
  model?: string | null;
671
762
  modelTier?: string | null;
672
763
  profile?: string | null;
764
+ modelGroup?: string | null;
673
765
  effort?: string | null;
674
766
  vcsRepo?: string | null;
675
767
  },
@@ -684,9 +776,12 @@ export async function recordClaimModelResolution(
684
776
  const harnessProvider = agent.harnessProvider ?? agent.provider ?? null;
685
777
 
686
778
  if (!task.model?.trim()) {
779
+ // A fallback hop's resume sets `profile` to the member it picked and keeps
780
+ // `modelGroup`; the profile wins (create-time exclusivity binds creators only).
687
781
  const taskProfile = task.profile?.trim();
782
+ const taskGroup = taskProfile ? undefined : task.modelGroup?.trim();
688
783
  const agentDefault =
689
- taskProfile || parseModelTier(task.modelTier)
784
+ taskProfile || taskGroup || parseModelTier(task.modelTier)
690
785
  ? null
691
786
  : await getAgentDefaultProfileName(agent.id);
692
787
  // The agent default is agent-scoped config: a repo-scoped MODEL_OVERRIDE or
@@ -699,9 +794,11 @@ export async function recordClaimModelResolution(
699
794
  const defaultProfile = repoKeys.has("MODEL_OVERRIDE") ? null : agentDefault;
700
795
  const picked = taskProfile
701
796
  ? await resolveClaimProfile(taskProfile, "profile:task", harnessProvider)
702
- : defaultProfile
703
- ? await resolveClaimProfile(defaultProfile, "profile:agent-default", harnessProvider)
704
- : null;
797
+ : taskGroup
798
+ ? await resolveClaimGroup(taskGroup, task, agent.id, harnessProvider, includeRepoSecrets)
799
+ : defaultProfile
800
+ ? await resolveClaimProfile(defaultProfile, "profile:agent-default", harnessProvider)
801
+ : null;
705
802
  if (picked && "modelUnsupported" in picked)
706
803
  return { modelUnsupported: picked.modelUnsupported };
707
804
  if (picked) {
@@ -743,7 +840,13 @@ export async function recordClaimModelResolution(
743
840
  harnessProvider,
744
841
  workerOverrides: await getAgentModelTierOverrides(agent.id),
745
842
  });
746
- const alias = await resolveTierAlias(resolvedTier, task, harnessProvider);
843
+ const alias = await resolveTierAlias(
844
+ resolvedTier,
845
+ task,
846
+ agent.id,
847
+ harnessProvider,
848
+ includeRepoSecrets,
849
+ );
747
850
  if (alias && "modelUnsupported" in alias) return { modelUnsupported: alias.modelUnsupported };
748
851
  if (alias) {
749
852
  const checked = await applyCliSupport(
@@ -37,6 +37,7 @@ import { ampModelError, ampPinCatalogError, ampPinProviderError } from "../utils
37
37
  import { getAgentById, getAllAgents } from "./db";
38
38
  import { getModelProfileByName } from "./db/model-profiles";
39
39
  import { loadModelsCatalog } from "./model-catalog-store";
40
+ import { groupHasMemberOnHarness } from "./model-group-resolution";
40
41
  import { resolveLatestAlias } from "./model-tier-resolution";
41
42
 
42
43
  /** Harnesses whose model ids the catalog does not describe. */
@@ -118,7 +119,10 @@ export async function harnessModelErrorFor(
118
119
  * stays sync and catalog-free; this runs next to it.
119
120
  */
120
121
  export async function poolTaskRunsOnHarness(
121
- task: (TaskModelPinFields & { profile?: string | null }) | null | undefined,
122
+ task:
123
+ | (TaskModelPinFields & { profile?: string | null; modelGroup?: string | null })
124
+ | null
125
+ | undefined,
122
126
  harness: string | null | undefined,
123
127
  ): Promise<boolean> {
124
128
  // A task's model profile runs on one harness only; other workers leave it in the pool.
@@ -127,6 +131,10 @@ export async function poolTaskRunsOnHarness(
127
131
  const profile = await getModelProfileByName(profileName);
128
132
  return !profile || !harness || profile.harness === harness;
129
133
  }
134
+ // A model group runs on the harnesses its members run on. A tier task keeps
135
+ // running anywhere: its tier chain covers harnesses its group does not.
136
+ const groupName = task?.modelGroup?.trim();
137
+ if (groupName) return await groupHasMemberOnHarness(groupName, harness);
130
138
  // Only the task's own pin restricts harnesses; a model a previous run
131
139
  // reported into `model` does not.
132
140
  const model = taskModelPin(task ?? {})?.trim();
@@ -17,6 +17,7 @@ import {
17
17
  releaseTask,
18
18
  } from "../db";
19
19
  import { type AgentTaskRow, rowToAgentTask } from "../db/tasks/read";
20
+ import { resolveGroupForAgent } from "../model-group-resolution";
20
21
  import { checkProfileForAgent, runtimeReadsRepoSecrets } from "../model-profile-check";
21
22
  import { poolTaskRunsOnHarness } from "../model-validation";
22
23
  import {
@@ -194,22 +195,35 @@ export async function routePoolTasks(
194
195
  task: AgentTask,
195
196
  viaWake: boolean,
196
197
  ): Promise<boolean> => {
197
- if (!task.profile) return true;
198
+ // A model group task waits for an agent with a member that passes; a hop's
199
+ // resume names its member as `profile`, which wins.
200
+ const profile = task.profile;
201
+ const group = profile ? undefined : task.modelGroup;
202
+ if (!profile && !group) return true;
198
203
  for (const includeRepoSecrets of secretViews(agent, viaWake)) {
199
204
  const memoKey = JSON.stringify([
200
205
  agent.id,
201
- task.profile,
206
+ profile ? "profile" : "group",
207
+ profile ?? group,
202
208
  task.vcsRepo ?? null,
203
209
  includeRepoSecrets,
204
210
  ]);
205
211
  let ok = profileOk.get(memoKey);
206
212
  if (ok === undefined) {
207
- const result = await checkProfileForAgent(agent.id, task.profile, {
208
- vcsRepo: task.vcsRepo,
209
- includeRepoSecrets,
210
- fallbacks: false,
211
- });
212
- ok = result?.ok !== false;
213
+ if (profile) {
214
+ const result = await checkProfileForAgent(agent.id, profile, {
215
+ vcsRepo: task.vcsRepo,
216
+ includeRepoSecrets,
217
+ fallbacks: false,
218
+ });
219
+ ok = result?.ok !== false;
220
+ } else {
221
+ const resolution = await resolveGroupForAgent(group as string, agent.id, {
222
+ vcsRepo: task.vcsRepo,
223
+ includeRepoSecrets,
224
+ });
225
+ ok = resolution.kind !== "none";
226
+ }
213
227
  profileOk.set(memoKey, ok);
214
228
  }
215
229
  if (!ok) return false;
@@ -10,6 +10,7 @@
10
10
  import { chown } from "node:fs/promises";
11
11
  import { fileURLToPath } from "node:url";
12
12
  import { readRunDirFile } from "../../scripts-runtime/executors/native";
13
+ import { getDeploymentScriptExecutorName } from "../../scripts-runtime/executors/registry";
13
14
  import {
14
15
  buildSandboxedCommand,
15
16
  DEFAULT_SANDBOX_LIMITS,
@@ -26,6 +27,12 @@ function extractorPath(): string {
26
27
  }
27
28
 
28
29
  export async function extractArgsJsonSchema(source: string): Promise<string | null> {
30
+ // The extractor evaluates the module in native Bun. A deployment pinned to
31
+ // quickjs must not run script code natively, so no schema is extracted there;
32
+ // the quickjs runner still validates args against `argsSchema` at run time.
33
+ // shortcut: no argsJsonSchema under SCRIPT_EXECUTOR=quickjs; extract inside quickjs to restore it.
34
+ if (getDeploymentScriptExecutorName() === "quickjs") return null;
35
+
29
36
  const tmpdir = `${process.env.TMPDIR ?? "/tmp"}/schema-extract-${crypto.randomUUID()}`;
30
37
 
31
38
  try {
@@ -82,6 +82,9 @@ const RESERVED_KEYS = new Set([
82
82
  // tokens, so only the deployment env may redirect it.
83
83
  "GITHUB_URL",
84
84
  "GITHUB_API_URL",
85
+ // Linear host (E2E emulator): the API base receives the OAuth client secret and tokens.
86
+ "LINEAR_URL",
87
+ "LINEAR_API_URL",
85
88
  // Picks which App installation workers get tokens for; a config writer must not choose it.
86
89
  "GITHUB_APP_INSTALLATION_ID",
87
90
  // Owners whose repos get a token for their own installation; same reason.
@@ -109,6 +112,9 @@ const API_PROCESS_CONTROL_ENV_KEYS = new Set([
109
112
  "BUN_OPTIONS",
110
113
  "GCONV_PATH",
111
114
  "GLIBC_TUNABLES",
115
+ // Names the executable the API runs for its own `claude -p` calls
116
+ // (`defaultSpawnClaudeCli`). Workers read it from their config overlay.
117
+ "CLAUDE_BINARY",
112
118
  ]);
113
119
  const API_PROCESS_CONTROL_ENV_PREFIXES = ["LD_", "DYLD_", "BASH_", "BUN_INSPECT"];
114
120
 
@@ -326,6 +332,16 @@ function booleanValidators(keys: string[]): Record<string, ConfigValidator> {
326
332
  }
327
333
 
328
334
  /** Build a single `{ KEY: validator }` entry restricted to `options`. */
335
+ function scheduleIdsValidator(key: string): Record<string, ConfigValidator> {
336
+ const message = `Invalid ${key} (must be comma-separated schedule UUIDs)`;
337
+ return {
338
+ [key]: (value: unknown) => {
339
+ if (typeof value !== "string") return message;
340
+ return parseFollowUpGateScheduleIds(value).every(isFollowUpGateScheduleId) ? null : message;
341
+ },
342
+ };
343
+ }
344
+
329
345
  function enumValidator(key: string, options: string[]): Record<string, ConfigValidator> {
330
346
  const listed = options.filter(Boolean).join(", ");
331
347
  const message = `Invalid ${key} value (must be one of: ${listed}${options.includes("") ? ", or empty" : ""})`;
@@ -639,13 +655,9 @@ const VALIDATED_KEYS: Record<string, ConfigValidator> = {
639
655
  ...enumValidator("MODEL_WINDOW_EXHAUSTED_POLICY", ["fail", "fallback"]),
640
656
  ...enumValidator("CREDENTIAL_SELECTION_STRATEGY", [...CREDENTIAL_SELECTION_STRATEGIES]),
641
657
  ...enumValidator("HEARTBEAT_CHECKLIST_GATE_MODE", ["shadow", "enforce"]),
642
- // `enforce` is deliberately absent: the follow-up gate only records decisions.
643
- ...enumValidator("FOLLOW_UP_GATE_MODE", ["off", "shadow"]),
644
- FOLLOW_UP_GATE_SCHEDULE_IDS: (value: unknown) => {
645
- const message = "Invalid FOLLOW_UP_GATE_SCHEDULE_IDS (must be comma-separated schedule UUIDs)";
646
- if (typeof value !== "string") return message;
647
- return parseFollowUpGateScheduleIds(value).every(isFollowUpGateScheduleId) ? null : message;
648
- },
658
+ ...enumValidator("FOLLOW_UP_GATE_MODE", ["off", "shadow", "enforce"]),
659
+ ...scheduleIdsValidator("FOLLOW_UP_GATE_SCHEDULE_IDS"),
660
+ ...scheduleIdsValidator("FOLLOW_UP_GATE_ENFORCE_SCHEDULE_IDS"),
649
661
  ...enumValidator("SYSTEM_ONE_DEFAULT_PROVIDER", [...SYSTEM_ONE_DEFAULT_PROVIDER_OPTIONS]),
650
662
  ...enumValidator("SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER", [
651
663
  ...SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_OPTIONS,
@@ -718,6 +730,7 @@ const VALIDATED_KEYS: Record<string, ConfigValidator> = {
718
730
  "CHAT_SDK_ENABLED",
719
731
  "SLACK_RENDER_V2",
720
732
  "SLACK_RENDER_V2_TASK_TREE_ENABLED",
733
+ "SLACK_REPLY_FOOTER_ENABLED",
721
734
  "SLACK_RENDER_V2_DELEGATION",
722
735
  "SLACK_BLOCK_EXTERNAL_CHANNELS",
723
736
  "GITHUB_DISABLE",
@@ -12,7 +12,7 @@
12
12
  */
13
13
 
14
14
  import { getApiKey } from "../utils/api-key";
15
- import { getMcpBaseUrl } from "../utils/constants";
15
+ import { getScriptApiBaseUrl } from "../utils/constants";
16
16
  import { parseEnvFlag } from "../utils/env-flag";
17
17
  import { generateTaskTitle, TASK_TITLE_TIMEOUT_MS } from "../utils/internal-ai/task-title";
18
18
  import { scrubSecrets } from "../utils/secret-scrubber";
@@ -103,7 +103,7 @@ async function titleTask(
103
103
  task: task.task,
104
104
  env,
105
105
  // Loopback context for the codex OAuth probe; only used when no API key is set.
106
- apiUrl: getMcpBaseUrl(),
106
+ apiUrl: getScriptApiBaseUrl(),
107
107
  apiKey: getApiKey(),
108
108
  callerTag: `task-title:${task.source}`,
109
109
  signal: AbortSignal.timeout(TASK_TITLE_TIMEOUT_MS),
@@ -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.34";
5
+ export const AGENT_FS_VERSION = "0.18.37";
@@ -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';