@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
@@ -0,0 +1,169 @@
1
+ import { cardToBlockKit, cardToFallbackText } from "@chat-adapter/slack";
2
+ import { CardSpecError, toCard } from "@json-render/chat";
3
+ import {
4
+ type TaskUiSpecAction,
5
+ type TaskUiSpecDocument,
6
+ type TaskUiSpecInput,
7
+ UI_SPEC_ACTION_ID,
8
+ UI_SPEC_ACTION_PREFIX,
9
+ UI_SPEC_CARD_LIMITS,
10
+ UI_SPEC_MAX_ACTIONS_ROW_ELEMENTS,
11
+ UI_SPEC_MAX_BLOCKS,
12
+ UI_SPEC_MAX_BYTES,
13
+ } from "../utils/task-ui-spec";
14
+
15
+ export interface ValidateTaskUiSpecOptions {
16
+ taskId: string;
17
+ actionsEnabled: boolean;
18
+ }
19
+
20
+ export type ValidateTaskUiSpecResult =
21
+ | {
22
+ ok: true;
23
+ spec: TaskUiSpecDocument;
24
+ actions: Record<string, TaskUiSpecAction> | undefined;
25
+ blocks: unknown[];
26
+ fallbackText: string;
27
+ }
28
+ | { ok: false; issues: string[] };
29
+
30
+ export type RenderTaskUiSpecResult =
31
+ | { ok: true; blocks: unknown[]; fallbackText: string }
32
+ | { ok: false; issues: string[] };
33
+
34
+ /** Element props whose value must be an https: URL, by component type. */
35
+ const URL_PROPS: Record<string, string> = {
36
+ LinkButton: "url",
37
+ Image: "url",
38
+ Card: "imageUrl",
39
+ };
40
+
41
+ type Element = { type?: unknown; props?: Record<string, unknown> };
42
+
43
+ function asElement(value: unknown): Element | null {
44
+ return value !== null && typeof value === "object" ? (value as Element) : null;
45
+ }
46
+
47
+ function elementProps(element: Element): Record<string, unknown> {
48
+ const props = element.props;
49
+ return props !== null && typeof props === "object" ? props : {};
50
+ }
51
+
52
+ function isHttpsUrl(value: unknown): boolean {
53
+ if (typeof value !== "string") return false;
54
+ try {
55
+ return new URL(value).protocol === "https:";
56
+ } catch {
57
+ return false;
58
+ }
59
+ }
60
+
61
+ /**
62
+ * Steps 4 to 6 of the uiSpec contract: make the render copy, convert it with
63
+ * `toCard`, and check the Slack block budget. Also returns the fallback text.
64
+ */
65
+ export function renderTaskUiSpec(spec: TaskUiSpecDocument, taskId: string): RenderTaskUiSpecResult {
66
+ // Step 4: the render copy namespaces Button ids and carries the task id.
67
+ // The stored spec keeps the original ids.
68
+ const renderCopy = structuredClone(spec);
69
+ for (const value of Object.values(renderCopy.elements)) {
70
+ const element = asElement(value);
71
+ if (!element || element.type !== "Button") continue;
72
+ const props = elementProps(element);
73
+ element.props = { ...props, id: `${UI_SPEC_ACTION_PREFIX}${String(props.id)}`, value: taskId };
74
+ }
75
+
76
+ // Step 5: convert to a Chat SDK card under the engine limits.
77
+ let card: ReturnType<typeof toCard>;
78
+ try {
79
+ card = toCard(renderCopy as Parameters<typeof toCard>[0], { limits: UI_SPEC_CARD_LIMITS });
80
+ } catch (error) {
81
+ if (error instanceof CardSpecError) return { ok: false, issues: [...error.issues] };
82
+ throw error;
83
+ }
84
+
85
+ // Step 6: the Slack block budget.
86
+ const blocks = cardToBlockKit(card);
87
+ const issues: string[] = [];
88
+ if (blocks.length > UI_SPEC_MAX_BLOCKS) {
89
+ issues.push(
90
+ `uiSpec renders as ${blocks.length} Slack blocks; the limit is ${UI_SPEC_MAX_BLOCKS}.`,
91
+ );
92
+ }
93
+ for (const block of blocks as Array<{ type?: string; elements?: unknown[] }>) {
94
+ const count = block.elements?.length ?? 0;
95
+ if (block.type === "actions" && count > UI_SPEC_MAX_ACTIONS_ROW_ELEMENTS) {
96
+ issues.push(
97
+ `An Actions row renders ${count} Slack elements; the limit is ${UI_SPEC_MAX_ACTIONS_ROW_ELEMENTS}.`,
98
+ );
99
+ }
100
+ }
101
+ if (issues.length > 0) return { ok: false, issues };
102
+
103
+ // Step 7: the text for surfaces that cannot render the card.
104
+ return { ok: true, blocks, fallbackText: cardToFallbackText(card) };
105
+ }
106
+
107
+ /**
108
+ * Validates an agent-sent uiSpec against the json-render chat catalog and the
109
+ * engine limits. Pure: no I/O. Returns every issue found in steps 1 to 3, or
110
+ * the issues of the first failing later step.
111
+ */
112
+ export function validateTaskUiSpec(
113
+ input: TaskUiSpecInput,
114
+ { taskId, actionsEnabled }: ValidateTaskUiSpecOptions,
115
+ ): ValidateTaskUiSpecResult {
116
+ const issues: string[] = [];
117
+
118
+ // Step 1: size.
119
+ const bytes = new TextEncoder().encode(JSON.stringify(input.spec)).length;
120
+ if (bytes > UI_SPEC_MAX_BYTES) {
121
+ issues.push(`uiSpec is ${bytes} bytes; the limit is ${UI_SPEC_MAX_BYTES}.`);
122
+ }
123
+
124
+ for (const [elementId, value] of Object.entries(input.spec.elements)) {
125
+ const element = asElement(value);
126
+ if (!element) continue;
127
+ const props = elementProps(element);
128
+ const type = typeof element.type === "string" ? element.type : "";
129
+
130
+ // Step 2: URL schemes.
131
+ const urlProp = Object.hasOwn(URL_PROPS, type) ? URL_PROPS[type] : undefined;
132
+ if (urlProp) {
133
+ const url = props[urlProp];
134
+ if (url !== undefined && url !== null && !isHttpsUrl(url)) {
135
+ issues.push(`${elementId}.${urlProp} must be an https: URL.`);
136
+ }
137
+ }
138
+
139
+ // Step 3: Buttons need the action flag and a declared action.
140
+ if (type === "Button") {
141
+ if (!actionsEnabled) {
142
+ issues.push(`Button ${elementId} needs UI_SPEC_ACTIONS_ENABLED=true; use LinkButton.`);
143
+ continue;
144
+ }
145
+ const id = props.id;
146
+ const declared =
147
+ typeof id === "string" &&
148
+ UI_SPEC_ACTION_ID.test(id) &&
149
+ input.actions !== undefined &&
150
+ Object.hasOwn(input.actions, id);
151
+ if (!declared) {
152
+ issues.push(
153
+ `Button ${elementId} names action "${String(id)}", which uiSpec.actions does not declare.`,
154
+ );
155
+ }
156
+ }
157
+ }
158
+ if (issues.length > 0) return { ok: false, issues };
159
+
160
+ const rendered = renderTaskUiSpec(input.spec, taskId);
161
+ if (!rendered.ok) return rendered;
162
+ return {
163
+ ok: true,
164
+ spec: input.spec,
165
+ actions: input.actions,
166
+ blocks: rendered.blocks,
167
+ fallbackText: rendered.fallbackText,
168
+ };
169
+ }
@@ -0,0 +1,159 @@
1
+ import type { RateLimitWindowTelemetry } from "./error-tracker";
2
+ import {
3
+ applyProviderQuotaReport,
4
+ codexWindowKey,
5
+ type ProviderAccountTelemetry,
6
+ providerLimitTelemetrySchema,
7
+ type RateLimitReplacement,
8
+ } from "./provider-account-telemetry";
9
+
10
+ export interface CodexQuotaTelemetry {
11
+ windows: RateLimitWindowTelemetry;
12
+ account: ProviderAccountTelemetry;
13
+ replace: RateLimitReplacement[];
14
+ }
15
+
16
+ function record(value: unknown): Record<string, unknown> | undefined {
17
+ return value && typeof value === "object" && !Array.isArray(value)
18
+ ? (value as Record<string, unknown>)
19
+ : undefined;
20
+ }
21
+
22
+ /** Normalize one Codex 0.167.0 bucket. Rolling metadata nulls mean unavailable. */
23
+ export function normalizeCodexRateLimits(
24
+ value: unknown,
25
+ observedAt: string,
26
+ sparse = false,
27
+ fallbackLimitId = "codex",
28
+ ): CodexQuotaTelemetry | undefined {
29
+ const raw = record(value);
30
+ if (!raw || !Number.isFinite(Date.parse(observedAt))) return;
31
+ const limitId = typeof raw.limitId === "string" ? raw.limitId : fallbackLimitId;
32
+ if (!limitId || limitId.length > 128) return;
33
+ const limit: Record<string, unknown> = { observedAt };
34
+ for (const [field, input] of Object.entries({
35
+ planRaw: raw.planType,
36
+ label: raw.limitName,
37
+ normalModelSlug: raw.normalModelSlug,
38
+ credits:
39
+ raw.credits === null
40
+ ? null
41
+ : record(raw.credits) && {
42
+ hasCredits: record(raw.credits)!.hasCredits,
43
+ unlimited: record(raw.credits)!.unlimited,
44
+ balance: record(raw.credits)!.balance,
45
+ },
46
+ spend:
47
+ raw.individualLimit === null
48
+ ? null
49
+ : record(raw.individualLimit) && {
50
+ limit: record(raw.individualLimit)!.limit,
51
+ used: record(raw.individualLimit)!.used,
52
+ remainingPercent: record(raw.individualLimit)!.remainingPercent,
53
+ resetsAt: record(raw.individualLimit)!.resetsAt,
54
+ },
55
+ reachedType: raw.rateLimitReachedType,
56
+ spendControlReached: raw.spendControlReached,
57
+ })) {
58
+ if (input === undefined || (sparse && input === null && field !== "spendControlReached"))
59
+ continue;
60
+ const parsed = providerLimitTelemetrySchema.safeParse({ observedAt, [field]: input });
61
+ if (parsed.success) Object.assign(limit, parsed.data);
62
+ }
63
+ const account: ProviderAccountTelemetry = {
64
+ source: "codex",
65
+ observedAt,
66
+ limits: { [limitId]: providerLimitTelemetrySchema.parse(limit) },
67
+ };
68
+ const windows: RateLimitWindowTelemetry = {};
69
+ const slots: RateLimitReplacement["slots"] = [];
70
+ for (const slot of ["primary", "secondary"] as const) {
71
+ if (raw[slot] === null) {
72
+ slots.push(slot);
73
+ continue;
74
+ }
75
+ const window = record(raw[slot]);
76
+ if (
77
+ !window ||
78
+ typeof window.usedPercent !== "number" ||
79
+ !Number.isFinite(window.usedPercent) ||
80
+ !Number.isInteger(window.usedPercent) ||
81
+ window.usedPercent < 0 ||
82
+ window.usedPercent > 2147483647
83
+ )
84
+ continue;
85
+ slots.push(slot);
86
+ const duration = window.windowDurationMins;
87
+ const reset = window.resetsAt;
88
+ windows[codexWindowKey(limitId, slot)] = {
89
+ status: window.usedPercent >= 100 ? "rejected" : "allowed",
90
+ utilization: window.usedPercent / 100,
91
+ lastSeenAt: observedAt,
92
+ source: "codex",
93
+ limitId,
94
+ ...(typeof raw.limitName === "string" && raw.limitName.length <= 256
95
+ ? { label: raw.limitName }
96
+ : {}),
97
+ ...(typeof raw.normalModelSlug === "string" && raw.normalModelSlug.length <= 256
98
+ ? { normalModelSlug: raw.normalModelSlug }
99
+ : {}),
100
+ ...(typeof duration === "number" &&
101
+ Number.isInteger(duration) &&
102
+ duration > 0 &&
103
+ duration <= 576000
104
+ ? { durationMins: duration }
105
+ : {}),
106
+ ...(typeof reset === "number" &&
107
+ Number.isSafeInteger(reset) &&
108
+ reset > 0 &&
109
+ reset <= 8_640_000_000_000
110
+ ? { resetsAt: reset }
111
+ : {}),
112
+ };
113
+ }
114
+ return {
115
+ windows,
116
+ account,
117
+ replace: slots.length ? [{ source: "codex", limitId, observedAt, slots }] : [],
118
+ };
119
+ }
120
+
121
+ /** Normalize the read envelope. An empty or unusable map falls back to the legacy snapshot. */
122
+ export function normalizeCodexRateLimitsResponse(
123
+ value: unknown,
124
+ observedAt: string,
125
+ ): CodexQuotaTelemetry | undefined {
126
+ const raw = record(value);
127
+ if (!raw || !Number.isFinite(Date.parse(observedAt))) return;
128
+ let buckets = Object.entries(record(raw.rateLimitsByLimitId) ?? {}).flatMap(([id, bucket]) => {
129
+ const normalized = normalizeCodexRateLimits(bucket, observedAt, false, id);
130
+ return normalized ? [normalized] : [];
131
+ });
132
+ if (!buckets.length) {
133
+ const legacy = normalizeCodexRateLimits(raw.rateLimits, observedAt);
134
+ if (legacy) buckets = [legacy];
135
+ }
136
+ const account: ProviderAccountTelemetry = { source: "codex", observedAt };
137
+ if (typeof raw.ordinaryUsageAllowed === "boolean" || raw.ordinaryUsageAllowed === null)
138
+ account.ordinaryUsageAllowed = raw.ordinaryUsageAllowed;
139
+ const credits = record(raw.rateLimitResetCredits);
140
+ if (raw.rateLimitResetCredits === null) account.resetCreditsAvailable = null;
141
+ else if (
142
+ typeof credits?.availableCount === "number" &&
143
+ Number.isSafeInteger(credits.availableCount) &&
144
+ credits.availableCount >= 0
145
+ )
146
+ account.resetCreditsAvailable = credits.availableCount;
147
+ if (
148
+ !buckets.length &&
149
+ account.ordinaryUsageAllowed === undefined &&
150
+ account.resetCreditsAvailable === undefined
151
+ )
152
+ return;
153
+ let merged = { windows: {} as RateLimitWindowTelemetry, account };
154
+ for (const bucket of buckets) {
155
+ const next = applyProviderQuotaReport(merged, bucket);
156
+ merged = { ...next, account: next.account! };
157
+ }
158
+ return { ...merged, replace: buckets.flatMap((bucket) => bucket.replace) };
159
+ }
@@ -112,32 +112,46 @@ export function getAgentFsLiveUrl(): string {
112
112
  export type AgentFsLinkTarget = "dashboard" | "live";
113
113
 
114
114
  /**
115
- * The operator's `AGENT_FS_LINK_TARGET` choice (trimmed, lowercased). Null when
116
- * unset, blank, or invalid: every surface then keeps its automatic behavior.
115
+ * Where people-facing file links point. An explicit `AGENT_FS_LINK_TARGET`
116
+ * (trimmed, lowercased) wins. Unset, blank, or invalid: `dashboard` when an
117
+ * `APP_URL` / `DASHBOARD_URL` is configured (not the hosted fallback) and
118
+ * Comb is not explicitly off (`COMB_ENABLED=false`), else `live`.
117
119
  */
118
- export function readAgentFsLinkTarget(): AgentFsLinkTarget | null {
120
+ export function readAgentFsLinkTarget(): AgentFsLinkTarget {
119
121
  const raw = process.env.AGENT_FS_LINK_TARGET?.trim().toLowerCase();
120
- return raw === "dashboard" || raw === "live" ? raw : null;
122
+ if (raw === "dashboard" || raw === "live") return raw;
123
+ return getConfiguredAppUrls().length > 0 && !isCombExplicitlyOff() ? "dashboard" : "live";
121
124
  }
122
125
 
123
126
  /**
124
127
  * The base URL (no trailing slash) that a people-facing file link starts with,
125
128
  * per {@link readAgentFsLinkTarget}. `dashboard` uses `APP_URL` when one is
126
- * configured (and, for attachments, Comb is on), else the live app. Null when
127
- * no target is set: the caller keeps its current code path.
129
+ * configured and Comb is on, else the live app.
128
130
  *
129
- * The prompt surface skips the Comb check: workers do not get `COMB_ENABLED`,
130
- * and an explicit `dashboard` is the operator's choice.
131
+ * The prompt surface checks only an explicit `COMB_ENABLED=false`: a worker
132
+ * sees `COMB_ENABLED` only from a swarm_config row (RELOADABLE_ENV_KEYS in
133
+ * runner.ts) and may lack the API's agent-fs settings, so `isCombEnabled()`
134
+ * does not hold there.
131
135
  */
132
- export function resolveAgentFsLinkBase(surface: "prompt" | "attachment"): string | null {
133
- const target = readAgentFsLinkTarget();
134
- if (target === null) return null;
135
- if (target === "dashboard" && getConfiguredAppUrls().length > 0) {
136
- if (surface === "prompt" || isCombEnabled()) return getAppUrl();
136
+ export function resolveAgentFsLinkBase(surface: "prompt" | "attachment"): string {
137
+ if (readAgentFsLinkTarget() === "dashboard" && getConfiguredAppUrls().length > 0) {
138
+ if (surface === "prompt" ? !isCombExplicitlyOff() : isCombEnabled()) return getAppUrl();
137
139
  }
138
140
  return getAgentFsLiveUrl();
139
141
  }
140
142
 
143
+ /**
144
+ * The query string for a file link that starts with `base`. A live-app link
145
+ * gets `?apiUrl=<AGENT_FS_PUBLIC_URL>` when that URL is set, so a browser with
146
+ * no agent-fs key knows which agent-fs to sign in to (the agent-fs invite link
147
+ * convention). Empty for a dashboard link or with no public agent-fs URL.
148
+ */
149
+ export function agentFsFileLinkQuery(base: string): string {
150
+ if (base !== getAgentFsLiveUrl()) return "";
151
+ const publicUrl = process.env.AGENT_FS_PUBLIC_URL?.trim().replace(/\/+$/, "");
152
+ return publicUrl ? `?apiUrl=${encodeURIComponent(publicUrl)}` : "";
153
+ }
154
+
141
155
  /**
142
156
  * Optional fallback agent-fs `org_id` for attachments that store only `path`.
143
157
  * Strictly opt-in — when neither env var is set, the renderer keeps the
@@ -199,93 +213,12 @@ export function agentFsFileRoute(opts: AgentFsFileRef): string | null {
199
213
  * when that route is null; callers fall back to the raw `agent-fs:<path>`
200
214
  * display instead.
201
215
  *
202
- * Shape: ${liveHost}/file/~/<orgId>/<driveId>/<normalized-path>
216
+ * Shape: ${liveHost}/file/~/<orgId>/<driveId>/<normalized-path>[?apiUrl=<AGENT_FS_PUBLIC_URL>]
203
217
  */
204
218
  export function buildAgentFsLiveUrl(opts: AgentFsFileRef): string | null {
205
219
  const route = agentFsFileRoute(opts);
206
- return route ? `${getAgentFsLiveUrl()}/file/~/${route}` : null;
207
- }
208
-
209
- /** RFC 1918 private and 169.254/16 link-local IPv4 space, by its first two octets. */
210
- function isPrivateIpv4(a: number, b: number): boolean {
211
- return (
212
- a === 10 ||
213
- (a === 172 && b >= 16 && b <= 31) ||
214
- (a === 192 && b === 168) ||
215
- (a === 169 && b === 254)
216
- );
217
- }
218
-
219
- /**
220
- * The eight 16-bit groups of an IPv6 literal (no brackets), or null when it is
221
- * malformed. `new URL` already normalizes a host to compressed hex, so a
222
- * dotted IPv4 tail never reaches here; one is rejected rather than parsed.
223
- */
224
- function parseIpv6(addr: string): number[] | null {
225
- if (addr.includes(".")) return null;
226
- const halves = addr.split("::");
227
- if (halves.length > 2) return null;
228
- const toGroups = (part: string): number[] | null => {
229
- if (!part) return [];
230
- const groups = part
231
- .split(":")
232
- .map((g) => (/^[0-9a-f]{1,4}$/.test(g) ? Number.parseInt(g, 16) : Number.NaN));
233
- return groups.some(Number.isNaN) ? null : groups;
234
- };
235
- const head = toGroups(halves[0] ?? "");
236
- const tail = toGroups(halves[1] ?? "");
237
- if (!head || !tail) return null;
238
- if (halves.length === 1) return head.length === 8 ? head : null;
239
- const missing = 8 - head.length - tail.length;
240
- return missing < 1 ? null : [...head, ...new Array<number>(missing).fill(0), ...tail];
241
- }
242
-
243
- /**
244
- * Whether a browser can plausibly open this URL. False for the addresses only
245
- * the swarm's own network resolves: a single-label host (a docker or compose
246
- * service such as `agent-fs`), `*.internal` (Railway, Fly, GCP),
247
- * `*.svc` / `*.cluster.local` (Kubernetes), and private, link-local or
248
- * unique-local IPs, including IPv4-mapped IPv6 (`::ffff:10.0.0.5`), `::` and
249
- * multicast `ff00::/8`. Loopback counts as reachable: a localhost URL means the
250
- * API and agent-fs share a host, which only works for a browser on that same
251
- * machine (the local dev setup), and a remote operator can set `COMB_ENABLED`.
252
- * An unparseable value is not reachable.
253
- */
254
- export function isBrowserReachableUrl(value: string): boolean {
255
- let host: string;
256
- try {
257
- host = new URL(value).hostname.toLowerCase().replace(/\.$/, "");
258
- } catch {
259
- return false;
260
- }
261
- if (!host) return false;
262
- if (host === "localhost" || host.endsWith(".localhost")) return true;
263
- if (host.startsWith("[")) {
264
- const parsed = parseIpv6(host.slice(1, -1));
265
- if (!parsed) return false;
266
- const g = (i: number) => parsed[i] ?? 0;
267
- // Loopback is reachable (the local dev setup).
268
- if (parsed.slice(0, 7).every((x) => x === 0) && g(7) === 1) return true;
269
- // `::` and multicast `ff00::/8` are not addresses a browser can open.
270
- if (parsed.every((x) => x === 0) || (g(0) & 0xff00) === 0xff00) return false;
271
- // Unique-local `fc00::/7` and link-local `fe80::/10`.
272
- if ((g(0) & 0xfe00) === 0xfc00 || (g(0) & 0xffc0) === 0xfe80) return false;
273
- // IPv4-mapped `::ffff:a.b.c.d`: judge the embedded IPv4 address.
274
- if (parsed.slice(0, 5).every((x) => x === 0) && g(5) === 0xffff) {
275
- const a = g(6) >> 8;
276
- if (a === 0) return false;
277
- return a === 127 || !isPrivateIpv4(a, g(6) & 0xff);
278
- }
279
- return true;
280
- }
281
- const octets = host.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
282
- if (octets) {
283
- const [a, b] = [Number(octets[1]), Number(octets[2])];
284
- if (a === 0) return false;
285
- return a === 127 || !isPrivateIpv4(a, b);
286
- }
287
- if (!host.includes(".")) return false;
288
- return !(host.endsWith(".internal") || host.endsWith(".svc") || host.endsWith(".cluster.local"));
220
+ const live = getAgentFsLiveUrl();
221
+ return route ? `${live}/file/~/${route}${agentFsFileLinkQuery(live)}` : null;
289
222
  }
290
223
 
291
224
  export interface CombState {
@@ -297,38 +230,40 @@ export interface CombState {
297
230
  }
298
231
 
299
232
  /**
300
- * Comb (the agent-fs review space in the dashboard). An explicit
301
- * `COMB_ENABLED` wins both ways, but still needs `AGENT_FS_API_URL`. Unset, it
302
- * is on only when a browser can reach agent-fs: `AGENT_FS_PUBLIC_URL` is set,
303
- * `AGENT_FS_PROXY` is on and the public API URL is {@link isBrowserReachableUrl}
304
- * (the browser goes through the API), or, with no proxy, `AGENT_FS_API_URL` is
305
- * itself reachable. Otherwise the browser would land on a private host.
233
+ * Comb (the agent-fs review space in the dashboard). It always needs
234
+ * `AGENT_FS_API_URL`, and an explicit `COMB_ENABLED=false` turns it off. An
235
+ * explicit `COMB_ENABLED=true` turns it on. Unset, it is on only when the
236
+ * browser has an agent-fs address: `AGENT_FS_PUBLIC_URL`, or the API's
237
+ * `/agentfs` proxy (`AGENT_FS_PROXY`, on by default with `AGENT_FS_API_URL`).
306
238
  * Reads `process.env` per call, so a config reload applies without a restart.
307
239
  */
308
240
  export function getCombState(): CombState {
309
241
  const apiUrl = process.env.AGENT_FS_API_URL?.trim().replace(/\/+$/, "");
310
- const raw = process.env.COMB_ENABLED;
311
- // The two parses agree only when the value is a recognized flag literal.
312
- const explicit = parseEnvFlag(raw, true) === parseEnvFlag(raw, false);
313
- if (explicit && !isEnvFlagEnabled("COMB_ENABLED", false)) {
242
+ const explicit = isCombFlagExplicit();
243
+ if (isCombExplicitlyOff()) {
314
244
  return { enabled: false, explicit, reason: "COMB_ENABLED is false." };
315
245
  }
316
246
  if (!apiUrl) return { enabled: false, explicit, reason: "AGENT_FS_API_URL is not set." };
317
- if (explicit) return { enabled: true, explicit, reason: null };
318
- if (process.env.AGENT_FS_PUBLIC_URL?.trim()) return { enabled: true, explicit, reason: null };
319
- // With the proxy on, the browser goes to `<public API URL>/agentfs`, so that
320
- // is the address to check, not `AGENT_FS_API_URL`.
321
- const proxy = isAgentFsProxyEnabled();
322
- const browserUrl = proxy ? getPublicMcpBaseUrl() : apiUrl;
323
- return isBrowserReachableUrl(browserUrl)
324
- ? { enabled: true, explicit, reason: null }
325
- : {
326
- enabled: false,
327
- explicit,
328
- reason: proxy
329
- ? `AGENT_FS_PROXY is on, but the API address ${browserUrl} is not reachable from a browser. Set PUBLIC_MCP_BASE_URL to the public API URL, or set COMB_ENABLED=true to force Files on.`
330
- : `AGENT_FS_API_URL (${apiUrl}) is not reachable from a browser. Set AGENT_FS_PUBLIC_URL or AGENT_FS_PROXY=true, or set COMB_ENABLED=true to force Files on.`,
331
- };
247
+ if (!explicit && !process.env.AGENT_FS_PUBLIC_URL?.trim() && !isAgentFsProxyEnabled()) {
248
+ return {
249
+ enabled: false,
250
+ explicit,
251
+ reason:
252
+ "AGENT_FS_PROXY is false and AGENT_FS_PUBLIC_URL is not set, so a browser has no agent-fs address.",
253
+ };
254
+ }
255
+ return { enabled: true, explicit, reason: null };
256
+ }
257
+
258
+ /** `COMB_ENABLED` holds a recognized flag literal (the two parses agree only then). */
259
+ function isCombFlagExplicit(): boolean {
260
+ const raw = process.env.COMB_ENABLED;
261
+ return parseEnvFlag(raw, true) === parseEnvFlag(raw, false);
262
+ }
263
+
264
+ /** `COMB_ENABLED` is an explicit false. Also readable on a worker, unlike {@link isCombEnabled}. */
265
+ export function isCombExplicitlyOff(): boolean {
266
+ return isCombFlagExplicit() && !isEnvFlagEnabled("COMB_ENABLED", false);
332
267
  }
333
268
 
334
269
  /**
@@ -342,22 +277,9 @@ export function isCombEnabled(): boolean {
342
277
  /**
343
278
  * `AGENT_FS_PROXY`: the API serves agent-fs at `/agentfs/*` (plus the public
344
279
  * `/share/*` and `/site/*` pages), and Comb uses `<public API URL>/agentfs`.
345
- * Read per request, so a config upsert applies without a restart. Off by default.
280
+ * Read per request, so a config upsert applies without a restart.
281
+ * Defaults on when `AGENT_FS_API_URL` is nonblank. An explicit flag wins.
346
282
  */
347
283
  export function isAgentFsProxyEnabled(): boolean {
348
- return isEnvFlagEnabled("AGENT_FS_PROXY", false);
349
- }
350
-
351
- /**
352
- * The dashboard (Comb) URL for an agent-fs file, same id and encoding rules as
353
- * {@link buildAgentFsLiveUrl}. Null unless Comb is on AND an explicit
354
- * `APP_URL` / `DASHBOARD_URL` is set: the hosted default dashboard cannot open
355
- * a self-hosted swarm's files.
356
- *
357
- * Shape: ${appUrl}/file/~/<orgId>/<driveId>/<normalized-path>
358
- */
359
- export function buildCombFileUrl(opts: AgentFsFileRef): string | null {
360
- if (!isCombEnabled() || getConfiguredAppUrls().length === 0) return null;
361
- const route = agentFsFileRoute(opts);
362
- return route ? `${getAppUrl()}/file/~/${route}` : null;
284
+ return isEnvFlagEnabled("AGENT_FS_PROXY", Boolean(process.env.AGENT_FS_API_URL?.trim()));
363
285
  }
@@ -172,6 +172,8 @@ export interface CredentialSelection {
172
172
  seatBlockedIndices?: number[];
173
173
  /** Subscription plan id detected on the credential (`SUBSCRIPTION_PLANS`), reported with its usage. */
174
174
  plan?: string | null;
175
+ /** Raw provider identity, independent of a priced catalog selection. */
176
+ planRaw?: string | null;
175
177
  /** `authFailureFence` from `GET /api/keys/available`, read before the task (Codex pool only). */
176
178
  authFailureFence?: number;
177
179
  }
@@ -24,6 +24,16 @@ export interface RateLimitWindowInfo {
24
24
  isUsingOverage?: boolean;
25
25
  surpassedThreshold?: number;
26
26
  lastSeenAt: string;
27
+ fieldObservedAt?: Partial<
28
+ Record<"durationMins" | "resetsAt" | "label" | "normalModelSlug", string>
29
+ >;
30
+ durationMins?: number;
31
+ source?: "claude" | "codex";
32
+ limitId?: string;
33
+ label?: string;
34
+ normalModelSlug?: string;
35
+ overageStatus?: string;
36
+ overageDisabledReason?: string;
27
37
  }
28
38
 
29
39
  export type RateLimitWindowTelemetry = Record<string, RateLimitWindowInfo>;
@@ -86,6 +96,15 @@ export function parseRateLimitWindowTelemetry(
86
96
  const existing = byType.get(info.rateLimitType);
87
97
  byType.set(info.rateLimitType, existing ? { ...existing, ...topLevel } : topLevel);
88
98
 
99
+ const mergedTop = byType.get(info.rateLimitType)!;
100
+ for (const field of ["overageStatus", "overageDisabledReason"] as const) {
101
+ if (typeof info[field] === "string") mergedTop[field] = info[field].slice(0, 256);
102
+ }
103
+ for (const [key, window] of byType) {
104
+ window.source = "claude";
105
+ if (key === "five_hour") window.durationMins = 300;
106
+ else if (key.startsWith("seven_day")) window.durationMins = 10080;
107
+ }
89
108
  return Array.from(byType, ([rateLimitType, windowInfo]) => ({
90
109
  rateLimitType,
91
110
  info: windowInfo,