@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,645 @@
1
+ import { afterAll, afterEach, beforeAll, describe, expect, test } from "bun:test";
2
+ import { unlink } from "node:fs/promises";
3
+ import { z } from "zod";
4
+ import * as db from "../be/db";
5
+ import {
6
+ closeDb,
7
+ completeTask,
8
+ createWorkflow,
9
+ deleteWorkflow,
10
+ failTask,
11
+ getDbClient,
12
+ getTaskByWorkflowRunStepId,
13
+ getWaitStateByStepId,
14
+ getWorkflow,
15
+ getWorkflowRun,
16
+ getWorkflowRunStepsByRunId,
17
+ initDb,
18
+ PINNED_WORKFLOW_KEYS,
19
+ pinWorkflowDefinition,
20
+ resolveWaitState,
21
+ toPinnedDefinition,
22
+ } from "../be/db";
23
+ import { hashPinnedDefinition, mergePinnedDefinition } from "../be/db/workflow-run-definitions";
24
+ import {
25
+ type ExecutorMeta,
26
+ type Workflow,
27
+ type WorkflowDefinition,
28
+ type WorkflowNode,
29
+ type WorkflowRunStep,
30
+ type WorkflowSnapshot,
31
+ WorkflowSnapshotSchema,
32
+ } from "../types";
33
+ import { startWorkflowExecution } from "../workflows/engine";
34
+ import { workflowEventBus } from "../workflows/event-bus";
35
+ import {
36
+ BaseExecutor,
37
+ type ExecutorDependencies,
38
+ type ExecutorResult,
39
+ } from "../workflows/executors/base";
40
+ import { createExecutorRegistry, type ExecutorRegistry } from "../workflows/executors/registry";
41
+ import {
42
+ recoverResolvedWaitState,
43
+ resumeWaitState,
44
+ retryFailedRun,
45
+ setupWorkflowResumeListener,
46
+ } from "../workflows/resume";
47
+ import { startRetryPoller, stopRetryPoller } from "../workflows/retry-poller";
48
+ import { interpolate } from "../workflows/template";
49
+ import { snapshotAndUpdateWorkflow } from "../workflows/version";
50
+
51
+ // Each test starts a run on definition A (`n1 → a2`), edits the workflow to B
52
+ // (`n1 → b2`, with a changed config value) through the real edit path, then
53
+ // drives one resume path. The run must finish on A.
54
+
55
+ const TEST_DB_PATH = "./test-workflow-definition-pinning.sqlite";
56
+
57
+ type Variant = "A" | "B";
58
+
59
+ /** Every instant node execution: which run, which node, which config tag. */
60
+ const executions: { runId: string; nodeId: string; tag: string }[] = [];
61
+
62
+ class ProbeExecutor extends BaseExecutor<typeof ProbeExecutor.schema, typeof ProbeExecutor.out> {
63
+ static readonly schema = z.object({ tag: z.string() });
64
+ static readonly out = z.object({ tag: z.string() });
65
+ readonly type = "probe";
66
+ readonly mode = "instant" as const;
67
+ readonly configSchema = ProbeExecutor.schema;
68
+ readonly outputSchema = ProbeExecutor.out;
69
+
70
+ protected async execute(
71
+ config: z.infer<typeof ProbeExecutor.schema>,
72
+ _context: Readonly<Record<string, unknown>>,
73
+ meta: ExecutorMeta,
74
+ ): Promise<ExecutorResult<z.infer<typeof ProbeExecutor.out>>> {
75
+ executions.push({ runId: meta.runId, nodeId: meta.nodeId, tag: config.tag });
76
+ return { status: "success", output: { tag: config.tag } };
77
+ }
78
+ }
79
+
80
+ /** Fails until `gateOpen` is set; records the config tag it ran with. */
81
+ let gateOpen = false;
82
+ class GateExecutor extends BaseExecutor<typeof GateExecutor.schema, typeof GateExecutor.out> {
83
+ static readonly schema = z.object({ tag: z.string() });
84
+ static readonly out = z.object({ tag: z.string() });
85
+ readonly type = "gate";
86
+ readonly mode = "instant" as const;
87
+ readonly configSchema = GateExecutor.schema;
88
+ readonly outputSchema = GateExecutor.out;
89
+
90
+ protected async execute(
91
+ config: z.infer<typeof GateExecutor.schema>,
92
+ _context: Readonly<Record<string, unknown>>,
93
+ meta: ExecutorMeta,
94
+ ): Promise<ExecutorResult<z.infer<typeof GateExecutor.out>>> {
95
+ executions.push({ runId: meta.runId, nodeId: meta.nodeId, tag: config.tag });
96
+ if (!gateOpen) return { status: "failed", error: "gate closed" };
97
+ return { status: "success", output: { tag: config.tag } };
98
+ }
99
+ }
100
+
101
+ /** Records the key order of its config objects, as a script or System One node iterates them. */
102
+ const keyOrders: { runId: string; args: string[]; nested: string[] }[] = [];
103
+ class OrderExecutor extends BaseExecutor<typeof OrderExecutor.schema, typeof OrderExecutor.out> {
104
+ static readonly schema = z.object({
105
+ args: z.record(z.string(), z.unknown()),
106
+ nested: z.record(z.string(), z.unknown()),
107
+ });
108
+ static readonly out = z.object({ args: z.array(z.string()) });
109
+ readonly type = "order";
110
+ readonly mode = "instant" as const;
111
+ readonly configSchema = OrderExecutor.schema;
112
+ readonly outputSchema = OrderExecutor.out;
113
+
114
+ protected async execute(
115
+ config: z.infer<typeof OrderExecutor.schema>,
116
+ _context: Readonly<Record<string, unknown>>,
117
+ meta: ExecutorMeta,
118
+ ): Promise<ExecutorResult<z.infer<typeof OrderExecutor.out>>> {
119
+ const args = Object.keys(config.args);
120
+ keyOrders.push({ runId: meta.runId, args, nested: Object.keys(config.nested) });
121
+ return { status: "success", output: { args } };
122
+ }
123
+ }
124
+
125
+ class MockHitlExecutor extends BaseExecutor<
126
+ typeof MockHitlExecutor.schema,
127
+ typeof MockHitlExecutor.out
128
+ > {
129
+ static readonly schema = z.object({ title: z.string() });
130
+ static readonly out = z.object({
131
+ requestId: z.string(),
132
+ status: z.string(),
133
+ responses: z.record(z.string(), z.unknown()).nullable(),
134
+ });
135
+ readonly type = "mock-hitl";
136
+ readonly mode = "async" as const;
137
+ readonly configSchema = MockHitlExecutor.schema;
138
+ readonly outputSchema = MockHitlExecutor.out;
139
+ lastRequestId: string | null = null;
140
+
141
+ protected async execute(
142
+ config: z.infer<typeof MockHitlExecutor.schema>,
143
+ _context: Readonly<Record<string, unknown>>,
144
+ meta: ExecutorMeta,
145
+ ): Promise<ExecutorResult<z.infer<typeof MockHitlExecutor.out>>> {
146
+ const requestId = crypto.randomUUID();
147
+ this.lastRequestId = requestId;
148
+ await this.deps.db.createApprovalRequest({
149
+ id: requestId,
150
+ title: config.title,
151
+ questions: [{ id: "q1", type: "approval", label: "Approve?", required: true }],
152
+ approvers: { policy: "any" as const },
153
+ workflowRunId: meta.runId,
154
+ workflowRunStepId: meta.stepId,
155
+ });
156
+ return {
157
+ status: "success",
158
+ async: true,
159
+ waitFor: "approval.resolved",
160
+ correlationId: requestId,
161
+ } as unknown as ExecutorResult<z.infer<typeof MockHitlExecutor.out>>;
162
+ }
163
+ }
164
+
165
+ const deps: ExecutorDependencies = {
166
+ db: db as typeof import("../be/db"),
167
+ eventBus: workflowEventBus,
168
+ interpolate: (template, ctx) => interpolate(template, ctx).result,
169
+ };
170
+
171
+ let registry: ExecutorRegistry;
172
+ let teardownResumeListener: (() => void) | undefined;
173
+ const createdWorkflowIds: string[] = [];
174
+ let counter = 0;
175
+
176
+ beforeAll(() => {
177
+ initDb(TEST_DB_PATH);
178
+ registry = createExecutorRegistry(deps);
179
+ registry.register(new ProbeExecutor(deps));
180
+ registry.register(new GateExecutor(deps));
181
+ registry.register(new OrderExecutor(deps));
182
+ registry.register(new MockHitlExecutor(deps));
183
+ teardownResumeListener = setupWorkflowResumeListener(workflowEventBus, registry);
184
+ });
185
+
186
+ afterEach(() => {
187
+ stopRetryPoller();
188
+ gateOpen = false;
189
+ });
190
+
191
+ afterAll(async () => {
192
+ // Detach from the process-wide bus: a leaked listener resumes runs in later files.
193
+ teardownResumeListener?.();
194
+ stopRetryPoller();
195
+ for (const id of createdWorkflowIds) {
196
+ await deleteWorkflow(id).catch(() => {});
197
+ }
198
+ closeDb();
199
+ for (const suffix of ["", "-wal", "-shm"]) {
200
+ await unlink(`${TEST_DB_PATH}${suffix}`).catch(() => {});
201
+ }
202
+ });
203
+
204
+ // ─── Helpers ─────────────────────────────────────────────────
205
+
206
+ type FirstNode = (variant: Variant, successor: string) => WorkflowNode;
207
+
208
+ /** `n1 → a2` for A, `n1 → b2` for B; the successor probe carries the variant tag. */
209
+ function twoNode(variant: Variant, first: FirstNode, extra: Partial<WorkflowDefinition> = {}) {
210
+ const successor = variant === "A" ? "a2" : "b2";
211
+ return {
212
+ ...extra,
213
+ nodes: [first(variant, successor), { id: successor, type: "probe", config: { tag: variant } }],
214
+ } as WorkflowDefinition;
215
+ }
216
+
217
+ const agentTaskFirst: FirstNode = (variant, successor) => ({
218
+ id: "n1",
219
+ type: "agent-task",
220
+ config: { template: `Work ${variant}` },
221
+ next: successor,
222
+ });
223
+
224
+ async function makeWorkflow(
225
+ definition: WorkflowDefinition,
226
+ extra: Partial<Parameters<typeof createWorkflow>[0]> = {},
227
+ ): Promise<Workflow> {
228
+ counter++;
229
+ const workflow = await createWorkflow({
230
+ name: `pinning-${counter}-${Date.now()}`,
231
+ definition,
232
+ ...extra,
233
+ });
234
+ createdWorkflowIds.push(workflow.id);
235
+ return workflow;
236
+ }
237
+
238
+ async function editTo(workflowId: string, definition: WorkflowDefinition, extra = {}) {
239
+ const { workflow } = await snapshotAndUpdateWorkflow(workflowId, { definition, ...extra });
240
+ expect(workflow?.definition.nodes.map((n) => n.id)).toEqual(definition.nodes.map((n) => n.id));
241
+ }
242
+
243
+ async function waitFor<T>(
244
+ probe: () => Promise<T | null | undefined | false>,
245
+ label: string,
246
+ timeoutMs = 3000,
247
+ ): Promise<T> {
248
+ const deadline = Date.now() + timeoutMs;
249
+ while (Date.now() < deadline) {
250
+ const value = await probe();
251
+ if (value) return value;
252
+ await new Promise((r) => setTimeout(r, 10));
253
+ }
254
+ throw new Error(`Timed out waiting for ${label}`);
255
+ }
256
+
257
+ async function stepFor(runId: string, nodeId: string): Promise<WorkflowRunStep> {
258
+ const step = (await getWorkflowRunStepsByRunId(runId)).find((s) => s.nodeId === nodeId);
259
+ if (!step) throw new Error(`no ${nodeId} step in run ${runId}`);
260
+ return step;
261
+ }
262
+
263
+ async function waitForRunStatus(runId: string, status: string) {
264
+ return waitFor(async () => {
265
+ const run = await getWorkflowRun(runId);
266
+ return run?.status === status ? run : null;
267
+ }, `run ${runId} ${status}`);
268
+ }
269
+
270
+ /** The run walked `variant`'s successor with `variant`'s config, and never the other one. */
271
+ async function expectFollowed(runId: string, variant: Variant) {
272
+ const [own, other] = variant === "A" ? ["a2", "b2"] : ["b2", "a2"];
273
+ const nodeIds = (await getWorkflowRunStepsByRunId(runId)).map((s) => s.nodeId);
274
+ expect(nodeIds).toContain(own);
275
+ expect(nodeIds).not.toContain(other);
276
+ const successorTags = executions
277
+ .filter((e) => e.runId === runId && e.nodeId !== "n1")
278
+ .map((e) => `${e.nodeId}:${e.tag}`);
279
+ expect(successorTags).toEqual([`${own}:${variant}`]);
280
+ }
281
+
282
+ /** `workflow_runs.definitionHash` is internal: not on the public `WorkflowRun`. */
283
+ async function pinHash(runId: string): Promise<string | null> {
284
+ const row = await getDbClient().get<{ definitionHash: string | null }>(
285
+ "SELECT definitionHash FROM workflow_runs WHERE id = ?",
286
+ [runId],
287
+ );
288
+ return row?.definitionHash ?? null;
289
+ }
290
+
291
+ async function startOnA(workflow: Workflow): Promise<string> {
292
+ const runId = await startWorkflowExecution(workflow, {}, registry);
293
+ expect(await pinHash(runId)).toBeTruthy();
294
+ return runId;
295
+ }
296
+
297
+ async function completeN1Task(runId: string, output = "done") {
298
+ const task = await getTaskByWorkflowRunStepId((await stepFor(runId, "n1")).id);
299
+ expect(task).toBeTruthy();
300
+ await completeTask(task!.id, output);
301
+ }
302
+
303
+ // ─── Resume paths ────────────────────────────────────────────
304
+
305
+ describe("a run finishes on the definition it started with", () => {
306
+ test("task completion resumes on A after an edit to B", async () => {
307
+ const workflow = await makeWorkflow(twoNode("A", agentTaskFirst));
308
+ const runId = await startOnA(workflow);
309
+ expect((await getWorkflowRun(runId))?.status).toBe("waiting");
310
+
311
+ await editTo(workflow.id, twoNode("B", agentTaskFirst));
312
+ await completeN1Task(runId);
313
+
314
+ await waitForRunStatus(runId, "completed");
315
+ await expectFollowed(runId, "A");
316
+ });
317
+
318
+ test("task failure follows A's onNodeFailure, not B's", async () => {
319
+ const workflow = await makeWorkflow(
320
+ twoNode("A", agentTaskFirst, { onNodeFailure: "continue" }),
321
+ );
322
+ const runId = await startOnA(workflow);
323
+
324
+ await editTo(workflow.id, twoNode("B", agentTaskFirst, { onNodeFailure: "fail" }));
325
+ const task = await getTaskByWorkflowRunStepId((await stepFor(runId, "n1")).id);
326
+ await failTask(task!.id, "agent crashed");
327
+
328
+ // B would fail the run; A continues past the failed node to a2.
329
+ await waitForRunStatus(runId, "completed");
330
+ await expectFollowed(runId, "A");
331
+ });
332
+
333
+ test("manual retry re-executes A's failed node and successor", async () => {
334
+ const gateFirst: FirstNode = (variant, successor) => ({
335
+ id: "n1",
336
+ type: "gate",
337
+ config: { tag: variant },
338
+ next: successor,
339
+ });
340
+ const workflow = await makeWorkflow(twoNode("A", gateFirst));
341
+ const runId = await startWorkflowExecution(workflow, {}, registry);
342
+ expect((await getWorkflowRun(runId))?.status).toBe("failed");
343
+
344
+ await editTo(workflow.id, twoNode("B", gateFirst));
345
+ gateOpen = true;
346
+ await retryFailedRun(runId, registry);
347
+
348
+ await waitForRunStatus(runId, "completed");
349
+ expect(
350
+ executions.filter((e) => e.runId === runId && e.nodeId === "n1").map((e) => e.tag),
351
+ ).toEqual(["A", "A"]);
352
+ await expectFollowed(runId, "A");
353
+ });
354
+
355
+ test("the retry poller re-executes A's node config", async () => {
356
+ const retry = { maxRetries: 1, strategy: "static" as const, baseDelayMs: 0, maxDelayMs: 0 };
357
+ const gateFirst: FirstNode = (variant, successor) => ({
358
+ id: "n1",
359
+ type: "gate",
360
+ config: { tag: variant },
361
+ retry,
362
+ next: successor,
363
+ });
364
+ const workflow = await makeWorkflow(twoNode("A", gateFirst));
365
+ const runId = await startWorkflowExecution(workflow, {}, registry);
366
+ const queued = await stepFor(runId, "n1");
367
+ expect(queued.status).toBe("failed");
368
+ expect(queued.nextRetryAt).toBeTruthy();
369
+
370
+ await editTo(workflow.id, twoNode("B", gateFirst));
371
+ gateOpen = true;
372
+ startRetryPoller(registry, 10);
373
+
374
+ await waitForRunStatus(runId, "completed");
375
+ stopRetryPoller();
376
+ expect(
377
+ executions.filter((e) => e.runId === runId && e.nodeId === "n1").map((e) => e.tag),
378
+ ).toEqual(["A", "A"]);
379
+ await expectFollowed(runId, "A");
380
+ });
381
+
382
+ test("approval resolution routes on A's ports", async () => {
383
+ const hitlFirst: FirstNode = (variant, successor) => ({
384
+ id: "n1",
385
+ type: "mock-hitl",
386
+ config: { title: `Review ${variant}` },
387
+ next: { approved: successor },
388
+ });
389
+ const workflow = await makeWorkflow(twoNode("A", hitlFirst));
390
+ const runId = await startOnA(workflow);
391
+ const requestId = (registry.get("mock-hitl") as MockHitlExecutor).lastRequestId!;
392
+
393
+ await editTo(workflow.id, twoNode("B", hitlFirst));
394
+ workflowEventBus.emit("approval.resolved", {
395
+ requestId,
396
+ status: "approved",
397
+ responses: { q1: true },
398
+ workflowRunId: runId,
399
+ workflowRunStepId: (await stepFor(runId, "n1")).id,
400
+ });
401
+
402
+ await waitForRunStatus(runId, "completed");
403
+ await expectFollowed(runId, "A");
404
+ });
405
+
406
+ const waitFirst: FirstNode = (_variant, successor) => ({
407
+ id: "n1",
408
+ type: "wait",
409
+ config: { mode: "time", durationMs: 10 },
410
+ next: { default: successor },
411
+ });
412
+
413
+ test("a claimed wait (resumeWaitState) continues on A", async () => {
414
+ const workflow = await makeWorkflow(twoNode("A", waitFirst));
415
+ const runId = await startOnA(workflow);
416
+ const wait = await getWaitStateByStepId((await stepFor(runId, "n1")).id);
417
+ expect(wait?.status).toBe("pending");
418
+
419
+ await editTo(workflow.id, twoNode("B", waitFirst));
420
+ await resumeWaitState(wait!.id, "fired", undefined, registry);
421
+
422
+ await waitForRunStatus(runId, "completed");
423
+ await expectFollowed(runId, "A");
424
+ });
425
+
426
+ test("a resolved wait recovered after a crash (recoverResolvedWaitState) continues on A", async () => {
427
+ const workflow = await makeWorkflow(twoNode("A", waitFirst));
428
+ const runId = await startOnA(workflow);
429
+ const wait = await getWaitStateByStepId((await stepFor(runId, "n1")).id);
430
+ // The wait resolved, then the process died before the step checkpoint.
431
+ expect((await resolveWaitState(wait!.id, { status: "fired" })).updated).toBe(true);
432
+ expect((await stepFor(runId, "n1")).status).toBe("waiting");
433
+
434
+ await editTo(workflow.id, twoNode("B", waitFirst));
435
+ await recoverResolvedWaitState(wait!.id, registry);
436
+
437
+ await waitForRunStatus(runId, "completed");
438
+ await expectFollowed(runId, "A");
439
+ });
440
+
441
+ test("a later agent-task step inherits A's workflow dir, not one B adds", async () => {
442
+ const definition: WorkflowDefinition = {
443
+ nodes: [
444
+ { id: "n1", type: "agent-task", config: { template: "first" }, next: "n2" },
445
+ { id: "n2", type: "agent-task", config: { template: "second" } },
446
+ ],
447
+ };
448
+ const workflow = await makeWorkflow(definition);
449
+ const runId = await startOnA(workflow);
450
+
451
+ await editTo(workflow.id, definition, { dir: "/b" });
452
+ expect((await getWorkflow(workflow.id))?.dir).toBe("/b");
453
+ await completeN1Task(runId);
454
+
455
+ const n2Task = await waitFor(async () => {
456
+ const step = (await getWorkflowRunStepsByRunId(runId)).find((s) => s.nodeId === "n2");
457
+ return step ? getTaskByWorkflowRunStepId(step.id) : null;
458
+ }, "n2 task");
459
+ expect(n2Task.dir).toBeUndefined();
460
+ });
461
+ });
462
+
463
+ // ─── New runs, legacy runs, no restart ───────────────────────
464
+
465
+ describe("which definition a run uses", () => {
466
+ test("a run started after the edit uses B", async () => {
467
+ const workflow = await makeWorkflow(twoNode("A", agentTaskFirst));
468
+ const runA = await startOnA(workflow);
469
+ await editTo(workflow.id, twoNode("B", agentTaskFirst));
470
+
471
+ const runB = await startWorkflowExecution((await getWorkflow(workflow.id))!, {}, registry);
472
+ expect(await pinHash(runB)).not.toBe(await pinHash(runA));
473
+ await completeN1Task(runB);
474
+
475
+ await waitForRunStatus(runB, "completed");
476
+ await expectFollowed(runB, "B");
477
+ });
478
+
479
+ test("a run with no pin (created before migration 283) follows the live row", async () => {
480
+ const workflow = await makeWorkflow(twoNode("A", agentTaskFirst));
481
+ const runId = await startOnA(workflow);
482
+ await getDbClient().run("UPDATE workflow_runs SET definitionHash = NULL WHERE id = ?", [runId]);
483
+
484
+ await editTo(workflow.id, twoNode("B", agentTaskFirst));
485
+ await completeN1Task(runId);
486
+
487
+ await waitForRunStatus(runId, "completed");
488
+ await expectFollowed(runId, "B");
489
+ });
490
+
491
+ test("no restart: an old run resumes on A while a new run in the same process uses B", async () => {
492
+ const workflow = await makeWorkflow(twoNode("A", agentTaskFirst));
493
+ const run1 = await startOnA(workflow);
494
+ await editTo(workflow.id, twoNode("B", agentTaskFirst));
495
+ const run2 = await startWorkflowExecution((await getWorkflow(workflow.id))!, {}, registry);
496
+ expect((await getWorkflowRun(run2))?.status).toBe("waiting");
497
+
498
+ await completeN1Task(run1);
499
+ await completeN1Task(run2);
500
+
501
+ await waitForRunStatus(run1, "completed");
502
+ await waitForRunStatus(run2, "completed");
503
+ await expectFollowed(run1, "A");
504
+ await expectFollowed(run2, "B");
505
+ });
506
+ });
507
+
508
+ // ─── Pin storage ─────────────────────────────────────────────
509
+
510
+ describe("pinned definition storage", () => {
511
+ test("PINNED_WORKFLOW_KEYS plus enabled is exactly WorkflowSnapshot", () => {
512
+ type Pinned = (typeof PINNED_WORKFLOW_KEYS)[number];
513
+ type Unclassified = Exclude<keyof WorkflowSnapshot, Pinned | "enabled">;
514
+ type Unknown = Exclude<Pinned | "enabled", keyof WorkflowSnapshot>;
515
+ const unclassified: [Unclassified] extends [never] ? true : false = true;
516
+ const unknown: [Unknown] extends [never] ? true : false = true;
517
+ expect(unclassified && unknown).toBe(true);
518
+
519
+ expect([...PINNED_WORKFLOW_KEYS, "enabled"].sort()).toEqual(
520
+ Object.keys(WorkflowSnapshotSchema.shape).sort(),
521
+ );
522
+ });
523
+
524
+ test("merge takes every pinned key from the pin, so a dir the edit added does not leak", async () => {
525
+ const definition = twoNode("A", agentTaskFirst);
526
+ const pinnedFrom = await makeWorkflow(definition);
527
+ const live: Workflow = {
528
+ ...pinnedFrom,
529
+ definition: twoNode("B", agentTaskFirst),
530
+ dir: "/b",
531
+ enabled: false,
532
+ createdByAgentId: "live-agent",
533
+ };
534
+
535
+ const merged = mergePinnedDefinition(live, toPinnedDefinition(pinnedFrom));
536
+
537
+ expect(merged.dir).toBeUndefined();
538
+ expect(merged.definition).toEqual(definition);
539
+ expect(merged.enabled).toBe(false);
540
+ expect(merged.createdByAgentId).toBe("live-agent");
541
+ expect(merged.id).toBe(pinnedFrom.id);
542
+ });
543
+
544
+ test("the hash keeps nested key order and ignores top-level order and undefined fields", async () => {
545
+ const workflow = await makeWorkflow(twoNode("A", agentTaskFirst));
546
+ const pinned = toPinnedDefinition(workflow);
547
+ const topReversed = Object.fromEntries(
548
+ Object.entries({ ...pinned, dir: undefined }).reverse(),
549
+ ) as typeof pinned;
550
+ const [first, ...rest] = pinned.definition.nodes;
551
+ const nestedReversed = {
552
+ ...pinned,
553
+ definition: {
554
+ ...pinned.definition,
555
+ nodes: [Object.fromEntries(Object.entries(first!).reverse()) as WorkflowNode, ...rest],
556
+ },
557
+ };
558
+
559
+ expect(hashPinnedDefinition(topReversed)).toEqual(hashPinnedDefinition(pinned));
560
+ expect(hashPinnedDefinition(nestedReversed).hash).not.toBe(hashPinnedDefinition(pinned).hash);
561
+ });
562
+
563
+ test("toggling enabled mints no new definition row", async () => {
564
+ const workflow = await makeWorkflow(twoNode("A", agentTaskFirst));
565
+ const before = await pinWorkflowDefinition(workflow);
566
+ const rowsBefore = await getDbClient().get<{ n: number }>(
567
+ "SELECT COUNT(*) AS n FROM workflow_run_definitions",
568
+ );
569
+
570
+ await snapshotAndUpdateWorkflow(workflow.id, { enabled: false });
571
+ const after = await pinWorkflowDefinition((await getWorkflow(workflow.id))!);
572
+ const rowsAfter = await getDbClient().get<{ n: number }>(
573
+ "SELECT COUNT(*) AS n FROM workflow_run_definitions",
574
+ );
575
+
576
+ expect(after).toBe(before);
577
+ expect(rowsAfter?.n).toBe(rowsBefore?.n);
578
+ });
579
+
580
+ test("deleteWorkflow drops only the definition rows no remaining run references", async () => {
581
+ const wf1 = await makeWorkflow(twoNode("A", agentTaskFirst));
582
+ const wf2 = await makeWorkflow(twoNode("A", agentTaskFirst));
583
+ const run1 = await startOnA(wf1);
584
+ const run2 = await startOnA(wf2);
585
+ const run3 = await startOnA(wf2);
586
+ const h1 = (await pinHash(run1))!;
587
+ const h2 = (await pinHash(run2))!;
588
+ expect(h1).not.toBe(h2);
589
+ // A wf2 run shares wf1's snapshot row, as identical content does.
590
+ await getDbClient().run("UPDATE workflow_runs SET definitionHash = ? WHERE id = ?", [h1, run3]);
591
+ const exists = async (hash: string) =>
592
+ (await getDbClient().get("SELECT 1 FROM workflow_run_definitions WHERE hash = ?", [hash])) !=
593
+ null;
594
+
595
+ await deleteWorkflow(wf1.id);
596
+ expect(await exists(h1)).toBe(true);
597
+ expect(await exists(h2)).toBe(true);
598
+
599
+ await deleteWorkflow(wf2.id);
600
+ expect(await exists(h1)).toBe(false);
601
+ expect(await exists(h2)).toBe(false);
602
+ });
603
+ });
604
+
605
+ // ─── Execution-relevant order ────────────────────────────────
606
+
607
+ describe("a resumed run keeps the key order it started with", () => {
608
+ /** `n1` (agent task, the pause) → `n2`, which records the order of `args` and `nested`. */
609
+ function ordered(args: Record<string, unknown>, nested: Record<string, unknown>) {
610
+ return {
611
+ nodes: [
612
+ { id: "n1", type: "agent-task", config: { template: "Work" }, next: "n2" },
613
+ { id: "n2", type: "order", config: { args, nested } },
614
+ ],
615
+ } as WorkflowDefinition;
616
+ }
617
+ const orderOf = (runId: string) => keyOrders.find((entry) => entry.runId === runId);
618
+
619
+ test("object keys reach the executor in definition order after a pause", async () => {
620
+ const workflow = await makeWorkflow(ordered({ z: 1, a: 2 }, { y: 1, b: 2 }));
621
+ const runId = await startOnA(workflow);
622
+ expect((await getWorkflowRun(runId))?.status).toBe("waiting");
623
+
624
+ await completeN1Task(runId);
625
+ await waitForRunStatus(runId, "completed");
626
+
627
+ expect(orderOf(runId)).toEqual({ runId, args: ["z", "a"], nested: ["y", "b"] });
628
+ });
629
+
630
+ test("definitions that differ only in key order pin distinct rows and resume apart", async () => {
631
+ const workflow = await makeWorkflow(ordered({ z: 1, a: 2 }, { y: 1, b: 2 }));
632
+ const first = await startOnA(workflow);
633
+ await editTo(workflow.id, ordered({ a: 2, z: 1 }, { b: 2, y: 1 }));
634
+ const second = await startOnA((await getWorkflow(workflow.id))!);
635
+ expect(await pinHash(second)).not.toBe(await pinHash(first));
636
+
637
+ await completeN1Task(second);
638
+ await completeN1Task(first);
639
+ await waitForRunStatus(first, "completed");
640
+ await waitForRunStatus(second, "completed");
641
+
642
+ expect(orderOf(first)).toEqual({ runId: first, args: ["z", "a"], nested: ["y", "b"] });
643
+ expect(orderOf(second)).toEqual({ runId: second, args: ["a", "z"], nested: ["b", "y"] });
644
+ });
645
+ });
@@ -374,13 +374,22 @@ describe("NotifyExecutor", () => {
374
374
  expect(out.sent).toBe(false);
375
375
  });
376
376
 
377
- test("slack stub returns sent=false", async () => {
378
- const result = await executor.run(
379
- input({ channel: "slack", target: "#general", template: "hi" }, {}),
380
- );
381
- expect(result.status).toBe("success");
382
- const out = result.output as { sent: boolean };
383
- expect(out.sent).toBe(false);
377
+ test("slack returns sent=false when Slack is not configured", async () => {
378
+ // A configured Slack with no client makes the executor wait, then fail
379
+ // (see workflow-notify-slack-ready.test.ts). Pin the unconfigured case.
380
+ const previous = process.env.SLACK_DISABLE;
381
+ process.env.SLACK_DISABLE = "true";
382
+ try {
383
+ const result = await executor.run(
384
+ input({ channel: "slack", target: "#general", template: "hi" }, {}),
385
+ );
386
+ expect(result.status).toBe("success");
387
+ const out = result.output as { sent: boolean };
388
+ expect(out.sent).toBe(false);
389
+ } finally {
390
+ if (previous === undefined) delete process.env.SLACK_DISABLE;
391
+ else process.env.SLACK_DISABLE = previous;
392
+ }
384
393
  });
385
394
 
386
395
  test("email stub returns sent=false", async () => {