@desplega.ai/agent-swarm 2.8.3 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (491) hide show
  1. package/dist/acp-adapter-jqn86aam.js +16 -0
  2. package/dist/acp-targets-swxq55dr.js +23 -0
  3. package/dist/{actions-ewz7bp4g.js → actions-pb678g3e.js} +20 -19
  4. package/dist/agent-fs-provision-dmhnc38q.js +27 -0
  5. package/dist/{amp-adapter-f25tqhnf.js → amp-adapter-3pa66q27.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-x2cp5fvf.js} +41 -41
  7. package/dist/{app-mkptw0k7.js → app-17d12ev4.js} +6 -4
  8. package/dist/approval-notifications-h7vd9pmg.js +20 -0
  9. package/dist/{assistant-c47rfe77.js → assistant-t7k39ree.js} +54 -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-0gqmkfbe.js} +1 -1
  12. package/dist/{boot-reembed-1ghy2sab.js → boot-reembed-f064w382.js} +1 -1
  13. package/dist/{boot-reembed-htr73hbs.js → boot-reembed-n6anc01d.js} +1 -1
  14. package/dist/{boot-scrub-sweep-yrytg42z.js → boot-scrub-sweep-ejd5dnrz.js} +84 -13
  15. package/dist/{boot-seeds-n2b3dx4e.js → boot-seeds-f99fjs5q.js} +4 -4
  16. package/dist/{boxd-jmfqgkqa.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-gvznwxgc.js +28 -0
  18. package/dist/{claude-managed-adapter-hddmxjyj.js → claude-managed-adapter-pbrbvc64.js} +4 -4
  19. package/dist/{claude-managed-setup-hfvry1bd.js → claude-managed-setup-kdxttvc3.js} +10 -10
  20. package/dist/{claude-sdk-session-0hamqzc7.js → claude-sdk-session-0t2teq6n.js} +9386 -9196
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-s8p8hhty.js → cli-1tvdx9t5.js} +2 -2
  23. package/dist/{cli-s7zz734a.js → cli-25nstr34.js} +1 -1
  24. package/dist/{cli-kw44j53p.js → cli-2kg31ted.js} +45 -38
  25. package/dist/{cli-mwwmka77.js → cli-2tnbc3gw.js} +375 -127
  26. package/dist/{cli-4dpkjc2e.js → cli-3zxdz9r7.js} +9 -9
  27. package/dist/{cli-mdpbjnzq.js → cli-4ghh072d.js} +14 -14
  28. package/dist/{cli-54qr8mcd.js → cli-57pvhnyt.js} +4 -4
  29. package/dist/{cli-f1kwb5fc.js → cli-5a6pqy45.js} +333 -21
  30. package/dist/{cli-93t5s4zq.js → cli-5gpqgs8b.js} +2 -2
  31. package/dist/{cli-4ax9mvvg.js → cli-5gygrr67.js} +9 -9
  32. package/dist/{cli-t5ys4ebm.js → cli-5kcmxwxv.js} +3 -3
  33. package/dist/{cli-k96cecs7.js → cli-5ntc4we6.js} +2948 -316
  34. package/dist/{cli-15204js0.js → cli-6237rnyr.js} +1 -1
  35. package/dist/cli-6dp0jkfj.js +754 -0
  36. package/dist/{cli-k2rw11py.js → cli-7831nhaw.js} +5 -5
  37. package/dist/{cli-7c5tgqhf.js → cli-7cgf614g.js} +10 -10
  38. package/dist/{cli-z8cvws4c.js → cli-7fx9jyfs.js} +852 -55
  39. package/dist/{cli-pe4d96rb.js → cli-7zm3b3f5.js} +1 -1
  40. package/dist/{cli-0bcgyj5b.js → cli-812paz57.js} +69 -6
  41. package/dist/{cli-ztq5z4e1.js → cli-8axx8vnw.js} +4 -4
  42. package/dist/cli-8x8y70av.js +103 -0
  43. package/dist/{cli-6yygkr0w.js → cli-95930z69.js} +15 -7
  44. package/dist/{cli-sdvcrq5x.js → cli-9a2rtd77.js} +16 -14
  45. package/dist/cli-9ttx00s3.js +137 -0
  46. package/dist/{cli-6ek0hff4.js → cli-a9hfzg2r.js} +3 -3
  47. package/dist/{cli-am1ptset.js → cli-aa8s22gn.js} +19 -14
  48. package/dist/{cli-4e1hfbpq.js → cli-bk9v1xrv.js} +19 -19
  49. package/dist/{cli-e2w34h6z.js → cli-c07v0qfa.js} +98 -54
  50. package/dist/{cli-dpsfwh7n.js → cli-c5cspahx.js} +24 -24
  51. package/dist/{cli-gpz1d0t2.js → cli-cw7mc1je.js} +4 -4
  52. package/dist/{cli-qmqt520k.js → cli-dd37e0cm.js} +2 -2
  53. package/dist/cli-dqgnbnxs.js +132 -0
  54. package/dist/{cli-tnzebztn.js → cli-dx439zpg.js} +1 -1
  55. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  56. package/dist/{cli-knva3nmx.js → cli-e9973bf0.js} +8 -6
  57. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  58. package/dist/{cli-crpf163n.js → cli-eepnpee7.js} +16 -26
  59. package/dist/{cli-nx2n3z6p.js → cli-eg437b5p.js} +1 -1
  60. package/dist/{cli-zdaypkq9.js → cli-faf46gdq.js} +285 -97
  61. package/dist/{cli-tas6ckky.js → cli-fgphc007.js} +2 -2
  62. package/dist/{cli-sg27rk2t.js → cli-fnh4b12r.js} +24 -18
  63. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  64. package/dist/{cli-rqfvkx5t.js → cli-g3zzby8t.js} +13 -13
  65. package/dist/{cli-kd56bmk4.js → cli-gabsjg8x.js} +3 -1
  66. package/dist/{cli-tf79ryyy.js → cli-gddgcnav.js} +3 -3
  67. package/dist/{cli-rjvsf9qa.js → cli-h474mvp5.js} +11 -11
  68. package/dist/{cli-5a7szzfh.js → cli-hnamkvnc.js} +2 -2
  69. package/dist/{cli-8bpgbr8k.js → cli-j49yqpvh.js} +6 -6
  70. package/dist/{cli-awwptga4.js → cli-jd3kxppb.js} +1 -1
  71. package/dist/{cli-1m96dc36.js → cli-js8zrfyg.js} +3 -3
  72. package/dist/{cli-vx421edw.js → cli-k09cxm6m.js} +9 -7
  73. package/dist/{cli-n5t077me.js → cli-k7pt28ad.js} +10 -3
  74. package/dist/{cli-922z7gwm.js → cli-kaa4bd7x.js} +9 -6
  75. package/dist/cli-kj0hyr43.js +51 -0
  76. package/dist/{cli-c0xjnr8z.js → cli-kmvcm34h.js} +2 -2
  77. package/dist/{cli-0vksaxvr.js → cli-kqh27v2y.js} +2 -2
  78. package/dist/{cli-bj6qhgte.js → cli-m1fbz2wj.js} +30 -37
  79. package/dist/{cli-me0r8gzr.js → cli-mc1fx4xd.js} +27 -25
  80. package/dist/{cli-qps8je6j.js → cli-me4maa4j.js} +46 -6
  81. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  82. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  83. package/dist/{cli-yss07azk.js → cli-nhq5js1b.js} +3 -3
  84. package/dist/cli-nmcpzbty.js +296 -0
  85. package/dist/cli-nr46j5pw.js +78 -0
  86. package/dist/{cli-t4dv07kr.js → cli-pn1v1pb0.js} +1 -1
  87. package/dist/{cli-c71n3bxq.js → cli-pwsax0vp.js} +2 -2
  88. package/dist/{cli-9zmb7ptc.js → cli-pz1c00aa.js} +8 -753
  89. package/dist/{cli-emekyyhr.js → cli-q2d3e1k1.js} +1 -1
  90. package/dist/{cli-zeaehgyd.js → cli-q8cfh1t9.js} +2 -2
  91. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  92. package/dist/{cli-2d0cghfn.js → cli-qj39vrc6.js} +1 -1
  93. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  94. package/dist/{cli-gn9y6fn7.js → cli-rts1qvb4.js} +2 -2
  95. package/dist/{cli-pxwtcgcp.js → cli-sn4pc4qx.js} +2 -2
  96. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  97. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  98. package/dist/{cli-6wj7p986.js → cli-spzkdgtg.js} +3 -3
  99. package/dist/{cli-m2z8jagn.js → cli-srtkr1h2.js} +18 -18
  100. package/dist/{cli-8476gtwf.js → cli-ssvdrk4y.js} +1 -1
  101. package/dist/{cli-c3ng0mb4.js → cli-svc803vq.js} +69 -816
  102. package/dist/{cli-500c09j9.js → cli-t9ga4qmb.js} +14 -14
  103. package/dist/{cli-j8cjdzan.js → cli-vs9vdpy0.js} +1 -1
  104. package/dist/{cli-bhsfbmk8.js → cli-vvgaz8t6.js} +93 -44
  105. package/dist/{cli-kmemts3w.js → cli-vw5x18yj.js} +39 -69
  106. package/dist/{cli-x3ex5bqf.js → cli-w16kwbzw.js} +1 -1
  107. package/dist/cli-w7dxb2fj.js +921 -0
  108. package/dist/{cli-x6t50dmw.js → cli-wr1h0k28.js} +3 -3
  109. package/dist/{cli-skmhsnqh.js → cli-x40a0w9j.js} +1 -1
  110. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  111. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  112. package/dist/{cli-h9yy18gy.js → cli-ymct0ycy.js} +262 -100
  113. package/dist/{cli-dtdht77h.js → cli-zg3z63x3.js} +2 -2
  114. package/dist/cli.js +27 -24
  115. package/dist/{codex-adapter-2brxx5ta.js → codex-adapter-44yq2fkn.js} +9 -8
  116. package/dist/{codex-hook-c930c3ea.js → codex-hook-h1zb7cfk.js} +6 -6
  117. package/dist/{codex-login-cbrs1h5w.js → codex-login-cdyrr5y1.js} +1 -1
  118. package/dist/{codex-session-runner-y9anfj0r.js → codex-session-runner-zbh26gbw.js} +10 -9
  119. package/dist/{commands-wn9q06qr.js → commands-54f02v5b.js} +3 -3
  120. package/dist/{controller-fw608czd.js → controller-9gpwcdek.js} +6 -6
  121. package/dist/{controllers-connect-63j5rdcm.js → controllers-connect-61re6k1n.js} +26 -25
  122. package/dist/{cursor-adapter-6mb9jme8.js → cursor-adapter-7e4g81vd.js} +2 -2
  123. package/dist/{db-y4wfrzbm.js → db-dg2gc7fd.js} +15 -13
  124. package/dist/{db-0m6v5tq4.js → db-wnh0qjy1.js} +3 -3
  125. package/dist/{devin-adapter-r0yx3gv8.js → devin-adapter-zp4tqq53.js} +1 -1
  126. package/dist/{dispatcher-9tq2zzdj.js → dispatcher-jrm24r43.js} +19 -18
  127. package/dist/{docker-j75atvpt.js → docker-9aq30pp2.js} +5 -5
  128. package/dist/{dsh-adapter-t09sv4tq.js → dsh-adapter-1yqk267c.js} +2 -2
  129. package/dist/{e2b-a7vzs2vj.js → e2b-3v1e745x.js} +6 -6
  130. package/dist/{e2b-7s9dscap.js → e2b-sm28k0k3.js} +6 -6
  131. package/dist/{easter-egg-3d-fbwvmwhe.js → easter-egg-3d-r4h9cs9m.js} +1 -1
  132. package/dist/{embedding-space-wh8de1t9.js → embedding-space-bafjr5f7.js} +6 -6
  133. package/dist/{embeddings-3hpbdtjr.js → embeddings-7xmgqe0e.js} +1 -1
  134. package/dist/{event-bus-tr6h3gv8.js → event-bus-xr83x566.js} +1 -1
  135. package/dist/{execute-4bdf8sdy.js → execute-d6jg5ns0.js} +1 -1
  136. package/dist/{external-channel-ts2fwqh0.js → external-channel-frq1xvq2.js} +2 -2
  137. package/dist/fx-adapter-0zrkfbkd.js +19 -0
  138. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  139. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  140. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  141. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  142. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  143. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-hh7strj3.js} +1 -1
  144. package/dist/{google-vertex-fhxaafzw.js → google-vertex-fy5bw2pm.js} +5 -5
  145. package/dist/grok-adapter-3db1c538.js +19 -0
  146. package/dist/handlers-k22n8mnn.js +33 -0
  147. package/dist/{heartbeat-2ze5fzpc.js → heartbeat-6bpa611t.js} +22 -21
  148. package/dist/{hook-ca54yd4s.js → hook-hvm5nf46.js} +5 -5
  149. package/dist/{hook-gaehe2w5.js → hook-w12k146y.js} +14 -14
  150. package/dist/{http-jfg8t2yk.js → http-43tthdvs.js} +1684 -509
  151. package/dist/{index-d6wkh8ar.js → index-1f0vypbg.js} +2 -2
  152. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  153. package/dist/{index-khe3gp0k.js → index-4b1q8kan.js} +20 -20
  154. package/dist/{index-hjhfk3ra.js → index-585gyczt.js} +1 -1
  155. package/dist/index-8xcyd3mc.js +33 -0
  156. package/dist/index-9sy2bh6n.js +38 -0
  157. package/dist/{index-2skqtd76.js → index-b24j7t2m.js} +30 -28
  158. package/dist/{index-gjwaqaq8.js → index-cret47a5.js} +6 -6
  159. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  160. package/dist/{index-csgrxedz.js → index-fn054vsf.js} +1 -1
  161. package/dist/{index-3yvzbhxd.js → index-ftywhyr0.js} +129 -142
  162. package/dist/{index-3gv6sc4z.js → index-mhq4sh5w.js} +1 -1
  163. package/dist/index-tx9mc2ap.js +570 -0
  164. package/dist/index-wjd56k1v.js +34 -0
  165. package/dist/{keepalive-k2a3qe73.js → keepalive-rk0j0jvh.js} +4 -4
  166. package/dist/lead-atxf3q6e.js +72 -0
  167. package/dist/{maintenance-gb5sd5nc.js → maintenance-g6z6kaxw.js} +1 -1
  168. package/dist/{node-252anz2h.js → node-jftbyawr.js} +4 -4
  169. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  170. package/dist/{oauth-refresh-sweep-y7rm6bkb.js → oauth-refresh-sweep-2k3g2q4w.js} +3 -3
  171. package/dist/{onboard-jmc5qerv.js → onboard-6fdbvh3v.js} +8 -8
  172. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  173. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  174. package/dist/{opencode-adapter-7eade9ev.js → opencode-adapter-fdbsvts7.js} +7 -6
  175. package/dist/{otel-impl-8j1xhxqd.js → otel-impl-rvwtc09q.js} +110 -110
  176. package/dist/pending-sqkrb836.js +80 -0
  177. package/dist/{pi-mono-adapter-yqmaf32x.js → pi-mono-adapter-asqayqcg.js} +12 -12
  178. package/dist/{pricing-refresh-1nj722h6.js → pricing-refresh-f5tkgmw2.js} +2 -2
  179. package/dist/{rbac-roles-b1mtr6dr.js → rbac-roles-06s555fa.js} +3 -3
  180. package/dist/{rbac-roles-n1f3frk1.js → rbac-roles-szxsg8t1.js} +10 -3
  181. package/dist/{render-v2-1gfpd8rj.js → render-v2-103p266q.js} +4 -4
  182. package/dist/{resume-w1s1eh5v.js → resume-v7kjewt9.js} +8 -7
  183. package/dist/{runtime-84g5egsc.js → runtime-f1gmk0b7.js} +1 -1
  184. package/dist/{session-access-y6z1txk4.js → session-access-6shev8ts.js} +4 -4
  185. package/dist/{session-source-backfill-gxxwfh12.js → session-source-backfill-bd7spzjd.js} +3 -3
  186. package/dist/{setup-r91gstyk.js → setup-kmxmztdb.js} +1 -1
  187. package/dist/thread-buffer-4yz236d0.js +36 -0
  188. package/dist/{virtual-modules-cgnj6kme.js → virtual-modules-57eje5wy.js} +5 -5
  189. package/dist/{work-objects-qcxzg61c.js → work-objects-zr47ygmf.js} +23 -21
  190. package/dist/{worker-follow-up-y2d2h7km.js → worker-follow-up-grrr3fda.js} +19 -18
  191. package/dist/worker-p4hbtcy3.js +72 -0
  192. package/dist/{x-qhxq2ama.js → x-wg164ss9.js} +2 -2
  193. package/openapi.json +1211 -155
  194. package/package.json +9 -6
  195. package/plugin/commands/create-pr.md +1 -1
  196. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  197. package/src/apps/action-runner.ts +21 -1
  198. package/src/apps/catalog.generated.json +626 -17
  199. package/src/apps/page-validator.ts +314 -8
  200. package/src/assets/key.ts +6 -0
  201. package/src/be/agent-fs-user-keys.ts +186 -0
  202. package/src/be/audit-user.ts +27 -13
  203. package/src/be/automation-preflight.test.ts +14 -14
  204. package/src/be/automation-preflight.ts +24 -16
  205. package/src/be/boot-scrub-sweep.ts +143 -14
  206. package/src/be/caller-session-group.ts +86 -0
  207. package/src/be/checklist.ts +375 -0
  208. package/src/be/db/agents.ts +12 -1
  209. package/src/be/db/approvals.ts +26 -0
  210. package/src/be/db/session-moves.ts +23 -0
  211. package/src/be/db/session-tree.ts +78 -19
  212. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  213. package/src/be/db/tasks/slack-fold.ts +116 -0
  214. package/src/be/db/tasks/write.ts +34 -0
  215. package/src/be/db-queries/mcp-servers.ts +13 -0
  216. package/src/be/db-queries/oauth.ts +6 -0
  217. package/src/be/db-queries/task-artifacts.ts +10 -8
  218. package/src/be/db.ts +42 -15
  219. package/src/be/extensions/assets.ts +17 -13
  220. package/src/be/import/config.ts +54 -0
  221. package/src/be/import/dir-source.ts +372 -0
  222. package/src/be/import/index.ts +149 -0
  223. package/src/be/import/pending.ts +71 -0
  224. package/src/be/import/schema.ts +137 -0
  225. package/src/be/import/seeders.ts +462 -0
  226. package/src/be/migrations/297_import_ownership.sql +34 -0
  227. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  228. package/src/be/migrations/302_checklist_items.sql +23 -0
  229. package/src/be/multi-runtime.ts +8 -1
  230. package/src/be/rbac-roles.ts +8 -1
  231. package/src/be/runtime-pools/demand.ts +20 -2
  232. package/src/be/runtime-pools/reachability.ts +31 -0
  233. package/src/be/runtime-pools/routing.ts +8 -1
  234. package/src/be/runtime-pools/supervisor.ts +6 -7
  235. package/src/be/savings/read.ts +8 -6
  236. package/src/be/script-credential-broker.ts +2 -2
  237. package/src/be/scripts/typecheck.ts +4 -4
  238. package/src/be/seed/agent-fs-provision.ts +104 -19
  239. package/src/be/seed/index.ts +1 -1
  240. package/src/be/seed/registry.ts +27 -8
  241. package/src/be/seed/runner.ts +1 -1
  242. package/src/be/seed/schedules-seeder.ts +24 -6
  243. package/src/be/seed/seed-toggle.ts +32 -0
  244. package/src/be/seed/types.ts +6 -0
  245. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  246. package/src/be/steering.ts +27 -4
  247. package/src/be/swarm-config-guard.ts +30 -0
  248. package/src/be/task-citations.ts +8 -5
  249. package/src/commands/onboard/agent-fs-version.ts +1 -1
  250. package/src/commands/runner.ts +61 -2
  251. package/src/e2b/env.ts +2 -0
  252. package/src/extensions/catalog.generated.json +17 -0
  253. package/src/extensions/contract-types.generated.ts +1 -1
  254. package/src/github/app.ts +10 -1
  255. package/src/github/handlers.ts +6 -3
  256. package/src/github/reactions.ts +12 -14
  257. package/src/heartbeat/heartbeat.ts +14 -4
  258. package/src/http/agents.ts +19 -10
  259. package/src/http/all-routes.ts +2 -0
  260. package/src/http/approval-requests.ts +24 -4
  261. package/src/http/apps.ts +69 -5
  262. package/src/http/checklist.ts +176 -0
  263. package/src/http/db-query-bounded.ts +256 -11
  264. package/src/http/db-query-shared.ts +9 -0
  265. package/src/http/favorites.ts +14 -2
  266. package/src/http/fs.ts +346 -1
  267. package/src/http/index.ts +29 -1
  268. package/src/http/kv.ts +13 -0
  269. package/src/http/mcp-oauth.ts +1 -1
  270. package/src/http/mcp-servers.ts +15 -2
  271. package/src/http/onboarding.ts +2 -9
  272. package/src/http/poll.ts +45 -0
  273. package/src/http/script-connections.ts +1 -0
  274. package/src/http/sessions.ts +17 -0
  275. package/src/http/slack-events.ts +101 -0
  276. package/src/http/status.ts +25 -7
  277. package/src/http/task-requester.ts +46 -0
  278. package/src/http/tasks.ts +64 -37
  279. package/src/http/users.ts +14 -0
  280. package/src/http/webhooks.ts +15 -0
  281. package/src/integrations/cards/index.ts +151 -0
  282. package/src/integrations/chat-sdk/outbound.ts +39 -13
  283. package/src/integrations/chat-sdk/runtime.ts +7 -1
  284. package/src/integrations/chat-sdk/status.ts +17 -0
  285. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  286. package/src/kv-reserved-namespaces.ts +17 -2
  287. package/src/oauth/presets.ts +29 -2
  288. package/src/prompts/base-prompt.ts +17 -4
  289. package/src/prompts/session-templates.ts +83 -6
  290. package/src/providers/acp-targets.ts +1 -1
  291. package/src/providers/amp-adapter.ts +1 -1
  292. package/src/providers/claude-managed-adapter.ts +5 -1
  293. package/src/providers/codex-adapter.ts +1 -1
  294. package/src/providers/codex-app-server.ts +2 -11
  295. package/src/providers/opencode-adapter.ts +7 -19
  296. package/src/providers/runtime-dependencies.ts +158 -0
  297. package/src/rbac/legacy-policy.ts +2 -0
  298. package/src/rbac/permissions.ts +10 -1
  299. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  300. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  301. package/src/scripts-runtime/egress-secrets.ts +2 -2
  302. package/src/scripts-runtime/swarm-sdk.ts +3 -2
  303. package/src/scripts-runtime/types/stdlib.d.ts +11 -4
  304. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -1
  305. package/src/scripts-runtime/types/swarm-sdk.d.ts +11 -4
  306. package/src/server.ts +4 -4
  307. package/src/slack/app.ts +87 -46
  308. package/src/slack/assistant.ts +33 -7
  309. package/src/slack/handlers.ts +6 -4
  310. package/src/slack/http-receiver.ts +284 -0
  311. package/src/slack/inbound-dispatch.ts +43 -7
  312. package/src/slack/inbound-files.ts +33 -14
  313. package/src/slack/message-text.ts +47 -4
  314. package/src/slack/render-v2.ts +2 -1
  315. package/src/slack/socket-ack.ts +17 -10
  316. package/src/slack/steering.ts +5 -0
  317. package/src/slack/thread-buffer-store.ts +58 -0
  318. package/src/slack/thread-buffer.ts +341 -57
  319. package/src/tasks/context-key.ts +24 -0
  320. package/src/tasks/sibling-awareness.ts +13 -1
  321. package/src/tests/agent-fs-live-url.test.ts +15 -0
  322. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  323. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  324. package/src/tests/agentfs-proxy.test.ts +8 -8
  325. package/src/tests/approval-card-resolution.test.ts +396 -0
  326. package/src/tests/approval-requests-notifications.test.ts +1 -1
  327. package/src/tests/approval-respond-auth.test.ts +28 -0
  328. package/src/tests/apps-action-parent-task.test.ts +140 -0
  329. package/src/tests/apps-catalog-additions.test.ts +315 -0
  330. package/src/tests/apps-catalog-files.test.ts +114 -0
  331. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  332. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  333. package/src/tests/apps-catalog-table.test.ts +47 -0
  334. package/src/tests/apps-chart-shell.test.ts +1 -1
  335. package/src/tests/apps-element-assembly.test.ts +52 -3
  336. package/src/tests/apps-session-thread.test.ts +182 -0
  337. package/src/tests/asset-key-invariants.test.ts +14 -0
  338. package/src/tests/base-prompt.test.ts +107 -23
  339. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  340. package/src/tests/caller-session-group.test.ts +199 -0
  341. package/src/tests/cards.test.ts +169 -0
  342. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  343. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  344. package/src/tests/chat-sdk-tools.test.ts +147 -0
  345. package/src/tests/checklist-nudge.test.ts +208 -0
  346. package/src/tests/checklist.test.ts +686 -0
  347. package/src/tests/codex-app-server.test.ts +16 -0
  348. package/src/tests/comb-config-guard.test.ts +21 -0
  349. package/src/tests/comb-default.test.ts +59 -97
  350. package/src/tests/comb-links.test.ts +86 -16
  351. package/src/tests/comb-status.test.ts +24 -27
  352. package/src/tests/create-page-tool.test.ts +101 -1
  353. package/src/tests/create-schedule-key.test.ts +105 -0
  354. package/src/tests/credential-broker.test.ts +2 -2
  355. package/src/tests/db-query.test.ts +87 -1
  356. package/src/tests/db-task-read-contract.test.ts +1 -0
  357. package/src/tests/db-task-write-contract.test.ts +2 -1
  358. package/src/tests/docs-index-footprint.test.js +3 -3
  359. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  360. package/src/tests/extensions-assets.test.ts +7 -3
  361. package/src/tests/extensions-catalog.test.ts +1 -0
  362. package/src/tests/extensions-example-sql-admin-only.test.ts +198 -0
  363. package/src/tests/extensions-pre-task.test.ts +3 -3
  364. package/src/tests/extensions-steering.test.ts +14 -2
  365. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  366. package/src/tests/fetch-resolved-env.test.ts +68 -0
  367. package/src/tests/fixtures/import-package.ts +32 -0
  368. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  369. package/src/tests/fs-routes.test.ts +505 -2
  370. package/src/tests/github-ghes-mock.test.ts +196 -0
  371. package/src/tests/github-host.test.ts +285 -0
  372. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  373. package/src/tests/heartbeat.test.ts +56 -0
  374. package/src/tests/import-config.test.ts +209 -0
  375. package/src/tests/import.test.ts +464 -0
  376. package/src/tests/invites-http.test.ts +144 -1
  377. package/src/tests/kv-http.test.ts +11 -0
  378. package/src/tests/literal-matcher.test.ts +58 -0
  379. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  380. package/src/tests/oauth-presets.test.ts +12 -0
  381. package/src/tests/pool-affinity.test.ts +50 -0
  382. package/src/tests/prompt-template-session.test.ts +52 -5
  383. package/src/tests/provider-registration.test.ts +2 -55
  384. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  385. package/src/tests/rbac-admission.test.ts +19 -0
  386. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  387. package/src/tests/rbac-engine.test.ts +2 -0
  388. package/src/tests/rbac-roles.test.ts +2 -0
  389. package/src/tests/runner-missing-dependency.test.ts +61 -0
  390. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  391. package/src/tests/runtime-pool-routing.test.ts +52 -0
  392. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  393. package/src/tests/savings-fleet-slices.test.ts +122 -0
  394. package/src/tests/savings-read.test.ts +41 -0
  395. package/src/tests/savings-scripts.test.ts +9 -3
  396. package/src/tests/script-connections.test.ts +2 -0
  397. package/src/tests/script-executor-conformance.test.ts +41 -4
  398. package/src/tests/secret-scrub-gate.test.ts +257 -0
  399. package/src/tests/seed-registry.test.ts +142 -9
  400. package/src/tests/session-source-keys.test.ts +42 -1
  401. package/src/tests/sessions-move.test.ts +70 -0
  402. package/src/tests/sessions-tree.test.ts +98 -0
  403. package/src/tests/sessions.test.ts +69 -0
  404. package/src/tests/slack-config.test.ts +4 -18
  405. package/src/tests/slack-http-receiver.test.ts +472 -0
  406. package/src/tests/slack-inbound-logging.test.ts +64 -0
  407. package/src/tests/slack-leave-thread.test.ts +1 -1
  408. package/src/tests/slack-message-text.test.ts +104 -0
  409. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  410. package/src/tests/slack-render-v2.test.ts +48 -0
  411. package/src/tests/slack-skip-reaction.test.ts +2 -2
  412. package/src/tests/slack-steering.test.ts +22 -10
  413. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  414. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  415. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  416. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  417. package/src/tests/slack-thread-buffer.test.ts +34 -34
  418. package/src/tests/slack-thread-participants.test.ts +23 -5
  419. package/src/tests/slack-tool-blocks.test.ts +167 -0
  420. package/src/tests/status.test.ts +32 -6
  421. package/src/tests/steering-core.test.ts +13 -0
  422. package/src/tests/steering-enabled.test.ts +7 -1
  423. package/src/tests/steering-promotion.test.ts +24 -0
  424. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  425. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  426. package/src/tests/task-artifacts.test.ts +50 -0
  427. package/src/tests/task-session-prompts.test.ts +95 -1
  428. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  429. package/src/tools/chat-post.ts +19 -4
  430. package/src/tools/chat-reply.ts +20 -4
  431. package/src/tools/create-page.ts +21 -4
  432. package/src/tools/get-swarm.ts +18 -2
  433. package/src/tools/join-swarm.ts +2 -1
  434. package/src/tools/kv/kv-write-auth.ts +17 -1
  435. package/src/tools/schedules/create-schedule.ts +22 -4
  436. package/src/tools/slack-post.ts +40 -7
  437. package/src/tools/slack-reply.ts +50 -14
  438. package/src/types.ts +43 -2
  439. package/src/utils/constants.ts +60 -138
  440. package/src/utils/github-host.ts +217 -0
  441. package/src/utils/github-pull-request.ts +8 -5
  442. package/src/utils/literal-matcher.ts +118 -0
  443. package/src/utils/secret-scrubber.ts +331 -25
  444. package/src/utils/task-attachment-links.ts +9 -12
  445. package/src/vcs/index.ts +3 -0
  446. package/src/workflows/approval-notifications.ts +188 -12
  447. package/src/workflows/executors/system-one-extraction.ts +14 -7
  448. package/src/workflows/executors/system-one-providers.ts +22 -1
  449. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  450. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  451. package/templates/extensions/README.md +1 -0
  452. package/templates/extensions/sql-admin-only/README.md +19 -0
  453. package/templates/extensions/sql-admin-only/hooks.ts +96 -0
  454. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  455. package/templates/import/manifest.schema.json +136 -0
  456. package/templates/import/sources.schema.json +44 -0
  457. package/templates/skills/agent-browser/SKILL.md +1 -1
  458. package/templates/skills/agent-browser/content.md +1 -1
  459. package/templates/skills/apps/SKILL.md +122 -12
  460. package/templates/skills/apps/content.md +122 -12
  461. package/templates/skills/asset-namespaces/content.md +2 -1
  462. package/templates/skills/chat-sdk/content.md +17 -0
  463. package/templates/skills/db-query-guidance/content.md +2 -1
  464. package/templates/skills/scheduling/content.md +27 -0
  465. package/templates/skills/slack-interaction/content.md +12 -2
  466. package/templates/skills/swarm-docs/content.md +1 -0
  467. package/templates/skills/swarm-extensions/config.json +1 -1
  468. package/templates/skills/swarm-extensions/content.md +33 -23
  469. package/templates/skills/swarm-scripts/SKILL.md +13 -0
  470. package/templates/skills/swarm-scripts/content.md +13 -0
  471. package/templates/skills/work-on-task/SKILL.md +1 -1
  472. package/templates/skills/work-on-task/content.md +1 -1
  473. package/templates/skills/workflow-iterate/content.md +4 -7
  474. package/templates/workflows/dreaming/content.md +2 -2
  475. package/dist/acp-adapter-xq6s2z6t.js +0 -14
  476. package/dist/claude-adapter-r33pqnzx.js +0 -24
  477. package/dist/cli-dns0y538.js +0 -194
  478. package/dist/fx-adapter-1rnxnf56.js +0 -17
  479. package/dist/grok-adapter-efhmf1r8.js +0 -17
  480. package/dist/handlers-anrr3py9.js +0 -32
  481. package/dist/index-8w2aznds.js +0 -33
  482. package/dist/index-qnjvr362.js +0 -37
  483. package/dist/index-yzxd3sn9.js +0 -32
  484. package/dist/lead-zhxqbfdv.js +0 -69
  485. package/dist/worker-7j2907g6.js +0 -69
  486. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  487. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  488. package/dist/{index-0rvk3vd4.js → index-bs7gw5fd.js} +3 -3
  489. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  490. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  491. 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 }[] = [];
@@ -892,17 +991,25 @@ export function crossPageDefinitionIssues(
892
991
  });
893
992
 
894
993
  if (!isPlainObject(page.elements)) continue;
994
+ const splitDrawers: string[] = [];
895
995
  for (const [elementId, rawElement] of Object.entries(page.elements)) {
896
996
  if (!isPlainObject(rawElement)) continue;
897
997
  const elementPath = `${pagePath}.elements.${elementId}`;
898
- if (rawElement.type === "Drawer" && isPlainObject(rawElement.props)) {
998
+ const panelType = typeof rawElement.type === "string" ? rawElement.type : "";
999
+ if (ROUTE_PANEL_TYPES.has(panelType) && isPlainObject(rawElement.props)) {
1000
+ if (panelType === "Drawer" && rawElement.props.presentation === "split") {
1001
+ splitDrawers.push(elementPath);
1002
+ }
899
1003
  const paramPath = `${elementPath}.props.param`;
900
1004
  if (
901
1005
  Object.hasOwn(rawElement.props, "param") &&
902
1006
  typeof rawElement.props.param !== "string"
903
1007
  ) {
904
1008
  issues.push(
905
- issue(paramPath, "Drawer param must be a literal route param name (not a binding)"),
1009
+ issue(
1010
+ paramPath,
1011
+ `${panelType} param must be a literal route param name (not a binding)`,
1012
+ ),
906
1013
  );
907
1014
  } else if (
908
1015
  typeof rawElement.props.param === "string" &&
@@ -917,6 +1024,16 @@ export function crossPageDefinitionIssues(
917
1024
  }
918
1025
  }
919
1026
  }
1027
+ // One detail region per surface: a second split Drawer would fight the
1028
+ // first for the same pane.
1029
+ for (const path of splitDrawers.slice(1)) {
1030
+ issues.push(
1031
+ issue(
1032
+ `${path}.props.presentation`,
1033
+ `only one presentation: "split" Drawer per page (first: ${splitDrawers[0]})`,
1034
+ ),
1035
+ );
1036
+ }
920
1037
 
921
1038
  const refs: StateRef[] = [];
922
1039
  collectStateRefs(page, pagePath, refs);
@@ -1345,8 +1462,12 @@ function chartPropIssues(
1345
1462
  seen.add(entry.key);
1346
1463
  }
1347
1464
  }
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"));
1465
+ if (
1466
+ (props.kind === "pie" || props.kind === "donut") &&
1467
+ Array.isArray(props.series) &&
1468
+ props.series.length !== 1
1469
+ ) {
1470
+ issues.push(issue(`${propsPath}.series`, `kind "${props.kind}" takes exactly one series`));
1350
1471
  }
1351
1472
  if (
1352
1473
  typeof props.height === "number" &&
@@ -1357,6 +1478,179 @@ function chartPropIssues(
1357
1478
  return issues;
1358
1479
  }
1359
1480
 
1481
+ const CURRENCY_CODE = /^[A-Z]{3}$/;
1482
+
1483
+ /**
1484
+ * Accordion children are positional (`children[i]` is the body of
1485
+ * `items[i]`), so the counts must match; item keys are unique, and
1486
+ * `defaultOpen` names only declared keys.
1487
+ */
1488
+ function accordionIssues(
1489
+ element: Record<string, unknown>,
1490
+ elementPath: string,
1491
+ ): AppValidationIssue[] {
1492
+ const issues: AppValidationIssue[] = [];
1493
+ const props = element.props as Record<string, unknown>;
1494
+ if (!Array.isArray(props.items)) return issues;
1495
+ const keys = props.items.map((item) => (isPlainObject(item) ? item.key : undefined));
1496
+ const childCount = Array.isArray(element.children) ? element.children.length : 0;
1497
+ if (childCount !== keys.length) {
1498
+ issues.push(
1499
+ issue(
1500
+ `${elementPath}.children`,
1501
+ `Accordion children are positional: ${keys.length} items need ${keys.length} children (got ${childCount})`,
1502
+ ),
1503
+ );
1504
+ }
1505
+ const seen = new Set<unknown>();
1506
+ for (const [index, key] of keys.entries()) {
1507
+ if (typeof key === "string" && seen.has(key)) {
1508
+ issues.push(issue(`${elementPath}.props.items.${index}.key`, `duplicate item key "${key}"`));
1509
+ }
1510
+ seen.add(key);
1511
+ }
1512
+ if (Array.isArray(props.defaultOpen)) {
1513
+ for (const [index, key] of props.defaultOpen.entries()) {
1514
+ if (typeof key === "string" && !seen.has(key)) {
1515
+ issues.push(
1516
+ issue(`${elementPath}.props.defaultOpen.${index}`, `unknown item key "${key}"`),
1517
+ );
1518
+ }
1519
+ }
1520
+ }
1521
+ return issues;
1522
+ }
1523
+
1524
+ /**
1525
+ * `currency` must be an ISO 4217 code: on Chart and Metric props, on Table
1526
+ * columns (and their popover fields) and on DetailList fields. The catalog
1527
+ * carries it as a JSON-schema `pattern`, which the generic walker skips.
1528
+ */
1529
+ function currencyIssues(
1530
+ type: unknown,
1531
+ props: Record<string, unknown>,
1532
+ elementPath: string,
1533
+ ): AppValidationIssue[] {
1534
+ const issues: AppValidationIssue[] = [];
1535
+ const check = (value: unknown, path: string) => {
1536
+ if (typeof value === "string" && !CURRENCY_CODE.test(value)) {
1537
+ issues.push(issue(path, `must be an ISO 4217 code like USD (got "${value}")`));
1538
+ }
1539
+ };
1540
+ const propsPath = `${elementPath}.props`;
1541
+ if (type === "Chart" || type === "Metric") check(props.currency, `${propsPath}.currency`);
1542
+ const listProp = type === "Table" ? "columns" : type === "DetailList" ? "fields" : null;
1543
+ if (!listProp || !Array.isArray(props[listProp])) return issues;
1544
+ for (const [index, entry] of (props[listProp] as unknown[]).entries()) {
1545
+ if (!isPlainObject(entry)) continue;
1546
+ const entryPath = `${propsPath}.${listProp}.${index}`;
1547
+ check(entry.currency, `${entryPath}.currency`);
1548
+ const popover = entry.popover;
1549
+ if (isPlainObject(popover) && Array.isArray(popover.fields)) {
1550
+ for (const [fieldIndex, field] of popover.fields.entries()) {
1551
+ if (isPlainObject(field)) {
1552
+ check(field.currency, `${entryPath}.popover.fields.${fieldIndex}.currency`);
1553
+ }
1554
+ }
1555
+ }
1556
+ }
1557
+ return issues;
1558
+ }
1559
+
1560
+ /** The `$row` fields `Files.onSelect` publishes. */
1561
+ const FILE_ROW_FIELDS = new Set(["path", "name", "type", "size", "modifiedAt"]);
1562
+
1563
+ function collectFileRowIssues(value: unknown, path: string, issues: AppValidationIssue[]): void {
1564
+ if (isPlainObject(value) && typeof value.$row === "string") {
1565
+ if (!FILE_ROW_FIELDS.has(value.$row)) {
1566
+ issues.push(
1567
+ issue(
1568
+ appendPath(path, "$row"),
1569
+ `unknown Files row field "${value.$row}" (one of ${[...FILE_ROW_FIELDS].join(", ")})`,
1570
+ ),
1571
+ );
1572
+ }
1573
+ return;
1574
+ }
1575
+ if (Array.isArray(value) || isPlainObject(value)) {
1576
+ for (const [key, child] of Object.entries(value)) {
1577
+ collectFileRowIssues(child, appendPath(path, key), issues);
1578
+ }
1579
+ }
1580
+ }
1581
+
1582
+ /**
1583
+ * `File` / `Files`: a literal `path` must be absolute without `..` segments.
1584
+ * Hygiene only: agent-fs drive membership is the access boundary.
1585
+ */
1586
+ function agentFsPropIssues(
1587
+ type: "File" | "Files",
1588
+ props: Record<string, unknown>,
1589
+ elementPath: string,
1590
+ ): AppValidationIssue[] {
1591
+ const issues: AppValidationIssue[] = [];
1592
+ const propsPath = `${elementPath}.props`;
1593
+ if (typeof props.path === "string" && !isAgentFsPath(props.path)) {
1594
+ issues.push(issue(`${propsPath}.path`, 'must be an absolute agent-fs path without ".."'));
1595
+ }
1596
+ if (type === "Files") collectFileRowIssues(props.onSelect, `${propsPath}.onSelect`, issues);
1597
+ return issues;
1598
+ }
1599
+
1600
+ function isAgentFsPath(value: string): boolean {
1601
+ return value.startsWith("/") && !value.split("/").includes("..");
1602
+ }
1603
+
1604
+ /**
1605
+ * Form `kind: "file"` fields: `dir` is required unless `source: "pick"`, and
1606
+ * a literal `dir` follows the `File` / `Files` path rules.
1607
+ */
1608
+ function formFileFieldIssues(
1609
+ props: Record<string, unknown>,
1610
+ elementPath: string,
1611
+ ): AppValidationIssue[] {
1612
+ const issues: AppValidationIssue[] = [];
1613
+ if (!Array.isArray(props.fields)) return issues;
1614
+ for (const [index, field] of props.fields.entries()) {
1615
+ if (!isPlainObject(field) || field.kind !== "file") continue;
1616
+ const fieldPath = `${elementPath}.props.fields.${index}`;
1617
+ if (field.dir === undefined && field.source !== "pick") {
1618
+ issues.push(issue(`${fieldPath}.dir`, 'is required for kind "file" unless source is "pick"'));
1619
+ } else if (typeof field.dir === "string" && !isAgentFsPath(field.dir)) {
1620
+ issues.push(issue(`${fieldPath}.dir`, 'must be an absolute agent-fs path without ".."'));
1621
+ }
1622
+ }
1623
+ return issues;
1624
+ }
1625
+
1626
+ /** `DateRange`: a plain-token id (it roots `/ui/<id>/from|to`) and a listed `defaultPreset`. */
1627
+ function dateRangePropIssues(
1628
+ props: Record<string, unknown>,
1629
+ elementPath: string,
1630
+ ): AppValidationIssue[] {
1631
+ const issues: AppValidationIssue[] = [];
1632
+ const propsPath = `${elementPath}.props`;
1633
+ if (
1634
+ typeof props.id === "string" &&
1635
+ (!SCHEMA_FORM_ID.test(props.id) || RESERVED_UI_IDS.has(props.id))
1636
+ ) {
1637
+ issues.push(
1638
+ issue(
1639
+ `${propsPath}.id`,
1640
+ "DateRange id must match ^[A-Za-z0-9_-]+$ and not be __proto__, constructor, or prototype",
1641
+ ),
1642
+ );
1643
+ }
1644
+ if (
1645
+ Array.isArray(props.presets) &&
1646
+ typeof props.defaultPreset === "string" &&
1647
+ !props.presets.includes(props.defaultPreset)
1648
+ ) {
1649
+ issues.push(issue(`${propsPath}.defaultPreset`, "must be one of the listed presets"));
1650
+ }
1651
+ return issues;
1652
+ }
1653
+
1360
1654
  /**
1361
1655
  * Sidebar-layout page metadata: `icon` from the catalog icon set, and
1362
1656
  * `headerActions` / `nav` only where the sidebar layout renders them.
@@ -1485,7 +1779,8 @@ export function validatePage(
1485
1779
  formIds.add(rawElement.props.id);
1486
1780
  }
1487
1781
  if (
1488
- type === "SchemaForm" &&
1782
+ typeof type === "string" &&
1783
+ PLAIN_TOKEN_ID_COMPONENTS.has(type) &&
1489
1784
  isPlainObject(rawElement.props) &&
1490
1785
  typeof rawElement.props.id === "string" &&
1491
1786
  (!SCHEMA_FORM_ID.test(rawElement.props.id) || RESERVED_UI_IDS.has(rawElement.props.id))
@@ -1493,10 +1788,13 @@ export function validatePage(
1493
1788
  issues.push(
1494
1789
  issue(
1495
1790
  `${propsPath}.id`,
1496
- "SchemaForm id must match ^[A-Za-z0-9_-]+$ and not be __proto__, constructor, or prototype",
1791
+ `${type} id must match ^[A-Za-z0-9_-]+$ and not be __proto__, constructor, or prototype`,
1497
1792
  ),
1498
1793
  );
1499
1794
  }
1795
+ if (type === "SessionThread" && isPlainObject(rawElement.props)) {
1796
+ issues.push(...sessionThreadIssues(rawElement.props, propsPath));
1797
+ }
1500
1798
  if (
1501
1799
  typeof type === "string" &&
1502
1800
  UI_STATE_COMPONENTS.has(type) &&
@@ -1527,6 +1825,13 @@ export function validatePage(
1527
1825
  }
1528
1826
  collectLinkFieldIssues(definition, type, rawElement.props, elementPath, issues);
1529
1827
  if (type === "Chart") issues.push(...chartPropIssues(rawElement.props, elementPath));
1828
+ issues.push(...currencyIssues(type, rawElement.props, elementPath));
1829
+ if (type === "Accordion") issues.push(...accordionIssues(rawElement, elementPath));
1830
+ if (type === "File" || type === "Files") {
1831
+ issues.push(...agentFsPropIssues(type, rawElement.props, elementPath));
1832
+ }
1833
+ if (type === "Form") issues.push(...formFileFieldIssues(rawElement.props, elementPath));
1834
+ if (type === "DateRange") issues.push(...dateRangePropIssues(rawElement.props, elementPath));
1530
1835
  if (type === "Table") {
1531
1836
  // Row selection lives at `/ui/<id>/selected`, so it needs an id to root it.
1532
1837
  const tableProps = rawElement.props;
@@ -1751,6 +2056,7 @@ export function validatePage(
1751
2056
  issues.push(...onResult.issues);
1752
2057
  stateRefs.push(...onResult.stateRefs);
1753
2058
  }
2059
+ if (type === "Approval") issues.push(...approvalIssues(rawElement, elementPath));
1754
2060
  if (Object.hasOwn(rawElement, "watch")) {
1755
2061
  const watchResult = validateActionMap(
1756
2062
  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
+ }
@@ -1,8 +1,34 @@
1
1
  import type { IncomingMessage } from "node:http";
2
+ import { isGroupKey } from "../assets/key";
3
+ import { sourceOfKey } from "../assets/source-key";
2
4
  import { authUserId, getRequestAuth } from "../utils/request-auth-context";
3
5
  import { getAgentCurrentTask, getTaskById } from "./db";
4
6
  import { findUserByExternalId } from "./users";
5
7
 
8
+ /** Resolve a source task only when the calling agent owns it. */
9
+ export async function resolveCallerTask(
10
+ sourceTaskId: string | undefined,
11
+ callerAgentId: string | undefined,
12
+ ) {
13
+ if (!callerAgentId) return null;
14
+ const task = sourceTaskId
15
+ ? await getTaskById(sourceTaskId)
16
+ : await getAgentCurrentTask(callerAgentId);
17
+ return task?.agentId === callerAgentId ? task : null;
18
+ }
19
+
20
+ /**
21
+ * Return the calling task's group key, excluding namespace roots, resource
22
+ * leaves and source groups (a Slack channel or chat thread is not a user group).
23
+ */
24
+ export async function resolveTaskGroupKey(
25
+ sourceTaskId: string | undefined,
26
+ callerAgentId: string | undefined,
27
+ ): Promise<string | undefined> {
28
+ const task = await resolveCallerTask(sourceTaskId, callerAgentId);
29
+ return task && isGroupKey(task.key) && !sourceOfKey(task.key) ? task.key : undefined;
30
+ }
31
+
6
32
  /**
7
33
  * Resolve the trusted audit-actor user id for a write to an audited table
8
34
  * (`scripts` / `workflows` / `scheduled_tasks`).
@@ -29,20 +55,8 @@ export async function resolveTaskAuditUserId(
29
55
  sourceTaskId: string | undefined,
30
56
  callerAgentId: string | undefined,
31
57
  ): Promise<string | null> {
32
- if (!callerAgentId) return null;
33
-
34
- let resolvedSourceTaskId = sourceTaskId;
35
- if (!resolvedSourceTaskId) {
36
- const currentTask = await getAgentCurrentTask(callerAgentId);
37
- if (currentTask) resolvedSourceTaskId = currentTask.id;
38
- }
39
- if (!resolvedSourceTaskId) return null;
40
-
41
- const task = await getTaskById(resolvedSourceTaskId);
58
+ const task = await resolveCallerTask(sourceTaskId, callerAgentId);
42
59
  if (!task) return null;
43
- // Bind the header to the caller's own task — otherwise it is just a
44
- // client-chosen value and its requester cannot be trusted.
45
- if (task.agentId !== callerAgentId) return null;
46
60
 
47
61
  if (task.requestedByUserId) return task.requestedByUserId;
48
62