@desplega.ai/agent-swarm 2.10.0 → 2.12.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 (572) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-arrwv4f0.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-y0d2n1c2.js → actions-c4chgxp6.js} +27 -24
  4. package/dist/{agent-fs-provision-tpj7sktd.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-vmmnmw8d.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{anthropic-messages-zdca3gv1.js → anthropic-messages-88b7s3n9.js} +177 -25
  7. package/dist/{app-wb7w45dq.js → app-hn5fftf5.js} +7 -6
  8. package/dist/{approval-notifications-7mqr6vbd.js → approval-notifications-3g6yc8nv.js} +7 -6
  9. package/dist/{assistant-gf60454p.js → assistant-cpjgpjvp.js} +29 -26
  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-hce1av1h.js} +1 -1
  12. package/dist/{boot-reembed-5tmeskj2.js → boot-reembed-bztbxc4z.js} +1 -1
  13. package/dist/{boot-reembed-wb44vc3s.js → boot-reembed-d7xcym0j.js} +1 -1
  14. package/dist/{boot-scrub-sweep-25bxhnw4.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  15. package/dist/{boot-seeds-nj9za0vk.js → boot-seeds-arrkbe8t.js} +4 -4
  16. package/dist/{boxd-wn235q80.js → boxd-68n75y1s.js} +2 -2
  17. package/dist/{claude-adapter-d3krpdyb.js → claude-adapter-ykpyr5p8.js} +8 -8
  18. package/dist/{claude-managed-adapter-t8nfgcgz.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  19. package/dist/{claude-managed-setup-7y4pwd81.js → claude-managed-setup-trd59v7b.js} +4 -4
  20. package/dist/{claude-sdk-session-d138zy0e.js → claude-sdk-session-yjcze0j1.js} +10941 -10412
  21. package/dist/{cli-vq2eg24x.js → cli-01tvvtad.js} +63 -60
  22. package/dist/cli-04zc3f7b.js +68 -0
  23. package/dist/{cli-01k6wpr9.js → cli-0k1a0sde.js} +7 -7
  24. package/dist/{cli-j6te8keb.js → cli-0pp1yjg2.js} +8 -8
  25. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  26. package/dist/{cli-wwp1bd3n.js → cli-12vek61e.js} +564 -97
  27. package/dist/{cli-rqx70rcz.js → cli-17qzb39j.js} +5 -2
  28. package/dist/{cli-124ntmf0.js → cli-1htmtqc2.js} +143 -63
  29. package/dist/{cli-3f8zbtqa.js → cli-2amwhyv2.js} +15 -11
  30. package/dist/{cli-7sf9sb0w.js → cli-2m6yaq6b.js} +1 -1
  31. package/dist/{cli-6cwr32fe.js → cli-2tw284hj.js} +422 -140
  32. package/dist/{cli-6ehs4mta.js → cli-2z2c4k6q.js} +18 -4
  33. package/dist/{cli-nstkanmx.js → cli-39qm0rtm.js} +8 -8
  34. package/dist/{cli-hnamkvnc.js → cli-3p288654.js} +2 -2
  35. package/dist/{cli-4ymxrwg5.js → cli-4dyzzkfb.js} +2 -2
  36. package/dist/{cli-3kd08rej.js → cli-4jjrhy48.js} +1 -1
  37. package/dist/{cli-kxn3747f.js → cli-4se3x6qm.js} +1 -26
  38. package/dist/cli-52nfye5j.js +673 -0
  39. package/dist/cli-55tc8cj4.js +252 -0
  40. package/dist/cli-5r95eqbh.js +186 -0
  41. package/dist/{cli-6037prsx.js → cli-5tg94mdw.js} +13 -13
  42. package/dist/{cli-2spnz7ye.js → cli-5x03v6en.js} +11137 -8332
  43. package/dist/{cli-y4ccxtz5.js → cli-5z0g0e8v.js} +153 -6
  44. package/dist/{cli-8y43jx2r.js → cli-6p8p2e6r.js} +16 -9
  45. package/dist/{cli-539h29es.js → cli-72yms3ey.js} +224 -189
  46. package/dist/{cli-y8p78ekx.js → cli-73q4g5nx.js} +21 -21
  47. package/dist/{cli-p74md7t8.js → cli-7b7rxz22.js} +13 -15
  48. package/dist/{cli-43ms35q9.js → cli-7wy8gbwb.js} +3 -3
  49. package/dist/{cli-7mv4h3sn.js → cli-7yn42w6m.js} +2 -2
  50. package/dist/{cli-gabsjg8x.js → cli-8hp56wat.js} +3 -2
  51. package/dist/cli-8mfdbdhe.js +43 -0
  52. package/dist/{cli-zcfpsfzf.js → cli-96234j5w.js} +3 -3
  53. package/dist/{cli-1z4qggfe.js → cli-9fvk9mv8.js} +30 -21
  54. package/dist/{cli-2rnd5j3t.js → cli-9qe5y107.js} +2 -2
  55. package/dist/{cli-5mpy301f.js → cli-9t7syepg.js} +1 -1
  56. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  57. package/dist/{cli-7evph51z.js → cli-a49frv85.js} +2 -2
  58. package/dist/{cli-3aaeb78m.js → cli-agjbj5x0.js} +95 -10
  59. package/dist/{cli-th1dkc2v.js → cli-b93d81yg.js} +2 -2
  60. package/dist/{cli-qj39vrc6.js → cli-bhgrhedp.js} +1 -1
  61. package/dist/{cli-2xv18ywz.js → cli-bmqp0ser.js} +2 -2
  62. package/dist/{cli-9fjr27ez.js → cli-bp6k9acz.js} +18 -22
  63. package/dist/{cli-5a6pqy45.js → cli-bpje8n65.js} +31 -4
  64. package/dist/{cli-2v2zdm0a.js → cli-bz97ff9n.js} +2 -2
  65. package/dist/{cli-3caf7pmg.js → cli-c7j31hq9.js} +3 -3
  66. package/dist/{cli-t9ga4qmb.js → cli-cah298e5.js} +40 -33
  67. package/dist/{cli-aw83sr40.js → cli-cjqyse9q.js} +3 -3
  68. package/dist/{cli-b6px1k1q.js → cli-dd2k2mcd.js} +1 -1
  69. package/dist/{cli-nv4xsvmk.js → cli-dkvtfgn4.js} +7 -7
  70. package/dist/{cli-7r162fxe.js → cli-e3ahxq5y.js} +23 -17
  71. package/dist/{cli-3et6fmfe.js → cli-e8n0hdzd.js} +1 -1
  72. package/dist/{cli-tsa40663.js → cli-ebqx630g.js} +3 -3
  73. package/dist/{cli-kbtzfrxj.js → cli-en6dmkxd.js} +3 -3
  74. package/dist/{cli-m9cvf7vs.js → cli-eq4kew31.js} +14 -14
  75. package/dist/{cli-fcfbct2j.js → cli-eqq0hwvx.js} +5 -5
  76. package/dist/{cli-7zm3b3f5.js → cli-ercwc8xn.js} +1 -1
  77. package/dist/{cli-vs9vdpy0.js → cli-ex1y88j3.js} +1 -1
  78. package/dist/{cli-mk7c5ac4.js → cli-fxd1mwtr.js} +2 -2
  79. package/dist/{cli-91pkxres.js → cli-fy4gb74g.js} +2 -2
  80. package/dist/{cli-fq2rr3jb.js → cli-fyaq4zdv.js} +6 -6
  81. package/dist/{cli-cc93xzes.js → cli-gfy6hbd9.js} +28 -17
  82. package/dist/{cli-s1khw52h.js → cli-h70a2mxy.js} +71 -17
  83. package/dist/cli-hbvgzjq4.js +69 -0
  84. package/dist/{cli-qx4f057j.js → cli-hhc47ack.js} +4 -4
  85. package/dist/{cli-q5srsxq2.js → cli-j5gtytvg.js} +154 -41
  86. package/dist/{cli-psffsanb.js → cli-js10kdk7.js} +6 -1
  87. package/dist/{cli-54vrpgm0.js → cli-k3facve0.js} +8 -5
  88. package/dist/{cli-vsw91x06.js → cli-k5jx8jya.js} +10 -6
  89. package/dist/{cli-tr27kwyg.js → cli-krbcr00p.js} +261 -6
  90. package/dist/{cli-5qhfv9rw.js → cli-kwr5qv5g.js} +44 -17
  91. package/dist/{cli-md50mj0r.js → cli-m5qtmrbc.js} +3 -3
  92. package/dist/{cli-vfqvrd82.js → cli-ma9ys8rt.js} +2 -2
  93. package/dist/{cli-w16kwbzw.js → cli-mbwmqb5w.js} +1 -1
  94. package/dist/{cli-w1q68d8x.js → cli-mcymtvwn.js} +322 -72
  95. package/dist/{cli-k3q2va86.js → cli-mq2fbgva.js} +66 -5
  96. package/dist/{cli-xqdz5cqm.js → cli-mz7ycqn8.js} +1 -0
  97. package/dist/{cli-kpgcm7xy.js → cli-n85m2wkq.js} +1 -1
  98. package/dist/{cli-v8z0yga9.js → cli-n8f0fs3c.js} +4 -4
  99. package/dist/{cli-mys27d03.js → cli-nja15knq.js} +3 -3
  100. package/dist/{cli-zk7v5s89.js → cli-pe3yxedk.js} +3 -3
  101. package/dist/{cli-v46zsvqk.js → cli-ph95yejc.js} +2 -2
  102. package/dist/{cli-6237rnyr.js → cli-pqfecppn.js} +1 -1
  103. package/dist/{cli-qrta34nb.js → cli-q2dywc8h.js} +4 -4
  104. package/dist/{cli-k6nejceb.js → cli-q4z9s6zs.js} +2 -2
  105. package/dist/{cli-s1zqk1aj.js → cli-q8tc22bj.js} +15 -9
  106. package/dist/{cli-hg42n3hx.js → cli-qrzq3hvg.js} +8 -8
  107. package/dist/{cli-43evxwj4.js → cli-r0mz92by.js} +9 -4
  108. package/dist/{cli-jrbq4djp.js → cli-r14ac1y0.js} +1 -1
  109. package/dist/{cli-5gpqgs8b.js → cli-rtmqzat7.js} +2 -2
  110. package/dist/{cli-tvgqesec.js → cli-s6zk31gr.js} +4 -4
  111. package/dist/{cli-6ym4jhzp.js → cli-sv2r3bw8.js} +7 -7
  112. package/dist/{cli-wafmk3fn.js → cli-t75xngj1.js} +12 -12
  113. package/dist/{cli-x40a0w9j.js → cli-tdk7jtka.js} +1 -1
  114. package/dist/{cli-zeh2mhkg.js → cli-tm60vtax.js} +1 -1
  115. package/dist/cli-tsfkcd4v.js +30 -0
  116. package/dist/{cli-8st34zhr.js → cli-v9ya390t.js} +57 -19
  117. package/dist/{cli-zfqg6fzn.js → cli-vbppqvte.js} +3 -3
  118. package/dist/{cli-p0n7b5rz.js → cli-wvjqaqcp.js} +2907 -151
  119. package/dist/{cli-sb4426be.js → cli-xf4z5bdn.js} +5 -5
  120. package/dist/{cli-p0c3vtch.js → cli-xm34qj8m.js} +772 -515
  121. package/dist/{cli-z0m452jr.js → cli-ya3kf4gs.js} +1 -1
  122. package/dist/{cli-had1p04a.js → cli-yegz2g06.js} +4 -4
  123. package/dist/{cli-k5yewqgd.js → cli-yfpc6qy9.js} +3 -3
  124. package/dist/{cli-q2d3e1k1.js → cli-z4f346g5.js} +1 -1
  125. package/dist/{cli-yab6sh8p.js → cli-zcghfsdg.js} +23 -4
  126. package/dist/cli.js +34 -30
  127. package/dist/{cloudflare-workers-ai-system-one-4aysy6rh.js → cloudflare-workers-ai-system-one-w3m0fbf8.js} +2 -2
  128. package/dist/{codex-adapter-exfdbj73.js → codex-adapter-wc6e4wct.js} +8 -8
  129. package/dist/{codex-hook-59atdwd8.js → codex-hook-aqtj17yr.js} +1 -1
  130. package/dist/{codex-login-a239g1ah.js → codex-login-1ven7yje.js} +1 -1
  131. package/dist/{codex-session-runner-xhznc4g3.js → codex-session-runner-ppfgjd97.js} +9 -9
  132. package/dist/{commands-d8g349v4.js → commands-tsv2vx5b.js} +3 -3
  133. package/dist/{controller-mwgdmb8y.js → controller-ye4sdwsy.js} +4 -4
  134. package/dist/{controllers-connect-5v7qx04j.js → controllers-connect-zn4dg69h.js} +25 -22
  135. package/dist/core-dxcy02sc.js +41 -0
  136. package/dist/{cursor-adapter-p2q5h35d.js → cursor-adapter-q2g9vwts.js} +2 -2
  137. package/dist/{db-wcw0b2j8.js → db-3r1fyr2n.js} +6 -2
  138. package/dist/{db-qpganbeb.js → db-g111qn9j.js} +3 -3
  139. package/dist/{devin-adapter-zp4tqq53.js → devin-adapter-t8d86q9x.js} +1 -1
  140. package/dist/{dispatcher-8d8s49yz.js → dispatcher-4q8s0mx8.js} +22 -19
  141. package/dist/{docker-09tkkg0n.js → docker-1b41eysj.js} +51 -14
  142. package/dist/{dsh-adapter-me0twn13.js → dsh-adapter-mmcw1z5s.js} +2 -2
  143. package/dist/{e2b-3v1e745x.js → e2b-ew8c5j5v.js} +3 -3
  144. package/dist/{e2b-sm28k0k3.js → e2b-xm60c8ad.js} +6 -6
  145. package/dist/{easter-egg-3d-wv7w5ty6.js → easter-egg-3d-04ke6hcp.js} +1 -1
  146. package/dist/{embedding-space-e48xchqa.js → embedding-space-kcdn52vz.js} +6 -6
  147. package/dist/{embeddings-tgq2afbq.js → embeddings-jnzcd91a.js} +1 -1
  148. package/dist/{event-bus-xr83x566.js → event-bus-v4ywhc2p.js} +1 -1
  149. package/dist/{execute-8rhwrk7f.js → execute-74amghty.js} +8 -4
  150. package/dist/{external-channel-8bt3j2pm.js → external-channel-v9zgxnxz.js} +2 -2
  151. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  152. package/dist/{google-generative-ai-bh0djqjp.js → google-generative-ai-sw77egmr.js} +9 -9
  153. package/dist/{google-vertex-prjbw8dj.js → google-vertex-rrw93g8h.js} +9 -9
  154. package/dist/grok-adapter-t6m74fb1.js +19 -0
  155. package/dist/handlers-9kwcrc4k.js +38 -0
  156. package/dist/{heartbeat-x0056ra5.js → heartbeat-p8pk1msj.js} +25 -22
  157. package/dist/{hook-a7vmn2st.js → hook-k1h73zd7.js} +5 -5
  158. package/dist/{hook-mrd2ayxv.js → hook-p5reemds.js} +8 -8
  159. package/dist/{http-ym9c5svp.js → http-ms1z5xxy.js} +2549 -224
  160. package/dist/index-23cdfzr6.js +39 -0
  161. package/dist/{index-01ns1pkw.js → index-76zzxtzf.js} +1 -1
  162. package/dist/{index-ny60jcat.js → index-fbkqhvvj.js} +40 -18
  163. package/dist/index-g7kkjs5b.js +38 -0
  164. package/dist/{index-x6azjwm8.js → index-gjn6qfgn.js} +1 -1
  165. package/dist/{index-b5wgnm78.js → index-kdmkfjt7.js} +4 -4
  166. package/dist/{index-p46tvwtx.js → index-kn63q1gr.js} +28 -25
  167. package/dist/{index-9myfj74s.js → index-kzdqn3dd.js} +3 -3
  168. package/dist/{index-4a0670yh.js → index-p2f5xg64.js} +6 -6
  169. package/dist/index-stk36pa5.js +43 -0
  170. package/dist/{k8s-m56sw868.js → k8s-fy8hbhkg.js} +73 -14
  171. package/dist/{keepalive-7yxg8z4c.js → keepalive-031js8jz.js} +4 -4
  172. package/dist/lead-mfggjtfk.js +77 -0
  173. package/dist/{llama-cpp-classify-nfgswa1m.js → llama-cpp-classify-yvb8vh7w.js} +2 -2
  174. package/dist/{maintenance-6tefxmk1.js → maintenance-sq9v3qx9.js} +1 -1
  175. package/dist/{mistral-conversations-tm2vd4gc.js → mistral-conversations-w4bncwbt.js} +7 -7
  176. package/dist/{node-7qsx5kvm.js → node-z67yjre7.js} +19 -13
  177. package/dist/{oauth-refresh-sweep-70cavc3a.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  178. package/dist/object-webhooks-r24wwb5y.js +21 -0
  179. package/dist/{onboard-fja65z08.js → onboard-p25yhh7t.js} +5 -5
  180. package/dist/{openai-codex-responses-sxjv60xx.js → openai-codex-responses-70g39cgz.js} +20 -14
  181. package/dist/{openai-completions-0c7qnhsx.js → openai-completions-cv3hp4h5.js} +18 -11
  182. package/dist/{openai-decisions-ytp6w6xh.js → openai-decisions-fyq1p9f9.js} +2 -2
  183. package/dist/{openai-responses-a7h29chp.js → openai-responses-trsvnks6.js} +13 -11
  184. package/dist/{opencode-adapter-hakkm7yh.js → opencode-adapter-wcjc4zdk.js} +7 -7
  185. package/dist/{openrouter-images-xr9gme9x.js → openrouter-images-0jj12a2q.js} +6 -6
  186. package/dist/{otel-impl-7zhnt6gj.js → otel-impl-ff1gf20m.js} +2 -2
  187. package/dist/{pending-h01yzpx4.js → pending-hxj5yatb.js} +23 -20
  188. package/dist/{pi-messages-2j0fpqwq.js → pi-messages-zk3g4esn.js} +1 -1
  189. package/dist/{pi-mono-adapter-f52hz743.js → pi-mono-adapter-vkp4zz7p.js} +19 -18
  190. package/dist/{pricing-refresh-fzxvk2zf.js → pricing-refresh-9w7gx41w.js} +2 -2
  191. package/dist/{rbac-roles-9v6vhgbs.js → rbac-roles-84aw10nz.js} +3 -3
  192. package/dist/{rbac-roles-hfgh8sba.js → rbac-roles-hz74vckp.js} +2 -2
  193. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  194. package/dist/{render-v2-1rgspxzf.js → render-v2-nrdkg9gf.js} +7 -6
  195. package/dist/{resume-tqy61x24.js → resume-s6ey36rh.js} +9 -8
  196. package/dist/{runtime-exkxyx5f.js → runtime-x0b4pyam.js} +2 -2
  197. package/dist/{session-access-3act7vt4.js → session-access-xv49tk14.js} +4 -4
  198. package/dist/{session-source-backfill-82qe7fqq.js → session-source-backfill-r5j988ah.js} +3 -3
  199. package/dist/{setup-ry1vfdef.js → setup-mj0krk1p.js} +1 -1
  200. package/dist/thread-buffer-temgaqsy.js +41 -0
  201. package/dist/tree-visibility-cbrsfaar.js +24 -0
  202. package/dist/{typesafe-system-one-vcfj2ak8.js → typesafe-system-one-qkvkgrcz.js} +2 -2
  203. package/dist/{user-merge-jobs-bx6bf7db.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  204. package/dist/{virtual-modules-s0rjzcqq.js → virtual-modules-ns0ryw05.js} +32 -10
  205. package/dist/{work-objects-z2e5tv03.js → work-objects-pydhzast.js} +25 -22
  206. package/dist/worker-efcemc22.js +77 -0
  207. package/dist/{worker-follow-up-y3xeg89w.js → worker-follow-up-9z2xec5e.js} +22 -19
  208. package/dist/{x-wg164ss9.js → x-3dtaf2r9.js} +2 -2
  209. package/openapi.json +2040 -559
  210. package/package.json +15 -11
  211. package/src/azure-devops/auth.ts +2 -3
  212. package/src/be/agent-fs-identity.ts +46 -0
  213. package/src/be/agent-history.ts +215 -0
  214. package/src/be/db/agents.ts +34 -12
  215. package/src/be/db/request-composition.ts +190 -0
  216. package/src/be/db/runtime.ts +15 -0
  217. package/src/be/db/slack-trees.ts +220 -10
  218. package/src/be/db/tasks/human-free.ts +3 -2
  219. package/src/be/db/tasks/write.ts +2 -2
  220. package/src/be/db/workflow-run-retention.ts +101 -0
  221. package/src/be/db-client.ts +23 -1
  222. package/src/be/db-retention-defaults.ts +46 -0
  223. package/src/be/db-retention.ts +55 -6
  224. package/src/be/db.ts +2 -0
  225. package/src/be/mcp-events/catalog.ts +108 -0
  226. package/src/be/mcp-events/dispatcher.ts +202 -0
  227. package/src/be/mcp-events/protocol.ts +296 -0
  228. package/src/be/mcp-events/store.ts +231 -0
  229. package/src/be/mcp-events/webhook.ts +226 -0
  230. package/src/be/memory/providers/sqlite-store.ts +110 -24
  231. package/src/be/memory/review-recall-filter.ts +22 -0
  232. package/src/be/memory/search-candidates.ts +5 -7
  233. package/src/be/memory/types.ts +5 -0
  234. package/src/be/migrations/322_runtime_pool_workspace.sql +8 -0
  235. package/src/be/migrations/323_slack_task_tree_visibility.sql +9 -0
  236. package/src/be/migrations/326_slack_reconcile_pages.sql +13 -0
  237. package/src/be/migrations/327_mcp_event_subscriptions.sql +57 -0
  238. package/src/be/migrations/329_workflow_run_retention.sql +9 -0
  239. package/src/be/migrations/330_request_composition.sql +22 -0
  240. package/src/be/migrations/332_primitive_objects.sql +31 -0
  241. package/src/be/migrations/334_agent_history.sql +23 -0
  242. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  243. package/src/be/model-profile-check.ts +1 -1
  244. package/src/be/multi-runtime.ts +32 -4
  245. package/src/be/primitives/boards/elements.ts +717 -0
  246. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  247. package/src/be/primitives/boards/service.ts +121 -0
  248. package/src/be/primitives/object-webhooks.ts +348 -0
  249. package/src/be/primitives/objects.ts +686 -0
  250. package/src/be/primitives/sheets/a1.ts +136 -0
  251. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  252. package/src/be/primitives/sheets/engine.ts +199 -0
  253. package/src/be/primitives/sheets/format.ts +106 -0
  254. package/src/be/primitives/sheets/service.ts +415 -0
  255. package/src/be/primitives/write-object.ts +83 -0
  256. package/src/be/runtime-pools/controllers.ts +18 -3
  257. package/src/be/runtime-pools/db.ts +15 -4
  258. package/src/be/runtime-pools/supervisor.ts +42 -2
  259. package/src/be/script-credential-broker.ts +8 -27
  260. package/src/be/scripts/typecheck.ts +216 -0
  261. package/src/be/seed/agent-fs-provision.ts +18 -0
  262. package/src/be/swarm-config-guard.ts +10 -2
  263. package/src/be/users.ts +19 -0
  264. package/src/commands/context-preamble.ts +11 -4
  265. package/src/commands/credential-outcome-report.ts +33 -9
  266. package/src/commands/e2b-stack-wizard.tsx +12 -6
  267. package/src/commands/onboard/agent-fs-version.ts +1 -1
  268. package/src/commands/onboard/steps/harness.tsx +1 -1
  269. package/src/commands/provider-credentials.ts +1 -0
  270. package/src/commands/runner.ts +116 -12
  271. package/src/e2b/env.ts +3 -1
  272. package/src/extensions/catalog.generated.json +1 -1
  273. package/src/fs/agent-fs-provider.ts +33 -2
  274. package/src/github/app.ts +59 -14
  275. package/src/gitlab/auth.ts +3 -4
  276. package/src/heartbeat/heartbeat.ts +11 -11
  277. package/src/http/agent-lifecycle.ts +152 -0
  278. package/src/http/agents.ts +12 -0
  279. package/src/http/all-routes.ts +4 -0
  280. package/src/http/auth.ts +2 -1
  281. package/src/http/config.ts +2 -1
  282. package/src/http/core.ts +2 -0
  283. package/src/http/github-token.ts +66 -0
  284. package/src/http/index.ts +36 -0
  285. package/src/http/mcp-user.ts +11 -8
  286. package/src/http/mcp.ts +58 -42
  287. package/src/http/object-webhooks.ts +101 -0
  288. package/src/http/operator-actor.ts +2 -1
  289. package/src/http/prompt-templates.ts +1 -0
  290. package/src/http/request-composition.ts +310 -0
  291. package/src/http/sessions.ts +7 -0
  292. package/src/http/tasks.ts +6 -1
  293. package/src/http/tool-schema-estimate.ts +95 -0
  294. package/src/http/workflows.ts +61 -11
  295. package/src/integrations/chat-sdk/inbound.ts +2 -2
  296. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  297. package/src/prompts/base-prompt.ts +133 -7
  298. package/src/prompts/resolver.ts +41 -2
  299. package/src/providers/acp-targets.ts +2 -2
  300. package/src/providers/amp-adapter.ts +1 -1
  301. package/src/providers/opencode-adapter.ts +76 -2
  302. package/src/providers/opencode-swarm-plugin.ts +22 -3
  303. package/src/providers/pi-mono-adapter.ts +1 -0
  304. package/src/providers/pi-mono-extension.ts +71 -0
  305. package/src/providers/pricing-sources.md +4 -0
  306. package/src/providers/request-composition-hook.ts +312 -0
  307. package/src/providers/types.ts +5 -0
  308. package/src/rbac/legacy-policy.ts +2 -0
  309. package/src/rbac/permissions.ts +5 -0
  310. package/src/runtime-providers/controller-protocol.ts +7 -0
  311. package/src/runtime-providers/docker.ts +80 -12
  312. package/src/runtime-providers/k8s.ts +111 -6
  313. package/src/runtime-providers/types.ts +17 -0
  314. package/src/scheduler/scheduler.ts +1 -1
  315. package/src/script-workflows/guest-ctx.ts +32 -0
  316. package/src/script-workflows/workflow-ctx.ts +2 -0
  317. package/src/scripts-runtime/ctx.ts +9 -1
  318. package/src/scripts-runtime/executors/native.ts +106 -21
  319. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  320. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  321. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  322. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  323. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  324. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  325. package/src/server-user.ts +16 -1
  326. package/src/server.ts +48 -0
  327. package/src/slack/ack.ts +10 -5
  328. package/src/slack/actions.ts +3 -3
  329. package/src/slack/app.ts +2 -0
  330. package/src/slack/assistant.ts +4 -4
  331. package/src/slack/blocks.ts +3 -3
  332. package/src/slack/handlers.ts +3 -3
  333. package/src/slack/reaction-shortcode.ts +23 -2
  334. package/src/slack/render-v2.ts +297 -200
  335. package/src/slack/responses.ts +7 -5
  336. package/src/slack/thread-buffer.ts +3 -3
  337. package/src/slack/tree-visibility.ts +64 -0
  338. package/src/tasks/worker-follow-up.ts +127 -17
  339. package/src/tests/agent-history.test.ts +313 -0
  340. package/src/tests/azure-devops-auth.test.ts +6 -0
  341. package/src/tests/azure-devops-outbound.test.ts +47 -14
  342. package/src/tests/base-prompt.test.ts +149 -1
  343. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  344. package/src/tests/check-playwright-version.test.ts +33 -0
  345. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  346. package/src/tests/context-preamble-budget.test.ts +65 -0
  347. package/src/tests/credential-check.test.ts +12 -0
  348. package/src/tests/credential-outcome-report.test.ts +81 -1
  349. package/src/tests/db-client.test.ts +22 -0
  350. package/src/tests/db-retention-defaults.test.ts +244 -0
  351. package/src/tests/db-retention.test.ts +2 -1
  352. package/src/tests/db-task-read-contract.test.ts +2 -0
  353. package/src/tests/db-task-write-contract.test.ts +2 -0
  354. package/src/tests/deploy-release-dispatch.test.ts +332 -0
  355. package/src/tests/e2b-stack-wizard.test.tsx +156 -0
  356. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  357. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  358. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  359. package/src/tests/e2e-shards.test.ts +137 -0
  360. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  361. package/src/tests/entrypoint-chown-no-follow.test.ts +69 -0
  362. package/src/tests/entrypoint-repo-clone-target.test.ts +112 -0
  363. package/src/tests/env-flag.test.ts +4 -2
  364. package/src/tests/event-loop-lag.test.ts +12 -18
  365. package/src/tests/extensions-example-slack-reply-gate.test.ts +15 -0
  366. package/src/tests/extensions-heartbeat.test.ts +34 -0
  367. package/src/tests/fixtures/base-prompt-baseline-cases.ts +78 -0
  368. package/src/tests/fixtures/base-prompt-baseline.json +18 -0
  369. package/src/tests/github-app-worker-auth-helper.test.ts +325 -0
  370. package/src/tests/github-installation-token-route.test.ts +199 -0
  371. package/src/tests/gitlab-auth.test.ts +10 -0
  372. package/src/tests/heartbeat.test.ts +38 -0
  373. package/src/tests/http-api-integration.test.ts +0 -6
  374. package/src/tests/mcp-user-events.test.ts +708 -0
  375. package/src/tests/memory-key-paths.test.ts +4 -1
  376. package/src/tests/memory-search-stall.test.ts +421 -0
  377. package/src/tests/migration-322-runtime-pool-workspace.test.ts +116 -0
  378. package/src/tests/migration-329-workflow-run-retention.test.ts +32 -0
  379. package/src/tests/model-profile-fallbacks.test.ts +236 -2
  380. package/src/tests/opencode-adapter.test.ts +97 -0
  381. package/src/tests/pi-mono-extension.test.ts +168 -0
  382. package/src/tests/preload-env.test.ts +61 -1
  383. package/src/tests/preload.ts +22 -0
  384. package/src/tests/primitives-boards.test.ts +686 -0
  385. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  386. package/src/tests/primitives-objects.test.ts +248 -0
  387. package/src/tests/prompt-template-resolver.test.ts +85 -0
  388. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  389. package/src/tests/reload-config.test.ts +45 -0
  390. package/src/tests/request-composition.test.ts +447 -0
  391. package/src/tests/runner-max-concurrent.test.ts +86 -0
  392. package/src/tests/runtime-pools-db.test.ts +80 -0
  393. package/src/tests/runtime-provider-registration.test.ts +8 -0
  394. package/src/tests/runtime-providers-docker.test.ts +192 -1
  395. package/src/tests/runtime-providers-k8s.test.ts +127 -0
  396. package/src/tests/runtime-remote-controller.test.ts +64 -1
  397. package/src/tests/runtime-supervisor.test.ts +101 -0
  398. package/src/tests/script-connections.test.ts +8 -0
  399. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  400. package/src/tests/scripts-namespaces.test.ts +211 -0
  401. package/src/tests/secret-scrub-gate.test.ts +1 -0
  402. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  403. package/src/tests/secret-scrubber.test.ts +1 -1
  404. package/src/tests/session-tokens.test.ts +27 -0
  405. package/src/tests/sheet-engine.test.ts +58 -0
  406. package/src/tests/slack-blocks.test.ts +18 -0
  407. package/src/tests/slack-empty-icon-config.test.ts +113 -0
  408. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  409. package/src/tests/slack-reaction-config.test.ts +38 -2
  410. package/src/tests/slack-read-boundaries.test.ts +4 -2
  411. package/src/tests/slack-render-v2-query-plans.test.ts +100 -1
  412. package/src/tests/slack-render-v2-reconcile.test.ts +75 -4
  413. package/src/tests/slack-render-v2.test.ts +683 -11
  414. package/src/tests/swarm-config-reserved-keys.test.ts +1 -0
  415. package/src/tests/task-session-prompts.test.ts +37 -0
  416. package/src/tests/task-start-after-commit.test.ts +82 -0
  417. package/src/tests/ui-logs-parser.test.ts +67 -0
  418. package/src/tests/user-delete-perf.test.ts +36 -9
  419. package/src/tests/webhook-filter.test.ts +327 -0
  420. package/src/tests/workflow-async-v2.test.ts +19 -16
  421. package/src/tests/workflow-e2e.test.ts +1 -9
  422. package/src/tests/workflow-finalization-races.test.ts +553 -0
  423. package/src/tests/workflow-foreach.test.ts +2 -0
  424. package/src/tests/workflow-hitl-routing.test.ts +26 -20
  425. package/src/tests/workflow-http-v2.test.ts +105 -2
  426. package/src/tests/workflow-idempotency.test.ts +41 -0
  427. package/src/tests/workflow-mcp-webhook-filter.test.ts +214 -0
  428. package/src/tests/workflow-parallel-park.test.ts +297 -0
  429. package/src/tests/workflow-retry-v2.test.ts +158 -21
  430. package/src/tests/workflow-retry-validation.test.ts +13 -13
  431. package/src/tests/workflow-runs-retention.test.ts +533 -0
  432. package/src/tests/workflow-script-principal.test.ts +7 -2
  433. package/src/tests/workflow-tla-races.test.ts +36 -2
  434. package/src/tests/workflow-triggers-v2.test.ts +201 -0
  435. package/src/tests/workflow-wait-builtin-events.test.ts +3 -1
  436. package/src/tests/workflow-wait-event.test.ts +28 -2
  437. package/src/tests/workflow-wait-poller.test.ts +94 -0
  438. package/src/tests/workflow-wait-time.test.ts +7 -3
  439. package/src/tests/workflow-wait.ts +44 -0
  440. package/src/tools/boards.ts +260 -0
  441. package/src/tools/objects.ts +191 -0
  442. package/src/tools/sheets.ts +312 -0
  443. package/src/tools/slack-read.ts +10 -3
  444. package/src/tools/tool-config.ts +23 -0
  445. package/src/tools/workflows/create-workflow.ts +18 -4
  446. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  447. package/src/tools/workflows/patch-workflow.ts +4 -0
  448. package/src/tools/workflows/update-workflow.ts +24 -3
  449. package/src/types.ts +216 -2
  450. package/src/utils/credentials.ts +7 -0
  451. package/src/utils/sandboxed-process.ts +47 -2
  452. package/src/utils/secret-scrubber.ts +61 -6
  453. package/src/workflows/checkpoint.ts +18 -0
  454. package/src/workflows/engine.ts +73 -31
  455. package/src/workflows/foreach-driver.ts +42 -4
  456. package/src/workflows/input.ts +29 -1
  457. package/src/workflows/patch-definition.ts +15 -1
  458. package/src/workflows/recovery.ts +6 -1
  459. package/src/workflows/resume.ts +11 -3
  460. package/src/workflows/retry-poller.ts +32 -6
  461. package/src/workflows/successor-routing.ts +108 -0
  462. package/src/workflows/task-step-routing.ts +5 -2
  463. package/src/workflows/triggers.ts +21 -36
  464. package/src/workflows/validation.ts +10 -0
  465. package/src/workflows/wait-poller.ts +6 -2
  466. package/src/workflows/webhook-filter.ts +203 -0
  467. package/templates/ai-toolbox.manifest.json +1 -1
  468. package/templates/extensions/slack-reply-gate/hooks.ts +8 -4
  469. package/templates/skills/agent-browser/SKILL.md +1 -0
  470. package/templates/skills/agent-browser/content.md +1 -0
  471. package/templates/skills/pages/content.md +5 -0
  472. package/templates/skills/swarm-docs/content.md +8 -1
  473. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  474. package/templates/skills/swarm-scripts/content.md +1 -0
  475. package/templates/skills/tdd-planning/content.md +5 -2
  476. package/dist/acp-adapter-bht22g3k.js +0 -16
  477. package/dist/core-sxy4epp2.js +0 -38
  478. package/dist/fx-adapter-adtdb3jb.js +0 -19
  479. package/dist/grok-adapter-accnn9km.js +0 -19
  480. package/dist/handlers-1x77561e.js +0 -35
  481. package/dist/index-48qzcqzj.js +0 -35
  482. package/dist/index-rkvaambe.js +0 -36
  483. package/dist/index-xj1mq27m.js +0 -40
  484. package/dist/lead-enzn86bz.js +0 -74
  485. package/dist/thread-buffer-3x93yexa.js +0 -38
  486. package/dist/worker-zfcv2wbf.js +0 -74
  487. package/src/slack/socket-mode-guard.test.ts +0 -25
  488. package/src/tests/agent-activity.test.ts +0 -247
  489. package/src/tests/agent-fs-live-url.test.ts +0 -55
  490. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  491. package/src/tests/approval-sweeps-config.test.ts +0 -47
  492. package/src/tests/cards.test.ts +0 -169
  493. package/src/tests/chat-sdk-facts.test.ts +0 -23
  494. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  495. package/src/tests/core-auth.test.ts +0 -156
  496. package/src/tests/date-utils.test.ts +0 -48
  497. package/src/tests/db-context-versions.test.ts +0 -37
  498. package/src/tests/db-runtime.test.ts +0 -131
  499. package/src/tests/enabled-capabilities.test.ts +0 -20
  500. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  501. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  502. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  503. package/src/tests/github-event-labels.test.ts +0 -24
  504. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  505. package/src/tests/http-log-scrubbing.test.ts +0 -123
  506. package/src/tests/http-semconv-attributes.test.ts +0 -92
  507. package/src/tests/identity.test.ts +0 -117
  508. package/src/tests/inbox-state.test.ts +0 -167
  509. package/src/tests/internal-ai/models.test.ts +0 -54
  510. package/src/tests/launch-password-rejection.test.ts +0 -140
  511. package/src/tests/list-total-cache.test.ts +0 -88
  512. package/src/tests/match-route.test.ts +0 -187
  513. package/src/tests/memory-feature-flags.test.ts +0 -45
  514. package/src/tests/memory-get-tool.test.ts +0 -269
  515. package/src/tests/memory-health-endpoint.test.ts +0 -78
  516. package/src/tests/memory-http-access.test.ts +0 -221
  517. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  518. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  519. package/src/tests/openai-embedding-provider.test.ts +0 -159
  520. package/src/tests/org-identity.test.ts +0 -44
  521. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  522. package/src/tests/pages-browser-sdk.test.ts +0 -76
  523. package/src/tests/pages-feedback-keys.test.ts +0 -121
  524. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  525. package/src/tests/pages-list-endpoint.test.ts +0 -148
  526. package/src/tests/pages-password-mode.test.ts +0 -266
  527. package/src/tests/pages-public-authed-401.test.ts +0 -103
  528. package/src/tests/pages-public-html.test.ts +0 -297
  529. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  530. package/src/tests/pages-view-count.test.ts +0 -245
  531. package/src/tests/prompt-templates-db.test.ts +0 -616
  532. package/src/tests/rbac-engine.test.ts +0 -742
  533. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  534. package/src/tests/route-def-find-route.test.ts +0 -192
  535. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  536. package/src/tests/schedule-validation-helper.test.ts +0 -51
  537. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  538. package/src/tests/scheduler-backoff.test.ts +0 -166
  539. package/src/tests/script-run-token.test.ts +0 -75
  540. package/src/tests/scripts-extract-signature.test.ts +0 -47
  541. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  542. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  543. package/src/tests/short-id.test.ts +0 -23
  544. package/src/tests/skill-files-http.test.ts +0 -222
  545. package/src/tests/skill-get-file-tool.test.ts +0 -110
  546. package/src/tests/skill-script-refs.test.ts +0 -63
  547. package/src/tests/skill-update-scope.test.ts +0 -252
  548. package/src/tests/skills-bundle.test.ts +0 -99
  549. package/src/tests/slack-app-icon.test.ts +0 -94
  550. package/src/tests/slack-assistant-comention.test.ts +0 -139
  551. package/src/tests/slack-delete.test.ts +0 -157
  552. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  553. package/src/tests/slack-manifest.test.ts +0 -23
  554. package/src/tests/slack-task-output.test.ts +0 -90
  555. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  556. package/src/tests/swarm-diff.test.ts +0 -728
  557. package/src/tests/task-lifecycle-events.test.ts +0 -53
  558. package/src/tests/template-asset-config.test.ts +0 -18
  559. package/src/tests/template-fetch.test.ts +0 -490
  560. package/src/tests/themes-page-theme.test.ts +0 -155
  561. package/src/tests/tool-annotations.test.ts +0 -442
  562. package/src/tests/tool-output-agent-id.test.ts +0 -202
  563. package/src/tests/update-profile-agentid.test.ts +0 -248
  564. package/src/tests/whoami-route.test.ts +0 -162
  565. package/src/tests/workflow-definition-telemetry.test.ts +0 -134
  566. package/src/tests/workflow-patch.test.ts +0 -169
  567. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  568. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  569. package/src/tests/workflow-step-claims.test.ts +0 -152
  570. package/src/tests/workflow-step-order.test.ts +0 -92
  571. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  572. package/src/tests/workflow-versions.test.ts +0 -240
@@ -0,0 +1,101 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import { z } from "zod";
3
+ import { handleObjectWebhookEvent, objectWebhookSecret } from "../be/primitives/object-webhooks";
4
+ import { decodeStandardWebhookSecret, verifyStandardWebhookSignature } from "../workflows/triggers";
5
+ import { route } from "./route-def";
6
+ import { BODY_TOO_LARGE, enforceContentLengthCap, jsonError } from "./utils";
7
+
8
+ /** A `file.changed` envelope is metadata only (a few hundred bytes). */
9
+ const MAX_BODY_BYTES = 64 * 1024;
10
+
11
+ const objectWebhook = route({
12
+ method: "post",
13
+ path: "/api/objects/agent-fs-webhook/{id}",
14
+ pattern: ["api", "objects", "agent-fs-webhook", null],
15
+ summary: "Receive agent-fs file.changed events that keep primitive objects in sync",
16
+ tags: ["Webhooks"],
17
+ params: z.object({ id: z.string().describe("Receiver id the swarm registered with agent-fs") }),
18
+ auth: { apiKey: false },
19
+ rbac: {
20
+ ungated:
21
+ "provider webhook: authenticated by the per-drive Standard Webhooks HMAC secret the swarm registered with agent-fs, not a swarm principal",
22
+ },
23
+ responses: {
24
+ 200: {
25
+ description: "Event applied or ignored",
26
+ schema: z.object({
27
+ action: z.enum(["updated", "tombstoned", "restored", "moved", "ignored"]),
28
+ path: z.string(),
29
+ id: z.string().optional(),
30
+ reason: z.string().optional(),
31
+ }),
32
+ },
33
+ 400: { description: "Body is not a valid event" },
34
+ 401: { description: "Unknown receiver, missing headers or invalid signature" },
35
+ 413: { description: "Body exceeds 64 KiB" },
36
+ 503: { description: "agent-fs could not be read; agent-fs retries the delivery" },
37
+ },
38
+ });
39
+
40
+ const header = (req: IncomingMessage, name: string): string | undefined => {
41
+ const value = req.headers[name];
42
+ return Array.isArray(value) ? value[0] : value;
43
+ };
44
+
45
+ export async function handleObjectWebhooks(
46
+ req: IncomingMessage,
47
+ res: ServerResponse,
48
+ pathSegments: string[],
49
+ ): Promise<boolean> {
50
+ if (!objectWebhook.match(req.method, pathSegments)) return false;
51
+ if (enforceContentLengthCap(req, res, MAX_BODY_BYTES) === BODY_TOO_LARGE) return true;
52
+
53
+ const chunks: Buffer[] = [];
54
+ let received = 0;
55
+ for await (const chunk of req) {
56
+ received += (chunk as Buffer).byteLength;
57
+ if (received > MAX_BODY_BYTES) {
58
+ jsonError(res, `Payload too large (max ${MAX_BODY_BYTES} bytes)`, 413);
59
+ req.resume();
60
+ return true;
61
+ }
62
+ chunks.push(chunk as Buffer);
63
+ }
64
+ const rawBody = Buffer.concat(chunks).toString("utf-8");
65
+
66
+ // Standard Webhooks: HMAC over "{id}.{timestamp}.{body}", timestamp within
67
+ // 5 minutes. A replay inside that window is a no-op: events apply only above
68
+ // the row's stored file version.
69
+ const id = header(req, "webhook-id");
70
+ const timestamp = header(req, "webhook-timestamp");
71
+ const signature = header(req, "webhook-signature");
72
+ const hook = await objectWebhookSecret(pathSegments[3] ?? "");
73
+ const key = hook ? decodeStandardWebhookSecret(hook.secret) : null;
74
+ if (
75
+ !hook ||
76
+ !key ||
77
+ !id ||
78
+ !timestamp ||
79
+ !signature ||
80
+ !verifyStandardWebhookSignature(key, rawBody, { id, timestamp, signature })
81
+ ) {
82
+ jsonError(res, "Invalid webhook signature", 401);
83
+ return true;
84
+ }
85
+
86
+ let envelope: unknown;
87
+ try {
88
+ envelope = JSON.parse(rawBody);
89
+ } catch {
90
+ jsonError(res, "Invalid JSON body", 400);
91
+ return true;
92
+ }
93
+
94
+ const outcome = await handleObjectWebhookEvent(hook, envelope);
95
+ if (outcome.status === 200) {
96
+ objectWebhook.respond(res, 200, outcome.result);
97
+ } else {
98
+ jsonError(res, outcome.error, outcome.status);
99
+ }
100
+ return true;
101
+ }
@@ -18,6 +18,7 @@ import type { IncomingMessage, ServerResponse } from "node:http";
18
18
  import { fingerprintApiKey, type IdentityActor } from "../be/users";
19
19
  import { getApiKey } from "../utils/api-key";
20
20
  import { getRequestAuth } from "../utils/request-auth-context";
21
+ import { verifyTokenEquality } from "../workflows/triggers";
21
22
  import { authUserId, isOperatorAuth, rejectGuest } from "./request-principal";
22
23
  import { jsonError } from "./utils";
23
24
 
@@ -63,7 +64,7 @@ export function getOperatorActor(req: IncomingMessage, res: ServerResponse): Ide
63
64
  return { kind: "operator", id: fingerprintApiKey("") };
64
65
  }
65
66
 
66
- if (!rawKey || rawKey !== swarmKey) {
67
+ if (!rawKey || !verifyTokenEquality(swarmKey, rawKey)) {
67
68
  jsonError(res, "Unauthorized", 401);
68
69
  return null;
69
70
  }
@@ -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
+ }
@@ -12,6 +12,7 @@ import { SOURCE_GROUPS_READ_ONLY, sourceMoveError, sourceOfKey } from "../assets
12
12
  import { AssetKeyAuthorizationError, authorizeAssetKeyWrite } from "../be/asset-key-auth";
13
13
  import { resolveHttpAuditUserId } from "../be/audit-user";
14
14
  import {
15
+ AgentDeletedError,
15
16
  AssetKeyMovesBlockedError,
16
17
  assertAssetKeyMovesAllowed,
17
18
  countSessions,
@@ -325,6 +326,7 @@ const mintAgentTokenRoute = route({
325
326
  403: { description: "Operator or user credentials required" },
326
327
  404: { description: "Agent not found and no name given" },
327
328
  409: { description: "Agent already holds an active token" },
329
+ 410: { description: "An operator deleted this agent id (`agent_deleted`); restore it first" },
328
330
  },
329
331
  rbac: { permission: "agent.token.manage" },
330
332
  });
@@ -475,8 +477,13 @@ async function handleAgentTokens(
475
477
  })
476
478
  .catch((error) => {
477
479
  if (error instanceof AgentTokenExistsError) return { status: 409 as const };
480
+ if (error instanceof AgentDeletedError) return { status: 410 as const };
478
481
  throw error;
479
482
  });
483
+ if (result.status === 410) {
484
+ jsonError(res, "agent_deleted", 410);
485
+ return true;
486
+ }
480
487
  if (result.status === 404) {
481
488
  jsonError(res, "Agent not found; pass name to create it", 404);
482
489
  return true;
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
+ }