@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/apps.ts CHANGED
@@ -65,6 +65,7 @@ import {
65
65
  import { getAgentById, getAppVersion, getAppVersions, getTaskById } from "../be/db";
66
66
  import type { RbacResource } from "../rbac";
67
67
  import { can } from "../rbac";
68
+ import { APP_SESSION_KEY_PATTERN, appSessionContextKey } from "../tasks/context-key";
68
69
  import { AgentTaskStatusSchema, AppIconSchema } from "../types";
69
70
  import { getRequestAuth } from "../utils/request-auth-context";
70
71
  import { scrubObject } from "../utils/secret-scrubber";
@@ -72,6 +73,7 @@ import { resolveHttpFavoriteOwner } from "./favorite-owner";
72
73
  import { agentFirstPrincipal, authUser, authUserId, requestPrincipal } from "./request-principal";
73
74
  import { bodyTask, route } from "./route-def";
74
75
  import { denyParentAttach } from "./session-access";
76
+ import { resolveTaskRequester } from "./task-requester";
75
77
  import { BODY_TOO_LARGE, enforceContentLengthCap, json, jsonError } from "./utils";
76
78
 
77
79
  const MAX_APP_BODY_BYTES = 5 * 1024 * 1024;
@@ -638,6 +640,36 @@ const runActionRoute = route({
638
640
  input: z.record(z.string(), z.unknown()).optional(),
639
641
  /** Chains the new task off an existing one. Task-kind actions only: a script or sync action rejects it (400). */
640
642
  parentTaskId: z.string().min(1).optional(),
643
+ /**
644
+ * `false`: no Lead follow-up (review) task when the created task finishes
645
+ * (`followUpConfig.disabled`). A json-render `SessionThread` sends it, so
646
+ * the chat stays one task per message. Script and sync actions create no
647
+ * task and ignore it, so a generic caller may always send it.
648
+ */
649
+ followUp: z.boolean().optional(),
650
+ /**
651
+ * The person the task is for, when the caller is the shared operator key
652
+ * (the dashboard's picked identity). Resolved like `POST /api/tasks`: a
653
+ * caller bound to a user always wins, and the hint is honored only when
654
+ * the caller may assign requesters.
655
+ */
656
+ requestedByUserId: z.string().min(1).optional(),
657
+ /**
658
+ * A json-render `SessionThread` session. The server builds the task's
659
+ * `contextKey` (`task:app:<appId>:<key>:user:<requester>`) from this
660
+ * app's id, the key and the resolved requester; a raw `contextKey` is
661
+ * never taken from the client. Scope `user` needs a requesting user.
662
+ * Scope `shared` is reserved: it answers 400 until shared sessions land
663
+ * (planned: an everyone:write `session_shares` row on the root). A
664
+ * follow-up (`parentTaskId`) inherits its parent's key instead. Script
665
+ * and sync actions ignore it.
666
+ */
667
+ session: z
668
+ .object({
669
+ key: z.string().regex(APP_SESSION_KEY_PATTERN),
670
+ scope: z.enum(["user", "shared"]).optional(),
671
+ })
672
+ .optional(),
641
673
  }),
642
674
  responses: {
643
675
  200: { description: "Action invoked", schema: runActionResultSchema },
@@ -1403,15 +1435,15 @@ export async function handleApps(
1403
1435
  return true;
1404
1436
  }
1405
1437
  if (definitionNeedsRepair(res, app)) return true;
1438
+ const actions = app.definition.actions;
1439
+ const action =
1440
+ actions && Object.hasOwn(actions, parsed.params.name)
1441
+ ? actions[parsed.params.name]
1442
+ : undefined;
1406
1443
  if (parsed.body.parentTaskId) {
1407
1444
  // `parentTaskId` only means something to a task-kind action: a script or
1408
1445
  // sync action rejects it rather than silently dropping it. An unknown
1409
1446
  // action keeps `runAppAction`'s 404.
1410
- const actions = app.definition.actions;
1411
- const action =
1412
- actions && Object.hasOwn(actions, parsed.params.name)
1413
- ? actions[parsed.params.name]
1414
- : undefined;
1415
1447
  if (action && action.kind !== "task") {
1416
1448
  jsonError(res, "parentTaskId is only supported for task-kind actions", 400);
1417
1449
  return true;
@@ -1428,11 +1460,43 @@ export async function handleApps(
1428
1460
  if (await denyParentAttach(req, res, myAgentId, parentTask, principal)) return true;
1429
1461
  }
1430
1462
  }
1463
+ // Only a task-kind action creates a task to attribute and key.
1464
+ const requestedByUserId =
1465
+ action?.kind === "task"
1466
+ ? await resolveTaskRequester(req, myAgentId, parsed.body.requestedByUserId)
1467
+ : undefined;
1468
+ let contextKey: string | undefined;
1469
+ const session = parsed.body.session;
1470
+ if (session && action?.kind === "task") {
1471
+ if (session.scope === "shared") {
1472
+ jsonError(res, 'session scope "shared" is not supported yet', 400);
1473
+ return true;
1474
+ }
1475
+ if (!requestedByUserId) {
1476
+ jsonError(
1477
+ res,
1478
+ "A user-scoped session needs a requesting user: sign in or pick an identity",
1479
+ 400,
1480
+ );
1481
+ return true;
1482
+ }
1483
+ // A follow-up joins its parent's chain and inherits the parent's key.
1484
+ if (!parsed.body.parentTaskId) {
1485
+ contextKey = appSessionContextKey({
1486
+ appId: app.id,
1487
+ sessionKey: session.key,
1488
+ userId: requestedByUserId,
1489
+ });
1490
+ }
1491
+ }
1431
1492
  const output = await runAppAction({
1432
1493
  app,
1433
1494
  name: parsed.params.name,
1434
1495
  input: parsed.body.input,
1435
1496
  parentTaskId: parsed.body.parentTaskId,
1497
+ followUp: parsed.body.followUp,
1498
+ requestedByUserId,
1499
+ contextKey,
1436
1500
  caller,
1437
1501
  actor,
1438
1502
  });
@@ -0,0 +1,176 @@
1
+ import type { IncomingMessage, ServerResponse } from "node:http";
2
+ import { z } from "zod";
3
+ import {
4
+ ChecklistError,
5
+ listChecklist,
6
+ mutateChecklist,
7
+ userGrantCanEditSwarm,
8
+ } from "../be/checklist";
9
+ import { can } from "../rbac";
10
+ import { ChecklistItemSchema } from "../types";
11
+ import { resolveHttpFavoriteOwner } from "./favorite-owner";
12
+ import { resolveRequestPrincipal } from "./request-principal";
13
+ import { route } from "./route-def";
14
+ import { jsonError } from "./utils";
15
+
16
+ const getChecklist = route({
17
+ method: "get",
18
+ path: "/api/checklist",
19
+ pattern: ["api", "checklist"],
20
+ summary: "Read the post-onboarding checklist",
21
+ tags: ["Checklist"],
22
+ responses: {
23
+ 200: {
24
+ description: "Checklist items and swarm edit permission",
25
+ schema: z.object({ items: z.array(ChecklistItemSchema), canEditSwarm: z.boolean() }),
26
+ },
27
+ },
28
+ });
29
+
30
+ const addChecklistItem = route({
31
+ method: "post",
32
+ path: "/api/checklist/items",
33
+ pattern: ["api", "checklist", "items"],
34
+ summary: "Add a checklist item",
35
+ tags: ["Checklist"],
36
+ rbac: { permission: "checklist.write.own" },
37
+ body: z.object({
38
+ kind: z.enum(["channel", "tool", "use_case", "custom"]),
39
+ label: z.string().min(1).max(200),
40
+ // An in-app path only: the dashboard renders it as a router link.
41
+ href: z
42
+ .string()
43
+ .max(500)
44
+ .regex(/^\/(?!\/)/, "href must be an in-app path starting with /")
45
+ .optional(),
46
+ scope: z.enum(["swarm", "user"]),
47
+ // The dashboard sends `{ adapter }` for a channel item. The size cap keeps
48
+ // free-form meta from the Lead small.
49
+ meta: z
50
+ .looseObject({ adapter: z.string().min(1).max(64).optional() })
51
+ .refine((meta) => JSON.stringify(meta).length <= 1024, {
52
+ message: "meta must be at most 1024 characters as JSON",
53
+ })
54
+ .optional(),
55
+ }),
56
+ responses: {
57
+ 201: { description: "Added checklist item", schema: z.object({ item: ChecklistItemSchema }) },
58
+ 400: { description: "A user is required for user items" },
59
+ 403: { description: "The caller cannot edit swarm items" },
60
+ 409: { description: "An open channel item for the same adapter already exists" },
61
+ },
62
+ });
63
+
64
+ const patchChecklistItem = route({
65
+ method: "patch",
66
+ path: "/api/checklist/items/{id}",
67
+ pattern: ["api", "checklist", "items", null],
68
+ summary: "Update a checklist item",
69
+ tags: ["Checklist"],
70
+ rbac: { permission: "checklist.write.own" },
71
+ params: z.object({ id: z.string() }),
72
+ body: z
73
+ .object({
74
+ action: z.enum(["remove", "restore", "done", "reorder"]),
75
+ reason: z.string().max(500).optional(),
76
+ sortOrder: z.number().int().optional(),
77
+ })
78
+ .refine((body) => body.action !== "reorder" || body.sortOrder !== undefined, {
79
+ message: "Reorder requires sortOrder",
80
+ path: ["sortOrder"],
81
+ }),
82
+ responses: {
83
+ 200: { description: "Updated checklist item", schema: z.object({ item: ChecklistItemSchema }) },
84
+ 400: { description: "Invalid update" },
85
+ 403: { description: "The caller cannot edit this item" },
86
+ 404: { description: "Checklist item not found" },
87
+ },
88
+ });
89
+
90
+ function decodePathId(raw: string): string {
91
+ try {
92
+ return decodeURIComponent(raw);
93
+ } catch {
94
+ return raw;
95
+ }
96
+ }
97
+
98
+ export async function handleChecklist(
99
+ req: IncomingMessage,
100
+ res: ServerResponse,
101
+ pathSegments: string[],
102
+ queryParams: URLSearchParams,
103
+ myAgentId: string | undefined,
104
+ ): Promise<boolean> {
105
+ if (
106
+ !getChecklist.match(req.method, pathSegments) &&
107
+ !addChecklistItem.match(req.method, pathSegments) &&
108
+ !patchChecklistItem.match(req.method, pathSegments)
109
+ )
110
+ return false;
111
+ const owner = await resolveHttpFavoriteOwner(req, myAgentId);
112
+ if (!owner) {
113
+ jsonError(res, "An authenticated principal is required", 401);
114
+ return true;
115
+ }
116
+ const principal = await resolveRequestPrincipal(req, myAgentId, { precedence: "agent-first" });
117
+ if (!principal) {
118
+ jsonError(res, "An authenticated principal is required", 401);
119
+ return true;
120
+ }
121
+ // Agents act on the checklist only as the Lead.
122
+ if (
123
+ principal.kind === "agent" &&
124
+ !getChecklist.match(req.method, pathSegments) &&
125
+ !can({ principal, verb: "checklist.write.agent", resource: { kind: "none" }, source: "http" })
126
+ .allow
127
+ ) {
128
+ jsonError(res, "Only the Lead agent can change the checklist", 403);
129
+ return true;
130
+ }
131
+ // The dashboard's selected user has the same grants as that user's token.
132
+ // Role rows count only with RBAC on; off, the legacy policy decides.
133
+ const grantAllows =
134
+ principal.kind !== "agent" && owner.userId ? await userGrantCanEditSwarm(owner.userId) : null;
135
+ const canEditSwarm =
136
+ grantAllows ??
137
+ (principal.kind === "operator" ||
138
+ can({ principal, verb: "config.write.any", resource: { kind: "none" }, source: "http" })
139
+ .allow);
140
+ const actor = {
141
+ id: principal.kind === "agent" ? `lead:${principal.agentId}` : owner.actorId,
142
+ userId: owner.userId,
143
+ canEditSwarm,
144
+ };
145
+ try {
146
+ if (getChecklist.match(req.method, pathSegments)) {
147
+ const parsed = await getChecklist.parse(req, res, pathSegments, queryParams);
148
+ if (!parsed) return true;
149
+ getChecklist.respond(res, 200, {
150
+ items: await listChecklist(owner.userId, canEditSwarm),
151
+ canEditSwarm,
152
+ });
153
+ } else if (addChecklistItem.match(req.method, pathSegments)) {
154
+ const parsed = await addChecklistItem.parse(req, res, pathSegments, queryParams);
155
+ if (!parsed) return true;
156
+ addChecklistItem.respond(res, 201, {
157
+ item: await mutateChecklist(actor, { action: "add", ...parsed.body }),
158
+ });
159
+ } else {
160
+ const parsed = await patchChecklistItem.parse(req, res, pathSegments, queryParams);
161
+ if (!parsed) return true;
162
+ const { action, sortOrder, reason } = parsed.body;
163
+ // Path segments arrive raw, and ids hold colons (`swarm:tool`) that clients may encode.
164
+ const id = decodePathId(parsed.params.id);
165
+ const item = await mutateChecklist(
166
+ actor,
167
+ action === "reorder" ? { action, id, sortOrder: sortOrder! } : { action, id, reason },
168
+ );
169
+ patchChecklistItem.respond(res, 200, { item });
170
+ }
171
+ } catch (error) {
172
+ if (!(error instanceof ChecklistError)) throw error;
173
+ jsonError(res, error.message, error.status);
174
+ }
175
+ return true;
176
+ }
@@ -43,6 +43,7 @@ import {
43
43
  DbQueryTimeoutError,
44
44
  executeReadOnlyQuery,
45
45
  getDbQueryConcurrencyCap,
46
+ isDbQueryWorkerPoolEnabled,
46
47
  warnDbQuerySpawnUnavailableOnce,
47
48
  } from "./db-query-shared";
48
49
 
@@ -209,7 +210,8 @@ export async function executeReadOnlyQueryBounded(
209
210
  acquireBoundedQuerySlot();
210
211
 
211
212
  try {
212
- return await runBoundedQueryChild(sql, params, budgetMs, maxRows);
213
+ const run = isDbQueryWorkerPoolEnabled() ? runPooledQuery : runBoundedQueryChild;
214
+ return await run(sql, params, budgetMs, maxRows);
213
215
  } finally {
214
216
  releaseBoundedQuerySlot();
215
217
  }
@@ -229,13 +231,13 @@ export function isReportableTimeout(timedOut: boolean, exitCode: number, stdout:
229
231
  return timedOut && !(exitCode === 0 && stdout.length > 0);
230
232
  }
231
233
 
232
- async function runBoundedQueryChild(
234
+ function buildPayload(
233
235
  sql: string,
234
236
  params: unknown[],
235
237
  budgetMs: number,
236
238
  maxRows?: number,
237
- ): Promise<DbQueryResult> {
238
- const payload: ChildPayload = {
239
+ ): ChildPayload {
240
+ return {
239
241
  file: getDb().filename,
240
242
  sql,
241
243
  params,
@@ -243,6 +245,27 @@ async function runBoundedQueryChild(
243
245
  maxRows,
244
246
  busyTimeoutMs: budgetMs,
245
247
  };
248
+ }
249
+
250
+ function timeoutError(budgetMs: number): DbQueryTimeoutError {
251
+ return new DbQueryTimeoutError(
252
+ `Query exceeded the ${budgetMs}ms budget and was terminated. Filter on an indexed column and add a LIMIT. Aggregates such as COUNT(*), SUM(...) or typeof() over session_logs, agent_log, events or task_context_snapshots read every row in range and cannot be made cheap by chunking on rowid.`,
253
+ );
254
+ }
255
+
256
+ /** No `bun` to spawn (see the catch in runBoundedQueryChild): run in-process, loudly, once. */
257
+ function isMissingExecutable(err: unknown): boolean {
258
+ const message = err instanceof Error ? err.message : String(err);
259
+ return /executable not found/i.test(message) || /enoent/i.test(message);
260
+ }
261
+
262
+ async function runBoundedQueryChild(
263
+ sql: string,
264
+ params: unknown[],
265
+ budgetMs: number,
266
+ maxRows?: number,
267
+ ): Promise<DbQueryResult> {
268
+ const payload = buildPayload(sql, params, budgetMs, maxRows);
246
269
 
247
270
  let proc: Bun.Subprocess<"pipe", "pipe", "pipe">;
248
271
  try {
@@ -259,10 +282,7 @@ async function runBoundedQueryChild(
259
282
  // the systemd installer) ships or requires `bun` on $PATH, so this is
260
283
  // expected to be rare; fall back to the in-process path rather than
261
284
  // failing every db-query outright.
262
- const message = err instanceof Error ? err.message : String(err);
263
- if (!/executable not found/i.test(message) && !/enoent/i.test(message)) {
264
- throw err;
265
- }
285
+ if (!isMissingExecutable(err)) throw err;
266
286
  warnDbQuerySpawnUnavailableOnce();
267
287
  return executeReadOnlyQuery(sql, params, maxRows);
268
288
  }
@@ -290,9 +310,7 @@ async function runBoundedQueryChild(
290
310
  }
291
311
 
292
312
  if (isReportableTimeout(timedOut, exitCode, stdout)) {
293
- throw new DbQueryTimeoutError(
294
- `Query exceeded the ${budgetMs}ms budget and was terminated. Filter on an indexed column and add a LIMIT. Aggregates such as COUNT(*), SUM(...) or typeof() over session_logs, agent_log, events or task_context_snapshots read every row in range and cannot be made cheap by chunking on rowid.`,
295
- );
313
+ throw timeoutError(budgetMs);
296
314
  }
297
315
 
298
316
  if (exitCode === WRITE_REJECTED_EXIT_CODE) {
@@ -314,3 +332,230 @@ async function runBoundedQueryChild(
314
332
  total: parsed.total,
315
333
  };
316
334
  }
335
+
336
+ // ---------------------------------------------------------------------------
337
+ // Worker pool. The per-request `bun -e` spawn costs ~65 ms of runtime start,
338
+ // module load and sqlite-vec load per call, which dominated POST /api/db-query
339
+ // latency (~70k calls/day). Long-lived children keep one read-only connection
340
+ // and take newline-delimited JSON requests on stdin. The kill-on-budget
341
+ // guarantee is unchanged: the parent SIGKILLs the worker, drops it from the
342
+ // pool, and the next request spawns a fresh one. `acquireBoundedQuerySlot`
343
+ // already caps in-flight queries, so live workers never exceed the cap.
344
+ // ---------------------------------------------------------------------------
345
+
346
+ /** Recycle a worker after this many queries to bound its RSS growth. */
347
+ const POOL_MAX_QUERIES_PER_WORKER = 500;
348
+ const POOL_IDLE_REAP_MS = 60_000;
349
+ /** A reply this large left the worker holding a big heap; recycle it instead of parking it. */
350
+ const POOL_MAX_PARKED_REPLY_CHARS = 8 * 1024 * 1024;
351
+
352
+ // Plain JS like CHILD_SCRIPT. Same read-only guard, iteration and BLOB handling;
353
+ // JSON.stringify output has no raw newline, so "\n" delimits messages.
354
+ const WORKER_SCRIPT = `
355
+ const { Database } = require("bun:sqlite");
356
+
357
+ let db = null;
358
+ let dbFile = null;
359
+
360
+ function run(req) {
361
+ const { file, sql, params, vecExtensionPath, maxRows, busyTimeoutMs } = req;
362
+ if (!db || dbFile !== file) {
363
+ if (db) db.close();
364
+ db = null;
365
+ const opened = new Database(file, { readonly: true });
366
+ if (vecExtensionPath) {
367
+ try {
368
+ opened.loadExtension(vecExtensionPath);
369
+ } catch {
370
+ // Non-fatal: only queries that reference vec0 tables/functions need it.
371
+ }
372
+ }
373
+ db = opened;
374
+ dbFile = file;
375
+ }
376
+ db.exec("PRAGMA busy_timeout = " + Math.trunc(busyTimeoutMs) + ";");
377
+ const stmt = db.prepare(sql);
378
+ try {
379
+ if (stmt.columnNames.length === 0) throw new Error("Only read-only queries are allowed");
380
+ const columns = stmt.columnNames;
381
+ const start = performance.now();
382
+ const rowArrays = [];
383
+ let total = 0;
384
+ for (const row of stmt.iterate(...(params || []))) {
385
+ total++;
386
+ if (!maxRows || rowArrays.length < maxRows) {
387
+ rowArrays.push(
388
+ columns.map((col) => {
389
+ const value = row[col];
390
+ return value instanceof Uint8Array ? Array.from(value) : value;
391
+ }),
392
+ );
393
+ }
394
+ }
395
+ return { columns, rows: rowArrays, elapsed: Math.round(performance.now() - start), total };
396
+ } finally {
397
+ // Finalize so no read transaction stays open and blocks WAL checkpoints.
398
+ stmt.finalize();
399
+ }
400
+ }
401
+
402
+ function handle(line) {
403
+ let out;
404
+ try {
405
+ out = JSON.stringify(run(JSON.parse(line)));
406
+ } catch (err) {
407
+ out = JSON.stringify({ error: err && err.message ? err.message : String(err) });
408
+ }
409
+ process.stdout.write(out + "\\n");
410
+ }
411
+
412
+ (async () => {
413
+ const decoder = new TextDecoder();
414
+ let buf = "";
415
+ for await (const chunk of Bun.stdin.stream()) {
416
+ buf += decoder.decode(chunk, { stream: true });
417
+ let nl;
418
+ while ((nl = buf.indexOf("\\n")) >= 0) {
419
+ const line = buf.slice(0, nl);
420
+ buf = buf.slice(nl + 1);
421
+ if (line) handle(line);
422
+ }
423
+ }
424
+ })();
425
+ `;
426
+
427
+ interface PoolWorker {
428
+ proc: Bun.Subprocess<"pipe", "pipe", "pipe">;
429
+ queries: number;
430
+ stderr: Promise<string>;
431
+ idleTimer?: ReturnType<typeof setTimeout>;
432
+ /** Set only while a query is in flight on this worker. */
433
+ onLine?: (line: string) => void;
434
+ onExit?: (reason: string) => void;
435
+ }
436
+
437
+ const idleWorkers: PoolWorker[] = [];
438
+
439
+ /** Kill a worker and forget it. Idempotent. */
440
+ function retireWorker(w: PoolWorker): void {
441
+ clearTimeout(w.idleTimer);
442
+ const i = idleWorkers.indexOf(w);
443
+ if (i >= 0) idleWorkers.splice(i, 1);
444
+ w.proc.kill("SIGKILL");
445
+ }
446
+
447
+ async function pumpWorker(w: PoolWorker): Promise<void> {
448
+ const decoder = new TextDecoder();
449
+ let partial = "";
450
+ try {
451
+ for await (const chunk of w.proc.stdout) {
452
+ const text = decoder.decode(chunk, { stream: true });
453
+ // Only scan the new chunk: a reply can be tens of MB and arrive in many chunks.
454
+ let from = 0;
455
+ let nl = text.indexOf("\n", from);
456
+ while (nl >= 0) {
457
+ const line = partial + text.slice(from, nl);
458
+ partial = "";
459
+ from = nl + 1;
460
+ w.onLine?.(line);
461
+ nl = text.indexOf("\n", from);
462
+ }
463
+ partial += text.slice(from);
464
+ }
465
+ } catch {
466
+ // A broken stdout pipe means the worker is gone; handled below like a clean EOF.
467
+ }
468
+ const code = await w.proc.exited;
469
+ const stderr = (await w.stderr).trim();
470
+ retireWorker(w);
471
+ w.onExit?.(stderr || `db-query worker exited with code ${code}`);
472
+ }
473
+
474
+ function spawnWorker(): PoolWorker {
475
+ const proc = Bun.spawn(["bun", "-e", WORKER_SCRIPT], {
476
+ stdin: "pipe",
477
+ stdout: "pipe",
478
+ stderr: "pipe",
479
+ });
480
+ // Idle workers must not keep the API (or a test run) alive; they exit on stdin EOF anyway.
481
+ proc.unref();
482
+ const w: PoolWorker = { proc, queries: 0, stderr: new Response(proc.stderr).text() };
483
+ void pumpWorker(w);
484
+ return w;
485
+ }
486
+
487
+ async function runPooledQuery(
488
+ sql: string,
489
+ params: unknown[],
490
+ budgetMs: number,
491
+ maxRows?: number,
492
+ ): Promise<DbQueryResult> {
493
+ let worker = idleWorkers.pop();
494
+ if (worker) {
495
+ clearTimeout(worker.idleTimer);
496
+ } else {
497
+ try {
498
+ worker = spawnWorker();
499
+ } catch (err) {
500
+ // Same fallback as runBoundedQueryChild: no spawnable `bun` means in-process.
501
+ if (!isMissingExecutable(err)) throw err;
502
+ warnDbQuerySpawnUnavailableOnce();
503
+ return executeReadOnlyQuery(sql, params, maxRows);
504
+ }
505
+ }
506
+ const w = worker;
507
+ const request = `${JSON.stringify(buildPayload(sql, params, budgetMs, maxRows))}\n`;
508
+
509
+ let reply: string;
510
+ try {
511
+ reply = await new Promise<string>((resolve, reject) => {
512
+ const timer = setTimeout(() => {
513
+ retireWorker(w);
514
+ reject(timeoutError(budgetMs));
515
+ }, budgetMs);
516
+ w.onLine = (line) => {
517
+ clearTimeout(timer);
518
+ resolve(line);
519
+ };
520
+ w.onExit = (reason) => {
521
+ clearTimeout(timer);
522
+ reject(new Error(reason));
523
+ };
524
+ w.proc.stdin.write(request);
525
+ w.proc.stdin.flush();
526
+ });
527
+ } catch (err) {
528
+ retireWorker(w);
529
+ throw err;
530
+ } finally {
531
+ w.onLine = undefined;
532
+ w.onExit = undefined;
533
+ }
534
+
535
+ w.queries++;
536
+ if (w.queries >= POOL_MAX_QUERIES_PER_WORKER || reply.length > POOL_MAX_PARKED_REPLY_CHARS) {
537
+ retireWorker(w);
538
+ } else {
539
+ w.idleTimer = setTimeout(() => retireWorker(w), POOL_IDLE_REAP_MS);
540
+ idleWorkers.push(w);
541
+ }
542
+
543
+ const parsed = JSON.parse(reply) as ChildSuccess & { error?: string };
544
+ if (parsed.error !== undefined) throw new Error(parsed.error);
545
+ return {
546
+ columns: parsed.columns,
547
+ rows: parsed.rows,
548
+ elapsed: parsed.elapsed,
549
+ total: parsed.total,
550
+ };
551
+ }
552
+
553
+ /** Exposed for tests only — pids of the parked workers. */
554
+ export function getDbQueryWorkerPidsForTests(): number[] {
555
+ return idleWorkers.map((w) => w.proc.pid);
556
+ }
557
+
558
+ /** Exposed for tests only — kills every parked worker. */
559
+ export function resetDbQueryWorkerPoolForTests(): void {
560
+ for (const w of [...idleWorkers]) retireWorker(w);
561
+ }
@@ -246,6 +246,15 @@ export function isDbQueryBoundedEnabled(env: NodeJS.ProcessEnv = process.env): b
246
246
  return isEnvFlagEnabled("DB_QUERY_BOUNDED_ENABLED", true, env);
247
247
  }
248
248
 
249
+ /**
250
+ * Long-lived worker children for the bounded path, instead of one `bun -e`
251
+ * spawn per query. On by default; `false` restores the per-request spawn.
252
+ * Read dynamically on every call, like `isDbQueryBoundedEnabled`.
253
+ */
254
+ export function isDbQueryWorkerPoolEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
255
+ return isEnvFlagEnabled("DB_QUERY_WORKER_POOL_ENABLED", true, env);
256
+ }
257
+
249
258
  /**
250
259
  * Node/Bun's `setTimeout` takes a 32-bit signed delay internally; a value
251
260
  * above this silently wraps instead of waiting that long (observed as the
@@ -1,5 +1,6 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
+ import { AssetKeyError, normalizeAssetKey } from "../assets/key";
3
4
  import { listFavorites as listFavoriteRows, setFavorite } from "../be/db";
4
5
  import { FavoriteItemTypeSchema, UserFavoriteSchema } from "../types";
5
6
  import { resolveHttpFavoriteOwner } from "./favorite-owner";
@@ -50,6 +51,7 @@ const putFavorite = route({
50
51
  row: UserFavoriteSchema.nullable(),
51
52
  }),
52
53
  },
54
+ 400: { description: "Invalid asset key for a key favorite" },
53
55
  401: { description: "No authenticated principal context" },
54
56
  },
55
57
  });
@@ -93,18 +95,28 @@ export async function handleFavorites(
93
95
  jsonError(res, "Authenticated principal required to update favorites", 401);
94
96
  return true;
95
97
  }
98
+ let itemId = parsed.body.itemId;
99
+ if (parsed.body.itemType === "key") {
100
+ try {
101
+ itemId = normalizeAssetKey(itemId);
102
+ } catch (error) {
103
+ if (!(error instanceof AssetKeyError)) throw error;
104
+ jsonError(res, error.message, 400);
105
+ return true;
106
+ }
107
+ }
96
108
  const favorite = await setFavorite({
97
109
  favoriteScope: owner.scope,
98
110
  userId: owner.userId,
99
111
  itemType: parsed.body.itemType,
100
- itemId: parsed.body.itemId,
112
+ itemId,
101
113
  favorite: parsed.body.favorite,
102
114
  actorId: owner.actorId,
103
115
  });
104
116
  putFavorite.respond(res, 200, {
105
117
  favorite: parsed.body.favorite,
106
118
  itemType: parsed.body.itemType,
107
- itemId: parsed.body.itemId,
119
+ itemId,
108
120
  row: favorite,
109
121
  });
110
122
  return true;