@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
@@ -28,6 +28,7 @@ import { getResourceSessionLabels, getSessionLabels } from "../be/db/session-lab
28
28
  import {
29
29
  listPrefixRoots,
30
30
  listSharedPrefixRoots,
31
+ moveKeyFavorites,
31
32
  moveSessionChains,
32
33
  type SessionKeyMove,
33
34
  } from "../be/db/session-moves";
@@ -80,6 +81,7 @@ import {
80
81
  import { getRequestAuth } from "../utils/request-auth-context";
81
82
  import { isRuntimePoolsEnabled } from "../utils/runtime-pools-flag";
82
83
  import { canMutateTaskNamespace } from "./assets";
84
+ import { resolveHttpFavoriteOwner } from "./favorite-owner";
83
85
  import { createListTotalCache } from "./list-total-cache";
84
86
  import { agentFirstPrincipal, authUserId, requireAuthKind } from "./request-principal";
85
87
  import { route } from "./route-def";
@@ -1242,6 +1244,21 @@ export async function handleSessions(
1242
1244
  if (roots.length < SESSION_MOVE_LIMIT) break;
1243
1245
  }
1244
1246
  const moved = await moveSessionChains({ moves, changedBy });
1247
+ // Stars on the group follow a rename only when no session of any owner is
1248
+ // left under the old key: nothing skipped, nothing remaining. Every user's
1249
+ // stars move only when this request moved sessions, which proves the caller
1250
+ // could move every root. A rename that moves nothing (an emptied group, or a
1251
+ // retry) moves only the caller's own stars. A delete leaves the stars in place.
1252
+ if (
1253
+ key !== null &&
1254
+ skipped.length === 0 &&
1255
+ remaining === 0 &&
1256
+ (await listPrefixRoots({ from, limit: 1 })).length === 0
1257
+ ) {
1258
+ const scope =
1259
+ moved.length > 0 ? undefined : (await resolveHttpFavoriteOwner(req, myAgentId))?.scope;
1260
+ if (moved.length > 0 || scope) await moveKeyFavorites({ from, to: key, scope });
1261
+ }
1245
1262
  moveSessionPrefix.respond(res, 200, { moved, skipped, remaining });
1246
1263
  },
1247
1264
  );
@@ -0,0 +1,101 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import { getSlackHttpReceiver } from "../slack/app";
3
+ import { getSlackConfiguration } from "../slack/config";
4
+ import { route } from "./route-def";
5
+ import { BODY_TOO_LARGE, enforceContentLengthCap, jsonError } from "./utils";
6
+
7
+ const slackEventsRoute = route({
8
+ method: "post",
9
+ path: "/api/integrations/slack/events",
10
+ pattern: ["api", "integrations", "slack", "events"],
11
+ summary:
12
+ "Slack HTTP ingress (SLACK_MODE=http): Events API, slash commands and interactivity at one request URL",
13
+ tags: ["Slack"],
14
+ auth: { apiKey: false },
15
+ rbac: {
16
+ ungated:
17
+ "Slack-signed request: HMAC v0 verified with SLACK_SIGNING_SECRET, with a 5-minute timestamp window, before any work",
18
+ },
19
+ responses: {
20
+ 200: {
21
+ description: "Accepted",
22
+ unstructured:
23
+ "Slack ack payload: empty, the url_verification challenge, or a command/interactivity response body",
24
+ },
25
+ 400: { description: "Malformed body after a valid signature" },
26
+ 401: { description: "Missing or invalid signature, or timestamp outside the 5-minute window" },
27
+ 403: { description: "Delivery for a workspace this swarm does not own" },
28
+ 404: { description: "Slack is disabled or not in HTTP mode" },
29
+ 413: { description: "Body exceeds 1 MiB" },
30
+ 503: {
31
+ description: "Receiver not ready, workspace unverified, or backlog full; Slack retries",
32
+ },
33
+ },
34
+ });
35
+
36
+ /** Slack payloads are a few KB; the receipt store refuses anything above 1 MiB anyway. */
37
+ const SLACK_EVENTS_MAX_BODY_BYTES = 1024 * 1024;
38
+
39
+ function header(req: IncomingMessage, name: string): string | undefined {
40
+ const value = req.headers[name];
41
+ return Array.isArray(value) ? value[0] : value;
42
+ }
43
+
44
+ export async function handleSlackEvents(
45
+ req: IncomingMessage,
46
+ res: ServerResponse,
47
+ pathSegments: string[],
48
+ ): Promise<boolean> {
49
+ if (!slackEventsRoute.match(req.method, pathSegments)) return false;
50
+
51
+ // Never open ingress under Socket Mode, or without credentials.
52
+ const config = getSlackConfiguration();
53
+ if (config.disabled || config.mode !== "http" || config.missingCredentials.length > 0) {
54
+ jsonError(res, "Slack HTTP mode is not enabled", 404);
55
+ return true;
56
+ }
57
+ const receiver = getSlackHttpReceiver();
58
+ if (!receiver) {
59
+ res.writeHead(503, { "Content-Type": "application/json", "Retry-After": "5" });
60
+ res.end(JSON.stringify({ error: "Slack receiver is not ready" }));
61
+ return true;
62
+ }
63
+
64
+ // Unauthenticated until the HMAC passes, so bound the body before buffering
65
+ // it. An oversized stream is answered at once and drained without buffering.
66
+ if (enforceContentLengthCap(req, res, SLACK_EVENTS_MAX_BODY_BYTES) === BODY_TOO_LARGE) {
67
+ return true;
68
+ }
69
+ const chunks: Buffer[] = [];
70
+ let receivedBytes = 0;
71
+ let tooLarge = false;
72
+ for await (const chunk of req) {
73
+ if (tooLarge) continue;
74
+ receivedBytes += (chunk as Buffer).byteLength;
75
+ if (receivedBytes > SLACK_EVENTS_MAX_BODY_BYTES) {
76
+ tooLarge = true;
77
+ chunks.length = 0;
78
+ jsonError(res, `Payload too large (max ${SLACK_EVENTS_MAX_BODY_BYTES} bytes)`, 413);
79
+ continue;
80
+ }
81
+ chunks.push(chunk as Buffer);
82
+ }
83
+ if (tooLarge) return true;
84
+
85
+ const result = await receiver.handle({
86
+ rawBody: Buffer.concat(chunks),
87
+ signature: header(req, "x-slack-signature"),
88
+ timestamp: header(req, "x-slack-request-timestamp"),
89
+ contentType: header(req, "content-type"),
90
+ retryNum: header(req, "x-slack-retry-num"),
91
+ retryReason: header(req, "x-slack-retry-reason"),
92
+ // Read per request so a config reload takes effect; never stored or logged.
93
+ signingSecret: process.env.SLACK_SIGNING_SECRET as string,
94
+ });
95
+ res.writeHead(result.status, {
96
+ ...(result.contentType ? { "Content-Type": result.contentType } : {}),
97
+ ...result.headers,
98
+ });
99
+ res.end(result.body);
100
+ return true;
101
+ }
@@ -44,6 +44,7 @@ import { getSlackConfiguration } from "../slack/config";
44
44
  import { getSlackConnectionState } from "../slack/connection-state";
45
45
  import { isTelemetryEnabled } from "../telemetry";
46
46
  import { type AgentCredStatus, AutomationIntegrationIdSchema, ProviderNameSchema } from "../types";
47
+ import { resolveGitHubHost } from "../utils/github-host";
47
48
  import { isRuntimePoolsEnabled } from "../utils/runtime-pools-flag";
48
49
  import { resolveAppUrl } from "./config-values";
49
50
  import { route } from "./route-def";
@@ -141,7 +142,7 @@ export type StatusActivity = z.infer<typeof StatusActivitySchema>;
141
142
 
142
143
  export const StatusCombSchema = z.object({
143
144
  enabled: z.boolean(),
144
- /** What is missing when Comb is off (for example no browser-reachable agent-fs URL). Null when on. */
145
+ /** Why Comb is off (no `AGENT_FS_API_URL`, `COMB_ENABLED=false`, or no browser agent-fs address). Null when on. */
145
146
  reason: z.string().nullable(),
146
147
  api_url: z.string().nullable(),
147
148
  live_url: z.string(),
@@ -221,6 +222,16 @@ export type AutomationStatus = z.infer<typeof AutomationStatusSchema>;
221
222
  export const StatusHealthSchema = z.enum(["ok", "degraded", "broken"]);
222
223
  export type StatusHealth = z.infer<typeof StatusHealthSchema>;
223
224
 
225
+ /**
226
+ * The GitHub web base (`GITHUB_URL`, default https://github.com) the dashboard
227
+ * builds and recognizes PR, issue and repo links with. Deployment-env only.
228
+ */
229
+ export const StatusGitHubSchema = z.object({
230
+ web_url: z.string(),
231
+ enterprise: z.boolean(),
232
+ });
233
+ export type StatusGitHub = z.infer<typeof StatusGitHubSchema>;
234
+
224
235
  export const StatusRuntimePoolsSchema = z.object({ enabled: z.boolean(), supervisor: z.string() });
225
236
 
226
237
  export const StatusResponseSchema = z.object({
@@ -236,6 +247,8 @@ export const StatusResponseSchema = z.object({
236
247
  telemetry: StatusTelemetrySchema.optional(),
237
248
  /** Additive: absent on servers that predate it. */
238
249
  instance: StatusInstanceSchema.optional(),
250
+ /** Additive: absent on servers that predate it, or when `GITHUB_URL` is invalid. */
251
+ github: StatusGitHubSchema.optional(),
239
252
  });
240
253
  export type StatusResponse = z.infer<typeof StatusResponseSchema>;
241
254
 
@@ -496,9 +509,6 @@ function slackMilestone(state: AutomationSetupStates["slack"]): SetupMilestone {
496
509
  hint = "Slack is explicitly disabled (SLACK_DISABLE=true).";
497
510
  } else if (!config.mode) {
498
511
  hint = "Invalid SLACK_MODE. Use socket or http.";
499
- } else if (config.mode === "http" && config.missingCredentials.length === 0) {
500
- hint =
501
- "HTTP credentials are configured, but HTTP ingress is unavailable until the receiver is installed.";
502
512
  } else {
503
513
  hint = `Set ${config.missingCredentials.join(" + ")} for Slack ${config.mode} mode.`;
504
514
  }
@@ -511,7 +521,7 @@ function slackMilestone(state: AutomationSetupStates["slack"]): SetupMilestone {
511
521
  };
512
522
  }
513
523
 
514
- if (config.mode === "socket" && getSlackConnectionState() === "connected") {
524
+ if (getSlackConnectionState() === "connected") {
515
525
  return {
516
526
  id: "slack",
517
527
  label: "Slack configured",
@@ -526,7 +536,7 @@ function slackMilestone(state: AutomationSetupStates["slack"]): SetupMilestone {
526
536
  state: "configured",
527
537
  hint:
528
538
  config.mode === "http"
529
- ? "HTTP credentials are configured, but HTTP ingress is unavailable until the receiver is installed."
539
+ ? "HTTP credentials are configured, but the receiver is not ready (workspace not verified yet)."
530
540
  : "Socket Mode credentials are configured, but the bot is not connected to Slack.",
531
541
  action_url: automationIntegrationFixUrl("slack"),
532
542
  };
@@ -780,9 +790,17 @@ export async function buildStatusPayload(): Promise<StatusResponse> {
780
790
  health: computeHealth(setup, readyLeads),
781
791
  telemetry: { enabled: isTelemetryEnabled() },
782
792
  instance,
793
+ ...githubStatus(),
783
794
  };
784
795
  }
785
796
 
797
+ /** Left out on an invalid host config: the GitHub integration logs that error and stays off. */
798
+ function githubStatus(): { github?: StatusGitHub } {
799
+ const host = resolveGitHubHost();
800
+ if (!host.ok) return {};
801
+ return { github: { web_url: host.config.webUrl, enterprise: host.config.enterprise } };
802
+ }
803
+
786
804
  function getCombStatus(serviceUserId: string | null): StatusAgentFs["comb"] {
787
805
  const comb = getCombConfig();
788
806
  return {
@@ -822,7 +840,7 @@ const getStatus = route({
822
840
  pattern: ["status"],
823
841
  summary: "Identity + setup readiness + live activity for the swarm dashboard",
824
842
  description:
825
- "Single source of truth consumed by the UI home page. Identity comes from SWARM_* envs; setup milestones each emit `unverified | configured | verified`; automations report `running | needs_setup` from the same runtime preflight used at dispatch; activity counts agents alive in the last 5 min, leads that can take work (status idle or busy), and tasks created in the last 24h; agent_fs reports whether AGENT_FS_API_URL is set, plus the Comb settings (whether Files is on and, when off, what is missing; the browser-facing agent-fs URL, the shared org and drive ids, and the agent-fs user id of the swarm service account); telemetry reports the effective ANONYMIZED_TELEMETRY opt-out state.",
843
+ "Single source of truth consumed by the UI home page. Identity comes from SWARM_* envs; setup milestones each emit `unverified | configured | verified`; automations report `running | needs_setup` from the same runtime preflight used at dispatch; activity counts agents alive in the last 5 min, leads that can take work (status idle or busy), and tasks created in the last 24h; agent_fs reports whether AGENT_FS_API_URL is set, plus the Comb settings (whether Files is on and, when off, what is missing; the browser-facing agent-fs URL, the shared org and drive ids, and the agent-fs user id of the swarm service account); telemetry reports the effective ANONYMIZED_TELEMETRY opt-out state; github reports the GitHub web base (GITHUB_URL) for PR and repo links.",
826
844
  tags: ["Status"],
827
845
  responses: {
828
846
  200: { description: "Status payload", schema: StatusResponseSchema },
@@ -0,0 +1,46 @@
1
+ import type { IncomingMessage } from "node:http";
2
+ import { resolveHttpAuditUserId } from "../be/audit-user";
3
+ import { findUserById } from "../be/users";
4
+ import { can } from "../rbac";
5
+ import { agentFirstPrincipal } from "./request-principal";
6
+
7
+ /**
8
+ * Requester for a new task. Prefer trusted server-side identity: an
9
+ * authenticated request user, or the caller's own ownership-gated task context
10
+ * (`X-Source-Task-Id` / ambient current task), the upstream #939 anti-spoofing
11
+ * behavior.
12
+ *
13
+ * TRUST_BODY_REQUESTED_BY_USER_ID (default ON) accepts a body-supplied
14
+ * `requestedByUserId` as a last resort, only when the caller could not be
15
+ * bound to a user (shared operator key), and only after validating it names a
16
+ * real user. Typical single-tenant deployments share ONE operator key, so
17
+ * without this the UI and API callers can never attribute tasks. Set
18
+ * TRUST_BODY_REQUESTED_BY_USER_ID=false anywhere holders of the shared/global
19
+ * key are NOT all equally trusted: with it on, any such caller can attribute
20
+ * a task to any user.
21
+ *
22
+ * Pass `trustedUserId` when the caller already resolved it.
23
+ *
24
+ * Lives outside `tasks.ts` so route modules can share it without importing the
25
+ * task routes, which would change route registration order (and `openapi.json`).
26
+ */
27
+ export async function resolveTaskRequester(
28
+ req: IncomingMessage,
29
+ myAgentId: string | undefined,
30
+ bodyUserId: string | undefined,
31
+ trustedUserId?: string | null,
32
+ ): Promise<string | undefined> {
33
+ const trusted =
34
+ trustedUserId === undefined ? await resolveHttpAuditUserId(req, myAgentId) : trustedUserId;
35
+ if (trusted) return trusted;
36
+ if (process.env.TRUST_BODY_REQUESTED_BY_USER_ID === "false" || !bodyUserId) return undefined;
37
+ // A worker on the shared key is not the operator: its X-Agent-ID names it, so the body
38
+ // hint is dropped like it is when the worker has a requester of its own.
39
+ const mayAssign = can({
40
+ principal: await agentFirstPrincipal(req, myAgentId),
41
+ verb: "task.requester.assign",
42
+ resource: { kind: "none" },
43
+ source: "http",
44
+ }).allow;
45
+ return mayAssign ? (await findUserById(bodyUserId))?.id : undefined;
46
+ }
package/src/http/tasks.ts CHANGED
@@ -37,6 +37,7 @@ import {
37
37
  updateAgentStatusFromCapacity,
38
38
  updateTaskClaudeSessionId,
39
39
  updateTaskProgress,
40
+ updateTaskTags,
40
41
  updateTaskTitle,
41
42
  updateTaskVcs,
42
43
  } from "../be/db";
@@ -126,6 +127,7 @@ import {
126
127
  SESSION_WRITE_DENIED,
127
128
  sessionAccessFor,
128
129
  } from "./session-access";
130
+ import { resolveTaskRequester } from "./task-requester";
129
131
  import { jsonError, parseBody } from "./utils";
130
132
 
131
133
  // ─── Response Schemas ────────────────────────────────────────────────────────
@@ -854,6 +856,46 @@ const updateTaskTitleRoute = route({
854
856
  rbac: { permission: "task.action.own" },
855
857
  });
856
858
 
859
+ /**
860
+ * Only dashboard presentation tags (`ui:` namespace). Every other tag drives
861
+ * behaviour (classification such as `heartbeat`, routing, follow-ups) and is
862
+ * set by the server, never through this route.
863
+ */
864
+ const TaskTagListSchema = z
865
+ .array(
866
+ z
867
+ .string()
868
+ .regex(/^ui:[a-z0-9][a-z0-9-]{0,60}$/, "Only ui: presentation tags can be changed here"),
869
+ )
870
+ .max(20);
871
+
872
+ const updateTaskTagsRoute = route({
873
+ method: "patch",
874
+ path: "/api/tasks/{id}/tags",
875
+ pattern: ["api", "tasks", null, "tags"],
876
+ session: { taskParam: "id" },
877
+ summary: "Add or remove task tags",
878
+ description:
879
+ "Adds the `add` tags and removes the `remove` tags. A tag in both lists is removed. Only `ui:` presentation tags are accepted (400 otherwise); tags that drive behaviour are server-owned. The dashboard uses `ui:dismissed` to hide a failed task from Home's Needs you. Does not change `lastUpdatedAt`.",
880
+ tags: ["Tasks"],
881
+ params: z.object({ id: z.string() }),
882
+ body: z
883
+ .object({
884
+ add: TaskTagListSchema.optional(),
885
+ remove: TaskTagListSchema.optional(),
886
+ })
887
+ .refine((body) => (body.add?.length ?? 0) + (body.remove?.length ?? 0) > 0, {
888
+ message: "Give at least one tag to add or remove",
889
+ }),
890
+ responses: {
891
+ 200: { description: "Tags updated", schema: z.object({ task: AgentTaskSchema }) },
892
+ 403: { description: "Task belongs to another user" },
893
+ 404: { description: "Task not found" },
894
+ },
895
+ auth: { apiKey: true },
896
+ rbac: { permission: "task.action.own" },
897
+ });
898
+
857
899
  async function canSteerTask(
858
900
  req: IncomingMessage,
859
901
  myAgentId: string | undefined,
@@ -950,43 +992,7 @@ async function deniesForeignContext(req: IncomingMessage, contextKey: string): P
950
992
  return false;
951
993
  }
952
994
 
953
- /**
954
- * Requester for a new task. Prefer trusted server-side identity: an
955
- * authenticated request user, or the caller's own ownership-gated task context
956
- * (`X-Source-Task-Id` / ambient current task), the upstream #939 anti-spoofing
957
- * behavior.
958
- *
959
- * TRUST_BODY_REQUESTED_BY_USER_ID (default ON) accepts a body-supplied
960
- * `requestedByUserId` as a last resort, only when the caller could not be
961
- * bound to a user (shared operator key), and only after validating it names a
962
- * real user. Typical single-tenant deployments share ONE operator key, so
963
- * without this the UI and API callers can never attribute tasks. Set
964
- * TRUST_BODY_REQUESTED_BY_USER_ID=false anywhere holders of the shared/global
965
- * key are NOT all equally trusted: with it on, any such caller can attribute
966
- * a task to any user.
967
- *
968
- * Pass `trustedUserId` when the caller already resolved it.
969
- */
970
- export async function resolveTaskRequester(
971
- req: IncomingMessage,
972
- myAgentId: string | undefined,
973
- bodyUserId: string | undefined,
974
- trustedUserId?: string | null,
975
- ): Promise<string | undefined> {
976
- const trusted =
977
- trustedUserId === undefined ? await resolveHttpAuditUserId(req, myAgentId) : trustedUserId;
978
- if (trusted) return trusted;
979
- if (process.env.TRUST_BODY_REQUESTED_BY_USER_ID === "false" || !bodyUserId) return undefined;
980
- // A worker on the shared key is not the operator: its X-Agent-ID names it, so the body
981
- // hint is dropped like it is when the worker has a requester of its own.
982
- const mayAssign = can({
983
- principal: await resolveTaskWritePrincipal(req, myAgentId),
984
- verb: "task.requester.assign",
985
- resource: { kind: "none" },
986
- source: "http",
987
- }).allow;
988
- return mayAssign ? (await findUserById(bodyUserId))?.id : undefined;
989
- }
995
+ export { resolveTaskRequester };
990
996
 
991
997
  // ─── Handler ─────────────────────────────────────────────────────────────────
992
998
 
@@ -2114,6 +2120,27 @@ export async function handleTasks(
2114
2120
  return true;
2115
2121
  }
2116
2122
 
2123
+ if (updateTaskTagsRoute.match(req.method, pathSegments)) {
2124
+ const parsed = await updateTaskTagsRoute.parse(req, res, pathSegments, queryParams);
2125
+ if (!parsed) return true;
2126
+ const existing = await getTaskById(parsed.params.id);
2127
+ if (!existing) {
2128
+ jsonError(res, "Task not found", 404);
2129
+ return true;
2130
+ }
2131
+ if (await deniesNonOwnerTaskWrite(req, existing)) {
2132
+ jsonError(res, NOT_YOUR_TASK_DENIED, 403);
2133
+ return true;
2134
+ }
2135
+ const task = await updateTaskTags(parsed.params.id, parsed.body);
2136
+ if (!task) {
2137
+ jsonError(res, "Task not found", 404);
2138
+ return true;
2139
+ }
2140
+ updateTaskTagsRoute.respond(res, 200, { task });
2141
+ return true;
2142
+ }
2143
+
2117
2144
  if (resumeTaskRoute.match(req.method, pathSegments)) {
2118
2145
  const parsed = await resumeTaskRoute.parse(req, res, pathSegments, queryParams);
2119
2146
  if (!parsed) return true;
package/src/http/users.ts CHANGED
@@ -30,6 +30,7 @@
30
30
 
31
31
  import type { IncomingMessage, ServerResponse } from "node:http";
32
32
  import { z } from "zod";
33
+ import { ensureUserAgentFsAccount } from "../be/agent-fs-user-keys";
33
34
  import {
34
35
  createConnectorCode,
35
36
  DEFAULT_CONNECTOR_CODE_LABEL,
@@ -77,6 +78,7 @@ import { UserCommsPrefsSchema, UserSchema } from "../types";
77
78
  import { DEFAULT_APP_URL } from "../utils/constants";
78
79
  import { assertUrlSafe } from "../utils/egress-guard";
79
80
  import { authUser, getRequestAuth } from "../utils/request-auth-context";
81
+ import { scrubSecrets } from "../utils/secret-scrubber";
80
82
  import { resolveAppUrl, resolveMcpBaseUrl } from "./config-values";
81
83
  import { clientIp, createIpRateLimiter } from "./ip-rate-limit";
82
84
  import { getOperatorActor } from "./operator-actor";
@@ -1286,6 +1288,18 @@ export async function handleUsers(
1286
1288
  jsonError(res, "code_invalid", 404);
1287
1289
  return true;
1288
1290
  }
1291
+ // No transaction is open here, so afterCommit only defers the call (fire and forget).
1292
+ getDbClient().afterCommit(async () => {
1293
+ try {
1294
+ await ensureUserAgentFsAccount(result.userId);
1295
+ } catch (error) {
1296
+ console.warn(
1297
+ scrubSecrets(
1298
+ `[agent-fs] invite account ensure failed: ${error instanceof Error ? error.message : String(error)}`,
1299
+ ),
1300
+ );
1301
+ }
1302
+ });
1289
1303
  exchangeInviteCodeRoute.respond(res, 200, result);
1290
1304
  } catch {
1291
1305
  jsonError(res, "Failed to exchange code", 500);
@@ -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
+ }