@desplega.ai/agent-swarm 2.7.9 → 2.8.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 (355) hide show
  1. package/dist/acp-adapter-t949vbbp.js +15 -0
  2. package/dist/{actions-g563mbn2.js → actions-7e9czc7s.js} +19 -19
  3. package/dist/{amp-adapter-q61w05eb.js → amp-adapter-gv6cbb7d.js} +2 -3
  4. package/dist/app-b9fbkp9v.js +20 -0
  5. package/dist/{assistant-p477rjwj.js → assistant-wjb7v4c7.js} +22 -22
  6. package/dist/{boot-args-schema-h4qj462e.js → boot-args-schema-2t37e0fe.js} +1 -1
  7. package/dist/{boot-reembed-n1ehfbsw.js → boot-reembed-a35nkyr1.js} +1 -1
  8. package/dist/{boot-reembed-qw4mc0pt.js → boot-reembed-gka3zas7.js} +1 -1
  9. package/dist/{boot-scrub-sweep-9w9jp4sm.js → boot-scrub-sweep-65sdnp6c.js} +3 -3
  10. package/dist/{boot-seeds-qdaf3sdy.js → boot-seeds-x42tzytw.js} +4 -5
  11. package/dist/{claude-adapter-348p5hx9.js → claude-adapter-v221b2fd.js} +7 -8
  12. package/dist/{claude-managed-adapter-h74d06yz.js → claude-managed-adapter-29eq09wd.js} +2 -2
  13. package/dist/{claude-managed-setup-7787fxtp.js → claude-managed-setup-9m6450zk.js} +2 -2
  14. package/dist/{claude-sdk-session-hbszbt8a.js → claude-sdk-session-0q0ptaba.js} +9066 -8818
  15. package/dist/{cli-n5yexkdg.js → cli-0b4zam62.js} +1 -0
  16. package/dist/{cli-21159vea.js → cli-0jzra9ad.js} +2 -2
  17. package/dist/{cli-eqtfgfr6.js → cli-2gxeg5gr.js} +1 -1
  18. package/dist/{cli-k70e3x9e.js → cli-2wnq8jkz.js} +9 -9
  19. package/dist/{cli-cvs2r2vq.js → cli-2zp0et3v.js} +59 -6
  20. package/dist/{cli-650zv9q9.js → cli-334z18y3.js} +4 -4
  21. package/dist/{cli-12xyjhws.js → cli-3rkdne1h.js} +2 -2
  22. package/dist/{cli-2a8py3sx.js → cli-4txa0ter.js} +5 -7
  23. package/dist/{cli-jc1g9ndz.js → cli-5j88qqa8.js} +10 -5
  24. package/dist/{cli-xfjrc279.js → cli-5mrq3ake.js} +48 -14
  25. package/dist/{cli-v3cf1ts9.js → cli-6t09sdhy.js} +3 -3
  26. package/dist/{cli-qzt90yze.js → cli-6wxjceza.js} +8 -8
  27. package/dist/{cli-9aezs55w.js → cli-7b8sbmag.js} +8 -8
  28. package/dist/{cli-3xj33nrx.js → cli-7cp6aa1q.js} +10 -3
  29. package/dist/{cli-jfx48xrj.js → cli-7p1kvkck.js} +6 -6
  30. package/dist/{cli-b932gexn.js → cli-8aes17e4.js} +2 -2
  31. package/dist/{cli-3tqcamp6.js → cli-8fknbnhw.js} +14 -13
  32. package/dist/{cli-587857ys.js → cli-8kzasymh.js} +3 -3
  33. package/dist/{cli-sgs5k6yd.js → cli-a7wvp2km.js} +1 -1
  34. package/dist/{cli-varqt4d1.js → cli-abejgen1.js} +69 -22
  35. package/dist/{cli-rwymrnaz.js → cli-bsywb58a.js} +8 -8
  36. package/dist/{cli-btc9cb4c.js → cli-c55z5chy.js} +4 -6
  37. package/dist/{cli-ms5m5r1y.js → cli-deefvewm.js} +1 -1
  38. package/dist/{cli-p17970qv.js → cli-ee0b971j.js} +3 -3
  39. package/dist/cli-f3vq58d2.js +242 -0
  40. package/dist/{cli-3xcwp3z8.js → cli-ffhtssbp.js} +2 -2
  41. package/dist/{cli-hwprv9e4.js → cli-g70vxtjh.js} +2 -2
  42. package/dist/{cli-4t0fmf3z.js → cli-gxkx0zzp.js} +1 -1
  43. package/dist/{cli-neyag5p6.js → cli-h38x262p.js} +3365 -429
  44. package/dist/{cli-2ccpqyyf.js → cli-j790gp2w.js} +105 -22
  45. package/dist/{cli-f2zenhja.js → cli-kc7v1nfv.js} +1 -1
  46. package/dist/{cli-vxh6acp7.js → cli-m23zjcy2.js} +10 -10
  47. package/dist/{cli-y8nbefpb.js → cli-m28atx8q.js} +12 -10
  48. package/dist/{cli-serm8zrx.js → cli-m4dqmnbp.js} +1 -1
  49. package/dist/{cli-ybjdc978.js → cli-mrt48bx7.js} +7 -4
  50. package/dist/{cli-y5rbvxhc.js → cli-n515ex5z.js} +14 -14
  51. package/dist/{cli-ypff1qwp.js → cli-n9ftpys4.js} +7 -7
  52. package/dist/{cli-605nn699.js → cli-p1bq50aa.js} +894 -226
  53. package/dist/{cli-qkdmz8c8.js → cli-p1w18yhx.js} +1 -1
  54. package/dist/{cli-xk879m3k.js → cli-p2gfst4m.js} +52 -43
  55. package/dist/{cli-sya22y84.js → cli-pasjcnmj.js} +12 -12
  56. package/dist/{cli-0whpms1z.js → cli-qa4wdgsy.js} +5 -5
  57. package/dist/{cli-ejkvvqbe.js → cli-qfedvmcr.js} +50 -24
  58. package/dist/{cli-tqq0hspb.js → cli-qmqk2yc2.js} +1 -1
  59. package/dist/{cli-qmd3mse0.js → cli-qsnnd04k.js} +1 -1
  60. package/dist/{cli-agyaeef4.js → cli-qwca7s44.js} +3 -3
  61. package/dist/{cli-fayav105.js → cli-rfywm85n.js} +724 -792
  62. package/dist/{cli-zgv8gxgs.js → cli-rmmpt0wm.js} +6 -6
  63. package/dist/{cli-hae9j8sv.js → cli-rzsy6nc6.js} +12 -8
  64. package/dist/{cli-btf6fw39.js → cli-s7t6p9my.js} +1 -1
  65. package/dist/{cli-cseh6f8w.js → cli-sdtt3men.js} +1 -1
  66. package/dist/{cli-9r5gtwjr.js → cli-tk7cjj8h.js} +197 -2
  67. package/dist/{cli-q26b9wre.js → cli-tph5wt3y.js} +4 -4
  68. package/dist/{cli-gce09r66.js → cli-tqegb8eq.js} +3 -3
  69. package/dist/{cli-kf3pxxdg.js → cli-v1dv1r37.js} +1 -1
  70. package/dist/{cli-09kmfkmq.js → cli-wcg8x116.js} +1 -1
  71. package/dist/{cli-mnrkgg60.js → cli-wk18cm92.js} +5 -5
  72. package/dist/{cli-p0m0p34z.js → cli-x1wa213s.js} +3 -3
  73. package/dist/{cli-jrp1dt73.js → cli-xzm9vcfg.js} +1 -1
  74. package/dist/{cli-715t1gx6.js → cli-y97qxcfx.js} +9 -9
  75. package/dist/{cli-bc779n4v.js → cli-yq3zak69.js} +1 -1
  76. package/dist/cli.js +17 -17
  77. package/dist/{codex-adapter-ysq6bzha.js → codex-adapter-30j9bpzd.js} +5 -6
  78. package/dist/{codex-hook-fac6175r.js → codex-hook-h3vk6xzr.js} +1 -1
  79. package/dist/{codex-session-runner-qakzfx93.js → codex-session-runner-8vp57v8w.js} +5 -6
  80. package/dist/{commands-rs7hkv9r.js → commands-bngnz9g7.js} +3 -3
  81. package/dist/{controller-r5x9bg6e.js → controller-hxx8wwy1.js} +2 -2
  82. package/dist/{controllers-connect-498hrxvk.js → controllers-connect-e2b4gyxc.js} +20 -20
  83. package/dist/{cursor-adapter-d46qszer.js → cursor-adapter-n5nc3mfe.js} +1 -2
  84. package/dist/{db-s13dqhr6.js → db-bgm7vkc0.js} +3 -3
  85. package/dist/{db-pm96nhdb.js → db-c6np41ca.js} +12 -2
  86. package/dist/{devin-adapter-z46ep5ph.js → devin-adapter-xedz98zv.js} +1 -1
  87. package/dist/{dispatcher-j3h81t7m.js → dispatcher-jnybck15.js} +18 -18
  88. package/dist/{dsh-adapter-rw0d5rc4.js → dsh-adapter-nrhbrjz8.js} +1 -2
  89. package/dist/{easter-egg-3d-qtgfxgze.js → easter-egg-3d-533knw22.js} +1 -1
  90. package/dist/{embedding-space-xh8p4q4x.js → embedding-space-crsm2zp0.js} +6 -6
  91. package/dist/{embeddings-wp745m91.js → embeddings-e7z3f27f.js} +1 -1
  92. package/dist/{execute-2fzb9z74.js → execute-b3mrb1mv.js} +1 -1
  93. package/dist/{external-channel-ys21h3sy.js → external-channel-m77wf5z3.js} +2 -2
  94. package/dist/{fx-adapter-vz0b9z3g.js → fx-adapter-b6w0kf56.js} +7 -8
  95. package/dist/{google-generative-ai-ytpgncx9.js → google-generative-ai-h7s3e9kk.js} +1 -1
  96. package/dist/{google-vertex-tqhze5j7.js → google-vertex-fhxaafzw.js} +1 -1
  97. package/dist/{grok-adapter-spea7zkj.js → grok-adapter-4sqtebdk.js} +7 -8
  98. package/dist/handlers-kdjcyzdj.js +32 -0
  99. package/dist/heartbeat-xgb036sx.js +43 -0
  100. package/dist/{hook-amcj4s10.js → hook-5h02c9ga.js} +6 -6
  101. package/dist/{hook-bc6n49qn.js → hook-xsk1jbha.js} +5 -5
  102. package/dist/{http-7374brv5.js → http-txe7qhvn.js} +448 -165
  103. package/dist/{index-pxn30mse.js → index-0eny15vj.js} +8 -8
  104. package/dist/{index-5a9jtqde.js → index-0rvk3vd4.js} +46 -46
  105. package/dist/{index-fvzke5kx.js → index-1qw6f2dc.js} +10 -10
  106. package/dist/{index-q5cmtbz5.js → index-4a0670yh.js} +15939 -14244
  107. package/dist/index-835xdgnm.js +33 -0
  108. package/dist/index-d469300x.js +37 -0
  109. package/dist/{index-h7f61sy9.js → index-e5pfbsys.js} +3 -3
  110. package/dist/{index-hsad2t3r.js → index-m5gx1xd6.js} +38 -38
  111. package/dist/{index-5fx3b3kw.js → index-rvccek1w.js} +9 -9
  112. package/dist/index-rzqwp11g.js +32 -0
  113. package/dist/{index-w4m9z29z.js → index-tvfafeyy.js} +1 -1
  114. package/dist/{index-c9y31ytf.js → index-vk63emp7.js} +979 -35
  115. package/dist/{index-514d9pf6.js → index-w7em4ktq.js} +8 -8
  116. package/dist/{index-p4hjwbvw.js → index-ysvbhg5m.js} +1 -1
  117. package/dist/{keepalive-wy29kbrg.js → keepalive-4zsrce78.js} +3 -3
  118. package/dist/lead-yqt47dkr.js +70 -0
  119. package/dist/{maintenance-h2ds9w6c.js → maintenance-86jvartk.js} +1 -1
  120. package/dist/{oauth-refresh-sweep-q7mtbyp3.js → oauth-refresh-sweep-j52kg9pr.js} +2 -2
  121. package/dist/{onboard-vw8r2fdw.js → onboard-c2aj5p8q.js} +3 -3
  122. package/dist/{opencode-adapter-mtb0953j.js → opencode-adapter-dsagkhtw.js} +5 -6
  123. package/dist/{otel-impl-j42czw3r.js → otel-impl-yyy203z8.js} +1 -1
  124. package/dist/{pi-mono-adapter-zk8pg9jr.js → pi-mono-adapter-546cd1cc.js} +9 -9
  125. package/dist/{pricing-refresh-x7nhv23d.js → pricing-refresh-1rgzqyzz.js} +2 -3
  126. package/dist/{rbac-roles-9044425x.js → rbac-roles-e70xfeyj.js} +4 -6
  127. package/dist/{rbac-roles-bzvee6cf.js → rbac-roles-q89qe8er.js} +3 -3
  128. package/dist/{registry-hpjfmcfz.js → registry-32b1mft6.js} +1 -1
  129. package/dist/{render-v2-t7bn4skz.js → render-v2-k6tt107q.js} +9 -4
  130. package/dist/{resume-x94gemep.js → resume-cnnrjfxa.js} +6 -6
  131. package/dist/{runtime-breq6fmv.js → runtime-1hv06jsn.js} +1 -1
  132. package/dist/{session-access-q7dmqjvt.js → session-access-xkxkjw3n.js} +4 -4
  133. package/dist/{session-source-backfill-440ysamr.js → session-source-backfill-1d5pdwww.js} +2 -2
  134. package/dist/{setup-07n4727s.js → setup-se8q7gkc.js} +1 -1
  135. package/dist/{virtual-modules-z5h6mcyf.js → virtual-modules-gazyapte.js} +3 -3
  136. package/dist/{work-objects-pnq5y534.js → work-objects-1kxnbzy5.js} +22 -22
  137. package/dist/{worker-follow-up-7z1gfkr8.js → worker-follow-up-zqm8apt4.js} +18 -18
  138. package/dist/worker-j6xxtq7p.js +70 -0
  139. package/openapi.json +334 -7
  140. package/package.json +4 -4
  141. package/src/apps/catalog.generated.json +55 -0
  142. package/src/apps/definition.ts +11 -0
  143. package/src/apps/page-validator.ts +19 -0
  144. package/src/apps/store.ts +28 -8
  145. package/src/assets/key.ts +77 -4
  146. package/src/be/db/model-profiles.ts +147 -38
  147. package/src/be/db/session-labels.ts +57 -0
  148. package/src/be/db/session-tree.ts +51 -7
  149. package/src/be/db/slack-trees.ts +146 -0
  150. package/src/be/db/tasks/read.ts +107 -8
  151. package/src/be/db/workflow-run-definitions.ts +117 -0
  152. package/src/be/db-client.ts +8 -2
  153. package/src/be/db.ts +119 -87
  154. package/src/be/event-loop-lag.ts +146 -0
  155. package/src/be/mcp-overflow-sweep.ts +2 -1
  156. package/src/be/memory/constants.ts +14 -1
  157. package/src/be/memory/key-paths.ts +8 -0
  158. package/src/be/memory/providers/sqlite-store.ts +199 -18
  159. package/src/be/memory/task-learning.ts +79 -14
  160. package/src/be/memory/types.ts +24 -1
  161. package/src/be/migrations/278_slack_render_v2_reconcile.sql +108 -0
  162. package/src/be/migrations/279_backfill_learning_expiry.sql +15 -0
  163. package/src/be/migrations/281_model_profiles_pr2.sql +28 -0
  164. package/src/be/migrations/283_workflow_run_definitions.sql +14 -0
  165. package/src/be/model-profile-check.ts +284 -0
  166. package/src/be/model-tier-resolution.ts +112 -12
  167. package/src/be/multi-runtime.ts +27 -0
  168. package/src/be/runtime-pools/routing.ts +52 -4
  169. package/src/be/scripts/typecheck.ts +1 -0
  170. package/src/be/seed-scripts/catalog/dreaming-learnings.ts +552 -0
  171. package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +389 -14
  172. package/src/be/seed-scripts/catalog/dreaming-memtax.ts +6 -3
  173. package/src/be/seed-scripts/index.ts +9 -0
  174. package/src/be/steering.ts +8 -2
  175. package/src/be/swarm-config-guard.ts +2 -0
  176. package/src/commands/context-preamble.ts +258 -0
  177. package/src/commands/onboard/agent-fs-version.ts +1 -1
  178. package/src/commands/runner.ts +32 -1
  179. package/src/extensions/catalog.generated.json +3 -3
  180. package/src/fs/provider.ts +17 -3
  181. package/src/heartbeat/heartbeat.ts +17 -5
  182. package/src/heartbeat/index.ts +1 -0
  183. package/src/http/agents.ts +56 -4
  184. package/src/http/apps.ts +3 -1
  185. package/src/http/config.ts +2 -6
  186. package/src/http/core.ts +9 -3
  187. package/src/http/index.ts +12 -9
  188. package/src/http/memory.ts +9 -4
  189. package/src/http/model-profiles.ts +58 -10
  190. package/src/http/poll.ts +36 -3
  191. package/src/http/schedules.ts +42 -3
  192. package/src/http/sessions.ts +16 -3
  193. package/src/http/tasks.ts +37 -12
  194. package/src/http/utils.ts +18 -0
  195. package/src/http/webhooks.ts +48 -0
  196. package/src/http/workflows.ts +15 -2
  197. package/src/integrations/chat-sdk/commands.ts +167 -31
  198. package/src/integrations/chat-sdk/inbound.ts +10 -8
  199. package/src/integrations/chat-sdk/message-text.ts +117 -0
  200. package/src/prompts/session-templates.ts +1 -1
  201. package/src/providers/acp-targets.ts +11 -6
  202. package/src/providers/amp-adapter.ts +1 -1
  203. package/src/providers/claude-sdk-session.ts +132 -23
  204. package/src/providers/codex-skill-resolver.ts +10 -4
  205. package/src/providers/cursor-adapter.ts +1 -1
  206. package/src/providers/devin-skill-resolver.ts +5 -5
  207. package/src/providers/dsh-adapter.ts +1 -1
  208. package/src/scheduler/schedule-task.ts +1 -0
  209. package/src/scheduler/scheduler.ts +4 -1
  210. package/src/scripts-runtime/executors/quickjs-runner.ts +2 -0
  211. package/src/scripts-runtime/executors/quickjs-structured-clone.ts +180 -0
  212. package/src/scripts-runtime/quickjs-compat.ts +0 -1
  213. package/src/scripts-runtime/sdk-allowlist.ts +1 -0
  214. package/src/scripts-runtime/swarm-sdk.ts +18 -1
  215. package/src/scripts-runtime/types/stdlib.d.ts +1 -0
  216. package/src/scripts-runtime/types/swarm-sdk.d.ts +1 -0
  217. package/src/server.ts +2 -0
  218. package/src/slack/app.ts +425 -10
  219. package/src/slack/handlers.ts +9 -2
  220. package/src/slack/inbound-dispatch.ts +18 -1
  221. package/src/slack/index.ts +7 -1
  222. package/src/slack/lifecycle-lock.ts +29 -0
  223. package/src/slack/render-v2.ts +424 -212
  224. package/src/slack/socket-fence.ts +64 -0
  225. package/src/slack/watcher.ts +42 -8
  226. package/src/slack/workspace-guard.ts +345 -0
  227. package/src/tasks/task-terminal-effects.ts +4 -0
  228. package/src/tasks/worker-follow-up.ts +102 -2
  229. package/src/tests/acp-adapter.test.ts +82 -0
  230. package/src/tests/apps-icon.test.ts +120 -0
  231. package/src/tests/apps-schema-form.test.ts +151 -0
  232. package/src/tests/chained-task-follow-up.test.ts +248 -0
  233. package/src/tests/chat-sdk-commands.test.ts +359 -2
  234. package/src/tests/chat-sdk-inbound.test.ts +20 -0
  235. package/src/tests/chat-sdk-slack.test.ts +189 -1
  236. package/src/tests/check-pr-body.test.ts +40 -0
  237. package/src/tests/claude-sdk-lifecycle.test.ts +216 -1
  238. package/src/tests/claude-sdk-process.fixture.ts +57 -0
  239. package/src/tests/codex-skill-resolver.test.ts +31 -0
  240. package/src/tests/credentials-allowlist.test.ts +470 -0
  241. package/src/tests/db-client-busy-retry.test.ts +69 -18
  242. package/src/tests/db-client.test.ts +26 -1
  243. package/src/tests/db-task-read-contract.test.ts +7 -0
  244. package/src/tests/db-task-write-contract.test.ts +6 -0
  245. package/src/tests/deferred-wake-follow-up.test.ts +47 -0
  246. package/src/tests/docs-index-footprint.test.js +3 -3
  247. package/src/tests/dreaming-learnings.test.ts +1395 -0
  248. package/src/tests/dsh-adapter.test.ts +1 -1
  249. package/src/tests/event-loop-lag.test.ts +184 -0
  250. package/src/tests/explicit-model-validation.test.ts +2 -0
  251. package/src/tests/extensions-example-comms-adherence-gate.test.ts +115 -0
  252. package/src/tests/fs-provider.test.ts +42 -0
  253. package/src/tests/github-webhook-early-ack.test.ts +144 -0
  254. package/src/tests/heartbeat.test.ts +28 -1
  255. package/src/tests/http-api-integration.test.ts +2 -0
  256. package/src/tests/http-log-scrubbing.test.ts +68 -2
  257. package/src/tests/human-free-reclassify.test.ts +5 -1
  258. package/src/tests/kv-storage.test.ts +92 -1
  259. package/src/tests/list-endpoint-slimming.test.ts +17 -0
  260. package/src/tests/memory-key-paths.test.ts +57 -0
  261. package/src/tests/memory-retrieval-purge.test.ts +19 -0
  262. package/src/tests/migration-283-workflow-run-definitions.test.ts +69 -0
  263. package/src/tests/model-profile-check.test.ts +387 -0
  264. package/src/tests/model-profiles-api.test.ts +528 -1
  265. package/src/tests/profile-claim.test.ts +415 -3
  266. package/src/tests/profile-tier-alias.test.ts +382 -0
  267. package/src/tests/quickjs-compat.test.ts +1 -1
  268. package/src/tests/runner-context-preamble.test.ts +552 -0
  269. package/src/tests/schedule-profile.test.ts +359 -0
  270. package/src/tests/script-connections.test.ts +9 -0
  271. package/src/tests/script-executor-conformance.test.ts +188 -0
  272. package/src/tests/script-per-script-executor.test.ts +1 -0
  273. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +141 -0
  274. package/src/tests/seed-scripts.test.ts +2 -2
  275. package/src/tests/sessions-tree.test.ts +133 -2
  276. package/src/tests/slack-app-icon.test.ts +4 -0
  277. package/src/tests/slack-dm-implicit-mention.test.ts +236 -0
  278. package/src/tests/slack-file-tools-attachments.test.ts +1 -0
  279. package/src/tests/slack-inbound-receipts.test.ts +22 -2
  280. package/src/tests/slack-read-boundaries.test.ts +4 -3
  281. package/src/tests/slack-render-v2-query-plans.test.ts +262 -3
  282. package/src/tests/slack-render-v2-reconcile.test.ts +201 -0
  283. package/src/tests/slack-socket-ack.test.ts +16 -1
  284. package/src/tests/slack-socket-watchdog.test.ts +748 -0
  285. package/src/tests/slack-workspace-guard.test.ts +905 -0
  286. package/src/tests/steering-core.test.ts +40 -0
  287. package/src/tests/store-progress-learning.test.ts +605 -20
  288. package/src/tests/tool-annotations.test.ts +1 -1
  289. package/src/tests/vcs-identity-inheritance.test.ts +85 -0
  290. package/src/tests/workflow-convergence.test.ts +46 -40
  291. package/src/tests/workflow-definition-pinning-recovery.test.ts +552 -0
  292. package/src/tests/workflow-definition-pinning.test.ts +645 -0
  293. package/src/tests/workflow-executors.test.ts +16 -7
  294. package/src/tests/workflow-foreach.test.ts +43 -20
  295. package/src/tests/workflow-notify-slack-ready.test.ts +161 -0
  296. package/src/tests/workflow-profile.test.ts +328 -0
  297. package/src/tools/app-upsert.ts +1 -1
  298. package/src/tools/memory-edit.ts +2 -1
  299. package/src/tools/model-profiles/check-model-profile.ts +63 -0
  300. package/src/tools/schedules/create-schedule.ts +45 -4
  301. package/src/tools/schedules/patch-schedule.ts +50 -4
  302. package/src/tools/schedules/update-schedule.ts +50 -4
  303. package/src/tools/send-task.ts +17 -2
  304. package/src/tools/store-progress.ts +15 -3
  305. package/src/tools/task-action.ts +9 -1
  306. package/src/tools/templates.ts +13 -0
  307. package/src/tools/tool-config.ts +2 -1
  308. package/src/tools/utils.ts +77 -11
  309. package/src/tools/workflows/create-workflow.ts +1 -1
  310. package/src/tools/workflows/retry-workflow-run.ts +1 -1
  311. package/src/tools/workflows/update-workflow.ts +10 -1
  312. package/src/types.ts +56 -1
  313. package/src/utils/credentials.ts +89 -12
  314. package/src/workflows/engine.ts +10 -1
  315. package/src/workflows/executors/agent-task.ts +21 -2
  316. package/src/workflows/executors/foreach.ts +4 -1
  317. package/src/workflows/executors/notify.ts +62 -6
  318. package/src/workflows/executors/sub-workflow.ts +1 -1
  319. package/src/workflows/executors/swarm-script.ts +4 -1
  320. package/src/workflows/foreach-driver.ts +8 -5
  321. package/src/workflows/limits.ts +2 -1
  322. package/src/workflows/model-validation.ts +27 -2
  323. package/src/workflows/patch-definition.ts +3 -1
  324. package/src/workflows/recovery.ts +6 -6
  325. package/src/workflows/resume.ts +9 -9
  326. package/src/workflows/retry-poller.ts +2 -2
  327. package/templates/extensions/comms-adherence-gate/README.md +25 -0
  328. package/templates/extensions/comms-adherence-gate/hooks.ts +100 -11
  329. package/templates/extensions/comms-adherence-gate/manifest.json +1 -1
  330. package/templates/skills/apps/SKILL.md +9 -0
  331. package/templates/skills/apps/content.md +9 -0
  332. package/templates/skills/code-quality/content.md +12 -0
  333. package/templates/skills/memory/content.md +8 -0
  334. package/templates/skills/scheduling/config.json +1 -1
  335. package/templates/skills/scheduling/content.md +2 -2
  336. package/templates/skills/swarm-docs/content.md +4 -0
  337. package/templates/skills/swarm-extensions/content.md +1 -1
  338. package/templates/skills/swarm-scripts/SKILL.md +1 -1
  339. package/templates/skills/swarm-scripts/content.md +1 -1
  340. package/templates/skills/work-on-task/SKILL.md +2 -0
  341. package/templates/skills/work-on-task/content.md +2 -0
  342. package/templates/workflows/dreaming/content.md +174 -7
  343. package/dist/acp-adapter-dn4gdsgr.js +0 -16
  344. package/dist/app-a66ssc4k.js +0 -17
  345. package/dist/cli-530hkwdy.js +0 -779
  346. package/dist/cli-a0657jmf.js +0 -339
  347. package/dist/cli-cyn9v8zr.js +0 -748
  348. package/dist/handlers-crckt5dq.js +0 -32
  349. package/dist/heartbeat-8phn1kdq.js +0 -41
  350. package/dist/index-4x08sjtk.js +0 -30
  351. package/dist/index-8ybffts4.js +0 -37
  352. package/dist/index-nfy4kkg5.js +0 -33
  353. package/dist/lead-zdqxsvjn.js +0 -71
  354. package/dist/worker-y62rvvq3.js +0 -71
  355. package/dist/{cli-gxy8y1dt.js → cli-8bpgbr8k.js} +3 -3
@@ -0,0 +1,470 @@
1
+ // A model profile's credential allowlist: the worker picks pooled keys only
2
+ // from the allowlisted suffixes (`resolveCredentialPools` → `selectCredential`),
3
+ // fails fast when none match, and behaves exactly as before without one. The
4
+ // last block drives the real `/api/poll` handler to check the claim trigger
5
+ // carries the allowlist.
6
+
7
+ import {
8
+ afterAll,
9
+ afterEach,
10
+ beforeAll,
11
+ beforeEach,
12
+ describe,
13
+ expect,
14
+ spyOn,
15
+ test,
16
+ } from "bun:test";
17
+ import { unlink } from "node:fs/promises";
18
+ import { closeDb, createAgent, createTaskExtended, getDbClient, initDb, pauseTask } from "../be/db";
19
+ import { createModelProfile } from "../be/db/model-profiles";
20
+ import { fetchResolvedEnv, getPausedTasksFromAPI } from "../commands/runner";
21
+ import { handlePoll } from "../http/poll";
22
+ import { handleTasks } from "../http/tasks";
23
+ import {
24
+ type AvailabilityInfo,
25
+ CredentialAllowlistError,
26
+ keySuffix,
27
+ ModelWindowExhaustedError,
28
+ resolveCredentialPools,
29
+ selectCredential,
30
+ } from "../utils/credentials";
31
+
32
+ const VAR = "CLAUDE_CODE_OAUTH_TOKEN";
33
+ // Positions 0..3; the allowlist below names positions 1 and 3.
34
+ const POOL = ["tok-aaaaa", "tok-bbbbb", "tok-ccccc", "tok-ddddd"];
35
+ const ALLOWED = ["bbbbb", "ddddd"];
36
+ const ALLOWED_IDX = [1, 3];
37
+
38
+ async function pick(
39
+ info: AvailabilityInfo | undefined,
40
+ opts: {
41
+ allow?: Record<string, string[]>;
42
+ model?: string;
43
+ enforceModelCapacity?: boolean;
44
+ localBlocks?: Map<string, number>;
45
+ } = {},
46
+ ) {
47
+ const env: Record<string, string | undefined> = { [VAR]: POOL.join(",") };
48
+ const selections = await resolveCredentialPools(env, {
49
+ provider: "claude",
50
+ model: opts.model ?? "sonnet",
51
+ availableIndicesMap: info ? { [VAR]: info } : {},
52
+ enforceModelCapacity: opts.enforceModelCapacity,
53
+ localBlocks: opts.localBlocks,
54
+ allowedKeySuffixes: "allow" in opts ? opts.allow : { [VAR]: ALLOWED },
55
+ allowlistProfile: "claude-pinned",
56
+ });
57
+ expect(selections).toHaveLength(1);
58
+ const selection = selections[0]!;
59
+ expect(env[VAR]).toBe(selection.selected);
60
+ return selection;
61
+ }
62
+
63
+ async function indicesOver(draws: number, run: () => ReturnType<typeof pick>) {
64
+ const seen = new Set<number>();
65
+ for (let i = 0; i < draws; i++) seen.add((await run()).index);
66
+ return seen;
67
+ }
68
+
69
+ let logSpy: ReturnType<typeof spyOn>;
70
+ beforeEach(() => {
71
+ logSpy = spyOn(console, "log").mockImplementation(() => {});
72
+ });
73
+ afterEach(() => {
74
+ logSpy.mockRestore();
75
+ });
76
+
77
+ describe("keySuffix", () => {
78
+ test("is the last five characters, the same suffix a task record stamps", () => {
79
+ expect(keySuffix("sk-ant-oat01-xyz12345")).toBe("12345");
80
+ expect(selectCredential("a-11111,b-22222", [1]).keySuffix).toBe(keySuffix("b-22222"));
81
+ });
82
+ });
83
+
84
+ describe("resolveCredentialPools with an allowlist", () => {
85
+ test("maps allowlisted suffixes to their positions in the full 4-key pool", async () => {
86
+ const seen = await indicesOver(200, () => pick(undefined));
87
+ expect([...seen].sort()).toEqual(ALLOWED_IDX);
88
+ const selection = await pick(undefined);
89
+ // Indices stay positions in the full pool: reportKeyUsage and keyIndex are unaffected.
90
+ expect(selection.total).toBe(4);
91
+ expect(selection.selected).toBe(POOL[selection.index]);
92
+ expect(ALLOWED).toContain(selection.keySuffix);
93
+ });
94
+
95
+ test("intersects the server's available indices with the allowlist", async () => {
96
+ const seen = await indicesOver(200, () => pick({ availableIndices: [0, 1, 2] }));
97
+ expect([...seen]).toEqual([1]);
98
+ expect((await pick({ availableIndices: [0, 1, 2] })).isRateLimitFallback).toBe(false);
99
+ });
100
+
101
+ test("all rate-limited: 1,000 draws never leave the allowlist", async () => {
102
+ const seen = new Set<number>();
103
+ for (let i = 0; i < 1000; i++) {
104
+ const selection = await pick({ availableIndices: [] });
105
+ expect(selection.isRateLimitFallback).toBe(true);
106
+ seen.add(selection.index);
107
+ }
108
+ expect([...seen].sort()).toEqual(ALLOWED_IDX);
109
+ });
110
+
111
+ test("only non-allowlisted keys available: picks within the allowlist as a rate-limit fallback", async () => {
112
+ const seen = new Set<number>();
113
+ for (let i = 0; i < 200; i++) {
114
+ const selection = await pick({ availableIndices: [0, 2] });
115
+ expect(selection.isRateLimitFallback).toBe(true);
116
+ seen.add(selection.index);
117
+ }
118
+ expect([...seen].sort()).toEqual(ALLOWED_IDX);
119
+ });
120
+
121
+ test("the seat fallback is restricted to the allowlist", async () => {
122
+ // Key 1 is on a seat without the model; keys 0 and 2 are fine but not allowlisted.
123
+ const info = { availableIndices: [], modelBlockedIndices: [], seatBlockedIndices: [1] };
124
+ const seen = await indicesOver(200, () =>
125
+ pick(info, { model: "opus", enforceModelCapacity: true }),
126
+ );
127
+ expect([...seen]).toEqual([3]);
128
+ });
129
+
130
+ test("every allowlisted key seat-blocked fails fast, though other keys could run it", async () => {
131
+ const info = { availableIndices: [], modelBlockedIndices: [], seatBlockedIndices: [1, 3] };
132
+ const error = await pick(info, { model: "opus", enforceModelCapacity: true }).catch((e) => e);
133
+ expect(error).toBeInstanceOf(ModelWindowExhaustedError);
134
+ expect((error as ModelWindowExhaustedError).seatBlockedCount).toBe(2);
135
+ });
136
+
137
+ test("window exhaustion is counted over the allowlist only", async () => {
138
+ // Keys 0 and 2 have Opus capacity, but both allowlisted keys are window-blocked.
139
+ const exhausted = {
140
+ availableIndices: [0, 2],
141
+ modelBlockedIndices: [1, 3],
142
+ earliestModelResetAt: "2026-10-20T00:00:00.000Z",
143
+ };
144
+ const error = await pick(exhausted, { model: "opus", enforceModelCapacity: true }).catch(
145
+ (e) => e,
146
+ );
147
+ expect(error).toBeInstanceOf(ModelWindowExhaustedError);
148
+ expect((error as ModelWindowExhaustedError).modelBlockedCount).toBe(2);
149
+
150
+ // A window block on a key outside the allowlist does not count: the allowlisted keys
151
+ // are only key-wide rate-limited, so the pick goes ahead within the allowlist.
152
+ const outside = { availableIndices: [2], modelBlockedIndices: [0] };
153
+ const selection = await pick(outside, { model: "opus", enforceModelCapacity: true });
154
+ expect(ALLOWED_IDX).toContain(selection.index);
155
+ expect(selection.isRateLimitFallback).toBe(true);
156
+ });
157
+
158
+ test("a local window block on an allowlisted key is counted too", async () => {
159
+ const localBlocks = new Map([[`${VAR}:1:seven_day_opus`, Date.now() + 60_000]]);
160
+ const error = await pick(
161
+ { availableIndices: [0, 1, 2], modelBlockedIndices: [3] },
162
+ { model: "opus", enforceModelCapacity: true, localBlocks },
163
+ ).catch((e) => e);
164
+ expect(error).toBeInstanceOf(ModelWindowExhaustedError);
165
+ expect((error as ModelWindowExhaustedError).modelBlockedCount).toBe(2);
166
+ });
167
+
168
+ test("zero matches throws CredentialAllowlistError naming the profile and both suffixes", async () => {
169
+ const error = await pick(undefined, { allow: { [VAR]: ["a1b2c", "x9y8z"] } }).catch((e) => e);
170
+ expect(error).toBeInstanceOf(CredentialAllowlistError);
171
+ expect((error as Error).message).toBe(
172
+ `credential allowlist for claude-pinned matches no ${VAR} key (wanted a1b2c, x9y8z)`,
173
+ );
174
+ });
175
+
176
+ test("a single-key pool that is not allowlisted throws too", async () => {
177
+ const env = { [VAR]: "tok-only1" };
178
+ await expect(
179
+ resolveCredentialPools(env, {
180
+ provider: "claude",
181
+ allowedKeySuffixes: { [VAR]: ["abcde"] },
182
+ }),
183
+ ).rejects.toBeInstanceOf(CredentialAllowlistError);
184
+ });
185
+
186
+ test("a var without an entry keeps its whole pool", async () => {
187
+ const seen = await indicesOver(300, () =>
188
+ pick(undefined, { allow: { ANTHROPIC_API_KEY: ["zzzzz"] } }),
189
+ );
190
+ expect([...seen].sort()).toEqual([0, 1, 2, 3]);
191
+ });
192
+ });
193
+
194
+ describe("selectCredential allowedIndices", () => {
195
+ test("bounds the pick-anyway branches", () => {
196
+ const value = POOL.join(",");
197
+ for (let i = 0; i < 500; i++) {
198
+ expect(ALLOWED_IDX).toContain(selectCredential(value, [], VAR, ALLOWED_IDX).index);
199
+ expect(ALLOWED_IDX).toContain(selectCredential(value, [7, 9], VAR, ALLOWED_IDX).index);
200
+ expect(ALLOWED_IDX).toContain(selectCredential(value, undefined, VAR, ALLOWED_IDX).index);
201
+ }
202
+ });
203
+ });
204
+
205
+ describe("no allowlist is byte-identical to today", () => {
206
+ /** A fixed pseudo-random sequence, restarted per run. */
207
+ function seeded(seed: number) {
208
+ let state = seed;
209
+ return () => {
210
+ state = (state * 1103515245 + 12345) % 2147483648;
211
+ return state / 2147483648;
212
+ };
213
+ }
214
+
215
+ async function runSeeded(
216
+ seed: number,
217
+ info: AvailabilityInfo | undefined,
218
+ allow: Record<string, string[]> | undefined,
219
+ ) {
220
+ const rand = seeded(seed);
221
+ const spy = spyOn(Math, "random").mockImplementation(rand);
222
+ try {
223
+ const out: Array<[number, boolean | undefined]> = [];
224
+ for (let i = 0; i < 50; i++) {
225
+ const s = await pick(info, { allow });
226
+ out.push([s.index, s.isRateLimitFallback]);
227
+ }
228
+ return out;
229
+ } finally {
230
+ spy.mockRestore();
231
+ }
232
+ }
233
+
234
+ /** The pre-allowlist picker, inlined: random over all keys, or over the available ones. */
235
+ function legacy(seed: number, available: number[] | undefined) {
236
+ const rand = seeded(seed);
237
+ const out: Array<[number, boolean | undefined]> = [];
238
+ for (let i = 0; i < 50; i++) {
239
+ if (available && available.length > 0) {
240
+ out.push([available[Math.floor(rand() * available.length)]!, false]);
241
+ } else {
242
+ out.push([Math.floor(rand() * POOL.length), available !== undefined]);
243
+ }
244
+ }
245
+ return out;
246
+ }
247
+
248
+ for (const [label, available] of [
249
+ ["no availability info", undefined],
250
+ ["some keys available", [0, 2, 3]],
251
+ ["all rate-limited", []],
252
+ ] as const) {
253
+ test(`same seed, same pick: ${label}`, async () => {
254
+ const info = available ? { availableIndices: [...available] } : undefined;
255
+ const expected = legacy(42, available ? [...available] : undefined);
256
+ expect(await runSeeded(42, info, undefined)).toEqual(expected);
257
+ // An allowlist that covers the whole pool draws the same keys too.
258
+ const all = POOL.map(keySuffix);
259
+ expect(await runSeeded(42, info, { [VAR]: all })).toEqual(expected);
260
+ });
261
+ }
262
+ });
263
+
264
+ describe("fetchResolvedEnv forwards the trigger allowlist", () => {
265
+ let server: ReturnType<typeof Bun.serve>;
266
+ let apiUrl: string;
267
+
268
+ beforeAll(() => {
269
+ server = Bun.serve({
270
+ port: 0,
271
+ fetch(req) {
272
+ const url = new URL(req.url);
273
+ if (url.pathname === "/api/config/resolved") {
274
+ return Response.json({
275
+ configs: [
276
+ { key: VAR, value: POOL.join(",") },
277
+ { key: "HARNESS_PROVIDER", value: "claude" },
278
+ ],
279
+ });
280
+ }
281
+ if (url.pathname === "/api/keys/available") {
282
+ // Every key rate-limited: the pick-anyway branch must still respect the allowlist.
283
+ return Response.json({ success: true, availableIndices: [], totalKeys: 4 });
284
+ }
285
+ return new Response("Not found", { status: 404 });
286
+ },
287
+ });
288
+ apiUrl = server.url.toString().replace(/\/$/, "");
289
+ });
290
+
291
+ afterAll(() => {
292
+ server.stop(true);
293
+ });
294
+
295
+ test("picks only allowlisted keys", async () => {
296
+ for (let i = 0; i < 20; i++) {
297
+ const { env } = await fetchResolvedEnv(apiUrl, "key", "agent-allowlist", {}, "sonnet", {
298
+ provider: "claude",
299
+ enforceModelCapacity: true,
300
+ credentialAllowlist: { [VAR]: ALLOWED },
301
+ resolvedProfile: "claude-pinned",
302
+ });
303
+ expect(ALLOWED).toContain(keySuffix(env[VAR] ?? ""));
304
+ }
305
+ });
306
+
307
+ test("throws CredentialAllowlistError when nothing matches", async () => {
308
+ await expect(
309
+ fetchResolvedEnv(apiUrl, "key", "agent-allowlist", {}, "sonnet", {
310
+ provider: "claude",
311
+ enforceModelCapacity: true,
312
+ credentialAllowlist: { [VAR]: ["nomat"] },
313
+ resolvedProfile: "claude-pinned",
314
+ }),
315
+ ).rejects.toThrow(
316
+ "credential allowlist for claude-pinned matches no CLAUDE_CODE_OAUTH_TOKEN key",
317
+ );
318
+ });
319
+ });
320
+
321
+ describe("the claim trigger carries the profile's allowlist", () => {
322
+ const TEST_DB_PATH = "./test-credentials-allowlist.sqlite";
323
+
324
+ async function removeDbFiles(path: string): Promise<void> {
325
+ for (const suffix of ["", "-wal", "-shm"]) {
326
+ try {
327
+ await unlink(path + suffix);
328
+ } catch (error) {
329
+ if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
330
+ }
331
+ }
332
+ }
333
+
334
+ async function callPoll(agentId: string): Promise<{ task: Record<string, unknown> } | null> {
335
+ let bodyStr = "";
336
+ const req = {
337
+ method: "GET",
338
+ url: "/api/poll",
339
+ headers: { "x-agent-id": agentId },
340
+ } as unknown as Parameters<typeof handlePoll>[0];
341
+ const res = {
342
+ setHeader() {},
343
+ writeHead() {},
344
+ end(body?: string) {
345
+ bodyStr = body ?? "";
346
+ },
347
+ } as unknown as Parameters<typeof handlePoll>[1];
348
+ await handlePoll(req, res, ["api", "poll"], new URLSearchParams(), agentId);
349
+ return (JSON.parse(bodyStr) as { trigger: { task: Record<string, unknown> } | null }).trigger;
350
+ }
351
+
352
+ beforeAll(async () => {
353
+ await removeDbFiles(TEST_DB_PATH);
354
+ initDb(TEST_DB_PATH);
355
+ });
356
+
357
+ afterAll(async () => {
358
+ closeDb();
359
+ await removeDbFiles(TEST_DB_PATH);
360
+ });
361
+
362
+ beforeEach(async () => {
363
+ const client = getDbClient();
364
+ await client.run("DELETE FROM agent_tasks");
365
+ await client.run("DELETE FROM agents");
366
+ await client.run("DELETE FROM model_profiles");
367
+ await createModelProfile({
368
+ name: "claude-pinned",
369
+ harness: "claude",
370
+ model: "opus",
371
+ credentials: { [VAR]: ALLOWED },
372
+ });
373
+ await createModelProfile({ name: "claude-open", harness: "claude", model: "sonnet" });
374
+ });
375
+
376
+ async function claim(profile: string | undefined) {
377
+ const w = await createAgent({
378
+ name: `w-${profile ?? "none"}`,
379
+ isLead: false,
380
+ status: "idle",
381
+ maxTasks: 1,
382
+ harnessProvider: "claude",
383
+ });
384
+ await createTaskExtended("work", { agentId: w.id, ...(profile ? { profile } : {}) });
385
+ return (await callPoll(w.id))?.task;
386
+ }
387
+
388
+ test("a profile with an allowlist puts it on the trigger", async () => {
389
+ const task = await claim("claude-pinned");
390
+ expect(task).toMatchObject({
391
+ resolvedProfile: "claude-pinned",
392
+ credentialAllowlist: { [VAR]: ALLOWED },
393
+ });
394
+ });
395
+
396
+ test("a profile without one, or no profile, leaves it off", async () => {
397
+ expect(await claim("claude-open")).not.toHaveProperty("credentialAllowlist");
398
+ expect(await claim(undefined)).not.toHaveProperty("credentialAllowlist");
399
+ });
400
+
401
+ // Paused-task recovery spawns from `GET /api/paused-tasks`, not a claim
402
+ // trigger. Drives the runner's real fetch and key pick over that response.
403
+ test("a paused task resumes on an allowlisted key", async () => {
404
+ const w = await createAgent({
405
+ name: "w-paused",
406
+ isLead: false,
407
+ status: "idle",
408
+ maxTasks: 1,
409
+ harnessProvider: "claude",
410
+ });
411
+ const created = await createTaskExtended("work", { agentId: w.id, profile: "claude-pinned" });
412
+ expect((await callPoll(w.id))?.task.credentialAllowlist).toEqual({ [VAR]: ALLOWED });
413
+ expect(await pauseTask(created.id)).not.toBeNull();
414
+
415
+ const server = Bun.serve({
416
+ port: 0,
417
+ async fetch(req) {
418
+ const url = new URL(req.url);
419
+ if (url.pathname === "/api/paused-tasks") {
420
+ let body = "";
421
+ const fakeReq = {
422
+ method: "GET",
423
+ url: "/api/paused-tasks",
424
+ headers: { "x-agent-id": w.id },
425
+ } as unknown as Parameters<typeof handleTasks>[0];
426
+ const fakeRes = {
427
+ setHeader() {},
428
+ writeHead() {},
429
+ end(chunk?: string) {
430
+ body = chunk ?? "";
431
+ },
432
+ } as unknown as Parameters<typeof handleTasks>[1];
433
+ await handleTasks(fakeReq, fakeRes, ["api", "paused-tasks"], url.searchParams, w.id);
434
+ return new Response(body, { headers: { "content-type": "application/json" } });
435
+ }
436
+ if (url.pathname === "/api/config/resolved") {
437
+ return Response.json({
438
+ configs: [
439
+ { key: VAR, value: POOL.join(",") },
440
+ { key: "HARNESS_PROVIDER", value: "claude" },
441
+ ],
442
+ });
443
+ }
444
+ if (url.pathname === "/api/keys/available") {
445
+ return Response.json({ success: true, availableIndices: [0, 1, 2, 3], totalKeys: 4 });
446
+ }
447
+ return new Response("Not found", { status: 404 });
448
+ },
449
+ });
450
+ const apiUrl = server.url.toString().replace(/\/$/, "");
451
+ try {
452
+ const [paused] = await getPausedTasksFromAPI({ apiUrl, apiKey: "key", agentId: w.id });
453
+ expect(paused?.id).toBe(created.id);
454
+ const seen = new Set<string>();
455
+ for (let i = 0; i < 40; i++) {
456
+ const { env } = await fetchResolvedEnv(apiUrl, "key", w.id, {}, "opus", {
457
+ provider: "claude",
458
+ taskId: paused!.id,
459
+ enforceModelCapacity: true,
460
+ resolvedProfile: paused!.resolvedProfile,
461
+ credentialAllowlist: paused!.credentialAllowlist,
462
+ });
463
+ seen.add(keySuffix(env[VAR] ?? ""));
464
+ }
465
+ expect([...seen].filter((suffix) => !ALLOWED.includes(suffix))).toEqual([]);
466
+ } finally {
467
+ server.stop(true);
468
+ }
469
+ });
470
+ });
@@ -1,5 +1,5 @@
1
1
  import { Database } from "bun:sqlite";
2
- import { afterEach, beforeEach, describe, expect, test } from "bun:test";
2
+ import { afterEach, beforeEach, describe, expect, spyOn, test } from "bun:test";
3
3
  import { unlink } from "node:fs/promises";
4
4
  import { createBunSqliteClient, type DbClient } from "../be/db-client";
5
5
 
@@ -319,29 +319,80 @@ describe("db-client SQLITE_BUSY retry", () => {
319
319
  finalAttemptSpinMs: 50,
320
320
  });
321
321
  const writers = 60;
322
+ // The gate logs "(N spinning probes)" when the episode ends. Counting
323
+ // probes measures the thing that blocks the loop (each probe is one
324
+ // synchronous attemptSpinMs wait) without sampling wall-clock timer lag,
325
+ // which stalls for 700-1100ms on loaded CI runners although the gate held.
326
+ const warn = spyOn(console, "warn").mockImplementation(() => {});
327
+ // Record every driver attempt with the busy_timeout it ran under and
328
+ // whether it hit BUSY. The gate's own probe count cannot see attempts it
329
+ // classed as gated, so this checks what the driver was actually told to
330
+ // wait, independent of the gate's bookkeeping and of runner scheduling.
331
+ const attempts: { spinMs: number; busy: boolean }[] = [];
332
+ let busyTimeoutMs = -1;
333
+ const exec = main.exec.bind(main);
334
+ const query = main.query.bind(main);
335
+ const execSpy = spyOn(main, "exec").mockImplementation(((sql: string) => {
336
+ const set = /^PRAGMA busy_timeout = (\d+)$/.exec(sql);
337
+ if (set) busyTimeoutMs = Number(set[1]);
338
+ return exec(sql);
339
+ }) as typeof main.exec);
340
+ const querySpy = spyOn(main, "query").mockImplementation(((sql: string) => {
341
+ const stmt = query(sql);
342
+ if (!sql.startsWith("INSERT INTO items")) return stmt;
343
+ return {
344
+ run: (...params: unknown[]) => {
345
+ const spinMs = busyTimeoutMs;
346
+ try {
347
+ const out = stmt.run(...(params as never[]));
348
+ attempts.push({ spinMs, busy: false });
349
+ return out;
350
+ } catch (err) {
351
+ attempts.push({ spinMs, busy: (err as { code?: string }).code === "SQLITE_BUSY" });
352
+ throw err;
353
+ }
354
+ },
355
+ };
356
+ }) as unknown as typeof main.query);
322
357
  const released = holdWriteLock(1_500);
323
358
 
324
- let maxLagMs = 0;
325
- let last = performance.now();
326
- const ticker = setInterval(() => {
327
- const now = performance.now();
328
- maxLagMs = Math.max(maxLagMs, now - last - 10);
329
- last = now;
330
- }, 10);
331
-
332
359
  const startedAt = performance.now();
333
- const results = await Promise.allSettled(
334
- Array.from({ length: writers }, (_, i) =>
335
- crowdClient.run("INSERT INTO items (name) VALUES (?)", [`crowd-${i}`]),
336
- ),
337
- );
360
+ let results: PromiseSettledResult<unknown>[];
361
+ try {
362
+ results = await Promise.allSettled(
363
+ Array.from({ length: writers }, (_, i) =>
364
+ crowdClient.run("INSERT INTO items (name) VALUES (?)", [`crowd-${i}`]),
365
+ ),
366
+ );
367
+ } finally {
368
+ await released;
369
+ execSpy.mockRestore();
370
+ querySpy.mockRestore();
371
+ }
338
372
  const wallMs = performance.now() - startedAt;
339
- clearInterval(ticker);
340
- await released;
373
+ const messages = warn.mock.calls.map((c) => String(c[0]));
374
+ warn.mockRestore();
341
375
 
342
376
  expect(results.every((r) => r.status === "fulfilled")).toBe(true);
343
- // Ungated: 60 writers x 50ms = 3s of blocked loop per round of attempts.
344
- expect(maxLagMs).toBeLessThan(500);
377
+ const episode = messages.map((m) => /released after \d+ms \((\d+) spinning probes\)/.exec(m));
378
+ const probes = Number(episode.find((m) => m)?.[1]);
379
+ // The episode must have been observed and closed, or the count proves nothing.
380
+ expect(Number.isFinite(probes)).toBe(true);
381
+ // Ungated every one of the 60 writers spins on every round of attempts
382
+ // (60 x 50ms = 3s of blocked loop per round). Gated, only one probe runs
383
+ // per gate interval (50, 100, 200, 400, 800ms), so a 1.5s hold needs ~6.
384
+ expect(probes).toBeGreaterThan(0);
385
+ expect(probes).toBeLessThanOrEqual(15);
386
+ const busy = attempts.filter((a) => a.busy);
387
+ const spinning = busy.filter((a) => a.spinMs > 0).length;
388
+ // Every other writer hit the held lock with a zero busy_timeout, so it
389
+ // failed in microseconds instead of blocking the loop. Without the gate
390
+ // there are no such attempts at all.
391
+ expect(busy.length - spinning).toBeGreaterThan(writers);
392
+ // The only BUSY attempts allowed to wait are the gate's probes: a gated
393
+ // attempt that waits any time (even 10ms x hundreds of attempts) shows up
394
+ // here as more spinning attempts than the gate reported probes.
395
+ expect(spinning).toBe(probes);
345
396
  // Ungated the crowd needed several seconds of spin rounds after release.
346
397
  expect(wallMs).toBeLessThan(3_000);
347
398
  const rows = await crowdClient.query<{ n: number }>(
@@ -4,6 +4,8 @@ import { mkdtempSync, rmSync } from "node:fs";
4
4
  import { tmpdir } from "node:os";
5
5
  import { join } from "node:path";
6
6
  import { createBunSqliteClient, type DbClient, type DbExecutor } from "../be/db-client";
7
+ import { withLoopPath } from "../be/event-loop-lag";
8
+ import { clearVolatileSecretsForTesting, registerVolatileSecret } from "../utils/secret-scrubber";
7
9
 
8
10
  let raw: Database;
9
11
  let client: DbClient;
@@ -452,7 +454,7 @@ describe("db-client slow statement warning", () => {
452
454
  expect(elapsedMs).toBeGreaterThan(100);
453
455
  const lines = slowWarnings(warn);
454
456
  expect(lines).toHaveLength(1);
455
- expect(lines[0]).toMatch(/blocked the event loop for \d+ms: \/\* padding/);
457
+ expect(lines[0]).toMatch(/blocked the event loop for \d+ms path=unknown: \/\* padding/);
456
458
  expect(lines[0]).not.toContain(PARAM_SECRET);
457
459
  expect(lines[0]).not.toContain("WITH RECURSIVE");
458
460
  expect(lines[0]?.endsWith("…")).toBe(true);
@@ -461,6 +463,29 @@ describe("db-client slow statement warning", () => {
461
463
  }
462
464
  });
463
465
 
466
+ test("scrubs a secret that straddles the SQL cutoff and a secret in the path", async () => {
467
+ const secret = "slowsqlSECRET0123456789abcdef"; // gitleaks:allow (synthetic test fixture)
468
+ registerVolatileSecret(secret, "SLOW_SQL_TEST_SECRET");
469
+ // "/* " plus 186 chars puts the secret at char 189, across the 200-char cut.
470
+ const sql = `/* ${"p".repeat(185)} ${secret} */ WITH RECURSIVE c(x) AS (SELECT 1 UNION ALL SELECT x + 1 FROM c WHERE x < ?) SELECT count(*) AS n FROM c WHERE ? IS NOT NULL`;
471
+ expect(sql.indexOf(secret)).toBeLessThan(200);
472
+ expect(sql.indexOf(secret) + secret.length).toBeGreaterThan(200);
473
+ const warn = spyOn(console, "warn").mockImplementation(() => {});
474
+ try {
475
+ const startedAt = performance.now();
476
+ await withLoopPath(`route ${secret}`, () => client.get(sql, [SLOW_ROWS, PARAM_SECRET]));
477
+ expect(performance.now() - startedAt).toBeGreaterThan(100);
478
+ const lines = slowWarnings(warn);
479
+ expect(lines).toHaveLength(1);
480
+ expect(lines[0]).not.toContain(secret.slice(0, 10));
481
+ expect(lines[0]).toContain("path=route [REDACTED:SLOW_SQL_TEST_SECRET]");
482
+ expect(lines[0]).toContain("[REDACTED:SLOW_SQL_TEST_SECRET]");
483
+ } finally {
484
+ warn.mockRestore();
485
+ clearVolatileSecretsForTesting();
486
+ }
487
+ });
488
+
464
489
  test("logs a slow statement run inside a transaction", async () => {
465
490
  const warn = spyOn(console, "warn").mockImplementation(() => {});
466
491
  try {
@@ -73,6 +73,7 @@ type:McpServerInsert
73
73
  type:MentionPreview
74
74
  type:PageListOptions
75
75
  type:PendingChatRelay
76
+ type:PinnedWorkflowDefinition
76
77
  type:PlanSource
77
78
  type:RecordBudgetRefusalNotificationInput
78
79
  type:ScheduledTaskFilters
@@ -108,6 +109,7 @@ value:ExtensionAgentAssignmentError
108
109
  value:KvTypeCollisionError
109
110
  value:MAX_EMPTY_POLLS
110
111
  value:NOT_EXTENSION_AGENT_SQL
112
+ value:PINNED_WORKFLOW_KEYS
111
113
  value:ReservedAgentRoleError
112
114
  value:SESSION_ACTIVITY_REFRESH_MIN_INTERVAL_MS
113
115
  value:SKILL_FILE_LIMITS
@@ -316,6 +318,7 @@ value:getLatestPageBySlug
316
318
  value:getLatestScriptRunStepTaskByContextKey
317
319
  value:getLatestStepForNode
318
320
  value:getLatestTaskByContextKey
321
+ value:getLatestTaskByContextKeyPrefix
319
322
  value:getLeadAgent
320
323
  value:getLiveAgentCounts
321
324
  value:getLogsByAgentId
@@ -364,6 +367,7 @@ value:getResolvableDeferralOutcomes
364
367
  value:getResolvedConfig
365
368
  value:getRetryableSteps
366
369
  value:getRootTaskChain
370
+ value:getRunWorkflow
367
371
  value:getRunningScriptRuns
368
372
  value:getScheduledTaskById
369
373
  value:getScheduledTaskByName
@@ -521,6 +525,7 @@ value:normalizeSkillFilePath
521
525
  value:noteSlackOutcomeDeliveryFailure
522
526
  value:overwriteTerminalTaskResultText
523
527
  value:pauseTask
528
+ value:pinWorkflowDefinition
524
529
  value:postMessage
525
530
  value:promoteAbandonedDraftTasks
526
531
  value:promoteDraftTask
@@ -576,6 +581,7 @@ value:startTask
576
581
  value:supersedeTask
577
582
  value:sweepExpiredKv
578
583
  value:sweepExpiredKvPrefix
584
+ value:toPinnedDefinition
579
585
  value:toggleAgentSkill
580
586
  value:uninstallMcpServer
581
587
  value:uninstallSkill
@@ -651,6 +657,7 @@ value:getLatestLeadTaskByContextKey
651
657
  value:getLatestLeadTaskInThread
652
658
  value:getLatestScriptRunStepTaskByContextKey
653
659
  value:getLatestTaskByContextKey
660
+ value:getLatestTaskByContextKeyPrefix
654
661
  value:getMostRecentTaskInThread
655
662
  value:getPendingChatRelayTasks
656
663
  value:getPendingSlackRelayTasks