@desplega.ai/agent-swarm 2.8.3 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (491) hide show
  1. package/dist/acp-adapter-jqn86aam.js +16 -0
  2. package/dist/acp-targets-swxq55dr.js +23 -0
  3. package/dist/{actions-ewz7bp4g.js → actions-pb678g3e.js} +20 -19
  4. package/dist/agent-fs-provision-dmhnc38q.js +27 -0
  5. package/dist/{amp-adapter-f25tqhnf.js → amp-adapter-3pa66q27.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-x2cp5fvf.js} +41 -41
  7. package/dist/{app-mkptw0k7.js → app-17d12ev4.js} +6 -4
  8. package/dist/approval-notifications-h7vd9pmg.js +20 -0
  9. package/dist/{assistant-c47rfe77.js → assistant-t7k39ree.js} +54 -33
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-4vb0xsat.js → boot-args-schema-0gqmkfbe.js} +1 -1
  12. package/dist/{boot-reembed-1ghy2sab.js → boot-reembed-f064w382.js} +1 -1
  13. package/dist/{boot-reembed-htr73hbs.js → boot-reembed-n6anc01d.js} +1 -1
  14. package/dist/{boot-scrub-sweep-yrytg42z.js → boot-scrub-sweep-ejd5dnrz.js} +84 -13
  15. package/dist/{boot-seeds-n2b3dx4e.js → boot-seeds-f99fjs5q.js} +4 -4
  16. package/dist/{boxd-jmfqgkqa.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-gvznwxgc.js +28 -0
  18. package/dist/{claude-managed-adapter-hddmxjyj.js → claude-managed-adapter-pbrbvc64.js} +4 -4
  19. package/dist/{claude-managed-setup-hfvry1bd.js → claude-managed-setup-kdxttvc3.js} +10 -10
  20. package/dist/{claude-sdk-session-0hamqzc7.js → claude-sdk-session-0t2teq6n.js} +9386 -9196
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-s8p8hhty.js → cli-1tvdx9t5.js} +2 -2
  23. package/dist/{cli-s7zz734a.js → cli-25nstr34.js} +1 -1
  24. package/dist/{cli-kw44j53p.js → cli-2kg31ted.js} +45 -38
  25. package/dist/{cli-mwwmka77.js → cli-2tnbc3gw.js} +375 -127
  26. package/dist/{cli-4dpkjc2e.js → cli-3zxdz9r7.js} +9 -9
  27. package/dist/{cli-mdpbjnzq.js → cli-4ghh072d.js} +14 -14
  28. package/dist/{cli-54qr8mcd.js → cli-57pvhnyt.js} +4 -4
  29. package/dist/{cli-f1kwb5fc.js → cli-5a6pqy45.js} +333 -21
  30. package/dist/{cli-93t5s4zq.js → cli-5gpqgs8b.js} +2 -2
  31. package/dist/{cli-4ax9mvvg.js → cli-5gygrr67.js} +9 -9
  32. package/dist/{cli-t5ys4ebm.js → cli-5kcmxwxv.js} +3 -3
  33. package/dist/{cli-k96cecs7.js → cli-5ntc4we6.js} +2948 -316
  34. package/dist/{cli-15204js0.js → cli-6237rnyr.js} +1 -1
  35. package/dist/cli-6dp0jkfj.js +754 -0
  36. package/dist/{cli-k2rw11py.js → cli-7831nhaw.js} +5 -5
  37. package/dist/{cli-7c5tgqhf.js → cli-7cgf614g.js} +10 -10
  38. package/dist/{cli-z8cvws4c.js → cli-7fx9jyfs.js} +852 -55
  39. package/dist/{cli-pe4d96rb.js → cli-7zm3b3f5.js} +1 -1
  40. package/dist/{cli-0bcgyj5b.js → cli-812paz57.js} +69 -6
  41. package/dist/{cli-ztq5z4e1.js → cli-8axx8vnw.js} +4 -4
  42. package/dist/cli-8x8y70av.js +103 -0
  43. package/dist/{cli-6yygkr0w.js → cli-95930z69.js} +15 -7
  44. package/dist/{cli-sdvcrq5x.js → cli-9a2rtd77.js} +16 -14
  45. package/dist/cli-9ttx00s3.js +137 -0
  46. package/dist/{cli-6ek0hff4.js → cli-a9hfzg2r.js} +3 -3
  47. package/dist/{cli-am1ptset.js → cli-aa8s22gn.js} +19 -14
  48. package/dist/{cli-4e1hfbpq.js → cli-bk9v1xrv.js} +19 -19
  49. package/dist/{cli-e2w34h6z.js → cli-c07v0qfa.js} +98 -54
  50. package/dist/{cli-dpsfwh7n.js → cli-c5cspahx.js} +24 -24
  51. package/dist/{cli-gpz1d0t2.js → cli-cw7mc1je.js} +4 -4
  52. package/dist/{cli-qmqt520k.js → cli-dd37e0cm.js} +2 -2
  53. package/dist/cli-dqgnbnxs.js +132 -0
  54. package/dist/{cli-tnzebztn.js → cli-dx439zpg.js} +1 -1
  55. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  56. package/dist/{cli-knva3nmx.js → cli-e9973bf0.js} +8 -6
  57. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  58. package/dist/{cli-crpf163n.js → cli-eepnpee7.js} +16 -26
  59. package/dist/{cli-nx2n3z6p.js → cli-eg437b5p.js} +1 -1
  60. package/dist/{cli-zdaypkq9.js → cli-faf46gdq.js} +285 -97
  61. package/dist/{cli-tas6ckky.js → cli-fgphc007.js} +2 -2
  62. package/dist/{cli-sg27rk2t.js → cli-fnh4b12r.js} +24 -18
  63. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  64. package/dist/{cli-rqfvkx5t.js → cli-g3zzby8t.js} +13 -13
  65. package/dist/{cli-kd56bmk4.js → cli-gabsjg8x.js} +3 -1
  66. package/dist/{cli-tf79ryyy.js → cli-gddgcnav.js} +3 -3
  67. package/dist/{cli-rjvsf9qa.js → cli-h474mvp5.js} +11 -11
  68. package/dist/{cli-5a7szzfh.js → cli-hnamkvnc.js} +2 -2
  69. package/dist/{cli-8bpgbr8k.js → cli-j49yqpvh.js} +6 -6
  70. package/dist/{cli-awwptga4.js → cli-jd3kxppb.js} +1 -1
  71. package/dist/{cli-1m96dc36.js → cli-js8zrfyg.js} +3 -3
  72. package/dist/{cli-vx421edw.js → cli-k09cxm6m.js} +9 -7
  73. package/dist/{cli-n5t077me.js → cli-k7pt28ad.js} +10 -3
  74. package/dist/{cli-922z7gwm.js → cli-kaa4bd7x.js} +9 -6
  75. package/dist/cli-kj0hyr43.js +51 -0
  76. package/dist/{cli-c0xjnr8z.js → cli-kmvcm34h.js} +2 -2
  77. package/dist/{cli-0vksaxvr.js → cli-kqh27v2y.js} +2 -2
  78. package/dist/{cli-bj6qhgte.js → cli-m1fbz2wj.js} +30 -37
  79. package/dist/{cli-me0r8gzr.js → cli-mc1fx4xd.js} +27 -25
  80. package/dist/{cli-qps8je6j.js → cli-me4maa4j.js} +46 -6
  81. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  82. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  83. package/dist/{cli-yss07azk.js → cli-nhq5js1b.js} +3 -3
  84. package/dist/cli-nmcpzbty.js +296 -0
  85. package/dist/cli-nr46j5pw.js +78 -0
  86. package/dist/{cli-t4dv07kr.js → cli-pn1v1pb0.js} +1 -1
  87. package/dist/{cli-c71n3bxq.js → cli-pwsax0vp.js} +2 -2
  88. package/dist/{cli-9zmb7ptc.js → cli-pz1c00aa.js} +8 -753
  89. package/dist/{cli-emekyyhr.js → cli-q2d3e1k1.js} +1 -1
  90. package/dist/{cli-zeaehgyd.js → cli-q8cfh1t9.js} +2 -2
  91. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  92. package/dist/{cli-2d0cghfn.js → cli-qj39vrc6.js} +1 -1
  93. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  94. package/dist/{cli-gn9y6fn7.js → cli-rts1qvb4.js} +2 -2
  95. package/dist/{cli-pxwtcgcp.js → cli-sn4pc4qx.js} +2 -2
  96. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  97. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  98. package/dist/{cli-6wj7p986.js → cli-spzkdgtg.js} +3 -3
  99. package/dist/{cli-m2z8jagn.js → cli-srtkr1h2.js} +18 -18
  100. package/dist/{cli-8476gtwf.js → cli-ssvdrk4y.js} +1 -1
  101. package/dist/{cli-c3ng0mb4.js → cli-svc803vq.js} +69 -816
  102. package/dist/{cli-500c09j9.js → cli-t9ga4qmb.js} +14 -14
  103. package/dist/{cli-j8cjdzan.js → cli-vs9vdpy0.js} +1 -1
  104. package/dist/{cli-bhsfbmk8.js → cli-vvgaz8t6.js} +93 -44
  105. package/dist/{cli-kmemts3w.js → cli-vw5x18yj.js} +39 -69
  106. package/dist/{cli-x3ex5bqf.js → cli-w16kwbzw.js} +1 -1
  107. package/dist/cli-w7dxb2fj.js +921 -0
  108. package/dist/{cli-x6t50dmw.js → cli-wr1h0k28.js} +3 -3
  109. package/dist/{cli-skmhsnqh.js → cli-x40a0w9j.js} +1 -1
  110. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  111. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  112. package/dist/{cli-h9yy18gy.js → cli-ymct0ycy.js} +262 -100
  113. package/dist/{cli-dtdht77h.js → cli-zg3z63x3.js} +2 -2
  114. package/dist/cli.js +27 -24
  115. package/dist/{codex-adapter-2brxx5ta.js → codex-adapter-44yq2fkn.js} +9 -8
  116. package/dist/{codex-hook-c930c3ea.js → codex-hook-h1zb7cfk.js} +6 -6
  117. package/dist/{codex-login-cbrs1h5w.js → codex-login-cdyrr5y1.js} +1 -1
  118. package/dist/{codex-session-runner-y9anfj0r.js → codex-session-runner-zbh26gbw.js} +10 -9
  119. package/dist/{commands-wn9q06qr.js → commands-54f02v5b.js} +3 -3
  120. package/dist/{controller-fw608czd.js → controller-9gpwcdek.js} +6 -6
  121. package/dist/{controllers-connect-63j5rdcm.js → controllers-connect-61re6k1n.js} +26 -25
  122. package/dist/{cursor-adapter-6mb9jme8.js → cursor-adapter-7e4g81vd.js} +2 -2
  123. package/dist/{db-y4wfrzbm.js → db-dg2gc7fd.js} +15 -13
  124. package/dist/{db-0m6v5tq4.js → db-wnh0qjy1.js} +3 -3
  125. package/dist/{devin-adapter-r0yx3gv8.js → devin-adapter-zp4tqq53.js} +1 -1
  126. package/dist/{dispatcher-9tq2zzdj.js → dispatcher-jrm24r43.js} +19 -18
  127. package/dist/{docker-j75atvpt.js → docker-9aq30pp2.js} +5 -5
  128. package/dist/{dsh-adapter-t09sv4tq.js → dsh-adapter-1yqk267c.js} +2 -2
  129. package/dist/{e2b-a7vzs2vj.js → e2b-3v1e745x.js} +6 -6
  130. package/dist/{e2b-7s9dscap.js → e2b-sm28k0k3.js} +6 -6
  131. package/dist/{easter-egg-3d-fbwvmwhe.js → easter-egg-3d-r4h9cs9m.js} +1 -1
  132. package/dist/{embedding-space-wh8de1t9.js → embedding-space-bafjr5f7.js} +6 -6
  133. package/dist/{embeddings-3hpbdtjr.js → embeddings-7xmgqe0e.js} +1 -1
  134. package/dist/{event-bus-tr6h3gv8.js → event-bus-xr83x566.js} +1 -1
  135. package/dist/{execute-4bdf8sdy.js → execute-d6jg5ns0.js} +1 -1
  136. package/dist/{external-channel-ts2fwqh0.js → external-channel-frq1xvq2.js} +2 -2
  137. package/dist/fx-adapter-0zrkfbkd.js +19 -0
  138. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  139. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  140. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  141. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  142. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  143. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-hh7strj3.js} +1 -1
  144. package/dist/{google-vertex-fhxaafzw.js → google-vertex-fy5bw2pm.js} +5 -5
  145. package/dist/grok-adapter-3db1c538.js +19 -0
  146. package/dist/handlers-k22n8mnn.js +33 -0
  147. package/dist/{heartbeat-2ze5fzpc.js → heartbeat-6bpa611t.js} +22 -21
  148. package/dist/{hook-ca54yd4s.js → hook-hvm5nf46.js} +5 -5
  149. package/dist/{hook-gaehe2w5.js → hook-w12k146y.js} +14 -14
  150. package/dist/{http-jfg8t2yk.js → http-43tthdvs.js} +1684 -509
  151. package/dist/{index-d6wkh8ar.js → index-1f0vypbg.js} +2 -2
  152. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  153. package/dist/{index-khe3gp0k.js → index-4b1q8kan.js} +20 -20
  154. package/dist/{index-hjhfk3ra.js → index-585gyczt.js} +1 -1
  155. package/dist/index-8xcyd3mc.js +33 -0
  156. package/dist/index-9sy2bh6n.js +38 -0
  157. package/dist/{index-2skqtd76.js → index-b24j7t2m.js} +30 -28
  158. package/dist/{index-gjwaqaq8.js → index-cret47a5.js} +6 -6
  159. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  160. package/dist/{index-csgrxedz.js → index-fn054vsf.js} +1 -1
  161. package/dist/{index-3yvzbhxd.js → index-ftywhyr0.js} +129 -142
  162. package/dist/{index-3gv6sc4z.js → index-mhq4sh5w.js} +1 -1
  163. package/dist/index-tx9mc2ap.js +570 -0
  164. package/dist/index-wjd56k1v.js +34 -0
  165. package/dist/{keepalive-k2a3qe73.js → keepalive-rk0j0jvh.js} +4 -4
  166. package/dist/lead-atxf3q6e.js +72 -0
  167. package/dist/{maintenance-gb5sd5nc.js → maintenance-g6z6kaxw.js} +1 -1
  168. package/dist/{node-252anz2h.js → node-jftbyawr.js} +4 -4
  169. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  170. package/dist/{oauth-refresh-sweep-y7rm6bkb.js → oauth-refresh-sweep-2k3g2q4w.js} +3 -3
  171. package/dist/{onboard-jmc5qerv.js → onboard-6fdbvh3v.js} +8 -8
  172. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  173. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  174. package/dist/{opencode-adapter-7eade9ev.js → opencode-adapter-fdbsvts7.js} +7 -6
  175. package/dist/{otel-impl-8j1xhxqd.js → otel-impl-rvwtc09q.js} +110 -110
  176. package/dist/pending-sqkrb836.js +80 -0
  177. package/dist/{pi-mono-adapter-yqmaf32x.js → pi-mono-adapter-asqayqcg.js} +12 -12
  178. package/dist/{pricing-refresh-1nj722h6.js → pricing-refresh-f5tkgmw2.js} +2 -2
  179. package/dist/{rbac-roles-b1mtr6dr.js → rbac-roles-06s555fa.js} +3 -3
  180. package/dist/{rbac-roles-n1f3frk1.js → rbac-roles-szxsg8t1.js} +10 -3
  181. package/dist/{render-v2-1gfpd8rj.js → render-v2-103p266q.js} +4 -4
  182. package/dist/{resume-w1s1eh5v.js → resume-v7kjewt9.js} +8 -7
  183. package/dist/{runtime-84g5egsc.js → runtime-f1gmk0b7.js} +1 -1
  184. package/dist/{session-access-y6z1txk4.js → session-access-6shev8ts.js} +4 -4
  185. package/dist/{session-source-backfill-gxxwfh12.js → session-source-backfill-bd7spzjd.js} +3 -3
  186. package/dist/{setup-r91gstyk.js → setup-kmxmztdb.js} +1 -1
  187. package/dist/thread-buffer-4yz236d0.js +36 -0
  188. package/dist/{virtual-modules-cgnj6kme.js → virtual-modules-57eje5wy.js} +5 -5
  189. package/dist/{work-objects-qcxzg61c.js → work-objects-zr47ygmf.js} +23 -21
  190. package/dist/{worker-follow-up-y2d2h7km.js → worker-follow-up-grrr3fda.js} +19 -18
  191. package/dist/worker-p4hbtcy3.js +72 -0
  192. package/dist/{x-qhxq2ama.js → x-wg164ss9.js} +2 -2
  193. package/openapi.json +1211 -155
  194. package/package.json +9 -6
  195. package/plugin/commands/create-pr.md +1 -1
  196. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  197. package/src/apps/action-runner.ts +21 -1
  198. package/src/apps/catalog.generated.json +626 -17
  199. package/src/apps/page-validator.ts +314 -8
  200. package/src/assets/key.ts +6 -0
  201. package/src/be/agent-fs-user-keys.ts +186 -0
  202. package/src/be/audit-user.ts +27 -13
  203. package/src/be/automation-preflight.test.ts +14 -14
  204. package/src/be/automation-preflight.ts +24 -16
  205. package/src/be/boot-scrub-sweep.ts +143 -14
  206. package/src/be/caller-session-group.ts +86 -0
  207. package/src/be/checklist.ts +375 -0
  208. package/src/be/db/agents.ts +12 -1
  209. package/src/be/db/approvals.ts +26 -0
  210. package/src/be/db/session-moves.ts +23 -0
  211. package/src/be/db/session-tree.ts +78 -19
  212. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  213. package/src/be/db/tasks/slack-fold.ts +116 -0
  214. package/src/be/db/tasks/write.ts +34 -0
  215. package/src/be/db-queries/mcp-servers.ts +13 -0
  216. package/src/be/db-queries/oauth.ts +6 -0
  217. package/src/be/db-queries/task-artifacts.ts +10 -8
  218. package/src/be/db.ts +42 -15
  219. package/src/be/extensions/assets.ts +17 -13
  220. package/src/be/import/config.ts +54 -0
  221. package/src/be/import/dir-source.ts +372 -0
  222. package/src/be/import/index.ts +149 -0
  223. package/src/be/import/pending.ts +71 -0
  224. package/src/be/import/schema.ts +137 -0
  225. package/src/be/import/seeders.ts +462 -0
  226. package/src/be/migrations/297_import_ownership.sql +34 -0
  227. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  228. package/src/be/migrations/302_checklist_items.sql +23 -0
  229. package/src/be/multi-runtime.ts +8 -1
  230. package/src/be/rbac-roles.ts +8 -1
  231. package/src/be/runtime-pools/demand.ts +20 -2
  232. package/src/be/runtime-pools/reachability.ts +31 -0
  233. package/src/be/runtime-pools/routing.ts +8 -1
  234. package/src/be/runtime-pools/supervisor.ts +6 -7
  235. package/src/be/savings/read.ts +8 -6
  236. package/src/be/script-credential-broker.ts +2 -2
  237. package/src/be/scripts/typecheck.ts +4 -4
  238. package/src/be/seed/agent-fs-provision.ts +104 -19
  239. package/src/be/seed/index.ts +1 -1
  240. package/src/be/seed/registry.ts +27 -8
  241. package/src/be/seed/runner.ts +1 -1
  242. package/src/be/seed/schedules-seeder.ts +24 -6
  243. package/src/be/seed/seed-toggle.ts +32 -0
  244. package/src/be/seed/types.ts +6 -0
  245. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  246. package/src/be/steering.ts +27 -4
  247. package/src/be/swarm-config-guard.ts +30 -0
  248. package/src/be/task-citations.ts +8 -5
  249. package/src/commands/onboard/agent-fs-version.ts +1 -1
  250. package/src/commands/runner.ts +61 -2
  251. package/src/e2b/env.ts +2 -0
  252. package/src/extensions/catalog.generated.json +17 -0
  253. package/src/extensions/contract-types.generated.ts +1 -1
  254. package/src/github/app.ts +10 -1
  255. package/src/github/handlers.ts +6 -3
  256. package/src/github/reactions.ts +12 -14
  257. package/src/heartbeat/heartbeat.ts +14 -4
  258. package/src/http/agents.ts +19 -10
  259. package/src/http/all-routes.ts +2 -0
  260. package/src/http/approval-requests.ts +24 -4
  261. package/src/http/apps.ts +69 -5
  262. package/src/http/checklist.ts +176 -0
  263. package/src/http/db-query-bounded.ts +256 -11
  264. package/src/http/db-query-shared.ts +9 -0
  265. package/src/http/favorites.ts +14 -2
  266. package/src/http/fs.ts +346 -1
  267. package/src/http/index.ts +29 -1
  268. package/src/http/kv.ts +13 -0
  269. package/src/http/mcp-oauth.ts +1 -1
  270. package/src/http/mcp-servers.ts +15 -2
  271. package/src/http/onboarding.ts +2 -9
  272. package/src/http/poll.ts +45 -0
  273. package/src/http/script-connections.ts +1 -0
  274. package/src/http/sessions.ts +17 -0
  275. package/src/http/slack-events.ts +101 -0
  276. package/src/http/status.ts +25 -7
  277. package/src/http/task-requester.ts +46 -0
  278. package/src/http/tasks.ts +64 -37
  279. package/src/http/users.ts +14 -0
  280. package/src/http/webhooks.ts +15 -0
  281. package/src/integrations/cards/index.ts +151 -0
  282. package/src/integrations/chat-sdk/outbound.ts +39 -13
  283. package/src/integrations/chat-sdk/runtime.ts +7 -1
  284. package/src/integrations/chat-sdk/status.ts +17 -0
  285. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  286. package/src/kv-reserved-namespaces.ts +17 -2
  287. package/src/oauth/presets.ts +29 -2
  288. package/src/prompts/base-prompt.ts +17 -4
  289. package/src/prompts/session-templates.ts +83 -6
  290. package/src/providers/acp-targets.ts +1 -1
  291. package/src/providers/amp-adapter.ts +1 -1
  292. package/src/providers/claude-managed-adapter.ts +5 -1
  293. package/src/providers/codex-adapter.ts +1 -1
  294. package/src/providers/codex-app-server.ts +2 -11
  295. package/src/providers/opencode-adapter.ts +7 -19
  296. package/src/providers/runtime-dependencies.ts +158 -0
  297. package/src/rbac/legacy-policy.ts +2 -0
  298. package/src/rbac/permissions.ts +10 -1
  299. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  300. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  301. package/src/scripts-runtime/egress-secrets.ts +2 -2
  302. package/src/scripts-runtime/swarm-sdk.ts +3 -2
  303. package/src/scripts-runtime/types/stdlib.d.ts +11 -4
  304. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -1
  305. package/src/scripts-runtime/types/swarm-sdk.d.ts +11 -4
  306. package/src/server.ts +4 -4
  307. package/src/slack/app.ts +87 -46
  308. package/src/slack/assistant.ts +33 -7
  309. package/src/slack/handlers.ts +6 -4
  310. package/src/slack/http-receiver.ts +284 -0
  311. package/src/slack/inbound-dispatch.ts +43 -7
  312. package/src/slack/inbound-files.ts +33 -14
  313. package/src/slack/message-text.ts +47 -4
  314. package/src/slack/render-v2.ts +2 -1
  315. package/src/slack/socket-ack.ts +17 -10
  316. package/src/slack/steering.ts +5 -0
  317. package/src/slack/thread-buffer-store.ts +58 -0
  318. package/src/slack/thread-buffer.ts +341 -57
  319. package/src/tasks/context-key.ts +24 -0
  320. package/src/tasks/sibling-awareness.ts +13 -1
  321. package/src/tests/agent-fs-live-url.test.ts +15 -0
  322. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  323. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  324. package/src/tests/agentfs-proxy.test.ts +8 -8
  325. package/src/tests/approval-card-resolution.test.ts +396 -0
  326. package/src/tests/approval-requests-notifications.test.ts +1 -1
  327. package/src/tests/approval-respond-auth.test.ts +28 -0
  328. package/src/tests/apps-action-parent-task.test.ts +140 -0
  329. package/src/tests/apps-catalog-additions.test.ts +315 -0
  330. package/src/tests/apps-catalog-files.test.ts +114 -0
  331. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  332. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  333. package/src/tests/apps-catalog-table.test.ts +47 -0
  334. package/src/tests/apps-chart-shell.test.ts +1 -1
  335. package/src/tests/apps-element-assembly.test.ts +52 -3
  336. package/src/tests/apps-session-thread.test.ts +182 -0
  337. package/src/tests/asset-key-invariants.test.ts +14 -0
  338. package/src/tests/base-prompt.test.ts +107 -23
  339. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  340. package/src/tests/caller-session-group.test.ts +199 -0
  341. package/src/tests/cards.test.ts +169 -0
  342. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  343. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  344. package/src/tests/chat-sdk-tools.test.ts +147 -0
  345. package/src/tests/checklist-nudge.test.ts +208 -0
  346. package/src/tests/checklist.test.ts +686 -0
  347. package/src/tests/codex-app-server.test.ts +16 -0
  348. package/src/tests/comb-config-guard.test.ts +21 -0
  349. package/src/tests/comb-default.test.ts +59 -97
  350. package/src/tests/comb-links.test.ts +86 -16
  351. package/src/tests/comb-status.test.ts +24 -27
  352. package/src/tests/create-page-tool.test.ts +101 -1
  353. package/src/tests/create-schedule-key.test.ts +105 -0
  354. package/src/tests/credential-broker.test.ts +2 -2
  355. package/src/tests/db-query.test.ts +87 -1
  356. package/src/tests/db-task-read-contract.test.ts +1 -0
  357. package/src/tests/db-task-write-contract.test.ts +2 -1
  358. package/src/tests/docs-index-footprint.test.js +3 -3
  359. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  360. package/src/tests/extensions-assets.test.ts +7 -3
  361. package/src/tests/extensions-catalog.test.ts +1 -0
  362. package/src/tests/extensions-example-sql-admin-only.test.ts +198 -0
  363. package/src/tests/extensions-pre-task.test.ts +3 -3
  364. package/src/tests/extensions-steering.test.ts +14 -2
  365. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  366. package/src/tests/fetch-resolved-env.test.ts +68 -0
  367. package/src/tests/fixtures/import-package.ts +32 -0
  368. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  369. package/src/tests/fs-routes.test.ts +505 -2
  370. package/src/tests/github-ghes-mock.test.ts +196 -0
  371. package/src/tests/github-host.test.ts +285 -0
  372. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  373. package/src/tests/heartbeat.test.ts +56 -0
  374. package/src/tests/import-config.test.ts +209 -0
  375. package/src/tests/import.test.ts +464 -0
  376. package/src/tests/invites-http.test.ts +144 -1
  377. package/src/tests/kv-http.test.ts +11 -0
  378. package/src/tests/literal-matcher.test.ts +58 -0
  379. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  380. package/src/tests/oauth-presets.test.ts +12 -0
  381. package/src/tests/pool-affinity.test.ts +50 -0
  382. package/src/tests/prompt-template-session.test.ts +52 -5
  383. package/src/tests/provider-registration.test.ts +2 -55
  384. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  385. package/src/tests/rbac-admission.test.ts +19 -0
  386. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  387. package/src/tests/rbac-engine.test.ts +2 -0
  388. package/src/tests/rbac-roles.test.ts +2 -0
  389. package/src/tests/runner-missing-dependency.test.ts +61 -0
  390. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  391. package/src/tests/runtime-pool-routing.test.ts +52 -0
  392. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  393. package/src/tests/savings-fleet-slices.test.ts +122 -0
  394. package/src/tests/savings-read.test.ts +41 -0
  395. package/src/tests/savings-scripts.test.ts +9 -3
  396. package/src/tests/script-connections.test.ts +2 -0
  397. package/src/tests/script-executor-conformance.test.ts +41 -4
  398. package/src/tests/secret-scrub-gate.test.ts +257 -0
  399. package/src/tests/seed-registry.test.ts +142 -9
  400. package/src/tests/session-source-keys.test.ts +42 -1
  401. package/src/tests/sessions-move.test.ts +70 -0
  402. package/src/tests/sessions-tree.test.ts +98 -0
  403. package/src/tests/sessions.test.ts +69 -0
  404. package/src/tests/slack-config.test.ts +4 -18
  405. package/src/tests/slack-http-receiver.test.ts +472 -0
  406. package/src/tests/slack-inbound-logging.test.ts +64 -0
  407. package/src/tests/slack-leave-thread.test.ts +1 -1
  408. package/src/tests/slack-message-text.test.ts +104 -0
  409. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  410. package/src/tests/slack-render-v2.test.ts +48 -0
  411. package/src/tests/slack-skip-reaction.test.ts +2 -2
  412. package/src/tests/slack-steering.test.ts +22 -10
  413. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  414. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  415. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  416. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  417. package/src/tests/slack-thread-buffer.test.ts +34 -34
  418. package/src/tests/slack-thread-participants.test.ts +23 -5
  419. package/src/tests/slack-tool-blocks.test.ts +167 -0
  420. package/src/tests/status.test.ts +32 -6
  421. package/src/tests/steering-core.test.ts +13 -0
  422. package/src/tests/steering-enabled.test.ts +7 -1
  423. package/src/tests/steering-promotion.test.ts +24 -0
  424. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  425. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  426. package/src/tests/task-artifacts.test.ts +50 -0
  427. package/src/tests/task-session-prompts.test.ts +95 -1
  428. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  429. package/src/tools/chat-post.ts +19 -4
  430. package/src/tools/chat-reply.ts +20 -4
  431. package/src/tools/create-page.ts +21 -4
  432. package/src/tools/get-swarm.ts +18 -2
  433. package/src/tools/join-swarm.ts +2 -1
  434. package/src/tools/kv/kv-write-auth.ts +17 -1
  435. package/src/tools/schedules/create-schedule.ts +22 -4
  436. package/src/tools/slack-post.ts +40 -7
  437. package/src/tools/slack-reply.ts +50 -14
  438. package/src/types.ts +43 -2
  439. package/src/utils/constants.ts +60 -138
  440. package/src/utils/github-host.ts +217 -0
  441. package/src/utils/github-pull-request.ts +8 -5
  442. package/src/utils/literal-matcher.ts +118 -0
  443. package/src/utils/secret-scrubber.ts +331 -25
  444. package/src/utils/task-attachment-links.ts +9 -12
  445. package/src/vcs/index.ts +3 -0
  446. package/src/workflows/approval-notifications.ts +188 -12
  447. package/src/workflows/executors/system-one-extraction.ts +14 -7
  448. package/src/workflows/executors/system-one-providers.ts +22 -1
  449. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  450. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  451. package/templates/extensions/README.md +1 -0
  452. package/templates/extensions/sql-admin-only/README.md +19 -0
  453. package/templates/extensions/sql-admin-only/hooks.ts +96 -0
  454. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  455. package/templates/import/manifest.schema.json +136 -0
  456. package/templates/import/sources.schema.json +44 -0
  457. package/templates/skills/agent-browser/SKILL.md +1 -1
  458. package/templates/skills/agent-browser/content.md +1 -1
  459. package/templates/skills/apps/SKILL.md +122 -12
  460. package/templates/skills/apps/content.md +122 -12
  461. package/templates/skills/asset-namespaces/content.md +2 -1
  462. package/templates/skills/chat-sdk/content.md +17 -0
  463. package/templates/skills/db-query-guidance/content.md +2 -1
  464. package/templates/skills/scheduling/content.md +27 -0
  465. package/templates/skills/slack-interaction/content.md +12 -2
  466. package/templates/skills/swarm-docs/content.md +1 -0
  467. package/templates/skills/swarm-extensions/config.json +1 -1
  468. package/templates/skills/swarm-extensions/content.md +33 -23
  469. package/templates/skills/swarm-scripts/SKILL.md +13 -0
  470. package/templates/skills/swarm-scripts/content.md +13 -0
  471. package/templates/skills/work-on-task/SKILL.md +1 -1
  472. package/templates/skills/work-on-task/content.md +1 -1
  473. package/templates/skills/workflow-iterate/content.md +4 -7
  474. package/templates/workflows/dreaming/content.md +2 -2
  475. package/dist/acp-adapter-xq6s2z6t.js +0 -14
  476. package/dist/claude-adapter-r33pqnzx.js +0 -24
  477. package/dist/cli-dns0y538.js +0 -194
  478. package/dist/fx-adapter-1rnxnf56.js +0 -17
  479. package/dist/grok-adapter-efhmf1r8.js +0 -17
  480. package/dist/handlers-anrr3py9.js +0 -32
  481. package/dist/index-8w2aznds.js +0 -33
  482. package/dist/index-qnjvr362.js +0 -37
  483. package/dist/index-yzxd3sn9.js +0 -32
  484. package/dist/lead-zhxqbfdv.js +0 -69
  485. package/dist/worker-7j2907g6.js +0 -69
  486. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  487. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  488. package/dist/{index-0rvk3vd4.js → index-bs7gw5fd.js} +3 -3
  489. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  490. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  491. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -10,6 +10,13 @@ import {
10
10
  recordSlackMessage,
11
11
  } from "@/be/db";
12
12
  import { getTaskCitations } from "@/be/task-citations";
13
+ import {
14
+ cardIssuesMessage,
15
+ cardSpecInputSchema,
16
+ cardToSlack,
17
+ renderCard,
18
+ slackFallbackText,
19
+ } from "@/integrations/cards";
13
20
  import { getSlackApp } from "@/slack/app";
14
21
  import {
15
22
  buildCaptionBlock,
@@ -33,7 +40,7 @@ export const registerSlackReplyTool = (server: McpServer) => {
33
40
  {
34
41
  title: "Reply to Slack thread",
35
42
  description:
36
- "Send a reply to a Slack thread. Use inboxMessageId for inbox messages, or taskId for task-related threads. The engine already publishes the task tree and outcome card, so send only a distinct agent-authored message. Prefer one reply per task over several, do not post progress, receipt, or acknowledgment messages, and match its length to what the user asked for.",
43
+ "Send a reply to a Slack thread. Use inboxMessageId for inbox messages, or taskId for task-related threads. The engine already publishes the task tree and outcome card, so send only a distinct agent-authored message. Prefer one reply per task over several, do not post progress, receipt, or acknowledgment messages, and match its length to what the user asked for. For a structured result (key figures, a table, charts, links), send a `card` instead of hand-built `blocks`.",
37
44
  annotations: { openWorldHint: true },
38
45
 
39
46
  inputSchema: z.object({
@@ -45,18 +52,28 @@ export const registerSlackReplyTool = (server: McpServer) => {
45
52
  .uuid()
46
53
  .optional()
47
54
  .describe("The task ID with Slack context (for task-related threads)."),
48
- message: z.string().min(1).max(4000).describe("The message to send to the Slack thread."),
55
+ message: z
56
+ .string()
57
+ .min(1)
58
+ .max(4000)
59
+ .optional()
60
+ .describe(
61
+ "The message to send to the Slack thread. Required unless card is given; with a card it renders above it.",
62
+ ),
49
63
  blocks: z
50
64
  .array(z.record(z.string(), z.unknown()))
51
65
  .max(50)
52
66
  .optional()
53
- .describe("Optional Block Kit blocks. When omitted, a mrkdwn section is generated."),
67
+ .describe(
68
+ "Optional raw Block Kit blocks. When omitted, a mrkdwn section is generated. Prefer card.",
69
+ ),
70
+ card: cardSpecInputSchema.optional(),
54
71
  }),
55
72
  outputSchema: swarmToolOutputSchema({
56
73
  messageTs: z.string().optional(),
57
74
  }),
58
75
  },
59
- async ({ inboxMessageId, taskId, message, blocks }, requestInfo, _meta) => {
76
+ async ({ inboxMessageId, taskId, message, blocks, card }, requestInfo, _meta) => {
60
77
  if (!requestInfo.agentId) {
61
78
  return toolErr("Agent ID not found.");
62
79
  }
@@ -75,6 +92,19 @@ export const registerSlackReplyTool = (server: McpServer) => {
75
92
  if (inboxMessageId && taskId) {
76
93
  return toolErr("Provide either inboxMessageId or taskId, not both.");
77
94
  }
95
+ if (blocks && card) return toolErr("Provide either blocks or card, not both.");
96
+ if (!message && !card) return toolErr("Provide a message or a card.");
97
+
98
+ // Validate the card before any side effect, so a bad spec changes nothing.
99
+ let cardSlack: { blocks: Record<string, unknown>[]; text: string } | undefined;
100
+ if (card) {
101
+ const rendered = renderCard(card);
102
+ const slack = "card" in rendered ? await cardToSlack(rendered.card) : rendered;
103
+ if ("issues" in slack) {
104
+ return toolErr(cardIssuesMessage(slack.issues), { data: { issues: slack.issues } });
105
+ }
106
+ cardSlack = slack;
107
+ }
78
108
 
79
109
  // Determine Slack context from inbox message or task
80
110
  if (inboxMessageId) {
@@ -89,7 +119,10 @@ export const registerSlackReplyTool = (server: McpServer) => {
89
119
  slackThreadTs = inboxMsg.slackThreadTs;
90
120
 
91
121
  // Mark as responded
92
- await markInboxMessageResponded(inboxMessageId, message);
122
+ await markInboxMessageResponded(
123
+ inboxMessageId,
124
+ slackFallbackText(message ?? "", cardSlack?.text),
125
+ );
93
126
  } else if (taskId) {
94
127
  const task = await getTaskById(taskId);
95
128
  if (!task) {
@@ -125,13 +158,11 @@ export const registerSlackReplyTool = (server: McpServer) => {
125
158
  const citations = taskId ? await getTaskCitations(taskId) : [];
126
159
  // Sources go in a caption under the reply, never in the body or the
127
160
  // notification text.
128
- const slackMessage = renderTaskCitations(
129
- markdownToSlack(message),
130
- citations,
131
- "slack",
132
- false,
133
- );
134
- const renderedBlocks = blocks?.map((block) =>
161
+ const slackMessage = message
162
+ ? renderTaskCitations(markdownToSlack(message), citations, "slack", false)
163
+ : "";
164
+ const customBlocks = cardSlack?.blocks ?? blocks;
165
+ const renderedBlocks = customBlocks?.map((block) =>
135
166
  JSON.parse(
136
167
  JSON.stringify(block, (key, value) =>
137
168
  key === "text" && typeof value === "string"
@@ -145,10 +176,15 @@ export const registerSlackReplyTool = (server: McpServer) => {
145
176
 
146
177
  const tree = await getSlackTreeMessageByThread(slackChannelId, slackThreadTs);
147
178
  const messageBlocks: Record<string, unknown>[] = [
179
+ ...(cardSlack && slackMessage ? buildMrkdwnSectionBlocks(slackMessage) : []),
148
180
  ...(renderedBlocks ?? buildMrkdwnSectionBlocks(slackMessage)),
149
181
  ];
150
182
  for (const group of taskCitationSourceGroups(
151
- blocks ? JSON.stringify(blocks) : message,
183
+ cardSlack
184
+ ? `${message ?? ""}\n${JSON.stringify(cardSlack.blocks)}`
185
+ : blocks
186
+ ? JSON.stringify(blocks)
187
+ : (message ?? ""),
152
188
  citations,
153
189
  )) {
154
190
  const caption = buildCaptionBlock(group.items, {
@@ -178,7 +214,7 @@ export const registerSlackReplyTool = (server: McpServer) => {
178
214
  app.client.chat.postMessage({
179
215
  channel: slackChannelId,
180
216
  thread_ts: slackThreadTs,
181
- text: slackMessage, // Fallback for notifications
217
+ text: slackFallbackText(slackMessage, cardSlack?.text), // Fallback for notifications
182
218
  unfurl_links: false,
183
219
  unfurl_media: false,
184
220
  username: getAgentDisplayName(agent),
package/src/types.ts CHANGED
@@ -615,7 +615,16 @@ export const SteeringStatusSchema = z.enum([
615
615
  ]);
616
616
  export type SteeringStatus = z.infer<typeof SteeringStatusSchema>;
617
617
 
618
- export const SteeringSourceSchema = z.enum(["ui", "mcp", "script", "slack", "api", "chat"]);
618
+ /** `app-page`: a steer sent from a json-render app page (the `SessionThread` component). */
619
+ export const SteeringSourceSchema = z.enum([
620
+ "ui",
621
+ "mcp",
622
+ "script",
623
+ "slack",
624
+ "api",
625
+ "chat",
626
+ "app-page",
627
+ ]);
619
628
  export type SteeringSource = z.infer<typeof SteeringSourceSchema>;
620
629
 
621
630
  export const SteeringMessageSchema = z
@@ -1337,7 +1346,39 @@ export type InboxItemState = z.infer<typeof InboxItemStateSchema>;
1337
1346
  // User Favorites (principal-scoped stars for app navigation)
1338
1347
  // ============================================================================
1339
1348
 
1340
- export const FavoriteItemTypeSchema = z.enum(["page", "workflow", "schedule", "agent-fs-path"]);
1349
+ export const ChecklistItemSchema = z
1350
+ .object({
1351
+ id: z.string(),
1352
+ scope: z.enum(["swarm", "user"]),
1353
+ userId: z.string().nullable(),
1354
+ kind: z.enum(["channel", "tool", "use_case", "custom"]),
1355
+ label: z.string(),
1356
+ href: z.string().nullable(),
1357
+ meta: z.record(z.string(), z.unknown()).nullable(),
1358
+ sortOrder: z.number(),
1359
+ status: z.enum(["open", "done", "removed"]),
1360
+ statusChangedAt: z.string().nullable(),
1361
+ statusChangedBy: z.string().nullable(),
1362
+ statusChangedByName: z.string().nullable(),
1363
+ statusReason: z.string().nullable(),
1364
+ nudgedAt: z.string().nullable(),
1365
+ nudgedTaskId: z.string().nullable(),
1366
+ signal: z.boolean().nullable(),
1367
+ done: z.boolean(),
1368
+ editable: z.boolean(),
1369
+ createdAt: z.string(),
1370
+ lastUpdatedAt: z.string(),
1371
+ })
1372
+ .openapi("ChecklistItem");
1373
+ export type ChecklistItem = z.infer<typeof ChecklistItemSchema>;
1374
+
1375
+ export const FavoriteItemTypeSchema = z.enum([
1376
+ "page",
1377
+ "workflow",
1378
+ "schedule",
1379
+ "agent-fs-path",
1380
+ "key",
1381
+ ]);
1341
1382
  export type FavoriteItemType = z.infer<typeof FavoriteItemTypeSchema>;
1342
1383
 
1343
1384
  export const UserFavoriteSchema = z
@@ -112,32 +112,46 @@ export function getAgentFsLiveUrl(): string {
112
112
  export type AgentFsLinkTarget = "dashboard" | "live";
113
113
 
114
114
  /**
115
- * The operator's `AGENT_FS_LINK_TARGET` choice (trimmed, lowercased). Null when
116
- * unset, blank, or invalid: every surface then keeps its automatic behavior.
115
+ * Where people-facing file links point. An explicit `AGENT_FS_LINK_TARGET`
116
+ * (trimmed, lowercased) wins. Unset, blank, or invalid: `dashboard` when an
117
+ * `APP_URL` / `DASHBOARD_URL` is configured (not the hosted fallback) and
118
+ * Comb is not explicitly off (`COMB_ENABLED=false`), else `live`.
117
119
  */
118
- export function readAgentFsLinkTarget(): AgentFsLinkTarget | null {
120
+ export function readAgentFsLinkTarget(): AgentFsLinkTarget {
119
121
  const raw = process.env.AGENT_FS_LINK_TARGET?.trim().toLowerCase();
120
- return raw === "dashboard" || raw === "live" ? raw : null;
122
+ if (raw === "dashboard" || raw === "live") return raw;
123
+ return getConfiguredAppUrls().length > 0 && !isCombExplicitlyOff() ? "dashboard" : "live";
121
124
  }
122
125
 
123
126
  /**
124
127
  * The base URL (no trailing slash) that a people-facing file link starts with,
125
128
  * per {@link readAgentFsLinkTarget}. `dashboard` uses `APP_URL` when one is
126
- * configured (and, for attachments, Comb is on), else the live app. Null when
127
- * no target is set: the caller keeps its current code path.
129
+ * configured and Comb is on, else the live app.
128
130
  *
129
- * The prompt surface skips the Comb check: workers do not get `COMB_ENABLED`,
130
- * and an explicit `dashboard` is the operator's choice.
131
+ * The prompt surface checks only an explicit `COMB_ENABLED=false`: a worker
132
+ * sees `COMB_ENABLED` only from a swarm_config row (RELOADABLE_ENV_KEYS in
133
+ * runner.ts) and may lack the API's agent-fs settings, so `isCombEnabled()`
134
+ * does not hold there.
131
135
  */
132
- export function resolveAgentFsLinkBase(surface: "prompt" | "attachment"): string | null {
133
- const target = readAgentFsLinkTarget();
134
- if (target === null) return null;
135
- if (target === "dashboard" && getConfiguredAppUrls().length > 0) {
136
- if (surface === "prompt" || isCombEnabled()) return getAppUrl();
136
+ export function resolveAgentFsLinkBase(surface: "prompt" | "attachment"): string {
137
+ if (readAgentFsLinkTarget() === "dashboard" && getConfiguredAppUrls().length > 0) {
138
+ if (surface === "prompt" ? !isCombExplicitlyOff() : isCombEnabled()) return getAppUrl();
137
139
  }
138
140
  return getAgentFsLiveUrl();
139
141
  }
140
142
 
143
+ /**
144
+ * The query string for a file link that starts with `base`. A live-app link
145
+ * gets `?apiUrl=<AGENT_FS_PUBLIC_URL>` when that URL is set, so a browser with
146
+ * no agent-fs key knows which agent-fs to sign in to (the agent-fs invite link
147
+ * convention). Empty for a dashboard link or with no public agent-fs URL.
148
+ */
149
+ export function agentFsFileLinkQuery(base: string): string {
150
+ if (base !== getAgentFsLiveUrl()) return "";
151
+ const publicUrl = process.env.AGENT_FS_PUBLIC_URL?.trim().replace(/\/+$/, "");
152
+ return publicUrl ? `?apiUrl=${encodeURIComponent(publicUrl)}` : "";
153
+ }
154
+
141
155
  /**
142
156
  * Optional fallback agent-fs `org_id` for attachments that store only `path`.
143
157
  * Strictly opt-in — when neither env var is set, the renderer keeps the
@@ -199,93 +213,12 @@ export function agentFsFileRoute(opts: AgentFsFileRef): string | null {
199
213
  * when that route is null; callers fall back to the raw `agent-fs:<path>`
200
214
  * display instead.
201
215
  *
202
- * Shape: ${liveHost}/file/~/<orgId>/<driveId>/<normalized-path>
216
+ * Shape: ${liveHost}/file/~/<orgId>/<driveId>/<normalized-path>[?apiUrl=<AGENT_FS_PUBLIC_URL>]
203
217
  */
204
218
  export function buildAgentFsLiveUrl(opts: AgentFsFileRef): string | null {
205
219
  const route = agentFsFileRoute(opts);
206
- return route ? `${getAgentFsLiveUrl()}/file/~/${route}` : null;
207
- }
208
-
209
- /** RFC 1918 private and 169.254/16 link-local IPv4 space, by its first two octets. */
210
- function isPrivateIpv4(a: number, b: number): boolean {
211
- return (
212
- a === 10 ||
213
- (a === 172 && b >= 16 && b <= 31) ||
214
- (a === 192 && b === 168) ||
215
- (a === 169 && b === 254)
216
- );
217
- }
218
-
219
- /**
220
- * The eight 16-bit groups of an IPv6 literal (no brackets), or null when it is
221
- * malformed. `new URL` already normalizes a host to compressed hex, so a
222
- * dotted IPv4 tail never reaches here; one is rejected rather than parsed.
223
- */
224
- function parseIpv6(addr: string): number[] | null {
225
- if (addr.includes(".")) return null;
226
- const halves = addr.split("::");
227
- if (halves.length > 2) return null;
228
- const toGroups = (part: string): number[] | null => {
229
- if (!part) return [];
230
- const groups = part
231
- .split(":")
232
- .map((g) => (/^[0-9a-f]{1,4}$/.test(g) ? Number.parseInt(g, 16) : Number.NaN));
233
- return groups.some(Number.isNaN) ? null : groups;
234
- };
235
- const head = toGroups(halves[0] ?? "");
236
- const tail = toGroups(halves[1] ?? "");
237
- if (!head || !tail) return null;
238
- if (halves.length === 1) return head.length === 8 ? head : null;
239
- const missing = 8 - head.length - tail.length;
240
- return missing < 1 ? null : [...head, ...new Array<number>(missing).fill(0), ...tail];
241
- }
242
-
243
- /**
244
- * Whether a browser can plausibly open this URL. False for the addresses only
245
- * the swarm's own network resolves: a single-label host (a docker or compose
246
- * service such as `agent-fs`), `*.internal` (Railway, Fly, GCP),
247
- * `*.svc` / `*.cluster.local` (Kubernetes), and private, link-local or
248
- * unique-local IPs, including IPv4-mapped IPv6 (`::ffff:10.0.0.5`), `::` and
249
- * multicast `ff00::/8`. Loopback counts as reachable: a localhost URL means the
250
- * API and agent-fs share a host, which only works for a browser on that same
251
- * machine (the local dev setup), and a remote operator can set `COMB_ENABLED`.
252
- * An unparseable value is not reachable.
253
- */
254
- export function isBrowserReachableUrl(value: string): boolean {
255
- let host: string;
256
- try {
257
- host = new URL(value).hostname.toLowerCase().replace(/\.$/, "");
258
- } catch {
259
- return false;
260
- }
261
- if (!host) return false;
262
- if (host === "localhost" || host.endsWith(".localhost")) return true;
263
- if (host.startsWith("[")) {
264
- const parsed = parseIpv6(host.slice(1, -1));
265
- if (!parsed) return false;
266
- const g = (i: number) => parsed[i] ?? 0;
267
- // Loopback is reachable (the local dev setup).
268
- if (parsed.slice(0, 7).every((x) => x === 0) && g(7) === 1) return true;
269
- // `::` and multicast `ff00::/8` are not addresses a browser can open.
270
- if (parsed.every((x) => x === 0) || (g(0) & 0xff00) === 0xff00) return false;
271
- // Unique-local `fc00::/7` and link-local `fe80::/10`.
272
- if ((g(0) & 0xfe00) === 0xfc00 || (g(0) & 0xffc0) === 0xfe80) return false;
273
- // IPv4-mapped `::ffff:a.b.c.d`: judge the embedded IPv4 address.
274
- if (parsed.slice(0, 5).every((x) => x === 0) && g(5) === 0xffff) {
275
- const a = g(6) >> 8;
276
- if (a === 0) return false;
277
- return a === 127 || !isPrivateIpv4(a, g(6) & 0xff);
278
- }
279
- return true;
280
- }
281
- const octets = host.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
282
- if (octets) {
283
- const [a, b] = [Number(octets[1]), Number(octets[2])];
284
- if (a === 0) return false;
285
- return a === 127 || !isPrivateIpv4(a, b);
286
- }
287
- if (!host.includes(".")) return false;
288
- return !(host.endsWith(".internal") || host.endsWith(".svc") || host.endsWith(".cluster.local"));
220
+ const live = getAgentFsLiveUrl();
221
+ return route ? `${live}/file/~/${route}${agentFsFileLinkQuery(live)}` : null;
289
222
  }
290
223
 
291
224
  export interface CombState {
@@ -297,38 +230,40 @@ export interface CombState {
297
230
  }
298
231
 
299
232
  /**
300
- * Comb (the agent-fs review space in the dashboard). An explicit
301
- * `COMB_ENABLED` wins both ways, but still needs `AGENT_FS_API_URL`. Unset, it
302
- * is on only when a browser can reach agent-fs: `AGENT_FS_PUBLIC_URL` is set,
303
- * `AGENT_FS_PROXY` is on and the public API URL is {@link isBrowserReachableUrl}
304
- * (the browser goes through the API), or, with no proxy, `AGENT_FS_API_URL` is
305
- * itself reachable. Otherwise the browser would land on a private host.
233
+ * Comb (the agent-fs review space in the dashboard). It always needs
234
+ * `AGENT_FS_API_URL`, and an explicit `COMB_ENABLED=false` turns it off. An
235
+ * explicit `COMB_ENABLED=true` turns it on. Unset, it is on only when the
236
+ * browser has an agent-fs address: `AGENT_FS_PUBLIC_URL`, or the API's
237
+ * `/agentfs` proxy (`AGENT_FS_PROXY`, on by default with `AGENT_FS_API_URL`).
306
238
  * Reads `process.env` per call, so a config reload applies without a restart.
307
239
  */
308
240
  export function getCombState(): CombState {
309
241
  const apiUrl = process.env.AGENT_FS_API_URL?.trim().replace(/\/+$/, "");
310
- const raw = process.env.COMB_ENABLED;
311
- // The two parses agree only when the value is a recognized flag literal.
312
- const explicit = parseEnvFlag(raw, true) === parseEnvFlag(raw, false);
313
- if (explicit && !isEnvFlagEnabled("COMB_ENABLED", false)) {
242
+ const explicit = isCombFlagExplicit();
243
+ if (isCombExplicitlyOff()) {
314
244
  return { enabled: false, explicit, reason: "COMB_ENABLED is false." };
315
245
  }
316
246
  if (!apiUrl) return { enabled: false, explicit, reason: "AGENT_FS_API_URL is not set." };
317
- if (explicit) return { enabled: true, explicit, reason: null };
318
- if (process.env.AGENT_FS_PUBLIC_URL?.trim()) return { enabled: true, explicit, reason: null };
319
- // With the proxy on, the browser goes to `<public API URL>/agentfs`, so that
320
- // is the address to check, not `AGENT_FS_API_URL`.
321
- const proxy = isAgentFsProxyEnabled();
322
- const browserUrl = proxy ? getPublicMcpBaseUrl() : apiUrl;
323
- return isBrowserReachableUrl(browserUrl)
324
- ? { enabled: true, explicit, reason: null }
325
- : {
326
- enabled: false,
327
- explicit,
328
- reason: proxy
329
- ? `AGENT_FS_PROXY is on, but the API address ${browserUrl} is not reachable from a browser. Set PUBLIC_MCP_BASE_URL to the public API URL, or set COMB_ENABLED=true to force Files on.`
330
- : `AGENT_FS_API_URL (${apiUrl}) is not reachable from a browser. Set AGENT_FS_PUBLIC_URL or AGENT_FS_PROXY=true, or set COMB_ENABLED=true to force Files on.`,
331
- };
247
+ if (!explicit && !process.env.AGENT_FS_PUBLIC_URL?.trim() && !isAgentFsProxyEnabled()) {
248
+ return {
249
+ enabled: false,
250
+ explicit,
251
+ reason:
252
+ "AGENT_FS_PROXY is false and AGENT_FS_PUBLIC_URL is not set, so a browser has no agent-fs address.",
253
+ };
254
+ }
255
+ return { enabled: true, explicit, reason: null };
256
+ }
257
+
258
+ /** `COMB_ENABLED` holds a recognized flag literal (the two parses agree only then). */
259
+ function isCombFlagExplicit(): boolean {
260
+ const raw = process.env.COMB_ENABLED;
261
+ return parseEnvFlag(raw, true) === parseEnvFlag(raw, false);
262
+ }
263
+
264
+ /** `COMB_ENABLED` is an explicit false. Also readable on a worker, unlike {@link isCombEnabled}. */
265
+ export function isCombExplicitlyOff(): boolean {
266
+ return isCombFlagExplicit() && !isEnvFlagEnabled("COMB_ENABLED", false);
332
267
  }
333
268
 
334
269
  /**
@@ -342,22 +277,9 @@ export function isCombEnabled(): boolean {
342
277
  /**
343
278
  * `AGENT_FS_PROXY`: the API serves agent-fs at `/agentfs/*` (plus the public
344
279
  * `/share/*` and `/site/*` pages), and Comb uses `<public API URL>/agentfs`.
345
- * Read per request, so a config upsert applies without a restart. Off by default.
280
+ * Read per request, so a config upsert applies without a restart.
281
+ * Defaults on when `AGENT_FS_API_URL` is nonblank. An explicit flag wins.
346
282
  */
347
283
  export function isAgentFsProxyEnabled(): boolean {
348
- return isEnvFlagEnabled("AGENT_FS_PROXY", false);
349
- }
350
-
351
- /**
352
- * The dashboard (Comb) URL for an agent-fs file, same id and encoding rules as
353
- * {@link buildAgentFsLiveUrl}. Null unless Comb is on AND an explicit
354
- * `APP_URL` / `DASHBOARD_URL` is set: the hosted default dashboard cannot open
355
- * a self-hosted swarm's files.
356
- *
357
- * Shape: ${appUrl}/file/~/<orgId>/<driveId>/<normalized-path>
358
- */
359
- export function buildCombFileUrl(opts: AgentFsFileRef): string | null {
360
- if (!isCombEnabled() || getConfiguredAppUrls().length === 0) return null;
361
- const route = agentFsFileRoute(opts);
362
- return route ? `${getAppUrl()}/file/~/${route}` : null;
284
+ return isEnvFlagEnabled("AGENT_FS_PROXY", Boolean(process.env.AGENT_FS_API_URL?.trim()));
363
285
  }
@@ -0,0 +1,217 @@
1
+ /**
2
+ * GitHub host resolver: one place that owns the web, REST and GraphQL bases.
3
+ *
4
+ * `GITHUB_URL` (web base, default https://github.com) and `GITHUB_API_URL`
5
+ * (REST override) target a GitHub Enterprise Server instance. Both are
6
+ * deployment-env only (reserved in swarm-config-guard): the API base receives
7
+ * the PAT, the App JWT and installation tokens.
8
+ *
9
+ * Env is read on every call (no cache) so tests and config reloads both work.
10
+ * No DB imports: API and worker code both use this module.
11
+ */
12
+
13
+ const DEFAULT_WEB_URL = "https://github.com";
14
+ const DEFAULT_API_URL = "https://api.github.com";
15
+ /** Hosts the SQL helpers can splice into a string literal or GLOB pattern. */
16
+ const SQL_SAFE_HOST = /^[a-z0-9._:-]+$/;
17
+
18
+ export interface GitHubHostConfig {
19
+ /** Web base, no trailing slash, e.g. `https://ghe.corp`. */
20
+ webUrl: string;
21
+ /** REST base, no trailing slash, e.g. `https://ghe.corp/api/v3`. */
22
+ apiUrl: string;
23
+ graphqlUrl: string;
24
+ /** Host (with port when set) for git/gh, e.g. `ghe.corp`. */
25
+ host: string;
26
+ /** Host (with port) of the REST base, e.g. `api.github.com`. */
27
+ apiHost: string;
28
+ enterprise: boolean;
29
+ }
30
+
31
+ export type GitHubHostResult =
32
+ | { ok: true; config: GitHubHostConfig; warning?: string }
33
+ | { ok: false; error: string };
34
+
35
+ type Env = Record<string, string | undefined>;
36
+
37
+ const DEFAULT_CONFIG: GitHubHostConfig = {
38
+ webUrl: DEFAULT_WEB_URL,
39
+ apiUrl: DEFAULT_API_URL,
40
+ graphqlUrl: `${DEFAULT_API_URL}/graphql`,
41
+ host: "github.com",
42
+ apiHost: "api.github.com",
43
+ enterprise: false,
44
+ };
45
+
46
+ // Error messages never echo the raw value or its path: either can carry a token
47
+ // (`https://user:ghp_x@host`, `https://host/ghp_x`), and they reach boot logs and /status.
48
+
49
+ function parseBase(name: string, raw: string, allowPath: boolean): URL | string {
50
+ let url: URL;
51
+ try {
52
+ url = new URL(raw);
53
+ } catch {
54
+ return `${name} is not a valid URL`;
55
+ }
56
+ if (url.protocol !== "https:" && url.protocol !== "http:") {
57
+ return `${name} must use https:// (got ${url.protocol})`;
58
+ }
59
+ if (url.username || url.password) return `${name} must not contain credentials`;
60
+ if (url.search || url.hash || raw.includes("?") || raw.includes("#")) {
61
+ return `${name} must not contain a query or fragment`;
62
+ }
63
+ if (!allowPath && url.pathname !== "/") {
64
+ return `${name} must be the instance root, without a path`;
65
+ }
66
+ if (!SQL_SAFE_HOST.test(url.host)) {
67
+ // shortcut: IPv6 literals (`[::1]`) are refused because `[` is a GLOB class, upgrade by escaping if one is needed.
68
+ return `${name} host must be a DNS name or IPv4 address`;
69
+ }
70
+ return url;
71
+ }
72
+
73
+ function stripSlash(value: string): string {
74
+ return value.replace(/\/+$/, "");
75
+ }
76
+
77
+ /** Resolve and validate the GitHub host config from env. Never throws. */
78
+ export function resolveGitHubHost(env: Env = process.env): GitHubHostResult {
79
+ const rawWeb = env.GITHUB_URL?.trim() ?? "";
80
+ const rawApi = env.GITHUB_API_URL?.trim() ?? "";
81
+ const warnings: string[] = [];
82
+
83
+ let webUrl = DEFAULT_WEB_URL;
84
+ let host = "github.com";
85
+ if (rawWeb) {
86
+ const parsed = parseBase("GITHUB_URL", rawWeb, false);
87
+ if (typeof parsed === "string") return { ok: false, error: parsed };
88
+ if (parsed.protocol === "http:")
89
+ warnings.push("GITHUB_URL uses http://; tokens travel unencrypted");
90
+ // URL lowercases the host already; `origin` drops the trailing slash.
91
+ webUrl = parsed.origin;
92
+ host = parsed.host;
93
+ }
94
+
95
+ // An explicit github.com (or www.) is the default, whatever the scheme.
96
+ const enterprise = host !== "github.com" && host !== "www.github.com";
97
+ if (!enterprise) {
98
+ webUrl = DEFAULT_WEB_URL;
99
+ host = "github.com";
100
+ warnings.length = 0;
101
+ }
102
+
103
+ let apiUrl: string;
104
+ if (rawApi) {
105
+ const parsed = parseBase("GITHUB_API_URL", rawApi, true);
106
+ if (typeof parsed === "string") return { ok: false, error: parsed };
107
+ if (parsed.protocol === "http:")
108
+ warnings.push("GITHUB_API_URL uses http://; tokens travel unencrypted");
109
+ apiUrl = stripSlash(`${parsed.origin}${parsed.pathname}`);
110
+ } else if (!enterprise) {
111
+ apiUrl = DEFAULT_API_URL;
112
+ } else if (host.endsWith(".ghe.com")) {
113
+ // GHE.com data residency: the API lives on an `api.` subdomain.
114
+ apiUrl = `${webUrl.replace("://", "://api.")}`;
115
+ } else {
116
+ apiUrl = `${webUrl}/api/v3`;
117
+ }
118
+
119
+ const graphqlUrl = apiUrl.endsWith("/api/v3")
120
+ ? `${apiUrl.slice(0, -"/api/v3".length)}/api/graphql`
121
+ : `${apiUrl}/graphql`;
122
+
123
+ return {
124
+ ok: true,
125
+ config: { webUrl, apiUrl, graphqlUrl, host, apiHost: new URL(apiUrl).host, enterprise },
126
+ ...(warnings.length ? { warning: warnings.join("; ") } : {}),
127
+ };
128
+ }
129
+
130
+ /**
131
+ * The resolved config. Throws on an invalid value rather than falling back to github.com.
132
+ * For readers that pick where a token goes; parse/link readers use getGitHubLinkConfig.
133
+ */
134
+ export function getGitHubHostConfig(): GitHubHostConfig {
135
+ const result = resolveGitHubHost();
136
+ if (!result.ok) throw new Error(`Invalid GitHub host config: ${result.error}`);
137
+ return result.config;
138
+ }
139
+
140
+ /**
141
+ * The resolved config, or the github.com default when the config is invalid. Never throws.
142
+ * Only for readers that parse or link (PR extraction, SQL host match, citations, presets,
143
+ * VCS detection); never use it to pick where a token goes.
144
+ */
145
+ export function getGitHubLinkConfig(): GitHubHostConfig {
146
+ const result = resolveGitHubHost();
147
+ return result.ok ? result.config : { ...DEFAULT_CONFIG };
148
+ }
149
+
150
+ export const getGitHubWebUrl = (): string => getGitHubHostConfig().webUrl;
151
+ export const getGitHubApiUrl = (): string => getGitHubHostConfig().apiUrl;
152
+ export const getGitHubGraphqlUrl = (): string => getGitHubHostConfig().graphqlUrl;
153
+ export const getGitHubHost = (): string => getGitHubHostConfig().host;
154
+ export const isGitHubEnterprise = (): boolean => getGitHubHostConfig().enterprise;
155
+
156
+ /** `${apiBase}${path}`, path starting with `/`. */
157
+ export function githubApiUrl(path: string): string {
158
+ return `${getGitHubApiUrl()}${path}`;
159
+ }
160
+
161
+ /** `${webBase}${path}`, path starting with `/`. */
162
+ export function githubWebLink(path: string): string {
163
+ return `${getGitHubWebUrl()}${path}`;
164
+ }
165
+
166
+ /**
167
+ * The configured host (github.com on an invalid config), safe to splice into a SQL
168
+ * string literal or GLOB pattern: resolveGitHubHost refuses any other host shape. Never throws.
169
+ */
170
+ export function getGitHubHostForSql(): string {
171
+ const host = getGitHubLinkConfig().host;
172
+ return SQL_SAFE_HOST.test(host) ? host : DEFAULT_CONFIG.host;
173
+ }
174
+
175
+ /**
176
+ * On GHES, gh sends GITHUB_TOKEN / GH_TOKEN to github.com. Move the PAT to
177
+ * GH_ENTERPRISE_TOKEN (GHES hosts only) and drop the github.com variables, so a
178
+ * harness session never carries the GHES PAT where gh would send it to github.com.
179
+ * Mirrors the GHES branch of docker-entrypoint.sh. No-op on github.com or an invalid config.
180
+ */
181
+ export function scopeGitHubTokenToEnterprise(env: Env): void {
182
+ const host = resolveGitHubHost(env);
183
+ if (!host.ok || !host.config.enterprise) return;
184
+ const token = env.GITHUB_TOKEN || env.GH_TOKEN;
185
+ if (token) env.GH_ENTERPRISE_TOKEN = token;
186
+ delete env.GITHUB_TOKEN;
187
+ delete env.GH_TOKEN;
188
+ }
189
+
190
+ /**
191
+ * Host of a URL (https://, git://, ssh:// or scp-like `git@host:owner/repo`),
192
+ * lowercased, or null.
193
+ */
194
+ function urlHost(url: string): string | null {
195
+ const scp = url.match(/^[\w.-]+@([^:/]+):(?!\/)/);
196
+ if (scp) return scp[1]!.toLowerCase();
197
+ try {
198
+ const parsed = new URL(/^[a-z][a-z0-9+.-]*:\/\//i.test(url) ? url : `https://${url}`);
199
+ return parsed.host.toLowerCase();
200
+ } catch {
201
+ return null;
202
+ }
203
+ }
204
+
205
+ /**
206
+ * True when `url` points at the configured GitHub host (plus www.github.com in default mode).
207
+ * Parse-only: github.com rules on an invalid config. Never throws.
208
+ */
209
+ export function isGitHubUrl(url: string): boolean {
210
+ const host = urlHost(url.trim());
211
+ if (!host) return false;
212
+ const config = getGitHubLinkConfig();
213
+ if (host === config.host) return true;
214
+ // scp-like and ssh URLs never carry the web port.
215
+ if (host === new URL(config.webUrl).hostname) return true;
216
+ return !config.enterprise && host === "www.github.com";
217
+ }