@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
@@ -1,6 +1,10 @@
1
1
  import { afterAll, beforeAll, beforeEach, describe, expect, test } from "bun:test";
2
2
  import { unlink } from "node:fs/promises";
3
3
  import { closeDb, getDbClient, initDb, upsertSwarmConfig } from "../be/db";
4
+ import {
5
+ SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_OPTIONS,
6
+ validateConfigValue,
7
+ } from "../be/swarm-config-guard";
4
8
  import type { WorkflowNode } from "../types";
5
9
  import { validateDefinition } from "../workflows/definition";
6
10
  import { interpolateNodeConfig } from "../workflows/engine";
@@ -15,6 +19,8 @@ import {
15
19
  SystemOneExtractionOutputSchema,
16
20
  } from "../workflows/executors/system-one-extraction";
17
21
  import {
22
+ resolveSystemOneExtractDefaultProvider,
23
+ SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_CONFIG_KEY,
18
24
  SYSTEM_ONE_EXTRACT_PROVIDER_IDS,
19
25
  SYSTEM_ONE_PROVIDER_IDS,
20
26
  } from "../workflows/executors/system-one-providers";
@@ -57,7 +63,7 @@ afterAll(async () => {
57
63
 
58
64
  beforeEach(async () => {
59
65
  await getDbClient().run(
60
- "DELETE FROM swarm_config WHERE key IN ('CLOUDFLARE_ACCOUNT_ID', 'CLOUDFLARE_API_TOKEN', 'CLOUDFLARE_API_KEY')",
66
+ "DELETE FROM swarm_config WHERE key IN ('CLOUDFLARE_ACCOUNT_ID', 'CLOUDFLARE_API_TOKEN', 'CLOUDFLARE_API_KEY', 'SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER')",
61
67
  );
62
68
  });
63
69
 
@@ -832,3 +838,145 @@ describe("system-one-extraction in a workflow definition", () => {
832
838
  expect(missing.strictUnresolved).toEqual(["nope"]);
833
839
  });
834
840
  });
841
+
842
+ describe("system-one-extraction default provider", () => {
843
+ const key = SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_CONFIG_KEY;
844
+
845
+ test.each([
846
+ { row: undefined, env: undefined },
847
+ { row: undefined, env: "cloudflare" },
848
+ { row: "cloudflare", env: "bogus" },
849
+ { row: "openai", env: "cloudflare" },
850
+ { row: "laya", env: "openai" },
851
+ { row: undefined, env: "laya" },
852
+ { row: " CloudFlare ", env: "openai" },
853
+ ])("resolves row $row and environment $env", async ({ row, env }) => {
854
+ if (row !== undefined) {
855
+ await upsertSwarmConfig({ scope: "global", key, value: "cloudflare" });
856
+ // Simulate an invalid legacy row that the current config guard refuses.
857
+ await getDbClient().run("UPDATE swarm_config SET value = ? WHERE key = ?", [row, key]);
858
+ }
859
+ const lookups: unknown[] = [];
860
+ const db = {
861
+ ...deps.db,
862
+ getSwarmConfigs: async (filter: Parameters<typeof deps.db.getSwarmConfigs>[0]) => {
863
+ lookups.push(filter);
864
+ return deps.db.getSwarmConfigs(filter);
865
+ },
866
+ };
867
+ expect(await resolveSystemOneExtractDefaultProvider({ db, env: { [key]: env } })).toBe(
868
+ "cloudflare",
869
+ );
870
+ expect(lookups).toEqual([{ scope: "global", key }]);
871
+ });
872
+
873
+ test("an unreadable row uses the environment", async () => {
874
+ const db = {
875
+ ...deps.db,
876
+ getSwarmConfigs: async () => {
877
+ throw new Error("unreadable");
878
+ },
879
+ };
880
+ expect(await resolveSystemOneExtractDefaultProvider({ db, env: { [key]: "cloudflare" } })).toBe(
881
+ "cloudflare",
882
+ );
883
+ });
884
+
885
+ test("the config guard accepts exactly the extraction hosts", () => {
886
+ expect([...SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_OPTIONS]).toEqual(
887
+ SYSTEM_ONE_EXTRACT_PROVIDER_IDS,
888
+ );
889
+ expect(validateConfigValue(key, "cloudflare")).toBeNull();
890
+ expect(validateConfigValue(key, "openai")).toContain(
891
+ "Invalid SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER value",
892
+ );
893
+ });
894
+
895
+ test("a node without a provider resolves the setting at each extraction", async () => {
896
+ expect(SystemOneExtractionConfigSchema.parse(config()).provider).toBeUndefined();
897
+ let reads = 0;
898
+ const { transport, calls } = makeTransport([jsonResponse(envelope())]);
899
+ const executor = new SystemOneExtractionExecutor(
900
+ {
901
+ ...deps,
902
+ db: {
903
+ ...deps.db,
904
+ getSwarmConfigs: async (filter) => {
905
+ reads++;
906
+ return deps.db.getSwarmConfigs(filter);
907
+ },
908
+ },
909
+ },
910
+ {
911
+ fetch: transport,
912
+ env: { [key]: "openai" },
913
+ getApiKey: async () => CF_TOKEN,
914
+ getServerUrl: async () => CF_ACCOUNT,
915
+ },
916
+ );
917
+ await upsertSwarmConfig({ scope: "global", key, value: "cloudflare" });
918
+ expect((await run(executor, config())).status).toBe("success");
919
+ expect(calls[0]?.url).toBe(`${CF_BASE}/clairic`);
920
+ await getDbClient().run("UPDATE swarm_config SET value = 'laya' WHERE key = ?", [key]);
921
+ expect((await run(executor, config())).status).toBe("success");
922
+ expect(calls[1]?.url).toBe(`${CF_BASE}/clairic`);
923
+ expect(reads).toBe(2);
924
+ });
925
+
926
+ test("an explicit provider does not read the default", async () => {
927
+ let reads = 0;
928
+ const executor = new SystemOneExtractionExecutor(
929
+ {
930
+ ...deps,
931
+ db: {
932
+ ...deps.db,
933
+ getSwarmConfigs: async () => {
934
+ reads++;
935
+ throw new Error("default must not be read");
936
+ },
937
+ },
938
+ },
939
+ {
940
+ fetch: makeTransport([jsonResponse(envelope())]).transport,
941
+ getApiKey: async (id) => {
942
+ expect(id).toBe("cloudflare");
943
+ return CF_TOKEN;
944
+ },
945
+ getServerUrl: async () => CF_ACCOUNT,
946
+ env: { [key]: "openai" },
947
+ },
948
+ );
949
+ expect((await run(executor, config({ provider: "cloudflare" }))).status).toBe("success");
950
+ expect(reads).toBe(0);
951
+ });
952
+
953
+ test("readiness resolves the default once for all nodes", async () => {
954
+ let reads = 0;
955
+ const executor = new SystemOneExtractionExecutor(
956
+ {
957
+ ...deps,
958
+ db: {
959
+ ...deps.db,
960
+ getSwarmConfigs: async (filter) => {
961
+ reads++;
962
+ expect(filter).toEqual({ scope: "global", key });
963
+ return [];
964
+ },
965
+ },
966
+ },
967
+ {
968
+ env: { [key]: "cloudflare" },
969
+ getApiKey: async () => null,
970
+ getServerUrl: async () => CF_ACCOUNT,
971
+ },
972
+ );
973
+ const problems = await executor.checkReadiness([
974
+ { id: "a", config: config() },
975
+ { id: "b", config: config() },
976
+ ]);
977
+ expect(reads).toBe(1);
978
+ expect(problems).toHaveLength(1);
979
+ expect(problems[0]?.nodeIds).toEqual(["a", "b"]);
980
+ expect(problems[0]?.message).toContain("CLOUDFLARE_API_TOKEN");
981
+ });
982
+ });
@@ -1,5 +1,6 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
+ import { cardIssuesMessage, cardSpecInputSchema, renderCardFor } from "@/integrations/cards";
3
4
  import { CHAT_SDK_ADAPTER_NAMES } from "@/integrations/chat-sdk/config";
4
5
  import { errorMessage } from "@/integrations/chat-sdk/logger";
5
6
  import {
@@ -17,7 +18,7 @@ export const registerChatPostTool = (server: McpServer) => {
17
18
  {
18
19
  title: "Post to a chat thread or channel",
19
20
  description:
20
- "Lead only. Post a message to any Chat SDK thread or channel (Telegram, Slack, Discord, Teams), outside the thread of your current task. Give threadId to reply in a thread, or channelId to start a new message in a channel. Ids carry the adapter prefix, such as telegram:12345. To answer the user of your current chat task, use chat-reply instead.",
21
+ "Lead only. Post a message to any Chat SDK thread or channel (Telegram, Slack, Discord, Teams), outside the thread of your current task. Give threadId to reply in a thread, or channelId to start a new message in a channel. Ids carry the adapter prefix, such as telegram:12345. To answer the user of your current chat task, use chat-reply instead. For a structured result (key figures, a table, charts, links), send a `card`; it posts after the text as a native card.",
21
22
  annotations: { openWorldHint: true },
22
23
  inputSchema: z.object({
23
24
  adapter: z.enum(CHAT_SDK_ADAPTER_NAMES).describe("Chat SDK adapter name."),
@@ -31,7 +32,13 @@ export const registerChatPostTool = (server: McpServer) => {
31
32
  .min(1)
32
33
  .optional()
33
34
  .describe("Full SDK channel id, such as slack:C123. Ignored when threadId is set."),
34
- text: z.string().min(1).max(20_000).describe("Markdown text to post."),
35
+ text: z
36
+ .string()
37
+ .min(1)
38
+ .max(20_000)
39
+ .optional()
40
+ .describe("Markdown text to post. Required unless card is given."),
41
+ card: cardSpecInputSchema.optional(),
35
42
  attachments: chatAttachmentsSchema,
36
43
  }),
37
44
  outputSchema: swarmToolOutputSchema({
@@ -45,10 +52,11 @@ export const registerChatPostTool = (server: McpServer) => {
45
52
  .optional(),
46
53
  }),
47
54
  },
48
- async ({ adapter, threadId, channelId, text, attachments }, requestInfo) => {
55
+ async ({ adapter, threadId, channelId, text, card, attachments }, requestInfo) => {
49
56
  const data = { yourAgentId: requestInfo.agentId };
50
57
  const target = threadId ?? channelId;
51
58
  if (!target) return toolErr("Give a threadId or a channelId.", { data });
59
+ if (!text && !card) return toolErr("Provide text or a card.", { data });
52
60
  if (adapterOfChatId(target) !== adapter) {
53
61
  return toolErr(`The id ${target} does not belong to the ${adapter} adapter.`, { data });
54
62
  }
@@ -58,6 +66,12 @@ export const registerChatPostTool = (server: McpServer) => {
58
66
  { data },
59
67
  );
60
68
  }
69
+ const rendered = card ? await renderCardFor(adapter, card) : undefined;
70
+ if (rendered && "issues" in rendered) {
71
+ return toolErr(cardIssuesMessage(rendered.issues), {
72
+ data: { ...data, issues: rendered.issues },
73
+ });
74
+ }
61
75
  const resolved = await resolveChatAttachmentRefs(
62
76
  attachments ?? [],
63
77
  requestInfo.sourceTaskId,
@@ -68,7 +82,8 @@ export const registerChatPostTool = (server: McpServer) => {
68
82
  const sent = await postChatMessage({
69
83
  adapter,
70
84
  ...(threadId ? { threadId } : { channelId }),
71
- text,
85
+ text: text ?? [],
86
+ card: rendered?.card,
72
87
  taskId: requestInfo.sourceTaskId,
73
88
  files: resolved.files,
74
89
  });
@@ -1,6 +1,7 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
3
  import { getAgentCurrentTask, getTaskById } from "@/be/db";
4
+ import { cardIssuesMessage, cardSpecInputSchema, renderCardFor } from "@/integrations/cards";
4
5
  import { errorMessage } from "@/integrations/chat-sdk/logger";
5
6
  import {
6
7
  ChatAdapterUnavailableError,
@@ -18,10 +19,16 @@ export const registerChatReplyTool = (server: McpServer) => {
18
19
  {
19
20
  title: "Reply in the chat thread of this task",
20
21
  description:
21
- "Post a message to the Telegram, Slack, Discord or Teams thread your current task came from. Works only on a task whose contextKey starts with task:chat-sdk:. The task's final output is posted to the thread automatically when the task ends, so use this only for a question to the user, a short progress note on long work, or to send files (attachments). Markdown is supported; long text is split into several messages. When the final output of a task is posted, the files attached to that task go with it.",
22
+ "Post a message to the Telegram, Slack, Discord or Teams thread your current task came from. Works only on a task whose contextKey starts with task:chat-sdk:. The task's final output is posted to the thread automatically when the task ends, so use this only for a question to the user, a short progress note on long work, or to send files (attachments). Markdown is supported; long text is split into several messages. When the final output of a task is posted, the files attached to that task go with it. For a structured result (key figures, a table, charts, links), send a `card`; it posts after the text as a native card.",
22
23
  annotations: { openWorldHint: true },
23
24
  inputSchema: z.object({
24
- text: z.string().min(1).max(20_000).describe("Markdown text to post to the thread."),
25
+ text: z
26
+ .string()
27
+ .min(1)
28
+ .max(20_000)
29
+ .optional()
30
+ .describe("Markdown text to post to the thread. Required unless card is given."),
31
+ card: cardSpecInputSchema.optional(),
25
32
  attachments: chatAttachmentsSchema,
26
33
  }),
27
34
  outputSchema: swarmToolOutputSchema({
@@ -34,9 +41,10 @@ export const registerChatReplyTool = (server: McpServer) => {
34
41
  .optional(),
35
42
  }),
36
43
  },
37
- async ({ text, attachments }, requestInfo) => {
44
+ async ({ text, card, attachments }, requestInfo) => {
38
45
  if (!requestInfo.agentId) return toolErr("Agent ID not found.");
39
46
  const data = { yourAgentId: requestInfo.agentId };
47
+ if (!text && !card) return toolErr("Provide text or a card.", { data });
40
48
 
41
49
  // The header names the task this session works on; without it, the
42
50
  // agent's current in-progress task.
@@ -55,6 +63,13 @@ export const registerChatReplyTool = (server: McpServer) => {
55
63
  { data },
56
64
  );
57
65
  }
66
+ // Validated for the thread's adapter, before anything is sent.
67
+ const rendered = card ? await renderCardFor(thread.adapter, card) : undefined;
68
+ if (rendered && "issues" in rendered) {
69
+ return toolErr(cardIssuesMessage(rendered.issues), {
70
+ data: { ...data, issues: rendered.issues },
71
+ });
72
+ }
58
73
 
59
74
  const resolved = await resolveChatAttachmentRefs(
60
75
  attachments ?? [],
@@ -67,7 +82,8 @@ export const registerChatReplyTool = (server: McpServer) => {
67
82
  const sent = await postChatMessage({
68
83
  adapter: thread.adapter,
69
84
  threadId: thread.threadId,
70
- text,
85
+ text: text ?? [],
86
+ card: rendered?.card,
71
87
  taskId: task.id,
72
88
  files: resolved.files,
73
89
  // Same anchor as the final answer: the message that started this task.
@@ -24,7 +24,8 @@
24
24
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
25
25
  import * as z from "zod";
26
26
  import { authorizeAssetKeyWrite } from "@/be/asset-key-auth";
27
- import { resolveTaskAuditUserId } from "@/be/audit-user";
27
+ import { resolveTaskAuditUserId, resolveTaskGroupKey } from "@/be/audit-user";
28
+ import { fileCallerSessionIntoGroup } from "@/be/caller-session-group";
28
29
  import { createPage, getPage, getPageBySlug, updatePage } from "@/be/db";
29
30
  import { getPageEditCounter } from "@/be/db/page-versions";
30
31
  import { classAttributeValues, countColorLiterals } from "@/pages/color-literals";
@@ -101,7 +102,7 @@ export const registerCreatePageTool = (server: McpServer) => {
101
102
  annotations: { destructiveHint: false },
102
103
  inputSchema: z.object({
103
104
  key: AssetKeySchema.optional().describe(
104
- "Logical namespace. Defaults to a shared/page:<id>/ resource key.",
105
+ "Logical namespace. Defaults to the calling task's group key when it has one, else shared/page:<id>/. An explicit use-case group key also files the calling task's session into that group while the session still has its default key.",
105
106
  ),
106
107
  title: z.string().min(1).describe("Human-readable title shown in listings."),
107
108
  slug: z
@@ -174,6 +175,7 @@ export const registerCreatePageTool = (server: McpServer) => {
174
175
  colorLiteralCount: z.number().optional(),
175
176
  usesDesignSystem: z.boolean().optional(),
176
177
  lightOnlyColors: z.boolean().optional(),
178
+ movedSessionRootId: z.string().optional(),
177
179
  }),
178
180
  },
179
181
  async (input, requestInfo, _meta) => {
@@ -211,7 +213,11 @@ export const registerCreatePageTool = (server: McpServer) => {
211
213
  let assetKey: string | undefined;
212
214
  try {
213
215
  if (input.key !== undefined || !existing) {
214
- assetKey = input.key ? await authorizeAssetKeyWrite(input.key, trustedUserId) : undefined;
216
+ const resolvedKey =
217
+ input.key ?? (await resolveTaskGroupKey(requestInfo.sourceTaskId, requestInfo.agentId));
218
+ assetKey = resolvedKey
219
+ ? await authorizeAssetKeyWrite(resolvedKey, trustedUserId)
220
+ : undefined;
215
221
  }
216
222
  } catch (error) {
217
223
  const msg = error instanceof Error ? error.message : String(error);
@@ -303,12 +309,22 @@ export const registerCreatePageTool = (server: McpServer) => {
303
309
  }
304
310
  : {};
305
311
  const { ignored } = themeFields;
312
+ const movedSessionRootId =
313
+ input.key !== undefined && assetKey
314
+ ? await fileCallerSessionIntoGroup({
315
+ sourceTaskId: requestInfo.sourceTaskId,
316
+ agentId: requestInfo.agentId,
317
+ key: assetKey,
318
+ changedBy: trustedUserId ?? undefined,
319
+ })
320
+ : null;
306
321
 
307
322
  return toolOk(
308
323
  `Page "${input.title}" saved (slug=${finalSlug}, version=${version}, designVersion=${fresh.designVersion}).` +
309
324
  (ignored.length > 0
310
325
  ? " Some theme tokens were ignored (outside the page token contract or referencing a variable outside it)."
311
- : ""),
326
+ : "") +
327
+ (movedSessionRootId ? ` This session moved into ${assetKey}.` : ""),
312
328
  {
313
329
  details:
314
330
  `API: ${apiUrl}\n App: ${appUrl}` +
@@ -323,6 +339,7 @@ export const registerCreatePageTool = (server: McpServer) => {
323
339
  designVersion: fresh.designVersion,
324
340
  ...(ignored.length > 0 ? { ignoredTokens: ignored } : {}),
325
341
  ...designFlags,
342
+ ...(movedSessionRootId ? { movedSessionRootId } : {}),
326
343
  },
327
344
  },
328
345
  );
@@ -1,6 +1,7 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
3
  import { getAllAgents } from "@/be/db";
4
+ import { isAgentOnDemand } from "@/be/runtime-pools/reachability";
4
5
  import { createToolRegistrar, swarmToolOutputSchema, toolOk } from "@/tools/utils";
5
6
  import { AgentStatusSchema, ProviderNameSchema } from "@/types";
6
7
 
@@ -11,6 +12,12 @@ const agentOutputShape = z.looseObject({
11
12
  name: z.string().optional(),
12
13
  isLead: z.boolean().optional(),
13
14
  status: AgentStatusSchema.optional(),
15
+ onDemand: z
16
+ .boolean()
17
+ .optional()
18
+ .describe(
19
+ "True when the agent is offline but its runtime pool will start a runtime for it (multi-runtime on, pool capacity left, maxTasks fits one runtime). send-task to it starts a runtime.",
20
+ ),
14
21
  description: z.string().optional(),
15
22
  role: z.string().optional(),
16
23
  capabilities: z.array(z.string()).optional(),
@@ -57,12 +64,21 @@ export const registerGetSwarmTool = (server: McpServer) => {
57
64
  }),
58
65
  },
59
66
  async ({ includeFull }, requestInfo, _meta) => {
60
- const agents = await getAllAgents({ slim: !includeFull });
67
+ // A pool agent without a live runtime reports "offline", but a task sent
68
+ // to it starts a runtime. Mark it, so a Lead does not read it as unavailable.
69
+ const agents = await Promise.all(
70
+ (await getAllAgents({ slim: !includeFull })).map(async (a) =>
71
+ (await isAgentOnDemand(a)) ? { ...a, onDemand: true } : a,
72
+ ),
73
+ );
61
74
 
62
75
  // Include the ID — send-task targets agents by ID, and text-only
63
76
  // harnesses never see the structured data to look it up.
64
77
  const agentList = agents
65
- .map((a) => `- ${a.name} (${a.status}${a.isLead ? ", lead" : ""}) — id: ${a.id}`)
78
+ .map((a) => {
79
+ const onDemand = "onDemand" in a ? ", on demand: send-task starts it" : "";
80
+ return `- ${a.name} (${a.status}${onDemand}${a.isLead ? ", lead" : ""}) — id: ${a.id}`;
81
+ })
66
82
  .join("\n");
67
83
 
68
84
  return toolOk(
@@ -138,7 +138,8 @@ export const registerJoinSwarmTool = (server: McpServer) => {
138
138
  capabilities,
139
139
  claudeMd: defaultClaudeMd,
140
140
  soulMd: defaultSoulMd,
141
- identityMd: defaultIdentityMd,
141
+ // A pending file import may have written it in createAgent.
142
+ identityMd: agent.identityMd || defaultIdentityMd,
142
143
  });
143
144
 
144
145
  return updatedAgent ?? agent;
@@ -1,6 +1,10 @@
1
1
  import { getAgentById } from "@/be/db";
2
2
  import { mcpOverflowAuthError } from "@/kv-overflow";
3
- import { reservedNamespaceError, reservedRoomKeyError } from "@/kv-reserved-namespaces";
3
+ import {
4
+ requiresLeadToWrite,
5
+ reservedNamespaceError,
6
+ reservedRoomKeyError,
7
+ } from "@/kv-reserved-namespaces";
4
8
  import { can } from "@/rbac";
5
9
 
6
10
  /**
@@ -31,6 +35,18 @@ export async function kvWriteAuthError(
31
35
  if (namespace.startsWith("task:page:")) {
32
36
  return "task:page:* writes require a page-proxy request, not an MCP call";
33
37
  }
38
+ if (requiresLeadToWrite(namespace)) {
39
+ const agent = info.agentId ? await getAgentById(info.agentId) : null;
40
+ const allowed =
41
+ info.agentId != null &&
42
+ can({
43
+ principal: { kind: "agent", agentId: info.agentId, isLead: agent?.isLead ?? false },
44
+ verb: "kv.write.any",
45
+ resource: { kind: "kv-namespace", namespace },
46
+ source: "mcp",
47
+ }).allow;
48
+ if (!allowed) return "writes to this namespace require lead";
49
+ }
34
50
  if (namespace.startsWith("task:agent:")) {
35
51
  // A missing caller identity can never own a namespace nor be lead — same
36
52
  // denial as before (no separate "agent not found" branch). Own-namespace
@@ -2,7 +2,8 @@ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import { CronExpressionParser } from "cron-parser";
3
3
  import * as z from "zod";
4
4
  import { authorizeAssetKeyWrite } from "@/be/asset-key-auth";
5
- import { resolveTaskAuditUserId } from "@/be/audit-user";
5
+ import { resolveTaskAuditUserId, resolveTaskGroupKey } from "@/be/audit-user";
6
+ import { fileCallerSessionIntoGroup } from "@/be/caller-session-group";
6
7
  import {
7
8
  createScheduledTask,
8
9
  extensionAgentAssignmentError,
@@ -33,7 +34,7 @@ import {
33
34
 
34
35
  export const createScheduleInputSchema = z.object({
35
36
  key: AssetKeySchema.optional().describe(
36
- "Logical namespace. Defaults to a shared/schedule:<id>/ resource key.",
37
+ "Logical namespace. Defaults to the calling task's group key when it has one, else shared/schedule:<id>/. An explicit use-case group key also files the calling task's session into that group while the session still has its default key, so the planning session, the schedule and its runs share one key.",
37
38
  ),
38
39
  name: z.string().min(1).max(100).describe("Unique name for the schedule (e.g., 'daily-cleanup')"),
39
40
  taskTemplate: z
@@ -178,6 +179,7 @@ export const registerCreateScheduleTool = (server: McpServer) => {
178
179
  yourAgentId: z.string().optional(),
179
180
  schedule: z.looseObject(scheduleDataShape).optional(),
180
181
  modelTierDeprecated: modelTierDeprecatedOutputSchema.optional(),
182
+ movedSessionRootId: z.string().optional(),
181
183
  }),
182
184
  },
183
185
  async (
@@ -327,7 +329,11 @@ export const registerCreateScheduleTool = (server: McpServer) => {
327
329
  const createdBy =
328
330
  (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
329
331
  undefined;
330
- const assetKey = key ? await authorizeAssetKeyWrite(key, createdBy) : undefined;
332
+ const resolvedKey =
333
+ key ?? (await resolveTaskGroupKey(requestInfo.sourceTaskId, requestInfo.agentId));
334
+ const assetKey = resolvedKey
335
+ ? await authorizeAssetKeyWrite(resolvedKey, createdBy)
336
+ : undefined;
331
337
 
332
338
  const schedule = await createScheduledTask({
333
339
  key: assetKey,
@@ -355,17 +361,29 @@ export const registerCreateScheduleTool = (server: McpServer) => {
355
361
  createdBy,
356
362
  });
357
363
 
364
+ const movedSessionRootId =
365
+ key !== undefined && assetKey
366
+ ? await fileCallerSessionIntoGroup({
367
+ sourceTaskId: requestInfo.sourceTaskId,
368
+ agentId: requestInfo.agentId,
369
+ key: assetKey,
370
+ changedBy: createdBy,
371
+ })
372
+ : null;
373
+
358
374
  const scheduleDesc = isOneTime
359
375
  ? `one-time at ${schedule.nextRunAt}`
360
376
  : cronExpression || `every ${intervalMs}ms`;
361
377
  const modelTierDeprecated = modelTierDeprecation(modelTier, targetHarness);
378
+ const movedNote = movedSessionRootId ? `. This session moved into ${assetKey}.` : "";
362
379
  return toolOk(
363
- `Created schedule "${name}" (${scheduleDesc}). Next run: ${schedule.nextRunAt || "disabled"}`,
380
+ `Created schedule "${name}" (${scheduleDesc}). Next run: ${schedule.nextRunAt || "disabled"}${movedNote}`,
364
381
  {
365
382
  data: {
366
383
  yourAgentId: requestInfo.agentId,
367
384
  schedule,
368
385
  ...(modelTierDeprecated ? { modelTierDeprecated } : {}),
386
+ ...(movedSessionRootId ? { movedSessionRootId } : {}),
369
387
  },
370
388
  },
371
389
  );
@@ -6,6 +6,13 @@ import {
6
6
  getTaskById,
7
7
  recordSlackMessage,
8
8
  } from "@/be/db";
9
+ import {
10
+ cardIssuesMessage,
11
+ cardSpecInputSchema,
12
+ cardToSlack,
13
+ renderCard,
14
+ slackFallbackText,
15
+ } from "@/integrations/cards";
9
16
  import { can } from "@/rbac";
10
17
  import { getSlackApp } from "@/slack/app";
11
18
  import { buildMrkdwnSectionBlocks, getTaskLink } from "@/slack/blocks";
@@ -21,7 +28,7 @@ export const registerSlackPostTool = (server: McpServer) => {
21
28
  {
22
29
  title: "Post message to Slack channel",
23
30
  description:
24
- "Post a message to a Slack channel. By default creates a new top-level message; pass `threadTs` to post as a threaded reply under an existing message (obtain the ts from `slack-start-thread`). Requires lead privileges.",
31
+ "Post a message to a Slack channel. By default creates a new top-level message; pass `threadTs` to post as a threaded reply under an existing message (obtain the ts from `slack-start-thread`). For a structured result (key figures, a table, charts, links), send a `card` instead of hand-built `blocks`. Requires lead privileges.",
25
32
  annotations: { openWorldHint: true },
26
33
 
27
34
  inputSchema: z.object({
@@ -31,12 +38,22 @@ export const registerSlackPostTool = (server: McpServer) => {
31
38
  .describe(
32
39
  "The Slack channel ID to post to. A user ID (U…/W…) posts in the bot's DM with that user.",
33
40
  ),
34
- message: z.string().min(1).max(4000).describe("The message content to post."),
41
+ message: z
42
+ .string()
43
+ .min(1)
44
+ .max(4000)
45
+ .optional()
46
+ .describe(
47
+ "The message content to post. Required unless card is given; with a card it renders above it.",
48
+ ),
35
49
  blocks: z
36
50
  .array(z.record(z.string(), z.unknown()))
37
51
  .max(50)
38
52
  .optional()
39
- .describe("Optional Block Kit blocks. When omitted, a mrkdwn section is generated."),
53
+ .describe(
54
+ "Optional raw Block Kit blocks. When omitted, a mrkdwn section is generated. Prefer card.",
55
+ ),
56
+ card: cardSpecInputSchema.optional(),
40
57
  threadTs: z
41
58
  .string()
42
59
  .optional()
@@ -48,7 +65,11 @@ export const registerSlackPostTool = (server: McpServer) => {
48
65
  messageTs: z.string().optional(),
49
66
  }),
50
67
  },
51
- async ({ channelId: requestedChannelId, message, threadTs, blocks }, requestInfo, _meta) => {
68
+ async (
69
+ { channelId: requestedChannelId, message, threadTs, blocks, card },
70
+ requestInfo,
71
+ _meta,
72
+ ) => {
52
73
  if (!requestInfo.agentId) {
53
74
  return toolErr("Agent ID not found.");
54
75
  }
@@ -68,6 +89,17 @@ export const registerSlackPostTool = (server: McpServer) => {
68
89
  if (!decision.allow) {
69
90
  return toolErr("Posting to Slack channels requires lead privileges.");
70
91
  }
92
+ if (blocks && card) return toolErr("Provide either blocks or card, not both.");
93
+ if (!message && !card) return toolErr("Provide a message or a card.");
94
+ let cardSlack: { blocks: Record<string, unknown>[]; text: string } | undefined;
95
+ if (card) {
96
+ const rendered = renderCard(card);
97
+ const slack = "card" in rendered ? await cardToSlack(rendered.card) : rendered;
98
+ if ("issues" in slack) {
99
+ return toolErr(cardIssuesMessage(slack.issues), { data: { issues: slack.issues } });
100
+ }
101
+ cardSlack = slack;
102
+ }
71
103
 
72
104
  const app = getSlackApp();
73
105
  if (!app) {
@@ -88,7 +120,7 @@ export const registerSlackPostTool = (server: McpServer) => {
88
120
  }
89
121
 
90
122
  try {
91
- const slackMessage = markdownToSlack(message);
123
+ const slackMessage = message ? markdownToSlack(message) : "";
92
124
 
93
125
  const sourceTask = requestInfo.sourceTaskId
94
126
  ? await getTaskById(requestInfo.sourceTaskId)
@@ -96,7 +128,8 @@ export const registerSlackPostTool = (server: McpServer) => {
96
128
  const contextKey = sourceTask?.contextKey;
97
129
  const tree = threadTs ? await getSlackTreeMessageByThread(channelId, threadTs) : null;
98
130
  const messageBlocks: Record<string, unknown>[] = [
99
- ...(blocks ?? buildMrkdwnSectionBlocks(slackMessage)),
131
+ ...(cardSlack && slackMessage ? buildMrkdwnSectionBlocks(slackMessage) : []),
132
+ ...(cardSlack?.blocks ?? blocks ?? buildMrkdwnSectionBlocks(slackMessage)),
100
133
  ];
101
134
  if (sourceTask && tree) {
102
135
  if (messageBlocks.length >= 50) {
@@ -116,7 +149,7 @@ export const registerSlackPostTool = (server: McpServer) => {
116
149
  const result = await withAutoJoin(app.client, channelId, () =>
117
150
  app.client.chat.postMessage({
118
151
  channel: channelId,
119
- text: slackMessage, // Fallback for notifications
152
+ text: slackFallbackText(slackMessage, cardSlack?.text), // Fallback for notifications
120
153
  unfurl_links: false,
121
154
  unfurl_media: false,
122
155
  username: getAgentDisplayName(agent),