@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
@@ -36,7 +36,7 @@ describe("Chart, Metric sparkline and the sidebar layout", () => {
36
36
  expect(await pathsFor(withProps("overview", "deploysChart", { colour: "red" }))).toContain(
37
37
  `${chart}.colour`,
38
38
  );
39
- expect(await pathsFor(withProps("overview", "deploysChart", { kind: "pie" }))).toContain(
39
+ expect(await pathsFor(withProps("overview", "deploysChart", { kind: "radar" }))).toContain(
40
40
  `${chart}.kind`,
41
41
  );
42
42
  expect(await pathsFor(withProps("overview", "deploysChart", { xType: "log" }))).toContain(
@@ -16,6 +16,7 @@ import {
16
16
  ELEMENT_KEYS,
17
17
  MAX_ELEMENT_REF_DEPTH,
18
18
  REWRITE_COVERAGE,
19
+ UI_STATE_COMPONENTS,
19
20
  } from "../../apps/ui/src/lib/json-render/assemble";
20
21
 
21
22
  /**
@@ -24,16 +25,20 @@ import {
24
25
  * in `src/apps/definition`, which opens the database, and the whole point of
25
26
  * the assembler is that it stays free of that.
26
27
  */
27
- function serverElementKeys(): string[] {
28
+ function serverSetEntries(name: string): string[] {
28
29
  const source = require("node:fs").readFileSync(
29
30
  new URL("../apps/page-validator.ts", import.meta.url),
30
31
  "utf8",
31
32
  ) as string;
32
- const block = /export const ELEMENT_KEYS = new Set\(\[([\s\S]*?)\]\)/.exec(source);
33
- if (!block) throw new Error("ELEMENT_KEYS not found in src/apps/page-validator.ts");
33
+ const block = new RegExp(`const ${name} = new Set\\(\\[([\\s\\S]*?)\\]\\)`).exec(source);
34
+ if (!block) throw new Error(`${name} not found in src/apps/page-validator.ts`);
34
35
  return [...block[1]!.matchAll(/"([^"]+)"/g)].map((match) => match[1]!);
35
36
  }
36
37
 
38
+ function serverElementKeys(): string[] {
39
+ return serverSetEntries("ELEMENT_KEYS");
40
+ }
41
+
37
42
  const NOTES_ID = "11111111-1111-4111-8111-111111111111";
38
43
  const CONSUMER_ID = "22222222-2222-4222-8222-222222222222";
39
44
 
@@ -383,6 +388,50 @@ describe("assemblePageSpec — instance scoping", () => {
383
388
  expect(node(spec, "ref:statB:search")?.props.id).toBe("instances/statB/q");
384
389
  });
385
390
 
391
+ test("the client's UI_STATE_COMPONENTS mirror the server's", () => {
392
+ expect([...UI_STATE_COMPONENTS].sort()).toEqual(serverSetEntries("UI_STATE_COMPONENTS").sort());
393
+ });
394
+
395
+ test("every /ui/<id> component gets a per-instance id, so two instances never share a draft", () => {
396
+ const panel = {
397
+ mode: "bound",
398
+ root: "col",
399
+ elements: {
400
+ col: { type: "Stack", props: {}, children: ["thread", "form", "tree", "num", "echo"] },
401
+ thread: {
402
+ type: "SessionThread",
403
+ props: {
404
+ id: "talk",
405
+ onDispatch: [{ action: "app.action", params: { name: "ask", input: { $form: "" } } }],
406
+ },
407
+ },
408
+ form: { type: "SchemaForm", props: { id: "props" } },
409
+ tree: { type: "Tree", props: { id: "nav" } },
410
+ num: { type: "NumberInput", props: { id: "count" } },
411
+ echo: { type: "Text", props: { content: { $state: "/ui/talk/value" } } },
412
+ },
413
+ };
414
+ const consumer = consumerApp({ elements: { panel } });
415
+ consumer.definition.pages!.main = {
416
+ root: "root",
417
+ elements: {
418
+ root: { type: "Stack", props: {}, children: ["a", "b"] },
419
+ a: { type: "ElementRef", props: { element: "panel" } },
420
+ b: { type: "ElementRef", props: { element: "panel" } },
421
+ },
422
+ };
423
+ const { spec } = assemble(consumer);
424
+ for (const key of ["a", "b"]) {
425
+ expect(node(spec, `ref:${key}:thread`)?.props.id).toBe(`instances/${key}/talk`);
426
+ expect(node(spec, `ref:${key}:form`)?.props.id).toBe(`instances/${key}/props`);
427
+ expect(node(spec, `ref:${key}:tree`)?.props.id).toBe(`instances/${key}/nav`);
428
+ expect(node(spec, `ref:${key}:num`)?.props.id).toBe(`instances/${key}/count`);
429
+ expect(node(spec, `ref:${key}:echo`)?.props.content).toEqual({
430
+ $state: `/ui/instances/${key}/talk/value`,
431
+ });
432
+ }
433
+ });
434
+
386
435
  test("an explicit instanceKey overrides the referencing node id", () => {
387
436
  const consumer = consumerApp();
388
437
  (consumer.definition.pages!.main!.elements.statB as any).props.instanceKey = "pinned";
@@ -0,0 +1,182 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import type { AgentTask } from "../../apps/ui/src/api/types";
3
+ import { threadRequestText } from "../../apps/ui/src/lib/json-render/session-thread-model";
4
+ import { parseAppDefinition } from "../apps/definition";
5
+ import { resolveTemplateFromCode } from "../prompts/resolver";
6
+ import "../prompts/session-templates";
7
+
8
+ async function expectParseIssue(definition: unknown, message: string): Promise<void> {
9
+ const parsed = await parseAppDefinition(definition);
10
+ expect(parsed.success).toBe(false);
11
+ if (parsed.success) return;
12
+ expect(parsed.issues.some((entry) => entry.message.includes(message))).toBe(true);
13
+ }
14
+
15
+ function sessionThreadDefinition(model = "screen", overrides: Record<string, unknown> = {}) {
16
+ return {
17
+ models: {
18
+ screen: { columns: { rootTaskId: { kind: "string" } } },
19
+ },
20
+ queries: { screenById: { model: "screen" } },
21
+ actions: {
22
+ dispatchCoder: { kind: "task", prompt: "Edit the screen per the user's message" },
23
+ },
24
+ pages: {
25
+ main: {
26
+ root: "root",
27
+ elements: {
28
+ root: { type: "Stack", props: {}, children: ["thread", "draftEcho"] },
29
+ thread: {
30
+ type: "SessionThread",
31
+ props: {
32
+ id: "thread",
33
+ sessionKey: "main",
34
+ onDispatch: [
35
+ { action: "app.action", params: { name: "dispatchCoder", input: { $form: "" } } },
36
+ {
37
+ action: "app.mutate",
38
+ params: {
39
+ model,
40
+ op: "update",
41
+ rowId: "r1",
42
+ values: { rootTaskId: { $state: "/actions/dispatchCoder/taskId" } },
43
+ },
44
+ },
45
+ ],
46
+ ...overrides,
47
+ },
48
+ },
49
+ draftEcho: { type: "Text", props: { content: { $state: "/ui/thread/value" } } },
50
+ },
51
+ },
52
+ },
53
+ defaultPage: "main",
54
+ };
55
+ }
56
+
57
+ describe("SessionThread validation", () => {
58
+ test("accepts a SessionThread with a sessionKey and an app.action + app.mutate onDispatch chain", async () => {
59
+ const parsed = await parseAppDefinition(sessionThreadDefinition());
60
+ expect(parsed.success).toBe(true);
61
+ });
62
+
63
+ test("accepts a minimal SessionThread (id and sessionKey) that still claims /ui/<id>", async () => {
64
+ // `id` and `sessionKey` are the only required props, and `draftEcho`
65
+ // binding `/ui/thread/value` proves the bare component still registers
66
+ // its UI state slot.
67
+ const definition = sessionThreadDefinition();
68
+ definition.pages.main.elements.thread.props = { id: "thread", sessionKey: "main" } as never;
69
+ const parsed = await parseAppDefinition(definition);
70
+ expect(parsed.success).toBe(true);
71
+ });
72
+
73
+ test("binding /ui/<id>/value without a matching SessionThread id fails", async () => {
74
+ const definition = sessionThreadDefinition();
75
+ definition.pages.main.elements.draftEcho.props = {
76
+ content: { $state: "/ui/phantom/value" },
77
+ };
78
+ await expectParseIssue(definition, 'state reference targets unknown UI control "phantom"');
79
+ });
80
+
81
+ test("rejects an onDispatch app.mutate against an undeclared model", async () => {
82
+ await expectParseIssue(sessionThreadDefinition("ghost"), 'unknown model "ghost"');
83
+ });
84
+
85
+ test("rejects an onDispatch app.action naming an undeclared app action", async () => {
86
+ await expectParseIssue(
87
+ sessionThreadDefinition("screen", {
88
+ onDispatch: [{ action: "app.action", params: { name: "nope" } }],
89
+ }),
90
+ 'unknown app action "nope"',
91
+ );
92
+ });
93
+
94
+ test("rejects an onDispatch step with an unknown action type", async () => {
95
+ await expectParseIssue(
96
+ sessionThreadDefinition("screen", { onDispatch: [{ action: "app.explode", params: {} }] }),
97
+ 'unknown action type "app.explode"',
98
+ );
99
+ });
100
+
101
+ test("accepts a $chain sentinel (e.g. parentTaskId) inside an onDispatch app.action's params", async () => {
102
+ const definition = sessionThreadDefinition("screen", {
103
+ onDispatch: [
104
+ {
105
+ action: "app.action",
106
+ params: {
107
+ name: "dispatchCoder",
108
+ input: { $form: "" },
109
+ parentTaskId: { $chain: "leafTaskId" },
110
+ },
111
+ },
112
+ ],
113
+ });
114
+ const parsed = await parseAppDefinition(definition);
115
+ expect(parsed.success).toBe(true);
116
+ });
117
+
118
+ test("rejects a $chain sentinel outside action params (not a resolvable literal there)", async () => {
119
+ const definition = sessionThreadDefinition();
120
+ definition.pages.main.elements.draftEcho.props = {
121
+ content: { $chain: "leafTaskId" },
122
+ };
123
+ await expectParseIssue(
124
+ definition,
125
+ "$row, $rowIndex, $form, and $chain bindings are only allowed in action params",
126
+ );
127
+ });
128
+
129
+ test("rejects a SessionThread with no sessionKey", async () => {
130
+ const definition = sessionThreadDefinition();
131
+ definition.pages.main.elements.thread.props = { id: "thread" } as never;
132
+ await expectParseIssue(definition, "is required");
133
+ });
134
+
135
+ test("rejects a literal sessionKey that is not a plain token", async () => {
136
+ await expectParseIssue(
137
+ sessionThreadDefinition("screen", { sessionKey: "a:b" }),
138
+ "SessionThread sessionKey must match ^[A-Za-z0-9_-]{1,128}$",
139
+ );
140
+ });
141
+
142
+ test("accepts a bound sessionKey (checked by the server at send time)", async () => {
143
+ const parsed = await parseAppDefinition(
144
+ sessionThreadDefinition("screen", {
145
+ sessionKey: { $state: "/queries/screenById/data/0/id" },
146
+ scope: "user",
147
+ }),
148
+ );
149
+ if (!parsed.success) console.error(parsed.issues);
150
+ expect(parsed.success).toBe(true);
151
+ });
152
+
153
+ test('rejects scope "shared" until shared sessions land', async () => {
154
+ await expectParseIssue(
155
+ sessionThreadDefinition("screen", { scope: "shared" }),
156
+ 'scope "shared" is not supported yet',
157
+ );
158
+ });
159
+
160
+ test("rejects a SessionThread id that is not a plain token", async () => {
161
+ const definition = sessionThreadDefinition();
162
+ (definition.pages.main.elements.thread.props as Record<string, unknown>).id = "a/b";
163
+ await expectParseIssue(definition, "SessionThread id must match ^[A-Za-z0-9_-]+$");
164
+ });
165
+ });
166
+
167
+ describe("SessionThread turn text", () => {
168
+ test("shows only input.message for a prompt rendered from the task.app.action template", () => {
169
+ const input = { screenId: "s1", message: 'Add a card titled "Hello"\nwith two lines' };
170
+ const { text } = resolveTemplateFromCode("task.app.action", {
171
+ prompt: "# Edit a screen\n\nYou edit the screen doc.",
172
+ app_id: "app-1",
173
+ action_name: "editScreen",
174
+ input_json: JSON.stringify(input),
175
+ caller_json: JSON.stringify({ kind: "user", userId: "u1" }),
176
+ });
177
+ expect(text).toContain("[App action]");
178
+ // `app.action` creates its tasks with source "api" (src/apps/action-runner.ts).
179
+ const task = { id: "t1", task: text, source: "api" } as AgentTask;
180
+ expect(threadRequestText(task)).toBe(input.message);
181
+ });
182
+ });
@@ -1,5 +1,6 @@
1
1
  import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
2
  import { createApp } from "../apps/store";
3
+ import { isGroupKey, SESSION_LEAF_KINDS } from "../assets/key";
3
4
  import { auditAssetKeys } from "../be/asset-key-audit";
4
5
  import {
5
6
  closeDb,
@@ -61,6 +62,19 @@ afterAll(() => {
61
62
  });
62
63
 
63
64
  describe("cross-entity asset namespace invariants", () => {
65
+ test("group keys exclude namespace roots and every resource leaf", () => {
66
+ for (const base of ["shared/", "personal/user-1/"]) {
67
+ expect(isGroupKey(base)).toBe(false);
68
+ for (const kind of SESSION_LEAF_KINDS) {
69
+ expect(isGroupKey(`${base}${kind}:abc/`)).toBe(false);
70
+ expect(isGroupKey(`${base}research/${kind}:abc/`)).toBe(false);
71
+ }
72
+ for (const group of ["research/", "research/competitors/", "release:v2/", "mytask:abc/"]) {
73
+ expect(isGroupKey(`${base}${group}`)).toBe(true);
74
+ }
75
+ }
76
+ expect(isGroupKey(" Shared/Research ")).toBe(true);
77
+ });
64
78
  test("all primary entities receive deterministic resource-specific shared keys", async () => {
65
79
  const taskA = await createTaskExtended("first", { agentId });
66
80
  const taskB = await createTaskExtended("second", { agentId });
@@ -36,6 +36,7 @@ const ENV_KEYS = [
36
36
  "AGENT_FS_API_URL",
37
37
  "AGENT_FS_LINK_TARGET",
38
38
  "AGENT_FS_LIVE_URL",
39
+ "AGENT_FS_PUBLIC_URL",
39
40
  "APP_URL",
40
41
  "DASHBOARD_URL",
41
42
  "SCRIPTS_ONLY_MCP",
@@ -488,26 +489,48 @@ describe("getBasePrompt: outputs section", () => {
488
489
  const AGENT_FS_LINE = "agent-fs is the shared drive between agents";
489
490
  const NO_AGENT_FS_LINE = "agent-fs is not configured here.";
490
491
 
492
+ const linkLine = (base: string) =>
493
+ `Link files as \`${base}/file/~/<org>/<drive>/<path>\`. Make an \`agent-fs share-create\` link only when the requester asks for one or the reader has no agent-fs login.`;
494
+
491
495
  test("uses the agent-fs variant when a local environment has AGENT_FS_API_URL", async () => {
492
496
  process.env.AGENT_FS_API_URL = "http://localhost:8787";
493
497
  const result = await getBasePrompt({ ...minimalArgs, traits: localTraits });
494
498
  expect(result).toContain("## Outputs");
495
499
  expect(result).toContain(AGENT_FS_LINE);
496
- expect(result).toContain(
497
- `Give people the live app link \`\${AGENT_FS_LIVE_URL}/file/~/<org>/<drive>/<path>\`. Make an \`agent-fs share-create\` link only when the requester asks for one or the reader has no agent-fs login.`,
498
- );
500
+ // No APP_URL: the default live host.
501
+ expect(result).toContain(linkLine("https://live.agent-fs.dev"));
499
502
  expect(result).not.toContain(NO_AGENT_FS_LINE);
500
503
  });
501
504
 
502
- test("AGENT_FS_LINK_TARGET=dashboard with APP_URL links people to <APP_URL>/file/~/", async () => {
505
+ test("files-first delivery: results under the asset key, a Page only when asked", async () => {
503
506
  process.env.AGENT_FS_API_URL = "http://localhost:8787";
504
- process.env.AGENT_FS_LINK_TARGET = "dashboard";
505
- process.env.APP_URL = "http://localhost:5274/";
507
+ const result = await getBasePrompt({ ...minimalArgs, traits: localTraits });
508
+ expect(result).toContain("Deliver results as files.");
509
+ expect(result).toContain("The drive path equals the key string");
510
+ expect(result).toContain("make a Page only when the requester asks for one");
511
+ expect(result.match(/## Outputs/g)).toHaveLength(1);
512
+ expect(result.match(/The drive path equals the key string/g)).toHaveLength(1);
513
+ });
514
+
515
+ test("APP_URL set and no AGENT_FS_LINK_TARGET: links point at the dashboard", async () => {
516
+ process.env.AGENT_FS_API_URL = "http://localhost:8787";
517
+ process.env.APP_URL = "https://app.example.test/";
518
+ const result = await getBasePrompt({ ...minimalArgs, traits: localTraits });
519
+ expect(result).toContain(linkLine("https://app.example.test"));
520
+ expect(result).not.toContain("live.agent-fs.dev");
521
+ });
522
+
523
+ test("a live link carries ?apiUrl= when AGENT_FS_PUBLIC_URL is set", async () => {
524
+ process.env.AGENT_FS_API_URL = "http://localhost:8787";
525
+ process.env.AGENT_FS_PUBLIC_URL = "https://fs.example.test";
506
526
  const result = await getBasePrompt({ ...minimalArgs, traits: localTraits });
507
527
  expect(result).toContain(
508
- "Give people the live app link `http://localhost:5274/file/~/<org>/<drive>/<path>`.",
528
+ "`https://live.agent-fs.dev/file/~/<org>/<drive>/<path>?apiUrl=https%3A%2F%2Ffs.example.test`",
509
529
  );
510
- expect(result).not.toContain("AGENT_FS_LIVE_URL}/file/~/");
530
+ process.env.APP_URL = "https://app.example.test";
531
+ const dashboard = await getBasePrompt({ ...minimalArgs, traits: localTraits });
532
+ expect(dashboard).toContain(linkLine("https://app.example.test"));
533
+ expect(dashboard).not.toContain("apiUrl=");
511
534
  });
512
535
 
513
536
  test("AGENT_FS_LINK_TARGET=dashboard without APP_URL falls back to the live base", async () => {
@@ -515,9 +538,7 @@ describe("getBasePrompt: outputs section", () => {
515
538
  process.env.AGENT_FS_LINK_TARGET = "dashboard";
516
539
  process.env.AGENT_FS_LIVE_URL = "https://live.example.test/";
517
540
  const result = await getBasePrompt({ ...minimalArgs, traits: localTraits });
518
- expect(result).toContain(
519
- "Give people the live app link `https://live.example.test/file/~/<org>/<drive>/<path>`.",
520
- );
541
+ expect(result).toContain(linkLine("https://live.example.test"));
521
542
  });
522
543
 
523
544
  test("AGENT_FS_LINK_TARGET=live uses the default live host", async () => {
@@ -525,19 +546,15 @@ describe("getBasePrompt: outputs section", () => {
525
546
  process.env.AGENT_FS_LINK_TARGET = "live";
526
547
  process.env.APP_URL = "http://localhost:5274";
527
548
  const result = await getBasePrompt({ ...minimalArgs, traits: localTraits });
528
- expect(result).toContain(
529
- "Give people the live app link `https://live.agent-fs.dev/file/~/<org>/<drive>/<path>`.",
530
- );
549
+ expect(result).toContain(linkLine("https://live.agent-fs.dev"));
531
550
  });
532
551
 
533
- test("an invalid AGENT_FS_LINK_TARGET keeps the exact old sentence", async () => {
552
+ test("an invalid AGENT_FS_LINK_TARGET counts as unset", async () => {
534
553
  process.env.AGENT_FS_API_URL = "http://localhost:8787";
535
554
  process.env.AGENT_FS_LINK_TARGET = "Dashboard2";
536
555
  process.env.APP_URL = "http://localhost:5274";
537
556
  const result = await getBasePrompt({ ...minimalArgs, traits: localTraits });
538
- expect(result).toContain(
539
- `Give people the live app link \`\${AGENT_FS_LIVE_URL}/file/~/<org>/<drive>/<path>\`. Make an \`agent-fs share-create\` link only when the requester asks for one or the reader has no agent-fs login.`,
540
- );
557
+ expect(result).toContain(linkLine("http://localhost:5274"));
541
558
  });
542
559
 
543
560
  test("uses the no_agent_fs variant when AGENT_FS_API_URL is unset", async () => {
@@ -677,6 +694,70 @@ describe("getBasePrompt: slack section", () => {
677
694
  });
678
695
  });
679
696
 
697
+ // ---------------------------------------------------------------------------
698
+ // 6b. Use cases (lead contract) and the use-case channel thread
699
+ // ---------------------------------------------------------------------------
700
+
701
+ describe("getBasePrompt: use cases and the channel thread", () => {
702
+ const USE_CASE = "A use case is work that repeats or continues";
703
+ const THREAD_HEADER = "## Use-case channel thread";
704
+ const lead = { ...minimalArgs, role: "lead" };
705
+ const count = (text: string, needle: string) => text.split(needle).length - 1;
706
+
707
+ test("the lead gets the use-case paragraph once, linked to APP_URL", async () => {
708
+ process.env.APP_URL = "https://app.example.test";
709
+ const result = await getBasePrompt(lead);
710
+ expect(count(result, USE_CASE)).toBe(1);
711
+ expect(count(result, "/sessions?view=")).toBe(1);
712
+ expect(result).toContain("https://app.example.test/sessions?view=<key>");
713
+ });
714
+
715
+ test("without APP_URL the link uses the default app URL", async () => {
716
+ const result = await getBasePrompt(lead);
717
+ expect(result).toContain("https://app.agent-swarm.dev/sessions?view=<key>");
718
+ });
719
+
720
+ test("a worker gets no use-case paragraph", async () => {
721
+ enableSlack();
722
+ const result = await getBasePrompt(minimalArgs);
723
+ expect(result).not.toContain(USE_CASE);
724
+ expect(result).not.toContain(THREAD_HEADER);
725
+ });
726
+
727
+ test("the thread offer renders once for a lead with Slack configured", async () => {
728
+ enableSlack();
729
+ const result = await getBasePrompt(lead);
730
+ expect(count(result, THREAD_HEADER)).toBe(1);
731
+ });
732
+
733
+ test("no thread offer without Slack or a Chat SDK adapter", async () => {
734
+ expect(await getBasePrompt(lead)).not.toContain(THREAD_HEADER);
735
+ expect(await getBasePrompt({ ...lead, serverCapabilities: ["core", "pages"] })).not.toContain(
736
+ THREAD_HEADER,
737
+ );
738
+ });
739
+
740
+ test("the thread offer renders once for a lead with the chat-sdk capability", async () => {
741
+ const result = await getBasePrompt({ ...lead, serverCapabilities: ["core", "chat-sdk"] });
742
+ expect(count(result, THREAD_HEADER)).toBe(1);
743
+ });
744
+
745
+ test("Slack and Chat SDK together still render one offer", async () => {
746
+ enableSlack();
747
+ const result = await getBasePrompt({
748
+ ...lead,
749
+ serverCapabilities: ["core", "slack", "chat-sdk"],
750
+ });
751
+ expect(count(result, THREAD_HEADER)).toBe(1);
752
+ });
753
+
754
+ test("a scripts-only lead gets no thread offer", async () => {
755
+ enableSlack();
756
+ const result = await getBasePrompt({ ...lead, scriptsOnly: true });
757
+ expect(result).not.toContain(THREAD_HEADER);
758
+ });
759
+ });
760
+
680
761
  // ---------------------------------------------------------------------------
681
762
  // 7. Messaging is deprecated and gone from every variant
682
763
  // ---------------------------------------------------------------------------
@@ -1149,21 +1230,24 @@ describe("getBasePrompt: size budget", () => {
1149
1230
  // Include task-output budget, exceptions, and the two citation-scoping lines (when to cite, when not to).
1150
1231
  // Keep tight role-specific ceilings to catch unrelated prompt growth.
1151
1232
  // +150 for the multi-person thread line in the communication block (~105 chars).
1152
- test("a fresh claude worker stays under 5,900 characters", async () => {
1233
+ // +200 for the chat-card outputs line (~190 chars).
1234
+ test("a fresh claude worker stays under 6,100 characters", async () => {
1153
1235
  const result = await getBasePrompt({ ...minimalArgs, name: "Ada", traits: localTraits });
1154
- expect(result.length).toBeLessThan(5_900);
1236
+ expect(result.length).toBeLessThan(6_100);
1155
1237
  });
1156
1238
 
1157
1239
  // The lead ceiling includes the swarm-docs pointer (~190 chars), which renders
1158
- // while the skill list is still unknown.
1159
- test("a fresh claude lead stays under 6,250 characters", async () => {
1240
+ // while the skill list is still unknown, the missing-tool pointer (~150 chars),
1241
+ // and the use-case paragraph (~790 chars).
1242
+ // +250 for the chat-card outputs line (~190 chars).
1243
+ test("a fresh claude lead stays under 7,450 characters", async () => {
1160
1244
  const result = await getBasePrompt({
1161
1245
  ...minimalArgs,
1162
1246
  role: "lead",
1163
1247
  name: "Cora",
1164
1248
  traits: localTraits,
1165
1249
  });
1166
- expect(result.length).toBeLessThan(6_250);
1250
+ expect(result.length).toBeLessThan(7_450);
1167
1251
  });
1168
1252
 
1169
1253
  test("Picateclas spawn-OOM hardening: the kitchen sink stays below MAX_ARG_STRLEN", async () => {