@desplega.ai/agent-swarm 2.8.2 → 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 (558) hide show
  1. package/dist/acp-adapter-jqn86aam.js +16 -0
  2. package/dist/acp-targets-swxq55dr.js +23 -0
  3. package/dist/{actions-kxek041g.js → actions-pb678g3e.js} +22 -20
  4. package/dist/agent-fs-provision-dmhnc38q.js +27 -0
  5. package/dist/{amp-adapter-ce7jjke4.js → amp-adapter-3pa66q27.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-x2cp5fvf.js} +41 -41
  7. package/dist/{app-v6zz8yh0.js → app-17d12ev4.js} +6 -4
  8. package/dist/approval-notifications-h7vd9pmg.js +20 -0
  9. package/dist/{assistant-m0sw9xx2.js → assistant-t7k39ree.js} +56 -34
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-66bk37wv.js → boot-args-schema-0gqmkfbe.js} +1 -1
  12. package/dist/{boot-reembed-edjpwsc1.js → boot-reembed-f064w382.js} +1 -1
  13. package/dist/{boot-reembed-y27n09tz.js → boot-reembed-n6anc01d.js} +1 -1
  14. package/dist/{boot-scrub-sweep-1xc35965.js → boot-scrub-sweep-ejd5dnrz.js} +84 -13
  15. package/dist/{boot-seeds-7hjj91qj.js → boot-seeds-f99fjs5q.js} +4 -4
  16. package/dist/{boxd-ent8ch04.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-gvznwxgc.js +28 -0
  18. package/dist/{claude-managed-adapter-jh6c523j.js → claude-managed-adapter-pbrbvc64.js} +4 -4
  19. package/dist/{claude-managed-setup-y6z2perp.js → claude-managed-setup-kdxttvc3.js} +11 -11
  20. package/dist/{claude-sdk-session-vvya8wqk.js → claude-sdk-session-0t2teq6n.js} +9386 -9197
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-rmzsadkf.js → cli-1tvdx9t5.js} +2 -2
  23. package/dist/{cli-3vmb0n58.js → cli-25nstr34.js} +1 -1
  24. package/dist/{cli-959kp5h2.js → cli-2kg31ted.js} +45 -38
  25. package/dist/{cli-4vzgeta4.js → cli-2tnbc3gw.js} +375 -127
  26. package/dist/{cli-tekytdq9.js → cli-3zxdz9r7.js} +9 -9
  27. package/dist/{cli-bsywb58a.js → cli-4ghh072d.js} +16 -16
  28. package/dist/{cli-9mb2q6pb.js → cli-57pvhnyt.js} +4 -4
  29. package/dist/{cli-d84byzn8.js → cli-5a6pqy45.js} +441 -53
  30. package/dist/{cli-jrzkw01m.js → cli-5gpqgs8b.js} +2 -2
  31. package/dist/{cli-0cq8y6m7.js → cli-5gygrr67.js} +9 -9
  32. package/dist/{cli-z1w943va.js → cli-5kcmxwxv.js} +3 -3
  33. package/dist/{cli-3e875j5p.js → cli-5ntc4we6.js} +3189 -328
  34. package/dist/{cli-bst1vp7e.js → cli-5y2fvw4z.js} +13 -5
  35. package/dist/{cli-mrt48bx7.js → cli-6237rnyr.js} +1 -1
  36. package/dist/cli-6dp0jkfj.js +754 -0
  37. package/dist/{cli-b98a65ed.js → cli-7831nhaw.js} +5 -5
  38. package/dist/{cli-kjtwrhea.js → cli-7cgf614g.js} +10 -10
  39. package/dist/{cli-fwy8kfd6.js → cli-7fx9jyfs.js} +942 -63
  40. package/dist/{cli-28fq781p.js → cli-7zm3b3f5.js} +1 -1
  41. package/dist/{cli-v1dv1r37.js → cli-812paz57.js} +143 -9
  42. package/dist/{cli-837vfs2x.js → cli-8axx8vnw.js} +4 -4
  43. package/dist/cli-8x8y70av.js +103 -0
  44. package/dist/{cli-vj75tyaw.js → cli-95930z69.js} +15 -7
  45. package/dist/{cli-j24zbska.js → cli-9a2rtd77.js} +16 -14
  46. package/dist/cli-9ttx00s3.js +137 -0
  47. package/dist/{cli-6ek0hff4.js → cli-a9hfzg2r.js} +3 -3
  48. package/dist/{cli-dzpc6en0.js → cli-aa8s22gn.js} +19 -14
  49. package/dist/{cli-x1wa213s.js → cli-bk9v1xrv.js} +21 -21
  50. package/dist/{cli-a0z912j7.js → cli-c07v0qfa.js} +194 -75
  51. package/dist/{cli-1qkz151v.js → cli-c5cspahx.js} +28 -36
  52. package/dist/{cli-vdektqgf.js → cli-cw7mc1je.js} +4 -4
  53. package/dist/{cli-n6vtrcht.js → cli-dd37e0cm.js} +2 -2
  54. package/dist/cli-dqgnbnxs.js +132 -0
  55. package/dist/{cli-kc7v1nfv.js → cli-dx439zpg.js} +1 -1
  56. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  57. package/dist/{cli-f6bahpn5.js → cli-e9973bf0.js} +8 -6
  58. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  59. package/dist/{cli-6rc5frdm.js → cli-eepnpee7.js} +34 -37
  60. package/dist/{cli-rvhdmjvt.js → cli-eg437b5p.js} +1 -1
  61. package/dist/cli-faf46gdq.js +714 -0
  62. package/dist/{cli-f4r3g076.js → cli-fgphc007.js} +2 -2
  63. package/dist/{cli-5y340nzn.js → cli-fnh4b12r.js} +24 -18
  64. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  65. package/dist/{cli-e1p3n5gq.js → cli-g3zzby8t.js} +13 -13
  66. package/dist/{cli-3vjhs18n.js → cli-gabsjg8x.js} +3 -1
  67. package/dist/{cli-1pz0330a.js → cli-gddgcnav.js} +3 -3
  68. package/dist/{cli-97ae65rz.js → cli-h474mvp5.js} +11 -11
  69. package/dist/{cli-m88rpzkh.js → cli-hnamkvnc.js} +2 -2
  70. package/dist/{cli-8bpgbr8k.js → cli-j49yqpvh.js} +6 -6
  71. package/dist/{cli-w401b9tq.js → cli-jd3kxppb.js} +1 -1
  72. package/dist/{cli-m9s2qff2.js → cli-jg5txpm6.js} +187 -93
  73. package/dist/{cli-8aes17e4.js → cli-js8zrfyg.js} +3 -3
  74. package/dist/{cli-pfs8adn4.js → cli-k09cxm6m.js} +9 -7
  75. package/dist/{cli-q24n86d2.js → cli-k7pt28ad.js} +10 -3
  76. package/dist/{cli-zh9rsbqf.js → cli-kaa4bd7x.js} +11 -8
  77. package/dist/cli-kj0hyr43.js +51 -0
  78. package/dist/{cli-g70vxtjh.js → cli-kmvcm34h.js} +2 -2
  79. package/dist/{cli-t2tma8gb.js → cli-kqh27v2y.js} +2 -2
  80. package/dist/{cli-mxn1qvbn.js → cli-m1fbz2wj.js} +32 -57
  81. package/dist/{cli-2kvhc7x8.js → cli-mc1fx4xd.js} +51 -90
  82. package/dist/{cli-pchypa1s.js → cli-me4maa4j.js} +61 -6
  83. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  84. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  85. package/dist/cli-nhq5js1b.js +142 -0
  86. package/dist/cli-nmcpzbty.js +296 -0
  87. package/dist/cli-nr46j5pw.js +78 -0
  88. package/dist/{cli-5mrq3ake.js → cli-pn1v1pb0.js} +1 -1
  89. package/dist/{cli-f4e8r23x.js → cli-pwsax0vp.js} +11 -6
  90. package/dist/{cli-gyt3zydq.js → cli-pz1c00aa.js} +9 -754
  91. package/dist/{cli-eddnyg3t.js → cli-q2d3e1k1.js} +1 -1
  92. package/dist/{cli-fpjmegdb.js → cli-q8cfh1t9.js} +2 -2
  93. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  94. package/dist/{cli-2r0jcc3k.js → cli-qj39vrc6.js} +1 -1
  95. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  96. package/dist/{cli-0jzra9ad.js → cli-rts1qvb4.js} +2 -2
  97. package/dist/{cli-3rkdne1h.js → cli-sn4pc4qx.js} +2 -2
  98. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  99. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  100. package/dist/{cli-6wj7p986.js → cli-spzkdgtg.js} +3 -3
  101. package/dist/{cli-m2z8jagn.js → cli-srtkr1h2.js} +18 -18
  102. package/dist/{cli-2gxeg5gr.js → cli-ssvdrk4y.js} +1 -1
  103. package/dist/{cli-jdknh18m.js → cli-svc803vq.js} +69 -816
  104. package/dist/{cli-7349va39.js → cli-t9ga4qmb.js} +935 -445
  105. package/dist/{cli-m5akxq8q.js → cli-vs9vdpy0.js} +1 -1
  106. package/dist/{cli-26ctbcdp.js → cli-vvgaz8t6.js} +93 -44
  107. package/dist/{cli-3sy2xags.js → cli-vw5x18yj.js} +39 -69
  108. package/dist/{cli-kchjb7qy.js → cli-w16kwbzw.js} +1 -1
  109. package/dist/cli-w7dxb2fj.js +921 -0
  110. package/dist/{cli-x6t50dmw.js → cli-wr1h0k28.js} +3 -3
  111. package/dist/{cli-d6521kb5.js → cli-x40a0w9j.js} +1 -1
  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-rcecc3yq.js → cli-ymct0ycy.js} +321 -111
  115. package/dist/{cli-xzm9vcfg.js → cli-zg3z63x3.js} +2 -2
  116. package/dist/cli.js +29 -26
  117. package/dist/{codex-adapter-zerf5qsp.js → codex-adapter-44yq2fkn.js} +9 -9
  118. package/dist/{codex-hook-30gyhzxe.js → codex-hook-h1zb7cfk.js} +6 -6
  119. package/dist/{codex-login-bcda78ge.js → codex-login-cdyrr5y1.js} +1 -1
  120. package/dist/{codex-session-runner-89s304py.js → codex-session-runner-zbh26gbw.js} +10 -10
  121. package/dist/{commands-jeh1b51j.js → commands-54f02v5b.js} +3 -3
  122. package/dist/{controller-mctfbrse.js → controller-9gpwcdek.js} +6 -6
  123. package/dist/{controllers-connect-nxa1ddwn.js → controllers-connect-61re6k1n.js} +26 -25
  124. package/dist/{cursor-adapter-qj8vehv6.js → cursor-adapter-7e4g81vd.js} +2 -2
  125. package/dist/{db-b36qn6k3.js → db-dg2gc7fd.js} +17 -13
  126. package/dist/{db-2dvay0es.js → db-wnh0qjy1.js} +3 -3
  127. package/dist/{devin-adapter-xedz98zv.js → devin-adapter-zp4tqq53.js} +1 -1
  128. package/dist/{dispatcher-gndbta01.js → dispatcher-jrm24r43.js} +19 -18
  129. package/dist/{docker-866qpzt9.js → docker-9aq30pp2.js} +5 -5
  130. package/dist/{dsh-adapter-f75sz821.js → dsh-adapter-1yqk267c.js} +2 -2
  131. package/dist/{e2b-3gpc2n3w.js → e2b-3v1e745x.js} +6 -6
  132. package/dist/{e2b-jbm7mj93.js → e2b-sm28k0k3.js} +6 -6
  133. package/dist/{easter-egg-3d-533knw22.js → easter-egg-3d-r4h9cs9m.js} +1 -1
  134. package/dist/{embedding-space-4p05vb2x.js → embedding-space-bafjr5f7.js} +6 -6
  135. package/dist/{embeddings-m6768mgh.js → embeddings-7xmgqe0e.js} +1 -1
  136. package/dist/{event-bus-e66gh7cc.js → event-bus-xr83x566.js} +1 -1
  137. package/dist/{execute-b3mrb1mv.js → execute-d6jg5ns0.js} +1 -1
  138. package/dist/{external-channel-gjv3jne3.js → external-channel-frq1xvq2.js} +2 -2
  139. package/dist/fx-adapter-0zrkfbkd.js +19 -0
  140. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  141. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  142. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  143. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  144. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  145. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-hh7strj3.js} +1 -1
  146. package/dist/{google-vertex-fhxaafzw.js → google-vertex-fy5bw2pm.js} +5 -5
  147. package/dist/grok-adapter-3db1c538.js +19 -0
  148. package/dist/handlers-k22n8mnn.js +33 -0
  149. package/dist/{heartbeat-a1tv60gt.js → heartbeat-6bpa611t.js} +22 -21
  150. package/dist/{hook-8h5dzcgq.js → hook-hvm5nf46.js} +5 -5
  151. package/dist/{hook-cyaps9ba.js → hook-w12k146y.js} +14 -14
  152. package/dist/{http-t15mhbd9.js → http-43tthdvs.js} +5838 -2600
  153. package/dist/{index-d6wkh8ar.js → index-1f0vypbg.js} +2 -2
  154. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  155. package/dist/{index-khe3gp0k.js → index-4b1q8kan.js} +20 -20
  156. package/dist/{index-hjhfk3ra.js → index-585gyczt.js} +1 -1
  157. package/dist/index-8xcyd3mc.js +33 -0
  158. package/dist/index-9sy2bh6n.js +38 -0
  159. package/dist/{index-2skqtd76.js → index-b24j7t2m.js} +30 -28
  160. package/dist/{index-gjwaqaq8.js → index-cret47a5.js} +6 -6
  161. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  162. package/dist/{index-w1zqf680.js → index-fn054vsf.js} +1 -1
  163. package/dist/{index-qav6455f.js → index-ftywhyr0.js} +214 -152
  164. package/dist/{index-tvfafeyy.js → index-mhq4sh5w.js} +1 -1
  165. package/dist/index-tx9mc2ap.js +570 -0
  166. package/dist/index-wjd56k1v.js +34 -0
  167. package/dist/{keepalive-91s7hzrb.js → keepalive-rk0j0jvh.js} +4 -4
  168. package/dist/lead-atxf3q6e.js +72 -0
  169. package/dist/{maintenance-7pjmy5xy.js → maintenance-g6z6kaxw.js} +1 -1
  170. package/dist/{node-4c5jqxr3.js → node-7qsx5kvm.js} +1 -1
  171. package/dist/{node-252anz2h.js → node-jftbyawr.js} +4 -4
  172. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  173. package/dist/{oauth-refresh-sweep-rzqfm94j.js → oauth-refresh-sweep-2k3g2q4w.js} +3 -3
  174. package/dist/{onboard-74st7pag.js → onboard-6fdbvh3v.js} +8 -8
  175. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  176. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  177. package/dist/{opencode-adapter-arn7gm8q.js → opencode-adapter-fdbsvts7.js} +7 -7
  178. package/dist/{otel-impl-rnzey8cb.js → otel-impl-rvwtc09q.js} +110 -110
  179. package/dist/pending-sqkrb836.js +80 -0
  180. package/dist/{pi-mono-adapter-6mkwq64n.js → pi-mono-adapter-asqayqcg.js} +13 -13
  181. package/dist/{pricing-refresh-ha21jhk7.js → pricing-refresh-f5tkgmw2.js} +2 -2
  182. package/dist/{rbac-roles-wqhma4dr.js → rbac-roles-06s555fa.js} +3 -3
  183. package/dist/{rbac-roles-59dxachk.js → rbac-roles-szxsg8t1.js} +10 -3
  184. package/dist/{render-v2-14kpzx12.js → render-v2-103p266q.js} +4 -4
  185. package/dist/{resume-gsa5fb5f.js → resume-v7kjewt9.js} +8 -7
  186. package/dist/{runtime-1hv06jsn.js → runtime-f1gmk0b7.js} +1 -1
  187. package/dist/{session-access-skm7bnp6.js → session-access-6shev8ts.js} +4 -4
  188. package/dist/{session-source-backfill-pbqzbncv.js → session-source-backfill-bd7spzjd.js} +3 -3
  189. package/dist/{setup-5yermsem.js → setup-kmxmztdb.js} +1 -1
  190. package/dist/thread-buffer-4yz236d0.js +36 -0
  191. package/dist/{virtual-modules-gazyapte.js → virtual-modules-57eje5wy.js} +5 -5
  192. package/dist/{work-objects-xj0ck0w4.js → work-objects-zr47ygmf.js} +23 -21
  193. package/dist/{worker-follow-up-911xc0b8.js → worker-follow-up-grrr3fda.js} +19 -18
  194. package/dist/worker-p4hbtcy3.js +72 -0
  195. package/dist/{x-2fyrt5pp.js → x-wg164ss9.js} +2 -2
  196. package/openapi.json +4518 -2356
  197. package/package.json +11 -8
  198. package/plugin/commands/create-pr.md +1 -1
  199. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  200. package/src/apps/action-runner.ts +21 -1
  201. package/src/apps/catalog.generated.json +626 -17
  202. package/src/apps/page-validator.ts +314 -8
  203. package/src/assets/key.ts +6 -0
  204. package/src/be/agent-fs-user-keys.ts +186 -0
  205. package/src/be/audit-user.ts +27 -13
  206. package/src/be/automation-preflight.test.ts +14 -14
  207. package/src/be/automation-preflight.ts +24 -16
  208. package/src/be/boot-scrub-sweep.ts +143 -14
  209. package/src/be/caller-session-group.ts +86 -0
  210. package/src/be/checklist.ts +375 -0
  211. package/src/be/db/agents.ts +12 -1
  212. package/src/be/db/approvals.ts +26 -0
  213. package/src/be/db/session-moves.ts +23 -0
  214. package/src/be/db/session-tree.ts +78 -19
  215. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  216. package/src/be/db/tasks/read.ts +33 -0
  217. package/src/be/db/tasks/slack-fold.ts +116 -0
  218. package/src/be/db/tasks/write.ts +34 -0
  219. package/src/be/db-queries/mcp-servers.ts +13 -0
  220. package/src/be/db-queries/oauth.ts +6 -0
  221. package/src/be/db-queries/task-artifacts.ts +10 -8
  222. package/src/be/db.ts +74 -22
  223. package/src/be/extensions/assets.ts +17 -13
  224. package/src/be/import/config.ts +54 -0
  225. package/src/be/import/dir-source.ts +372 -0
  226. package/src/be/import/index.ts +149 -0
  227. package/src/be/import/pending.ts +71 -0
  228. package/src/be/import/schema.ts +137 -0
  229. package/src/be/import/seeders.ts +462 -0
  230. package/src/be/migrations/289_automation_savings_daily.sql +47 -0
  231. package/src/be/migrations/291_task_slack_participants.sql +4 -0
  232. package/src/be/migrations/293_savings_component_links.sql +58 -0
  233. package/src/be/migrations/296_automation_savings_daily_read_index.sql +6 -0
  234. package/src/be/migrations/297_import_ownership.sql +34 -0
  235. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  236. package/src/be/migrations/302_checklist_items.sql +23 -0
  237. package/src/be/model-profile-check.ts +10 -2
  238. package/src/be/multi-runtime.ts +8 -1
  239. package/src/be/rbac-roles.ts +8 -1
  240. package/src/be/runtime-pools/demand.ts +20 -2
  241. package/src/be/runtime-pools/reachability.ts +31 -0
  242. package/src/be/runtime-pools/routing.ts +8 -1
  243. package/src/be/runtime-pools/supervisor.ts +6 -7
  244. package/src/be/savings/compute.ts +511 -16
  245. package/src/be/savings/model.ts +282 -14
  246. package/src/be/savings/read.ts +1502 -0
  247. package/src/be/savings/rollup.ts +571 -0
  248. package/src/be/script-credential-broker.ts +2 -2
  249. package/src/be/scripts/run-credential.ts +15 -3
  250. package/src/be/scripts/typecheck.ts +90 -8
  251. package/src/be/seed/agent-fs-provision.ts +104 -19
  252. package/src/be/seed/index.ts +1 -1
  253. package/src/be/seed/registry.ts +27 -8
  254. package/src/be/seed/runner.ts +1 -1
  255. package/src/be/seed/schedules-seeder.ts +24 -6
  256. package/src/be/seed/seed-toggle.ts +32 -0
  257. package/src/be/seed/types.ts +6 -0
  258. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  259. package/src/be/seed-scripts/catalog/dreaming-learnings.ts +10 -2
  260. package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +70 -4
  261. package/src/be/steering.ts +27 -4
  262. package/src/be/swarm-config-guard.ts +38 -0
  263. package/src/be/task-citations.ts +8 -5
  264. package/src/be/users.ts +29 -2
  265. package/src/commands/onboard/agent-fs-version.ts +1 -1
  266. package/src/commands/runner.ts +219 -42
  267. package/src/e2b/env.ts +2 -0
  268. package/src/extensions/catalog.generated.json +17 -0
  269. package/src/extensions/contract-types.generated.ts +1 -1
  270. package/src/github/app.ts +10 -1
  271. package/src/github/handlers.ts +6 -3
  272. package/src/github/reactions.ts +12 -14
  273. package/src/heartbeat/heartbeat.ts +14 -4
  274. package/src/http/agents.ts +19 -10
  275. package/src/http/all-routes.ts +2 -0
  276. package/src/http/approval-requests.ts +24 -4
  277. package/src/http/apps.ts +69 -5
  278. package/src/http/checklist.ts +176 -0
  279. package/src/http/db-query-bounded.ts +256 -11
  280. package/src/http/db-query-shared.ts +9 -0
  281. package/src/http/favorites.ts +14 -2
  282. package/src/http/fs.ts +346 -1
  283. package/src/http/index.ts +37 -2
  284. package/src/http/kv.ts +13 -0
  285. package/src/http/mcp-oauth.ts +1 -1
  286. package/src/http/mcp-servers.ts +15 -2
  287. package/src/http/onboarding.ts +2 -9
  288. package/src/http/poll.ts +59 -1
  289. package/src/http/requested-by.ts +97 -1
  290. package/src/http/savings.ts +676 -190
  291. package/src/http/script-connections.ts +1 -0
  292. package/src/http/scripts.ts +26 -15
  293. package/src/http/sessions.ts +17 -0
  294. package/src/http/slack-events.ts +101 -0
  295. package/src/http/status.ts +25 -7
  296. package/src/http/task-requester.ts +46 -0
  297. package/src/http/tasks.ts +107 -42
  298. package/src/http/users.ts +14 -0
  299. package/src/http/webhooks.ts +15 -0
  300. package/src/integrations/cards/index.ts +151 -0
  301. package/src/integrations/chat-sdk/outbound.ts +39 -13
  302. package/src/integrations/chat-sdk/runtime.ts +7 -1
  303. package/src/integrations/chat-sdk/status.ts +17 -0
  304. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  305. package/src/kv-reserved-namespaces.ts +17 -2
  306. package/src/oauth/presets.ts +29 -2
  307. package/src/prompts/base-prompt.ts +17 -4
  308. package/src/prompts/session-templates.ts +163 -9
  309. package/src/providers/acp-targets.ts +2 -2
  310. package/src/providers/amp-adapter.ts +1 -1
  311. package/src/providers/claude-adapter.ts +0 -20
  312. package/src/providers/claude-flag-settings.ts +12 -10
  313. package/src/providers/claude-managed-adapter.ts +5 -1
  314. package/src/providers/codex-adapter.ts +10 -35
  315. package/src/providers/codex-app-server.ts +2 -11
  316. package/src/providers/opencode-adapter.ts +41 -31
  317. package/src/providers/runtime-dependencies.ts +158 -0
  318. package/src/rbac/legacy-policy.ts +2 -0
  319. package/src/rbac/permissions.ts +10 -1
  320. package/src/scheduler/scheduler.ts +20 -14
  321. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  322. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  323. package/src/scripts-runtime/ctx.ts +1 -1
  324. package/src/scripts-runtime/egress-secrets.ts +2 -2
  325. package/src/scripts-runtime/executors/quickjs-bundle.ts +1 -0
  326. package/src/scripts-runtime/executors/quickjs-prelude.ts +162 -2
  327. package/src/scripts-runtime/executors/quickjs-runner.ts +4 -1
  328. package/src/scripts-runtime/stdlib/fetch.ts +113 -15
  329. package/src/scripts-runtime/stdlib/index.ts +3 -1
  330. package/src/scripts-runtime/stdlib/retry.ts +174 -0
  331. package/src/scripts-runtime/swarm-sdk.ts +187 -17
  332. package/src/scripts-runtime/types/stdlib.d.ts +97 -8
  333. package/src/scripts-runtime/types/swarm-extension.d.ts +27 -1
  334. package/src/scripts-runtime/types/swarm-sdk.d.ts +71 -6
  335. package/src/server.ts +4 -4
  336. package/src/slack/actions.ts +1 -0
  337. package/src/slack/app.ts +87 -46
  338. package/src/slack/assistant.ts +35 -7
  339. package/src/slack/enrich.ts +144 -50
  340. package/src/slack/handlers.ts +43 -99
  341. package/src/slack/http-receiver.ts +284 -0
  342. package/src/slack/inbound-dispatch.ts +43 -7
  343. package/src/slack/inbound-files.ts +33 -14
  344. package/src/slack/message-text.ts +47 -4
  345. package/src/slack/render-v2.ts +2 -1
  346. package/src/slack/socket-ack.ts +17 -10
  347. package/src/slack/steering.ts +5 -0
  348. package/src/slack/templates.ts +9 -0
  349. package/src/slack/thread-buffer-store.ts +58 -0
  350. package/src/slack/thread-buffer.ts +367 -109
  351. package/src/slack/thread-participants.ts +187 -0
  352. package/src/tasks/context-key.ts +24 -0
  353. package/src/tasks/sibling-awareness.ts +13 -1
  354. package/src/tests/agent-fs-live-url.test.ts +15 -0
  355. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  356. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  357. package/src/tests/agentfs-proxy.test.ts +8 -8
  358. package/src/tests/approval-card-resolution.test.ts +396 -0
  359. package/src/tests/approval-requests-notifications.test.ts +1 -1
  360. package/src/tests/approval-respond-auth.test.ts +28 -0
  361. package/src/tests/apps-action-parent-task.test.ts +140 -0
  362. package/src/tests/apps-catalog-additions.test.ts +315 -0
  363. package/src/tests/apps-catalog-files.test.ts +114 -0
  364. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  365. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  366. package/src/tests/apps-catalog-table.test.ts +47 -0
  367. package/src/tests/apps-chart-shell.test.ts +1 -1
  368. package/src/tests/apps-element-assembly.test.ts +52 -3
  369. package/src/tests/apps-session-thread.test.ts +182 -0
  370. package/src/tests/asset-key-invariants.test.ts +14 -0
  371. package/src/tests/base-prompt.test.ts +108 -23
  372. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  373. package/src/tests/caller-session-group.test.ts +199 -0
  374. package/src/tests/cards.test.ts +169 -0
  375. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  376. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  377. package/src/tests/chat-sdk-tools.test.ts +147 -0
  378. package/src/tests/checklist-nudge.test.ts +208 -0
  379. package/src/tests/checklist.test.ts +686 -0
  380. package/src/tests/claude-adapter-binary.test.ts +7 -1
  381. package/src/tests/claude-adapter.test.ts +10 -64
  382. package/src/tests/claude-flag-settings.test.ts +15 -11
  383. package/src/tests/claude-hook-credentials.test.ts +0 -1
  384. package/src/tests/claude-sdk-lifecycle.test.ts +5 -1
  385. package/src/tests/codex-adapter.test.ts +17 -78
  386. package/src/tests/codex-app-server.test.ts +16 -0
  387. package/src/tests/comb-config-guard.test.ts +21 -0
  388. package/src/tests/comb-default.test.ts +59 -97
  389. package/src/tests/comb-links.test.ts +86 -16
  390. package/src/tests/comb-status.test.ts +24 -27
  391. package/src/tests/create-page-tool.test.ts +101 -1
  392. package/src/tests/create-schedule-key.test.ts +105 -0
  393. package/src/tests/create-task-vcs-repo.test.ts +136 -0
  394. package/src/tests/credential-broker.test.ts +2 -2
  395. package/src/tests/db-query.test.ts +87 -1
  396. package/src/tests/db-task-read-contract.test.ts +3 -0
  397. package/src/tests/db-task-write-contract.test.ts +3 -1
  398. package/src/tests/docs-index-footprint.test.js +3 -3
  399. package/src/tests/dreaming-learnings.test.ts +104 -0
  400. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  401. package/src/tests/extensions-assets.test.ts +7 -3
  402. package/src/tests/extensions-catalog.test.ts +1 -0
  403. package/src/tests/extensions-example-sql-admin-only.test.ts +198 -0
  404. package/src/tests/extensions-pre-task.test.ts +7 -5
  405. package/src/tests/extensions-steering.test.ts +14 -2
  406. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  407. package/src/tests/fetch-resolved-env.test.ts +115 -1
  408. package/src/tests/fixtures/import-package.ts +32 -0
  409. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  410. package/src/tests/fs-routes.test.ts +505 -2
  411. package/src/tests/github-ghes-mock.test.ts +196 -0
  412. package/src/tests/github-host.test.ts +285 -0
  413. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  414. package/src/tests/heartbeat.test.ts +56 -0
  415. package/src/tests/import-config.test.ts +209 -0
  416. package/src/tests/import.test.ts +464 -0
  417. package/src/tests/invites-http.test.ts +144 -1
  418. package/src/tests/kv-http.test.ts +11 -0
  419. package/src/tests/literal-matcher.test.ts +58 -0
  420. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  421. package/src/tests/oauth-presets.test.ts +12 -0
  422. package/src/tests/opencode-adapter.test.ts +53 -6
  423. package/src/tests/pool-affinity.test.ts +50 -0
  424. package/src/tests/prompt-template-session.test.ts +69 -6
  425. package/src/tests/provider-registration.test.ts +2 -55
  426. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  427. package/src/tests/rbac-admission.test.ts +19 -0
  428. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  429. package/src/tests/rbac-engine.test.ts +2 -0
  430. package/src/tests/rbac-roles.test.ts +2 -0
  431. package/src/tests/runner-missing-dependency.test.ts +61 -0
  432. package/src/tests/runner-requester-profile.test.ts +139 -1
  433. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  434. package/src/tests/runtime-pool-routing.test.ts +52 -0
  435. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  436. package/src/tests/savings-compound.test.ts +774 -0
  437. package/src/tests/savings-compute.test.ts +7 -198
  438. package/src/tests/savings-fleet-latency.test.ts +143 -0
  439. package/src/tests/savings-fleet-read.test.ts +195 -0
  440. package/src/tests/savings-fleet-scale.test.ts +222 -0
  441. package/src/tests/savings-fleet-slices.test.ts +122 -0
  442. package/src/tests/savings-model.test.ts +212 -0
  443. package/src/tests/savings-read.test.ts +408 -0
  444. package/src/tests/savings-rollup.test.ts +766 -0
  445. package/src/tests/savings-scripts.test.ts +617 -0
  446. package/src/tests/script-connections.test.ts +4 -0
  447. package/src/tests/script-executor-conformance.test.ts +481 -0
  448. package/src/tests/scripts-http.test.ts +55 -0
  449. package/src/tests/scripts-runtime-fetch.test.ts +2 -2
  450. package/src/tests/secret-rules.test.ts +124 -1
  451. package/src/tests/secret-scrub-gate.test.ts +257 -0
  452. package/src/tests/secret-scrubber.test.ts +1 -1
  453. package/src/tests/seed-registry.test.ts +142 -9
  454. package/src/tests/session-source-keys.test.ts +42 -1
  455. package/src/tests/sessions-move.test.ts +70 -0
  456. package/src/tests/sessions-tree.test.ts +98 -0
  457. package/src/tests/sessions.test.ts +69 -0
  458. package/src/tests/slack-config.test.ts +4 -18
  459. package/src/tests/slack-dm-implicit-mention.test.ts +20 -1
  460. package/src/tests/slack-http-receiver.test.ts +472 -0
  461. package/src/tests/slack-identity-resolution.test.ts +23 -0
  462. package/src/tests/slack-inbound-files.test.ts +2 -1
  463. package/src/tests/slack-inbound-logging.test.ts +64 -0
  464. package/src/tests/slack-leave-thread.test.ts +1 -1
  465. package/src/tests/slack-message-text.test.ts +104 -0
  466. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  467. package/src/tests/slack-render-v2.test.ts +48 -0
  468. package/src/tests/slack-skip-reaction.test.ts +2 -2
  469. package/src/tests/slack-steering.test.ts +22 -10
  470. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  471. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  472. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  473. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  474. package/src/tests/slack-thread-buffer.test.ts +34 -34
  475. package/src/tests/slack-thread-participants.test.ts +447 -0
  476. package/src/tests/slack-tool-blocks.test.ts +167 -0
  477. package/src/tests/status.test.ts +32 -6
  478. package/src/tests/steering-core.test.ts +13 -0
  479. package/src/tests/steering-enabled.test.ts +7 -1
  480. package/src/tests/steering-promotion.test.ts +24 -0
  481. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  482. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  483. package/src/tests/task-artifacts.test.ts +50 -0
  484. package/src/tests/task-session-prompts.test.ts +95 -1
  485. package/src/tests/tool-annotations.test.ts +30 -0
  486. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  487. package/src/tools/chat-post.ts +19 -4
  488. package/src/tools/chat-reply.ts +20 -4
  489. package/src/tools/create-page.ts +21 -4
  490. package/src/tools/get-swarm.ts +18 -2
  491. package/src/tools/join-swarm.ts +2 -1
  492. package/src/tools/kv/kv-write-auth.ts +17 -1
  493. package/src/tools/schedules/create-schedule.ts +22 -4
  494. package/src/tools/slack-post.ts +40 -7
  495. package/src/tools/slack-reply.ts +50 -14
  496. package/src/types.ts +74 -2
  497. package/src/utils/constants.ts +60 -138
  498. package/src/utils/github-host.ts +217 -0
  499. package/src/utils/github-pull-request.ts +8 -5
  500. package/src/utils/literal-matcher.ts +118 -0
  501. package/src/utils/mcp-server-fetcher.test.ts +89 -0
  502. package/src/utils/mcp-server-fetcher.ts +13 -5
  503. package/src/utils/request-auth-context.ts +24 -0
  504. package/src/utils/secret-rules.generated.ts +1 -1
  505. package/src/utils/secret-scrubber.ts +485 -54
  506. package/src/utils/task-attachment-links.ts +9 -12
  507. package/src/vcs/index.ts +3 -0
  508. package/src/workflows/approval-notifications.ts +188 -12
  509. package/src/workflows/executors/swarm-script.ts +23 -19
  510. package/src/workflows/executors/system-one-extraction.ts +14 -7
  511. package/src/workflows/executors/system-one-providers.ts +22 -1
  512. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  513. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  514. package/templates/extensions/README.md +1 -0
  515. package/templates/extensions/sql-admin-only/README.md +19 -0
  516. package/templates/extensions/sql-admin-only/hooks.ts +96 -0
  517. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  518. package/templates/import/manifest.schema.json +136 -0
  519. package/templates/import/sources.schema.json +44 -0
  520. package/templates/skills/agent-browser/SKILL.md +1 -1
  521. package/templates/skills/agent-browser/content.md +1 -1
  522. package/templates/skills/apps/SKILL.md +122 -12
  523. package/templates/skills/apps/content.md +122 -12
  524. package/templates/skills/asset-namespaces/content.md +2 -1
  525. package/templates/skills/chat-sdk/content.md +17 -0
  526. package/templates/skills/db-query-guidance/content.md +2 -1
  527. package/templates/skills/scheduling/content.md +27 -0
  528. package/templates/skills/slack-interaction/content.md +12 -2
  529. package/templates/skills/swarm-docs/content.md +1 -0
  530. package/templates/skills/swarm-extensions/config.json +1 -1
  531. package/templates/skills/swarm-extensions/content.md +33 -23
  532. package/templates/skills/swarm-scripts/SKILL.md +18 -4
  533. package/templates/skills/swarm-scripts/content.md +18 -4
  534. package/templates/skills/work-on-task/SKILL.md +1 -1
  535. package/templates/skills/work-on-task/content.md +1 -1
  536. package/templates/skills/workflow-iterate/content.md +4 -7
  537. package/templates/workflows/dreaming/content.md +3 -3
  538. package/dist/acp-adapter-fqzkxyra.js +0 -15
  539. package/dist/claude-adapter-stw7jdcf.js +0 -25
  540. package/dist/cli-4bd1rck6.js +0 -4
  541. package/dist/cli-dns0y538.js +0 -194
  542. package/dist/cli-g5mtmf6t.js +0 -432
  543. package/dist/cli-xf3qw745.js +0 -104
  544. package/dist/fx-adapter-rpsgb1tw.js +0 -18
  545. package/dist/grok-adapter-n2m3zjg1.js +0 -18
  546. package/dist/handlers-nv8edn19.js +0 -32
  547. package/dist/index-ksmyd6kc.js +0 -37
  548. package/dist/index-rjnrje98.js +0 -32
  549. package/dist/index-tv3413wy.js +0 -33
  550. package/dist/lead-3hmddvrm.js +0 -70
  551. package/dist/worker-qgg0m2gw.js +0 -70
  552. package/src/providers/ctx-mode-env.ts +0 -10
  553. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  554. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  555. package/dist/{index-0rvk3vd4.js → index-bs7gw5fd.js} +3 -3
  556. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  557. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  558. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -5,6 +5,7 @@
5
5
  "Grid",
6
6
  "Split",
7
7
  "Divider",
8
+ "Accordion",
8
9
  "Tabs",
9
10
  "Container",
10
11
  "Card",
@@ -31,14 +32,21 @@
31
32
  "Chips",
32
33
  "Table",
33
34
  "Form",
35
+ "Dialog",
34
36
  "Drawer",
35
37
  "DetailList",
36
38
  "CardGrid",
37
39
  "Kanban",
40
+ "Approval",
38
41
  "Calendar",
39
42
  "ContributionGraph",
40
43
  "Tree",
44
+ "Files",
45
+ "File",
46
+ "DateRange",
47
+ "Timeline",
41
48
  "SchemaForm",
49
+ "SessionThread",
42
50
  "ElementRef",
43
51
  "ElementSlot"
44
52
  ],
@@ -185,15 +193,109 @@
185
193
  }
186
194
  },
187
195
  "Divider": {
188
- "description": "Horizontal rule between sections, optionally with a centered `label` (e.g. `\"Filters\"`).",
196
+ "description": "Rule between sections, optionally with a centered `label` (e.g. `\"Filters\"`). `orientation: \"vertical\"` draws it between the items of a row `Stack`, as tall as the row.",
189
197
  "props": {
190
198
  "$schema": "http://json-schema.org/draft-07/schema#",
191
199
  "type": "object",
192
200
  "properties": {
193
201
  "label": {
194
202
  "type": "string"
203
+ },
204
+ "orientation": {
205
+ "type": "string",
206
+ "enum": ["horizontal", "vertical"]
207
+ }
208
+ },
209
+ "additionalProperties": false
210
+ }
211
+ },
212
+ "Accordion": {
213
+ "description": "Grouped collapsible sections. POSITIONAL children like Tabs: children[i] is the body of items[i], so declare exactly as many children as items, in the same order. `items: [{ key, title, description?, icon? }]`. `type: \"single\"` (default) keeps at most one item open (opening one closes the others, and the open one can be closed); `\"multiple\"` lets several open. The open keys are client state at `{ \"$state\": \"/ui/<id>/open\" }` (an array); `defaultOpen` lists the keys open on first render. Bodies mount only while open. For one collapsible block use `Section collapsible`.",
214
+ "slots": ["default"],
215
+ "props": {
216
+ "$schema": "http://json-schema.org/draft-07/schema#",
217
+ "type": "object",
218
+ "properties": {
219
+ "id": {
220
+ "type": "string"
221
+ },
222
+ "type": {
223
+ "type": "string",
224
+ "enum": ["single", "multiple"]
225
+ },
226
+ "items": {
227
+ "minItems": 1,
228
+ "type": "array",
229
+ "items": {
230
+ "type": "object",
231
+ "properties": {
232
+ "key": {
233
+ "type": "string"
234
+ },
235
+ "title": {
236
+ "type": "string"
237
+ },
238
+ "description": {
239
+ "type": "string"
240
+ },
241
+ "icon": {
242
+ "type": "string",
243
+ "enum": [
244
+ "plus",
245
+ "refresh-cw",
246
+ "search",
247
+ "filter",
248
+ "download",
249
+ "upload",
250
+ "external-link",
251
+ "copy",
252
+ "check",
253
+ "x",
254
+ "trash-2",
255
+ "pencil",
256
+ "eye",
257
+ "calendar",
258
+ "clock",
259
+ "user",
260
+ "users",
261
+ "bot",
262
+ "git-pull-request",
263
+ "git-branch",
264
+ "github",
265
+ "slack",
266
+ "mail",
267
+ "link",
268
+ "file-text",
269
+ "folder",
270
+ "database",
271
+ "zap",
272
+ "sparkles",
273
+ "flag",
274
+ "star",
275
+ "tag",
276
+ "alert-triangle",
277
+ "info",
278
+ "circle-check",
279
+ "trending-up",
280
+ "trending-down",
281
+ "dollar-sign",
282
+ "activity",
283
+ "rocket"
284
+ ]
285
+ }
286
+ },
287
+ "required": ["key", "title"],
288
+ "additionalProperties": false
289
+ }
290
+ },
291
+ "defaultOpen": {
292
+ "type": "array",
293
+ "items": {
294
+ "type": "string"
295
+ }
195
296
  }
196
297
  },
298
+ "required": ["id", "items"],
197
299
  "additionalProperties": false
198
300
  }
199
301
  },
@@ -624,7 +726,7 @@
624
726
  }
625
727
  },
626
728
  "Metric": {
627
- "description": "Stat tile (the dashboard `StatPanel`): label, value, optional `detail` line and `trend: { direction: \"up\"|\"down\"|\"flat\", label }` (arrow plus success/error/muted text). `icon` adds a tile tinted by `tone` (neutral|success|active|error|info|pending|warning|paused); `info` is a one-sentence explanation in a tooltip next to the label. Bind `loading` to the backing query (`{ \"$state\": \"/queries/<name>/loading\" }`) to show a skeleton instead of a blank value while it loads; an empty value renders an em dash. `sparkline` draws a small trend line under the value, in the `tone` color: an array of numbers (`null` is a gap), or rows (bind `{ \"$state\": \"/queries/<name>/data\" }`) read through `sparklineKey`. Fewer than two points draws nothing.",
729
+ "description": "Stat tile (the dashboard `StatPanel`): label, value, optional `detail` line and `trend: { direction: \"up\"|\"down\"|\"flat\", label }` (arrow plus success/error/muted text). `icon` adds a tile tinted by `tone` (neutral|success|active|error|info|pending|warning|paused); `info` is a one-sentence explanation in a tooltip next to the label. Bind `loading` to the backing query (`{ \"$state\": \"/queries/<name>/loading\" }`) to show a skeleton instead of a blank value while it loads; an empty value renders an em dash. `sparkline` draws a small trend line under the value, in the `tone` color: an array of numbers (`null` is a gap), or rows (bind `{ \"$state\": \"/queries/<name>/data\" }`) read through `sparklineKey`. Fewer than two points draws nothing. `format` number | currency (`currency`, ISO code, default USD) | percent (values are ratios, 0.42 = 42%) formats a numeric `value`, the same contract as Chart; a string value shows as is.",
628
730
  "props": {
629
731
  "$schema": "http://json-schema.org/draft-07/schema#",
630
732
  "type": "object",
@@ -739,6 +841,14 @@
739
841
  },
740
842
  "sparklineKey": {
741
843
  "type": "string"
844
+ },
845
+ "format": {
846
+ "type": "string",
847
+ "enum": ["number", "currency", "percent"]
848
+ },
849
+ "currency": {
850
+ "type": "string",
851
+ "pattern": "^[A-Z]{3}$"
742
852
  }
743
853
  },
744
854
  "required": ["label", "value"],
@@ -746,14 +856,14 @@
746
856
  }
747
857
  },
748
858
  "Chart": {
749
- "description": "Line, area or bar chart over rows. Bind `data`/`loading`/`error` to a named query like Table. `x` is the row field on the x axis: `xType: \"category\"` (default) keeps row order, `\"time\"` parses ISO dates or epoch ms, sorts the rows and labels ticks as dates (rows whose `x` does not parse are dropped). `series: [{ key, label?, color? }]` (1-8) plots numeric row fields; `color` is chart-1..chart-5, primary, success, warning, error, info or muted (default palette, in order: primary, chart-2..chart-5). `stacked` stacks area and bar series (lines never stack). `format` number (default) | currency (`currency`, ISO code, default USD) | percent (values are ratios, 0.42 = 42%) shapes axis ticks and the tooltip. Hover shows a tooltip with every series; the legend shows with two or more series (`legend` forces it on or off). `height` px (120-640, default 240). No rows renders `emptyMessage` (default \"No data yet\"). Wrap it in a `Card` for a title.",
859
+ "description": "Line, area or bar chart over rows. Bind `data`/`loading`/`error` to a named query like Table. `x` is the row field on the x axis: `xType: \"category\"` (default) keeps row order, `\"time\"` parses ISO dates or epoch ms, sorts the rows and labels ticks as dates (rows whose `x` does not parse are dropped). `series: [{ key, label?, color? }]` (1-8) plots numeric row fields; `color` is chart-1..chart-5, primary, success, warning, error, info or muted (default palette, in order: primary, chart-2..chart-5). `stacked` stacks area and bar series (lines never stack). `format` number (default) | currency (`currency`, ISO code, default USD) | percent (values are ratios, 0.42 = 42%) shapes axis ticks and the tooltip. Hover shows a tooltip with every series; the legend shows with two or more series (`legend` forces it on or off). `kind: \"pie\"` or `\"donut\"` takes exactly one series: `x` is the slice label, each row with a positive value is a slice labelled with its share, the tooltip shows the value in `format` plus the share, and the legend defaults on (`xType` and `stacked` do not apply). `height` px (120-640, default 240). No rows renders `emptyMessage` (default \"No data yet\"). Wrap it in a `Card` for a title.",
750
860
  "props": {
751
861
  "$schema": "http://json-schema.org/draft-07/schema#",
752
862
  "type": "object",
753
863
  "properties": {
754
864
  "kind": {
755
865
  "type": "string",
756
- "enum": ["line", "area", "bar"]
866
+ "enum": ["line", "area", "bar", "pie", "donut"]
757
867
  },
758
868
  "data": {
759
869
  "type": "array",
@@ -1380,7 +1490,7 @@
1380
1490
  }
1381
1491
  },
1382
1492
  "Table": {
1383
- "description": "Data table. Bind `data`/`loading`/`error` to a named query (`/queries/<name>/...`); also bind `refreshing` to `/queries/<name>/fetching` so a poll or `app.refresh` over loaded rows shows a slim progress bar (`loading` alone is the first-load skeleton). `rowActions` chains receive `{ \"$row\": \"<col>\" }` (or `{ \"$row\": \"\" }` for the whole row) and `{ \"$rowIndex\": true }`. Destructive row actions always confirm via a dialog; override the copy with `confirm: { title, description, confirmLabel }`. `search` (case-insensitive substring across every listed column) and `filters` (per-column equality, `null`/`\"\"` disables one; an array means \"one of\", which is what a multiple `Chips` writes, and an empty array disables it) narrow the polled rows client-side — bind them to a `SearchInput` / `Select` via `/ui/<id>/value`, or pin a constant (e.g. `\"filters\": { \"pinned\": true }`). Columns take `pinned: \"left\"|\"right\"` to survive horizontal scroll; `pagination` pages large row sets (auto past 200 rows); `density: \"compact\"` tightens row height. Column kinds: `status` (lifecycle values like pending/in_progress/completed/failed get the dashboard status icon, anything else a `tones` pill), `user` / `agent` (avatar + name), `relative` (smart time with the exact time on hover), `duration` (ms → 1m 23s), `progress` (bar, `max` default 100), `copy` (value + copy button), `switch` / `checkbox` (run the column's `onChange` chain with `$row` set to the new value; read-only without it), `link` (a smart link: a GitHub PR, issue, commit or repo URL or `owner/repo#N`, a dashboard task / agent / session / app URL or an agent-fs file renders as a chip with an icon and a short label; any other http(s) URL opens in a new tab as plain text), `json` (compact single-line `JSON.stringify` preview, truncated). Columns also take `align`, `truncate: \"middle\"` (ids, paths), a header `icon`, a header `hint` (a tooltip on the header; a label cut by the column width also shows in full on hover) and `tooltip` (a row field shown in a tooltip on the cell), and `format` — a `{{field}}` template (e.g. `\"{{name}} · v{{version}}\"`) that combines several row fields into one cell and overrides `key`/`kind` rendering on desktop and in the phone list (placeholder names match `[w.]+`, no hyphens or spaces; sorting uses the composed text; `search` and `filters` still read the column's `key`). `href` (a row field holding a URL) makes the cell a link to that URL while it shows its own text or `format` (`{ key: \"number\", format: \"{{repo}}#{{number}}\", href: \"url\" }`), and `linkLabel` (a `{{field}}` template) replaces the derived label of a link. `popover: { title?, fields, trigger? }` opens a popover from the cell on hover or focus (`trigger: \"click\"` for a click) that lists several fields of the row with the DetailList field shape (up to 12); on a cell with its own controls (link, copy, switch) a click popover opens from a separate Details button beside the content. In the phone list a link column renders as a chip under the row and a popover column gets a Details button (tap to open, whatever its `trigger`). `onRowClick` runs a chain with `$row` when a row is clicked — pair it with `app.navigate` + a Drawer and bind `selectedId` to the drawer param to highlight the open row. `rowId` names the id field (default `id`). Below 768px the table renders as a phone list (`mobile: \"list\"`, fields picked by `mobileFields: { title, subtitle?, meta?, status? }`); `mobile: \"scroll\"` keeps the grid. `emptyState: { icon?, title, body? }` replaces the empty message. Row actions take `icon` and `placement: \"menu\"` (collected into a More menu). `selectable: true` + `id` adds a leading checkbox column (select-all header over the rows left after `search`/`filters`, shift-click for a range); the selection is client state at `{ \"$state\": \"/ui/<id>/selected\" }` (an array of row ids by `rowId`), never a model write. `bulkActions` (same shape as `rowActions`, no `placement`, implies `selectable`) show a bar with the count, the buttons and Clear while rows are selected; chains have no `$row`, read the ids from that `$state` path, and the selection clears after the chain succeeds.",
1493
+ "description": "Data table. Bind `data`/`loading`/`error` to a named query (`/queries/<name>/...`); also bind `refreshing` to `/queries/<name>/fetching` so a poll or `app.refresh` over loaded rows shows a slim progress bar (`loading` alone is the first-load skeleton). `rowActions` chains receive `{ \"$row\": \"<col>\" }` (or `{ \"$row\": \"\" }` for the whole row) and `{ \"$rowIndex\": true }`. Destructive row actions always confirm via a dialog; override the copy with `confirm: { title, description, confirmLabel }`. `search` (case-insensitive substring across every listed column) and `filters` (per-column equality, `null`/`\"\"` disables one; an array means \"one of\", which is what a multiple `Chips` writes, and an empty array disables it) narrow the polled rows client-side — bind them to a `SearchInput` / `Select` via `/ui/<id>/value`, or pin a constant (e.g. `\"filters\": { \"pinned\": true }`). Columns take `pinned: \"left\"|\"right\"` to survive horizontal scroll; `pagination` pages large row sets (auto past 200 rows); `density: \"compact\"` tightens row height. Column kinds: `status` (lifecycle values like pending/in_progress/completed/failed get the dashboard status icon, anything else a `tones` pill), `user` / `agent` (avatar + name), `relative` (smart time with the exact time on hover), `duration` (ms → 1m 23s), `progress` (bar, `max` default 100), `copy` (value + copy button), `switch` / `checkbox` (run the column's `onChange` chain with `$row` set to the new value; read-only without it), `link` (a smart link: a GitHub PR, issue, commit or repo URL or `owner/repo#N`, a dashboard task / agent / session / app URL or an agent-fs file renders as a chip with an icon and a short label; any other http(s) URL opens in a new tab as plain text), `json` (compact single-line `JSON.stringify` preview, truncated), `currency` (a number as money, ISO 4217 `currency`, default USD: `$1,234.50`) and `percent` (a ratio as a percent, 0.42 = 42%). Columns also take `align`, `truncate: \"middle\"` (ids, paths), a header `icon`, a header `hint` (a tooltip on the header; a label cut by the column width also shows in full on hover) and `tooltip` (a row field shown in a tooltip on the cell), and `format` — a `{{field}}` template (e.g. `\"{{name}} · v{{version}}\"`) that combines several row fields into one cell and overrides `key`/`kind` rendering on desktop and in the phone list (placeholder names match `[w.]+`, no hyphens or spaces; sorting uses the composed text; `search` and `filters` still read the column's `key`). `href` (a row field holding a URL) makes the cell a link to that URL while it shows its own text or `format` (`{ key: \"number\", format: \"{{repo}}#{{number}}\", href: \"url\" }`), and `linkLabel` (a `{{field}}` template) replaces the derived label of a link. `popover: { title?, fields, trigger? }` opens a popover from the cell on hover or focus (`trigger: \"click\"` for a click) that lists several fields of the row with the DetailList field shape (up to 12); on a cell with its own controls (link, copy, switch) a click popover opens from a separate Details button beside the content. In the phone list a link column renders as a chip under the row and a popover column gets a Details button (tap to open, whatever its `trigger`). `onRowClick` runs a chain with `$row` when a row is clicked — pair it with `app.navigate` + a Drawer and bind `selectedId` to the drawer param to highlight the open row. `rowId` names the id field (default `id`). Below 768px the table renders as a phone list (`mobile: \"list\"`, fields picked by `mobileFields: { title, subtitle?, meta?, status? }`); `mobile: \"scroll\"` keeps the grid. `emptyState: { icon?, title, body? }` replaces the empty message. Row actions take `icon` and `placement: \"menu\"` (collected into a More menu). `selectable: true` + `id` adds a leading checkbox column (select-all header over the rows left after `search`/`filters`, shift-click for a range); the selection is client state at `{ \"$state\": \"/ui/<id>/selected\" }` (an array of row ids by `rowId`), never a model write. `bulkActions` (same shape as `rowActions`, no `placement`, implies `selectable`) show a bar with the count, the buttons and Clear while rows are selected; chains have no `$row`, read the ids from that `$state` path, and the selection clears after the chain succeeds.",
1384
1494
  "props": {
1385
1495
  "$schema": "http://json-schema.org/draft-07/schema#",
1386
1496
  "type": "object",
@@ -1429,7 +1539,9 @@
1429
1539
  "switch",
1430
1540
  "checkbox",
1431
1541
  "link",
1432
- "json"
1542
+ "json",
1543
+ "currency",
1544
+ "percent"
1433
1545
  ]
1434
1546
  },
1435
1547
  "tones": {
@@ -1451,6 +1563,10 @@
1451
1563
  ]
1452
1564
  }
1453
1565
  },
1566
+ "currency": {
1567
+ "type": "string",
1568
+ "pattern": "^[A-Z]{3}$"
1569
+ },
1454
1570
  "width": {
1455
1571
  "type": "number"
1456
1572
  },
@@ -1555,7 +1671,9 @@
1555
1671
  "relative",
1556
1672
  "copy",
1557
1673
  "link",
1558
- "json"
1674
+ "json",
1675
+ "currency",
1676
+ "percent"
1559
1677
  ]
1560
1678
  },
1561
1679
  "tones": {
@@ -1577,6 +1695,10 @@
1577
1695
  ]
1578
1696
  }
1579
1697
  },
1698
+ "currency": {
1699
+ "type": "string",
1700
+ "pattern": "^[A-Z]{3}$"
1701
+ },
1580
1702
  "href": {
1581
1703
  "type": "string"
1582
1704
  },
@@ -2090,7 +2212,7 @@
2090
2212
  }
2091
2213
  },
2092
2214
  "Form": {
2093
- "description": "Field form. Values live in state under `/forms/<id>/<field>`; `onSubmit` chains receive `$form` (all collected values) and `$form: \"<field>\"` for one. `app.mutate` failures in the chain surface inline under the fields (not the page banner), and the submit button shows a pending spinner while the chain runs.",
2215
+ "description": "Field form. Values live in state under `/forms/<id>/<field>`; `onSubmit` chains receive `$form` (all collected values) and `$form: \"<field>\"` for one. `app.mutate` failures in the chain surface inline under the fields (not the page banner), and the submit button shows a pending spinner while the chain runs. `kind: \"file\"` attaches agent-fs files with the VIEWER's own agent-fs key (swarm default drive): `source: \"upload\"` (default) picks local files and uploads them on submit, before the chain, to `<dir>/<timestamp>-<id>-<n>-<name>` (unique per file, across fields and submits); `\"pick\"` opens a browser of `dir` (or `/`) to attach a file that already exists; `\"both\"` offers both. `$form.<name>` is the path, or an array of paths with `multiple: true`. `accept` filters the file picker. An upload failure stops the chain and keeps the values. Without an agent-fs connection the field shows a \"Connect agent-fs\" card, and a required file field disables submit.",
2094
2216
  "props": {
2095
2217
  "$schema": "http://json-schema.org/draft-07/schema#",
2096
2218
  "type": "object",
@@ -2115,7 +2237,7 @@
2115
2237
  },
2116
2238
  "kind": {
2117
2239
  "type": "string",
2118
- "enum": ["string", "text", "number", "boolean", "date", "enum"]
2240
+ "enum": ["string", "text", "number", "boolean", "date", "enum", "file"]
2119
2241
  },
2120
2242
  "options": {
2121
2243
  "type": "array",
@@ -2128,6 +2250,22 @@
2128
2250
  },
2129
2251
  "required": {
2130
2252
  "type": "boolean"
2253
+ },
2254
+ "dir": {
2255
+ "type": "string"
2256
+ },
2257
+ "accept": {
2258
+ "type": "array",
2259
+ "items": {
2260
+ "type": "string"
2261
+ }
2262
+ },
2263
+ "multiple": {
2264
+ "type": "boolean"
2265
+ },
2266
+ "source": {
2267
+ "type": "string",
2268
+ "enum": ["upload", "pick", "both"]
2131
2269
  }
2132
2270
  },
2133
2271
  "required": ["name"],
@@ -2162,8 +2300,147 @@
2162
2300
  "additionalProperties": false
2163
2301
  }
2164
2302
  },
2303
+ "Dialog": {
2304
+ "description": "Route-driven modal, centered over the page, for short forms (\"New item\"). The same contract as Drawer: open exactly while the page route param named by `param` is set (open it with `app.navigate`, e.g. from a `headerActions` Button), a deep link opens it, and closing (the X, Escape, a click outside) clears the param. `size` sm|md (default)|lg. `actions` render in its footer with the Drawer confirm rules; read the record id with `{ \"$state\": \"/route/params/<param>\" }`. Children mount only while open. A Form inside closes nothing by itself: add an `app.navigate` step without the param after the write.",
2305
+ "slots": ["default"],
2306
+ "props": {
2307
+ "$schema": "http://json-schema.org/draft-07/schema#",
2308
+ "type": "object",
2309
+ "properties": {
2310
+ "param": {
2311
+ "type": "string"
2312
+ },
2313
+ "title": {
2314
+ "type": "string"
2315
+ },
2316
+ "description": {
2317
+ "type": "string"
2318
+ },
2319
+ "size": {
2320
+ "type": "string",
2321
+ "enum": ["sm", "md", "lg"]
2322
+ },
2323
+ "actions": {
2324
+ "type": "array",
2325
+ "items": {
2326
+ "type": "object",
2327
+ "properties": {
2328
+ "label": {
2329
+ "type": "string"
2330
+ },
2331
+ "variant": {
2332
+ "type": "string",
2333
+ "enum": [
2334
+ "default",
2335
+ "secondary",
2336
+ "outline",
2337
+ "ghost",
2338
+ "destructive",
2339
+ "destructive-outline"
2340
+ ]
2341
+ },
2342
+ "confirm": {
2343
+ "anyOf": [
2344
+ {
2345
+ "type": "boolean"
2346
+ },
2347
+ {
2348
+ "type": "object",
2349
+ "properties": {
2350
+ "title": {
2351
+ "type": "string"
2352
+ },
2353
+ "description": {
2354
+ "type": "string"
2355
+ },
2356
+ "confirmLabel": {
2357
+ "type": "string"
2358
+ }
2359
+ },
2360
+ "additionalProperties": false
2361
+ },
2362
+ {
2363
+ "type": "string"
2364
+ }
2365
+ ]
2366
+ },
2367
+ "actions": {
2368
+ "type": "array",
2369
+ "items": {
2370
+ "type": "object",
2371
+ "properties": {
2372
+ "action": {
2373
+ "type": "string"
2374
+ },
2375
+ "params": {
2376
+ "type": "object",
2377
+ "propertyNames": {
2378
+ "type": "string"
2379
+ },
2380
+ "additionalProperties": {}
2381
+ }
2382
+ },
2383
+ "required": ["action"],
2384
+ "additionalProperties": false
2385
+ }
2386
+ },
2387
+ "icon": {
2388
+ "type": "string",
2389
+ "enum": [
2390
+ "plus",
2391
+ "refresh-cw",
2392
+ "search",
2393
+ "filter",
2394
+ "download",
2395
+ "upload",
2396
+ "external-link",
2397
+ "copy",
2398
+ "check",
2399
+ "x",
2400
+ "trash-2",
2401
+ "pencil",
2402
+ "eye",
2403
+ "calendar",
2404
+ "clock",
2405
+ "user",
2406
+ "users",
2407
+ "bot",
2408
+ "git-pull-request",
2409
+ "git-branch",
2410
+ "github",
2411
+ "slack",
2412
+ "mail",
2413
+ "link",
2414
+ "file-text",
2415
+ "folder",
2416
+ "database",
2417
+ "zap",
2418
+ "sparkles",
2419
+ "flag",
2420
+ "star",
2421
+ "tag",
2422
+ "alert-triangle",
2423
+ "info",
2424
+ "circle-check",
2425
+ "trending-up",
2426
+ "trending-down",
2427
+ "dollar-sign",
2428
+ "activity",
2429
+ "rocket"
2430
+ ]
2431
+ }
2432
+ },
2433
+ "required": ["label", "actions"],
2434
+ "additionalProperties": false
2435
+ }
2436
+ }
2437
+ },
2438
+ "required": ["param"],
2439
+ "additionalProperties": false
2440
+ }
2441
+ },
2165
2442
  "Drawer": {
2166
- "description": "Route-driven slide-in side panel (sheet). Open exactly when the route param named by `param` is set — open it with `app.navigate` (e.g. a rowAction setting `{ \"panel\": { \"$row\": \"id\" } }`), and the URL stays shareable: a deep link with the param renders the drawer open, and closing it clears the param. Children mount only while open (a Table inside does NOT stay warm when closed — unlike Tabs). `side` right (default) or left; `size` sm|md|lg|xl: about 480/660/900/1010px at a 1440px viewport (md default), growing with the viewport up to 640/960/1280/1600px; full width on phones. `actions: [{ label, icon?, variant?, confirm?, actions }]` render in a sticky footer with the Table rowActions confirm rules (destructive variants confirm, an `app.mutate` delete always confirms); chains have no `$row`, so read the open record id with `{ \"$state\": \"/route/params/<param>\" }`.",
2443
+ "description": "Route-driven slide-in side panel (sheet). Open exactly when the route param named by `param` is set — open it with `app.navigate` (e.g. a rowAction setting `{ \"panel\": { \"$row\": \"id\" } }`), and the URL stays shareable: a deep link with the param renders the drawer open, and closing it clears the param. Children mount only while open (a Table inside does NOT stay warm when closed — unlike Tabs). `side` right (default) or left; `size` sm|md|lg|xl: about 480/660/900/1010px at a 1440px viewport (md default), growing with the viewport up to 640/960/1280/1600px; full width on phones. `actions: [{ label, icon?, variant?, confirm?, actions }]` render in a sticky footer with the Table rowActions confirm rules (destructive variants confirm, an `app.mutate` delete always confirms); chains have no `$row`, so read the open record id with `{ \"$state\": \"/route/params/<param>\" }`. `presentation: \"split\"` renders it inline as a right pane beside the page instead of a sheet: the page canvas shrinks, the pane has a draggable edge (arrow keys too, double-click resets) and its width is kept per viewer; below 768px it is the sheet. At most one split Drawer per page; `side` does not apply to it.",
2167
2444
  "slots": ["default"],
2168
2445
  "props": {
2169
2446
  "$schema": "http://json-schema.org/draft-07/schema#",
@@ -2186,6 +2463,10 @@
2186
2463
  "type": "string",
2187
2464
  "enum": ["sm", "md", "lg", "xl"]
2188
2465
  },
2466
+ "presentation": {
2467
+ "type": "string",
2468
+ "enum": ["sheet", "split"]
2469
+ },
2189
2470
  "actions": {
2190
2471
  "type": "array",
2191
2472
  "items": {
@@ -2306,7 +2587,7 @@
2306
2587
  }
2307
2588
  },
2308
2589
  "DetailList": {
2309
- "description": "Read-only label/value detail view for ONE record. Bind `data` to a single row — usually `{ \"$state\": \"/queries/<name>/data/0\" }` with a `$param`-filtered query. `fields` pick and format properties with the same kinds as Table columns (badge tones, relative dates) plus `status` (lifecycle chip), `user` (avatar + name), `relative` (smart time, exact on hover), `copy` (value + copy button), `link` (a smart link from the value, or from the row field named by `href`; `linkLabel` is a `{{field}}` template for its text), `code` (monospace block) and `json` (collapsible JSON tree). Bind `loading` to the query (`/queries/<name>/loading`) for skeleton fields while it loads; `emptyMessage` shows when the record is genuinely missing.",
2590
+ "description": "Read-only label/value detail view for ONE record. Bind `data` to a single row — usually `{ \"$state\": \"/queries/<name>/data/0\" }` with a `$param`-filtered query. `fields` pick and format properties with the same kinds as Table columns (badge tones, relative dates) plus `status` (lifecycle chip), `user` (avatar + name), `relative` (smart time, exact on hover), `copy` (value + copy button), `link` (a smart link from the value, or from the row field named by `href`; `linkLabel` is a `{{field}}` template for its text), `code` (monospace block), `json` (collapsible JSON tree), and `currency` / `percent` (as Table columns, with `currency` the ISO 4217 code). Bind `loading` to the query (`/queries/<name>/loading`) for skeleton fields while it loads; `emptyMessage` shows when the record is genuinely missing.",
2310
2591
  "props": {
2311
2592
  "$schema": "http://json-schema.org/draft-07/schema#",
2312
2593
  "type": "object",
@@ -2353,7 +2634,9 @@
2353
2634
  "relative",
2354
2635
  "copy",
2355
2636
  "link",
2356
- "json"
2637
+ "json",
2638
+ "currency",
2639
+ "percent"
2357
2640
  ]
2358
2641
  },
2359
2642
  "tones": {
@@ -2375,6 +2658,10 @@
2375
2658
  ]
2376
2659
  }
2377
2660
  },
2661
+ "currency": {
2662
+ "type": "string",
2663
+ "pattern": "^[A-Z]{3}$"
2664
+ },
2378
2665
  "href": {
2379
2666
  "type": "string"
2380
2667
  },
@@ -2628,7 +2915,9 @@
2628
2915
  "relative",
2629
2916
  "copy",
2630
2917
  "link",
2631
- "json"
2918
+ "json",
2919
+ "currency",
2920
+ "percent"
2632
2921
  ]
2633
2922
  },
2634
2923
  "tones": {
@@ -2650,6 +2939,10 @@
2650
2939
  ]
2651
2940
  }
2652
2941
  },
2942
+ "currency": {
2943
+ "type": "string",
2944
+ "pattern": "^[A-Z]{3}$"
2945
+ },
2653
2946
  "href": {
2654
2947
  "type": "string"
2655
2948
  },
@@ -2709,14 +3002,54 @@
2709
3002
  "additionalProperties": false
2710
3003
  }
2711
3004
  },
2712
- "Calendar": {
2713
- "description": "Read-only month calendar of rows. `startField` (and optional `endField`) hold dates; an event shows on every day it spans. `titleField` labels it. Has its own prev/next month controls; each Calendar keeps its own month. `onSelect` runs when an event is clicked, with `$row` (e.g. `app.navigate` to open a Drawer).",
3005
+ "Approval": {
3006
+ "description": "One approval request (human-in-the-loop), answered in place as the viewer. Bind `requestId` to the id an `app.action` script returned (`{ \"$state\": \"/actions/<name>/result/requestId\" }`); an empty id renders nothing. It polls every 5s while the request is pending and stops once it resolves. A viewer whose role cannot answer, or whose answer the server refuses, gets a read-only card with an \"Open in dashboard\" link. `showResolved` (default true) shows the answers after resolution; `compact` drops the card chrome. `onResolved` runs once when the page sees the request leave `pending`, with `$chain` = `{ status, responses, resolvedBy }`; a request that was already resolved when the page loaded does not run it.",
2714
3007
  "props": {
2715
3008
  "$schema": "http://json-schema.org/draft-07/schema#",
2716
3009
  "type": "object",
2717
3010
  "properties": {
2718
- "data": {
2719
- "type": "array",
3011
+ "requestId": {
3012
+ "type": "string"
3013
+ },
3014
+ "showResolved": {
3015
+ "type": "boolean"
3016
+ },
3017
+ "compact": {
3018
+ "type": "boolean"
3019
+ },
3020
+ "onResolved": {
3021
+ "type": "array",
3022
+ "items": {
3023
+ "type": "object",
3024
+ "properties": {
3025
+ "action": {
3026
+ "type": "string"
3027
+ },
3028
+ "params": {
3029
+ "type": "object",
3030
+ "propertyNames": {
3031
+ "type": "string"
3032
+ },
3033
+ "additionalProperties": {}
3034
+ }
3035
+ },
3036
+ "required": ["action"],
3037
+ "additionalProperties": false
3038
+ }
3039
+ }
3040
+ },
3041
+ "required": ["requestId"],
3042
+ "additionalProperties": false
3043
+ }
3044
+ },
3045
+ "Calendar": {
3046
+ "description": "Read-only month calendar of rows. `startField` (and optional `endField`) hold dates; an event shows on every day it spans. `titleField` labels it. Has its own prev/next month controls; each Calendar keeps its own month. `onSelect` runs when an event is clicked, with `$row` (e.g. `app.navigate` to open a Drawer).",
3047
+ "props": {
3048
+ "$schema": "http://json-schema.org/draft-07/schema#",
3049
+ "type": "object",
3050
+ "properties": {
3051
+ "data": {
3052
+ "type": "array",
2720
3053
  "items": {
2721
3054
  "type": "object",
2722
3055
  "propertyNames": {
@@ -2826,6 +3159,232 @@
2826
3159
  "additionalProperties": false
2827
3160
  }
2828
3161
  },
3162
+ "Files": {
3163
+ "description": "agent-fs folder listing, read as the VIEWER with their own agent-fs key (Comb's connection), from the swarm's default drive. `path` is an absolute folder. `mode: \"list\"` (default) shows that folder; `\"browser\"` also opens subfolders, with crumbs that never go above `path`. Folders sort first. Clicking a file (or, in list mode, a folder) runs `onSelect` with `$row` = `{ path, name, type, size, modifiedAt }` (`type` is `file` or `directory`), usually an `app.navigate` that puts `$row.path` in a route param a `File` reads. `selectedPath` highlights that row. `upload: true` adds an Upload button and a drop zone that upload into the open folder with the viewer's key and refresh the list; a taken name asks Keep both or Skip. A viewer who has not connected agent-fs sees a \"Connect agent-fs\" card instead; access is whatever their drive membership allows. Rows scroll inside `maxHeight` (default 480px), or set `fill: true` to grow inside a `fill`-aware parent.",
3164
+ "props": {
3165
+ "$schema": "http://json-schema.org/draft-07/schema#",
3166
+ "type": "object",
3167
+ "properties": {
3168
+ "path": {
3169
+ "type": "string"
3170
+ },
3171
+ "mode": {
3172
+ "type": "string",
3173
+ "enum": ["list", "browser"]
3174
+ },
3175
+ "selectedPath": {
3176
+ "type": "string"
3177
+ },
3178
+ "emptyMessage": {
3179
+ "type": "string"
3180
+ },
3181
+ "maxHeight": {
3182
+ "description": "CSS max-height for the scrollable list, e.g. '480px' (default '480px')",
3183
+ "type": "string"
3184
+ },
3185
+ "fill": {
3186
+ "type": "boolean"
3187
+ },
3188
+ "onSelect": {
3189
+ "type": "array",
3190
+ "items": {
3191
+ "type": "object",
3192
+ "properties": {
3193
+ "action": {
3194
+ "type": "string"
3195
+ },
3196
+ "params": {
3197
+ "type": "object",
3198
+ "propertyNames": {
3199
+ "type": "string"
3200
+ },
3201
+ "additionalProperties": {}
3202
+ }
3203
+ },
3204
+ "required": ["action"],
3205
+ "additionalProperties": false
3206
+ }
3207
+ },
3208
+ "upload": {
3209
+ "type": "boolean"
3210
+ }
3211
+ },
3212
+ "required": ["path"],
3213
+ "additionalProperties": false
3214
+ }
3215
+ },
3216
+ "File": {
3217
+ "description": "One agent-fs file, read as the VIEWER with their own agent-fs key, from the swarm's default drive. `path` is absolute, usually bound to a route param. Markdown renders (raw HTML shown as text), images show as `<img>` (SVG too, so scripts never run), PDFs open in the browser's viewer, video and audio play, CSV shows as a table, and text files (HTML included, as source) show their lines. Anything else shows Download and \"Open in agent-fs\". An empty `path` shows a \"No file selected\" state. Sizes to content; `height` fixes a scrolling box, `fill: true` grows inside a `fill`-aware parent. Not connected: a \"Connect agent-fs\" card.",
3218
+ "props": {
3219
+ "$schema": "http://json-schema.org/draft-07/schema#",
3220
+ "type": "object",
3221
+ "properties": {
3222
+ "path": {
3223
+ "type": "string"
3224
+ },
3225
+ "height": {
3226
+ "type": "string"
3227
+ },
3228
+ "fill": {
3229
+ "type": "boolean"
3230
+ }
3231
+ },
3232
+ "required": ["path"],
3233
+ "additionalProperties": false
3234
+ }
3235
+ },
3236
+ "DateRange": {
3237
+ "description": "Date range filter: preset buttons (`7d`, `30d`, `90d`, `mtd` month to date, `custom`) that write `/ui/<id>/from` and `/ui/<id>/to` as inclusive `YYYY-MM-DD` dates ending today. Bind query params to them with `{ \"$state\": \"/ui/<id>/from\" }`, so the query refetches when the range changes. `presets` picks and orders the buttons (default all five); `defaultPreset` is written on first load (default the first preset). `custom` opens two date inputs in a popover and applies when from is not after to.",
3238
+ "props": {
3239
+ "$schema": "http://json-schema.org/draft-07/schema#",
3240
+ "type": "object",
3241
+ "properties": {
3242
+ "id": {
3243
+ "type": "string"
3244
+ },
3245
+ "presets": {
3246
+ "minItems": 1,
3247
+ "type": "array",
3248
+ "items": {
3249
+ "type": "string",
3250
+ "enum": ["7d", "30d", "90d", "mtd", "custom"]
3251
+ }
3252
+ },
3253
+ "defaultPreset": {
3254
+ "type": "string",
3255
+ "enum": ["7d", "30d", "90d", "mtd", "custom"]
3256
+ },
3257
+ "label": {
3258
+ "type": "string"
3259
+ }
3260
+ },
3261
+ "required": ["id"],
3262
+ "additionalProperties": false
3263
+ }
3264
+ },
3265
+ "Timeline": {
3266
+ "description": "Vertical event list over rows, newest first, grouped under day headings (Today, Yesterday, then dates). Bind `data`/`loading` to a named query like Table. `timeField` (ISO date or epoch ms; rows that do not parse are left out), `titleField`, optional `descriptionField`, and `statusField` with `tones` (value → pill tone, lifecycle values get the status chip) shape each event; `icon` replaces the marker dot. `onSelect` runs with `$row` and `$rowIndex` when an event is clicked. No rows renders `emptyMessage`.",
3267
+ "props": {
3268
+ "$schema": "http://json-schema.org/draft-07/schema#",
3269
+ "type": "object",
3270
+ "properties": {
3271
+ "data": {
3272
+ "type": "array",
3273
+ "items": {
3274
+ "type": "object",
3275
+ "propertyNames": {
3276
+ "type": "string"
3277
+ },
3278
+ "additionalProperties": {}
3279
+ }
3280
+ },
3281
+ "loading": {
3282
+ "type": "boolean"
3283
+ },
3284
+ "timeField": {
3285
+ "type": "string"
3286
+ },
3287
+ "titleField": {
3288
+ "type": "string"
3289
+ },
3290
+ "descriptionField": {
3291
+ "type": "string"
3292
+ },
3293
+ "statusField": {
3294
+ "type": "string"
3295
+ },
3296
+ "tones": {
3297
+ "type": "object",
3298
+ "propertyNames": {
3299
+ "type": "string"
3300
+ },
3301
+ "additionalProperties": {
3302
+ "type": "string",
3303
+ "enum": [
3304
+ "neutral",
3305
+ "success",
3306
+ "active",
3307
+ "error",
3308
+ "info",
3309
+ "pending",
3310
+ "warning",
3311
+ "paused"
3312
+ ]
3313
+ }
3314
+ },
3315
+ "icon": {
3316
+ "type": "string",
3317
+ "enum": [
3318
+ "plus",
3319
+ "refresh-cw",
3320
+ "search",
3321
+ "filter",
3322
+ "download",
3323
+ "upload",
3324
+ "external-link",
3325
+ "copy",
3326
+ "check",
3327
+ "x",
3328
+ "trash-2",
3329
+ "pencil",
3330
+ "eye",
3331
+ "calendar",
3332
+ "clock",
3333
+ "user",
3334
+ "users",
3335
+ "bot",
3336
+ "git-pull-request",
3337
+ "git-branch",
3338
+ "github",
3339
+ "slack",
3340
+ "mail",
3341
+ "link",
3342
+ "file-text",
3343
+ "folder",
3344
+ "database",
3345
+ "zap",
3346
+ "sparkles",
3347
+ "flag",
3348
+ "star",
3349
+ "tag",
3350
+ "alert-triangle",
3351
+ "info",
3352
+ "circle-check",
3353
+ "trending-up",
3354
+ "trending-down",
3355
+ "dollar-sign",
3356
+ "activity",
3357
+ "rocket"
3358
+ ]
3359
+ },
3360
+ "emptyMessage": {
3361
+ "type": "string"
3362
+ },
3363
+ "onSelect": {
3364
+ "type": "array",
3365
+ "items": {
3366
+ "type": "object",
3367
+ "properties": {
3368
+ "action": {
3369
+ "type": "string"
3370
+ },
3371
+ "params": {
3372
+ "type": "object",
3373
+ "propertyNames": {
3374
+ "type": "string"
3375
+ },
3376
+ "additionalProperties": {}
3377
+ }
3378
+ },
3379
+ "required": ["action"],
3380
+ "additionalProperties": false
3381
+ }
3382
+ }
3383
+ },
3384
+ "required": ["timeField", "titleField"],
3385
+ "additionalProperties": false
3386
+ }
3387
+ },
2829
3388
  "SchemaForm": {
2830
3389
  "description": "Schema-driven props panel. Walks `schema.properties` and renders one control per property — text input (or a select when `enum` is present), number input, or switch — labelled by key with the property `description` as tooltip. Each field seeds from `value?.[key] ?? property.default`. On every field commit the draft object is written to `/ui/<id>/value` and the `onChange` chain is dispatched with `$form` = the current values and `{ \"$value\": true }` = the value just written (the whole merged doc when `baseDoc` is set; never read `/ui/<id>/value` with `$state` in `onChange`, the renderer resolves it before the commit and it is one edit stale). The draft rebuilds whenever the bound `schema` identity changes. With `baseDoc` (a `{ root, elements }` doc) and `nodeKey`, it edits `baseDoc.elements[nodeKey].props` and `/ui/<id>/value` holds the whole doc with the edit merged in, ready for one `app.mutate` (pass it as `{ \"$value\": true }`). At most 100 fields and 200 enum options render, and a `baseDoc` over 5,000 elements is refused. `fill: true` grows the field list to fill a `fill`-aware parent and scrolls internally instead of sizing to content — pair it with a `fill` sibling (e.g. Tree) in the same column Stack to split the available height evenly between them.",
2831
3390
  "props": {
@@ -2880,6 +3439,56 @@
2880
3439
  "additionalProperties": false
2881
3440
  }
2882
3441
  },
3442
+ "SessionThread": {
3443
+ "description": "A chat on an app page, rendered as the dashboard's session conversation (the same turn timeline and composer as the \"Session about this page\" panel). The session is found by key, not stored in a row: the server keys each task an `app.action` step creates as `task:app:<appId>:<sessionKey>:user:<viewer>`, and the thread shows the viewer's newest session with that key. The viewer must have an identity: with none picked the composer is disabled. `scope: \"shared\"` (one session for everyone) comes in a follow-up PR and is rejected today. A person bubble shows the `message` of an app-action input (cut at 4,000 characters), not the whole agent prompt. Sending routes three ways: no session yet → run `onDispatch`, whose `app.action` creates the session's root task; a task in the session not finished → the shared composer steers the newest unfinished task on any agent (steering source `app-page`; Queue, or Interrupt where the harness supports it); every task finished → run `onDispatch` again, chaining off the newest task via `\"parentTaskId\": { \"$chain\": \"leafTaskId\" }`. `$chain.leafTaskId` is `null` when there is no session, and a null `$chain` key drops the param, so one `onDispatch` covers the first message and follow-ups. Each `app.action` step is sent with the session and `followUp: false` (unless it sets `followUp` itself), so the Lead adds no review task. Messages are text only (no attachments or mic). After each send the composer stays busy until the new task shows up (at most 30 s). \"New session\" starts over: the next message creates a new root, and the older session is no longer shown. The composer draft is mirrored to `/ui/<id>/value` (namespaced per instance inside an element). The thread is 420 px tall; `fill: true` fills a `fill`-aware parent instead, with the timeline scrolling inside it and the composer pinned to the bottom.",
3444
+ "props": {
3445
+ "$schema": "http://json-schema.org/draft-07/schema#",
3446
+ "type": "object",
3447
+ "properties": {
3448
+ "id": {
3449
+ "type": "string"
3450
+ },
3451
+ "sessionKey": {
3452
+ "type": "string",
3453
+ "description": "App-chosen session key, a plain token (^[A-Za-z0-9_-]{1,128}$), e.g. \"main\", or a $state binding to a token such as { \"$state\": \"/route/params/itemId\" }. The server keys the session as task:app:<appId>:<sessionKey>:user:<viewer>, so each viewer has their own session per key and app."
3454
+ },
3455
+ "scope": {
3456
+ "description": "\"user\" (default): one session per viewer. \"shared\" is reserved for a follow-up PR (one session everyone on the page writes to) and is rejected today.",
3457
+ "type": "string",
3458
+ "enum": ["user", "shared"]
3459
+ },
3460
+ "placeholder": {
3461
+ "type": "string"
3462
+ },
3463
+ "onDispatch": {
3464
+ "description": "Action chain run with $form={message} to send a message. $chain={leafTaskId} is the session's newest task, or null when the viewer has no session yet — a null $chain key drops the param, so `\"parentTaskId\": {\"$chain\": \"leafTaskId\"}` starts a new session on the first message and chains a new task off the leaf on every later one. Each app.action step is sent with the session (key and scope) and followUp: false. The chain should app.action a task.",
3465
+ "type": "array",
3466
+ "items": {
3467
+ "type": "object",
3468
+ "properties": {
3469
+ "action": {
3470
+ "type": "string"
3471
+ },
3472
+ "params": {
3473
+ "type": "object",
3474
+ "propertyNames": {
3475
+ "type": "string"
3476
+ },
3477
+ "additionalProperties": {}
3478
+ }
3479
+ },
3480
+ "required": ["action"],
3481
+ "additionalProperties": false
3482
+ }
3483
+ },
3484
+ "fill": {
3485
+ "type": "boolean"
3486
+ }
3487
+ },
3488
+ "required": ["id", "sessionKey"],
3489
+ "additionalProperties": false
3490
+ }
3491
+ },
2883
3492
  "ElementRef": {
2884
3493
  "description": "Reference a reusable element from this app or an exported element from another app. Consumer children are inserted at the target's ElementSlot.",
2885
3494
  "slots": ["default"],