@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
@@ -0,0 +1,686 @@
1
+ import {
2
+ afterAll,
3
+ afterEach,
4
+ beforeAll,
5
+ beforeEach,
6
+ describe,
7
+ expect,
8
+ spyOn,
9
+ test,
10
+ } from "bun:test";
11
+ import { Readable } from "node:stream";
12
+ import {
13
+ type ChecklistActor,
14
+ firstOpenItem,
15
+ listChecklist,
16
+ markNudged,
17
+ mutateChecklist,
18
+ userGrantCanEditSwarm,
19
+ } from "../be/checklist";
20
+ import { closeDb, createAgent, createUser, getDb, getDbClient, initDb } from "../be/db";
21
+ import { getSessionReadState, triageSessionList } from "../be/db/session-tree";
22
+ import { deleteOAuthTokens, storeOAuthTokens, upsertOAuthApp } from "../be/db-queries/oauth";
23
+ import { runMigrations } from "../be/migrations/runner";
24
+ import { attachRole, detachRole } from "../be/rbac-roles";
25
+ import { handleChecklist } from "../http/checklist";
26
+ import { getPathSegments, parseQueryParams } from "../http/utils";
27
+ import * as chatRuntime from "../integrations/chat-sdk/runtime";
28
+ import type { ChecklistItem } from "../types";
29
+ import type { HttpRequestAuth } from "../utils/request-auth-context";
30
+ import { setRequestAuth } from "../utils/request-auth-context";
31
+
32
+ const dbPath = "./test-checklist.sqlite";
33
+ const envKeys = [
34
+ "GITHUB_TOKEN",
35
+ "GITLAB_TOKEN",
36
+ "BITBUCKET_TOKEN",
37
+ "GITHUB_WEBHOOK_SECRET",
38
+ "GITHUB_APP_ID",
39
+ "GITHUB_APP_PRIVATE_KEY",
40
+ "SLACK_BOT_TOKEN",
41
+ "SLACK_APP_TOKEN",
42
+ "SLACK_DISABLE",
43
+ "SLACK_TRANSPORT",
44
+ "RBAC_ENABLED",
45
+ "CHAT_SDK_ADAPTERS",
46
+ ] as const;
47
+ const savedEnv = Object.fromEntries(envKeys.map((key) => [key, process.env[key]]));
48
+ let auth: HttpRequestAuth;
49
+ let userId: string;
50
+ let actor: ChecklistActor;
51
+ let healthSpy: ReturnType<typeof spyOn<typeof chatRuntime, "getChatSdkHealth">>;
52
+
53
+ async function api(method: string, path = "/api/checklist", body?: unknown, agentId?: string) {
54
+ const req = Readable.from(
55
+ body === undefined ? [] : [Buffer.from(JSON.stringify(body))],
56
+ ) as Readable & {
57
+ method: string;
58
+ url: string;
59
+ headers: Record<string, string>;
60
+ };
61
+ req.method = method;
62
+ req.url = path;
63
+ req.headers = {
64
+ "content-type": "application/json",
65
+ ...(agentId ? { "x-agent-id": agentId } : {}),
66
+ };
67
+ setRequestAuth(req, auth);
68
+ let status = 200;
69
+ let responseBody = "";
70
+ const res = {
71
+ setHeader() {},
72
+ writeHead(code: number) {
73
+ status = code;
74
+ },
75
+ end(chunk?: string) {
76
+ responseBody += chunk ?? "";
77
+ },
78
+ };
79
+ await handleChecklist(req, res as never, getPathSegments(path), parseQueryParams(path), agentId);
80
+ return {
81
+ status,
82
+ body: JSON.parse(responseBody) as {
83
+ items: ChecklistItem[];
84
+ item: ChecklistItem;
85
+ canEditSwarm: boolean;
86
+ error?: string;
87
+ },
88
+ };
89
+ }
90
+
91
+ const item = async (kind: ChecklistItem["kind"], id = userId) =>
92
+ (await listChecklist(id)).find((entry) => entry.kind === kind)!;
93
+
94
+ async function root(key: string, read = false, owner = userId, parentTaskId: string | null = null) {
95
+ const id = crypto.randomUUID();
96
+ const now = new Date().toISOString();
97
+ await getDbClient().run(
98
+ `INSERT INTO agent_tasks (id, task, status, source, "key", requestedByUserId, parentTaskId, createdAt, lastUpdatedAt)
99
+ VALUES (?, 'Checklist use case', 'completed', 'ui', ?, ?, ?, ?, ?)`,
100
+ [id, key, owner, parentTaskId, now, now],
101
+ );
102
+ if (read) await triageSessionList(owner, { groupKey: key }, "read");
103
+ return id;
104
+ }
105
+
106
+ async function asset(
107
+ table: "pages" | "workflows" | "scheduled_tasks",
108
+ key: string,
109
+ creator = userId,
110
+ ) {
111
+ const id = crypto.randomUUID();
112
+ const now = new Date().toISOString();
113
+ if (table === "pages") {
114
+ await getDbClient().run(
115
+ `INSERT INTO pages (id, agentId, slug, title, contentType, body, "key", created_by, createdAt)
116
+ VALUES (?, ?, ?, 'Checklist page', 'text/html', '<p>Test</p>', ?, ?, ?)`,
117
+ [id, crypto.randomUUID(), id, key, creator, now],
118
+ );
119
+ } else if (table === "workflows") {
120
+ await getDbClient().run(
121
+ `INSERT INTO workflows (id, name, definition, "key", created_by, createdAt)
122
+ VALUES (?, ?, '{"nodes":[]}', ?, ?, ?)`,
123
+ [id, id, key, creator, now],
124
+ );
125
+ } else {
126
+ await getDbClient().run(
127
+ `INSERT INTO scheduled_tasks (id, name, intervalMs, taskTemplate, "key", created_by, createdAt, lastUpdatedAt)
128
+ VALUES (?, ?, 60000, 'Test', ?, ?, ?, ?)`,
129
+ [id, id, key, creator, now, now],
130
+ );
131
+ }
132
+ return id;
133
+ }
134
+
135
+ beforeAll(() => {
136
+ initDb(dbPath);
137
+ });
138
+
139
+ beforeEach(async () => {
140
+ for (const key of envKeys) delete process.env[key];
141
+ process.env.SLACK_DISABLE = "true";
142
+ process.env.RBAC_ENABLED = "true";
143
+ await getDbClient().run("DELETE FROM checklist_items");
144
+ await getDbClient().run("DELETE FROM oauth_authorizations");
145
+ const user = await createUser({ name: "Checklist User" });
146
+ userId = user.id;
147
+ auth = { kind: "user", userId, user };
148
+ actor = { id: userId, userId, canEditSwarm: true };
149
+ delete process.env.CHAT_SDK_ADAPTERS;
150
+ healthSpy = spyOn(chatRuntime, "getChatSdkHealth").mockReturnValue({});
151
+ });
152
+
153
+ afterEach(() => {
154
+ healthSpy.mockRestore();
155
+ for (const key of envKeys) {
156
+ if (savedEnv[key] === undefined) delete process.env[key];
157
+ else process.env[key] = savedEnv[key];
158
+ }
159
+ });
160
+
161
+ afterAll(async () => {
162
+ closeDb();
163
+ for (const suffix of ["", "-wal", "-shm"])
164
+ await Bun.file(dbPath + suffix)
165
+ .delete()
166
+ .catch(() => {});
167
+ });
168
+
169
+ describe("checklist defaults and signals", () => {
170
+ test("reads merge the defaults without writing, writes store them, and changes are kept", async () => {
171
+ await asset("pages", "shared/existing/");
172
+ const other = await createUser({ name: "Unread checklist" });
173
+ const run = spyOn(getDbClient(), "run");
174
+ const transaction = spyOn(getDbClient(), "transaction");
175
+ let results: ChecklistItem[][];
176
+ try {
177
+ results = await Promise.all([
178
+ listChecklist(userId),
179
+ listChecklist(userId),
180
+ listChecklist(null),
181
+ firstOpenItem(userId, true).then((first) => (first ? [first] : [])),
182
+ ]);
183
+ expect(run).not.toHaveBeenCalled();
184
+ expect(transaction).not.toHaveBeenCalled();
185
+ } finally {
186
+ run.mockRestore();
187
+ transaction.mockRestore();
188
+ }
189
+ expect(results[0].map((row) => row.id)).toEqual([
190
+ "swarm:channel",
191
+ "swarm:tool",
192
+ `user:${userId}:use_case`,
193
+ ]);
194
+ expect(results[2]).toHaveLength(2);
195
+ expect(await getDbClient().get("SELECT COUNT(*) AS n FROM checklist_items")).toEqual({ n: 0 });
196
+ await mutateChecklist(actor, { action: "remove", id: "swarm:tool", reason: "Later" });
197
+ expect((await item("tool")).status).toBe("removed");
198
+ expect(await listChecklist(userId)).toHaveLength(3);
199
+ expect((await listChecklist(other.id)).filter((row) => row.scope === "user")).toHaveLength(1);
200
+ });
201
+
202
+ test("migration 302 applies to a populated database and lists the defaults on its first read", async () => {
203
+ const pageId = await asset("pages", "shared/pre-checklist/");
204
+ await getDbClient().run("DROP TABLE checklist_items");
205
+ await getDbClient().run("DELETE FROM _migrations WHERE version = 302");
206
+ runMigrations(getDb());
207
+ expect(await getDbClient().get("SELECT id FROM pages WHERE id = ?", [pageId])).toEqual({
208
+ id: pageId,
209
+ });
210
+ expect(await listChecklist(userId)).toHaveLength(3);
211
+ });
212
+
213
+ test("Slack configuration checks the channel without checking tools", async () => {
214
+ expect((await item("channel")).signal).toBe(false);
215
+ process.env.SLACK_DISABLE = "false";
216
+ process.env.SLACK_BOT_TOKEN = "xoxb-checklist-fixture";
217
+ process.env.SLACK_APP_TOKEN = "xapp-checklist-fixture";
218
+ expect((await item("channel")).signal).toBe(true);
219
+ expect((await item("tool")).signal).toBe(false);
220
+ });
221
+
222
+ test("channel adapters require configured, enabled, healthy status and respect meta.adapter", async () => {
223
+ const targeted = await mutateChecklist(actor, {
224
+ action: "add",
225
+ scope: "swarm",
226
+ kind: "channel",
227
+ label: "Telegram",
228
+ meta: { adapter: "telegram" },
229
+ });
230
+ const slack = await mutateChecklist(actor, {
231
+ action: "add",
232
+ scope: "swarm",
233
+ kind: "channel",
234
+ label: "Slack",
235
+ meta: { adapter: "slack" },
236
+ });
237
+ const ok = { status: "ok" } as chatRuntime.ChatAdapterHealth;
238
+ const cases: [
239
+ Record<string, unknown>,
240
+ Record<string, chatRuntime.ChatAdapterHealth>,
241
+ boolean,
242
+ ][] = [
243
+ [{}, { telegram: ok }, false], // not configured
244
+ [{ telegram: { enabled: false } }, { telegram: ok }, false], // turned off
245
+ [{ telegram: {} }, { telegram: { ...ok, status: "error" } }, false], // unhealthy
246
+ [{ telegram: {} }, {}, false], // not started
247
+ [{ telegram: {} }, { telegram: ok }, true],
248
+ ];
249
+ for (const [adapters, health, expected] of cases) {
250
+ process.env.CHAT_SDK_ADAPTERS = JSON.stringify(adapters);
251
+ healthSpy.mockReturnValue(health);
252
+ const items = await listChecklist(userId);
253
+ expect(items.find((row) => row.id === targeted.id)?.signal).toBe(expected);
254
+ expect(items.find((row) => row.id === slack.id)?.signal).toBe(false);
255
+ expect(items.find((row) => row.id === "swarm:channel")?.signal).toBe(expected);
256
+ }
257
+ process.env.SLACK_DISABLE = "false";
258
+ process.env.SLACK_BOT_TOKEN = "xoxb-checklist-fixture";
259
+ process.env.SLACK_APP_TOKEN = "xapp-checklist-fixture";
260
+ expect((await listChecklist(userId)).find((row) => row.id === slack.id)?.signal).toBe(true);
261
+ });
262
+
263
+ test.each([
264
+ "GITHUB_TOKEN",
265
+ "GITLAB_TOKEN",
266
+ "BITBUCKET_TOKEN",
267
+ ])("tool uses the %s flag", async (key) => {
268
+ expect((await item("tool")).signal).toBe(false);
269
+ process.env[key] = "fixture-token";
270
+ expect(await item("tool")).toMatchObject({ signal: true, done: true, status: "open" });
271
+ });
272
+
273
+ test.each(["google", "microsoft"])("tool uses stored %s OAuth tokens", async (provider) => {
274
+ expect((await item("tool")).signal).toBe(false);
275
+ await upsertOAuthApp(provider, {
276
+ clientId: "fixture",
277
+ clientSecret: "fixture-secret",
278
+ authorizeUrl: "https://example.com/authorize",
279
+ tokenUrl: "https://example.com/token",
280
+ redirectUri: "https://example.com/callback",
281
+ scopes: "test",
282
+ });
283
+ await storeOAuthTokens(provider, { accessToken: "checklist-fixture-token", expiresAt: null });
284
+ expect((await item("tool")).signal).toBe(true);
285
+ await deleteOAuthTokens(provider);
286
+ expect((await item("tool")).signal).toBe(false);
287
+ });
288
+
289
+ test.each([
290
+ "pages",
291
+ "workflows",
292
+ "scheduled_tasks",
293
+ ] as const)("use_case needs a %s asset and a read root below its group", async (table) => {
294
+ const key = `shared/checklist-${crypto.randomUUID()}/`;
295
+ await asset(table, key);
296
+ expect((await item("use_case")).signal).toBe(false);
297
+ const rootId = await root(`${key}task:${crypto.randomUUID()}/`);
298
+ expect((await item("use_case")).signal).toBe(false);
299
+ await triageSessionList(userId, { groupKey: key }, "read");
300
+ expect((await getSessionReadState(rootId, userId))?.readState).toBe("read");
301
+ expect(await item("use_case")).toMatchObject({ signal: true, done: true });
302
+ await triageSessionList(userId, { groupKey: key }, "done");
303
+ expect((await item("use_case")).signal).toBe(false);
304
+ });
305
+
306
+ test("a read task alone, another user's asset, and an asset under another prefix do not count", async () => {
307
+ const key = `shared/checklist-${crypto.randomUUID()}/`;
308
+ await root(key, true);
309
+ expect((await item("use_case")).signal).toBe(false);
310
+ const other = await createUser({ name: "Other creator" });
311
+ await asset("pages", key, other.id);
312
+ expect((await item("use_case")).signal).toBe(false);
313
+ await asset("pages", `${key.slice(0, -1)}-else/`);
314
+ expect((await item("use_case")).signal).toBe(false);
315
+ });
316
+
317
+ test("one read group counts behind 100 newer non-group keys, and done items skip the check", async () => {
318
+ const key = `shared/checklist-${crypto.randomUUID()}/`;
319
+ await asset("pages", key);
320
+ await root(`${key}task:${crypto.randomUUID()}/`, true);
321
+ await getDbClient().run("UPDATE pages SET createdAt = '2000-01-01T00:00:00.000Z'");
322
+ for (let i = 0; i < 101; i++) await asset("pages", `shared/page:${crypto.randomUUID()}/`);
323
+ expect((await item("use_case")).signal).toBe(true);
324
+ const actorItem = `user:${userId}:use_case`;
325
+ await mutateChecklist(actor, { action: "done", id: actorItem });
326
+ const query = spyOn(getDbClient(), "query");
327
+ try {
328
+ expect(await item("use_case")).toMatchObject({ status: "done", done: true, signal: null });
329
+ // Only the checklist rows are read: no asset scan for a done use case.
330
+ expect(query).toHaveBeenCalledTimes(1);
331
+ } finally {
332
+ query.mockRestore();
333
+ }
334
+ });
335
+
336
+ test("a stored meta that is not a JSON object reads as no meta", async () => {
337
+ for (const [index, raw] of ["{not json", "[1,2]", '"text"'].entries()) {
338
+ await getDbClient().run(
339
+ `INSERT INTO checklist_items (id, scope, kind, label, meta, sortOrder)
340
+ VALUES (?, 'swarm', 'channel', 'Broken', ?, ?)`,
341
+ [`broken-${index}`, raw, 10 + index],
342
+ );
343
+ }
344
+ const response = await api("GET");
345
+ expect(response.status).toBe(200);
346
+ expect(
347
+ response.body.items.filter((row) => row.id.startsWith("broken-")).map((row) => row.meta),
348
+ ).toEqual([null, null, null]);
349
+ });
350
+
351
+ test("namespace roots and resource leaves do not count as group keys", async () => {
352
+ for (const key of ["shared/", `shared/page:${crypto.randomUUID()}/`]) {
353
+ await asset("pages", key);
354
+ await root(key, true);
355
+ }
356
+ expect((await item("use_case")).signal).toBe(false);
357
+ });
358
+ });
359
+
360
+ describe("checklist ownership and mutations", () => {
361
+ test("a member cannot change swarm items, an admin can, and editable matches permissions", async () => {
362
+ await detachRole(userId, "admin");
363
+ await attachRole(userId, "requester");
364
+ let response = await api("GET");
365
+ expect(response.body.canEditSwarm).toBe(false);
366
+ expect(response.body.items.map((row) => row.editable)).toEqual([false, false, true]);
367
+ for (const action of ["remove", "restore", "done", "reorder"]) {
368
+ expect(
369
+ (await api("PATCH", "/api/checklist/items/swarm:channel", { action, sortOrder: 1 })).status,
370
+ ).toBe(403);
371
+ }
372
+ expect(
373
+ (
374
+ await api("POST", "/api/checklist/items", {
375
+ scope: "swarm",
376
+ kind: "custom",
377
+ label: "Denied",
378
+ })
379
+ ).status,
380
+ ).toBe(403);
381
+ await attachRole(userId, "admin");
382
+ response = await api("PATCH", "/api/checklist/items/swarm:channel", {
383
+ action: "remove",
384
+ reason: "No chat needed",
385
+ });
386
+ expect(response.status).toBe(200);
387
+ expect(response.body.item).toMatchObject({
388
+ status: "removed",
389
+ statusChangedBy: userId,
390
+ statusChangedByName: "Checklist User",
391
+ statusReason: "No chat needed",
392
+ editable: true,
393
+ });
394
+ expect(response.body.item.statusChangedAt).toBeString();
395
+ expect((await api("GET")).body.canEditSwarm).toBe(true);
396
+ });
397
+
398
+ test("remove, done and restore record the actor and reason, and preserve audit fields", async () => {
399
+ const id = `user:${userId}:use_case`;
400
+ await api("GET");
401
+ for (const action of ["remove", "done"]) {
402
+ const response = await api("PATCH", `/api/checklist/items/${id}`, {
403
+ action,
404
+ reason: `Reason for ${action}`,
405
+ });
406
+ expect(response.status).toBe(200);
407
+ expect(response.body.item).toMatchObject({
408
+ status: action === "remove" ? "removed" : "done",
409
+ statusChangedBy: userId,
410
+ statusReason: `Reason for ${action}`,
411
+ });
412
+ }
413
+ const restored = await api("PATCH", `/api/checklist/items/${id}`, {
414
+ action: "restore",
415
+ reason: "Ignored",
416
+ });
417
+ expect(restored.body.item).toMatchObject({
418
+ status: "open",
419
+ statusReason: null,
420
+ statusChangedBy: userId,
421
+ done: false,
422
+ });
423
+ expect(
424
+ await getDbClient().get("SELECT created_by, updated_by FROM checklist_items WHERE id = ?", [
425
+ id,
426
+ ]),
427
+ ).toEqual({ created_by: userId, updated_by: userId });
428
+ });
429
+
430
+ test("labels and reasons are scrubbed before they are stored, and encoded ids resolve", async () => {
431
+ const secret = `ghp_${"gH4".repeat(12)}`;
432
+ const added = await api("POST", "/api/checklist/items", {
433
+ scope: "user",
434
+ kind: "custom",
435
+ label: `Rotate ${secret}`,
436
+ });
437
+ expect(added.status).toBe(201);
438
+ const id = added.body.item.id as string;
439
+ const removed = await api("PATCH", `/api/checklist/items/${encodeURIComponent(id)}`, {
440
+ action: "remove",
441
+ reason: `Leaked ${secret}`,
442
+ });
443
+ expect(removed.status).toBe(200);
444
+ const row = await getDbClient().get<{ label: string; statusReason: string }>(
445
+ "SELECT label, statusReason FROM checklist_items WHERE id = ?",
446
+ [id],
447
+ );
448
+ expect(row?.label).not.toContain(secret);
449
+ expect(row?.statusReason).not.toContain(secret);
450
+ const encoded = await api(
451
+ "PATCH",
452
+ `/api/checklist/items/${encodeURIComponent(`user:${userId}:use_case`)}`,
453
+ { action: "done" },
454
+ );
455
+ expect(encoded.status).toBe(200);
456
+ });
457
+
458
+ test("other users cannot edit user items even as admins, and unknown ids return 404", async () => {
459
+ const other = await createUser({ name: "Other owner" });
460
+ const otherItem = `/api/checklist/items/user:${other.id}:use_case`;
461
+ // Not stored yet: another user's default reads as unknown.
462
+ expect((await api("PATCH", otherItem, { action: "remove" })).status).toBe(404);
463
+ await mutateChecklist(
464
+ { id: other.id, userId: other.id, canEditSwarm: false },
465
+ { action: "restore", id: `user:${other.id}:use_case` },
466
+ );
467
+ expect((await api("PATCH", otherItem, { action: "remove" })).status).toBe(403);
468
+ expect(
469
+ (await api("PATCH", `/api/checklist/items/${crypto.randomUUID()}`, { action: "done" }))
470
+ .status,
471
+ ).toBe(404);
472
+ expect((await api("GET")).body.items.some((row) => row.userId === other.id)).toBe(false);
473
+ });
474
+
475
+ test("custom items have no signal, use per-list ordering, and validate requests", async () => {
476
+ const added = await api("POST", "/api/checklist/items", {
477
+ scope: "user",
478
+ kind: "custom",
479
+ label: "Review the plan",
480
+ href: "/sessions",
481
+ meta: { note: "Review" },
482
+ });
483
+ expect(added.status).toBe(201);
484
+ const custom = added.body.item;
485
+ expect(custom).toMatchObject({
486
+ userId,
487
+ scope: "user",
488
+ signal: null,
489
+ done: false,
490
+ sortOrder: 3,
491
+ meta: { note: "Review" },
492
+ });
493
+ const done = await api("PATCH", `/api/checklist/items/${custom.id}`, {
494
+ action: "done",
495
+ reason: "Reviewed",
496
+ });
497
+ expect(done.body.item).toMatchObject({ done: true, signal: null, statusReason: "Reviewed" });
498
+ const reordered = await api("PATCH", `/api/checklist/items/${custom.id}`, {
499
+ action: "reorder",
500
+ sortOrder: -1,
501
+ });
502
+ expect(reordered.body.item.sortOrder).toBe(-1);
503
+ expect((await api("GET")).body.items[0].id).toBe(custom.id);
504
+ expect(
505
+ (await api("PATCH", `/api/checklist/items/${custom.id}`, { action: "reorder" })).status,
506
+ ).toBe(400);
507
+ expect(
508
+ (
509
+ await api("PATCH", `/api/checklist/items/${custom.id}`, {
510
+ action: "done",
511
+ reason: "x".repeat(501),
512
+ })
513
+ ).status,
514
+ ).toBe(400);
515
+ expect(
516
+ (
517
+ await api("POST", "/api/checklist/items", {
518
+ scope: "user",
519
+ kind: "custom",
520
+ label: "x".repeat(201),
521
+ })
522
+ ).status,
523
+ ).toBe(400);
524
+ });
525
+
526
+ test("a second open item for the same adapter is refused, and meta is capped", async () => {
527
+ const telegram = {
528
+ scope: "swarm",
529
+ kind: "channel",
530
+ label: "Connect Telegram",
531
+ meta: { adapter: "telegram" },
532
+ };
533
+ const first = await api("POST", "/api/checklist/items", telegram);
534
+ expect(first.status).toBe(201);
535
+ const second = await api("POST", "/api/checklist/items", telegram);
536
+ expect(second.status).toBe(409);
537
+ expect(second.body.error).toContain("telegram");
538
+ expect(
539
+ (await api("POST", "/api/checklist/items", { ...telegram, meta: { adapter: "discord" } }))
540
+ .status,
541
+ ).toBe(201);
542
+ await api("PATCH", `/api/checklist/items/${first.body.item.id}`, { action: "remove" });
543
+ expect((await api("POST", "/api/checklist/items", telegram)).status).toBe(201);
544
+ for (const meta of [{ adapter: 42 }, { note: "x".repeat(1100) }]) {
545
+ expect((await api("POST", "/api/checklist/items", { ...telegram, meta })).status).toBe(400);
546
+ }
547
+ });
548
+
549
+ test("with RBAC off, role rows do not decide swarm edits: the legacy policy does", async () => {
550
+ await attachRole(userId, "admin");
551
+ expect((await api("GET")).body.canEditSwarm).toBe(true);
552
+ process.env.RBAC_ENABLED = "false";
553
+ // The admin role row stays, but a user token is no Lead under the legacy policy.
554
+ expect((await api("GET")).body.canEditSwarm).toBe(false);
555
+ auth = { kind: "operator", fingerprint: "op:checklist" };
556
+ expect((await api("GET")).body.canEditSwarm).toBe(true);
557
+ });
558
+
559
+ test("the checklist nudge honors RBAC off like the route: the Lead may edit swarm items", async () => {
560
+ await attachRole(userId, "admin");
561
+ expect(await userGrantCanEditSwarm(userId)).toBe(true);
562
+ process.env.RBAC_ENABLED = "false";
563
+ expect(await userGrantCanEditSwarm(userId)).toBeNull();
564
+ });
565
+
566
+ test("unstored defaults serialize the same on every read", async () => {
567
+ const first = await listChecklist(userId);
568
+ await Bun.sleep(5);
569
+ expect(await listChecklist(userId)).toEqual(first);
570
+ });
571
+
572
+ test("operator without a user sees swarm items, but cannot create user items", async () => {
573
+ auth = { kind: "operator", fingerprint: "op:checklist" };
574
+ const response = await api("GET");
575
+ expect(response.body.items).toHaveLength(2);
576
+ expect(response.body.canEditSwarm).toBe(true);
577
+ expect(
578
+ (
579
+ await api("POST", "/api/checklist/items", {
580
+ scope: "user",
581
+ kind: "custom",
582
+ label: "No user",
583
+ })
584
+ ).status,
585
+ ).toBe(400);
586
+ });
587
+
588
+ test("agent actions use the task owner and record Lead attribution", async () => {
589
+ const agentId = crypto.randomUUID();
590
+ await createAgent({ id: agentId, name: "Checklist Lead", isLead: true, status: "idle" });
591
+ const taskId = await root(`shared/checklist-${crypto.randomUUID()}/`);
592
+ await getDbClient().run(
593
+ "UPDATE agent_tasks SET agentId = ?, status = 'in_progress' WHERE id = ?",
594
+ [agentId, taskId],
595
+ );
596
+ auth = { kind: "operator", fingerprint: "op:checklist" };
597
+ await api("GET", "/api/checklist", undefined, agentId);
598
+ const response = await api(
599
+ "PATCH",
600
+ `/api/checklist/items/user:${userId}:use_case`,
601
+ { action: "done", reason: "Lead verified" },
602
+ agentId,
603
+ );
604
+ expect(response.status).toBe(200);
605
+ expect(response.body.item).toMatchObject({
606
+ statusChangedBy: `lead:${agentId}`,
607
+ statusChangedByName: "Lead",
608
+ statusReason: "Lead verified",
609
+ });
610
+ });
611
+
612
+ test("non-lead agents read the checklist but cannot change it", async () => {
613
+ const agentId = crypto.randomUUID();
614
+ await createAgent({ id: agentId, name: "Checklist Worker", isLead: false, status: "idle" });
615
+ const taskId = await root(`shared/checklist-${crypto.randomUUID()}/`);
616
+ await getDbClient().run(
617
+ "UPDATE agent_tasks SET agentId = ?, status = 'in_progress' WHERE id = ?",
618
+ [agentId, taskId],
619
+ );
620
+ auth = { kind: "operator", fingerprint: "op:checklist" };
621
+ expect((await api("GET", "/api/checklist", undefined, agentId)).status).toBe(200);
622
+ const patch = await api(
623
+ "PATCH",
624
+ `/api/checklist/items/user:${userId}:use_case`,
625
+ { action: "done" },
626
+ agentId,
627
+ );
628
+ expect(patch.status).toBe(403);
629
+ const add = await api(
630
+ "POST",
631
+ "/api/checklist/items",
632
+ { scope: "user", kind: "custom", label: "Worker item" },
633
+ agentId,
634
+ );
635
+ expect(add.status).toBe(403);
636
+ });
637
+
638
+ test("a user token with an agent header is recorded as the user, not the Lead", async () => {
639
+ const agentId = crypto.randomUUID();
640
+ await createAgent({ id: agentId, name: "Header Lead", isLead: true, status: "idle" });
641
+ const response = await api(
642
+ "PATCH",
643
+ `/api/checklist/items/user:${userId}:use_case`,
644
+ { action: "done" },
645
+ agentId,
646
+ );
647
+ expect(response.status).toBe(200);
648
+ expect(response.body.item.statusChangedBy).toBe(userId);
649
+ });
650
+
651
+ test("firstOpenItem skips done, signaled, removed, nudged and custom items, and nudge writes join transactions", async () => {
652
+ process.env.GITHUB_TOKEN = "fixture-token";
653
+ await listChecklist(userId);
654
+ await mutateChecklist(actor, { action: "add", scope: "user", kind: "custom", label: "Manual" });
655
+ expect((await firstOpenItem(userId, false))?.id).toBe(`user:${userId}:use_case`);
656
+ expect((await firstOpenItem(userId, true))?.id).toBe("swarm:channel");
657
+ const taskId = crypto.randomUUID();
658
+ await expect(
659
+ getDbClient().transaction(async () => {
660
+ await markNudged("swarm:channel", taskId, userId);
661
+ expect((await firstOpenItem(userId, true))?.id).toBe(`user:${userId}:use_case`);
662
+ throw new Error("Rollback nudge");
663
+ }),
664
+ ).rejects.toThrow("Rollback nudge");
665
+ expect((await firstOpenItem(userId, true))?.id).toBe("swarm:channel");
666
+ await getDbClient().transaction(async () => {
667
+ await markNudged("swarm:channel", taskId, userId);
668
+ });
669
+ expect(await item("channel")).toMatchObject({
670
+ nudgedTaskId: taskId,
671
+ nudgedAt: expect.any(String),
672
+ });
673
+ await mutateChecklist(actor, { action: "done", id: `user:${userId}:use_case` });
674
+ expect(await firstOpenItem(userId, true)).toBeNull();
675
+ await mutateChecklist(actor, { action: "remove", id: `user:${userId}:use_case` });
676
+ expect(await firstOpenItem(userId, true)).toBeNull();
677
+ });
678
+
679
+ test("firstOpenItem advances to the next swarm item after a nudge", async () => {
680
+ expect((await firstOpenItem(userId, true))?.id).toBe("swarm:channel");
681
+ await markNudged("swarm:channel", crypto.randomUUID(), userId);
682
+ expect((await firstOpenItem(userId, true))?.id).toBe("swarm:tool");
683
+ await mutateChecklist(actor, { action: "remove", id: "swarm:tool" });
684
+ expect((await firstOpenItem(userId, true))?.id).toBe(`user:${userId}:use_case`);
685
+ });
686
+ });