@desplega.ai/agent-swarm 2.8.2 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (558) hide show
  1. package/dist/acp-adapter-jqn86aam.js +16 -0
  2. package/dist/acp-targets-swxq55dr.js +23 -0
  3. package/dist/{actions-kxek041g.js → actions-pb678g3e.js} +22 -20
  4. package/dist/agent-fs-provision-dmhnc38q.js +27 -0
  5. package/dist/{amp-adapter-ce7jjke4.js → amp-adapter-3pa66q27.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-x2cp5fvf.js} +41 -41
  7. package/dist/{app-v6zz8yh0.js → app-17d12ev4.js} +6 -4
  8. package/dist/approval-notifications-h7vd9pmg.js +20 -0
  9. package/dist/{assistant-m0sw9xx2.js → assistant-t7k39ree.js} +56 -34
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-66bk37wv.js → boot-args-schema-0gqmkfbe.js} +1 -1
  12. package/dist/{boot-reembed-edjpwsc1.js → boot-reembed-f064w382.js} +1 -1
  13. package/dist/{boot-reembed-y27n09tz.js → boot-reembed-n6anc01d.js} +1 -1
  14. package/dist/{boot-scrub-sweep-1xc35965.js → boot-scrub-sweep-ejd5dnrz.js} +84 -13
  15. package/dist/{boot-seeds-7hjj91qj.js → boot-seeds-f99fjs5q.js} +4 -4
  16. package/dist/{boxd-ent8ch04.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-gvznwxgc.js +28 -0
  18. package/dist/{claude-managed-adapter-jh6c523j.js → claude-managed-adapter-pbrbvc64.js} +4 -4
  19. package/dist/{claude-managed-setup-y6z2perp.js → claude-managed-setup-kdxttvc3.js} +11 -11
  20. package/dist/{claude-sdk-session-vvya8wqk.js → claude-sdk-session-0t2teq6n.js} +9386 -9197
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-rmzsadkf.js → cli-1tvdx9t5.js} +2 -2
  23. package/dist/{cli-3vmb0n58.js → cli-25nstr34.js} +1 -1
  24. package/dist/{cli-959kp5h2.js → cli-2kg31ted.js} +45 -38
  25. package/dist/{cli-4vzgeta4.js → cli-2tnbc3gw.js} +375 -127
  26. package/dist/{cli-tekytdq9.js → cli-3zxdz9r7.js} +9 -9
  27. package/dist/{cli-bsywb58a.js → cli-4ghh072d.js} +16 -16
  28. package/dist/{cli-9mb2q6pb.js → cli-57pvhnyt.js} +4 -4
  29. package/dist/{cli-d84byzn8.js → cli-5a6pqy45.js} +441 -53
  30. package/dist/{cli-jrzkw01m.js → cli-5gpqgs8b.js} +2 -2
  31. package/dist/{cli-0cq8y6m7.js → cli-5gygrr67.js} +9 -9
  32. package/dist/{cli-z1w943va.js → cli-5kcmxwxv.js} +3 -3
  33. package/dist/{cli-3e875j5p.js → cli-5ntc4we6.js} +3189 -328
  34. package/dist/{cli-bst1vp7e.js → cli-5y2fvw4z.js} +13 -5
  35. package/dist/{cli-mrt48bx7.js → cli-6237rnyr.js} +1 -1
  36. package/dist/cli-6dp0jkfj.js +754 -0
  37. package/dist/{cli-b98a65ed.js → cli-7831nhaw.js} +5 -5
  38. package/dist/{cli-kjtwrhea.js → cli-7cgf614g.js} +10 -10
  39. package/dist/{cli-fwy8kfd6.js → cli-7fx9jyfs.js} +942 -63
  40. package/dist/{cli-28fq781p.js → cli-7zm3b3f5.js} +1 -1
  41. package/dist/{cli-v1dv1r37.js → cli-812paz57.js} +143 -9
  42. package/dist/{cli-837vfs2x.js → cli-8axx8vnw.js} +4 -4
  43. package/dist/cli-8x8y70av.js +103 -0
  44. package/dist/{cli-vj75tyaw.js → cli-95930z69.js} +15 -7
  45. package/dist/{cli-j24zbska.js → cli-9a2rtd77.js} +16 -14
  46. package/dist/cli-9ttx00s3.js +137 -0
  47. package/dist/{cli-6ek0hff4.js → cli-a9hfzg2r.js} +3 -3
  48. package/dist/{cli-dzpc6en0.js → cli-aa8s22gn.js} +19 -14
  49. package/dist/{cli-x1wa213s.js → cli-bk9v1xrv.js} +21 -21
  50. package/dist/{cli-a0z912j7.js → cli-c07v0qfa.js} +194 -75
  51. package/dist/{cli-1qkz151v.js → cli-c5cspahx.js} +28 -36
  52. package/dist/{cli-vdektqgf.js → cli-cw7mc1je.js} +4 -4
  53. package/dist/{cli-n6vtrcht.js → cli-dd37e0cm.js} +2 -2
  54. package/dist/cli-dqgnbnxs.js +132 -0
  55. package/dist/{cli-kc7v1nfv.js → cli-dx439zpg.js} +1 -1
  56. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  57. package/dist/{cli-f6bahpn5.js → cli-e9973bf0.js} +8 -6
  58. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  59. package/dist/{cli-6rc5frdm.js → cli-eepnpee7.js} +34 -37
  60. package/dist/{cli-rvhdmjvt.js → cli-eg437b5p.js} +1 -1
  61. package/dist/cli-faf46gdq.js +714 -0
  62. package/dist/{cli-f4r3g076.js → cli-fgphc007.js} +2 -2
  63. package/dist/{cli-5y340nzn.js → cli-fnh4b12r.js} +24 -18
  64. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  65. package/dist/{cli-e1p3n5gq.js → cli-g3zzby8t.js} +13 -13
  66. package/dist/{cli-3vjhs18n.js → cli-gabsjg8x.js} +3 -1
  67. package/dist/{cli-1pz0330a.js → cli-gddgcnav.js} +3 -3
  68. package/dist/{cli-97ae65rz.js → cli-h474mvp5.js} +11 -11
  69. package/dist/{cli-m88rpzkh.js → cli-hnamkvnc.js} +2 -2
  70. package/dist/{cli-8bpgbr8k.js → cli-j49yqpvh.js} +6 -6
  71. package/dist/{cli-w401b9tq.js → cli-jd3kxppb.js} +1 -1
  72. package/dist/{cli-m9s2qff2.js → cli-jg5txpm6.js} +187 -93
  73. package/dist/{cli-8aes17e4.js → cli-js8zrfyg.js} +3 -3
  74. package/dist/{cli-pfs8adn4.js → cli-k09cxm6m.js} +9 -7
  75. package/dist/{cli-q24n86d2.js → cli-k7pt28ad.js} +10 -3
  76. package/dist/{cli-zh9rsbqf.js → cli-kaa4bd7x.js} +11 -8
  77. package/dist/cli-kj0hyr43.js +51 -0
  78. package/dist/{cli-g70vxtjh.js → cli-kmvcm34h.js} +2 -2
  79. package/dist/{cli-t2tma8gb.js → cli-kqh27v2y.js} +2 -2
  80. package/dist/{cli-mxn1qvbn.js → cli-m1fbz2wj.js} +32 -57
  81. package/dist/{cli-2kvhc7x8.js → cli-mc1fx4xd.js} +51 -90
  82. package/dist/{cli-pchypa1s.js → cli-me4maa4j.js} +61 -6
  83. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  84. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  85. package/dist/cli-nhq5js1b.js +142 -0
  86. package/dist/cli-nmcpzbty.js +296 -0
  87. package/dist/cli-nr46j5pw.js +78 -0
  88. package/dist/{cli-5mrq3ake.js → cli-pn1v1pb0.js} +1 -1
  89. package/dist/{cli-f4e8r23x.js → cli-pwsax0vp.js} +11 -6
  90. package/dist/{cli-gyt3zydq.js → cli-pz1c00aa.js} +9 -754
  91. package/dist/{cli-eddnyg3t.js → cli-q2d3e1k1.js} +1 -1
  92. package/dist/{cli-fpjmegdb.js → cli-q8cfh1t9.js} +2 -2
  93. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  94. package/dist/{cli-2r0jcc3k.js → cli-qj39vrc6.js} +1 -1
  95. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  96. package/dist/{cli-0jzra9ad.js → cli-rts1qvb4.js} +2 -2
  97. package/dist/{cli-3rkdne1h.js → cli-sn4pc4qx.js} +2 -2
  98. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  99. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  100. package/dist/{cli-6wj7p986.js → cli-spzkdgtg.js} +3 -3
  101. package/dist/{cli-m2z8jagn.js → cli-srtkr1h2.js} +18 -18
  102. package/dist/{cli-2gxeg5gr.js → cli-ssvdrk4y.js} +1 -1
  103. package/dist/{cli-jdknh18m.js → cli-svc803vq.js} +69 -816
  104. package/dist/{cli-7349va39.js → cli-t9ga4qmb.js} +935 -445
  105. package/dist/{cli-m5akxq8q.js → cli-vs9vdpy0.js} +1 -1
  106. package/dist/{cli-26ctbcdp.js → cli-vvgaz8t6.js} +93 -44
  107. package/dist/{cli-3sy2xags.js → cli-vw5x18yj.js} +39 -69
  108. package/dist/{cli-kchjb7qy.js → cli-w16kwbzw.js} +1 -1
  109. package/dist/cli-w7dxb2fj.js +921 -0
  110. package/dist/{cli-x6t50dmw.js → cli-wr1h0k28.js} +3 -3
  111. package/dist/{cli-d6521kb5.js → cli-x40a0w9j.js} +1 -1
  112. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  113. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  114. package/dist/{cli-rcecc3yq.js → cli-ymct0ycy.js} +321 -111
  115. package/dist/{cli-xzm9vcfg.js → cli-zg3z63x3.js} +2 -2
  116. package/dist/cli.js +29 -26
  117. package/dist/{codex-adapter-zerf5qsp.js → codex-adapter-44yq2fkn.js} +9 -9
  118. package/dist/{codex-hook-30gyhzxe.js → codex-hook-h1zb7cfk.js} +6 -6
  119. package/dist/{codex-login-bcda78ge.js → codex-login-cdyrr5y1.js} +1 -1
  120. package/dist/{codex-session-runner-89s304py.js → codex-session-runner-zbh26gbw.js} +10 -10
  121. package/dist/{commands-jeh1b51j.js → commands-54f02v5b.js} +3 -3
  122. package/dist/{controller-mctfbrse.js → controller-9gpwcdek.js} +6 -6
  123. package/dist/{controllers-connect-nxa1ddwn.js → controllers-connect-61re6k1n.js} +26 -25
  124. package/dist/{cursor-adapter-qj8vehv6.js → cursor-adapter-7e4g81vd.js} +2 -2
  125. package/dist/{db-b36qn6k3.js → db-dg2gc7fd.js} +17 -13
  126. package/dist/{db-2dvay0es.js → db-wnh0qjy1.js} +3 -3
  127. package/dist/{devin-adapter-xedz98zv.js → devin-adapter-zp4tqq53.js} +1 -1
  128. package/dist/{dispatcher-gndbta01.js → dispatcher-jrm24r43.js} +19 -18
  129. package/dist/{docker-866qpzt9.js → docker-9aq30pp2.js} +5 -5
  130. package/dist/{dsh-adapter-f75sz821.js → dsh-adapter-1yqk267c.js} +2 -2
  131. package/dist/{e2b-3gpc2n3w.js → e2b-3v1e745x.js} +6 -6
  132. package/dist/{e2b-jbm7mj93.js → e2b-sm28k0k3.js} +6 -6
  133. package/dist/{easter-egg-3d-533knw22.js → easter-egg-3d-r4h9cs9m.js} +1 -1
  134. package/dist/{embedding-space-4p05vb2x.js → embedding-space-bafjr5f7.js} +6 -6
  135. package/dist/{embeddings-m6768mgh.js → embeddings-7xmgqe0e.js} +1 -1
  136. package/dist/{event-bus-e66gh7cc.js → event-bus-xr83x566.js} +1 -1
  137. package/dist/{execute-b3mrb1mv.js → execute-d6jg5ns0.js} +1 -1
  138. package/dist/{external-channel-gjv3jne3.js → external-channel-frq1xvq2.js} +2 -2
  139. package/dist/fx-adapter-0zrkfbkd.js +19 -0
  140. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  141. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  142. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  143. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  144. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  145. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-hh7strj3.js} +1 -1
  146. package/dist/{google-vertex-fhxaafzw.js → google-vertex-fy5bw2pm.js} +5 -5
  147. package/dist/grok-adapter-3db1c538.js +19 -0
  148. package/dist/handlers-k22n8mnn.js +33 -0
  149. package/dist/{heartbeat-a1tv60gt.js → heartbeat-6bpa611t.js} +22 -21
  150. package/dist/{hook-8h5dzcgq.js → hook-hvm5nf46.js} +5 -5
  151. package/dist/{hook-cyaps9ba.js → hook-w12k146y.js} +14 -14
  152. package/dist/{http-t15mhbd9.js → http-43tthdvs.js} +5838 -2600
  153. package/dist/{index-d6wkh8ar.js → index-1f0vypbg.js} +2 -2
  154. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  155. package/dist/{index-khe3gp0k.js → index-4b1q8kan.js} +20 -20
  156. package/dist/{index-hjhfk3ra.js → index-585gyczt.js} +1 -1
  157. package/dist/index-8xcyd3mc.js +33 -0
  158. package/dist/index-9sy2bh6n.js +38 -0
  159. package/dist/{index-2skqtd76.js → index-b24j7t2m.js} +30 -28
  160. package/dist/{index-gjwaqaq8.js → index-cret47a5.js} +6 -6
  161. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  162. package/dist/{index-w1zqf680.js → index-fn054vsf.js} +1 -1
  163. package/dist/{index-qav6455f.js → index-ftywhyr0.js} +214 -152
  164. package/dist/{index-tvfafeyy.js → index-mhq4sh5w.js} +1 -1
  165. package/dist/index-tx9mc2ap.js +570 -0
  166. package/dist/index-wjd56k1v.js +34 -0
  167. package/dist/{keepalive-91s7hzrb.js → keepalive-rk0j0jvh.js} +4 -4
  168. package/dist/lead-atxf3q6e.js +72 -0
  169. package/dist/{maintenance-7pjmy5xy.js → maintenance-g6z6kaxw.js} +1 -1
  170. package/dist/{node-4c5jqxr3.js → node-7qsx5kvm.js} +1 -1
  171. package/dist/{node-252anz2h.js → node-jftbyawr.js} +4 -4
  172. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  173. package/dist/{oauth-refresh-sweep-rzqfm94j.js → oauth-refresh-sweep-2k3g2q4w.js} +3 -3
  174. package/dist/{onboard-74st7pag.js → onboard-6fdbvh3v.js} +8 -8
  175. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  176. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  177. package/dist/{opencode-adapter-arn7gm8q.js → opencode-adapter-fdbsvts7.js} +7 -7
  178. package/dist/{otel-impl-rnzey8cb.js → otel-impl-rvwtc09q.js} +110 -110
  179. package/dist/pending-sqkrb836.js +80 -0
  180. package/dist/{pi-mono-adapter-6mkwq64n.js → pi-mono-adapter-asqayqcg.js} +13 -13
  181. package/dist/{pricing-refresh-ha21jhk7.js → pricing-refresh-f5tkgmw2.js} +2 -2
  182. package/dist/{rbac-roles-wqhma4dr.js → rbac-roles-06s555fa.js} +3 -3
  183. package/dist/{rbac-roles-59dxachk.js → rbac-roles-szxsg8t1.js} +10 -3
  184. package/dist/{render-v2-14kpzx12.js → render-v2-103p266q.js} +4 -4
  185. package/dist/{resume-gsa5fb5f.js → resume-v7kjewt9.js} +8 -7
  186. package/dist/{runtime-1hv06jsn.js → runtime-f1gmk0b7.js} +1 -1
  187. package/dist/{session-access-skm7bnp6.js → session-access-6shev8ts.js} +4 -4
  188. package/dist/{session-source-backfill-pbqzbncv.js → session-source-backfill-bd7spzjd.js} +3 -3
  189. package/dist/{setup-5yermsem.js → setup-kmxmztdb.js} +1 -1
  190. package/dist/thread-buffer-4yz236d0.js +36 -0
  191. package/dist/{virtual-modules-gazyapte.js → virtual-modules-57eje5wy.js} +5 -5
  192. package/dist/{work-objects-xj0ck0w4.js → work-objects-zr47ygmf.js} +23 -21
  193. package/dist/{worker-follow-up-911xc0b8.js → worker-follow-up-grrr3fda.js} +19 -18
  194. package/dist/worker-p4hbtcy3.js +72 -0
  195. package/dist/{x-2fyrt5pp.js → x-wg164ss9.js} +2 -2
  196. package/openapi.json +4518 -2356
  197. package/package.json +11 -8
  198. package/plugin/commands/create-pr.md +1 -1
  199. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  200. package/src/apps/action-runner.ts +21 -1
  201. package/src/apps/catalog.generated.json +626 -17
  202. package/src/apps/page-validator.ts +314 -8
  203. package/src/assets/key.ts +6 -0
  204. package/src/be/agent-fs-user-keys.ts +186 -0
  205. package/src/be/audit-user.ts +27 -13
  206. package/src/be/automation-preflight.test.ts +14 -14
  207. package/src/be/automation-preflight.ts +24 -16
  208. package/src/be/boot-scrub-sweep.ts +143 -14
  209. package/src/be/caller-session-group.ts +86 -0
  210. package/src/be/checklist.ts +375 -0
  211. package/src/be/db/agents.ts +12 -1
  212. package/src/be/db/approvals.ts +26 -0
  213. package/src/be/db/session-moves.ts +23 -0
  214. package/src/be/db/session-tree.ts +78 -19
  215. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  216. package/src/be/db/tasks/read.ts +33 -0
  217. package/src/be/db/tasks/slack-fold.ts +116 -0
  218. package/src/be/db/tasks/write.ts +34 -0
  219. package/src/be/db-queries/mcp-servers.ts +13 -0
  220. package/src/be/db-queries/oauth.ts +6 -0
  221. package/src/be/db-queries/task-artifacts.ts +10 -8
  222. package/src/be/db.ts +74 -22
  223. package/src/be/extensions/assets.ts +17 -13
  224. package/src/be/import/config.ts +54 -0
  225. package/src/be/import/dir-source.ts +372 -0
  226. package/src/be/import/index.ts +149 -0
  227. package/src/be/import/pending.ts +71 -0
  228. package/src/be/import/schema.ts +137 -0
  229. package/src/be/import/seeders.ts +462 -0
  230. package/src/be/migrations/289_automation_savings_daily.sql +47 -0
  231. package/src/be/migrations/291_task_slack_participants.sql +4 -0
  232. package/src/be/migrations/293_savings_component_links.sql +58 -0
  233. package/src/be/migrations/296_automation_savings_daily_read_index.sql +6 -0
  234. package/src/be/migrations/297_import_ownership.sql +34 -0
  235. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  236. package/src/be/migrations/302_checklist_items.sql +23 -0
  237. package/src/be/model-profile-check.ts +10 -2
  238. package/src/be/multi-runtime.ts +8 -1
  239. package/src/be/rbac-roles.ts +8 -1
  240. package/src/be/runtime-pools/demand.ts +20 -2
  241. package/src/be/runtime-pools/reachability.ts +31 -0
  242. package/src/be/runtime-pools/routing.ts +8 -1
  243. package/src/be/runtime-pools/supervisor.ts +6 -7
  244. package/src/be/savings/compute.ts +511 -16
  245. package/src/be/savings/model.ts +282 -14
  246. package/src/be/savings/read.ts +1502 -0
  247. package/src/be/savings/rollup.ts +571 -0
  248. package/src/be/script-credential-broker.ts +2 -2
  249. package/src/be/scripts/run-credential.ts +15 -3
  250. package/src/be/scripts/typecheck.ts +90 -8
  251. package/src/be/seed/agent-fs-provision.ts +104 -19
  252. package/src/be/seed/index.ts +1 -1
  253. package/src/be/seed/registry.ts +27 -8
  254. package/src/be/seed/runner.ts +1 -1
  255. package/src/be/seed/schedules-seeder.ts +24 -6
  256. package/src/be/seed/seed-toggle.ts +32 -0
  257. package/src/be/seed/types.ts +6 -0
  258. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  259. package/src/be/seed-scripts/catalog/dreaming-learnings.ts +10 -2
  260. package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +70 -4
  261. package/src/be/steering.ts +27 -4
  262. package/src/be/swarm-config-guard.ts +38 -0
  263. package/src/be/task-citations.ts +8 -5
  264. package/src/be/users.ts +29 -2
  265. package/src/commands/onboard/agent-fs-version.ts +1 -1
  266. package/src/commands/runner.ts +219 -42
  267. package/src/e2b/env.ts +2 -0
  268. package/src/extensions/catalog.generated.json +17 -0
  269. package/src/extensions/contract-types.generated.ts +1 -1
  270. package/src/github/app.ts +10 -1
  271. package/src/github/handlers.ts +6 -3
  272. package/src/github/reactions.ts +12 -14
  273. package/src/heartbeat/heartbeat.ts +14 -4
  274. package/src/http/agents.ts +19 -10
  275. package/src/http/all-routes.ts +2 -0
  276. package/src/http/approval-requests.ts +24 -4
  277. package/src/http/apps.ts +69 -5
  278. package/src/http/checklist.ts +176 -0
  279. package/src/http/db-query-bounded.ts +256 -11
  280. package/src/http/db-query-shared.ts +9 -0
  281. package/src/http/favorites.ts +14 -2
  282. package/src/http/fs.ts +346 -1
  283. package/src/http/index.ts +37 -2
  284. package/src/http/kv.ts +13 -0
  285. package/src/http/mcp-oauth.ts +1 -1
  286. package/src/http/mcp-servers.ts +15 -2
  287. package/src/http/onboarding.ts +2 -9
  288. package/src/http/poll.ts +59 -1
  289. package/src/http/requested-by.ts +97 -1
  290. package/src/http/savings.ts +676 -190
  291. package/src/http/script-connections.ts +1 -0
  292. package/src/http/scripts.ts +26 -15
  293. package/src/http/sessions.ts +17 -0
  294. package/src/http/slack-events.ts +101 -0
  295. package/src/http/status.ts +25 -7
  296. package/src/http/task-requester.ts +46 -0
  297. package/src/http/tasks.ts +107 -42
  298. package/src/http/users.ts +14 -0
  299. package/src/http/webhooks.ts +15 -0
  300. package/src/integrations/cards/index.ts +151 -0
  301. package/src/integrations/chat-sdk/outbound.ts +39 -13
  302. package/src/integrations/chat-sdk/runtime.ts +7 -1
  303. package/src/integrations/chat-sdk/status.ts +17 -0
  304. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  305. package/src/kv-reserved-namespaces.ts +17 -2
  306. package/src/oauth/presets.ts +29 -2
  307. package/src/prompts/base-prompt.ts +17 -4
  308. package/src/prompts/session-templates.ts +163 -9
  309. package/src/providers/acp-targets.ts +2 -2
  310. package/src/providers/amp-adapter.ts +1 -1
  311. package/src/providers/claude-adapter.ts +0 -20
  312. package/src/providers/claude-flag-settings.ts +12 -10
  313. package/src/providers/claude-managed-adapter.ts +5 -1
  314. package/src/providers/codex-adapter.ts +10 -35
  315. package/src/providers/codex-app-server.ts +2 -11
  316. package/src/providers/opencode-adapter.ts +41 -31
  317. package/src/providers/runtime-dependencies.ts +158 -0
  318. package/src/rbac/legacy-policy.ts +2 -0
  319. package/src/rbac/permissions.ts +10 -1
  320. package/src/scheduler/scheduler.ts +20 -14
  321. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  322. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  323. package/src/scripts-runtime/ctx.ts +1 -1
  324. package/src/scripts-runtime/egress-secrets.ts +2 -2
  325. package/src/scripts-runtime/executors/quickjs-bundle.ts +1 -0
  326. package/src/scripts-runtime/executors/quickjs-prelude.ts +162 -2
  327. package/src/scripts-runtime/executors/quickjs-runner.ts +4 -1
  328. package/src/scripts-runtime/stdlib/fetch.ts +113 -15
  329. package/src/scripts-runtime/stdlib/index.ts +3 -1
  330. package/src/scripts-runtime/stdlib/retry.ts +174 -0
  331. package/src/scripts-runtime/swarm-sdk.ts +187 -17
  332. package/src/scripts-runtime/types/stdlib.d.ts +97 -8
  333. package/src/scripts-runtime/types/swarm-extension.d.ts +27 -1
  334. package/src/scripts-runtime/types/swarm-sdk.d.ts +71 -6
  335. package/src/server.ts +4 -4
  336. package/src/slack/actions.ts +1 -0
  337. package/src/slack/app.ts +87 -46
  338. package/src/slack/assistant.ts +35 -7
  339. package/src/slack/enrich.ts +144 -50
  340. package/src/slack/handlers.ts +43 -99
  341. package/src/slack/http-receiver.ts +284 -0
  342. package/src/slack/inbound-dispatch.ts +43 -7
  343. package/src/slack/inbound-files.ts +33 -14
  344. package/src/slack/message-text.ts +47 -4
  345. package/src/slack/render-v2.ts +2 -1
  346. package/src/slack/socket-ack.ts +17 -10
  347. package/src/slack/steering.ts +5 -0
  348. package/src/slack/templates.ts +9 -0
  349. package/src/slack/thread-buffer-store.ts +58 -0
  350. package/src/slack/thread-buffer.ts +367 -109
  351. package/src/slack/thread-participants.ts +187 -0
  352. package/src/tasks/context-key.ts +24 -0
  353. package/src/tasks/sibling-awareness.ts +13 -1
  354. package/src/tests/agent-fs-live-url.test.ts +15 -0
  355. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  356. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  357. package/src/tests/agentfs-proxy.test.ts +8 -8
  358. package/src/tests/approval-card-resolution.test.ts +396 -0
  359. package/src/tests/approval-requests-notifications.test.ts +1 -1
  360. package/src/tests/approval-respond-auth.test.ts +28 -0
  361. package/src/tests/apps-action-parent-task.test.ts +140 -0
  362. package/src/tests/apps-catalog-additions.test.ts +315 -0
  363. package/src/tests/apps-catalog-files.test.ts +114 -0
  364. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  365. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  366. package/src/tests/apps-catalog-table.test.ts +47 -0
  367. package/src/tests/apps-chart-shell.test.ts +1 -1
  368. package/src/tests/apps-element-assembly.test.ts +52 -3
  369. package/src/tests/apps-session-thread.test.ts +182 -0
  370. package/src/tests/asset-key-invariants.test.ts +14 -0
  371. package/src/tests/base-prompt.test.ts +108 -23
  372. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  373. package/src/tests/caller-session-group.test.ts +199 -0
  374. package/src/tests/cards.test.ts +169 -0
  375. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  376. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  377. package/src/tests/chat-sdk-tools.test.ts +147 -0
  378. package/src/tests/checklist-nudge.test.ts +208 -0
  379. package/src/tests/checklist.test.ts +686 -0
  380. package/src/tests/claude-adapter-binary.test.ts +7 -1
  381. package/src/tests/claude-adapter.test.ts +10 -64
  382. package/src/tests/claude-flag-settings.test.ts +15 -11
  383. package/src/tests/claude-hook-credentials.test.ts +0 -1
  384. package/src/tests/claude-sdk-lifecycle.test.ts +5 -1
  385. package/src/tests/codex-adapter.test.ts +17 -78
  386. package/src/tests/codex-app-server.test.ts +16 -0
  387. package/src/tests/comb-config-guard.test.ts +21 -0
  388. package/src/tests/comb-default.test.ts +59 -97
  389. package/src/tests/comb-links.test.ts +86 -16
  390. package/src/tests/comb-status.test.ts +24 -27
  391. package/src/tests/create-page-tool.test.ts +101 -1
  392. package/src/tests/create-schedule-key.test.ts +105 -0
  393. package/src/tests/create-task-vcs-repo.test.ts +136 -0
  394. package/src/tests/credential-broker.test.ts +2 -2
  395. package/src/tests/db-query.test.ts +87 -1
  396. package/src/tests/db-task-read-contract.test.ts +3 -0
  397. package/src/tests/db-task-write-contract.test.ts +3 -1
  398. package/src/tests/docs-index-footprint.test.js +3 -3
  399. package/src/tests/dreaming-learnings.test.ts +104 -0
  400. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  401. package/src/tests/extensions-assets.test.ts +7 -3
  402. package/src/tests/extensions-catalog.test.ts +1 -0
  403. package/src/tests/extensions-example-sql-admin-only.test.ts +198 -0
  404. package/src/tests/extensions-pre-task.test.ts +7 -5
  405. package/src/tests/extensions-steering.test.ts +14 -2
  406. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  407. package/src/tests/fetch-resolved-env.test.ts +115 -1
  408. package/src/tests/fixtures/import-package.ts +32 -0
  409. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  410. package/src/tests/fs-routes.test.ts +505 -2
  411. package/src/tests/github-ghes-mock.test.ts +196 -0
  412. package/src/tests/github-host.test.ts +285 -0
  413. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  414. package/src/tests/heartbeat.test.ts +56 -0
  415. package/src/tests/import-config.test.ts +209 -0
  416. package/src/tests/import.test.ts +464 -0
  417. package/src/tests/invites-http.test.ts +144 -1
  418. package/src/tests/kv-http.test.ts +11 -0
  419. package/src/tests/literal-matcher.test.ts +58 -0
  420. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  421. package/src/tests/oauth-presets.test.ts +12 -0
  422. package/src/tests/opencode-adapter.test.ts +53 -6
  423. package/src/tests/pool-affinity.test.ts +50 -0
  424. package/src/tests/prompt-template-session.test.ts +69 -6
  425. package/src/tests/provider-registration.test.ts +2 -55
  426. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  427. package/src/tests/rbac-admission.test.ts +19 -0
  428. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  429. package/src/tests/rbac-engine.test.ts +2 -0
  430. package/src/tests/rbac-roles.test.ts +2 -0
  431. package/src/tests/runner-missing-dependency.test.ts +61 -0
  432. package/src/tests/runner-requester-profile.test.ts +139 -1
  433. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  434. package/src/tests/runtime-pool-routing.test.ts +52 -0
  435. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  436. package/src/tests/savings-compound.test.ts +774 -0
  437. package/src/tests/savings-compute.test.ts +7 -198
  438. package/src/tests/savings-fleet-latency.test.ts +143 -0
  439. package/src/tests/savings-fleet-read.test.ts +195 -0
  440. package/src/tests/savings-fleet-scale.test.ts +222 -0
  441. package/src/tests/savings-fleet-slices.test.ts +122 -0
  442. package/src/tests/savings-model.test.ts +212 -0
  443. package/src/tests/savings-read.test.ts +408 -0
  444. package/src/tests/savings-rollup.test.ts +766 -0
  445. package/src/tests/savings-scripts.test.ts +617 -0
  446. package/src/tests/script-connections.test.ts +4 -0
  447. package/src/tests/script-executor-conformance.test.ts +481 -0
  448. package/src/tests/scripts-http.test.ts +55 -0
  449. package/src/tests/scripts-runtime-fetch.test.ts +2 -2
  450. package/src/tests/secret-rules.test.ts +124 -1
  451. package/src/tests/secret-scrub-gate.test.ts +257 -0
  452. package/src/tests/secret-scrubber.test.ts +1 -1
  453. package/src/tests/seed-registry.test.ts +142 -9
  454. package/src/tests/session-source-keys.test.ts +42 -1
  455. package/src/tests/sessions-move.test.ts +70 -0
  456. package/src/tests/sessions-tree.test.ts +98 -0
  457. package/src/tests/sessions.test.ts +69 -0
  458. package/src/tests/slack-config.test.ts +4 -18
  459. package/src/tests/slack-dm-implicit-mention.test.ts +20 -1
  460. package/src/tests/slack-http-receiver.test.ts +472 -0
  461. package/src/tests/slack-identity-resolution.test.ts +23 -0
  462. package/src/tests/slack-inbound-files.test.ts +2 -1
  463. package/src/tests/slack-inbound-logging.test.ts +64 -0
  464. package/src/tests/slack-leave-thread.test.ts +1 -1
  465. package/src/tests/slack-message-text.test.ts +104 -0
  466. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  467. package/src/tests/slack-render-v2.test.ts +48 -0
  468. package/src/tests/slack-skip-reaction.test.ts +2 -2
  469. package/src/tests/slack-steering.test.ts +22 -10
  470. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  471. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  472. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  473. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  474. package/src/tests/slack-thread-buffer.test.ts +34 -34
  475. package/src/tests/slack-thread-participants.test.ts +447 -0
  476. package/src/tests/slack-tool-blocks.test.ts +167 -0
  477. package/src/tests/status.test.ts +32 -6
  478. package/src/tests/steering-core.test.ts +13 -0
  479. package/src/tests/steering-enabled.test.ts +7 -1
  480. package/src/tests/steering-promotion.test.ts +24 -0
  481. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  482. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  483. package/src/tests/task-artifacts.test.ts +50 -0
  484. package/src/tests/task-session-prompts.test.ts +95 -1
  485. package/src/tests/tool-annotations.test.ts +30 -0
  486. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  487. package/src/tools/chat-post.ts +19 -4
  488. package/src/tools/chat-reply.ts +20 -4
  489. package/src/tools/create-page.ts +21 -4
  490. package/src/tools/get-swarm.ts +18 -2
  491. package/src/tools/join-swarm.ts +2 -1
  492. package/src/tools/kv/kv-write-auth.ts +17 -1
  493. package/src/tools/schedules/create-schedule.ts +22 -4
  494. package/src/tools/slack-post.ts +40 -7
  495. package/src/tools/slack-reply.ts +50 -14
  496. package/src/types.ts +74 -2
  497. package/src/utils/constants.ts +60 -138
  498. package/src/utils/github-host.ts +217 -0
  499. package/src/utils/github-pull-request.ts +8 -5
  500. package/src/utils/literal-matcher.ts +118 -0
  501. package/src/utils/mcp-server-fetcher.test.ts +89 -0
  502. package/src/utils/mcp-server-fetcher.ts +13 -5
  503. package/src/utils/request-auth-context.ts +24 -0
  504. package/src/utils/secret-rules.generated.ts +1 -1
  505. package/src/utils/secret-scrubber.ts +485 -54
  506. package/src/utils/task-attachment-links.ts +9 -12
  507. package/src/vcs/index.ts +3 -0
  508. package/src/workflows/approval-notifications.ts +188 -12
  509. package/src/workflows/executors/swarm-script.ts +23 -19
  510. package/src/workflows/executors/system-one-extraction.ts +14 -7
  511. package/src/workflows/executors/system-one-providers.ts +22 -1
  512. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  513. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  514. package/templates/extensions/README.md +1 -0
  515. package/templates/extensions/sql-admin-only/README.md +19 -0
  516. package/templates/extensions/sql-admin-only/hooks.ts +96 -0
  517. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  518. package/templates/import/manifest.schema.json +136 -0
  519. package/templates/import/sources.schema.json +44 -0
  520. package/templates/skills/agent-browser/SKILL.md +1 -1
  521. package/templates/skills/agent-browser/content.md +1 -1
  522. package/templates/skills/apps/SKILL.md +122 -12
  523. package/templates/skills/apps/content.md +122 -12
  524. package/templates/skills/asset-namespaces/content.md +2 -1
  525. package/templates/skills/chat-sdk/content.md +17 -0
  526. package/templates/skills/db-query-guidance/content.md +2 -1
  527. package/templates/skills/scheduling/content.md +27 -0
  528. package/templates/skills/slack-interaction/content.md +12 -2
  529. package/templates/skills/swarm-docs/content.md +1 -0
  530. package/templates/skills/swarm-extensions/config.json +1 -1
  531. package/templates/skills/swarm-extensions/content.md +33 -23
  532. package/templates/skills/swarm-scripts/SKILL.md +18 -4
  533. package/templates/skills/swarm-scripts/content.md +18 -4
  534. package/templates/skills/work-on-task/SKILL.md +1 -1
  535. package/templates/skills/work-on-task/content.md +1 -1
  536. package/templates/skills/workflow-iterate/content.md +4 -7
  537. package/templates/workflows/dreaming/content.md +3 -3
  538. package/dist/acp-adapter-fqzkxyra.js +0 -15
  539. package/dist/claude-adapter-stw7jdcf.js +0 -25
  540. package/dist/cli-4bd1rck6.js +0 -4
  541. package/dist/cli-dns0y538.js +0 -194
  542. package/dist/cli-g5mtmf6t.js +0 -432
  543. package/dist/cli-xf3qw745.js +0 -104
  544. package/dist/fx-adapter-rpsgb1tw.js +0 -18
  545. package/dist/grok-adapter-n2m3zjg1.js +0 -18
  546. package/dist/handlers-nv8edn19.js +0 -32
  547. package/dist/index-ksmyd6kc.js +0 -37
  548. package/dist/index-rjnrje98.js +0 -32
  549. package/dist/index-tv3413wy.js +0 -33
  550. package/dist/lead-3hmddvrm.js +0 -70
  551. package/dist/worker-qgg0m2gw.js +0 -70
  552. package/src/providers/ctx-mode-env.ts +0 -10
  553. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  554. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  555. package/dist/{index-0rvk3vd4.js → index-bs7gw5fd.js} +3 -3
  556. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  557. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  558. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -697,4 +697,17 @@ describe("task steering core", () => {
697
697
  );
698
698
  }
699
699
  });
700
+
701
+ test("a task with no provider anywhere advertises the claude modes a steer actually takes", async () => {
702
+ const task = await createTaskExtended("no provider capability read", { source: "api" });
703
+ expect(task.agentId ?? null).toBeNull();
704
+ expect(task.provider ?? null).toBeNull();
705
+ // `requestSteering` delivers through the default claude harness, so the
706
+ // advertised modes must not claim "can't be steered" ([]).
707
+ expect((await getTaskSteeringFields(task)).supportedSteerModes).toEqual(
708
+ PROVIDER_STEER_CAPABILITIES.claude,
709
+ );
710
+ const batch = await getTaskSteeringFieldsForTasks([task]);
711
+ expect(batch.get(task.id)?.supportedSteerModes).toEqual(PROVIDER_STEER_CAPABILITIES.claude);
712
+ });
700
713
  });
@@ -342,7 +342,13 @@ describe("STEERING_ENABLED defaults and overrides", () => {
342
342
  message: "take the fallback path",
343
343
  }),
344
344
  ).toBeNull();
345
- bufferThreadMessage(channelId, threadTs, "create the normal follow-up", "U1", "1.0002");
345
+ await bufferThreadMessage(
346
+ channelId,
347
+ threadTs,
348
+ "create the normal follow-up",
349
+ "U1",
350
+ "1.0002",
351
+ );
346
352
  await instantFlush(`${channelId}:${threadTs}`);
347
353
  });
348
354
 
@@ -145,6 +145,30 @@ describe("steering promotion on terminal tasks", () => {
145
145
  expect(trigger?.task.modelUnsupported).toBeUndefined();
146
146
  });
147
147
 
148
+ test.each([
149
+ ["app-page", "ui"],
150
+ ["script", "api"],
151
+ ["slack", "slack"],
152
+ ] as const)("a promoted %s steer creates a task with source %s", async (source, expected) => {
153
+ const task = await createTaskExtended("source mapping parent", { agentId });
154
+ expect((await startTask(task.id))?.status).toBe("in_progress");
155
+ await createSteeringMessage({
156
+ taskId: task.id,
157
+ body: "carry the source",
158
+ mode: "queue",
159
+ source,
160
+ createdByKind: "user",
161
+ });
162
+
163
+ expect((await completeTask(task.id, "done"))?.status).toBe("completed");
164
+ const [promoted] = await getSteeringMessagesForTask(task.id);
165
+ expect(promoted).toMatchObject({ status: "promoted", source });
166
+ expect(await getTaskById(promoted!.promotedTaskId!)).toMatchObject({
167
+ parentTaskId: task.id,
168
+ source: expected,
169
+ });
170
+ });
171
+
148
172
  test("promotion bypasses disabled follow-up configuration", async () => {
149
173
  const { task } = await taskWithPendingSteer("must still be followed", {
150
174
  followUpConfig: { disabled: true },
@@ -196,6 +196,12 @@ describe("swarm-config reserved keys guard", () => {
196
196
  expect(isReservedConfigKey("Secrets_Encryption_Key")).toBe(true);
197
197
  });
198
198
 
199
+ test("recognizes the GitHub host keys (they redirect GitHub tokens)", () => {
200
+ expect(isReservedConfigKey("GITHUB_URL")).toBe(true);
201
+ expect(isReservedConfigKey("GITHUB_API_URL")).toBe(true);
202
+ expect(isReservedConfigKey("GITHUB_TOKEN")).toBe(false);
203
+ });
204
+
199
205
  test("does not match unrelated keys", () => {
200
206
  expect(isReservedConfigKey("OPENAI_API_KEY")).toBe(false);
201
207
  expect(isReservedConfigKey("API_KEYS")).toBe(false);
@@ -473,6 +479,17 @@ describe("swarm-config reserved keys guard", () => {
473
479
  expect(body.error).toBe(EXPECTED_MESSAGE("API_KEY"));
474
480
  });
475
481
 
482
+ test("returns 400 for reserved key GITHUB_URL", async () => {
483
+ const res = await fetch(`${baseUrl}/api/config`, {
484
+ method: "PUT",
485
+ headers: { "Content-Type": "application/json" },
486
+ body: JSON.stringify({ scope: "global", key: "GITHUB_URL", value: "https://evil.test" }),
487
+ });
488
+ expect(res.status).toBe(400);
489
+ const body = (await res.json()) as { error: string };
490
+ expect(body.error).toBe(EXPECTED_MESSAGE("GITHUB_URL"));
491
+ });
492
+
476
493
  test("returns 400 for case variant 'Api_Key'", async () => {
477
494
  const res = await fetch(`${baseUrl}/api/config`, {
478
495
  method: "PUT",
@@ -0,0 +1,67 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import {
3
+ SYSTEM_ONE_DECIDE_DEFAULT_KEY,
4
+ SYSTEM_ONE_EXTRACT_DEFAULT_KEY,
5
+ SYSTEM_ONE_FALLBACK,
6
+ SYSTEM_ONE_HOST_VIEWS,
7
+ } from "../../apps/ui/src/lib/system-one-hosts";
8
+ import {
9
+ SYSTEM_ONE_DEFAULT_PROVIDER,
10
+ SYSTEM_ONE_DEFAULT_PROVIDER_CONFIG_KEY,
11
+ SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER,
12
+ SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_CONFIG_KEY,
13
+ SYSTEM_ONE_HOSTS,
14
+ type SystemOneHost,
15
+ } from "../workflows/executors/system-one-providers";
16
+
17
+ type Service = SystemOneHost["decide"] | SystemOneHost["extract"];
18
+
19
+ /** What the dashboard mirrors of one service. */
20
+ function serviceShape(service: Service) {
21
+ if (!service) return undefined;
22
+ return {
23
+ defaultModel: service.defaultModel,
24
+ allowedModels: service.allowedModels ? [...service.allowedModels] : undefined,
25
+ };
26
+ }
27
+
28
+ function configKeyOf(host: SystemOneHost): string | undefined {
29
+ const endpoint = (host.decide ?? host.extract)?.endpoint;
30
+ return endpoint && typeof endpoint !== "string" ? endpoint.configKey : undefined;
31
+ }
32
+
33
+ // The dashboard never imports `src/`: `apps/ui/src/lib/system-one-hosts.ts`
34
+ // mirrors `SYSTEM_ONE_HOSTS` for Connect › AI providers › System One.
35
+ describe("System One hosts: the dashboard mirror", () => {
36
+ test("lists the same hosts with the same keys, capabilities and models", () => {
37
+ const server = Object.entries(SYSTEM_ONE_HOSTS as Record<string, SystemOneHost>).map(
38
+ ([id, host]) => ({
39
+ id,
40
+ keyName: host.keyName,
41
+ fallbackKeyNames: host.fallbackKeyNames ? [...host.fallbackKeyNames] : undefined,
42
+ configKey: configKeyOf(host),
43
+ decide: serviceShape(host.decide),
44
+ extract: serviceShape(host.extract),
45
+ }),
46
+ );
47
+ const ui = SYSTEM_ONE_HOST_VIEWS.map((host) => ({
48
+ id: host.id,
49
+ keyName: host.keyName,
50
+ fallbackKeyNames: host.fallbackKeyNames ? [...host.fallbackKeyNames] : undefined,
51
+ configKey: host.configKey,
52
+ decide: serviceShape(host.decide as Service),
53
+ extract: serviceShape(host.extract as Service),
54
+ }));
55
+ const byId = (a: { id: string }, b: { id: string }) => a.id.localeCompare(b.id);
56
+ expect(ui.sort(byId)).toEqual(server.sort(byId));
57
+ });
58
+
59
+ test("names the same default keys and fallbacks", () => {
60
+ expect(SYSTEM_ONE_DECIDE_DEFAULT_KEY).toBe(SYSTEM_ONE_DEFAULT_PROVIDER_CONFIG_KEY);
61
+ expect(SYSTEM_ONE_EXTRACT_DEFAULT_KEY).toBe(SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_CONFIG_KEY);
62
+ expect(SYSTEM_ONE_FALLBACK).toEqual({
63
+ decide: SYSTEM_ONE_DEFAULT_PROVIDER,
64
+ extract: SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER,
65
+ });
66
+ });
67
+ });
@@ -391,3 +391,53 @@ describe("attachment-first task shipping evidence", () => {
391
391
  }
392
392
  });
393
393
  });
394
+
395
+ describe("GitHub Enterprise host (GITHUB_URL)", () => {
396
+ const saved = process.env.GITHUB_URL;
397
+ afterAll(() => {
398
+ if (saved === undefined) delete process.env.GITHUB_URL;
399
+ else process.env.GITHUB_URL = saved;
400
+ });
401
+
402
+ async function hasPullRequest(output: string): Promise<number | undefined> {
403
+ const task = await createTaskExtended(`ghes: ${output}`, { agentId, source: "api" });
404
+ await getDbClient().run("UPDATE agent_tasks SET output = ? WHERE id = ?", [output, task.id]);
405
+ const sql = taskShippingEvidenceSql("t");
406
+ const row = await getDbClient().get<{ hasPullRequest: number }>(
407
+ `SELECT ${sql.hasPullRequest} AS hasPullRequest FROM agent_tasks t WHERE t.id = ?`,
408
+ [task.id],
409
+ );
410
+ return row?.hasPullRequest;
411
+ }
412
+
413
+ test("GHES mode: SQL and TS both match the GHES host, not github.com", async () => {
414
+ process.env.GITHUB_URL = "https://ghe.test";
415
+ expect(await hasPullRequest("Opened https://ghe.test/o/r/pull/7.")).toBe(1);
416
+ expect(extractGitHubPullRequestUrls("Opened https://ghe.test/o/r/pull/7.")).toEqual([
417
+ { url: "https://ghe.test/o/r/pull/7", owner: "o", repo: "r", number: 7 },
418
+ ]);
419
+ // Negative control: one deployment talks to one host.
420
+ expect(await hasPullRequest("Opened https://github.com/o/r/pull/7")).toBe(0);
421
+ expect(extractGitHubPullRequestUrls("https://github.com/o/r/pull/7")).toEqual([]);
422
+ });
423
+
424
+ test("invalid GITHUB_URL: completeTask still completes and records github.com PRs", async () => {
425
+ process.env.GITHUB_URL = "https://ghe.test/path";
426
+ const task = await inProgressTask("invalid GITHUB_URL completion");
427
+ const done = await completeTask(
428
+ task.id,
429
+ "Done: https://github.com/o/r/pull/9 (not https://ghe.test/o/r/pull/9)",
430
+ );
431
+ expect(done?.status).toBe("completed");
432
+ expect((await getTaskAttachments(task.id)).map((attachment) => attachment.url)).toEqual([
433
+ "https://github.com/o/r/pull/9",
434
+ ]);
435
+ expect(await hasPullRequest("Opened https://github.com/o/r/pull/9")).toBe(1);
436
+ });
437
+
438
+ test("default mode: a GHES-looking URL is not a PR", async () => {
439
+ delete process.env.GITHUB_URL;
440
+ expect(await hasPullRequest("Opened https://ghe.test/o/r/pull/7")).toBe(0);
441
+ expect(extractGitHubPullRequestUrls("https://ghe.test/o/r/pull/7")).toEqual([]);
442
+ });
443
+ });
@@ -1,7 +1,9 @@
1
1
  import { describe, expect, test } from "bun:test";
2
2
  import {
3
+ buildChecklistNudgePrompt,
3
4
  buildRequesterProfilePrompt,
4
5
  buildTaskSessionPrompts,
6
+ buildUseCasePrompt,
5
7
  type TaskSessionContext,
6
8
  } from "../commands/runner";
7
9
  import { type BasePromptArgs, getTaskContextPrompt } from "../prompts/base-prompt";
@@ -48,6 +50,12 @@ const sessionA: TaskSessionContext = {
48
50
  notes: "Lead with the answer.",
49
51
  comms: { verbosity: "terse" },
50
52
  },
53
+ checklistNudge: {
54
+ itemId: "swarm:channel",
55
+ kind: "channel",
56
+ label: "Connect a chat channel",
57
+ href: "https://swarm.example.com/integrations/channels",
58
+ },
51
59
  cwdWarning: 'Note: The task requested working directory "/nope" but it does not exist.',
52
60
  };
53
61
 
@@ -78,7 +86,16 @@ describe("buildTaskSessionPrompts", () => {
78
86
  expect(a.systemPrompt).toBe(b.systemPrompt);
79
87
  expect(a.systemPrompt).toBe(c.systemPrompt);
80
88
  expect(a.systemPrompt).toEndWith("\n\nOperator note: be careful.");
81
- for (const perTask of ["## Repository", "## Requester Profile", "Taras", "Eze", "/nope"]) {
89
+ for (const perTask of [
90
+ "## Repository",
91
+ "## Requester Profile",
92
+ "## Setup suggestion",
93
+ "has not finished setting up",
94
+ "Connect a chat channel",
95
+ "Taras",
96
+ "Eze",
97
+ "/nope",
98
+ ]) {
82
99
  expect(a.systemPrompt).not.toContain(perTask);
83
100
  }
84
101
  });
@@ -113,6 +130,7 @@ describe("buildTaskSessionPrompts", () => {
113
130
 
114
131
  const repoBlock = await getTaskContextPrompt({ ...args, repoContext: sessionA.repoContext });
115
132
  const profile = await buildRequesterProfilePrompt(sessionA.requestedBy);
133
+ const nudge = await buildChecklistNudgePrompt(sessionA.checklistNudge);
116
134
  expect(repoBlock).toContain("## Repository");
117
135
  expect(repoBlock).toContain("Alpha repo rules.");
118
136
  expect(profile).toContain("This task was requested by Taras (CTO).");
@@ -122,6 +140,7 @@ describe("buildTaskSessionPrompts", () => {
122
140
  expect(prompt).toContain(profile);
123
141
  expect(prompt).toEndWith(sessionA.cwdWarning ?? "");
124
142
  expect(prompt.indexOf(repoBlock)).toBeLessThan(prompt.indexOf(profile));
143
+ expect(prompt.indexOf(profile)).toBeLessThan(prompt.indexOf(nudge));
125
144
  expect(prompt).not.toMatch(/\n{3,}/);
126
145
  });
127
146
 
@@ -129,4 +148,79 @@ describe("buildTaskSessionPrompts", () => {
129
148
  const { prompt } = await build(agentArgs("claude"), sessionC, "/work-on-task ccc");
130
149
  expect(prompt).toBe("/work-on-task ccc");
131
150
  });
151
+
152
+ test("a lead task with a checklist nudge carries it once, in the task prompt only", async () => {
153
+ const lead = agentArgs("claude", { role: "lead" });
154
+ const withNudge = await build(lead, sessionA, "/work-on-task aaa");
155
+ const withoutNudge = await build(
156
+ lead,
157
+ { ...sessionA, checklistNudge: undefined },
158
+ "/work-on-task aaa",
159
+ );
160
+ const nudge = await buildChecklistNudgePrompt(sessionA.checklistNudge);
161
+
162
+ expect(nudge).toContain("## Setup suggestion");
163
+ expect(nudge).toContain("Open item: Connect a chat channel.");
164
+ expect(nudge).toContain(
165
+ "at the end of your reply, with the link https://swarm.example.com/integrations/channels.",
166
+ );
167
+ expect(withNudge.systemPrompt).toBe(withoutNudge.systemPrompt);
168
+ expect(withNudge.systemPrompt).not.toContain("has not finished setting up");
169
+ expect(withNudge.prompt.split("has not finished setting up").length - 1).toBe(1);
170
+ expect(withoutNudge.prompt).not.toContain("has not finished setting up");
171
+ // The static pointer for missing tools lives in the lead contract instead.
172
+ expect(withNudge.systemPrompt).toContain("/integrations/tools");
173
+ });
174
+
175
+ test("a nudge with no link reads as a plain offer", async () => {
176
+ const nudge = await buildChecklistNudgePrompt({
177
+ itemId: "swarm:channel",
178
+ kind: "channel",
179
+ label: "Connect a chat channel",
180
+ });
181
+ expect(nudge).toContain("offer it once, at the end of your reply. If it does not fit");
182
+ expect(nudge).not.toContain("with the link");
183
+ expect(nudge).not.toContain("{{");
184
+ });
185
+
186
+ test("no nudge renders nothing", async () => {
187
+ expect(await buildChecklistNudgePrompt(undefined)).toBe("");
188
+ });
189
+
190
+ test("a lead task in a use-case group carries the key once, in the task prompt only", async () => {
191
+ const lead = agentArgs("claude", { role: "lead" });
192
+ const inGroup = await build(
193
+ lead,
194
+ { ...sessionA, taskKey: "shared/competitor-watch/" },
195
+ "/work-on-task aaa",
196
+ );
197
+ const inInbox = await build(
198
+ lead,
199
+ { ...sessionA, taskKey: "shared/task:aaa/" },
200
+ "/work-on-task aaa",
201
+ );
202
+
203
+ expect(inGroup.systemPrompt).toBe(inInbox.systemPrompt);
204
+ expect(inGroup.systemPrompt).not.toContain("shared/competitor-watch/");
205
+ expect(inGroup.systemPrompt).not.toContain("## Use case\n");
206
+ expect(inGroup.prompt.split("## Use case\n").length - 1).toBe(1);
207
+ expect(inGroup.prompt).toContain(
208
+ "This task is in the use case with key `shared/competitor-watch/`.",
209
+ );
210
+ expect(inInbox.prompt).not.toContain("## Use case\n");
211
+ // The use-case paragraph and its link base stay in the system prompt, once.
212
+ expect(inGroup.systemPrompt.split("A use case is work that repeats").length - 1).toBe(1);
213
+ expect(inGroup.prompt).not.toContain("A use case is work that repeats");
214
+ });
215
+
216
+ test("the use-case note needs a lead and a user group key", async () => {
217
+ expect(await buildUseCasePrompt("lead", "shared/acme/")).toContain("`shared/acme/`");
218
+ expect(await buildUseCasePrompt("lead", "personal/u1/acme/")).toContain("`personal/u1/acme/`");
219
+ expect(await buildUseCasePrompt("worker", "shared/acme/")).toBe("");
220
+ expect(await buildUseCasePrompt("lead", undefined)).toBe("");
221
+ expect(await buildUseCasePrompt("lead", "shared/")).toBe("");
222
+ expect(await buildUseCasePrompt("lead", "shared/task:abc/")).toBe("");
223
+ expect(await buildUseCasePrompt("lead", "shared/schedule:abc/")).toBe("");
224
+ expect(await buildUseCasePrompt("lead", "shared/slack/C123/thread:1.2/")).toBe("");
225
+ });
132
226
  });
@@ -1,6 +1,8 @@
1
1
  import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
2
  import { unlink } from "node:fs/promises";
3
3
  import { closeDb, initDb } from "../be/db";
4
+ import { SDK_TOOL_NAME_MAP } from "../scripts-runtime/sdk-allowlist";
5
+ import { isReadOnlyBridgeCall } from "../scripts-runtime/swarm-sdk";
4
6
  import { createServer } from "../server";
5
7
  import { ALL_TOOLS, CORE_TOOLS, DEFERRED_TOOLS } from "../tools/tool-config";
6
8
 
@@ -409,4 +411,32 @@ describe("Tool Annotations & Classification", () => {
409
411
  expect(idempotent).toBeGreaterThanOrEqual(5); // update/register tools
410
412
  expect(openWorld).toBeGreaterThanOrEqual(3); // Slack tools
411
413
  });
414
+
415
+ // === ctx.swarm bridge retry classification ===
416
+ // The bridge retries a 5xx or network error only for reads. Its read list is
417
+ // hand-kept, so cross-check it against the tool annotations both ways. The
418
+ // generic bridge sends every call as POST, the strictest case.
419
+ // poll-task is annotated read-only but claims work, so it must not repeat.
420
+ const READ_ANNOTATED_BUT_WRITES = new Set(["task_poll"]);
421
+
422
+ test("every read-only SDK method retries as a read on the ctx.swarm bridge", () => {
423
+ const missing = Object.entries(SDK_TOOL_NAME_MAP)
424
+ .filter(([, tool]) => tools[tool]?.annotations?.readOnlyHint === true)
425
+ .filter(([method]) => !READ_ANNOTATED_BUT_WRITES.has(method))
426
+ .filter(([method]) => !isReadOnlyBridgeCall(method, "POST"))
427
+ .map(([method]) => method);
428
+ expect(missing).toEqual([]);
429
+ for (const method of READ_ANNOTATED_BUT_WRITES) {
430
+ expect(isReadOnlyBridgeCall(method, "POST")).toBe(false);
431
+ expect(isReadOnlyBridgeCall(method, "GET")).toBe(false);
432
+ }
433
+ });
434
+
435
+ test("no SDK method the bridge repeats as a read is annotated as a write", () => {
436
+ const writes = Object.entries(SDK_TOOL_NAME_MAP)
437
+ .filter(([method]) => isReadOnlyBridgeCall(method, "POST"))
438
+ .filter(([, tool]) => tools[tool]?.annotations?.destructiveHint === true)
439
+ .map(([method]) => method);
440
+ expect(writes).toEqual([]);
441
+ });
412
442
  });
@@ -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
  });