@desplega.ai/agent-swarm 2.9.0 → 2.9.1

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 (305) hide show
  1. package/dist/acp-adapter-g909b5hw.js +16 -0
  2. package/dist/{acp-targets-swxq55dr.js → acp-targets-ny75x1qy.js} +7 -7
  3. package/dist/{actions-pb678g3e.js → actions-b9qgrmeq.js} +81 -21
  4. package/dist/{agent-fs-provision-dmhnc38q.js → agent-fs-provision-b5dhdsbd.js} +4 -4
  5. package/dist/{amp-adapter-3pa66q27.js → amp-adapter-vtax2c9s.js} +2 -2
  6. package/dist/{anthropic-messages-x2cp5fvf.js → anthropic-messages-r5xf5hqw.js} +10 -10
  7. package/dist/{app-17d12ev4.js → app-g2z15hax.js} +6 -3
  8. package/dist/{approval-notifications-h7vd9pmg.js → approval-notifications-yt13wp8r.js} +8 -5
  9. package/dist/{assistant-t7k39ree.js → assistant-2cgfxsgk.js} +23 -21
  10. package/dist/{boot-args-schema-0gqmkfbe.js → boot-args-schema-3gwy0f60.js} +1 -1
  11. package/dist/{boot-reembed-n6anc01d.js → boot-reembed-92g7s5zp.js} +1 -1
  12. package/dist/{boot-reembed-f064w382.js → boot-reembed-mywmyp4s.js} +1 -1
  13. package/dist/{boot-scrub-sweep-ejd5dnrz.js → boot-scrub-sweep-7dkdzqxx.js} +3 -3
  14. package/dist/{boot-seeds-f99fjs5q.js → boot-seeds-ce7rvgq1.js} +4 -4
  15. package/dist/{claude-adapter-gvznwxgc.js → claude-adapter-3m4q7735.js} +7 -7
  16. package/dist/{claude-managed-adapter-pbrbvc64.js → claude-managed-adapter-t8nfgcgz.js} +2 -2
  17. package/dist/{claude-managed-setup-kdxttvc3.js → claude-managed-setup-c217draw.js} +3 -3
  18. package/dist/{claude-sdk-session-0t2teq6n.js → claude-sdk-session-7fbqm51z.js} +7 -7
  19. package/dist/{cli-9a2rtd77.js → cli-1jykg0py.js} +6 -4
  20. package/dist/{cli-5ntc4we6.js → cli-2czxfnvj.js} +235 -2003
  21. package/dist/{cli-dd37e0cm.js → cli-2dq9yv8p.js} +1 -1
  22. package/dist/{cli-c07v0qfa.js → cli-2xs8tsf7.js} +69 -66
  23. package/dist/{cli-7fx9jyfs.js → cli-2yjj3e31.js} +64 -10
  24. package/dist/{cli-4ghh072d.js → cli-32djehja.js} +36 -36
  25. package/dist/{cli-cw7mc1je.js → cli-3j873zxq.js} +3 -3
  26. package/dist/cli-43ms35q9.js +270 -0
  27. package/dist/cli-47hz21se.js +25584 -0
  28. package/dist/{cli-n515ex5z.js → cli-4ymxrwg5.js} +16 -16
  29. package/dist/{cli-5gygrr67.js → cli-67mwzr35.js} +1 -1
  30. package/dist/{cli-5kcmxwxv.js → cli-6945ywhr.js} +1 -1
  31. package/dist/{cli-812paz57.js → cli-6ehs4mta.js} +18 -2
  32. package/dist/{cli-95930z69.js → cli-6ym4jhzp.js} +2 -2
  33. package/dist/{cli-zg3z63x3.js → cli-7mv4h3sn.js} +1 -1
  34. package/dist/{cli-eg437b5p.js → cli-7sf9sb0w.js} +2 -1
  35. package/dist/{cli-nr46j5pw.js → cli-8zh9nrew.js} +1 -1
  36. package/dist/{cli-wr1h0k28.js → cli-9w8712tq.js} +617 -278
  37. package/dist/{cli-ssvdrk4y.js → cli-b6px1k1q.js} +1 -1
  38. package/dist/{cli-7831nhaw.js → cli-b91nz213.js} +3 -3
  39. package/dist/{cli-7cgf614g.js → cli-bg63qmsx.js} +2 -2
  40. package/dist/{cli-me4maa4j.js → cli-bkjdknnp.js} +9 -5
  41. package/dist/{cli-rts1qvb4.js → cli-bnqncekd.js} +2 -2
  42. package/dist/{cli-25nstr34.js → cli-br0924pw.js} +1 -1
  43. package/dist/{cli-ymct0ycy.js → cli-ctx0b85j.js} +5222 -4978
  44. package/dist/{cli-kqh27v2y.js → cli-dgs10ttj.js} +1 -1
  45. package/dist/{cli-kmvcm34h.js → cli-f3jyzq4g.js} +2 -2
  46. package/dist/cli-f8x9drqr.js +84 -0
  47. package/dist/{cli-8axx8vnw.js → cli-f9gz2vyj.js} +5 -5
  48. package/dist/{cli-vvgaz8t6.js → cli-fh97xn30.js} +2 -2
  49. package/dist/{cli-8x8y70av.js → cli-fkef327x.js} +2 -2
  50. package/dist/{cli-js8zrfyg.js → cli-gfy38pvt.js} +2 -2
  51. package/dist/{cli-kaa4bd7x.js → cli-h9yqfzx9.js} +7 -6
  52. package/dist/{cli-svc803vq.js → cli-j7svy295.js} +11 -11
  53. package/dist/{cli-nhq5js1b.js → cli-jaw5v1sy.js} +3 -3
  54. package/dist/{cli-w7dxb2fj.js → cli-jkw6ptfw.js} +6 -6
  55. package/dist/{cli-1tvdx9t5.js → cli-jm0hvmz2.js} +1 -1
  56. package/dist/{cli-e9973bf0.js → cli-jwampxxq.js} +2 -2
  57. package/dist/{cli-dx439zpg.js → cli-kpgcm7xy.js} +13 -1
  58. package/dist/{cli-pz1c00aa.js → cli-kxx4k2jw.js} +2 -2
  59. package/dist/{cli-aa8s22gn.js → cli-m7c2380k.js} +191 -182
  60. package/dist/{cli-2kg31ted.js → cli-m7zvgt57.js} +11 -11
  61. package/dist/{cli-57pvhnyt.js → cli-mhapr559.js} +1 -1
  62. package/dist/{cli-gddgcnav.js → cli-mjw0yf82.js} +1 -1
  63. package/dist/{cli-h474mvp5.js → cli-mkwkwq81.js} +7 -4
  64. package/dist/{cli-jd3kxppb.js → cli-mw620q3n.js} +1 -1
  65. package/dist/{cli-spzkdgtg.js → cli-n3qe7tyr.js} +172 -168
  66. package/dist/{cli-3zxdz9r7.js → cli-nafvvsp8.js} +3 -3
  67. package/dist/{cli-fnh4b12r.js → cli-nbt14he0.js} +6 -6
  68. package/dist/{cli-7akn6ze9.js → cli-nh7x3133.js} +7 -28
  69. package/dist/{cli-faf46gdq.js → cli-p4kckx1z.js} +10 -10
  70. package/dist/{cli-k7pt28ad.js → cli-pb2ay3sh.js} +2 -2
  71. package/dist/{cli-pn1v1pb0.js → cli-psffsanb.js} +3 -2
  72. package/dist/{cli-2tnbc3gw.js → cli-pyjn0qhk.js} +2257 -61
  73. package/dist/{cli-fgphc007.js → cli-rq5rpv6k.js} +1 -1
  74. package/dist/{cli-vw5x18yj.js → cli-sn650d7x.js} +9 -9
  75. package/dist/{cli-mc1fx4xd.js → cli-td9tb872.js} +10 -10
  76. package/dist/{cli-6dp0jkfj.js → cli-tvc4jag9.js} +3 -3
  77. package/dist/{cli-a9hfzg2r.js → cli-ty3gha1p.js} +6 -6
  78. package/dist/{cli-pwsax0vp.js → cli-v57d7fmm.js} +1 -1
  79. package/dist/{cli-nmcpzbty.js → cli-vt89089n.js} +4 -4
  80. package/dist/{cli-sn4pc4qx.js → cli-vyff45ve.js} +2 -2
  81. package/dist/{cli-m1fbz2wj.js → cli-w4n323t3.js} +175 -16
  82. package/dist/{cli-g3zzby8t.js → cli-wn13hhdt.js} +5 -5
  83. package/dist/{cli-q8cfh1t9.js → cli-xag7btpe.js} +1 -1
  84. package/dist/{cli-c5cspahx.js → cli-y2ewxhth.js} +38 -13
  85. package/dist/{cli-k09cxm6m.js → cli-ysvspf5e.js} +2 -2
  86. package/dist/{cli-eepnpee7.js → cli-zh0e5x7p.js} +4 -4
  87. package/dist/{cli-bk9v1xrv.js → cli-zr6qy15y.js} +11 -11
  88. package/dist/cli.js +21 -20
  89. package/dist/{codex-adapter-44yq2fkn.js → codex-adapter-n656pvb8.js} +6 -6
  90. package/dist/{codex-hook-h1zb7cfk.js → codex-hook-59atdwd8.js} +1 -1
  91. package/dist/{codex-login-cdyrr5y1.js → codex-login-a239g1ah.js} +1 -1
  92. package/dist/{codex-session-runner-zbh26gbw.js → codex-session-runner-p0fbv5y9.js} +6 -6
  93. package/dist/{commands-54f02v5b.js → commands-gwea8z5p.js} +3 -3
  94. package/dist/{controller-9gpwcdek.js → controller-t67c3grh.js} +6 -3
  95. package/dist/{controllers-connect-61re6k1n.js → controllers-connect-ks155r0h.js} +22 -20
  96. package/dist/{cursor-adapter-7e4g81vd.js → cursor-adapter-ygwrtmkv.js} +1 -1
  97. package/dist/{db-dg2gc7fd.js → db-kpmx06s9.js} +8 -2
  98. package/dist/{db-wnh0qjy1.js → db-rb2xqdb1.js} +3 -3
  99. package/dist/{dispatcher-jrm24r43.js → dispatcher-31sm0ej2.js} +20 -18
  100. package/dist/{docker-9aq30pp2.js → docker-09tkkg0n.js} +42 -3
  101. package/dist/{dsh-adapter-1yqk267c.js → dsh-adapter-qyxh0w31.js} +1 -1
  102. package/dist/{easter-egg-3d-r4h9cs9m.js → easter-egg-3d-00wjscn6.js} +1 -1
  103. package/dist/{embedding-space-bafjr5f7.js → embedding-space-qhw4g68n.js} +6 -6
  104. package/dist/{embeddings-7xmgqe0e.js → embeddings-zdv9ke6x.js} +1 -1
  105. package/dist/{execute-d6jg5ns0.js → execute-zna8wwr7.js} +1 -1
  106. package/dist/{external-channel-frq1xvq2.js → external-channel-1ac6t56s.js} +2 -2
  107. package/dist/fx-adapter-sk7n0fzc.js +19 -0
  108. package/dist/{google-generative-ai-hh7strj3.js → google-generative-ai-maq6c9bf.js} +1 -1
  109. package/dist/{google-vertex-fy5bw2pm.js → google-vertex-2jgsw2nb.js} +1 -1
  110. package/dist/grok-adapter-sjbcm5ew.js +19 -0
  111. package/dist/handlers-yzy0c87x.js +35 -0
  112. package/dist/{heartbeat-6bpa611t.js → heartbeat-2f6z4kdx.js} +23 -21
  113. package/dist/{hook-w12k146y.js → hook-8y0gvtp1.js} +6 -6
  114. package/dist/{hook-hvm5nf46.js → hook-w1skzaqc.js} +5 -5
  115. package/dist/{http-43tthdvs.js → http-wghxvpef.js} +714 -145
  116. package/dist/{index-1f0vypbg.js → index-0h6qd4p1.js} +34 -24
  117. package/dist/index-25pvya7q.js +40 -0
  118. package/dist/index-2t4859r5.js +35 -0
  119. package/dist/{index-4b1q8kan.js → index-4k7m5dgj.js} +629 -354
  120. package/dist/index-620y7jzq.js +15 -0
  121. package/dist/{index-cret47a5.js → index-8p0j4h4j.js} +506 -43
  122. package/dist/{index-mhq4sh5w.js → index-8zn8nxn5.js} +1 -1
  123. package/dist/{index-m5gx1xd6.js → index-9myfj74s.js} +40 -40
  124. package/dist/{index-ftywhyr0.js → index-9zkchs9t.js} +221 -65
  125. package/dist/{index-bs7gw5fd.js → index-b5wgnm78.js} +44 -44
  126. package/dist/index-cxca2t8y.js +36 -0
  127. package/dist/{index-585gyczt.js → index-pe3d8jfy.js} +3 -3
  128. package/dist/{index-tx9mc2ap.js → index-rv89fvzf.js} +24 -22
  129. package/dist/{index-fn054vsf.js → index-s71ez27v.js} +1 -1
  130. package/dist/{keepalive-rk0j0jvh.js → keepalive-sh02349h.js} +3 -3
  131. package/dist/lead-gk4h5eg7.js +74 -0
  132. package/dist/{maintenance-g6z6kaxw.js → maintenance-yj0dcjja.js} +1 -1
  133. package/dist/{node-jftbyawr.js → node-dqm4xgxw.js} +1 -1
  134. package/dist/{oauth-refresh-sweep-2k3g2q4w.js → oauth-refresh-sweep-d9xedk66.js} +2 -2
  135. package/dist/{onboard-6fdbvh3v.js → onboard-dpgjn03r.js} +2 -2
  136. package/dist/{opencode-adapter-fdbsvts7.js → opencode-adapter-2d31cpjc.js} +6 -6
  137. package/dist/{otel-impl-rvwtc09q.js → otel-impl-1skarpfq.js} +1 -1
  138. package/dist/{pending-sqkrb836.js → pending-bfmxtx0g.js} +21 -19
  139. package/dist/{pi-mono-adapter-asqayqcg.js → pi-mono-adapter-gvppnasy.js} +40 -13
  140. package/dist/{pricing-refresh-f5tkgmw2.js → pricing-refresh-c6b325mk.js} +2 -2
  141. package/dist/{rbac-roles-06s555fa.js → rbac-roles-h80qbdbs.js} +3 -3
  142. package/dist/{rbac-roles-szxsg8t1.js → rbac-roles-zfcx68tx.js} +2 -2
  143. package/dist/{render-v2-103p266q.js → render-v2-nx20t3rb.js} +6 -3
  144. package/dist/{resume-v7kjewt9.js → resume-5ep8agan.js} +10 -7
  145. package/dist/{runtime-f1gmk0b7.js → runtime-r3pj4mce.js} +1 -1
  146. package/dist/{session-access-6shev8ts.js → session-access-n7p3m15b.js} +4 -4
  147. package/dist/{session-source-backfill-bd7spzjd.js → session-source-backfill-v8mt0zwn.js} +3 -3
  148. package/dist/{setup-kmxmztdb.js → setup-z1psaqhe.js} +1 -1
  149. package/dist/thread-buffer-a1re2r9r.js +38 -0
  150. package/dist/{virtual-modules-57eje5wy.js → virtual-modules-rrbjdpxn.js} +3 -3
  151. package/dist/{work-objects-zr47ygmf.js → work-objects-4aghh73z.js} +29 -23
  152. package/dist/worker-3dyyb8ev.js +74 -0
  153. package/dist/{worker-follow-up-grrr3fda.js → worker-follow-up-166zmex1.js} +20 -18
  154. package/openapi.json +1387 -13
  155. package/package.json +7 -6
  156. package/src/apps/catalog.generated.json +43 -3
  157. package/src/apps/page-validator.ts +27 -0
  158. package/src/be/db/model-profiles.ts +4 -1
  159. package/src/be/db/session-costs.ts +219 -0
  160. package/src/be/db/session-log-reasoning.ts +36 -0
  161. package/src/be/db/tasks/read.ts +7 -3
  162. package/src/be/db/tasks/write.ts +33 -1
  163. package/src/be/db.ts +200 -304
  164. package/src/be/key-window-usage.ts +385 -0
  165. package/src/be/migrations/303_task_ui_specs.sql +28 -0
  166. package/src/be/migrations/306_provider_account_telemetry.sql +1 -0
  167. package/src/be/migrations/307_session_cost_credential_attribution.sql +23 -0
  168. package/src/be/migrations/310_session_logs_reasoning.sql +12 -0
  169. package/src/be/runtime-pools/db.ts +3 -0
  170. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -0
  171. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -0
  172. package/src/be/seed-scripts/catalog/wait-for-task.ts +5 -1
  173. package/src/be/seed-skills/index.ts +3 -0
  174. package/src/be/swarm-config-guard.ts +24 -1
  175. package/src/be/task-ui-spec.ts +158 -0
  176. package/src/commands/controller.ts +3 -0
  177. package/src/commands/credential-outcome-report.ts +13 -3
  178. package/src/commands/rate-limit-outcome.ts +6 -0
  179. package/src/commands/runner.ts +34 -53
  180. package/src/extensions/catalog.generated.json +3 -3
  181. package/src/extensions/contract-types.generated.ts +1 -1
  182. package/src/http/api-keys.ts +258 -30
  183. package/src/http/session-data.ts +74 -23
  184. package/src/http/sessions.ts +6 -2
  185. package/src/http/tasks.ts +105 -5
  186. package/src/integrations/chat-sdk/relay.ts +87 -0
  187. package/src/jira/outbound.ts +5 -3
  188. package/src/linear/outbound.ts +5 -1
  189. package/src/prompts/base-prompt.ts +8 -0
  190. package/src/prompts/session-templates.ts +19 -2
  191. package/src/providers/acp-targets.ts +1 -1
  192. package/src/providers/amp-adapter.ts +1 -1
  193. package/src/providers/claude-adapter.ts +27 -4
  194. package/src/providers/claude-flag-settings.ts +39 -1
  195. package/src/providers/codex-adapter.ts +85 -3
  196. package/src/providers/codex-app-server.ts +9 -5
  197. package/src/providers/codex-oauth/auth-json.ts +1 -0
  198. package/src/providers/pi-mono-adapter.ts +35 -2
  199. package/src/providers/pricing-sources.md +32 -0
  200. package/src/providers/types.ts +11 -0
  201. package/src/runtime-providers/docker.ts +65 -1
  202. package/src/scheduler/deferred-task-waits.ts +18 -5
  203. package/src/scripts-runtime/types/swarm-extension.d.ts +8 -8
  204. package/src/slack/actions.ts +56 -0
  205. package/src/slack/app.ts +22 -15
  206. package/src/slack/inbound-files.ts +2 -0
  207. package/src/slack/render-v2.ts +107 -23
  208. package/src/slack/responses.ts +3 -2
  209. package/src/slack/work-objects.ts +4 -1
  210. package/src/tasks/errors.ts +5 -0
  211. package/src/tests/acp-adapter.test.ts +4 -6
  212. package/src/tests/api-key-tracking.test.ts +0 -72
  213. package/src/tests/api-keys-status-model-limits.test.ts +93 -1
  214. package/src/tests/api-keys-validation.test.ts +42 -0
  215. package/src/tests/approval-card-resolution.test.ts +7 -1
  216. package/src/tests/approval-requests-notifications.test.ts +11 -1
  217. package/src/tests/apps-catalog-page-frame.test.ts +49 -0
  218. package/src/tests/apps-session-thread.test.ts +79 -0
  219. package/src/tests/base-prompt.test.ts +111 -5
  220. package/src/tests/chat-sdk-relay.test.ts +149 -1
  221. package/src/tests/claude-adapter-binary.test.ts +67 -6
  222. package/src/tests/claude-flag-settings.test.ts +29 -0
  223. package/src/tests/claude-sdk-lifecycle.test.ts +5 -0
  224. package/src/tests/codex-adapter.test.ts +340 -2
  225. package/src/tests/codex-app-server.test.ts +16 -0
  226. package/src/tests/codex-oauth.test.ts +3 -1
  227. package/src/tests/codex-rate-limits.test.ts +384 -0
  228. package/src/tests/credential-outcome-report.test.ts +20 -0
  229. package/src/tests/db-task-read-contract.test.ts +3 -0
  230. package/src/tests/db-task-write-contract.test.ts +4 -0
  231. package/src/tests/deferred-task-wake.test.ts +63 -1
  232. package/src/tests/docker-isolation-config-guard.test.ts +29 -0
  233. package/src/tests/docs-index-footprint.test.js +11 -3
  234. package/src/tests/e2e-visuals-comment.test.ts +82 -0
  235. package/src/tests/e2e-visuals-verify-pr.test.ts +138 -0
  236. package/src/tests/extensions-example-sql-admin-only.test.ts +7 -4
  237. package/src/tests/fixtures/ui-spec-slack/deploys.json +121 -0
  238. package/src/tests/fixtures/ui-spec-slack/incident.json +183 -0
  239. package/src/tests/fixtures/ui-spec-slack/three-charts-stale.json +196 -0
  240. package/src/tests/fixtures/ui-spec-slack/video-rejected-by-slack.json +183 -0
  241. package/src/tests/fixtures/ui-spec-slack/video.json +446 -0
  242. package/src/tests/gitleaks-download-retry.test.ts +85 -0
  243. package/src/tests/human-thread-routing.test.ts +187 -0
  244. package/src/tests/jira-outbound-sync.test.ts +33 -1
  245. package/src/tests/key-window-usage.test.ts +831 -0
  246. package/src/tests/linear-outbound-sync.test.ts +30 -1
  247. package/src/tests/pi-mono-adapter.test.ts +79 -0
  248. package/src/tests/preload-env.test.ts +2 -0
  249. package/src/tests/preload.ts +3 -1
  250. package/src/tests/prompt-template-session.test.ts +4 -3
  251. package/src/tests/provider-quota-persistence.test.ts +362 -0
  252. package/src/tests/rate-limit-event.test.ts +22 -0
  253. package/src/tests/reasoning-events.test.ts +164 -0
  254. package/src/tests/routing-affinity-inventory.test.ts +22 -0
  255. package/src/tests/runtime-providers-docker.test.ts +91 -0
  256. package/src/tests/script-connections.test.ts +5 -0
  257. package/src/tests/secret-canary-sweep.test.ts +41 -5
  258. package/src/tests/seed-scripts.test.ts +23 -0
  259. package/src/tests/session-cost-attribution.test.ts +748 -0
  260. package/src/tests/session-costs.test.ts +14 -15
  261. package/src/tests/session-logs.test.ts +83 -0
  262. package/src/tests/sessions-detail-batch.test.ts +7 -0
  263. package/src/tests/slack-render-v2.test.ts +357 -0
  264. package/src/tests/slack-start-reload-race.test.ts +67 -0
  265. package/src/tests/subscription-plans.test.ts +20 -1
  266. package/src/tests/task-ui-action-route.test.ts +191 -0
  267. package/src/tests/task-ui-actions.test.ts +195 -0
  268. package/src/tests/task-ui-spec-fallback.test.ts +65 -0
  269. package/src/tests/task-ui-spec.test.ts +368 -0
  270. package/src/tests/workflow-agent-task-retry.test.ts +34 -1
  271. package/src/tools/defer-task.ts +1 -1
  272. package/src/tools/store-progress.ts +69 -3
  273. package/src/types.ts +7 -2
  274. package/src/ui-spec/actions.ts +86 -0
  275. package/src/ui-spec/fallback.ts +19 -0
  276. package/src/ui-spec/slack.ts +17 -0
  277. package/src/ui-spec/validate.ts +169 -0
  278. package/src/utils/codex-rate-limits.ts +159 -0
  279. package/src/utils/credentials.ts +2 -0
  280. package/src/utils/error-tracker.ts +19 -0
  281. package/src/utils/provider-account-telemetry.ts +331 -0
  282. package/src/utils/reasoning-events.ts +107 -0
  283. package/src/utils/subscription-plans.ts +11 -59
  284. package/src/utils/task-ui-spec.ts +67 -0
  285. package/src/workflows/task-step-routing.ts +8 -3
  286. package/templates/extensions/sql-admin-only/README.md +2 -1
  287. package/templates/extensions/sql-admin-only/hooks.ts +7 -3
  288. package/templates/extensions/sql-admin-only/manifest.json +1 -1
  289. package/templates/skills/apps/SKILL.md +32 -5
  290. package/templates/skills/apps/content.md +32 -5
  291. package/templates/skills/ui-spec/config.json +14 -0
  292. package/templates/skills/ui-spec/content.md +127 -0
  293. package/dist/acp-adapter-jqn86aam.js +0 -16
  294. package/dist/cli-srtkr1h2.js +0 -12078
  295. package/dist/fx-adapter-0zrkfbkd.js +0 -19
  296. package/dist/grok-adapter-3db1c538.js +0 -19
  297. package/dist/handlers-k22n8mnn.js +0 -33
  298. package/dist/index-8xcyd3mc.js +0 -33
  299. package/dist/index-9sy2bh6n.js +0 -38
  300. package/dist/index-b24j7t2m.js +0 -12797
  301. package/dist/index-wjd56k1v.js +0 -34
  302. package/dist/lead-atxf3q6e.js +0 -72
  303. package/dist/thread-buffer-4yz236d0.js +0 -36
  304. package/dist/worker-p4hbtcy3.js +0 -72
  305. package/dist/{cli-j49yqpvh.js → cli-7evph51z.js} +3 -3
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.9.0",
5
+ "version": "2.9.1",
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": [
@@ -3530,6 +3530,7 @@
3530
3530
  "task_follow_up_suppressed",
3531
3531
  "task_follow_up_gate_shadow",
3532
3532
  "task_citation_check_refused",
3533
+ "task_ui_spec_check_refused",
3533
3534
  "channel_message",
3534
3535
  "service_registered",
3535
3536
  "service_unregistered",
@@ -4346,6 +4347,39 @@
4346
4347
  "agentId": {
4347
4348
  "type": "string"
4348
4349
  },
4350
+ "credentialKeyType": {
4351
+ "type": [
4352
+ "string",
4353
+ "null"
4354
+ ]
4355
+ },
4356
+ "credentialKeySuffix": {
4357
+ "type": [
4358
+ "string",
4359
+ "null"
4360
+ ]
4361
+ },
4362
+ "harness": {
4363
+ "type": [
4364
+ "string",
4365
+ "null"
4366
+ ],
4367
+ "enum": [
4368
+ "claude",
4369
+ "codex",
4370
+ "pi",
4371
+ "devin",
4372
+ "claude-managed",
4373
+ "opencode",
4374
+ "acp",
4375
+ "dsh",
4376
+ "amp",
4377
+ "cursor",
4378
+ "grok",
4379
+ "fx",
4380
+ null
4381
+ ]
4382
+ },
4349
4383
  "totalCostUsd": {
4350
4384
  "type": "number",
4351
4385
  "minimum": 0
@@ -4361,14 +4395,20 @@
4361
4395
  "default": 0
4362
4396
  },
4363
4397
  "cacheReadTokens": {
4364
- "type": "integer",
4398
+ "type": [
4399
+ "integer",
4400
+ "null"
4401
+ ],
4365
4402
  "minimum": 0,
4366
- "default": 0
4403
+ "default": null
4367
4404
  },
4368
4405
  "cacheWriteTokens": {
4369
- "type": "integer",
4406
+ "type": [
4407
+ "integer",
4408
+ "null"
4409
+ ],
4370
4410
  "minimum": 0,
4371
- "default": 0
4411
+ "default": null
4372
4412
  },
4373
4413
  "reasoningOutputTokens": {
4374
4414
  "type": "integer",
@@ -19731,6 +19771,11 @@
19731
19771
  "plan": {
19732
19772
  "type": "string",
19733
19773
  "maxLength": 40
19774
+ },
19775
+ "planRaw": {
19776
+ "type": "string",
19777
+ "minLength": 1,
19778
+ "maxLength": 80
19734
19779
  }
19735
19780
  },
19736
19781
  "required": [
@@ -20116,6 +20161,7 @@
20116
20161
  "/api/keys/report-rate-limit-windows": {
20117
20162
  "post": {
20118
20163
  "summary": "Record provider-emitted rate-limit window telemetry for an API key",
20164
+ "description": "Reports accept up to 64 windows and 64 account limits within 256 KiB. Stored records have the same count limits.",
20119
20165
  "tags": [
20120
20166
  "API Keys"
20121
20167
  ],
@@ -20148,7 +20194,8 @@
20148
20194
  "type": "object",
20149
20195
  "properties": {
20150
20196
  "status": {
20151
- "type": "string"
20197
+ "type": "string",
20198
+ "maxLength": 256
20152
20199
  },
20153
20200
  "utilization": {
20154
20201
  "type": "number"
@@ -20156,6 +20203,60 @@
20156
20203
  "resetsAt": {
20157
20204
  "type": "number"
20158
20205
  },
20206
+ "fieldObservedAt": {
20207
+ "type": "object",
20208
+ "properties": {
20209
+ "durationMins": {
20210
+ "type": "string",
20211
+ "format": "date-time"
20212
+ },
20213
+ "resetsAt": {
20214
+ "type": "string",
20215
+ "format": "date-time"
20216
+ },
20217
+ "label": {
20218
+ "type": "string",
20219
+ "format": "date-time"
20220
+ },
20221
+ "normalModelSlug": {
20222
+ "type": "string",
20223
+ "format": "date-time"
20224
+ }
20225
+ }
20226
+ },
20227
+ "durationMins": {
20228
+ "type": "integer",
20229
+ "exclusiveMinimum": 0,
20230
+ "maximum": 576000
20231
+ },
20232
+ "source": {
20233
+ "type": "string",
20234
+ "enum": [
20235
+ "claude",
20236
+ "codex"
20237
+ ]
20238
+ },
20239
+ "limitId": {
20240
+ "type": "string",
20241
+ "minLength": 1,
20242
+ "maxLength": 128
20243
+ },
20244
+ "label": {
20245
+ "type": "string",
20246
+ "maxLength": 256
20247
+ },
20248
+ "normalModelSlug": {
20249
+ "type": "string",
20250
+ "maxLength": 256
20251
+ },
20252
+ "overageStatus": {
20253
+ "type": "string",
20254
+ "maxLength": 256
20255
+ },
20256
+ "overageDisabledReason": {
20257
+ "type": "string",
20258
+ "maxLength": 256
20259
+ },
20159
20260
  "isUsingOverage": {
20160
20261
  "type": "boolean"
20161
20262
  },
@@ -20173,6 +20274,252 @@
20173
20274
  ]
20174
20275
  }
20175
20276
  },
20277
+ "account": {
20278
+ "type": "object",
20279
+ "properties": {
20280
+ "source": {
20281
+ "type": "string",
20282
+ "enum": [
20283
+ "codex",
20284
+ "claude"
20285
+ ]
20286
+ },
20287
+ "observedAt": {
20288
+ "type": "string",
20289
+ "format": "date-time"
20290
+ },
20291
+ "fieldObservedAt": {
20292
+ "type": "object",
20293
+ "properties": {
20294
+ "ordinaryUsageAllowed": {
20295
+ "type": "string",
20296
+ "format": "date-time"
20297
+ },
20298
+ "resetCreditsAvailable": {
20299
+ "type": "string",
20300
+ "format": "date-time"
20301
+ }
20302
+ }
20303
+ },
20304
+ "ordinaryUsageAllowed": {
20305
+ "type": [
20306
+ "boolean",
20307
+ "null"
20308
+ ]
20309
+ },
20310
+ "resetCreditsAvailable": {
20311
+ "type": [
20312
+ "integer",
20313
+ "null"
20314
+ ],
20315
+ "minimum": 0
20316
+ },
20317
+ "limits": {
20318
+ "type": "object",
20319
+ "additionalProperties": {
20320
+ "type": "object",
20321
+ "properties": {
20322
+ "observedAt": {
20323
+ "type": "string",
20324
+ "format": "date-time"
20325
+ },
20326
+ "fieldObservedAt": {
20327
+ "type": "object",
20328
+ "properties": {
20329
+ "planRaw": {
20330
+ "type": "string",
20331
+ "format": "date-time"
20332
+ },
20333
+ "label": {
20334
+ "type": "string",
20335
+ "format": "date-time"
20336
+ },
20337
+ "normalModelSlug": {
20338
+ "type": "string",
20339
+ "format": "date-time"
20340
+ },
20341
+ "credits": {
20342
+ "type": "string",
20343
+ "format": "date-time"
20344
+ },
20345
+ "spend": {
20346
+ "type": "string",
20347
+ "format": "date-time"
20348
+ },
20349
+ "spendControlReached": {
20350
+ "type": "string",
20351
+ "format": "date-time"
20352
+ },
20353
+ "reachedType": {
20354
+ "type": "string",
20355
+ "format": "date-time"
20356
+ }
20357
+ }
20358
+ },
20359
+ "windowRemovedAt": {
20360
+ "type": "object",
20361
+ "properties": {
20362
+ "primary": {
20363
+ "type": "string",
20364
+ "format": "date-time"
20365
+ },
20366
+ "secondary": {
20367
+ "type": "string",
20368
+ "format": "date-time"
20369
+ }
20370
+ },
20371
+ "additionalProperties": false
20372
+ },
20373
+ "planRaw": {
20374
+ "type": [
20375
+ "string",
20376
+ "null"
20377
+ ],
20378
+ "maxLength": 256
20379
+ },
20380
+ "label": {
20381
+ "type": [
20382
+ "string",
20383
+ "null"
20384
+ ],
20385
+ "maxLength": 256
20386
+ },
20387
+ "normalModelSlug": {
20388
+ "type": [
20389
+ "string",
20390
+ "null"
20391
+ ],
20392
+ "maxLength": 256
20393
+ },
20394
+ "credits": {
20395
+ "type": [
20396
+ "object",
20397
+ "null"
20398
+ ],
20399
+ "properties": {
20400
+ "hasCredits": {
20401
+ "type": "boolean"
20402
+ },
20403
+ "unlimited": {
20404
+ "type": "boolean"
20405
+ },
20406
+ "balance": {
20407
+ "type": [
20408
+ "string",
20409
+ "null"
20410
+ ],
20411
+ "maxLength": 256
20412
+ }
20413
+ },
20414
+ "required": [
20415
+ "hasCredits",
20416
+ "unlimited"
20417
+ ],
20418
+ "additionalProperties": false
20419
+ },
20420
+ "spend": {
20421
+ "type": [
20422
+ "object",
20423
+ "null"
20424
+ ],
20425
+ "properties": {
20426
+ "limit": {
20427
+ "type": "string",
20428
+ "maxLength": 256
20429
+ },
20430
+ "used": {
20431
+ "type": "string",
20432
+ "maxLength": 256
20433
+ },
20434
+ "remainingPercent": {
20435
+ "type": "integer",
20436
+ "minimum": -2147483648,
20437
+ "maximum": 2147483647
20438
+ },
20439
+ "resetsAt": {
20440
+ "type": "integer",
20441
+ "minimum": 0,
20442
+ "maximum": 8640000000000
20443
+ }
20444
+ },
20445
+ "required": [
20446
+ "limit",
20447
+ "used",
20448
+ "remainingPercent",
20449
+ "resetsAt"
20450
+ ],
20451
+ "additionalProperties": false
20452
+ },
20453
+ "spendControlReached": {
20454
+ "type": [
20455
+ "boolean",
20456
+ "null"
20457
+ ]
20458
+ },
20459
+ "reachedType": {
20460
+ "type": [
20461
+ "string",
20462
+ "null"
20463
+ ],
20464
+ "maxLength": 256
20465
+ }
20466
+ },
20467
+ "required": [
20468
+ "observedAt"
20469
+ ],
20470
+ "additionalProperties": false
20471
+ }
20472
+ }
20473
+ },
20474
+ "required": [
20475
+ "source",
20476
+ "observedAt"
20477
+ ],
20478
+ "additionalProperties": false
20479
+ },
20480
+ "replace": {
20481
+ "type": "array",
20482
+ "items": {
20483
+ "type": "object",
20484
+ "properties": {
20485
+ "source": {
20486
+ "type": "string",
20487
+ "enum": [
20488
+ "codex"
20489
+ ]
20490
+ },
20491
+ "limitId": {
20492
+ "type": "string",
20493
+ "minLength": 1,
20494
+ "maxLength": 128
20495
+ },
20496
+ "observedAt": {
20497
+ "type": "string",
20498
+ "format": "date-time"
20499
+ },
20500
+ "slots": {
20501
+ "type": "array",
20502
+ "items": {
20503
+ "type": "string",
20504
+ "enum": [
20505
+ "primary",
20506
+ "secondary"
20507
+ ]
20508
+ },
20509
+ "minItems": 1,
20510
+ "maxItems": 2
20511
+ }
20512
+ },
20513
+ "required": [
20514
+ "source",
20515
+ "limitId",
20516
+ "observedAt",
20517
+ "slots"
20518
+ ],
20519
+ "additionalProperties": false
20520
+ },
20521
+ "maxItems": 128
20522
+ },
20176
20523
  "scope": {
20177
20524
  "type": "string"
20178
20525
  },
@@ -20235,6 +20582,16 @@
20235
20582
  }
20236
20583
  }
20237
20584
  }
20585
+ },
20586
+ "413": {
20587
+ "description": "Telemetry report exceeds 256 KiB",
20588
+ "content": {
20589
+ "application/json": {
20590
+ "schema": {
20591
+ "$ref": "#/components/schemas/ErrorResponse"
20592
+ }
20593
+ }
20594
+ }
20238
20595
  }
20239
20596
  }
20240
20597
  }
@@ -20614,7 +20971,8 @@
20614
20971
  "type": "object",
20615
20972
  "properties": {
20616
20973
  "status": {
20617
- "type": "string"
20974
+ "type": "string",
20975
+ "maxLength": 256
20618
20976
  },
20619
20977
  "utilization": {
20620
20978
  "type": "number"
@@ -20622,6 +20980,60 @@
20622
20980
  "resetsAt": {
20623
20981
  "type": "number"
20624
20982
  },
20983
+ "fieldObservedAt": {
20984
+ "type": "object",
20985
+ "properties": {
20986
+ "durationMins": {
20987
+ "type": "string",
20988
+ "format": "date-time"
20989
+ },
20990
+ "resetsAt": {
20991
+ "type": "string",
20992
+ "format": "date-time"
20993
+ },
20994
+ "label": {
20995
+ "type": "string",
20996
+ "format": "date-time"
20997
+ },
20998
+ "normalModelSlug": {
20999
+ "type": "string",
21000
+ "format": "date-time"
21001
+ }
21002
+ }
21003
+ },
21004
+ "durationMins": {
21005
+ "type": "integer",
21006
+ "exclusiveMinimum": 0,
21007
+ "maximum": 576000
21008
+ },
21009
+ "source": {
21010
+ "type": "string",
21011
+ "enum": [
21012
+ "claude",
21013
+ "codex"
21014
+ ]
21015
+ },
21016
+ "limitId": {
21017
+ "type": "string",
21018
+ "minLength": 1,
21019
+ "maxLength": 128
21020
+ },
21021
+ "label": {
21022
+ "type": "string",
21023
+ "maxLength": 256
21024
+ },
21025
+ "normalModelSlug": {
21026
+ "type": "string",
21027
+ "maxLength": 256
21028
+ },
21029
+ "overageStatus": {
21030
+ "type": "string",
21031
+ "maxLength": 256
21032
+ },
21033
+ "overageDisabledReason": {
21034
+ "type": "string",
21035
+ "maxLength": 256
21036
+ },
20625
21037
  "isUsingOverage": {
20626
21038
  "type": "boolean"
20627
21039
  },
@@ -20639,6 +21051,212 @@
20639
21051
  ]
20640
21052
  }
20641
21053
  },
21054
+ "providerAccount": {
21055
+ "type": [
21056
+ "object",
21057
+ "null"
21058
+ ],
21059
+ "properties": {
21060
+ "source": {
21061
+ "type": "string",
21062
+ "enum": [
21063
+ "codex",
21064
+ "claude"
21065
+ ]
21066
+ },
21067
+ "observedAt": {
21068
+ "type": "string",
21069
+ "format": "date-time"
21070
+ },
21071
+ "fieldObservedAt": {
21072
+ "type": "object",
21073
+ "properties": {
21074
+ "ordinaryUsageAllowed": {
21075
+ "type": "string",
21076
+ "format": "date-time"
21077
+ },
21078
+ "resetCreditsAvailable": {
21079
+ "type": "string",
21080
+ "format": "date-time"
21081
+ }
21082
+ }
21083
+ },
21084
+ "ordinaryUsageAllowed": {
21085
+ "type": [
21086
+ "boolean",
21087
+ "null"
21088
+ ]
21089
+ },
21090
+ "resetCreditsAvailable": {
21091
+ "type": [
21092
+ "integer",
21093
+ "null"
21094
+ ],
21095
+ "minimum": 0
21096
+ },
21097
+ "limits": {
21098
+ "type": "object",
21099
+ "additionalProperties": {
21100
+ "type": "object",
21101
+ "properties": {
21102
+ "observedAt": {
21103
+ "type": "string",
21104
+ "format": "date-time"
21105
+ },
21106
+ "fieldObservedAt": {
21107
+ "type": "object",
21108
+ "properties": {
21109
+ "planRaw": {
21110
+ "type": "string",
21111
+ "format": "date-time"
21112
+ },
21113
+ "label": {
21114
+ "type": "string",
21115
+ "format": "date-time"
21116
+ },
21117
+ "normalModelSlug": {
21118
+ "type": "string",
21119
+ "format": "date-time"
21120
+ },
21121
+ "credits": {
21122
+ "type": "string",
21123
+ "format": "date-time"
21124
+ },
21125
+ "spend": {
21126
+ "type": "string",
21127
+ "format": "date-time"
21128
+ },
21129
+ "spendControlReached": {
21130
+ "type": "string",
21131
+ "format": "date-time"
21132
+ },
21133
+ "reachedType": {
21134
+ "type": "string",
21135
+ "format": "date-time"
21136
+ }
21137
+ }
21138
+ },
21139
+ "windowRemovedAt": {
21140
+ "type": "object",
21141
+ "properties": {
21142
+ "primary": {
21143
+ "type": "string",
21144
+ "format": "date-time"
21145
+ },
21146
+ "secondary": {
21147
+ "type": "string",
21148
+ "format": "date-time"
21149
+ }
21150
+ },
21151
+ "additionalProperties": false
21152
+ },
21153
+ "planRaw": {
21154
+ "type": [
21155
+ "string",
21156
+ "null"
21157
+ ],
21158
+ "maxLength": 256
21159
+ },
21160
+ "label": {
21161
+ "type": [
21162
+ "string",
21163
+ "null"
21164
+ ],
21165
+ "maxLength": 256
21166
+ },
21167
+ "normalModelSlug": {
21168
+ "type": [
21169
+ "string",
21170
+ "null"
21171
+ ],
21172
+ "maxLength": 256
21173
+ },
21174
+ "credits": {
21175
+ "type": [
21176
+ "object",
21177
+ "null"
21178
+ ],
21179
+ "properties": {
21180
+ "hasCredits": {
21181
+ "type": "boolean"
21182
+ },
21183
+ "unlimited": {
21184
+ "type": "boolean"
21185
+ },
21186
+ "balance": {
21187
+ "type": [
21188
+ "string",
21189
+ "null"
21190
+ ],
21191
+ "maxLength": 256
21192
+ }
21193
+ },
21194
+ "required": [
21195
+ "hasCredits",
21196
+ "unlimited"
21197
+ ],
21198
+ "additionalProperties": false
21199
+ },
21200
+ "spend": {
21201
+ "type": [
21202
+ "object",
21203
+ "null"
21204
+ ],
21205
+ "properties": {
21206
+ "limit": {
21207
+ "type": "string",
21208
+ "maxLength": 256
21209
+ },
21210
+ "used": {
21211
+ "type": "string",
21212
+ "maxLength": 256
21213
+ },
21214
+ "remainingPercent": {
21215
+ "type": "integer",
21216
+ "minimum": -2147483648,
21217
+ "maximum": 2147483647
21218
+ },
21219
+ "resetsAt": {
21220
+ "type": "integer",
21221
+ "minimum": 0,
21222
+ "maximum": 8640000000000
21223
+ }
21224
+ },
21225
+ "required": [
21226
+ "limit",
21227
+ "used",
21228
+ "remainingPercent",
21229
+ "resetsAt"
21230
+ ],
21231
+ "additionalProperties": false
21232
+ },
21233
+ "spendControlReached": {
21234
+ "type": [
21235
+ "boolean",
21236
+ "null"
21237
+ ]
21238
+ },
21239
+ "reachedType": {
21240
+ "type": [
21241
+ "string",
21242
+ "null"
21243
+ ],
21244
+ "maxLength": 256
21245
+ }
21246
+ },
21247
+ "required": [
21248
+ "observedAt"
21249
+ ],
21250
+ "additionalProperties": false
21251
+ }
21252
+ }
21253
+ },
21254
+ "required": [
21255
+ "source",
21256
+ "observedAt"
21257
+ ],
21258
+ "additionalProperties": false
21259
+ },
20642
21260
  "plan": {
20643
21261
  "type": [
20644
21262
  "string",
@@ -20657,6 +21275,12 @@
20657
21275
  null
20658
21276
  ]
20659
21277
  },
21278
+ "detectedPlanRaw": {
21279
+ "type": [
21280
+ "string",
21281
+ "null"
21282
+ ]
21283
+ },
20660
21284
  "lastSeatMismatchAt": {
20661
21285
  "type": [
20662
21286
  "string",
@@ -20743,8 +21367,10 @@
20743
21367
  "name",
20744
21368
  "provider",
20745
21369
  "rateLimitWindows",
21370
+ "providerAccount",
20746
21371
  "plan",
20747
21372
  "planSource",
21373
+ "detectedPlanRaw",
20748
21374
  "lastSeatMismatchAt",
20749
21375
  "lastSeatMismatchModel",
20750
21376
  "consecutiveAuthFailures",
@@ -20779,6 +21405,419 @@
20779
21405
  }
20780
21406
  }
20781
21407
  },
21408
+ "/api/keys/window-usage": {
21409
+ "get": {
21410
+ "summary": "Get Swarm-observed usage within current provider windows",
21411
+ "description": "Usage calculations support 256 windows, 16 distinct windows per credential, 90 days, and 100,000 session rows. Oversized requests fail without partial totals.",
21412
+ "tags": [
21413
+ "API Keys"
21414
+ ],
21415
+ "security": [
21416
+ {
21417
+ "bearerAuth": []
21418
+ }
21419
+ ],
21420
+ "parameters": [
21421
+ {
21422
+ "schema": {
21423
+ "type": "string",
21424
+ "maxLength": 128
21425
+ },
21426
+ "required": false,
21427
+ "name": "keyType",
21428
+ "in": "query"
21429
+ },
21430
+ {
21431
+ "schema": {
21432
+ "type": "string",
21433
+ "minLength": 1,
21434
+ "maxLength": 10
21435
+ },
21436
+ "required": false,
21437
+ "name": "keySuffix",
21438
+ "in": "query"
21439
+ },
21440
+ {
21441
+ "schema": {
21442
+ "type": "string",
21443
+ "maxLength": 64
21444
+ },
21445
+ "required": false,
21446
+ "name": "scope",
21447
+ "in": "query"
21448
+ },
21449
+ {
21450
+ "schema": {
21451
+ "type": "string",
21452
+ "maxLength": 128
21453
+ },
21454
+ "required": false,
21455
+ "name": "scopeId",
21456
+ "in": "query"
21457
+ }
21458
+ ],
21459
+ "responses": {
21460
+ "200": {
21461
+ "description": "Independent windows with receipt-time tokens and explicit measurement coverage",
21462
+ "content": {
21463
+ "application/json": {
21464
+ "schema": {
21465
+ "type": "object",
21466
+ "properties": {
21467
+ "success": {
21468
+ "type": "boolean",
21469
+ "enum": [
21470
+ true
21471
+ ]
21472
+ },
21473
+ "asOf": {
21474
+ "type": "string"
21475
+ },
21476
+ "accounting": {
21477
+ "type": "string",
21478
+ "enum": [
21479
+ "session_cost_receipt_time"
21480
+ ]
21481
+ },
21482
+ "windows": {
21483
+ "type": "array",
21484
+ "items": {
21485
+ "type": "object",
21486
+ "properties": {
21487
+ "statusId": {
21488
+ "type": "string"
21489
+ },
21490
+ "keyType": {
21491
+ "type": "string"
21492
+ },
21493
+ "keySuffix": {
21494
+ "type": "string"
21495
+ },
21496
+ "scope": {
21497
+ "type": "string"
21498
+ },
21499
+ "scopeId": {
21500
+ "type": [
21501
+ "string",
21502
+ "null"
21503
+ ]
21504
+ },
21505
+ "windowKey": {
21506
+ "type": "string"
21507
+ },
21508
+ "durationMins": {
21509
+ "type": [
21510
+ "number",
21511
+ "null"
21512
+ ]
21513
+ },
21514
+ "startsAt": {
21515
+ "type": [
21516
+ "string",
21517
+ "null"
21518
+ ]
21519
+ },
21520
+ "endsAt": {
21521
+ "type": [
21522
+ "string",
21523
+ "null"
21524
+ ]
21525
+ },
21526
+ "dataThrough": {
21527
+ "type": "string"
21528
+ },
21529
+ "observedAt": {
21530
+ "type": "string"
21531
+ },
21532
+ "observationAgeMs": {
21533
+ "type": "number"
21534
+ },
21535
+ "modelScope": {
21536
+ "type": "object",
21537
+ "properties": {
21538
+ "kind": {
21539
+ "type": "string",
21540
+ "enum": [
21541
+ "account",
21542
+ "family",
21543
+ "unknown"
21544
+ ]
21545
+ },
21546
+ "model": {
21547
+ "type": [
21548
+ "string",
21549
+ "null"
21550
+ ]
21551
+ }
21552
+ },
21553
+ "required": [
21554
+ "kind",
21555
+ "model"
21556
+ ]
21557
+ },
21558
+ "unavailableReason": {
21559
+ "type": [
21560
+ "string",
21561
+ "null"
21562
+ ],
21563
+ "enum": [
21564
+ "missing_reset",
21565
+ "unknown_duration",
21566
+ "unknown_model_scope",
21567
+ "window_not_started",
21568
+ null
21569
+ ]
21570
+ },
21571
+ "usage": {
21572
+ "type": [
21573
+ "object",
21574
+ "null"
21575
+ ],
21576
+ "properties": {
21577
+ "sessions": {
21578
+ "type": "integer"
21579
+ },
21580
+ "errorSessions": {
21581
+ "type": "integer"
21582
+ },
21583
+ "completedTasks": {
21584
+ "type": "integer"
21585
+ },
21586
+ "tokens": {
21587
+ "type": "object",
21588
+ "properties": {
21589
+ "uncachedInput": {
21590
+ "type": "object",
21591
+ "properties": {
21592
+ "value": {
21593
+ "type": [
21594
+ "number",
21595
+ "null"
21596
+ ]
21597
+ },
21598
+ "measuredSessions": {
21599
+ "type": "integer"
21600
+ },
21601
+ "missingSessions": {
21602
+ "type": "integer"
21603
+ }
21604
+ },
21605
+ "required": [
21606
+ "value",
21607
+ "measuredSessions",
21608
+ "missingSessions"
21609
+ ]
21610
+ },
21611
+ "output": {
21612
+ "type": "object",
21613
+ "properties": {
21614
+ "value": {
21615
+ "type": [
21616
+ "number",
21617
+ "null"
21618
+ ]
21619
+ },
21620
+ "measuredSessions": {
21621
+ "type": "integer"
21622
+ },
21623
+ "missingSessions": {
21624
+ "type": "integer"
21625
+ }
21626
+ },
21627
+ "required": [
21628
+ "value",
21629
+ "measuredSessions",
21630
+ "missingSessions"
21631
+ ]
21632
+ },
21633
+ "cacheRead": {
21634
+ "type": "object",
21635
+ "properties": {
21636
+ "value": {
21637
+ "type": [
21638
+ "number",
21639
+ "null"
21640
+ ]
21641
+ },
21642
+ "measuredSessions": {
21643
+ "type": "integer"
21644
+ },
21645
+ "missingSessions": {
21646
+ "type": "integer"
21647
+ }
21648
+ },
21649
+ "required": [
21650
+ "value",
21651
+ "measuredSessions",
21652
+ "missingSessions"
21653
+ ]
21654
+ },
21655
+ "cacheWrite": {
21656
+ "type": "object",
21657
+ "properties": {
21658
+ "value": {
21659
+ "type": [
21660
+ "number",
21661
+ "null"
21662
+ ]
21663
+ },
21664
+ "measuredSessions": {
21665
+ "type": "integer"
21666
+ },
21667
+ "missingSessions": {
21668
+ "type": "integer"
21669
+ }
21670
+ },
21671
+ "required": [
21672
+ "value",
21673
+ "measuredSessions",
21674
+ "missingSessions"
21675
+ ]
21676
+ },
21677
+ "reasoning": {
21678
+ "type": "object",
21679
+ "properties": {
21680
+ "value": {
21681
+ "type": [
21682
+ "number",
21683
+ "null"
21684
+ ]
21685
+ },
21686
+ "measuredSessions": {
21687
+ "type": "integer"
21688
+ },
21689
+ "missingSessions": {
21690
+ "type": "integer"
21691
+ }
21692
+ },
21693
+ "required": [
21694
+ "value",
21695
+ "measuredSessions",
21696
+ "missingSessions"
21697
+ ]
21698
+ },
21699
+ "thinking": {
21700
+ "type": "object",
21701
+ "properties": {
21702
+ "value": {
21703
+ "type": [
21704
+ "number",
21705
+ "null"
21706
+ ]
21707
+ },
21708
+ "measuredSessions": {
21709
+ "type": "integer"
21710
+ },
21711
+ "missingSessions": {
21712
+ "type": "integer"
21713
+ }
21714
+ },
21715
+ "required": [
21716
+ "value",
21717
+ "measuredSessions",
21718
+ "missingSessions"
21719
+ ]
21720
+ }
21721
+ },
21722
+ "required": [
21723
+ "uncachedInput",
21724
+ "output",
21725
+ "cacheRead",
21726
+ "cacheWrite",
21727
+ "reasoning",
21728
+ "thinking"
21729
+ ]
21730
+ },
21731
+ "modelUnattributedSessions": {
21732
+ "type": "integer"
21733
+ },
21734
+ "swarmUnattributedSessions": {
21735
+ "type": "integer"
21736
+ }
21737
+ },
21738
+ "required": [
21739
+ "sessions",
21740
+ "errorSessions",
21741
+ "completedTasks",
21742
+ "tokens",
21743
+ "modelUnattributedSessions",
21744
+ "swarmUnattributedSessions"
21745
+ ]
21746
+ }
21747
+ },
21748
+ "required": [
21749
+ "statusId",
21750
+ "keyType",
21751
+ "keySuffix",
21752
+ "scope",
21753
+ "scopeId",
21754
+ "windowKey",
21755
+ "durationMins",
21756
+ "startsAt",
21757
+ "endsAt",
21758
+ "dataThrough",
21759
+ "observedAt",
21760
+ "observationAgeMs",
21761
+ "modelScope",
21762
+ "unavailableReason",
21763
+ "usage"
21764
+ ]
21765
+ }
21766
+ }
21767
+ },
21768
+ "required": [
21769
+ "success",
21770
+ "asOf",
21771
+ "accounting",
21772
+ "windows"
21773
+ ]
21774
+ }
21775
+ }
21776
+ }
21777
+ },
21778
+ "400": {
21779
+ "description": "Invalid filters",
21780
+ "content": {
21781
+ "application/json": {
21782
+ "schema": {
21783
+ "$ref": "#/components/schemas/ErrorResponse"
21784
+ }
21785
+ }
21786
+ }
21787
+ },
21788
+ "401": {
21789
+ "description": "Unauthorized",
21790
+ "content": {
21791
+ "application/json": {
21792
+ "schema": {
21793
+ "$ref": "#/components/schemas/ErrorResponse"
21794
+ }
21795
+ }
21796
+ }
21797
+ },
21798
+ "422": {
21799
+ "description": "Requested usage exceeds the aggregation bounds",
21800
+ "content": {
21801
+ "application/json": {
21802
+ "schema": {
21803
+ "$ref": "#/components/schemas/ErrorResponse"
21804
+ }
21805
+ }
21806
+ }
21807
+ },
21808
+ "429": {
21809
+ "description": "Usage query budget exhausted. Retry after one second",
21810
+ "content": {
21811
+ "application/json": {
21812
+ "schema": {
21813
+ "$ref": "#/components/schemas/ErrorResponse"
21814
+ }
21815
+ }
21816
+ }
21817
+ }
21818
+ }
21819
+ }
21820
+ },
20782
21821
  "/api/keys/costs": {
20783
21822
  "get": {
20784
21823
  "summary": "Get aggregated cost data per API key",
@@ -36090,7 +37129,7 @@
36090
37129
  }
36091
37130
  },
36092
37131
  "403": {
36093
- "description": "An agent caller names a parentTaskId it neither owns nor created, or a non-lead agent binds the task to a chat thread",
37132
+ "description": "Parent/session access denied, unauthorized chat-thread binding, or routing requirements reject the assignment",
36094
37133
  "content": {
36095
37134
  "application/json": {
36096
37135
  "schema": {
@@ -37100,6 +38139,62 @@
37100
38139
  "verified"
37101
38140
  ]
37102
38141
  }
38142
+ },
38143
+ "uiSpec": {
38144
+ "type": [
38145
+ "object",
38146
+ "null"
38147
+ ],
38148
+ "properties": {
38149
+ "spec": {
38150
+ "type": "object",
38151
+ "properties": {
38152
+ "root": {
38153
+ "type": "string"
38154
+ },
38155
+ "elements": {
38156
+ "type": "object",
38157
+ "additionalProperties": {}
38158
+ },
38159
+ "state": {
38160
+ "type": "object",
38161
+ "additionalProperties": {}
38162
+ }
38163
+ },
38164
+ "required": [
38165
+ "root",
38166
+ "elements"
38167
+ ]
38168
+ },
38169
+ "actions": {
38170
+ "type": "object",
38171
+ "additionalProperties": {
38172
+ "type": "object",
38173
+ "properties": {
38174
+ "kind": {
38175
+ "type": "string",
38176
+ "enum": [
38177
+ "follow_up"
38178
+ ]
38179
+ },
38180
+ "prompt": {
38181
+ "type": "string"
38182
+ }
38183
+ },
38184
+ "required": [
38185
+ "kind",
38186
+ "prompt"
38187
+ ]
38188
+ }
38189
+ },
38190
+ "fallbackText": {
38191
+ "type": "string"
38192
+ }
38193
+ },
38194
+ "required": [
38195
+ "spec",
38196
+ "fallbackText"
38197
+ ]
37103
38198
  }
37104
38199
  },
37105
38200
  "required": [
@@ -37107,7 +38202,8 @@
37107
38202
  "supportedSteerModes",
37108
38203
  "logs",
37109
38204
  "attachments",
37110
- "citations"
38205
+ "citations",
38206
+ "uiSpec"
37111
38207
  ]
37112
38208
  }
37113
38209
  ]
@@ -38049,10 +39145,99 @@
38049
39145
  }
38050
39146
  }
38051
39147
  },
39148
+ "/api/tasks/{id}/ui-actions/{actionId}": {
39149
+ "post": {
39150
+ "summary": "Run the action a task card Button declares",
39151
+ "description": "Runs the task card action once per task and action. Only the task requester may run it: a user token, or the operator key with the requester in `X-Swarm-User-Id`. Agent callers, and operator calls with no picked user, get 403. Needs UI_SPEC_ACTIONS_ENABLED=true.",
39152
+ "tags": [
39153
+ "Tasks"
39154
+ ],
39155
+ "security": [
39156
+ {
39157
+ "bearerAuth": []
39158
+ }
39159
+ ],
39160
+ "parameters": [
39161
+ {
39162
+ "schema": {
39163
+ "type": "string"
39164
+ },
39165
+ "required": true,
39166
+ "name": "id",
39167
+ "in": "path"
39168
+ },
39169
+ {
39170
+ "schema": {
39171
+ "type": "string"
39172
+ },
39173
+ "required": true,
39174
+ "name": "actionId",
39175
+ "in": "path"
39176
+ }
39177
+ ],
39178
+ "responses": {
39179
+ "200": {
39180
+ "description": "The action started, or it already ran",
39181
+ "content": {
39182
+ "application/json": {
39183
+ "schema": {
39184
+ "type": "object",
39185
+ "properties": {
39186
+ "status": {
39187
+ "type": "string",
39188
+ "enum": [
39189
+ "started",
39190
+ "already_done"
39191
+ ]
39192
+ },
39193
+ "taskId": {
39194
+ "type": "string"
39195
+ }
39196
+ },
39197
+ "required": [
39198
+ "status"
39199
+ ]
39200
+ }
39201
+ }
39202
+ }
39203
+ },
39204
+ "403": {
39205
+ "description": "Only the task requester may run the action",
39206
+ "content": {
39207
+ "application/json": {
39208
+ "schema": {
39209
+ "$ref": "#/components/schemas/ErrorResponse"
39210
+ }
39211
+ }
39212
+ }
39213
+ },
39214
+ "404": {
39215
+ "description": "Task or action not found",
39216
+ "content": {
39217
+ "application/json": {
39218
+ "schema": {
39219
+ "$ref": "#/components/schemas/ErrorResponse"
39220
+ }
39221
+ }
39222
+ }
39223
+ },
39224
+ "409": {
39225
+ "description": "Card actions are turned off (UI_SPEC_ACTIONS_ENABLED)",
39226
+ "content": {
39227
+ "application/json": {
39228
+ "schema": {
39229
+ "$ref": "#/components/schemas/ErrorResponse"
39230
+ }
39231
+ }
39232
+ }
39233
+ }
39234
+ }
39235
+ }
39236
+ },
38052
39237
  "/api/tasks/{id}/supersede": {
38053
39238
  "post": {
38054
39239
  "summary": "Supersede an in-progress task (terminate + spawn resume follow-up)",
38055
- "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. 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.",
39240
+ "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. 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.",
38056
39241
  "tags": [
38057
39242
  "Tasks"
38058
39243
  ],
@@ -51977,6 +53162,42 @@
51977
53162
  "type": "string",
51978
53163
  "minLength": 1
51979
53164
  },
53165
+ "credentialKeyType": {
53166
+ "type": [
53167
+ "string",
53168
+ "null"
53169
+ ],
53170
+ "pattern": "^[A-Z][A-Z0-9_]{0,79}$"
53171
+ },
53172
+ "credentialKeySuffix": {
53173
+ "type": [
53174
+ "string",
53175
+ "null"
53176
+ ],
53177
+ "minLength": 1,
53178
+ "maxLength": 10
53179
+ },
53180
+ "harness": {
53181
+ "type": [
53182
+ "string",
53183
+ "null"
53184
+ ],
53185
+ "enum": [
53186
+ "claude",
53187
+ "codex",
53188
+ "pi",
53189
+ "devin",
53190
+ "claude-managed",
53191
+ "opencode",
53192
+ "acp",
53193
+ "dsh",
53194
+ "amp",
53195
+ "cursor",
53196
+ "grok",
53197
+ "fx",
53198
+ null
53199
+ ]
53200
+ },
51980
53201
  "totalCostUsd": {
51981
53202
  "type": "number"
51982
53203
  },
@@ -51995,7 +53216,10 @@
51995
53216
  "minimum": 0
51996
53217
  },
51997
53218
  "cacheReadTokens": {
51998
- "type": "integer",
53219
+ "type": [
53220
+ "integer",
53221
+ "null"
53222
+ ],
51999
53223
  "minimum": 0
52000
53224
  },
52001
53225
  "cacheWriteTokens": {
@@ -52156,6 +53380,26 @@
52156
53380
  }
52157
53381
  }
52158
53382
  }
53383
+ },
53384
+ "403": {
53385
+ "description": "Untrusted session attribution",
53386
+ "content": {
53387
+ "application/json": {
53388
+ "schema": {
53389
+ "$ref": "#/components/schemas/ErrorResponse"
53390
+ }
53391
+ }
53392
+ }
53393
+ },
53394
+ "409": {
53395
+ "description": "Session identity conflict",
53396
+ "content": {
53397
+ "application/json": {
53398
+ "schema": {
53399
+ "$ref": "#/components/schemas/ErrorResponse"
53400
+ }
53401
+ }
53402
+ }
52159
53403
  }
52160
53404
  }
52161
53405
  },
@@ -52345,6 +53589,12 @@
52345
53589
  },
52346
53590
  "subscriptionCostUsd": {
52347
53591
  "type": "number"
53592
+ },
53593
+ "credentialUnattributedCostUsd": {
53594
+ "type": "number"
53595
+ },
53596
+ "credentialUnattributedSessions": {
53597
+ "type": "integer"
52348
53598
  }
52349
53599
  },
52350
53600
  "required": [
@@ -52360,7 +53610,9 @@
52360
53610
  "attributableCostUsd",
52361
53611
  "excludedCostUsd",
52362
53612
  "excludedTaskCount",
52363
- "subscriptionCostUsd"
53613
+ "subscriptionCostUsd",
53614
+ "credentialUnattributedCostUsd",
53615
+ "credentialUnattributedSessions"
52364
53616
  ]
52365
53617
  },
52366
53618
  "daily": {
@@ -52385,6 +53637,12 @@
52385
53637
  },
52386
53638
  "subscriptionCostUsd": {
52387
53639
  "type": "number"
53640
+ },
53641
+ "credentialUnattributedCostUsd": {
53642
+ "type": "number"
53643
+ },
53644
+ "credentialUnattributedSessions": {
53645
+ "type": "integer"
52388
53646
  }
52389
53647
  },
52390
53648
  "required": [
@@ -52393,7 +53651,9 @@
52393
53651
  "inputTokens",
52394
53652
  "outputTokens",
52395
53653
  "sessions",
52396
- "subscriptionCostUsd"
53654
+ "subscriptionCostUsd",
53655
+ "credentialUnattributedCostUsd",
53656
+ "credentialUnattributedSessions"
52397
53657
  ]
52398
53658
  }
52399
53659
  },
@@ -56262,6 +57522,62 @@
56262
57522
  ]
56263
57523
  }
56264
57524
  },
57525
+ "uiSpec": {
57526
+ "type": [
57527
+ "object",
57528
+ "null"
57529
+ ],
57530
+ "properties": {
57531
+ "spec": {
57532
+ "type": "object",
57533
+ "properties": {
57534
+ "root": {
57535
+ "type": "string"
57536
+ },
57537
+ "elements": {
57538
+ "type": "object",
57539
+ "additionalProperties": {}
57540
+ },
57541
+ "state": {
57542
+ "type": "object",
57543
+ "additionalProperties": {}
57544
+ }
57545
+ },
57546
+ "required": [
57547
+ "root",
57548
+ "elements"
57549
+ ]
57550
+ },
57551
+ "actions": {
57552
+ "type": "object",
57553
+ "additionalProperties": {
57554
+ "type": "object",
57555
+ "properties": {
57556
+ "kind": {
57557
+ "type": "string",
57558
+ "enum": [
57559
+ "follow_up"
57560
+ ]
57561
+ },
57562
+ "prompt": {
57563
+ "type": "string"
57564
+ }
57565
+ },
57566
+ "required": [
57567
+ "kind",
57568
+ "prompt"
57569
+ ]
57570
+ }
57571
+ },
57572
+ "fallbackText": {
57573
+ "type": "string"
57574
+ }
57575
+ },
57576
+ "required": [
57577
+ "spec",
57578
+ "fallbackText"
57579
+ ]
57580
+ },
56265
57581
  "isLeadTask": {
56266
57582
  "type": "boolean"
56267
57583
  },
@@ -56278,6 +57594,7 @@
56278
57594
  },
56279
57595
  "required": [
56280
57596
  "citations",
57597
+ "uiSpec",
56281
57598
  "isLeadTask",
56282
57599
  "supportedSteerModes"
56283
57600
  ]
@@ -56359,6 +57676,62 @@
56359
57676
  ]
56360
57677
  }
56361
57678
  },
57679
+ "uiSpec": {
57680
+ "type": [
57681
+ "object",
57682
+ "null"
57683
+ ],
57684
+ "properties": {
57685
+ "spec": {
57686
+ "type": "object",
57687
+ "properties": {
57688
+ "root": {
57689
+ "type": "string"
57690
+ },
57691
+ "elements": {
57692
+ "type": "object",
57693
+ "additionalProperties": {}
57694
+ },
57695
+ "state": {
57696
+ "type": "object",
57697
+ "additionalProperties": {}
57698
+ }
57699
+ },
57700
+ "required": [
57701
+ "root",
57702
+ "elements"
57703
+ ]
57704
+ },
57705
+ "actions": {
57706
+ "type": "object",
57707
+ "additionalProperties": {
57708
+ "type": "object",
57709
+ "properties": {
57710
+ "kind": {
57711
+ "type": "string",
57712
+ "enum": [
57713
+ "follow_up"
57714
+ ]
57715
+ },
57716
+ "prompt": {
57717
+ "type": "string"
57718
+ }
57719
+ },
57720
+ "required": [
57721
+ "kind",
57722
+ "prompt"
57723
+ ]
57724
+ }
57725
+ },
57726
+ "fallbackText": {
57727
+ "type": "string"
57728
+ }
57729
+ },
57730
+ "required": [
57731
+ "spec",
57732
+ "fallbackText"
57733
+ ]
57734
+ },
56362
57735
  "isLeadTask": {
56363
57736
  "type": "boolean"
56364
57737
  },
@@ -56375,6 +57748,7 @@
56375
57748
  },
56376
57749
  "required": [
56377
57750
  "citations",
57751
+ "uiSpec",
56378
57752
  "isLeadTask",
56379
57753
  "supportedSteerModes"
56380
57754
  ]