@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/openapi.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "openapi": "3.1.0",
3
3
  "info": {
4
4
  "title": "Agent Swarm API",
5
- "version": "2.10.0",
5
+ "version": "2.11.0",
6
6
  "description": "Multi-agent orchestration API for Claude Code, Codex, and Gemini CLI. Enables task distribution, agent communication, and service discovery.\n\nMCP tools are documented separately in [MCP.md](./MCP.md)."
7
7
  },
8
8
  "servers": [
@@ -4179,6 +4179,126 @@
4179
4179
  "review"
4180
4180
  ]
4181
4181
  },
4182
+ "RequestComposition": {
4183
+ "type": "object",
4184
+ "properties": {
4185
+ "id": {
4186
+ "type": "string",
4187
+ "format": "uuid"
4188
+ },
4189
+ "taskId": {
4190
+ "type": "string"
4191
+ },
4192
+ "agentId": {
4193
+ "type": "string"
4194
+ },
4195
+ "sessionId": {
4196
+ "type": "string"
4197
+ },
4198
+ "seq": {
4199
+ "type": "integer",
4200
+ "minimum": 0
4201
+ },
4202
+ "provider": {
4203
+ "type": "string"
4204
+ },
4205
+ "model": {
4206
+ "type": [
4207
+ "string",
4208
+ "null"
4209
+ ]
4210
+ },
4211
+ "source": {
4212
+ "type": "string",
4213
+ "enum": [
4214
+ "worker",
4215
+ "harness-hook"
4216
+ ]
4217
+ },
4218
+ "parts": {
4219
+ "type": "array",
4220
+ "items": {
4221
+ "$ref": "#/components/schemas/RequestCompositionPart"
4222
+ }
4223
+ },
4224
+ "staticEstTokens": {
4225
+ "type": "integer",
4226
+ "minimum": 0
4227
+ },
4228
+ "tokenRatio": {
4229
+ "type": "number"
4230
+ },
4231
+ "createdAt": {
4232
+ "type": "string",
4233
+ "format": "date-time"
4234
+ }
4235
+ },
4236
+ "required": [
4237
+ "id",
4238
+ "taskId",
4239
+ "agentId",
4240
+ "sessionId",
4241
+ "seq",
4242
+ "provider",
4243
+ "model",
4244
+ "source",
4245
+ "parts",
4246
+ "staticEstTokens",
4247
+ "tokenRatio",
4248
+ "createdAt"
4249
+ ]
4250
+ },
4251
+ "RequestCompositionPart": {
4252
+ "type": "object",
4253
+ "properties": {
4254
+ "kind": {
4255
+ "type": "string",
4256
+ "enum": [
4257
+ "system_section",
4258
+ "persona",
4259
+ "claude_md",
4260
+ "operator_prompt",
4261
+ "tool_schemas",
4262
+ "skills_listing",
4263
+ "task_prompt",
4264
+ "memories"
4265
+ ]
4266
+ },
4267
+ "id": {
4268
+ "type": "string",
4269
+ "minLength": 1,
4270
+ "maxLength": 200
4271
+ },
4272
+ "label": {
4273
+ "type": "string",
4274
+ "minLength": 1,
4275
+ "maxLength": 200
4276
+ },
4277
+ "chars": {
4278
+ "type": "integer",
4279
+ "minimum": 0
4280
+ },
4281
+ "fidelity": {
4282
+ "type": "string",
4283
+ "enum": [
4284
+ "exact",
4285
+ "estimate"
4286
+ ],
4287
+ "default": "exact"
4288
+ },
4289
+ "estTokens": {
4290
+ "type": "integer",
4291
+ "minimum": 0
4292
+ }
4293
+ },
4294
+ "required": [
4295
+ "kind",
4296
+ "id",
4297
+ "label",
4298
+ "chars",
4299
+ "estTokens"
4300
+ ]
4301
+ },
4182
4302
  "ScriptRun": {
4183
4303
  "type": "object",
4184
4304
  "properties": {
@@ -5682,12 +5802,94 @@
5682
5802
  "type": "string",
5683
5803
  "minLength": 1
5684
5804
  },
5685
- "description": "Optional event allowlist, matched exactly against the eventHeader value after signature verification. A delivery whose event is not listed (or that has no event header) gets a 2xx `skipped` reply and creates no run. Omit or leave empty to accept every event."
5805
+ "description": "Deprecated alias of one delivery-filter clause, AND-ed with filter. Matched exactly against eventHeader, or against the preset event field when eventHeader is omitted: X-GitHub-Event (github, and the default), X-Gitlab-Event (gitlab), or JSON body type (standard-webhooks). A miss returns 200 skipped with reason event-not-allowed and creates no run. Omit or leave empty to add no event clause."
5686
5806
  },
5687
5807
  "eventHeader": {
5688
5808
  "type": "string",
5689
5809
  "minLength": 1,
5690
- "description": "Request header holding the event name for `events` (case-insensitive lookup). Defaults to X-GitHub-Event."
5810
+ "description": "Deprecated. Header read for events. The name lookup is case-insensitive and the value is exact. Overrides preset. Defaults to X-GitHub-Event when preset is omitted."
5811
+ },
5812
+ "preset": {
5813
+ "type": "string",
5814
+ "enum": [
5815
+ "github",
5816
+ "gitlab",
5817
+ "standard-webhooks"
5818
+ ],
5819
+ "description": "Optional sender preset for the events allowlist. github reads X-GitHub-Event, gitlab reads X-Gitlab-Event, and standard-webhooks reads the JSON body field type. A preset alone does not filter. Ignored when eventHeader is set."
5820
+ },
5821
+ "filter": {
5822
+ "type": "object",
5823
+ "properties": {
5824
+ "headers": {
5825
+ "type": "object",
5826
+ "additionalProperties": {
5827
+ "anyOf": [
5828
+ {
5829
+ "type": "string",
5830
+ "minLength": 1,
5831
+ "maxLength": 512
5832
+ },
5833
+ {
5834
+ "type": "array",
5835
+ "items": {
5836
+ "type": "string",
5837
+ "minLength": 1,
5838
+ "maxLength": 512
5839
+ },
5840
+ "minItems": 1,
5841
+ "maxItems": 64
5842
+ }
5843
+ ]
5844
+ },
5845
+ "description": "Header name to one exact value, or a list of exact values. Names are matched case-insensitively. Every entry must match."
5846
+ },
5847
+ "body": {
5848
+ "type": "object",
5849
+ "additionalProperties": {
5850
+ "anyOf": [
5851
+ {
5852
+ "type": "string",
5853
+ "maxLength": 512
5854
+ },
5855
+ {
5856
+ "type": "number"
5857
+ },
5858
+ {
5859
+ "type": "boolean"
5860
+ },
5861
+ {
5862
+ "type": "null"
5863
+ },
5864
+ {
5865
+ "type": "array",
5866
+ "items": {
5867
+ "anyOf": [
5868
+ {
5869
+ "type": "string",
5870
+ "maxLength": 512
5871
+ },
5872
+ {
5873
+ "type": "number"
5874
+ },
5875
+ {
5876
+ "type": "boolean"
5877
+ },
5878
+ {
5879
+ "type": "null"
5880
+ }
5881
+ ]
5882
+ },
5883
+ "minItems": 1,
5884
+ "maxItems": 64
5885
+ }
5886
+ ]
5887
+ },
5888
+ "description": "Dot path into the JSON body, to one exact scalar or a list of scalars. A numeric segment indexes an array (commits.0.id). No type coercion. Every entry must match."
5889
+ }
5890
+ },
5891
+ "additionalProperties": false,
5892
+ "description": "Header and JSON body allowlists, AND-ed with events. Evaluated after signature verification and before a run is saved. A miss returns 200 skipped with reason filter-not-matched and creates no run."
5691
5893
  }
5692
5894
  },
5693
5895
  "required": [
@@ -6460,12 +6662,94 @@
6460
6662
  "type": "string",
6461
6663
  "minLength": 1
6462
6664
  },
6463
- "description": "Optional event allowlist, matched exactly against the eventHeader value after signature verification. A delivery whose event is not listed (or that has no event header) gets a 2xx `skipped` reply and creates no run. Omit or leave empty to accept every event."
6665
+ "description": "Deprecated alias of one delivery-filter clause, AND-ed with filter. Matched exactly against eventHeader, or against the preset event field when eventHeader is omitted: X-GitHub-Event (github, and the default), X-Gitlab-Event (gitlab), or JSON body type (standard-webhooks). A miss returns 200 skipped with reason event-not-allowed and creates no run. Omit or leave empty to add no event clause."
6464
6666
  },
6465
6667
  "eventHeader": {
6466
6668
  "type": "string",
6467
6669
  "minLength": 1,
6468
- "description": "Request header holding the event name for `events` (case-insensitive lookup). Defaults to X-GitHub-Event."
6670
+ "description": "Deprecated. Header read for events. The name lookup is case-insensitive and the value is exact. Overrides preset. Defaults to X-GitHub-Event when preset is omitted."
6671
+ },
6672
+ "preset": {
6673
+ "type": "string",
6674
+ "enum": [
6675
+ "github",
6676
+ "gitlab",
6677
+ "standard-webhooks"
6678
+ ],
6679
+ "description": "Optional sender preset for the events allowlist. github reads X-GitHub-Event, gitlab reads X-Gitlab-Event, and standard-webhooks reads the JSON body field type. A preset alone does not filter. Ignored when eventHeader is set."
6680
+ },
6681
+ "filter": {
6682
+ "type": "object",
6683
+ "properties": {
6684
+ "headers": {
6685
+ "type": "object",
6686
+ "additionalProperties": {
6687
+ "anyOf": [
6688
+ {
6689
+ "type": "string",
6690
+ "minLength": 1,
6691
+ "maxLength": 512
6692
+ },
6693
+ {
6694
+ "type": "array",
6695
+ "items": {
6696
+ "type": "string",
6697
+ "minLength": 1,
6698
+ "maxLength": 512
6699
+ },
6700
+ "minItems": 1,
6701
+ "maxItems": 64
6702
+ }
6703
+ ]
6704
+ },
6705
+ "description": "Header name to one exact value, or a list of exact values. Names are matched case-insensitively. Every entry must match."
6706
+ },
6707
+ "body": {
6708
+ "type": "object",
6709
+ "additionalProperties": {
6710
+ "anyOf": [
6711
+ {
6712
+ "type": "string",
6713
+ "maxLength": 512
6714
+ },
6715
+ {
6716
+ "type": "number"
6717
+ },
6718
+ {
6719
+ "type": "boolean"
6720
+ },
6721
+ {
6722
+ "type": "null"
6723
+ },
6724
+ {
6725
+ "type": "array",
6726
+ "items": {
6727
+ "anyOf": [
6728
+ {
6729
+ "type": "string",
6730
+ "maxLength": 512
6731
+ },
6732
+ {
6733
+ "type": "number"
6734
+ },
6735
+ {
6736
+ "type": "boolean"
6737
+ },
6738
+ {
6739
+ "type": "null"
6740
+ }
6741
+ ]
6742
+ },
6743
+ "minItems": 1,
6744
+ "maxItems": 64
6745
+ }
6746
+ ]
6747
+ },
6748
+ "description": "Dot path into the JSON body, to one exact scalar or a list of scalars. A numeric segment indexes an array (commits.0.id). No type coercion. Every entry must match."
6749
+ }
6750
+ },
6751
+ "additionalProperties": false,
6752
+ "description": "Header and JSON body allowlists, AND-ed with events. Evaluated after signature verification and before a run is saved. A miss returns 200 skipped with reason filter-not-matched and creates no run."
6469
6753
  }
6470
6754
  },
6471
6755
  "required": [
@@ -6727,6 +7011,21 @@
6727
7011
  ],
6728
7012
  "additionalProperties": false
6729
7013
  },
7014
+ "workspace": {
7015
+ "type": [
7016
+ "object",
7017
+ "null"
7018
+ ],
7019
+ "properties": {
7020
+ "sizeGb": {
7021
+ "type": "integer",
7022
+ "minimum": 1,
7023
+ "maximum": 1024
7024
+ }
7025
+ },
7026
+ "default": null,
7027
+ "additionalProperties": false
7028
+ },
6730
7029
  "ttlSec": {
6731
7030
  "type": [
6732
7031
  "integer",
@@ -6877,6 +7176,12 @@
6877
7176
  "null"
6878
7177
  ]
6879
7178
  },
7179
+ "workspaceSlot": {
7180
+ "type": [
7181
+ "integer",
7182
+ "null"
7183
+ ]
7184
+ },
6880
7185
  "reportedSlots": {
6881
7186
  "type": "integer"
6882
7187
  },
@@ -12378,6 +12683,12 @@
12378
12683
  "null"
12379
12684
  ]
12380
12685
  },
12686
+ "workspaceSlot": {
12687
+ "type": [
12688
+ "integer",
12689
+ "null"
12690
+ ]
12691
+ },
12381
12692
  "reportedSlots": {
12382
12693
  "type": "integer"
12383
12694
  },
@@ -25606,45 +25917,73 @@
25606
25917
  }
25607
25918
  }
25608
25919
  },
25609
- "/api/heartbeat/sweep": {
25920
+ "/api/github/installation-token": {
25610
25921
  "post": {
25611
- "summary": "Trigger an immediate heartbeat sweep",
25922
+ "summary": "Mint a GitHub App installation token for worker git and gh",
25923
+ "description": "Internal worker endpoint. Returns a short-lived installation token for the installation in `GITHUB_APP_INSTALLATION_ID`, minted with the API server's GitHub App credentials. The caller cannot choose the installation. Only a registered agent (swarm API key plus X-Agent-ID, or an agent or runtime token) may call it; user, guest and ACP task tokens are refused. 404 when the App or the installation id is not configured, so workers fall back to `GITHUB_TOKEN`.",
25612
25924
  "tags": [
25613
- "Heartbeat"
25925
+ "GitHub"
25614
25926
  ],
25615
25927
  "security": [
25616
25928
  {
25617
25929
  "bearerAuth": []
25618
25930
  }
25619
25931
  ],
25932
+ "requestBody": {
25933
+ "content": {
25934
+ "application/json": {
25935
+ "schema": {
25936
+ "type": "object",
25937
+ "properties": {}
25938
+ }
25939
+ }
25940
+ }
25941
+ },
25620
25942
  "responses": {
25621
25943
  "200": {
25622
- "description": "Sweep completed successfully",
25944
+ "description": "Installation token and its expiry (ISO 8601)",
25623
25945
  "content": {
25624
25946
  "application/json": {
25625
25947
  "schema": {
25626
25948
  "type": "object",
25627
25949
  "properties": {
25628
- "success": {
25629
- "type": "boolean",
25630
- "enum": [
25631
- true
25632
- ]
25950
+ "token": {
25951
+ "type": "string"
25633
25952
  },
25634
- "message": {
25953
+ "expiresAt": {
25635
25954
  "type": "string"
25636
25955
  }
25637
25956
  },
25638
25957
  "required": [
25639
- "success",
25640
- "message"
25958
+ "token",
25959
+ "expiresAt"
25641
25960
  ]
25642
25961
  }
25643
25962
  }
25644
25963
  }
25645
25964
  },
25646
- "401": {
25647
- "description": "Unauthorized",
25965
+ "403": {
25966
+ "description": "Caller is not a registered agent",
25967
+ "content": {
25968
+ "application/json": {
25969
+ "schema": {
25970
+ "$ref": "#/components/schemas/ErrorResponse"
25971
+ }
25972
+ }
25973
+ }
25974
+ },
25975
+ "404": {
25976
+ "description": "GitHub App worker auth is not configured",
25977
+ "content": {
25978
+ "application/json": {
25979
+ "schema": {
25980
+ "$ref": "#/components/schemas/ErrorResponse"
25981
+ }
25982
+ }
25983
+ }
25984
+ },
25985
+ "502": {
25986
+ "description": "GitHub refused or failed to mint the token",
25648
25987
  "content": {
25649
25988
  "application/json": {
25650
25989
  "schema": {
@@ -25656,9 +25995,9 @@
25656
25995
  }
25657
25996
  }
25658
25997
  },
25659
- "/api/heartbeat/checklist": {
25998
+ "/api/heartbeat/sweep": {
25660
25999
  "post": {
25661
- "summary": "Trigger an immediate heartbeat checklist check",
26000
+ "summary": "Trigger an immediate heartbeat sweep",
25662
26001
  "tags": [
25663
26002
  "Heartbeat"
25664
26003
  ],
@@ -25669,7 +26008,57 @@
25669
26008
  ],
25670
26009
  "responses": {
25671
26010
  "200": {
25672
- "description": "Checklist check completed successfully",
26011
+ "description": "Sweep completed successfully",
26012
+ "content": {
26013
+ "application/json": {
26014
+ "schema": {
26015
+ "type": "object",
26016
+ "properties": {
26017
+ "success": {
26018
+ "type": "boolean",
26019
+ "enum": [
26020
+ true
26021
+ ]
26022
+ },
26023
+ "message": {
26024
+ "type": "string"
26025
+ }
26026
+ },
26027
+ "required": [
26028
+ "success",
26029
+ "message"
26030
+ ]
26031
+ }
26032
+ }
26033
+ }
26034
+ },
26035
+ "401": {
26036
+ "description": "Unauthorized",
26037
+ "content": {
26038
+ "application/json": {
26039
+ "schema": {
26040
+ "$ref": "#/components/schemas/ErrorResponse"
26041
+ }
26042
+ }
26043
+ }
26044
+ }
26045
+ }
26046
+ }
26047
+ },
26048
+ "/api/heartbeat/checklist": {
26049
+ "post": {
26050
+ "summary": "Trigger an immediate heartbeat checklist check",
26051
+ "tags": [
26052
+ "Heartbeat"
26053
+ ],
26054
+ "security": [
26055
+ {
26056
+ "bearerAuth": []
26057
+ }
26058
+ ],
26059
+ "responses": {
26060
+ "200": {
26061
+ "description": "Checklist check completed successfully",
25673
26062
  "content": {
25674
26063
  "application/json": {
25675
26064
  "schema": {
@@ -40123,7 +40512,7 @@
40123
40512
  "/api/tasks/{id}/supersede": {
40124
40513
  "post": {
40125
40514
  "summary": "Supersede an in-progress task (terminate + spawn resume follow-up)",
40126
- "description": "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.",
40515
+ "description": "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.",
40127
40516
  "tags": [
40128
40517
  "Tasks"
40129
40518
  ],
@@ -41946,6 +42335,24 @@
41946
42335
  "items": {
41947
42336
  "type": "string"
41948
42337
  }
42338
+ },
42339
+ "segments": {
42340
+ "type": "array",
42341
+ "items": {
42342
+ "type": "object",
42343
+ "properties": {
42344
+ "templateId": {
42345
+ "type": "string"
42346
+ },
42347
+ "chars": {
42348
+ "type": "integer"
42349
+ }
42350
+ },
42351
+ "required": [
42352
+ "templateId",
42353
+ "chars"
42354
+ ]
42355
+ }
41949
42356
  }
41950
42357
  },
41951
42358
  "required": [
@@ -42286,6 +42693,24 @@
42286
42693
  "items": {
42287
42694
  "type": "string"
42288
42695
  }
42696
+ },
42697
+ "segments": {
42698
+ "type": "array",
42699
+ "items": {
42700
+ "type": "object",
42701
+ "properties": {
42702
+ "templateId": {
42703
+ "type": "string"
42704
+ },
42705
+ "chars": {
42706
+ "type": "integer"
42707
+ }
42708
+ },
42709
+ "required": [
42710
+ "templateId",
42711
+ "chars"
42712
+ ]
42713
+ }
42289
42714
  }
42290
42715
  },
42291
42716
  "required": [
@@ -44157,6 +44582,289 @@
44157
44582
  }
44158
44583
  }
44159
44584
  },
44585
+ "/api/tasks/{id}/request-composition": {
44586
+ "post": {
44587
+ "summary": "Record the request composition manifest of a task session",
44588
+ "description": "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.",
44589
+ "tags": [
44590
+ "Tasks"
44591
+ ],
44592
+ "security": [
44593
+ {
44594
+ "bearerAuth": []
44595
+ }
44596
+ ],
44597
+ "parameters": [
44598
+ {
44599
+ "schema": {
44600
+ "type": "string"
44601
+ },
44602
+ "required": true,
44603
+ "name": "id",
44604
+ "in": "path"
44605
+ }
44606
+ ],
44607
+ "requestBody": {
44608
+ "content": {
44609
+ "application/json": {
44610
+ "schema": {
44611
+ "type": "object",
44612
+ "properties": {
44613
+ "sessionId": {
44614
+ "type": "string",
44615
+ "minLength": 1
44616
+ },
44617
+ "provider": {
44618
+ "type": "string",
44619
+ "minLength": 1
44620
+ },
44621
+ "model": {
44622
+ "type": "string"
44623
+ },
44624
+ "toolLoading": {
44625
+ "type": "string",
44626
+ "enum": [
44627
+ "all",
44628
+ "core",
44629
+ "preloaded",
44630
+ "none"
44631
+ ]
44632
+ },
44633
+ "parts": {
44634
+ "type": "array",
44635
+ "items": {
44636
+ "type": "object",
44637
+ "properties": {
44638
+ "kind": {
44639
+ "type": "string",
44640
+ "enum": [
44641
+ "system_section",
44642
+ "persona",
44643
+ "claude_md",
44644
+ "operator_prompt",
44645
+ "tool_schemas",
44646
+ "skills_listing",
44647
+ "task_prompt",
44648
+ "memories"
44649
+ ]
44650
+ },
44651
+ "id": {
44652
+ "type": "string",
44653
+ "minLength": 1,
44654
+ "maxLength": 200
44655
+ },
44656
+ "label": {
44657
+ "type": "string",
44658
+ "minLength": 1,
44659
+ "maxLength": 200
44660
+ },
44661
+ "chars": {
44662
+ "type": "integer",
44663
+ "minimum": 0
44664
+ },
44665
+ "fidelity": {
44666
+ "type": "string",
44667
+ "enum": [
44668
+ "exact",
44669
+ "estimate"
44670
+ ],
44671
+ "default": "exact"
44672
+ }
44673
+ },
44674
+ "required": [
44675
+ "kind",
44676
+ "id",
44677
+ "label",
44678
+ "chars"
44679
+ ]
44680
+ },
44681
+ "maxItems": 200
44682
+ },
44683
+ "source": {
44684
+ "type": "string",
44685
+ "enum": [
44686
+ "worker",
44687
+ "harness-hook"
44688
+ ],
44689
+ "default": "worker"
44690
+ },
44691
+ "harness": {
44692
+ "type": "object",
44693
+ "properties": {
44694
+ "systemChars": {
44695
+ "type": "integer",
44696
+ "minimum": 0
44697
+ },
44698
+ "payloadChars": {
44699
+ "type": "integer",
44700
+ "minimum": 0
44701
+ },
44702
+ "promptTokens": {
44703
+ "type": "integer",
44704
+ "minimum": 0
44705
+ },
44706
+ "firstMessageChars": {
44707
+ "type": "integer",
44708
+ "minimum": 0
44709
+ }
44710
+ },
44711
+ "required": [
44712
+ "systemChars",
44713
+ "payloadChars",
44714
+ "promptTokens"
44715
+ ]
44716
+ }
44717
+ },
44718
+ "required": [
44719
+ "sessionId",
44720
+ "provider",
44721
+ "toolLoading",
44722
+ "parts"
44723
+ ]
44724
+ }
44725
+ }
44726
+ }
44727
+ },
44728
+ "responses": {
44729
+ "200": {
44730
+ "description": "Manifest recorded",
44731
+ "content": {
44732
+ "application/json": {
44733
+ "schema": {
44734
+ "type": "object",
44735
+ "properties": {
44736
+ "ok": {
44737
+ "type": "boolean",
44738
+ "enum": [
44739
+ true
44740
+ ]
44741
+ },
44742
+ "id": {
44743
+ "type": "string",
44744
+ "format": "uuid"
44745
+ },
44746
+ "seq": {
44747
+ "type": "integer",
44748
+ "minimum": 0
44749
+ }
44750
+ },
44751
+ "required": [
44752
+ "ok",
44753
+ "id",
44754
+ "seq"
44755
+ ]
44756
+ }
44757
+ }
44758
+ }
44759
+ },
44760
+ "400": {
44761
+ "description": "Validation error",
44762
+ "content": {
44763
+ "application/json": {
44764
+ "schema": {
44765
+ "$ref": "#/components/schemas/ErrorResponse"
44766
+ }
44767
+ }
44768
+ }
44769
+ },
44770
+ "403": {
44771
+ "description": "Task is assigned to another agent",
44772
+ "content": {
44773
+ "application/json": {
44774
+ "schema": {
44775
+ "$ref": "#/components/schemas/ErrorResponse"
44776
+ }
44777
+ }
44778
+ }
44779
+ },
44780
+ "404": {
44781
+ "description": "Task not found",
44782
+ "content": {
44783
+ "application/json": {
44784
+ "schema": {
44785
+ "$ref": "#/components/schemas/ErrorResponse"
44786
+ }
44787
+ }
44788
+ }
44789
+ },
44790
+ "429": {
44791
+ "description": "The task already holds the maximum number of manifests",
44792
+ "content": {
44793
+ "application/json": {
44794
+ "schema": {
44795
+ "$ref": "#/components/schemas/ErrorResponse"
44796
+ }
44797
+ }
44798
+ }
44799
+ }
44800
+ }
44801
+ },
44802
+ "get": {
44803
+ "summary": "Get the request composition manifests of a task",
44804
+ "tags": [
44805
+ "Tasks"
44806
+ ],
44807
+ "security": [
44808
+ {
44809
+ "bearerAuth": []
44810
+ }
44811
+ ],
44812
+ "parameters": [
44813
+ {
44814
+ "schema": {
44815
+ "type": "string"
44816
+ },
44817
+ "required": true,
44818
+ "name": "id",
44819
+ "in": "path"
44820
+ },
44821
+ {
44822
+ "schema": {
44823
+ "type": "integer",
44824
+ "minimum": 1,
44825
+ "maximum": 100,
44826
+ "default": 100
44827
+ },
44828
+ "required": false,
44829
+ "name": "limit",
44830
+ "in": "query"
44831
+ }
44832
+ ],
44833
+ "responses": {
44834
+ "200": {
44835
+ "description": "Manifests, oldest first",
44836
+ "content": {
44837
+ "application/json": {
44838
+ "schema": {
44839
+ "type": "object",
44840
+ "properties": {
44841
+ "manifests": {
44842
+ "type": "array",
44843
+ "items": {
44844
+ "$ref": "#/components/schemas/RequestComposition"
44845
+ }
44846
+ }
44847
+ },
44848
+ "required": [
44849
+ "manifests"
44850
+ ]
44851
+ }
44852
+ }
44853
+ }
44854
+ },
44855
+ "404": {
44856
+ "description": "Task not found",
44857
+ "content": {
44858
+ "application/json": {
44859
+ "schema": {
44860
+ "$ref": "#/components/schemas/ErrorResponse"
44861
+ }
44862
+ }
44863
+ }
44864
+ }
44865
+ }
44866
+ }
44867
+ },
44160
44868
  "/api/realtime/ticket": {
44161
44869
  "post": {
44162
44870
  "summary": "Issue a one-shot dashboard realtime ticket",
@@ -71733,12 +72441,94 @@
71733
72441
  "type": "string",
71734
72442
  "minLength": 1
71735
72443
  },
71736
- "description": "Optional event allowlist, matched exactly against the eventHeader value after signature verification. A delivery whose event is not listed (or that has no event header) gets a 2xx `skipped` reply and creates no run. Omit or leave empty to accept every event."
72444
+ "description": "Deprecated alias of one delivery-filter clause, AND-ed with filter. Matched exactly against eventHeader, or against the preset event field when eventHeader is omitted: X-GitHub-Event (github, and the default), X-Gitlab-Event (gitlab), or JSON body type (standard-webhooks). A miss returns 200 skipped with reason event-not-allowed and creates no run. Omit or leave empty to add no event clause."
71737
72445
  },
71738
72446
  "eventHeader": {
71739
72447
  "type": "string",
71740
72448
  "minLength": 1,
71741
- "description": "Request header holding the event name for `events` (case-insensitive lookup). Defaults to X-GitHub-Event."
72449
+ "description": "Deprecated. Header read for events. The name lookup is case-insensitive and the value is exact. Overrides preset. Defaults to X-GitHub-Event when preset is omitted."
72450
+ },
72451
+ "preset": {
72452
+ "type": "string",
72453
+ "enum": [
72454
+ "github",
72455
+ "gitlab",
72456
+ "standard-webhooks"
72457
+ ],
72458
+ "description": "Optional sender preset for the events allowlist. github reads X-GitHub-Event, gitlab reads X-Gitlab-Event, and standard-webhooks reads the JSON body field type. A preset alone does not filter. Ignored when eventHeader is set."
72459
+ },
72460
+ "filter": {
72461
+ "type": "object",
72462
+ "properties": {
72463
+ "headers": {
72464
+ "type": "object",
72465
+ "additionalProperties": {
72466
+ "anyOf": [
72467
+ {
72468
+ "type": "string",
72469
+ "minLength": 1,
72470
+ "maxLength": 512
72471
+ },
72472
+ {
72473
+ "type": "array",
72474
+ "items": {
72475
+ "type": "string",
72476
+ "minLength": 1,
72477
+ "maxLength": 512
72478
+ },
72479
+ "minItems": 1,
72480
+ "maxItems": 64
72481
+ }
72482
+ ]
72483
+ },
72484
+ "description": "Header name to one exact value, or a list of exact values. Names are matched case-insensitively. Every entry must match."
72485
+ },
72486
+ "body": {
72487
+ "type": "object",
72488
+ "additionalProperties": {
72489
+ "anyOf": [
72490
+ {
72491
+ "type": "string",
72492
+ "maxLength": 512
72493
+ },
72494
+ {
72495
+ "type": "number"
72496
+ },
72497
+ {
72498
+ "type": "boolean"
72499
+ },
72500
+ {
72501
+ "type": "null"
72502
+ },
72503
+ {
72504
+ "type": "array",
72505
+ "items": {
72506
+ "anyOf": [
72507
+ {
72508
+ "type": "string",
72509
+ "maxLength": 512
72510
+ },
72511
+ {
72512
+ "type": "number"
72513
+ },
72514
+ {
72515
+ "type": "boolean"
72516
+ },
72517
+ {
72518
+ "type": "null"
72519
+ }
72520
+ ]
72521
+ },
72522
+ "minItems": 1,
72523
+ "maxItems": 64
72524
+ }
72525
+ ]
72526
+ },
72527
+ "description": "Dot path into the JSON body, to one exact scalar or a list of scalars. A numeric segment indexes an array (commits.0.id). No type coercion. Every entry must match."
72528
+ }
72529
+ },
72530
+ "additionalProperties": false,
72531
+ "description": "Header and JSON body allowlists, AND-ed with events. Evaluated after signature verification and before a run is saved. A miss returns 200 skipped with reason filter-not-matched and creates no run."
71742
72532
  }
71743
72533
  },
71744
72534
  "required": [
@@ -72167,12 +72957,94 @@
72167
72957
  "type": "string",
72168
72958
  "minLength": 1
72169
72959
  },
72170
- "description": "Optional event allowlist, matched exactly against the eventHeader value after signature verification. A delivery whose event is not listed (or that has no event header) gets a 2xx `skipped` reply and creates no run. Omit or leave empty to accept every event."
72960
+ "description": "Deprecated alias of one delivery-filter clause, AND-ed with filter. Matched exactly against eventHeader, or against the preset event field when eventHeader is omitted: X-GitHub-Event (github, and the default), X-Gitlab-Event (gitlab), or JSON body type (standard-webhooks). A miss returns 200 skipped with reason event-not-allowed and creates no run. Omit or leave empty to add no event clause."
72171
72961
  },
72172
72962
  "eventHeader": {
72173
72963
  "type": "string",
72174
72964
  "minLength": 1,
72175
- "description": "Request header holding the event name for `events` (case-insensitive lookup). Defaults to X-GitHub-Event."
72965
+ "description": "Deprecated. Header read for events. The name lookup is case-insensitive and the value is exact. Overrides preset. Defaults to X-GitHub-Event when preset is omitted."
72966
+ },
72967
+ "preset": {
72968
+ "type": "string",
72969
+ "enum": [
72970
+ "github",
72971
+ "gitlab",
72972
+ "standard-webhooks"
72973
+ ],
72974
+ "description": "Optional sender preset for the events allowlist. github reads X-GitHub-Event, gitlab reads X-Gitlab-Event, and standard-webhooks reads the JSON body field type. A preset alone does not filter. Ignored when eventHeader is set."
72975
+ },
72976
+ "filter": {
72977
+ "type": "object",
72978
+ "properties": {
72979
+ "headers": {
72980
+ "type": "object",
72981
+ "additionalProperties": {
72982
+ "anyOf": [
72983
+ {
72984
+ "type": "string",
72985
+ "minLength": 1,
72986
+ "maxLength": 512
72987
+ },
72988
+ {
72989
+ "type": "array",
72990
+ "items": {
72991
+ "type": "string",
72992
+ "minLength": 1,
72993
+ "maxLength": 512
72994
+ },
72995
+ "minItems": 1,
72996
+ "maxItems": 64
72997
+ }
72998
+ ]
72999
+ },
73000
+ "description": "Header name to one exact value, or a list of exact values. Names are matched case-insensitively. Every entry must match."
73001
+ },
73002
+ "body": {
73003
+ "type": "object",
73004
+ "additionalProperties": {
73005
+ "anyOf": [
73006
+ {
73007
+ "type": "string",
73008
+ "maxLength": 512
73009
+ },
73010
+ {
73011
+ "type": "number"
73012
+ },
73013
+ {
73014
+ "type": "boolean"
73015
+ },
73016
+ {
73017
+ "type": "null"
73018
+ },
73019
+ {
73020
+ "type": "array",
73021
+ "items": {
73022
+ "anyOf": [
73023
+ {
73024
+ "type": "string",
73025
+ "maxLength": 512
73026
+ },
73027
+ {
73028
+ "type": "number"
73029
+ },
73030
+ {
73031
+ "type": "boolean"
73032
+ },
73033
+ {
73034
+ "type": "null"
73035
+ }
73036
+ ]
73037
+ },
73038
+ "minItems": 1,
73039
+ "maxItems": 64
73040
+ }
73041
+ ]
73042
+ },
73043
+ "description": "Dot path into the JSON body, to one exact scalar or a list of scalars. A numeric segment indexes an array (commits.0.id). No type coercion. Every entry must match."
73044
+ }
73045
+ },
73046
+ "additionalProperties": false,
73047
+ "description": "Header and JSON body allowlists, AND-ed with events. Evaluated after signature verification and before a run is saved. A miss returns 200 skipped with reason filter-not-matched and creates no run."
72176
73048
  }
72177
73049
  },
72178
73050
  "required": [
@@ -73416,35 +74288,80 @@
73416
74288
  ],
73417
74289
  "responses": {
73418
74290
  "200": {
73419
- "description": "Delivery skipped: its event is not in the trigger's `events` allowlist. No run was created.",
74291
+ "description": "Delivery skipped after signature verification and before a run was saved. event-not-allowed: the events allowlist missed. filter-not-matched: a header or JSON body field missed. The received value is not echoed for a filter miss.",
73420
74292
  "content": {
73421
74293
  "application/json": {
73422
74294
  "schema": {
73423
- "type": "object",
73424
- "properties": {
73425
- "skipped": {
73426
- "type": "boolean",
73427
- "enum": [
73428
- true
73429
- ]
73430
- },
73431
- "reason": {
73432
- "type": "string",
73433
- "enum": [
73434
- "event-not-allowed"
74295
+ "oneOf": [
74296
+ {
74297
+ "type": "object",
74298
+ "properties": {
74299
+ "skipped": {
74300
+ "type": "boolean",
74301
+ "enum": [
74302
+ true
74303
+ ]
74304
+ },
74305
+ "reason": {
74306
+ "type": "string",
74307
+ "enum": [
74308
+ "event-not-allowed"
74309
+ ]
74310
+ },
74311
+ "event": {
74312
+ "type": [
74313
+ "string",
74314
+ "null"
74315
+ ]
74316
+ }
74317
+ },
74318
+ "required": [
74319
+ "skipped",
74320
+ "reason",
74321
+ "event"
73435
74322
  ]
73436
74323
  },
73437
- "event": {
73438
- "type": [
73439
- "string",
73440
- "null"
74324
+ {
74325
+ "type": "object",
74326
+ "properties": {
74327
+ "skipped": {
74328
+ "type": "boolean",
74329
+ "enum": [
74330
+ true
74331
+ ]
74332
+ },
74333
+ "reason": {
74334
+ "type": "string",
74335
+ "enum": [
74336
+ "filter-not-matched"
74337
+ ]
74338
+ },
74339
+ "match": {
74340
+ "type": "object",
74341
+ "properties": {
74342
+ "source": {
74343
+ "type": "string",
74344
+ "enum": [
74345
+ "header",
74346
+ "body"
74347
+ ]
74348
+ },
74349
+ "path": {
74350
+ "type": "string"
74351
+ }
74352
+ },
74353
+ "required": [
74354
+ "source",
74355
+ "path"
74356
+ ]
74357
+ }
74358
+ },
74359
+ "required": [
74360
+ "skipped",
74361
+ "reason",
74362
+ "match"
73441
74363
  ]
73442
74364
  }
73443
- },
73444
- "required": [
73445
- "skipped",
73446
- "reason",
73447
- "event"
73448
74365
  ]
73449
74366
  }
73450
74367
  }
@@ -73953,6 +74870,21 @@
73953
74870
  ],
73954
74871
  "additionalProperties": false
73955
74872
  },
74873
+ "workspace": {
74874
+ "type": [
74875
+ "object",
74876
+ "null"
74877
+ ],
74878
+ "properties": {
74879
+ "sizeGb": {
74880
+ "type": "integer",
74881
+ "minimum": 1,
74882
+ "maximum": 1024
74883
+ }
74884
+ },
74885
+ "default": null,
74886
+ "additionalProperties": false
74887
+ },
73956
74888
  "ttlSec": {
73957
74889
  "type": [
73958
74890
  "integer",
@@ -74251,6 +75183,20 @@
74251
75183
  ],
74252
75184
  "additionalProperties": false
74253
75185
  },
75186
+ "workspace": {
75187
+ "type": [
75188
+ "object",
75189
+ "null"
75190
+ ],
75191
+ "properties": {
75192
+ "sizeGb": {
75193
+ "type": "integer",
75194
+ "minimum": 1,
75195
+ "maximum": 1024
75196
+ }
75197
+ },
75198
+ "additionalProperties": false
75199
+ },
74254
75200
  "ttlSec": {
74255
75201
  "type": [
74256
75202
  "integer",