@desplega.ai/agent-swarm 2.8.3 → 2.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (597) hide show
  1. package/dist/acp-adapter-g909b5hw.js +16 -0
  2. package/dist/acp-targets-ny75x1qy.js +23 -0
  3. package/dist/{actions-ewz7bp4g.js → actions-b9qgrmeq.js} +82 -21
  4. package/dist/agent-fs-provision-b5dhdsbd.js +27 -0
  5. package/dist/{amp-adapter-f25tqhnf.js → amp-adapter-vtax2c9s.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-r5xf5hqw.js} +37 -37
  7. package/dist/{app-mkptw0k7.js → app-g2z15hax.js} +9 -4
  8. package/dist/approval-notifications-yt13wp8r.js +23 -0
  9. package/dist/{assistant-c47rfe77.js → assistant-2cgfxsgk.js} +56 -33
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-4vb0xsat.js → boot-args-schema-3gwy0f60.js} +1 -1
  12. package/dist/{boot-reembed-htr73hbs.js → boot-reembed-92g7s5zp.js} +1 -1
  13. package/dist/{boot-reembed-1ghy2sab.js → boot-reembed-mywmyp4s.js} +1 -1
  14. package/dist/{boot-scrub-sweep-yrytg42z.js → boot-scrub-sweep-7dkdzqxx.js} +84 -13
  15. package/dist/{boot-seeds-n2b3dx4e.js → boot-seeds-ce7rvgq1.js} +4 -4
  16. package/dist/{boxd-jmfqgkqa.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-3m4q7735.js +28 -0
  18. package/dist/{claude-managed-adapter-hddmxjyj.js → claude-managed-adapter-t8nfgcgz.js} +4 -4
  19. package/dist/{claude-managed-setup-hfvry1bd.js → claude-managed-setup-c217draw.js} +10 -10
  20. package/dist/{claude-sdk-session-0hamqzc7.js → claude-sdk-session-7fbqm51z.js} +9386 -9196
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-sdvcrq5x.js → cli-1jykg0py.js} +18 -14
  23. package/dist/{cli-k96cecs7.js → cli-2czxfnvj.js} +1221 -357
  24. package/dist/{cli-qmqt520k.js → cli-2dq9yv8p.js} +2 -2
  25. package/dist/{cli-e2w34h6z.js → cli-2xs8tsf7.js} +132 -85
  26. package/dist/{cli-z8cvws4c.js → cli-2yjj3e31.js} +907 -56
  27. package/dist/{cli-mdpbjnzq.js → cli-32djehja.js} +42 -42
  28. package/dist/{cli-gpz1d0t2.js → cli-3j873zxq.js} +4 -4
  29. package/dist/cli-43ms35q9.js +270 -0
  30. package/dist/cli-47hz21se.js +25584 -0
  31. package/dist/{cli-n515ex5z.js → cli-4ymxrwg5.js} +16 -16
  32. package/dist/{cli-f1kwb5fc.js → cli-5a6pqy45.js} +333 -21
  33. package/dist/{cli-93t5s4zq.js → cli-5gpqgs8b.js} +2 -2
  34. package/dist/{cli-15204js0.js → cli-6237rnyr.js} +1 -1
  35. package/dist/{cli-4ax9mvvg.js → cli-67mwzr35.js} +9 -9
  36. package/dist/{cli-t5ys4ebm.js → cli-6945ywhr.js} +3 -3
  37. package/dist/{cli-0bcgyj5b.js → cli-6ehs4mta.js} +87 -8
  38. package/dist/{cli-6yygkr0w.js → cli-6ym4jhzp.js} +15 -7
  39. package/dist/{cli-8bpgbr8k.js → cli-7evph51z.js} +5 -5
  40. package/dist/{cli-dtdht77h.js → cli-7mv4h3sn.js} +2 -2
  41. package/dist/{cli-nx2n3z6p.js → cli-7sf9sb0w.js} +3 -2
  42. package/dist/{cli-pe4d96rb.js → cli-7zm3b3f5.js} +1 -1
  43. package/dist/cli-8zh9nrew.js +78 -0
  44. package/dist/cli-9ttx00s3.js +137 -0
  45. package/dist/{cli-x6t50dmw.js → cli-9w8712tq.js} +620 -281
  46. package/dist/{cli-8476gtwf.js → cli-b6px1k1q.js} +1 -1
  47. package/dist/{cli-k2rw11py.js → cli-b91nz213.js} +5 -5
  48. package/dist/{cli-7c5tgqhf.js → cli-bg63qmsx.js} +10 -10
  49. package/dist/{cli-qps8je6j.js → cli-bkjdknnp.js} +54 -10
  50. package/dist/{cli-gn9y6fn7.js → cli-bnqncekd.js} +2 -2
  51. package/dist/{cli-s7zz734a.js → cli-br0924pw.js} +1 -1
  52. package/dist/{cli-h9yy18gy.js → cli-ctx0b85j.js} +5484 -5078
  53. package/dist/{cli-0vksaxvr.js → cli-dgs10ttj.js} +2 -2
  54. package/dist/cli-dqgnbnxs.js +132 -0
  55. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  56. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  57. package/dist/{cli-c0xjnr8z.js → cli-f3jyzq4g.js} +2 -2
  58. package/dist/cli-f8x9drqr.js +84 -0
  59. package/dist/{cli-ztq5z4e1.js → cli-f9gz2vyj.js} +6 -6
  60. package/dist/{cli-bhsfbmk8.js → cli-fh97xn30.js} +93 -44
  61. package/dist/cli-fkef327x.js +103 -0
  62. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  63. package/dist/{cli-kd56bmk4.js → cli-gabsjg8x.js} +3 -1
  64. package/dist/{cli-1m96dc36.js → cli-gfy38pvt.js} +3 -3
  65. package/dist/{cli-922z7gwm.js → cli-h9yqfzx9.js} +15 -11
  66. package/dist/{cli-5a7szzfh.js → cli-hnamkvnc.js} +2 -2
  67. package/dist/{cli-c3ng0mb4.js → cli-j7svy295.js} +71 -818
  68. package/dist/{cli-yss07azk.js → cli-jaw5v1sy.js} +3 -3
  69. package/dist/cli-jkw6ptfw.js +921 -0
  70. package/dist/{cli-s8p8hhty.js → cli-jm0hvmz2.js} +2 -2
  71. package/dist/{cli-knva3nmx.js → cli-jwampxxq.js} +8 -6
  72. package/dist/cli-kj0hyr43.js +51 -0
  73. package/dist/{cli-tnzebztn.js → cli-kpgcm7xy.js} +13 -1
  74. package/dist/{cli-9zmb7ptc.js → cli-kxx4k2jw.js} +8 -753
  75. package/dist/{cli-am1ptset.js → cli-m7c2380k.js} +208 -194
  76. package/dist/{cli-kw44j53p.js → cli-m7zvgt57.js} +45 -38
  77. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  78. package/dist/{cli-54qr8mcd.js → cli-mhapr559.js} +4 -4
  79. package/dist/{cli-tf79ryyy.js → cli-mjw0yf82.js} +3 -3
  80. package/dist/{cli-rjvsf9qa.js → cli-mkwkwq81.js} +14 -11
  81. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  82. package/dist/{cli-awwptga4.js → cli-mw620q3n.js} +1 -1
  83. package/dist/{cli-6wj7p986.js → cli-n3qe7tyr.js} +172 -168
  84. package/dist/{cli-4dpkjc2e.js → cli-nafvvsp8.js} +9 -9
  85. package/dist/{cli-sg27rk2t.js → cli-nbt14he0.js} +25 -19
  86. package/dist/{cli-7akn6ze9.js → cli-nh7x3133.js} +7 -28
  87. package/dist/{cli-zdaypkq9.js → cli-p4kckx1z.js} +285 -97
  88. package/dist/{cli-n5t077me.js → cli-pb2ay3sh.js} +10 -3
  89. package/dist/{cli-t4dv07kr.js → cli-psffsanb.js} +4 -3
  90. package/dist/{cli-mwwmka77.js → cli-pyjn0qhk.js} +2712 -268
  91. package/dist/{cli-emekyyhr.js → cli-q2d3e1k1.js} +1 -1
  92. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  93. package/dist/{cli-2d0cghfn.js → cli-qj39vrc6.js} +1 -1
  94. package/dist/{cli-tas6ckky.js → cli-rq5rpv6k.js} +2 -2
  95. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  96. package/dist/{cli-kmemts3w.js → cli-sn650d7x.js} +39 -69
  97. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  98. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  99. package/dist/{cli-500c09j9.js → cli-t9ga4qmb.js} +14 -14
  100. package/dist/{cli-me0r8gzr.js → cli-td9tb872.js} +27 -25
  101. package/dist/cli-tvc4jag9.js +754 -0
  102. package/dist/{cli-6ek0hff4.js → cli-ty3gha1p.js} +4 -4
  103. package/dist/{cli-c71n3bxq.js → cli-v57d7fmm.js} +2 -2
  104. package/dist/{cli-j8cjdzan.js → cli-vs9vdpy0.js} +1 -1
  105. package/dist/cli-vt89089n.js +296 -0
  106. package/dist/{cli-pxwtcgcp.js → cli-vyff45ve.js} +2 -2
  107. package/dist/{cli-x3ex5bqf.js → cli-w16kwbzw.js} +1 -1
  108. package/dist/{cli-bj6qhgte.js → cli-w4n323t3.js} +197 -45
  109. package/dist/{cli-rqfvkx5t.js → cli-wn13hhdt.js} +13 -13
  110. package/dist/{cli-skmhsnqh.js → cli-x40a0w9j.js} +1 -1
  111. package/dist/{cli-zeaehgyd.js → cli-xag7btpe.js} +2 -2
  112. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  113. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  114. package/dist/{cli-dpsfwh7n.js → cli-y2ewxhth.js} +56 -31
  115. package/dist/{cli-vx421edw.js → cli-ysvspf5e.js} +9 -7
  116. package/dist/{cli-crpf163n.js → cli-zh0e5x7p.js} +16 -26
  117. package/dist/{cli-4e1hfbpq.js → cli-zr6qy15y.js} +24 -24
  118. package/dist/cli.js +33 -29
  119. package/dist/{codex-adapter-2brxx5ta.js → codex-adapter-n656pvb8.js} +9 -8
  120. package/dist/{codex-hook-c930c3ea.js → codex-hook-59atdwd8.js} +6 -6
  121. package/dist/{codex-login-cbrs1h5w.js → codex-login-a239g1ah.js} +1 -1
  122. package/dist/{codex-session-runner-y9anfj0r.js → codex-session-runner-p0fbv5y9.js} +10 -9
  123. package/dist/{commands-wn9q06qr.js → commands-gwea8z5p.js} +3 -3
  124. package/dist/{controller-fw608czd.js → controller-t67c3grh.js} +9 -6
  125. package/dist/{controllers-connect-63j5rdcm.js → controllers-connect-ks155r0h.js} +28 -25
  126. package/dist/{cursor-adapter-6mb9jme8.js → cursor-adapter-ygwrtmkv.js} +2 -2
  127. package/dist/{db-y4wfrzbm.js → db-kpmx06s9.js} +21 -13
  128. package/dist/{db-0m6v5tq4.js → db-rb2xqdb1.js} +3 -3
  129. package/dist/{devin-adapter-r0yx3gv8.js → devin-adapter-zp4tqq53.js} +1 -1
  130. package/dist/{dispatcher-9tq2zzdj.js → dispatcher-31sm0ej2.js} +21 -18
  131. package/dist/{docker-j75atvpt.js → docker-09tkkg0n.js} +47 -8
  132. package/dist/{dsh-adapter-t09sv4tq.js → dsh-adapter-qyxh0w31.js} +2 -2
  133. package/dist/{e2b-a7vzs2vj.js → e2b-3v1e745x.js} +6 -6
  134. package/dist/{e2b-7s9dscap.js → e2b-sm28k0k3.js} +6 -6
  135. package/dist/{easter-egg-3d-fbwvmwhe.js → easter-egg-3d-00wjscn6.js} +1 -1
  136. package/dist/{embedding-space-wh8de1t9.js → embedding-space-qhw4g68n.js} +6 -6
  137. package/dist/{embeddings-3hpbdtjr.js → embeddings-zdv9ke6x.js} +1 -1
  138. package/dist/{event-bus-tr6h3gv8.js → event-bus-xr83x566.js} +1 -1
  139. package/dist/{execute-4bdf8sdy.js → execute-zna8wwr7.js} +1 -1
  140. package/dist/{external-channel-ts2fwqh0.js → external-channel-1ac6t56s.js} +2 -2
  141. package/dist/fx-adapter-sk7n0fzc.js +19 -0
  142. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  143. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  144. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  145. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  146. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  147. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-maq6c9bf.js} +1 -1
  148. package/dist/{google-vertex-fhxaafzw.js → google-vertex-2jgsw2nb.js} +5 -5
  149. package/dist/grok-adapter-sjbcm5ew.js +19 -0
  150. package/dist/handlers-yzy0c87x.js +35 -0
  151. package/dist/{heartbeat-2ze5fzpc.js → heartbeat-2f6z4kdx.js} +24 -21
  152. package/dist/{hook-gaehe2w5.js → hook-8y0gvtp1.js} +14 -14
  153. package/dist/{hook-ca54yd4s.js → hook-w1skzaqc.js} +5 -5
  154. package/dist/{http-jfg8t2yk.js → http-wghxvpef.js} +2333 -589
  155. package/dist/{index-d6wkh8ar.js → index-0h6qd4p1.js} +34 -24
  156. package/dist/index-25pvya7q.js +40 -0
  157. package/dist/index-2t4859r5.js +35 -0
  158. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  159. package/dist/{index-khe3gp0k.js → index-4k7m5dgj.js} +645 -370
  160. package/dist/index-620y7jzq.js +15 -0
  161. package/dist/{index-gjwaqaq8.js → index-8p0j4h4j.js} +506 -43
  162. package/dist/{index-3gv6sc4z.js → index-8zn8nxn5.js} +1 -1
  163. package/dist/{index-m5gx1xd6.js → index-9myfj74s.js} +40 -40
  164. package/dist/{index-3yvzbhxd.js → index-9zkchs9t.js} +336 -193
  165. package/dist/{index-0rvk3vd4.js → index-b5wgnm78.js} +47 -47
  166. package/dist/index-cxca2t8y.js +36 -0
  167. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  168. package/dist/{index-hjhfk3ra.js → index-pe3d8jfy.js} +3 -3
  169. package/dist/index-rv89fvzf.js +572 -0
  170. package/dist/{index-csgrxedz.js → index-s71ez27v.js} +1 -1
  171. package/dist/{keepalive-k2a3qe73.js → keepalive-sh02349h.js} +4 -4
  172. package/dist/lead-gk4h5eg7.js +74 -0
  173. package/dist/{maintenance-gb5sd5nc.js → maintenance-yj0dcjja.js} +1 -1
  174. package/dist/{node-252anz2h.js → node-dqm4xgxw.js} +4 -4
  175. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  176. package/dist/{oauth-refresh-sweep-y7rm6bkb.js → oauth-refresh-sweep-d9xedk66.js} +3 -3
  177. package/dist/{onboard-jmc5qerv.js → onboard-dpgjn03r.js} +8 -8
  178. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  179. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  180. package/dist/{opencode-adapter-7eade9ev.js → opencode-adapter-2d31cpjc.js} +7 -6
  181. package/dist/{otel-impl-8j1xhxqd.js → otel-impl-1skarpfq.js} +110 -110
  182. package/dist/pending-bfmxtx0g.js +82 -0
  183. package/dist/{pi-mono-adapter-yqmaf32x.js → pi-mono-adapter-gvppnasy.js} +43 -16
  184. package/dist/{pricing-refresh-1nj722h6.js → pricing-refresh-c6b325mk.js} +2 -2
  185. package/dist/{rbac-roles-b1mtr6dr.js → rbac-roles-h80qbdbs.js} +3 -3
  186. package/dist/{rbac-roles-n1f3frk1.js → rbac-roles-zfcx68tx.js} +10 -3
  187. package/dist/{render-v2-1gfpd8rj.js → render-v2-nx20t3rb.js} +7 -4
  188. package/dist/{resume-w1s1eh5v.js → resume-5ep8agan.js} +11 -7
  189. package/dist/{runtime-84g5egsc.js → runtime-r3pj4mce.js} +1 -1
  190. package/dist/{session-access-y6z1txk4.js → session-access-n7p3m15b.js} +4 -4
  191. package/dist/{session-source-backfill-gxxwfh12.js → session-source-backfill-v8mt0zwn.js} +4 -4
  192. package/dist/{setup-r91gstyk.js → setup-z1psaqhe.js} +1 -1
  193. package/dist/thread-buffer-a1re2r9r.js +38 -0
  194. package/dist/{virtual-modules-cgnj6kme.js → virtual-modules-rrbjdpxn.js} +5 -5
  195. package/dist/{work-objects-qcxzg61c.js → work-objects-4aghh73z.js} +31 -23
  196. package/dist/worker-3dyyb8ev.js +74 -0
  197. package/dist/{worker-follow-up-y2d2h7km.js → worker-follow-up-166zmex1.js} +21 -18
  198. package/dist/{x-qhxq2ama.js → x-wg164ss9.js} +2 -2
  199. package/openapi.json +2561 -131
  200. package/package.json +15 -11
  201. package/plugin/commands/create-pr.md +1 -1
  202. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  203. package/src/apps/action-runner.ts +21 -1
  204. package/src/apps/catalog.generated.json +667 -18
  205. package/src/apps/page-validator.ts +341 -8
  206. package/src/assets/key.ts +6 -0
  207. package/src/be/agent-fs-user-keys.ts +186 -0
  208. package/src/be/audit-user.ts +27 -13
  209. package/src/be/automation-preflight.test.ts +14 -14
  210. package/src/be/automation-preflight.ts +24 -16
  211. package/src/be/boot-scrub-sweep.ts +143 -14
  212. package/src/be/caller-session-group.ts +86 -0
  213. package/src/be/checklist.ts +375 -0
  214. package/src/be/db/agents.ts +12 -1
  215. package/src/be/db/approvals.ts +26 -0
  216. package/src/be/db/model-profiles.ts +4 -1
  217. package/src/be/db/session-costs.ts +219 -0
  218. package/src/be/db/session-log-reasoning.ts +36 -0
  219. package/src/be/db/session-moves.ts +23 -0
  220. package/src/be/db/session-tree.ts +78 -19
  221. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  222. package/src/be/db/tasks/read.ts +7 -3
  223. package/src/be/db/tasks/slack-fold.ts +116 -0
  224. package/src/be/db/tasks/write.ts +67 -1
  225. package/src/be/db-queries/mcp-servers.ts +13 -0
  226. package/src/be/db-queries/oauth.ts +6 -0
  227. package/src/be/db-queries/task-artifacts.ts +10 -8
  228. package/src/be/db.ts +242 -319
  229. package/src/be/extensions/assets.ts +17 -13
  230. package/src/be/import/config.ts +54 -0
  231. package/src/be/import/dir-source.ts +372 -0
  232. package/src/be/import/index.ts +149 -0
  233. package/src/be/import/pending.ts +71 -0
  234. package/src/be/import/schema.ts +137 -0
  235. package/src/be/import/seeders.ts +462 -0
  236. package/src/be/key-window-usage.ts +385 -0
  237. package/src/be/migrations/297_import_ownership.sql +34 -0
  238. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  239. package/src/be/migrations/302_checklist_items.sql +23 -0
  240. package/src/be/migrations/303_task_ui_specs.sql +28 -0
  241. package/src/be/migrations/306_provider_account_telemetry.sql +1 -0
  242. package/src/be/migrations/307_session_cost_credential_attribution.sql +23 -0
  243. package/src/be/migrations/310_session_logs_reasoning.sql +12 -0
  244. package/src/be/multi-runtime.ts +8 -1
  245. package/src/be/rbac-roles.ts +8 -1
  246. package/src/be/runtime-pools/db.ts +3 -0
  247. package/src/be/runtime-pools/demand.ts +20 -2
  248. package/src/be/runtime-pools/reachability.ts +31 -0
  249. package/src/be/runtime-pools/routing.ts +8 -1
  250. package/src/be/runtime-pools/supervisor.ts +6 -7
  251. package/src/be/savings/read.ts +8 -6
  252. package/src/be/script-credential-broker.ts +2 -2
  253. package/src/be/scripts/typecheck.ts +4 -4
  254. package/src/be/seed/agent-fs-provision.ts +104 -19
  255. package/src/be/seed/index.ts +1 -1
  256. package/src/be/seed/registry.ts +27 -8
  257. package/src/be/seed/runner.ts +1 -1
  258. package/src/be/seed/schedules-seeder.ts +24 -6
  259. package/src/be/seed/seed-toggle.ts +32 -0
  260. package/src/be/seed/types.ts +6 -0
  261. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -0
  262. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -0
  263. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  264. package/src/be/seed-scripts/catalog/wait-for-task.ts +5 -1
  265. package/src/be/seed-skills/index.ts +3 -0
  266. package/src/be/steering.ts +27 -4
  267. package/src/be/swarm-config-guard.ts +54 -1
  268. package/src/be/task-citations.ts +8 -5
  269. package/src/be/task-ui-spec.ts +158 -0
  270. package/src/commands/controller.ts +3 -0
  271. package/src/commands/credential-outcome-report.ts +13 -3
  272. package/src/commands/onboard/agent-fs-version.ts +1 -1
  273. package/src/commands/rate-limit-outcome.ts +6 -0
  274. package/src/commands/runner.ts +95 -55
  275. package/src/e2b/env.ts +2 -0
  276. package/src/extensions/catalog.generated.json +17 -0
  277. package/src/extensions/contract-types.generated.ts +1 -1
  278. package/src/github/app.ts +10 -1
  279. package/src/github/handlers.ts +6 -3
  280. package/src/github/reactions.ts +12 -14
  281. package/src/heartbeat/heartbeat.ts +14 -4
  282. package/src/http/agents.ts +19 -10
  283. package/src/http/all-routes.ts +2 -0
  284. package/src/http/api-keys.ts +258 -30
  285. package/src/http/approval-requests.ts +24 -4
  286. package/src/http/apps.ts +69 -5
  287. package/src/http/checklist.ts +176 -0
  288. package/src/http/db-query-bounded.ts +256 -11
  289. package/src/http/db-query-shared.ts +9 -0
  290. package/src/http/favorites.ts +14 -2
  291. package/src/http/fs.ts +346 -1
  292. package/src/http/index.ts +29 -1
  293. package/src/http/kv.ts +13 -0
  294. package/src/http/mcp-oauth.ts +1 -1
  295. package/src/http/mcp-servers.ts +15 -2
  296. package/src/http/onboarding.ts +2 -9
  297. package/src/http/poll.ts +45 -0
  298. package/src/http/script-connections.ts +1 -0
  299. package/src/http/session-data.ts +74 -23
  300. package/src/http/sessions.ts +23 -2
  301. package/src/http/slack-events.ts +101 -0
  302. package/src/http/status.ts +25 -7
  303. package/src/http/task-requester.ts +46 -0
  304. package/src/http/tasks.ts +169 -42
  305. package/src/http/users.ts +14 -0
  306. package/src/http/webhooks.ts +15 -0
  307. package/src/integrations/cards/index.ts +151 -0
  308. package/src/integrations/chat-sdk/outbound.ts +39 -13
  309. package/src/integrations/chat-sdk/relay.ts +87 -0
  310. package/src/integrations/chat-sdk/runtime.ts +7 -1
  311. package/src/integrations/chat-sdk/status.ts +17 -0
  312. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  313. package/src/jira/outbound.ts +5 -3
  314. package/src/kv-reserved-namespaces.ts +17 -2
  315. package/src/linear/outbound.ts +5 -1
  316. package/src/oauth/presets.ts +29 -2
  317. package/src/prompts/base-prompt.ts +25 -4
  318. package/src/prompts/session-templates.ts +102 -8
  319. package/src/providers/acp-targets.ts +1 -1
  320. package/src/providers/amp-adapter.ts +1 -1
  321. package/src/providers/claude-adapter.ts +27 -4
  322. package/src/providers/claude-flag-settings.ts +39 -1
  323. package/src/providers/claude-managed-adapter.ts +5 -1
  324. package/src/providers/codex-adapter.ts +86 -4
  325. package/src/providers/codex-app-server.ts +11 -16
  326. package/src/providers/codex-oauth/auth-json.ts +1 -0
  327. package/src/providers/opencode-adapter.ts +7 -19
  328. package/src/providers/pi-mono-adapter.ts +35 -2
  329. package/src/providers/pricing-sources.md +32 -0
  330. package/src/providers/runtime-dependencies.ts +158 -0
  331. package/src/providers/types.ts +11 -0
  332. package/src/rbac/legacy-policy.ts +2 -0
  333. package/src/rbac/permissions.ts +10 -1
  334. package/src/runtime-providers/docker.ts +65 -1
  335. package/src/scheduler/deferred-task-waits.ts +18 -5
  336. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  337. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  338. package/src/scripts-runtime/egress-secrets.ts +2 -2
  339. package/src/scripts-runtime/swarm-sdk.ts +3 -2
  340. package/src/scripts-runtime/types/stdlib.d.ts +11 -4
  341. package/src/scripts-runtime/types/swarm-extension.d.ts +9 -9
  342. package/src/scripts-runtime/types/swarm-sdk.d.ts +11 -4
  343. package/src/server.ts +4 -4
  344. package/src/slack/actions.ts +56 -0
  345. package/src/slack/app.ts +107 -59
  346. package/src/slack/assistant.ts +33 -7
  347. package/src/slack/handlers.ts +6 -4
  348. package/src/slack/http-receiver.ts +284 -0
  349. package/src/slack/inbound-dispatch.ts +43 -7
  350. package/src/slack/inbound-files.ts +35 -14
  351. package/src/slack/message-text.ts +47 -4
  352. package/src/slack/render-v2.ts +109 -24
  353. package/src/slack/responses.ts +3 -2
  354. package/src/slack/socket-ack.ts +17 -10
  355. package/src/slack/steering.ts +5 -0
  356. package/src/slack/thread-buffer-store.ts +58 -0
  357. package/src/slack/thread-buffer.ts +341 -57
  358. package/src/slack/work-objects.ts +4 -1
  359. package/src/tasks/context-key.ts +24 -0
  360. package/src/tasks/errors.ts +5 -0
  361. package/src/tasks/sibling-awareness.ts +13 -1
  362. package/src/tests/acp-adapter.test.ts +4 -6
  363. package/src/tests/agent-fs-live-url.test.ts +15 -0
  364. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  365. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  366. package/src/tests/agentfs-proxy.test.ts +8 -8
  367. package/src/tests/api-key-tracking.test.ts +0 -72
  368. package/src/tests/api-keys-status-model-limits.test.ts +93 -1
  369. package/src/tests/api-keys-validation.test.ts +42 -0
  370. package/src/tests/approval-card-resolution.test.ts +402 -0
  371. package/src/tests/approval-requests-notifications.test.ts +12 -2
  372. package/src/tests/approval-respond-auth.test.ts +28 -0
  373. package/src/tests/apps-action-parent-task.test.ts +140 -0
  374. package/src/tests/apps-catalog-additions.test.ts +315 -0
  375. package/src/tests/apps-catalog-files.test.ts +114 -0
  376. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  377. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  378. package/src/tests/apps-catalog-page-frame.test.ts +49 -0
  379. package/src/tests/apps-catalog-table.test.ts +47 -0
  380. package/src/tests/apps-chart-shell.test.ts +1 -1
  381. package/src/tests/apps-element-assembly.test.ts +52 -3
  382. package/src/tests/apps-session-thread.test.ts +261 -0
  383. package/src/tests/asset-key-invariants.test.ts +14 -0
  384. package/src/tests/base-prompt.test.ts +213 -23
  385. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  386. package/src/tests/caller-session-group.test.ts +199 -0
  387. package/src/tests/cards.test.ts +169 -0
  388. package/src/tests/chat-sdk-relay.test.ts +149 -1
  389. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  390. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  391. package/src/tests/chat-sdk-tools.test.ts +147 -0
  392. package/src/tests/checklist-nudge.test.ts +208 -0
  393. package/src/tests/checklist.test.ts +686 -0
  394. package/src/tests/claude-adapter-binary.test.ts +67 -6
  395. package/src/tests/claude-flag-settings.test.ts +29 -0
  396. package/src/tests/claude-sdk-lifecycle.test.ts +5 -0
  397. package/src/tests/codex-adapter.test.ts +340 -2
  398. package/src/tests/codex-app-server.test.ts +32 -0
  399. package/src/tests/codex-oauth.test.ts +3 -1
  400. package/src/tests/codex-rate-limits.test.ts +384 -0
  401. package/src/tests/comb-config-guard.test.ts +21 -0
  402. package/src/tests/comb-default.test.ts +59 -97
  403. package/src/tests/comb-links.test.ts +86 -16
  404. package/src/tests/comb-status.test.ts +24 -27
  405. package/src/tests/create-page-tool.test.ts +101 -1
  406. package/src/tests/create-schedule-key.test.ts +105 -0
  407. package/src/tests/credential-broker.test.ts +2 -2
  408. package/src/tests/credential-outcome-report.test.ts +20 -0
  409. package/src/tests/db-query.test.ts +87 -1
  410. package/src/tests/db-task-read-contract.test.ts +4 -0
  411. package/src/tests/db-task-write-contract.test.ts +6 -1
  412. package/src/tests/deferred-task-wake.test.ts +63 -1
  413. package/src/tests/docker-isolation-config-guard.test.ts +29 -0
  414. package/src/tests/docs-index-footprint.test.js +11 -3
  415. package/src/tests/e2e-visuals-comment.test.ts +82 -0
  416. package/src/tests/e2e-visuals-verify-pr.test.ts +138 -0
  417. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  418. package/src/tests/extensions-assets.test.ts +7 -3
  419. package/src/tests/extensions-catalog.test.ts +1 -0
  420. package/src/tests/extensions-example-sql-admin-only.test.ts +201 -0
  421. package/src/tests/extensions-pre-task.test.ts +3 -3
  422. package/src/tests/extensions-steering.test.ts +14 -2
  423. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  424. package/src/tests/fetch-resolved-env.test.ts +68 -0
  425. package/src/tests/fixtures/import-package.ts +32 -0
  426. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  427. package/src/tests/fixtures/ui-spec-slack/deploys.json +121 -0
  428. package/src/tests/fixtures/ui-spec-slack/incident.json +183 -0
  429. package/src/tests/fixtures/ui-spec-slack/three-charts-stale.json +196 -0
  430. package/src/tests/fixtures/ui-spec-slack/video-rejected-by-slack.json +183 -0
  431. package/src/tests/fixtures/ui-spec-slack/video.json +446 -0
  432. package/src/tests/fs-routes.test.ts +505 -2
  433. package/src/tests/github-ghes-mock.test.ts +196 -0
  434. package/src/tests/github-host.test.ts +285 -0
  435. package/src/tests/gitleaks-download-retry.test.ts +85 -0
  436. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  437. package/src/tests/heartbeat.test.ts +56 -0
  438. package/src/tests/human-thread-routing.test.ts +187 -0
  439. package/src/tests/import-config.test.ts +209 -0
  440. package/src/tests/import.test.ts +464 -0
  441. package/src/tests/invites-http.test.ts +144 -1
  442. package/src/tests/jira-outbound-sync.test.ts +33 -1
  443. package/src/tests/key-window-usage.test.ts +831 -0
  444. package/src/tests/kv-http.test.ts +11 -0
  445. package/src/tests/linear-outbound-sync.test.ts +30 -1
  446. package/src/tests/literal-matcher.test.ts +58 -0
  447. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  448. package/src/tests/oauth-presets.test.ts +12 -0
  449. package/src/tests/pi-mono-adapter.test.ts +79 -0
  450. package/src/tests/pool-affinity.test.ts +50 -0
  451. package/src/tests/preload-env.test.ts +2 -0
  452. package/src/tests/preload.ts +3 -1
  453. package/src/tests/prompt-template-session.test.ts +53 -5
  454. package/src/tests/provider-quota-persistence.test.ts +362 -0
  455. package/src/tests/provider-registration.test.ts +2 -55
  456. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  457. package/src/tests/rate-limit-event.test.ts +22 -0
  458. package/src/tests/rbac-admission.test.ts +19 -0
  459. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  460. package/src/tests/rbac-engine.test.ts +2 -0
  461. package/src/tests/rbac-roles.test.ts +2 -0
  462. package/src/tests/reasoning-events.test.ts +164 -0
  463. package/src/tests/routing-affinity-inventory.test.ts +22 -0
  464. package/src/tests/runner-missing-dependency.test.ts +61 -0
  465. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  466. package/src/tests/runtime-pool-routing.test.ts +52 -0
  467. package/src/tests/runtime-providers-docker.test.ts +91 -0
  468. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  469. package/src/tests/savings-fleet-slices.test.ts +122 -0
  470. package/src/tests/savings-read.test.ts +41 -0
  471. package/src/tests/savings-scripts.test.ts +9 -3
  472. package/src/tests/script-connections.test.ts +7 -0
  473. package/src/tests/script-executor-conformance.test.ts +41 -4
  474. package/src/tests/secret-canary-sweep.test.ts +41 -5
  475. package/src/tests/secret-scrub-gate.test.ts +257 -0
  476. package/src/tests/seed-registry.test.ts +142 -9
  477. package/src/tests/seed-scripts.test.ts +23 -0
  478. package/src/tests/session-cost-attribution.test.ts +748 -0
  479. package/src/tests/session-costs.test.ts +14 -15
  480. package/src/tests/session-logs.test.ts +83 -0
  481. package/src/tests/session-source-keys.test.ts +42 -1
  482. package/src/tests/sessions-detail-batch.test.ts +7 -0
  483. package/src/tests/sessions-move.test.ts +70 -0
  484. package/src/tests/sessions-tree.test.ts +98 -0
  485. package/src/tests/sessions.test.ts +69 -0
  486. package/src/tests/slack-config.test.ts +4 -18
  487. package/src/tests/slack-http-receiver.test.ts +472 -0
  488. package/src/tests/slack-inbound-logging.test.ts +64 -0
  489. package/src/tests/slack-leave-thread.test.ts +1 -1
  490. package/src/tests/slack-message-text.test.ts +104 -0
  491. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  492. package/src/tests/slack-render-v2.test.ts +405 -0
  493. package/src/tests/slack-skip-reaction.test.ts +2 -2
  494. package/src/tests/slack-start-reload-race.test.ts +67 -0
  495. package/src/tests/slack-steering.test.ts +22 -10
  496. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  497. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  498. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  499. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  500. package/src/tests/slack-thread-buffer.test.ts +34 -34
  501. package/src/tests/slack-thread-participants.test.ts +23 -5
  502. package/src/tests/slack-tool-blocks.test.ts +167 -0
  503. package/src/tests/status.test.ts +32 -6
  504. package/src/tests/steering-core.test.ts +13 -0
  505. package/src/tests/steering-enabled.test.ts +7 -1
  506. package/src/tests/steering-promotion.test.ts +24 -0
  507. package/src/tests/subscription-plans.test.ts +20 -1
  508. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  509. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  510. package/src/tests/task-artifacts.test.ts +50 -0
  511. package/src/tests/task-session-prompts.test.ts +95 -1
  512. package/src/tests/task-ui-action-route.test.ts +191 -0
  513. package/src/tests/task-ui-actions.test.ts +195 -0
  514. package/src/tests/task-ui-spec-fallback.test.ts +65 -0
  515. package/src/tests/task-ui-spec.test.ts +368 -0
  516. package/src/tests/workflow-agent-task-retry.test.ts +34 -1
  517. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  518. package/src/tools/chat-post.ts +19 -4
  519. package/src/tools/chat-reply.ts +20 -4
  520. package/src/tools/create-page.ts +21 -4
  521. package/src/tools/defer-task.ts +1 -1
  522. package/src/tools/get-swarm.ts +18 -2
  523. package/src/tools/join-swarm.ts +2 -1
  524. package/src/tools/kv/kv-write-auth.ts +17 -1
  525. package/src/tools/schedules/create-schedule.ts +22 -4
  526. package/src/tools/slack-post.ts +40 -7
  527. package/src/tools/slack-reply.ts +50 -14
  528. package/src/tools/store-progress.ts +69 -3
  529. package/src/types.ts +50 -4
  530. package/src/ui-spec/actions.ts +86 -0
  531. package/src/ui-spec/fallback.ts +19 -0
  532. package/src/ui-spec/slack.ts +17 -0
  533. package/src/ui-spec/validate.ts +169 -0
  534. package/src/utils/codex-rate-limits.ts +159 -0
  535. package/src/utils/constants.ts +60 -138
  536. package/src/utils/credentials.ts +2 -0
  537. package/src/utils/error-tracker.ts +19 -0
  538. package/src/utils/github-host.ts +217 -0
  539. package/src/utils/github-pull-request.ts +8 -5
  540. package/src/utils/literal-matcher.ts +118 -0
  541. package/src/utils/provider-account-telemetry.ts +331 -0
  542. package/src/utils/reasoning-events.ts +107 -0
  543. package/src/utils/secret-scrubber.ts +331 -25
  544. package/src/utils/subscription-plans.ts +11 -59
  545. package/src/utils/task-attachment-links.ts +9 -12
  546. package/src/utils/task-ui-spec.ts +67 -0
  547. package/src/vcs/index.ts +3 -0
  548. package/src/workflows/approval-notifications.ts +188 -12
  549. package/src/workflows/executors/system-one-extraction.ts +14 -7
  550. package/src/workflows/executors/system-one-providers.ts +22 -1
  551. package/src/workflows/task-step-routing.ts +8 -3
  552. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  553. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  554. package/templates/extensions/README.md +1 -0
  555. package/templates/extensions/sql-admin-only/README.md +20 -0
  556. package/templates/extensions/sql-admin-only/hooks.ts +100 -0
  557. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  558. package/templates/import/manifest.schema.json +136 -0
  559. package/templates/import/sources.schema.json +44 -0
  560. package/templates/skills/agent-browser/SKILL.md +1 -1
  561. package/templates/skills/agent-browser/content.md +1 -1
  562. package/templates/skills/apps/SKILL.md +151 -14
  563. package/templates/skills/apps/content.md +151 -14
  564. package/templates/skills/asset-namespaces/content.md +2 -1
  565. package/templates/skills/chat-sdk/content.md +17 -0
  566. package/templates/skills/db-query-guidance/content.md +2 -1
  567. package/templates/skills/scheduling/content.md +27 -0
  568. package/templates/skills/slack-interaction/content.md +12 -2
  569. package/templates/skills/swarm-docs/content.md +1 -0
  570. package/templates/skills/swarm-extensions/config.json +1 -1
  571. package/templates/skills/swarm-extensions/content.md +33 -23
  572. package/templates/skills/swarm-scripts/SKILL.md +13 -0
  573. package/templates/skills/swarm-scripts/content.md +13 -0
  574. package/templates/skills/ui-spec/config.json +14 -0
  575. package/templates/skills/ui-spec/content.md +127 -0
  576. package/templates/skills/work-on-task/SKILL.md +1 -1
  577. package/templates/skills/work-on-task/content.md +1 -1
  578. package/templates/skills/workflow-iterate/content.md +4 -7
  579. package/templates/workflows/dreaming/content.md +2 -2
  580. package/dist/acp-adapter-xq6s2z6t.js +0 -14
  581. package/dist/claude-adapter-r33pqnzx.js +0 -24
  582. package/dist/cli-dns0y538.js +0 -194
  583. package/dist/cli-m2z8jagn.js +0 -12078
  584. package/dist/fx-adapter-1rnxnf56.js +0 -17
  585. package/dist/grok-adapter-efhmf1r8.js +0 -17
  586. package/dist/handlers-anrr3py9.js +0 -32
  587. package/dist/index-2skqtd76.js +0 -12795
  588. package/dist/index-8w2aznds.js +0 -33
  589. package/dist/index-qnjvr362.js +0 -37
  590. package/dist/index-yzxd3sn9.js +0 -32
  591. package/dist/lead-zhxqbfdv.js +0 -69
  592. package/dist/worker-7j2907g6.js +0 -69
  593. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  594. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  595. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  596. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  597. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -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),
@@ -28,6 +28,7 @@ import {
28
28
  MAX_TASK_CITATIONS,
29
29
  upsertTaskCitations,
30
30
  } from "@/be/task-citations";
31
+ import { hasTaskUiSpecCheckRefusal, upsertTaskUiSpec } from "@/be/task-ui-spec";
31
32
  import { AgentFsProvider } from "@/fs/agent-fs-provider";
32
33
  import { can } from "@/rbac";
33
34
  import { finalizeSkippedTaskReaction, skipReasonFrom } from "@/tasks/task-skip";
@@ -38,8 +39,11 @@ import {
38
39
  } from "@/tasks/terminal-result-guard";
39
40
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
40
41
  import { AgentTaskStatusSchema, AttachmentInputSchema, isTerminalTaskStatus } from "@/types";
42
+ import { validateTaskUiSpec } from "@/ui-spec/validate";
43
+ import { isEnvFlagEnabled } from "@/utils/env-flag";
41
44
  import { scrubSecrets } from "@/utils/secret-scrubber";
42
45
  import { taskCitationIssues, taskCitationWarnings } from "@/utils/task-citations";
46
+ import { UI_SPEC_ACTION_ID } from "@/utils/task-ui-spec";
43
47
  import { ensure } from "../utils/business-use";
44
48
 
45
49
  // Phase 11: the `cost` / `costData` field was removed from this tool's input
@@ -199,6 +203,27 @@ export const registerStoreProgressTool = (server: McpServer) => {
199
203
  .describe(
200
204
  'Claim sources, upserted by index across calls. Use only for factual claims the reader cannot already see in the thread or task tree, 1-2 sources; none on delegation, routing, acks, or status replies. Reference each one in output with [citation:N], or set general: true for a source that backs the whole answer (it renders under "General sources"). ref per kind: task = task UUID; memory = memory UUID (optional quote must appear verbatim in it); github = owner/repo#N, owner/repo@<sha>, or a github.com pull, issues, or commit URL; slack = permalink or channel/ts; agent-fs = file path; page = page id; script-run = script run id; url = http(s) URL. The first completing call is refused, and the task stays in progress, if a marker has no entry, a citation fails validation, or a non-general citation is unreferenced; the response lists each problem. After one refusal, completion proceeds and those markers and sources are dropped from rendered output. At most 50 citations per call/task, refs up to 2048 characters, labels up to 200. Invalid or oversized batches are ignored; existing indices can still be updated at capacity.',
201
205
  ),
206
+ uiSpec: z
207
+ .object({
208
+ spec: z
209
+ .object({
210
+ root: z.string().min(1),
211
+ elements: z.record(z.string(), z.unknown()),
212
+ state: z.record(z.string(), z.unknown()).optional(),
213
+ })
214
+ .describe("A json-render spec for the chat catalog. Root must be a Card."),
215
+ actions: z
216
+ .record(
217
+ z.string().regex(UI_SPEC_ACTION_ID),
218
+ z.object({ kind: z.literal("follow_up"), prompt: z.string().min(1).max(4000) }),
219
+ )
220
+ .optional()
221
+ .describe("Actions that Button ids name. Needs UI_SPEC_ACTIONS_ENABLED=true."),
222
+ })
223
+ .optional()
224
+ .describe(
225
+ "Optional rich card for this result, rendered in the Slack outcome card, the session view and Chat SDK channels. `output` stays the prose answer. A Slack card shows only the spec of its own task. See the ui-spec skill.",
226
+ ),
202
227
  learning: z
203
228
  .union([
204
229
  z.string(),
@@ -246,6 +271,7 @@ export const registerStoreProgressTool = (server: McpServer) => {
246
271
  failureReason,
247
272
  attachments,
248
273
  citations,
274
+ uiSpec,
249
275
  learning,
250
276
  persistMemory,
251
277
  chainedTaskId,
@@ -398,6 +424,8 @@ export const registerStoreProgressTool = (server: McpServer) => {
398
424
  }
399
425
 
400
426
  let learningWrite: Promise<TaskLearningResult> | undefined;
427
+ // A sentence about the uiSpec, appended to a successful result message.
428
+ let uiSpecNote: string | undefined;
401
429
  const result = await getDbClient().transaction(async () => {
402
430
  const agent = await getAgentById(requestInfo.agentId ?? "");
403
431
 
@@ -606,9 +634,45 @@ export const registerStoreProgressTool = (server: McpServer) => {
606
634
  }
607
635
  }
608
636
 
637
+ // uiSpec: stored only with a completion, and only when the flag is on.
638
+ // An invalid spec refuses the first completion, like citations above.
639
+ let uiSpecToStore: Parameters<typeof upsertTaskUiSpec>[1] | undefined;
640
+ if (uiSpec && !isEnvFlagEnabled("UI_SPEC_ENABLED", false)) {
641
+ uiSpecNote = "uiSpec ignored: UI_SPEC_ENABLED is off.";
642
+ } else if (uiSpec && status !== "completed") {
643
+ uiSpecNote = 'uiSpec is stored only with status "completed".';
644
+ } else if (uiSpec) {
645
+ const validation = validateTaskUiSpec(uiSpec, {
646
+ taskId,
647
+ actionsEnabled: isEnvFlagEnabled("UI_SPEC_ACTIONS_ENABLED", false),
648
+ });
649
+ if (validation.ok) {
650
+ uiSpecToStore = {
651
+ spec: validation.spec,
652
+ ...(validation.actions ? { actions: validation.actions } : {}),
653
+ fallbackText: validation.fallbackText,
654
+ };
655
+ } else if (!(await hasTaskUiSpecCheckRefusal(taskId))) {
656
+ await createLogEntry({
657
+ eventType: "task_ui_spec_check_refused",
658
+ agentId: agent.id,
659
+ taskId,
660
+ newValue: validation.issues.join("\n"),
661
+ });
662
+ return {
663
+ success: false,
664
+ task: existingTask,
665
+ message: `Completion refused: uiSpec is not valid. The task stays ${existingTask.status}. Fix these, then call store-progress again:\n- ${validation.issues.join("\n- ")}\nThis check refuses once per task; the next completion is accepted without the spec.`,
666
+ };
667
+ } else {
668
+ uiSpecNote = `uiSpec dropped: ${validation.issues[0]}`;
669
+ }
670
+ }
671
+
609
672
  // Handle status change
610
673
  if (status === "completed") {
611
674
  const result = await completeTask(taskId, output);
675
+ if (result && uiSpecToStore) await upsertTaskUiSpec(taskId, uiSpecToStore);
612
676
  if (result) {
613
677
  updatedTask = result;
614
678
 
@@ -737,9 +801,11 @@ export const registerStoreProgressTool = (server: McpServer) => {
737
801
 
738
802
  const learningResult = await learningWrite;
739
803
  const { success } = result;
740
- const message = learningResult
741
- ? `${result.message} ${learningSentence(learningResult)}`
742
- : result.message;
804
+ const message = [
805
+ result.message,
806
+ ...(learningResult ? [learningSentence(learningResult)] : []),
807
+ ...(success && uiSpecNote ? [uiSpecNote] : []),
808
+ ].join(" ");
743
809
  const task = result.task
744
810
  ? {
745
811
  id: result.task.id,
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
@@ -1337,7 +1346,39 @@ export type InboxItemState = z.infer<typeof InboxItemStateSchema>;
1337
1346
  // User Favorites (principal-scoped stars for app navigation)
1338
1347
  // ============================================================================
1339
1348
 
1340
- 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
+ ]);
1341
1382
  export type FavoriteItemType = z.infer<typeof FavoriteItemTypeSchema>;
1342
1383
 
1343
1384
  export const UserFavoriteSchema = z
@@ -1875,6 +1916,8 @@ export const AgentLogEventTypeSchema = z.enum([
1875
1916
  "task_follow_up_gate_shadow",
1876
1917
  // store-progress refused a completion once because its citations were inaccurate
1877
1918
  "task_citation_check_refused",
1919
+ // store-progress refused a completion once because its uiSpec was invalid
1920
+ "task_ui_spec_check_refused",
1878
1921
  "channel_message",
1879
1922
  // Service registry events
1880
1923
  "service_registered",
@@ -1966,11 +2009,14 @@ export const SessionCostSchema = z
1966
2009
  sessionId: z.string(),
1967
2010
  taskId: z.uuid().optional(),
1968
2011
  agentId: z.string(),
2012
+ credentialKeyType: z.string().nullable().optional(),
2013
+ credentialKeySuffix: z.string().nullable().optional(),
2014
+ harness: ProviderNameSchema.nullable().optional(),
1969
2015
  totalCostUsd: z.number().min(0),
1970
2016
  inputTokens: z.number().int().min(0).default(0),
1971
2017
  outputTokens: z.number().int().min(0).default(0),
1972
- cacheReadTokens: z.number().int().min(0).default(0),
1973
- cacheWriteTokens: z.number().int().min(0).default(0),
2018
+ cacheReadTokens: z.number().int().min(0).nullable().default(null),
2019
+ cacheWriteTokens: z.number().int().min(0).nullable().default(null),
1974
2020
  // Migration 063: reasoning_output_tokens from codex turn.completed events.
1975
2021
  reasoningOutputTokens: z.number().int().min(0).default(0),
1976
2022
  // Migration 063: thinking_input_tokens from claude extended-thinking flows.
@@ -0,0 +1,86 @@
1
+ import { getLeadAgent, getTaskById } from "../be/db";
2
+ import {
3
+ getTaskUiSpec,
4
+ releaseTaskUiActionRun,
5
+ reserveTaskUiActionRun,
6
+ setTaskUiActionResult,
7
+ type TaskUiActionSurface,
8
+ } from "../be/task-ui-spec";
9
+ import { slackContextKey } from "../tasks/context-key";
10
+ import { createTaskWithSiblingAwareness } from "../tasks/sibling-awareness";
11
+ import { isEnvFlagEnabled } from "../utils/env-flag";
12
+
13
+ export type TaskUiActionResult =
14
+ | { status: "started"; taskId: string }
15
+ | { status: "already_done" | "disabled" | "unknown_action" | "forbidden" };
16
+
17
+ /**
18
+ * Runs the action a spec Button names, once per task and action. The Slack
19
+ * click and the web route both call it. Only the task requester may run it.
20
+ */
21
+ export async function runTaskUiAction({
22
+ taskId,
23
+ actionId,
24
+ surface,
25
+ actorUserId,
26
+ slackUserId,
27
+ }: {
28
+ taskId: string;
29
+ actionId: string;
30
+ surface: TaskUiActionSurface;
31
+ actorUserId: string | undefined;
32
+ slackUserId?: string;
33
+ }): Promise<TaskUiActionResult> {
34
+ if (!isEnvFlagEnabled("UI_SPEC_ACTIONS_ENABLED", false)) return { status: "disabled" };
35
+
36
+ const task = await getTaskById(taskId);
37
+ const stored = task ? await getTaskUiSpec(taskId) : null;
38
+ const action =
39
+ stored?.actions && Object.hasOwn(stored.actions, actionId)
40
+ ? stored.actions[actionId]
41
+ : undefined;
42
+ if (!task || !action) return { status: "unknown_action" };
43
+
44
+ if (!actorUserId || actorUserId !== task.requestedByUserId) return { status: "forbidden" };
45
+
46
+ const reserved = await reserveTaskUiActionRun({
47
+ taskId,
48
+ actionId,
49
+ surface,
50
+ slackUserId,
51
+ userId: actorUserId,
52
+ });
53
+ if (reserved === "exists") return { status: "already_done" };
54
+
55
+ // The same task the Slack follow-up modal creates. A failed create releases
56
+ // the reservation, so a later click can retry.
57
+ let followUp: Awaited<ReturnType<typeof createTaskWithSiblingAwareness>>;
58
+ try {
59
+ const lead = await getLeadAgent();
60
+ followUp = await createTaskWithSiblingAwareness(
61
+ action.prompt,
62
+ {
63
+ agentId: lead?.id,
64
+ routingReason: lead ? "skill" : undefined,
65
+ routingSource: lead ? "engine_default" : undefined,
66
+ source: surface === "slack" ? "slack" : "ui",
67
+ parentTaskId: taskId,
68
+ inheritParentOutputSchema: false,
69
+ slackChannelId: task.slackChannelId,
70
+ slackThreadTs: task.slackThreadTs,
71
+ slackUserId,
72
+ requestedByUserId: actorUserId,
73
+ contextKey:
74
+ task.slackChannelId && task.slackThreadTs
75
+ ? slackContextKey({ channelId: task.slackChannelId, threadTs: task.slackThreadTs })
76
+ : undefined,
77
+ },
78
+ { origin: surface === "slack" ? "slack" : "rest" },
79
+ );
80
+ } catch (error) {
81
+ await releaseTaskUiActionRun(taskId, actionId);
82
+ throw error;
83
+ }
84
+ await setTaskUiActionResult(taskId, actionId, followUp.id);
85
+ return { status: "started", taskId: followUp.id };
86
+ }
@@ -0,0 +1,19 @@
1
+ import { getTaskUiSpec } from "../be/task-ui-spec";
2
+ import { isEnvFlagEnabled } from "../utils/env-flag";
3
+ import { scrubSecrets } from "../utils/secret-scrubber";
4
+
5
+ /**
6
+ * The body that a text-only surface posts (Linear, Jira, the legacy Slack
7
+ * card, the Slack Work Object), with the task's card appended as plain text.
8
+ * Returns `body` itself when the flag is off or the task has no stored spec,
9
+ * so the posted text stays byte-identical to the text without this feature.
10
+ * The appended fallback goes through `scrubSecrets`.
11
+ */
12
+ export async function withUiSpecFallback(taskId: string, body: string): Promise<string> {
13
+ if (!isEnvFlagEnabled("UI_SPEC_ENABLED", false)) return body;
14
+ const stored = await getTaskUiSpec(taskId);
15
+ if (!stored?.fallbackText) return body;
16
+ // Stored scrubbed; scrubbed again at egress, since these sends post it as is.
17
+ const fallbackText = scrubSecrets(stored.fallbackText);
18
+ return body ? `${body}\n\n${fallbackText}` : fallbackText;
19
+ }
@@ -0,0 +1,17 @@
1
+ import type { TaskUiSpec } from "../utils/task-ui-spec";
2
+ import { renderTaskUiSpec } from "./validate";
3
+
4
+ /**
5
+ * Slack Block Kit blocks for a stored task UI spec. Re-runs the render steps,
6
+ * because a package bump can change what a stored spec converts to. Returns
7
+ * `[]` when the stored spec no longer converts; the caller then shows the
8
+ * stored fallback text. Logs the issues, never the spec body.
9
+ */
10
+ export function taskUiSpecSlackBlocks(stored: TaskUiSpec, taskId: string): unknown[] {
11
+ const rendered = renderTaskUiSpec(stored.spec, taskId);
12
+ if (rendered.ok) return rendered.blocks;
13
+ console.warn(
14
+ `[ui-spec] stored spec for task ${taskId} no longer renders: ${rendered.issues.join(" | ")}`,
15
+ );
16
+ return [];
17
+ }