@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
@@ -45,7 +45,10 @@ export const ELEMENT_KEYS = new Set([
45
45
  "repeat",
46
46
  "watch",
47
47
  ]);
48
- // Components whose `id` claims a `/ui/<id>/...` state slot.
48
+ // Components whose `id` claims a `/ui/<id>/...` state slot. Mirrored by the
49
+ // element assembler (`apps/ui/src/lib/json-render/assemble.ts`), which
50
+ // namespaces these ids per instance; `apps-element-assembly.test.ts` keeps the
51
+ // two lists equal.
49
52
  const UI_STATE_COMPONENTS = new Set([
50
53
  "SearchInput",
51
54
  "Select",
@@ -54,11 +57,44 @@ const UI_STATE_COMPONENTS = new Set([
54
57
  "Chips",
55
58
  "Tree",
56
59
  "SchemaForm",
60
+ "SessionThread",
57
61
  "Table",
62
+ "Accordion",
63
+ "DateRange",
58
64
  ]);
59
65
 
60
- // A SchemaForm id is spliced into `/ui/<id>/value`, so it must be a plain token.
66
+ // A SchemaForm or SessionThread id is spliced into `/ui/<id>/value`, so it must
67
+ // be a plain token.
61
68
  const SCHEMA_FORM_ID = /^[A-Za-z0-9_-]+$/;
69
+ const PLAIN_TOKEN_ID_COMPONENTS = new Set(["SchemaForm", "SessionThread"]);
70
+
71
+ /** Mirrors `APP_SESSION_KEY_PATTERN` (`src/tasks/context-key.ts`). */
72
+ const SESSION_KEY = /^[A-Za-z0-9_-]{1,128}$/;
73
+
74
+ /**
75
+ * `SessionThread.sessionKey` lands in a server-built context key, so a literal
76
+ * must be a plain token (a binding is checked by the server at send time).
77
+ * `scope: "shared"` is reserved for a follow-up PR (planned: an
78
+ * everyone:write `session_shares` row on the root when it is created).
79
+ */
80
+ function sessionThreadIssues(
81
+ props: Record<string, unknown>,
82
+ propsPath: string,
83
+ ): AppValidationIssue[] {
84
+ const issues: AppValidationIssue[] = [];
85
+ if (typeof props.sessionKey === "string" && !SESSION_KEY.test(props.sessionKey)) {
86
+ issues.push(
87
+ issue(
88
+ `${propsPath}.sessionKey`,
89
+ "SessionThread sessionKey must match ^[A-Za-z0-9_-]{1,128}$",
90
+ ),
91
+ );
92
+ }
93
+ if (props.scope === "shared") {
94
+ issues.push(issue(`${propsPath}.scope`, 'scope "shared" is not supported yet'));
95
+ }
96
+ return issues;
97
+ }
62
98
  const RESERVED_UI_IDS = new Set(["__proto__", "constructor", "prototype"]);
63
99
 
64
100
  /**
@@ -73,6 +109,10 @@ const PROP_ACTION_CHAINS: Record<string, readonly string[]> = {
73
109
  Calendar: ["onSelect"],
74
110
  CardGrid: ["onClick"],
75
111
  SchemaForm: ["onChange"],
112
+ Approval: ["onResolved"],
113
+ Files: ["onSelect"],
114
+ Timeline: ["onSelect"],
115
+ SessionThread: ["onDispatch"],
76
116
  };
77
117
 
78
118
  /**
@@ -87,8 +127,67 @@ const ITEM_ACTION_CHAINS: Record<string, readonly (readonly [string, string])[]>
87
127
  ["columns", "onChange"],
88
128
  ],
89
129
  Drawer: [["actions", "actions"]],
130
+ Dialog: [["actions", "actions"]],
90
131
  };
91
132
 
133
+ /** Route-driven panels: open exactly while their declared page `param` is set. */
134
+ const ROUTE_PANEL_TYPES = new Set(["Drawer", "Dialog"]);
135
+
136
+ /** The `$chain` keys an `Approval.onResolved` chain may read (first path segment). */
137
+ const APPROVAL_CHAIN_KEYS = new Set(["status", "responses", "resolvedBy"]);
138
+
139
+ /** Every `{ $chain: key }` sentinel nested in `value`, with its path. */
140
+ function collectChainSentinels(
141
+ value: unknown,
142
+ path: string,
143
+ found: { path: string; key: string }[],
144
+ ): void {
145
+ if (Array.isArray(value)) {
146
+ for (const [index, child] of value.entries()) {
147
+ collectChainSentinels(child, appendPath(path, index), found);
148
+ }
149
+ return;
150
+ }
151
+ if (!isPlainObject(value)) return;
152
+ if (Object.keys(value).length === 1 && typeof value.$chain === "string") {
153
+ found.push({ path, key: value.$chain });
154
+ return;
155
+ }
156
+ for (const [key, child] of Object.entries(value)) {
157
+ collectChainSentinels(child, appendPath(path, key), found);
158
+ }
159
+ }
160
+
161
+ /**
162
+ * Approval publishes `{ status, responses, resolvedBy }` to its own
163
+ * `props.onResolved` chain. An element-level `on.resolved` is never emitted
164
+ * (json-render resolves `on` params itself and cannot see `$chain`), and an
165
+ * unknown `$chain` key stays an unresolved sentinel that fails the step.
166
+ */
167
+ function approvalIssues(element: Record<string, unknown>, elementPath: string) {
168
+ const issues: AppValidationIssue[] = [];
169
+ if (isPlainObject(element.on) && Object.hasOwn(element.on, "resolved")) {
170
+ issues.push(
171
+ issue(
172
+ `${elementPath}.on.resolved`,
173
+ "Approval runs its resolved chain from props.onResolved, not on.resolved",
174
+ ),
175
+ );
176
+ }
177
+ const props = isPlainObject(element.props) ? element.props : {};
178
+ const found: { path: string; key: string }[] = [];
179
+ collectChainSentinels(props.onResolved, `${elementPath}.props.onResolved`, found);
180
+ for (const { path, key } of found) {
181
+ // `$chain` reads a JSON-pointer path: `responses/<questionId>` reaches one answer.
182
+ const head = key.replace(/^\//, "").split("/")[0]!;
183
+ if (key === "" || APPROVAL_CHAIN_KEYS.has(head)) continue;
184
+ issues.push(
185
+ issue(path, `unknown $chain key "${key}"; Approval publishes status, responses, resolvedBy`),
186
+ );
187
+ }
188
+ return issues;
189
+ }
190
+
92
191
  /** Every `[path, chain]` nested in an element's item-chain props. */
93
192
  function itemActionChains(type: unknown, props: Record<string, unknown>, propsPath: string) {
94
193
  const chains: { path: string; chain: unknown }[] = [];
@@ -477,6 +576,22 @@ function actionParams(
477
576
  issue(appendPath(paramsPath, "name"), `unknown app action "${String(params.name)}"`),
478
577
  );
479
578
  }
579
+ // Same rules as `SessionThread.sessionKey` / `scope`: the key lands in a
580
+ // server-built context key; a bound key is checked at send time.
581
+ const session = params.session;
582
+ if (isPlainObject(session)) {
583
+ const sessionPath = appendPath(paramsPath, "session");
584
+ if (typeof session.key === "string" && !SESSION_KEY.test(session.key)) {
585
+ result.issues.push(
586
+ issue(appendPath(sessionPath, "key"), "session key must match ^[A-Za-z0-9_-]{1,128}$"),
587
+ );
588
+ }
589
+ if (session.scope === "shared") {
590
+ result.issues.push(
591
+ issue(appendPath(sessionPath, "scope"), 'scope "shared" is not supported yet'),
592
+ );
593
+ }
594
+ }
480
595
  } else if (step.action === "ui.toast") {
481
596
  // The Undo chain runs through the same handlers as any other chain, so
482
597
  // its steps get the same per-action checks (models, queries, actions).
@@ -892,17 +1007,25 @@ export function crossPageDefinitionIssues(
892
1007
  });
893
1008
 
894
1009
  if (!isPlainObject(page.elements)) continue;
1010
+ const splitDrawers: string[] = [];
895
1011
  for (const [elementId, rawElement] of Object.entries(page.elements)) {
896
1012
  if (!isPlainObject(rawElement)) continue;
897
1013
  const elementPath = `${pagePath}.elements.${elementId}`;
898
- if (rawElement.type === "Drawer" && isPlainObject(rawElement.props)) {
1014
+ const panelType = typeof rawElement.type === "string" ? rawElement.type : "";
1015
+ if (ROUTE_PANEL_TYPES.has(panelType) && isPlainObject(rawElement.props)) {
1016
+ if (panelType === "Drawer" && rawElement.props.presentation === "split") {
1017
+ splitDrawers.push(elementPath);
1018
+ }
899
1019
  const paramPath = `${elementPath}.props.param`;
900
1020
  if (
901
1021
  Object.hasOwn(rawElement.props, "param") &&
902
1022
  typeof rawElement.props.param !== "string"
903
1023
  ) {
904
1024
  issues.push(
905
- issue(paramPath, "Drawer param must be a literal route param name (not a binding)"),
1025
+ issue(
1026
+ paramPath,
1027
+ `${panelType} param must be a literal route param name (not a binding)`,
1028
+ ),
906
1029
  );
907
1030
  } else if (
908
1031
  typeof rawElement.props.param === "string" &&
@@ -917,6 +1040,16 @@ export function crossPageDefinitionIssues(
917
1040
  }
918
1041
  }
919
1042
  }
1043
+ // One detail region per surface: a second split Drawer would fight the
1044
+ // first for the same pane.
1045
+ for (const path of splitDrawers.slice(1)) {
1046
+ issues.push(
1047
+ issue(
1048
+ `${path}.props.presentation`,
1049
+ `only one presentation: "split" Drawer per page (first: ${splitDrawers[0]})`,
1050
+ ),
1051
+ );
1052
+ }
920
1053
 
921
1054
  const refs: StateRef[] = [];
922
1055
  collectStateRefs(page, pagePath, refs);
@@ -1345,8 +1478,12 @@ function chartPropIssues(
1345
1478
  seen.add(entry.key);
1346
1479
  }
1347
1480
  }
1348
- if (typeof props.currency === "string" && !/^[A-Z]{3}$/.test(props.currency)) {
1349
- issues.push(issue(`${propsPath}.currency`, "must be an ISO 4217 code like USD"));
1481
+ if (
1482
+ (props.kind === "pie" || props.kind === "donut") &&
1483
+ Array.isArray(props.series) &&
1484
+ props.series.length !== 1
1485
+ ) {
1486
+ issues.push(issue(`${propsPath}.series`, `kind "${props.kind}" takes exactly one series`));
1350
1487
  }
1351
1488
  if (
1352
1489
  typeof props.height === "number" &&
@@ -1357,6 +1494,182 @@ function chartPropIssues(
1357
1494
  return issues;
1358
1495
  }
1359
1496
 
1497
+ const CURRENCY_CODE = /^[A-Z]{3}$/;
1498
+
1499
+ /**
1500
+ * Accordion children are positional (`children[i]` is the body of
1501
+ * `items[i]`), so the counts must match; item keys are unique, and
1502
+ * `defaultOpen` names only declared keys.
1503
+ */
1504
+ function accordionIssues(
1505
+ element: Record<string, unknown>,
1506
+ elementPath: string,
1507
+ ): AppValidationIssue[] {
1508
+ const issues: AppValidationIssue[] = [];
1509
+ const props = element.props as Record<string, unknown>;
1510
+ if (!Array.isArray(props.items)) return issues;
1511
+ const keys = props.items.map((item) => (isPlainObject(item) ? item.key : undefined));
1512
+ const childCount = Array.isArray(element.children) ? element.children.length : 0;
1513
+ if (childCount !== keys.length) {
1514
+ issues.push(
1515
+ issue(
1516
+ `${elementPath}.children`,
1517
+ `Accordion children are positional: ${keys.length} items need ${keys.length} children (got ${childCount})`,
1518
+ ),
1519
+ );
1520
+ }
1521
+ const seen = new Set<unknown>();
1522
+ for (const [index, key] of keys.entries()) {
1523
+ if (typeof key === "string" && seen.has(key)) {
1524
+ issues.push(issue(`${elementPath}.props.items.${index}.key`, `duplicate item key "${key}"`));
1525
+ }
1526
+ seen.add(key);
1527
+ }
1528
+ if (Array.isArray(props.defaultOpen)) {
1529
+ for (const [index, key] of props.defaultOpen.entries()) {
1530
+ if (typeof key === "string" && !seen.has(key)) {
1531
+ issues.push(
1532
+ issue(`${elementPath}.props.defaultOpen.${index}`, `unknown item key "${key}"`),
1533
+ );
1534
+ }
1535
+ }
1536
+ }
1537
+ return issues;
1538
+ }
1539
+
1540
+ /**
1541
+ * `currency` must be an ISO 4217 code: on Chart and Metric props, on Table
1542
+ * columns (and their popover fields) and on DetailList fields. The catalog
1543
+ * carries it as a JSON-schema `pattern`, which the generic walker skips.
1544
+ */
1545
+ function currencyIssues(
1546
+ type: unknown,
1547
+ props: Record<string, unknown>,
1548
+ elementPath: string,
1549
+ ): AppValidationIssue[] {
1550
+ const issues: AppValidationIssue[] = [];
1551
+ const check = (value: unknown, path: string) => {
1552
+ if (typeof value === "string" && !CURRENCY_CODE.test(value)) {
1553
+ issues.push(issue(path, `must be an ISO 4217 code like USD (got "${value}")`));
1554
+ }
1555
+ };
1556
+ const propsPath = `${elementPath}.props`;
1557
+ if (type === "Chart" || type === "Metric") check(props.currency, `${propsPath}.currency`);
1558
+ const listProp = type === "Table" ? "columns" : type === "DetailList" ? "fields" : null;
1559
+ if (!listProp || !Array.isArray(props[listProp])) return issues;
1560
+ for (const [index, entry] of (props[listProp] as unknown[]).entries()) {
1561
+ if (!isPlainObject(entry)) continue;
1562
+ const entryPath = `${propsPath}.${listProp}.${index}`;
1563
+ check(entry.currency, `${entryPath}.currency`);
1564
+ const popover = entry.popover;
1565
+ if (isPlainObject(popover) && Array.isArray(popover.fields)) {
1566
+ for (const [fieldIndex, field] of popover.fields.entries()) {
1567
+ if (isPlainObject(field)) {
1568
+ check(field.currency, `${entryPath}.popover.fields.${fieldIndex}.currency`);
1569
+ }
1570
+ }
1571
+ }
1572
+ }
1573
+ return issues;
1574
+ }
1575
+
1576
+ /** The `$row` fields `Files.onSelect` publishes. */
1577
+ const FILE_ROW_FIELDS = new Set(["path", "name", "type", "size", "modifiedAt"]);
1578
+
1579
+ function collectFileRowIssues(value: unknown, path: string, issues: AppValidationIssue[]): void {
1580
+ if (isPlainObject(value) && typeof value.$row === "string") {
1581
+ if (!FILE_ROW_FIELDS.has(value.$row)) {
1582
+ issues.push(
1583
+ issue(
1584
+ appendPath(path, "$row"),
1585
+ `unknown Files row field "${value.$row}" (one of ${[...FILE_ROW_FIELDS].join(", ")})`,
1586
+ ),
1587
+ );
1588
+ }
1589
+ return;
1590
+ }
1591
+ if (Array.isArray(value) || isPlainObject(value)) {
1592
+ for (const [key, child] of Object.entries(value)) {
1593
+ collectFileRowIssues(child, appendPath(path, key), issues);
1594
+ }
1595
+ }
1596
+ }
1597
+
1598
+ /**
1599
+ * `File` / `Files`: a literal `path` must be absolute without `..` segments.
1600
+ * Hygiene only: agent-fs drive membership is the access boundary.
1601
+ */
1602
+ function agentFsPropIssues(
1603
+ type: "File" | "Files",
1604
+ props: Record<string, unknown>,
1605
+ elementPath: string,
1606
+ ): AppValidationIssue[] {
1607
+ const issues: AppValidationIssue[] = [];
1608
+ const propsPath = `${elementPath}.props`;
1609
+ if (typeof props.path === "string" && !isAgentFsPath(props.path)) {
1610
+ issues.push(issue(`${propsPath}.path`, 'must be an absolute agent-fs path without ".."'));
1611
+ }
1612
+ if (type === "Files") collectFileRowIssues(props.onSelect, `${propsPath}.onSelect`, issues);
1613
+ return issues;
1614
+ }
1615
+
1616
+ /** `PageFrame.pageId` literal: a page id as the `/pages/:id` route takes it (no slugs). */
1617
+ const PAGE_FRAME_ID = /^[a-f0-9]{32}$/i;
1618
+
1619
+ function isAgentFsPath(value: string): boolean {
1620
+ return value.startsWith("/") && !value.split("/").includes("..");
1621
+ }
1622
+
1623
+ /**
1624
+ * Form `kind: "file"` fields: `dir` is required unless `source: "pick"`, and
1625
+ * a literal `dir` follows the `File` / `Files` path rules.
1626
+ */
1627
+ function formFileFieldIssues(
1628
+ props: Record<string, unknown>,
1629
+ elementPath: string,
1630
+ ): AppValidationIssue[] {
1631
+ const issues: AppValidationIssue[] = [];
1632
+ if (!Array.isArray(props.fields)) return issues;
1633
+ for (const [index, field] of props.fields.entries()) {
1634
+ if (!isPlainObject(field) || field.kind !== "file") continue;
1635
+ const fieldPath = `${elementPath}.props.fields.${index}`;
1636
+ if (field.dir === undefined && field.source !== "pick") {
1637
+ issues.push(issue(`${fieldPath}.dir`, 'is required for kind "file" unless source is "pick"'));
1638
+ } else if (typeof field.dir === "string" && !isAgentFsPath(field.dir)) {
1639
+ issues.push(issue(`${fieldPath}.dir`, 'must be an absolute agent-fs path without ".."'));
1640
+ }
1641
+ }
1642
+ return issues;
1643
+ }
1644
+
1645
+ /** `DateRange`: a plain-token id (it roots `/ui/<id>/from|to`) and a listed `defaultPreset`. */
1646
+ function dateRangePropIssues(
1647
+ props: Record<string, unknown>,
1648
+ elementPath: string,
1649
+ ): AppValidationIssue[] {
1650
+ const issues: AppValidationIssue[] = [];
1651
+ const propsPath = `${elementPath}.props`;
1652
+ if (
1653
+ typeof props.id === "string" &&
1654
+ (!SCHEMA_FORM_ID.test(props.id) || RESERVED_UI_IDS.has(props.id))
1655
+ ) {
1656
+ issues.push(
1657
+ issue(
1658
+ `${propsPath}.id`,
1659
+ "DateRange id must match ^[A-Za-z0-9_-]+$ and not be __proto__, constructor, or prototype",
1660
+ ),
1661
+ );
1662
+ }
1663
+ if (
1664
+ Array.isArray(props.presets) &&
1665
+ typeof props.defaultPreset === "string" &&
1666
+ !props.presets.includes(props.defaultPreset)
1667
+ ) {
1668
+ issues.push(issue(`${propsPath}.defaultPreset`, "must be one of the listed presets"));
1669
+ }
1670
+ return issues;
1671
+ }
1672
+
1360
1673
  /**
1361
1674
  * Sidebar-layout page metadata: `icon` from the catalog icon set, and
1362
1675
  * `headerActions` / `nav` only where the sidebar layout renders them.
@@ -1485,7 +1798,8 @@ export function validatePage(
1485
1798
  formIds.add(rawElement.props.id);
1486
1799
  }
1487
1800
  if (
1488
- type === "SchemaForm" &&
1801
+ typeof type === "string" &&
1802
+ PLAIN_TOKEN_ID_COMPONENTS.has(type) &&
1489
1803
  isPlainObject(rawElement.props) &&
1490
1804
  typeof rawElement.props.id === "string" &&
1491
1805
  (!SCHEMA_FORM_ID.test(rawElement.props.id) || RESERVED_UI_IDS.has(rawElement.props.id))
@@ -1493,10 +1807,13 @@ export function validatePage(
1493
1807
  issues.push(
1494
1808
  issue(
1495
1809
  `${propsPath}.id`,
1496
- "SchemaForm id must match ^[A-Za-z0-9_-]+$ and not be __proto__, constructor, or prototype",
1810
+ `${type} id must match ^[A-Za-z0-9_-]+$ and not be __proto__, constructor, or prototype`,
1497
1811
  ),
1498
1812
  );
1499
1813
  }
1814
+ if (type === "SessionThread" && isPlainObject(rawElement.props)) {
1815
+ issues.push(...sessionThreadIssues(rawElement.props, propsPath));
1816
+ }
1500
1817
  if (
1501
1818
  typeof type === "string" &&
1502
1819
  UI_STATE_COMPONENTS.has(type) &&
@@ -1527,6 +1844,21 @@ export function validatePage(
1527
1844
  }
1528
1845
  collectLinkFieldIssues(definition, type, rawElement.props, elementPath, issues);
1529
1846
  if (type === "Chart") issues.push(...chartPropIssues(rawElement.props, elementPath));
1847
+ issues.push(...currencyIssues(type, rawElement.props, elementPath));
1848
+ if (type === "Accordion") issues.push(...accordionIssues(rawElement, elementPath));
1849
+ if (type === "File" || type === "Files") {
1850
+ issues.push(...agentFsPropIssues(type, rawElement.props, elementPath));
1851
+ }
1852
+ if (
1853
+ type === "PageFrame" &&
1854
+ typeof rawElement.props.pageId === "string" &&
1855
+ rawElement.props.pageId !== "" &&
1856
+ !PAGE_FRAME_ID.test(rawElement.props.pageId)
1857
+ ) {
1858
+ issues.push(issue(`${elementPath}.props.pageId`, "must be a page id (32 hex characters)"));
1859
+ }
1860
+ if (type === "Form") issues.push(...formFileFieldIssues(rawElement.props, elementPath));
1861
+ if (type === "DateRange") issues.push(...dateRangePropIssues(rawElement.props, elementPath));
1530
1862
  if (type === "Table") {
1531
1863
  // Row selection lives at `/ui/<id>/selected`, so it needs an id to root it.
1532
1864
  const tableProps = rawElement.props;
@@ -1751,6 +2083,7 @@ export function validatePage(
1751
2083
  issues.push(...onResult.issues);
1752
2084
  stateRefs.push(...onResult.stateRefs);
1753
2085
  }
2086
+ if (type === "Approval") issues.push(...approvalIssues(rawElement, elementPath));
1754
2087
  if (Object.hasOwn(rawElement, "watch")) {
1755
2088
  const watchResult = validateActionMap(
1756
2089
  rawElement.watch,
package/src/assets/key.ts CHANGED
@@ -110,6 +110,12 @@ export const SESSION_LEAF_KINDS = ["task", "thread", ...SESSION_RESOURCE_KINDS]
110
110
  /** The leaves a namespace root (`shared/`, `personal/<me>/`) holds as No group. */
111
111
  export const NO_GROUP_LEAF_KINDS = ["task", "thread"] as const;
112
112
  const sessionLeafPattern = new RegExp(`/(${SESSION_LEAF_KINDS.join("|")}):[^/]+/$`);
113
+
114
+ /** A user group key excludes namespace roots and resource leaves. */
115
+ export function isGroupKey(key: string): boolean {
116
+ const parsed = parseAssetKey(key);
117
+ return parsed.relativeSegments.length > 0 && !sessionLeafPattern.test(parsed.key);
118
+ }
113
119
  const resourceGroupPattern = new RegExp(
114
120
  `^(shared/|personal/[^/]+/)((${SESSION_RESOURCE_KINDS.join("|")}):([^/]+))/(?:(action:[^/]+)/)?`,
115
121
  );
@@ -0,0 +1,186 @@
1
+ import { registerVolatileSecret, scrubSecrets } from "../utils/secret-scrubber";
2
+ import { getUserGrant } from "./rbac-roles";
3
+ import {
4
+ AgentFsRequestError,
5
+ agentFsRequest,
6
+ getCurrentOrgMembers,
7
+ inviteEmailToSharedOrg,
8
+ resolveAgentFsSharedContext,
9
+ resolveApiUrl,
10
+ roleRank,
11
+ } from "./seed/agent-fs-provision";
12
+ import { findUserById } from "./users";
13
+
14
+ type AccountState =
15
+ | { status: "off"; email?: string; reason: string }
16
+ | { status: "pending"; email: string; orgId?: string; driveId?: string; reason: string }
17
+ | {
18
+ status: "ready";
19
+ agentFsUserId: string;
20
+ email: string;
21
+ displayName?: string;
22
+ orgId: string;
23
+ driveId: string;
24
+ };
25
+
26
+ export class AgentFsKeyValidationError extends Error {}
27
+
28
+ export async function ensureUserAgentFsAccount(userId: string): Promise<AccountState> {
29
+ if (!(await resolveApiUrl())) {
30
+ return { status: "off", reason: "AGENT_FS_API_URL is not configured" };
31
+ }
32
+ const user = await findUserById(userId);
33
+ const email = user?.email?.trim() ?? "";
34
+ if (!user || !email) {
35
+ return { status: "pending", email, reason: "The swarm user is missing or has no email" };
36
+ }
37
+ const shared = await resolveAgentFsSharedContext();
38
+ if (!shared) return { status: "off", reason: "AGENT_FS_API_URL is not configured" };
39
+ const pending = (reason: string): AccountState => ({
40
+ status: "pending",
41
+ email,
42
+ orgId: shared.orgId,
43
+ driveId: shared.driveId,
44
+ reason: scrubSecrets(reason),
45
+ });
46
+ const grant = await getUserGrant(userId);
47
+ const role = grant.grantsAll || grant.verbs.has("task.fs.mutate") ? "editor" : "viewer";
48
+ const members = await getCurrentOrgMembers(shared.apiUrl, shared.authHeaders, shared.orgId);
49
+ let member = members.find((candidate) => candidate.email === email.toLowerCase());
50
+ // The primary key of an account this call registers. It is used only to
51
+ // accept the org invite below and is never stored or returned.
52
+ let registeredKey: string | undefined;
53
+ if (!member) {
54
+ try {
55
+ // Registration creates the account before the invite.
56
+ const registered = await agentFsRequest<{ apiKey?: unknown }>(
57
+ shared.apiUrl,
58
+ "/auth/register",
59
+ { method: "POST", body: { email } },
60
+ );
61
+ if (typeof registered?.apiKey === "string" && registered.apiKey) {
62
+ registeredKey = registered.apiKey;
63
+ registerVolatileSecret(registeredKey, "AGENT_FS_USER_PRIMARY_KEY");
64
+ }
65
+ } catch (error) {
66
+ if (!(error instanceof AgentFsRequestError) || error.status >= 500) throw error;
67
+ if (error.status !== 409) return pending(error.message);
68
+ }
69
+ }
70
+
71
+ if (!member || roleRank(member.role) < roleRank(role)) {
72
+ const invited = await inviteEmailToSharedOrg(email, role);
73
+ if (invited.status === "pending") {
74
+ // agent-fs >= 0.18.19 answers every account outside the org with a
75
+ // pending invite. An account the swarm registered in this call is ours,
76
+ // so accept with its own key. An account that existed before must
77
+ // accept the invite itself.
78
+ if (!registeredKey || !invited.token) return pending("The agent-fs org invite is pending");
79
+ try {
80
+ await agentFsRequest(
81
+ shared.apiUrl,
82
+ `/invites/${encodeURIComponent(invited.token)}/accept`,
83
+ {
84
+ method: "POST",
85
+ headers: { authorization: `Bearer ${registeredKey}` },
86
+ allowConflict: true,
87
+ },
88
+ );
89
+ } catch (error) {
90
+ // The request path carries the invite token: report without it.
91
+ if (error instanceof AgentFsRequestError && error.status < 500) {
92
+ return pending(`The agent-fs org invite could not be accepted: HTTP ${error.status}`);
93
+ }
94
+ throw new Error(
95
+ `agent-fs invite accept failed${error instanceof AgentFsRequestError ? `: HTTP ${error.status}` : ""}`,
96
+ );
97
+ }
98
+ }
99
+ member = (await getCurrentOrgMembers(shared.apiUrl, shared.authHeaders, shared.orgId)).find(
100
+ (candidate) => candidate.email === email.toLowerCase(),
101
+ );
102
+ }
103
+ if (!member?.userId || roleRank(member.role) < roleRank(role)) {
104
+ return pending("The agent-fs org membership is not ready");
105
+ }
106
+ // The swarm assigns only viewer and editor, so an editor whose grant dropped
107
+ // to viewer is lowered before a key is minted. An agent-fs admin is managed
108
+ // in agent-fs (it can be the owner of the bootstrap key) and keeps its role.
109
+ if (member.role !== "admin" && roleRank(member.role) > roleRank(role)) {
110
+ try {
111
+ await agentFsRequest(
112
+ shared.apiUrl,
113
+ `/orgs/${encodeURIComponent(shared.orgId)}/members/${encodeURIComponent(member.userId)}`,
114
+ { method: "PATCH", headers: shared.authHeaders, body: { role } },
115
+ );
116
+ } catch (error) {
117
+ if (!(error instanceof AgentFsRequestError) || error.status >= 500) throw error;
118
+ return pending(`The agent-fs org role could not be lowered to ${role}`);
119
+ }
120
+ }
121
+ return {
122
+ status: "ready",
123
+ agentFsUserId: member.userId,
124
+ email,
125
+ displayName: user.name,
126
+ orgId: shared.orgId,
127
+ driveId: shared.driveId,
128
+ };
129
+ }
130
+
131
+ export async function mintUserAgentFsKey(userId: string, label: string) {
132
+ const sanitized = Array.from(
133
+ label
134
+ .replace(/\p{Cc}/gu, "")
135
+ .replace(/\s+/gu, " ")
136
+ .trim(),
137
+ )
138
+ .slice(0, 100)
139
+ .join("");
140
+ if (!sanitized) throw new AgentFsKeyValidationError("The key label must contain visible text");
141
+ const account = await ensureUserAgentFsAccount(userId);
142
+ if (account.status !== "ready") return account;
143
+ const shared = await resolveAgentFsSharedContext();
144
+ if (!shared) return { status: "off" as const, reason: "AGENT_FS_API_URL is not configured" };
145
+ try {
146
+ const minted = await agentFsRequest<{ id: string; apiKey: string; label: string }>(
147
+ shared.apiUrl,
148
+ `/orgs/${encodeURIComponent(account.orgId)}/members/${encodeURIComponent(account.agentFsUserId)}/keys`,
149
+ { method: "POST", headers: shared.authHeaders, body: { label: sanitized } },
150
+ );
151
+ if (!minted.apiKey || !minted.id) throw new Error("agent-fs did not return a named key");
152
+ registerVolatileSecret(minted.apiKey, `AGENT_FS_USER_KEY:${minted.id}`);
153
+ return {
154
+ status: "minted" as const,
155
+ apiKey: minted.apiKey,
156
+ keyId: minted.id,
157
+ label: minted.label,
158
+ agentFsUserId: account.agentFsUserId,
159
+ orgId: account.orgId,
160
+ driveId: account.driveId,
161
+ };
162
+ } catch (error) {
163
+ if (error instanceof AgentFsRequestError && error.status === 404) {
164
+ let memberMissing = false;
165
+ try {
166
+ memberMissing = JSON.parse(error.body)?.error === "NOT_FOUND";
167
+ } catch {
168
+ // Older agent-fs versions return a plain-text 404 for the missing route.
169
+ }
170
+ if (memberMissing) {
171
+ return {
172
+ status: "pending" as const,
173
+ email: account.email,
174
+ orgId: account.orgId,
175
+ driveId: account.driveId,
176
+ reason: scrubSecrets(error.message),
177
+ };
178
+ }
179
+ return {
180
+ status: "unsupported" as const,
181
+ reason: "Named user keys require agent-fs 0.18.17 or later",
182
+ };
183
+ }
184
+ throw error;
185
+ }
186
+ }