@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
package/src/http/tasks.ts CHANGED
@@ -37,6 +37,7 @@ import {
37
37
  updateAgentStatusFromCapacity,
38
38
  updateTaskClaudeSessionId,
39
39
  updateTaskProgress,
40
+ updateTaskTags,
40
41
  updateTaskTitle,
41
42
  updateTaskVcs,
42
43
  } from "../be/db";
@@ -57,10 +58,11 @@ import {
57
58
  SteeringRequestError,
58
59
  } from "../be/steering";
59
60
  import { getTaskCitations, TaskCitationSchema } from "../be/task-citations";
61
+ import { getTaskUiSpec, TaskUiSpecSchema } from "../be/task-ui-spec";
60
62
  import { findUserById } from "../be/users";
61
63
  import { can, isRbacEnabled, type RbacPrincipal, type RbacResource } from "../rbac";
62
64
  import { chatThreadOfContextKey } from "../tasks/context-key";
63
- import { TaskCreationBlockedError } from "../tasks/errors";
65
+ import { TaskCreationBlockedError, TaskRoutingAuthorizationError } from "../tasks/errors";
64
66
  import { createTaskWithSiblingAwareness } from "../tasks/sibling-awareness";
65
67
  import { finalizeSkippedTaskReaction, skipReasonFrom } from "../tasks/task-skip";
66
68
  import { guardTerminalTaskResultWrite } from "../tasks/terminal-result-guard";
@@ -96,6 +98,7 @@ import {
96
98
  splitLegacyModelAlias,
97
99
  TaskAttachmentSchema,
98
100
  } from "../types";
101
+ import { runTaskUiAction } from "../ui-spec/actions";
99
102
  import { ensure } from "../utils/business-use";
100
103
  import { getRequestAuth } from "../utils/request-auth-context";
101
104
  import { scrubSecrets } from "../utils/secret-scrubber";
@@ -126,6 +129,7 @@ import {
126
129
  SESSION_WRITE_DENIED,
127
130
  sessionAccessFor,
128
131
  } from "./session-access";
132
+ import { resolveTaskRequester } from "./task-requester";
129
133
  import { jsonError, parseBody } from "./utils";
130
134
 
131
135
  // ─── Response Schemas ────────────────────────────────────────────────────────
@@ -219,6 +223,7 @@ const GetTaskResponseSchema = AgentTaskSchema.extend({
219
223
  logs: z.array(AgentLogSchema),
220
224
  attachments: z.array(TaskAttachmentSchema),
221
225
  citations: z.array(TaskCitationSchema),
226
+ uiSpec: TaskUiSpecSchema.nullable(),
222
227
  });
223
228
 
224
229
  const FinishTaskSuccessSchema = z.object({
@@ -400,7 +405,7 @@ const createTask = route({
400
405
  },
401
406
  403: {
402
407
  description:
403
- "An agent caller names a parentTaskId it neither owns nor created, or a non-lead agent binds the task to a chat thread",
408
+ "Parent/session access denied, unauthorized chat-thread binding, or routing requirements reject the assignment",
404
409
  },
405
410
  422: {
406
411
  description: "Task creation blocked by an extension",
@@ -783,6 +788,31 @@ const resumeTaskRoute = route({
783
788
  },
784
789
  });
785
790
 
791
+ const runTaskUiActionRoute = route({
792
+ method: "post",
793
+ path: "/api/tasks/{id}/ui-actions/{actionId}",
794
+ pattern: ["api", "tasks", null, "ui-actions", null],
795
+ session: { taskParam: "id" },
796
+ rbac: { permission: "task.action.own" },
797
+ summary: "Run the action a task card Button declares",
798
+ description:
799
+ "Runs the task card action once per task and action. Only the task requester may run it: a user token, or the operator key with the requester in `X-Swarm-User-Id`. Agent callers, and operator calls with no picked user, get 403. Needs UI_SPEC_ACTIONS_ENABLED=true.",
800
+ tags: ["Tasks"],
801
+ params: z.object({ id: z.string(), actionId: z.string() }),
802
+ responses: {
803
+ 200: {
804
+ description: "The action started, or it already ran",
805
+ schema: z.object({
806
+ status: z.enum(["started", "already_done"]),
807
+ taskId: z.string().optional(),
808
+ }),
809
+ },
810
+ 403: { description: "Only the task requester may run the action" },
811
+ 404: { description: "Task or action not found" },
812
+ 409: { description: "Card actions are turned off (UI_SPEC_ACTIONS_ENABLED)" },
813
+ },
814
+ });
815
+
786
816
  const supersedeTaskRoute = route({
787
817
  method: "post",
788
818
  path: "/api/tasks/{id}/supersede",
@@ -790,7 +820,7 @@ const supersedeTaskRoute = route({
790
820
  session: { taskParam: "id" },
791
821
  summary: "Supersede an in-progress task (terminate + spawn resume follow-up)",
792
822
  description:
793
- 'Marks the original task `superseded` (terminal) and creates a fresh `taskType="resume"` follow-up so a worker can pick up the work in a new provider session. Workflow-step tasks (those with `workflowRunStepId`) are carved out: the original is marked `failed` with reason `superseded_workflow_task` and no follow-up is created — the workflow engine\'s retry/failure policy applies. With `reason: provider_fallback` (and its `errorClass`), the resume runs on the same agent with the next fallback profile that passes the profile check; when none is left, or the task is a workflow step, nothing changes and `kind: noFallback` tells the worker to fail the task itself, led by `failureReason` when set.',
823
+ "Marks the original task `superseded` (terminal) and creates a fresh `taskType=\"resume\"` follow-up so a worker can pick up the work in a new provider session. Workflow-step tasks (those with `workflowRunStepId`) are carved out: the original is marked `failed` with reason `superseded_workflow_task` and no follow-up is created — the workflow engine's retry/failure policy applies, and the task moves to `superseded` once the engine queues the step's retry. With `reason: provider_fallback` (and its `errorClass`), the resume runs on the same agent with the next fallback profile that passes the profile check; when none is left, or the task is a workflow step, nothing changes and `kind: noFallback` tells the worker to fail the task itself, led by `failureReason` when set.",
794
824
  tags: ["Tasks"],
795
825
  params: z.object({ id: z.string() }),
796
826
  body: z
@@ -854,6 +884,46 @@ const updateTaskTitleRoute = route({
854
884
  rbac: { permission: "task.action.own" },
855
885
  });
856
886
 
887
+ /**
888
+ * Only dashboard presentation tags (`ui:` namespace). Every other tag drives
889
+ * behaviour (classification such as `heartbeat`, routing, follow-ups) and is
890
+ * set by the server, never through this route.
891
+ */
892
+ const TaskTagListSchema = z
893
+ .array(
894
+ z
895
+ .string()
896
+ .regex(/^ui:[a-z0-9][a-z0-9-]{0,60}$/, "Only ui: presentation tags can be changed here"),
897
+ )
898
+ .max(20);
899
+
900
+ const updateTaskTagsRoute = route({
901
+ method: "patch",
902
+ path: "/api/tasks/{id}/tags",
903
+ pattern: ["api", "tasks", null, "tags"],
904
+ session: { taskParam: "id" },
905
+ summary: "Add or remove task tags",
906
+ description:
907
+ "Adds the `add` tags and removes the `remove` tags. A tag in both lists is removed. Only `ui:` presentation tags are accepted (400 otherwise); tags that drive behaviour are server-owned. The dashboard uses `ui:dismissed` to hide a failed task from Home's Needs you. Does not change `lastUpdatedAt`.",
908
+ tags: ["Tasks"],
909
+ params: z.object({ id: z.string() }),
910
+ body: z
911
+ .object({
912
+ add: TaskTagListSchema.optional(),
913
+ remove: TaskTagListSchema.optional(),
914
+ })
915
+ .refine((body) => (body.add?.length ?? 0) + (body.remove?.length ?? 0) > 0, {
916
+ message: "Give at least one tag to add or remove",
917
+ }),
918
+ responses: {
919
+ 200: { description: "Tags updated", schema: z.object({ task: AgentTaskSchema }) },
920
+ 403: { description: "Task belongs to another user" },
921
+ 404: { description: "Task not found" },
922
+ },
923
+ auth: { apiKey: true },
924
+ rbac: { permission: "task.action.own" },
925
+ });
926
+
857
927
  async function canSteerTask(
858
928
  req: IncomingMessage,
859
929
  myAgentId: string | undefined,
@@ -950,43 +1020,7 @@ async function deniesForeignContext(req: IncomingMessage, contextKey: string): P
950
1020
  return false;
951
1021
  }
952
1022
 
953
- /**
954
- * Requester for a new task. Prefer trusted server-side identity: an
955
- * authenticated request user, or the caller's own ownership-gated task context
956
- * (`X-Source-Task-Id` / ambient current task), the upstream #939 anti-spoofing
957
- * behavior.
958
- *
959
- * TRUST_BODY_REQUESTED_BY_USER_ID (default ON) accepts a body-supplied
960
- * `requestedByUserId` as a last resort, only when the caller could not be
961
- * bound to a user (shared operator key), and only after validating it names a
962
- * real user. Typical single-tenant deployments share ONE operator key, so
963
- * without this the UI and API callers can never attribute tasks. Set
964
- * TRUST_BODY_REQUESTED_BY_USER_ID=false anywhere holders of the shared/global
965
- * key are NOT all equally trusted: with it on, any such caller can attribute
966
- * a task to any user.
967
- *
968
- * Pass `trustedUserId` when the caller already resolved it.
969
- */
970
- export async function resolveTaskRequester(
971
- req: IncomingMessage,
972
- myAgentId: string | undefined,
973
- bodyUserId: string | undefined,
974
- trustedUserId?: string | null,
975
- ): Promise<string | undefined> {
976
- const trusted =
977
- trustedUserId === undefined ? await resolveHttpAuditUserId(req, myAgentId) : trustedUserId;
978
- if (trusted) return trusted;
979
- if (process.env.TRUST_BODY_REQUESTED_BY_USER_ID === "false" || !bodyUserId) return undefined;
980
- // A worker on the shared key is not the operator: its X-Agent-ID names it, so the body
981
- // hint is dropped like it is when the worker has a requester of its own.
982
- const mayAssign = can({
983
- principal: await resolveTaskWritePrincipal(req, myAgentId),
984
- verb: "task.requester.assign",
985
- resource: { kind: "none" },
986
- source: "http",
987
- }).allow;
988
- return mayAssign ? (await findUserById(bodyUserId))?.id : undefined;
989
- }
1023
+ export { resolveTaskRequester };
990
1024
 
991
1025
  // ─── Handler ─────────────────────────────────────────────────────────────────
992
1026
 
@@ -1234,6 +1268,12 @@ export async function handleTasks(
1234
1268
  parentTaskId: parsed.body.parentTaskId || undefined,
1235
1269
  // Human chat starts a new output contract; agent children keep inheriting.
1236
1270
  inheritParentOutputSchema: principal.kind === "agent",
1271
+ // Un mensaje humano abre trabajo nuevo; el padre conserva contexto, no requisitos del worker.
1272
+ // Solo en respuestas a un hilo: sin padre no hay requisitos que heredar.
1273
+ routingAffinity:
1274
+ parsed.body.parentTaskId && (principal.kind === "user" || principal.kind === "operator")
1275
+ ? { capabilities: [] }
1276
+ : undefined,
1237
1277
  source: parsed.body.source || "api",
1238
1278
  outputSchema: parsed.body.outputSchema || undefined,
1239
1279
  contextKey: parsed.body.contextKey || undefined,
@@ -1267,6 +1307,21 @@ export async function handleTasks(
1267
1307
 
1268
1308
  createTask.respond(res, 201, task);
1269
1309
  } catch (error) {
1310
+ if (error instanceof TaskRoutingAuthorizationError) {
1311
+ console.warn(
1312
+ "[HTTP] Task assignment rejected:",
1313
+ scrubSecrets(
1314
+ JSON.stringify({
1315
+ parentTaskId: parsed.body.parentTaskId,
1316
+ source: parsed.body.source ?? "api",
1317
+ contextKey: parsed.body.contextKey ?? parentTask?.contextKey,
1318
+ reason: error.message,
1319
+ }),
1320
+ ),
1321
+ );
1322
+ jsonError(res, error.message, 403);
1323
+ return true;
1324
+ }
1270
1325
  if (error instanceof TaskCreationBlockedError) {
1271
1326
  createTask.respond(res, 422, { error: error.reason, extension: error.extension });
1272
1327
  return true;
@@ -1725,6 +1780,7 @@ export async function handleTasks(
1725
1780
  logs,
1726
1781
  attachments,
1727
1782
  citations: await getTaskCitations(task.id),
1783
+ uiSpec: await getTaskUiSpec(task.id),
1728
1784
  });
1729
1785
  return true;
1730
1786
  }
@@ -2114,6 +2170,76 @@ export async function handleTasks(
2114
2170
  return true;
2115
2171
  }
2116
2172
 
2173
+ if (updateTaskTagsRoute.match(req.method, pathSegments)) {
2174
+ const parsed = await updateTaskTagsRoute.parse(req, res, pathSegments, queryParams);
2175
+ if (!parsed) return true;
2176
+ const existing = await getTaskById(parsed.params.id);
2177
+ if (!existing) {
2178
+ jsonError(res, "Task not found", 404);
2179
+ return true;
2180
+ }
2181
+ if (await deniesNonOwnerTaskWrite(req, existing)) {
2182
+ jsonError(res, NOT_YOUR_TASK_DENIED, 403);
2183
+ return true;
2184
+ }
2185
+ const task = await updateTaskTags(parsed.params.id, parsed.body);
2186
+ if (!task) {
2187
+ jsonError(res, "Task not found", 404);
2188
+ return true;
2189
+ }
2190
+ updateTaskTagsRoute.respond(res, 200, { task });
2191
+ return true;
2192
+ }
2193
+
2194
+ if (runTaskUiActionRoute.match(req.method, pathSegments)) {
2195
+ const parsed = await runTaskUiActionRoute.parse(req, res, pathSegments, queryParams);
2196
+ if (!parsed) return true;
2197
+ const task = await getTaskById(parsed.params.id);
2198
+ if (!task) {
2199
+ jsonError(res, "Task not found", 404);
2200
+ return true;
2201
+ }
2202
+ if (!(await canActOnOwnTask(req, myAgentId, task))) {
2203
+ jsonError(res, "Not authorized to act on this task", 403);
2204
+ return true;
2205
+ }
2206
+ // Only a user clicks a card button: a user token, or a dashboard tab on the
2207
+ // operator key that names its user. An agent, or an operator call with no
2208
+ // picked user, resolves to no user, so the requester check refuses it.
2209
+ // TRUST_BODY_REQUESTED_BY_USER_ID=false stops trusting a caller-named user
2210
+ // on the shared key, so then only a user token can click.
2211
+ const actor = await resolveSessionActor(req, myAgentId);
2212
+ const tokenUserId = authUserId(getRequestAuth(req));
2213
+ const trustsPickedUser = process.env.TRUST_BODY_REQUESTED_BY_USER_ID !== "false";
2214
+ const actorUserId =
2215
+ actor.kind === "user" && (tokenUserId || trustsPickedUser)
2216
+ ? (actor.userId ?? undefined)
2217
+ : undefined;
2218
+ const result = await runTaskUiAction({
2219
+ taskId: task.id,
2220
+ actionId: parsed.params.actionId,
2221
+ surface: "web",
2222
+ actorUserId,
2223
+ });
2224
+ switch (result.status) {
2225
+ case "forbidden":
2226
+ jsonError(res, "Only the task requester may run this action", 403);
2227
+ return true;
2228
+ case "unknown_action":
2229
+ jsonError(res, "This task declares no such action", 404);
2230
+ return true;
2231
+ case "disabled":
2232
+ jsonError(res, "Card actions are turned off (UI_SPEC_ACTIONS_ENABLED)", 409);
2233
+ return true;
2234
+ case "already_done":
2235
+ runTaskUiActionRoute.respond(res, 200, { status: "already_done" });
2236
+ return true;
2237
+ case "started":
2238
+ runTaskUiActionRoute.respond(res, 200, result);
2239
+ return true;
2240
+ }
2241
+ }
2242
+
2117
2243
  if (resumeTaskRoute.match(req.method, pathSegments)) {
2118
2244
  const parsed = await resumeTaskRoute.parse(req, res, pathSegments, queryParams);
2119
2245
  if (!parsed) return true;
@@ -2226,8 +2352,9 @@ export async function handleTasks(
2226
2352
  }
2227
2353
 
2228
2354
  // Workflow-step tasks: fail back to the engine instead of superseding.
2229
- // Check this BEFORE the supersede UPDATE so we don't leave a workflow
2230
- // step in `superseded` if the engine expects `failed`.
2355
+ // Check this BEFORE the supersede UPDATE: the engine's retry path runs off
2356
+ // `task.failed`. Once it queues the step's retry it moves the task to
2357
+ // `superseded` itself (`scheduleTaskStepRetry`).
2231
2358
  if (task.workflowRunStepId != null) {
2232
2359
  const failed = await failTask(parsed.params.id, SUPERSEDED_WORKFLOW_TASK_REASON);
2233
2360
  if (task.agentId) {
package/src/http/users.ts CHANGED
@@ -30,6 +30,7 @@
30
30
 
31
31
  import type { IncomingMessage, ServerResponse } from "node:http";
32
32
  import { z } from "zod";
33
+ import { ensureUserAgentFsAccount } from "../be/agent-fs-user-keys";
33
34
  import {
34
35
  createConnectorCode,
35
36
  DEFAULT_CONNECTOR_CODE_LABEL,
@@ -77,6 +78,7 @@ import { UserCommsPrefsSchema, UserSchema } from "../types";
77
78
  import { DEFAULT_APP_URL } from "../utils/constants";
78
79
  import { assertUrlSafe } from "../utils/egress-guard";
79
80
  import { authUser, getRequestAuth } from "../utils/request-auth-context";
81
+ import { scrubSecrets } from "../utils/secret-scrubber";
80
82
  import { resolveAppUrl, resolveMcpBaseUrl } from "./config-values";
81
83
  import { clientIp, createIpRateLimiter } from "./ip-rate-limit";
82
84
  import { getOperatorActor } from "./operator-actor";
@@ -1286,6 +1288,18 @@ export async function handleUsers(
1286
1288
  jsonError(res, "code_invalid", 404);
1287
1289
  return true;
1288
1290
  }
1291
+ // No transaction is open here, so afterCommit only defers the call (fire and forget).
1292
+ getDbClient().afterCommit(async () => {
1293
+ try {
1294
+ await ensureUserAgentFsAccount(result.userId);
1295
+ } catch (error) {
1296
+ console.warn(
1297
+ scrubSecrets(
1298
+ `[agent-fs] invite account ensure failed: ${error instanceof Error ? error.message : String(error)}`,
1299
+ ),
1300
+ );
1301
+ }
1302
+ });
1289
1303
  exchangeInviteCodeRoute.respond(res, 200, result);
1290
1304
  } catch {
1291
1305
  jsonError(res, "Failed to exchange code", 500);
@@ -96,6 +96,7 @@ import type { KapsoWebhookPayload } from "../integrations/kapso/inbound";
96
96
  import { resolveKapsoRequestedByUserId, routeKapsoInbound } from "../integrations/kapso/inbound";
97
97
  import { TaskCreationBlockedError } from "../tasks/errors";
98
98
  import { getPublicMcpBaseUrl } from "../utils/constants";
99
+ import { resolveGitHubHost } from "../utils/github-host";
99
100
  import { scrubSecrets } from "../utils/secret-scrubber";
100
101
  import { canonicalAzureDevOpsRepoUrl } from "../vcs/azure-devops";
101
102
  import { getExecutorRegistry } from "../workflows";
@@ -460,6 +461,20 @@ export async function handleWebhooks(
460
461
  return true;
461
462
  }
462
463
 
464
+ // GHES names its host on every delivery. A mismatch is a misconfiguration, not an
465
+ // attack (the HMAC check above is the trust boundary), so warn and carry on.
466
+ const enterpriseHost = req.headers["x-github-enterprise-host"] as string | undefined;
467
+ const configuredHost = resolveGitHubHost();
468
+ if (
469
+ enterpriseHost &&
470
+ configuredHost.ok &&
471
+ enterpriseHost.toLowerCase() !== configuredHost.config.host
472
+ ) {
473
+ console.warn(
474
+ `[GitHub] Webhook from GHES host ${enterpriseHost}, but GITHUB_URL resolves to ${configuredHost.config.host}`,
475
+ );
476
+ }
477
+
463
478
  if (eventType === "ping") {
464
479
  console.log("[GitHub] Received ping event - webhook configured successfully");
465
480
  githubWebhook.respond(res, 200, { message: "pong" });
@@ -0,0 +1,151 @@
1
+ import { CardSpecError, standardComponentDefinitions, toCard } from "@json-render/chat";
2
+ import type { CardChild, CardElement } from "chat";
3
+ import * as z from "zod";
4
+
5
+ // No callback buttons yet: nothing handles a click, so `Button` stays out and
6
+ // `Actions` holds `LinkButton`s only.
7
+ const { Button: _button, ...standard } = standardComponentDefinitions;
8
+
9
+ /** The components an agent-authored card may use. */
10
+ export const chatCardComponents = {
11
+ ...standard,
12
+ Actions: { ...standard.Actions, description: "Row of LinkButton elements." },
13
+ };
14
+
15
+ /**
16
+ * Slack's caps. Past them the adapter turns a table or chart into a code block
17
+ * cut at 3,000 characters, which drops content while the post succeeds, so
18
+ * reject instead. `tableRows` counts the header row.
19
+ */
20
+ export const CARD_LIMITS = {
21
+ tables: 1,
22
+ charts: 2,
23
+ fields: 10,
24
+ tableRows: 101,
25
+ tableColumns: 20,
26
+ chartTitle: 50,
27
+ chartLabel: 20,
28
+ chartSeries: 12,
29
+ chartPoints: 20,
30
+ } as const;
31
+
32
+ /** Slack's data_table cap on the characters of all cells, header included. */
33
+ export const TABLE_MAX_CELL_CHARS = 10_000;
34
+
35
+ // One line per component: its description and an example of its props, which
36
+ // is the only place the agent sees prop names (Chart and Table need them).
37
+ const catalogLines = Object.entries(chatCardComponents)
38
+ .map(([name, def]) => `${name}: ${def.description} Props e.g. ${JSON.stringify(def.example)}.`)
39
+ .join(" ");
40
+
41
+ const CARD_RULES =
42
+ 'Every element has "children" (leaves use []). Field goes inside Fields, LinkButton inside Actions. A bar, line or area Chart has one value per category per series; a pie Chart uses {"type":"pie","segments":[{"label","value"}]}.';
43
+
44
+ /** Tool input for a json-render chat card spec. `toCard` does the real validation. */
45
+ export const cardSpecInputSchema = z
46
+ .looseObject({
47
+ root: z.string().min(1).describe("Id of the root element. It must be a Card."),
48
+ elements: z
49
+ .record(z.string(), z.unknown())
50
+ .describe(
51
+ 'Map of element id to { type, props, children: [ids] }. Example: {"root":"c","elements":{"c":{"type":"Card","props":{"title":"Deploy"},"children":["f"]},"f":{"type":"Fields","props":{},"children":["f1"]},"f1":{"type":"Field","props":{"label":"Status","value":"green"},"children":[]}}}',
52
+ ),
53
+ })
54
+ .describe(
55
+ `Optional json-render card spec, rendered as a native card. Use it for structured results: key figures, a table, up to ${CARD_LIMITS.charts} charts, links. At most ${CARD_LIMITS.tables} table, of up to ${CARD_LIMITS.tableRows - 1} rows, ${CARD_LIMITS.tableColumns} columns and ${TABLE_MAX_CELL_CHARS} characters in all. ${CARD_RULES} Components: ${catalogLines}`,
56
+ );
57
+
58
+ export type CardSpecInput = z.infer<typeof cardSpecInputSchema>;
59
+
60
+ /**
61
+ * Validate an agent's spec and build the Chat SDK card. Returns the
62
+ * `CardSpecError` issues instead of throwing so a tool can hand them back.
63
+ */
64
+ export function renderCard(spec: CardSpecInput): { card: CardElement } | { issues: string[] } {
65
+ let card: CardElement;
66
+ try {
67
+ // biome-ignore lint/suspicious/noExplicitAny: toCard validates the shape and reports issues
68
+ card = toCard(spec as any, { components: chatCardComponents, limits: CARD_LIMITS });
69
+ } catch (error) {
70
+ if (error instanceof CardSpecError) return { issues: error.issues };
71
+ throw error;
72
+ }
73
+ // toCard has no character limit, so check the expanded tables here.
74
+ const issues = cardChildren(card)
75
+ .filter((child) => child.type === "table")
76
+ .flatMap((table) => {
77
+ const chars = [table.headers, ...table.rows]
78
+ .flat()
79
+ .reduce((sum, cell) => sum + cell.length, 0);
80
+ return chars > TABLE_MAX_CELL_CHARS
81
+ ? [`Table: ${chars} characters in its cells, at most ${TABLE_MAX_CELL_CHARS}`]
82
+ : [];
83
+ });
84
+ return issues.length ? { issues } : { card };
85
+ }
86
+
87
+ /** Every child of the card, sections flattened. */
88
+ function cardChildren(card: { children: CardChild[] }): CardChild[] {
89
+ return card.children.flatMap((child) =>
90
+ child.type === "section" ? [child, ...cardChildren(child)] : [child],
91
+ );
92
+ }
93
+
94
+ /** Tool error text for a rejected spec: one issue per line, for the agent to fix. */
95
+ export function cardIssuesMessage(issues: string[]): string {
96
+ return `Invalid card spec. Fix it and retry:\n${issues.map((issue) => `- ${issue}`).join("\n")}`;
97
+ }
98
+
99
+ const NATIVE_SLACK_BLOCKS: Record<string, string[]> = {
100
+ table: ["table", "data_table"],
101
+ chart: ["data_visualization"],
102
+ };
103
+
104
+ /**
105
+ * Block Kit and the card's notification text for native Slack. Returns issues when a table or chart would not render natively: the
106
+ * adapter's code-block fallback is cut at 3,000 characters, so a post could
107
+ * succeed with rows missing. `CARD_LIMITS` stops the known cases first; this
108
+ * catches the rest (a duplicate chart label, a long axis label).
109
+ */
110
+ export async function cardToSlack(
111
+ card: CardElement,
112
+ ): Promise<{ blocks: Record<string, unknown>[]; text: string } | { issues: string[] }> {
113
+ // Lazy like the Chat SDK adapters: the adapter module is only loaded when a card is posted.
114
+ const { cardToBlockKit, cardToFallbackText } = await import("@chat-adapter/slack");
115
+ const issues = cardChildren(card).flatMap((child) => {
116
+ const native = NATIVE_SLACK_BLOCKS[child.type];
117
+ if (!native) return [];
118
+ const [block] = cardToBlockKit({ type: "card", children: [child] });
119
+ return block && native.includes(String(block.type))
120
+ ? []
121
+ : [`${child.type === "table" ? "Table" : "Chart"}: Slack cannot render it natively`];
122
+ });
123
+ if (issues.length) return { issues };
124
+ return {
125
+ blocks: cardToBlockKit(card),
126
+ text: cardToFallbackText(card),
127
+ };
128
+ }
129
+
130
+ /**
131
+ * `renderCard` plus the native check for the adapter the card goes to. The Chat
132
+ * SDK tools call this before they send anything: on Slack the adapter turns a
133
+ * table or chart it cannot draw into a fallback cut at 3,000 characters.
134
+ */
135
+ export async function renderCardFor(
136
+ adapter: string,
137
+ spec: CardSpecInput,
138
+ ): Promise<{ card: CardElement } | { issues: string[] }> {
139
+ const rendered = renderCard(spec);
140
+ if ("issues" in rendered || adapter !== "slack") return rendered;
141
+ const slack = await cardToSlack(rendered.card);
142
+ return "issues" in slack ? slack : rendered;
143
+ }
144
+
145
+ /**
146
+ * Notification text for a message posted with a card: both, message first, so
147
+ * notifications and screen readers do not lose the message.
148
+ */
149
+ export function slackFallbackText(message: string, cardText?: string): string {
150
+ return [message, cardText].filter(Boolean).join("\n\n");
151
+ }
@@ -1,4 +1,4 @@
1
- import type { Attachment, FileUpload } from "chat";
1
+ import type { Attachment, CardElement, FileUpload } from "chat";
2
2
  import { scrubSecrets } from "@/utils/secret-scrubber";
3
3
  import { workflowEventBus } from "@/workflows/event-bus";
4
4
  import { formatFileSize } from "./attachments";
@@ -78,12 +78,12 @@ export class ChatFileTooLargeError extends Error {
78
78
 
79
79
  type SentChunk = { id: string; threadId?: string };
80
80
 
81
+ type OutboundMessage =
82
+ | { markdown: string; files?: FileUpload[]; attachments?: Attachment[] }
83
+ | CardElement;
84
+
81
85
  interface PostTarget {
82
- post(message: {
83
- markdown: string;
84
- files?: FileUpload[];
85
- attachments?: Attachment[];
86
- }): Promise<SentChunk>;
86
+ post(message: OutboundMessage): Promise<SentChunk>;
87
87
  }
88
88
 
89
89
  /** A fence opener or closer: up to 3 spaces, then 3+ backticks or tildes. */
@@ -122,18 +122,27 @@ export function escapeTelegramHashLines(markdown: string): string {
122
122
  .join("\n");
123
123
  }
124
124
 
125
- /** `replyFirst` sends the first chunk as a native reply; later chunks are plain posts. */
125
+ /**
126
+ * `replyFirst` sends the first message as a native reply; later ones are plain
127
+ * posts. A `card` goes out after the text chunks, as one more message.
128
+ */
126
129
  async function postChunks(
127
130
  adapter: string,
128
131
  target: PostTarget,
129
132
  parts: readonly string[],
130
- replyFirst?: (message: { markdown: string }) => Promise<SentChunk>,
133
+ replyFirst?: (message: OutboundMessage) => Promise<SentChunk>,
134
+ card?: CardElement,
131
135
  ): Promise<{ messageIds: string[]; threadId?: string }> {
132
136
  const messageIds: string[] = [];
133
137
  let threadId: string | undefined;
134
138
  const limit = chatMessageLimit(adapter);
135
- for (const chunk of parts.flatMap((part) => splitChatMessage(part, limit))) {
136
- const message = { markdown: adapter === "telegram" ? escapeTelegramHashLines(chunk) : chunk };
139
+ const messages: OutboundMessage[] = parts
140
+ .flatMap((part) => splitChatMessage(part, limit))
141
+ .map((chunk) => ({
142
+ markdown: adapter === "telegram" ? escapeTelegramHashLines(chunk) : chunk,
143
+ }));
144
+ if (card) messages.push(card);
145
+ for (const message of messages) {
137
146
  const sent =
138
147
  replyFirst && messageIds.length === 0
139
148
  ? await replyFirst(message)
@@ -318,6 +327,15 @@ export function formatUnsentFilesNote(unsent: UnsentChatFile[]): string {
318
327
  return [`Could not send ${count}:`, ...lines].join("\n");
319
328
  }
320
329
 
330
+ /** A copy of the card with every string scrubbed, so a card cannot leak what text cannot. */
331
+ function scrubCard(card: CardElement): CardElement {
332
+ return JSON.parse(
333
+ JSON.stringify(card, (_key, value) =>
334
+ typeof value === "string" ? scrubSecrets(value) : value,
335
+ ),
336
+ );
337
+ }
338
+
321
339
  /**
322
340
  * Post markdown to a Chat SDK thread or channel. Scrubs the text, splits it by
323
341
  * the adapter limit, and emits one `chat.message.sent` for the whole message
@@ -335,7 +353,10 @@ export function formatUnsentFilesNote(unsent: UnsentChatFile[]): string {
335
353
  * An array `text` is posted as one message per element, each still split at
336
354
  * the limit; the caller uses it when its own markup must not be cut in two.
337
355
  *
338
- * `replyToMessageId` anchors the first chunk to that message on a thread
356
+ * `card` (a validated Chat SDK card) is posted after the text as its own
357
+ * message; `text` may then be empty. Its strings are scrubbed like the text.
358
+ *
359
+ * `replyToMessageId` anchors the first message to that message on a thread
339
360
  * target. Telegram sends it with `allow_sending_without_reply`, so a deleted
340
361
  * target still gets the message, unthreaded.
341
362
  */
@@ -344,6 +365,7 @@ export async function postChatMessage(args: {
344
365
  threadId?: string;
345
366
  channelId?: string;
346
367
  text: string | readonly string[];
368
+ card?: CardElement;
347
369
  taskId?: string;
348
370
  files?: OutboundChatFile[];
349
371
  replyToMessageId?: string;
@@ -354,7 +376,10 @@ export async function postChatMessage(args: {
354
376
  const chat = getChatInstance(args.adapter);
355
377
  if (!chat) throw new ChatAdapterUnavailableError(args.adapter);
356
378
  const parts = (typeof args.text === "string" ? [args.text] : args.text).map(scrubSecrets);
357
- const text = parts.join("\n\n");
379
+ const card = args.card && scrubCard(args.card);
380
+ // shortcut: a card-only message reports its title as the event text; add a
381
+ // plain-text rendering of the card if an event consumer needs the body.
382
+ const text = parts.join("\n\n") || (card?.title ?? "");
358
383
 
359
384
  let result: ChatPostResult;
360
385
  let target: PostTarget;
@@ -369,6 +394,7 @@ export async function postChatMessage(args: {
369
394
  thread,
370
395
  parts,
371
396
  replyTo && thread.adapter.reply ? (message) => thread.reply(replyTo, message) : undefined,
397
+ card,
372
398
  );
373
399
  result = {
374
400
  adapter: args.adapter,
@@ -380,7 +406,7 @@ export async function postChatMessage(args: {
380
406
  } else if (args.channelId) {
381
407
  const channel = chat.channel(args.channelId);
382
408
  target = channel;
383
- const sent = await postChunks(args.adapter, channel, parts);
409
+ const sent = await postChunks(args.adapter, channel, parts, undefined, card);
384
410
  result = {
385
411
  adapter: args.adapter,
386
412
  threadId: sent.threadId ?? channel.id,