@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
@@ -5,6 +5,7 @@ import { resolveTemplate } from "../prompts/resolver";
5
5
  import { githubContextKey } from "../tasks/context-key";
6
6
  import { createTaskWithSiblingAwareness } from "../tasks/sibling-awareness";
7
7
  import { parseEnvFlag } from "../utils/env-flag";
8
+ import { getGitHubGraphqlUrl, githubApiUrl } from "../utils/github-host";
8
9
  import { getInstallationToken } from "./app";
9
10
  import {
10
11
  detectMention,
@@ -1056,7 +1057,9 @@ async function fetchReviewScopedComments(
1056
1057
  reviewId: number,
1057
1058
  headers: Record<string, string>,
1058
1059
  ): Promise<FetchReviewCommentsResult> {
1059
- const url = `https://api.github.com/repos/${repo}/pulls/${prNumber}/reviews/${reviewId}/comments?per_page=100`;
1060
+ const url = githubApiUrl(
1061
+ `/repos/${repo}/pulls/${prNumber}/reviews/${reviewId}/comments?per_page=100`,
1062
+ );
1060
1063
 
1061
1064
  let result = await fetchPaginatedReviewComments(url, headers);
1062
1065
  if (result.degraded || result.comments.length > 0) {
@@ -1080,7 +1083,7 @@ async function fetchPrLevelReviewComments(
1080
1083
  reviewId: number,
1081
1084
  headers: Record<string, string>,
1082
1085
  ): Promise<FetchReviewCommentsResult> {
1083
- const url = `https://api.github.com/repos/${repo}/pulls/${prNumber}/comments?per_page=100`;
1086
+ const url = githubApiUrl(`/repos/${repo}/pulls/${prNumber}/comments?per_page=100`);
1084
1087
  const result = await fetchPaginatedReviewComments(url, headers);
1085
1088
  return {
1086
1089
  comments: result.comments.filter((comment) => comment.pull_request_review_id === reviewId),
@@ -1208,7 +1211,7 @@ async function fetchPrReviewActionCounts(
1208
1211
  if (!token || !owner || !name) return null;
1209
1212
 
1210
1213
  try {
1211
- const response = await fetch("https://api.github.com/graphql", {
1214
+ const response = await fetch(getGitHubGraphqlUrl(), {
1212
1215
  method: "POST",
1213
1216
  headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
1214
1217
  body: JSON.stringify({
@@ -1,3 +1,4 @@
1
+ import { getGitHubGraphqlUrl, githubApiUrl } from "../utils/github-host";
1
2
  import { scrubSecrets } from "../utils/secret-scrubber";
2
3
  import { getInstallationToken, isReactionsEnabled } from "./app";
3
4
 
@@ -54,7 +55,7 @@ async function postRestReaction(
54
55
  if (!token) return false;
55
56
 
56
57
  try {
57
- const response = await fetch(`https://api.github.com/repos/${repo}/${target}/reactions`, {
58
+ const response = await fetch(githubApiUrl(`/repos/${repo}/${target}/reactions`), {
58
59
  method: "POST",
59
60
  headers: {
60
61
  Accept: "application/vnd.github+json",
@@ -157,7 +158,7 @@ export async function addGraphQLReaction(
157
158
  if (!token) return false;
158
159
 
159
160
  try {
160
- const response = await fetch("https://api.github.com/graphql", {
161
+ const response = await fetch(getGitHubGraphqlUrl(), {
161
162
  method: "POST",
162
163
  headers: {
163
164
  Authorization: `Bearer ${token}`,
@@ -224,19 +225,16 @@ export async function postComment(
224
225
  }
225
226
 
226
227
  try {
227
- const response = await fetch(
228
- `https://api.github.com/repos/${repo}/issues/${issueNumber}/comments`,
229
- {
230
- method: "POST",
231
- headers: {
232
- Accept: "application/vnd.github+json",
233
- Authorization: `Bearer ${token}`,
234
- "X-GitHub-Api-Version": "2022-11-28",
235
- "Content-Type": "application/json",
236
- },
237
- body: JSON.stringify({ body }),
228
+ const response = await fetch(githubApiUrl(`/repos/${repo}/issues/${issueNumber}/comments`), {
229
+ method: "POST",
230
+ headers: {
231
+ Accept: "application/vnd.github+json",
232
+ Authorization: `Bearer ${token}`,
233
+ "X-GitHub-Api-Version": "2022-11-28",
234
+ "Content-Type": "application/json",
238
235
  },
239
- );
236
+ body: JSON.stringify({ body }),
237
+ });
240
238
 
241
239
  if (!response.ok) {
242
240
  const errorText = await response.text();
@@ -138,9 +138,14 @@ function defaultIntervalMs(): number {
138
138
  return parseHeartbeatIntervalMs(process.env.HEARTBEAT_INTERVAL_MS);
139
139
  }
140
140
 
141
- /** Stall threshold: tasks with fresh worker heartbeat but no task update for this many minutes */
141
+ /**
142
+ * Stall threshold: tasks with fresh worker heartbeat but no task update for
143
+ * this many minutes. A positive integer, or 30: `Number(value) || 30` kept a
144
+ * negative threshold, which flagged every recently updated task (#2835).
145
+ */
142
146
  function stallThresholdMinutes(): number {
143
- return Number(process.env.HEARTBEAT_STALL_THRESHOLD_MIN) || 30;
147
+ const value = Number(process.env.HEARTBEAT_STALL_THRESHOLD_MIN);
148
+ return Number.isInteger(value) && value > 0 ? value : 30;
144
149
  }
145
150
 
146
151
  /** Stall threshold: tasks with no active session (worker clearly dead) */
@@ -169,9 +174,14 @@ const STALE_CLEANUP_THRESHOLD_MINUTES = Number(process.env.HEARTBEAT_STALE_CLEAN
169
174
  */
170
175
  const DRAFT_TASK_TIMEOUT_MINUTES = Number(process.env.HEARTBEAT_DRAFT_TASK_TIMEOUT_MIN) || 5;
171
176
 
172
- /** Max crash-recovery resume generations before failing for lead triage */
177
+ /**
178
+ * Max crash-recovery resume generations before failing for lead triage: a
179
+ * positive integer, or 3. `Number(value) || 3` kept a negative limit, which
180
+ * exhausted the budget before the first resume (#2834).
181
+ */
173
182
  export function maxResumeGenerations(): number {
174
- return Number(process.env.HEARTBEAT_MAX_RESUME_GENERATIONS) || 3;
183
+ const value = Number(process.env.HEARTBEAT_MAX_RESUME_GENERATIONS);
184
+ return Number.isInteger(value) && value > 0 ? value : 3;
175
185
  }
176
186
 
177
187
  export const RESUME_BUDGET_EXHAUSTED_REASON = "resume_budget_exhausted";
@@ -51,6 +51,7 @@ import {
51
51
  upsertRuntimeInstance,
52
52
  } from "../be/multi-runtime";
53
53
  import { getPoolForAgent, resolvePoolDelivery } from "../be/runtime-pools/db";
54
+ import { isAgentOnDemand } from "../be/runtime-pools/reachability";
54
55
  import { ACP_TARGET_IDS } from "../providers/acp-target-catalog";
55
56
  import { reasoningCapability } from "../providers/reasoning-effort";
56
57
  import { ALL_CAPABILITIES, getEnabledCapabilities } from "../server";
@@ -382,8 +383,22 @@ async function resolveListClaudeTransports(
382
383
  /** List/detail rows carry the effective Claude transport so the dashboard can flag SDK agents. */
383
384
  const AgentListItemSchema = AgentWithCapacityAndTasksSchema.extend({
384
385
  claudeTransport: ClaudeTransportSchema.optional(),
386
+ /** Offline, but its runtime pool starts a runtime when a task is sent (`isAgentOnDemand`). */
387
+ onDemand: z.boolean().optional(),
385
388
  });
386
389
 
390
+ /** The list/detail extras: effective Claude transport and the on-demand flag, when set. */
391
+ async function withListExtras<T extends Agent>(
392
+ agent: T,
393
+ claudeTransport: ClaudeTransport | undefined,
394
+ ): Promise<T & { claudeTransport?: ClaudeTransport; onDemand?: true }> {
395
+ return {
396
+ ...agent,
397
+ ...(claudeTransport ? { claudeTransport } : {}),
398
+ ...((await isAgentOnDemand(agent)) ? { onDemand: true as const } : {}),
399
+ };
400
+ }
401
+
387
402
  /**
388
403
  * The agents whose name, role or id contains `q` (case-insensitive), at most
389
404
  * `limit` of them. A swarm has tens of agents, so filtering loaded rows is cheap.
@@ -919,10 +934,9 @@ export async function handleAgentsRest(
919
934
  resolveListClaudeTransports(agents),
920
935
  ]);
921
936
  listAgents.respond(res, 200, {
922
- agents: agentsWithCapacity.map((agent) => {
923
- const claudeTransport = transports.get(agent.id);
924
- return claudeTransport ? { ...agent, claudeTransport } : agent;
925
- }),
937
+ agents: await Promise.all(
938
+ agentsWithCapacity.map((agent) => withListExtras(agent, transports.get(agent.id))),
939
+ ),
926
940
  });
927
941
  return true;
928
942
  }
@@ -1649,12 +1663,7 @@ export async function handleAgentsRest(
1649
1663
  agentWithCapacity(agent),
1650
1664
  resolveListClaudeTransports([agent]),
1651
1665
  ]);
1652
- const claudeTransport = transports.get(agent.id);
1653
- getAgent.respond(
1654
- res,
1655
- 200,
1656
- claudeTransport ? { ...agentWithCap, claudeTransport } : agentWithCap,
1657
- );
1666
+ getAgent.respond(res, 200, await withListExtras(agentWithCap, transports.get(agent.id)));
1658
1667
  return true;
1659
1668
  }
1660
1669
 
@@ -28,6 +28,7 @@ import "./api-keys";
28
28
  import "./events";
29
29
  import "./extensions";
30
30
  import "./favorites";
31
+ import "./checklist";
31
32
  import "./fs";
32
33
  import "./heartbeat";
33
34
  import "./inbox-state";
@@ -60,6 +61,7 @@ import "./savings";
60
61
  import "./savings-calibration";
61
62
  import "./sessions";
62
63
  import "./skills";
64
+ import "./slack-events";
63
65
  import "./slack-inbound";
64
66
  import "./scripts";
65
67
  import "./mcp-bridge";
@@ -180,7 +180,15 @@ const ApprovalRequestSummarySchema = ApprovalRequestSchema.omit({
180
180
  resolutionReason: true,
181
181
  notificationChannels: true,
182
182
  configState: true,
183
- }).extend({ questionCount: z.number().int() });
183
+ }).extend({
184
+ questionCount: z.number().int(),
185
+ viewerCanRespond: z
186
+ .boolean()
187
+ .optional()
188
+ .describe(
189
+ "Pending rows only: whether the caller may answer, by the same rule as the respond route (a listed user or role, or no users and roles listed).",
190
+ ),
191
+ });
184
192
 
185
193
  /**
186
194
  * Reshapes a DB `ApprovalRequest` row for `respond()` — identical values,
@@ -209,9 +217,13 @@ async function toApprovalRequestResponse(
209
217
  };
210
218
  }
211
219
 
212
- /** Slim rows plus `approvalProgress` for the pending ones (one extra read). */
220
+ /**
221
+ * Slim rows plus `approvalProgress` and `viewerCanRespond` for the pending ones
222
+ * (one extra read). `viewer` is null when the caller cannot answer any request.
223
+ */
213
224
  async function withApprovalProgress(
214
225
  rows: Awaited<ReturnType<typeof listApprovalRequestSummaries>>,
226
+ viewer: ApprovalResponder | null,
215
227
  ): Promise<z.infer<typeof ApprovalRequestSummarySchema>[]> {
216
228
  const pendingIds = rows.filter((row) => row.status === "pending").map((row) => row.id);
217
229
  const state = new Map(
@@ -225,6 +237,10 @@ async function withApprovalProgress(
225
237
  approvalProgress: entry
226
238
  ? await approvalProgress(entry.approvers as ApproversShape, entry.approvals ?? [])
227
239
  : null,
240
+ ...(entry && {
241
+ viewerCanRespond:
242
+ viewer !== null && isListedApprover(entry.approvers as ApproversShape, viewer),
243
+ }),
228
244
  };
229
245
  }),
230
246
  );
@@ -490,7 +506,7 @@ const listRoute = route({
490
506
  pattern: ["api", "approval-requests"],
491
507
  summary: "List approval requests with optional filters",
492
508
  description:
493
- "Returns full approval requests by default. Pass `fields=slim` for the list-view shape: `questions`, `approvers`, `responses`, `resolutionReason` and `notificationChannels` are dropped and `questionCount` is added. Fetch one request in full via `GET /api/approval-requests/{id}`.",
509
+ "Returns full approval requests by default. Pass `fields=slim` for the list-view shape: `questions`, `approvers`, `responses`, `resolutionReason` and `notificationChannels` are dropped and `questionCount` is added, plus `viewerCanRespond` on pending rows. Fetch one request in full via `GET /api/approval-requests/{id}`.",
494
510
  tags: ["ApprovalRequests"],
495
511
  query: z.object({
496
512
  status: z.string().optional(),
@@ -890,8 +906,12 @@ export async function handleApprovalRequests(
890
906
  };
891
907
  // Opt-in: API, MCP and script callers that don't ask keep the full rows.
892
908
  if (parsed.query.fields === "slim") {
909
+ const viewer = await approvalResponder(req);
893
910
  listRoute.respond(res, 200, {
894
- approvalRequests: await withApprovalProgress(await listApprovalRequestSummaries(filters)),
911
+ approvalRequests: await withApprovalProgress(
912
+ await listApprovalRequestSummaries(filters),
913
+ viewer.ok ? viewer.responder : null,
914
+ ),
895
915
  });
896
916
  return true;
897
917
  }
package/src/http/apps.ts CHANGED
@@ -65,6 +65,7 @@ import {
65
65
  import { getAgentById, getAppVersion, getAppVersions, getTaskById } from "../be/db";
66
66
  import type { RbacResource } from "../rbac";
67
67
  import { can } from "../rbac";
68
+ import { APP_SESSION_KEY_PATTERN, appSessionContextKey } from "../tasks/context-key";
68
69
  import { AgentTaskStatusSchema, AppIconSchema } from "../types";
69
70
  import { getRequestAuth } from "../utils/request-auth-context";
70
71
  import { scrubObject } from "../utils/secret-scrubber";
@@ -72,6 +73,7 @@ import { resolveHttpFavoriteOwner } from "./favorite-owner";
72
73
  import { agentFirstPrincipal, authUser, authUserId, requestPrincipal } from "./request-principal";
73
74
  import { bodyTask, route } from "./route-def";
74
75
  import { denyParentAttach } from "./session-access";
76
+ import { resolveTaskRequester } from "./task-requester";
75
77
  import { BODY_TOO_LARGE, enforceContentLengthCap, json, jsonError } from "./utils";
76
78
 
77
79
  const MAX_APP_BODY_BYTES = 5 * 1024 * 1024;
@@ -638,6 +640,36 @@ const runActionRoute = route({
638
640
  input: z.record(z.string(), z.unknown()).optional(),
639
641
  /** Chains the new task off an existing one. Task-kind actions only: a script or sync action rejects it (400). */
640
642
  parentTaskId: z.string().min(1).optional(),
643
+ /**
644
+ * `false`: no Lead follow-up (review) task when the created task finishes
645
+ * (`followUpConfig.disabled`). A json-render `SessionThread` sends it, so
646
+ * the chat stays one task per message. Script and sync actions create no
647
+ * task and ignore it, so a generic caller may always send it.
648
+ */
649
+ followUp: z.boolean().optional(),
650
+ /**
651
+ * The person the task is for, when the caller is the shared operator key
652
+ * (the dashboard's picked identity). Resolved like `POST /api/tasks`: a
653
+ * caller bound to a user always wins, and the hint is honored only when
654
+ * the caller may assign requesters.
655
+ */
656
+ requestedByUserId: z.string().min(1).optional(),
657
+ /**
658
+ * A json-render `SessionThread` session. The server builds the task's
659
+ * `contextKey` (`task:app:<appId>:<key>:user:<requester>`) from this
660
+ * app's id, the key and the resolved requester; a raw `contextKey` is
661
+ * never taken from the client. Scope `user` needs a requesting user.
662
+ * Scope `shared` is reserved: it answers 400 until shared sessions land
663
+ * (planned: an everyone:write `session_shares` row on the root). A
664
+ * follow-up (`parentTaskId`) inherits its parent's key instead. Script
665
+ * and sync actions ignore it.
666
+ */
667
+ session: z
668
+ .object({
669
+ key: z.string().regex(APP_SESSION_KEY_PATTERN),
670
+ scope: z.enum(["user", "shared"]).optional(),
671
+ })
672
+ .optional(),
641
673
  }),
642
674
  responses: {
643
675
  200: { description: "Action invoked", schema: runActionResultSchema },
@@ -1403,15 +1435,15 @@ export async function handleApps(
1403
1435
  return true;
1404
1436
  }
1405
1437
  if (definitionNeedsRepair(res, app)) return true;
1438
+ const actions = app.definition.actions;
1439
+ const action =
1440
+ actions && Object.hasOwn(actions, parsed.params.name)
1441
+ ? actions[parsed.params.name]
1442
+ : undefined;
1406
1443
  if (parsed.body.parentTaskId) {
1407
1444
  // `parentTaskId` only means something to a task-kind action: a script or
1408
1445
  // sync action rejects it rather than silently dropping it. An unknown
1409
1446
  // action keeps `runAppAction`'s 404.
1410
- const actions = app.definition.actions;
1411
- const action =
1412
- actions && Object.hasOwn(actions, parsed.params.name)
1413
- ? actions[parsed.params.name]
1414
- : undefined;
1415
1447
  if (action && action.kind !== "task") {
1416
1448
  jsonError(res, "parentTaskId is only supported for task-kind actions", 400);
1417
1449
  return true;
@@ -1428,11 +1460,43 @@ export async function handleApps(
1428
1460
  if (await denyParentAttach(req, res, myAgentId, parentTask, principal)) return true;
1429
1461
  }
1430
1462
  }
1463
+ // Only a task-kind action creates a task to attribute and key.
1464
+ const requestedByUserId =
1465
+ action?.kind === "task"
1466
+ ? await resolveTaskRequester(req, myAgentId, parsed.body.requestedByUserId)
1467
+ : undefined;
1468
+ let contextKey: string | undefined;
1469
+ const session = parsed.body.session;
1470
+ if (session && action?.kind === "task") {
1471
+ if (session.scope === "shared") {
1472
+ jsonError(res, 'session scope "shared" is not supported yet', 400);
1473
+ return true;
1474
+ }
1475
+ if (!requestedByUserId) {
1476
+ jsonError(
1477
+ res,
1478
+ "A user-scoped session needs a requesting user: sign in or pick an identity",
1479
+ 400,
1480
+ );
1481
+ return true;
1482
+ }
1483
+ // A follow-up joins its parent's chain and inherits the parent's key.
1484
+ if (!parsed.body.parentTaskId) {
1485
+ contextKey = appSessionContextKey({
1486
+ appId: app.id,
1487
+ sessionKey: session.key,
1488
+ userId: requestedByUserId,
1489
+ });
1490
+ }
1491
+ }
1431
1492
  const output = await runAppAction({
1432
1493
  app,
1433
1494
  name: parsed.params.name,
1434
1495
  input: parsed.body.input,
1435
1496
  parentTaskId: parsed.body.parentTaskId,
1497
+ followUp: parsed.body.followUp,
1498
+ requestedByUserId,
1499
+ contextKey,
1436
1500
  caller,
1437
1501
  actor,
1438
1502
  });
@@ -0,0 +1,176 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import { z } from "zod";
3
+ import {
4
+ ChecklistError,
5
+ listChecklist,
6
+ mutateChecklist,
7
+ userGrantCanEditSwarm,
8
+ } from "../be/checklist";
9
+ import { can } from "../rbac";
10
+ import { ChecklistItemSchema } from "../types";
11
+ import { resolveHttpFavoriteOwner } from "./favorite-owner";
12
+ import { resolveRequestPrincipal } from "./request-principal";
13
+ import { route } from "./route-def";
14
+ import { jsonError } from "./utils";
15
+
16
+ const getChecklist = route({
17
+ method: "get",
18
+ path: "/api/checklist",
19
+ pattern: ["api", "checklist"],
20
+ summary: "Read the post-onboarding checklist",
21
+ tags: ["Checklist"],
22
+ responses: {
23
+ 200: {
24
+ description: "Checklist items and swarm edit permission",
25
+ schema: z.object({ items: z.array(ChecklistItemSchema), canEditSwarm: z.boolean() }),
26
+ },
27
+ },
28
+ });
29
+
30
+ const addChecklistItem = route({
31
+ method: "post",
32
+ path: "/api/checklist/items",
33
+ pattern: ["api", "checklist", "items"],
34
+ summary: "Add a checklist item",
35
+ tags: ["Checklist"],
36
+ rbac: { permission: "checklist.write.own" },
37
+ body: z.object({
38
+ kind: z.enum(["channel", "tool", "use_case", "custom"]),
39
+ label: z.string().min(1).max(200),
40
+ // An in-app path only: the dashboard renders it as a router link.
41
+ href: z
42
+ .string()
43
+ .max(500)
44
+ .regex(/^\/(?!\/)/, "href must be an in-app path starting with /")
45
+ .optional(),
46
+ scope: z.enum(["swarm", "user"]),
47
+ // The dashboard sends `{ adapter }` for a channel item. The size cap keeps
48
+ // free-form meta from the Lead small.
49
+ meta: z
50
+ .looseObject({ adapter: z.string().min(1).max(64).optional() })
51
+ .refine((meta) => JSON.stringify(meta).length <= 1024, {
52
+ message: "meta must be at most 1024 characters as JSON",
53
+ })
54
+ .optional(),
55
+ }),
56
+ responses: {
57
+ 201: { description: "Added checklist item", schema: z.object({ item: ChecklistItemSchema }) },
58
+ 400: { description: "A user is required for user items" },
59
+ 403: { description: "The caller cannot edit swarm items" },
60
+ 409: { description: "An open channel item for the same adapter already exists" },
61
+ },
62
+ });
63
+
64
+ const patchChecklistItem = route({
65
+ method: "patch",
66
+ path: "/api/checklist/items/{id}",
67
+ pattern: ["api", "checklist", "items", null],
68
+ summary: "Update a checklist item",
69
+ tags: ["Checklist"],
70
+ rbac: { permission: "checklist.write.own" },
71
+ params: z.object({ id: z.string() }),
72
+ body: z
73
+ .object({
74
+ action: z.enum(["remove", "restore", "done", "reorder"]),
75
+ reason: z.string().max(500).optional(),
76
+ sortOrder: z.number().int().optional(),
77
+ })
78
+ .refine((body) => body.action !== "reorder" || body.sortOrder !== undefined, {
79
+ message: "Reorder requires sortOrder",
80
+ path: ["sortOrder"],
81
+ }),
82
+ responses: {
83
+ 200: { description: "Updated checklist item", schema: z.object({ item: ChecklistItemSchema }) },
84
+ 400: { description: "Invalid update" },
85
+ 403: { description: "The caller cannot edit this item" },
86
+ 404: { description: "Checklist item not found" },
87
+ },
88
+ });
89
+
90
+ function decodePathId(raw: string): string {
91
+ try {
92
+ return decodeURIComponent(raw);
93
+ } catch {
94
+ return raw;
95
+ }
96
+ }
97
+
98
+ export async function handleChecklist(
99
+ req: IncomingMessage,
100
+ res: ServerResponse,
101
+ pathSegments: string[],
102
+ queryParams: URLSearchParams,
103
+ myAgentId: string | undefined,
104
+ ): Promise<boolean> {
105
+ if (
106
+ !getChecklist.match(req.method, pathSegments) &&
107
+ !addChecklistItem.match(req.method, pathSegments) &&
108
+ !patchChecklistItem.match(req.method, pathSegments)
109
+ )
110
+ return false;
111
+ const owner = await resolveHttpFavoriteOwner(req, myAgentId);
112
+ if (!owner) {
113
+ jsonError(res, "An authenticated principal is required", 401);
114
+ return true;
115
+ }
116
+ const principal = await resolveRequestPrincipal(req, myAgentId, { precedence: "agent-first" });
117
+ if (!principal) {
118
+ jsonError(res, "An authenticated principal is required", 401);
119
+ return true;
120
+ }
121
+ // Agents act on the checklist only as the Lead.
122
+ if (
123
+ principal.kind === "agent" &&
124
+ !getChecklist.match(req.method, pathSegments) &&
125
+ !can({ principal, verb: "checklist.write.agent", resource: { kind: "none" }, source: "http" })
126
+ .allow
127
+ ) {
128
+ jsonError(res, "Only the Lead agent can change the checklist", 403);
129
+ return true;
130
+ }
131
+ // The dashboard's selected user has the same grants as that user's token.
132
+ // Role rows count only with RBAC on; off, the legacy policy decides.
133
+ const grantAllows =
134
+ principal.kind !== "agent" && owner.userId ? await userGrantCanEditSwarm(owner.userId) : null;
135
+ const canEditSwarm =
136
+ grantAllows ??
137
+ (principal.kind === "operator" ||
138
+ can({ principal, verb: "config.write.any", resource: { kind: "none" }, source: "http" })
139
+ .allow);
140
+ const actor = {
141
+ id: principal.kind === "agent" ? `lead:${principal.agentId}` : owner.actorId,
142
+ userId: owner.userId,
143
+ canEditSwarm,
144
+ };
145
+ try {
146
+ if (getChecklist.match(req.method, pathSegments)) {
147
+ const parsed = await getChecklist.parse(req, res, pathSegments, queryParams);
148
+ if (!parsed) return true;
149
+ getChecklist.respond(res, 200, {
150
+ items: await listChecklist(owner.userId, canEditSwarm),
151
+ canEditSwarm,
152
+ });
153
+ } else if (addChecklistItem.match(req.method, pathSegments)) {
154
+ const parsed = await addChecklistItem.parse(req, res, pathSegments, queryParams);
155
+ if (!parsed) return true;
156
+ addChecklistItem.respond(res, 201, {
157
+ item: await mutateChecklist(actor, { action: "add", ...parsed.body }),
158
+ });
159
+ } else {
160
+ const parsed = await patchChecklistItem.parse(req, res, pathSegments, queryParams);
161
+ if (!parsed) return true;
162
+ const { action, sortOrder, reason } = parsed.body;
163
+ // Path segments arrive raw, and ids hold colons (`swarm:tool`) that clients may encode.
164
+ const id = decodePathId(parsed.params.id);
165
+ const item = await mutateChecklist(
166
+ actor,
167
+ action === "reorder" ? { action, id, sortOrder: sortOrder! } : { action, id, reason },
168
+ );
169
+ patchChecklistItem.respond(res, 200, { item });
170
+ }
171
+ } catch (error) {
172
+ if (!(error instanceof ChecklistError)) throw error;
173
+ jsonError(res, error.message, error.status);
174
+ }
175
+ return true;
176
+ }