@desplega.ai/agent-swarm 2.12.0 → 2.13.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 (327) hide show
  1. package/dist/acp-adapter-cn53011z.js +17 -0
  2. package/dist/{acp-targets-311gcyvw.js → acp-targets-86f0sh6g.js} +9 -8
  3. package/dist/{actions-c4chgxp6.js → actions-zv8vcxvr.js} +24 -23
  4. package/dist/{agent-fs-provision-0b9awm5n.js → agent-fs-provision-jqshb33y.js} +4 -4
  5. package/dist/{amp-adapter-r0veq6x5.js → amp-adapter-gt503ywc.js} +2 -2
  6. package/dist/{app-hn5fftf5.js → app-6t4k5rh1.js} +6 -4
  7. package/dist/{approval-notifications-3g6yc8nv.js → approval-notifications-fcfw063h.js} +7 -6
  8. package/dist/{assistant-cpjgpjvp.js → assistant-9dzybh12.js} +25 -24
  9. package/dist/{boot-args-schema-hce1av1h.js → boot-args-schema-xzfp2feg.js} +1 -1
  10. package/dist/{boot-reembed-d7xcym0j.js → boot-reembed-3jz0p2jk.js} +1 -1
  11. package/dist/{boot-reembed-bztbxc4z.js → boot-reembed-r88wngfg.js} +5 -2
  12. package/dist/{boot-scrub-sweep-mkmm16gk.js → boot-scrub-sweep-scrqhw48.js} +2 -2
  13. package/dist/{boot-seeds-arrkbe8t.js → boot-seeds-vb2dcrrb.js} +4 -4
  14. package/dist/{claude-adapter-ykpyr5p8.js → claude-adapter-h3mp9hgs.js} +7 -6
  15. package/dist/{claude-managed-adapter-ssg6z4bt.js → claude-managed-adapter-kpbyj2vb.js} +3 -3
  16. package/dist/{claude-managed-setup-trd59v7b.js → claude-managed-setup-0efr3wkg.js} +5 -5
  17. package/dist/{claude-sdk-session-yjcze0j1.js → claude-sdk-session-03dw669q.js} +7 -6
  18. package/dist/{cli-e3ahxq5y.js → cli-0b655smz.js} +4 -4
  19. package/dist/{cli-mcymtvwn.js → cli-0dg7ytxm.js} +89 -11
  20. package/dist/cli-0jkenasr.js +148 -0
  21. package/dist/{cli-c7j31hq9.js → cli-0pazkmd4.js} +3 -3
  22. package/dist/{cli-5tg94mdw.js → cli-117g15t4.js} +8 -11
  23. package/dist/{cli-r14ac1y0.js → cli-1dbv9mj9.js} +1 -1
  24. package/dist/{cli-q8tc22bj.js → cli-1v82d2w6.js} +3 -3
  25. package/dist/{cli-pe3yxedk.js → cli-2jk4s7z1.js} +2 -2
  26. package/dist/{cli-0pp1yjg2.js → cli-2skf1mdf.js} +8 -8
  27. package/dist/{cli-2tw284hj.js → cli-48nvk6sb.js} +1 -1
  28. package/dist/{cli-en6dmkxd.js → cli-49f5jyhh.js} +2 -2
  29. package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
  30. package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
  31. package/dist/{cli-yegz2g06.js → cli-6h88mn9q.js} +3 -3
  32. package/dist/{cli-52nfye5j.js → cli-7dbhnsj9.js} +23 -15
  33. package/dist/{cli-04zc3f7b.js → cli-9fsagra4.js} +1 -1
  34. package/dist/{cli-nja15knq.js → cli-9m9kyw77.js} +3 -3
  35. package/dist/{cli-k5jx8jya.js → cli-ajjvqhf3.js} +1 -1
  36. package/dist/{cli-hbvgzjq4.js → cli-avqkr20b.js} +2 -2
  37. package/dist/{cli-yfpc6qy9.js → cli-avxh26pd.js} +46 -15
  38. package/dist/{cli-q2dywc8h.js → cli-b2jh3dyb.js} +4 -4
  39. package/dist/{cli-m5qtmrbc.js → cli-c8v2yvej.js} +2 -2
  40. package/dist/{cli-gfy6hbd9.js → cli-ct8sz3np.js} +17 -10
  41. package/dist/{cli-bz97ff9n.js → cli-dka73bak.js} +1 -1
  42. package/dist/{cli-dkvtfgn4.js → cli-dkejt425.js} +75 -16
  43. package/dist/{cli-sv2r3bw8.js → cli-dnh64e8e.js} +2 -2
  44. package/dist/{cli-kwr5qv5g.js → cli-eb279wn3.js} +2 -2
  45. package/dist/{cli-hhc47ack.js → cli-f1952kjy.js} +2 -2
  46. package/dist/{cli-5z0g0e8v.js → cli-f8rcvf2x.js} +49 -13
  47. package/dist/{cli-eq4kew31.js → cli-fhvk2nvp.js} +24 -11
  48. package/dist/{cli-xf4z5bdn.js → cli-fz9pcjsw.js} +2 -2
  49. package/dist/{cli-fxd1mwtr.js → cli-g6j6ac3h.js} +1 -1
  50. package/dist/{cli-ya3kf4gs.js → cli-gfcv679k.js} +1 -1
  51. package/dist/{cli-55tc8cj4.js → cli-hbq0kwxz.js} +4 -4
  52. package/dist/{cli-39qm0rtm.js → cli-hc6e4tac.js} +28 -149
  53. package/dist/{cli-j5gtytvg.js → cli-hgsxnjyg.js} +13 -10
  54. package/dist/{cli-h70a2mxy.js → cli-hpb9x72z.js} +48 -8
  55. package/dist/{cli-7yn42w6m.js → cli-j53hpbsm.js} +1 -1
  56. package/dist/{cli-12vek61e.js → cli-jj3c5nyb.js} +471 -119
  57. package/dist/{cli-fy4gb74g.js → cli-kde4ky90.js} +1 -1
  58. package/dist/{cli-9qe5y107.js → cli-kspxjftk.js} +1 -1
  59. package/dist/{cli-bp6k9acz.js → cli-mh7pdxe0.js} +16 -16
  60. package/dist/{cli-v9ya390t.js → cli-mz34pxbk.js} +8 -8
  61. package/dist/{cli-ma9ys8rt.js → cli-nc6a8b5b.js} +7 -4
  62. package/dist/{cli-1htmtqc2.js → cli-prf7kz78.js} +49 -49
  63. package/dist/{cli-01tvvtad.js → cli-qec9bynj.js} +3 -3
  64. package/dist/{cli-t75xngj1.js → cli-qhhb30e8.js} +7 -7
  65. package/dist/{cli-73q4g5nx.js → cli-qm3ntjqs.js} +12 -12
  66. package/dist/{cli-tm60vtax.js → cli-rfejbpe1.js} +1 -1
  67. package/dist/{cli-agjbj5x0.js → cli-sdh61g52.js} +37 -19
  68. package/dist/{cli-9y4tgrkf.js → cli-skd2c4ej.js} +2 -1
  69. package/dist/{cli-5x03v6en.js → cli-sq913bh1.js} +8 -8
  70. package/dist/{cli-b93d81yg.js → cli-t35hx078.js} +1 -1
  71. package/dist/{cli-r0mz92by.js → cli-tn91wc6e.js} +1 -1
  72. package/dist/{cli-wvjqaqcp.js → cli-tstj6e8e.js} +1113 -227
  73. package/dist/{cli-xm34qj8m.js → cli-w14j2z4k.js} +2 -2
  74. package/dist/{cli-eqq0hwvx.js → cli-wndegmns.js} +1 -1
  75. package/dist/{cli-0k1a0sde.js → cli-wrhbym01.js} +6 -6
  76. package/dist/{cli-fyaq4zdv.js → cli-wv20kbr3.js} +6 -6
  77. package/dist/{cli-mq2fbgva.js → cli-wxwv3t11.js} +2 -2
  78. package/dist/{cli-krbcr00p.js → cli-xfjn2kyq.js} +58 -4
  79. package/dist/{cli-5r95eqbh.js → cli-y260hgep.js} +1 -1
  80. package/dist/{cli-cjqyse9q.js → cli-y4a4458j.js} +3 -3
  81. package/dist/{cli-2amwhyv2.js → cli-y518qkjg.js} +5 -3
  82. package/dist/{cli-0vcqcwfn.js → cli-yfvhvw8m.js} +2 -0
  83. package/dist/cli-yn4kt85g.js +148 -0
  84. package/dist/{cli-n8f0fs3c.js → cli-ytc7fpza.js} +8 -8
  85. package/dist/{cli-e8n0hdzd.js → cli-z64t9pe6.js} +1 -1
  86. package/dist/{cli-72yms3ey.js → cli-zqmmy073.js} +198 -18
  87. package/dist/cli.js +18 -16
  88. package/dist/{codex-adapter-wc6e4wct.js → codex-adapter-f3yp0kaj.js} +5 -5
  89. package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
  90. package/dist/{codex-session-runner-ppfgjd97.js → codex-session-runner-ns4mv70p.js} +5 -5
  91. package/dist/{commands-tsv2vx5b.js → commands-5bzf2tfw.js} +3 -3
  92. package/dist/{controller-ye4sdwsy.js → controller-5xt7kvfm.js} +2 -2
  93. package/dist/{controllers-connect-zn4dg69h.js → controllers-connect-0gg13mzp.js} +24 -23
  94. package/dist/core-0fqtbrxa.js +42 -0
  95. package/dist/{cursor-adapter-q2g9vwts.js → cursor-adapter-p0c5zv6r.js} +1 -1
  96. package/dist/{db-g111qn9j.js → db-2s68ycq7.js} +3 -3
  97. package/dist/{db-3r1fyr2n.js → db-q7q639k5.js} +4 -2
  98. package/dist/{dispatcher-4q8s0mx8.js → dispatcher-j2y1q7ae.js} +24 -21
  99. package/dist/{dsh-adapter-mmcw1z5s.js → dsh-adapter-pgnkf4st.js} +1 -1
  100. package/dist/{easter-egg-3d-04ke6hcp.js → easter-egg-3d-0kea97jf.js} +1 -1
  101. package/dist/{embedding-space-kcdn52vz.js → embedding-space-3n6mhhmy.js} +6 -6
  102. package/dist/{embeddings-jnzcd91a.js → embeddings-jfmj6yme.js} +1 -1
  103. package/dist/{execute-74amghty.js → execute-tjrej979.js} +1 -1
  104. package/dist/{external-channel-v9zgxnxz.js → external-channel-jy8w2gg3.js} +2 -2
  105. package/dist/fx-adapter-k6w3jvz9.js +20 -0
  106. package/dist/grok-adapter-4q5tssw0.js +20 -0
  107. package/dist/handlers-qxgfvvsf.js +41 -0
  108. package/dist/{heartbeat-p8pk1msj.js → heartbeat-6tr2w2da.js} +25 -24
  109. package/dist/{hook-p5reemds.js → hook-bpnncsec.js} +76 -17
  110. package/dist/{hook-k1h73zd7.js → hook-fv1jwrv7.js} +6 -5
  111. package/dist/{http-ms1z5xxy.js → http-bpa26czn.js} +785 -181
  112. package/dist/index-0mcxjdsa.js +44 -0
  113. package/dist/{index-kn63q1gr.js → index-52tgbhrw.js} +29 -28
  114. package/dist/index-dz4q23ag.js +40 -0
  115. package/dist/{index-76zzxtzf.js → index-mpj0z9e0.js} +1 -1
  116. package/dist/index-s175jckx.js +39 -0
  117. package/dist/{index-gjn6qfgn.js → index-s8re7mvq.js} +1 -1
  118. package/dist/{index-fbkqhvvj.js → index-w216g9y9.js} +198 -160
  119. package/dist/{keepalive-031js8jz.js → keepalive-d6z12s04.js} +3 -3
  120. package/dist/lead-p3hx7h35.js +79 -0
  121. package/dist/{maintenance-sq9v3qx9.js → maintenance-7kac6g2g.js} +1 -1
  122. package/dist/{oauth-refresh-sweep-zqmnyvs8.js → oauth-refresh-sweep-t1xjetbh.js} +2 -2
  123. package/dist/{object-webhooks-r24wwb5y.js → object-webhooks-6rdagg0r.js} +7 -7
  124. package/dist/{onboard-p25yhh7t.js → onboard-32y1cfxy.js} +3 -3
  125. package/dist/{opencode-adapter-wcjc4zdk.js → opencode-adapter-enp3v31n.js} +7 -6
  126. package/dist/{otel-impl-ff1gf20m.js → otel-impl-k0tm5ptj.js} +1 -1
  127. package/dist/{pending-hxj5yatb.js → pending-24zebgvs.js} +23 -22
  128. package/dist/{pi-mono-adapter-vkp4zz7p.js → pi-mono-adapter-yj72xxxe.js} +85 -16
  129. package/dist/{pricing-refresh-9w7gx41w.js → pricing-refresh-cf25x38j.js} +2 -2
  130. package/dist/{rbac-roles-84aw10nz.js → rbac-roles-0wydd22m.js} +3 -3
  131. package/dist/{rbac-roles-hz74vckp.js → rbac-roles-at6crb3r.js} +7 -4
  132. package/dist/{registry-eeyx1201.js → registry-zv0zvxsx.js} +1 -1
  133. package/dist/{render-v2-nrdkg9gf.js → render-v2-nvcw0jd7.js} +8 -4
  134. package/dist/{resume-s6ey36rh.js → resume-y4w0k5v3.js} +9 -8
  135. package/dist/{runtime-x0b4pyam.js → runtime-vpe43hx0.js} +1 -1
  136. package/dist/{session-access-xv49tk14.js → session-access-gkyvnfye.js} +5 -4
  137. package/dist/{session-source-backfill-r5j988ah.js → session-source-backfill-3w2st4m2.js} +2 -2
  138. package/dist/{setup-mj0krk1p.js → setup-axxvqtys.js} +1 -1
  139. package/dist/thread-buffer-rwa7d4dx.js +42 -0
  140. package/dist/{tree-visibility-cbrsfaar.js → tree-visibility-y4fqvab5.js} +2 -2
  141. package/dist/{user-merge-jobs-f9d8nwnw.js → user-merge-jobs-kcmwvrc6.js} +3 -3
  142. package/dist/{virtual-modules-ns0ryw05.js → virtual-modules-7d92dct1.js} +3 -3
  143. package/dist/{work-objects-pydhzast.js → work-objects-f708e069.js} +27 -25
  144. package/dist/worker-8rg9gz74.js +79 -0
  145. package/dist/{worker-follow-up-9z2xec5e.js → worker-follow-up-0by8wztc.js} +22 -21
  146. package/dist/xlsx-9acfmxr1.js +31534 -0
  147. package/openapi.json +1385 -204
  148. package/package.json +5 -3
  149. package/src/agentmail/handlers.ts +26 -19
  150. package/src/apps/catalog.generated.json +31 -0
  151. package/src/apps/row-store.ts +37 -14
  152. package/src/azure-devops/handlers.ts +2 -0
  153. package/src/be/audit-user.ts +46 -6
  154. package/src/be/db/kv-windows.ts +22 -0
  155. package/src/be/db/session-moves.ts +3 -3
  156. package/src/be/db/session-tree.ts +52 -5
  157. package/src/be/db/skill-audit.ts +17 -0
  158. package/src/be/db/tasks/write.ts +18 -3
  159. package/src/be/db.ts +114 -23
  160. package/src/be/extensions/assets.ts +11 -7
  161. package/src/be/memory/demotion-evidence.ts +2 -2
  162. package/src/be/memory/providers/sqlite-store.ts +151 -18
  163. package/src/be/memory/search-read-worker.ts +60 -0
  164. package/src/be/memory/search-reader.ts +223 -0
  165. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  166. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  167. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  168. package/src/be/model-tier-resolution.ts +18 -1
  169. package/src/be/multi-runtime.ts +17 -0
  170. package/src/be/primitives/object-embed.ts +250 -0
  171. package/src/be/primitives/objects.ts +29 -9
  172. package/src/be/primitives/sheets/service.ts +138 -6
  173. package/src/be/primitives/sheets/xlsx.ts +367 -0
  174. package/src/be/rbac-roles.ts +3 -0
  175. package/src/be/repo-checked-update.ts +4 -4
  176. package/src/be/repo-merge-policy.ts +26 -9
  177. package/src/be/scripts/boot-reembed.ts +6 -0
  178. package/src/be/scripts/db.ts +17 -5
  179. package/src/be/scripts/embeddings.ts +6 -0
  180. package/src/be/scripts/typecheck.ts +43 -2
  181. package/src/be/seed/schedules-seeder.ts +9 -1
  182. package/src/be/seed/workflows-seeder.ts +9 -1
  183. package/src/be/seed-scripts/index.ts +2 -0
  184. package/src/be/seed-skills/index.ts +12 -0
  185. package/src/be/swarm-config-guard.ts +1 -0
  186. package/src/be/unmapped-identities.ts +95 -1
  187. package/src/bitbucket/handlers.ts +2 -0
  188. package/src/commands/onboard/agent-fs-version.ts +1 -1
  189. package/src/event-waits/github.ts +43 -0
  190. package/src/event-waits/index.ts +29 -0
  191. package/src/event-waits/types.ts +51 -0
  192. package/src/extensions/contract-types.generated.ts +1 -1
  193. package/src/extensions/dispatcher.ts +9 -0
  194. package/src/fs/agent-fs-provider.ts +4 -1
  195. package/src/github/handlers.ts +3 -1
  196. package/src/github/pull-request-state.ts +34 -0
  197. package/src/gitlab/handlers.ts +12 -7
  198. package/src/hooks/codex-hook.ts +99 -1
  199. package/src/hooks/hook.ts +85 -11
  200. package/src/hooks/native-tool-hooks.ts +245 -0
  201. package/src/http/all-routes.ts +1 -0
  202. package/src/http/assets.ts +4 -3
  203. package/src/http/comb.ts +2 -2
  204. package/src/http/favorite-owner.ts +2 -2
  205. package/src/http/favorites.ts +3 -2
  206. package/src/http/fs.ts +13 -4
  207. package/src/http/index.ts +2 -0
  208. package/src/http/mcp-bridge.ts +4 -0
  209. package/src/http/objects.ts +265 -0
  210. package/src/http/pages.ts +3 -3
  211. package/src/http/poll.ts +43 -12
  212. package/src/http/repos.ts +7 -6
  213. package/src/http/schedules.ts +10 -6
  214. package/src/http/script-connections.ts +2 -2
  215. package/src/http/scripts.ts +9 -0
  216. package/src/http/sessions.ts +30 -12
  217. package/src/http/skills.ts +17 -0
  218. package/src/http/task-requester.ts +2 -2
  219. package/src/http/tasks.ts +13 -3
  220. package/src/http/tool-hooks.ts +24 -2
  221. package/src/http/trackers/authorize-gate.ts +2 -2
  222. package/src/http/users.ts +136 -1
  223. package/src/http/workflow-events.ts +13 -0
  224. package/src/http/workflows.ts +21 -11
  225. package/src/linear/sync.ts +3 -1
  226. package/src/prompts/base-prompt.ts +35 -13
  227. package/src/prompts/session-templates.ts +25 -0
  228. package/src/providers/acp-targets.ts +1 -1
  229. package/src/providers/amp-adapter.ts +1 -1
  230. package/src/providers/dsh-adapter.ts +1 -1
  231. package/src/providers/opencode-adapter.ts +1 -0
  232. package/src/providers/opencode-swarm-plugin.ts +50 -1
  233. package/src/providers/pi-mono-adapter.ts +139 -9
  234. package/src/providers/pi-mono-extension.ts +69 -0
  235. package/src/providers/runtime-dependencies.ts +1 -1
  236. package/src/rbac/legacy-policy.ts +3 -0
  237. package/src/rbac/permissions.ts +11 -1
  238. package/src/scheduler/deferred-task-waits.ts +170 -13
  239. package/src/scripts-runtime/executors/types.ts +5 -0
  240. package/src/scripts-runtime/loader.ts +8 -0
  241. package/src/scripts-runtime/mcp-client.ts +4 -0
  242. package/src/scripts-runtime/sdk-allowlist.ts +14 -1
  243. package/src/scripts-runtime/swarm-config.ts +8 -0
  244. package/src/scripts-runtime/swarm-sdk.ts +4 -0
  245. package/src/scripts-runtime/types/stdlib.d.ts +47 -4
  246. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  247. package/src/scripts-runtime/types/swarm-sdk.d.ts +47 -4
  248. package/src/server.ts +4 -0
  249. package/src/slack/enrich.ts +81 -21
  250. package/src/slack/handlers.test.ts +55 -2
  251. package/src/slack/handlers.ts +38 -3
  252. package/src/slack/render-v2.ts +19 -0
  253. package/src/slack/session-mirror.ts +208 -0
  254. package/src/slack/thread-participants.ts +0 -5
  255. package/src/slack/watcher.ts +3 -0
  256. package/src/slack/work-objects.test.ts +2 -1
  257. package/src/slack/work-objects.ts +7 -2
  258. package/src/tests/agentmail-filters.test.ts +4 -3
  259. package/src/tests/audit-agent-person.test.ts +825 -0
  260. package/src/tests/audit-updated-by.test.ts +19 -12
  261. package/src/tests/claude-hook-output.test.ts +107 -2
  262. package/src/tests/claude-managed-setup.test.ts +1 -1
  263. package/src/tests/codex-adapter.test.ts +6 -6
  264. package/src/tests/codex-gpt6-release.test.ts +4 -4
  265. package/src/tests/db-task-read-contract.test.ts +1 -0
  266. package/src/tests/db-task-write-contract.test.ts +1 -0
  267. package/src/tests/dsh-adapter.test.ts +1 -1
  268. package/src/tests/extensions-catalog.test.ts +33 -25
  269. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  270. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  271. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  272. package/src/tests/kv-storage.test.ts +3 -0
  273. package/src/tests/memory-search-reader.test.ts +258 -0
  274. package/src/tests/memory-search-stall.test.ts +197 -20
  275. package/src/tests/model-control.test.ts +4 -4
  276. package/src/tests/model-tier-resolution.test.ts +2 -2
  277. package/src/tests/multi-runtime-registration.test.ts +8 -2
  278. package/src/tests/native-tool-hooks.test.ts +188 -0
  279. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  280. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  281. package/src/tests/poll-probe-readonly.test.ts +108 -0
  282. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  283. package/src/tests/prompt-template-session.test.ts +3 -2
  284. package/src/tests/rbac-roles.test.ts +3 -0
  285. package/src/tests/script-connections.test.ts +4 -0
  286. package/src/tests/seed-model-profiles.test.ts +1 -1
  287. package/src/tests/sessions-tree.test.ts +10 -2
  288. package/src/tests/slack-thread-participants.test.ts +66 -4
  289. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  290. package/src/tools/defer-task.ts +154 -12
  291. package/src/tools/objects.ts +10 -5
  292. package/src/tools/repos/update-repo.ts +6 -6
  293. package/src/tools/schedules/create-schedule.ts +1 -0
  294. package/src/tools/schedules/list-schedules.ts +3 -0
  295. package/src/tools/schedules/patch-schedule.ts +12 -3
  296. package/src/tools/schedules/update-schedule.ts +12 -3
  297. package/src/tools/sheets.ts +66 -0
  298. package/src/tools/skills/skill-create.ts +6 -0
  299. package/src/tools/skills/skill-install-remote.ts +6 -0
  300. package/src/tools/skills/skill-sync-remote.ts +9 -0
  301. package/src/tools/skills/skill-update.ts +9 -1
  302. package/src/tools/tool-config.ts +3 -1
  303. package/src/tools/utils.ts +15 -0
  304. package/src/tools/workflows/create-workflow.ts +9 -4
  305. package/src/tools/workflows/patch-workflow-node.ts +1 -1
  306. package/src/tools/workflows/patch-workflow.ts +5 -2
  307. package/src/tools/workflows/update-workflow.ts +13 -7
  308. package/src/types.ts +96 -12
  309. package/src/workflows/input.ts +12 -5
  310. package/src/workflows/patch-definition.ts +13 -5
  311. package/src/workflows/triggers.ts +11 -6
  312. package/src/workflows/version.ts +7 -1
  313. package/templates/skills/boards-and-sheets/config.json +14 -0
  314. package/templates/skills/boards-and-sheets/content.md +163 -0
  315. package/templates/skills/swarm-docs/content.md +9 -0
  316. package/dist/acp-adapter-11m13kx4.js +0 -16
  317. package/dist/core-dxcy02sc.js +0 -41
  318. package/dist/fx-adapter-0ar6pqm3.js +0 -19
  319. package/dist/grok-adapter-t6m74fb1.js +0 -19
  320. package/dist/handlers-9kwcrc4k.js +0 -38
  321. package/dist/index-23cdfzr6.js +0 -39
  322. package/dist/index-g7kkjs5b.js +0 -38
  323. package/dist/index-stk36pa5.js +0 -43
  324. package/dist/lead-mfggjtfk.js +0 -77
  325. package/dist/thread-buffer-temgaqsy.js +0 -41
  326. package/dist/worker-efcemc22.js +0 -77
  327. /package/dist/{cli-cah298e5.js → cli-m4ejz4nj.js} +0 -0
@@ -3,8 +3,10 @@
3
3
  *
4
4
  * Verifies:
5
5
  * - `updated_by` is stamped when a source task with a human requester is present.
6
- * - A pure-automation update (no source task / no human requester) does NOT clobber
7
- * an existing `updated_by` value or cause a crash.
6
+ * - A tool or route update with no trusted human (no requester, or a foreign
7
+ * source task) records the agent and clears `updated_by`: the pair always
8
+ * describes the latest user-intent write.
9
+ * - A direct system update that passes no audit fields leaves both untouched.
8
10
  */
9
11
  import { afterAll, beforeAll, describe, expect, test } from "bun:test";
10
12
  import { unlink } from "node:fs/promises";
@@ -159,7 +161,7 @@ describe("update-schedule MCP tool — updated_by column", () => {
159
161
  expect(updated?.updatedBy).toBe(humanUserId);
160
162
  });
161
163
 
162
- test("does not crash or clear updated_by when source task has no human requester", async () => {
164
+ test("an update with no human requester records the agent and clears the person", async () => {
163
165
  const server = new McpServer({ name: "audit-test-2", version: "1.0.0" });
164
166
  registerUpdateScheduleTool(server);
165
167
 
@@ -186,7 +188,8 @@ describe("update-schedule MCP tool — updated_by column", () => {
186
188
  expect((result.structuredContent as { success: boolean }).success).toBe(true);
187
189
 
188
190
  const after = await getScheduledTaskById(schedule.id);
189
- expect(after?.updatedBy).toBe(humanUserId); // must not be cleared
191
+ expect(after?.updatedBy).toBeUndefined();
192
+ expect(after?.updatedByAgentId).toBe(agentId);
190
193
  });
191
194
  });
192
195
 
@@ -247,7 +250,7 @@ describe("update-workflow MCP tool — updated_by column", () => {
247
250
  expect(updated?.updatedBy).toBe(humanUserId);
248
251
  });
249
252
 
250
- test("does not clobber updated_by when source task has no human requester", async () => {
253
+ test("an update with no human requester records the agent and clears the person", async () => {
251
254
  const server = new McpServer({ name: "audit-wf-test-2", version: "1.0.0" });
252
255
  registerUpdateWorkflowTool(server);
253
256
 
@@ -269,7 +272,8 @@ describe("update-workflow MCP tool — updated_by column", () => {
269
272
  expect((result.structuredContent as { success: boolean }).success).toBe(true);
270
273
 
271
274
  const after = await getWorkflow(wf.id);
272
- expect(after?.updatedBy).toBe(humanUserId);
275
+ expect(after?.updatedBy).toBeUndefined();
276
+ expect(after?.updatedByAgentId).toBe(agentId);
273
277
  });
274
278
  });
275
279
 
@@ -299,7 +303,7 @@ describe("patch-workflow MCP tool — updated_by column", () => {
299
303
  expect(updated?.updatedBy).toBe(humanUserId);
300
304
  });
301
305
 
302
- test("does not clobber updated_by on automation patch", async () => {
306
+ test("an automation patch records the agent and clears the person", async () => {
303
307
  const server = new McpServer({ name: "audit-patch-test-2", version: "1.0.0" });
304
308
  registerPatchWorkflowTool(server);
305
309
 
@@ -324,7 +328,8 @@ describe("patch-workflow MCP tool — updated_by column", () => {
324
328
  expect((result.structuredContent as { success: boolean }).success).toBe(true);
325
329
 
326
330
  const after = await getWorkflow(wf.id);
327
- expect(after?.updatedBy).toBe(humanUserId);
331
+ expect(after?.updatedBy).toBeUndefined();
332
+ expect(after?.updatedByAgentId).toBe(agentId);
328
333
  });
329
334
  });
330
335
 
@@ -578,7 +583,7 @@ describe("patch-workflow-node MCP tool — updated_by column", () => {
578
583
  expect(updated?.updatedBy).toBe(humanUserId);
579
584
  });
580
585
 
581
- test("does not clobber updated_by on automation patch", async () => {
586
+ test("an automation patch records the agent and clears the person", async () => {
582
587
  const server = new McpServer({ name: "audit-patchnode-test-2", version: "1.0.0" });
583
588
  registerPatchWorkflowNodeTool(server);
584
589
 
@@ -600,7 +605,8 @@ describe("patch-workflow-node MCP tool — updated_by column", () => {
600
605
  expect((result.structuredContent as { success: boolean }).success).toBe(true);
601
606
 
602
607
  const after = await getWorkflow(wf.id);
603
- expect(after?.updatedBy).toBe(humanUserId);
608
+ expect(after?.updatedBy).toBeUndefined();
609
+ expect(after?.updatedByAgentId).toBe(agentId);
604
610
  });
605
611
 
606
612
  test("does not trust a foreign source task", async () => {
@@ -632,8 +638,9 @@ describe("patch-workflow-node MCP tool — updated_by column", () => {
632
638
  );
633
639
  expect((result.structuredContent as { success: boolean }).success).toBe(true);
634
640
 
635
- // updated_by must be unchanged — the foreign task's requester is not trusted.
641
+ // The foreign task's requester is not trusted: this write has no known person.
636
642
  const after = await getWorkflow(wf.id);
637
- expect(after?.updatedBy).toBe(humanUserId);
643
+ expect(after?.updatedBy).toBeUndefined();
644
+ expect(after?.updatedByAgentId).toBe(agentId);
638
645
  });
639
646
  });
@@ -9,7 +9,7 @@
9
9
  *
10
10
  * Each test runs the real hook as a subprocess against a fake API.
11
11
  */
12
- import { afterAll, beforeAll, describe, expect, test } from "bun:test";
12
+ import { afterAll, afterEach, beforeAll, describe, expect, test } from "bun:test";
13
13
  import { mkdtemp, rm } from "node:fs/promises";
14
14
  import { tmpdir } from "node:os";
15
15
  import { join } from "node:path";
@@ -23,9 +23,16 @@ type FakeState = {
23
23
  isLead: boolean;
24
24
  cancelledTaskId: string | null;
25
25
  shouldBlockPolling: boolean;
26
+ /** When set, the fake API reports native extensions and answers each tool hook with this. */
27
+ nativeDecision: Record<string, unknown> | null;
26
28
  };
27
29
 
28
- const state: FakeState = { isLead: false, cancelledTaskId: null, shouldBlockPolling: false };
30
+ const state: FakeState = {
31
+ isLead: false,
32
+ cancelledTaskId: null,
33
+ shouldBlockPolling: false,
34
+ nativeDecision: null,
35
+ };
29
36
  let server: ReturnType<typeof Bun.serve>;
30
37
  let projectDir: string;
31
38
 
@@ -57,6 +64,12 @@ beforeAll(async () => {
57
64
  : [];
58
65
  return Response.json({ cancelled });
59
66
  }
67
+ if (url.pathname === "/api/tool-hooks/status") {
68
+ return Response.json({ native: state.nativeDecision !== null });
69
+ }
70
+ if (url.pathname === "/api/tool-hooks") {
71
+ return Response.json(state.nativeDecision ?? { action: "continue" });
72
+ }
60
73
  return Response.json({ ok: true });
61
74
  },
62
75
  });
@@ -122,6 +135,10 @@ const bashTouch = {
122
135
  };
123
136
 
124
137
  describe("claude hook stdout", () => {
138
+ afterEach(() => {
139
+ state.nativeDecision = null;
140
+ });
141
+
125
142
  test(
126
143
  "blocked PreToolUse prints exactly one deny JSON object",
127
144
  async () => {
@@ -308,4 +325,92 @@ describe("claude hook stdout", () => {
308
325
  },
309
326
  CHILD_PROCESS_TEST_BUDGET_MS,
310
327
  );
328
+
329
+ describe("native rewrite of a Bash command", () => {
330
+ const leaky = `gh pr create --repo desplega-ai/agent-swarm --title x --body 'taskId = ${"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"}'`;
331
+ const room = "gh pr create --repo desplega-ai/agent-swarm --title x --body hello";
332
+ const rewriteTo = (command: string) => {
333
+ state.nativeDecision = { action: "modify", args: { command } };
334
+ };
335
+ /** A fresh TMPDIR keeps the 30 s status cache from leaking between tests. */
336
+ const runRewrite = async (extraEnv: Record<string, string> = {}) => {
337
+ const tmp = await mkdtemp(join(tmpdir(), "claude-hook-native-"));
338
+ try {
339
+ return await runHook(
340
+ {
341
+ hook_event_name: "PreToolUse",
342
+ tool_name: "Bash",
343
+ tool_input: { command: "echo safe" },
344
+ },
345
+ crypto.randomUUID(),
346
+ { TMPDIR: tmp, ...extraEnv },
347
+ );
348
+ } finally {
349
+ await rm(tmp, { recursive: true, force: true });
350
+ }
351
+ };
352
+
353
+ test(
354
+ "a rewrite into a leaking gh pr body is blocked, not emitted",
355
+ async () => {
356
+ rewriteTo(leaky);
357
+ const result = await runRewrite();
358
+ expect(result.exitCode).toBe(2);
359
+ expect(result.stderr).toContain("PR body leak check");
360
+ expect(result.stdout.trim()).toBe("");
361
+ },
362
+ CHILD_PROCESS_TEST_BUDGET_MS,
363
+ );
364
+
365
+ test(
366
+ "a rewrite into a gh pr create with no PR room is blocked, not emitted",
367
+ async () => {
368
+ rewriteTo(room);
369
+ const result = await runRewrite({ PR_ROOM_REPOS: "desplega-ai/agent-swarm" });
370
+ expect(result.exitCode).toBe(2);
371
+ expect(result.stderr).toContain("PR rooms");
372
+ expect(result.stdout.trim()).toBe("");
373
+ },
374
+ CHILD_PROCESS_TEST_BUDGET_MS,
375
+ );
376
+
377
+ test(
378
+ "a safe rewrite is emitted as one updatedInput object",
379
+ async () => {
380
+ rewriteTo("echo rewritten");
381
+ const result = await runRewrite({ PR_ROOM_REPOS: "desplega-ai/agent-swarm" });
382
+ expect(result.exitCode).toBe(0);
383
+ const out = parseSoleJson(result.stdout) as {
384
+ hookSpecificOutput: { updatedInput: { command: string } };
385
+ };
386
+ expect(out.hookSpecificOutput.updatedInput).toEqual({ command: "echo rewritten" });
387
+ },
388
+ CHILD_PROCESS_TEST_BUDGET_MS,
389
+ );
390
+
391
+ test(
392
+ "a safe rewrite keeps the loop warning in the same single object",
393
+ async () => {
394
+ rewriteTo("echo rewritten");
395
+ Object.assign(state, { isLead: false, cancelledTaskId: null, shouldBlockPolling: false });
396
+ const taskId = crypto.randomUUID();
397
+ const tmp = await mkdtemp(join(tmpdir(), "claude-hook-native-"));
398
+ let out: { hookSpecificOutput: Record<string, unknown> } | undefined;
399
+ try {
400
+ for (let i = 0; i < 14 && !out?.hookSpecificOutput.additionalContext; i++) {
401
+ const result = await runHook({ hook_event_name: "PreToolUse", ...bashTouch }, taskId, {
402
+ TMPDIR: tmp,
403
+ });
404
+ out = parseSoleJson(result.stdout) as typeof out;
405
+ }
406
+ } finally {
407
+ await rm(`/tmp/agent-swarm-tool-history/${taskId}.json`, { force: true });
408
+ await rm(tmp, { recursive: true, force: true });
409
+ }
410
+ expect(out?.hookSpecificOutput.updatedInput).toEqual({ command: "echo rewritten" });
411
+ expect(out?.hookSpecificOutput.additionalContext).toStartWith("Warning: ");
412
+ },
413
+ CHILD_PROCESS_TEST_BUDGET_MS * 3,
414
+ );
415
+ });
311
416
  });
@@ -336,7 +336,7 @@ describe("resolveClaudeManagedSetupConfig", () => {
336
336
  expect(result.mcpBaseUrl).toBe("https://example.com");
337
337
  expect(result.apiKey).toBe("key123");
338
338
  expect(result.apiUrl).toBe("https://example.com");
339
- expect(result.agentModel).toBe("claude-sonnet-5");
339
+ expect(result.agentModel).toBe("claude-sonnet-5-5");
340
340
  expect(promptSecret).not.toHaveBeenCalled();
341
341
  });
342
342
 
@@ -1541,16 +1541,16 @@ describe("resolveCodexModel", () => {
1541
1541
  expect(resolveCodexModel("")).toBe(CODEX_DEFAULT_MODEL);
1542
1542
  });
1543
1543
 
1544
- test("claude shortname 'opus' → gpt-5.6-sol", () => {
1545
- expect(resolveCodexModel("opus")).toBe("gpt-5.6-sol");
1544
+ test("claude shortname 'opus' → gpt-6.1-sol", () => {
1545
+ expect(resolveCodexModel("opus")).toBe("gpt-6.1-sol");
1546
1546
  });
1547
1547
 
1548
- test("claude shortname 'sonnet' → gpt-5.6-terra", () => {
1549
- expect(resolveCodexModel("sonnet")).toBe("gpt-5.6-terra");
1548
+ test("claude shortname 'sonnet' → gpt-6.1-terra", () => {
1549
+ expect(resolveCodexModel("sonnet")).toBe("gpt-6.1-terra");
1550
1550
  });
1551
1551
 
1552
- test("claude shortname 'haiku' → gpt-5.6-luna", () => {
1553
- expect(resolveCodexModel("haiku")).toBe("gpt-5.6-luna");
1552
+ test("claude shortname 'haiku' → gpt-6-luna", () => {
1553
+ expect(resolveCodexModel("haiku")).toBe("gpt-6-luna");
1554
1554
  });
1555
1555
 
1556
1556
  test("passthrough 'gpt-5.4-mini' → gpt-5.4-mini", () => {
@@ -90,10 +90,10 @@ for (const release of releases) {
90
90
  }
91
91
 
92
92
  test("release additions preserve rollout-safe defaults and aliases", () => {
93
- expect(CODEX_DEFAULT_MODEL).toBe("gpt-5.6-terra");
94
- expect(resolveCodexModel("sonnet")).toBe("gpt-5.6-terra");
95
- expect(resolveCodexModel("haiku")).toBe("gpt-5.6-luna");
96
- expect(resolveCodexModel("opus")).toBe("gpt-5.6-sol");
93
+ expect(CODEX_DEFAULT_MODEL).toBe("gpt-6.1-terra");
94
+ expect(resolveCodexModel("sonnet")).toBe("gpt-6.1-terra");
95
+ expect(resolveCodexModel("haiku")).toBe("gpt-6-luna");
96
+ expect(resolveCodexModel("opus")).toBe("gpt-6.1-sol");
97
97
  });
98
98
 
99
99
  describe("gpt-6.1-sol", () => {
@@ -577,6 +577,7 @@ value:setApiKeyPlan
577
577
  value:setBudgetRefusalFollowUpTaskId
578
578
  value:setFavorite
579
579
  value:setScriptRunFollowUpGuard
580
+ value:setSkillUpdatedBy
580
581
  value:setSlackMessageTracking
581
582
  value:setTaskTitleIfUnset
582
583
  value:setUserFavorite
@@ -600,6 +600,7 @@ value:setApiKeyPlan
600
600
  value:setBudgetRefusalFollowUpTaskId
601
601
  value:setFavorite
602
602
  value:setScriptRunFollowUpGuard
603
+ value:setSkillUpdatedBy
603
604
  value:setSlackMessageTracking
604
605
  value:setTaskTitleIfUnset
605
606
  value:setUserFavorite
@@ -376,7 +376,7 @@ describe("dsh harness", () => {
376
376
  await rename(join(config.cwd, "dsh"), join(config.cwd, "npx"));
377
377
  config.env = { ...config.env, DSH_BINARY: "", PATH: config.cwd };
378
378
  await expect(new DshAdapter().createSession(config)).rejects.toThrow(
379
- "dsh CLI not found. Install @deepseek-ai/dsh@0.2.2-rc.1",
379
+ "dsh CLI not found. Install @deepseek-ai/dsh@0.2.2-rc.2",
380
380
  );
381
381
  expect(await Bun.file(join(config.cwd, "invocation.json")).exists()).toBe(false);
382
382
  });
@@ -31,33 +31,41 @@ afterEach(async () => {
31
31
  for (const dir of tempDirs.splice(0)) await rm(dir, { recursive: true, force: true });
32
32
  });
33
33
 
34
+ // One test per bundled entry. Each entry runs a full TypeScript program (~0.5-2.5s locally, more on
35
+ // a loaded CI runner), so a single test looping over the whole catalog spent a shared 15s budget
36
+ // that grew with every new extension and timed out on slow shards. Add new names here.
37
+ const BUNDLED_ENTRIES = [
38
+ "comms-adherence-gate",
39
+ "deploy-awareness",
40
+ "github-sender-allowlist",
41
+ "notify-on-complete",
42
+ "require-ticket-ref",
43
+ "require-verification-note",
44
+ "slack-reply-gate",
45
+ "sql-admin-only",
46
+ "task-digest",
47
+ ];
48
+
34
49
  describe("predefined extension catalog", () => {
35
- test(
36
- "every bundled entry passes the manifest schema and bundle validation",
37
- async () => {
38
- const catalog = getExtensionCatalog();
39
- expect(Object.keys(catalog).sort()).toEqual([
40
- "comms-adherence-gate",
41
- "deploy-awareness",
42
- "github-sender-allowlist",
43
- "notify-on-complete",
44
- "require-ticket-ref",
45
- "require-verification-note",
46
- "slack-reply-gate",
47
- "sql-admin-only",
48
- "task-digest",
49
- ]);
50
- for (const [name, entry] of Object.entries(catalog)) {
51
- expect(entry.manifest.name).toBe(name);
52
- expect(ExtensionManifestSchema.safeParse(entry.manifest).success).toBe(true);
53
- const result = await validateBundle({ manifest: entry.manifest, files: entry.files });
50
+ for (const name of BUNDLED_ENTRIES) {
51
+ test(
52
+ `bundled entry ${name} passes the manifest schema and bundle validation`,
53
+ async () => {
54
+ const catalog = getExtensionCatalog();
55
+ // Fails every entry's test when a bundled template is added or removed without updating the list.
56
+ expect(Object.keys(catalog).sort()).toEqual(BUNDLED_ENTRIES);
57
+ const entry = catalog[name];
58
+ expect(entry).toBeDefined();
59
+ expect(entry!.manifest.name).toBe(name);
60
+ expect(ExtensionManifestSchema.safeParse(entry!.manifest).success).toBe(true);
61
+ const result = await validateBundle({ manifest: entry!.manifest, files: entry!.files });
54
62
  expect(result).toMatchObject({ ok: true });
55
- }
56
- expect(getCatalogEntry("task-digest")?.manifestFile).toBe("manifest.yaml");
57
- expect(getCatalogEntry("toString")).toBeNull();
58
- },
59
- { timeout: 15_000 },
60
- );
63
+ expect(getCatalogEntry("task-digest")?.manifestFile).toBe("manifest.yaml");
64
+ expect(getCatalogEntry("toString")).toBeNull();
65
+ },
66
+ { timeout: 15_000 },
67
+ );
68
+ }
61
69
 
62
70
  test("the generator reads YAML and JSON templates and their referenced files", async () => {
63
71
  const dir = await templatesDir({
@@ -187,6 +187,8 @@ describe("kv-storage helpers", () => {
187
187
  )
188
188
  ).map(keyOf);
189
189
 
190
+ // Count batch yields only, not the DB client's elapsed-time slice yields.
191
+ const clock = spyOn(performance, "now").mockReturnValue(0);
190
192
  const immediate = spyOn(globalThis, "setImmediate");
191
193
  let removed: number;
192
194
  let yields: number;
@@ -195,6 +197,7 @@ describe("kv-storage helpers", () => {
195
197
  yields = immediate.mock.calls.length;
196
198
  } finally {
197
199
  immediate.mockRestore();
200
+ clock.mockRestore();
198
201
  }
199
202
 
200
203
  const after = new Set(
@@ -0,0 +1,258 @@
1
+ import {
2
+ afterAll,
3
+ afterEach,
4
+ beforeAll,
5
+ describe,
6
+ expect,
7
+ setSystemTime,
8
+ spyOn,
9
+ test,
10
+ } from "bun:test";
11
+ import { randomUUID } from "node:crypto";
12
+ import { closeDb, createAgent, getDbClient, initDb } from "../be/db";
13
+ import { attachDemotionEvidence } from "../be/memory/demotion-evidence";
14
+ import { SqliteMemoryStore } from "../be/memory/providers/sqlite-store";
15
+ import { searchMemoryCandidates } from "../be/memory/search-candidates";
16
+ import {
17
+ __resetMemorySearchReaderForTests,
18
+ memorySearchReader,
19
+ memorySearchReaderStats,
20
+ SEARCH_READ_WORKERS,
21
+ } from "../be/memory/search-reader";
22
+
23
+ // Memory search reads run in worker threads with their own read-only
24
+ // connection, so a slow vec/bm25 statement no longer freezes the API loop.
25
+ // The in-memory test template cannot be opened from a worker, so this file
26
+ // swaps it for a real WAL file, as db-query.test.ts does.
27
+
28
+ const TEST_DB_PATH = "./test-memory-search-reader.sqlite";
29
+ const agentId = randomUUID();
30
+ const otherAgent = randomUUID();
31
+ const WORDS = ["deploy", "sqlite", "worker", "review", "billing", "slack", "migration", "vector"];
32
+ const globals = globalThis as typeof globalThis & {
33
+ __testMigrationTemplate?: Uint8Array;
34
+ __savedSearchReaderTemplate?: Uint8Array;
35
+ };
36
+
37
+ /** Deterministic unit vector per seed. */
38
+ function vector(seed: number): Float32Array {
39
+ const embedding = new Float32Array(512);
40
+ let norm = 0;
41
+ for (let i = 0; i < embedding.length; i++) {
42
+ const value = Math.sin(seed * 12.9898 + i * 78.233);
43
+ embedding[i] = value;
44
+ norm += value * value;
45
+ }
46
+ for (let i = 0; i < embedding.length; i++) embedding[i]! /= Math.sqrt(norm);
47
+ return embedding;
48
+ }
49
+
50
+ async function removeDb(): Promise<void> {
51
+ for (const suffix of ["", "-wal", "-shm"]) {
52
+ try {
53
+ await Bun.file(`${TEST_DB_PATH}${suffix}`).delete();
54
+ } catch {}
55
+ }
56
+ }
57
+
58
+ /** Every search path the store has, plus the HTTP route's candidate fetch and evidence lookup. */
59
+ async function runSearches(store: SqliteMemoryStore) {
60
+ const query = vector(3);
61
+ const wrongDimension = new Float32Array(8);
62
+ const candidates = await searchMemoryCandidates(store, query, agentId, {
63
+ limit: 10,
64
+ queryText: "deploy worker",
65
+ });
66
+ return {
67
+ vec: await store.search(query, agentId, { limit: 10 }),
68
+ hybrid: await store.search(query, agentId, { limit: 10, queryText: "sqlite review" }),
69
+ fts: await store.search(wrongDimension, agentId, { limit: 10, queryText: "billing slack" }),
70
+ swarmOnly: await store.search(query, agentId, { limit: 10, scope: "swarm" }),
71
+ keyPrefix: await store.search(query, agentId, { limit: 10, keyPrefix: "/notes/a" }),
72
+ exhaustive: await store.search(query, agentId, { limit: 10, exhaustive: true }),
73
+ lead: await store.search(query, agentId, { limit: 10, isLead: true, queryText: "vector" }),
74
+ route: await attachDemotionEvidence(candidates),
75
+ };
76
+ }
77
+
78
+ const SLOW_SQL =
79
+ "WITH RECURSIVE c(x) AS (SELECT 1 UNION ALL SELECT x + 1 FROM c WHERE x < ?) SELECT count(*) AS n FROM c";
80
+ const SLOW_ROWS = 3_000_000;
81
+
82
+ /** Longest gap between ticks of a 5 ms timer while `run` is pending. */
83
+ async function maxTimerGap(run: () => Promise<unknown>): Promise<number> {
84
+ let last = performance.now();
85
+ let maxGap = 0;
86
+ const timer = setInterval(() => {
87
+ const now = performance.now();
88
+ maxGap = Math.max(maxGap, now - last);
89
+ last = now;
90
+ }, 5);
91
+ try {
92
+ await run();
93
+ const now = performance.now();
94
+ return Math.max(maxGap, now - last);
95
+ } finally {
96
+ clearInterval(timer);
97
+ }
98
+ }
99
+
100
+ beforeAll(async () => {
101
+ globals.__savedSearchReaderTemplate = globals.__testMigrationTemplate;
102
+ globals.__testMigrationTemplate = undefined;
103
+ closeDb();
104
+ await removeDb();
105
+ initDb(TEST_DB_PATH);
106
+ await createAgent({ id: agentId, name: "Reader Agent", isLead: false, status: "idle" });
107
+ await createAgent({ id: otherAgent, name: "Other Agent", isLead: false, status: "idle" });
108
+
109
+ const store = new SqliteMemoryStore();
110
+ for (let i = 0; i < 80; i++) {
111
+ const row = await store.store({
112
+ agentId: i % 3 === 0 ? otherAgent : agentId,
113
+ scope: i % 4 === 0 ? "swarm" : "agent",
114
+ name: `note-${i}`,
115
+ key: `/notes/${i % 2 === 0 ? "a" : "b"}/${i}`,
116
+ content: `${WORDS[i % WORDS.length]} ${WORDS[(i * 3) % WORDS.length]} note ${i}`,
117
+ source: i % 5 === 0 ? "task_completion" : "manual",
118
+ });
119
+ await store.updateEmbedding(row.id, vector(i), "test");
120
+ if (i % 7 === 0) {
121
+ // Net-negative posterior with rating rows, so the evidence lookup returns data.
122
+ await getDbClient().run("UPDATE agent_memory SET alpha = 1, beta = 4 WHERE id = ?", [row.id]);
123
+ await getDbClient().run(
124
+ `INSERT INTO memory_rating (id, memoryId, source, signal, weight, createdAt)
125
+ VALUES (?, ?, 'llm', -1, 1, datetime('now'))`,
126
+ [randomUUID(), row.id],
127
+ );
128
+ }
129
+ }
130
+ });
131
+
132
+ afterEach(async () => {
133
+ setSystemTime();
134
+ await __resetMemorySearchReaderForTests();
135
+ });
136
+
137
+ afterAll(async () => {
138
+ await __resetMemorySearchReaderForTests();
139
+ closeDb();
140
+ globals.__testMigrationTemplate = globals.__savedSearchReaderTemplate;
141
+ globals.__savedSearchReaderTemplate = undefined;
142
+ await removeDb();
143
+ });
144
+
145
+ describe("memory search reads in worker threads", () => {
146
+ test("every search path returns the same results from the workers as in-process", async () => {
147
+ const store = new SqliteMemoryStore();
148
+ // FTS scores apply recency decay against the clock; hold it still across both runs.
149
+ setSystemTime(new Date());
150
+ await __resetMemorySearchReaderForTests({ inProcess: true });
151
+ const inProcess = await runSearches(store);
152
+ expect(await memorySearchReaderStats()).toBeNull();
153
+
154
+ await __resetMemorySearchReaderForTests();
155
+ const fromWorkers = await runSearches(store);
156
+ // Positive control: the workers served these reads.
157
+ expect(await memorySearchReaderStats()).toEqual({
158
+ workers: SEARCH_READ_WORKERS,
159
+ busy: 0,
160
+ queued: 0,
161
+ });
162
+
163
+ // Non-empty on every path, so equality is not two empty lists.
164
+ for (const results of Object.values(inProcess)) expect(results.length).toBeGreaterThan(0);
165
+ expect(inProcess.route.some((c) => c.demotionEvidence)).toBe(true);
166
+ expect(fromWorkers).toEqual(inProcess);
167
+ });
168
+
169
+ test(
170
+ "the event loop keeps running while a worker read runs; in-process it freezes",
171
+ async () => {
172
+ const params = [SLOW_ROWS];
173
+ await __resetMemorySearchReaderForTests({ inProcess: true });
174
+ const started = performance.now();
175
+ const frozen = await maxTimerGap(() => memorySearchReader.get(SLOW_SQL, params));
176
+ const statementMs = performance.now() - started;
177
+ // Negative control: the in-process read blocks the timer for the whole statement.
178
+ expect(statementMs).toBeGreaterThan(150);
179
+ expect(frozen).toBeGreaterThan(statementMs * 0.8);
180
+
181
+ await __resetMemorySearchReaderForTests();
182
+ await memorySearchReader.get("SELECT 1"); // start the pool outside the measurement
183
+ let result: unknown;
184
+ const gap = await maxTimerGap(async () => {
185
+ result = await memorySearchReader.get(SLOW_SQL, params);
186
+ });
187
+ expect(result).toEqual({ n: SLOW_ROWS });
188
+ expect(gap).toBeLessThan(Math.min(100, statementMs / 2));
189
+ // Wall-clock timer gaps: a loaded CI host can stretch one tick past the bound.
190
+ },
191
+ { retry: 2 },
192
+ );
193
+
194
+ test("a burst of reads runs at most SEARCH_READ_WORKERS at once and the rest queue", async () => {
195
+ await memorySearchReader.get("SELECT 1");
196
+ const burst = Array.from({ length: 5 }, () =>
197
+ memorySearchReader.get<{ n: number }>(SLOW_SQL, [SLOW_ROWS]),
198
+ );
199
+ expect(await memorySearchReaderStats()).toEqual({
200
+ workers: SEARCH_READ_WORKERS,
201
+ busy: SEARCH_READ_WORKERS,
202
+ queued: 5 - SEARCH_READ_WORKERS,
203
+ });
204
+ expect(await Promise.all(burst)).toEqual(Array(5).fill({ n: SLOW_ROWS }));
205
+ expect(await memorySearchReaderStats()).toEqual({
206
+ workers: SEARCH_READ_WORKERS,
207
+ busy: 0,
208
+ queued: 0,
209
+ });
210
+ });
211
+
212
+ test("a SQL error from a worker read rejects with the SQLite message", async () => {
213
+ await expect(memorySearchReader.query("SELECT * FROM no_such_table")).rejects.toThrow(
214
+ "no such table: no_such_table",
215
+ );
216
+ // The pool survives a statement error.
217
+ expect(await memorySearchReader.get("SELECT 2 AS n")).toEqual({ n: 2 });
218
+ });
219
+
220
+ test("a read inside a transaction stays on the main connection and sees its writes", async () => {
221
+ const id = randomUUID();
222
+ const seen = await getDbClient()
223
+ .transaction(async (tx) => {
224
+ await tx.run(
225
+ `INSERT INTO memory_rating (id, memoryId, source, signal, weight, createdAt)
226
+ VALUES (?, 'uncommitted', 'llm', 1, 1, datetime('now'))`,
227
+ [id],
228
+ );
229
+ const row = await memorySearchReader.get("SELECT id FROM memory_rating WHERE id = ?", [id]);
230
+ throw Object.assign(new Error("rollback"), { row });
231
+ })
232
+ .catch((err: Error & { row?: unknown }) => err.row);
233
+ expect(seen).toEqual({ id });
234
+ expect(await memorySearchReaderStats()).toBeNull();
235
+ });
236
+
237
+ test("workers that fail to start leave reads in-process, with a log line", async () => {
238
+ const RealWorker = globalThis.Worker;
239
+ const warn = spyOn(console, "warn").mockImplementation(() => {});
240
+ globalThis.Worker = class {
241
+ constructor() {
242
+ throw new Error("worker entry missing");
243
+ }
244
+ } as unknown as typeof Worker;
245
+ try {
246
+ const store = new SqliteMemoryStore();
247
+ const results = await store.search(vector(3), agentId, { limit: 5, queryText: "deploy" });
248
+ expect(results.length).toBeGreaterThan(0);
249
+ expect(await memorySearchReaderStats()).toBeNull();
250
+ expect(warn.mock.calls.map((args) => String(args[0]))).toContain(
251
+ "[memory-search] read workers failed to start (worker entry missing); reads run in-process",
252
+ );
253
+ } finally {
254
+ globalThis.Worker = RealWorker;
255
+ warn.mockRestore();
256
+ }
257
+ });
258
+ });