@desplega.ai/agent-swarm 2.10.0 → 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 (378) hide show
  1. package/dist/acp-adapter-weaaxey3.js +16 -0
  2. package/dist/{acp-targets-arrwv4f0.js → acp-targets-5wyy2b9m.js} +9 -9
  3. package/dist/{actions-y0d2n1c2.js → actions-4nxq386s.js} +24 -23
  4. package/dist/{agent-fs-provision-tpj7sktd.js → agent-fs-provision-v6enh76w.js} +4 -4
  5. package/dist/{amp-adapter-vmmnmw8d.js → amp-adapter-ze3x22qn.js} +3 -3
  6. package/dist/{anthropic-messages-zdca3gv1.js → anthropic-messages-88b7s3n9.js} +177 -25
  7. package/dist/{app-wb7w45dq.js → app-kyqt8ehw.js} +7 -6
  8. package/dist/{approval-notifications-7mqr6vbd.js → approval-notifications-a0db0esw.js} +7 -6
  9. package/dist/{assistant-gf60454p.js → assistant-9g5jzq25.js} +26 -25
  10. package/dist/{azure-openai-responses-b3y7fz36.js → azure-openai-responses-jeaas6x0.js} +10 -10
  11. package/dist/{boot-args-schema-qxmd59sr.js → boot-args-schema-d7fme4q1.js} +1 -1
  12. package/dist/{boot-reembed-wb44vc3s.js → boot-reembed-6wpazmpw.js} +1 -1
  13. package/dist/{boot-reembed-5tmeskj2.js → boot-reembed-jrwxeye2.js} +1 -1
  14. package/dist/{boot-scrub-sweep-25bxhnw4.js → boot-scrub-sweep-52h7yntp.js} +2 -2
  15. package/dist/{boot-seeds-nj9za0vk.js → boot-seeds-kb3dxjex.js} +4 -4
  16. package/dist/{boxd-wn235q80.js → boxd-jrrmkv3w.js} +2 -2
  17. package/dist/{claude-adapter-d3krpdyb.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-7y4pwd81.js → claude-managed-setup-9ssb7ct4.js} +4 -4
  20. package/dist/{claude-sdk-session-d138zy0e.js → claude-sdk-session-p6t0gyse.js} +10941 -10412
  21. package/dist/{cli-p0n7b5rz.js → cli-075ccjh6.js} +344 -130
  22. package/dist/{cli-3caf7pmg.js → cli-0bgj4rh5.js} +3 -3
  23. package/dist/{cli-7r162fxe.js → cli-14xdms9a.js} +23 -17
  24. package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
  25. package/dist/{cli-y4ccxtz5.js → cli-1h4njv9y.js} +144 -6
  26. package/dist/{cli-6ym4jhzp.js → cli-27fat7st.js} +7 -7
  27. package/dist/{cli-k3q2va86.js → cli-2aacfdcn.js} +5 -5
  28. package/dist/{cli-vq2eg24x.js → cli-2gvdvsxj.js} +3 -3
  29. package/dist/{cli-sb4426be.js → cli-2jtfm8kh.js} +5 -5
  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-5qhfv9rw.js → cli-453497a0.js} +44 -17
  33. package/dist/{cli-2rnd5j3t.js → cli-4aswccje.js} +2 -2
  34. package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
  35. package/dist/{cli-p0c3vtch.js → cli-4g323fjh.js} +772 -515
  36. package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
  37. package/dist/{cli-fcfbct2j.js → cli-4kzp7r0q.js} +5 -5
  38. package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
  39. package/dist/{cli-zeh2mhkg.js → cli-5ptj757f.js} +1 -1
  40. package/dist/{cli-539h29es.js → cli-6a3j25xd.js} +224 -189
  41. package/dist/{cli-hnamkvnc.js → cli-6c9ve77f.js} +2 -2
  42. package/dist/{cli-3et6fmfe.js → cli-6n7y5ypy.js} +1 -1
  43. package/dist/{cli-8y43jx2r.js → cli-6p8p2e6r.js} +16 -9
  44. package/dist/{cli-zk7v5s89.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-6037prsx.js → cli-892y3vfp.js} +13 -13
  48. package/dist/cli-8mfdbdhe.js +43 -0
  49. package/dist/{cli-s1zqk1aj.js → cli-8zmpwe79.js} +15 -9
  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-aw83sr40.js → cli-9knhkkgr.js} +3 -3
  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-6cwr32fe.js → cli-a02habn6.js} +422 -140
  57. package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
  58. package/dist/{cli-3f8zbtqa.js → cli-a6q6x15h.js} +9 -8
  59. package/dist/{cli-j6te8keb.js → cli-atm0hkes.js} +8 -8
  60. package/dist/{cli-9fjr27ez.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-mk7c5ac4.js → cli-bq97k63w.js} +2 -2
  64. package/dist/{cli-vfqvrd82.js → cli-cstggwq7.js} +2 -2
  65. package/dist/{cli-md50mj0r.js → cli-czvvnfr9.js} +3 -3
  66. package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
  67. package/dist/{cli-fq2rr3jb.js → cli-djt6wmrc.js} +6 -6
  68. package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
  69. package/dist/{cli-z0m452jr.js → cli-f7dhm7hh.js} +1 -1
  70. package/dist/{cli-mys27d03.js → cli-f8yhybxr.js} +3 -3
  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-y8p78ekx.js → cli-h2qtafm4.js} +18 -18
  74. package/dist/{cli-psffsanb.js → cli-ha4ek2nb.js} +6 -1
  75. package/dist/{cli-th1dkc2v.js → cli-hnh8erra.js} +2 -2
  76. package/dist/{cli-w16kwbzw.js → cli-htymm48w.js} +1 -1
  77. package/dist/{cli-124ntmf0.js → cli-j2r1apqm.js} +138 -59
  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-v8z0yga9.js → cli-k4r5sfaj.js} +4 -4
  81. package/dist/{cli-91pkxres.js → cli-kbm659dk.js} +2 -2
  82. package/dist/{cli-q5srsxq2.js → cli-m00c47q6.js} +110 -27
  83. package/dist/{cli-3aaeb78m.js → cli-mhrr4d5b.js} +95 -10
  84. package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
  85. package/dist/{cli-qrta34nb.js → cli-n6ygvrrm.js} +4 -4
  86. package/dist/{cli-k5yewqgd.js → cli-nbakg5xh.js} +3 -3
  87. package/dist/{cli-nstkanmx.js → cli-nc39ym5q.js} +8 -8
  88. package/dist/{cli-01k6wpr9.js → cli-p1a4khta.js} +7 -7
  89. package/dist/{cli-t9ga4qmb.js → cli-p8zqbbt1.js} +40 -33
  90. package/dist/{cli-v46zsvqk.js → cli-ph95yejc.js} +2 -2
  91. package/dist/{cli-k6nejceb.js → cli-q4z9s6zs.js} +2 -2
  92. package/dist/{cli-kbtzfrxj.js → cli-q71g5q39.js} +3 -3
  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-cc93xzes.js → cli-raqw9fw9.js} +28 -17
  98. package/dist/cli-rhsc2zyx.js +68 -0
  99. package/dist/{cli-8st34zhr.js → cli-rpmw4fsv.js} +57 -19
  100. package/dist/{cli-had1p04a.js → cli-rwgwen5v.js} +4 -4
  101. package/dist/{cli-tr27kwyg.js → cli-rytq7dm2.js} +261 -6
  102. package/dist/{cli-s1khw52h.js → cli-s9twe4x0.js} +66 -17
  103. package/dist/{cli-2v2zdm0a.js → cli-t2s7j5cy.js} +2 -2
  104. package/dist/{cli-nv4xsvmk.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-jrbq4djp.js → cli-v3zcnr8g.js} +1 -1
  108. package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
  109. package/dist/{cli-qx4f057j.js → cli-vy3fn0mz.js} +4 -4
  110. package/dist/{cli-7sf9sb0w.js → cli-w5dar1bk.js} +1 -1
  111. package/dist/{cli-w1q68d8x.js → cli-wz4e5am2.js} +9 -9
  112. package/dist/{cli-m9cvf7vs.js → cli-xqbqwpxr.js} +14 -14
  113. package/dist/{cli-2spnz7ye.js → cli-ynph3b70.js} +11137 -8332
  114. package/dist/{cli-43evxwj4.js → cli-yvzxbztc.js} +9 -4
  115. package/dist/{cli-vsw91x06.js → cli-yzxqwcvq.js} +3 -6
  116. package/dist/{cli-wafmk3fn.js → cli-zb1hff00.js} +12 -12
  117. package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
  118. package/dist/{cli-wwp1bd3n.js → cli-zhn4r1rz.js} +519 -75
  119. package/dist/{cli-tvgqesec.js → cli-zqq57pgx.js} +4 -4
  120. package/dist/cli.js +28 -27
  121. package/dist/{cloudflare-workers-ai-system-one-4aysy6rh.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
  122. package/dist/{codex-adapter-exfdbj73.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-xhznc4g3.js → codex-session-runner-xn63q3h7.js} +9 -9
  126. package/dist/{commands-d8g349v4.js → commands-ctey7tr5.js} +3 -3
  127. package/dist/{controller-mwgdmb8y.js → controller-rqhbppg9.js} +4 -4
  128. package/dist/{controllers-connect-5v7qx04j.js → controllers-connect-w3qbpbt1.js} +22 -21
  129. package/dist/{core-sxy4epp2.js → core-df1n049h.js} +19 -18
  130. package/dist/{cursor-adapter-p2q5h35d.js → cursor-adapter-r819hf1a.js} +2 -2
  131. package/dist/{db-wcw0b2j8.js → db-2ah39cyx.js} +2 -2
  132. package/dist/{db-qpganbeb.js → db-p5drc1d1.js} +3 -3
  133. package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-bc6g0x29.js} +1 -1
  134. package/dist/{dispatcher-8d8s49yz.js → dispatcher-x6w14pde.js} +19 -18
  135. package/dist/{docker-09tkkg0n.js → docker-6c4reetq.js} +51 -14
  136. package/dist/{dsh-adapter-me0twn13.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-wv7w5ty6.js → easter-egg-3d-1y6r9gxy.js} +1 -1
  140. package/dist/{embedding-space-e48xchqa.js → embedding-space-z6ptw3jk.js} +6 -6
  141. package/dist/{embeddings-tgq2afbq.js → embeddings-0sxb1d2h.js} +1 -1
  142. package/dist/{event-bus-xr83x566.js → event-bus-swr88jg5.js} +1 -1
  143. package/dist/{execute-8rhwrk7f.js → execute-6m1ex8ce.js} +8 -4
  144. package/dist/{external-channel-8bt3j2pm.js → external-channel-ezer7pk0.js} +2 -2
  145. package/dist/fx-adapter-zwmps9re.js +19 -0
  146. package/dist/{google-generative-ai-bh0djqjp.js → google-generative-ai-sw77egmr.js} +9 -9
  147. package/dist/{google-vertex-prjbw8dj.js → google-vertex-rrw93g8h.js} +9 -9
  148. package/dist/grok-adapter-q0avf919.js +19 -0
  149. package/dist/handlers-g5jq0e4q.js +36 -0
  150. package/dist/{heartbeat-x0056ra5.js → heartbeat-6c4fr49t.js} +22 -21
  151. package/dist/{hook-mrd2ayxv.js → hook-02rt5tvq.js} +8 -8
  152. package/dist/{hook-a7vmn2st.js → hook-t1c5avbv.js} +5 -5
  153. package/dist/{http-ym9c5svp.js → http-qa3h32a1.js} +2049 -148
  154. package/dist/index-1f6m47mq.js +37 -0
  155. package/dist/index-1p1mpqda.js +36 -0
  156. package/dist/{index-p46tvwtx.js → index-akbgsdhh.js} +25 -24
  157. package/dist/{index-ny60jcat.js → index-e42j998x.js} +16 -13
  158. package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
  159. package/dist/{index-01ns1pkw.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-x6azjwm8.js → index-qpjk2hxk.js} +1 -1
  163. package/dist/index-tnkd410q.js +41 -0
  164. package/dist/{k8s-m56sw868.js → k8s-7jrh5va2.js} +73 -14
  165. package/dist/{keepalive-7yxg8z4c.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-6tefxmk1.js → maintenance-g7v15tj1.js} +1 -1
  169. package/dist/{mistral-conversations-tm2vd4gc.js → mistral-conversations-w4bncwbt.js} +7 -7
  170. package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
  171. package/dist/{oauth-refresh-sweep-70cavc3a.js → oauth-refresh-sweep-ywgf8tbr.js} +3 -3
  172. package/dist/{onboard-fja65z08.js → onboard-m3fedypq.js} +3 -3
  173. package/dist/{openai-codex-responses-sxjv60xx.js → openai-codex-responses-70g39cgz.js} +20 -14
  174. package/dist/{openai-completions-0c7qnhsx.js → openai-completions-cv3hp4h5.js} +18 -11
  175. package/dist/{openai-decisions-ytp6w6xh.js → openai-decisions-fyq1p9f9.js} +2 -2
  176. package/dist/{openai-responses-a7h29chp.js → openai-responses-trsvnks6.js} +13 -11
  177. package/dist/{opencode-adapter-hakkm7yh.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-7zhnt6gj.js → otel-impl-3ehm1hgc.js} +2 -2
  180. package/dist/{pending-h01yzpx4.js → pending-fwj2fatd.js} +20 -19
  181. package/dist/{pi-messages-2j0fpqwq.js → pi-messages-zk3g4esn.js} +1 -1
  182. package/dist/{pi-mono-adapter-f52hz743.js → pi-mono-adapter-xdeesvc4.js} +18 -17
  183. package/dist/{pricing-refresh-fzxvk2zf.js → pricing-refresh-4j8dzvxg.js} +2 -2
  184. package/dist/{rbac-roles-9v6vhgbs.js → rbac-roles-8msjr07m.js} +3 -3
  185. package/dist/{rbac-roles-hfgh8sba.js → rbac-roles-n7t2acv8.js} +2 -2
  186. package/dist/{render-v2-1rgspxzf.js → render-v2-j7qggj8h.js} +7 -6
  187. package/dist/{resume-tqy61x24.js → resume-hj1mn65y.js} +9 -8
  188. package/dist/{runtime-exkxyx5f.js → runtime-z31mdsgv.js} +2 -2
  189. package/dist/{session-access-3act7vt4.js → session-access-w38fh09a.js} +4 -4
  190. package/dist/{session-source-backfill-82qe7fqq.js → session-source-backfill-ax6qxv20.js} +3 -3
  191. package/dist/{setup-ry1vfdef.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-vcfj2ak8.js → typesafe-system-one-qkvkgrcz.js} +2 -2
  195. package/dist/{user-merge-jobs-bx6bf7db.js → user-merge-jobs-mvheb3ed.js} +3 -3
  196. package/dist/{virtual-modules-s0rjzcqq.js → virtual-modules-w2qk2wew.js} +32 -10
  197. package/dist/{work-objects-z2e5tv03.js → work-objects-4ahy5es5.js} +22 -21
  198. package/dist/worker-ews1nyhw.js +75 -0
  199. package/dist/{worker-follow-up-y3xeg89w.js → worker-follow-up-1gs4aw7y.js} +19 -18
  200. package/dist/{x-wg164ss9.js → x-3wr8c5sh.js} +2 -2
  201. package/openapi.json +995 -49
  202. package/package.json +9 -8
  203. package/src/be/db/request-composition.ts +190 -0
  204. package/src/be/db/runtime.ts +15 -0
  205. package/src/be/db/slack-trees.ts +220 -10
  206. package/src/be/db/tasks/human-free.ts +3 -2
  207. package/src/be/db/workflow-run-retention.ts +101 -0
  208. package/src/be/db-client.ts +23 -1
  209. package/src/be/db-retention-defaults.ts +46 -0
  210. package/src/be/db-retention.ts +55 -6
  211. package/src/be/mcp-events/catalog.ts +108 -0
  212. package/src/be/mcp-events/dispatcher.ts +202 -0
  213. package/src/be/mcp-events/protocol.ts +296 -0
  214. package/src/be/mcp-events/store.ts +231 -0
  215. package/src/be/mcp-events/webhook.ts +226 -0
  216. package/src/be/memory/providers/sqlite-store.ts +110 -24
  217. package/src/be/memory/review-recall-filter.ts +22 -0
  218. package/src/be/memory/search-candidates.ts +5 -7
  219. package/src/be/memory/types.ts +5 -0
  220. package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
  221. package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
  222. package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
  223. package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
  224. package/src/be/migrations/329_workflow_run_retention.sql +9 -0
  225. package/src/be/migrations/330_request_composition.sql +22 -0
  226. package/src/be/model-profile-check.ts +1 -1
  227. package/src/be/multi-runtime.ts +32 -4
  228. package/src/be/runtime-pools/controllers.ts +18 -3
  229. package/src/be/runtime-pools/db.ts +15 -4
  230. package/src/be/runtime-pools/supervisor.ts +42 -2
  231. package/src/be/swarm-config-guard.ts +10 -2
  232. package/src/commands/context-preamble.ts +11 -4
  233. package/src/commands/credential-outcome-report.ts +33 -9
  234. package/src/commands/e2b-stack-wizard.tsx +12 -6
  235. package/src/commands/runner.ts +116 -12
  236. package/src/extensions/catalog.generated.json +1 -1
  237. package/src/github/app.ts +59 -14
  238. package/src/http/all-routes.ts +2 -0
  239. package/src/http/config.ts +2 -1
  240. package/src/http/core.ts +2 -0
  241. package/src/http/github-token.ts +66 -0
  242. package/src/http/index.ts +21 -0
  243. package/src/http/mcp-user.ts +11 -8
  244. package/src/http/mcp.ts +58 -42
  245. package/src/http/prompt-templates.ts +1 -0
  246. package/src/http/request-composition.ts +310 -0
  247. package/src/http/tasks.ts +6 -1
  248. package/src/http/tool-schema-estimate.ts +95 -0
  249. package/src/http/workflows.ts +29 -11
  250. package/src/integrations/chat-sdk/inbound.ts +2 -2
  251. package/src/prompts/base-prompt.ts +133 -7
  252. package/src/prompts/resolver.ts +41 -2
  253. package/src/providers/amp-adapter.ts +1 -1
  254. package/src/providers/opencode-adapter.ts +72 -1
  255. package/src/providers/opencode-swarm-plugin.ts +22 -3
  256. package/src/providers/pi-mono-adapter.ts +1 -0
  257. package/src/providers/pi-mono-extension.ts +71 -0
  258. package/src/providers/pricing-sources.md +4 -0
  259. package/src/providers/request-composition-hook.ts +312 -0
  260. package/src/providers/types.ts +5 -0
  261. package/src/runtime-providers/controller-protocol.ts +7 -0
  262. package/src/runtime-providers/docker.ts +80 -12
  263. package/src/runtime-providers/k8s.ts +111 -6
  264. package/src/runtime-providers/types.ts +17 -0
  265. package/src/scheduler/scheduler.ts +1 -1
  266. package/src/server-user.ts +16 -1
  267. package/src/slack/ack.ts +10 -5
  268. package/src/slack/actions.ts +3 -3
  269. package/src/slack/app.ts +2 -0
  270. package/src/slack/assistant.ts +4 -4
  271. package/src/slack/blocks.ts +3 -3
  272. package/src/slack/handlers.ts +3 -3
  273. package/src/slack/reaction-shortcode.ts +23 -2
  274. package/src/slack/render-v2.ts +297 -200
  275. package/src/slack/responses.ts +7 -5
  276. package/src/slack/thread-buffer.ts +3 -3
  277. package/src/slack/tree-visibility.ts +64 -0
  278. package/src/tasks/worker-follow-up.ts +127 -17
  279. package/src/tests/azure-devops-outbound.test.ts +47 -14
  280. package/src/tests/base-prompt.test.ts +149 -1
  281. package/src/tests/check-playwright-version.test.ts +33 -0
  282. package/src/tests/context-preamble-budget.test.ts +65 -0
  283. package/src/tests/credential-outcome-report.test.ts +81 -1
  284. package/src/tests/db-client.test.ts +22 -0
  285. package/src/tests/db-retention-defaults.test.ts +244 -0
  286. package/src/tests/db-retention.test.ts +2 -1
  287. package/src/tests/db-runtime.test.ts +2 -1
  288. package/src/tests/deploy-release-dispatch.test.ts +332 -0
  289. package/src/tests/e2b-stack-wizard.test.tsx +156 -0
  290. package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
  291. package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
  292. package/src/tests/env-flag.test.ts +4 -2
  293. package/src/tests/event-loop-lag.test.ts +12 -18
  294. package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
  295. package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
  296. package/src/tests/fixtures/base-prompt-baseline.json +18 -0
  297. package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
  298. package/src/tests/github-installation-token-route.test.ts +199 -0
  299. package/src/tests/mcp-user-events.test.ts +708 -0
  300. package/src/tests/memory-key-paths.test.ts +4 -1
  301. package/src/tests/memory-search-stall.test.ts +421 -0
  302. package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
  303. package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
  304. package/src/tests/model-profile-fallbacks.test.ts +236 -2
  305. package/src/tests/opencode-adapter.test.ts +86 -0
  306. package/src/tests/pi-mono-extension.test.ts +168 -0
  307. package/src/tests/preload-env.test.ts +61 -1
  308. package/src/tests/preload.ts +22 -0
  309. package/src/tests/prompt-template-resolver.test.ts +85 -0
  310. package/src/tests/reload-config.test.ts +45 -0
  311. package/src/tests/request-composition.test.ts +447 -0
  312. package/src/tests/runner-max-concurrent.test.ts +86 -0
  313. package/src/tests/runtime-pools-db.test.ts +80 -0
  314. package/src/tests/runtime-provider-registration.test.ts +8 -0
  315. package/src/tests/runtime-providers-docker.test.ts +192 -1
  316. package/src/tests/runtime-providers-k8s.test.ts +127 -0
  317. package/src/tests/runtime-remote-controller.test.ts +64 -1
  318. package/src/tests/runtime-supervisor.test.ts +101 -0
  319. package/src/tests/script-connections.test.ts +8 -0
  320. package/src/tests/slack-blocks.test.ts +18 -0
  321. package/src/tests/slack-empty-icon-config.test.ts +113 -0
  322. package/src/tests/slack-reaction-config.test.ts +38 -2
  323. package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
  324. package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
  325. package/src/tests/slack-render-v2.test.ts +683 -11
  326. package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
  327. package/src/tests/task-session-prompts.test.ts +37 -0
  328. package/src/tests/user-delete-perf.test.ts +36 -9
  329. package/src/tests/webhook-filter.test.ts +327 -0
  330. package/src/tests/workflow-async-v2.test.ts +19 -16
  331. package/src/tests/workflow-definition-telemetry.test.ts +15 -5
  332. package/src/tests/workflow-e2e.test.ts +1 -9
  333. package/src/tests/workflow-finalization-races.test.ts +553 -0
  334. package/src/tests/workflow-foreach.test.ts +2 -0
  335. package/src/tests/workflow-hitl-routing.test.ts +26 -20
  336. package/src/tests/workflow-http-v2.test.ts +105 -2
  337. package/src/tests/workflow-idempotency.test.ts +41 -0
  338. package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
  339. package/src/tests/workflow-parallel-park.test.ts +297 -0
  340. package/src/tests/workflow-retry-v2.test.ts +57 -21
  341. package/src/tests/workflow-retry-validation.test.ts +13 -13
  342. package/src/tests/workflow-runs-retention.test.ts +533 -0
  343. package/src/tests/workflow-script-principal.test.ts +7 -2
  344. package/src/tests/workflow-tla-races.test.ts +7 -2
  345. package/src/tests/workflow-triggers-v2.test.ts +201 -0
  346. package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
  347. package/src/tests/workflow-wait-event.test.ts +28 -2
  348. package/src/tests/workflow-wait-poller.test.ts +94 -0
  349. package/src/tests/workflow-wait-time.test.ts +7 -3
  350. package/src/tests/workflow-wait.test.ts +26 -0
  351. package/src/tests/workflow-wait.ts +44 -0
  352. package/src/tools/workflows/create-workflow.ts +7 -3
  353. package/src/tools/workflows/update-workflow.ts +7 -3
  354. package/src/types.ts +200 -2
  355. package/src/utils/credentials.ts +7 -0
  356. package/src/workflows/checkpoint.ts +18 -0
  357. package/src/workflows/engine.ts +38 -10
  358. package/src/workflows/foreach-driver.ts +42 -4
  359. package/src/workflows/recovery.ts +6 -1
  360. package/src/workflows/resume.ts +11 -3
  361. package/src/workflows/retry-poller.ts +17 -4
  362. package/src/workflows/successor-routing.ts +108 -0
  363. package/src/workflows/task-step-routing.ts +5 -2
  364. package/src/workflows/triggers.ts +21 -36
  365. package/src/workflows/wait-poller.ts +6 -2
  366. package/src/workflows/webhook-filter.ts +203 -0
  367. package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
  368. package/templates/skills/swarm-docs/content.md +2 -0
  369. package/dist/acp-adapter-bht22g3k.js +0 -16
  370. package/dist/fx-adapter-adtdb3jb.js +0 -19
  371. package/dist/grok-adapter-accnn9km.js +0 -19
  372. package/dist/handlers-1x77561e.js +0 -35
  373. package/dist/index-48qzcqzj.js +0 -35
  374. package/dist/index-rkvaambe.js +0 -36
  375. package/dist/index-xj1mq27m.js +0 -40
  376. package/dist/lead-enzn86bz.js +0 -74
  377. package/dist/thread-buffer-3x93yexa.js +0 -38
  378. package/dist/worker-zfcv2wbf.js +0 -74
package/src/http/index.ts CHANGED
@@ -17,8 +17,10 @@ import {
17
17
  } from "../be/db";
18
18
  import { startTaskSearchBackfill, stopTaskSearchBackfill } from "../be/db/tasks/search-index";
19
19
  import { startDbRetention, stopDbRetention } from "../be/db-retention";
20
+ import { seedDbRetentionDefaults } from "../be/db-retention-defaults";
20
21
  import { startEventLoopLagProbe, stopEventLoopLagProbe, withLoopPath } from "../be/event-loop-lag";
21
22
  import { startHumanFreeDrain, stopHumanFreeDrain } from "../be/human-free-drain";
23
+ import { initMcpEventsDispatcher } from "../be/mcp-events/dispatcher";
22
24
  import { startMcpOverflowSweep, stopMcpOverflowSweep } from "../be/mcp-overflow-sweep";
23
25
  import {
24
26
  enqueueAuditRow,
@@ -96,6 +98,7 @@ import { handleExtensions } from "./extensions";
96
98
  import { handleFavorites } from "./favorites";
97
99
  import { handleFleetBenchmark } from "./fleet-benchmark";
98
100
  import { handleFs } from "./fs";
101
+ import { handleGitHubToken } from "./github-token";
99
102
  import { handleHeartbeat } from "./heartbeat";
100
103
  import { handleImprovements } from "./improvements";
101
104
  import { handleInboxState } from "./inbox-state";
@@ -131,6 +134,7 @@ import { handlePromptTemplates } from "./prompt-templates";
131
134
  import { handleRanking } from "./ranking";
132
135
  import { handleRealtimeAsset, handleRealtimeTicket } from "./realtime";
133
136
  import { handleRepos } from "./repos";
137
+ import { handleRequestComposition } from "./request-composition";
134
138
  import { handleRooms } from "./rooms";
135
139
  import { describeRequestRoute } from "./route-def";
136
140
  import { handleRuntimePools } from "./runtime-pools";
@@ -372,6 +376,7 @@ const httpServer = createHttpServer(async (req, res) => {
372
376
  () => handleAgentsRest(req, res, pathSegments, queryParams, myAgentId),
373
377
  () => handleBudgets(req, res, pathSegments, queryParams, myAgentId),
374
378
  () => handleContext(req, res, pathSegments, queryParams, myAgentId),
379
+ () => handleRequestComposition(req, res, pathSegments, queryParams, myAgentId),
375
380
  () => handleAssets(req, res, pathSegments, queryParams, myAgentId),
376
381
  () => handleTasks(req, res, pathSegments, queryParams, myAgentId),
377
382
  () => handleStats(req, res, pathSegments, queryParams, myAgentId),
@@ -389,6 +394,7 @@ const httpServer = createHttpServer(async (req, res) => {
389
394
  () => handlePoolKeys(req, res, pathSegments, queryParams),
390
395
  () => handleConfig(req, res, pathSegments, queryParams),
391
396
  () => handleFs(req, res, pathSegments, queryParams, myAgentId),
397
+ () => handleGitHubToken(req, res, pathSegments, myAgentId),
392
398
  () => handleAgentFsProxy(req, res),
393
399
  () => handleComb(req, res, pathSegments, queryParams, myAgentId),
394
400
  () => handleKv(req, res, pathSegments, queryParams),
@@ -652,6 +658,18 @@ startEventLoopLagProbe();
652
658
  // credential saved only in swarm_config silently reverts to the stale env
653
659
  // value on the next deploy (2026-09-16 prod Slack outage). Reserved keys
654
660
  // (API_KEY, SECRETS_ENCRYPTION_KEY, ...) stay env-only regardless.
661
+ // New-install seed: a database created by this boot gets the default
662
+ // retention values as global config rows. Runs before the load below so the
663
+ // rows are injected. Non-fatal: a failed seed leaves retention off.
664
+ try {
665
+ await seedDbRetentionDefaults();
666
+ } catch (err) {
667
+ console.warn(
668
+ "[startup] Retention defaults seed failed (non-fatal):",
669
+ scrubSecrets(err instanceof Error ? err.message : String(err)),
670
+ );
671
+ }
672
+
655
673
  let startupConfigsInjected: string[] = [];
656
674
  try {
657
675
  startupConfigsInjected = await loadGlobalConfigsIntoEnv(true);
@@ -865,6 +883,9 @@ httpServer
865
883
  initAzureDevOps();
866
884
  initAzureDevOpsOutbound();
867
885
 
886
+ // MCP Events webhook delivery for /mcp-user subscribers (gated per event by MCP_USER_EVENTS_ENABLED)
887
+ initMcpEventsDispatcher();
888
+
868
889
  // Initialize Bitbucket Cloud webhook handler (if configured)
869
890
  initBitbucket();
870
891
 
@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
2
2
  import type { IncomingMessage, ServerResponse } from "node:http";
3
3
  import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
4
4
  import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
5
- import { resolveUserByToken } from "@/be/users";
5
+ import { resolveUserToken } from "@/be/users";
6
6
  import { createUserServer } from "@/server-user";
7
7
  import type { User } from "@/types";
8
8
  import { setRequestAuth } from "@/utils/request-auth-context";
@@ -27,12 +27,14 @@ function extractBearer(req: IncomingMessage): string | null {
27
27
  return token.startsWith("aswt_") ? token : null;
28
28
  }
29
29
 
30
- async function resolveActiveUser(req: IncomingMessage): Promise<User | null> {
30
+ async function resolveActiveUser(
31
+ req: IncomingMessage,
32
+ ): Promise<{ user: User; tokenId: string } | null> {
31
33
  const token = extractBearer(req);
32
34
  if (!token) return null;
33
- const user = await resolveUserByToken(token);
34
- if (!user || user.status !== "active") return null;
35
- return user;
35
+ const resolved = await resolveUserToken(token);
36
+ if (!resolved?.user || resolved.user.status !== "active") return null;
37
+ return { user: resolved.user, tokenId: resolved.tokenId };
36
38
  }
37
39
 
38
40
  export async function handleMcpUser(
@@ -48,8 +50,9 @@ export async function handleMcpUser(
48
50
  return false;
49
51
  }
50
52
 
51
- const user = await resolveActiveUser(req);
52
- if (!user) return unauthorized(res);
53
+ const resolved = await resolveActiveUser(req);
54
+ if (!resolved) return unauthorized(res);
55
+ const { user, tokenId } = resolved;
53
56
  // Install the resolved user as the request's ambient auth so DB audit
54
57
  // columns (created_by on tasks made through the user MCP) attribute to the
55
58
  // human behind the token instead of NULL.
@@ -91,7 +94,7 @@ export async function handleMcpUser(
91
94
  }
92
95
  };
93
96
 
94
- const server = createUserServer(user);
97
+ const server = createUserServer(user, tokenId);
95
98
  await server.connect(transport);
96
99
  } else {
97
100
  return respondNoMcpSession(res, sessionId);
package/src/http/mcp.ts CHANGED
@@ -214,50 +214,9 @@ export async function handleMcp(
214
214
  }
215
215
  };
216
216
 
217
- const configs = await getResolvedConfig(agentId);
218
- const configValue = configs.find((config) => config.key === "SCRIPTS_ONLY_MCP")?.value;
219
- const preloadEnabled = parseEnvFlag(
220
- configs.find((config) => config.key === "TASK_TOOL_PRELOAD_ENABLED")?.value ??
221
- process.env.TASK_TOOL_PRELOAD_ENABLED,
222
- true,
223
- );
224
- let preloadedTools: string[] = [];
225
217
  const sourceTaskId = headerValue(req.headers["x-source-task-id"]);
226
218
  const sourceTask = sourceTaskId ? await getTaskById(sourceTaskId) : undefined;
227
- // A session bound to a non-chat task never sees chat-reply. Without the
228
- // header the tool stays, and resolves the agent's current task itself.
229
- const excludedTools =
230
- sourceTask && !isChatSdkTask(sourceTask) ? [...CHAT_TASK_ONLY_TOOLS] : [];
231
- if (preloadEnabled) {
232
- // Never select a manifest using another agent's task. Session-token
233
- // identity is also checked above, before any MCP session is created.
234
- if (sourceTask?.agentId === agentId) {
235
- const manifestValue =
236
- configs.find((config) => config.key === "TASK_TOOL_MANIFESTS")?.value ??
237
- process.env.TASK_TOOL_MANIFESTS ??
238
- "{}";
239
- try {
240
- preloadedTools = selectTaskTools(parseTaskToolManifest(manifestValue), sourceTask);
241
- } catch {
242
- // An invalid deployment value must not prevent tool discovery.
243
- // Avoid logging its contents, which may contain misfiled secrets.
244
- console.warn("[MCP] Invalid TASK_TOOL_MANIFESTS; using ordinary tool discovery");
245
- }
246
- }
247
- }
248
- const server = await createServer({
249
- preloadedTools,
250
- excludedTools,
251
- // Agent row, then global row, then deployment env. A blank agent row
252
- // resolves to "unset" for that agent.
253
- enabledTools:
254
- configs.find((config) => config.key === "SWARM_ENABLED_TOOLS")?.value ??
255
- process.env.SWARM_ENABLED_TOOLS,
256
- scriptsOnly: resolveScriptsOnlyMode({
257
- env: process.env.SCRIPTS_ONLY_MCP,
258
- configValue,
259
- }),
260
- });
219
+ const server = await createServer(await resolveMcpSessionOptions(agentId, sourceTask));
261
220
  await server.connect(transport);
262
221
  } else {
263
222
  return respondNoMcpSession(res, sessionId);
@@ -281,3 +240,60 @@ export async function handleMcp(
281
240
  res.end("Method not allowed");
282
241
  return true;
283
242
  }
243
+
244
+ export type McpSessionOptions = {
245
+ preloadedTools: string[];
246
+ excludedTools: string[];
247
+ enabledTools: string | undefined;
248
+ scriptsOnly: boolean;
249
+ };
250
+
251
+ /**
252
+ * The `createServer` inputs for one agent's MCP session, all resolved
253
+ * server-side: config rows, the API's env, and the session's source task.
254
+ * The request-composition tool estimate reuses this to measure the same
255
+ * surface the agent's harness sees.
256
+ */
257
+ export async function resolveMcpSessionOptions(
258
+ agentId: string,
259
+ sourceTask: Awaited<ReturnType<typeof getTaskById>> | undefined,
260
+ ): Promise<McpSessionOptions> {
261
+ const configs = await getResolvedConfig(agentId);
262
+ const configValue = configs.find((config) => config.key === "SCRIPTS_ONLY_MCP")?.value;
263
+ const preloadEnabled = parseEnvFlag(
264
+ configs.find((config) => config.key === "TASK_TOOL_PRELOAD_ENABLED")?.value ??
265
+ process.env.TASK_TOOL_PRELOAD_ENABLED,
266
+ true,
267
+ );
268
+ let preloadedTools: string[] = [];
269
+ // A session bound to a non-chat task never sees chat-reply. Without the
270
+ // header the tool stays, and resolves the agent's current task itself.
271
+ const excludedTools = sourceTask && !isChatSdkTask(sourceTask) ? [...CHAT_TASK_ONLY_TOOLS] : [];
272
+ if (preloadEnabled) {
273
+ // Never select a manifest using another agent's task. Session-token
274
+ // identity is also checked by handleMcp, before any MCP session is created.
275
+ if (sourceTask?.agentId === agentId) {
276
+ const manifestValue =
277
+ configs.find((config) => config.key === "TASK_TOOL_MANIFESTS")?.value ??
278
+ process.env.TASK_TOOL_MANIFESTS ??
279
+ "{}";
280
+ try {
281
+ preloadedTools = selectTaskTools(parseTaskToolManifest(manifestValue), sourceTask);
282
+ } catch {
283
+ // An invalid deployment value must not prevent tool discovery.
284
+ // Avoid logging its contents, which may contain misfiled secrets.
285
+ console.warn("[MCP] Invalid TASK_TOOL_MANIFESTS; using ordinary tool discovery");
286
+ }
287
+ }
288
+ }
289
+ return {
290
+ preloadedTools,
291
+ excludedTools,
292
+ // Agent row, then global row, then deployment env. A blank agent row
293
+ // resolves to "unset" for that agent.
294
+ enabledTools:
295
+ configs.find((config) => config.key === "SWARM_ENABLED_TOOLS")?.value ??
296
+ process.env.SWARM_ENABLED_TOOLS,
297
+ scriptsOnly: resolveScriptsOnlyMode({ env: process.env.SCRIPTS_ONLY_MCP, configValue }),
298
+ };
299
+ }
@@ -57,6 +57,7 @@ const ResolveResultSchema = z.object({
57
57
  scope: z.string().optional(),
58
58
  skipped: z.boolean(),
59
59
  unresolved: z.array(z.string()),
60
+ segments: z.array(z.object({ templateId: z.string(), chars: z.number().int() })).optional(),
60
61
  });
61
62
 
62
63
  /** Mirrors the return type of `resolvePromptTemplate` in src/be/db.ts */
@@ -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
@@ -832,7 +832,7 @@ const supersedeTaskRoute = route({
832
832
  session: { taskParam: "id" },
833
833
  summary: "Supersede an in-progress task (terminate + spawn resume follow-up)",
834
834
  description:
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 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.",
836
836
  tags: ["Tasks"],
837
837
  params: z.object({ id: z.string() }),
838
838
  body: z
@@ -2384,6 +2384,11 @@ export async function handleTasks(
2384
2384
  return true;
2385
2385
  }
2386
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
+ }
2387
2392
  }
2388
2393
 
2389
2394
  // Workflow-step tasks: fail back to the engine instead of superseding.
@@ -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
+ }