@desplega.ai/agent-swarm 2.8.2 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (558) hide show
  1. package/dist/acp-adapter-jqn86aam.js +16 -0
  2. package/dist/acp-targets-swxq55dr.js +23 -0
  3. package/dist/{actions-kxek041g.js → actions-pb678g3e.js} +22 -20
  4. package/dist/agent-fs-provision-dmhnc38q.js +27 -0
  5. package/dist/{amp-adapter-ce7jjke4.js → amp-adapter-3pa66q27.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-x2cp5fvf.js} +41 -41
  7. package/dist/{app-v6zz8yh0.js → app-17d12ev4.js} +6 -4
  8. package/dist/approval-notifications-h7vd9pmg.js +20 -0
  9. package/dist/{assistant-m0sw9xx2.js → assistant-t7k39ree.js} +56 -34
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-66bk37wv.js → boot-args-schema-0gqmkfbe.js} +1 -1
  12. package/dist/{boot-reembed-edjpwsc1.js → boot-reembed-f064w382.js} +1 -1
  13. package/dist/{boot-reembed-y27n09tz.js → boot-reembed-n6anc01d.js} +1 -1
  14. package/dist/{boot-scrub-sweep-1xc35965.js → boot-scrub-sweep-ejd5dnrz.js} +84 -13
  15. package/dist/{boot-seeds-7hjj91qj.js → boot-seeds-f99fjs5q.js} +4 -4
  16. package/dist/{boxd-ent8ch04.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-gvznwxgc.js +28 -0
  18. package/dist/{claude-managed-adapter-jh6c523j.js → claude-managed-adapter-pbrbvc64.js} +4 -4
  19. package/dist/{claude-managed-setup-y6z2perp.js → claude-managed-setup-kdxttvc3.js} +11 -11
  20. package/dist/{claude-sdk-session-vvya8wqk.js → claude-sdk-session-0t2teq6n.js} +9386 -9197
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-rmzsadkf.js → cli-1tvdx9t5.js} +2 -2
  23. package/dist/{cli-3vmb0n58.js → cli-25nstr34.js} +1 -1
  24. package/dist/{cli-959kp5h2.js → cli-2kg31ted.js} +45 -38
  25. package/dist/{cli-4vzgeta4.js → cli-2tnbc3gw.js} +375 -127
  26. package/dist/{cli-tekytdq9.js → cli-3zxdz9r7.js} +9 -9
  27. package/dist/{cli-bsywb58a.js → cli-4ghh072d.js} +16 -16
  28. package/dist/{cli-9mb2q6pb.js → cli-57pvhnyt.js} +4 -4
  29. package/dist/{cli-d84byzn8.js → cli-5a6pqy45.js} +441 -53
  30. package/dist/{cli-jrzkw01m.js → cli-5gpqgs8b.js} +2 -2
  31. package/dist/{cli-0cq8y6m7.js → cli-5gygrr67.js} +9 -9
  32. package/dist/{cli-z1w943va.js → cli-5kcmxwxv.js} +3 -3
  33. package/dist/{cli-3e875j5p.js → cli-5ntc4we6.js} +3189 -328
  34. package/dist/{cli-bst1vp7e.js → cli-5y2fvw4z.js} +13 -5
  35. package/dist/{cli-mrt48bx7.js → cli-6237rnyr.js} +1 -1
  36. package/dist/cli-6dp0jkfj.js +754 -0
  37. package/dist/{cli-b98a65ed.js → cli-7831nhaw.js} +5 -5
  38. package/dist/{cli-kjtwrhea.js → cli-7cgf614g.js} +10 -10
  39. package/dist/{cli-fwy8kfd6.js → cli-7fx9jyfs.js} +942 -63
  40. package/dist/{cli-28fq781p.js → cli-7zm3b3f5.js} +1 -1
  41. package/dist/{cli-v1dv1r37.js → cli-812paz57.js} +143 -9
  42. package/dist/{cli-837vfs2x.js → cli-8axx8vnw.js} +4 -4
  43. package/dist/cli-8x8y70av.js +103 -0
  44. package/dist/{cli-vj75tyaw.js → cli-95930z69.js} +15 -7
  45. package/dist/{cli-j24zbska.js → cli-9a2rtd77.js} +16 -14
  46. package/dist/cli-9ttx00s3.js +137 -0
  47. package/dist/{cli-6ek0hff4.js → cli-a9hfzg2r.js} +3 -3
  48. package/dist/{cli-dzpc6en0.js → cli-aa8s22gn.js} +19 -14
  49. package/dist/{cli-x1wa213s.js → cli-bk9v1xrv.js} +21 -21
  50. package/dist/{cli-a0z912j7.js → cli-c07v0qfa.js} +194 -75
  51. package/dist/{cli-1qkz151v.js → cli-c5cspahx.js} +28 -36
  52. package/dist/{cli-vdektqgf.js → cli-cw7mc1je.js} +4 -4
  53. package/dist/{cli-n6vtrcht.js → cli-dd37e0cm.js} +2 -2
  54. package/dist/cli-dqgnbnxs.js +132 -0
  55. package/dist/{cli-kc7v1nfv.js → cli-dx439zpg.js} +1 -1
  56. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  57. package/dist/{cli-f6bahpn5.js → cli-e9973bf0.js} +8 -6
  58. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  59. package/dist/{cli-6rc5frdm.js → cli-eepnpee7.js} +34 -37
  60. package/dist/{cli-rvhdmjvt.js → cli-eg437b5p.js} +1 -1
  61. package/dist/cli-faf46gdq.js +714 -0
  62. package/dist/{cli-f4r3g076.js → cli-fgphc007.js} +2 -2
  63. package/dist/{cli-5y340nzn.js → cli-fnh4b12r.js} +24 -18
  64. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  65. package/dist/{cli-e1p3n5gq.js → cli-g3zzby8t.js} +13 -13
  66. package/dist/{cli-3vjhs18n.js → cli-gabsjg8x.js} +3 -1
  67. package/dist/{cli-1pz0330a.js → cli-gddgcnav.js} +3 -3
  68. package/dist/{cli-97ae65rz.js → cli-h474mvp5.js} +11 -11
  69. package/dist/{cli-m88rpzkh.js → cli-hnamkvnc.js} +2 -2
  70. package/dist/{cli-8bpgbr8k.js → cli-j49yqpvh.js} +6 -6
  71. package/dist/{cli-w401b9tq.js → cli-jd3kxppb.js} +1 -1
  72. package/dist/{cli-m9s2qff2.js → cli-jg5txpm6.js} +187 -93
  73. package/dist/{cli-8aes17e4.js → cli-js8zrfyg.js} +3 -3
  74. package/dist/{cli-pfs8adn4.js → cli-k09cxm6m.js} +9 -7
  75. package/dist/{cli-q24n86d2.js → cli-k7pt28ad.js} +10 -3
  76. package/dist/{cli-zh9rsbqf.js → cli-kaa4bd7x.js} +11 -8
  77. package/dist/cli-kj0hyr43.js +51 -0
  78. package/dist/{cli-g70vxtjh.js → cli-kmvcm34h.js} +2 -2
  79. package/dist/{cli-t2tma8gb.js → cli-kqh27v2y.js} +2 -2
  80. package/dist/{cli-mxn1qvbn.js → cli-m1fbz2wj.js} +32 -57
  81. package/dist/{cli-2kvhc7x8.js → cli-mc1fx4xd.js} +51 -90
  82. package/dist/{cli-pchypa1s.js → cli-me4maa4j.js} +61 -6
  83. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  84. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  85. package/dist/cli-nhq5js1b.js +142 -0
  86. package/dist/cli-nmcpzbty.js +296 -0
  87. package/dist/cli-nr46j5pw.js +78 -0
  88. package/dist/{cli-5mrq3ake.js → cli-pn1v1pb0.js} +1 -1
  89. package/dist/{cli-f4e8r23x.js → cli-pwsax0vp.js} +11 -6
  90. package/dist/{cli-gyt3zydq.js → cli-pz1c00aa.js} +9 -754
  91. package/dist/{cli-eddnyg3t.js → cli-q2d3e1k1.js} +1 -1
  92. package/dist/{cli-fpjmegdb.js → cli-q8cfh1t9.js} +2 -2
  93. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  94. package/dist/{cli-2r0jcc3k.js → cli-qj39vrc6.js} +1 -1
  95. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  96. package/dist/{cli-0jzra9ad.js → cli-rts1qvb4.js} +2 -2
  97. package/dist/{cli-3rkdne1h.js → cli-sn4pc4qx.js} +2 -2
  98. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  99. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  100. package/dist/{cli-6wj7p986.js → cli-spzkdgtg.js} +3 -3
  101. package/dist/{cli-m2z8jagn.js → cli-srtkr1h2.js} +18 -18
  102. package/dist/{cli-2gxeg5gr.js → cli-ssvdrk4y.js} +1 -1
  103. package/dist/{cli-jdknh18m.js → cli-svc803vq.js} +69 -816
  104. package/dist/{cli-7349va39.js → cli-t9ga4qmb.js} +935 -445
  105. package/dist/{cli-m5akxq8q.js → cli-vs9vdpy0.js} +1 -1
  106. package/dist/{cli-26ctbcdp.js → cli-vvgaz8t6.js} +93 -44
  107. package/dist/{cli-3sy2xags.js → cli-vw5x18yj.js} +39 -69
  108. package/dist/{cli-kchjb7qy.js → cli-w16kwbzw.js} +1 -1
  109. package/dist/cli-w7dxb2fj.js +921 -0
  110. package/dist/{cli-x6t50dmw.js → cli-wr1h0k28.js} +3 -3
  111. package/dist/{cli-d6521kb5.js → cli-x40a0w9j.js} +1 -1
  112. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  113. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  114. package/dist/{cli-rcecc3yq.js → cli-ymct0ycy.js} +321 -111
  115. package/dist/{cli-xzm9vcfg.js → cli-zg3z63x3.js} +2 -2
  116. package/dist/cli.js +29 -26
  117. package/dist/{codex-adapter-zerf5qsp.js → codex-adapter-44yq2fkn.js} +9 -9
  118. package/dist/{codex-hook-30gyhzxe.js → codex-hook-h1zb7cfk.js} +6 -6
  119. package/dist/{codex-login-bcda78ge.js → codex-login-cdyrr5y1.js} +1 -1
  120. package/dist/{codex-session-runner-89s304py.js → codex-session-runner-zbh26gbw.js} +10 -10
  121. package/dist/{commands-jeh1b51j.js → commands-54f02v5b.js} +3 -3
  122. package/dist/{controller-mctfbrse.js → controller-9gpwcdek.js} +6 -6
  123. package/dist/{controllers-connect-nxa1ddwn.js → controllers-connect-61re6k1n.js} +26 -25
  124. package/dist/{cursor-adapter-qj8vehv6.js → cursor-adapter-7e4g81vd.js} +2 -2
  125. package/dist/{db-b36qn6k3.js → db-dg2gc7fd.js} +17 -13
  126. package/dist/{db-2dvay0es.js → db-wnh0qjy1.js} +3 -3
  127. package/dist/{devin-adapter-xedz98zv.js → devin-adapter-zp4tqq53.js} +1 -1
  128. package/dist/{dispatcher-gndbta01.js → dispatcher-jrm24r43.js} +19 -18
  129. package/dist/{docker-866qpzt9.js → docker-9aq30pp2.js} +5 -5
  130. package/dist/{dsh-adapter-f75sz821.js → dsh-adapter-1yqk267c.js} +2 -2
  131. package/dist/{e2b-3gpc2n3w.js → e2b-3v1e745x.js} +6 -6
  132. package/dist/{e2b-jbm7mj93.js → e2b-sm28k0k3.js} +6 -6
  133. package/dist/{easter-egg-3d-533knw22.js → easter-egg-3d-r4h9cs9m.js} +1 -1
  134. package/dist/{embedding-space-4p05vb2x.js → embedding-space-bafjr5f7.js} +6 -6
  135. package/dist/{embeddings-m6768mgh.js → embeddings-7xmgqe0e.js} +1 -1
  136. package/dist/{event-bus-e66gh7cc.js → event-bus-xr83x566.js} +1 -1
  137. package/dist/{execute-b3mrb1mv.js → execute-d6jg5ns0.js} +1 -1
  138. package/dist/{external-channel-gjv3jne3.js → external-channel-frq1xvq2.js} +2 -2
  139. package/dist/fx-adapter-0zrkfbkd.js +19 -0
  140. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  141. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  142. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  143. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  144. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  145. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-hh7strj3.js} +1 -1
  146. package/dist/{google-vertex-fhxaafzw.js → google-vertex-fy5bw2pm.js} +5 -5
  147. package/dist/grok-adapter-3db1c538.js +19 -0
  148. package/dist/handlers-k22n8mnn.js +33 -0
  149. package/dist/{heartbeat-a1tv60gt.js → heartbeat-6bpa611t.js} +22 -21
  150. package/dist/{hook-8h5dzcgq.js → hook-hvm5nf46.js} +5 -5
  151. package/dist/{hook-cyaps9ba.js → hook-w12k146y.js} +14 -14
  152. package/dist/{http-t15mhbd9.js → http-43tthdvs.js} +5838 -2600
  153. package/dist/{index-d6wkh8ar.js → index-1f0vypbg.js} +2 -2
  154. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  155. package/dist/{index-khe3gp0k.js → index-4b1q8kan.js} +20 -20
  156. package/dist/{index-hjhfk3ra.js → index-585gyczt.js} +1 -1
  157. package/dist/index-8xcyd3mc.js +33 -0
  158. package/dist/index-9sy2bh6n.js +38 -0
  159. package/dist/{index-2skqtd76.js → index-b24j7t2m.js} +30 -28
  160. package/dist/{index-gjwaqaq8.js → index-cret47a5.js} +6 -6
  161. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  162. package/dist/{index-w1zqf680.js → index-fn054vsf.js} +1 -1
  163. package/dist/{index-qav6455f.js → index-ftywhyr0.js} +214 -152
  164. package/dist/{index-tvfafeyy.js → index-mhq4sh5w.js} +1 -1
  165. package/dist/index-tx9mc2ap.js +570 -0
  166. package/dist/index-wjd56k1v.js +34 -0
  167. package/dist/{keepalive-91s7hzrb.js → keepalive-rk0j0jvh.js} +4 -4
  168. package/dist/lead-atxf3q6e.js +72 -0
  169. package/dist/{maintenance-7pjmy5xy.js → maintenance-g6z6kaxw.js} +1 -1
  170. package/dist/{node-4c5jqxr3.js → node-7qsx5kvm.js} +1 -1
  171. package/dist/{node-252anz2h.js → node-jftbyawr.js} +4 -4
  172. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  173. package/dist/{oauth-refresh-sweep-rzqfm94j.js → oauth-refresh-sweep-2k3g2q4w.js} +3 -3
  174. package/dist/{onboard-74st7pag.js → onboard-6fdbvh3v.js} +8 -8
  175. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  176. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  177. package/dist/{opencode-adapter-arn7gm8q.js → opencode-adapter-fdbsvts7.js} +7 -7
  178. package/dist/{otel-impl-rnzey8cb.js → otel-impl-rvwtc09q.js} +110 -110
  179. package/dist/pending-sqkrb836.js +80 -0
  180. package/dist/{pi-mono-adapter-6mkwq64n.js → pi-mono-adapter-asqayqcg.js} +13 -13
  181. package/dist/{pricing-refresh-ha21jhk7.js → pricing-refresh-f5tkgmw2.js} +2 -2
  182. package/dist/{rbac-roles-wqhma4dr.js → rbac-roles-06s555fa.js} +3 -3
  183. package/dist/{rbac-roles-59dxachk.js → rbac-roles-szxsg8t1.js} +10 -3
  184. package/dist/{render-v2-14kpzx12.js → render-v2-103p266q.js} +4 -4
  185. package/dist/{resume-gsa5fb5f.js → resume-v7kjewt9.js} +8 -7
  186. package/dist/{runtime-1hv06jsn.js → runtime-f1gmk0b7.js} +1 -1
  187. package/dist/{session-access-skm7bnp6.js → session-access-6shev8ts.js} +4 -4
  188. package/dist/{session-source-backfill-pbqzbncv.js → session-source-backfill-bd7spzjd.js} +3 -3
  189. package/dist/{setup-5yermsem.js → setup-kmxmztdb.js} +1 -1
  190. package/dist/thread-buffer-4yz236d0.js +36 -0
  191. package/dist/{virtual-modules-gazyapte.js → virtual-modules-57eje5wy.js} +5 -5
  192. package/dist/{work-objects-xj0ck0w4.js → work-objects-zr47ygmf.js} +23 -21
  193. package/dist/{worker-follow-up-911xc0b8.js → worker-follow-up-grrr3fda.js} +19 -18
  194. package/dist/worker-p4hbtcy3.js +72 -0
  195. package/dist/{x-2fyrt5pp.js → x-wg164ss9.js} +2 -2
  196. package/openapi.json +4518 -2356
  197. package/package.json +11 -8
  198. package/plugin/commands/create-pr.md +1 -1
  199. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  200. package/src/apps/action-runner.ts +21 -1
  201. package/src/apps/catalog.generated.json +626 -17
  202. package/src/apps/page-validator.ts +314 -8
  203. package/src/assets/key.ts +6 -0
  204. package/src/be/agent-fs-user-keys.ts +186 -0
  205. package/src/be/audit-user.ts +27 -13
  206. package/src/be/automation-preflight.test.ts +14 -14
  207. package/src/be/automation-preflight.ts +24 -16
  208. package/src/be/boot-scrub-sweep.ts +143 -14
  209. package/src/be/caller-session-group.ts +86 -0
  210. package/src/be/checklist.ts +375 -0
  211. package/src/be/db/agents.ts +12 -1
  212. package/src/be/db/approvals.ts +26 -0
  213. package/src/be/db/session-moves.ts +23 -0
  214. package/src/be/db/session-tree.ts +78 -19
  215. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  216. package/src/be/db/tasks/read.ts +33 -0
  217. package/src/be/db/tasks/slack-fold.ts +116 -0
  218. package/src/be/db/tasks/write.ts +34 -0
  219. package/src/be/db-queries/mcp-servers.ts +13 -0
  220. package/src/be/db-queries/oauth.ts +6 -0
  221. package/src/be/db-queries/task-artifacts.ts +10 -8
  222. package/src/be/db.ts +74 -22
  223. package/src/be/extensions/assets.ts +17 -13
  224. package/src/be/import/config.ts +54 -0
  225. package/src/be/import/dir-source.ts +372 -0
  226. package/src/be/import/index.ts +149 -0
  227. package/src/be/import/pending.ts +71 -0
  228. package/src/be/import/schema.ts +137 -0
  229. package/src/be/import/seeders.ts +462 -0
  230. package/src/be/migrations/289_automation_savings_daily.sql +47 -0
  231. package/src/be/migrations/291_task_slack_participants.sql +4 -0
  232. package/src/be/migrations/293_savings_component_links.sql +58 -0
  233. package/src/be/migrations/296_automation_savings_daily_read_index.sql +6 -0
  234. package/src/be/migrations/297_import_ownership.sql +34 -0
  235. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  236. package/src/be/migrations/302_checklist_items.sql +23 -0
  237. package/src/be/model-profile-check.ts +10 -2
  238. package/src/be/multi-runtime.ts +8 -1
  239. package/src/be/rbac-roles.ts +8 -1
  240. package/src/be/runtime-pools/demand.ts +20 -2
  241. package/src/be/runtime-pools/reachability.ts +31 -0
  242. package/src/be/runtime-pools/routing.ts +8 -1
  243. package/src/be/runtime-pools/supervisor.ts +6 -7
  244. package/src/be/savings/compute.ts +511 -16
  245. package/src/be/savings/model.ts +282 -14
  246. package/src/be/savings/read.ts +1502 -0
  247. package/src/be/savings/rollup.ts +571 -0
  248. package/src/be/script-credential-broker.ts +2 -2
  249. package/src/be/scripts/run-credential.ts +15 -3
  250. package/src/be/scripts/typecheck.ts +90 -8
  251. package/src/be/seed/agent-fs-provision.ts +104 -19
  252. package/src/be/seed/index.ts +1 -1
  253. package/src/be/seed/registry.ts +27 -8
  254. package/src/be/seed/runner.ts +1 -1
  255. package/src/be/seed/schedules-seeder.ts +24 -6
  256. package/src/be/seed/seed-toggle.ts +32 -0
  257. package/src/be/seed/types.ts +6 -0
  258. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  259. package/src/be/seed-scripts/catalog/dreaming-learnings.ts +10 -2
  260. package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +70 -4
  261. package/src/be/steering.ts +27 -4
  262. package/src/be/swarm-config-guard.ts +38 -0
  263. package/src/be/task-citations.ts +8 -5
  264. package/src/be/users.ts +29 -2
  265. package/src/commands/onboard/agent-fs-version.ts +1 -1
  266. package/src/commands/runner.ts +219 -42
  267. package/src/e2b/env.ts +2 -0
  268. package/src/extensions/catalog.generated.json +17 -0
  269. package/src/extensions/contract-types.generated.ts +1 -1
  270. package/src/github/app.ts +10 -1
  271. package/src/github/handlers.ts +6 -3
  272. package/src/github/reactions.ts +12 -14
  273. package/src/heartbeat/heartbeat.ts +14 -4
  274. package/src/http/agents.ts +19 -10
  275. package/src/http/all-routes.ts +2 -0
  276. package/src/http/approval-requests.ts +24 -4
  277. package/src/http/apps.ts +69 -5
  278. package/src/http/checklist.ts +176 -0
  279. package/src/http/db-query-bounded.ts +256 -11
  280. package/src/http/db-query-shared.ts +9 -0
  281. package/src/http/favorites.ts +14 -2
  282. package/src/http/fs.ts +346 -1
  283. package/src/http/index.ts +37 -2
  284. package/src/http/kv.ts +13 -0
  285. package/src/http/mcp-oauth.ts +1 -1
  286. package/src/http/mcp-servers.ts +15 -2
  287. package/src/http/onboarding.ts +2 -9
  288. package/src/http/poll.ts +59 -1
  289. package/src/http/requested-by.ts +97 -1
  290. package/src/http/savings.ts +676 -190
  291. package/src/http/script-connections.ts +1 -0
  292. package/src/http/scripts.ts +26 -15
  293. package/src/http/sessions.ts +17 -0
  294. package/src/http/slack-events.ts +101 -0
  295. package/src/http/status.ts +25 -7
  296. package/src/http/task-requester.ts +46 -0
  297. package/src/http/tasks.ts +107 -42
  298. package/src/http/users.ts +14 -0
  299. package/src/http/webhooks.ts +15 -0
  300. package/src/integrations/cards/index.ts +151 -0
  301. package/src/integrations/chat-sdk/outbound.ts +39 -13
  302. package/src/integrations/chat-sdk/runtime.ts +7 -1
  303. package/src/integrations/chat-sdk/status.ts +17 -0
  304. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  305. package/src/kv-reserved-namespaces.ts +17 -2
  306. package/src/oauth/presets.ts +29 -2
  307. package/src/prompts/base-prompt.ts +17 -4
  308. package/src/prompts/session-templates.ts +163 -9
  309. package/src/providers/acp-targets.ts +2 -2
  310. package/src/providers/amp-adapter.ts +1 -1
  311. package/src/providers/claude-adapter.ts +0 -20
  312. package/src/providers/claude-flag-settings.ts +12 -10
  313. package/src/providers/claude-managed-adapter.ts +5 -1
  314. package/src/providers/codex-adapter.ts +10 -35
  315. package/src/providers/codex-app-server.ts +2 -11
  316. package/src/providers/opencode-adapter.ts +41 -31
  317. package/src/providers/runtime-dependencies.ts +158 -0
  318. package/src/rbac/legacy-policy.ts +2 -0
  319. package/src/rbac/permissions.ts +10 -1
  320. package/src/scheduler/scheduler.ts +20 -14
  321. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  322. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  323. package/src/scripts-runtime/ctx.ts +1 -1
  324. package/src/scripts-runtime/egress-secrets.ts +2 -2
  325. package/src/scripts-runtime/executors/quickjs-bundle.ts +1 -0
  326. package/src/scripts-runtime/executors/quickjs-prelude.ts +162 -2
  327. package/src/scripts-runtime/executors/quickjs-runner.ts +4 -1
  328. package/src/scripts-runtime/stdlib/fetch.ts +113 -15
  329. package/src/scripts-runtime/stdlib/index.ts +3 -1
  330. package/src/scripts-runtime/stdlib/retry.ts +174 -0
  331. package/src/scripts-runtime/swarm-sdk.ts +187 -17
  332. package/src/scripts-runtime/types/stdlib.d.ts +97 -8
  333. package/src/scripts-runtime/types/swarm-extension.d.ts +27 -1
  334. package/src/scripts-runtime/types/swarm-sdk.d.ts +71 -6
  335. package/src/server.ts +4 -4
  336. package/src/slack/actions.ts +1 -0
  337. package/src/slack/app.ts +87 -46
  338. package/src/slack/assistant.ts +35 -7
  339. package/src/slack/enrich.ts +144 -50
  340. package/src/slack/handlers.ts +43 -99
  341. package/src/slack/http-receiver.ts +284 -0
  342. package/src/slack/inbound-dispatch.ts +43 -7
  343. package/src/slack/inbound-files.ts +33 -14
  344. package/src/slack/message-text.ts +47 -4
  345. package/src/slack/render-v2.ts +2 -1
  346. package/src/slack/socket-ack.ts +17 -10
  347. package/src/slack/steering.ts +5 -0
  348. package/src/slack/templates.ts +9 -0
  349. package/src/slack/thread-buffer-store.ts +58 -0
  350. package/src/slack/thread-buffer.ts +367 -109
  351. package/src/slack/thread-participants.ts +187 -0
  352. package/src/tasks/context-key.ts +24 -0
  353. package/src/tasks/sibling-awareness.ts +13 -1
  354. package/src/tests/agent-fs-live-url.test.ts +15 -0
  355. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  356. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  357. package/src/tests/agentfs-proxy.test.ts +8 -8
  358. package/src/tests/approval-card-resolution.test.ts +396 -0
  359. package/src/tests/approval-requests-notifications.test.ts +1 -1
  360. package/src/tests/approval-respond-auth.test.ts +28 -0
  361. package/src/tests/apps-action-parent-task.test.ts +140 -0
  362. package/src/tests/apps-catalog-additions.test.ts +315 -0
  363. package/src/tests/apps-catalog-files.test.ts +114 -0
  364. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  365. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  366. package/src/tests/apps-catalog-table.test.ts +47 -0
  367. package/src/tests/apps-chart-shell.test.ts +1 -1
  368. package/src/tests/apps-element-assembly.test.ts +52 -3
  369. package/src/tests/apps-session-thread.test.ts +182 -0
  370. package/src/tests/asset-key-invariants.test.ts +14 -0
  371. package/src/tests/base-prompt.test.ts +108 -23
  372. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  373. package/src/tests/caller-session-group.test.ts +199 -0
  374. package/src/tests/cards.test.ts +169 -0
  375. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  376. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  377. package/src/tests/chat-sdk-tools.test.ts +147 -0
  378. package/src/tests/checklist-nudge.test.ts +208 -0
  379. package/src/tests/checklist.test.ts +686 -0
  380. package/src/tests/claude-adapter-binary.test.ts +7 -1
  381. package/src/tests/claude-adapter.test.ts +10 -64
  382. package/src/tests/claude-flag-settings.test.ts +15 -11
  383. package/src/tests/claude-hook-credentials.test.ts +0 -1
  384. package/src/tests/claude-sdk-lifecycle.test.ts +5 -1
  385. package/src/tests/codex-adapter.test.ts +17 -78
  386. package/src/tests/codex-app-server.test.ts +16 -0
  387. package/src/tests/comb-config-guard.test.ts +21 -0
  388. package/src/tests/comb-default.test.ts +59 -97
  389. package/src/tests/comb-links.test.ts +86 -16
  390. package/src/tests/comb-status.test.ts +24 -27
  391. package/src/tests/create-page-tool.test.ts +101 -1
  392. package/src/tests/create-schedule-key.test.ts +105 -0
  393. package/src/tests/create-task-vcs-repo.test.ts +136 -0
  394. package/src/tests/credential-broker.test.ts +2 -2
  395. package/src/tests/db-query.test.ts +87 -1
  396. package/src/tests/db-task-read-contract.test.ts +3 -0
  397. package/src/tests/db-task-write-contract.test.ts +3 -1
  398. package/src/tests/docs-index-footprint.test.js +3 -3
  399. package/src/tests/dreaming-learnings.test.ts +104 -0
  400. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  401. package/src/tests/extensions-assets.test.ts +7 -3
  402. package/src/tests/extensions-catalog.test.ts +1 -0
  403. package/src/tests/extensions-example-sql-admin-only.test.ts +198 -0
  404. package/src/tests/extensions-pre-task.test.ts +7 -5
  405. package/src/tests/extensions-steering.test.ts +14 -2
  406. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  407. package/src/tests/fetch-resolved-env.test.ts +115 -1
  408. package/src/tests/fixtures/import-package.ts +32 -0
  409. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  410. package/src/tests/fs-routes.test.ts +505 -2
  411. package/src/tests/github-ghes-mock.test.ts +196 -0
  412. package/src/tests/github-host.test.ts +285 -0
  413. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  414. package/src/tests/heartbeat.test.ts +56 -0
  415. package/src/tests/import-config.test.ts +209 -0
  416. package/src/tests/import.test.ts +464 -0
  417. package/src/tests/invites-http.test.ts +144 -1
  418. package/src/tests/kv-http.test.ts +11 -0
  419. package/src/tests/literal-matcher.test.ts +58 -0
  420. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  421. package/src/tests/oauth-presets.test.ts +12 -0
  422. package/src/tests/opencode-adapter.test.ts +53 -6
  423. package/src/tests/pool-affinity.test.ts +50 -0
  424. package/src/tests/prompt-template-session.test.ts +69 -6
  425. package/src/tests/provider-registration.test.ts +2 -55
  426. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  427. package/src/tests/rbac-admission.test.ts +19 -0
  428. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  429. package/src/tests/rbac-engine.test.ts +2 -0
  430. package/src/tests/rbac-roles.test.ts +2 -0
  431. package/src/tests/runner-missing-dependency.test.ts +61 -0
  432. package/src/tests/runner-requester-profile.test.ts +139 -1
  433. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  434. package/src/tests/runtime-pool-routing.test.ts +52 -0
  435. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  436. package/src/tests/savings-compound.test.ts +774 -0
  437. package/src/tests/savings-compute.test.ts +7 -198
  438. package/src/tests/savings-fleet-latency.test.ts +143 -0
  439. package/src/tests/savings-fleet-read.test.ts +195 -0
  440. package/src/tests/savings-fleet-scale.test.ts +222 -0
  441. package/src/tests/savings-fleet-slices.test.ts +122 -0
  442. package/src/tests/savings-model.test.ts +212 -0
  443. package/src/tests/savings-read.test.ts +408 -0
  444. package/src/tests/savings-rollup.test.ts +766 -0
  445. package/src/tests/savings-scripts.test.ts +617 -0
  446. package/src/tests/script-connections.test.ts +4 -0
  447. package/src/tests/script-executor-conformance.test.ts +481 -0
  448. package/src/tests/scripts-http.test.ts +55 -0
  449. package/src/tests/scripts-runtime-fetch.test.ts +2 -2
  450. package/src/tests/secret-rules.test.ts +124 -1
  451. package/src/tests/secret-scrub-gate.test.ts +257 -0
  452. package/src/tests/secret-scrubber.test.ts +1 -1
  453. package/src/tests/seed-registry.test.ts +142 -9
  454. package/src/tests/session-source-keys.test.ts +42 -1
  455. package/src/tests/sessions-move.test.ts +70 -0
  456. package/src/tests/sessions-tree.test.ts +98 -0
  457. package/src/tests/sessions.test.ts +69 -0
  458. package/src/tests/slack-config.test.ts +4 -18
  459. package/src/tests/slack-dm-implicit-mention.test.ts +20 -1
  460. package/src/tests/slack-http-receiver.test.ts +472 -0
  461. package/src/tests/slack-identity-resolution.test.ts +23 -0
  462. package/src/tests/slack-inbound-files.test.ts +2 -1
  463. package/src/tests/slack-inbound-logging.test.ts +64 -0
  464. package/src/tests/slack-leave-thread.test.ts +1 -1
  465. package/src/tests/slack-message-text.test.ts +104 -0
  466. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  467. package/src/tests/slack-render-v2.test.ts +48 -0
  468. package/src/tests/slack-skip-reaction.test.ts +2 -2
  469. package/src/tests/slack-steering.test.ts +22 -10
  470. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  471. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  472. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  473. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  474. package/src/tests/slack-thread-buffer.test.ts +34 -34
  475. package/src/tests/slack-thread-participants.test.ts +447 -0
  476. package/src/tests/slack-tool-blocks.test.ts +167 -0
  477. package/src/tests/status.test.ts +32 -6
  478. package/src/tests/steering-core.test.ts +13 -0
  479. package/src/tests/steering-enabled.test.ts +7 -1
  480. package/src/tests/steering-promotion.test.ts +24 -0
  481. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  482. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  483. package/src/tests/task-artifacts.test.ts +50 -0
  484. package/src/tests/task-session-prompts.test.ts +95 -1
  485. package/src/tests/tool-annotations.test.ts +30 -0
  486. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  487. package/src/tools/chat-post.ts +19 -4
  488. package/src/tools/chat-reply.ts +20 -4
  489. package/src/tools/create-page.ts +21 -4
  490. package/src/tools/get-swarm.ts +18 -2
  491. package/src/tools/join-swarm.ts +2 -1
  492. package/src/tools/kv/kv-write-auth.ts +17 -1
  493. package/src/tools/schedules/create-schedule.ts +22 -4
  494. package/src/tools/slack-post.ts +40 -7
  495. package/src/tools/slack-reply.ts +50 -14
  496. package/src/types.ts +74 -2
  497. package/src/utils/constants.ts +60 -138
  498. package/src/utils/github-host.ts +217 -0
  499. package/src/utils/github-pull-request.ts +8 -5
  500. package/src/utils/literal-matcher.ts +118 -0
  501. package/src/utils/mcp-server-fetcher.test.ts +89 -0
  502. package/src/utils/mcp-server-fetcher.ts +13 -5
  503. package/src/utils/request-auth-context.ts +24 -0
  504. package/src/utils/secret-rules.generated.ts +1 -1
  505. package/src/utils/secret-scrubber.ts +485 -54
  506. package/src/utils/task-attachment-links.ts +9 -12
  507. package/src/vcs/index.ts +3 -0
  508. package/src/workflows/approval-notifications.ts +188 -12
  509. package/src/workflows/executors/swarm-script.ts +23 -19
  510. package/src/workflows/executors/system-one-extraction.ts +14 -7
  511. package/src/workflows/executors/system-one-providers.ts +22 -1
  512. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  513. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  514. package/templates/extensions/README.md +1 -0
  515. package/templates/extensions/sql-admin-only/README.md +19 -0
  516. package/templates/extensions/sql-admin-only/hooks.ts +96 -0
  517. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  518. package/templates/import/manifest.schema.json +136 -0
  519. package/templates/import/sources.schema.json +44 -0
  520. package/templates/skills/agent-browser/SKILL.md +1 -1
  521. package/templates/skills/agent-browser/content.md +1 -1
  522. package/templates/skills/apps/SKILL.md +122 -12
  523. package/templates/skills/apps/content.md +122 -12
  524. package/templates/skills/asset-namespaces/content.md +2 -1
  525. package/templates/skills/chat-sdk/content.md +17 -0
  526. package/templates/skills/db-query-guidance/content.md +2 -1
  527. package/templates/skills/scheduling/content.md +27 -0
  528. package/templates/skills/slack-interaction/content.md +12 -2
  529. package/templates/skills/swarm-docs/content.md +1 -0
  530. package/templates/skills/swarm-extensions/config.json +1 -1
  531. package/templates/skills/swarm-extensions/content.md +33 -23
  532. package/templates/skills/swarm-scripts/SKILL.md +18 -4
  533. package/templates/skills/swarm-scripts/content.md +18 -4
  534. package/templates/skills/work-on-task/SKILL.md +1 -1
  535. package/templates/skills/work-on-task/content.md +1 -1
  536. package/templates/skills/workflow-iterate/content.md +4 -7
  537. package/templates/workflows/dreaming/content.md +3 -3
  538. package/dist/acp-adapter-fqzkxyra.js +0 -15
  539. package/dist/claude-adapter-stw7jdcf.js +0 -25
  540. package/dist/cli-4bd1rck6.js +0 -4
  541. package/dist/cli-dns0y538.js +0 -194
  542. package/dist/cli-g5mtmf6t.js +0 -432
  543. package/dist/cli-xf3qw745.js +0 -104
  544. package/dist/fx-adapter-rpsgb1tw.js +0 -18
  545. package/dist/grok-adapter-n2m3zjg1.js +0 -18
  546. package/dist/handlers-nv8edn19.js +0 -32
  547. package/dist/index-ksmyd6kc.js +0 -37
  548. package/dist/index-rjnrje98.js +0 -32
  549. package/dist/index-tv3413wy.js +0 -33
  550. package/dist/lead-3hmddvrm.js +0 -70
  551. package/dist/worker-qgg0m2gw.js +0 -70
  552. package/src/providers/ctx-mode-env.ts +0 -10
  553. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  554. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  555. package/dist/{index-0rvk3vd4.js → index-bs7gw5fd.js} +3 -3
  556. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  557. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  558. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -313,8 +313,8 @@ export interface SwarmSdk {
313
313
  }): Promise<unknown>;
314
314
 
315
315
  // --- write: slack ---
316
- slack_post(args: { channelId: string; message: string; blocks?: unknown }): Promise<unknown>;
317
- slack_reply(args: { channelId?: string; threadTs?: string; message: string; taskId?: string; blocks?: unknown }): Promise<unknown>;
316
+ slack_post(args: { channelId: string; message?: string; blocks?: unknown; card?: unknown }): Promise<unknown>;
317
+ slack_reply(args: { channelId?: string; threadTs?: string; message?: string; taskId?: string; blocks?: unknown; card?: unknown }): Promise<unknown>;
318
318
  slack_startThread(args: { channelId: string; message: string; blocks?: unknown }): Promise<unknown>;
319
319
  slack_createChannel(args: { name: string; isPrivate?: boolean }): Promise<unknown>;
320
320
  slack_inviteToChannel(args: { channelId: string; userIds: string[] }): Promise<unknown>;
@@ -326,8 +326,8 @@ export interface SwarmSdk {
326
326
  slack_leaveThread(args: { taskId?: string; channelId?: string; threadTs?: string }): Promise<unknown>;
327
327
 
328
328
  // --- write: chat sdk ---
329
- chat_reply(args: { text: string }): Promise<unknown>;
330
- chat_post(args: { adapter: "telegram" | "slack" | "discord" | "teams"; threadId?: string; channelId?: string; text: string }): Promise<unknown>;
329
+ chat_reply(args: { text?: string; card?: unknown }): Promise<unknown>;
330
+ chat_post(args: { adapter: "telegram" | "slack" | "discord" | "teams"; threadId?: string; channelId?: string; text?: string; card?: unknown }): Promise<unknown>;
331
331
  chat_openDm(args: { adapter: "telegram" | "slack" | "discord" | "teams"; userId: string }): Promise<unknown>;
332
332
  chat_registerChannel(args: { adapter: "telegram" | "slack" | "discord" | "teams"; channelId: string; agentId?: string; workflowId?: string; name?: string }): Promise<unknown>;
333
333
  chat_unregisterChannel(args: { adapter: "telegram" | "slack" | "discord" | "teams"; channelId: string }): Promise<unknown>;
@@ -483,12 +483,70 @@ export interface SwarmSdk {
483
483
  }): Promise<unknown>;
484
484
  }
485
485
 
486
+ export interface RetryOptions {
487
+ /** Retries after the first call. Default 3, so at most 4 calls. */
488
+ retries?: number;
489
+ /** First backoff delay in ms. Doubles on each retry, with jitter. Default 200. */
490
+ minDelayMs?: number;
491
+ /** Cap on a single wait, including a Retry-After wait. Default 5000. */
492
+ maxDelayMs?: number;
493
+ /** Total time across all calls and waits, in ms. Default 30000. */
494
+ budgetMs?: number;
495
+ /**
496
+ * Decides whether to retry: gets the thrown error or the returned value and
497
+ * the 1-based attempt. Default: retry any throw, plus a failed fetch Response,
498
+ * ctx.api raw result or ctx.swarm envelope with status 429, 502, 503 or 504.
499
+ */
500
+ retryOn?: (errorOrResult: unknown, attempt: number) => boolean | Promise<boolean>;
501
+ /** Stops the retries: once it aborts, the wait ends and retry rejects with its reason. */
502
+ signal?: AbortSignal;
503
+ }
504
+
505
+ export interface FetchRetryOptions extends RetryOptions {
506
+ /**
507
+ * Sends an Idempotency-Key header, the same value on every attempt: true
508
+ * generates a UUID per call, a string is used as is. A POST or PATCH with
509
+ * the header also retries 502/503/504 and network errors. It only prevents
510
+ * a duplicate when the server dedupes by the key.
511
+ */
512
+ idempotencyKey?: boolean | string;
513
+ }
514
+
515
+ /**
516
+ * ctx.stdlib.fetch options. Default retries: 429 on every method (Retry-After
517
+ * honoured); 502/503/504 and network errors on GET, HEAD, OPTIONS, PUT, DELETE,
518
+ * or any request with an Idempotency-Key. A stream body gets one attempt.
519
+ */
520
+ export type FetchOptions = RequestInit & {
521
+ /** false: one attempt. true or omitted: the defaults above. An object tunes them. */
522
+ retry?: boolean | FetchRetryOptions;
523
+ /** @deprecated Use retry: { retries }. Total attempts, so retries: 1 is one attempt. */
524
+ retries?: number;
525
+ /** Per-attempt timeout in ms. Default 30000. */
526
+ timeoutMs?: number;
527
+ };
528
+
529
+ export interface Retry {
530
+ /**
531
+ * Calls fn(attempt) (sync or async) until it succeeds or a retry is not
532
+ * warranted. Out of attempts or budget: rethrows the last error or returns
533
+ * the last result. Honours Retry-After on a 429, capped by maxDelayMs.
534
+ */
535
+ <T>(fn: (attempt: number) => T | Promise<T>, options?: RetryOptions): Promise<Awaited<T>>;
536
+ /** Returns a reusable function with fn's arguments that retries each call. */
537
+ wrap<A extends unknown[], T>(
538
+ fn: (...args: A) => T | Promise<T>,
539
+ options?: RetryOptions,
540
+ ): (...args: A) => Promise<Awaited<T>>;
541
+ }
542
+
486
543
  export interface ScriptStdlib {
487
- fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
488
- fetchJson(input: string | URL | Request, init?: RequestInit): Promise<unknown>;
544
+ fetch(input: string | URL | Request, init?: FetchOptions): Promise<Response>;
545
+ fetchJson(input: string | URL | Request, init?: FetchOptions): Promise<unknown>;
489
546
  grep(pattern: string, files?: string | string[]): Promise<string>;
490
547
  glob(pattern: string): Promise<string[]>;
491
548
  table(rows: Array<Record<string, unknown>>): string;
549
+ retry: Retry;
492
550
  Redacted: RedactedStatic;
493
551
  }
494
552
 
@@ -639,11 +697,35 @@ declare module "stdlib" {
639
697
  meta<T>(self: Redacted<T>): { type: "system" | "user"; isSecret: boolean };
640
698
  isSecret<T>(self: Redacted<T>): boolean;
641
699
  };
642
- export function fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
643
- export function fetchJson(input: string | URL | Request, init?: RequestInit): Promise<unknown>;
700
+ export function fetch(input: string | URL | Request, init?: FetchOptions): Promise<Response>;
701
+ export function fetchJson(input: string | URL | Request, init?: FetchOptions): Promise<unknown>;
644
702
  export function grep(pattern: string, files?: string | string[]): Promise<string>;
645
703
  export function glob(pattern: string): Promise<string[]>;
646
704
  export function table(rows: Array<Record<string, unknown>>): string;
705
+ export interface RetryOptions {
706
+ retries?: number;
707
+ minDelayMs?: number;
708
+ maxDelayMs?: number;
709
+ budgetMs?: number;
710
+ retryOn?: (errorOrResult: unknown, attempt: number) => boolean | Promise<boolean>;
711
+ signal?: AbortSignal;
712
+ }
713
+ export interface FetchRetryOptions extends RetryOptions {
714
+ idempotencyKey?: boolean | string;
715
+ }
716
+ export type FetchOptions = RequestInit & {
717
+ retry?: boolean | FetchRetryOptions;
718
+ /** @deprecated Use retry: { retries }. Total attempts. */
719
+ retries?: number;
720
+ timeoutMs?: number;
721
+ };
722
+ export const retry: {
723
+ <T>(fn: (attempt: number) => T | Promise<T>, options?: RetryOptions): Promise<Awaited<T>>;
724
+ wrap<A extends unknown[], T>(
725
+ fn: (...args: A) => T | Promise<T>,
726
+ options?: RetryOptions,
727
+ ): (...args: A) => Promise<Awaited<T>>;
728
+ };
647
729
  }
648
730
  `;
649
731
 
@@ -38,6 +38,7 @@ type InviteTarget = {
38
38
  };
39
39
 
40
40
  type OrgMember = {
41
+ userId?: string;
41
42
  email?: string | null;
42
43
  role?: string | null;
43
44
  user?: { email?: string | null } | null;
@@ -45,10 +46,11 @@ type OrgMember = {
45
46
 
46
47
  type FetchLike = typeof fetch;
47
48
 
48
- class AgentFsRequestError extends Error {
49
+ export class AgentFsRequestError extends Error {
49
50
  constructor(
50
51
  message: string,
51
52
  readonly status: number,
53
+ readonly body: string,
52
54
  ) {
53
55
  super(message);
54
56
  }
@@ -151,6 +153,17 @@ async function storeProvisionHash(value: string): Promise<void> {
151
153
  });
152
154
  }
153
155
 
156
+ /** The API-owned bootstrap key: stored config, then env, then the legacy shared key. Empty when none. */
157
+ async function resolveSharedApiKey(): Promise<string> {
158
+ return (
159
+ (await getConfigValue(API_KEY_CONFIG)) ||
160
+ process.env.API_AGENT_FS_API_KEY ||
161
+ process.env.AGENT_FS_API_KEY ||
162
+ (await getConfigValue(LEGACY_SHARED_KEY_CONFIG)) ||
163
+ ""
164
+ );
165
+ }
166
+
154
167
  export async function ensureAgentFsSharedProvisioning(options?: {
155
168
  apiUrl?: string;
156
169
  registerEmail?: string;
@@ -165,12 +178,7 @@ export async function ensureAgentFsSharedProvisioning(options?: {
165
178
  if (!apiUrl) throw new Error("AGENT_FS_API_URL is not configured");
166
179
 
167
180
  const registerEmail = options?.registerEmail ?? (await resolveRegisterEmail());
168
- let apiKey =
169
- (await getConfigValue(API_KEY_CONFIG)) ||
170
- process.env.API_AGENT_FS_API_KEY ||
171
- process.env.AGENT_FS_API_KEY ||
172
- (await getConfigValue(LEGACY_SHARED_KEY_CONFIG)) ||
173
- "";
181
+ let apiKey = await resolveSharedApiKey();
174
182
 
175
183
  if (!apiKey) {
176
184
  const registered = await agentFsRequest<{
@@ -236,6 +244,70 @@ export type SharedOrgInviteResult = {
236
244
  token?: string;
237
245
  };
238
246
 
247
+ /** Use complete shared credentials without writes. Provision missing credentials otherwise. */
248
+ export async function resolveAgentFsSharedContext(): Promise<{
249
+ apiUrl: string;
250
+ orgId: string;
251
+ driveId: string;
252
+ authHeaders: Record<string, string>;
253
+ } | null> {
254
+ const apiUrl = await resolveApiUrl();
255
+ if (!apiUrl) return null;
256
+ const apiKey = await resolveSharedApiKey();
257
+ const orgId =
258
+ (await getConfigValue("AGENT_FS_DEFAULT_ORG_ID")) ||
259
+ process.env.AGENT_FS_DEFAULT_ORG_ID ||
260
+ (await getConfigValue("AGENT_FS_SHARED_ORG_ID")) ||
261
+ process.env.AGENT_FS_SHARED_ORG_ID;
262
+ const driveId =
263
+ (await getConfigValue("AGENT_FS_DEFAULT_DRIVE_ID")) || process.env.AGENT_FS_DEFAULT_DRIVE_ID;
264
+ if (apiKey && orgId && driveId) {
265
+ return { apiUrl, orgId, driveId, authHeaders: { authorization: `Bearer ${apiKey}` } };
266
+ }
267
+ return ensureAgentFsSharedProvisioning({ apiUrl });
268
+ }
269
+
270
+ /**
271
+ * Tell agent-fs which swarm the shared org trusts, so the live app can offer
272
+ * "Continue with <swarm>" (`PATCH /orgs/{orgId}` with `{ swarmUrl }`). Runs
273
+ * once per boot, after the seeders, with the explicit `APP_URL`. No URL (the
274
+ * hosted fallback is not this swarm) or an unprovisioned shared org is
275
+ * "skipped": it never provisions. The org is read first, and the swarm writes
276
+ * only when its `swarmUrl` is empty: an org admin can set it in the agent-fs
277
+ * app, and the swarm never overwrites that. A matching value is "unchanged",
278
+ * a different one is "kept", and neither writes. An agent-fs without the
279
+ * route (404 or 405, for example 0.18.17) is "unsupported", not an error.
280
+ */
281
+ export async function syncAgentFsOrgSwarmUrl(
282
+ swarmUrl: string | undefined,
283
+ ): Promise<"set" | "unchanged" | "kept" | "unsupported" | "skipped"> {
284
+ if (!swarmUrl) return "skipped";
285
+ const apiUrl = await resolveApiUrl();
286
+ const apiKey =
287
+ (await getConfigValue(API_KEY_CONFIG)) ||
288
+ process.env.API_AGENT_FS_API_KEY ||
289
+ process.env.AGENT_FS_API_KEY;
290
+ const orgId =
291
+ (await getConfigValue("AGENT_FS_DEFAULT_ORG_ID")) || process.env.AGENT_FS_DEFAULT_ORG_ID;
292
+ if (!apiUrl || !apiKey || !orgId) return "skipped";
293
+ const orgPath = `/orgs/${encodeURIComponent(orgId)}`;
294
+ const headers = { authorization: `Bearer ${apiKey}` };
295
+ try {
296
+ const org = await agentFsRequest<{ swarmUrl?: unknown }>(apiUrl, orgPath, { headers });
297
+ const current = typeof org?.swarmUrl === "string" ? org.swarmUrl.trim() : "";
298
+ // agent-fs drops the trailing slash when it stores the value.
299
+ if (current === swarmUrl.replace(/\/+$/, "")) return "unchanged";
300
+ if (current) return "kept";
301
+ await agentFsRequest(apiUrl, orgPath, { method: "PATCH", headers, body: { swarmUrl } });
302
+ return "set";
303
+ } catch (error) {
304
+ if (error instanceof AgentFsRequestError && (error.status === 404 || error.status === 405)) {
305
+ return "unsupported";
306
+ }
307
+ throw error;
308
+ }
309
+ }
310
+
239
311
  /**
240
312
  * Invite an external (non-agent) member into the shared org using the
241
313
  * API-owned bootstrap credentials. Powers `POST /api/fs/members/invite` so
@@ -254,7 +326,8 @@ export async function inviteEmailToSharedOrg(
254
326
  email: string,
255
327
  role: Role,
256
328
  ): Promise<SharedOrgInviteResult> {
257
- const shared = await ensureAgentFsSharedProvisioning();
329
+ const shared = await resolveAgentFsSharedContext();
330
+ if (!shared) throw new Error("AGENT_FS_API_URL is not configured");
258
331
  const currentRoles = await getCurrentOrgMemberRoles(
259
332
  shared.apiUrl,
260
333
  shared.authHeaders,
@@ -517,20 +590,29 @@ async function getCurrentOrgMemberRoles(
517
590
  headers: Record<string, string>,
518
591
  orgId: string,
519
592
  ): Promise<Map<string, Role>> {
593
+ const roles = new Map<string, Role>();
594
+ for (const member of await getCurrentOrgMembers(apiUrl, headers, orgId)) {
595
+ roles.set(member.email, member.role);
596
+ }
597
+
598
+ return roles;
599
+ }
600
+
601
+ export async function getCurrentOrgMembers(
602
+ apiUrl: string,
603
+ headers: Record<string, string>,
604
+ orgId: string,
605
+ ): Promise<Array<{ userId?: string; email: string; role: Role }>> {
520
606
  const response = await agentFsRequest<{ members?: OrgMember[] }>(
521
607
  apiUrl,
522
608
  `/orgs/${encodeURIComponent(orgId)}/members`,
523
609
  { headers },
524
610
  );
525
- const roles = new Map<string, Role>();
526
-
527
- for (const member of response.members ?? []) {
611
+ return (response.members ?? []).flatMap((member) => {
528
612
  const email = (member.email ?? member.user?.email ?? "").trim().toLowerCase();
529
613
  const role = normalizeRole(member.role);
530
- if (email && role) roles.set(email, role);
531
- }
532
-
533
- return roles;
614
+ return email && role ? [{ userId: member.userId, email, role }] : [];
615
+ });
534
616
  }
535
617
 
536
618
  function normalizeRole(role: string | null | undefined): Role | null {
@@ -538,11 +620,11 @@ function normalizeRole(role: string | null | undefined): Role | null {
538
620
  return null;
539
621
  }
540
622
 
541
- function roleRank(role: Role): number {
623
+ export function roleRank(role: Role): number {
542
624
  return { viewer: 0, editor: 1, admin: 2 }[role];
543
625
  }
544
626
 
545
- async function agentFsRequest<T = unknown>(
627
+ export async function agentFsRequest<T = unknown>(
546
628
  apiUrl: string,
547
629
  path: string,
548
630
  options: {
@@ -565,15 +647,18 @@ async function agentFsRequest<T = unknown>(
565
647
  if (!response.ok && !(options.allowConflict && response.status === 409)) {
566
648
  const text = await response.text().catch(() => "");
567
649
  throw new AgentFsRequestError(
568
- `agent-fs ${options.method ?? "GET"} ${path} failed: HTTP ${response.status}${text ? ` ${text}` : ""}`,
650
+ scrubSecrets(
651
+ `agent-fs ${options.method ?? "GET"} ${path} failed: HTTP ${response.status}${text ? ` ${text}` : ""}`,
652
+ ),
569
653
  response.status,
654
+ text,
570
655
  );
571
656
  }
572
657
 
573
658
  return (await response.json().catch(() => ({}))) as T;
574
659
  }
575
660
 
576
- async function resolveApiUrl(): Promise<string> {
661
+ export async function resolveApiUrl(): Promise<string> {
577
662
  const raw = process.env.AGENT_FS_API_URL || (await getConfigValue("AGENT_FS_API_URL")) || "";
578
663
  return raw.trim().replace(/\/+$/, "");
579
664
  }
@@ -3,7 +3,7 @@
3
3
  * contract and the versioning rule the harness enforces.
4
4
  */
5
5
 
6
- export { runAllSeeders, SEEDERS } from "./registry";
6
+ export { buildSeeders, runAllSeeders, SEEDERS } from "./registry";
7
7
  export { runSeeder, runSeeders } from "./runner";
8
8
  export { getSeedState, recordSeedState } from "./state-db";
9
9
  export type { SeedAction, Seeder, SeederResult, SeederRunOptions, SeedItem } from "./types";
@@ -10,17 +10,36 @@ import { scriptsSeeder } from "../seed-scripts";
10
10
  import { skillsSeeder } from "../seed-skills";
11
11
  import { agentFsProvisionSeeder } from "./agent-fs-provision";
12
12
  import { runSeeders } from "./runner";
13
- import { schedulesSeeder } from "./schedules-seeder";
13
+ import { createSchedulesSeeder } from "./schedules-seeder";
14
+ import {
15
+ isSeedSchedulesEnabled,
16
+ isSeedScriptsEnabled,
17
+ isSeedSkillsEnabled,
18
+ isSeedWorkflowsEnabled,
19
+ } from "./seed-toggle";
14
20
  import type { Seeder, SeederResult, SeederRunOptions } from "./types";
15
21
  import { workflowsSeeder } from "./workflows-seeder";
16
22
 
17
- export const SEEDERS: Seeder[] = [
18
- agentFsProvisionSeeder,
19
- scriptsSeeder,
20
- skillsSeeder,
21
- workflowsSeeder,
22
- schedulesSeeder,
23
- ];
23
+ /**
24
+ * Build the active seeder list from the per-kind opt-out flags (see
25
+ * {@link ./seed-toggle}). `agentFsProvisionSeeder` always runs: it provisions
26
+ * storage the swarm needs to boot, regardless of catalog-content preference.
27
+ */
28
+ export function buildSeeders(env: NodeJS.ProcessEnv = process.env): Seeder[] {
29
+ const seeders: Seeder[] = [agentFsProvisionSeeder];
30
+ if (isSeedScriptsEnabled(env)) seeders.push(scriptsSeeder);
31
+ if (isSeedSkillsEnabled(env)) seeders.push(skillsSeeder);
32
+ if (isSeedWorkflowsEnabled(env)) seeders.push(workflowsSeeder);
33
+ if (isSeedSchedulesEnabled(env)) seeders.push(createSchedulesSeeder(undefined, env));
34
+ return seeders;
35
+ }
36
+
37
+ /**
38
+ * Every registered seeder under the env read at module load. Like
39
+ * `SEED_AUTOMATIONS_ENABLED`, these flags are restart-required: flip one and
40
+ * restart the process to change what the next boot/CLI seed pass includes.
41
+ */
42
+ export const SEEDERS: Seeder[] = buildSeeders();
24
43
 
25
44
  /** Apply every registered seeder. Called at API boot and by the seed CLI. */
26
45
  export function runAllSeeders(opts?: SeederRunOptions): Promise<SeederResult[]> {
@@ -60,7 +60,7 @@ export async function runSeeder(seeder: Seeder, opts?: SeederRunOptions): Promis
60
60
  // we conservatively assume a user authored it and must not clobber it.
61
61
  const pristine = state ? upstream === state.seededHash : false;
62
62
 
63
- if (!pristine) {
63
+ if (!pristine && !seeder.overwriteUserModified) {
64
64
  // A user changed the upstream copy since our last seed — preserve it.
65
65
  result.skippedUserModified += 1;
66
66
  continue;
@@ -76,6 +76,7 @@ import {
76
76
  } from "../db";
77
77
  import { getScript } from "../scripts/db";
78
78
  import { resolveSeededEnabled } from "./automation-toggle";
79
+ import { isSeedScriptsEnabled, isSeedWorkflowsEnabled } from "./seed-toggle";
79
80
  import type { Seeder, SeedItem } from "./types";
80
81
  import { canonicalJson } from "./workflows-seeder";
81
82
 
@@ -360,17 +361,34 @@ function nextRunAt(schedule: SeedSchedule): string | null {
360
361
 
361
362
  export function createSchedulesSeeder(
362
363
  sources: readonly ScheduleTemplateSource[] = BUILT_IN_SCHEDULE_SOURCES,
364
+ env: NodeJS.ProcessEnv = process.env,
363
365
  ): Seeder<ScheduleSeedItem> {
364
366
  const schedules = loadSeedSchedules(sources);
367
+ const scriptsEnabled = isSeedScriptsEnabled(env);
368
+ const workflowsEnabled = isSeedWorkflowsEnabled(env);
365
369
  return {
366
370
  kind: "schedule",
367
371
 
368
- items(): ScheduleSeedItem[] {
369
- return schedules.map((schedule) => ({
370
- key: schedule.name,
371
- contentHash: scheduleSeedHash(schedule),
372
- schedule,
373
- }));
372
+ async items(): Promise<ScheduleSeedItem[]> {
373
+ const items: ScheduleSeedItem[] = [];
374
+ for (const schedule of schedules) {
375
+ // An opted-out catalog may be supplied externally. Defer only missing
376
+ // targets, checking again on the next seed pass; keep unrelated schedules.
377
+ if (
378
+ schedule.targetType === "script" &&
379
+ !scriptsEnabled &&
380
+ !(await getScript({ name: schedule.scriptName, scope: "global" }))
381
+ )
382
+ continue;
383
+ if (
384
+ schedule.targetType === "workflow" &&
385
+ !workflowsEnabled &&
386
+ !(await listWorkflows()).some((workflow) => workflow.name === schedule.workflow)
387
+ )
388
+ continue;
389
+ items.push({ key: schedule.name, contentHash: scheduleSeedHash(schedule), schedule });
390
+ }
391
+ return items;
374
392
  },
375
393
 
376
394
  async upstreamHash(item): Promise<string | null> {
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Per-kind opt-out for the built-in seed catalog (scripts, skills, workflows,
3
+ * schedules).
4
+ *
5
+ * Each flag defaults to `true`, reproducing pre-existing behavior when unset.
6
+ * `agentFsProvisionSeeder` has no flag here: it provisions the shared-drive
7
+ * storage the swarm needs to boot, and always runs — see {@link ./registry}.
8
+ *
9
+ * Distinct from `SEED_AUTOMATIONS_ENABLED` ({@link ./automation-toggle}),
10
+ * which only gates whether a freshly seeded workflow/schedule arrives
11
+ * *enabled* — the catalog row is still created either way. These flags gate
12
+ * whether the catalog row is created at all, for installs whose content is
13
+ * intentionally 100% externally managed.
14
+ */
15
+
16
+ import { isEnvFlagEnabled } from "../../utils/env-flag";
17
+
18
+ export function isSeedScriptsEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
19
+ return isEnvFlagEnabled("SEED_SCRIPTS_ENABLED", true, env);
20
+ }
21
+
22
+ export function isSeedSkillsEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
23
+ return isEnvFlagEnabled("SEED_SKILLS_ENABLED", true, env);
24
+ }
25
+
26
+ export function isSeedWorkflowsEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
27
+ return isEnvFlagEnabled("SEED_WORKFLOWS_ENABLED", true, env);
28
+ }
29
+
30
+ export function isSeedSchedulesEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
31
+ return isEnvFlagEnabled("SEED_SCHEDULES_ENABLED", true, env);
32
+ }
@@ -44,6 +44,12 @@ export type SeederRunOptions = {
44
44
  export interface Seeder<TItem extends SeedItem = SeedItem> {
45
45
  /** Kind discriminator — namespaces this seeder's rows in `seed_state`. */
46
46
  readonly kind: string;
47
+ /**
48
+ * Apply source changes over a user-modified upstream copy instead of
49
+ * preserving it. Built-in seeders leave this unset; file imports set it for
50
+ * `onConflict: overwrite` sources.
51
+ */
52
+ readonly overwriteUserModified?: boolean;
47
53
  /** The version-controlled source-of-truth records for this kind. */
48
54
  items(): TItem[] | Promise<TItem[]>;
49
55
  /**
@@ -12,8 +12,8 @@ const CAPS = {
12
12
  memoryStore: 5,
13
13
  memoryEdit: 5,
14
14
  memoryDelete: 10,
15
- skillCreate: 1,
16
- skillUpdate: 3,
15
+ skillCreate: 2,
16
+ skillUpdate: 6,
17
17
  scriptSpecs: 2,
18
18
  scriptBuilds: 2,
19
19
  };
@@ -211,6 +211,13 @@ export function reuseWatermark(o: { from: Cursor; at: string; reuseRan: boolean;
211
211
 
212
212
  const esc = (s: string, n: number) => String(s ?? "").replace(/\s+/g, " ").replace(/\|/g, "\\|").slice(0, n);
213
213
 
214
+ /** Measured triage cost: "this run" only when every triage task has a session_costs row; rows land late, so a short count is "partial". */
215
+ export function measuredCost(row: { tasks?: unknown; usd?: unknown } | undefined, taskCount: number): { usd: number; basis: string } | null {
216
+ const tasks = Number(row?.tasks ?? 0);
217
+ if (!row || row.usd === null || row.usd === undefined || tasks === 0) return null;
218
+ return { usd: Number(row.usd), basis: tasks >= taskCount ? "this run" : `partial: ${tasks} of ${taskCount} tasks` };
219
+ }
220
+
214
221
  export function renderSection(r: { skipReason?: string | null; read: number; planned: number; newRead: number; reuseRead: number; batches: number; okBatches: number; failedBatches: Array<{ batchId: string; status: string }>; promoted: number; kept: number; keptHowto: number; dropped: number; dropWhy: Record<string, number>; guards: Record<string, number>; invalid: Record<string, number>; missing: number; left: number | null; cursor: { from: string; to: string } | null; cost: { usd: number | null; basis: string }; samples: TriageRow[]; names: Record<string, string> }): string {
215
222
  const L: string[] = [HEADING];
216
223
  if (r.skipReason) {
@@ -439,8 +446,9 @@ export default async function (args: unknown, ctx: ScriptContext) {
439
446
  const taskIds = parsed.map((x) => x.taskId).filter(Boolean) as string[];
440
447
  let cost: { usd: number | null; basis: string } = { usd: null, basis: "no tasks" };
441
448
  if (taskIds.length) {
442
- const c = (await q("cost", `SELECT SUM(totalCostUsd) usd FROM session_costs WHERE taskId IN (${taskIds.map(() => "?").join(",")})`, taskIds))[0];
443
- if (c && c.usd !== null && c.usd !== undefined) cost = { usd: Number(c.usd), basis: "this run" };
449
+ const c = (await q("cost", `SELECT COUNT(DISTINCT taskId) tasks, SUM(totalCostUsd) usd FROM session_costs WHERE taskId IN (${taskIds.map(() => "?").join(",")})`, taskIds))[0];
450
+ const measured = measuredCost(c, new Set(taskIds).size);
451
+ if (measured) cost = measured;
444
452
  else {
445
453
  const prior = (await q("cost-prior", `SELECT COUNT(*) tasks, AVG(s.usd) usd FROM (SELECT sc.taskId, SUM(sc.totalCostUsd) usd FROM session_costs sc JOIN agent_tasks t ON t.id = sc.taskId WHERE t.tags LIKE '%dreaming-v2-learnings%' AND t.status = 'completed' AND sc.createdAt >= datetime('now','-7 days') GROUP BY sc.taskId) s`))[0];
446
454
  cost = prior && Number(prior.tasks) > 0 && prior.usd !== null ? { usd: Number(prior.usd) * taskIds.length, basis: `estimate: mean of ${prior.tasks} triage tasks in 7 days` } : { usd: null, basis: "session_costs lands after the triage tasks finish" };
@@ -707,6 +707,45 @@ export function handoffRow(path: string, r: Route, texts: string[], scripts: Ski
707
707
  memberIds,
708
708
  };
709
709
  }
710
+ // Synthesize turns only a few routes into actions a night (shared skill caps), so :latest carries every route it did
711
+ // not act on. A route is consumed when an approved synthesize action cites the handoff KV and one of its members.
712
+ export const ROUTES_KV_REF = "memtax-create:skill-routes";
713
+ export function consumedMembers(synth: unknown): Set<string> {
714
+ const s: any = parse(synth);
715
+ const out = new Set<string>();
716
+ for (const x of Array.isArray(s?.actions) ? s.actions : []) {
717
+ const ev: string[] = Array.isArray(x?.evidence) ? x.evidence.map(String) : [];
718
+ if (!ev.some((e) => e.includes(ROUTES_KV_REF))) continue;
719
+ for (const e of ev) if (e.startsWith("memory:")) out.add(e.slice("memory:".length));
720
+ }
721
+ return out;
722
+ }
723
+ /** Stored routes minus consumed ones, merged by slug with tonight's (union memberIds, tonight's fields win), members
724
+ * whose rows are gone dropped (`live` null = unknown, keep all), largest first. */
725
+ export function carryRoutes(tonight: any[], stored: any[], consumed: Set<string>, live: Set<string> | null) {
726
+ const slugOf = (r: any) => String(r?.slug || String(r?.path ?? "").split("/").pop() || "");
727
+ const namesOf = (r: any) => Object.fromEntries((r?.memberIds ?? []).map((id: string, i: number) => [id, String(r?.memberNames?.[i] ?? "")]));
728
+ const kept = stored.filter((r) => slugOf(r) && !(r.memberIds ?? []).some((id: string) => consumed.has(id)));
729
+ const tonightSlugs = new Set(tonight.map(slugOf));
730
+ const bySlug = new Map<string, any>();
731
+ const names: Record<string, string> = {};
732
+ for (const r of [...kept, ...tonight]) {
733
+ const slug = slugOf(r);
734
+ if (!slug) continue;
735
+ Object.assign(names, Object.fromEntries(Object.entries(namesOf(r)).filter(([, n]) => n)));
736
+ const prev = bySlug.get(slug);
737
+ bySlug.set(slug, { ...prev, ...r, slug, memberIds: [...new Set([...(prev?.memberIds ?? []), ...(r.memberIds ?? []).map(String)])] });
738
+ }
739
+ const routes: any[] = [];
740
+ let gone = 0;
741
+ for (const r of bySlug.values()) {
742
+ const memberIds = live ? r.memberIds.filter((id: string) => live.has(id)) : r.memberIds;
743
+ if (!memberIds.length) gone++;
744
+ else routes.push({ ...r, memberIds, memberNames: memberIds.map((id: string) => names[id] ?? "") });
745
+ }
746
+ routes.sort((x, y) => y.memberIds.length - x.memberIds.length);
747
+ return { routes, carried: routes.filter((r) => !tonightSlugs.has(r.slug)).length, consumed: stored.length - kept.length, gone };
748
+ }
710
749
  export const scriptHint = (texts: string[]) => texts.some((t) => /\b(GET|POST|PUT|PATCH|DELETE) \/|\bcurl\b|\bendpoint\b|https?:\/\/[^\s]*\/(v\d|api)\b|x-api-key|Bearer\b/i.test(String(t ?? "")));
711
750
 
712
751
  const KIND_OF_ROOT = (root: string) =>
@@ -1445,10 +1484,33 @@ async function runScript(args: unknown, ctx: ScriptContext) {
1445
1484
  let handoff = runDry ? "dry run, not written" : "none";
1446
1485
  if (!runDry) {
1447
1486
  try {
1448
- const value = { runId, at: new Date().toISOString(), routes: skillRoutes.map((r) => ({ ...r, memberNames: (r.memberIds ?? []).map((id: string) => memberNames[id] ?? "") })) };
1449
- await ctx.swarm.kv_set({ namespace: NS, key: `memtax-create:skill-routes:${runId}`, value: value as any });
1450
- await ctx.swarm.kv_set({ namespace: NS, key: "memtax-create:skill-routes:latest", value: value as any });
1451
- handoff = `KV memtax-create:skill-routes:latest (${skillRoutes.length} routes)`;
1487
+ const tonight = skillRoutes.map((r) => ({ ...r, memberNames: (r.memberIds ?? []).map((id: string) => memberNames[id] ?? "") }));
1488
+ await ctx.swarm.kv_set({ namespace: NS, key: `memtax-create:skill-routes:${runId}`, value: { runId, at: new Date().toISOString(), routes: tonight } as any });
1489
+ // Tonight's synthesize already read the stored set: drop what it acted on, carry the rest forward.
1490
+ const stored: any = (await ctx.swarm.kv_getOrNull({ namespace: NS, key: "memtax-create:skill-routes:latest" }))?.value;
1491
+ const prior: any[] = Array.isArray(stored?.routes) ? stored.routes : [];
1492
+ let consumed = new Set<string>();
1493
+ try {
1494
+ for (const r of await qStrict(`SELECT json_extract(output, '$.taskOutput') v FROM workflow_run_steps WHERE runId = ? AND nodeId = 'synthesize'`, [runId])) for (const id of consumedMembers(r.v)) consumed.add(id);
1495
+ } catch (e: any) {
1496
+ consumed = new Set();
1497
+ errors.push(`handoff: synthesize step unreadable, nothing marked consumed: ${String(e?.message ?? e).slice(0, 200)}`);
1498
+ }
1499
+ const ids = [...new Set([...prior, ...tonight].flatMap((r: any) => (r?.memberIds ?? []).map(String)))];
1500
+ let live: Set<string> | null = null;
1501
+ try {
1502
+ live = new Set<string>();
1503
+ for (let i = 0; i < ids.length; i += 500) {
1504
+ const part = ids.slice(i, i + 500);
1505
+ for (const r of await qStrict(`SELECT DISTINCT id FROM agent_memory WHERE id IN (${part.map(() => "?").join(",")}) AND (expiresAt IS NULL OR expiresAt > ?)`, [...part, new Date().toISOString()])) live.add(String(r.id));
1506
+ }
1507
+ } catch (e: any) {
1508
+ live = null;
1509
+ errors.push(`handoff: member check failed, kept every member: ${String(e?.message ?? e).slice(0, 200)}`);
1510
+ }
1511
+ const carry = carryRoutes(tonight, prior, consumed, live);
1512
+ await ctx.swarm.kv_set({ namespace: NS, key: "memtax-create:skill-routes:latest", value: { runId, at: new Date().toISOString(), routes: carry.routes } as any });
1513
+ handoff = `KV memtax-create:skill-routes:latest (${carry.routes.length} routes: ${tonight.length} tonight, ${carry.carried} carried, ${carry.consumed} consumed, ${carry.gone} with no live members)`;
1452
1514
  } catch (e: any) {
1453
1515
  errors.push(`handoff: ${String(e?.message ?? e).slice(0, 200)}`);
1454
1516
  handoff = "failed";
@@ -1799,6 +1861,10 @@ async function runScript(args: unknown, ctx: ScriptContext) {
1799
1861
  t("handoff: covered how-to -> skill-refactor skill-update, no script", h2.lane === "skill-refactor" && h2.op === "skill-update" && h2.skill === "agentmail-sending" && h2.scriptLane === null, h2);
1800
1862
  const h3 = handoffRow("/howto/bluesky", routeCluster("/howto/bluesky", sk), ["POST /xrpc/com.atproto.repo.createRecord with Bearer token"], scr, ["d4", "d5"]);
1801
1863
  t("handoff: API how-to with no script -> script candidate", h3.scriptExisting === null && h3.script === true && h3.scriptLane === "scriptify", h3);
1864
+ const cm = consumedMembers(JSON.stringify({ actions: [{ evidence: ["memory:m1", "kv:dreaming-v2/memtax-create:skill-routes:latest"] }, { evidence: ["memory:m9"] }] }));
1865
+ t("carry: only an action citing the handoff KV consumes its members", cm.has("m1") && !cm.has("m9"), [...cm]);
1866
+ const cr = carryRoutes([{ slug: "b", memberIds: ["m4"], memberNames: ["n4"], route: "skill-new" }], [{ slug: "a", memberIds: ["m1"] }, { slug: "b", memberIds: ["m2", "m3"], memberNames: ["n2", "n3"], route: "skill-update" }, { slug: "c", memberIds: ["m5"] }], cm, new Set(["m1", "m2", "m4"]));
1867
+ t("carry: consumed dropped, merged by slug (union), dead members and empty routes dropped, largest first", cr.routes.length === 1 && cr.routes[0].slug === "b" && cr.routes[0].route === "skill-new" && cr.routes[0].memberIds.join() === "m2,m4" && cr.routes[0].memberNames.join() === "n2,n4" && cr.consumed === 1 && cr.gone === 1, cr);
1802
1868
  // Near-duplicate guard. Vectors with a known cosine: [1, 0] vs [c, sqrt(1 - c^2)].
1803
1869
  const at = (c: number) => [c, Math.sqrt(1 - c * c)];
1804
1870
  const o = { nearDupCos: 0.8, twinCos: 0.95 };