@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
@@ -1,6 +1,7 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
3
  import { getAgentCurrentTask, getTaskById } from "@/be/db";
4
+ import { cardIssuesMessage, cardSpecInputSchema, renderCardFor } from "@/integrations/cards";
4
5
  import { errorMessage } from "@/integrations/chat-sdk/logger";
5
6
  import {
6
7
  ChatAdapterUnavailableError,
@@ -18,10 +19,16 @@ export const registerChatReplyTool = (server: McpServer) => {
18
19
  {
19
20
  title: "Reply in the chat thread of this task",
20
21
  description:
21
- "Post a message to the Telegram, Slack, Discord or Teams thread your current task came from. Works only on a task whose contextKey starts with task:chat-sdk:. The task's final output is posted to the thread automatically when the task ends, so use this only for a question to the user, a short progress note on long work, or to send files (attachments). Markdown is supported; long text is split into several messages. When the final output of a task is posted, the files attached to that task go with it.",
22
+ "Post a message to the Telegram, Slack, Discord or Teams thread your current task came from. Works only on a task whose contextKey starts with task:chat-sdk:. The task's final output is posted to the thread automatically when the task ends, so use this only for a question to the user, a short progress note on long work, or to send files (attachments). Markdown is supported; long text is split into several messages. When the final output of a task is posted, the files attached to that task go with it. For a structured result (key figures, a table, charts, links), send a `card`; it posts after the text as a native card.",
22
23
  annotations: { openWorldHint: true },
23
24
  inputSchema: z.object({
24
- text: z.string().min(1).max(20_000).describe("Markdown text to post to the thread."),
25
+ text: z
26
+ .string()
27
+ .min(1)
28
+ .max(20_000)
29
+ .optional()
30
+ .describe("Markdown text to post to the thread. Required unless card is given."),
31
+ card: cardSpecInputSchema.optional(),
25
32
  attachments: chatAttachmentsSchema,
26
33
  }),
27
34
  outputSchema: swarmToolOutputSchema({
@@ -34,9 +41,10 @@ export const registerChatReplyTool = (server: McpServer) => {
34
41
  .optional(),
35
42
  }),
36
43
  },
37
- async ({ text, attachments }, requestInfo) => {
44
+ async ({ text, card, attachments }, requestInfo) => {
38
45
  if (!requestInfo.agentId) return toolErr("Agent ID not found.");
39
46
  const data = { yourAgentId: requestInfo.agentId };
47
+ if (!text && !card) return toolErr("Provide text or a card.", { data });
40
48
 
41
49
  // The header names the task this session works on; without it, the
42
50
  // agent's current in-progress task.
@@ -55,6 +63,13 @@ export const registerChatReplyTool = (server: McpServer) => {
55
63
  { data },
56
64
  );
57
65
  }
66
+ // Validated for the thread's adapter, before anything is sent.
67
+ const rendered = card ? await renderCardFor(thread.adapter, card) : undefined;
68
+ if (rendered && "issues" in rendered) {
69
+ return toolErr(cardIssuesMessage(rendered.issues), {
70
+ data: { ...data, issues: rendered.issues },
71
+ });
72
+ }
58
73
 
59
74
  const resolved = await resolveChatAttachmentRefs(
60
75
  attachments ?? [],
@@ -67,7 +82,8 @@ export const registerChatReplyTool = (server: McpServer) => {
67
82
  const sent = await postChatMessage({
68
83
  adapter: thread.adapter,
69
84
  threadId: thread.threadId,
70
- text,
85
+ text: text ?? [],
86
+ card: rendered?.card,
71
87
  taskId: task.id,
72
88
  files: resolved.files,
73
89
  // Same anchor as the final answer: the message that started this task.
@@ -24,7 +24,8 @@
24
24
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
25
25
  import * as z from "zod";
26
26
  import { authorizeAssetKeyWrite } from "@/be/asset-key-auth";
27
- import { resolveTaskAuditUserId } from "@/be/audit-user";
27
+ import { resolveTaskAuditUserId, resolveTaskGroupKey } from "@/be/audit-user";
28
+ import { fileCallerSessionIntoGroup } from "@/be/caller-session-group";
28
29
  import { createPage, getPage, getPageBySlug, updatePage } from "@/be/db";
29
30
  import { getPageEditCounter } from "@/be/db/page-versions";
30
31
  import { classAttributeValues, countColorLiterals } from "@/pages/color-literals";
@@ -101,7 +102,7 @@ export const registerCreatePageTool = (server: McpServer) => {
101
102
  annotations: { destructiveHint: false },
102
103
  inputSchema: z.object({
103
104
  key: AssetKeySchema.optional().describe(
104
- "Logical namespace. Defaults to a shared/page:<id>/ resource key.",
105
+ "Logical namespace. Defaults to the calling task's group key when it has one, else shared/page:<id>/. An explicit use-case group key also files the calling task's session into that group while the session still has its default key.",
105
106
  ),
106
107
  title: z.string().min(1).describe("Human-readable title shown in listings."),
107
108
  slug: z
@@ -174,6 +175,7 @@ export const registerCreatePageTool = (server: McpServer) => {
174
175
  colorLiteralCount: z.number().optional(),
175
176
  usesDesignSystem: z.boolean().optional(),
176
177
  lightOnlyColors: z.boolean().optional(),
178
+ movedSessionRootId: z.string().optional(),
177
179
  }),
178
180
  },
179
181
  async (input, requestInfo, _meta) => {
@@ -211,7 +213,11 @@ export const registerCreatePageTool = (server: McpServer) => {
211
213
  let assetKey: string | undefined;
212
214
  try {
213
215
  if (input.key !== undefined || !existing) {
214
- assetKey = input.key ? await authorizeAssetKeyWrite(input.key, trustedUserId) : undefined;
216
+ const resolvedKey =
217
+ input.key ?? (await resolveTaskGroupKey(requestInfo.sourceTaskId, requestInfo.agentId));
218
+ assetKey = resolvedKey
219
+ ? await authorizeAssetKeyWrite(resolvedKey, trustedUserId)
220
+ : undefined;
215
221
  }
216
222
  } catch (error) {
217
223
  const msg = error instanceof Error ? error.message : String(error);
@@ -303,12 +309,22 @@ export const registerCreatePageTool = (server: McpServer) => {
303
309
  }
304
310
  : {};
305
311
  const { ignored } = themeFields;
312
+ const movedSessionRootId =
313
+ input.key !== undefined && assetKey
314
+ ? await fileCallerSessionIntoGroup({
315
+ sourceTaskId: requestInfo.sourceTaskId,
316
+ agentId: requestInfo.agentId,
317
+ key: assetKey,
318
+ changedBy: trustedUserId ?? undefined,
319
+ })
320
+ : null;
306
321
 
307
322
  return toolOk(
308
323
  `Page "${input.title}" saved (slug=${finalSlug}, version=${version}, designVersion=${fresh.designVersion}).` +
309
324
  (ignored.length > 0
310
325
  ? " Some theme tokens were ignored (outside the page token contract or referencing a variable outside it)."
311
- : ""),
326
+ : "") +
327
+ (movedSessionRootId ? ` This session moved into ${assetKey}.` : ""),
312
328
  {
313
329
  details:
314
330
  `API: ${apiUrl}\n App: ${appUrl}` +
@@ -323,6 +339,7 @@ export const registerCreatePageTool = (server: McpServer) => {
323
339
  designVersion: fresh.designVersion,
324
340
  ...(ignored.length > 0 ? { ignoredTokens: ignored } : {}),
325
341
  ...designFlags,
342
+ ...(movedSessionRootId ? { movedSessionRootId } : {}),
326
343
  },
327
344
  },
328
345
  );
@@ -1,6 +1,7 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import * as z from "zod";
3
3
  import { getAllAgents } from "@/be/db";
4
+ import { isAgentOnDemand } from "@/be/runtime-pools/reachability";
4
5
  import { createToolRegistrar, swarmToolOutputSchema, toolOk } from "@/tools/utils";
5
6
  import { AgentStatusSchema, ProviderNameSchema } from "@/types";
6
7
 
@@ -11,6 +12,12 @@ const agentOutputShape = z.looseObject({
11
12
  name: z.string().optional(),
12
13
  isLead: z.boolean().optional(),
13
14
  status: AgentStatusSchema.optional(),
15
+ onDemand: z
16
+ .boolean()
17
+ .optional()
18
+ .describe(
19
+ "True when the agent is offline but its runtime pool will start a runtime for it (multi-runtime on, pool capacity left, maxTasks fits one runtime). send-task to it starts a runtime.",
20
+ ),
14
21
  description: z.string().optional(),
15
22
  role: z.string().optional(),
16
23
  capabilities: z.array(z.string()).optional(),
@@ -57,12 +64,21 @@ export const registerGetSwarmTool = (server: McpServer) => {
57
64
  }),
58
65
  },
59
66
  async ({ includeFull }, requestInfo, _meta) => {
60
- const agents = await getAllAgents({ slim: !includeFull });
67
+ // A pool agent without a live runtime reports "offline", but a task sent
68
+ // to it starts a runtime. Mark it, so a Lead does not read it as unavailable.
69
+ const agents = await Promise.all(
70
+ (await getAllAgents({ slim: !includeFull })).map(async (a) =>
71
+ (await isAgentOnDemand(a)) ? { ...a, onDemand: true } : a,
72
+ ),
73
+ );
61
74
 
62
75
  // Include the ID — send-task targets agents by ID, and text-only
63
76
  // harnesses never see the structured data to look it up.
64
77
  const agentList = agents
65
- .map((a) => `- ${a.name} (${a.status}${a.isLead ? ", lead" : ""}) — id: ${a.id}`)
78
+ .map((a) => {
79
+ const onDemand = "onDemand" in a ? ", on demand: send-task starts it" : "";
80
+ return `- ${a.name} (${a.status}${onDemand}${a.isLead ? ", lead" : ""}) — id: ${a.id}`;
81
+ })
66
82
  .join("\n");
67
83
 
68
84
  return toolOk(
@@ -138,7 +138,8 @@ export const registerJoinSwarmTool = (server: McpServer) => {
138
138
  capabilities,
139
139
  claudeMd: defaultClaudeMd,
140
140
  soulMd: defaultSoulMd,
141
- identityMd: defaultIdentityMd,
141
+ // A pending file import may have written it in createAgent.
142
+ identityMd: agent.identityMd || defaultIdentityMd,
142
143
  });
143
144
 
144
145
  return updatedAgent ?? agent;
@@ -1,6 +1,10 @@
1
1
  import { getAgentById } from "@/be/db";
2
2
  import { mcpOverflowAuthError } from "@/kv-overflow";
3
- import { reservedNamespaceError, reservedRoomKeyError } from "@/kv-reserved-namespaces";
3
+ import {
4
+ requiresLeadToWrite,
5
+ reservedNamespaceError,
6
+ reservedRoomKeyError,
7
+ } from "@/kv-reserved-namespaces";
4
8
  import { can } from "@/rbac";
5
9
 
6
10
  /**
@@ -31,6 +35,18 @@ export async function kvWriteAuthError(
31
35
  if (namespace.startsWith("task:page:")) {
32
36
  return "task:page:* writes require a page-proxy request, not an MCP call";
33
37
  }
38
+ if (requiresLeadToWrite(namespace)) {
39
+ const agent = info.agentId ? await getAgentById(info.agentId) : null;
40
+ const allowed =
41
+ info.agentId != null &&
42
+ can({
43
+ principal: { kind: "agent", agentId: info.agentId, isLead: agent?.isLead ?? false },
44
+ verb: "kv.write.any",
45
+ resource: { kind: "kv-namespace", namespace },
46
+ source: "mcp",
47
+ }).allow;
48
+ if (!allowed) return "writes to this namespace require lead";
49
+ }
34
50
  if (namespace.startsWith("task:agent:")) {
35
51
  // A missing caller identity can never own a namespace nor be lead — same
36
52
  // denial as before (no separate "agent not found" branch). Own-namespace
@@ -2,7 +2,8 @@ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
2
  import { CronExpressionParser } from "cron-parser";
3
3
  import * as z from "zod";
4
4
  import { authorizeAssetKeyWrite } from "@/be/asset-key-auth";
5
- import { resolveTaskAuditUserId } from "@/be/audit-user";
5
+ import { resolveTaskAuditUserId, resolveTaskGroupKey } from "@/be/audit-user";
6
+ import { fileCallerSessionIntoGroup } from "@/be/caller-session-group";
6
7
  import {
7
8
  createScheduledTask,
8
9
  extensionAgentAssignmentError,
@@ -33,7 +34,7 @@ import {
33
34
 
34
35
  export const createScheduleInputSchema = z.object({
35
36
  key: AssetKeySchema.optional().describe(
36
- "Logical namespace. Defaults to a shared/schedule:<id>/ resource key.",
37
+ "Logical namespace. Defaults to the calling task's group key when it has one, else shared/schedule:<id>/. An explicit use-case group key also files the calling task's session into that group while the session still has its default key, so the planning session, the schedule and its runs share one key.",
37
38
  ),
38
39
  name: z.string().min(1).max(100).describe("Unique name for the schedule (e.g., 'daily-cleanup')"),
39
40
  taskTemplate: z
@@ -178,6 +179,7 @@ export const registerCreateScheduleTool = (server: McpServer) => {
178
179
  yourAgentId: z.string().optional(),
179
180
  schedule: z.looseObject(scheduleDataShape).optional(),
180
181
  modelTierDeprecated: modelTierDeprecatedOutputSchema.optional(),
182
+ movedSessionRootId: z.string().optional(),
181
183
  }),
182
184
  },
183
185
  async (
@@ -327,7 +329,11 @@ export const registerCreateScheduleTool = (server: McpServer) => {
327
329
  const createdBy =
328
330
  (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
329
331
  undefined;
330
- const assetKey = key ? await authorizeAssetKeyWrite(key, createdBy) : undefined;
332
+ const resolvedKey =
333
+ key ?? (await resolveTaskGroupKey(requestInfo.sourceTaskId, requestInfo.agentId));
334
+ const assetKey = resolvedKey
335
+ ? await authorizeAssetKeyWrite(resolvedKey, createdBy)
336
+ : undefined;
331
337
 
332
338
  const schedule = await createScheduledTask({
333
339
  key: assetKey,
@@ -355,17 +361,29 @@ export const registerCreateScheduleTool = (server: McpServer) => {
355
361
  createdBy,
356
362
  });
357
363
 
364
+ const movedSessionRootId =
365
+ key !== undefined && assetKey
366
+ ? await fileCallerSessionIntoGroup({
367
+ sourceTaskId: requestInfo.sourceTaskId,
368
+ agentId: requestInfo.agentId,
369
+ key: assetKey,
370
+ changedBy: createdBy,
371
+ })
372
+ : null;
373
+
358
374
  const scheduleDesc = isOneTime
359
375
  ? `one-time at ${schedule.nextRunAt}`
360
376
  : cronExpression || `every ${intervalMs}ms`;
361
377
  const modelTierDeprecated = modelTierDeprecation(modelTier, targetHarness);
378
+ const movedNote = movedSessionRootId ? `. This session moved into ${assetKey}.` : "";
362
379
  return toolOk(
363
- `Created schedule "${name}" (${scheduleDesc}). Next run: ${schedule.nextRunAt || "disabled"}`,
380
+ `Created schedule "${name}" (${scheduleDesc}). Next run: ${schedule.nextRunAt || "disabled"}${movedNote}`,
364
381
  {
365
382
  data: {
366
383
  yourAgentId: requestInfo.agentId,
367
384
  schedule,
368
385
  ...(modelTierDeprecated ? { modelTierDeprecated } : {}),
386
+ ...(movedSessionRootId ? { movedSessionRootId } : {}),
369
387
  },
370
388
  },
371
389
  );
@@ -6,6 +6,13 @@ import {
6
6
  getTaskById,
7
7
  recordSlackMessage,
8
8
  } from "@/be/db";
9
+ import {
10
+ cardIssuesMessage,
11
+ cardSpecInputSchema,
12
+ cardToSlack,
13
+ renderCard,
14
+ slackFallbackText,
15
+ } from "@/integrations/cards";
9
16
  import { can } from "@/rbac";
10
17
  import { getSlackApp } from "@/slack/app";
11
18
  import { buildMrkdwnSectionBlocks, getTaskLink } from "@/slack/blocks";
@@ -21,7 +28,7 @@ export const registerSlackPostTool = (server: McpServer) => {
21
28
  {
22
29
  title: "Post message to Slack channel",
23
30
  description:
24
- "Post a message to a Slack channel. By default creates a new top-level message; pass `threadTs` to post as a threaded reply under an existing message (obtain the ts from `slack-start-thread`). Requires lead privileges.",
31
+ "Post a message to a Slack channel. By default creates a new top-level message; pass `threadTs` to post as a threaded reply under an existing message (obtain the ts from `slack-start-thread`). For a structured result (key figures, a table, charts, links), send a `card` instead of hand-built `blocks`. Requires lead privileges.",
25
32
  annotations: { openWorldHint: true },
26
33
 
27
34
  inputSchema: z.object({
@@ -31,12 +38,22 @@ export const registerSlackPostTool = (server: McpServer) => {
31
38
  .describe(
32
39
  "The Slack channel ID to post to. A user ID (U…/W…) posts in the bot's DM with that user.",
33
40
  ),
34
- message: z.string().min(1).max(4000).describe("The message content to post."),
41
+ message: z
42
+ .string()
43
+ .min(1)
44
+ .max(4000)
45
+ .optional()
46
+ .describe(
47
+ "The message content to post. Required unless card is given; with a card it renders above it.",
48
+ ),
35
49
  blocks: z
36
50
  .array(z.record(z.string(), z.unknown()))
37
51
  .max(50)
38
52
  .optional()
39
- .describe("Optional Block Kit blocks. When omitted, a mrkdwn section is generated."),
53
+ .describe(
54
+ "Optional raw Block Kit blocks. When omitted, a mrkdwn section is generated. Prefer card.",
55
+ ),
56
+ card: cardSpecInputSchema.optional(),
40
57
  threadTs: z
41
58
  .string()
42
59
  .optional()
@@ -48,7 +65,11 @@ export const registerSlackPostTool = (server: McpServer) => {
48
65
  messageTs: z.string().optional(),
49
66
  }),
50
67
  },
51
- async ({ channelId: requestedChannelId, message, threadTs, blocks }, requestInfo, _meta) => {
68
+ async (
69
+ { channelId: requestedChannelId, message, threadTs, blocks, card },
70
+ requestInfo,
71
+ _meta,
72
+ ) => {
52
73
  if (!requestInfo.agentId) {
53
74
  return toolErr("Agent ID not found.");
54
75
  }
@@ -68,6 +89,17 @@ export const registerSlackPostTool = (server: McpServer) => {
68
89
  if (!decision.allow) {
69
90
  return toolErr("Posting to Slack channels requires lead privileges.");
70
91
  }
92
+ if (blocks && card) return toolErr("Provide either blocks or card, not both.");
93
+ if (!message && !card) return toolErr("Provide a message or a card.");
94
+ let cardSlack: { blocks: Record<string, unknown>[]; text: string } | undefined;
95
+ if (card) {
96
+ const rendered = renderCard(card);
97
+ const slack = "card" in rendered ? await cardToSlack(rendered.card) : rendered;
98
+ if ("issues" in slack) {
99
+ return toolErr(cardIssuesMessage(slack.issues), { data: { issues: slack.issues } });
100
+ }
101
+ cardSlack = slack;
102
+ }
71
103
 
72
104
  const app = getSlackApp();
73
105
  if (!app) {
@@ -88,7 +120,7 @@ export const registerSlackPostTool = (server: McpServer) => {
88
120
  }
89
121
 
90
122
  try {
91
- const slackMessage = markdownToSlack(message);
123
+ const slackMessage = message ? markdownToSlack(message) : "";
92
124
 
93
125
  const sourceTask = requestInfo.sourceTaskId
94
126
  ? await getTaskById(requestInfo.sourceTaskId)
@@ -96,7 +128,8 @@ export const registerSlackPostTool = (server: McpServer) => {
96
128
  const contextKey = sourceTask?.contextKey;
97
129
  const tree = threadTs ? await getSlackTreeMessageByThread(channelId, threadTs) : null;
98
130
  const messageBlocks: Record<string, unknown>[] = [
99
- ...(blocks ?? buildMrkdwnSectionBlocks(slackMessage)),
131
+ ...(cardSlack && slackMessage ? buildMrkdwnSectionBlocks(slackMessage) : []),
132
+ ...(cardSlack?.blocks ?? blocks ?? buildMrkdwnSectionBlocks(slackMessage)),
100
133
  ];
101
134
  if (sourceTask && tree) {
102
135
  if (messageBlocks.length >= 50) {
@@ -116,7 +149,7 @@ export const registerSlackPostTool = (server: McpServer) => {
116
149
  const result = await withAutoJoin(app.client, channelId, () =>
117
150
  app.client.chat.postMessage({
118
151
  channel: channelId,
119
- text: slackMessage, // Fallback for notifications
152
+ text: slackFallbackText(slackMessage, cardSlack?.text), // Fallback for notifications
120
153
  unfurl_links: false,
121
154
  unfurl_media: false,
122
155
  username: getAgentDisplayName(agent),
@@ -10,6 +10,13 @@ import {
10
10
  recordSlackMessage,
11
11
  } from "@/be/db";
12
12
  import { getTaskCitations } from "@/be/task-citations";
13
+ import {
14
+ cardIssuesMessage,
15
+ cardSpecInputSchema,
16
+ cardToSlack,
17
+ renderCard,
18
+ slackFallbackText,
19
+ } from "@/integrations/cards";
13
20
  import { getSlackApp } from "@/slack/app";
14
21
  import {
15
22
  buildCaptionBlock,
@@ -33,7 +40,7 @@ export const registerSlackReplyTool = (server: McpServer) => {
33
40
  {
34
41
  title: "Reply to Slack thread",
35
42
  description:
36
- "Send a reply to a Slack thread. Use inboxMessageId for inbox messages, or taskId for task-related threads. The engine already publishes the task tree and outcome card, so send only a distinct agent-authored message. Prefer one reply per task over several, do not post progress, receipt, or acknowledgment messages, and match its length to what the user asked for.",
43
+ "Send a reply to a Slack thread. Use inboxMessageId for inbox messages, or taskId for task-related threads. The engine already publishes the task tree and outcome card, so send only a distinct agent-authored message. Prefer one reply per task over several, do not post progress, receipt, or acknowledgment messages, and match its length to what the user asked for. For a structured result (key figures, a table, charts, links), send a `card` instead of hand-built `blocks`.",
37
44
  annotations: { openWorldHint: true },
38
45
 
39
46
  inputSchema: z.object({
@@ -45,18 +52,28 @@ export const registerSlackReplyTool = (server: McpServer) => {
45
52
  .uuid()
46
53
  .optional()
47
54
  .describe("The task ID with Slack context (for task-related threads)."),
48
- message: z.string().min(1).max(4000).describe("The message to send to the Slack thread."),
55
+ message: z
56
+ .string()
57
+ .min(1)
58
+ .max(4000)
59
+ .optional()
60
+ .describe(
61
+ "The message to send to the Slack thread. Required unless card is given; with a card it renders above it.",
62
+ ),
49
63
  blocks: z
50
64
  .array(z.record(z.string(), z.unknown()))
51
65
  .max(50)
52
66
  .optional()
53
- .describe("Optional Block Kit blocks. When omitted, a mrkdwn section is generated."),
67
+ .describe(
68
+ "Optional raw Block Kit blocks. When omitted, a mrkdwn section is generated. Prefer card.",
69
+ ),
70
+ card: cardSpecInputSchema.optional(),
54
71
  }),
55
72
  outputSchema: swarmToolOutputSchema({
56
73
  messageTs: z.string().optional(),
57
74
  }),
58
75
  },
59
- async ({ inboxMessageId, taskId, message, blocks }, requestInfo, _meta) => {
76
+ async ({ inboxMessageId, taskId, message, blocks, card }, requestInfo, _meta) => {
60
77
  if (!requestInfo.agentId) {
61
78
  return toolErr("Agent ID not found.");
62
79
  }
@@ -75,6 +92,19 @@ export const registerSlackReplyTool = (server: McpServer) => {
75
92
  if (inboxMessageId && taskId) {
76
93
  return toolErr("Provide either inboxMessageId or taskId, not both.");
77
94
  }
95
+ if (blocks && card) return toolErr("Provide either blocks or card, not both.");
96
+ if (!message && !card) return toolErr("Provide a message or a card.");
97
+
98
+ // Validate the card before any side effect, so a bad spec changes nothing.
99
+ let cardSlack: { blocks: Record<string, unknown>[]; text: string } | undefined;
100
+ if (card) {
101
+ const rendered = renderCard(card);
102
+ const slack = "card" in rendered ? await cardToSlack(rendered.card) : rendered;
103
+ if ("issues" in slack) {
104
+ return toolErr(cardIssuesMessage(slack.issues), { data: { issues: slack.issues } });
105
+ }
106
+ cardSlack = slack;
107
+ }
78
108
 
79
109
  // Determine Slack context from inbox message or task
80
110
  if (inboxMessageId) {
@@ -89,7 +119,10 @@ export const registerSlackReplyTool = (server: McpServer) => {
89
119
  slackThreadTs = inboxMsg.slackThreadTs;
90
120
 
91
121
  // Mark as responded
92
- await markInboxMessageResponded(inboxMessageId, message);
122
+ await markInboxMessageResponded(
123
+ inboxMessageId,
124
+ slackFallbackText(message ?? "", cardSlack?.text),
125
+ );
93
126
  } else if (taskId) {
94
127
  const task = await getTaskById(taskId);
95
128
  if (!task) {
@@ -125,13 +158,11 @@ export const registerSlackReplyTool = (server: McpServer) => {
125
158
  const citations = taskId ? await getTaskCitations(taskId) : [];
126
159
  // Sources go in a caption under the reply, never in the body or the
127
160
  // notification text.
128
- const slackMessage = renderTaskCitations(
129
- markdownToSlack(message),
130
- citations,
131
- "slack",
132
- false,
133
- );
134
- const renderedBlocks = blocks?.map((block) =>
161
+ const slackMessage = message
162
+ ? renderTaskCitations(markdownToSlack(message), citations, "slack", false)
163
+ : "";
164
+ const customBlocks = cardSlack?.blocks ?? blocks;
165
+ const renderedBlocks = customBlocks?.map((block) =>
135
166
  JSON.parse(
136
167
  JSON.stringify(block, (key, value) =>
137
168
  key === "text" && typeof value === "string"
@@ -145,10 +176,15 @@ export const registerSlackReplyTool = (server: McpServer) => {
145
176
 
146
177
  const tree = await getSlackTreeMessageByThread(slackChannelId, slackThreadTs);
147
178
  const messageBlocks: Record<string, unknown>[] = [
179
+ ...(cardSlack && slackMessage ? buildMrkdwnSectionBlocks(slackMessage) : []),
148
180
  ...(renderedBlocks ?? buildMrkdwnSectionBlocks(slackMessage)),
149
181
  ];
150
182
  for (const group of taskCitationSourceGroups(
151
- blocks ? JSON.stringify(blocks) : message,
183
+ cardSlack
184
+ ? `${message ?? ""}\n${JSON.stringify(cardSlack.blocks)}`
185
+ : blocks
186
+ ? JSON.stringify(blocks)
187
+ : (message ?? ""),
152
188
  citations,
153
189
  )) {
154
190
  const caption = buildCaptionBlock(group.items, {
@@ -178,7 +214,7 @@ export const registerSlackReplyTool = (server: McpServer) => {
178
214
  app.client.chat.postMessage({
179
215
  channel: slackChannelId,
180
216
  thread_ts: slackThreadTs,
181
- text: slackMessage, // Fallback for notifications
217
+ text: slackFallbackText(slackMessage, cardSlack?.text), // Fallback for notifications
182
218
  unfurl_links: false,
183
219
  unfurl_media: false,
184
220
  username: getAgentDisplayName(agent),
package/src/types.ts CHANGED
@@ -615,7 +615,16 @@ export const SteeringStatusSchema = z.enum([
615
615
  ]);
616
616
  export type SteeringStatus = z.infer<typeof SteeringStatusSchema>;
617
617
 
618
- export const SteeringSourceSchema = z.enum(["ui", "mcp", "script", "slack", "api", "chat"]);
618
+ /** `app-page`: a steer sent from a json-render app page (the `SessionThread` component). */
619
+ export const SteeringSourceSchema = z.enum([
620
+ "ui",
621
+ "mcp",
622
+ "script",
623
+ "slack",
624
+ "api",
625
+ "chat",
626
+ "app-page",
627
+ ]);
619
628
  export type SteeringSource = z.infer<typeof SteeringSourceSchema>;
620
629
 
621
630
  export const SteeringMessageSchema = z
@@ -751,6 +760,34 @@ export const RoutingAffinitySchema = z
751
760
  .openapi("RoutingAffinity");
752
761
  export type RoutingAffinity = z.infer<typeof RoutingAffinitySchema>;
753
762
 
763
+ // People in a multi-person Slack thread, captured when the task is created.
764
+ // `trust`: internal (company domain or audience override), external (other
765
+ // domain, other Slack team), unknown (no email). External and unknown are
766
+ // untrusted: their messages are information, never instructions.
767
+ export const SlackParticipantTrustSchema = z.enum(["internal", "external", "unknown"]);
768
+ export type SlackParticipantTrust = z.infer<typeof SlackParticipantTrustSchema>;
769
+
770
+ export const TaskSlackParticipantSchema = z.object({
771
+ slackUserId: z.string(),
772
+ userId: z.string().optional(),
773
+ trust: SlackParticipantTrustSchema,
774
+ /** Sent the first task in this thread (who started the swarm's work). */
775
+ starter: z.boolean().optional(),
776
+ /** Sent the message that triggered this task. */
777
+ newest: z.boolean().optional(),
778
+ /** Sent a message in the batch that triggered this task. */
779
+ asked: z.boolean().optional(),
780
+ });
781
+ export type TaskSlackParticipant = z.infer<typeof TaskSlackParticipantSchema>;
782
+
783
+ export const TaskSlackParticipantsSchema = z.object({
784
+ /** At most the cap, primary senders first. */
785
+ people: z.array(TaskSlackParticipantSchema),
786
+ /** Humans past the cap, rendered as `<N more...>`. */
787
+ more: z.number().int().min(0),
788
+ });
789
+ export type TaskSlackParticipants = z.infer<typeof TaskSlackParticipantsSchema>;
790
+
754
791
  export const AgentTaskSchema = z
755
792
  .object({
756
793
  id: z.uuid(),
@@ -805,6 +842,7 @@ export const AgentTaskSchema = z
805
842
  slackThreadTs: z.string().optional(),
806
843
  slackTriggerMessageTs: z.string().optional(),
807
844
  slackUserId: z.string().optional(),
845
+ slackParticipants: TaskSlackParticipantsSchema.optional(),
808
846
  slackReplySent: z.boolean().default(false),
809
847
  slackProgressMessageTs: z.string().optional(),
810
848
  slackTreeRootMessageTs: z.string().optional(),
@@ -972,6 +1010,8 @@ export const CreateTaskOptionsSchema = z.object({
972
1010
  /** Exact Slack message that directly triggered this task; never inherited. */
973
1011
  slackTriggerMessageTs: z.string().optional(),
974
1012
  slackUserId: z.string().optional(),
1013
+ /** People in the Slack thread; inherited by children like `slackUserId`. */
1014
+ slackParticipants: TaskSlackParticipantsSchema.optional(),
975
1015
  /**
976
1016
  * Opt out of the residual Slack/contextKey normalization (see the
977
1017
  * "Residual-mismatch guard" comment near the INSERT in src/be/db.ts): a
@@ -1306,7 +1346,39 @@ export type InboxItemState = z.infer<typeof InboxItemStateSchema>;
1306
1346
  // User Favorites (principal-scoped stars for app navigation)
1307
1347
  // ============================================================================
1308
1348
 
1309
- export const FavoriteItemTypeSchema = z.enum(["page", "workflow", "schedule", "agent-fs-path"]);
1349
+ export const ChecklistItemSchema = z
1350
+ .object({
1351
+ id: z.string(),
1352
+ scope: z.enum(["swarm", "user"]),
1353
+ userId: z.string().nullable(),
1354
+ kind: z.enum(["channel", "tool", "use_case", "custom"]),
1355
+ label: z.string(),
1356
+ href: z.string().nullable(),
1357
+ meta: z.record(z.string(), z.unknown()).nullable(),
1358
+ sortOrder: z.number(),
1359
+ status: z.enum(["open", "done", "removed"]),
1360
+ statusChangedAt: z.string().nullable(),
1361
+ statusChangedBy: z.string().nullable(),
1362
+ statusChangedByName: z.string().nullable(),
1363
+ statusReason: z.string().nullable(),
1364
+ nudgedAt: z.string().nullable(),
1365
+ nudgedTaskId: z.string().nullable(),
1366
+ signal: z.boolean().nullable(),
1367
+ done: z.boolean(),
1368
+ editable: z.boolean(),
1369
+ createdAt: z.string(),
1370
+ lastUpdatedAt: z.string(),
1371
+ })
1372
+ .openapi("ChecklistItem");
1373
+ export type ChecklistItem = z.infer<typeof ChecklistItemSchema>;
1374
+
1375
+ export const FavoriteItemTypeSchema = z.enum([
1376
+ "page",
1377
+ "workflow",
1378
+ "schedule",
1379
+ "agent-fs-path",
1380
+ "key",
1381
+ ]);
1310
1382
  export type FavoriteItemType = z.infer<typeof FavoriteItemTypeSchema>;
1311
1383
 
1312
1384
  export const UserFavoriteSchema = z