@desplega.ai/agent-swarm 2.8.3 → 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 (597) hide show
  1. package/dist/acp-adapter-g909b5hw.js +16 -0
  2. package/dist/acp-targets-ny75x1qy.js +23 -0
  3. package/dist/{actions-ewz7bp4g.js → actions-b9qgrmeq.js} +82 -21
  4. package/dist/agent-fs-provision-b5dhdsbd.js +27 -0
  5. package/dist/{amp-adapter-f25tqhnf.js → amp-adapter-vtax2c9s.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-r5xf5hqw.js} +37 -37
  7. package/dist/{app-mkptw0k7.js → app-g2z15hax.js} +9 -4
  8. package/dist/approval-notifications-yt13wp8r.js +23 -0
  9. package/dist/{assistant-c47rfe77.js → assistant-2cgfxsgk.js} +56 -33
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-4vb0xsat.js → boot-args-schema-3gwy0f60.js} +1 -1
  12. package/dist/{boot-reembed-htr73hbs.js → boot-reembed-92g7s5zp.js} +1 -1
  13. package/dist/{boot-reembed-1ghy2sab.js → boot-reembed-mywmyp4s.js} +1 -1
  14. package/dist/{boot-scrub-sweep-yrytg42z.js → boot-scrub-sweep-7dkdzqxx.js} +84 -13
  15. package/dist/{boot-seeds-n2b3dx4e.js → boot-seeds-ce7rvgq1.js} +4 -4
  16. package/dist/{boxd-jmfqgkqa.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-3m4q7735.js +28 -0
  18. package/dist/{claude-managed-adapter-hddmxjyj.js → claude-managed-adapter-t8nfgcgz.js} +4 -4
  19. package/dist/{claude-managed-setup-hfvry1bd.js → claude-managed-setup-c217draw.js} +10 -10
  20. package/dist/{claude-sdk-session-0hamqzc7.js → claude-sdk-session-7fbqm51z.js} +9386 -9196
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-sdvcrq5x.js → cli-1jykg0py.js} +18 -14
  23. package/dist/{cli-k96cecs7.js → cli-2czxfnvj.js} +1221 -357
  24. package/dist/{cli-qmqt520k.js → cli-2dq9yv8p.js} +2 -2
  25. package/dist/{cli-e2w34h6z.js → cli-2xs8tsf7.js} +132 -85
  26. package/dist/{cli-z8cvws4c.js → cli-2yjj3e31.js} +907 -56
  27. package/dist/{cli-mdpbjnzq.js → cli-32djehja.js} +42 -42
  28. package/dist/{cli-gpz1d0t2.js → cli-3j873zxq.js} +4 -4
  29. package/dist/cli-43ms35q9.js +270 -0
  30. package/dist/cli-47hz21se.js +25584 -0
  31. package/dist/{cli-n515ex5z.js → cli-4ymxrwg5.js} +16 -16
  32. package/dist/{cli-f1kwb5fc.js → cli-5a6pqy45.js} +333 -21
  33. package/dist/{cli-93t5s4zq.js → cli-5gpqgs8b.js} +2 -2
  34. package/dist/{cli-15204js0.js → cli-6237rnyr.js} +1 -1
  35. package/dist/{cli-4ax9mvvg.js → cli-67mwzr35.js} +9 -9
  36. package/dist/{cli-t5ys4ebm.js → cli-6945ywhr.js} +3 -3
  37. package/dist/{cli-0bcgyj5b.js → cli-6ehs4mta.js} +87 -8
  38. package/dist/{cli-6yygkr0w.js → cli-6ym4jhzp.js} +15 -7
  39. package/dist/{cli-8bpgbr8k.js → cli-7evph51z.js} +5 -5
  40. package/dist/{cli-dtdht77h.js → cli-7mv4h3sn.js} +2 -2
  41. package/dist/{cli-nx2n3z6p.js → cli-7sf9sb0w.js} +3 -2
  42. package/dist/{cli-pe4d96rb.js → cli-7zm3b3f5.js} +1 -1
  43. package/dist/cli-8zh9nrew.js +78 -0
  44. package/dist/cli-9ttx00s3.js +137 -0
  45. package/dist/{cli-x6t50dmw.js → cli-9w8712tq.js} +620 -281
  46. package/dist/{cli-8476gtwf.js → cli-b6px1k1q.js} +1 -1
  47. package/dist/{cli-k2rw11py.js → cli-b91nz213.js} +5 -5
  48. package/dist/{cli-7c5tgqhf.js → cli-bg63qmsx.js} +10 -10
  49. package/dist/{cli-qps8je6j.js → cli-bkjdknnp.js} +54 -10
  50. package/dist/{cli-gn9y6fn7.js → cli-bnqncekd.js} +2 -2
  51. package/dist/{cli-s7zz734a.js → cli-br0924pw.js} +1 -1
  52. package/dist/{cli-h9yy18gy.js → cli-ctx0b85j.js} +5484 -5078
  53. package/dist/{cli-0vksaxvr.js → cli-dgs10ttj.js} +2 -2
  54. package/dist/cli-dqgnbnxs.js +132 -0
  55. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  56. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  57. package/dist/{cli-c0xjnr8z.js → cli-f3jyzq4g.js} +2 -2
  58. package/dist/cli-f8x9drqr.js +84 -0
  59. package/dist/{cli-ztq5z4e1.js → cli-f9gz2vyj.js} +6 -6
  60. package/dist/{cli-bhsfbmk8.js → cli-fh97xn30.js} +93 -44
  61. package/dist/cli-fkef327x.js +103 -0
  62. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  63. package/dist/{cli-kd56bmk4.js → cli-gabsjg8x.js} +3 -1
  64. package/dist/{cli-1m96dc36.js → cli-gfy38pvt.js} +3 -3
  65. package/dist/{cli-922z7gwm.js → cli-h9yqfzx9.js} +15 -11
  66. package/dist/{cli-5a7szzfh.js → cli-hnamkvnc.js} +2 -2
  67. package/dist/{cli-c3ng0mb4.js → cli-j7svy295.js} +71 -818
  68. package/dist/{cli-yss07azk.js → cli-jaw5v1sy.js} +3 -3
  69. package/dist/cli-jkw6ptfw.js +921 -0
  70. package/dist/{cli-s8p8hhty.js → cli-jm0hvmz2.js} +2 -2
  71. package/dist/{cli-knva3nmx.js → cli-jwampxxq.js} +8 -6
  72. package/dist/cli-kj0hyr43.js +51 -0
  73. package/dist/{cli-tnzebztn.js → cli-kpgcm7xy.js} +13 -1
  74. package/dist/{cli-9zmb7ptc.js → cli-kxx4k2jw.js} +8 -753
  75. package/dist/{cli-am1ptset.js → cli-m7c2380k.js} +208 -194
  76. package/dist/{cli-kw44j53p.js → cli-m7zvgt57.js} +45 -38
  77. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  78. package/dist/{cli-54qr8mcd.js → cli-mhapr559.js} +4 -4
  79. package/dist/{cli-tf79ryyy.js → cli-mjw0yf82.js} +3 -3
  80. package/dist/{cli-rjvsf9qa.js → cli-mkwkwq81.js} +14 -11
  81. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  82. package/dist/{cli-awwptga4.js → cli-mw620q3n.js} +1 -1
  83. package/dist/{cli-6wj7p986.js → cli-n3qe7tyr.js} +172 -168
  84. package/dist/{cli-4dpkjc2e.js → cli-nafvvsp8.js} +9 -9
  85. package/dist/{cli-sg27rk2t.js → cli-nbt14he0.js} +25 -19
  86. package/dist/{cli-7akn6ze9.js → cli-nh7x3133.js} +7 -28
  87. package/dist/{cli-zdaypkq9.js → cli-p4kckx1z.js} +285 -97
  88. package/dist/{cli-n5t077me.js → cli-pb2ay3sh.js} +10 -3
  89. package/dist/{cli-t4dv07kr.js → cli-psffsanb.js} +4 -3
  90. package/dist/{cli-mwwmka77.js → cli-pyjn0qhk.js} +2712 -268
  91. package/dist/{cli-emekyyhr.js → cli-q2d3e1k1.js} +1 -1
  92. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  93. package/dist/{cli-2d0cghfn.js → cli-qj39vrc6.js} +1 -1
  94. package/dist/{cli-tas6ckky.js → cli-rq5rpv6k.js} +2 -2
  95. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  96. package/dist/{cli-kmemts3w.js → cli-sn650d7x.js} +39 -69
  97. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  98. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  99. package/dist/{cli-500c09j9.js → cli-t9ga4qmb.js} +14 -14
  100. package/dist/{cli-me0r8gzr.js → cli-td9tb872.js} +27 -25
  101. package/dist/cli-tvc4jag9.js +754 -0
  102. package/dist/{cli-6ek0hff4.js → cli-ty3gha1p.js} +4 -4
  103. package/dist/{cli-c71n3bxq.js → cli-v57d7fmm.js} +2 -2
  104. package/dist/{cli-j8cjdzan.js → cli-vs9vdpy0.js} +1 -1
  105. package/dist/cli-vt89089n.js +296 -0
  106. package/dist/{cli-pxwtcgcp.js → cli-vyff45ve.js} +2 -2
  107. package/dist/{cli-x3ex5bqf.js → cli-w16kwbzw.js} +1 -1
  108. package/dist/{cli-bj6qhgte.js → cli-w4n323t3.js} +197 -45
  109. package/dist/{cli-rqfvkx5t.js → cli-wn13hhdt.js} +13 -13
  110. package/dist/{cli-skmhsnqh.js → cli-x40a0w9j.js} +1 -1
  111. package/dist/{cli-zeaehgyd.js → cli-xag7btpe.js} +2 -2
  112. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  113. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  114. package/dist/{cli-dpsfwh7n.js → cli-y2ewxhth.js} +56 -31
  115. package/dist/{cli-vx421edw.js → cli-ysvspf5e.js} +9 -7
  116. package/dist/{cli-crpf163n.js → cli-zh0e5x7p.js} +16 -26
  117. package/dist/{cli-4e1hfbpq.js → cli-zr6qy15y.js} +24 -24
  118. package/dist/cli.js +33 -29
  119. package/dist/{codex-adapter-2brxx5ta.js → codex-adapter-n656pvb8.js} +9 -8
  120. package/dist/{codex-hook-c930c3ea.js → codex-hook-59atdwd8.js} +6 -6
  121. package/dist/{codex-login-cbrs1h5w.js → codex-login-a239g1ah.js} +1 -1
  122. package/dist/{codex-session-runner-y9anfj0r.js → codex-session-runner-p0fbv5y9.js} +10 -9
  123. package/dist/{commands-wn9q06qr.js → commands-gwea8z5p.js} +3 -3
  124. package/dist/{controller-fw608czd.js → controller-t67c3grh.js} +9 -6
  125. package/dist/{controllers-connect-63j5rdcm.js → controllers-connect-ks155r0h.js} +28 -25
  126. package/dist/{cursor-adapter-6mb9jme8.js → cursor-adapter-ygwrtmkv.js} +2 -2
  127. package/dist/{db-y4wfrzbm.js → db-kpmx06s9.js} +21 -13
  128. package/dist/{db-0m6v5tq4.js → db-rb2xqdb1.js} +3 -3
  129. package/dist/{devin-adapter-r0yx3gv8.js → devin-adapter-zp4tqq53.js} +1 -1
  130. package/dist/{dispatcher-9tq2zzdj.js → dispatcher-31sm0ej2.js} +21 -18
  131. package/dist/{docker-j75atvpt.js → docker-09tkkg0n.js} +47 -8
  132. package/dist/{dsh-adapter-t09sv4tq.js → dsh-adapter-qyxh0w31.js} +2 -2
  133. package/dist/{e2b-a7vzs2vj.js → e2b-3v1e745x.js} +6 -6
  134. package/dist/{e2b-7s9dscap.js → e2b-sm28k0k3.js} +6 -6
  135. package/dist/{easter-egg-3d-fbwvmwhe.js → easter-egg-3d-00wjscn6.js} +1 -1
  136. package/dist/{embedding-space-wh8de1t9.js → embedding-space-qhw4g68n.js} +6 -6
  137. package/dist/{embeddings-3hpbdtjr.js → embeddings-zdv9ke6x.js} +1 -1
  138. package/dist/{event-bus-tr6h3gv8.js → event-bus-xr83x566.js} +1 -1
  139. package/dist/{execute-4bdf8sdy.js → execute-zna8wwr7.js} +1 -1
  140. package/dist/{external-channel-ts2fwqh0.js → external-channel-1ac6t56s.js} +2 -2
  141. package/dist/fx-adapter-sk7n0fzc.js +19 -0
  142. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  143. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  144. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  145. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  146. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  147. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-maq6c9bf.js} +1 -1
  148. package/dist/{google-vertex-fhxaafzw.js → google-vertex-2jgsw2nb.js} +5 -5
  149. package/dist/grok-adapter-sjbcm5ew.js +19 -0
  150. package/dist/handlers-yzy0c87x.js +35 -0
  151. package/dist/{heartbeat-2ze5fzpc.js → heartbeat-2f6z4kdx.js} +24 -21
  152. package/dist/{hook-gaehe2w5.js → hook-8y0gvtp1.js} +14 -14
  153. package/dist/{hook-ca54yd4s.js → hook-w1skzaqc.js} +5 -5
  154. package/dist/{http-jfg8t2yk.js → http-wghxvpef.js} +2333 -589
  155. package/dist/{index-d6wkh8ar.js → index-0h6qd4p1.js} +34 -24
  156. package/dist/index-25pvya7q.js +40 -0
  157. package/dist/index-2t4859r5.js +35 -0
  158. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  159. package/dist/{index-khe3gp0k.js → index-4k7m5dgj.js} +645 -370
  160. package/dist/index-620y7jzq.js +15 -0
  161. package/dist/{index-gjwaqaq8.js → index-8p0j4h4j.js} +506 -43
  162. package/dist/{index-3gv6sc4z.js → index-8zn8nxn5.js} +1 -1
  163. package/dist/{index-m5gx1xd6.js → index-9myfj74s.js} +40 -40
  164. package/dist/{index-3yvzbhxd.js → index-9zkchs9t.js} +336 -193
  165. package/dist/{index-0rvk3vd4.js → index-b5wgnm78.js} +47 -47
  166. package/dist/index-cxca2t8y.js +36 -0
  167. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  168. package/dist/{index-hjhfk3ra.js → index-pe3d8jfy.js} +3 -3
  169. package/dist/index-rv89fvzf.js +572 -0
  170. package/dist/{index-csgrxedz.js → index-s71ez27v.js} +1 -1
  171. package/dist/{keepalive-k2a3qe73.js → keepalive-sh02349h.js} +4 -4
  172. package/dist/lead-gk4h5eg7.js +74 -0
  173. package/dist/{maintenance-gb5sd5nc.js → maintenance-yj0dcjja.js} +1 -1
  174. package/dist/{node-252anz2h.js → node-dqm4xgxw.js} +4 -4
  175. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  176. package/dist/{oauth-refresh-sweep-y7rm6bkb.js → oauth-refresh-sweep-d9xedk66.js} +3 -3
  177. package/dist/{onboard-jmc5qerv.js → onboard-dpgjn03r.js} +8 -8
  178. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  179. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  180. package/dist/{opencode-adapter-7eade9ev.js → opencode-adapter-2d31cpjc.js} +7 -6
  181. package/dist/{otel-impl-8j1xhxqd.js → otel-impl-1skarpfq.js} +110 -110
  182. package/dist/pending-bfmxtx0g.js +82 -0
  183. package/dist/{pi-mono-adapter-yqmaf32x.js → pi-mono-adapter-gvppnasy.js} +43 -16
  184. package/dist/{pricing-refresh-1nj722h6.js → pricing-refresh-c6b325mk.js} +2 -2
  185. package/dist/{rbac-roles-b1mtr6dr.js → rbac-roles-h80qbdbs.js} +3 -3
  186. package/dist/{rbac-roles-n1f3frk1.js → rbac-roles-zfcx68tx.js} +10 -3
  187. package/dist/{render-v2-1gfpd8rj.js → render-v2-nx20t3rb.js} +7 -4
  188. package/dist/{resume-w1s1eh5v.js → resume-5ep8agan.js} +11 -7
  189. package/dist/{runtime-84g5egsc.js → runtime-r3pj4mce.js} +1 -1
  190. package/dist/{session-access-y6z1txk4.js → session-access-n7p3m15b.js} +4 -4
  191. package/dist/{session-source-backfill-gxxwfh12.js → session-source-backfill-v8mt0zwn.js} +4 -4
  192. package/dist/{setup-r91gstyk.js → setup-z1psaqhe.js} +1 -1
  193. package/dist/thread-buffer-a1re2r9r.js +38 -0
  194. package/dist/{virtual-modules-cgnj6kme.js → virtual-modules-rrbjdpxn.js} +5 -5
  195. package/dist/{work-objects-qcxzg61c.js → work-objects-4aghh73z.js} +31 -23
  196. package/dist/worker-3dyyb8ev.js +74 -0
  197. package/dist/{worker-follow-up-y2d2h7km.js → worker-follow-up-166zmex1.js} +21 -18
  198. package/dist/{x-qhxq2ama.js → x-wg164ss9.js} +2 -2
  199. package/openapi.json +2561 -131
  200. package/package.json +15 -11
  201. package/plugin/commands/create-pr.md +1 -1
  202. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  203. package/src/apps/action-runner.ts +21 -1
  204. package/src/apps/catalog.generated.json +667 -18
  205. package/src/apps/page-validator.ts +341 -8
  206. package/src/assets/key.ts +6 -0
  207. package/src/be/agent-fs-user-keys.ts +186 -0
  208. package/src/be/audit-user.ts +27 -13
  209. package/src/be/automation-preflight.test.ts +14 -14
  210. package/src/be/automation-preflight.ts +24 -16
  211. package/src/be/boot-scrub-sweep.ts +143 -14
  212. package/src/be/caller-session-group.ts +86 -0
  213. package/src/be/checklist.ts +375 -0
  214. package/src/be/db/agents.ts +12 -1
  215. package/src/be/db/approvals.ts +26 -0
  216. package/src/be/db/model-profiles.ts +4 -1
  217. package/src/be/db/session-costs.ts +219 -0
  218. package/src/be/db/session-log-reasoning.ts +36 -0
  219. package/src/be/db/session-moves.ts +23 -0
  220. package/src/be/db/session-tree.ts +78 -19
  221. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  222. package/src/be/db/tasks/read.ts +7 -3
  223. package/src/be/db/tasks/slack-fold.ts +116 -0
  224. package/src/be/db/tasks/write.ts +67 -1
  225. package/src/be/db-queries/mcp-servers.ts +13 -0
  226. package/src/be/db-queries/oauth.ts +6 -0
  227. package/src/be/db-queries/task-artifacts.ts +10 -8
  228. package/src/be/db.ts +242 -319
  229. package/src/be/extensions/assets.ts +17 -13
  230. package/src/be/import/config.ts +54 -0
  231. package/src/be/import/dir-source.ts +372 -0
  232. package/src/be/import/index.ts +149 -0
  233. package/src/be/import/pending.ts +71 -0
  234. package/src/be/import/schema.ts +137 -0
  235. package/src/be/import/seeders.ts +462 -0
  236. package/src/be/key-window-usage.ts +385 -0
  237. package/src/be/migrations/297_import_ownership.sql +34 -0
  238. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  239. package/src/be/migrations/302_checklist_items.sql +23 -0
  240. package/src/be/migrations/303_task_ui_specs.sql +28 -0
  241. package/src/be/migrations/306_provider_account_telemetry.sql +1 -0
  242. package/src/be/migrations/307_session_cost_credential_attribution.sql +23 -0
  243. package/src/be/migrations/310_session_logs_reasoning.sql +12 -0
  244. package/src/be/multi-runtime.ts +8 -1
  245. package/src/be/rbac-roles.ts +8 -1
  246. package/src/be/runtime-pools/db.ts +3 -0
  247. package/src/be/runtime-pools/demand.ts +20 -2
  248. package/src/be/runtime-pools/reachability.ts +31 -0
  249. package/src/be/runtime-pools/routing.ts +8 -1
  250. package/src/be/runtime-pools/supervisor.ts +6 -7
  251. package/src/be/savings/read.ts +8 -6
  252. package/src/be/script-credential-broker.ts +2 -2
  253. package/src/be/scripts/typecheck.ts +4 -4
  254. package/src/be/seed/agent-fs-provision.ts +104 -19
  255. package/src/be/seed/index.ts +1 -1
  256. package/src/be/seed/registry.ts +27 -8
  257. package/src/be/seed/runner.ts +1 -1
  258. package/src/be/seed/schedules-seeder.ts +24 -6
  259. package/src/be/seed/seed-toggle.ts +32 -0
  260. package/src/be/seed/types.ts +6 -0
  261. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -0
  262. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -0
  263. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  264. package/src/be/seed-scripts/catalog/wait-for-task.ts +5 -1
  265. package/src/be/seed-skills/index.ts +3 -0
  266. package/src/be/steering.ts +27 -4
  267. package/src/be/swarm-config-guard.ts +54 -1
  268. package/src/be/task-citations.ts +8 -5
  269. package/src/be/task-ui-spec.ts +158 -0
  270. package/src/commands/controller.ts +3 -0
  271. package/src/commands/credential-outcome-report.ts +13 -3
  272. package/src/commands/onboard/agent-fs-version.ts +1 -1
  273. package/src/commands/rate-limit-outcome.ts +6 -0
  274. package/src/commands/runner.ts +95 -55
  275. package/src/e2b/env.ts +2 -0
  276. package/src/extensions/catalog.generated.json +17 -0
  277. package/src/extensions/contract-types.generated.ts +1 -1
  278. package/src/github/app.ts +10 -1
  279. package/src/github/handlers.ts +6 -3
  280. package/src/github/reactions.ts +12 -14
  281. package/src/heartbeat/heartbeat.ts +14 -4
  282. package/src/http/agents.ts +19 -10
  283. package/src/http/all-routes.ts +2 -0
  284. package/src/http/api-keys.ts +258 -30
  285. package/src/http/approval-requests.ts +24 -4
  286. package/src/http/apps.ts +69 -5
  287. package/src/http/checklist.ts +176 -0
  288. package/src/http/db-query-bounded.ts +256 -11
  289. package/src/http/db-query-shared.ts +9 -0
  290. package/src/http/favorites.ts +14 -2
  291. package/src/http/fs.ts +346 -1
  292. package/src/http/index.ts +29 -1
  293. package/src/http/kv.ts +13 -0
  294. package/src/http/mcp-oauth.ts +1 -1
  295. package/src/http/mcp-servers.ts +15 -2
  296. package/src/http/onboarding.ts +2 -9
  297. package/src/http/poll.ts +45 -0
  298. package/src/http/script-connections.ts +1 -0
  299. package/src/http/session-data.ts +74 -23
  300. package/src/http/sessions.ts +23 -2
  301. package/src/http/slack-events.ts +101 -0
  302. package/src/http/status.ts +25 -7
  303. package/src/http/task-requester.ts +46 -0
  304. package/src/http/tasks.ts +169 -42
  305. package/src/http/users.ts +14 -0
  306. package/src/http/webhooks.ts +15 -0
  307. package/src/integrations/cards/index.ts +151 -0
  308. package/src/integrations/chat-sdk/outbound.ts +39 -13
  309. package/src/integrations/chat-sdk/relay.ts +87 -0
  310. package/src/integrations/chat-sdk/runtime.ts +7 -1
  311. package/src/integrations/chat-sdk/status.ts +17 -0
  312. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  313. package/src/jira/outbound.ts +5 -3
  314. package/src/kv-reserved-namespaces.ts +17 -2
  315. package/src/linear/outbound.ts +5 -1
  316. package/src/oauth/presets.ts +29 -2
  317. package/src/prompts/base-prompt.ts +25 -4
  318. package/src/prompts/session-templates.ts +102 -8
  319. package/src/providers/acp-targets.ts +1 -1
  320. package/src/providers/amp-adapter.ts +1 -1
  321. package/src/providers/claude-adapter.ts +27 -4
  322. package/src/providers/claude-flag-settings.ts +39 -1
  323. package/src/providers/claude-managed-adapter.ts +5 -1
  324. package/src/providers/codex-adapter.ts +86 -4
  325. package/src/providers/codex-app-server.ts +11 -16
  326. package/src/providers/codex-oauth/auth-json.ts +1 -0
  327. package/src/providers/opencode-adapter.ts +7 -19
  328. package/src/providers/pi-mono-adapter.ts +35 -2
  329. package/src/providers/pricing-sources.md +32 -0
  330. package/src/providers/runtime-dependencies.ts +158 -0
  331. package/src/providers/types.ts +11 -0
  332. package/src/rbac/legacy-policy.ts +2 -0
  333. package/src/rbac/permissions.ts +10 -1
  334. package/src/runtime-providers/docker.ts +65 -1
  335. package/src/scheduler/deferred-task-waits.ts +18 -5
  336. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  337. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  338. package/src/scripts-runtime/egress-secrets.ts +2 -2
  339. package/src/scripts-runtime/swarm-sdk.ts +3 -2
  340. package/src/scripts-runtime/types/stdlib.d.ts +11 -4
  341. package/src/scripts-runtime/types/swarm-extension.d.ts +9 -9
  342. package/src/scripts-runtime/types/swarm-sdk.d.ts +11 -4
  343. package/src/server.ts +4 -4
  344. package/src/slack/actions.ts +56 -0
  345. package/src/slack/app.ts +107 -59
  346. package/src/slack/assistant.ts +33 -7
  347. package/src/slack/handlers.ts +6 -4
  348. package/src/slack/http-receiver.ts +284 -0
  349. package/src/slack/inbound-dispatch.ts +43 -7
  350. package/src/slack/inbound-files.ts +35 -14
  351. package/src/slack/message-text.ts +47 -4
  352. package/src/slack/render-v2.ts +109 -24
  353. package/src/slack/responses.ts +3 -2
  354. package/src/slack/socket-ack.ts +17 -10
  355. package/src/slack/steering.ts +5 -0
  356. package/src/slack/thread-buffer-store.ts +58 -0
  357. package/src/slack/thread-buffer.ts +341 -57
  358. package/src/slack/work-objects.ts +4 -1
  359. package/src/tasks/context-key.ts +24 -0
  360. package/src/tasks/errors.ts +5 -0
  361. package/src/tasks/sibling-awareness.ts +13 -1
  362. package/src/tests/acp-adapter.test.ts +4 -6
  363. package/src/tests/agent-fs-live-url.test.ts +15 -0
  364. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  365. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  366. package/src/tests/agentfs-proxy.test.ts +8 -8
  367. package/src/tests/api-key-tracking.test.ts +0 -72
  368. package/src/tests/api-keys-status-model-limits.test.ts +93 -1
  369. package/src/tests/api-keys-validation.test.ts +42 -0
  370. package/src/tests/approval-card-resolution.test.ts +402 -0
  371. package/src/tests/approval-requests-notifications.test.ts +12 -2
  372. package/src/tests/approval-respond-auth.test.ts +28 -0
  373. package/src/tests/apps-action-parent-task.test.ts +140 -0
  374. package/src/tests/apps-catalog-additions.test.ts +315 -0
  375. package/src/tests/apps-catalog-files.test.ts +114 -0
  376. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  377. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  378. package/src/tests/apps-catalog-page-frame.test.ts +49 -0
  379. package/src/tests/apps-catalog-table.test.ts +47 -0
  380. package/src/tests/apps-chart-shell.test.ts +1 -1
  381. package/src/tests/apps-element-assembly.test.ts +52 -3
  382. package/src/tests/apps-session-thread.test.ts +261 -0
  383. package/src/tests/asset-key-invariants.test.ts +14 -0
  384. package/src/tests/base-prompt.test.ts +213 -23
  385. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  386. package/src/tests/caller-session-group.test.ts +199 -0
  387. package/src/tests/cards.test.ts +169 -0
  388. package/src/tests/chat-sdk-relay.test.ts +149 -1
  389. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  390. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  391. package/src/tests/chat-sdk-tools.test.ts +147 -0
  392. package/src/tests/checklist-nudge.test.ts +208 -0
  393. package/src/tests/checklist.test.ts +686 -0
  394. package/src/tests/claude-adapter-binary.test.ts +67 -6
  395. package/src/tests/claude-flag-settings.test.ts +29 -0
  396. package/src/tests/claude-sdk-lifecycle.test.ts +5 -0
  397. package/src/tests/codex-adapter.test.ts +340 -2
  398. package/src/tests/codex-app-server.test.ts +32 -0
  399. package/src/tests/codex-oauth.test.ts +3 -1
  400. package/src/tests/codex-rate-limits.test.ts +384 -0
  401. package/src/tests/comb-config-guard.test.ts +21 -0
  402. package/src/tests/comb-default.test.ts +59 -97
  403. package/src/tests/comb-links.test.ts +86 -16
  404. package/src/tests/comb-status.test.ts +24 -27
  405. package/src/tests/create-page-tool.test.ts +101 -1
  406. package/src/tests/create-schedule-key.test.ts +105 -0
  407. package/src/tests/credential-broker.test.ts +2 -2
  408. package/src/tests/credential-outcome-report.test.ts +20 -0
  409. package/src/tests/db-query.test.ts +87 -1
  410. package/src/tests/db-task-read-contract.test.ts +4 -0
  411. package/src/tests/db-task-write-contract.test.ts +6 -1
  412. package/src/tests/deferred-task-wake.test.ts +63 -1
  413. package/src/tests/docker-isolation-config-guard.test.ts +29 -0
  414. package/src/tests/docs-index-footprint.test.js +11 -3
  415. package/src/tests/e2e-visuals-comment.test.ts +82 -0
  416. package/src/tests/e2e-visuals-verify-pr.test.ts +138 -0
  417. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  418. package/src/tests/extensions-assets.test.ts +7 -3
  419. package/src/tests/extensions-catalog.test.ts +1 -0
  420. package/src/tests/extensions-example-sql-admin-only.test.ts +201 -0
  421. package/src/tests/extensions-pre-task.test.ts +3 -3
  422. package/src/tests/extensions-steering.test.ts +14 -2
  423. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  424. package/src/tests/fetch-resolved-env.test.ts +68 -0
  425. package/src/tests/fixtures/import-package.ts +32 -0
  426. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  427. package/src/tests/fixtures/ui-spec-slack/deploys.json +121 -0
  428. package/src/tests/fixtures/ui-spec-slack/incident.json +183 -0
  429. package/src/tests/fixtures/ui-spec-slack/three-charts-stale.json +196 -0
  430. package/src/tests/fixtures/ui-spec-slack/video-rejected-by-slack.json +183 -0
  431. package/src/tests/fixtures/ui-spec-slack/video.json +446 -0
  432. package/src/tests/fs-routes.test.ts +505 -2
  433. package/src/tests/github-ghes-mock.test.ts +196 -0
  434. package/src/tests/github-host.test.ts +285 -0
  435. package/src/tests/gitleaks-download-retry.test.ts +85 -0
  436. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  437. package/src/tests/heartbeat.test.ts +56 -0
  438. package/src/tests/human-thread-routing.test.ts +187 -0
  439. package/src/tests/import-config.test.ts +209 -0
  440. package/src/tests/import.test.ts +464 -0
  441. package/src/tests/invites-http.test.ts +144 -1
  442. package/src/tests/jira-outbound-sync.test.ts +33 -1
  443. package/src/tests/key-window-usage.test.ts +831 -0
  444. package/src/tests/kv-http.test.ts +11 -0
  445. package/src/tests/linear-outbound-sync.test.ts +30 -1
  446. package/src/tests/literal-matcher.test.ts +58 -0
  447. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  448. package/src/tests/oauth-presets.test.ts +12 -0
  449. package/src/tests/pi-mono-adapter.test.ts +79 -0
  450. package/src/tests/pool-affinity.test.ts +50 -0
  451. package/src/tests/preload-env.test.ts +2 -0
  452. package/src/tests/preload.ts +3 -1
  453. package/src/tests/prompt-template-session.test.ts +53 -5
  454. package/src/tests/provider-quota-persistence.test.ts +362 -0
  455. package/src/tests/provider-registration.test.ts +2 -55
  456. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  457. package/src/tests/rate-limit-event.test.ts +22 -0
  458. package/src/tests/rbac-admission.test.ts +19 -0
  459. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  460. package/src/tests/rbac-engine.test.ts +2 -0
  461. package/src/tests/rbac-roles.test.ts +2 -0
  462. package/src/tests/reasoning-events.test.ts +164 -0
  463. package/src/tests/routing-affinity-inventory.test.ts +22 -0
  464. package/src/tests/runner-missing-dependency.test.ts +61 -0
  465. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  466. package/src/tests/runtime-pool-routing.test.ts +52 -0
  467. package/src/tests/runtime-providers-docker.test.ts +91 -0
  468. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  469. package/src/tests/savings-fleet-slices.test.ts +122 -0
  470. package/src/tests/savings-read.test.ts +41 -0
  471. package/src/tests/savings-scripts.test.ts +9 -3
  472. package/src/tests/script-connections.test.ts +7 -0
  473. package/src/tests/script-executor-conformance.test.ts +41 -4
  474. package/src/tests/secret-canary-sweep.test.ts +41 -5
  475. package/src/tests/secret-scrub-gate.test.ts +257 -0
  476. package/src/tests/seed-registry.test.ts +142 -9
  477. package/src/tests/seed-scripts.test.ts +23 -0
  478. package/src/tests/session-cost-attribution.test.ts +748 -0
  479. package/src/tests/session-costs.test.ts +14 -15
  480. package/src/tests/session-logs.test.ts +83 -0
  481. package/src/tests/session-source-keys.test.ts +42 -1
  482. package/src/tests/sessions-detail-batch.test.ts +7 -0
  483. package/src/tests/sessions-move.test.ts +70 -0
  484. package/src/tests/sessions-tree.test.ts +98 -0
  485. package/src/tests/sessions.test.ts +69 -0
  486. package/src/tests/slack-config.test.ts +4 -18
  487. package/src/tests/slack-http-receiver.test.ts +472 -0
  488. package/src/tests/slack-inbound-logging.test.ts +64 -0
  489. package/src/tests/slack-leave-thread.test.ts +1 -1
  490. package/src/tests/slack-message-text.test.ts +104 -0
  491. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  492. package/src/tests/slack-render-v2.test.ts +405 -0
  493. package/src/tests/slack-skip-reaction.test.ts +2 -2
  494. package/src/tests/slack-start-reload-race.test.ts +67 -0
  495. package/src/tests/slack-steering.test.ts +22 -10
  496. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  497. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  498. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  499. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  500. package/src/tests/slack-thread-buffer.test.ts +34 -34
  501. package/src/tests/slack-thread-participants.test.ts +23 -5
  502. package/src/tests/slack-tool-blocks.test.ts +167 -0
  503. package/src/tests/status.test.ts +32 -6
  504. package/src/tests/steering-core.test.ts +13 -0
  505. package/src/tests/steering-enabled.test.ts +7 -1
  506. package/src/tests/steering-promotion.test.ts +24 -0
  507. package/src/tests/subscription-plans.test.ts +20 -1
  508. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  509. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  510. package/src/tests/task-artifacts.test.ts +50 -0
  511. package/src/tests/task-session-prompts.test.ts +95 -1
  512. package/src/tests/task-ui-action-route.test.ts +191 -0
  513. package/src/tests/task-ui-actions.test.ts +195 -0
  514. package/src/tests/task-ui-spec-fallback.test.ts +65 -0
  515. package/src/tests/task-ui-spec.test.ts +368 -0
  516. package/src/tests/workflow-agent-task-retry.test.ts +34 -1
  517. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  518. package/src/tools/chat-post.ts +19 -4
  519. package/src/tools/chat-reply.ts +20 -4
  520. package/src/tools/create-page.ts +21 -4
  521. package/src/tools/defer-task.ts +1 -1
  522. package/src/tools/get-swarm.ts +18 -2
  523. package/src/tools/join-swarm.ts +2 -1
  524. package/src/tools/kv/kv-write-auth.ts +17 -1
  525. package/src/tools/schedules/create-schedule.ts +22 -4
  526. package/src/tools/slack-post.ts +40 -7
  527. package/src/tools/slack-reply.ts +50 -14
  528. package/src/tools/store-progress.ts +69 -3
  529. package/src/types.ts +50 -4
  530. package/src/ui-spec/actions.ts +86 -0
  531. package/src/ui-spec/fallback.ts +19 -0
  532. package/src/ui-spec/slack.ts +17 -0
  533. package/src/ui-spec/validate.ts +169 -0
  534. package/src/utils/codex-rate-limits.ts +159 -0
  535. package/src/utils/constants.ts +60 -138
  536. package/src/utils/credentials.ts +2 -0
  537. package/src/utils/error-tracker.ts +19 -0
  538. package/src/utils/github-host.ts +217 -0
  539. package/src/utils/github-pull-request.ts +8 -5
  540. package/src/utils/literal-matcher.ts +118 -0
  541. package/src/utils/provider-account-telemetry.ts +331 -0
  542. package/src/utils/reasoning-events.ts +107 -0
  543. package/src/utils/secret-scrubber.ts +331 -25
  544. package/src/utils/subscription-plans.ts +11 -59
  545. package/src/utils/task-attachment-links.ts +9 -12
  546. package/src/utils/task-ui-spec.ts +67 -0
  547. package/src/vcs/index.ts +3 -0
  548. package/src/workflows/approval-notifications.ts +188 -12
  549. package/src/workflows/executors/system-one-extraction.ts +14 -7
  550. package/src/workflows/executors/system-one-providers.ts +22 -1
  551. package/src/workflows/task-step-routing.ts +8 -3
  552. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  553. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  554. package/templates/extensions/README.md +1 -0
  555. package/templates/extensions/sql-admin-only/README.md +20 -0
  556. package/templates/extensions/sql-admin-only/hooks.ts +100 -0
  557. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  558. package/templates/import/manifest.schema.json +136 -0
  559. package/templates/import/sources.schema.json +44 -0
  560. package/templates/skills/agent-browser/SKILL.md +1 -1
  561. package/templates/skills/agent-browser/content.md +1 -1
  562. package/templates/skills/apps/SKILL.md +151 -14
  563. package/templates/skills/apps/content.md +151 -14
  564. package/templates/skills/asset-namespaces/content.md +2 -1
  565. package/templates/skills/chat-sdk/content.md +17 -0
  566. package/templates/skills/db-query-guidance/content.md +2 -1
  567. package/templates/skills/scheduling/content.md +27 -0
  568. package/templates/skills/slack-interaction/content.md +12 -2
  569. package/templates/skills/swarm-docs/content.md +1 -0
  570. package/templates/skills/swarm-extensions/config.json +1 -1
  571. package/templates/skills/swarm-extensions/content.md +33 -23
  572. package/templates/skills/swarm-scripts/SKILL.md +13 -0
  573. package/templates/skills/swarm-scripts/content.md +13 -0
  574. package/templates/skills/ui-spec/config.json +14 -0
  575. package/templates/skills/ui-spec/content.md +127 -0
  576. package/templates/skills/work-on-task/SKILL.md +1 -1
  577. package/templates/skills/work-on-task/content.md +1 -1
  578. package/templates/skills/workflow-iterate/content.md +4 -7
  579. package/templates/workflows/dreaming/content.md +2 -2
  580. package/dist/acp-adapter-xq6s2z6t.js +0 -14
  581. package/dist/claude-adapter-r33pqnzx.js +0 -24
  582. package/dist/cli-dns0y538.js +0 -194
  583. package/dist/cli-m2z8jagn.js +0 -12078
  584. package/dist/fx-adapter-1rnxnf56.js +0 -17
  585. package/dist/grok-adapter-efhmf1r8.js +0 -17
  586. package/dist/handlers-anrr3py9.js +0 -32
  587. package/dist/index-2skqtd76.js +0 -12795
  588. package/dist/index-8w2aznds.js +0 -33
  589. package/dist/index-qnjvr362.js +0 -37
  590. package/dist/index-yzxd3sn9.js +0 -32
  591. package/dist/lead-zhxqbfdv.js +0 -69
  592. package/dist/worker-7j2907g6.js +0 -69
  593. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  594. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  595. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  596. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  597. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
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.8.3",
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": [
@@ -2494,7 +2494,8 @@
2494
2494
  "page",
2495
2495
  "workflow",
2496
2496
  "schedule",
2497
- "agent-fs-path"
2497
+ "agent-fs-path",
2498
+ "key"
2498
2499
  ]
2499
2500
  },
2500
2501
  "itemId": {
@@ -2521,6 +2522,139 @@
2521
2522
  "lastUpdatedAt"
2522
2523
  ]
2523
2524
  },
2525
+ "ChecklistItem": {
2526
+ "type": "object",
2527
+ "properties": {
2528
+ "id": {
2529
+ "type": "string"
2530
+ },
2531
+ "scope": {
2532
+ "type": "string",
2533
+ "enum": [
2534
+ "swarm",
2535
+ "user"
2536
+ ]
2537
+ },
2538
+ "userId": {
2539
+ "type": [
2540
+ "string",
2541
+ "null"
2542
+ ]
2543
+ },
2544
+ "kind": {
2545
+ "type": "string",
2546
+ "enum": [
2547
+ "channel",
2548
+ "tool",
2549
+ "use_case",
2550
+ "custom"
2551
+ ]
2552
+ },
2553
+ "label": {
2554
+ "type": "string"
2555
+ },
2556
+ "href": {
2557
+ "type": [
2558
+ "string",
2559
+ "null"
2560
+ ]
2561
+ },
2562
+ "meta": {
2563
+ "type": [
2564
+ "object",
2565
+ "null"
2566
+ ],
2567
+ "additionalProperties": {}
2568
+ },
2569
+ "sortOrder": {
2570
+ "type": "number"
2571
+ },
2572
+ "status": {
2573
+ "type": "string",
2574
+ "enum": [
2575
+ "open",
2576
+ "done",
2577
+ "removed"
2578
+ ]
2579
+ },
2580
+ "statusChangedAt": {
2581
+ "type": [
2582
+ "string",
2583
+ "null"
2584
+ ]
2585
+ },
2586
+ "statusChangedBy": {
2587
+ "type": [
2588
+ "string",
2589
+ "null"
2590
+ ]
2591
+ },
2592
+ "statusChangedByName": {
2593
+ "type": [
2594
+ "string",
2595
+ "null"
2596
+ ]
2597
+ },
2598
+ "statusReason": {
2599
+ "type": [
2600
+ "string",
2601
+ "null"
2602
+ ]
2603
+ },
2604
+ "nudgedAt": {
2605
+ "type": [
2606
+ "string",
2607
+ "null"
2608
+ ]
2609
+ },
2610
+ "nudgedTaskId": {
2611
+ "type": [
2612
+ "string",
2613
+ "null"
2614
+ ]
2615
+ },
2616
+ "signal": {
2617
+ "type": [
2618
+ "boolean",
2619
+ "null"
2620
+ ]
2621
+ },
2622
+ "done": {
2623
+ "type": "boolean"
2624
+ },
2625
+ "editable": {
2626
+ "type": "boolean"
2627
+ },
2628
+ "createdAt": {
2629
+ "type": "string"
2630
+ },
2631
+ "lastUpdatedAt": {
2632
+ "type": "string"
2633
+ }
2634
+ },
2635
+ "required": [
2636
+ "id",
2637
+ "scope",
2638
+ "userId",
2639
+ "kind",
2640
+ "label",
2641
+ "href",
2642
+ "meta",
2643
+ "sortOrder",
2644
+ "status",
2645
+ "statusChangedAt",
2646
+ "statusChangedBy",
2647
+ "statusChangedByName",
2648
+ "statusReason",
2649
+ "nudgedAt",
2650
+ "nudgedTaskId",
2651
+ "signal",
2652
+ "done",
2653
+ "editable",
2654
+ "createdAt",
2655
+ "lastUpdatedAt"
2656
+ ]
2657
+ },
2524
2658
  "TaskAttachment": {
2525
2659
  "type": "object",
2526
2660
  "properties": {
@@ -3313,7 +3447,8 @@
3313
3447
  "script",
3314
3448
  "slack",
3315
3449
  "api",
3316
- "chat"
3450
+ "chat",
3451
+ "app-page"
3317
3452
  ]
3318
3453
  },
3319
3454
  "senderLabel": {
@@ -3395,6 +3530,7 @@
3395
3530
  "task_follow_up_suppressed",
3396
3531
  "task_follow_up_gate_shadow",
3397
3532
  "task_citation_check_refused",
3533
+ "task_ui_spec_check_refused",
3398
3534
  "channel_message",
3399
3535
  "service_registered",
3400
3536
  "service_unregistered",
@@ -4211,6 +4347,39 @@
4211
4347
  "agentId": {
4212
4348
  "type": "string"
4213
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
+ },
4214
4383
  "totalCostUsd": {
4215
4384
  "type": "number",
4216
4385
  "minimum": 0
@@ -4226,14 +4395,20 @@
4226
4395
  "default": 0
4227
4396
  },
4228
4397
  "cacheReadTokens": {
4229
- "type": "integer",
4398
+ "type": [
4399
+ "integer",
4400
+ "null"
4401
+ ],
4230
4402
  "minimum": 0,
4231
- "default": 0
4403
+ "default": null
4232
4404
  },
4233
4405
  "cacheWriteTokens": {
4234
- "type": "integer",
4406
+ "type": [
4407
+ "integer",
4408
+ "null"
4409
+ ],
4235
4410
  "minimum": 0,
4236
- "default": 0
4411
+ "default": null
4237
4412
  },
4238
4413
  "reasoningOutputTokens": {
4239
4414
  "type": "integer",
@@ -10420,6 +10595,32 @@
10420
10595
  "parentTaskId": {
10421
10596
  "type": "string",
10422
10597
  "minLength": 1
10598
+ },
10599
+ "followUp": {
10600
+ "type": "boolean"
10601
+ },
10602
+ "requestedByUserId": {
10603
+ "type": "string",
10604
+ "minLength": 1
10605
+ },
10606
+ "session": {
10607
+ "type": "object",
10608
+ "properties": {
10609
+ "key": {
10610
+ "type": "string",
10611
+ "pattern": "^[A-Za-z0-9_-]{1,128}$"
10612
+ },
10613
+ "scope": {
10614
+ "type": "string",
10615
+ "enum": [
10616
+ "user",
10617
+ "shared"
10618
+ ]
10619
+ }
10620
+ },
10621
+ "required": [
10622
+ "key"
10623
+ ]
10423
10624
  }
10424
10625
  }
10425
10626
  }
@@ -11300,6 +11501,9 @@
11300
11501
  "cli",
11301
11502
  "sdk"
11302
11503
  ]
11504
+ },
11505
+ "onDemand": {
11506
+ "type": "boolean"
11303
11507
  }
11304
11508
  },
11305
11509
  "required": [
@@ -12589,6 +12793,9 @@
12589
12793
  "cli",
12590
12794
  "sdk"
12591
12795
  ]
12796
+ },
12797
+ "onDemand": {
12798
+ "type": "boolean"
12592
12799
  }
12593
12800
  },
12594
12801
  "required": [
@@ -14802,7 +15009,7 @@
14802
15009
  },
14803
15010
  "get": {
14804
15011
  "summary": "List approval requests with optional filters",
14805
- "description": "Returns full approval requests by default. Pass `fields=slim` for the list-view shape: `questions`, `approvers`, `responses`, `resolutionReason` and `notificationChannels` are dropped and `questionCount` is added. Fetch one request in full via `GET /api/approval-requests/{id}`.",
15012
+ "description": "Returns full approval requests by default. Pass `fields=slim` for the list-view shape: `questions`, `approvers`, `responses`, `resolutionReason` and `notificationChannels` are dropped and `questionCount` is added, plus `viewerCanRespond` on pending rows. Fetch one request in full via `GET /api/approval-requests/{id}`.",
14806
15013
  "tags": [
14807
15014
  "ApprovalRequests"
14808
15015
  ],
@@ -15371,6 +15578,10 @@
15371
15578
  },
15372
15579
  "questionCount": {
15373
15580
  "type": "integer"
15581
+ },
15582
+ "viewerCanRespond": {
15583
+ "type": "boolean",
15584
+ "description": "Pending rows only: whether the caller may answer, by the same rule as the respond route (a listed user or role, or no users and roles listed)."
15374
15585
  }
15375
15586
  },
15376
15587
  "required": [
@@ -19560,111 +19771,17 @@
19560
19771
  "plan": {
19561
19772
  "type": "string",
19562
19773
  "maxLength": 40
19563
- }
19564
- },
19565
- "required": [
19566
- "keyType",
19567
- "keySuffix",
19568
- "keyIndex"
19569
- ]
19570
- }
19571
- }
19572
- }
19573
- },
19574
- "responses": {
19575
- "200": {
19576
- "description": "Usage recorded",
19577
- "content": {
19578
- "application/json": {
19579
- "schema": {
19580
- "type": "object",
19581
- "properties": {
19582
- "success": {
19583
- "type": "boolean",
19584
- "enum": [
19585
- true
19586
- ]
19587
- },
19588
- "message": {
19589
- "type": "string"
19590
- }
19591
- },
19592
- "required": [
19593
- "success",
19594
- "message"
19595
- ]
19596
- }
19597
- }
19598
- }
19599
- },
19600
- "400": {
19601
- "description": "Validation error",
19602
- "content": {
19603
- "application/json": {
19604
- "schema": {
19605
- "$ref": "#/components/schemas/ErrorResponse"
19606
- }
19607
- }
19608
- }
19609
- },
19610
- "401": {
19611
- "description": "Unauthorized",
19612
- "content": {
19613
- "application/json": {
19614
- "schema": {
19615
- "$ref": "#/components/schemas/ErrorResponse"
19616
- }
19617
- }
19618
- }
19619
- }
19620
- }
19621
- }
19622
- },
19623
- "/api/keys/report-rate-limit": {
19624
- "post": {
19625
- "summary": "Mark an API key as rate-limited",
19626
- "tags": [
19627
- "API Keys"
19628
- ],
19629
- "security": [
19630
- {
19631
- "bearerAuth": []
19632
- }
19633
- ],
19634
- "requestBody": {
19635
- "content": {
19636
- "application/json": {
19637
- "schema": {
19638
- "type": "object",
19639
- "properties": {
19640
- "keyType": {
19641
- "type": "string"
19642
19774
  },
19643
- "keySuffix": {
19775
+ "planRaw": {
19644
19776
  "type": "string",
19645
19777
  "minLength": 1,
19646
- "maxLength": 10
19647
- },
19648
- "keyIndex": {
19649
- "type": "integer",
19650
- "minimum": 0
19651
- },
19652
- "rateLimitedUntil": {
19653
- "type": "string",
19654
- "format": "date-time"
19655
- },
19656
- "scope": {
19657
- "type": "string"
19658
- },
19659
- "scopeId": {
19660
- "type": "string"
19778
+ "maxLength": 80
19661
19779
  }
19662
19780
  },
19663
19781
  "required": [
19664
19782
  "keyType",
19665
19783
  "keySuffix",
19666
- "keyIndex",
19667
- "rateLimitedUntil"
19784
+ "keyIndex"
19668
19785
  ]
19669
19786
  }
19670
19787
  }
@@ -19672,7 +19789,106 @@
19672
19789
  },
19673
19790
  "responses": {
19674
19791
  "200": {
19675
- "description": "Key marked as rate-limited",
19792
+ "description": "Usage recorded",
19793
+ "content": {
19794
+ "application/json": {
19795
+ "schema": {
19796
+ "type": "object",
19797
+ "properties": {
19798
+ "success": {
19799
+ "type": "boolean",
19800
+ "enum": [
19801
+ true
19802
+ ]
19803
+ },
19804
+ "message": {
19805
+ "type": "string"
19806
+ }
19807
+ },
19808
+ "required": [
19809
+ "success",
19810
+ "message"
19811
+ ]
19812
+ }
19813
+ }
19814
+ }
19815
+ },
19816
+ "400": {
19817
+ "description": "Validation error",
19818
+ "content": {
19819
+ "application/json": {
19820
+ "schema": {
19821
+ "$ref": "#/components/schemas/ErrorResponse"
19822
+ }
19823
+ }
19824
+ }
19825
+ },
19826
+ "401": {
19827
+ "description": "Unauthorized",
19828
+ "content": {
19829
+ "application/json": {
19830
+ "schema": {
19831
+ "$ref": "#/components/schemas/ErrorResponse"
19832
+ }
19833
+ }
19834
+ }
19835
+ }
19836
+ }
19837
+ }
19838
+ },
19839
+ "/api/keys/report-rate-limit": {
19840
+ "post": {
19841
+ "summary": "Mark an API key as rate-limited",
19842
+ "tags": [
19843
+ "API Keys"
19844
+ ],
19845
+ "security": [
19846
+ {
19847
+ "bearerAuth": []
19848
+ }
19849
+ ],
19850
+ "requestBody": {
19851
+ "content": {
19852
+ "application/json": {
19853
+ "schema": {
19854
+ "type": "object",
19855
+ "properties": {
19856
+ "keyType": {
19857
+ "type": "string"
19858
+ },
19859
+ "keySuffix": {
19860
+ "type": "string",
19861
+ "minLength": 1,
19862
+ "maxLength": 10
19863
+ },
19864
+ "keyIndex": {
19865
+ "type": "integer",
19866
+ "minimum": 0
19867
+ },
19868
+ "rateLimitedUntil": {
19869
+ "type": "string",
19870
+ "format": "date-time"
19871
+ },
19872
+ "scope": {
19873
+ "type": "string"
19874
+ },
19875
+ "scopeId": {
19876
+ "type": "string"
19877
+ }
19878
+ },
19879
+ "required": [
19880
+ "keyType",
19881
+ "keySuffix",
19882
+ "keyIndex",
19883
+ "rateLimitedUntil"
19884
+ ]
19885
+ }
19886
+ }
19887
+ }
19888
+ },
19889
+ "responses": {
19890
+ "200": {
19891
+ "description": "Key marked as rate-limited",
19676
19892
  "content": {
19677
19893
  "application/json": {
19678
19894
  "schema": {
@@ -19945,6 +20161,7 @@
19945
20161
  "/api/keys/report-rate-limit-windows": {
19946
20162
  "post": {
19947
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.",
19948
20165
  "tags": [
19949
20166
  "API Keys"
19950
20167
  ],
@@ -19977,7 +20194,8 @@
19977
20194
  "type": "object",
19978
20195
  "properties": {
19979
20196
  "status": {
19980
- "type": "string"
20197
+ "type": "string",
20198
+ "maxLength": 256
19981
20199
  },
19982
20200
  "utilization": {
19983
20201
  "type": "number"
@@ -19985,6 +20203,60 @@
19985
20203
  "resetsAt": {
19986
20204
  "type": "number"
19987
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
+ },
19988
20260
  "isUsingOverage": {
19989
20261
  "type": "boolean"
19990
20262
  },
@@ -20002,6 +20274,252 @@
20002
20274
  ]
20003
20275
  }
20004
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
+ },
20005
20523
  "scope": {
20006
20524
  "type": "string"
20007
20525
  },
@@ -20064,6 +20582,16 @@
20064
20582
  }
20065
20583
  }
20066
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
+ }
20067
20595
  }
20068
20596
  }
20069
20597
  }
@@ -20443,7 +20971,8 @@
20443
20971
  "type": "object",
20444
20972
  "properties": {
20445
20973
  "status": {
20446
- "type": "string"
20974
+ "type": "string",
20975
+ "maxLength": 256
20447
20976
  },
20448
20977
  "utilization": {
20449
20978
  "type": "number"
@@ -20451,6 +20980,60 @@
20451
20980
  "resetsAt": {
20452
20981
  "type": "number"
20453
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
+ },
20454
21037
  "isUsingOverage": {
20455
21038
  "type": "boolean"
20456
21039
  },
@@ -20468,6 +21051,212 @@
20468
21051
  ]
20469
21052
  }
20470
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
+ },
20471
21260
  "plan": {
20472
21261
  "type": [
20473
21262
  "string",
@@ -20486,6 +21275,12 @@
20486
21275
  null
20487
21276
  ]
20488
21277
  },
21278
+ "detectedPlanRaw": {
21279
+ "type": [
21280
+ "string",
21281
+ "null"
21282
+ ]
21283
+ },
20489
21284
  "lastSeatMismatchAt": {
20490
21285
  "type": [
20491
21286
  "string",
@@ -20572,8 +21367,10 @@
20572
21367
  "name",
20573
21368
  "provider",
20574
21369
  "rateLimitWindows",
21370
+ "providerAccount",
20575
21371
  "plan",
20576
21372
  "planSource",
21373
+ "detectedPlanRaw",
20577
21374
  "lastSeatMismatchAt",
20578
21375
  "lastSeatMismatchModel",
20579
21376
  "consecutiveAuthFailures",
@@ -20608,6 +21405,419 @@
20608
21405
  }
20609
21406
  }
20610
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
+ },
20611
21821
  "/api/keys/costs": {
20612
21822
  "get": {
20613
21823
  "summary": "Get aggregated cost data per API key",
@@ -22749,7 +23959,8 @@
22749
23959
  "page",
22750
23960
  "workflow",
22751
23961
  "schedule",
22752
- "agent-fs-path"
23962
+ "agent-fs-path",
23963
+ "key"
22753
23964
  ]
22754
23965
  },
22755
23966
  "required": false,
@@ -22828,7 +24039,8 @@
22828
24039
  "page",
22829
24040
  "workflow",
22830
24041
  "schedule",
22831
- "agent-fs-path"
24042
+ "agent-fs-path",
24043
+ "key"
22832
24044
  ]
22833
24045
  },
22834
24046
  "itemId": {
@@ -22865,7 +24077,8 @@
22865
24077
  "page",
22866
24078
  "workflow",
22867
24079
  "schedule",
22868
- "agent-fs-path"
24080
+ "agent-fs-path",
24081
+ "key"
22869
24082
  ]
22870
24083
  },
22871
24084
  "itemId": {
@@ -22892,6 +24105,16 @@
22892
24105
  }
22893
24106
  }
22894
24107
  },
24108
+ "400": {
24109
+ "description": "Invalid asset key for a key favorite",
24110
+ "content": {
24111
+ "application/json": {
24112
+ "schema": {
24113
+ "$ref": "#/components/schemas/ErrorResponse"
24114
+ }
24115
+ }
24116
+ }
24117
+ },
22895
24118
  "401": {
22896
24119
  "description": "No authenticated principal context",
22897
24120
  "content": {
@@ -22905,6 +24128,657 @@
22905
24128
  }
22906
24129
  }
22907
24130
  },
24131
+ "/api/checklist": {
24132
+ "get": {
24133
+ "summary": "Read the post-onboarding checklist",
24134
+ "tags": [
24135
+ "Checklist"
24136
+ ],
24137
+ "security": [
24138
+ {
24139
+ "bearerAuth": []
24140
+ }
24141
+ ],
24142
+ "responses": {
24143
+ "200": {
24144
+ "description": "Checklist items and swarm edit permission",
24145
+ "content": {
24146
+ "application/json": {
24147
+ "schema": {
24148
+ "type": "object",
24149
+ "properties": {
24150
+ "items": {
24151
+ "type": "array",
24152
+ "items": {
24153
+ "$ref": "#/components/schemas/ChecklistItem"
24154
+ }
24155
+ },
24156
+ "canEditSwarm": {
24157
+ "type": "boolean"
24158
+ }
24159
+ },
24160
+ "required": [
24161
+ "items",
24162
+ "canEditSwarm"
24163
+ ]
24164
+ }
24165
+ }
24166
+ }
24167
+ }
24168
+ }
24169
+ }
24170
+ },
24171
+ "/api/checklist/items": {
24172
+ "post": {
24173
+ "summary": "Add a checklist item",
24174
+ "tags": [
24175
+ "Checklist"
24176
+ ],
24177
+ "security": [
24178
+ {
24179
+ "bearerAuth": []
24180
+ }
24181
+ ],
24182
+ "requestBody": {
24183
+ "content": {
24184
+ "application/json": {
24185
+ "schema": {
24186
+ "type": "object",
24187
+ "properties": {
24188
+ "kind": {
24189
+ "type": "string",
24190
+ "enum": [
24191
+ "channel",
24192
+ "tool",
24193
+ "use_case",
24194
+ "custom"
24195
+ ]
24196
+ },
24197
+ "label": {
24198
+ "type": "string",
24199
+ "minLength": 1,
24200
+ "maxLength": 200
24201
+ },
24202
+ "href": {
24203
+ "type": "string",
24204
+ "maxLength": 500,
24205
+ "pattern": "^\\/(?!\\/)"
24206
+ },
24207
+ "scope": {
24208
+ "type": "string",
24209
+ "enum": [
24210
+ "swarm",
24211
+ "user"
24212
+ ]
24213
+ },
24214
+ "meta": {
24215
+ "type": "object",
24216
+ "properties": {
24217
+ "adapter": {
24218
+ "type": "string",
24219
+ "minLength": 1,
24220
+ "maxLength": 64
24221
+ }
24222
+ },
24223
+ "additionalProperties": {}
24224
+ }
24225
+ },
24226
+ "required": [
24227
+ "kind",
24228
+ "label",
24229
+ "scope"
24230
+ ]
24231
+ }
24232
+ }
24233
+ }
24234
+ },
24235
+ "responses": {
24236
+ "201": {
24237
+ "description": "Added checklist item",
24238
+ "content": {
24239
+ "application/json": {
24240
+ "schema": {
24241
+ "type": "object",
24242
+ "properties": {
24243
+ "item": {
24244
+ "$ref": "#/components/schemas/ChecklistItem"
24245
+ }
24246
+ },
24247
+ "required": [
24248
+ "item"
24249
+ ]
24250
+ }
24251
+ }
24252
+ }
24253
+ },
24254
+ "400": {
24255
+ "description": "A user is required for user items",
24256
+ "content": {
24257
+ "application/json": {
24258
+ "schema": {
24259
+ "$ref": "#/components/schemas/ErrorResponse"
24260
+ }
24261
+ }
24262
+ }
24263
+ },
24264
+ "403": {
24265
+ "description": "The caller cannot edit swarm items",
24266
+ "content": {
24267
+ "application/json": {
24268
+ "schema": {
24269
+ "$ref": "#/components/schemas/ErrorResponse"
24270
+ }
24271
+ }
24272
+ }
24273
+ },
24274
+ "409": {
24275
+ "description": "An open channel item for the same adapter already exists",
24276
+ "content": {
24277
+ "application/json": {
24278
+ "schema": {
24279
+ "$ref": "#/components/schemas/ErrorResponse"
24280
+ }
24281
+ }
24282
+ }
24283
+ }
24284
+ }
24285
+ }
24286
+ },
24287
+ "/api/checklist/items/{id}": {
24288
+ "patch": {
24289
+ "summary": "Update a checklist item",
24290
+ "tags": [
24291
+ "Checklist"
24292
+ ],
24293
+ "security": [
24294
+ {
24295
+ "bearerAuth": []
24296
+ }
24297
+ ],
24298
+ "parameters": [
24299
+ {
24300
+ "schema": {
24301
+ "type": "string"
24302
+ },
24303
+ "required": true,
24304
+ "name": "id",
24305
+ "in": "path"
24306
+ }
24307
+ ],
24308
+ "requestBody": {
24309
+ "content": {
24310
+ "application/json": {
24311
+ "schema": {
24312
+ "type": "object",
24313
+ "properties": {
24314
+ "action": {
24315
+ "type": "string",
24316
+ "enum": [
24317
+ "remove",
24318
+ "restore",
24319
+ "done",
24320
+ "reorder"
24321
+ ]
24322
+ },
24323
+ "reason": {
24324
+ "type": "string",
24325
+ "maxLength": 500
24326
+ },
24327
+ "sortOrder": {
24328
+ "type": "integer"
24329
+ }
24330
+ },
24331
+ "required": [
24332
+ "action"
24333
+ ]
24334
+ }
24335
+ }
24336
+ }
24337
+ },
24338
+ "responses": {
24339
+ "200": {
24340
+ "description": "Updated checklist item",
24341
+ "content": {
24342
+ "application/json": {
24343
+ "schema": {
24344
+ "type": "object",
24345
+ "properties": {
24346
+ "item": {
24347
+ "$ref": "#/components/schemas/ChecklistItem"
24348
+ }
24349
+ },
24350
+ "required": [
24351
+ "item"
24352
+ ]
24353
+ }
24354
+ }
24355
+ }
24356
+ },
24357
+ "400": {
24358
+ "description": "Invalid update",
24359
+ "content": {
24360
+ "application/json": {
24361
+ "schema": {
24362
+ "$ref": "#/components/schemas/ErrorResponse"
24363
+ }
24364
+ }
24365
+ }
24366
+ },
24367
+ "403": {
24368
+ "description": "The caller cannot edit this item",
24369
+ "content": {
24370
+ "application/json": {
24371
+ "schema": {
24372
+ "$ref": "#/components/schemas/ErrorResponse"
24373
+ }
24374
+ }
24375
+ }
24376
+ },
24377
+ "404": {
24378
+ "description": "Checklist item not found",
24379
+ "content": {
24380
+ "application/json": {
24381
+ "schema": {
24382
+ "$ref": "#/components/schemas/ErrorResponse"
24383
+ }
24384
+ }
24385
+ }
24386
+ }
24387
+ }
24388
+ }
24389
+ },
24390
+ "/api/fs/me": {
24391
+ "get": {
24392
+ "summary": "Ensure the current user's agent-fs account and shared membership",
24393
+ "tags": [
24394
+ "FS"
24395
+ ],
24396
+ "security": [
24397
+ {
24398
+ "bearerAuth": []
24399
+ }
24400
+ ],
24401
+ "responses": {
24402
+ "200": {
24403
+ "description": "Account readiness",
24404
+ "content": {
24405
+ "application/json": {
24406
+ "schema": {
24407
+ "type": "object",
24408
+ "properties": {
24409
+ "status": {
24410
+ "type": "string",
24411
+ "enum": [
24412
+ "ready",
24413
+ "pending",
24414
+ "off",
24415
+ "unsupported"
24416
+ ],
24417
+ "description": "Account readiness in agent-fs."
24418
+ },
24419
+ "agentFsUserId": {
24420
+ "type": "string",
24421
+ "description": "User ID in agent-fs when ready."
24422
+ },
24423
+ "email": {
24424
+ "type": "string",
24425
+ "description": "Email of the swarm user, when available."
24426
+ },
24427
+ "displayName": {
24428
+ "type": "string",
24429
+ "description": "Name of the swarm user when ready."
24430
+ },
24431
+ "orgId": {
24432
+ "type": "string",
24433
+ "description": "Shared agent-fs org ID when configured."
24434
+ },
24435
+ "driveId": {
24436
+ "type": "string",
24437
+ "description": "Shared agent-fs drive ID when configured."
24438
+ },
24439
+ "reason": {
24440
+ "type": "string",
24441
+ "description": "Reason the account is not ready."
24442
+ }
24443
+ },
24444
+ "required": [
24445
+ "status"
24446
+ ]
24447
+ }
24448
+ }
24449
+ }
24450
+ },
24451
+ "401": {
24452
+ "description": "User identity required",
24453
+ "content": {
24454
+ "application/json": {
24455
+ "schema": {
24456
+ "$ref": "#/components/schemas/ErrorResponse"
24457
+ }
24458
+ }
24459
+ }
24460
+ },
24461
+ "403": {
24462
+ "description": "Caller cannot join the shared org",
24463
+ "content": {
24464
+ "application/json": {
24465
+ "schema": {
24466
+ "$ref": "#/components/schemas/ErrorResponse"
24467
+ }
24468
+ }
24469
+ }
24470
+ },
24471
+ "429": {
24472
+ "description": "Limit of twenty account checks per minute reached",
24473
+ "content": {
24474
+ "application/json": {
24475
+ "schema": {
24476
+ "$ref": "#/components/schemas/ErrorResponse"
24477
+ }
24478
+ }
24479
+ }
24480
+ },
24481
+ "502": {
24482
+ "description": "agent-fs request failed",
24483
+ "content": {
24484
+ "application/json": {
24485
+ "schema": {
24486
+ "$ref": "#/components/schemas/ErrorResponse"
24487
+ }
24488
+ }
24489
+ }
24490
+ }
24491
+ }
24492
+ }
24493
+ },
24494
+ "/api/fs/keys": {
24495
+ "post": {
24496
+ "summary": "Mint a named agent-fs key for the current user",
24497
+ "description": "The key is scoped to the shared org. The API returns it once and never stores it.",
24498
+ "tags": [
24499
+ "FS"
24500
+ ],
24501
+ "security": [
24502
+ {
24503
+ "bearerAuth": []
24504
+ }
24505
+ ],
24506
+ "requestBody": {
24507
+ "content": {
24508
+ "application/json": {
24509
+ "schema": {
24510
+ "type": "object",
24511
+ "properties": {
24512
+ "label": {
24513
+ "type": "string",
24514
+ "minLength": 1,
24515
+ "maxLength": 100
24516
+ }
24517
+ },
24518
+ "required": [
24519
+ "label"
24520
+ ]
24521
+ }
24522
+ }
24523
+ }
24524
+ },
24525
+ "responses": {
24526
+ "201": {
24527
+ "description": "Named key returned once and never stored",
24528
+ "content": {
24529
+ "application/json": {
24530
+ "schema": {
24531
+ "type": "object",
24532
+ "properties": {
24533
+ "apiKey": {
24534
+ "type": "string",
24535
+ "description": "Plaintext key returned once. The API never stores this key."
24536
+ },
24537
+ "keyId": {
24538
+ "type": "string"
24539
+ },
24540
+ "label": {
24541
+ "type": "string"
24542
+ },
24543
+ "agentFsUserId": {
24544
+ "type": "string"
24545
+ },
24546
+ "orgId": {
24547
+ "type": "string"
24548
+ },
24549
+ "driveId": {
24550
+ "type": "string"
24551
+ }
24552
+ },
24553
+ "required": [
24554
+ "apiKey",
24555
+ "keyId",
24556
+ "label",
24557
+ "agentFsUserId",
24558
+ "orgId",
24559
+ "driveId"
24560
+ ]
24561
+ }
24562
+ }
24563
+ }
24564
+ },
24565
+ "400": {
24566
+ "description": "Invalid key label",
24567
+ "content": {
24568
+ "application/json": {
24569
+ "schema": {
24570
+ "$ref": "#/components/schemas/ErrorResponse"
24571
+ }
24572
+ }
24573
+ }
24574
+ },
24575
+ "401": {
24576
+ "description": "User identity required",
24577
+ "content": {
24578
+ "application/json": {
24579
+ "schema": {
24580
+ "$ref": "#/components/schemas/ErrorResponse"
24581
+ }
24582
+ }
24583
+ }
24584
+ },
24585
+ "403": {
24586
+ "description": "Caller cannot join the shared org",
24587
+ "content": {
24588
+ "application/json": {
24589
+ "schema": {
24590
+ "$ref": "#/components/schemas/ErrorResponse"
24591
+ }
24592
+ }
24593
+ }
24594
+ },
24595
+ "409": {
24596
+ "description": "agent-fs account or membership is pending",
24597
+ "content": {
24598
+ "application/json": {
24599
+ "schema": {
24600
+ "$ref": "#/components/schemas/ErrorResponse"
24601
+ }
24602
+ }
24603
+ }
24604
+ },
24605
+ "429": {
24606
+ "description": "Limit of five keys per minute reached",
24607
+ "content": {
24608
+ "application/json": {
24609
+ "schema": {
24610
+ "$ref": "#/components/schemas/ErrorResponse"
24611
+ }
24612
+ }
24613
+ }
24614
+ },
24615
+ "501": {
24616
+ "description": "agent_fs_too_old",
24617
+ "content": {
24618
+ "application/json": {
24619
+ "schema": {
24620
+ "$ref": "#/components/schemas/ErrorResponse"
24621
+ }
24622
+ }
24623
+ }
24624
+ },
24625
+ "502": {
24626
+ "description": "agent-fs request failed",
24627
+ "content": {
24628
+ "application/json": {
24629
+ "schema": {
24630
+ "$ref": "#/components/schemas/ErrorResponse"
24631
+ }
24632
+ }
24633
+ }
24634
+ },
24635
+ "503": {
24636
+ "description": "agent_fs_not_configured",
24637
+ "content": {
24638
+ "application/json": {
24639
+ "schema": {
24640
+ "$ref": "#/components/schemas/ErrorResponse"
24641
+ }
24642
+ }
24643
+ }
24644
+ }
24645
+ }
24646
+ }
24647
+ },
24648
+ "/api/fs/continue": {
24649
+ "post": {
24650
+ "summary": "Mint a named agent-fs key for the live agent-fs app and return the redirect URL",
24651
+ "description": "Powers 'Continue with your swarm' on the live agent-fs app. The key travels only in the URL fragment of `redirectUrl`. The API never stores it.",
24652
+ "tags": [
24653
+ "FS"
24654
+ ],
24655
+ "security": [
24656
+ {
24657
+ "bearerAuth": []
24658
+ }
24659
+ ],
24660
+ "requestBody": {
24661
+ "content": {
24662
+ "application/json": {
24663
+ "schema": {
24664
+ "type": "object",
24665
+ "properties": {
24666
+ "returnTo": {
24667
+ "type": "string",
24668
+ "maxLength": 4096,
24669
+ "format": "uri"
24670
+ }
24671
+ },
24672
+ "required": [
24673
+ "returnTo"
24674
+ ]
24675
+ }
24676
+ }
24677
+ }
24678
+ },
24679
+ "responses": {
24680
+ "200": {
24681
+ "description": "Redirect URL with the named key in the fragment",
24682
+ "content": {
24683
+ "application/json": {
24684
+ "schema": {
24685
+ "type": "object",
24686
+ "properties": {
24687
+ "redirectUrl": {
24688
+ "type": "string",
24689
+ "description": "`returnTo` with `#key=<af_...>&apiUrl=<browser-facing agent-fs API URL>` as its only fragment."
24690
+ }
24691
+ },
24692
+ "required": [
24693
+ "redirectUrl"
24694
+ ]
24695
+ }
24696
+ }
24697
+ }
24698
+ },
24699
+ "400": {
24700
+ "description": "invalid_return_to: the origin is not the live agent-fs app (AGENT_FS_LIVE_URL). org_mismatch: the `returnTo` path names an agent-fs org other than this swarm's shared org.",
24701
+ "content": {
24702
+ "application/json": {
24703
+ "schema": {
24704
+ "$ref": "#/components/schemas/ErrorResponse"
24705
+ }
24706
+ }
24707
+ }
24708
+ },
24709
+ "401": {
24710
+ "description": "User identity required",
24711
+ "content": {
24712
+ "application/json": {
24713
+ "schema": {
24714
+ "$ref": "#/components/schemas/ErrorResponse"
24715
+ }
24716
+ }
24717
+ }
24718
+ },
24719
+ "403": {
24720
+ "description": "Caller cannot join the shared org",
24721
+ "content": {
24722
+ "application/json": {
24723
+ "schema": {
24724
+ "$ref": "#/components/schemas/ErrorResponse"
24725
+ }
24726
+ }
24727
+ }
24728
+ },
24729
+ "409": {
24730
+ "description": "agent-fs account or membership is pending",
24731
+ "content": {
24732
+ "application/json": {
24733
+ "schema": {
24734
+ "$ref": "#/components/schemas/ErrorResponse"
24735
+ }
24736
+ }
24737
+ }
24738
+ },
24739
+ "429": {
24740
+ "description": "Limit of ten continues per minute reached",
24741
+ "content": {
24742
+ "application/json": {
24743
+ "schema": {
24744
+ "$ref": "#/components/schemas/ErrorResponse"
24745
+ }
24746
+ }
24747
+ }
24748
+ },
24749
+ "501": {
24750
+ "description": "agent_fs_too_old",
24751
+ "content": {
24752
+ "application/json": {
24753
+ "schema": {
24754
+ "$ref": "#/components/schemas/ErrorResponse"
24755
+ }
24756
+ }
24757
+ }
24758
+ },
24759
+ "502": {
24760
+ "description": "agent-fs request failed",
24761
+ "content": {
24762
+ "application/json": {
24763
+ "schema": {
24764
+ "$ref": "#/components/schemas/ErrorResponse"
24765
+ }
24766
+ }
24767
+ }
24768
+ },
24769
+ "503": {
24770
+ "description": "agent_fs_not_configured",
24771
+ "content": {
24772
+ "application/json": {
24773
+ "schema": {
24774
+ "$ref": "#/components/schemas/ErrorResponse"
24775
+ }
24776
+ }
24777
+ }
24778
+ }
24779
+ }
24780
+ }
24781
+ },
22908
24782
  "/api/fs/capabilities": {
22909
24783
  "get": {
22910
24784
  "summary": "Get active file-storage provider capabilities",
@@ -24303,6 +26177,9 @@
24303
26177
  "incomplete"
24304
26178
  ]
24305
26179
  },
26180
+ "connected": {
26181
+ "type": "boolean"
26182
+ },
24306
26183
  "error": {
24307
26184
  "type": "string"
24308
26185
  },
@@ -24360,6 +26237,7 @@
24360
26237
  "configured",
24361
26238
  "enabled",
24362
26239
  "health",
26240
+ "connected",
24363
26241
  "webhookUrl"
24364
26242
  ]
24365
26243
  }
@@ -31369,7 +33247,7 @@
31369
33247
  "/status": {
31370
33248
  "get": {
31371
33249
  "summary": "Identity + setup readiness + live activity for the swarm dashboard",
31372
- "description": "Single source of truth consumed by the UI home page. Identity comes from SWARM_* envs; setup milestones each emit `unverified | configured | verified`; automations report `running | needs_setup` from the same runtime preflight used at dispatch; activity counts agents alive in the last 5 min, leads that can take work (status idle or busy), and tasks created in the last 24h; agent_fs reports whether AGENT_FS_API_URL is set, plus the Comb settings (whether Files is on and, when off, what is missing; the browser-facing agent-fs URL, the shared org and drive ids, and the agent-fs user id of the swarm service account); telemetry reports the effective ANONYMIZED_TELEMETRY opt-out state.",
33250
+ "description": "Single source of truth consumed by the UI home page. Identity comes from SWARM_* envs; setup milestones each emit `unverified | configured | verified`; automations report `running | needs_setup` from the same runtime preflight used at dispatch; activity counts agents alive in the last 5 min, leads that can take work (status idle or busy), and tasks created in the last 24h; agent_fs reports whether AGENT_FS_API_URL is set, plus the Comb settings (whether Files is on and, when off, what is missing; the browser-facing agent-fs URL, the shared org and drive ids, and the agent-fs user id of the swarm service account); telemetry reports the effective ANONYMIZED_TELEMETRY opt-out state; github reports the GitHub web base (GITHUB_URL) for PR and repo links.",
31373
33251
  "tags": [
31374
33252
  "Status"
31375
33253
  ],
@@ -31841,6 +33719,21 @@
31841
33719
  "tasks_failed",
31842
33720
  "workflow_runs_completed"
31843
33721
  ]
33722
+ },
33723
+ "github": {
33724
+ "type": "object",
33725
+ "properties": {
33726
+ "web_url": {
33727
+ "type": "string"
33728
+ },
33729
+ "enterprise": {
33730
+ "type": "boolean"
33731
+ }
33732
+ },
33733
+ "required": [
33734
+ "web_url",
33735
+ "enterprise"
33736
+ ]
31844
33737
  }
31845
33738
  },
31846
33739
  "required": [
@@ -35236,7 +37129,7 @@
35236
37129
  }
35237
37130
  },
35238
37131
  "403": {
35239
- "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",
35240
37133
  "content": {
35241
37134
  "application/json": {
35242
37135
  "schema": {
@@ -35633,7 +37526,8 @@
35633
37526
  "script",
35634
37527
  "slack",
35635
37528
  "api",
35636
- "chat"
37529
+ "chat",
37530
+ "app-page"
35637
37531
  ]
35638
37532
  },
35639
37533
  "requestedByUserId": {
@@ -36245,6 +38139,62 @@
36245
38139
  "verified"
36246
38140
  ]
36247
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
+ ]
36248
38198
  }
36249
38199
  },
36250
38200
  "required": [
@@ -36252,7 +38202,8 @@
36252
38202
  "supportedSteerModes",
36253
38203
  "logs",
36254
38204
  "attachments",
36255
- "citations"
38205
+ "citations",
38206
+ "uiSpec"
36256
38207
  ]
36257
38208
  }
36258
38209
  ]
@@ -37194,10 +39145,99 @@
37194
39145
  }
37195
39146
  }
37196
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
+ },
37197
39237
  "/api/tasks/{id}/supersede": {
37198
39238
  "post": {
37199
39239
  "summary": "Supersede an in-progress task (terminate + spawn resume follow-up)",
37200
- "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.",
37201
39241
  "tags": [
37202
39242
  "Tasks"
37203
39243
  ],
@@ -37480,24 +39520,105 @@
37480
39520
  "schema": {
37481
39521
  "type": "object",
37482
39522
  "properties": {
37483
- "title": {
37484
- "type": [
37485
- "string",
37486
- "null"
37487
- ],
37488
- "maxLength": 120
39523
+ "title": {
39524
+ "type": [
39525
+ "string",
39526
+ "null"
39527
+ ],
39528
+ "maxLength": 120
39529
+ }
39530
+ },
39531
+ "required": [
39532
+ "title"
39533
+ ]
39534
+ }
39535
+ }
39536
+ }
39537
+ },
39538
+ "responses": {
39539
+ "200": {
39540
+ "description": "Title updated",
39541
+ "content": {
39542
+ "application/json": {
39543
+ "schema": {
39544
+ "type": "object",
39545
+ "properties": {
39546
+ "task": {
39547
+ "$ref": "#/components/schemas/AgentTask"
39548
+ }
39549
+ },
39550
+ "required": [
39551
+ "task"
39552
+ ]
39553
+ }
39554
+ }
39555
+ }
39556
+ },
39557
+ "404": {
39558
+ "description": "Task not found",
39559
+ "content": {
39560
+ "application/json": {
39561
+ "schema": {
39562
+ "$ref": "#/components/schemas/ErrorResponse"
39563
+ }
39564
+ }
39565
+ }
39566
+ }
39567
+ }
39568
+ }
39569
+ },
39570
+ "/api/tasks/{id}/tags": {
39571
+ "patch": {
39572
+ "summary": "Add or remove task tags",
39573
+ "description": "Adds the `add` tags and removes the `remove` tags. A tag in both lists is removed. Only `ui:` presentation tags are accepted (400 otherwise); tags that drive behaviour are server-owned. The dashboard uses `ui:dismissed` to hide a failed task from Home's Needs you. Does not change `lastUpdatedAt`.",
39574
+ "tags": [
39575
+ "Tasks"
39576
+ ],
39577
+ "security": [
39578
+ {
39579
+ "bearerAuth": []
39580
+ }
39581
+ ],
39582
+ "parameters": [
39583
+ {
39584
+ "schema": {
39585
+ "type": "string"
39586
+ },
39587
+ "required": true,
39588
+ "name": "id",
39589
+ "in": "path"
39590
+ }
39591
+ ],
39592
+ "requestBody": {
39593
+ "content": {
39594
+ "application/json": {
39595
+ "schema": {
39596
+ "type": "object",
39597
+ "properties": {
39598
+ "add": {
39599
+ "type": "array",
39600
+ "items": {
39601
+ "type": "string",
39602
+ "pattern": "^ui:[a-z0-9][a-z0-9-]{0,60}$"
39603
+ },
39604
+ "maxItems": 20
39605
+ },
39606
+ "remove": {
39607
+ "type": "array",
39608
+ "items": {
39609
+ "type": "string",
39610
+ "pattern": "^ui:[a-z0-9][a-z0-9-]{0,60}$"
39611
+ },
39612
+ "maxItems": 20
37489
39613
  }
37490
- },
37491
- "required": [
37492
- "title"
37493
- ]
39614
+ }
37494
39615
  }
37495
39616
  }
37496
39617
  }
37497
39618
  },
37498
39619
  "responses": {
37499
39620
  "200": {
37500
- "description": "Title updated",
39621
+ "description": "Tags updated",
37501
39622
  "content": {
37502
39623
  "application/json": {
37503
39624
  "schema": {
@@ -37514,6 +39635,16 @@
37514
39635
  }
37515
39636
  }
37516
39637
  },
39638
+ "403": {
39639
+ "description": "Task belongs to another user",
39640
+ "content": {
39641
+ "application/json": {
39642
+ "schema": {
39643
+ "$ref": "#/components/schemas/ErrorResponse"
39644
+ }
39645
+ }
39646
+ }
39647
+ },
37517
39648
  "404": {
37518
39649
  "description": "Task not found",
37519
39650
  "content": {
@@ -39981,6 +42112,28 @@
39981
42112
  "name"
39982
42113
  ]
39983
42114
  },
42115
+ "checklistNudge": {
42116
+ "type": "object",
42117
+ "properties": {
42118
+ "itemId": {
42119
+ "type": "string"
42120
+ },
42121
+ "kind": {
42122
+ "type": "string"
42123
+ },
42124
+ "label": {
42125
+ "type": "string"
42126
+ },
42127
+ "href": {
42128
+ "type": "string"
42129
+ }
42130
+ },
42131
+ "required": [
42132
+ "itemId",
42133
+ "kind",
42134
+ "label"
42135
+ ]
42136
+ },
39984
42137
  "threadParticipants": {
39985
42138
  "type": "object",
39986
42139
  "properties": {
@@ -48412,6 +50565,9 @@
48412
50565
  "items": {
48413
50566
  "type": "string"
48414
50567
  }
50568
+ },
50569
+ "hiddenInCatalog": {
50570
+ "type": "boolean"
48415
50571
  }
48416
50572
  },
48417
50573
  "required": [
@@ -51006,6 +53162,42 @@
51006
53162
  "type": "string",
51007
53163
  "minLength": 1
51008
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
+ },
51009
53201
  "totalCostUsd": {
51010
53202
  "type": "number"
51011
53203
  },
@@ -51024,7 +53216,10 @@
51024
53216
  "minimum": 0
51025
53217
  },
51026
53218
  "cacheReadTokens": {
51027
- "type": "integer",
53219
+ "type": [
53220
+ "integer",
53221
+ "null"
53222
+ ],
51028
53223
  "minimum": 0
51029
53224
  },
51030
53225
  "cacheWriteTokens": {
@@ -51185,6 +53380,26 @@
51185
53380
  }
51186
53381
  }
51187
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
+ }
51188
53403
  }
51189
53404
  }
51190
53405
  },
@@ -51374,6 +53589,12 @@
51374
53589
  },
51375
53590
  "subscriptionCostUsd": {
51376
53591
  "type": "number"
53592
+ },
53593
+ "credentialUnattributedCostUsd": {
53594
+ "type": "number"
53595
+ },
53596
+ "credentialUnattributedSessions": {
53597
+ "type": "integer"
51377
53598
  }
51378
53599
  },
51379
53600
  "required": [
@@ -51389,7 +53610,9 @@
51389
53610
  "attributableCostUsd",
51390
53611
  "excludedCostUsd",
51391
53612
  "excludedTaskCount",
51392
- "subscriptionCostUsd"
53613
+ "subscriptionCostUsd",
53614
+ "credentialUnattributedCostUsd",
53615
+ "credentialUnattributedSessions"
51393
53616
  ]
51394
53617
  },
51395
53618
  "daily": {
@@ -51414,6 +53637,12 @@
51414
53637
  },
51415
53638
  "subscriptionCostUsd": {
51416
53639
  "type": "number"
53640
+ },
53641
+ "credentialUnattributedCostUsd": {
53642
+ "type": "number"
53643
+ },
53644
+ "credentialUnattributedSessions": {
53645
+ "type": "integer"
51417
53646
  }
51418
53647
  },
51419
53648
  "required": [
@@ -51422,7 +53651,9 @@
51422
53651
  "inputTokens",
51423
53652
  "outputTokens",
51424
53653
  "sessions",
51425
- "subscriptionCostUsd"
53654
+ "subscriptionCostUsd",
53655
+ "credentialUnattributedCostUsd",
53656
+ "credentialUnattributedSessions"
51426
53657
  ]
51427
53658
  }
51428
53659
  },
@@ -55291,6 +57522,62 @@
55291
57522
  ]
55292
57523
  }
55293
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
+ },
55294
57581
  "isLeadTask": {
55295
57582
  "type": "boolean"
55296
57583
  },
@@ -55307,6 +57594,7 @@
55307
57594
  },
55308
57595
  "required": [
55309
57596
  "citations",
57597
+ "uiSpec",
55310
57598
  "isLeadTask",
55311
57599
  "supportedSteerModes"
55312
57600
  ]
@@ -55388,6 +57676,62 @@
55388
57676
  ]
55389
57677
  }
55390
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
+ },
55391
57735
  "isLeadTask": {
55392
57736
  "type": "boolean"
55393
57737
  },
@@ -55404,6 +57748,7 @@
55404
57748
  },
55405
57749
  "required": [
55406
57750
  "citations",
57751
+ "uiSpec",
55407
57752
  "isLeadTask",
55408
57753
  "supportedSteerModes"
55409
57754
  ]
@@ -57639,6 +59984,79 @@
57639
59984
  }
57640
59985
  }
57641
59986
  },
59987
+ "/api/integrations/slack/events": {
59988
+ "post": {
59989
+ "summary": "Slack HTTP ingress (SLACK_MODE=http): Events API, slash commands and interactivity at one request URL",
59990
+ "tags": [
59991
+ "Slack"
59992
+ ],
59993
+ "responses": {
59994
+ "200": {
59995
+ "description": "Accepted"
59996
+ },
59997
+ "400": {
59998
+ "description": "Malformed body after a valid signature",
59999
+ "content": {
60000
+ "application/json": {
60001
+ "schema": {
60002
+ "$ref": "#/components/schemas/ErrorResponse"
60003
+ }
60004
+ }
60005
+ }
60006
+ },
60007
+ "401": {
60008
+ "description": "Missing or invalid signature, or timestamp outside the 5-minute window",
60009
+ "content": {
60010
+ "application/json": {
60011
+ "schema": {
60012
+ "$ref": "#/components/schemas/ErrorResponse"
60013
+ }
60014
+ }
60015
+ }
60016
+ },
60017
+ "403": {
60018
+ "description": "Delivery for a workspace this swarm does not own",
60019
+ "content": {
60020
+ "application/json": {
60021
+ "schema": {
60022
+ "$ref": "#/components/schemas/ErrorResponse"
60023
+ }
60024
+ }
60025
+ }
60026
+ },
60027
+ "404": {
60028
+ "description": "Slack is disabled or not in HTTP mode",
60029
+ "content": {
60030
+ "application/json": {
60031
+ "schema": {
60032
+ "$ref": "#/components/schemas/ErrorResponse"
60033
+ }
60034
+ }
60035
+ }
60036
+ },
60037
+ "413": {
60038
+ "description": "Body exceeds 1 MiB",
60039
+ "content": {
60040
+ "application/json": {
60041
+ "schema": {
60042
+ "$ref": "#/components/schemas/ErrorResponse"
60043
+ }
60044
+ }
60045
+ }
60046
+ },
60047
+ "503": {
60048
+ "description": "Receiver not ready, workspace unverified, or backlog full; Slack retries",
60049
+ "content": {
60050
+ "application/json": {
60051
+ "schema": {
60052
+ "$ref": "#/components/schemas/ErrorResponse"
60053
+ }
60054
+ }
60055
+ }
60056
+ }
60057
+ }
60058
+ }
60059
+ },
57642
60060
  "/api/slack/inbound/diagnostics": {
57643
60061
  "get": {
57644
60062
  "summary": "Operator-only. Slack inbound delivery diagnostics: transport mode, durable receipt counts by state, uncertain receipts awaiting review, and per-transport outcome counters. Never includes payloads or credentials.",
@@ -59673,7 +62091,19 @@
59673
62091
  "servers": {
59674
62092
  "type": "array",
59675
62093
  "items": {
59676
- "$ref": "#/components/schemas/McpServer"
62094
+ "allOf": [
62095
+ {
62096
+ "$ref": "#/components/schemas/McpServer"
62097
+ },
62098
+ {
62099
+ "type": "object",
62100
+ "properties": {
62101
+ "installCount": {
62102
+ "type": "number"
62103
+ }
62104
+ }
62105
+ }
62106
+ ]
59677
62107
  }
59678
62108
  },
59679
62109
  "total": {