@desplega.ai/agent-swarm 2.9.0 → 2.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (453) hide show
  1. package/dist/acp-adapter-bht22g3k.js +16 -0
  2. package/dist/{acp-targets-swxq55dr.js → acp-targets-arrwv4f0.js} +7 -7
  3. package/dist/{actions-pb678g3e.js → actions-y0d2n1c2.js} +102 -21
  4. package/dist/{agent-fs-provision-dmhnc38q.js → agent-fs-provision-tpj7sktd.js} +4 -4
  5. package/dist/{amp-adapter-3pa66q27.js → amp-adapter-vmmnmw8d.js} +2 -2
  6. package/dist/{anthropic-messages-x2cp5fvf.js → anthropic-messages-zdca3gv1.js} +22 -22
  7. package/dist/{app-17d12ev4.js → app-wb7w45dq.js} +6 -3
  8. package/dist/{approval-notifications-h7vd9pmg.js → approval-notifications-7mqr6vbd.js} +8 -5
  9. package/dist/{assistant-t7k39ree.js → assistant-gf60454p.js} +23 -21
  10. package/dist/{boot-args-schema-0gqmkfbe.js → boot-args-schema-qxmd59sr.js} +1 -1
  11. package/dist/{boot-reembed-f064w382.js → boot-reembed-5tmeskj2.js} +1 -1
  12. package/dist/{boot-reembed-n6anc01d.js → boot-reembed-wb44vc3s.js} +1 -1
  13. package/dist/boot-scrub-sweep-25bxhnw4.js +9 -0
  14. package/dist/{boot-seeds-f99fjs5q.js → boot-seeds-nj9za0vk.js} +4 -4
  15. package/dist/{claude-adapter-gvznwxgc.js → claude-adapter-d3krpdyb.js} +7 -7
  16. package/dist/{claude-managed-adapter-pbrbvc64.js → claude-managed-adapter-t8nfgcgz.js} +2 -2
  17. package/dist/{claude-managed-setup-kdxttvc3.js → claude-managed-setup-7y4pwd81.js} +3 -3
  18. package/dist/{claude-sdk-session-0t2teq6n.js → claude-sdk-session-d138zy0e.js} +7 -7
  19. package/dist/{cli-6dp0jkfj.js → cli-01k6wpr9.js} +4 -4
  20. package/dist/{cli-c07v0qfa.js → cli-124ntmf0.js} +83 -74
  21. package/dist/{cli-1tvdx9t5.js → cli-2rnd5j3t.js} +1 -1
  22. package/dist/{cli-4ghh072d.js → cli-2spnz7ye.js} +36 -36
  23. package/dist/{cli-dd37e0cm.js → cli-2v2zdm0a.js} +1 -1
  24. package/dist/{cli-aa8s22gn.js → cli-3aaeb78m.js} +195 -186
  25. package/dist/{cli-8x8y70av.js → cli-3caf7pmg.js} +2 -2
  26. package/dist/{cli-jd3kxppb.js → cli-3et6fmfe.js} +1 -1
  27. package/dist/{cli-kaa4bd7x.js → cli-3f8zbtqa.js} +9 -8
  28. package/dist/{cli-57pvhnyt.js → cli-43evxwj4.js} +1 -1
  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-2tnbc3gw.js → cli-539h29es.js} +2379 -66
  33. package/dist/{cli-rts1qvb4.js → cli-5qhfv9rw.js} +2 -2
  34. package/dist/{cli-faf46gdq.js → cli-6037prsx.js} +10 -10
  35. package/dist/{cli-bk9v1xrv.js → cli-6cwr32fe.js} +25 -25
  36. package/dist/{cli-812paz57.js → cli-6ehs4mta.js} +18 -2
  37. package/dist/{cli-95930z69.js → cli-6ym4jhzp.js} +2 -2
  38. package/dist/{cli-zg3z63x3.js → cli-7mv4h3sn.js} +1 -1
  39. package/dist/{cli-9a2rtd77.js → cli-7r162fxe.js} +24 -15
  40. package/dist/{cli-eg437b5p.js → cli-7sf9sb0w.js} +2 -1
  41. package/dist/{cli-vw5x18yj.js → cli-8st34zhr.js} +20 -10
  42. package/dist/{cli-fgphc007.js → cli-91pkxres.js} +1 -1
  43. package/dist/{cli-2kg31ted.js → cli-9fjr27ez.js} +11 -11
  44. package/dist/{cli-wr1h0k28.js → cli-9w8712tq.js} +617 -278
  45. package/dist/cli-aw83sr40.js +98 -0
  46. package/dist/{cli-ssvdrk4y.js → cli-b6px1k1q.js} +1 -1
  47. package/dist/{cli-w7dxb2fj.js → cli-cc93xzes.js} +6 -6
  48. package/dist/{cli-js8zrfyg.js → cli-fcfbct2j.js} +5 -5
  49. package/dist/{cli-3zxdz9r7.js → cli-fq2rr3jb.js} +6 -6
  50. package/dist/{boot-scrub-sweep-ejd5dnrz.js → cli-had1p04a.js} +8 -9
  51. package/dist/{cli-7cgf614g.js → cli-j6te8keb.js} +5 -5
  52. package/dist/{cli-25nstr34.js → cli-jrbq4djp.js} +1 -1
  53. package/dist/{cli-pz1c00aa.js → cli-k3q2va86.js} +2 -2
  54. package/dist/{cli-nhq5js1b.js → cli-k5yewqgd.js} +3 -3
  55. package/dist/cli-kbtzfrxj.js +404 -0
  56. package/dist/{cli-dx439zpg.js → cli-kpgcm7xy.js} +13 -1
  57. package/dist/{cli-mc1fx4xd.js → cli-m9cvf7vs.js} +10 -10
  58. package/dist/{cli-kmvcm34h.js → cli-md50mj0r.js} +2 -2
  59. package/dist/{cli-q8cfh1t9.js → cli-mk7c5ac4.js} +1 -1
  60. package/dist/cli-mys27d03.js +321 -0
  61. package/dist/{cli-spzkdgtg.js → cli-n3qe7tyr.js} +172 -168
  62. package/dist/{cli-7akn6ze9.js → cli-nh7x3133.js} +7 -28
  63. package/dist/{cli-fnh4b12r.js → cli-nstkanmx.js} +6 -6
  64. package/dist/{cli-g3zzby8t.js → cli-nv4xsvmk.js} +5 -5
  65. package/dist/{cli-sn4pc4qx.js → cli-p0c3vtch.js} +2 -2
  66. package/dist/{cli-5ntc4we6.js → cli-p0n7b5rz.js} +859 -2058
  67. package/dist/{cli-pn1v1pb0.js → cli-psffsanb.js} +3 -2
  68. package/dist/{cli-svc803vq.js → cli-q5srsxq2.js} +15 -15
  69. package/dist/{cli-nmcpzbty.js → cli-qrta34nb.js} +4 -4
  70. package/dist/{cli-k09cxm6m.js → cli-qx4f057j.js} +2 -2
  71. package/dist/{cli-eepnpee7.js → cli-s1khw52h.js} +12 -12
  72. package/dist/{cli-h474mvp5.js → cli-s1zqk1aj.js} +21 -11
  73. package/dist/{cli-8axx8vnw.js → cli-sb4426be.js} +10 -10
  74. package/dist/{cli-kqh27v2y.js → cli-th1dkc2v.js} +1 -1
  75. package/dist/{cli-cw7mc1je.js → cli-tr27kwyg.js} +3 -3
  76. package/dist/{cli-5kcmxwxv.js → cli-tvgqesec.js} +7 -5
  77. package/dist/{cli-a9hfzg2r.js → cli-ty3gha1p.js} +6 -6
  78. package/dist/{cli-fjggej24.js → cli-v46zsvqk.js} +1 -1
  79. package/dist/{cli-5gygrr67.js → cli-v8z0yga9.js} +4 -4
  80. package/dist/{cli-k7pt28ad.js → cli-vfqvrd82.js} +5 -5
  81. package/dist/{cli-vvgaz8t6.js → cli-vq2eg24x.js} +2 -2
  82. package/dist/{cli-pwsax0vp.js → cli-vsw91x06.js} +23 -22
  83. package/dist/{cli-7fx9jyfs.js → cli-w1q68d8x.js} +67 -11
  84. package/dist/{cli-c5cspahx.js → cli-wafmk3fn.js} +45 -20
  85. package/dist/{cli-ymct0ycy.js → cli-wwp1bd3n.js} +5495 -5095
  86. package/dist/{cli-me4maa4j.js → cli-y4ccxtz5.js} +45 -9
  87. package/dist/{cli-m1fbz2wj.js → cli-y8p78ekx.js} +178 -19
  88. package/dist/{cli-nr46j5pw.js → cli-z0m452jr.js} +1 -1
  89. package/dist/{cli-gddgcnav.js → cli-zeh2mhkg.js} +1 -1
  90. package/dist/{cli-e9973bf0.js → cli-zk7v5s89.js} +2 -2
  91. package/dist/cli.js +24 -23
  92. package/dist/{cloudflare-workers-ai-system-one-9y1zx3pt.js → cloudflare-workers-ai-system-one-4aysy6rh.js} +2 -2
  93. package/dist/{codex-adapter-44yq2fkn.js → codex-adapter-exfdbj73.js} +6 -6
  94. package/dist/{codex-hook-h1zb7cfk.js → codex-hook-59atdwd8.js} +1 -1
  95. package/dist/{codex-login-cdyrr5y1.js → codex-login-a239g1ah.js} +1 -1
  96. package/dist/{codex-session-runner-zbh26gbw.js → codex-session-runner-xhznc4g3.js} +6 -6
  97. package/dist/{commands-54f02v5b.js → commands-d8g349v4.js} +3 -3
  98. package/dist/{controller-9gpwcdek.js → controller-mwgdmb8y.js} +6 -3
  99. package/dist/{controllers-connect-61re6k1n.js → controllers-connect-5v7qx04j.js} +22 -20
  100. package/dist/core-sxy4epp2.js +38 -0
  101. package/dist/{cursor-adapter-7e4g81vd.js → cursor-adapter-p2q5h35d.js} +1 -1
  102. package/dist/{db-wnh0qjy1.js → db-qpganbeb.js} +3 -3
  103. package/dist/{db-dg2gc7fd.js → db-wcw0b2j8.js} +8 -2
  104. package/dist/{dispatcher-jrm24r43.js → dispatcher-8d8s49yz.js} +20 -18
  105. package/dist/{docker-9aq30pp2.js → docker-09tkkg0n.js} +42 -3
  106. package/dist/{dsh-adapter-1yqk267c.js → dsh-adapter-me0twn13.js} +1 -1
  107. package/dist/{easter-egg-3d-r4h9cs9m.js → easter-egg-3d-wv7w5ty6.js} +1 -1
  108. package/dist/{embedding-space-bafjr5f7.js → embedding-space-e48xchqa.js} +6 -6
  109. package/dist/{embeddings-7xmgqe0e.js → embeddings-tgq2afbq.js} +1 -1
  110. package/dist/{execute-d6jg5ns0.js → execute-8rhwrk7f.js} +1 -1
  111. package/dist/{external-channel-frq1xvq2.js → external-channel-8bt3j2pm.js} +2 -2
  112. package/dist/fx-adapter-adtdb3jb.js +19 -0
  113. package/dist/{google-generative-ai-hh7strj3.js → google-generative-ai-bh0djqjp.js} +5 -5
  114. package/dist/{google-vertex-fy5bw2pm.js → google-vertex-prjbw8dj.js} +9 -9
  115. package/dist/grok-adapter-accnn9km.js +19 -0
  116. package/dist/handlers-1x77561e.js +35 -0
  117. package/dist/{heartbeat-6bpa611t.js → heartbeat-x0056ra5.js} +23 -21
  118. package/dist/{hook-hvm5nf46.js → hook-a7vmn2st.js} +5 -5
  119. package/dist/{hook-w12k146y.js → hook-mrd2ayxv.js} +6 -6
  120. package/dist/{http-43tthdvs.js → http-ym9c5svp.js} +1335 -363
  121. package/dist/{index-fn054vsf.js → index-01ns1pkw.js} +1 -1
  122. package/dist/{index-1f0vypbg.js → index-0h6qd4p1.js} +34 -24
  123. package/dist/index-48qzcqzj.js +35 -0
  124. package/dist/{index-4b1q8kan.js → index-4k7m5dgj.js} +629 -354
  125. package/dist/index-620y7jzq.js +15 -0
  126. package/dist/{index-cret47a5.js → index-8p0j4h4j.js} +506 -43
  127. package/dist/{index-m5gx1xd6.js → index-9myfj74s.js} +40 -40
  128. package/dist/{index-bs7gw5fd.js → index-b5wgnm78.js} +44 -44
  129. package/dist/{index-ftywhyr0.js → index-ny60jcat.js} +394 -66
  130. package/dist/{index-tx9mc2ap.js → index-p46tvwtx.js} +24 -22
  131. package/dist/{index-585gyczt.js → index-pe3d8jfy.js} +3 -3
  132. package/dist/index-rkvaambe.js +36 -0
  133. package/dist/{index-mhq4sh5w.js → index-x6azjwm8.js} +1 -1
  134. package/dist/index-xj1mq27m.js +40 -0
  135. package/dist/k8s-m56sw868.js +217 -0
  136. package/dist/{keepalive-rk0j0jvh.js → keepalive-7yxg8z4c.js} +3 -3
  137. package/dist/lead-enzn86bz.js +74 -0
  138. package/dist/{maintenance-g6z6kaxw.js → maintenance-6tefxmk1.js} +1 -1
  139. package/dist/{node-jftbyawr.js → node-2wfcey7d.js} +1 -1
  140. package/dist/{oauth-refresh-sweep-2k3g2q4w.js → oauth-refresh-sweep-70cavc3a.js} +2 -2
  141. package/dist/{onboard-6fdbvh3v.js → onboard-fja65z08.js} +5 -5
  142. package/dist/{openai-decisions-q3hh60wr.js → openai-decisions-ytp6w6xh.js} +1 -1
  143. package/dist/{opencode-adapter-fdbsvts7.js → opencode-adapter-hakkm7yh.js} +6 -6
  144. package/dist/{otel-impl-rvwtc09q.js → otel-impl-7zhnt6gj.js} +1 -1
  145. package/dist/{pending-sqkrb836.js → pending-h01yzpx4.js} +21 -19
  146. package/dist/{pi-mono-adapter-asqayqcg.js → pi-mono-adapter-f52hz743.js} +40 -13
  147. package/dist/{pricing-refresh-f5tkgmw2.js → pricing-refresh-fzxvk2zf.js} +2 -2
  148. package/dist/{rbac-roles-06s555fa.js → rbac-roles-9v6vhgbs.js} +3 -3
  149. package/dist/{rbac-roles-szxsg8t1.js → rbac-roles-hfgh8sba.js} +2 -2
  150. package/dist/{render-v2-103p266q.js → render-v2-1rgspxzf.js} +6 -3
  151. package/dist/{resume-v7kjewt9.js → resume-tqy61x24.js} +10 -7
  152. package/dist/{runtime-f1gmk0b7.js → runtime-exkxyx5f.js} +1 -1
  153. package/dist/{session-access-6shev8ts.js → session-access-3act7vt4.js} +4 -4
  154. package/dist/{session-source-backfill-bd7spzjd.js → session-source-backfill-82qe7fqq.js} +3 -3
  155. package/dist/{setup-kmxmztdb.js → setup-ry1vfdef.js} +1 -1
  156. package/dist/thread-buffer-3x93yexa.js +38 -0
  157. package/dist/{typesafe-system-one-f2en2knd.js → typesafe-system-one-vcfj2ak8.js} +2 -2
  158. package/dist/user-merge-jobs-bx6bf7db.js +22 -0
  159. package/dist/{virtual-modules-57eje5wy.js → virtual-modules-s0rjzcqq.js} +3 -3
  160. package/dist/{work-objects-zr47ygmf.js → work-objects-z2e5tv03.js} +29 -23
  161. package/dist/{worker-follow-up-grrr3fda.js → worker-follow-up-y3xeg89w.js} +20 -18
  162. package/dist/worker-zfcv2wbf.js +74 -0
  163. package/openapi.json +2763 -147
  164. package/package.json +9 -8
  165. package/src/apps/catalog.generated.json +43 -3
  166. package/src/apps/page-validator.ts +27 -0
  167. package/src/be/boot-seeds.ts +7 -1
  168. package/src/be/db/model-groups.ts +238 -0
  169. package/src/be/db/model-profiles.ts +28 -7
  170. package/src/be/db/session-costs.ts +225 -0
  171. package/src/be/db/session-log-reasoning.ts +36 -0
  172. package/src/be/db/tasks/read.ts +8 -3
  173. package/src/be/db/tasks/write.ts +34 -1
  174. package/src/be/db/user-references.ts +75 -0
  175. package/src/be/db/users/references.ts +185 -0
  176. package/src/be/db-client.ts +70 -19
  177. package/src/be/db.ts +232 -361
  178. package/src/be/key-window-usage.ts +386 -0
  179. package/src/be/memory/demotion-evidence.ts +34 -0
  180. package/src/be/memory/reranker.ts +34 -12
  181. package/src/be/memory/review-recall-filter.ts +83 -0
  182. package/src/be/memory/search-candidates.ts +19 -6
  183. package/src/be/memory/types.ts +11 -0
  184. package/src/be/migrations/303_task_ui_specs.sql +28 -0
  185. package/src/be/migrations/306_provider_account_telemetry.sql +1 -0
  186. package/src/be/migrations/307_session_cost_credential_attribution.sql +23 -0
  187. package/src/be/migrations/310_session_logs_reasoning.sql +12 -0
  188. package/src/be/migrations/312_task_ui_action_runs_repeatable.sql +6 -0
  189. package/src/be/migrations/314_model_groups.sql +85 -0
  190. package/src/be/migrations/318_superseded_workflow_cut_backfill.sql +22 -0
  191. package/src/be/migrations/319_user_fk_indexes.sql +153 -0
  192. package/src/be/migrations/320_session_costs_kind.sql +4 -0
  193. package/src/be/migrations/321_user_merge_jobs.sql +52 -0
  194. package/src/be/pricing-normalize.ts +2 -0
  195. package/src/be/rbac-roles.ts +6 -4
  196. package/src/be/runtime-pools/db.ts +23 -5
  197. package/src/be/runtime-pools/supervisor.ts +15 -1
  198. package/src/be/scripts/db.ts +11 -0
  199. package/src/be/scripts/typecheck.ts +2 -0
  200. package/src/be/seed-model-groups.ts +86 -0
  201. package/src/be/seed-model-profiles.ts +20 -13
  202. package/src/be/seed-scripts/catalog/boot-triage.inline.ts +1 -0
  203. package/src/be/seed-scripts/catalog/boot-triage.ts +1 -0
  204. package/src/be/seed-scripts/catalog/dreaming-gather.ts +165 -1
  205. package/src/be/seed-scripts/catalog/wait-for-task.ts +5 -1
  206. package/src/be/seed-skills/index.ts +3 -0
  207. package/src/be/swarm-config-guard.ts +58 -1
  208. package/src/be/task-ui-spec.ts +259 -0
  209. package/src/be/user-merge-jobs.ts +564 -0
  210. package/src/be/users.ts +41 -23
  211. package/src/commands/controller.ts +3 -0
  212. package/src/commands/credential-outcome-report.ts +13 -3
  213. package/src/commands/onboard/agent-fs-version.ts +1 -1
  214. package/src/commands/onboard/compose-generator.ts +1 -1
  215. package/src/commands/onboard/env-generator.ts +1 -1
  216. package/src/commands/provider-credentials.ts +1 -1
  217. package/src/commands/rate-limit-outcome.ts +6 -0
  218. package/src/commands/runner.ts +34 -53
  219. package/src/extensions/catalog.generated.json +3 -3
  220. package/src/extensions/contract-types.generated.ts +1 -1
  221. package/src/extensions/contract.ts +15 -0
  222. package/src/extensions/dispatcher.ts +14 -4
  223. package/src/github/handlers.ts +57 -0
  224. package/src/github/types.ts +4 -0
  225. package/src/http/all-routes.ts +2 -0
  226. package/src/http/api-keys.ts +258 -30
  227. package/src/http/approval-requests.ts +5 -1
  228. package/src/http/auth.ts +3 -1
  229. package/src/http/config.ts +34 -1
  230. package/src/http/index.ts +13 -0
  231. package/src/http/memory.ts +19 -6
  232. package/src/http/model-groups.ts +277 -0
  233. package/src/http/model-profiles.ts +30 -13
  234. package/src/http/session-data.ts +74 -23
  235. package/src/http/sessions.ts +6 -2
  236. package/src/http/tasks.ts +140 -5
  237. package/src/http/tool-hooks.ts +140 -0
  238. package/src/http/users.ts +142 -19
  239. package/src/http/workflows.ts +19 -1
  240. package/src/integrations/chat-sdk/inbound.ts +8 -2
  241. package/src/integrations/chat-sdk/limits.ts +8 -3
  242. package/src/integrations/chat-sdk/relay.ts +87 -0
  243. package/src/jira/outbound.ts +5 -3
  244. package/src/linear/outbound.ts +5 -1
  245. package/src/prompts/base-prompt.ts +8 -0
  246. package/src/prompts/session-templates.ts +19 -2
  247. package/src/providers/acp-targets.ts +2 -2
  248. package/src/providers/amp-adapter.ts +1 -1
  249. package/src/providers/claude-adapter.ts +27 -4
  250. package/src/providers/claude-flag-settings.ts +39 -1
  251. package/src/providers/codex-adapter.ts +85 -3
  252. package/src/providers/codex-app-server.ts +9 -5
  253. package/src/providers/codex-oauth/auth-json.ts +1 -0
  254. package/src/providers/pi-mono-adapter.ts +35 -2
  255. package/src/providers/pricing-sources.md +41 -0
  256. package/src/providers/types.ts +11 -0
  257. package/src/rbac/legacy-policy.ts +1 -0
  258. package/src/rbac/permissions.ts +5 -0
  259. package/src/runtime-providers/docker.ts +65 -1
  260. package/src/runtime-providers/index.ts +7 -5
  261. package/src/runtime-providers/k8s.ts +250 -0
  262. package/src/scheduler/deferred-task-waits.ts +18 -5
  263. package/src/scripts-runtime/types/stdlib.d.ts +2 -0
  264. package/src/scripts-runtime/types/swarm-extension.d.ts +24 -9
  265. package/src/scripts-runtime/types/swarm-sdk.d.ts +2 -0
  266. package/src/slack/actions.ts +79 -0
  267. package/src/slack/app.ts +22 -15
  268. package/src/slack/blocks.ts +23 -2
  269. package/src/slack/inbound-files.ts +2 -0
  270. package/src/slack/render-v2.ts +154 -23
  271. package/src/slack/responses.ts +3 -2
  272. package/src/slack/work-objects.ts +4 -1
  273. package/src/tasks/errors.ts +5 -0
  274. package/src/tests/acp-adapter.test.ts +30 -6
  275. package/src/tests/api-key-tracking.test.ts +0 -72
  276. package/src/tests/api-keys-status-model-limits.test.ts +93 -1
  277. package/src/tests/api-keys-validation.test.ts +42 -0
  278. package/src/tests/approval-card-resolution.test.ts +7 -1
  279. package/src/tests/approval-requests-notifications.test.ts +11 -1
  280. package/src/tests/apps-catalog-page-frame.test.ts +49 -0
  281. package/src/tests/apps-session-thread.test.ts +79 -0
  282. package/src/tests/base-prompt.test.ts +111 -5
  283. package/src/tests/chat-sdk-relay.test.ts +170 -2
  284. package/src/tests/check-pr-body.test.ts +43 -0
  285. package/src/tests/claude-adapter-binary.test.ts +67 -6
  286. package/src/tests/claude-flag-settings.test.ts +29 -0
  287. package/src/tests/claude-sdk-lifecycle.test.ts +5 -0
  288. package/src/tests/codex-adapter.test.ts +340 -2
  289. package/src/tests/codex-app-server.test.ts +16 -0
  290. package/src/tests/codex-oauth.test.ts +3 -1
  291. package/src/tests/codex-rate-limits.test.ts +384 -0
  292. package/src/tests/credential-check.test.ts +14 -6
  293. package/src/tests/credential-outcome-report.test.ts +20 -0
  294. package/src/tests/db-client.test.ts +146 -0
  295. package/src/tests/db-task-read-contract.test.ts +3 -0
  296. package/src/tests/db-task-write-contract.test.ts +4 -0
  297. package/src/tests/deferred-task-wake.test.ts +63 -1
  298. package/src/tests/deploy-guard.test.ts +7 -7
  299. package/src/tests/deploy-select.test.ts +83 -0
  300. package/src/tests/docker-isolation-config-guard.test.ts +29 -0
  301. package/src/tests/docs-index-footprint.test.js +11 -3
  302. package/src/tests/dreaming-gather-corrections.test.ts +467 -0
  303. package/src/tests/e2e-visuals-comment.test.ts +82 -0
  304. package/src/tests/e2e-visuals-verify-pr.test.ts +138 -0
  305. package/src/tests/event-loop-lag.test.ts +9 -7
  306. package/src/tests/extensions-example-sql-admin-only.test.ts +7 -4
  307. package/src/tests/fixtures/extensions/native-tool-recorder/hooks.ts +26 -0
  308. package/src/tests/fixtures/extensions/native-tool-recorder/manifest.json +10 -0
  309. package/src/tests/fixtures/onboard/content.compose.yml.txt +1 -1
  310. package/src/tests/fixtures/onboard/content.env.txt +1 -1
  311. package/src/tests/fixtures/onboard/dev.compose.yml.txt +1 -1
  312. package/src/tests/fixtures/onboard/dev.env.txt +1 -1
  313. package/src/tests/fixtures/onboard/full-all.compose.yml.txt +1 -1
  314. package/src/tests/fixtures/onboard/full-all.env.txt +1 -1
  315. package/src/tests/fixtures/onboard/full.compose.yml.txt +1 -1
  316. package/src/tests/fixtures/onboard/full.env.txt +1 -1
  317. package/src/tests/fixtures/onboard/research.compose.yml.txt +1 -1
  318. package/src/tests/fixtures/onboard/research.env.txt +1 -1
  319. package/src/tests/fixtures/onboard/solo.compose.yml.txt +1 -1
  320. package/src/tests/fixtures/onboard/solo.env.txt +1 -1
  321. package/src/tests/fixtures/ui-spec-slack/deploys.json +121 -0
  322. package/src/tests/fixtures/ui-spec-slack/incident.json +183 -0
  323. package/src/tests/fixtures/ui-spec-slack/three-charts-stale.json +196 -0
  324. package/src/tests/fixtures/ui-spec-slack/video-rejected-by-slack.json +183 -0
  325. package/src/tests/fixtures/ui-spec-slack/video.json +446 -0
  326. package/src/tests/github-event-filter.test.ts +8 -0
  327. package/src/tests/github-handlers-inline-comments.test.ts +2 -0
  328. package/src/tests/github-handlers-reactions.test.ts +4 -0
  329. package/src/tests/github-handlers.test.ts +3 -0
  330. package/src/tests/github-sender-trust.test.ts +223 -0
  331. package/src/tests/gitleaks-download-retry.test.ts +85 -0
  332. package/src/tests/http-users.test.ts +142 -41
  333. package/src/tests/human-thread-routing.test.ts +187 -0
  334. package/src/tests/jira-outbound-sync.test.ts +33 -1
  335. package/src/tests/k8s-pool-smoke.test.ts +190 -0
  336. package/src/tests/key-window-usage.test.ts +846 -0
  337. package/src/tests/linear-outbound-sync.test.ts +30 -1
  338. package/src/tests/memory-rater-store.test.ts +35 -1
  339. package/src/tests/memory-reranker.test.ts +39 -4
  340. package/src/tests/memory-review-recall-filter.test.ts +205 -0
  341. package/src/tests/migration-318-superseded-workflow-cut-backfill.test.ts +74 -0
  342. package/src/tests/model-groups-api.test.ts +415 -0
  343. package/src/tests/model-profiles-api.test.ts +1 -0
  344. package/src/tests/operator-granted-credentials.test.ts +7 -2
  345. package/src/tests/operator-granted-role-wire.test.ts +2 -1
  346. package/src/tests/pi-mono-adapter.test.ts +79 -0
  347. package/src/tests/preload-env.test.ts +2 -0
  348. package/src/tests/preload.ts +3 -1
  349. package/src/tests/prompt-template-session.test.ts +4 -3
  350. package/src/tests/provider-quota-persistence.test.ts +362 -0
  351. package/src/tests/rate-limit-event.test.ts +22 -0
  352. package/src/tests/rbac-engine.test.ts +1 -0
  353. package/src/tests/reasoning-events.test.ts +164 -0
  354. package/src/tests/routing-affinity-inventory.test.ts +22 -0
  355. package/src/tests/runtime-k8s-pools.test.ts +142 -0
  356. package/src/tests/runtime-pools-db.test.ts +42 -2
  357. package/src/tests/runtime-pools-http.test.ts +47 -2
  358. package/src/tests/runtime-provider-registration.test.ts +5 -14
  359. package/src/tests/runtime-providers-docker.test.ts +91 -0
  360. package/src/tests/runtime-providers-k8s.test.ts +303 -0
  361. package/src/tests/script-connections.test.ts +18 -1
  362. package/src/tests/secret-canary-sweep.test.ts +41 -5
  363. package/src/tests/seed-scripts.test.ts +23 -0
  364. package/src/tests/session-cost-attribution.test.ts +748 -0
  365. package/src/tests/session-costs.test.ts +14 -15
  366. package/src/tests/session-logs.test.ts +83 -0
  367. package/src/tests/sessions-detail-batch.test.ts +7 -0
  368. package/src/tests/short-id.test.ts +23 -0
  369. package/src/tests/slack-blocks.test.ts +69 -0
  370. package/src/tests/slack-render-v2.test.ts +411 -0
  371. package/src/tests/slack-start-reload-race.test.ts +67 -0
  372. package/src/tests/spec-base-url.test.ts +13 -1
  373. package/src/tests/subscription-plans.test.ts +20 -1
  374. package/src/tests/system-one-decide-session-cost.test.ts +196 -0
  375. package/src/tests/task-ui-action-route.test.ts +249 -0
  376. package/src/tests/task-ui-actions.test.ts +195 -0
  377. package/src/tests/task-ui-script-actions.test.ts +517 -0
  378. package/src/tests/task-ui-spec-fallback.test.ts +65 -0
  379. package/src/tests/task-ui-spec.test.ts +368 -0
  380. package/src/tests/tool-hooks-http.test.ts +187 -0
  381. package/src/tests/ui-spec-script-actions-config.test.ts +196 -0
  382. package/src/tests/user-delete-perf.test.ts +321 -0
  383. package/src/tests/user-merge-jobs.test.ts +680 -0
  384. package/src/tests/vcs-provider.test.ts +25 -5
  385. package/src/tests/vendored-openapi.test.ts +13 -1
  386. package/src/tests/workflow-agent-task-retry.test.ts +96 -1
  387. package/src/tests/workflow-foreach-supersede-retry.test.ts +10 -0
  388. package/src/tests/workflow-http-v2.test.ts +27 -0
  389. package/src/tests/workflow-replay.test.ts +10 -1
  390. package/src/tests/workflow-triggers-v2.test.ts +128 -0
  391. package/src/tests/workflow-wait-event.test.ts +109 -1
  392. package/src/tools/defer-task.ts +1 -1
  393. package/src/tools/memory-search.ts +14 -3
  394. package/src/tools/store-progress.ts +69 -3
  395. package/src/tools/swarm-config/delete-config.ts +12 -1
  396. package/src/tools/swarm-config/set-config.ts +8 -0
  397. package/src/tools/system-one-decide.ts +113 -3
  398. package/src/tools/utils.ts +4 -1
  399. package/src/tools/workflows/create-workflow.ts +2 -0
  400. package/src/tools/workflows/update-workflow.ts +3 -1
  401. package/src/types.ts +93 -4
  402. package/src/ui-spec/actions.ts +112 -0
  403. package/src/ui-spec/fallback.ts +19 -0
  404. package/src/ui-spec/schema.ts +38 -0
  405. package/src/ui-spec/script-actions.ts +340 -0
  406. package/src/ui-spec/script-allowlist.ts +48 -0
  407. package/src/ui-spec/slack.ts +17 -0
  408. package/src/ui-spec/validate.ts +169 -0
  409. package/src/utils/codex-rate-limits.ts +159 -0
  410. package/src/utils/credentials.ts +2 -0
  411. package/src/utils/error-tracker.ts +19 -0
  412. package/src/utils/provider-account-telemetry.ts +331 -0
  413. package/src/utils/reasoning-events.ts +107 -0
  414. package/src/utils/short-id.ts +20 -14
  415. package/src/utils/subscription-plans.ts +11 -59
  416. package/src/utils/task-ui-spec.ts +79 -0
  417. package/src/vcs/index.ts +12 -2
  418. package/src/workflows/executors/system-one-decision.ts +2 -2
  419. package/src/workflows/resume.ts +3 -2
  420. package/src/workflows/task-step-routing.ts +38 -13
  421. package/src/workflows/triggers.ts +35 -3
  422. package/templates/extensions/manifest.schema.json +13 -0
  423. package/templates/extensions/sql-admin-only/README.md +2 -1
  424. package/templates/extensions/sql-admin-only/hooks.ts +7 -3
  425. package/templates/extensions/sql-admin-only/manifest.json +1 -1
  426. package/templates/skills/apps/SKILL.md +32 -5
  427. package/templates/skills/apps/content.md +32 -5
  428. package/templates/skills/swarm-docs/content.md +2 -0
  429. package/templates/skills/ui-spec/config.json +14 -0
  430. package/templates/skills/ui-spec/content.md +133 -0
  431. package/templates/workflows/dreaming/content.md +1 -1
  432. package/dist/acp-adapter-jqn86aam.js +0 -16
  433. package/dist/cli-7831nhaw.js +0 -93
  434. package/dist/cli-srtkr1h2.js +0 -12078
  435. package/dist/fx-adapter-0zrkfbkd.js +0 -19
  436. package/dist/grok-adapter-3db1c538.js +0 -19
  437. package/dist/handlers-k22n8mnn.js +0 -33
  438. package/dist/index-8xcyd3mc.js +0 -33
  439. package/dist/index-9sy2bh6n.js +0 -38
  440. package/dist/index-b24j7t2m.js +0 -12797
  441. package/dist/index-wjd56k1v.js +0 -34
  442. package/dist/lead-atxf3q6e.js +0 -72
  443. package/dist/thread-buffer-4yz236d0.js +0 -36
  444. package/dist/worker-p4hbtcy3.js +0 -72
  445. package/dist/{azure-openai-responses-590s1eea.js → azure-openai-responses-b3y7fz36.js} +8 -8
  446. package/dist/{cli-j49yqpvh.js → cli-7evph51z.js} +3 -3
  447. package/dist/{cli-g0vv9dg4.js → cli-8y43jx2r.js} +8 -8
  448. package/dist/{cli-m0cy2vyf.js → cli-k6nejceb.js} +4 -4
  449. package/dist/{mistral-conversations-0c30em7t.js → mistral-conversations-tm2vd4gc.js} +8 -8
  450. package/dist/{openai-codex-responses-bkcd8pjj.js → openai-codex-responses-sxjv60xx.js} +4 -4
  451. package/dist/{openai-completions-f3n69rep.js → openai-completions-0c7qnhsx.js} +20 -20
  452. package/dist/{openai-responses-gbh0wfqe.js → openai-responses-a7h29chp.js} +15 -15
  453. package/dist/{pi-messages-zebyt7gb.js → pi-messages-2j0fpqwq.js} +5 -5
@@ -0,0 +1,196 @@
1
+ /**
2
+ * `UI_SPEC_SCRIPT_ACTIONS` is human-only: only an admin user may write or
3
+ * delete it. The operator key (held by every worker), agents (the Lead
4
+ * included), guests and page sessions are refused, on the HTTP routes, the
5
+ * HITL config answer path and MCP tools.
6
+ */
7
+ import { afterAll, beforeAll, describe, expect, spyOn, test } from "bun:test";
8
+ import { createServer, type Server } from "node:http";
9
+ import { closeDb, createAgent, createUser, initDb, upsertSwarmConfig } from "../be/db";
10
+ import { attachRole, setUserRoles } from "../be/rbac-roles";
11
+ import { validateConfigValue } from "../be/swarm-config-guard";
12
+ import { findUserById } from "../be/users";
13
+ import { handleApprovalRequests } from "../http/approval-requests";
14
+ import { handleConfig } from "../http/config";
15
+ import * as core from "../http/core";
16
+ import { getPathSegments, parseQueryParams } from "../http/utils";
17
+ import { registerDeleteConfigTool } from "../tools/swarm-config/delete-config";
18
+ import { registerSetConfigTool } from "../tools/swarm-config/set-config";
19
+ import { setRequestAuth } from "../utils/request-auth-context";
20
+ import { listenOnFreePort } from "./test-net";
21
+
22
+ const KEY = "UI_SPEC_SCRIPT_ACTIONS";
23
+ const PIN = "github-metrics@0123456789abcdef";
24
+ const LEAD_ID = "22222222-2222-4222-8222-222222222222";
25
+
26
+ type ToolResult = { structuredContent?: { success?: boolean; message?: string } };
27
+ const tools = new Map<string, (args: unknown, meta: unknown) => Promise<ToolResult>>();
28
+ const mcp = {
29
+ registerTool(
30
+ name: string,
31
+ _config: unknown,
32
+ handler: (a: unknown, m: unknown) => Promise<ToolResult>,
33
+ ) {
34
+ tools.set(name, handler);
35
+ return { name };
36
+ },
37
+ };
38
+
39
+ let server: Server;
40
+ let baseUrl: string;
41
+ let adminId = "";
42
+ let plainUserId = "";
43
+ const reloadSpy = spyOn(core, "scheduleIntegrationsReload").mockImplementation(() => {});
44
+ const PAGE_ERROR = "cannot be changed from a page session";
45
+
46
+ beforeAll(async () => {
47
+ initDb(":memory:");
48
+ await createAgent({ id: LEAD_ID, name: "lead", isLead: true, status: "idle", capabilities: [] });
49
+ adminId = (await createUser({ name: "Admin" })).id;
50
+ await attachRole(adminId, "admin");
51
+ plainUserId = (await createUser({ name: "Requester" })).id;
52
+ await setUserRoles(plainUserId, ["requester"], adminId);
53
+ registerSetConfigTool(mcp as never);
54
+ registerDeleteConfigTool(mcp as never);
55
+
56
+ server = createServer(async (req, res) => {
57
+ // `x-test-user-id` makes a user principal (`x-test-page` binds it to a page
58
+ // session, as auth.ts does for a uid cookie), `x-test-guest` a guest; else
59
+ // the operator key.
60
+ const userId = req.headers["x-test-user-id"] as string | undefined;
61
+ if (userId) {
62
+ const user = await findUserById(userId);
63
+ const page = req.headers["x-test-page"]
64
+ ? { page: { id: "p1", executionAgentId: LEAD_ID } }
65
+ : {};
66
+ setRequestAuth(req, user ? { kind: "user", userId: user.id, user, ...page } : null);
67
+ } else if (req.headers["x-test-guest"]) {
68
+ setRequestAuth(req, { kind: "guest" });
69
+ } else {
70
+ setRequestAuth(req, { kind: "operator", fingerprint: "config-guard-test" });
71
+ }
72
+ const segments = getPathSegments(req.url ?? "");
73
+ const query = parseQueryParams(req.url ?? "");
74
+ if (await handleConfig(req, res, segments, query)) return;
75
+ if (await handleApprovalRequests(req, res, segments, query)) return;
76
+ res.writeHead(404).end();
77
+ });
78
+ baseUrl = `http://127.0.0.1:${await listenOnFreePort(server)}`;
79
+ });
80
+
81
+ afterAll(async () => {
82
+ reloadSpy.mockRestore();
83
+ await new Promise<void>((resolve) => server.close(() => resolve()));
84
+ closeDb();
85
+ });
86
+
87
+ function put(headers: Record<string, string>, value = PIN) {
88
+ return fetch(`${baseUrl}/api/config`, {
89
+ method: "PUT",
90
+ headers: { "Content-Type": "application/json", ...headers },
91
+ body: JSON.stringify({ scope: "global", key: KEY, value }),
92
+ });
93
+ }
94
+
95
+ describe("UI_SPEC_SCRIPT_ACTIONS value", () => {
96
+ test("accepts name@hash pins of 12 to 64 hex chars", () => {
97
+ expect(validateConfigValue(KEY, "")).toBeNull();
98
+ expect(validateConfigValue(KEY, `${PIN}, other@${"a".repeat(64)}`)).toBeNull();
99
+ });
100
+
101
+ test("rejects a bare name, a short hash and a non-hex hash", () => {
102
+ expect(validateConfigValue(KEY, "github-metrics")).toContain("name@<contentHash>");
103
+ expect(validateConfigValue(KEY, "github-metrics@0123abc")).toContain("at least 12 hex");
104
+ expect(validateConfigValue(KEY, "github-metrics@zzzzzzzzzzzzzz")).toContain("name@");
105
+ });
106
+ });
107
+
108
+ describe("PUT and DELETE /api/config", () => {
109
+ test("the operator key is refused, even naming the lead", async () => {
110
+ for (const headers of [{}, { "X-Agent-ID": LEAD_ID }]) {
111
+ const response = await put(headers);
112
+ expect(response.status).toBe(403);
113
+ expect(await response.text()).toContain("can only be changed by an admin user");
114
+ }
115
+ });
116
+
117
+ test("a guest and a non-admin user are refused", async () => {
118
+ expect((await put({ "x-test-guest": "1" })).status).toBe(403);
119
+ expect((await put({ "x-test-user-id": plainUserId })).status).toBe(403);
120
+ });
121
+
122
+ test("an admin user writes it, and an invalid value is refused", async () => {
123
+ const response = await put({ "x-test-user-id": adminId });
124
+ expect(response.status).toBe(200);
125
+ expect(((await response.json()) as { value: string }).value).toBe(PIN);
126
+ expect((await put({ "x-test-user-id": adminId }, "github-metrics")).status).toBe(400);
127
+ });
128
+
129
+ test("an admin's page session is refused, with its own message", async () => {
130
+ const response = await put({ "x-test-user-id": adminId, "x-test-page": "1" });
131
+ expect(response.status).toBe(403);
132
+ expect(await response.text()).toContain(PAGE_ERROR);
133
+ });
134
+
135
+ test("an admin's page session cannot delete it", async () => {
136
+ const row = await upsertSwarmConfig({ scope: "global", key: KEY, value: PIN });
137
+ const response = await fetch(`${baseUrl}/api/config/${row.id}`, {
138
+ method: "DELETE",
139
+ headers: { "x-test-user-id": adminId, "x-test-page": "1" },
140
+ });
141
+ expect(response.status).toBe(403);
142
+ expect(await response.text()).toContain(PAGE_ERROR);
143
+ });
144
+
145
+ test("only an admin user deletes it", async () => {
146
+ const row = await upsertSwarmConfig({ scope: "global", key: KEY, value: PIN });
147
+ const del = (headers: Record<string, string>) =>
148
+ fetch(`${baseUrl}/api/config/${row.id}`, { method: "DELETE", headers });
149
+ expect((await del({})).status).toBe(403);
150
+ expect((await del({ "x-test-user-id": adminId })).status).toBe(200);
151
+ });
152
+ });
153
+
154
+ describe("set-config and delete-config tools", () => {
155
+ const meta = { requestInfo: { headers: { "x-agent-id": LEAD_ID } } };
156
+
157
+ test("the lead cannot set it", async () => {
158
+ const result = await tools.get("set-config")!({ scope: "global", key: KEY, value: PIN }, meta);
159
+ expect(result.structuredContent?.success).toBe(false);
160
+ expect(result.structuredContent?.message).toContain("can only be changed by an admin user");
161
+ });
162
+
163
+ test("the lead cannot delete it", async () => {
164
+ const row = await upsertSwarmConfig({ scope: "global", key: KEY, value: PIN });
165
+ const result = await tools.get("delete-config")!({ id: row.id }, meta);
166
+ expect(result.structuredContent?.success).toBe(false);
167
+ expect(result.structuredContent?.message).toContain("can only be changed by an admin user");
168
+ });
169
+ });
170
+
171
+ describe("HITL config answer", () => {
172
+ test("an admin's page session cannot set it; the admin can", async () => {
173
+ const created = await fetch(`${baseUrl}/api/approval-requests`, {
174
+ method: "POST",
175
+ headers: { "Content-Type": "application/json" },
176
+ body: JSON.stringify({
177
+ title: "Pin a card script",
178
+ approvers: { policy: "any" },
179
+ questions: [{ id: "cfg", type: "config", config: { key: KEY, scope: "global" } }],
180
+ }),
181
+ });
182
+ expect(created.status).toBe(201);
183
+ const { approvalRequest } = (await created.json()) as { approvalRequest: { id: string } };
184
+ const answer = (headers: Record<string, string>) =>
185
+ fetch(`${baseUrl}/api/approval-requests/${approvalRequest.id}/respond`, {
186
+ method: "POST",
187
+ headers: { "Content-Type": "application/json", ...headers },
188
+ body: JSON.stringify({ responses: { cfg: { action: "set", value: PIN } } }),
189
+ });
190
+
191
+ const fromPage = await answer({ "x-test-user-id": adminId, "x-test-page": "1" });
192
+ expect(fromPage.status).toBe(403);
193
+ expect(await fromPage.text()).toContain(PAGE_ERROR);
194
+ expect((await answer({ "x-test-user-id": adminId })).status).toBe(200);
195
+ });
196
+ });
@@ -0,0 +1,321 @@
1
+ import { Database } from "bun:sqlite";
2
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
3
+ import { unlinkSync } from "node:fs";
4
+ import {
5
+ closeDb,
6
+ createUser,
7
+ createWorkflow,
8
+ createWorkflowRun,
9
+ deleteUser,
10
+ getDbClient,
11
+ getWorkflowRun,
12
+ initDb,
13
+ updateWorkflowRun,
14
+ } from "../be/db";
15
+ import {
16
+ USER_REFERENCE_COLUMNS_SQL,
17
+ type UserReferenceRow,
18
+ userReferenceRewriteSql,
19
+ WORKFLOW_CONTEXT_REMOVE_REQUESTER_SQL,
20
+ WORKFLOW_CONTEXT_SET_REQUESTER_SQL,
21
+ WORKFLOW_SEALED_CONTEXT_BY_REQUESTER_SQL,
22
+ } from "../be/db/user-references";
23
+ import { openSealedJson } from "../be/sealed-json";
24
+
25
+ // Incident 2026-11-09: merging two users ran deleteUser on an 85 GB prod DB
26
+ // and every UPDATE on the large audit tables scanned the full table while the
27
+ // workflow_runs JSON passes parsed the context of all 493k rows. The API froze
28
+ // for 278 s. Migration 319 indexes the user FK columns and the context
29
+ // requester expression. These tests explain the exact statements deleteUser
30
+ // runs (src/be/db/user-references.ts) and pin every plan to an index.
31
+
32
+ const TEST_DB_PATH = `./test-user-delete-perf-${crypto.randomUUID()}.sqlite`;
33
+
34
+ interface ExplainRow {
35
+ detail: string;
36
+ }
37
+
38
+ /** Table/column pairs that dominated the incident timings. */
39
+ const HEAVY_COLUMNS: Array<[table: string, column: string]> = [
40
+ ["workflow_runs", "created_by"],
41
+ ["workflow_runs", "updated_by"],
42
+ ["workflow_run_steps", "created_by"],
43
+ ["workflow_run_steps", "updated_by"],
44
+ ["script_runs", "created_by"],
45
+ ["script_runs", "updated_by"],
46
+ ["script_runs", "requestedByUserId"],
47
+ ["kv_entries", "created_by"],
48
+ ["kv_entries", "updated_by"],
49
+ ["page_versions", "created_by"],
50
+ ["page_versions", "updated_by"],
51
+ ["agent_memory", "created_by"],
52
+ ["agent_memory", "updated_by"],
53
+ ["asset_key_history", "changed_by"],
54
+ ];
55
+
56
+ async function explain(sql: string, params: string[]): Promise<string> {
57
+ const rows = await getDbClient().query<ExplainRow>(`EXPLAIN QUERY PLAN ${sql}`, params);
58
+ return rows.map((row) => row.detail).join(" | ");
59
+ }
60
+
61
+ /**
62
+ * Records every statement the process sends to bun:sqlite while fn runs. The
63
+ * db client funnels get / query / run through Database.prototype.query, so
64
+ * this sees the SQL deleteUser executes, not a copy of it.
65
+ */
66
+ async function recordStatements(fn: () => Promise<void>): Promise<string[]> {
67
+ const seen: string[] = [];
68
+ const original = Database.prototype.query;
69
+ Database.prototype.query = function patched(this: Database, sql: string, ...rest: unknown[]) {
70
+ seen.push(sql);
71
+ return (original as (this: Database, sql: string, ...rest: unknown[]) => unknown).call(
72
+ this,
73
+ sql,
74
+ ...rest,
75
+ );
76
+ } as typeof Database.prototype.query;
77
+ try {
78
+ await fn();
79
+ } finally {
80
+ Database.prototype.query = original;
81
+ }
82
+ return seen;
83
+ }
84
+
85
+ /** Explains a recorded statement with one placeholder value per `?`. */
86
+ async function explainRecorded(sql: string): Promise<string[]> {
87
+ const params = Array.from({ length: (sql.match(/\?/g) ?? []).length }, () => "x");
88
+ const rows = await getDbClient().query<ExplainRow>(`EXPLAIN QUERY PLAN ${sql}`, params);
89
+ return rows.map((row) => row.detail);
90
+ }
91
+
92
+ async function runRequestedBy(
93
+ userId: string,
94
+ opts: { createdBy?: string | null } = {},
95
+ ): Promise<string> {
96
+ const workflow = await createWorkflow({
97
+ name: `delete-perf-${crypto.randomUUID()}`,
98
+ definition: { nodes: [] },
99
+ });
100
+ const runId = crypto.randomUUID();
101
+ await createWorkflowRun({
102
+ id: runId,
103
+ workflowId: workflow.id,
104
+ triggerType: "manual",
105
+ createdBy: opts.createdBy === undefined ? userId : (opts.createdBy ?? undefined),
106
+ });
107
+ await updateWorkflowRun(runId, {
108
+ status: "running",
109
+ context: { swarm: { requestedByUserId: userId }, input: { key: "value" } },
110
+ });
111
+ return runId;
112
+ }
113
+
114
+ async function storedColumns(
115
+ runId: string,
116
+ ): Promise<{ created_by: string | null; context: string; context_replay: string }> {
117
+ const row = await getDbClient().get<{
118
+ created_by: string | null;
119
+ context: string;
120
+ context_replay: string;
121
+ }>("SELECT created_by, context, context_replay FROM workflow_runs WHERE id = ?", [runId]);
122
+ if (!row) throw new Error(`run ${runId} missing`);
123
+ return row;
124
+ }
125
+
126
+ beforeAll(() => {
127
+ initDb(TEST_DB_PATH);
128
+ });
129
+
130
+ afterAll(() => {
131
+ closeDb();
132
+ for (const suffix of ["", "-wal", "-shm"]) {
133
+ try {
134
+ unlinkSync(`${TEST_DB_PATH}${suffix}`);
135
+ } catch {
136
+ // ignore
137
+ }
138
+ }
139
+ });
140
+
141
+ describe("deleteUser query plans", () => {
142
+ test("the discovery query returns every heavy column", async () => {
143
+ const references = await getDbClient().query<UserReferenceRow>(USER_REFERENCE_COLUMNS_SQL);
144
+ const pairs = new Set(references.map((r) => `${r.tableName}.${r.columnName}`));
145
+ for (const [table, column] of HEAVY_COLUMNS) {
146
+ expect(pairs.has(`${table}.${column}`)).toBe(true);
147
+ }
148
+ });
149
+
150
+ test("every write statement a real deleteUser executes searches an index", async () => {
151
+ const source = await createUser({ name: "spy source" });
152
+ const target = await createUser({ name: "spy target" });
153
+ await runRequestedBy(source.id);
154
+ const references = await getDbClient().query<UserReferenceRow>(USER_REFERENCE_COLUMNS_SQL);
155
+
156
+ const statements = await recordStatements(async () => {
157
+ expect(await deleteUser(source.id, target.id)).toBe(true);
158
+ });
159
+
160
+ const rewrites = statements.filter((sql) => /^\s*UPDATE\s/i.test(sql));
161
+ const sealedSelects = statements.filter((sql) => /context_replay FROM workflow_runs/.test(sql));
162
+ const deletes = statements.filter((sql) => /^\s*DELETE FROM users\b/i.test(sql));
163
+ // Every discovered column, the context json_set, and the sealed replay copy.
164
+ expect(rewrites.length).toBeGreaterThanOrEqual(references.length + 2);
165
+ expect(sealedSelects.length).toBe(1);
166
+ expect(deletes.length).toBe(1);
167
+
168
+ const scans: string[] = [];
169
+ for (const sql of [...rewrites, ...sealedSelects, ...deletes]) {
170
+ const plan = await explainRecorded(sql);
171
+ if (plan.some((detail) => detail.startsWith("SCAN"))) {
172
+ scans.push(`${sql.replace(/\s+/g, " ").trim().slice(0, 120)} => ${plan.join(" | ")}`);
173
+ }
174
+ }
175
+ expect(scans).toEqual([]);
176
+ expect(
177
+ sealedSelects.concat(rewrites.filter((sql) => /json_set|json_remove/.test(sql))).length,
178
+ ).toBe(2);
179
+ });
180
+
181
+ test("every discovered column rewrite searches an index", async () => {
182
+ const references = await getDbClient().query<UserReferenceRow>(USER_REFERENCE_COLUMNS_SQL);
183
+ expect(references.length).toBeGreaterThan(HEAVY_COLUMNS.length);
184
+ const scans: string[] = [];
185
+ for (const reference of references) {
186
+ const detail = await explain(userReferenceRewriteSql(reference), ["replacement", "source"]);
187
+ if (!/SEARCH \S+ USING (COVERING )?INDEX/.test(detail) || /\bSCAN\b/.test(detail)) {
188
+ scans.push(`${reference.tableName}.${reference.columnName}: ${detail}`);
189
+ }
190
+ }
191
+ expect(scans).toEqual([]);
192
+ });
193
+
194
+ for (const [table, column] of HEAVY_COLUMNS) {
195
+ test(`UPDATE ${table}.${column} uses idx_${table}_${column}`, async () => {
196
+ const detail = await explain(
197
+ userReferenceRewriteSql({ tableName: table, columnName: column }),
198
+ ["replacement", "source"],
199
+ );
200
+ expect(detail).toMatch(
201
+ new RegExp(`SEARCH ${table} USING (COVERING )?INDEX idx_${table}_${column}`),
202
+ );
203
+ });
204
+ }
205
+
206
+ test("the sealed-context SELECT searches the context requester index", async () => {
207
+ const detail = await explain(WORKFLOW_SEALED_CONTEXT_BY_REQUESTER_SQL, ["source"]);
208
+ expect(detail).toMatch(/SEARCH workflow_runs USING INDEX idx_workflow_runs_context_requester/);
209
+ expect(detail).not.toMatch(/SCAN workflow_runs/);
210
+ });
211
+
212
+ test("the context json_set and json_remove UPDATEs search the context requester index", async () => {
213
+ for (const [sql, params] of [
214
+ [WORKFLOW_CONTEXT_SET_REQUESTER_SQL, ["replacement", "source"]],
215
+ [WORKFLOW_CONTEXT_REMOVE_REQUESTER_SQL, ["source"]],
216
+ ] as const) {
217
+ const detail = await explain(sql, [...params]);
218
+ expect(detail).toMatch(
219
+ /SEARCH workflow_runs USING INDEX idx_workflow_runs_context_requester/,
220
+ );
221
+ expect(detail).not.toMatch(/SCAN workflow_runs/);
222
+ }
223
+ });
224
+
225
+ test("DELETE FROM users runs its FK parent-delete checks without a table scan", async () => {
226
+ // A partial index with an unrelated predicate does not count: session_shares_user
227
+ // (migration 230, WHERE revokedAt IS NULL) left SCAN session_shares in this plan
228
+ // until migration 319 added idx_session_shares_userId.
229
+ const rows = await getDbClient().query<ExplainRow>(
230
+ "EXPLAIN QUERY PLAN DELETE FROM users WHERE id = ?",
231
+ ["source"],
232
+ );
233
+ const scans = rows.map((row) => row.detail).filter((detail) => detail.startsWith("SCAN"));
234
+ expect(scans).toEqual([]);
235
+ });
236
+ });
237
+
238
+ describe("deleteUser workflow context rewrite", () => {
239
+ test("a merge rewrites created_by, context and the sealed replay copy to the replacement", async () => {
240
+ const source = await createUser({ name: "merge source" });
241
+ const target = await createUser({ name: "merge target" });
242
+ const bystander = await createUser({ name: "bystander" });
243
+ const runId = await runRequestedBy(source.id);
244
+ const otherRunId = await runRequestedBy(bystander.id);
245
+
246
+ expect(await deleteUser(source.id, target.id)).toBe(true);
247
+
248
+ const stored = await storedColumns(runId);
249
+ expect(stored.created_by).toBe(target.id);
250
+ expect(JSON.parse(stored.context).swarm).toEqual({ requestedByUserId: target.id });
251
+ expect((openSealedJson(stored.context_replay) as { swarm: unknown }).swarm).toEqual({
252
+ requestedByUserId: target.id,
253
+ });
254
+ expect((await getWorkflowRun(runId))?.context?.swarm).toEqual({
255
+ requestedByUserId: target.id,
256
+ });
257
+
258
+ const other = await storedColumns(otherRunId);
259
+ expect(other.created_by).toBe(bystander.id);
260
+ expect(JSON.parse(other.context).swarm).toEqual({ requestedByUserId: bystander.id });
261
+ });
262
+
263
+ test("a merge rewrites the context requester even when created_by names another user or nobody", async () => {
264
+ // created_by and context.swarm.requestedByUserId can disagree: legacy runs
265
+ // predate created_by, and a node whose id is "swarm" can overwrite ctx.swarm.
266
+ // The rewrite must find the run through the context, not through created_by.
267
+ const source = await createUser({ name: "context-only source" });
268
+ const target = await createUser({ name: "context-only target" });
269
+ const creator = await createUser({ name: "different creator" });
270
+ const legacyRunId = await runRequestedBy(source.id, { createdBy: null });
271
+ const mismatchRunId = await runRequestedBy(source.id, { createdBy: creator.id });
272
+
273
+ expect(await deleteUser(source.id, target.id)).toBe(true);
274
+
275
+ for (const runId of [legacyRunId, mismatchRunId]) {
276
+ const stored = await storedColumns(runId);
277
+ expect(JSON.parse(stored.context).swarm).toEqual({ requestedByUserId: target.id });
278
+ expect((openSealedJson(stored.context_replay) as { swarm: unknown }).swarm).toEqual({
279
+ requestedByUserId: target.id,
280
+ });
281
+ }
282
+ expect((await storedColumns(legacyRunId)).created_by).toBeNull();
283
+ expect((await storedColumns(mismatchRunId)).created_by).toBe(creator.id);
284
+ });
285
+
286
+ test("a delete without a replacement clears created_by and removes the requester from both copies", async () => {
287
+ const source = await createUser({ name: "plain delete" });
288
+ const runId = await runRequestedBy(source.id);
289
+
290
+ expect(await deleteUser(source.id)).toBe(true);
291
+
292
+ const stored = await storedColumns(runId);
293
+ expect(stored.created_by).toBeNull();
294
+ const context = JSON.parse(stored.context);
295
+ expect(context.swarm).toEqual({});
296
+ expect(context.input).toEqual({ key: "value" });
297
+ const replay = openSealedJson(stored.context_replay) as { swarm: Record<string, unknown> };
298
+ expect(replay.swarm).toEqual({});
299
+ expect((await getWorkflowRun(runId))?.context?.swarm).toEqual({});
300
+ });
301
+
302
+ test("a run with malformed context JSON neither breaks the indexed lookup nor matches it", async () => {
303
+ const source = await createUser({ name: "malformed neighbour source" });
304
+ const target = await createUser({ name: "malformed neighbour target" });
305
+ const runId = await runRequestedBy(source.id);
306
+ const brokenRunId = await runRequestedBy(source.id);
307
+ // Bypass the API so the stored context is not valid JSON; the CASE guard in
308
+ // the index expression must yield NULL here instead of raising.
309
+ await getDbClient().run("UPDATE workflow_runs SET context = ? WHERE id = ?", [
310
+ "{not json",
311
+ brokenRunId,
312
+ ]);
313
+
314
+ expect(await deleteUser(source.id, target.id)).toBe(true);
315
+
316
+ expect(JSON.parse((await storedColumns(runId)).context).swarm).toEqual({
317
+ requestedByUserId: target.id,
318
+ });
319
+ expect((await storedColumns(brokenRunId)).context).toBe("{not json");
320
+ });
321
+ });