@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
@@ -1047,6 +1047,88 @@ ${serveFakeAcpAgent("FakeCopilot")}
1047
1047
  expect(env.AGENT_MODEL).toBe("custom-model");
1048
1048
  });
1049
1049
 
1050
+ test.each([
1051
+ ["number", 1],
1052
+ ["boolean", false],
1053
+ ["null", null],
1054
+ ["object", { key: "ALLOWED_TOKEN" }],
1055
+ ["nested array", ["ALLOWED_TOKEN"]],
1056
+ ])("custom target rejects a JSON env-key array containing a %s", (_name, entry) => {
1057
+ const config = baseConfig({
1058
+ env: {
1059
+ ACP_TARGET_ENV_KEYS: JSON.stringify(["ALLOWED_TOKEN", entry]),
1060
+ ALLOWED_TOKEN: "allowed",
1061
+ },
1062
+ });
1063
+ const resolveEnv = () => resolveAcpTarget(config).env(config);
1064
+
1065
+ expect(resolveEnv).toThrow(AcpTargetResolutionError);
1066
+ expect(resolveEnv).toThrow("ACP_TARGET_ENV_KEYS");
1067
+ });
1068
+
1069
+ test("custom target preserves literal keys in an all-string JSON env-key array", () => {
1070
+ const config = baseConfig({
1071
+ env: {
1072
+ ACP_TARGET_ENV_KEYS: JSON.stringify(["ALLOWED_TOKEN", " SPACED_KEY ", "", "ALLOWED_TOKEN"]),
1073
+ ALLOWED_TOKEN: "allowed",
1074
+ " SPACED_KEY ": "literal",
1075
+ "": "empty-key",
1076
+ BLOCKED_TOKEN: "blocked",
1077
+ },
1078
+ });
1079
+ const env = resolveAcpTarget(config).env(config);
1080
+
1081
+ expect(env.ALLOWED_TOKEN).toBe("allowed");
1082
+ expect(env[" SPACED_KEY "]).toBe("literal");
1083
+ expect(env[""]).toBe("empty-key");
1084
+ expect(env.SPACED_KEY).toBeUndefined();
1085
+ expect(env.BLOCKED_TOKEN).toBeUndefined();
1086
+ });
1087
+
1088
+ test("custom target trims comma-separated env keys and ignores empty segments", () => {
1089
+ const config = baseConfig({
1090
+ env: {
1091
+ ACP_TARGET_ENV_KEYS: " ALLOWED_TOKEN , , SECOND_TOKEN, ALLOWED_TOKEN , ",
1092
+ ALLOWED_TOKEN: "allowed",
1093
+ SECOND_TOKEN: "second",
1094
+ BLOCKED_TOKEN: "blocked",
1095
+ },
1096
+ });
1097
+ const env = resolveAcpTarget(config).env(config);
1098
+
1099
+ expect(env.ALLOWED_TOKEN).toBe("allowed");
1100
+ expect(env.SECOND_TOKEN).toBe("second");
1101
+ expect(env.BLOCKED_TOKEN).toBeUndefined();
1102
+ });
1103
+
1104
+ test.each([
1105
+ undefined,
1106
+ "",
1107
+ " ",
1108
+ "[]",
1109
+ ])("custom target forwards no extra env keys for an empty list (%j)", (value) => {
1110
+ const config = baseConfig({
1111
+ env: { ACP_TARGET_ENV_KEYS: value, ALLOWED_TOKEN: "allowed" },
1112
+ });
1113
+
1114
+ expect(resolveAcpTarget(config).env(config).ALLOWED_TOKEN).toBeUndefined();
1115
+ });
1116
+
1117
+ test.each([
1118
+ '["ALLOWED_TOKEN"',
1119
+ '"ALLOWED_TOKEN"',
1120
+ "123",
1121
+ "true",
1122
+ "null",
1123
+ '{"key":"value"}',
1124
+ ])("custom target keeps the text fallback for non-array or invalid JSON (%s)", (value) => {
1125
+ const config = baseConfig({
1126
+ env: { ACP_TARGET_ENV_KEYS: value, [value]: "allowed" },
1127
+ });
1128
+
1129
+ expect(resolveAcpTarget(config).env(config)[value]).toBe("allowed");
1130
+ });
1131
+
1050
1132
  test("configured options are nonfatal when absent or rejected", async () => {
1051
1133
  const advertised = [
1052
1134
  {
@@ -0,0 +1,120 @@
1
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
+ import { unlink } from "node:fs/promises";
3
+ import { parseAppDefinition } from "../apps/definition";
4
+ import { createApp, getApp, listApps, updateApp } from "../apps/store";
5
+ import { closeDb, getDbClient, initDb } from "../be/db";
6
+
7
+ const TEST_DB_PATH = `/private/tmp/test-apps-icon-${process.pid}.sqlite`;
8
+
9
+ const baseDefinition = {
10
+ models: {},
11
+ queries: {},
12
+ actions: {},
13
+ pages: {
14
+ main: {
15
+ title: "Main",
16
+ root: "root",
17
+ elements: { root: { type: "Stack", props: {}, children: [] } },
18
+ },
19
+ },
20
+ defaultPage: "main",
21
+ };
22
+
23
+ async function createWithIcon(name: string, icon: unknown) {
24
+ const parsed = await parseAppDefinition(baseDefinition, { writerIsUser: true });
25
+ if (!parsed.success) throw new Error(JSON.stringify(parsed.issues));
26
+ const app = await createApp({ name, definition: parsed.definition });
27
+ if (icon !== undefined) {
28
+ // Write the raw column so malformed stored icons (hand edits, old data) can be exercised.
29
+ const stored = { ...parsed.definition, icon };
30
+ await getDbClient().run("UPDATE apps SET definition = ? WHERE id = ?", [
31
+ JSON.stringify(stored),
32
+ app.id,
33
+ ]);
34
+ }
35
+ return app.id;
36
+ }
37
+
38
+ beforeAll(() => {
39
+ initDb(TEST_DB_PATH);
40
+ });
41
+
42
+ afterAll(async () => {
43
+ closeDb();
44
+ for (const suffix of ["", "-wal", "-shm"])
45
+ await unlink(`${TEST_DB_PATH}${suffix}`).catch(() => {});
46
+ });
47
+
48
+ describe("app icon", () => {
49
+ test("definition accepts a lucide icon and rejects a malformed one", async () => {
50
+ const icon = { type: "lucide", icon: "layout-grid", color: "#f59e0b" };
51
+ expect((await parseAppDefinition({ ...baseDefinition, icon })).success).toBe(true);
52
+ expect(
53
+ (await parseAppDefinition({ ...baseDefinition, icon: { type: "lucide", icon: "Not Valid" } }))
54
+ .success,
55
+ ).toBe(false);
56
+ expect(
57
+ (
58
+ await parseAppDefinition({
59
+ ...baseDefinition,
60
+ icon: { type: "lucide", icon: "star", color: "red" },
61
+ })
62
+ ).success,
63
+ ).toBe(false);
64
+ });
65
+
66
+ test('suggests "icon" for avatar and emoji top-level keys', async () => {
67
+ for (const key of ["avatar", "emoji"]) {
68
+ const parsed = await parseAppDefinition({ ...baseDefinition, [key]: "x" });
69
+ expect(parsed.success).toBe(false);
70
+ if (!parsed.success) {
71
+ expect(parsed.issues.some((issue) => issue.message.includes('did you mean "icon"'))).toBe(
72
+ true,
73
+ );
74
+ }
75
+ }
76
+ });
77
+
78
+ test("an icon written through the normal create and update path survives to listApps", async () => {
79
+ const icon = { type: "lucide", icon: "layout-grid", color: "#f59e0b" };
80
+ const parsed = await parseAppDefinition({ ...baseDefinition, icon }, { writerIsUser: true });
81
+ if (!parsed.success) throw new Error(JSON.stringify(parsed.issues));
82
+ const app = await createApp({ name: "Round trip", definition: parsed.definition });
83
+
84
+ expect((await listApps()).find((summary) => summary.id === app.id)?.icon).toEqual(icon);
85
+ expect((await getApp(app.id))?.definition.icon).toEqual(icon);
86
+
87
+ const nextIcon = { type: "lucide", icon: "star" };
88
+ const reparsed = await parseAppDefinition(
89
+ { ...baseDefinition, icon: nextIcon },
90
+ { writerIsUser: true },
91
+ );
92
+ if (!reparsed.success) throw new Error(JSON.stringify(reparsed.issues));
93
+ await updateApp(app.id, { definition: reparsed.definition });
94
+
95
+ expect((await listApps()).find((summary) => summary.id === app.id)?.icon).toEqual(nextIcon);
96
+ });
97
+
98
+ test("listApps projects a valid icon and omits it when absent or invalid", async () => {
99
+ const icon = { type: "lucide", icon: "layout-grid", color: "#f59e0b" };
100
+ const withIcon = await createWithIcon("With icon", icon);
101
+ const withoutIcon = await createWithIcon("Without icon", undefined);
102
+ const badShape = await createWithIcon("Bad shape", { type: "lucide", icon: "Not Valid" });
103
+ const wrongType = await createWithIcon("Wrong type", "star");
104
+
105
+ const byId = new Map((await listApps()).map((app) => [app.id, app]));
106
+ expect(byId.get(withIcon)?.icon).toEqual(icon);
107
+ for (const id of [withoutIcon, badShape, wrongType]) {
108
+ const summary = byId.get(id);
109
+ expect(summary).toBeDefined();
110
+ expect(summary && "icon" in summary).toBe(false);
111
+ }
112
+ });
113
+
114
+ test("an unknown but well-formed icon name is passed through for the dashboard to fall back on", async () => {
115
+ const icon = { type: "lucide", icon: "no-such-icon" };
116
+ const id = await createWithIcon("Unknown icon", icon);
117
+ const summary = (await listApps()).find((app) => app.id === id);
118
+ expect(summary?.icon).toEqual(icon);
119
+ });
120
+ });
@@ -0,0 +1,151 @@
1
+ import { describe, expect, test } from "bun:test";
2
+ import { parseAppDefinition } from "../apps/definition";
3
+
4
+ /**
5
+ * Validator coverage for the `SchemaForm` component: its `onChange` action
6
+ * chain and the `$state` `rowId` binding a nested-document editor persists
7
+ * with. Pure `parseAppDefinition` calls — no DB, no HTTP — mirroring
8
+ * `apps-tree.test.ts`.
9
+ */
10
+
11
+ async function expectParseIssue(definition: unknown, message: string): Promise<void> {
12
+ const parsed = await parseAppDefinition(definition);
13
+ expect(parsed.success).toBe(false);
14
+ if (parsed.success) return;
15
+ expect(parsed.issues.some((entry) => entry.message.includes(message))).toBe(true);
16
+ }
17
+
18
+ /**
19
+ * A definition with a `screen` model and a `SchemaForm` whose `onChange` chain
20
+ * runs an `app.mutate` against the named model.
21
+ */
22
+ function schemaFormDefinition(model = "screen", id = "props") {
23
+ return {
24
+ models: {
25
+ screen: { columns: { doc: { kind: "json" } } },
26
+ },
27
+ queries: {},
28
+ pages: {
29
+ main: {
30
+ root: "root",
31
+ elements: {
32
+ root: { type: "Stack", props: {}, children: ["props"] },
33
+ props: {
34
+ type: "SchemaForm",
35
+ props: {
36
+ id,
37
+ schema: { type: "object", properties: { title: { type: "string" } } },
38
+ onChange: [
39
+ {
40
+ action: "app.mutate",
41
+ params: { model, op: "update", rowId: "r1", values: { doc: { $form: "" } } },
42
+ },
43
+ ],
44
+ },
45
+ },
46
+ },
47
+ },
48
+ },
49
+ defaultPage: "main",
50
+ };
51
+ }
52
+
53
+ describe("SchemaForm validation", () => {
54
+ test("accepts a SchemaForm onChange app.mutate chain against a declared model", async () => {
55
+ const parsed = await parseAppDefinition(schemaFormDefinition());
56
+ expect(parsed.success).toBe(true);
57
+ });
58
+
59
+ test("rejects a SchemaForm onChange app.mutate chain against an undeclared model", async () => {
60
+ await expectParseIssue(schemaFormDefinition("ghost"), 'unknown model "ghost"');
61
+ });
62
+ });
63
+
64
+ describe("SchemaForm id", () => {
65
+ test.each([
66
+ "a/b",
67
+ "a b",
68
+ "..",
69
+ "",
70
+ "__proto__",
71
+ "constructor",
72
+ "prototype",
73
+ "a.b",
74
+ ])("rejects the id %p", async (id) => {
75
+ await expectParseIssue(schemaFormDefinition("screen", id), "SchemaForm id must match");
76
+ });
77
+
78
+ test("accepts letters, digits, underscore and hyphen", async () => {
79
+ const parsed = await parseAppDefinition(schemaFormDefinition("screen", "Props_1-a"));
80
+ expect(parsed.success).toBe(true);
81
+ });
82
+ });
83
+
84
+ /**
85
+ * A document-editing page: a Tree selects an element of a row's `doc`, and a
86
+ * SchemaForm merges edits into it (`baseDoc` + `nodeKey`) and persists the
87
+ * whole doc with an `app.mutate` keyed by the route param.
88
+ */
89
+ function documentEditorDefinition(rowId: unknown) {
90
+ return {
91
+ models: { screen: { columns: { doc: { kind: "json" }, name: { kind: "string" } } } },
92
+ queries: { screenById: { model: "screen", filter: { id: { $param: "screenId" } }, limit: 1 } },
93
+ pages: {
94
+ editor: {
95
+ params: { screenId: { kind: "string", required: true } },
96
+ root: "root",
97
+ elements: {
98
+ root: { type: "Stack", props: {}, children: ["tree", "props"] },
99
+ tree: {
100
+ type: "Tree",
101
+ props: { id: "tree", nodes: { $state: "/queries/screenById/data/0/doc" } },
102
+ },
103
+ props: {
104
+ type: "SchemaForm",
105
+ props: {
106
+ id: "props",
107
+ schema: { $state: "/ui/props/schema" },
108
+ baseDoc: { $state: "/queries/screenById/data/0/doc" },
109
+ nodeKey: { $state: "/ui/tree/value" },
110
+ onChange: [
111
+ {
112
+ action: "app.mutate",
113
+ params: {
114
+ model: "screen",
115
+ op: "update",
116
+ rowId,
117
+ values: { doc: { $state: "/ui/props/value" } },
118
+ },
119
+ },
120
+ ],
121
+ },
122
+ },
123
+ },
124
+ },
125
+ },
126
+ defaultPage: "editor",
127
+ };
128
+ }
129
+
130
+ describe("app.mutate rowId binding", () => {
131
+ test("accepts a $state rowId bound to a route param (editor persists by screenId)", async () => {
132
+ const parsed = await parseAppDefinition(
133
+ documentEditorDefinition({ $state: "/route/params/screenId" }),
134
+ );
135
+ expect(parsed.success).toBe(true);
136
+ });
137
+
138
+ test("a $state rowId still validates its target — an unknown route param fails", async () => {
139
+ await expectParseIssue(
140
+ documentEditorDefinition({ $state: "/route/params/ghost" }),
141
+ 'unknown route param "ghost"',
142
+ );
143
+ });
144
+
145
+ test("rejects a rowId that is neither a string, $row, nor $state binding", async () => {
146
+ await expectParseIssue(
147
+ documentEditorDefinition({ nope: true }),
148
+ "must be a string, $row, or $state binding",
149
+ );
150
+ });
151
+ });
@@ -0,0 +1,248 @@
1
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
3
+ import {
4
+ cancelTask,
5
+ closeDb,
6
+ completeTask,
7
+ createAgent,
8
+ createTaskExtended,
9
+ getDbClient,
10
+ getLogsByTaskIdAndEventType,
11
+ initDb,
12
+ pauseTask,
13
+ startTask,
14
+ } from "../be/db";
15
+ import { registerStoreProgressTool } from "../tools/store-progress";
16
+ import type { CreateTaskOptions } from "../types";
17
+
18
+ type StoreProgressResult = { structuredContent: { success: boolean; message: string } };
19
+ type RegisteredTool = { handler: (args: unknown, extra: unknown) => Promise<unknown> };
20
+
21
+ let leadId: string;
22
+ let workerId: string;
23
+ let otherWorkerId: string;
24
+ let storeProgress: RegisteredTool;
25
+
26
+ beforeAll(async () => {
27
+ initDb(":memory:");
28
+ leadId = (
29
+ await createAgent({
30
+ name: "Lead",
31
+ isLead: true,
32
+ status: "busy",
33
+ capabilities: [],
34
+ maxTasks: 50,
35
+ })
36
+ ).id;
37
+ workerId = (
38
+ await createAgent({ name: "Reviewer", status: "busy", capabilities: [], maxTasks: 50 })
39
+ ).id;
40
+ otherWorkerId = (
41
+ await createAgent({ name: "Coder", status: "busy", capabilities: [], maxTasks: 50 })
42
+ ).id;
43
+ const server = new McpServer({ name: "chained-follow-up-test", version: "1.0.0" });
44
+ registerStoreProgressTool(server);
45
+ storeProgress = (server as unknown as { _registeredTools: Record<string, RegisteredTool> })
46
+ ._registeredTools["store-progress"]!;
47
+ });
48
+ afterAll(() => closeDb());
49
+
50
+ type FollowUpRow = { id: string; task: string; slackChannelId: string | null };
51
+
52
+ function followUps(parentTaskId: string): Promise<FollowUpRow[]> {
53
+ return getDbClient().query<FollowUpRow>(
54
+ "SELECT id, task, slackChannelId FROM agent_tasks WHERE parentTaskId = ? AND taskType = 'follow-up'",
55
+ [parentTaskId],
56
+ );
57
+ }
58
+
59
+ /** A started worker task, as the Reviewer holds it mid-review. */
60
+ async function reviewTask(options: CreateTaskOptions = {}) {
61
+ const task = await createTaskExtended("Review PR #1", {
62
+ agentId: workerId,
63
+ creatorAgentId: leadId,
64
+ ...options,
65
+ });
66
+ await startTask(task.id);
67
+ return task;
68
+ }
69
+
70
+ /** The fix task the Reviewer chains from its review. */
71
+ function chainChild(parentTaskId: string, options: CreateTaskOptions = {}) {
72
+ return createTaskExtended("Fix the review blockers", {
73
+ agentId: otherWorkerId,
74
+ creatorAgentId: workerId,
75
+ parentTaskId,
76
+ followUpConfig: { disabled: true },
77
+ ...options,
78
+ });
79
+ }
80
+
81
+ async function finish(
82
+ taskId: string,
83
+ args: { status?: "completed" | "failed" | "skipped"; chainedTaskId?: string },
84
+ ) {
85
+ const status = args.status ?? "completed";
86
+ const result = (await storeProgress.handler(
87
+ {
88
+ taskId,
89
+ status,
90
+ ...(status === "completed" ? { output: "CHAINED: fix task" } : { failureReason: "boom" }),
91
+ ...(args.chainedTaskId ? { chainedTaskId: args.chainedTaskId } : {}),
92
+ },
93
+ {
94
+ sessionId: `session-${crypto.randomUUID()}`,
95
+ requestInfo: { headers: { "x-agent-id": workerId } },
96
+ },
97
+ )) as StoreProgressResult;
98
+ // The completion itself never fails because of chainedTaskId.
99
+ expect(result.structuredContent.success).toBe(true);
100
+ }
101
+
102
+ async function suppressions(taskId: string) {
103
+ return (await getLogsByTaskIdAndEventType(taskId, "task_follow_up_suppressed")).map(
104
+ (log) => JSON.parse(log.metadata ?? "{}") as Record<string, unknown>,
105
+ );
106
+ }
107
+
108
+ describe("store-progress chainedTaskId", () => {
109
+ test("a live chained child suppresses the follow-up and logs the handoff", async () => {
110
+ const task = await reviewTask({ followUpConfig: { onCompleted: "CHAINED => no action" } });
111
+ const child = await chainChild(task.id);
112
+
113
+ await finish(task.id, { chainedTaskId: child.id });
114
+
115
+ expect(await followUps(task.id)).toHaveLength(0);
116
+ expect(await suppressions(task.id)).toEqual([
117
+ {
118
+ reason: "chained_task_live",
119
+ status: "completed",
120
+ chainedTaskId: child.id,
121
+ chainedTaskStatus: "pending",
122
+ droppedOnCompleted: true,
123
+ },
124
+ ]);
125
+ });
126
+
127
+ test("in_progress and paused children count as live", async () => {
128
+ for (const settle of [startTask, async (id: string) => pauseTask((await startTask(id))!.id)]) {
129
+ const task = await reviewTask();
130
+ const child = await chainChild(task.id);
131
+ await settle(child.id);
132
+
133
+ await finish(task.id, { chainedTaskId: child.id });
134
+
135
+ expect(await followUps(task.id)).toHaveLength(0);
136
+ }
137
+ });
138
+
139
+ test.each([
140
+ ["completed", (id: string) => completeTask(id, "done"), "it is completed, not live"],
141
+ ["cancelled", (id: string) => cancelTask(id, "stop"), "it is cancelled, not live"],
142
+ ] as const)("a %s child creates the follow-up naming the reason", async (_, settle, reason) => {
143
+ const task = await reviewTask();
144
+ const child = await chainChild(task.id);
145
+ await settle(child.id);
146
+
147
+ await finish(task.id, { chainedTaskId: child.id });
148
+
149
+ const [followUp, ...rest] = await followUps(task.id);
150
+ expect(rest).toHaveLength(0);
151
+ expect(followUp!.task).toContain(`chainedTaskId ${child.id}`);
152
+ expect(followUp!.task).toContain(reason);
153
+ expect(await suppressions(task.id)).toHaveLength(0);
154
+ });
155
+
156
+ test("a child with another parent creates the follow-up", async () => {
157
+ const task = await reviewTask();
158
+ const otherParent = await reviewTask();
159
+ const child = await chainChild(otherParent.id);
160
+
161
+ await finish(task.id, { chainedTaskId: child.id });
162
+
163
+ const [followUp] = await followUps(task.id);
164
+ expect(followUp!.task).toContain(`its parentTaskId is ${otherParent.id}, not this task`);
165
+ });
166
+
167
+ test("a child created by another agent creates the follow-up", async () => {
168
+ const task = await reviewTask();
169
+ const child = await chainChild(task.id, { creatorAgentId: leadId });
170
+
171
+ await finish(task.id, { chainedTaskId: child.id });
172
+
173
+ const [followUp] = await followUps(task.id);
174
+ expect(followUp!.task).toContain("not created by the agent that completed this task");
175
+ });
176
+
177
+ test("an unknown id creates the follow-up", async () => {
178
+ const task = await reviewTask();
179
+ const missing = crypto.randomUUID();
180
+
181
+ await finish(task.id, { chainedTaskId: missing });
182
+
183
+ const [followUp] = await followUps(task.id);
184
+ expect(followUp!.task).toContain(`chainedTaskId ${missing}`);
185
+ expect(followUp!.task).toContain("no task has this id");
186
+ });
187
+
188
+ test("a failed completion ignores chainedTaskId and wakes the lead", async () => {
189
+ const task = await reviewTask();
190
+ const child = await chainChild(task.id);
191
+
192
+ await finish(task.id, { status: "failed", chainedTaskId: child.id });
193
+
194
+ const [followUp, ...rest] = await followUps(task.id);
195
+ expect(rest).toHaveLength(0);
196
+ expect(followUp!.task).not.toContain("chainedTaskId");
197
+ expect(await suppressions(task.id)).toHaveLength(0);
198
+ });
199
+
200
+ test("a skipped completion ignores chainedTaskId", async () => {
201
+ const task = await reviewTask();
202
+ const child = await chainChild(task.id);
203
+
204
+ await finish(task.id, { status: "skipped", chainedTaskId: child.id });
205
+
206
+ expect(await followUps(task.id)).toHaveLength(0);
207
+ expect(await suppressions(task.id)).toHaveLength(0);
208
+ });
209
+
210
+ test("followUpConfig.disabled still disables, with or without a valid chain", async () => {
211
+ for (const chained of [false, true]) {
212
+ const task = await reviewTask({ followUpConfig: { disabled: true } });
213
+ const child = await chainChild(task.id);
214
+
215
+ await finish(task.id, chained ? { chainedTaskId: child.id } : {});
216
+
217
+ expect(await followUps(task.id)).toHaveLength(0);
218
+ expect(await suppressions(task.id)).toHaveLength(0);
219
+ }
220
+ });
221
+
222
+ test("without chainedTaskId the follow-up is unchanged", async () => {
223
+ const task = await reviewTask();
224
+ await chainChild(task.id);
225
+
226
+ await finish(task.id, {});
227
+
228
+ const [followUp] = await followUps(task.id);
229
+ expect(followUp!.task).not.toContain("chainedTaskId");
230
+ });
231
+
232
+ test("a Slack-sourced task with a suppressed follow-up creates nothing in the thread", async () => {
233
+ const slack = { slackChannelId: "C_TEST", slackThreadTs: "1700000000.000100" };
234
+ const task = await reviewTask({ source: "slack", ...slack });
235
+ const child = await chainChild(task.id);
236
+
237
+ await finish(task.id, { chainedTaskId: child.id });
238
+
239
+ expect(await followUps(task.id)).toHaveLength(0);
240
+ // Only the review and its chained child live in the thread: no Lead
241
+ // follow-up exists to reply there or post an outcome card.
242
+ const inThread = await getDbClient().query<{ id: string }>(
243
+ "SELECT id FROM agent_tasks WHERE slackChannelId = ? AND slackThreadTs = ?",
244
+ [slack.slackChannelId, slack.slackThreadTs],
245
+ );
246
+ expect(inThread.map((row) => row.id).sort()).toEqual([task.id, child.id].sort());
247
+ });
248
+ });