@desplega.ai/agent-swarm 2.9.1 → 2.11.0

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 (502) hide show
  1. package/dist/acp-adapter-weaaxey3.js +16 -0
  2. package/dist/{acp-targets-ny75x1qy.js → acp-targets-5wyy2b9m.js} +9 -9
  3. package/dist/{actions-b9qgrmeq.js → actions-4nxq386s.js} +54 -32
  4. package/dist/{agent-fs-provision-b5dhdsbd.js → agent-fs-provision-v6enh76w.js} +4 -4
  5. package/dist/{amp-adapter-vtax2c9s.js → amp-adapter-ze3x22qn.js} +3 -3
  6. package/dist/{anthropic-messages-r5xf5hqw.js → anthropic-messages-88b7s3n9.js} +189 -37
  7. package/dist/{app-g2z15hax.js → app-kyqt8ehw.js} +7 -6
  8. package/dist/{approval-notifications-yt13wp8r.js → approval-notifications-a0db0esw.js} +7 -6
  9. package/dist/{assistant-2cgfxsgk.js → assistant-9g5jzq25.js} +26 -25
  10. package/dist/{azure-openai-responses-590s1eea.js → azure-openai-responses-jeaas6x0.js} +18 -18
  11. package/dist/{boot-args-schema-3gwy0f60.js → boot-args-schema-d7fme4q1.js} +1 -1
  12. package/dist/{boot-reembed-92g7s5zp.js → boot-reembed-6wpazmpw.js} +1 -1
  13. package/dist/{boot-reembed-mywmyp4s.js → boot-reembed-jrwxeye2.js} +1 -1
  14. package/dist/boot-scrub-sweep-52h7yntp.js +9 -0
  15. package/dist/{boot-seeds-ce7rvgq1.js → boot-seeds-kb3dxjex.js} +4 -4
  16. package/dist/{boxd-wn235q80.js → boxd-jrrmkv3w.js} +2 -2
  17. package/dist/{claude-adapter-3m4q7735.js → claude-adapter-0c0y8fqp.js} +8 -8
  18. package/dist/{claude-managed-adapter-t8nfgcgz.js → claude-managed-adapter-w2es07qq.js} +4 -4
  19. package/dist/{claude-managed-setup-c217draw.js → claude-managed-setup-9ssb7ct4.js} +4 -4
  20. package/dist/{claude-sdk-session-7fbqm51z.js → claude-sdk-session-p6t0gyse.js} +10941 -10412
  21. package/dist/{cli-2czxfnvj.js → cli-075ccjh6.js} +961 -178
  22. package/dist/{cli-fkef327x.js → cli-0bgj4rh5.js} +3 -3
  23. package/dist/{cli-1jykg0py.js → cli-14xdms9a.js} +41 -28
  24. package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
  25. package/dist/{cli-bkjdknnp.js → cli-1h4njv9y.js} +177 -7
  26. package/dist/{cli-6ym4jhzp.js → cli-27fat7st.js} +7 -7
  27. package/dist/{cli-kxx4k2jw.js → cli-2aacfdcn.js} +5 -5
  28. package/dist/{cli-fh97xn30.js → cli-2gvdvsxj.js} +3 -3
  29. package/dist/{cli-f9gz2vyj.js → cli-2jtfm8kh.js} +10 -10
  30. package/dist/{cli-6ehs4mta.js → cli-2z2c4k6q.js} +18 -4
  31. package/dist/{cli-6237rnyr.js → cli-3bpr3wks.js} +1 -1
  32. package/dist/{cli-bnqncekd.js → cli-453497a0.js} +44 -17
  33. package/dist/{cli-jm0hvmz2.js → cli-4aswccje.js} +2 -2
  34. package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
  35. package/dist/{cli-vyff45ve.js → cli-4g323fjh.js} +772 -515
  36. package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
  37. package/dist/{cli-gfy38pvt.js → cli-4kzp7r0q.js} +8 -8
  38. package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
  39. package/dist/{cli-mjw0yf82.js → cli-5ptj757f.js} +1 -1
  40. package/dist/{cli-pyjn0qhk.js → cli-6a3j25xd.js} +348 -196
  41. package/dist/{cli-hnamkvnc.js → cli-6c9ve77f.js} +2 -2
  42. package/dist/{cli-mw620q3n.js → cli-6n7y5ypy.js} +1 -1
  43. package/dist/{cli-g0vv9dg4.js → cli-6p8p2e6r.js} +19 -12
  44. package/dist/{cli-jwampxxq.js → cli-6tvh1fwq.js} +3 -3
  45. package/dist/{cli-p74md7t8.js → cli-7b7rxz22.js} +13 -15
  46. package/dist/{cli-5a6pqy45.js → cli-7e8sxqv5.js} +1 -1
  47. package/dist/{cli-p4kckx1z.js → cli-892y3vfp.js} +13 -13
  48. package/dist/cli-8mfdbdhe.js +43 -0
  49. package/dist/{cli-mkwkwq81.js → cli-8zmpwe79.js} +29 -16
  50. package/dist/{cli-zcfpsfzf.js → cli-96234j5w.js} +3 -3
  51. package/dist/{cli-1z4qggfe.js → cli-9fvk9mv8.js} +30 -21
  52. package/dist/{cli-7mv4h3sn.js → cli-9g12h1aq.js} +2 -2
  53. package/dist/{cli-f8x9drqr.js → cli-9knhkkgr.js} +19 -5
  54. package/dist/{cli-5mpy301f.js → cli-9t7syepg.js} +1 -1
  55. package/dist/{cli-qj39vrc6.js → cli-9yjhshah.js} +1 -1
  56. package/dist/{cli-zr6qy15y.js → cli-a02habn6.js} +427 -145
  57. package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
  58. package/dist/{cli-h9yqfzx9.js → cli-a6q6x15h.js} +11 -10
  59. package/dist/{cli-bg63qmsx.js → cli-atm0hkes.js} +11 -11
  60. package/dist/{cli-m7zvgt57.js → cli-b82a13ga.js} +13 -13
  61. package/dist/{cli-7zm3b3f5.js → cli-bf0t77nf.js} +1 -1
  62. package/dist/{cli-2xv18ywz.js → cli-bmqp0ser.js} +2 -2
  63. package/dist/{cli-xag7btpe.js → cli-bq97k63w.js} +2 -2
  64. package/dist/{cli-pb2ay3sh.js → cli-cstggwq7.js} +5 -5
  65. package/dist/{cli-f3jyzq4g.js → cli-czvvnfr9.js} +3 -3
  66. package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
  67. package/dist/{cli-nafvvsp8.js → cli-djt6wmrc.js} +9 -9
  68. package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
  69. package/dist/{cli-8zh9nrew.js → cli-f7dhm7hh.js} +1 -1
  70. package/dist/cli-f8yhybxr.js +321 -0
  71. package/dist/{cli-5gpqgs8b.js → cli-fwjwkw66.js} +2 -2
  72. package/dist/{cli-gabsjg8x.js → cli-g56fxddf.js} +1 -1
  73. package/dist/{cli-w4n323t3.js → cli-h2qtafm4.js} +19 -19
  74. package/dist/{cli-psffsanb.js → cli-ha4ek2nb.js} +6 -1
  75. package/dist/{cli-dgs10ttj.js → cli-hnh8erra.js} +2 -2
  76. package/dist/{cli-w16kwbzw.js → cli-htymm48w.js} +1 -1
  77. package/dist/{cli-2xs8tsf7.js → cli-j2r1apqm.js} +152 -67
  78. package/dist/{cli-43ms35q9.js → cli-k3c13za2.js} +3 -3
  79. package/dist/{cli-54vrpgm0.js → cli-k3facve0.js} +8 -5
  80. package/dist/{cli-67mwzr35.js → cli-k4r5sfaj.js} +7 -7
  81. package/dist/{cli-rq5rpv6k.js → cli-kbm659dk.js} +2 -2
  82. package/dist/{cli-j7svy295.js → cli-m00c47q6.js} +114 -31
  83. package/dist/{cli-m7c2380k.js → cli-mhrr4d5b.js} +99 -14
  84. package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
  85. package/dist/{cli-vt89089n.js → cli-n6ygvrrm.js} +4 -4
  86. package/dist/{cli-jaw5v1sy.js → cli-nbakg5xh.js} +3 -3
  87. package/dist/{cli-nbt14he0.js → cli-nc39ym5q.js} +8 -8
  88. package/dist/{cli-tvc4jag9.js → cli-p1a4khta.js} +8 -8
  89. package/dist/{cli-t9ga4qmb.js → cli-p8zqbbt1.js} +40 -33
  90. package/dist/{cli-fjggej24.js → cli-ph95yejc.js} +2 -2
  91. package/dist/{cli-m0cy2vyf.js → cli-q4z9s6zs.js} +5 -5
  92. package/dist/cli-q71g5q39.js +404 -0
  93. package/dist/{cli-vs9vdpy0.js → cli-qncx2r0s.js} +1 -1
  94. package/dist/{cli-hg42n3hx.js → cli-qrzq3hvg.js} +8 -8
  95. package/dist/{cli-x40a0w9j.js → cli-r813c7rb.js} +1 -1
  96. package/dist/{cli-kpgcm7xy.js → cli-ramn8jae.js} +1 -1
  97. package/dist/{cli-jkw6ptfw.js → cli-raqw9fw9.js} +28 -17
  98. package/dist/cli-rhsc2zyx.js +68 -0
  99. package/dist/{cli-sn650d7x.js → cli-rpmw4fsv.js} +68 -20
  100. package/dist/{boot-scrub-sweep-7dkdzqxx.js → cli-rwgwen5v.js} +9 -10
  101. package/dist/{cli-3j873zxq.js → cli-rytq7dm2.js} +261 -6
  102. package/dist/{cli-zh0e5x7p.js → cli-s9twe4x0.js} +71 -22
  103. package/dist/{cli-2dq9yv8p.js → cli-t2s7j5cy.js} +2 -2
  104. package/dist/{cli-wn13hhdt.js → cli-tb4j757d.js} +7 -7
  105. package/dist/{cli-q2d3e1k1.js → cli-thd3005a.js} +1 -1
  106. package/dist/cli-tsfkcd4v.js +30 -0
  107. package/dist/{cli-br0924pw.js → cli-v3zcnr8g.js} +1 -1
  108. package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
  109. package/dist/{cli-ysvspf5e.js → cli-vy3fn0mz.js} +4 -4
  110. package/dist/{cli-7sf9sb0w.js → cli-w5dar1bk.js} +1 -1
  111. package/dist/{cli-2yjj3e31.js → cli-wz4e5am2.js} +12 -10
  112. package/dist/{cli-td9tb872.js → cli-xqbqwpxr.js} +14 -14
  113. package/dist/{cli-32djehja.js → cli-ynph3b70.js} +11137 -8332
  114. package/dist/{cli-mhapr559.js → cli-yvzxbztc.js} +9 -4
  115. package/dist/{cli-v57d7fmm.js → cli-yzxqwcvq.js} +25 -27
  116. package/dist/{cli-y2ewxhth.js → cli-zb1hff00.js} +16 -16
  117. package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
  118. package/dist/{cli-ctx0b85j.js → cli-zhn4r1rz.js} +757 -157
  119. package/dist/{cli-6945ywhr.js → cli-zqq57pgx.js} +9 -7
  120. package/dist/cli.js +30 -29
  121. package/dist/{cloudflare-workers-ai-system-one-9y1zx3pt.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
  122. package/dist/{codex-adapter-n656pvb8.js → codex-adapter-ssahg4h4.js} +8 -8
  123. package/dist/{codex-hook-59atdwd8.js → codex-hook-aqtj17yr.js} +1 -1
  124. package/dist/{codex-login-a239g1ah.js → codex-login-9c7aggxe.js} +1 -1
  125. package/dist/{codex-session-runner-p0fbv5y9.js → codex-session-runner-xn63q3h7.js} +9 -9
  126. package/dist/{commands-gwea8z5p.js → commands-ctey7tr5.js} +3 -3
  127. package/dist/{controller-t67c3grh.js → controller-rqhbppg9.js} +4 -4
  128. package/dist/{controllers-connect-ks155r0h.js → controllers-connect-w3qbpbt1.js} +22 -21
  129. package/dist/core-df1n049h.js +39 -0
  130. package/dist/{cursor-adapter-ygwrtmkv.js → cursor-adapter-r819hf1a.js} +2 -2
  131. package/dist/{db-kpmx06s9.js → db-2ah39cyx.js} +2 -2
  132. package/dist/{db-rb2xqdb1.js → db-p5drc1d1.js} +3 -3
  133. package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-bc6g0x29.js} +1 -1
  134. package/dist/{dispatcher-31sm0ej2.js → dispatcher-x6w14pde.js} +19 -18
  135. package/dist/{docker-09tkkg0n.js → docker-6c4reetq.js} +51 -14
  136. package/dist/{dsh-adapter-qyxh0w31.js → dsh-adapter-h8qn14n4.js} +2 -2
  137. package/dist/{e2b-sm28k0k3.js → e2b-jg7kyyef.js} +6 -6
  138. package/dist/{e2b-3v1e745x.js → e2b-z4ec0qve.js} +3 -3
  139. package/dist/{easter-egg-3d-00wjscn6.js → easter-egg-3d-1y6r9gxy.js} +1 -1
  140. package/dist/{embedding-space-qhw4g68n.js → embedding-space-z6ptw3jk.js} +6 -6
  141. package/dist/{embeddings-zdv9ke6x.js → embeddings-0sxb1d2h.js} +1 -1
  142. package/dist/{event-bus-xr83x566.js → event-bus-swr88jg5.js} +1 -1
  143. package/dist/{execute-zna8wwr7.js → execute-6m1ex8ce.js} +8 -4
  144. package/dist/{external-channel-1ac6t56s.js → external-channel-ezer7pk0.js} +2 -2
  145. package/dist/fx-adapter-zwmps9re.js +19 -0
  146. package/dist/{google-generative-ai-maq6c9bf.js → google-generative-ai-sw77egmr.js} +13 -13
  147. package/dist/{google-vertex-2jgsw2nb.js → google-vertex-rrw93g8h.js} +13 -13
  148. package/dist/grok-adapter-q0avf919.js +19 -0
  149. package/dist/handlers-g5jq0e4q.js +36 -0
  150. package/dist/{heartbeat-2f6z4kdx.js → heartbeat-6c4fr49t.js} +22 -21
  151. package/dist/{hook-8y0gvtp1.js → hook-02rt5tvq.js} +8 -8
  152. package/dist/{hook-w1skzaqc.js → hook-t1c5avbv.js} +5 -5
  153. package/dist/{http-wghxvpef.js → http-qa3h32a1.js} +2659 -355
  154. package/dist/index-1f6m47mq.js +37 -0
  155. package/dist/index-1p1mpqda.js +36 -0
  156. package/dist/{index-rv89fvzf.js → index-akbgsdhh.js} +25 -24
  157. package/dist/{index-9zkchs9t.js → index-e42j998x.js} +190 -15
  158. package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
  159. package/dist/{index-s71ez27v.js → index-kqv9ebfj.js} +1 -1
  160. package/dist/{index-9myfj74s.js → index-kzdqn3dd.js} +3 -3
  161. package/dist/{index-4a0670yh.js → index-p2f5xg64.js} +6 -6
  162. package/dist/{index-8zn8nxn5.js → index-qpjk2hxk.js} +1 -1
  163. package/dist/index-tnkd410q.js +41 -0
  164. package/dist/k8s-7jrh5va2.js +276 -0
  165. package/dist/{keepalive-sh02349h.js → keepalive-jmf6pn8c.js} +4 -4
  166. package/dist/lead-m5e7xt93.js +75 -0
  167. package/dist/{llama-cpp-classify-nfgswa1m.js → llama-cpp-classify-yvb8vh7w.js} +2 -2
  168. package/dist/{maintenance-yj0dcjja.js → maintenance-g7v15tj1.js} +1 -1
  169. package/dist/{mistral-conversations-0c30em7t.js → mistral-conversations-w4bncwbt.js} +11 -11
  170. package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
  171. package/dist/{oauth-refresh-sweep-d9xedk66.js → oauth-refresh-sweep-ywgf8tbr.js} +3 -3
  172. package/dist/{onboard-dpgjn03r.js → onboard-m3fedypq.js} +6 -6
  173. package/dist/{openai-codex-responses-bkcd8pjj.js → openai-codex-responses-70g39cgz.js} +24 -18
  174. package/dist/{openai-completions-f3n69rep.js → openai-completions-cv3hp4h5.js} +33 -26
  175. package/dist/{openai-decisions-q3hh60wr.js → openai-decisions-fyq1p9f9.js} +2 -2
  176. package/dist/{openai-responses-gbh0wfqe.js → openai-responses-trsvnks6.js} +24 -22
  177. package/dist/{opencode-adapter-2d31cpjc.js → opencode-adapter-19ktcbb9.js} +7 -7
  178. package/dist/{openrouter-images-xr9gme9x.js → openrouter-images-0jj12a2q.js} +6 -6
  179. package/dist/{otel-impl-1skarpfq.js → otel-impl-3ehm1hgc.js} +2 -2
  180. package/dist/{pending-bfmxtx0g.js → pending-fwj2fatd.js} +20 -19
  181. package/dist/{pi-messages-zebyt7gb.js → pi-messages-zk3g4esn.js} +6 -6
  182. package/dist/{pi-mono-adapter-gvppnasy.js → pi-mono-adapter-xdeesvc4.js} +18 -17
  183. package/dist/{pricing-refresh-c6b325mk.js → pricing-refresh-4j8dzvxg.js} +2 -2
  184. package/dist/{rbac-roles-h80qbdbs.js → rbac-roles-8msjr07m.js} +3 -3
  185. package/dist/{rbac-roles-zfcx68tx.js → rbac-roles-n7t2acv8.js} +2 -2
  186. package/dist/{render-v2-nx20t3rb.js → render-v2-j7qggj8h.js} +7 -6
  187. package/dist/{resume-5ep8agan.js → resume-hj1mn65y.js} +9 -8
  188. package/dist/{runtime-r3pj4mce.js → runtime-z31mdsgv.js} +2 -2
  189. package/dist/{session-access-n7p3m15b.js → session-access-w38fh09a.js} +4 -4
  190. package/dist/{session-source-backfill-v8mt0zwn.js → session-source-backfill-ax6qxv20.js} +3 -3
  191. package/dist/{setup-z1psaqhe.js → setup-dsqmpfcr.js} +1 -1
  192. package/dist/thread-buffer-nf55vwx3.js +39 -0
  193. package/dist/tree-visibility-6vqmnr71.js +24 -0
  194. package/dist/{typesafe-system-one-f2en2knd.js → typesafe-system-one-qkvkgrcz.js} +2 -2
  195. package/dist/user-merge-jobs-mvheb3ed.js +22 -0
  196. package/dist/{virtual-modules-rrbjdpxn.js → virtual-modules-w2qk2wew.js} +32 -10
  197. package/dist/{work-objects-4aghh73z.js → work-objects-4ahy5es5.js} +22 -21
  198. package/dist/worker-ews1nyhw.js +75 -0
  199. package/dist/{worker-follow-up-166zmex1.js → worker-follow-up-1gs4aw7y.js} +19 -18
  200. package/dist/{x-wg164ss9.js → x-3wr8c5sh.js} +2 -2
  201. package/openapi.json +2576 -388
  202. package/package.json +11 -10
  203. package/src/be/boot-seeds.ts +7 -1
  204. package/src/be/db/model-groups.ts +238 -0
  205. package/src/be/db/model-profiles.ts +26 -8
  206. package/src/be/db/request-composition.ts +190 -0
  207. package/src/be/db/runtime.ts +15 -0
  208. package/src/be/db/session-costs.ts +8 -2
  209. package/src/be/db/slack-trees.ts +220 -10
  210. package/src/be/db/tasks/human-free.ts +3 -2
  211. package/src/be/db/tasks/read.ts +3 -2
  212. package/src/be/db/tasks/write.ts +2 -1
  213. package/src/be/db/user-references.ts +75 -0
  214. package/src/be/db/users/references.ts +185 -0
  215. package/src/be/db/workflow-run-retention.ts +101 -0
  216. package/src/be/db-client.ts +93 -20
  217. package/src/be/db-retention-defaults.ts +46 -0
  218. package/src/be/db-retention.ts +55 -6
  219. package/src/be/db.ts +32 -57
  220. package/src/be/key-window-usage.ts +1 -0
  221. package/src/be/mcp-events/catalog.ts +108 -0
  222. package/src/be/mcp-events/dispatcher.ts +202 -0
  223. package/src/be/mcp-events/protocol.ts +296 -0
  224. package/src/be/mcp-events/store.ts +231 -0
  225. package/src/be/mcp-events/webhook.ts +226 -0
  226. package/src/be/memory/demotion-evidence.ts +34 -0
  227. package/src/be/memory/providers/sqlite-store.ts +110 -24
  228. package/src/be/memory/reranker.ts +34 -12
  229. package/src/be/memory/review-recall-filter.ts +105 -0
  230. package/src/be/memory/search-candidates.ts +16 -5
  231. package/src/be/memory/types.ts +16 -0
  232. package/src/be/migrations/312_task_ui_action_runs_repeatable.sql +6 -0
  233. package/src/be/migrations/314_model_groups.sql +85 -0
  234. package/src/be/migrations/318_superseded_workflow_cut_backfill.sql +22 -0
  235. package/src/be/migrations/319_user_fk_indexes.sql +153 -0
  236. package/src/be/migrations/320_session_costs_kind.sql +4 -0
  237. package/src/be/migrations/321_user_merge_jobs.sql +52 -0
  238. package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
  239. package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
  240. package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
  241. package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
  242. package/src/be/migrations/329_workflow_run_retention.sql +9 -0
  243. package/src/be/migrations/330_request_composition.sql +22 -0
  244. package/src/be/model-profile-check.ts +1 -1
  245. package/src/be/multi-runtime.ts +32 -4
  246. package/src/be/pricing-normalize.ts +2 -0
  247. package/src/be/rbac-roles.ts +6 -4
  248. package/src/be/runtime-pools/controllers.ts +18 -3
  249. package/src/be/runtime-pools/db.ts +35 -9
  250. package/src/be/runtime-pools/supervisor.ts +57 -3
  251. package/src/be/scripts/db.ts +11 -0
  252. package/src/be/scripts/typecheck.ts +2 -0
  253. package/src/be/seed-model-groups.ts +86 -0
  254. package/src/be/seed-model-profiles.ts +20 -13
  255. package/src/be/seed-scripts/catalog/dreaming-gather.ts +165 -1
  256. package/src/be/swarm-config-guard.ts +44 -2
  257. package/src/be/task-ui-spec.ts +102 -1
  258. package/src/be/user-merge-jobs.ts +564 -0
  259. package/src/be/users.ts +41 -23
  260. package/src/commands/context-preamble.ts +11 -4
  261. package/src/commands/credential-outcome-report.ts +33 -9
  262. package/src/commands/e2b-stack-wizard.tsx +12 -6
  263. package/src/commands/onboard/agent-fs-version.ts +1 -1
  264. package/src/commands/onboard/compose-generator.ts +1 -1
  265. package/src/commands/onboard/env-generator.ts +1 -1
  266. package/src/commands/provider-credentials.ts +1 -1
  267. package/src/commands/runner.ts +116 -12
  268. package/src/extensions/catalog.generated.json +1 -1
  269. package/src/extensions/contract-types.generated.ts +1 -1
  270. package/src/extensions/contract.ts +15 -0
  271. package/src/extensions/dispatcher.ts +14 -4
  272. package/src/github/app.ts +59 -14
  273. package/src/github/handlers.ts +57 -0
  274. package/src/github/types.ts +4 -0
  275. package/src/http/all-routes.ts +4 -0
  276. package/src/http/approval-requests.ts +5 -1
  277. package/src/http/auth.ts +3 -1
  278. package/src/http/config.ts +36 -2
  279. package/src/http/core.ts +2 -0
  280. package/src/http/github-token.ts +66 -0
  281. package/src/http/index.ts +34 -0
  282. package/src/http/mcp-user.ts +11 -8
  283. package/src/http/mcp.ts +58 -42
  284. package/src/http/memory.ts +19 -6
  285. package/src/http/model-groups.ts +277 -0
  286. package/src/http/model-profiles.ts +30 -13
  287. package/src/http/prompt-templates.ts +1 -0
  288. package/src/http/request-composition.ts +310 -0
  289. package/src/http/tasks.ts +46 -6
  290. package/src/http/tool-hooks.ts +140 -0
  291. package/src/http/tool-schema-estimate.ts +95 -0
  292. package/src/http/users.ts +142 -19
  293. package/src/http/workflows.ts +37 -1
  294. package/src/integrations/chat-sdk/inbound.ts +8 -2
  295. package/src/integrations/chat-sdk/limits.ts +8 -3
  296. package/src/prompts/base-prompt.ts +133 -7
  297. package/src/prompts/resolver.ts +41 -2
  298. package/src/providers/acp-targets.ts +2 -2
  299. package/src/providers/amp-adapter.ts +1 -1
  300. package/src/providers/opencode-adapter.ts +72 -1
  301. package/src/providers/opencode-swarm-plugin.ts +22 -3
  302. package/src/providers/pi-mono-adapter.ts +1 -0
  303. package/src/providers/pi-mono-extension.ts +71 -0
  304. package/src/providers/pricing-sources.md +13 -0
  305. package/src/providers/request-composition-hook.ts +312 -0
  306. package/src/providers/types.ts +5 -0
  307. package/src/rbac/legacy-policy.ts +1 -0
  308. package/src/rbac/permissions.ts +5 -0
  309. package/src/runtime-providers/controller-protocol.ts +7 -0
  310. package/src/runtime-providers/docker.ts +80 -12
  311. package/src/runtime-providers/index.ts +7 -5
  312. package/src/runtime-providers/k8s.ts +355 -0
  313. package/src/runtime-providers/types.ts +17 -0
  314. package/src/scheduler/scheduler.ts +1 -1
  315. package/src/scripts-runtime/types/stdlib.d.ts +2 -0
  316. package/src/scripts-runtime/types/swarm-extension.d.ts +16 -1
  317. package/src/scripts-runtime/types/swarm-sdk.d.ts +2 -0
  318. package/src/server-user.ts +16 -1
  319. package/src/slack/ack.ts +10 -5
  320. package/src/slack/actions.ts +36 -13
  321. package/src/slack/app.ts +2 -0
  322. package/src/slack/assistant.ts +4 -4
  323. package/src/slack/blocks.ts +26 -5
  324. package/src/slack/handlers.ts +3 -3
  325. package/src/slack/reaction-shortcode.ts +23 -2
  326. package/src/slack/render-v2.ts +344 -200
  327. package/src/slack/responses.ts +7 -5
  328. package/src/slack/thread-buffer.ts +3 -3
  329. package/src/slack/tree-visibility.ts +64 -0
  330. package/src/tasks/worker-follow-up.ts +127 -17
  331. package/src/tests/acp-adapter.test.ts +26 -0
  332. package/src/tests/azure-devops-outbound.test.ts +47 -14
  333. package/src/tests/base-prompt.test.ts +149 -1
  334. package/src/tests/chat-sdk-relay.test.ts +21 -1
  335. package/src/tests/check-playwright-version.test.ts +33 -0
  336. package/src/tests/check-pr-body.test.ts +43 -0
  337. package/src/tests/context-preamble-budget.test.ts +65 -0
  338. package/src/tests/credential-check.test.ts +14 -6
  339. package/src/tests/credential-outcome-report.test.ts +81 -1
  340. package/src/tests/db-client.test.ts +168 -0
  341. package/src/tests/db-retention-defaults.test.ts +244 -0
  342. package/src/tests/db-retention.test.ts +2 -1
  343. package/src/tests/db-runtime.test.ts +2 -1
  344. package/src/tests/deploy-guard.test.ts +7 -7
  345. package/src/tests/deploy-release-dispatch.test.ts +332 -0
  346. package/src/tests/deploy-select.test.ts +83 -0
  347. package/src/tests/dreaming-gather-corrections.test.ts +467 -0
  348. package/src/tests/e2b-stack-wizard.test.tsx +156 -0
  349. package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
  350. package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
  351. package/src/tests/env-flag.test.ts +4 -2
  352. package/src/tests/event-loop-lag.test.ts +16 -20
  353. package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
  354. package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
  355. package/src/tests/fixtures/base-prompt-baseline.json +18 -0
  356. package/src/tests/fixtures/extensions/native-tool-recorder/hooks.ts +26 -0
  357. package/src/tests/fixtures/extensions/native-tool-recorder/manifest.json +10 -0
  358. package/src/tests/fixtures/onboard/content.compose.yml.txt +1 -1
  359. package/src/tests/fixtures/onboard/content.env.txt +1 -1
  360. package/src/tests/fixtures/onboard/dev.compose.yml.txt +1 -1
  361. package/src/tests/fixtures/onboard/dev.env.txt +1 -1
  362. package/src/tests/fixtures/onboard/full-all.compose.yml.txt +1 -1
  363. package/src/tests/fixtures/onboard/full-all.env.txt +1 -1
  364. package/src/tests/fixtures/onboard/full.compose.yml.txt +1 -1
  365. package/src/tests/fixtures/onboard/full.env.txt +1 -1
  366. package/src/tests/fixtures/onboard/research.compose.yml.txt +1 -1
  367. package/src/tests/fixtures/onboard/research.env.txt +1 -1
  368. package/src/tests/fixtures/onboard/solo.compose.yml.txt +1 -1
  369. package/src/tests/fixtures/onboard/solo.env.txt +1 -1
  370. package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
  371. package/src/tests/github-event-filter.test.ts +8 -0
  372. package/src/tests/github-handlers-inline-comments.test.ts +2 -0
  373. package/src/tests/github-handlers-reactions.test.ts +4 -0
  374. package/src/tests/github-handlers.test.ts +3 -0
  375. package/src/tests/github-installation-token-route.test.ts +199 -0
  376. package/src/tests/github-sender-trust.test.ts +223 -0
  377. package/src/tests/http-users.test.ts +142 -41
  378. package/src/tests/k8s-pool-smoke.test.ts +190 -0
  379. package/src/tests/key-window-usage.test.ts +15 -0
  380. package/src/tests/mcp-user-events.test.ts +708 -0
  381. package/src/tests/memory-key-paths.test.ts +4 -1
  382. package/src/tests/memory-rater-store.test.ts +35 -1
  383. package/src/tests/memory-reranker.test.ts +39 -4
  384. package/src/tests/memory-review-recall-filter.test.ts +205 -0
  385. package/src/tests/memory-search-stall.test.ts +421 -0
  386. package/src/tests/migration-318-superseded-workflow-cut-backfill.test.ts +74 -0
  387. package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
  388. package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
  389. package/src/tests/model-groups-api.test.ts +415 -0
  390. package/src/tests/model-profile-fallbacks.test.ts +236 -2
  391. package/src/tests/model-profiles-api.test.ts +1 -0
  392. package/src/tests/opencode-adapter.test.ts +86 -0
  393. package/src/tests/operator-granted-credentials.test.ts +7 -2
  394. package/src/tests/operator-granted-role-wire.test.ts +2 -1
  395. package/src/tests/pi-mono-extension.test.ts +168 -0
  396. package/src/tests/preload-env.test.ts +61 -1
  397. package/src/tests/preload.ts +22 -0
  398. package/src/tests/prompt-template-resolver.test.ts +85 -0
  399. package/src/tests/rbac-engine.test.ts +1 -0
  400. package/src/tests/reload-config.test.ts +45 -0
  401. package/src/tests/request-composition.test.ts +447 -0
  402. package/src/tests/runner-max-concurrent.test.ts +86 -0
  403. package/src/tests/runtime-k8s-pools.test.ts +142 -0
  404. package/src/tests/runtime-pools-db.test.ts +122 -2
  405. package/src/tests/runtime-pools-http.test.ts +47 -2
  406. package/src/tests/runtime-provider-registration.test.ts +13 -14
  407. package/src/tests/runtime-providers-docker.test.ts +192 -1
  408. package/src/tests/runtime-providers-k8s.test.ts +430 -0
  409. package/src/tests/runtime-remote-controller.test.ts +64 -1
  410. package/src/tests/runtime-supervisor.test.ts +101 -0
  411. package/src/tests/script-connections.test.ts +21 -1
  412. package/src/tests/short-id.test.ts +23 -0
  413. package/src/tests/slack-blocks.test.ts +87 -0
  414. package/src/tests/slack-empty-icon-config.test.ts +113 -0
  415. package/src/tests/slack-reaction-config.test.ts +38 -2
  416. package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
  417. package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
  418. package/src/tests/slack-render-v2.test.ts +737 -11
  419. package/src/tests/spec-base-url.test.ts +13 -1
  420. package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
  421. package/src/tests/system-one-decide-session-cost.test.ts +196 -0
  422. package/src/tests/task-session-prompts.test.ts +37 -0
  423. package/src/tests/task-ui-action-route.test.ts +59 -1
  424. package/src/tests/task-ui-script-actions.test.ts +517 -0
  425. package/src/tests/tool-hooks-http.test.ts +187 -0
  426. package/src/tests/ui-spec-script-actions-config.test.ts +196 -0
  427. package/src/tests/user-delete-perf.test.ts +348 -0
  428. package/src/tests/user-merge-jobs.test.ts +680 -0
  429. package/src/tests/vcs-provider.test.ts +25 -5
  430. package/src/tests/vendored-openapi.test.ts +13 -1
  431. package/src/tests/webhook-filter.test.ts +327 -0
  432. package/src/tests/workflow-agent-task-retry.test.ts +62 -0
  433. package/src/tests/workflow-async-v2.test.ts +19 -16
  434. package/src/tests/workflow-definition-telemetry.test.ts +15 -5
  435. package/src/tests/workflow-e2e.test.ts +1 -9
  436. package/src/tests/workflow-finalization-races.test.ts +553 -0
  437. package/src/tests/workflow-foreach-supersede-retry.test.ts +10 -0
  438. package/src/tests/workflow-foreach.test.ts +2 -0
  439. package/src/tests/workflow-hitl-routing.test.ts +26 -20
  440. package/src/tests/workflow-http-v2.test.ts +132 -2
  441. package/src/tests/workflow-idempotency.test.ts +41 -0
  442. package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
  443. package/src/tests/workflow-parallel-park.test.ts +297 -0
  444. package/src/tests/workflow-replay.test.ts +10 -1
  445. package/src/tests/workflow-retry-v2.test.ts +57 -21
  446. package/src/tests/workflow-retry-validation.test.ts +13 -13
  447. package/src/tests/workflow-runs-retention.test.ts +533 -0
  448. package/src/tests/workflow-script-principal.test.ts +7 -2
  449. package/src/tests/workflow-tla-races.test.ts +7 -2
  450. package/src/tests/workflow-triggers-v2.test.ts +329 -0
  451. package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
  452. package/src/tests/workflow-wait-event.test.ts +137 -3
  453. package/src/tests/workflow-wait-poller.test.ts +94 -0
  454. package/src/tests/workflow-wait-time.test.ts +7 -3
  455. package/src/tests/workflow-wait.test.ts +26 -0
  456. package/src/tests/workflow-wait.ts +44 -0
  457. package/src/tools/memory-search.ts +14 -3
  458. package/src/tools/store-progress.ts +26 -26
  459. package/src/tools/swarm-config/delete-config.ts +12 -1
  460. package/src/tools/swarm-config/set-config.ts +8 -0
  461. package/src/tools/system-one-decide.ts +113 -3
  462. package/src/tools/utils.ts +4 -1
  463. package/src/tools/workflows/create-workflow.ts +7 -1
  464. package/src/tools/workflows/update-workflow.ts +8 -2
  465. package/src/types.ts +284 -2
  466. package/src/ui-spec/actions.ts +30 -4
  467. package/src/ui-spec/schema.ts +38 -0
  468. package/src/ui-spec/script-actions.ts +340 -0
  469. package/src/ui-spec/script-allowlist.ts +48 -0
  470. package/src/utils/credentials.ts +7 -0
  471. package/src/utils/short-id.ts +20 -14
  472. package/src/utils/task-ui-spec.ts +16 -4
  473. package/src/vcs/index.ts +12 -2
  474. package/src/workflows/checkpoint.ts +18 -0
  475. package/src/workflows/engine.ts +38 -10
  476. package/src/workflows/executors/system-one-decision.ts +2 -2
  477. package/src/workflows/foreach-driver.ts +42 -4
  478. package/src/workflows/recovery.ts +6 -1
  479. package/src/workflows/resume.ts +14 -5
  480. package/src/workflows/retry-poller.ts +17 -4
  481. package/src/workflows/successor-routing.ts +108 -0
  482. package/src/workflows/task-step-routing.ts +35 -12
  483. package/src/workflows/triggers.ts +25 -8
  484. package/src/workflows/wait-poller.ts +6 -2
  485. package/src/workflows/webhook-filter.ts +203 -0
  486. package/templates/extensions/manifest.schema.json +13 -0
  487. package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
  488. package/templates/skills/swarm-docs/content.md +4 -0
  489. package/templates/skills/ui-spec/content.md +7 -1
  490. package/templates/workflows/dreaming/content.md +1 -1
  491. package/dist/acp-adapter-g909b5hw.js +0 -16
  492. package/dist/cli-b91nz213.js +0 -93
  493. package/dist/fx-adapter-sk7n0fzc.js +0 -19
  494. package/dist/grok-adapter-sjbcm5ew.js +0 -19
  495. package/dist/handlers-yzy0c87x.js +0 -35
  496. package/dist/index-25pvya7q.js +0 -40
  497. package/dist/index-2t4859r5.js +0 -35
  498. package/dist/index-cxca2t8y.js +0 -36
  499. package/dist/lead-gk4h5eg7.js +0 -74
  500. package/dist/thread-buffer-a1re2r9r.js +0 -38
  501. package/dist/worker-3dyyb8ev.js +0 -74
  502. /package/dist/{node-dqm4xgxw.js → node-2wfcey7d.js} +0 -0
@@ -10,6 +10,8 @@ import {
10
10
  type RuntimeProvider,
11
11
  type RuntimeStatus,
12
12
  type RuntimeTargetConfig,
13
+ WORKSPACE_LABEL,
14
+ WORKSPACE_MOUNT_PATH,
13
15
  } from "./types";
14
16
 
15
17
  /**
@@ -123,11 +125,52 @@ function assertCacheOwner(volume: CacheVolume, cache: RuntimeCacheReference): vo
123
125
  volume.Name !== cache.key ||
124
126
  volume.Labels?.[RUNTIME_LABELS.owner] !== cache.ownerId ||
125
127
  volume.Labels?.[RUNTIME_LABELS.poolId] !== cache.poolId ||
126
- volume.Labels?.["swarm.cache"] !== "true"
128
+ volume.Labels?.["swarm.cache"] !== "true" ||
129
+ volume.Labels?.[WORKSPACE_LABEL] === "true"
127
130
  )
128
131
  throw new Error(`Cache volume ${cache.key} is not owned by this swarm and pool`);
129
132
  }
130
133
 
134
+ function assertWorkspaceOwner(volume: CacheVolume, req: ProvisionRequest, key: string): void {
135
+ if (
136
+ volume.Name !== key ||
137
+ volume.Labels?.[RUNTIME_LABELS.owner] !== req.ownerId ||
138
+ volume.Labels?.[RUNTIME_LABELS.agentId] !== req.agentId ||
139
+ volume.Labels?.[WORKSPACE_LABEL] !== "true"
140
+ )
141
+ throw new Error(`Workspace volume ${key} is not owned by this swarm and agent`);
142
+ }
143
+
144
+ /** Creates or reuses the agent's workspace volume and refuses one a live container mounts. */
145
+ async function prepareWorkspaceMount(
146
+ target: RuntimeTargetConfig,
147
+ req: ProvisionRequest,
148
+ key: string,
149
+ ): Promise<{ Type: "volume"; Source: string; Target: string }> {
150
+ // No pool label: the volume outlives the pool and is never removed by the swarm.
151
+ const volume = await dockerApi<CacheVolume>(target, "POST", "/volumes/create", {
152
+ Name: key,
153
+ Labels: {
154
+ [RUNTIME_LABELS.owner]: req.ownerId,
155
+ [RUNTIME_LABELS.agentId]: req.agentId,
156
+ [WORKSPACE_LABEL]: "true",
157
+ },
158
+ });
159
+ assertWorkspaceOwner(volume, req, key);
160
+ const filters = encodeURIComponent(JSON.stringify({ volume: [key] }));
161
+ const users = await dockerApi<Array<{ Id: string; State?: string }>>(
162
+ target,
163
+ "GET",
164
+ `/containers/json?all=true&filters=${filters}`,
165
+ );
166
+ // Terminate marks a row offline before the container is gone; this is the infra fence.
167
+ const live = users.find((c) =>
168
+ ["running", "restarting", "paused", "created"].includes(c.State ?? ""),
169
+ );
170
+ if (live) throw new Error(`workspace ${key} is in use by ${live.Id}`);
171
+ return { Type: "volume", Source: key, Target: WORKSPACE_MOUNT_PATH };
172
+ }
173
+
131
174
  async function dockerApi<T>(
132
175
  target: RuntimeTargetConfig,
133
176
  method: string,
@@ -189,6 +232,7 @@ export class DockerRuntimeProvider implements RuntimeProvider {
189
232
  ephemeralDisk: true,
190
233
  supportsPause: false,
191
234
  persistentCache: true,
235
+ persistentWorkspace: true,
192
236
  };
193
237
 
194
238
  checkConfig(target: RuntimeTargetConfig): ConfigStatus {
@@ -228,6 +272,11 @@ export class DockerRuntimeProvider implements RuntimeProvider {
228
272
  cacheWarning = redactWithEnv(scrubSecrets(String(error)), req.env);
229
273
  }
230
274
  }
275
+ // Fail closed: a runtime never starts without its workspace.
276
+ const workspaceMount = req.workspace
277
+ ? await prepareWorkspaceMount(target, req, req.workspace.key)
278
+ : undefined;
279
+ const mounts = [cacheMount, workspaceMount].filter((mount) => mount !== undefined);
231
280
  const path = `/containers/create?name=${encodeURIComponent(`swarm-rt-${req.runtimeId}`)}`;
232
281
  const body = {
233
282
  Image: req.image,
@@ -250,7 +299,7 @@ export class DockerRuntimeProvider implements RuntimeProvider {
250
299
  NetworkMode: target.DOCKER_NETWORK,
251
300
  Memory: req.resources?.memoryMb ? req.resources.memoryMb * 1024 * 1024 : undefined,
252
301
  NanoCpus: req.resources?.cpu ? Math.round(req.resources.cpu * 1e9) : undefined,
253
- ...(cacheMount ? { Mounts: [cacheMount] } : {}),
302
+ ...(mounts.length ? { Mounts: mounts } : {}),
254
303
  ...(isolation.runtime ? { Runtime: isolation.runtime } : {}),
255
304
  ...(isolation.pidsLimit ? { PidsLimit: isolation.pidsLimit } : {}),
256
305
  ...(isolation.hardened
@@ -312,13 +361,19 @@ export class DockerRuntimeProvider implements RuntimeProvider {
312
361
  } catch (err) {
313
362
  if (!cacheMount || !isCacheMountError(err)) throw err;
314
363
  cacheWarning = redactWithEnv(scrubSecrets(String(err)), req.env);
315
- delete body.HostConfig.Mounts;
364
+ // Drop only the cache; a workspace mount error fails the retry and the provision.
365
+ if (workspaceMount) body.HostConfig.Mounts = [workspaceMount];
366
+ else delete body.HostConfig.Mounts;
316
367
  externalId = await createAndStart();
317
368
  }
369
+ const meta = {
370
+ ...(cacheWarning ? { cacheWarning } : {}),
371
+ ...(req.workspace ? { workspaceKey: req.workspace.key } : {}),
372
+ };
318
373
  return {
319
374
  kind: "docker",
320
375
  externalId,
321
- ...(cacheWarning ? { meta: { cacheWarning } } : {}),
376
+ ...(Object.keys(meta).length ? { meta } : {}),
322
377
  };
323
378
  } catch (err) {
324
379
  throw new Error(redactWithEnv(String(err), req.env));
@@ -340,7 +395,7 @@ export class DockerRuntimeProvider implements RuntimeProvider {
340
395
  async terminate(target: RuntimeTargetConfig, handle: RuntimeHandle): Promise<void> {
341
396
  try {
342
397
  // v=true also removes the container's anonymous volumes (the worker image declares
343
- // VOLUME /logs); named volumes are never removed by it.
398
+ // VOLUME /logs); named volumes (caches, workspaces) are never removed by it.
344
399
  await dockerApi(target, "DELETE", `/containers/${handle.externalId}?force=true&v=true`);
345
400
  } catch (err) {
346
401
  if (!(err instanceof DockerApiError) || err.statusCode !== 404) throw err;
@@ -376,13 +431,26 @@ export class DockerRuntimeProvider implements RuntimeProvider {
376
431
  JSON.stringify({ label: [RUNTIME_LABELS.runtimeId, `${RUNTIME_LABELS.owner}=${ownerId}`] }),
377
432
  );
378
433
  const rows = await dockerApi<
379
- Array<{ Id: string; Created?: number; Labels: Record<string, string> }>
434
+ Array<{
435
+ Id: string;
436
+ Created?: number;
437
+ Labels: Record<string, string>;
438
+ Mounts?: Array<{ Type?: string; Name?: string; Destination?: string }>;
439
+ }>
380
440
  >(target, "GET", `/containers/json?all=true&filters=${filters}`);
381
- return rows.map((row) => ({
382
- kind: "docker",
383
- externalId: row.Id,
384
- createdAt: row.Created === undefined ? undefined : new Date(row.Created * 1000).toISOString(),
385
- meta: row.Labels,
386
- }));
441
+ return rows.map((row) => {
442
+ // Recovery trusts only the real mount as workspace evidence, never a label.
443
+ const { workspaceKey: _label, ...meta } = row.Labels ?? {};
444
+ const workspace = row.Mounts?.find(
445
+ (mount) => mount.Type === "volume" && mount.Destination === WORKSPACE_MOUNT_PATH,
446
+ );
447
+ return {
448
+ kind: "docker",
449
+ externalId: row.Id,
450
+ createdAt:
451
+ row.Created === undefined ? undefined : new Date(row.Created * 1000).toISOString(),
452
+ meta: workspace?.Name ? { ...meta, workspaceKey: workspace.Name } : meta,
453
+ };
454
+ });
387
455
  }
388
456
  }
@@ -3,7 +3,7 @@ import type { RuntimeProvider, RuntimeProviderKind, RuntimeTargetConfig } from "
3
3
  export type * from "./types";
4
4
 
5
5
  export function canProvisionKind(kind: RuntimeProviderKind): boolean {
6
- return kind === "docker" || kind === "e2b" || kind === "boxd";
6
+ return kind === "docker" || kind === "e2b" || kind === "boxd" || kind === "k8s";
7
7
  }
8
8
 
9
9
  /**
@@ -31,11 +31,13 @@ export async function createRuntimeProvider(
31
31
  const { BoxdRuntimeProvider } = await import("./boxd");
32
32
  return new BoxdRuntimeProvider();
33
33
  }
34
- case "k8s":
34
+ case "k8s": {
35
+ const { KubernetesRuntimeProvider } = await import("./k8s");
36
+ return new KubernetesRuntimeProvider();
37
+ }
38
+ default:
35
39
  throw new Error(
36
- 'Unknown runtime provider: "k8s" (not implemented). Supported: static, docker, e2b, boxd',
40
+ `Unknown runtime provider: "${kind}". Supported: static, docker, e2b, boxd, k8s`,
37
41
  );
38
- default:
39
- throw new Error(`Unknown runtime provider: "${kind}". Supported: static, docker, e2b, boxd`);
40
42
  }
41
43
  }
@@ -0,0 +1,355 @@
1
+ import { redactWithEnv } from "../e2b/env";
2
+ import { scrubSecrets } from "../utils/secret-scrubber";
3
+ import {
4
+ type ConfigStatus,
5
+ type ProvisionRequest,
6
+ RUNTIME_LABELS,
7
+ type RuntimeHandle,
8
+ type RuntimeProvider,
9
+ type RuntimeStatus,
10
+ type RuntimeTargetConfig,
11
+ WORKSPACE_LABEL,
12
+ WORKSPACE_MOUNT_PATH,
13
+ } from "./types";
14
+
15
+ const SERVICE_ACCOUNT_DIR = "/var/run/secrets/kubernetes.io/serviceaccount";
16
+ const DNS_LABEL = /^[a-z0-9](?:[-a-z0-9]*[a-z0-9])?$/;
17
+
18
+ type Pod = {
19
+ metadata: {
20
+ name: string;
21
+ namespace: string;
22
+ uid: string;
23
+ labels?: Record<string, string>;
24
+ creationTimestamp?: string;
25
+ deletionTimestamp?: string;
26
+ };
27
+ spec?: {
28
+ containers?: Array<{ volumeMounts?: Array<{ name: string; mountPath: string }> }>;
29
+ volumes?: Array<{ name: string; persistentVolumeClaim?: { claimName: string } }>;
30
+ };
31
+ status?: { phase?: string };
32
+ };
33
+
34
+ type PersistentVolumeClaim = {
35
+ metadata: { name: string; labels?: Record<string, string> };
36
+ };
37
+
38
+ type KubernetesResource = "pods" | "persistentvolumeclaims";
39
+
40
+ class KubernetesApiError extends Error {
41
+ constructor(
42
+ readonly statusCode: number,
43
+ method: string,
44
+ resource: KubernetesResource,
45
+ ) {
46
+ // Kubernetes validation errors can echo the complete pod, including worker credentials.
47
+ super(`Kubernetes ${method} ${resource} failed (${statusCode})`);
48
+ }
49
+ }
50
+
51
+ function configuration(target: RuntimeTargetConfig) {
52
+ if ("K8S_TOKEN_FILE" in target || "K8S_CA_FILE" in target)
53
+ throw new Error("Kubernetes controller file paths are not supported.");
54
+ const inCluster = !target.K8S_API_URL && !!target.KUBERNETES_SERVICE_HOST;
55
+ let url: URL;
56
+ try {
57
+ url = new URL(target.K8S_API_URL || "https://kubernetes.default.svc");
58
+ } catch {
59
+ throw new Error("K8S_API_URL must be a valid HTTPS origin.");
60
+ }
61
+ if (
62
+ (url.protocol !== "https:" &&
63
+ !(url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname))) ||
64
+ url.username ||
65
+ url.password ||
66
+ url.search ||
67
+ url.hash ||
68
+ url.pathname !== "/"
69
+ )
70
+ throw new Error("K8S_API_URL must be an HTTPS origin. HTTP is allowed only on loopback.");
71
+ if (!target.K8S_API_URL && !inCluster)
72
+ throw new Error("Set K8S_API_URL or run the API inside Kubernetes.");
73
+ const namespace = target.K8S_NAMESPACE || "default";
74
+ if (namespace.length > 63 || !DNS_LABEL.test(namespace))
75
+ throw new Error("K8S_NAMESPACE must be a valid Kubernetes namespace.");
76
+ if (!target.K8S_TOKEN?.trim() && !inCluster)
77
+ throw new Error("Set K8S_TOKEN in secretConfig or use in-cluster authentication.");
78
+ return {
79
+ url,
80
+ namespace,
81
+ tokenFile: inCluster ? `${SERVICE_ACCOUNT_DIR}/token` : undefined,
82
+ caFile: inCluster ? `${SERVICE_ACCOUNT_DIR}/ca.crt` : undefined,
83
+ };
84
+ }
85
+
86
+ async function kubernetesApi<T>(
87
+ target: RuntimeTargetConfig,
88
+ method: string,
89
+ suffix = "",
90
+ body?: unknown,
91
+ resource: KubernetesResource = "pods",
92
+ ): Promise<T> {
93
+ const config = configuration(target);
94
+ const token = target.K8S_TOKEN?.trim() || (await Bun.file(config.tokenFile!).text()).trim();
95
+ if (!token) throw new Error("Kubernetes token is empty.");
96
+ const ca =
97
+ target.K8S_CA_CERT || (config.caFile ? await Bun.file(config.caFile).text() : undefined);
98
+ try {
99
+ const response = await fetch(
100
+ new URL(`/api/v1/namespaces/${config.namespace}/${resource}${suffix}`, config.url),
101
+ {
102
+ method,
103
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
104
+ body: body === undefined ? undefined : JSON.stringify(body),
105
+ redirect: "error",
106
+ signal: AbortSignal.timeout(30_000),
107
+ ...(ca ? { tls: { ca } } : {}),
108
+ },
109
+ );
110
+ if (!response.ok) {
111
+ await response.body?.cancel();
112
+ throw new KubernetesApiError(response.status, method, resource);
113
+ }
114
+ return (await response.json()) as T;
115
+ } catch (error) {
116
+ if (error instanceof KubernetesApiError) throw error;
117
+ throw new Error(redactWithEnv(scrubSecrets(String(error)), { K8S_TOKEN: token }));
118
+ }
119
+ }
120
+
121
+ /** The claim mounted at WORKSPACE_MOUNT_PATH, read from the pod spec, never from a label. */
122
+ function podWorkspaceKey(pod: Pod): string | undefined {
123
+ const mount = pod.spec?.containers
124
+ ?.flatMap((container) => container.volumeMounts ?? [])
125
+ .find((volumeMount) => volumeMount.mountPath === WORKSPACE_MOUNT_PATH);
126
+ return pod.spec?.volumes?.find((volume) => volume.name === mount?.name)?.persistentVolumeClaim
127
+ ?.claimName;
128
+ }
129
+
130
+ function podHandle(pod: Pod): RuntimeHandle {
131
+ const { workspaceKey: _label, ...labels } = pod.metadata.labels ?? {};
132
+ const workspaceKey = podWorkspaceKey(pod);
133
+ return {
134
+ kind: "k8s",
135
+ externalId: pod.metadata.name,
136
+ createdAt: pod.metadata.creationTimestamp,
137
+ meta: {
138
+ ...labels,
139
+ "k8s.namespace": pod.metadata.namespace,
140
+ "k8s.uid": pod.metadata.uid,
141
+ ...(workspaceKey ? { workspaceKey } : {}),
142
+ },
143
+ };
144
+ }
145
+
146
+ /**
147
+ * Gets or creates the agent's workspace claim. ReadWriteOncePod lets one pod mount it at a
148
+ * time, which is the infra fence against a second runtime in the same slot. No
149
+ * ownerReferences: the claim outlives the pod and the pool, and the swarm never deletes it.
150
+ */
151
+ async function ensureWorkspaceClaim(
152
+ target: RuntimeTargetConfig,
153
+ req: ProvisionRequest,
154
+ workspace: NonNullable<ProvisionRequest["workspace"]>,
155
+ ): Promise<void> {
156
+ const path = `/${encodeURIComponent(workspace.key)}`;
157
+ let claim: PersistentVolumeClaim;
158
+ try {
159
+ claim = await kubernetesApi<PersistentVolumeClaim>(
160
+ target,
161
+ "GET",
162
+ path,
163
+ undefined,
164
+ "persistentvolumeclaims",
165
+ );
166
+ } catch (error) {
167
+ if (!(error instanceof KubernetesApiError && error.statusCode === 404)) throw error;
168
+ claim = await kubernetesApi<PersistentVolumeClaim>(
169
+ target,
170
+ "POST",
171
+ "",
172
+ {
173
+ apiVersion: "v1",
174
+ kind: "PersistentVolumeClaim",
175
+ metadata: {
176
+ name: workspace.key,
177
+ namespace: configuration(target).namespace,
178
+ labels: {
179
+ [RUNTIME_LABELS.owner]: req.ownerId,
180
+ [RUNTIME_LABELS.agentId]: req.agentId,
181
+ [WORKSPACE_LABEL]: "true",
182
+ },
183
+ },
184
+ spec: {
185
+ accessModes: ["ReadWriteOncePod"],
186
+ resources: { requests: { storage: `${workspace.sizeGb ?? 20}Gi` } },
187
+ ...(target.K8S_STORAGE_CLASS ? { storageClassName: target.K8S_STORAGE_CLASS } : {}),
188
+ },
189
+ },
190
+ "persistentvolumeclaims",
191
+ );
192
+ }
193
+ const labels = claim.metadata.labels;
194
+ if (
195
+ claim.metadata.name !== workspace.key ||
196
+ labels?.[RUNTIME_LABELS.owner] !== req.ownerId ||
197
+ labels?.[RUNTIME_LABELS.agentId] !== req.agentId ||
198
+ labels?.[WORKSPACE_LABEL] !== "true"
199
+ )
200
+ throw new Error(`Workspace claim ${workspace.key} is not owned by this swarm and agent`);
201
+ }
202
+
203
+ function handlePath(target: RuntimeTargetConfig, handle: RuntimeHandle): string {
204
+ if (
205
+ handle.kind !== "k8s" ||
206
+ !handle.meta?.["k8s.uid"] ||
207
+ handle.meta["k8s.namespace"] !== configuration(target).namespace
208
+ )
209
+ throw new Error("Kubernetes handle must include a pod UID and the configured namespace.");
210
+ return `/${encodeURIComponent(handle.externalId)}`;
211
+ }
212
+
213
+ export class KubernetesRuntimeProvider implements RuntimeProvider {
214
+ readonly kind = "k8s" as const;
215
+ readonly traits = {
216
+ canProvision: true,
217
+ ephemeralDisk: true,
218
+ supportsPause: false,
219
+ persistentWorkspace: true,
220
+ };
221
+
222
+ checkConfig(target: RuntimeTargetConfig): ConfigStatus {
223
+ try {
224
+ configuration(target);
225
+ return { ready: true, missing: [] };
226
+ } catch (error) {
227
+ return { ready: false, missing: [], hint: scrubSecrets(String(error)) };
228
+ }
229
+ }
230
+
231
+ async provision(target: RuntimeTargetConfig, req: ProvisionRequest): Promise<RuntimeHandle> {
232
+ try {
233
+ if (req.cache) throw new Error("Kubernetes pools do not support persistent caches.");
234
+ const labels = {
235
+ ...req.labels,
236
+ [RUNTIME_LABELS.owner]: req.ownerId,
237
+ [RUNTIME_LABELS.runtimeId]: req.runtimeId,
238
+ [RUNTIME_LABELS.poolId]: req.poolId,
239
+ [RUNTIME_LABELS.agentId]: req.agentId,
240
+ };
241
+ const limits = {
242
+ ...(req.resources?.cpu ? { cpu: String(req.resources.cpu) } : {}),
243
+ ...(req.resources?.memoryMb ? { memory: `${req.resources.memoryMb}Mi` } : {}),
244
+ };
245
+ // Fail closed: a runtime never starts without its workspace.
246
+ if (req.workspace) await ensureWorkspaceClaim(target, req, req.workspace);
247
+ const name = `swarm-rt-${req.runtimeId}`;
248
+ const pod = await kubernetesApi<Pod>(target, "POST", "", {
249
+ apiVersion: "v1",
250
+ kind: "Pod",
251
+ metadata: { name, namespace: configuration(target).namespace, labels },
252
+ spec: {
253
+ restartPolicy: "Never",
254
+ automountServiceAccountToken: false,
255
+ ...(target.K8S_SERVICE_ACCOUNT ? { serviceAccountName: target.K8S_SERVICE_ACCOUNT } : {}),
256
+ ...(target.K8S_IMAGE_PULL_SECRETS
257
+ ? {
258
+ imagePullSecrets: target.K8S_IMAGE_PULL_SECRETS.split(",")
259
+ .map((name) => ({ name: name.trim() }))
260
+ .filter((secret) => secret.name),
261
+ }
262
+ : {}),
263
+ ...(req.ttlSec ? { activeDeadlineSeconds: req.ttlSec } : {}),
264
+ containers: [
265
+ {
266
+ name: "worker",
267
+ image: req.image,
268
+ env: Object.entries(req.env).map(([name, value]) => ({ name, value })),
269
+ ...(Object.keys(limits).length ? { resources: { requests: limits, limits } } : {}),
270
+ ...(req.workspace
271
+ ? { volumeMounts: [{ name: "workspace", mountPath: WORKSPACE_MOUNT_PATH }] }
272
+ : {}),
273
+ },
274
+ ],
275
+ ...(req.workspace
276
+ ? {
277
+ volumes: [
278
+ {
279
+ name: "workspace",
280
+ persistentVolumeClaim: { claimName: req.workspace.key },
281
+ },
282
+ ],
283
+ }
284
+ : {}),
285
+ },
286
+ });
287
+ const handle = podHandle(pod);
288
+ if (req.workspace) handle.meta = { ...handle.meta, workspaceKey: req.workspace.key };
289
+ return handle;
290
+ } catch (error) {
291
+ throw new Error(redactWithEnv(scrubSecrets(String(error)), req.env));
292
+ }
293
+ }
294
+
295
+ async terminate(target: RuntimeTargetConfig, handle: RuntimeHandle): Promise<void> {
296
+ const path = handlePath(target, handle);
297
+ try {
298
+ await kubernetesApi(target, "DELETE", path, {
299
+ apiVersion: "v1",
300
+ kind: "DeleteOptions",
301
+ preconditions: { uid: handle.meta!["k8s.uid"] },
302
+ });
303
+ } catch (error) {
304
+ // A UID conflict means another pod now uses the name. Preserve that pod.
305
+ if (!(error instanceof KubernetesApiError && [404, 409].includes(error.statusCode)))
306
+ throw error;
307
+ }
308
+ }
309
+
310
+ async status(target: RuntimeTargetConfig, handle: RuntimeHandle): Promise<RuntimeStatus> {
311
+ try {
312
+ const pod = await kubernetesApi<Pod>(target, "GET", handlePath(target, handle));
313
+ if (pod.metadata.uid !== handle.meta!["k8s.uid"]) return "exited";
314
+ if (pod.metadata.deletionTimestamp) return "exited";
315
+ switch (pod.status?.phase) {
316
+ case "Pending":
317
+ return "starting";
318
+ case "Running":
319
+ return "running";
320
+ case "Succeeded":
321
+ return "exited";
322
+ case "Failed":
323
+ return "failed";
324
+ default:
325
+ return "unknown";
326
+ }
327
+ } catch (error) {
328
+ return error instanceof KubernetesApiError && error.statusCode === 404 ? "exited" : "unknown";
329
+ }
330
+ }
331
+
332
+ async list(target: RuntimeTargetConfig, ownerId: string): Promise<RuntimeHandle[]> {
333
+ const query = new URLSearchParams({
334
+ labelSelector: `${RUNTIME_LABELS.owner}=${ownerId},${RUNTIME_LABELS.runtimeId}`,
335
+ limit: "500",
336
+ });
337
+ const handles: RuntimeHandle[] = [];
338
+ let continuation: string | undefined;
339
+ do {
340
+ if (continuation) query.set("continue", continuation);
341
+ const page = await kubernetesApi<{ items: Pod[]; metadata?: { continue?: string } }>(
342
+ target,
343
+ "GET",
344
+ `?${query}`,
345
+ );
346
+ for (const pod of page.items) {
347
+ const labels = pod.metadata.labels;
348
+ if (labels?.[RUNTIME_LABELS.owner] === ownerId && labels[RUNTIME_LABELS.runtimeId])
349
+ handles.push(podHandle(pod));
350
+ }
351
+ continuation = page.metadata?.continue;
352
+ } while (continuation);
353
+ return handles;
354
+ }
355
+ }
@@ -21,6 +21,8 @@ export interface RuntimeProviderTraits {
21
21
  supportsPause: boolean;
22
22
  /** Can mount a persistent cache shared by all runtimes of one pool. */
23
23
  persistentCache?: boolean;
24
+ /** Can mount a persistent per-agent workspace at WORKSPACE_MOUNT_PATH. */
25
+ persistentWorkspace?: boolean;
24
26
  /** Provider hard cap on runtime lifetime, if any. */
25
27
  maxTtlSec?: number;
26
28
  /** Continuous runtime limit for the configured infrastructure tier. */
@@ -49,6 +51,11 @@ export interface ProvisionRequest {
49
51
  resources?: { cpu?: number; memoryMb?: number };
50
52
  /** Provider-neutral cache identity, allocated by the API rather than the operator. */
51
53
  cache?: { key: string; mountPath: string };
54
+ /**
55
+ * Persistent workspace mounted at WORKSPACE_MOUNT_PATH. The adapter must echo
56
+ * `meta.workspaceKey` on the handle, or the supervisor terminates the runtime.
57
+ */
58
+ workspace?: { key: string; sizeGb?: number };
52
59
  ttlSec?: number;
53
60
  /** Ownership labels, used by list() to find runtimes this swarm started. */
54
61
  labels: Record<string, string>;
@@ -64,6 +71,13 @@ export function poolCacheKey(poolId: string, generation?: string): string {
64
71
  return `swarm-cache-${poolId}${generation ? `-${generation}` : ""}`;
65
72
  }
66
73
 
74
+ export const WORKSPACE_MOUNT_PATH = "/workspace/personal";
75
+
76
+ /** No pool and no generation: the volume outlives the pool and survives a rebind. */
77
+ export function workspaceVolumeKey(agentId: string, slot: number): string {
78
+ return `swarm-ws-${agentId.toLowerCase()}-${slot}`;
79
+ }
80
+
67
81
  export interface RuntimeHandle {
68
82
  kind: RuntimeProviderKind;
69
83
  /** Container id, sandbox id, or pod name. */
@@ -106,3 +120,6 @@ export const RUNTIME_LABELS = {
106
120
  poolId: "swarm.pool-id",
107
121
  agentId: "swarm.agent-id",
108
122
  } as const;
123
+
124
+ /** Marks a persistent workspace volume; releaseCache refuses anything carrying it. */
125
+ export const WORKSPACE_LABEL = "swarm.workspace";
@@ -96,7 +96,7 @@ export async function executeScheduleScript(schedule: ScheduledTask): Promise<vo
96
96
  agentId,
97
97
  scriptName: schedule.scriptName,
98
98
  // A pointer, not a copy: script schedules fire as often as every minute and
99
- // script_runs retention (SCRIPT_RUNS_RETENTION_DAYS) is off by default, so
99
+ // script_runs retention (SCRIPT_RUNS_RETENTION_DAYS) can be off, so
100
100
  // copying the source on every fire would grow the table by tens of MB a
101
101
  // day. script_versions keeps the text.
102
102
  source: `// Scheduled run of '${script.name}' v${script.version} (global, contentHash ${script.contentHash}) by schedule '${schedule.name}'.\n// Full source: script_versions row for this version.\n`,
@@ -778,6 +778,8 @@ declare module "swarm-sdk" {
778
778
  questions: Record<string, Record<string, unknown>>;
779
779
  timeoutMs?: number;
780
780
  maxRetries?: number;
781
+ /** Task whose session costs record this decision (default: the run's X-Source-Task-Id). */
782
+ taskId?: string;
781
783
  }): Promise<unknown>;
782
784
  }
783
785
 
@@ -352,7 +352,8 @@ declare module "swarm-extension" {
352
352
  runtimeInstanceId: string | undefined;
353
353
  sourceTaskId: string | undefined;
354
354
  contextKey: string | undefined;
355
- callOrigin: "mcp" | "extension" | "script-sdk";
355
+ callOrigin: "mcp" | "native" | "extension" | "script-sdk";
356
+ harness?: string | undefined;
356
357
  };
357
358
 
358
359
  import type { SwarmSdk } from "swarm-sdk";
@@ -394,7 +395,11 @@ declare module "swarm-extension" {
394
395
  };
395
396
  homepage?: string;
396
397
  author?: string;
398
+ /** Tool-call sources this extension's tool handlers receive. Default `["mcp"]`. */
399
+ toolSources?: readonly ToolSource[];
397
400
  }
401
+ /** `mcp`: swarm MCP tools. `native`: harness built-ins reported by a worker shim. */
402
+ export type ToolSource = "mcp" | "native";
398
403
  export interface HooksModule {
399
404
  default: SwarmExtension;
400
405
  config?: z.ZodTypeAny;
@@ -666,8 +671,16 @@ declare module "swarm-extension" {
666
671
  }
667
672
  export interface ToolCallEvent {
668
673
  tool: string;
674
+ /** Secret-scrubbed on native calls: a secret reads as `[REDACTED:<name>]`. */
669
675
  args: unknown;
670
676
  requestInfo: RequestInfo;
677
+ /** Native calls only: the harness's own tool name, such as `Bash`. */
678
+ nativeTool?: string;
679
+ /** Native calls only: the harness's own argument shape, secret-scrubbed. */
680
+ rawArgs?: unknown;
681
+ /** Native calls only: the harness's call id, and its parent for a nested call. */
682
+ toolCallId?: string;
683
+ parentToolCallId?: string;
671
684
  }
672
685
  export interface ToolCallModify {
673
686
  args: unknown;
@@ -797,6 +810,8 @@ declare module "swarm-extension" {
797
810
  export interface ToolCallCompletedEvent extends ToolCallEvent {
798
811
  result: unknown;
799
812
  durationMs: number;
813
+ /** Native calls only: the harness reported the call as failed. */
814
+ isError?: boolean;
800
815
  }
801
816
  export interface SwarmEventMap {
802
817
  "pre.task.create": {
@@ -736,6 +736,8 @@ declare module "swarm-sdk" {
736
736
  questions: Record<string, Record<string, unknown>>;
737
737
  timeoutMs?: number;
738
738
  maxRetries?: number;
739
+ /** Task whose session costs record this decision (default: the run's X-Source-Task-Id). */
740
+ taskId?: string;
739
741
  }): Promise<unknown>;
740
742
  }
741
743