@desplega.ai/agent-swarm 2.8.3 → 2.9.1

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 (597) hide show
  1. package/dist/acp-adapter-g909b5hw.js +16 -0
  2. package/dist/acp-targets-ny75x1qy.js +23 -0
  3. package/dist/{actions-ewz7bp4g.js → actions-b9qgrmeq.js} +82 -21
  4. package/dist/agent-fs-provision-b5dhdsbd.js +27 -0
  5. package/dist/{amp-adapter-f25tqhnf.js → amp-adapter-vtax2c9s.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-r5xf5hqw.js} +37 -37
  7. package/dist/{app-mkptw0k7.js → app-g2z15hax.js} +9 -4
  8. package/dist/approval-notifications-yt13wp8r.js +23 -0
  9. package/dist/{assistant-c47rfe77.js → assistant-2cgfxsgk.js} +56 -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-3gwy0f60.js} +1 -1
  12. package/dist/{boot-reembed-htr73hbs.js → boot-reembed-92g7s5zp.js} +1 -1
  13. package/dist/{boot-reembed-1ghy2sab.js → boot-reembed-mywmyp4s.js} +1 -1
  14. package/dist/{boot-scrub-sweep-yrytg42z.js → boot-scrub-sweep-7dkdzqxx.js} +84 -13
  15. package/dist/{boot-seeds-n2b3dx4e.js → boot-seeds-ce7rvgq1.js} +4 -4
  16. package/dist/{boxd-jmfqgkqa.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-3m4q7735.js +28 -0
  18. package/dist/{claude-managed-adapter-hddmxjyj.js → claude-managed-adapter-t8nfgcgz.js} +4 -4
  19. package/dist/{claude-managed-setup-hfvry1bd.js → claude-managed-setup-c217draw.js} +10 -10
  20. package/dist/{claude-sdk-session-0hamqzc7.js → claude-sdk-session-7fbqm51z.js} +9386 -9196
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-sdvcrq5x.js → cli-1jykg0py.js} +18 -14
  23. package/dist/{cli-k96cecs7.js → cli-2czxfnvj.js} +1221 -357
  24. package/dist/{cli-qmqt520k.js → cli-2dq9yv8p.js} +2 -2
  25. package/dist/{cli-e2w34h6z.js → cli-2xs8tsf7.js} +132 -85
  26. package/dist/{cli-z8cvws4c.js → cli-2yjj3e31.js} +907 -56
  27. package/dist/{cli-mdpbjnzq.js → cli-32djehja.js} +42 -42
  28. package/dist/{cli-gpz1d0t2.js → cli-3j873zxq.js} +4 -4
  29. package/dist/cli-43ms35q9.js +270 -0
  30. package/dist/cli-47hz21se.js +25584 -0
  31. package/dist/{cli-n515ex5z.js → cli-4ymxrwg5.js} +16 -16
  32. package/dist/{cli-f1kwb5fc.js → cli-5a6pqy45.js} +333 -21
  33. package/dist/{cli-93t5s4zq.js → cli-5gpqgs8b.js} +2 -2
  34. package/dist/{cli-15204js0.js → cli-6237rnyr.js} +1 -1
  35. package/dist/{cli-4ax9mvvg.js → cli-67mwzr35.js} +9 -9
  36. package/dist/{cli-t5ys4ebm.js → cli-6945ywhr.js} +3 -3
  37. package/dist/{cli-0bcgyj5b.js → cli-6ehs4mta.js} +87 -8
  38. package/dist/{cli-6yygkr0w.js → cli-6ym4jhzp.js} +15 -7
  39. package/dist/{cli-8bpgbr8k.js → cli-7evph51z.js} +5 -5
  40. package/dist/{cli-dtdht77h.js → cli-7mv4h3sn.js} +2 -2
  41. package/dist/{cli-nx2n3z6p.js → cli-7sf9sb0w.js} +3 -2
  42. package/dist/{cli-pe4d96rb.js → cli-7zm3b3f5.js} +1 -1
  43. package/dist/cli-8zh9nrew.js +78 -0
  44. package/dist/cli-9ttx00s3.js +137 -0
  45. package/dist/{cli-x6t50dmw.js → cli-9w8712tq.js} +620 -281
  46. package/dist/{cli-8476gtwf.js → cli-b6px1k1q.js} +1 -1
  47. package/dist/{cli-k2rw11py.js → cli-b91nz213.js} +5 -5
  48. package/dist/{cli-7c5tgqhf.js → cli-bg63qmsx.js} +10 -10
  49. package/dist/{cli-qps8je6j.js → cli-bkjdknnp.js} +54 -10
  50. package/dist/{cli-gn9y6fn7.js → cli-bnqncekd.js} +2 -2
  51. package/dist/{cli-s7zz734a.js → cli-br0924pw.js} +1 -1
  52. package/dist/{cli-h9yy18gy.js → cli-ctx0b85j.js} +5484 -5078
  53. package/dist/{cli-0vksaxvr.js → cli-dgs10ttj.js} +2 -2
  54. package/dist/cli-dqgnbnxs.js +132 -0
  55. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  56. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  57. package/dist/{cli-c0xjnr8z.js → cli-f3jyzq4g.js} +2 -2
  58. package/dist/cli-f8x9drqr.js +84 -0
  59. package/dist/{cli-ztq5z4e1.js → cli-f9gz2vyj.js} +6 -6
  60. package/dist/{cli-bhsfbmk8.js → cli-fh97xn30.js} +93 -44
  61. package/dist/cli-fkef327x.js +103 -0
  62. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  63. package/dist/{cli-kd56bmk4.js → cli-gabsjg8x.js} +3 -1
  64. package/dist/{cli-1m96dc36.js → cli-gfy38pvt.js} +3 -3
  65. package/dist/{cli-922z7gwm.js → cli-h9yqfzx9.js} +15 -11
  66. package/dist/{cli-5a7szzfh.js → cli-hnamkvnc.js} +2 -2
  67. package/dist/{cli-c3ng0mb4.js → cli-j7svy295.js} +71 -818
  68. package/dist/{cli-yss07azk.js → cli-jaw5v1sy.js} +3 -3
  69. package/dist/cli-jkw6ptfw.js +921 -0
  70. package/dist/{cli-s8p8hhty.js → cli-jm0hvmz2.js} +2 -2
  71. package/dist/{cli-knva3nmx.js → cli-jwampxxq.js} +8 -6
  72. package/dist/cli-kj0hyr43.js +51 -0
  73. package/dist/{cli-tnzebztn.js → cli-kpgcm7xy.js} +13 -1
  74. package/dist/{cli-9zmb7ptc.js → cli-kxx4k2jw.js} +8 -753
  75. package/dist/{cli-am1ptset.js → cli-m7c2380k.js} +208 -194
  76. package/dist/{cli-kw44j53p.js → cli-m7zvgt57.js} +45 -38
  77. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  78. package/dist/{cli-54qr8mcd.js → cli-mhapr559.js} +4 -4
  79. package/dist/{cli-tf79ryyy.js → cli-mjw0yf82.js} +3 -3
  80. package/dist/{cli-rjvsf9qa.js → cli-mkwkwq81.js} +14 -11
  81. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  82. package/dist/{cli-awwptga4.js → cli-mw620q3n.js} +1 -1
  83. package/dist/{cli-6wj7p986.js → cli-n3qe7tyr.js} +172 -168
  84. package/dist/{cli-4dpkjc2e.js → cli-nafvvsp8.js} +9 -9
  85. package/dist/{cli-sg27rk2t.js → cli-nbt14he0.js} +25 -19
  86. package/dist/{cli-7akn6ze9.js → cli-nh7x3133.js} +7 -28
  87. package/dist/{cli-zdaypkq9.js → cli-p4kckx1z.js} +285 -97
  88. package/dist/{cli-n5t077me.js → cli-pb2ay3sh.js} +10 -3
  89. package/dist/{cli-t4dv07kr.js → cli-psffsanb.js} +4 -3
  90. package/dist/{cli-mwwmka77.js → cli-pyjn0qhk.js} +2712 -268
  91. package/dist/{cli-emekyyhr.js → cli-q2d3e1k1.js} +1 -1
  92. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  93. package/dist/{cli-2d0cghfn.js → cli-qj39vrc6.js} +1 -1
  94. package/dist/{cli-tas6ckky.js → cli-rq5rpv6k.js} +2 -2
  95. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  96. package/dist/{cli-kmemts3w.js → cli-sn650d7x.js} +39 -69
  97. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  98. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  99. package/dist/{cli-500c09j9.js → cli-t9ga4qmb.js} +14 -14
  100. package/dist/{cli-me0r8gzr.js → cli-td9tb872.js} +27 -25
  101. package/dist/cli-tvc4jag9.js +754 -0
  102. package/dist/{cli-6ek0hff4.js → cli-ty3gha1p.js} +4 -4
  103. package/dist/{cli-c71n3bxq.js → cli-v57d7fmm.js} +2 -2
  104. package/dist/{cli-j8cjdzan.js → cli-vs9vdpy0.js} +1 -1
  105. package/dist/cli-vt89089n.js +296 -0
  106. package/dist/{cli-pxwtcgcp.js → cli-vyff45ve.js} +2 -2
  107. package/dist/{cli-x3ex5bqf.js → cli-w16kwbzw.js} +1 -1
  108. package/dist/{cli-bj6qhgte.js → cli-w4n323t3.js} +197 -45
  109. package/dist/{cli-rqfvkx5t.js → cli-wn13hhdt.js} +13 -13
  110. package/dist/{cli-skmhsnqh.js → cli-x40a0w9j.js} +1 -1
  111. package/dist/{cli-zeaehgyd.js → cli-xag7btpe.js} +2 -2
  112. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  113. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  114. package/dist/{cli-dpsfwh7n.js → cli-y2ewxhth.js} +56 -31
  115. package/dist/{cli-vx421edw.js → cli-ysvspf5e.js} +9 -7
  116. package/dist/{cli-crpf163n.js → cli-zh0e5x7p.js} +16 -26
  117. package/dist/{cli-4e1hfbpq.js → cli-zr6qy15y.js} +24 -24
  118. package/dist/cli.js +33 -29
  119. package/dist/{codex-adapter-2brxx5ta.js → codex-adapter-n656pvb8.js} +9 -8
  120. package/dist/{codex-hook-c930c3ea.js → codex-hook-59atdwd8.js} +6 -6
  121. package/dist/{codex-login-cbrs1h5w.js → codex-login-a239g1ah.js} +1 -1
  122. package/dist/{codex-session-runner-y9anfj0r.js → codex-session-runner-p0fbv5y9.js} +10 -9
  123. package/dist/{commands-wn9q06qr.js → commands-gwea8z5p.js} +3 -3
  124. package/dist/{controller-fw608czd.js → controller-t67c3grh.js} +9 -6
  125. package/dist/{controllers-connect-63j5rdcm.js → controllers-connect-ks155r0h.js} +28 -25
  126. package/dist/{cursor-adapter-6mb9jme8.js → cursor-adapter-ygwrtmkv.js} +2 -2
  127. package/dist/{db-y4wfrzbm.js → db-kpmx06s9.js} +21 -13
  128. package/dist/{db-0m6v5tq4.js → db-rb2xqdb1.js} +3 -3
  129. package/dist/{devin-adapter-r0yx3gv8.js → devin-adapter-zp4tqq53.js} +1 -1
  130. package/dist/{dispatcher-9tq2zzdj.js → dispatcher-31sm0ej2.js} +21 -18
  131. package/dist/{docker-j75atvpt.js → docker-09tkkg0n.js} +47 -8
  132. package/dist/{dsh-adapter-t09sv4tq.js → dsh-adapter-qyxh0w31.js} +2 -2
  133. package/dist/{e2b-a7vzs2vj.js → e2b-3v1e745x.js} +6 -6
  134. package/dist/{e2b-7s9dscap.js → e2b-sm28k0k3.js} +6 -6
  135. package/dist/{easter-egg-3d-fbwvmwhe.js → easter-egg-3d-00wjscn6.js} +1 -1
  136. package/dist/{embedding-space-wh8de1t9.js → embedding-space-qhw4g68n.js} +6 -6
  137. package/dist/{embeddings-3hpbdtjr.js → embeddings-zdv9ke6x.js} +1 -1
  138. package/dist/{event-bus-tr6h3gv8.js → event-bus-xr83x566.js} +1 -1
  139. package/dist/{execute-4bdf8sdy.js → execute-zna8wwr7.js} +1 -1
  140. package/dist/{external-channel-ts2fwqh0.js → external-channel-1ac6t56s.js} +2 -2
  141. package/dist/fx-adapter-sk7n0fzc.js +19 -0
  142. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  143. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  144. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  145. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  146. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  147. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-maq6c9bf.js} +1 -1
  148. package/dist/{google-vertex-fhxaafzw.js → google-vertex-2jgsw2nb.js} +5 -5
  149. package/dist/grok-adapter-sjbcm5ew.js +19 -0
  150. package/dist/handlers-yzy0c87x.js +35 -0
  151. package/dist/{heartbeat-2ze5fzpc.js → heartbeat-2f6z4kdx.js} +24 -21
  152. package/dist/{hook-gaehe2w5.js → hook-8y0gvtp1.js} +14 -14
  153. package/dist/{hook-ca54yd4s.js → hook-w1skzaqc.js} +5 -5
  154. package/dist/{http-jfg8t2yk.js → http-wghxvpef.js} +2333 -589
  155. package/dist/{index-d6wkh8ar.js → index-0h6qd4p1.js} +34 -24
  156. package/dist/index-25pvya7q.js +40 -0
  157. package/dist/index-2t4859r5.js +35 -0
  158. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  159. package/dist/{index-khe3gp0k.js → index-4k7m5dgj.js} +645 -370
  160. package/dist/index-620y7jzq.js +15 -0
  161. package/dist/{index-gjwaqaq8.js → index-8p0j4h4j.js} +506 -43
  162. package/dist/{index-3gv6sc4z.js → index-8zn8nxn5.js} +1 -1
  163. package/dist/{index-m5gx1xd6.js → index-9myfj74s.js} +40 -40
  164. package/dist/{index-3yvzbhxd.js → index-9zkchs9t.js} +336 -193
  165. package/dist/{index-0rvk3vd4.js → index-b5wgnm78.js} +47 -47
  166. package/dist/index-cxca2t8y.js +36 -0
  167. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  168. package/dist/{index-hjhfk3ra.js → index-pe3d8jfy.js} +3 -3
  169. package/dist/index-rv89fvzf.js +572 -0
  170. package/dist/{index-csgrxedz.js → index-s71ez27v.js} +1 -1
  171. package/dist/{keepalive-k2a3qe73.js → keepalive-sh02349h.js} +4 -4
  172. package/dist/lead-gk4h5eg7.js +74 -0
  173. package/dist/{maintenance-gb5sd5nc.js → maintenance-yj0dcjja.js} +1 -1
  174. package/dist/{node-252anz2h.js → node-dqm4xgxw.js} +4 -4
  175. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  176. package/dist/{oauth-refresh-sweep-y7rm6bkb.js → oauth-refresh-sweep-d9xedk66.js} +3 -3
  177. package/dist/{onboard-jmc5qerv.js → onboard-dpgjn03r.js} +8 -8
  178. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  179. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  180. package/dist/{opencode-adapter-7eade9ev.js → opencode-adapter-2d31cpjc.js} +7 -6
  181. package/dist/{otel-impl-8j1xhxqd.js → otel-impl-1skarpfq.js} +110 -110
  182. package/dist/pending-bfmxtx0g.js +82 -0
  183. package/dist/{pi-mono-adapter-yqmaf32x.js → pi-mono-adapter-gvppnasy.js} +43 -16
  184. package/dist/{pricing-refresh-1nj722h6.js → pricing-refresh-c6b325mk.js} +2 -2
  185. package/dist/{rbac-roles-b1mtr6dr.js → rbac-roles-h80qbdbs.js} +3 -3
  186. package/dist/{rbac-roles-n1f3frk1.js → rbac-roles-zfcx68tx.js} +10 -3
  187. package/dist/{render-v2-1gfpd8rj.js → render-v2-nx20t3rb.js} +7 -4
  188. package/dist/{resume-w1s1eh5v.js → resume-5ep8agan.js} +11 -7
  189. package/dist/{runtime-84g5egsc.js → runtime-r3pj4mce.js} +1 -1
  190. package/dist/{session-access-y6z1txk4.js → session-access-n7p3m15b.js} +4 -4
  191. package/dist/{session-source-backfill-gxxwfh12.js → session-source-backfill-v8mt0zwn.js} +4 -4
  192. package/dist/{setup-r91gstyk.js → setup-z1psaqhe.js} +1 -1
  193. package/dist/thread-buffer-a1re2r9r.js +38 -0
  194. package/dist/{virtual-modules-cgnj6kme.js → virtual-modules-rrbjdpxn.js} +5 -5
  195. package/dist/{work-objects-qcxzg61c.js → work-objects-4aghh73z.js} +31 -23
  196. package/dist/worker-3dyyb8ev.js +74 -0
  197. package/dist/{worker-follow-up-y2d2h7km.js → worker-follow-up-166zmex1.js} +21 -18
  198. package/dist/{x-qhxq2ama.js → x-wg164ss9.js} +2 -2
  199. package/openapi.json +2561 -131
  200. package/package.json +15 -11
  201. package/plugin/commands/create-pr.md +1 -1
  202. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  203. package/src/apps/action-runner.ts +21 -1
  204. package/src/apps/catalog.generated.json +667 -18
  205. package/src/apps/page-validator.ts +341 -8
  206. package/src/assets/key.ts +6 -0
  207. package/src/be/agent-fs-user-keys.ts +186 -0
  208. package/src/be/audit-user.ts +27 -13
  209. package/src/be/automation-preflight.test.ts +14 -14
  210. package/src/be/automation-preflight.ts +24 -16
  211. package/src/be/boot-scrub-sweep.ts +143 -14
  212. package/src/be/caller-session-group.ts +86 -0
  213. package/src/be/checklist.ts +375 -0
  214. package/src/be/db/agents.ts +12 -1
  215. package/src/be/db/approvals.ts +26 -0
  216. package/src/be/db/model-profiles.ts +4 -1
  217. package/src/be/db/session-costs.ts +219 -0
  218. package/src/be/db/session-log-reasoning.ts +36 -0
  219. package/src/be/db/session-moves.ts +23 -0
  220. package/src/be/db/session-tree.ts +78 -19
  221. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  222. package/src/be/db/tasks/read.ts +7 -3
  223. package/src/be/db/tasks/slack-fold.ts +116 -0
  224. package/src/be/db/tasks/write.ts +67 -1
  225. package/src/be/db-queries/mcp-servers.ts +13 -0
  226. package/src/be/db-queries/oauth.ts +6 -0
  227. package/src/be/db-queries/task-artifacts.ts +10 -8
  228. package/src/be/db.ts +242 -319
  229. package/src/be/extensions/assets.ts +17 -13
  230. package/src/be/import/config.ts +54 -0
  231. package/src/be/import/dir-source.ts +372 -0
  232. package/src/be/import/index.ts +149 -0
  233. package/src/be/import/pending.ts +71 -0
  234. package/src/be/import/schema.ts +137 -0
  235. package/src/be/import/seeders.ts +462 -0
  236. package/src/be/key-window-usage.ts +385 -0
  237. package/src/be/migrations/297_import_ownership.sql +34 -0
  238. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  239. package/src/be/migrations/302_checklist_items.sql +23 -0
  240. package/src/be/migrations/303_task_ui_specs.sql +28 -0
  241. package/src/be/migrations/306_provider_account_telemetry.sql +1 -0
  242. package/src/be/migrations/307_session_cost_credential_attribution.sql +23 -0
  243. package/src/be/migrations/310_session_logs_reasoning.sql +12 -0
  244. package/src/be/multi-runtime.ts +8 -1
  245. package/src/be/rbac-roles.ts +8 -1
  246. package/src/be/runtime-pools/db.ts +3 -0
  247. package/src/be/runtime-pools/demand.ts +20 -2
  248. package/src/be/runtime-pools/reachability.ts +31 -0
  249. package/src/be/runtime-pools/routing.ts +8 -1
  250. package/src/be/runtime-pools/supervisor.ts +6 -7
  251. package/src/be/savings/read.ts +8 -6
  252. package/src/be/script-credential-broker.ts +2 -2
  253. package/src/be/scripts/typecheck.ts +4 -4
  254. package/src/be/seed/agent-fs-provision.ts +104 -19
  255. package/src/be/seed/index.ts +1 -1
  256. package/src/be/seed/registry.ts +27 -8
  257. package/src/be/seed/runner.ts +1 -1
  258. package/src/be/seed/schedules-seeder.ts +24 -6
  259. package/src/be/seed/seed-toggle.ts +32 -0
  260. package/src/be/seed/types.ts +6 -0
  261. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -0
  262. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -0
  263. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  264. package/src/be/seed-scripts/catalog/wait-for-task.ts +5 -1
  265. package/src/be/seed-skills/index.ts +3 -0
  266. package/src/be/steering.ts +27 -4
  267. package/src/be/swarm-config-guard.ts +54 -1
  268. package/src/be/task-citations.ts +8 -5
  269. package/src/be/task-ui-spec.ts +158 -0
  270. package/src/commands/controller.ts +3 -0
  271. package/src/commands/credential-outcome-report.ts +13 -3
  272. package/src/commands/onboard/agent-fs-version.ts +1 -1
  273. package/src/commands/rate-limit-outcome.ts +6 -0
  274. package/src/commands/runner.ts +95 -55
  275. package/src/e2b/env.ts +2 -0
  276. package/src/extensions/catalog.generated.json +17 -0
  277. package/src/extensions/contract-types.generated.ts +1 -1
  278. package/src/github/app.ts +10 -1
  279. package/src/github/handlers.ts +6 -3
  280. package/src/github/reactions.ts +12 -14
  281. package/src/heartbeat/heartbeat.ts +14 -4
  282. package/src/http/agents.ts +19 -10
  283. package/src/http/all-routes.ts +2 -0
  284. package/src/http/api-keys.ts +258 -30
  285. package/src/http/approval-requests.ts +24 -4
  286. package/src/http/apps.ts +69 -5
  287. package/src/http/checklist.ts +176 -0
  288. package/src/http/db-query-bounded.ts +256 -11
  289. package/src/http/db-query-shared.ts +9 -0
  290. package/src/http/favorites.ts +14 -2
  291. package/src/http/fs.ts +346 -1
  292. package/src/http/index.ts +29 -1
  293. package/src/http/kv.ts +13 -0
  294. package/src/http/mcp-oauth.ts +1 -1
  295. package/src/http/mcp-servers.ts +15 -2
  296. package/src/http/onboarding.ts +2 -9
  297. package/src/http/poll.ts +45 -0
  298. package/src/http/script-connections.ts +1 -0
  299. package/src/http/session-data.ts +74 -23
  300. package/src/http/sessions.ts +23 -2
  301. package/src/http/slack-events.ts +101 -0
  302. package/src/http/status.ts +25 -7
  303. package/src/http/task-requester.ts +46 -0
  304. package/src/http/tasks.ts +169 -42
  305. package/src/http/users.ts +14 -0
  306. package/src/http/webhooks.ts +15 -0
  307. package/src/integrations/cards/index.ts +151 -0
  308. package/src/integrations/chat-sdk/outbound.ts +39 -13
  309. package/src/integrations/chat-sdk/relay.ts +87 -0
  310. package/src/integrations/chat-sdk/runtime.ts +7 -1
  311. package/src/integrations/chat-sdk/status.ts +17 -0
  312. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  313. package/src/jira/outbound.ts +5 -3
  314. package/src/kv-reserved-namespaces.ts +17 -2
  315. package/src/linear/outbound.ts +5 -1
  316. package/src/oauth/presets.ts +29 -2
  317. package/src/prompts/base-prompt.ts +25 -4
  318. package/src/prompts/session-templates.ts +102 -8
  319. package/src/providers/acp-targets.ts +1 -1
  320. package/src/providers/amp-adapter.ts +1 -1
  321. package/src/providers/claude-adapter.ts +27 -4
  322. package/src/providers/claude-flag-settings.ts +39 -1
  323. package/src/providers/claude-managed-adapter.ts +5 -1
  324. package/src/providers/codex-adapter.ts +86 -4
  325. package/src/providers/codex-app-server.ts +11 -16
  326. package/src/providers/codex-oauth/auth-json.ts +1 -0
  327. package/src/providers/opencode-adapter.ts +7 -19
  328. package/src/providers/pi-mono-adapter.ts +35 -2
  329. package/src/providers/pricing-sources.md +32 -0
  330. package/src/providers/runtime-dependencies.ts +158 -0
  331. package/src/providers/types.ts +11 -0
  332. package/src/rbac/legacy-policy.ts +2 -0
  333. package/src/rbac/permissions.ts +10 -1
  334. package/src/runtime-providers/docker.ts +65 -1
  335. package/src/scheduler/deferred-task-waits.ts +18 -5
  336. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  337. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  338. package/src/scripts-runtime/egress-secrets.ts +2 -2
  339. package/src/scripts-runtime/swarm-sdk.ts +3 -2
  340. package/src/scripts-runtime/types/stdlib.d.ts +11 -4
  341. package/src/scripts-runtime/types/swarm-extension.d.ts +9 -9
  342. package/src/scripts-runtime/types/swarm-sdk.d.ts +11 -4
  343. package/src/server.ts +4 -4
  344. package/src/slack/actions.ts +56 -0
  345. package/src/slack/app.ts +107 -59
  346. package/src/slack/assistant.ts +33 -7
  347. package/src/slack/handlers.ts +6 -4
  348. package/src/slack/http-receiver.ts +284 -0
  349. package/src/slack/inbound-dispatch.ts +43 -7
  350. package/src/slack/inbound-files.ts +35 -14
  351. package/src/slack/message-text.ts +47 -4
  352. package/src/slack/render-v2.ts +109 -24
  353. package/src/slack/responses.ts +3 -2
  354. package/src/slack/socket-ack.ts +17 -10
  355. package/src/slack/steering.ts +5 -0
  356. package/src/slack/thread-buffer-store.ts +58 -0
  357. package/src/slack/thread-buffer.ts +341 -57
  358. package/src/slack/work-objects.ts +4 -1
  359. package/src/tasks/context-key.ts +24 -0
  360. package/src/tasks/errors.ts +5 -0
  361. package/src/tasks/sibling-awareness.ts +13 -1
  362. package/src/tests/acp-adapter.test.ts +4 -6
  363. package/src/tests/agent-fs-live-url.test.ts +15 -0
  364. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  365. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  366. package/src/tests/agentfs-proxy.test.ts +8 -8
  367. package/src/tests/api-key-tracking.test.ts +0 -72
  368. package/src/tests/api-keys-status-model-limits.test.ts +93 -1
  369. package/src/tests/api-keys-validation.test.ts +42 -0
  370. package/src/tests/approval-card-resolution.test.ts +402 -0
  371. package/src/tests/approval-requests-notifications.test.ts +12 -2
  372. package/src/tests/approval-respond-auth.test.ts +28 -0
  373. package/src/tests/apps-action-parent-task.test.ts +140 -0
  374. package/src/tests/apps-catalog-additions.test.ts +315 -0
  375. package/src/tests/apps-catalog-files.test.ts +114 -0
  376. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  377. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  378. package/src/tests/apps-catalog-page-frame.test.ts +49 -0
  379. package/src/tests/apps-catalog-table.test.ts +47 -0
  380. package/src/tests/apps-chart-shell.test.ts +1 -1
  381. package/src/tests/apps-element-assembly.test.ts +52 -3
  382. package/src/tests/apps-session-thread.test.ts +261 -0
  383. package/src/tests/asset-key-invariants.test.ts +14 -0
  384. package/src/tests/base-prompt.test.ts +213 -23
  385. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  386. package/src/tests/caller-session-group.test.ts +199 -0
  387. package/src/tests/cards.test.ts +169 -0
  388. package/src/tests/chat-sdk-relay.test.ts +149 -1
  389. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  390. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  391. package/src/tests/chat-sdk-tools.test.ts +147 -0
  392. package/src/tests/checklist-nudge.test.ts +208 -0
  393. package/src/tests/checklist.test.ts +686 -0
  394. package/src/tests/claude-adapter-binary.test.ts +67 -6
  395. package/src/tests/claude-flag-settings.test.ts +29 -0
  396. package/src/tests/claude-sdk-lifecycle.test.ts +5 -0
  397. package/src/tests/codex-adapter.test.ts +340 -2
  398. package/src/tests/codex-app-server.test.ts +32 -0
  399. package/src/tests/codex-oauth.test.ts +3 -1
  400. package/src/tests/codex-rate-limits.test.ts +384 -0
  401. package/src/tests/comb-config-guard.test.ts +21 -0
  402. package/src/tests/comb-default.test.ts +59 -97
  403. package/src/tests/comb-links.test.ts +86 -16
  404. package/src/tests/comb-status.test.ts +24 -27
  405. package/src/tests/create-page-tool.test.ts +101 -1
  406. package/src/tests/create-schedule-key.test.ts +105 -0
  407. package/src/tests/credential-broker.test.ts +2 -2
  408. package/src/tests/credential-outcome-report.test.ts +20 -0
  409. package/src/tests/db-query.test.ts +87 -1
  410. package/src/tests/db-task-read-contract.test.ts +4 -0
  411. package/src/tests/db-task-write-contract.test.ts +6 -1
  412. package/src/tests/deferred-task-wake.test.ts +63 -1
  413. package/src/tests/docker-isolation-config-guard.test.ts +29 -0
  414. package/src/tests/docs-index-footprint.test.js +11 -3
  415. package/src/tests/e2e-visuals-comment.test.ts +82 -0
  416. package/src/tests/e2e-visuals-verify-pr.test.ts +138 -0
  417. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  418. package/src/tests/extensions-assets.test.ts +7 -3
  419. package/src/tests/extensions-catalog.test.ts +1 -0
  420. package/src/tests/extensions-example-sql-admin-only.test.ts +201 -0
  421. package/src/tests/extensions-pre-task.test.ts +3 -3
  422. package/src/tests/extensions-steering.test.ts +14 -2
  423. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  424. package/src/tests/fetch-resolved-env.test.ts +68 -0
  425. package/src/tests/fixtures/import-package.ts +32 -0
  426. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  427. package/src/tests/fixtures/ui-spec-slack/deploys.json +121 -0
  428. package/src/tests/fixtures/ui-spec-slack/incident.json +183 -0
  429. package/src/tests/fixtures/ui-spec-slack/three-charts-stale.json +196 -0
  430. package/src/tests/fixtures/ui-spec-slack/video-rejected-by-slack.json +183 -0
  431. package/src/tests/fixtures/ui-spec-slack/video.json +446 -0
  432. package/src/tests/fs-routes.test.ts +505 -2
  433. package/src/tests/github-ghes-mock.test.ts +196 -0
  434. package/src/tests/github-host.test.ts +285 -0
  435. package/src/tests/gitleaks-download-retry.test.ts +85 -0
  436. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  437. package/src/tests/heartbeat.test.ts +56 -0
  438. package/src/tests/human-thread-routing.test.ts +187 -0
  439. package/src/tests/import-config.test.ts +209 -0
  440. package/src/tests/import.test.ts +464 -0
  441. package/src/tests/invites-http.test.ts +144 -1
  442. package/src/tests/jira-outbound-sync.test.ts +33 -1
  443. package/src/tests/key-window-usage.test.ts +831 -0
  444. package/src/tests/kv-http.test.ts +11 -0
  445. package/src/tests/linear-outbound-sync.test.ts +30 -1
  446. package/src/tests/literal-matcher.test.ts +58 -0
  447. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  448. package/src/tests/oauth-presets.test.ts +12 -0
  449. package/src/tests/pi-mono-adapter.test.ts +79 -0
  450. package/src/tests/pool-affinity.test.ts +50 -0
  451. package/src/tests/preload-env.test.ts +2 -0
  452. package/src/tests/preload.ts +3 -1
  453. package/src/tests/prompt-template-session.test.ts +53 -5
  454. package/src/tests/provider-quota-persistence.test.ts +362 -0
  455. package/src/tests/provider-registration.test.ts +2 -55
  456. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  457. package/src/tests/rate-limit-event.test.ts +22 -0
  458. package/src/tests/rbac-admission.test.ts +19 -0
  459. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  460. package/src/tests/rbac-engine.test.ts +2 -0
  461. package/src/tests/rbac-roles.test.ts +2 -0
  462. package/src/tests/reasoning-events.test.ts +164 -0
  463. package/src/tests/routing-affinity-inventory.test.ts +22 -0
  464. package/src/tests/runner-missing-dependency.test.ts +61 -0
  465. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  466. package/src/tests/runtime-pool-routing.test.ts +52 -0
  467. package/src/tests/runtime-providers-docker.test.ts +91 -0
  468. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  469. package/src/tests/savings-fleet-slices.test.ts +122 -0
  470. package/src/tests/savings-read.test.ts +41 -0
  471. package/src/tests/savings-scripts.test.ts +9 -3
  472. package/src/tests/script-connections.test.ts +7 -0
  473. package/src/tests/script-executor-conformance.test.ts +41 -4
  474. package/src/tests/secret-canary-sweep.test.ts +41 -5
  475. package/src/tests/secret-scrub-gate.test.ts +257 -0
  476. package/src/tests/seed-registry.test.ts +142 -9
  477. package/src/tests/seed-scripts.test.ts +23 -0
  478. package/src/tests/session-cost-attribution.test.ts +748 -0
  479. package/src/tests/session-costs.test.ts +14 -15
  480. package/src/tests/session-logs.test.ts +83 -0
  481. package/src/tests/session-source-keys.test.ts +42 -1
  482. package/src/tests/sessions-detail-batch.test.ts +7 -0
  483. package/src/tests/sessions-move.test.ts +70 -0
  484. package/src/tests/sessions-tree.test.ts +98 -0
  485. package/src/tests/sessions.test.ts +69 -0
  486. package/src/tests/slack-config.test.ts +4 -18
  487. package/src/tests/slack-http-receiver.test.ts +472 -0
  488. package/src/tests/slack-inbound-logging.test.ts +64 -0
  489. package/src/tests/slack-leave-thread.test.ts +1 -1
  490. package/src/tests/slack-message-text.test.ts +104 -0
  491. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  492. package/src/tests/slack-render-v2.test.ts +405 -0
  493. package/src/tests/slack-skip-reaction.test.ts +2 -2
  494. package/src/tests/slack-start-reload-race.test.ts +67 -0
  495. package/src/tests/slack-steering.test.ts +22 -10
  496. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  497. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  498. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  499. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  500. package/src/tests/slack-thread-buffer.test.ts +34 -34
  501. package/src/tests/slack-thread-participants.test.ts +23 -5
  502. package/src/tests/slack-tool-blocks.test.ts +167 -0
  503. package/src/tests/status.test.ts +32 -6
  504. package/src/tests/steering-core.test.ts +13 -0
  505. package/src/tests/steering-enabled.test.ts +7 -1
  506. package/src/tests/steering-promotion.test.ts +24 -0
  507. package/src/tests/subscription-plans.test.ts +20 -1
  508. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  509. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  510. package/src/tests/task-artifacts.test.ts +50 -0
  511. package/src/tests/task-session-prompts.test.ts +95 -1
  512. package/src/tests/task-ui-action-route.test.ts +191 -0
  513. package/src/tests/task-ui-actions.test.ts +195 -0
  514. package/src/tests/task-ui-spec-fallback.test.ts +65 -0
  515. package/src/tests/task-ui-spec.test.ts +368 -0
  516. package/src/tests/workflow-agent-task-retry.test.ts +34 -1
  517. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  518. package/src/tools/chat-post.ts +19 -4
  519. package/src/tools/chat-reply.ts +20 -4
  520. package/src/tools/create-page.ts +21 -4
  521. package/src/tools/defer-task.ts +1 -1
  522. package/src/tools/get-swarm.ts +18 -2
  523. package/src/tools/join-swarm.ts +2 -1
  524. package/src/tools/kv/kv-write-auth.ts +17 -1
  525. package/src/tools/schedules/create-schedule.ts +22 -4
  526. package/src/tools/slack-post.ts +40 -7
  527. package/src/tools/slack-reply.ts +50 -14
  528. package/src/tools/store-progress.ts +69 -3
  529. package/src/types.ts +50 -4
  530. package/src/ui-spec/actions.ts +86 -0
  531. package/src/ui-spec/fallback.ts +19 -0
  532. package/src/ui-spec/slack.ts +17 -0
  533. package/src/ui-spec/validate.ts +169 -0
  534. package/src/utils/codex-rate-limits.ts +159 -0
  535. package/src/utils/constants.ts +60 -138
  536. package/src/utils/credentials.ts +2 -0
  537. package/src/utils/error-tracker.ts +19 -0
  538. package/src/utils/github-host.ts +217 -0
  539. package/src/utils/github-pull-request.ts +8 -5
  540. package/src/utils/literal-matcher.ts +118 -0
  541. package/src/utils/provider-account-telemetry.ts +331 -0
  542. package/src/utils/reasoning-events.ts +107 -0
  543. package/src/utils/secret-scrubber.ts +331 -25
  544. package/src/utils/subscription-plans.ts +11 -59
  545. package/src/utils/task-attachment-links.ts +9 -12
  546. package/src/utils/task-ui-spec.ts +67 -0
  547. package/src/vcs/index.ts +3 -0
  548. package/src/workflows/approval-notifications.ts +188 -12
  549. package/src/workflows/executors/system-one-extraction.ts +14 -7
  550. package/src/workflows/executors/system-one-providers.ts +22 -1
  551. package/src/workflows/task-step-routing.ts +8 -3
  552. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  553. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  554. package/templates/extensions/README.md +1 -0
  555. package/templates/extensions/sql-admin-only/README.md +20 -0
  556. package/templates/extensions/sql-admin-only/hooks.ts +100 -0
  557. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  558. package/templates/import/manifest.schema.json +136 -0
  559. package/templates/import/sources.schema.json +44 -0
  560. package/templates/skills/agent-browser/SKILL.md +1 -1
  561. package/templates/skills/agent-browser/content.md +1 -1
  562. package/templates/skills/apps/SKILL.md +151 -14
  563. package/templates/skills/apps/content.md +151 -14
  564. package/templates/skills/asset-namespaces/content.md +2 -1
  565. package/templates/skills/chat-sdk/content.md +17 -0
  566. package/templates/skills/db-query-guidance/content.md +2 -1
  567. package/templates/skills/scheduling/content.md +27 -0
  568. package/templates/skills/slack-interaction/content.md +12 -2
  569. package/templates/skills/swarm-docs/content.md +1 -0
  570. package/templates/skills/swarm-extensions/config.json +1 -1
  571. package/templates/skills/swarm-extensions/content.md +33 -23
  572. package/templates/skills/swarm-scripts/SKILL.md +13 -0
  573. package/templates/skills/swarm-scripts/content.md +13 -0
  574. package/templates/skills/ui-spec/config.json +14 -0
  575. package/templates/skills/ui-spec/content.md +127 -0
  576. package/templates/skills/work-on-task/SKILL.md +1 -1
  577. package/templates/skills/work-on-task/content.md +1 -1
  578. package/templates/skills/workflow-iterate/content.md +4 -7
  579. package/templates/workflows/dreaming/content.md +2 -2
  580. package/dist/acp-adapter-xq6s2z6t.js +0 -14
  581. package/dist/claude-adapter-r33pqnzx.js +0 -24
  582. package/dist/cli-dns0y538.js +0 -194
  583. package/dist/cli-m2z8jagn.js +0 -12078
  584. package/dist/fx-adapter-1rnxnf56.js +0 -17
  585. package/dist/grok-adapter-efhmf1r8.js +0 -17
  586. package/dist/handlers-anrr3py9.js +0 -32
  587. package/dist/index-2skqtd76.js +0 -12795
  588. package/dist/index-8w2aznds.js +0 -33
  589. package/dist/index-qnjvr362.js +0 -37
  590. package/dist/index-yzxd3sn9.js +0 -32
  591. package/dist/lead-zhxqbfdv.js +0 -69
  592. package/dist/worker-7j2907g6.js +0 -69
  593. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  594. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  595. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  596. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  597. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -0,0 +1,67 @@
1
+ /**
2
+ * Browser-safe constants and types for task UI specs (json-render chat catalog).
3
+ * No package imports: the dashboard imports this file directly.
4
+ */
5
+
6
+ /** Max UTF-8 bytes of `JSON.stringify(spec)`. */
7
+ export const UI_SPEC_MAX_BYTES = 32_768;
8
+
9
+ /** Max Slack blocks one spec may render as. */
10
+ export const UI_SPEC_MAX_BLOCKS = 45;
11
+
12
+ /** Max elements in one Slack `actions` block. */
13
+ export const UI_SPEC_MAX_ACTIONS_ROW_ELEMENTS = 25;
14
+
15
+ /** Prefix on the Slack `action_id` of every spec Button. */
16
+ export const UI_SPEC_ACTION_PREFIX = "swarm_ui:";
17
+
18
+ /** Allowed id of a declared action, and of the Button that names it. */
19
+ export const UI_SPEC_ACTION_ID = /^[a-z][a-z0-9_]{0,39}$/;
20
+
21
+ /** Limits passed to `toCard` from `@json-render/chat`. */
22
+ export const UI_SPEC_CARD_LIMITS = {
23
+ tables: 1,
24
+ charts: 2,
25
+ chartLabel: 20,
26
+ chartTitle: 50,
27
+ tableRows: 100,
28
+ tableColumns: 20,
29
+ } as const;
30
+
31
+ /** The chat catalog components. Kept equal to `@json-render/chat` by a drift test. */
32
+ export const UI_SPEC_COMPONENTS = [
33
+ "Card",
34
+ "Section",
35
+ "Text",
36
+ "Fields",
37
+ "Field",
38
+ "Table",
39
+ "Chart",
40
+ "Divider",
41
+ "Image",
42
+ "Actions",
43
+ "Button",
44
+ "LinkButton",
45
+ ] as const;
46
+
47
+ export type UiSpecComponent = (typeof UI_SPEC_COMPONENTS)[number];
48
+
49
+ export interface TaskUiSpecDocument {
50
+ root: string;
51
+ elements: Record<string, unknown>;
52
+ state?: Record<string, unknown>;
53
+ }
54
+
55
+ export interface TaskUiSpecAction {
56
+ kind: "follow_up";
57
+ prompt: string;
58
+ }
59
+
60
+ export interface TaskUiSpec {
61
+ spec: TaskUiSpecDocument;
62
+ actions?: Record<string, TaskUiSpecAction>;
63
+ fallbackText: string;
64
+ }
65
+
66
+ /** What an agent sends on `store-progress`: the spec without the derived fallback text. */
67
+ export type TaskUiSpecInput = Omit<TaskUiSpec, "fallbackText">;
package/src/vcs/index.ts CHANGED
@@ -2,6 +2,7 @@
2
2
  * VCS Provider utilities.
3
3
  */
4
4
 
5
+ import { getGitHubLinkConfig, isGitHubUrl } from "../utils/github-host";
5
6
  import { isAzureDevOpsUrl } from "./azure-devops";
6
7
  import { isBitbucketUrl } from "./bitbucket";
7
8
  import type { VcsProvider } from "./types";
@@ -15,6 +16,8 @@ export type { VcsProvider } from "./types";
15
16
  export function detectVcsProvider(url: string): VcsProvider | null {
16
17
  if (isAzureDevOpsUrl(url)) return "azure-devops";
17
18
  if (isBitbucketUrl(url)) return "bitbucket";
19
+ // The configured GHES host wins over the loose gitlab substring checks below.
20
+ if (getGitHubLinkConfig().enterprise && isGitHubUrl(url)) return "github";
18
21
  if (url.includes("gitlab.com") || url.includes("gitlab.")) return "gitlab";
19
22
  if (url.includes("github.com") || /^[\w.-]+\/[\w.-]+$/.test(url)) return "github";
20
23
  return null;
@@ -1,18 +1,21 @@
1
1
  import { formatConfigResult } from "../be/approval-config-question";
2
2
  import {
3
3
  type ApprovalRequest,
4
+ type ApprovalVote,
4
5
  claimApprovalCancellationNotification,
5
6
  completeApprovalCancellationNotificationClaim,
6
7
  createTaskExtended,
8
+ getAllUsers,
7
9
  getApprovalRequestById,
8
10
  getTaskById,
11
+ getUserById,
9
12
  releaseApprovalCancellationNotificationClaim,
10
13
  updateApprovalRequestNotifications,
11
14
  } from "../be/db";
12
15
  import { approvalCancellationNotificationKey } from "../be/db/approvals";
13
16
  import { resolveTemplate } from "../prompts/resolver";
14
17
  import { getSlackApp } from "../slack/app";
15
- import { resolveSlackConversationId } from "../slack/dm";
18
+ import { isSlackUserId, resolveSlackConversationId } from "../slack/dm";
16
19
  import {
17
20
  externalChannelToolError,
18
21
  getChannelBlockReason,
@@ -103,9 +106,9 @@ export async function dispatchApprovalNotifications(
103
106
  if (!notifications.length) return;
104
107
 
105
108
  const approvalUrl = `${getAppUrl()}/approval-requests/${requestId}`;
106
- const updatedChannels: Array<ApprovalNotificationChannel & { messageTs?: string }> = [
107
- ...notifications,
108
- ];
109
+ const updatedChannels: Array<
110
+ ApprovalNotificationChannel & { messageTs?: string; channelId?: string }
111
+ > = [...notifications];
109
112
  let updated = false;
110
113
 
111
114
  for (let i = 0; i < notifications.length; i++) {
@@ -124,12 +127,13 @@ export async function dispatchApprovalNotifications(
124
127
  continue;
125
128
  }
126
129
 
130
+ // A user-id channel posts into the user's Slackbot DM, where the bot cannot edit the card later.
131
+ const conversationId = await resolveSlackConversationId(
132
+ slackApp.client,
133
+ notification.target,
134
+ );
127
135
  // Same guard as the Slack tools: never post into a channel shared with another org.
128
136
  if (isBlockExternalEnabled()) {
129
- const conversationId = await resolveSlackConversationId(
130
- slackApp.client,
131
- notification.target,
132
- );
133
137
  const blockReason = await getChannelBlockReason(slackApp.client, conversationId);
134
138
  if (blockReason) {
135
139
  console.warn(`[HITL] ${externalChannelToolError(conversationId, blockReason)}`);
@@ -185,7 +189,7 @@ export async function dispatchApprovalNotifications(
185
189
  ];
186
190
 
187
191
  const result = await slackApp.client.chat.postMessage({
188
- channel: notification.target,
192
+ channel: conversationId,
189
193
  text: `Approval Required: ${escapeSlackMrkdwn(title)} — ${approvalUrl}`,
190
194
  unfurl_links: false,
191
195
  unfurl_media: false,
@@ -194,7 +198,12 @@ export async function dispatchApprovalNotifications(
194
198
  });
195
199
 
196
200
  if (result.ts) {
197
- updatedChannels[i] = { ...notification, messageTs: result.ts };
201
+ // chat.update and thread replies need the conversation the card is in.
202
+ updatedChannels[i] = {
203
+ ...notification,
204
+ messageTs: result.ts,
205
+ channelId: result.channel ?? conversationId,
206
+ };
198
207
  updated = true;
199
208
  }
200
209
 
@@ -214,7 +223,7 @@ export async function dispatchApprovalNotifications(
214
223
  if (updated) {
215
224
  try {
216
225
  await db.updateApprovalRequestNotifications(requestId, updatedChannels);
217
- // A cancel that landed while the card was posting found no messageTs to thread under.
226
+ // A resolution that landed while the card was posting found no messageTs to act on.
218
227
  const latest = await db.getApprovalRequestById(requestId);
219
228
  if (latest?.status === "cancelled") {
220
229
  await postApprovalCancellationUpdates(
@@ -222,6 +231,7 @@ export async function dispatchApprovalNotifications(
222
231
  latest.resolutionReason ?? "Workflow run cancelled",
223
232
  );
224
233
  }
234
+ if (latest && latest.status !== "pending") await updateResolvedApprovalCards([latest]);
225
235
  } catch (err) {
226
236
  console.error(
227
237
  "[HITL] Failed to update notification channels in DB:",
@@ -256,6 +266,7 @@ export async function postApprovalCancellationUpdates(
256
266
  channel: string;
257
267
  target: string;
258
268
  messageTs?: string;
269
+ channelId?: string;
259
270
  }> | null;
260
271
  const slackThreads = (channels ?? []).filter(
261
272
  (notification) => notification.channel === "slack" && notification.messageTs,
@@ -272,7 +283,8 @@ export async function postApprovalCancellationUpdates(
272
283
  if (!claim) continue;
273
284
  try {
274
285
  await client.chat.postMessage({
275
- channel: notification.target,
286
+ // No channelId: a pre-deploy card, posted to the target, so the reply follows it there.
287
+ channel: notification.channelId ?? notification.target,
276
288
  thread_ts: notification.messageTs,
277
289
  text,
278
290
  unfurl_links: false,
@@ -298,6 +310,170 @@ export async function postApprovalCancellationUpdates(
298
310
  }
299
311
  }
300
312
 
313
+ export interface ApprovalCardSlackClient {
314
+ chat: {
315
+ update(input: {
316
+ channel: string;
317
+ ts: string;
318
+ text: string;
319
+ // biome-ignore lint/suspicious/noExplicitAny: Block Kit objects
320
+ blocks: any[];
321
+ unfurl_links: false;
322
+ unfurl_media: false;
323
+ }): Promise<unknown>;
324
+ postMessage(input: {
325
+ channel: string;
326
+ thread_ts: string;
327
+ text: string;
328
+ unfurl_links: false;
329
+ unfurl_media: false;
330
+ }): Promise<unknown>;
331
+ };
332
+ }
333
+
334
+ type ApprovalSlackEntry = {
335
+ channel: string;
336
+ target: string;
337
+ messageTs?: string;
338
+ channelId?: string;
339
+ };
340
+
341
+ /**
342
+ * A card stored before `channelId` existed, sent with a U/W target. Slack put it
343
+ * in the user's Slackbot DM: chat.update rejects user ids, and the bot cannot
344
+ * learn or edit that DM, so the outcome goes in a thread reply sent the same way.
345
+ * That reply shares the cancellation reply's claim: one reply per card.
346
+ */
347
+ function isLegacyUserDmCard(card: ApprovalSlackEntry): boolean {
348
+ return !card.channelId && isSlackUserId(card.target);
349
+ }
350
+
351
+ /** The claim key of one Slack card's in-place edit, beside the cancellation reply's key. */
352
+ export function approvalCardUpdateKey(target: string, messageTs: string): string {
353
+ return `card:${approvalCancellationNotificationKey(target, messageTs)}`;
354
+ }
355
+
356
+ async function describeResolver(resolvedBy: string | null): Promise<string | null> {
357
+ if (!resolvedBy) return null;
358
+ if (resolvedBy === "operator") return "operator";
359
+ const user = await getUserById(resolvedBy).catch(() => null);
360
+ return user?.name ?? null;
361
+ }
362
+
363
+ /**
364
+ * Build the resolved card: the outcome replaces "Approval Required", the
365
+ * questions stay, the primary button becomes a neutral "View" link and the
366
+ * timeout caption goes. Returns null for a pending request.
367
+ */
368
+ export async function buildResolvedApprovalCard(
369
+ approval: ApprovalRequest,
370
+ ): Promise<{ text: string; blocks: unknown[] } | null> {
371
+ if (approval.status === "pending") return null;
372
+ let by = await describeResolver(approval.resolvedBy);
373
+ if (approval.resolvedBy === "operator") {
374
+ const claim = [...(approval.approvals ?? [])]
375
+ .reverse()
376
+ .find((vote: ApprovalVote) => vote.responder === "operator")?.claimedRespondedBy;
377
+ if (claim) {
378
+ const users = await getAllUsers();
379
+ const user =
380
+ users.find((user) => user.email === claim) ?? users.find((user) => user.name === claim);
381
+ by = `operator key (as ${user?.name ?? claim})`;
382
+ }
383
+ }
384
+ const byText = by ? ` by ${escapeSlackMrkdwn(by)}` : "";
385
+ const reason = (approval.resolutionReason ?? "").replace(/\s+/g, " ").trim().slice(0, 300);
386
+ const outcome = {
387
+ approved: `✅ *Approved${byText}*`,
388
+ rejected: `❌ *Rejected${byText}*`,
389
+ timeout: "⏱️ *Timed out, no response*",
390
+ cancelled: `🚫 *Cancelled${reason ? `: ${escapeSlackMrkdwn(reason)}` : ""}*`,
391
+ }[approval.status];
392
+ const title = escapeSlackMrkdwn(approval.title);
393
+ const resolvedAt = new Date(approval.resolvedAt ?? approval.updatedAt);
394
+ const unix = Math.floor(resolvedAt.getTime() / 1000);
395
+ // Slack renders the token in each viewer's timezone; the fallback is for old clients only.
396
+ const when = `<!date^${unix}^{date_short_pretty} {time}|${resolvedAt.toISOString()}>`;
397
+ const approvalUrl = `${getAppUrl()}/approval-requests/${approval.id}`;
398
+ const questions = approval.questions as ReadonlyArray<{ label?: string; type?: string }>;
399
+ return {
400
+ text: `${outcome.replaceAll("*", "")}: ${title}`,
401
+ blocks: [
402
+ { type: "section", text: { type: "mrkdwn", text: `${outcome}\n${title}` } },
403
+ { type: "section", text: { type: "mrkdwn", text: buildSlackQuestionsSummary(questions) } },
404
+ {
405
+ type: "actions",
406
+ elements: [
407
+ { type: "button", text: { type: "plain_text", text: "View" }, url: approvalUrl },
408
+ ],
409
+ },
410
+ { type: "context", elements: [{ type: "mrkdwn", text: `Resolved ${when}` }] },
411
+ ],
412
+ };
413
+ }
414
+
415
+ /**
416
+ * Edit each resolved request's Slack card in place with chat.update; a card in
417
+ * a user's Slackbot DM gets a thread reply instead. One claim per
418
+ * (channel, messageTs) makes a repeat call a no-op. A Slack error
419
+ * releases the claim and is logged; it never throws.
420
+ */
421
+ export async function updateResolvedApprovalCards(
422
+ approvals: ReadonlyArray<Pick<ApprovalRequest, "id" | "notificationChannels">>,
423
+ client: ApprovalCardSlackClient | undefined = getSlackApp()?.client as
424
+ | ApprovalCardSlackClient
425
+ | undefined,
426
+ ): Promise<void> {
427
+ if (!client) return;
428
+ for (const approval of approvals) {
429
+ const cards = ((approval.notificationChannels ?? []) as ApprovalSlackEntry[]).filter(
430
+ (n) => n.channel === "slack" && n.messageTs,
431
+ );
432
+ for (const card of cards) {
433
+ const key = isLegacyUserDmCard(card)
434
+ ? approvalCancellationNotificationKey(card.target, card.messageTs!)
435
+ : approvalCardUpdateKey(card.target, card.messageTs!);
436
+ try {
437
+ const claim = await claimApprovalCancellationNotification(approval.id, key, {
438
+ anyTerminal: true,
439
+ });
440
+ if (!claim) continue;
441
+ try {
442
+ const rendered = await buildResolvedApprovalCard(claim.approval);
443
+ if (!rendered) throw new Error("approval is still pending");
444
+ if (!isLegacyUserDmCard(card)) {
445
+ await client.chat.update({
446
+ channel: card.channelId ?? card.target,
447
+ ts: card.messageTs!,
448
+ text: rendered.text,
449
+ blocks: rendered.blocks,
450
+ unfurl_links: false,
451
+ unfurl_media: false,
452
+ });
453
+ } else {
454
+ await client.chat.postMessage({
455
+ channel: card.target,
456
+ thread_ts: card.messageTs!,
457
+ text: rendered.text,
458
+ unfurl_links: false,
459
+ unfurl_media: false,
460
+ });
461
+ }
462
+ await completeApprovalCancellationNotificationClaim(approval.id, key, claim.leaseToken);
463
+ } catch (error) {
464
+ await releaseApprovalCancellationNotificationClaim(approval.id, key, claim.leaseToken);
465
+ throw error;
466
+ }
467
+ } catch (error) {
468
+ console.error(
469
+ `[HITL] Failed to update the Slack card for approval ${approval.id}:`,
470
+ scrubSecrets(error instanceof Error ? error.message : String(error)),
471
+ );
472
+ }
473
+ }
474
+ }
475
+ }
476
+
301
477
  /**
302
478
  * Create the `hitl-follow-up` task that tells the requesting agent how a
303
479
  * standalone approval request ended. Returns false when no task is created.
@@ -8,6 +8,7 @@ import {
8
8
  type ExecutorResult,
9
9
  } from "./base";
10
10
  import {
11
+ resolveSystemOneExtractDefaultProvider,
11
12
  resolveSystemOneTarget,
12
13
  SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER,
13
14
  SYSTEM_ONE_EXTRACT_PROVIDER_IDS,
@@ -222,7 +223,7 @@ function imageBytes(image: ExtractionImage): number {
222
223
 
223
224
  export const SystemOneExtractionConfigSchema = z
224
225
  .strictObject({
225
- provider: z.enum(SYSTEM_ONE_EXTRACT_PROVIDER_IDS).default(SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER),
226
+ provider: z.enum(SYSTEM_ONE_EXTRACT_PROVIDER_IDS).optional(),
226
227
  /** Provider-specific model id. Unset means the provider's default. */
227
228
  model: z.string().min(1).optional(),
228
229
  /** The text to read. A structured value is sent as JSON text. May be empty when images are sent. */
@@ -298,10 +299,11 @@ export const SystemOneExtractionConfigSchema = z
298
299
  message: "images must total at most 8 MiB decoded",
299
300
  });
300
301
  }
301
- const host: SystemOneHost = SYSTEM_ONE_HOSTS[config.provider];
302
+ const providerId = config.provider ?? SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER;
303
+ const host: SystemOneHost = SYSTEM_ONE_HOSTS[providerId];
302
304
  const service = host.extract;
303
305
  const modelProblem = systemOneModelProblem(
304
- config.provider,
306
+ providerId,
305
307
  config.model ?? service?.defaultModel,
306
308
  "extract",
307
309
  );
@@ -311,7 +313,7 @@ export const SystemOneExtractionConfigSchema = z
311
313
  ctx.addIssue({
312
314
  code: "custom",
313
315
  path: ["fields"],
314
- message: `SystemOne provider "${config.provider}" takes at most ${maxFields} fields per node; this node has ${fieldIds.length}.`,
316
+ message: `SystemOne provider "${providerId}" takes at most ${maxFields} fields per node; this node has ${fieldIds.length}.`,
315
317
  });
316
318
  }
317
319
  const maxImages = service?.limits?.maxImages;
@@ -319,7 +321,7 @@ export const SystemOneExtractionConfigSchema = z
319
321
  ctx.addIssue({
320
322
  code: "custom",
321
323
  path: ["images"],
322
- message: `SystemOne provider "${config.provider}" takes at most ${maxImages} images per node.`,
324
+ message: `SystemOne provider "${providerId}" takes at most ${maxImages} images per node.`,
323
325
  });
324
326
  }
325
327
  });
@@ -727,6 +729,10 @@ export class SystemOneExtractionExecutor extends BaseExecutor<
727
729
  return { db: this.deps.db, env: this.options.env ?? process.env };
728
730
  }
729
731
 
732
+ private defaultProvider(): Promise<SystemOneExtractProviderId> {
733
+ return resolveSystemOneExtractDefaultProvider(this.providerContext());
734
+ }
735
+
730
736
  private resolveTarget(id: SystemOneExtractProviderId, model?: string) {
731
737
  const { getApiKey, getServerUrl } = this.options;
732
738
  return resolveSystemOneTarget(id, this.providerContext(), {
@@ -742,9 +748,10 @@ export class SystemOneExtractionExecutor extends BaseExecutor<
742
748
  nodes: readonly ExecutorReadinessNode[],
743
749
  ): Promise<ExecutorReadinessProblem[]> {
744
750
  const nodeIdsByProvider = new Map<SystemOneExtractProviderId, string[]>();
751
+ const defaultId = await this.defaultProvider();
745
752
  for (const node of nodes) {
746
753
  // An unknown provider is a config error the schema reports; it names no credential.
747
- const id = systemOneExtractProviderOf(node.config);
754
+ const id = systemOneExtractProviderOf(node.config, defaultId);
748
755
  if (id) nodeIdsByProvider.set(id, [...(nodeIdsByProvider.get(id) ?? []), node.id]);
749
756
  }
750
757
  const problems: ExecutorReadinessProblem[] = [];
@@ -770,7 +777,7 @@ export class SystemOneExtractionExecutor extends BaseExecutor<
770
777
  async extract(
771
778
  config: SystemOneExtractionConfig,
772
779
  ): Promise<{ ok: true; output: SystemOneExtractionOutput } | { ok: false; error: string }> {
773
- const providerId = config.provider;
780
+ const providerId = config.provider ?? (await this.defaultProvider());
774
781
  const service = (SYSTEM_ONE_HOSTS[providerId] as SystemOneHost).extract;
775
782
  if (!service) {
776
783
  return { ok: false, error: `SystemOne provider "${providerId}" does not serve extraction` };
@@ -314,6 +314,9 @@ export const SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER: SystemOneExtractProviderId = "
314
314
  /** Global config key naming the decision provider a node or call without `provider` uses. */
315
315
  export const SYSTEM_ONE_DEFAULT_PROVIDER_CONFIG_KEY = "SYSTEM_ONE_DEFAULT_PROVIDER";
316
316
 
317
+ /** Global config key naming the extraction provider a node without `provider` uses. */
318
+ export const SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_CONFIG_KEY = "SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER";
319
+
317
320
  export function isSystemOneProviderId(value: unknown): value is SystemOneProviderId {
318
321
  return (
319
322
  typeof value === "string" && (SYSTEM_ONE_PROVIDER_IDS as readonly string[]).includes(value)
@@ -349,6 +352,23 @@ export function isSystemOneExtractProviderId(value: unknown): value is SystemOne
349
352
  );
350
353
  }
351
354
 
355
+ /** Resolve the extraction host from global config, then the environment, then the fallback. */
356
+ export async function resolveSystemOneExtractDefaultProvider(
357
+ ctx: SystemOneProviderContext,
358
+ ): Promise<SystemOneExtractProviderId> {
359
+ let stored: string | undefined;
360
+ try {
361
+ stored = await readGlobalConfig(ctx.db, SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_CONFIG_KEY);
362
+ } catch {
363
+ // An unreadable row uses the same fallback as an unset row.
364
+ }
365
+ for (const raw of [stored, ctx.env[SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER_CONFIG_KEY]]) {
366
+ const id = raw?.trim().toLowerCase();
367
+ if (isSystemOneExtractProviderId(id)) return id;
368
+ }
369
+ return SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER;
370
+ }
371
+
352
372
  /**
353
373
  * Provider a raw node config selects, `defaultId` when it names none. Undefined
354
374
  * when the field is present but not a known id.
@@ -364,8 +384,9 @@ export function systemOneProviderOf(
364
384
  /** Extraction provider a raw node config selects. Undefined when present but not a known id. */
365
385
  export function systemOneExtractProviderOf(
366
386
  config: Record<string, unknown>,
387
+ defaultId: SystemOneExtractProviderId = SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER,
367
388
  ): SystemOneExtractProviderId | undefined {
368
- if (config.provider === undefined) return SYSTEM_ONE_EXTRACT_DEFAULT_PROVIDER;
389
+ if (config.provider === undefined) return defaultId;
369
390
  return isSystemOneExtractProviderId(config.provider) ? config.provider : undefined;
370
391
  }
371
392
 
@@ -4,6 +4,7 @@ import {
4
4
  getTaskById,
5
5
  getWorkflowRun,
6
6
  getWorkflowRunStep,
7
+ markWorkflowStepTaskSuperseded,
7
8
  updateWorkflowRun,
8
9
  updateWorkflowRunStep,
9
10
  } from "../be/db";
@@ -216,9 +217,10 @@ export const SUPERSEDE_RETRY_POLICY: RetryPolicy = {
216
217
  * bound to the failed task, detach that task (the executor reuses any task
217
218
  * bound to the step, so a bound failed task would park the retry forever), and
218
219
  * record the failure with `nextRetryAt` so the retry poller re-dispatches a new
219
- * task. Bounded by `maxRetries` via the step's persisted `retryCount`, read
220
- * only after ownership is confirmed: a stale caller's step snapshot may carry
221
- * the counter of a newer attempt.
220
+ * task. A detached task failed by a supersede cut moves to `superseded`.
221
+ * Bounded by `maxRetries` via the step's persisted `retryCount`, read only
222
+ * after ownership is confirmed: a stale caller's step snapshot may carry the
223
+ * counter of a newer attempt.
222
224
  *
223
225
  * A foreach child (`<foreachId>#<key>`) with an `agent-task` body takes the
224
226
  * parent foreach node's `retry`, else the same supersede default. While queued
@@ -266,6 +268,9 @@ export async function scheduleTaskStepRetry(
266
268
  if (current.retryCount >= policy.maxRetries) return "not-eligible";
267
269
  await detachTaskFromWorkflowRunStep(taskId);
268
270
  await checkpointStepFailure(runId, step.id, reason, current.retryCount, policy);
271
+ // A supersede cut that gets a retry is not a real failure: the step goes
272
+ // on in a fresh task. A cut with no retry stays `failed`.
273
+ await markWorkflowStepTaskSuperseded(taskId);
269
274
  return "scheduled";
270
275
  });
271
276
  }
@@ -122,7 +122,7 @@ The maker uploads to `thoughts/<maker-agent-id>/videos/<slug>/` (versions as `<s
122
122
  agent-fs --org <ORG_ID> --drive <DRIVE_ID> write thoughts/<maker-agent-id>/videos/<slug>/<file>.mp4 --file ./out/<file>.mp4
123
123
  ```
124
124
 
125
- Hand each mp4 over as its live app link `${AGENT_FS_LIVE_URL}/file/~/<org>/<drive>/<path>`: the viewer plays it for a signed-in teammate. Make a `share-create` link only when the brief asks for one or names a reader without an agent-fs login (a customer, a public post, an outsider). Then run `agent-fs --org <ORG_ID> --drive <DRIVE_ID> share-create <path> --expires-in 604800 --json`; the share page plays with no login for 7 days at most. Report the url, the share id and the expiry. A raw signed URL downloads instead of playing, and agent-fs serves a raw `.mp4` as `application/octet-stream`. For a byte-exact copy back down: `agent-fs download <path> -o <file>` (`cat` is paginated and truncates).
125
+ Hand each mp4 over as the file link from the Outputs section of your system prompt (the dashboard when configured): the viewer plays it for a signed-in teammate. Make a `share-create` link only when the brief asks for one or names a reader without an agent-fs login (a customer, a public post, an outsider). Then run `agent-fs --org <ORG_ID> --drive <DRIVE_ID> share-create <path> --expires-in 604800 --json`; the share page plays with no login for 7 days at most. Report the url, the share id and the expiry. A raw signed URL downloads instead of playing, and agent-fs serves a raw `.mp4` as `application/octet-stream`. For a byte-exact copy back down: `agent-fs download <path> -o <file>` (`cat` is paginated and truncates).
126
126
 
127
127
  **Not run** for this playbook: `write` to a real drive and `share-create` (it publishes a public link). `write --file`, `share-create` and `signed-url --inline` flags were checked against the CLI's `--help`. `agent-fs download` was run on the example master.
128
128
 
@@ -127,7 +127,7 @@ window.frame = (f) => { render(f); return cv.toDataURL("image/png"); };
127
127
 
128
128
  - agent-fs: `thoughts/<maker-agent-id>/videos/<slug>/` (versions as `<slug>-v2`, `<slug>-v3`, never overwrite an earlier version).
129
129
  - Upload the mp4s, contact sheet(s), `facts.json`, the music json, and `reel.html` so the next round can start from it. After every non-trivial write, `agent-fs stat <path> --json` and check the size.
130
- - Link for each final mp4: the live app link `${AGENT_FS_LIVE_URL}/file/~/<org>/<drive>/<path>`; its viewer plays the mp4 for a signed-in teammate. Make a `share-create` link only when the brief asks for one or names a reader without an agent-fs login (a customer, a public post, an outsider). Then run `agent-fs --org <ORG_ID> --drive <DRIVE_ID> share-create <path> --expires-in 604800 --json`; the share page plays the video with no login for 7 days at most. Report the url, the share id and the expiry. Do not hand out raw signed URLs for video.
130
+ - Link for each final mp4: the file link from the Outputs section of your system prompt (the dashboard when configured); its viewer plays the mp4 for a signed-in teammate. Make a `share-create` link only when the brief asks for one or names a reader without an agent-fs login (a customer, a public post, an outsider). Then run `agent-fs --org <ORG_ID> --drive <DRIVE_ID> share-create <path> --expires-in 604800 --json`; the share page plays the video with no login for 7 days at most. Report the url, the share id and the expiry. Do not hand out raw signed URLs for video.
131
131
  - agent-fs serves a raw `.mp4` download as `application/octet-stream`; the viewer and the share page play it. Mention it rather than retrying.
132
132
  - Output (short): paths, live app links (plus share url, id and expiry only if asked), ffprobe line, model, each on-screen fact with its source and SHA/run id, music attribution (source link, license link, changes made), logo source. No Slack post by the maker; Lead relays.
133
133
 
@@ -16,6 +16,7 @@ Each folder holds exactly one `manifest.yaml`, `manifest.yml`, or `manifest.json
16
16
  | `slack-reply-gate` | `pre.task.create` | Asks Jev (TypeSafe or OpenRouter) whether Lead should answer a Slack thread follow-up; in `enforce` drops the wake-up and marks the message :mute: |
17
17
  | `comms-adherence-gate` | `pre.tool.call` | Asks Jev (TypeSafe or OpenRouter) whether a Slack task's final output matches the requester's comms preferences and latest request; in `enforce` blocks a non-adherent completion once per task |
18
18
  | `require-verification-note` | `pre.tool.call` | Refuses completion without a `Verified:` line in the output |
19
+ | `sql-admin-only` | `pre.tool.call` | Blocks `db-query` calls on tasks created by a non-admin user |
19
20
  | `task-digest` | `post.task.completed`, `post.task.failed` | Ships the `task-digest-collect` script, the `task-digest-daily` schedule (09:00 UTC), the `task-digest-report` workflow, and the `task-digest-guide` skill |
20
21
 
21
22
  A template can ship scripts, schedules, workflows (`workflows/*.yaml` or `.json`), and skills (`skills/<dir>/SKILL.md` plus optional `files/**`). Every asset name starts with `<name>-`, including the workflow `name` and the `SKILL.md` frontmatter `name`. Schedules, workflows, and skills stay off until the extension is enabled. An extension skill is global: install it on each agent with `skill-install` after you enable the extension.
@@ -0,0 +1,20 @@
1
+ # sql-admin-only
2
+
3
+ Blocks `db-query` tool calls made on a task whose creator (`requestedByUserId`) is not an admin. Every other tool call passes untouched.
4
+
5
+ | Task creator | `db-query` |
6
+ |---|---|
7
+ | Not set, or the call has no task | Allowed |
8
+ | The header's id has no task row (a session with no task) | Allowed |
9
+ | Set, holds an admin role | Allowed |
10
+ | Set, no admin role | Blocked |
11
+ | Set, but the lookup fails or times out | Blocked |
12
+
13
+ No config. "Admin" means the creator's `users.role` is `admin` (case-insensitive), the role the swarm shows next to a requester's name. Only Lead (`manage-user`) and REST callers with `user.role.manage` can set it. RBAC roles are not used, because every user is created with the RBAC `admin` role. A creator whose user row is gone counts as non-admin.
14
+
15
+ The task comes from the call's `X-Source-Task-Id` header. The lookup gets 60% of `EXTENSION_HANDLER_TIMEOUT_MS` (default 5s), because the dispatcher lets a call through when a hook times out.
16
+
17
+ Coverage limits:
18
+
19
+ - Only agent MCP tool calls run `pre.tool.call`. Scripts calling `ctx.swarm.db_query`, extensions, and direct `POST /api/db-query` requests skip the hook.
20
+ - A call without an `X-Source-Task-Id` header has no task, so it is allowed.