@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
@@ -0,0 +1,310 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import { z } from "zod";
3
+ import { getTaskById } from "../be/db";
4
+ import {
5
+ clampTokenRatio,
6
+ createRequestComposition,
7
+ getLatestWorkerComposition,
8
+ getRequestCompositionsByTask,
9
+ getTokenRatio,
10
+ MAX_REQUEST_COMPOSITIONS_PER_TASK,
11
+ recordTokenRatio,
12
+ } from "../be/db/request-composition";
13
+ import { estimateTokens } from "../be/memory/key-browser";
14
+ import {
15
+ type RequestComposition,
16
+ type RequestCompositionPart,
17
+ RequestCompositionPartInputSchema,
18
+ RequestCompositionSchema,
19
+ type RequestCompositionToolLoading,
20
+ RequestCompositionToolLoadingSchema,
21
+ } from "../types";
22
+ import { resolveMcpSessionOptions } from "./mcp";
23
+ import { route } from "./route-def";
24
+ import { listSessionToolsMemo, measureToolSchemas } from "./tool-schema-estimate";
25
+ import { jsonError } from "./utils";
26
+
27
+ // ─── Response Schemas ───────────────────────────────────────────────────────
28
+
29
+ const PostRequestCompositionResponseSchema = z.object({
30
+ ok: z.literal(true),
31
+ id: z.uuid(),
32
+ seq: z.number().int().min(0),
33
+ });
34
+
35
+ const GetRequestCompositionResponseSchema = z.object({
36
+ manifests: z.array(RequestCompositionSchema),
37
+ });
38
+
39
+ // ─── Route Definitions ───────────────────────────────────────────────────────
40
+
41
+ const postRequestComposition = route({
42
+ method: "post",
43
+ path: "/api/tasks/{id}/request-composition",
44
+ pattern: ["api", "tasks", null, "request-composition"],
45
+ session: { taskParam: "id" },
46
+ rbac: {
47
+ ungated: "worker session telemetry, same posture as POST /api/tasks/{id}/context",
48
+ },
49
+ summary: "Record the request composition manifest of a task session",
50
+ description:
51
+ "The worker posts the size of each prompt part it assembled. The server adds the MCP tool-schema estimate for the agent's effective tool surface and stores the manifest as the session's next seq. A `harness-hook` post (pi, opencode) carries exact sizes measured from the request payload plus the call's prompt tokens: the server merges it with the session's worker manifest and folds the observed chars-to-tokens ratio into the provider's average. Only the agent assigned to the task may post, and a task keeps at most 100 manifests.",
52
+ tags: ["Tasks"],
53
+ params: z.object({ id: z.string() }),
54
+ body: z.object({
55
+ sessionId: z.string().min(1),
56
+ provider: z.string().min(1),
57
+ model: z.string().optional(),
58
+ toolLoading: RequestCompositionToolLoadingSchema,
59
+ parts: z.array(RequestCompositionPartInputSchema).max(200),
60
+ source: z.enum(["worker", "harness-hook"]).default("worker"),
61
+ /** Required for `harness-hook`: totals measured from the request payload. */
62
+ harness: z
63
+ .object({
64
+ systemChars: z.number().int().min(0),
65
+ payloadChars: z.number().int().min(0),
66
+ promptTokens: z.number().int().min(0),
67
+ firstMessageChars: z.number().int().min(0).optional(),
68
+ })
69
+ .optional(),
70
+ }),
71
+ responses: {
72
+ 200: { description: "Manifest recorded", schema: PostRequestCompositionResponseSchema },
73
+ 400: { description: "Validation error" },
74
+ 403: { description: "Task is assigned to another agent" },
75
+ 404: { description: "Task not found" },
76
+ 429: { description: "The task already holds the maximum number of manifests" },
77
+ },
78
+ auth: { apiKey: true, agentId: true },
79
+ });
80
+
81
+ const getRequestComposition = route({
82
+ method: "get",
83
+ path: "/api/tasks/{id}/request-composition",
84
+ pattern: ["api", "tasks", null, "request-composition"],
85
+ session: { taskParam: "id" },
86
+ summary: "Get the request composition manifests of a task",
87
+ tags: ["Tasks"],
88
+ params: z.object({ id: z.string() }),
89
+ query: z.object({
90
+ limit: z.coerce
91
+ .number()
92
+ .int()
93
+ .min(1)
94
+ .max(MAX_REQUEST_COMPOSITIONS_PER_TASK)
95
+ .default(MAX_REQUEST_COMPOSITIONS_PER_TASK),
96
+ }),
97
+ responses: {
98
+ 200: { description: "Manifests, oldest first", schema: GetRequestCompositionResponseSchema },
99
+ 404: { description: "Task not found" },
100
+ },
101
+ auth: { apiKey: true },
102
+ });
103
+
104
+ // ─── Tool schemas ────────────────────────────────────────────────────────────
105
+
106
+ const TOOL_SCHEMA_LABELS: Record<Exclude<RequestCompositionToolLoading, "none">, string> = {
107
+ all: "swarm tool schemas",
108
+ core: "swarm tool schemas (core + preloaded; deferred tools load into history)",
109
+ preloaded: "swarm tool schemas (preloaded only; deferred tools load into history)",
110
+ };
111
+
112
+ /**
113
+ * Estimate the swarm MCP tool schemas the harness sends with every call. The
114
+ * surface inputs (tool allowlist, capabilities, scripts-only, task manifests)
115
+ * are resolved server-side exactly as an MCP session resolves them; the
116
+ * loading mode is the worker's report. A failure drops the part, not the post.
117
+ */
118
+ async function toolSchemaPart(
119
+ agentId: string,
120
+ task: NonNullable<Awaited<ReturnType<typeof getTaskById>>>,
121
+ loading: RequestCompositionToolLoading,
122
+ ): Promise<RequestCompositionPart | null> {
123
+ if (loading === "none") return null;
124
+ try {
125
+ const tools = await listSessionToolsMemo(await resolveMcpSessionOptions(agentId, task));
126
+ const { chars } = measureToolSchemas(tools, loading);
127
+ return {
128
+ kind: "tool_schemas",
129
+ id: "mcp:agent-swarm",
130
+ label: TOOL_SCHEMA_LABELS[loading],
131
+ chars,
132
+ estTokens: estimateTokens(chars),
133
+ fidelity: "estimate",
134
+ };
135
+ } catch (err) {
136
+ console.warn(
137
+ `[request-composition] Tool schema estimate failed: ${err instanceof Error ? err.message : err}`,
138
+ );
139
+ return null;
140
+ }
141
+ }
142
+
143
+ // ─── Harness-hook manifests ──────────────────────────────────────────────────
144
+
145
+ /** Worker parts that are text inside the system prompt the harness sends. */
146
+ const SYSTEM_PROMPT_KINDS = new Set<RequestCompositionPart["kind"]>([
147
+ "system_section",
148
+ "persona",
149
+ "claude_md",
150
+ "operator_prompt",
151
+ ]);
152
+
153
+ /**
154
+ * Build a hook manifest's parts. The hook measured the whole system prompt,
155
+ * the tool declarations and the skills listing exactly. The worker manifest
156
+ * still names our sections, the task prompt and the memories, so they carry
157
+ * over; the system prompt chars they do not cover are the harness's own base
158
+ * prompt, now exact instead of a residual. On the session's first call the
159
+ * message text beyond our task prompt and memories is context the harness
160
+ * added (OpenCode's environment block, for one). Estimated tool schemas give
161
+ * way to the measured ones. Without a worker manifest the system prompt stays
162
+ * whole.
163
+ */
164
+ export function mergeHookParts(
165
+ hookParts: readonly RequestCompositionPart[],
166
+ harness: { systemChars: number; firstMessageChars?: number },
167
+ worker: RequestComposition | null,
168
+ ): RequestCompositionPart[] {
169
+ const exactPart = (id: string, label: string, chars: number): RequestCompositionPart => ({
170
+ kind: "system_section",
171
+ id,
172
+ label,
173
+ chars,
174
+ estTokens: estimateTokens(chars),
175
+ fidelity: "exact",
176
+ });
177
+ const hookSkillsChars = hookParts
178
+ .filter((part) => part.kind === "skills_listing")
179
+ .reduce((sum, part) => sum + part.chars, 0);
180
+ const harnessSystemChars = Math.max(0, harness.systemChars - hookSkillsChars);
181
+
182
+ if (!worker) {
183
+ return [exactPart("harness:system", "system prompt as sent", harnessSystemChars), ...hookParts];
184
+ }
185
+ const carried = worker.parts.filter(
186
+ (part) =>
187
+ part.kind !== "tool_schemas" && !(part.kind === "skills_listing" && hookSkillsChars > 0),
188
+ );
189
+ const ours = carried
190
+ .filter((part) => SYSTEM_PROMPT_KINDS.has(part.kind))
191
+ .reduce((sum, part) => sum + part.chars, 0);
192
+ const baseChars = harnessSystemChars - ours;
193
+ const messageExtraChars =
194
+ harness.firstMessageChars === undefined
195
+ ? 0
196
+ : harness.firstMessageChars -
197
+ carried
198
+ .filter((part) => part.kind === "task_prompt" || part.kind === "memories")
199
+ .reduce((sum, part) => sum + part.chars, 0);
200
+ return [
201
+ ...carried,
202
+ ...(baseChars > 0 ? [exactPart("harness:base", "harness base prompt", baseChars)] : []),
203
+ ...(messageExtraChars > 0
204
+ ? [exactPart("harness:messages", "harness context in the first message", messageExtraChars)]
205
+ : []),
206
+ ...hookParts,
207
+ ];
208
+ }
209
+
210
+ /** Observed tokens per `chars / 4`, or null when the call gives nothing to learn from. */
211
+ export function observedTokenRatio(promptTokens: number, payloadChars: number): number | null {
212
+ if (!(promptTokens > 0) || !(payloadChars > 0)) return null;
213
+ return promptTokens / (payloadChars / 4);
214
+ }
215
+
216
+ // ─── Handler ─────────────────────────────────────────────────────────────────
217
+
218
+ export async function handleRequestComposition(
219
+ req: IncomingMessage,
220
+ res: ServerResponse,
221
+ pathSegments: string[],
222
+ queryParams: URLSearchParams,
223
+ myAgentId: string | undefined,
224
+ ): Promise<boolean> {
225
+ if (postRequestComposition.match(req.method, pathSegments)) {
226
+ if (!myAgentId) {
227
+ jsonError(res, "Missing X-Agent-ID header", 400);
228
+ return true;
229
+ }
230
+
231
+ const parsed = await postRequestComposition.parse(req, res, pathSegments, queryParams);
232
+ if (!parsed) return true;
233
+
234
+ const task = await getTaskById(parsed.params.id);
235
+ if (!task) {
236
+ jsonError(res, "Task not found", 404);
237
+ return true;
238
+ }
239
+ if (task.agentId !== myAgentId) {
240
+ jsonError(res, "Task is assigned to another agent", 403);
241
+ return true;
242
+ }
243
+
244
+ const { body } = parsed;
245
+ let parts: RequestCompositionPart[] = body.parts.map((part) => ({
246
+ ...part,
247
+ estTokens: estimateTokens(part.chars),
248
+ }));
249
+ let tokenRatio: number;
250
+ if (body.source === "harness-hook") {
251
+ if (!body.harness) {
252
+ jsonError(res, "harness-hook manifests require `harness` totals", 400);
253
+ return true;
254
+ }
255
+ parts = mergeHookParts(parts, body.harness, await getLatestWorkerComposition(body.sessionId));
256
+ // This manifest keeps its own call's ratio, so its residual is ~0. The
257
+ // provider average serves the sessions that follow.
258
+ const observed = observedTokenRatio(body.harness.promptTokens, body.harness.payloadChars);
259
+ if (observed === null) {
260
+ tokenRatio = await getTokenRatio(body.provider);
261
+ } else {
262
+ tokenRatio = clampTokenRatio(observed);
263
+ await recordTokenRatio(body.provider, observed);
264
+ }
265
+ } else {
266
+ const toolPart = await toolSchemaPart(myAgentId, task, body.toolLoading);
267
+ if (toolPart) parts.push(toolPart);
268
+ tokenRatio = await getTokenRatio(body.provider);
269
+ }
270
+
271
+ const manifest = await createRequestComposition({
272
+ taskId: task.id,
273
+ agentId: myAgentId,
274
+ sessionId: body.sessionId,
275
+ provider: body.provider,
276
+ model: body.model,
277
+ source: body.source,
278
+ parts,
279
+ tokenRatio,
280
+ });
281
+ if (!manifest) {
282
+ jsonError(
283
+ res,
284
+ `Task already holds ${MAX_REQUEST_COMPOSITIONS_PER_TASK} request composition manifests`,
285
+ 429,
286
+ );
287
+ return true;
288
+ }
289
+
290
+ postRequestComposition.respond(res, 200, { ok: true, id: manifest.id, seq: manifest.seq });
291
+ return true;
292
+ }
293
+
294
+ if (getRequestComposition.match(req.method, pathSegments)) {
295
+ const parsed = await getRequestComposition.parse(req, res, pathSegments, queryParams);
296
+ if (!parsed) return true;
297
+
298
+ const task = await getTaskById(parsed.params.id);
299
+ if (!task) {
300
+ jsonError(res, "Task not found", 404);
301
+ return true;
302
+ }
303
+
304
+ const manifests = await getRequestCompositionsByTask(task.id, parsed.query.limit);
305
+ getRequestComposition.respond(res, 200, { manifests });
306
+ return true;
307
+ }
308
+
309
+ return false;
310
+ }
package/src/http/tasks.ts CHANGED
@@ -796,20 +796,32 @@ const runTaskUiActionRoute = route({
796
796
  rbac: { permission: "task.action.own" },
797
797
  summary: "Run the action a task card Button declares",
798
798
  description:
799
- "Runs the task card action once per task and action. Only the task requester may run it: a user token, or the operator key with the requester in `X-Swarm-User-Id`. Agent callers, and operator calls with no picked user, get 403. Needs UI_SPEC_ACTIONS_ENABLED=true.",
799
+ "Runs a task card action. Only the task requester may run it: a user token, or the operator key with the requester in `X-Swarm-User-Id`. Agent callers, and operator calls with no picked user, get 403. Needs UI_SPEC_ACTIONS_ENABLED=true. A `follow_up` action runs once per task and action. A `script` action re-runs its allowlisted script (UI_SPEC_SCRIPT_ACTIONS) and returns the new card; it can run again after a 30 s cooldown.",
800
800
  tags: ["Tasks"],
801
801
  params: z.object({ id: z.string(), actionId: z.string() }),
802
802
  responses: {
803
803
  200: {
804
- description: "The action started, or it already ran",
804
+ description:
805
+ "The follow-up started or already ran, or the script action replaced the card (`refreshed`, with the new `uiSpec`)",
805
806
  schema: z.object({
806
- status: z.enum(["started", "already_done"]),
807
+ status: z.enum(["started", "already_done", "refreshed"]),
807
808
  taskId: z.string().optional(),
809
+ uiSpec: TaskUiSpecSchema.optional(),
808
810
  }),
809
811
  },
810
- 403: { description: "Only the task requester may run the action" },
812
+ 403: {
813
+ description:
814
+ "Only the task requester may run the action, or the action's script is not allowlisted or changed since it was allowlisted",
815
+ },
811
816
  404: { description: "Task or action not found" },
812
- 409: { description: "Card actions are turned off (UI_SPEC_ACTIONS_ENABLED)" },
817
+ 409: {
818
+ description:
819
+ "Card actions are turned off (UI_SPEC_ACTIONS_ENABLED), or the script action is already running (with `Retry-After`)",
820
+ },
821
+ 422: { description: "The script failed or returned an invalid card; the old card stays" },
822
+ 429: {
823
+ description: "The script action ran recently; `Retry-After` says when it can run again",
824
+ },
813
825
  },
814
826
  });
815
827
 
@@ -820,7 +832,7 @@ const supersedeTaskRoute = route({
820
832
  session: { taskParam: "id" },
821
833
  summary: "Supersede an in-progress task (terminate + spawn resume follow-up)",
822
834
  description:
823
- "Marks the original task `superseded` (terminal) and creates a fresh `taskType=\"resume\"` follow-up so a worker can pick up the work in a new provider session. Workflow-step tasks (those with `workflowRunStepId`) are carved out: the original is marked `failed` with reason `superseded_workflow_task` and no follow-up is created — the workflow engine's retry/failure policy applies, and the task moves to `superseded` once the engine queues the step's retry. With `reason: provider_fallback` (and its `errorClass`), the resume runs on the same agent with the next fallback profile that passes the profile check; when none is left, or the task is a workflow step, nothing changes and `kind: noFallback` tells the worker to fail the task itself, led by `failureReason` when set.",
835
+ "Marks the original task `superseded` (terminal) and creates a fresh `taskType=\"resume\"` follow-up so a worker can pick up the work in a new provider session. Workflow-step tasks (those with `workflowRunStepId`) are carved out: the original is marked `failed` with reason `superseded_workflow_task` and no follow-up is created — the workflow engine's retry/failure policy applies, and the task moves to `superseded` once the engine queues the step's retry or the step ends without failing. With `reason: provider_fallback` (and its `errorClass`), the resume runs on the same agent: on the same profile while a key-scoped error (`rate_limit`, `credits`) leaves another unbenched key in its pool, else on the next fallback profile that passes the profile check; when none is left, or the task is a workflow step, nothing changes and `kind: noFallback` tells the worker to fail the task itself, led by `failureReason` when set.",
824
836
  tags: ["Tasks"],
825
837
  params: z.object({ id: z.string() }),
826
838
  body: z
@@ -2235,8 +2247,31 @@ export async function handleTasks(
2235
2247
  runTaskUiActionRoute.respond(res, 200, { status: "already_done" });
2236
2248
  return true;
2237
2249
  case "started":
2250
+ case "refreshed":
2238
2251
  runTaskUiActionRoute.respond(res, 200, result);
2239
2252
  return true;
2253
+ case "not_allowlisted":
2254
+ jsonError(res, "This action's script is not allowlisted (UI_SPEC_SCRIPT_ACTIONS)", 403);
2255
+ return true;
2256
+ case "script_changed":
2257
+ jsonError(
2258
+ res,
2259
+ "This action's script changed since it was allowlisted; an admin must re-pin it in UI_SPEC_SCRIPT_ACTIONS",
2260
+ 403,
2261
+ );
2262
+ return true;
2263
+ case "running":
2264
+ res.setHeader("Retry-After", String(result.retryAfterSec));
2265
+ jsonError(res, "This action is already running", 409);
2266
+ return true;
2267
+ case "rate_limited":
2268
+ res.setHeader("Retry-After", String(result.retryAfterSec));
2269
+ jsonError(res, `This action ran recently; try again in ${result.retryAfterSec}s`, 429);
2270
+ return true;
2271
+ case "script_failed":
2272
+ case "invalid_output":
2273
+ jsonError(res, `Refresh failed: ${result.error}`, 422);
2274
+ return true;
2240
2275
  }
2241
2276
  }
2242
2277
 
@@ -2349,6 +2384,11 @@ export async function handleTasks(
2349
2384
  return true;
2350
2385
  }
2351
2386
  fallback = { profile: pick.profile, hop: pick.hop };
2387
+ if (pick.hop.from === pick.profile) {
2388
+ console.log(
2389
+ `[Supersede] Task ${task.id.slice(0, 8)} hit ${pick.hop.errorClass} on ${pick.profile} (key ...${task.credentialKeySuffix ?? "?"}); retrying the profile on another key`,
2390
+ );
2391
+ }
2352
2392
  }
2353
2393
 
2354
2394
  // Workflow-step tasks: fail back to the engine instead of superseding.
@@ -0,0 +1,140 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import { z } from "zod";
3
+ import type { ToolCallEvent } from "../extensions/contract";
4
+ import { dispatchPost, dispatchPre } from "../extensions/dispatcher";
5
+ import type { RequestInfo } from "../tools/utils";
6
+ import { scrubObject } from "../utils/secret-scrubber";
7
+ import { route } from "./route-def";
8
+ import { jsonError } from "./utils";
9
+
10
+ const REDACTION_MARKER = "[REDACTED:";
11
+
12
+ const toolCallFields = {
13
+ harness: z.string().min(1).max(64).describe("Worker harness, such as `claude` or `pi`."),
14
+ tool: z.string().min(1).max(256).describe("Canonical tool name, such as `bash` or `edit`."),
15
+ nativeTool: z.string().min(1).max(256).optional().describe("The harness's own tool name."),
16
+ args: z.unknown().describe("Canonical tool arguments."),
17
+ rawArgs: z.unknown().optional().describe("The harness's own argument shape."),
18
+ toolCallId: z.string().max(256).optional(),
19
+ parentToolCallId: z.string().max(256).optional(),
20
+ };
21
+
22
+ const toolHookBody = z.discriminatedUnion("phase", [
23
+ z.object({ phase: z.literal("pre"), ...toolCallFields }),
24
+ z.object({
25
+ phase: z.literal("post"),
26
+ ...toolCallFields,
27
+ result: z.unknown(),
28
+ isError: z.boolean().optional(),
29
+ durationMs: z.number().nonnegative(),
30
+ }),
31
+ ]);
32
+
33
+ const toolHookDecision = z.discriminatedUnion("action", [
34
+ z.object({ action: z.literal("continue") }),
35
+ z.object({ action: z.literal("modify"), args: z.unknown() }),
36
+ z.object({ action: z.literal("block"), reason: z.string() }),
37
+ ]);
38
+
39
+ const toolHookRoute = route({
40
+ method: "post",
41
+ path: "/api/tool-hooks",
42
+ pattern: ["api", "tool-hooks"],
43
+ summary: "Run extension tool hooks for a harness-native tool call",
44
+ description:
45
+ "A worker shim reports a harness built-in tool call (bash, read, write, edit). `phase: pre` " +
46
+ "runs `pre.tool.call` with `callOrigin: native` and returns the decision. `phase: post` runs " +
47
+ "`post.tool.call` observe-only and returns 202 at once. Only extensions whose manifest " +
48
+ '`toolSources` includes `"native"` receive these calls. The server runs the secret scrubber ' +
49
+ "over the body before any handler sees it, so handlers read `[REDACTED:<name>]` in place of " +
50
+ "a secret. A `modify` whose args still carry that marker is rejected and the call continues " +
51
+ "unchanged. Shims must also scrub worker-side before sending.",
52
+ tags: ["Extensions"],
53
+ auth: { apiKey: true, agentId: true },
54
+ body: toolHookBody,
55
+ maxBodyBytes: 2 * 1024 * 1024,
56
+ rbac: { ungated: "self-scoped: an agent reports its own harness tool calls" },
57
+ responses: {
58
+ 200: { description: "Pre-call decision", schema: toolHookDecision },
59
+ 202: {
60
+ description: "Post-call event accepted",
61
+ schema: z.object({ accepted: z.literal(true) }),
62
+ },
63
+ 400: { description: "Invalid body or missing X-Agent-ID header" },
64
+ },
65
+ });
66
+
67
+ function header(req: IncomingMessage, name: string): string | undefined {
68
+ const raw = req.headers[name];
69
+ return Array.isArray(raw) ? raw[0] : raw;
70
+ }
71
+
72
+ export async function handleToolHooks(
73
+ req: IncomingMessage,
74
+ res: ServerResponse,
75
+ pathSegments: string[],
76
+ queryParams: URLSearchParams,
77
+ myAgentId: string | undefined,
78
+ ): Promise<boolean> {
79
+ if (!toolHookRoute.match(req.method, pathSegments)) return false;
80
+ if (!myAgentId) {
81
+ jsonError(res, "Missing X-Agent-ID header", 400);
82
+ return true;
83
+ }
84
+ const parsed = await toolHookRoute.parse(req, res, pathSegments, queryParams);
85
+ if (!parsed) return true;
86
+
87
+ // Scrub at entry: handlers, extension_runs rows and logs only ever see the scrubbed body.
88
+ const body = scrubObject(parsed.body);
89
+ const requestInfo: RequestInfo = {
90
+ sessionId: undefined,
91
+ agentId: myAgentId,
92
+ runtimeInstanceId: header(req, "x-runtime-instance-id"),
93
+ sourceTaskId: header(req, "x-source-task-id"),
94
+ contextKey: header(req, "x-context-key"),
95
+ callOrigin: "native",
96
+ harness: body.harness,
97
+ };
98
+ const event: ToolCallEvent = {
99
+ tool: body.tool,
100
+ args: body.args,
101
+ requestInfo,
102
+ nativeTool: body.nativeTool,
103
+ rawArgs: body.rawArgs,
104
+ toolCallId: body.toolCallId,
105
+ parentToolCallId: body.parentToolCallId,
106
+ };
107
+
108
+ if (body.phase === "post") {
109
+ toolHookRoute.respond(res, 202, { accepted: true });
110
+ void dispatchPost("post.tool.call", {
111
+ ...event,
112
+ result: body.result,
113
+ isError: body.isError,
114
+ durationMs: body.durationMs,
115
+ });
116
+ return true;
117
+ }
118
+
119
+ const result = await dispatchPre("pre.tool.call", event, {
120
+ // A marker in rewritten args is a placeholder, not the secret: executing it would break
121
+ // the call, so the rewrite is refused (an extension_runs error row) and the call continues.
122
+ validateModify: (data) =>
123
+ JSON.stringify(data.args ?? null).includes(REDACTION_MARKER)
124
+ ? {
125
+ success: false,
126
+ error: new Error(
127
+ `Modified arguments for native tool "${body.tool}" contain a redaction marker`,
128
+ ),
129
+ }
130
+ : { success: true, data },
131
+ });
132
+ if (result.action === "block") {
133
+ toolHookRoute.respond(res, 200, { action: "block", reason: result.reason });
134
+ } else if (result.action === "modify") {
135
+ toolHookRoute.respond(res, 200, { action: "modify", args: result.data.args });
136
+ } else {
137
+ toolHookRoute.respond(res, 200, { action: "continue" });
138
+ }
139
+ return true;
140
+ }
@@ -0,0 +1,95 @@
1
+ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
2
+ import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
3
+ import { createServer } from "@/server";
4
+ import { CORE_TOOLS } from "@/tools/tool-config";
5
+ import type { RequestCompositionToolLoading } from "@/types";
6
+ import type { McpSessionOptions } from "./mcp";
7
+
8
+ /** One entry of an MCP `tools/list` response, as the harness receives it. */
9
+ export type ListedTool = {
10
+ name: string;
11
+ description?: string;
12
+ inputSchema: unknown;
13
+ _meta?: Record<string, unknown>;
14
+ };
15
+
16
+ export type ToolSchemaEstimate = {
17
+ /** Chars the harness sends up front: loaded schemas plus deferred tool names. */
18
+ chars: number;
19
+ loadedCount: number;
20
+ deferredCount: number;
21
+ };
22
+
23
+ const isAlwaysLoad = (tool: ListedTool): boolean => tool._meta?.["anthropic/alwaysLoad"] === true;
24
+
25
+ /**
26
+ * Size a tool list the way each harness sends it. A loaded tool costs its
27
+ * name, description and JSON schema. A deferred tool costs only its name in
28
+ * the harness's deferred-tool listing; its schema enters history when loaded.
29
+ */
30
+ export function measureToolSchemas(
31
+ tools: readonly ListedTool[],
32
+ loading: RequestCompositionToolLoading,
33
+ ): ToolSchemaEstimate {
34
+ if (loading === "none") return { chars: 0, loadedCount: 0, deferredCount: 0 };
35
+ const isLoaded = (tool: ListedTool): boolean => {
36
+ if (loading === "all") return true;
37
+ if (loading === "core") return CORE_TOOLS.has(tool.name) || isAlwaysLoad(tool);
38
+ return isAlwaysLoad(tool);
39
+ };
40
+ let chars = 0;
41
+ let loadedCount = 0;
42
+ for (const tool of tools) {
43
+ if (isLoaded(tool)) {
44
+ loadedCount++;
45
+ chars += JSON.stringify({
46
+ name: tool.name,
47
+ description: tool.description ?? "",
48
+ input_schema: tool.inputSchema,
49
+ }).length;
50
+ } else {
51
+ chars += tool.name.length + 1;
52
+ }
53
+ }
54
+ return { chars, loadedCount, deferredCount: tools.length - loadedCount };
55
+ }
56
+
57
+ /** List the tools an MCP session built from `opts` would expose. */
58
+ async function listSessionTools(opts: McpSessionOptions): Promise<ListedTool[]> {
59
+ const server = await createServer(opts);
60
+ const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
61
+ await server.connect(serverTransport);
62
+ const client = new Client({ name: "request-composition-estimate", version: "1" });
63
+ try {
64
+ await client.connect(clientTransport);
65
+ return (await client.listTools()).tools;
66
+ } finally {
67
+ await client.close();
68
+ await server.close();
69
+ }
70
+ }
71
+
72
+ // Schemas are static per build; the surface depends only on these inputs.
73
+ const MAX_MEMO_ENTRIES = 32;
74
+ const toolListMemo = new Map<string, Promise<ListedTool[]>>();
75
+
76
+ /** Clear memoised tool lists (tests). */
77
+ export function resetToolSchemaMemo(): void {
78
+ toolListMemo.clear();
79
+ }
80
+
81
+ /** The `tools/list` payload for one session surface, memoised per input set. */
82
+ export function listSessionToolsMemo(opts: McpSessionOptions): Promise<ListedTool[]> {
83
+ const key = JSON.stringify({
84
+ opts,
85
+ capabilities: process.env.CAPABILITIES ?? null,
86
+ chatSdk: process.env.CHAT_SDK_ENABLED ?? null,
87
+ });
88
+ const cached = toolListMemo.get(key);
89
+ if (cached) return cached;
90
+ if (toolListMemo.size >= MAX_MEMO_ENTRIES) toolListMemo.clear();
91
+ const pending = listSessionTools(opts);
92
+ toolListMemo.set(key, pending);
93
+ pending.catch(() => toolListMemo.delete(key));
94
+ return pending;
95
+ }