@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
@@ -96,6 +96,7 @@ import type { KapsoWebhookPayload } from "../integrations/kapso/inbound";
96
96
  import { resolveKapsoRequestedByUserId, routeKapsoInbound } from "../integrations/kapso/inbound";
97
97
  import { TaskCreationBlockedError } from "../tasks/errors";
98
98
  import { getPublicMcpBaseUrl } from "../utils/constants";
99
+ import { resolveGitHubHost } from "../utils/github-host";
99
100
  import { scrubSecrets } from "../utils/secret-scrubber";
100
101
  import { canonicalAzureDevOpsRepoUrl } from "../vcs/azure-devops";
101
102
  import { getExecutorRegistry } from "../workflows";
@@ -460,6 +461,20 @@ export async function handleWebhooks(
460
461
  return true;
461
462
  }
462
463
 
464
+ // GHES names its host on every delivery. A mismatch is a misconfiguration, not an
465
+ // attack (the HMAC check above is the trust boundary), so warn and carry on.
466
+ const enterpriseHost = req.headers["x-github-enterprise-host"] as string | undefined;
467
+ const configuredHost = resolveGitHubHost();
468
+ if (
469
+ enterpriseHost &&
470
+ configuredHost.ok &&
471
+ enterpriseHost.toLowerCase() !== configuredHost.config.host
472
+ ) {
473
+ console.warn(
474
+ `[GitHub] Webhook from GHES host ${enterpriseHost}, but GITHUB_URL resolves to ${configuredHost.config.host}`,
475
+ );
476
+ }
477
+
463
478
  if (eventType === "ping") {
464
479
  console.log("[GitHub] Received ping event - webhook configured successfully");
465
480
  githubWebhook.respond(res, 200, { message: "pong" });
@@ -0,0 +1,151 @@
1
+ import { CardSpecError, standardComponentDefinitions, toCard } from "@json-render/chat";
2
+ import type { CardChild, CardElement } from "chat";
3
+ import * as z from "zod";
4
+
5
+ // No callback buttons yet: nothing handles a click, so `Button` stays out and
6
+ // `Actions` holds `LinkButton`s only.
7
+ const { Button: _button, ...standard } = standardComponentDefinitions;
8
+
9
+ /** The components an agent-authored card may use. */
10
+ export const chatCardComponents = {
11
+ ...standard,
12
+ Actions: { ...standard.Actions, description: "Row of LinkButton elements." },
13
+ };
14
+
15
+ /**
16
+ * Slack's caps. Past them the adapter turns a table or chart into a code block
17
+ * cut at 3,000 characters, which drops content while the post succeeds, so
18
+ * reject instead. `tableRows` counts the header row.
19
+ */
20
+ export const CARD_LIMITS = {
21
+ tables: 1,
22
+ charts: 2,
23
+ fields: 10,
24
+ tableRows: 101,
25
+ tableColumns: 20,
26
+ chartTitle: 50,
27
+ chartLabel: 20,
28
+ chartSeries: 12,
29
+ chartPoints: 20,
30
+ } as const;
31
+
32
+ /** Slack's data_table cap on the characters of all cells, header included. */
33
+ export const TABLE_MAX_CELL_CHARS = 10_000;
34
+
35
+ // One line per component: its description and an example of its props, which
36
+ // is the only place the agent sees prop names (Chart and Table need them).
37
+ const catalogLines = Object.entries(chatCardComponents)
38
+ .map(([name, def]) => `${name}: ${def.description} Props e.g. ${JSON.stringify(def.example)}.`)
39
+ .join(" ");
40
+
41
+ const CARD_RULES =
42
+ 'Every element has "children" (leaves use []). Field goes inside Fields, LinkButton inside Actions. A bar, line or area Chart has one value per category per series; a pie Chart uses {"type":"pie","segments":[{"label","value"}]}.';
43
+
44
+ /** Tool input for a json-render chat card spec. `toCard` does the real validation. */
45
+ export const cardSpecInputSchema = z
46
+ .looseObject({
47
+ root: z.string().min(1).describe("Id of the root element. It must be a Card."),
48
+ elements: z
49
+ .record(z.string(), z.unknown())
50
+ .describe(
51
+ 'Map of element id to { type, props, children: [ids] }. Example: {"root":"c","elements":{"c":{"type":"Card","props":{"title":"Deploy"},"children":["f"]},"f":{"type":"Fields","props":{},"children":["f1"]},"f1":{"type":"Field","props":{"label":"Status","value":"green"},"children":[]}}}',
52
+ ),
53
+ })
54
+ .describe(
55
+ `Optional json-render card spec, rendered as a native card. Use it for structured results: key figures, a table, up to ${CARD_LIMITS.charts} charts, links. At most ${CARD_LIMITS.tables} table, of up to ${CARD_LIMITS.tableRows - 1} rows, ${CARD_LIMITS.tableColumns} columns and ${TABLE_MAX_CELL_CHARS} characters in all. ${CARD_RULES} Components: ${catalogLines}`,
56
+ );
57
+
58
+ export type CardSpecInput = z.infer<typeof cardSpecInputSchema>;
59
+
60
+ /**
61
+ * Validate an agent's spec and build the Chat SDK card. Returns the
62
+ * `CardSpecError` issues instead of throwing so a tool can hand them back.
63
+ */
64
+ export function renderCard(spec: CardSpecInput): { card: CardElement } | { issues: string[] } {
65
+ let card: CardElement;
66
+ try {
67
+ // biome-ignore lint/suspicious/noExplicitAny: toCard validates the shape and reports issues
68
+ card = toCard(spec as any, { components: chatCardComponents, limits: CARD_LIMITS });
69
+ } catch (error) {
70
+ if (error instanceof CardSpecError) return { issues: error.issues };
71
+ throw error;
72
+ }
73
+ // toCard has no character limit, so check the expanded tables here.
74
+ const issues = cardChildren(card)
75
+ .filter((child) => child.type === "table")
76
+ .flatMap((table) => {
77
+ const chars = [table.headers, ...table.rows]
78
+ .flat()
79
+ .reduce((sum, cell) => sum + cell.length, 0);
80
+ return chars > TABLE_MAX_CELL_CHARS
81
+ ? [`Table: ${chars} characters in its cells, at most ${TABLE_MAX_CELL_CHARS}`]
82
+ : [];
83
+ });
84
+ return issues.length ? { issues } : { card };
85
+ }
86
+
87
+ /** Every child of the card, sections flattened. */
88
+ function cardChildren(card: { children: CardChild[] }): CardChild[] {
89
+ return card.children.flatMap((child) =>
90
+ child.type === "section" ? [child, ...cardChildren(child)] : [child],
91
+ );
92
+ }
93
+
94
+ /** Tool error text for a rejected spec: one issue per line, for the agent to fix. */
95
+ export function cardIssuesMessage(issues: string[]): string {
96
+ return `Invalid card spec. Fix it and retry:\n${issues.map((issue) => `- ${issue}`).join("\n")}`;
97
+ }
98
+
99
+ const NATIVE_SLACK_BLOCKS: Record<string, string[]> = {
100
+ table: ["table", "data_table"],
101
+ chart: ["data_visualization"],
102
+ };
103
+
104
+ /**
105
+ * Block Kit and the card's notification text for native Slack. Returns issues when a table or chart would not render natively: the
106
+ * adapter's code-block fallback is cut at 3,000 characters, so a post could
107
+ * succeed with rows missing. `CARD_LIMITS` stops the known cases first; this
108
+ * catches the rest (a duplicate chart label, a long axis label).
109
+ */
110
+ export async function cardToSlack(
111
+ card: CardElement,
112
+ ): Promise<{ blocks: Record<string, unknown>[]; text: string } | { issues: string[] }> {
113
+ // Lazy like the Chat SDK adapters: the adapter module is only loaded when a card is posted.
114
+ const { cardToBlockKit, cardToFallbackText } = await import("@chat-adapter/slack");
115
+ const issues = cardChildren(card).flatMap((child) => {
116
+ const native = NATIVE_SLACK_BLOCKS[child.type];
117
+ if (!native) return [];
118
+ const [block] = cardToBlockKit({ type: "card", children: [child] });
119
+ return block && native.includes(String(block.type))
120
+ ? []
121
+ : [`${child.type === "table" ? "Table" : "Chart"}: Slack cannot render it natively`];
122
+ });
123
+ if (issues.length) return { issues };
124
+ return {
125
+ blocks: cardToBlockKit(card),
126
+ text: cardToFallbackText(card),
127
+ };
128
+ }
129
+
130
+ /**
131
+ * `renderCard` plus the native check for the adapter the card goes to. The Chat
132
+ * SDK tools call this before they send anything: on Slack the adapter turns a
133
+ * table or chart it cannot draw into a fallback cut at 3,000 characters.
134
+ */
135
+ export async function renderCardFor(
136
+ adapter: string,
137
+ spec: CardSpecInput,
138
+ ): Promise<{ card: CardElement } | { issues: string[] }> {
139
+ const rendered = renderCard(spec);
140
+ if ("issues" in rendered || adapter !== "slack") return rendered;
141
+ const slack = await cardToSlack(rendered.card);
142
+ return "issues" in slack ? slack : rendered;
143
+ }
144
+
145
+ /**
146
+ * Notification text for a message posted with a card: both, message first, so
147
+ * notifications and screen readers do not lose the message.
148
+ */
149
+ export function slackFallbackText(message: string, cardText?: string): string {
150
+ return [message, cardText].filter(Boolean).join("\n\n");
151
+ }
@@ -1,4 +1,4 @@
1
- import type { Attachment, FileUpload } from "chat";
1
+ import type { Attachment, CardElement, FileUpload } from "chat";
2
2
  import { scrubSecrets } from "@/utils/secret-scrubber";
3
3
  import { workflowEventBus } from "@/workflows/event-bus";
4
4
  import { formatFileSize } from "./attachments";
@@ -78,12 +78,12 @@ export class ChatFileTooLargeError extends Error {
78
78
 
79
79
  type SentChunk = { id: string; threadId?: string };
80
80
 
81
+ type OutboundMessage =
82
+ | { markdown: string; files?: FileUpload[]; attachments?: Attachment[] }
83
+ | CardElement;
84
+
81
85
  interface PostTarget {
82
- post(message: {
83
- markdown: string;
84
- files?: FileUpload[];
85
- attachments?: Attachment[];
86
- }): Promise<SentChunk>;
86
+ post(message: OutboundMessage): Promise<SentChunk>;
87
87
  }
88
88
 
89
89
  /** A fence opener or closer: up to 3 spaces, then 3+ backticks or tildes. */
@@ -122,18 +122,27 @@ export function escapeTelegramHashLines(markdown: string): string {
122
122
  .join("\n");
123
123
  }
124
124
 
125
- /** `replyFirst` sends the first chunk as a native reply; later chunks are plain posts. */
125
+ /**
126
+ * `replyFirst` sends the first message as a native reply; later ones are plain
127
+ * posts. A `card` goes out after the text chunks, as one more message.
128
+ */
126
129
  async function postChunks(
127
130
  adapter: string,
128
131
  target: PostTarget,
129
132
  parts: readonly string[],
130
- replyFirst?: (message: { markdown: string }) => Promise<SentChunk>,
133
+ replyFirst?: (message: OutboundMessage) => Promise<SentChunk>,
134
+ card?: CardElement,
131
135
  ): Promise<{ messageIds: string[]; threadId?: string }> {
132
136
  const messageIds: string[] = [];
133
137
  let threadId: string | undefined;
134
138
  const limit = chatMessageLimit(adapter);
135
- for (const chunk of parts.flatMap((part) => splitChatMessage(part, limit))) {
136
- const message = { markdown: adapter === "telegram" ? escapeTelegramHashLines(chunk) : chunk };
139
+ const messages: OutboundMessage[] = parts
140
+ .flatMap((part) => splitChatMessage(part, limit))
141
+ .map((chunk) => ({
142
+ markdown: adapter === "telegram" ? escapeTelegramHashLines(chunk) : chunk,
143
+ }));
144
+ if (card) messages.push(card);
145
+ for (const message of messages) {
137
146
  const sent =
138
147
  replyFirst && messageIds.length === 0
139
148
  ? await replyFirst(message)
@@ -318,6 +327,15 @@ export function formatUnsentFilesNote(unsent: UnsentChatFile[]): string {
318
327
  return [`Could not send ${count}:`, ...lines].join("\n");
319
328
  }
320
329
 
330
+ /** A copy of the card with every string scrubbed, so a card cannot leak what text cannot. */
331
+ function scrubCard(card: CardElement): CardElement {
332
+ return JSON.parse(
333
+ JSON.stringify(card, (_key, value) =>
334
+ typeof value === "string" ? scrubSecrets(value) : value,
335
+ ),
336
+ );
337
+ }
338
+
321
339
  /**
322
340
  * Post markdown to a Chat SDK thread or channel. Scrubs the text, splits it by
323
341
  * the adapter limit, and emits one `chat.message.sent` for the whole message
@@ -335,7 +353,10 @@ export function formatUnsentFilesNote(unsent: UnsentChatFile[]): string {
335
353
  * An array `text` is posted as one message per element, each still split at
336
354
  * the limit; the caller uses it when its own markup must not be cut in two.
337
355
  *
338
- * `replyToMessageId` anchors the first chunk to that message on a thread
356
+ * `card` (a validated Chat SDK card) is posted after the text as its own
357
+ * message; `text` may then be empty. Its strings are scrubbed like the text.
358
+ *
359
+ * `replyToMessageId` anchors the first message to that message on a thread
339
360
  * target. Telegram sends it with `allow_sending_without_reply`, so a deleted
340
361
  * target still gets the message, unthreaded.
341
362
  */
@@ -344,6 +365,7 @@ export async function postChatMessage(args: {
344
365
  threadId?: string;
345
366
  channelId?: string;
346
367
  text: string | readonly string[];
368
+ card?: CardElement;
347
369
  taskId?: string;
348
370
  files?: OutboundChatFile[];
349
371
  replyToMessageId?: string;
@@ -354,7 +376,10 @@ export async function postChatMessage(args: {
354
376
  const chat = getChatInstance(args.adapter);
355
377
  if (!chat) throw new ChatAdapterUnavailableError(args.adapter);
356
378
  const parts = (typeof args.text === "string" ? [args.text] : args.text).map(scrubSecrets);
357
- const text = parts.join("\n\n");
379
+ const card = args.card && scrubCard(args.card);
380
+ // shortcut: a card-only message reports its title as the event text; add a
381
+ // plain-text rendering of the card if an event consumer needs the body.
382
+ const text = parts.join("\n\n") || (card?.title ?? "");
358
383
 
359
384
  let result: ChatPostResult;
360
385
  let target: PostTarget;
@@ -369,6 +394,7 @@ export async function postChatMessage(args: {
369
394
  thread,
370
395
  parts,
371
396
  replyTo && thread.adapter.reply ? (message) => thread.reply(replyTo, message) : undefined,
397
+ card,
372
398
  );
373
399
  result = {
374
400
  adapter: args.adapter,
@@ -380,7 +406,7 @@ export async function postChatMessage(args: {
380
406
  } else if (args.channelId) {
381
407
  const channel = chat.channel(args.channelId);
382
408
  target = channel;
383
- const sent = await postChunks(args.adapter, channel, parts);
409
+ const sent = await postChunks(args.adapter, channel, parts, undefined, card);
384
410
  result = {
385
411
  adapter: args.adapter,
386
412
  threadId: sent.threadId ?? channel.id,
@@ -25,6 +25,7 @@ import { registerChatHandlers } from "./handlers";
25
25
  import { createScrubbingLogger, errorMessage } from "./logger";
26
26
  import { startChatRelayWatcher, stopChatRelayWatcher } from "./relay";
27
27
  import { SqliteChatState } from "./state";
28
+ import { TelegramBotApiError } from "./telegram-api";
28
29
  import { getChatSdkTestHooks } from "./test-hooks";
29
30
  import { flushAllChatBuffers } from "./thread-buffer";
30
31
  import { stopAllTypingKeepalives } from "./typing";
@@ -132,10 +133,15 @@ async function startAdapter(
132
133
  }
133
134
  watchSocketConnection(adapter, logger);
134
135
  if (name === "telegram") {
135
- // The `/` menu in Telegram clients. The commands work without it.
136
+ // The `/` menu in Telegram clients. The commands work without it. In
137
+ // webhook mode this is the first call that checks the token, so a 401
138
+ // marks the adapter failed instead of connected.
136
139
  try {
137
140
  await registerTelegramCommands(config);
138
141
  } catch (error) {
142
+ if (error instanceof TelegramBotApiError && error.status === 401) {
143
+ throw new Error(`Telegram rejected the bot token: ${errorMessage(error)}`);
144
+ }
139
145
  logger.warn(`Could not register the Telegram commands: ${errorMessage(error)}`);
140
146
  }
141
147
  }
@@ -28,6 +28,8 @@ export const ChatSdkStatusSchema = z.object({
28
28
  enabled: z.boolean(),
29
29
  /** `incomplete`: present in `CHAT_SDK_ADAPTERS` with a missing field or an unresolvable `$config`; `error` names it. */
30
30
  health: z.enum(["ok", "error", "disabled", "incomplete"]),
31
+ /** `configured && enabled && health === "ok"`: the one rule the dashboard cards and the onboarding signal share. */
32
+ connected: z.boolean(),
31
33
  error: z.string().optional(),
32
34
  webhookUrl: z.string(),
33
35
  mode: z.string().optional(),
@@ -90,6 +92,20 @@ function readRawAdapters(): Partial<Record<ChatSdkAdapterName, Record<string, un
90
92
  }
91
93
  }
92
94
 
95
+ /**
96
+ * Adapters that are configured, turned on and healthy, with the same rule as
97
+ * `getChatSdkStatus`. Reads local state only (no Discord guild lookup), so it
98
+ * is safe on a hot path or inside a transaction.
99
+ */
100
+ export function healthyChatSdkAdapters(): ChatSdkAdapterName[] {
101
+ const raw = readRawAdapters();
102
+ const health = getChatSdkHealth();
103
+ return CHAT_SDK_ADAPTER_NAMES.filter(
104
+ (name) =>
105
+ raw[name] !== undefined && isAdapterEntryEnabled(raw[name]) && health[name]?.status === "ok",
106
+ );
107
+ }
108
+
93
109
  export function chatSdkWebhookUrl(name: ChatSdkAdapterName): string {
94
110
  return `${getPublicMcpBaseUrl()}/api/integrations/chat/${name}/webhook`;
95
111
  }
@@ -149,6 +165,7 @@ export async function getChatSdkStatus(): Promise<ChatSdkStatus> {
149
165
  configured,
150
166
  enabled,
151
167
  health,
168
+ connected: configured && enabled && health === "ok",
152
169
  ...(error ? { error: statusError(error) } : {}),
153
170
  webhookUrl: chatSdkWebhookUrl(name),
154
171
  ...(mode ? { mode } : {}),
@@ -5,7 +5,11 @@ const TELEGRAM_TIMEOUT_MS = 10_000;
5
5
 
6
6
  /** A Bot API call that did not return `ok: true`. The message never carries the token. */
7
7
  export class TelegramBotApiError extends Error {
8
- constructor(message: string) {
8
+ constructor(
9
+ message: string,
10
+ /** The HTTP status, when the Bot API answered. 401 means the token was rejected. */
11
+ readonly status?: number,
12
+ ) {
9
13
  super(message);
10
14
  this.name = "TelegramBotApiError";
11
15
  }
@@ -50,6 +54,7 @@ export async function callTelegramBotApi(
50
54
  const description = payload?.description ?? `HTTP ${response.status}`;
51
55
  throw new TelegramBotApiError(
52
56
  `Telegram ${method} failed: ${scrubSecrets(description.replaceAll(token, "[REDACTED]"))}`,
57
+ response.status,
53
58
  );
54
59
  }
55
60
  return payload.result;
@@ -14,6 +14,8 @@ const RESERVED_FAMILIES = new Map([
14
14
  ["slack-external-alert", "namespace is reserved for Slack external channel alerts"],
15
15
  // Threads the swarm left via slack-leave-thread (src/slack/left-threads.ts).
16
16
  ["slack-left-thread", "namespace is reserved for left Slack threads; use slack-leave-thread"],
17
+ // Slack thread replies awaiting their buffer flush (src/slack/thread-buffer-store.ts). Private.
18
+ ["slack-thread-buffer", "namespace is reserved for the Slack thread buffer"],
17
19
  // Source group labels (src/be/db/session-labels.ts). Private, see PRIVATE_FAMILIES.
18
20
  [
19
21
  "session-labels",
@@ -24,9 +26,22 @@ const RESERVED_FAMILIES = new Map([
24
26
  /**
25
27
  * Reserved families that generic KV callers may not read either. Their rows
26
28
  * hold data that another route returns only to callers with access (a
27
- * source label names a private channel or a DM partner).
29
+ * source label names a private channel or a DM partner; a buffered Slack
30
+ * reply holds a message from one).
28
31
  */
29
- const PRIVATE_FAMILIES = new Set(["session-labels"]);
32
+ const PRIVATE_FAMILIES = new Set(["session-labels", "slack-thread-buffer"]);
33
+
34
+ /**
35
+ * Families only the Lead may write. `usecase:<key>` holds the Slack or chat
36
+ * thread a use case reports to; the Lead posts run summaries there, so a
37
+ * worker must not be able to point it at another thread.
38
+ */
39
+ const LEAD_ONLY_FAMILIES = new Set(["usecase"]);
40
+
41
+ /** True when writes to `namespace` need a Lead agent (`kv.write.any`). */
42
+ export function requiresLeadToWrite(namespace: string): boolean {
43
+ return LEAD_ONLY_FAMILIES.has(namespace.split(":", 1)[0] ?? "");
44
+ }
30
45
 
31
46
  export function isReservedNamespace(namespace: string): boolean {
32
47
  return reservedNamespaceError(namespace) !== null;
@@ -13,6 +13,8 @@
13
13
  * pickers and by the app-creation response.
14
14
  */
15
15
 
16
+ import { getGitHubLinkConfig } from "../utils/github-host";
17
+
16
18
  export interface OAuthPreset {
17
19
  /** Stable preset identifier referenced by the catalog manifest + pickers. */
18
20
  id: string;
@@ -43,6 +45,12 @@ export interface OAuthPreset {
43
45
  extraParams?: Record<string, string>;
44
46
  /** Operator-facing quirk notes surfaced in pickers + the creation response. */
45
47
  setupHints: string[];
48
+ /**
49
+ * Leave this preset out of the "add" pickers. The provider has one
50
+ * canonical flow elsewhere (Linear and Jira: their tracker integration
51
+ * page). Lookups by id still resolve, so existing rows keep working.
52
+ */
53
+ hiddenInCatalog?: boolean;
46
54
  }
47
55
 
48
56
  /**
@@ -137,6 +145,7 @@ const OAUTH_PRESETS: readonly OAuthPreset[] = [
137
145
  },
138
146
  {
139
147
  id: "jira",
148
+ hiddenInCatalog: true,
140
149
  displayName: "Jira (Atlassian)",
141
150
  provider: "jira",
142
151
  authorizeUrl: "https://auth.atlassian.com/authorize",
@@ -156,6 +165,7 @@ const OAUTH_PRESETS: readonly OAuthPreset[] = [
156
165
  },
157
166
  {
158
167
  id: "linear",
168
+ hiddenInCatalog: true,
159
169
  displayName: "Linear",
160
170
  provider: "linear",
161
171
  authorizeUrl: "https://linear.app/oauth/authorize",
@@ -222,7 +232,23 @@ const OAUTH_PRESETS: readonly OAuthPreset[] = [
222
232
 
223
233
  /** All curated presets (stable order). */
224
234
  export function listOAuthPresets(): OAuthPreset[] {
225
- return OAUTH_PRESETS.map((preset) => ({ ...preset }));
235
+ return OAUTH_PRESETS.map(withGitHubHost);
236
+ }
237
+
238
+ /** Point the GitHub preset at the configured GitHub host (GHES); other presets pass through. */
239
+ function withGitHubHost(preset: OAuthPreset): OAuthPreset {
240
+ if (preset.id !== "github") return { ...preset };
241
+ const { webUrl, apiUrl, enterprise } = getGitHubLinkConfig();
242
+ if (!enterprise) return { ...preset };
243
+ return {
244
+ ...preset,
245
+ authorizeUrl: `${webUrl}/login/oauth/authorize`,
246
+ tokenUrl: `${webUrl}/login/oauth/access_token`,
247
+ userinfoUrl: `${apiUrl}/user`,
248
+ setupHints: preset.setupHints.map((hint) =>
249
+ hint.replace("github.com/settings/developers", `${webUrl}/settings/developers`),
250
+ ),
251
+ };
226
252
  }
227
253
 
228
254
  /** All valid preset ids, for validation error messages + pickers. */
@@ -232,7 +258,8 @@ export function listOAuthPresetIds(): string[] {
232
258
 
233
259
  /** Look up a preset by id, or `null` when unknown. */
234
260
  export function getOAuthPreset(id: string): OAuthPreset | null {
235
- return OAUTH_PRESETS.find((preset) => preset.id === id) ?? null;
261
+ const preset = OAUTH_PRESETS.find((candidate) => candidate.id === id);
262
+ return preset ? withGitHubHost(preset) : null;
236
263
  }
237
264
 
238
265
  function mergeExtraParams(
@@ -6,7 +6,7 @@
6
6
  * A-D, F, G composite session template (role + persona, contract, workspace,
7
7
  * memory, communication, secrets) from session-templates.ts
8
8
  * E outputs (gated on AGENT_FS_API_URL and the pages capability)
9
- * H deployment-gated notes: slack, steering
9
+ * H deployment-gated notes: slack, use-case channel thread (lead), steering
10
10
  * I tools and skills (harness tool discovery, skills, MCP server names)
11
11
  * J agent notes: CLAUDE.md, only when edited
12
12
  *
@@ -22,7 +22,7 @@
22
22
  import type { ProviderTraits } from "../providers/types";
23
23
  import { getSlackConfiguration } from "../slack/config";
24
24
  import type { ProviderName } from "../types";
25
- import { resolveAgentFsLinkBase } from "../utils/constants";
25
+ import { agentFsFileLinkQuery, getAppUrl, resolveAgentFsLinkBase } from "../utils/constants";
26
26
  import { isSteeringEnabled } from "../utils/steering-enabled";
27
27
  import { matchesDefaultClaudeMd, matchesDefaultIdentityMd } from "./defaults";
28
28
  import { resolveTemplateAsync } from "./resolver";
@@ -215,6 +215,8 @@ export const getBasePrompt = async (args: BasePromptArgs): Promise<string> => {
215
215
  role,
216
216
  agentId,
217
217
  persona,
218
+ // Deployment-level, so the lead's use-case link keeps the prompt cache-stable.
219
+ appUrl: getAppUrl(),
218
220
  };
219
221
 
220
222
  // Composite choice by traits, then role.
@@ -251,10 +253,10 @@ export const getBasePrompt = async (args: BasePromptArgs): Promise<string> => {
251
253
  // agent-fs CLI needs a local environment with AGENT_FS_API_URL set.
252
254
  if (hasMcp && serverHasCapability("pages", true)) {
253
255
  const agentFsConfigured = hasLocalEnv && Boolean(process.env.AGENT_FS_API_URL);
256
+ const fileLinkBase = resolveAgentFsLinkBase("prompt");
254
257
  const outputsResult = await resolveTemplateAsync(
255
258
  agentFsConfigured ? "system.agent.outputs" : "system.agent.outputs.no_agent_fs",
256
- // Unset AGENT_FS_LINK_TARGET keeps the literal the agent expands in its shell.
257
- { fileLinkBase: resolveAgentFsLinkBase("prompt") ?? `\${AGENT_FS_LIVE_URL}` },
259
+ { fileLinkBase, fileLinkQuery: agentFsFileLinkQuery(fileLinkBase) },
258
260
  );
259
261
  prompt += outputsResult.text;
260
262
  }
@@ -267,6 +269,17 @@ export const getBasePrompt = async (args: BasePromptArgs): Promise<string> => {
267
269
  prompt += slackResult.text;
268
270
  }
269
271
 
272
+ // Use-case channel thread (lead only: every posting tool is lead-only).
273
+ if (
274
+ hasMcp &&
275
+ role === "lead" &&
276
+ !scriptsOnlyMode &&
277
+ (slackPromptToolsEnabled || serverHasCapability("chat-sdk", false))
278
+ ) {
279
+ const threadResult = await resolveTemplateAsync("system.agent.lead.channel_thread", {});
280
+ prompt += threadResult.text;
281
+ }
282
+
270
283
  if (
271
284
  hasMcp &&
272
285
  isSteeringEnabled() &&