@desplega.ai/agent-swarm 2.13.5 → 2.14.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 (414) hide show
  1. package/dist/acp-adapter-99n6z9ky.js +17 -0
  2. package/dist/{acp-targets-w8dbs4nr.js → acp-targets-23exz4z4.js} +10 -10
  3. package/dist/{actions-8zrcbjrx.js → actions-zcr25x27.js} +60 -39
  4. package/dist/{agent-fs-provision-cbt2ttds.js → agent-fs-provision-7fa9e12e.js} +4 -4
  5. package/dist/{amp-adapter-8x6zp8w4.js → amp-adapter-s7ytmv6b.js} +3 -3
  6. package/dist/{app-zfa9dwjw.js → app-5d3sz1hy.js} +7 -7
  7. package/dist/{approval-notifications-rv92zmza.js → approval-notifications-7qgkzkzx.js} +8 -8
  8. package/dist/{assistant-q7s7rm1q.js → assistant-p2yvhc3j.js} +37 -32
  9. package/dist/{boot-args-schema-g27kpzr1.js → boot-args-schema-ry6cb0p7.js} +1 -1
  10. package/dist/{boot-reembed-1mjs52nt.js → boot-reembed-2hkm3vz2.js} +1 -1
  11. package/dist/{boot-reembed-m62dpdkg.js → boot-reembed-c9643ms3.js} +1 -1
  12. package/dist/{boot-scrub-sweep-ss1vcamw.js → boot-scrub-sweep-3ycxr51t.js} +2 -2
  13. package/dist/{boot-seeds-hwnvgbb3.js → boot-seeds-2hzvvzg0.js} +4 -4
  14. package/dist/{boxd-y0szhp0g.js → boxd-9py3x0jb.js} +2 -2
  15. package/dist/{claude-adapter-0rjmbhjk.js → claude-adapter-dnkww93e.js} +9 -9
  16. package/dist/{claude-managed-adapter-6k032agg.js → claude-managed-adapter-yk0cr5x6.js} +4 -4
  17. package/dist/{claude-managed-setup-6czvve8q.js → claude-managed-setup-4byxpp47.js} +5 -5
  18. package/dist/{claude-sdk-session-pr0znb81.js → claude-sdk-session-4wf3dbvs.js} +12467 -12285
  19. package/dist/{cli-t0n9svkb.js → cli-096aftq6.js} +12 -7
  20. package/dist/{cli-2wzkvfgm.js → cli-0e914dp9.js} +3 -3
  21. package/dist/{cli-vcpyttcw.js → cli-0h6m6z5g.js} +1 -1
  22. package/dist/{cli-q41qar56.js → cli-0k7ppk9k.js} +130 -8
  23. package/dist/{cli-ks06cd0n.js → cli-1nfabrt4.js} +8 -8
  24. package/dist/{cli-ebpq3c5z.js → cli-2414h5r9.js} +8 -8
  25. package/dist/{cli-nrt048ys.js → cli-24wervhz.js} +37 -0
  26. package/dist/{cli-pedm2kht.js → cli-2ayk9gn8.js} +2 -2
  27. package/dist/{cli-kr0jpw9c.js → cli-2ckwgs7q.js} +1 -1
  28. package/dist/{cli-evy3egte.js → cli-2savn6mm.js} +11 -100
  29. package/dist/{cli-n79j1vxc.js → cli-2zjxake1.js} +4 -4
  30. package/dist/{cli-z3x7h79n.js → cli-37p61fcg.js} +9 -9
  31. package/dist/{cli-2vp0z049.js → cli-39t9d248.js} +1 -1
  32. package/dist/{cli-sa02jsqt.js → cli-3mhdmcd4.js} +1 -1
  33. package/dist/{cli-34fygf87.js → cli-3wsabyt0.js} +2 -2
  34. package/dist/{cli-grbngev5.js → cli-466jjrwe.js} +11 -2
  35. package/dist/{cli-zxa1vmx7.js → cli-6ajyhxh7.js} +2 -2
  36. package/dist/{cli-bvamr9g0.js → cli-6yy4fepf.js} +4 -4
  37. package/dist/{cli-3vw6dd4g.js → cli-73rmgm45.js} +2 -2
  38. package/dist/{cli-8b4rpnwj.js → cli-7ca8hczj.js} +1 -1
  39. package/dist/{cli-0h8skzss.js → cli-7g5qj2ca.js} +4 -3
  40. package/dist/{cli-srre41gb.js → cli-7w1fs01q.js} +2 -2
  41. package/dist/{cli-tgc1kgg3.js → cli-84wxwt3z.js} +1 -1
  42. package/dist/{cli-4gaf3tx5.js → cli-84xn7bgz.js} +1 -1
  43. package/dist/{cli-s8dhq7rj.js → cli-879txsac.js} +5 -5
  44. package/dist/{cli-9n6g14vs.js → cli-8vbxjzk0.js} +3 -3
  45. package/dist/{cli-cmbb2t8a.js → cli-91amj3md.js} +2 -2
  46. package/dist/{cli-ewk3sg68.js → cli-930zbczq.js} +3 -3
  47. package/dist/{cli-6msnpj1z.js → cli-9fwznq4p.js} +10 -10
  48. package/dist/{cli-qmx8bnt4.js → cli-9j1t3kf6.js} +2 -2
  49. package/dist/{cli-t879ww0y.js → cli-9j47sgzy.js} +2 -2
  50. package/dist/{cli-0qt3epg4.js → cli-ad00h1st.js} +7 -7
  51. package/dist/{cli-avax5mp9.js → cli-adzmmcvf.js} +19 -7
  52. package/dist/{cli-ffn0a515.js → cli-ayxxkk3p.js} +68 -25
  53. package/dist/{cli-4vynxtrb.js → cli-bqfx72e6.js} +10 -3
  54. package/dist/{cli-887vhew6.js → cli-cbg0j1yt.js} +2716 -2643
  55. package/dist/{cli-fw67mnyc.js → cli-cg1q8ymp.js} +1 -1
  56. package/dist/{cli-he5nxaa8.js → cli-dw9rtjm3.js} +1 -1
  57. package/dist/{cli-emdfd8fh.js → cli-dy754erz.js} +9 -1
  58. package/dist/{cli-3860pmrq.js → cli-edxfzgah.js} +4 -4
  59. package/dist/{cli-v09eza21.js → cli-ejnhs815.js} +15 -15
  60. package/dist/{cli-k0nebh10.js → cli-enavhq6r.js} +1 -1
  61. package/dist/{cli-b42yfn17.js → cli-f2rwt43y.js} +13 -13
  62. package/dist/{cli-tvyt8w6n.js → cli-f9g96z28.js} +8 -8
  63. package/dist/{cli-zbbtp02a.js → cli-fww016hh.js} +457 -70
  64. package/dist/{cli-vbge4rsp.js → cli-g6a696c0.js} +4 -4
  65. package/dist/{cli-z1vam71h.js → cli-gc6b94tj.js} +2 -2
  66. package/dist/{cli-5tq15aa7.js → cli-gcyws2bp.js} +2 -2
  67. package/dist/{cli-srktrbby.js → cli-hzhv7yac.js} +1 -1
  68. package/dist/{cli-cp163xga.js → cli-jcnc5ret.js} +44 -32
  69. package/dist/{cli-j69pzrrz.js → cli-jgq9xptq.js} +5 -5
  70. package/dist/{cli-kwj3131p.js → cli-jwnac23b.js} +1 -1
  71. package/dist/{cli-wzecestt.js → cli-kc7vd07m.js} +616 -289
  72. package/dist/{cli-8pd1t17c.js → cli-kg63yp1r.js} +14 -14
  73. package/dist/{cli-zzq96q57.js → cli-krk8y8c7.js} +727 -139
  74. package/dist/{cli-5web09sb.js → cli-m0ea8ggd.js} +8 -10
  75. package/dist/{cli-qrvk9nka.js → cli-md4tn21h.js} +13 -13
  76. package/dist/{cli-1jq2em7b.js → cli-mv8ft7b0.js} +10 -9
  77. package/dist/{cli-ryem5cfq.js → cli-mw1tmn3x.js} +217 -27
  78. package/dist/{cli-abby987g.js → cli-njvpngc6.js} +3 -3
  79. package/dist/{cli-55h8m1x3.js → cli-phe2vcw5.js} +6 -6
  80. package/dist/{cli-prz1p3ft.js → cli-pq0kv31y.js} +5 -5
  81. package/dist/{cli-q1h041y8.js → cli-q457ga28.js} +6 -6
  82. package/dist/{cli-z40t85ms.js → cli-q5n3deaf.js} +1 -1
  83. package/dist/{cli-7ypg8hka.js → cli-qkbevqer.js} +3 -3
  84. package/dist/{cli-f9xw9pr4.js → cli-qrwjk4xy.js} +5 -5
  85. package/dist/{cli-kezzteka.js → cli-r04ve9xw.js} +1 -1
  86. package/dist/{cli-zntvmqmm.js → cli-r495stwd.js} +2 -2
  87. package/dist/{cli-1kvcsd2f.js → cli-r9d2tya0.js} +71 -3
  88. package/dist/{cli-ybte1fqc.js → cli-rp1n2xpd.js} +1 -1
  89. package/dist/{cli-sejvnjvw.js → cli-rs1rzwp4.js} +1 -1
  90. package/dist/{cli-94mxerrp.js → cli-rzbsh6bw.js} +1 -1
  91. package/dist/{cli-94gx6ze9.js → cli-s4pccby1.js} +1 -1
  92. package/dist/{cli-hd5bm1e1.js → cli-shyhb4t5.js} +10 -10
  93. package/dist/{cli-r3dxpmyt.js → cli-srq69pn1.js} +1 -1
  94. package/dist/{cli-7r9tvk8v.js → cli-tc165vrb.js} +8 -3
  95. package/dist/{cli-ced4azn1.js → cli-v4z5v3jd.js} +298 -80
  96. package/dist/{cli-ehg90jd1.js → cli-vxmmttmt.js} +55 -50
  97. package/dist/{cli-tt7dkwjj.js → cli-w4bvtxet.js} +7 -7
  98. package/dist/{cli-x2adbg4j.js → cli-wd7b5hgc.js} +1 -1
  99. package/dist/{cli-htb5bpz2.js → cli-wvbaq052.js} +1 -1
  100. package/dist/{cli-ywy8yz6t.js → cli-wvgg7r4j.js} +2 -2
  101. package/dist/{cli-19d6v8er.js → cli-wym6rxgt.js} +165 -6
  102. package/dist/{cli-f7b9nyvk.js → cli-yd7e590v.js} +12 -12
  103. package/dist/{cli-69zzpjgh.js → cli-yjb3cddd.js} +1 -1
  104. package/dist/{cli-5n9w2xzx.js → cli-z8t4485r.js} +2 -2
  105. package/dist/{cli-jdq3jmny.js → cli-ze1ndjs4.js} +4 -6
  106. package/dist/cli.js +28 -28
  107. package/dist/{codex-adapter-bn7eaxk5.js → codex-adapter-eq61radw.js} +8 -8
  108. package/dist/{codex-hook-nnmezjg9.js → codex-hook-8nmepvz6.js} +3 -3
  109. package/dist/{codex-login-ktfg1cxk.js → codex-login-vbd9707w.js} +1 -1
  110. package/dist/{codex-session-runner-j1e9hffc.js → codex-session-runner-rfx355h4.js} +9 -9
  111. package/dist/{commands-amhpafrr.js → commands-d1z0sx62.js} +3 -3
  112. package/dist/{controller-tw7g10j2.js → controller-9hz6d8x3.js} +4 -4
  113. package/dist/{controllers-connect-2ssqz7f4.js → controllers-connect-tz07d2xr.js} +24 -25
  114. package/dist/core-dynsv289.js +41 -0
  115. package/dist/{cursor-adapter-d6knjmwa.js → cursor-adapter-ef22ze3j.js} +2 -2
  116. package/dist/{db-fd6xxm77.js → db-gd81d68c.js} +3 -3
  117. package/dist/{db-sc59379z.js → db-vrckks6q.js} +4 -2
  118. package/dist/{devin-adapter-3bp6rape.js → devin-adapter-kdt6a2bh.js} +1 -1
  119. package/dist/{dispatcher-a2gdqz8c.js → dispatcher-76as8w2t.js} +21 -22
  120. package/dist/{docker-a59g3ebm.js → docker-51ta7jsh.js} +2 -2
  121. package/dist/dsh-adapter-ypfvcdyz.js +11 -0
  122. package/dist/{e2b-cn7cvjqy.js → e2b-05kn3kpq.js} +16 -5
  123. package/dist/{e2b-qnxyfea6.js → e2b-dm9r8hpy.js} +3 -3
  124. package/dist/{easter-egg-3d-a0pphy71.js → easter-egg-3d-sg21j15g.js} +1 -1
  125. package/dist/{embedding-space-qepzrach.js → embedding-space-zsdw37bb.js} +13 -23
  126. package/dist/{embeddings-d7vr881x.js → embeddings-p4e3e1m6.js} +1 -1
  127. package/dist/{event-bus-7gbsr0g4.js → event-bus-tvf2grf4.js} +1 -1
  128. package/dist/{execute-6afts2bn.js → execute-nztd0af0.js} +1 -1
  129. package/dist/{external-channel-881zq1x4.js → external-channel-717yzn4d.js} +2 -2
  130. package/dist/fx-adapter-9k0hptnz.js +20 -0
  131. package/dist/grok-adapter-skdj2pce.js +20 -0
  132. package/dist/handlers-5btjqkz6.js +39 -0
  133. package/dist/{heartbeat-4c022m6a.js → heartbeat-vfb1gy84.js} +24 -25
  134. package/dist/{hook-a7eh6zty.js → hook-ctz0xmp3.js} +11 -11
  135. package/dist/{hook-4k84x499.js → hook-eh52p7yd.js} +6 -6
  136. package/dist/{http-6aw5wanc.js → http-zregegrx.js} +784 -166
  137. package/dist/{index-xhad0n8m.js → index-5kx15d19.js} +1 -1
  138. package/dist/index-7w8p6em0.js +41 -0
  139. package/dist/index-evay0xyk.js +17 -0
  140. package/dist/{index-yq9hhhhy.js → index-fdym6ryb.js} +25 -26
  141. package/dist/{index-3j803vnb.js → index-mtnbhe12.js} +20533 -19786
  142. package/dist/index-vz4semsx.js +38 -0
  143. package/dist/{index-z2g9469g.js → index-x9qf8dg7.js} +108 -28
  144. package/dist/index-y3s0xp2v.js +43 -0
  145. package/dist/{k8s-36gfn847.js → k8s-ejkk0aw7.js} +2 -2
  146. package/dist/{keepalive-zhbmztqw.js → keepalive-zdqay870.js} +4 -5
  147. package/dist/lead-6cscw8a5.js +82 -0
  148. package/dist/{maintenance-rsp0591h.js → maintenance-t5ndg11m.js} +1 -1
  149. package/dist/{node-rxte5hc6.js → node-jkdd5w7m.js} +1 -1
  150. package/dist/{oauth-refresh-sweep-w3cqmxq7.js → oauth-refresh-sweep-y9zyd7t6.js} +3 -4
  151. package/dist/{object-webhooks-331hay92.js → object-webhooks-mkca91s0.js} +7 -7
  152. package/dist/{onboard-n2w80m2n.js → onboard-ss995244.js} +11 -9
  153. package/dist/{opencode-adapter-z98127cz.js → opencode-adapter-mwpz0278.js} +8 -8
  154. package/dist/{otel-impl-xsk35tvf.js → otel-impl-6n6vva3x.js} +2 -2
  155. package/dist/{pending-2e6trkxd.js → pending-2sxh1t6j.js} +22 -23
  156. package/dist/{pi-mono-adapter-wh6yndtm.js → pi-mono-adapter-sfb7zy43.js} +13 -13
  157. package/dist/{pricing-refresh-9355dj1t.js → pricing-refresh-h79bg4cf.js} +2 -2
  158. package/dist/{rbac-roles-8eajw4s6.js → rbac-roles-ckq0czp4.js} +2 -2
  159. package/dist/{rbac-roles-58y3m912.js → rbac-roles-jg2e260w.js} +3 -3
  160. package/dist/{render-v2-7gskkmd4.js → render-v2-ymbshmn0.js} +7 -7
  161. package/dist/{resume-0drnmpja.js → resume-jdhnt4jk.js} +10 -10
  162. package/dist/{runtime-d2tcmqte.js → runtime-y28jhhnf.js} +1 -1
  163. package/dist/{session-access-0ztys6bd.js → session-access-k4ta5hvp.js} +5 -5
  164. package/dist/{session-source-backfill-cdm5s046.js → session-source-backfill-528j4s8j.js} +3 -3
  165. package/dist/{setup-pqwb9tcc.js → setup-d6pj82fr.js} +15 -6
  166. package/dist/thread-buffer-9w6x5zec.js +40 -0
  167. package/dist/{tree-visibility-rwz67mje.js → tree-visibility-kjxv3nxk.js} +2 -2
  168. package/dist/{user-merge-jobs-mxrhamwt.js → user-merge-jobs-rabbncf6.js} +3 -3
  169. package/dist/{virtual-modules-71y1gsmg.js → virtual-modules-22k51txd.js} +3 -3
  170. package/dist/{work-objects-3k4ykt9j.js → work-objects-xtjbar3r.js} +26 -30
  171. package/dist/{worker-follow-up-y0h64xpr.js → worker-follow-up-fg48vk6d.js} +21 -22
  172. package/dist/worker-g4aj93dt.js +82 -0
  173. package/dist/{x-d27jj7z7.js → x-vfsqypht.js} +2 -2
  174. package/openapi.json +247 -20
  175. package/package.json +10 -10
  176. package/src/apps/definition.ts +76 -24
  177. package/src/apps/row-store.ts +67 -0
  178. package/src/apps/script-types.ts +131 -21
  179. package/src/apps/store.ts +4 -1
  180. package/src/be/db/script-runs.ts +33 -0
  181. package/src/be/db/slack-card-groups.ts +147 -0
  182. package/src/be/db/slack-trees.ts +26 -0
  183. package/src/be/db/task-idempotency.ts +63 -0
  184. package/src/be/db/tasks/read.ts +2 -0
  185. package/src/be/db/tasks/write.ts +4 -2
  186. package/src/be/db/workflow-idempotency.ts +6 -1
  187. package/src/be/db/workflows/read.ts +79 -0
  188. package/src/be/db.ts +51 -147
  189. package/src/be/improvements.ts +24 -2
  190. package/src/be/mcp-proxy.ts +45 -11
  191. package/src/be/memory/embedding-space.ts +10 -20
  192. package/src/be/memory/index.ts +35 -0
  193. package/src/be/memory/providers/openai-embedding.ts +10 -0
  194. package/src/be/migrations/348_task_deferred_until.sql +4 -0
  195. package/src/be/migrations/354_durable_objects.sql +9 -0
  196. package/src/be/migrations/356_slack_outcome_card_groups.sql +14 -0
  197. package/src/be/migrations/357_task_idempotency_keys.sql +27 -0
  198. package/src/be/migrations/362_favorites_app.sql +36 -0
  199. package/src/be/repo-checked-update.ts +58 -5
  200. package/src/be/requester-timezone.ts +10 -0
  201. package/src/be/script-connections.ts +5 -1
  202. package/src/be/script-credential-broker.ts +29 -2
  203. package/src/be/scripts/durable.ts +204 -0
  204. package/src/be/scripts/extract-schema.ts +29 -4
  205. package/src/be/scripts/run-credential.ts +1 -8
  206. package/src/be/scripts/typecheck.ts +32 -7
  207. package/src/be/seed-scripts/catalog/memory-eval.ts +11 -2
  208. package/src/be/seed-scripts/catalog/tool-usage.ts +27 -8
  209. package/src/be/swarm-config-guard.ts +87 -7
  210. package/src/be/users.ts +33 -12
  211. package/src/comb/review-batch.ts +16 -5
  212. package/src/commands/context-preamble.ts +237 -0
  213. package/src/commands/e2b.ts +14 -0
  214. package/src/commands/entrypoint-mcp-config.ts +231 -0
  215. package/src/commands/onboard/agent-fs-version.ts +1 -1
  216. package/src/commands/onboard/compose-generator.ts +2 -1
  217. package/src/commands/onboard/env-generator.ts +16 -7
  218. package/src/commands/runner.ts +23 -7
  219. package/src/commands/setup.tsx +17 -3
  220. package/src/extensions/contract-types.generated.ts +1 -1
  221. package/src/hooks/hook.ts +8 -2
  222. package/src/hooks/native-tool-hooks.ts +4 -2
  223. package/src/http/apps.ts +82 -42
  224. package/src/http/comb.ts +21 -5
  225. package/src/http/config.ts +8 -4
  226. package/src/http/heartbeat.ts +5 -0
  227. package/src/http/index.ts +12 -6
  228. package/src/http/kv.ts +7 -5
  229. package/src/http/mcp-oauth.ts +16 -0
  230. package/src/http/mcp-servers.ts +43 -3
  231. package/src/http/memory.ts +28 -1
  232. package/src/http/metrics.ts +11 -4
  233. package/src/http/onboarding.ts +12 -1
  234. package/src/http/repos.ts +27 -11
  235. package/src/http/request-principal.ts +27 -1
  236. package/src/http/schedules.ts +36 -8
  237. package/src/http/script-connection-proxy.ts +3 -1
  238. package/src/http/script-runs.ts +21 -10
  239. package/src/http/scripts.ts +177 -26
  240. package/src/http/session-cost-recompute.ts +9 -4
  241. package/src/http/skills.ts +70 -0
  242. package/src/http/status.ts +2 -0
  243. package/src/http/tasks.ts +92 -14
  244. package/src/http/trackers/jira.ts +18 -3
  245. package/src/http/trackers/linear.ts +3 -0
  246. package/src/kv-limits.ts +2 -0
  247. package/src/kv-reserved-namespaces.ts +25 -2
  248. package/src/prompts/session-templates.ts +49 -0
  249. package/src/prompts/session-turns.ts +30 -0
  250. package/src/providers/amp-adapter.ts +1 -1
  251. package/src/providers/claude-managed-adapter.ts +14 -0
  252. package/src/providers/claude-sdk-session.ts +14 -1
  253. package/src/providers/cursor-adapter.ts +1 -1
  254. package/src/providers/dsh-adapter.ts +1 -1
  255. package/src/providers/opencode-adapter.ts +3 -5
  256. package/src/providers/runtime-dependencies.ts +11 -8
  257. package/src/rbac/legacy-policy.ts +7 -0
  258. package/src/rbac/permissions.ts +27 -0
  259. package/src/scheduler/scheduler.ts +36 -18
  260. package/src/script-workflows/executor.ts +37 -8
  261. package/src/script-workflows/supervisor.ts +14 -0
  262. package/src/scripts-runtime/ctx.ts +5 -1
  263. package/src/scripts-runtime/durable-object-base.ts +19 -0
  264. package/src/scripts-runtime/eval-harness.ts +46 -1
  265. package/src/scripts-runtime/executors/native.ts +13 -1
  266. package/src/scripts-runtime/executors/quickjs-bundle.ts +20 -1
  267. package/src/scripts-runtime/executors/quickjs-prelude.ts +40 -1
  268. package/src/scripts-runtime/executors/quickjs-runner.ts +26 -3
  269. package/src/scripts-runtime/executors/quickjs-worker.ts +2 -1
  270. package/src/scripts-runtime/executors/types.ts +26 -0
  271. package/src/scripts-runtime/extract-signature.ts +96 -1
  272. package/src/scripts-runtime/loader.ts +11 -5
  273. package/src/scripts-runtime/mcp-client.ts +1 -1
  274. package/src/scripts-runtime/sdk-allowlist.ts +1 -0
  275. package/src/scripts-runtime/swarm-config.ts +7 -0
  276. package/src/scripts-runtime/swarm-sdk.ts +4 -1
  277. package/src/scripts-runtime/types/stdlib.d.ts +19 -0
  278. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  279. package/src/scripts-runtime/types/swarm-sdk.d.ts +19 -0
  280. package/src/slack/actions.ts +24 -0
  281. package/src/slack/assistant.ts +8 -0
  282. package/src/slack/blocks.ts +35 -0
  283. package/src/slack/channel-activity.ts +7 -0
  284. package/src/slack/enrich.ts +46 -54
  285. package/src/slack/files.ts +173 -23
  286. package/src/slack/handlers.test.ts +17 -19
  287. package/src/slack/handlers.ts +15 -14
  288. package/src/slack/render-v2.ts +264 -19
  289. package/src/slack/responses.ts +61 -5
  290. package/src/slack/session-mirror.ts +10 -5
  291. package/src/slack/task-output.ts +25 -14
  292. package/src/slack/templates.ts +9 -0
  293. package/src/slack/thread-participants.ts +64 -24
  294. package/src/slack/watcher.ts +4 -4
  295. package/src/slack/work-objects.ts +1 -1
  296. package/src/stdio.ts +5 -0
  297. package/src/tests/agents-list-model-display.test.ts +4 -0
  298. package/src/tests/apps-script-types.test.ts +63 -16
  299. package/src/tests/apps-sort-order.test.ts +87 -0
  300. package/src/tests/bedrock-model-groups.test.ts +4 -0
  301. package/src/tests/channel-activity.test.ts +9 -0
  302. package/src/tests/chatgpt-subscription-model-groups.test.ts +4 -0
  303. package/src/tests/claude-hook-output.test.ts +2 -0
  304. package/src/tests/claude-managed-adapter.test.ts +15 -3
  305. package/src/tests/claude-sdk-stderr.test.ts +28 -0
  306. package/src/tests/codex-gpt6-release.test.ts +4 -0
  307. package/src/tests/comb-review-batch.test.ts +17 -4
  308. package/src/tests/comb-status.test.ts +1 -0
  309. package/src/tests/db-client.test.ts +11 -5
  310. package/src/tests/db-task-read-contract.test.ts +1 -0
  311. package/src/tests/db-task-write-contract.test.ts +2 -2
  312. package/src/tests/defer-task.test.ts +23 -1
  313. package/src/tests/dsh-adapter.test.ts +1 -1
  314. package/src/tests/e2b-dispatch.test.ts +13 -1
  315. package/src/tests/entrypoint-mcp-config.test.ts +642 -0
  316. package/src/tests/fixtures/onboard/content.env.txt +2 -2
  317. package/src/tests/fixtures/onboard/dev.env.txt +2 -2
  318. package/src/tests/fixtures/onboard/full-all.env.txt +2 -2
  319. package/src/tests/fixtures/onboard/full.env.txt +2 -2
  320. package/src/tests/fixtures/onboard/research.env.txt +2 -2
  321. package/src/tests/fixtures/onboard/solo.env.txt +2 -2
  322. package/src/tests/fixtures/runner-missing-dependency.ts +2 -1
  323. package/src/tests/fx-adapter.test.ts +4 -5
  324. package/src/tests/hook-mcp-config-precedence.test.ts +59 -0
  325. package/src/tests/hook-ping-me-order.test.ts +1 -0
  326. package/src/tests/hook-runtime-close.test.ts +1 -0
  327. package/src/tests/improvements-payload.test.ts +2 -2
  328. package/src/tests/model-groups-live-catalog.test.ts +4 -0
  329. package/src/tests/oauth-credential-bindings.test.ts +8 -3
  330. package/src/tests/oauth-refresh-failure.test.ts +15 -3
  331. package/src/tests/onboard-env.test.ts +1 -1
  332. package/src/tests/openai-compatible-providers.test.ts +5 -0
  333. package/src/tests/openapi-route-headers.test.ts +2 -1
  334. package/src/tests/opus-5-5-registry.test.ts +4 -0
  335. package/src/tests/provider-runtime-dependencies.test.ts +26 -15
  336. package/src/tests/routing-affinity-inventory.test.ts +11 -0
  337. package/src/tests/runner-context-preamble.test.ts +202 -0
  338. package/src/tests/runner-repo-clone-args.test.ts +116 -0
  339. package/src/tests/scheduler-occurrence.test.ts +60 -9
  340. package/src/tests/script-connections-mcp.test.ts +6 -3
  341. package/src/tests/script-connections.test.ts +4 -0
  342. package/src/tests/scripts-namespaces.test.ts +3 -1
  343. package/src/tests/secret-scrubber.test.ts +8 -2
  344. package/src/tests/session-cost-recompute-unit.test.ts +39 -0
  345. package/src/tests/session-costs-recompute-all-providers.test.ts +6 -3
  346. package/src/tests/session-route-posture.test.ts +7 -1
  347. package/src/tests/slack-file-tools-attachments.test.ts +14 -9
  348. package/src/tests/slack-identity-resolution.test.ts +10 -3
  349. package/src/tests/slack-inline-output.test.ts +10 -8
  350. package/src/tests/slack-render-v2.test.ts +9 -4
  351. package/src/tests/slack-steering.test.ts +8 -2
  352. package/src/tests/slack-thread-participants.test.ts +11 -1
  353. package/src/tests/sonnet-5-5-registry.test.ts +4 -0
  354. package/src/tests/swarm-config-encryption.test.ts +5 -8
  355. package/src/tests/ui-spec-script-actions-config.test.ts +7 -3
  356. package/src/tests/workflow-triggers-v2.test.ts +35 -11
  357. package/src/tools/app-patch.ts +6 -2
  358. package/src/tools/app-upsert.ts +8 -4
  359. package/src/tools/defer-task.ts +17 -77
  360. package/src/tools/kv/kv-get.ts +2 -0
  361. package/src/tools/kv/kv-list.ts +11 -5
  362. package/src/tools/kv/kv-set.ts +1 -3
  363. package/src/tools/repos/update-repo.ts +37 -19
  364. package/src/tools/schedules/run-schedule-now.ts +21 -1
  365. package/src/tools/script-apis.ts +9 -4
  366. package/src/tools/script-common.ts +2 -2
  367. package/src/tools/script-run.ts +8 -0
  368. package/src/tools/script-upsert.ts +1 -1
  369. package/src/tools/slack-download-file.ts +15 -12
  370. package/src/tools/slack-post.ts +7 -1
  371. package/src/tools/slack-read.ts +3 -1
  372. package/src/tools/slack-reply.ts +16 -0
  373. package/src/tools/slack-start-thread.ts +8 -1
  374. package/src/tools/slack-upload-file.ts +99 -96
  375. package/src/tools/swarm-config/set-config.ts +3 -1
  376. package/src/tools/swarm-x.ts +0 -2
  377. package/src/tools/utils.ts +3 -0
  378. package/src/types.ts +8 -2
  379. package/src/utils/constants.ts +20 -0
  380. package/src/utils/deferral-time.ts +61 -0
  381. package/src/utils/request-auth-context.ts +15 -16
  382. package/src/utils/secret-scrubber.ts +1 -1
  383. package/src/workflows/engine.ts +6 -11
  384. package/src/workflows/executors/swarm-script.ts +0 -2
  385. package/src/workflows/foreach-driver.ts +6 -12
  386. package/src/workflows/input.ts +24 -1
  387. package/src/workflows/node-timeout.ts +18 -0
  388. package/src/workflows/retry-poller.ts +2 -1
  389. package/src/workflows/triggers.ts +21 -11
  390. package/src/x/composio.ts +10 -1
  391. package/templates/skills/apps/SKILL.md +4 -2
  392. package/templates/skills/apps/content.md +4 -2
  393. package/templates/skills/code-quality/content.md +4 -4
  394. package/templates/skills/scheduled-task-resilience/SKILL.md +2 -0
  395. package/templates/skills/scheduled-task-resilience/content.md +2 -0
  396. package/templates/skills/swarm-docs/content.md +7 -0
  397. package/templates/skills/swarm-scripts/SKILL.md +44 -0
  398. package/templates/skills/swarm-scripts/content.md +44 -0
  399. package/dist/acp-adapter-tbt61zkm.js +0 -17
  400. package/dist/cli-b9ygp1kz.js +0 -459
  401. package/dist/cli-kj0hyr43.js +0 -51
  402. package/dist/cli-m8f4379k.js +0 -173
  403. package/dist/core-bwp98v4w.js +0 -42
  404. package/dist/dsh-adapter-43ygwqn7.js +0 -9
  405. package/dist/fx-adapter-cr2hq17y.js +0 -20
  406. package/dist/grok-adapter-ayddnbsc.js +0 -20
  407. package/dist/handlers-7ghs84x2.js +0 -41
  408. package/dist/index-dtt0d634.js +0 -44
  409. package/dist/index-hmszyqkk.js +0 -42
  410. package/dist/index-j6rm1rtn.js +0 -39
  411. package/dist/index-rwwhsmjg.js +0 -13
  412. package/dist/lead-g2j4q39z.js +0 -83
  413. package/dist/thread-buffer-epx3san4.js +0 -42
  414. package/dist/worker-09gqn9xy.js +0 -83
@@ -1,11 +1,17 @@
1
+ import pkg from "../../../package.json";
1
2
  import { expandServices } from "./service-names.ts";
2
3
  import type { OnboardState } from "./types.ts";
3
4
 
4
5
  /**
5
6
  * Generate a .env file string from onboard wizard state.
6
7
  * Uses real values from state (not placeholders).
8
+ * `imageVersion` is the default AGENT_SWARM_VERSION pin: this CLI's release.
7
9
  */
8
- export function generateEnv(state: OnboardState, env: NodeJS.ProcessEnv = process.env): string {
10
+ export function generateEnv(
11
+ state: OnboardState,
12
+ env: NodeJS.ProcessEnv = process.env,
13
+ imageVersion: string = pkg.version,
14
+ ): string {
9
15
  const expanded = expandServices(state.services, state.agentIds);
10
16
  const lines: string[] = [];
11
17
 
@@ -16,12 +22,15 @@ export function generateEnv(state: OnboardState, env: NodeJS.ProcessEnv = proces
16
22
  lines.push(`MCP_BASE_URL=http://localhost:${port}`);
17
23
  lines.push("APP_URL=https://app.agent-swarm.dev");
18
24
 
19
- // Image pin. Blank resolves to `latest`, which moves on every commit to main
20
- // and is not a release. Left blank so a fresh install behaves as before;
21
- // operators set a published release from
22
- // https://github.com/desplega-ai/agent-swarm/releases before depending on it.
23
- lines.push("# Pin a release, e.g. AGENT_SWARM_VERSION=1.150.0. Blank tracks `latest`.");
24
- lines.push("AGENT_SWARM_VERSION=");
25
+ // Image pin. Defaults to this CLI's own release, so the API and agent images
26
+ // match the agent-fs and TEI pins that ship in the same release. Blank would
27
+ // resolve to `latest`, which moves on every commit to main and is not a
28
+ // release. AGENT_SWARM_VERSION in the installer's environment overrides it.
29
+ const pinned = env.AGENT_SWARM_VERSION?.trim() || imageVersion;
30
+ lines.push(
31
+ "# Image release for the API and agents. Change it to upgrade. Blank tracks `latest`.",
32
+ );
33
+ lines.push(`AGENT_SWARM_VERSION=${pinned}`);
25
34
 
26
35
  // Install path — read by src/telemetry.ts at boot to attribute the
27
36
  // "which entry point produced this install" cohort. Boolean/enum only,
@@ -132,6 +132,7 @@ import { buildAttachmentsSection } from "./attachments-section.ts";
132
132
  import {
133
133
  buildContextPreamble,
134
134
  buildResumeContextPreamble,
135
+ buildSessionFollowUpPreamble,
135
136
  prependContextPreamble,
136
137
  } from "./context-preamble.ts";
137
138
  import {
@@ -546,6 +547,14 @@ export async function ensureRepoForTask(
546
547
 
547
548
  let warning: string | null = null;
548
549
 
550
+ // git, gh and glab would read a leading "-" as an option (clone, and the fetch of an
551
+ // existing clone), not as the repo, the target or the branch.
552
+ if (url.startsWith("-") || clonePath.startsWith("-") || defaultBranch.startsWith("-")) {
553
+ throw new Error(
554
+ `Refusing to use repo ${name}: its url, clonePath and defaultBranch must not start with "-"`,
555
+ );
556
+ }
557
+
549
558
  if (!gitHeadExists) {
550
559
  console.log(`[${role}] Cloning ${name} to ${clonePath}...`);
551
560
  const provider = detectVcsProvider(url);
@@ -554,7 +563,7 @@ export async function ensureRepoForTask(
554
563
  } else if (provider === "gitlab") {
555
564
  await Bun.$`glab repo clone ${url} ${clonePath} -- --branch ${defaultBranch} --single-branch`.quiet();
556
565
  } else {
557
- await Bun.$`git clone --branch ${defaultBranch} --single-branch ${url} ${clonePath}`.quiet();
566
+ await Bun.$`git clone --branch ${defaultBranch} --single-branch -- ${url} ${clonePath}`.quiet();
558
567
  }
559
568
  // Validate the clone actually created the directory
560
569
  if (!existsSync(clonePath)) {
@@ -7465,14 +7474,14 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
7465
7474
 
7466
7475
  console.log(`\n[${role}] === Resuming paused task (iteration ${iteration}) ===`);
7467
7476
  console.log(`[${role}] Logging to: ${logFile}`);
7468
- console.log(`[${role}] Prompt: ${resumePrompt.slice(0, 100)}...`);
7477
+ console.log(`[${role}] Prompt: ${scrubSecrets(resumePrompt).slice(0, 100)}...`);
7469
7478
 
7470
7479
  const metadata = {
7471
7480
  type: metadataType,
7472
7481
  sessionId,
7473
7482
  iteration,
7474
7483
  timestamp: new Date().toISOString(),
7475
- prompt: resumePrompt,
7484
+ prompt: scrubSecrets(resumePrompt),
7476
7485
  trigger: "task_resumed",
7477
7486
  resumedTaskId: task.id,
7478
7487
  };
@@ -7909,8 +7918,13 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
7909
7918
  "task" in trigger.task
7910
7919
  ? (trigger.task as { task: string; id?: string; contextKey?: string })
7911
7920
  : null;
7912
- const taskObj = trigger.task as { parentTaskId?: string; taskType?: string } | undefined;
7921
+ const taskObj = trigger.task as
7922
+ | { parentTaskId?: string; taskType?: string; source?: string }
7923
+ | undefined;
7913
7924
  const isResumeTask = taskObj?.taskType === "resume";
7925
+ // A Sessions message to the Lead reads against the session's last Lead
7926
+ // turns, not one parent: a fresh session per message keeps no transcript.
7927
+ const isSessionFollowUp = isLead && !isResumeTask && taskObj?.source === "ui";
7914
7928
  const taskVcsRepo = (trigger.task as { vcsRepo?: string } | undefined)?.vcsRepo;
7915
7929
 
7916
7930
  // The prompt enrichment below needs several API reads that do not
@@ -7938,7 +7952,9 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
7938
7952
  taskObj?.parentTaskId && apiUrl
7939
7953
  ? isResumeTask
7940
7954
  ? buildResumeContextPreamble(apiUrl, apiKey, taskObj.parentTaskId)
7941
- : buildContextPreamble(apiUrl, apiKey, taskObj.parentTaskId)
7955
+ : isSessionFollowUp
7956
+ ? buildSessionFollowUpPreamble(apiUrl, apiKey, taskObj.parentTaskId)
7957
+ : buildContextPreamble(apiUrl, apiKey, taskObj.parentTaskId)
7942
7958
  : null,
7943
7959
  fetchProfileSyncRejectionBanner({
7944
7960
  ...apiConfig,
@@ -8163,7 +8179,7 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
8163
8179
 
8164
8180
  console.log(`\n[${role}] === Iteration ${iteration} ===`);
8165
8181
  console.log(`[${role}] Logging to: ${logFile}`);
8166
- console.log(`[${role}] Prompt: ${triggerPrompt.slice(0, 100)}...`);
8182
+ console.log(`[${role}] Prompt: ${scrubSecrets(triggerPrompt).slice(0, 100)}...`);
8167
8183
  if (effectiveCwd) {
8168
8184
  console.log(`[${role}] Working directory: ${effectiveCwd}`);
8169
8185
  }
@@ -8173,7 +8189,7 @@ export async function runAgent(config: RunnerConfig, opts: RunnerOptions) {
8173
8189
  sessionId,
8174
8190
  iteration,
8175
8191
  timestamp: new Date().toISOString(),
8176
- prompt: triggerPrompt,
8192
+ prompt: scrubSecrets(triggerPrompt),
8177
8193
  trigger: trigger.type,
8178
8194
  };
8179
8195
  await Bun.write(logFile, `${JSON.stringify(metadata)}\n`);
@@ -204,12 +204,15 @@ export function Setup({ dryRun = false, restore = false, yes = false }: SetupPro
204
204
  gitignoreContent = await gitignoreFile.text();
205
205
  }
206
206
 
207
+ // Match whole lines: a substring hit (a comment, a `!` rule) does not ignore
208
+ // anything. `.mcp.json` and its backup hold the API bearer token.
209
+ const ignoreLines = new Set(gitignoreContent.split(/\r?\n/).map((line) => line.trim()));
207
210
  const entriesToAdd: string[] = [];
208
- if (!gitignoreContent.includes(".claude")) {
211
+ if (!ignoreLines.has(".claude") && !ignoreLines.has(".claude/")) {
209
212
  entriesToAdd.push(".claude");
210
213
  }
211
- if (!gitignoreContent.includes(".mcp.json")) {
212
- entriesToAdd.push(".mcp.json");
214
+ for (const entry of [".mcp.json", ".mcp.json.bak"]) {
215
+ if (!ignoreLines.has(entry)) entriesToAdd.push(entry);
213
216
  }
214
217
 
215
218
  if (entriesToAdd.length > 0) {
@@ -223,6 +226,17 @@ export function Setup({ dryRun = false, restore = false, yes = false }: SetupPro
223
226
  } else {
224
227
  addLog(".gitignore already contains required entries");
225
228
  }
229
+
230
+ // An ignore rule does not untrack a file that is already committed.
231
+ const tracked = await Bun.$`git -C ${cwd} ls-files .mcp.json .mcp.json.bak`
232
+ .quiet()
233
+ .nothrow();
234
+ const trackedFiles = tracked.stdout.toString().trim();
235
+ if (trackedFiles) {
236
+ addLog(
237
+ `Warning: ${trackedFiles.split("\n").join(", ")} is tracked by git and will hold the API token. Run: git rm --cached ${trackedFiles.split("\n").join(" ")}`,
238
+ );
239
+ }
226
240
  } else {
227
241
  addLog("Not a git repository (skipping .gitignore update)");
228
242
  }
@@ -1,4 +1,4 @@
1
1
  // Generated by scripts/bundle-extension-types.ts. Do not edit.
2
2
  // biome-ignore-all lint/suspicious/noTemplateCurlyInString: Type declarations contain literal template placeholders.
3
3
  export const EXTENSION_TYPE_DEFINITIONS =
4
- '// biome-ignore-all lint/suspicious/noConfusingVoidType: Extension handlers may explicitly return no result.\ndeclare module "swarm-extension" {\n export type CreateTaskOptions = {\n key?: string | undefined;\n agentId?: string | null | undefined;\n creatorAgentId?: string | undefined;\n source?:\n | "chat"\n | "workflow"\n | "schedule"\n | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "comb"\n | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n taskType?: string | undefined;\n tags?: string[] | undefined;\n priority?: number | undefined;\n dependsOn?: string[] | undefined;\n offeredTo?: string | undefined;\n status?: "draft" | "backlog" | "unassigned" | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n overrideSlackContext?: boolean | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | undefined;\n workflowRunStepId?: string | undefined;\n sourceTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n inheritParentOutputSchema?: boolean | undefined;\n inheritParentRequester?: boolean | undefined;\n inheritParentRoutingAffinity?: boolean | undefined;\n inheritParentFollowUpConfig?: boolean | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n requestedByUserId?: string | undefined;\n contextKey?: string | undefined;\n bypassTrackerContextDedup?: boolean | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n };\n\n export type AgentTask = {\n id: string;\n key: string;\n agentId: string | null;\n task: string;\n status:\n | "skipped"\n | "draft"\n | "backlog"\n | "unassigned"\n | "offered"\n | "reviewing"\n | "pending"\n | "in_progress"\n | "paused"\n | "completed"\n | "failed"\n | "cancelled"\n | "superseded";\n source:\n | "chat"\n | "workflow"\n | "schedule"\n | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "comb";\n tags: string[];\n priority: number;\n dependsOn: string[];\n createdAt: string;\n lastUpdatedAt: string;\n slackReplySent: boolean;\n wasPaused: boolean;\n creatorAgentId?: string | undefined;\n title?: string | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n poolWakeAt?: string | undefined;\n taskType?: string | undefined;\n offeredTo?: string | undefined;\n offeredAt?: string | undefined;\n acceptedAt?: string | undefined;\n rejectionReason?: string | undefined;\n finishedAt?: string | undefined;\n notifiedAt?: string | undefined;\n statusKind?:\n | "error"\n | "workflow"\n | "external"\n | "agent"\n | "runner"\n | "deferred"\n | "cascade"\n | "user"\n | "system"\n | "graceful_shutdown"\n | "context_limits"\n | "manual_supersede"\n | "crash_recovery"\n | "provider_fallback"\n | "workflow_retry"\n | undefined;\n failureReason?: string | undefined;\n output?: string | undefined;\n progress?: string | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n slackProgressMessageTs?: string | undefined;\n slackTreeRootMessageTs?: string | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n claudeSessionId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n resolvedModel?: string | undefined;\n modelSource?: string | undefined;\n modelAlias?: string | undefined;\n resolvedEffort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n resolvedProfile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | null | undefined;\n workflowRunStepId?: string | null | undefined;\n contextKey?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n deferredAt?: string | undefined;\n compactionCount?: number | undefined;\n peakContextPercent?: number | undefined;\n peakContextTokens?: number | undefined;\n contextWindowSize?: number | undefined;\n credentialKeySuffix?: string | undefined;\n credentialKeyType?: string | undefined;\n requestedByUserId?: string | undefined;\n swarmVersion?: string | undefined;\n provider?:\n | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n providerMeta?: Record<string, unknown> | undefined;\n harnessVariant?: string | undefined;\n harnessVariantMeta?: Record<string, unknown> | undefined;\n totalCostUsd?: number | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n routingAffinityInvalid?: boolean | undefined;\n };\n\n export type ActiveSession = {\n id: string;\n agentId: string;\n taskId: string | null;\n triggerType: string;\n inboxMessageId: string | null;\n taskDescription: string | null;\n runnerSessionId: string | null;\n providerSessionId: string | null;\n startedAt: string;\n lastHeartbeatAt: string;\n runtimeInstanceId?: string | null | undefined;\n };\n\n export type SteerMode = "steer" | "queue";\n\n export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui" | "app-page";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n auditSourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "native" | "mcp" | "extension" | "script-sdk";\n harness?: string | undefined;\n };\n\n import type { SwarmSdk } from "swarm-sdk";\n import type { z } from "zod";\n export type Runtime = "api" | "worker";\n export interface ExtensionScriptAsset {\n name: string;\n file: string;\n description: string;\n intent?: string;\n }\n export interface ExtensionScheduleAsset {\n name: string;\n description?: string;\n script: string;\n cronExpression?: string;\n intervalMs?: number;\n timezone?: string;\n args?: Record<string, unknown>;\n }\n export interface ExtensionWorkflowAsset {\n file: string;\n }\n export interface ExtensionSkillAsset {\n dir: string;\n }\n export interface ExtensionManifest {\n $schema?: string;\n name: string;\n description: string;\n version: string;\n runtime: Runtime;\n assets: {\n hooks: string;\n scripts?: readonly ExtensionScriptAsset[];\n schedules?: readonly ExtensionScheduleAsset[];\n workflows?: readonly ExtensionWorkflowAsset[];\n skills?: readonly ExtensionSkillAsset[];\n };\n homepage?: string;\n author?: string;\n /** Tool-call sources this extension\'s tool handlers receive. Default `["mcp"]`. */\n toolSources?: readonly ToolSource[];\n }\n /** `mcp`: swarm MCP tools. `native`: harness built-ins reported by a worker shim. */\n export type ToolSource = "mcp" | "native";\n export interface HooksModule {\n default: SwarmExtension;\n config?: z.ZodTypeAny;\n }\n export interface ExtensionState {\n get<T = unknown>(key: string): Promise<T | null>;\n set<T>(key: string, value: T): Promise<void>;\n incr(key: string, by?: number): Promise<number>;\n del(key: string): Promise<void>;\n }\n export interface ExtensionLogger {\n debug(message: string, data?: unknown): void;\n info(message: string, data?: unknown): void;\n warn(message: string, data?: unknown): void;\n error(message: string, data?: unknown): void;\n }\n type ConfigFor<M extends ExtensionManifest> = M extends {\n config: infer C extends z.ZodTypeAny;\n }\n ? z.infer<C>\n : Record<string, unknown>;\n export interface ApiCtx<Config = Record<string, unknown>> {\n swarm: SwarmSdk;\n state: ExtensionState;\n config: Config;\n log: ExtensionLogger;\n signal: AbortSignal;\n event: {\n name: keyof SwarmEventMap;\n at: string;\n extension: {\n id: string;\n version: number;\n };\n };\n }\n export interface WorkerCtx<Config = Record<string, unknown>>\n extends Omit<ApiCtx<Config>, "swarm"> {\n swarm: SwarmSdk;\n worker: {\n agentId: string;\n taskId: string;\n harness: string;\n };\n }\n export type CtxFor<M extends ExtensionManifest> = M["runtime"] extends "api"\n ? ApiCtx<ConfigFor<M>>\n : WorkerCtx<ConfigFor<M>>;\n export type PreResult<Modify> =\n | void\n | {\n action: "continue";\n }\n | {\n action: "modify";\n data: Modify;\n }\n | {\n action: "block";\n reason: string;\n };\n export type TaskCreateOrigin =\n | "rest"\n | "app"\n | "mcp"\n | "slack"\n | "schedule"\n | "workflow"\n | "webhook"\n | "followUp"\n | `extension:${string}`;\n export interface TaskCreateEvent {\n options: CreateTaskOptions;\n description: string;\n origin: TaskCreateOrigin;\n requestInfo?: RequestInfo;\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n trigger: "mention" | "thread-buffer";\n messages: {\n ts: string;\n userId: string;\n text: string;\n }[];\n };\n }\n /** A pre.task.create hook blocked a task before it was created. */\n export interface TaskBlockedEvent {\n /** The extension that blocked, or whose model/agent rewrite was rejected. */\n extension: {\n id: string;\n name: string;\n };\n /** The scrubbed block reason. */\n reason: string;\n origin: TaskCreateOrigin;\n source?: AgentTask["source"];\n requester: {\n userId?: string;\n agentId?: string;\n slackUserId?: string;\n };\n context?: {\n contextKey?: string;\n scheduleId?: string;\n workflowRunId?: string;\n workflowRunStepId?: string;\n parentTaskId?: string;\n vcsRepo?: string;\n vcsNumber?: number;\n slackChannelId?: string;\n slackThreadTs?: string;\n };\n /** The original task description, scrubbed and cut to 500 characters. */\n description: string;\n }\n export type TaskCreateModify = Partial<\n Pick<\n CreateTaskOptions,\n | "agentId"\n | "creatorAgentId"\n | "source"\n | "taskType"\n | "tags"\n | "priority"\n | "dependsOn"\n | "offeredTo"\n | "vcsProvider"\n | "vcsRepo"\n | "vcsEventType"\n | "vcsNumber"\n | "vcsCommentId"\n | "vcsAuthor"\n | "vcsUrl"\n | "vcsInstallationId"\n | "vcsNodeId"\n | "agentmailInboxId"\n | "agentmailMessageId"\n | "agentmailThreadId"\n | "mentionMessageId"\n | "mentionChannelId"\n | "dir"\n | "model"\n | "modelTier"\n | "effort"\n | "outputSchema"\n | "followUpConfig"\n | "bypassTrackerContextDedup"\n >\n > & {\n description?: string;\n };\n export interface TaskFollowUpEvent {\n completedTask: AgentTask;\n status: "completed" | "failed";\n output?: string;\n failureReason?: string;\n workerAgentId: string;\n leadAgentId: string;\n summary: string;\n }\n export interface TaskSteerEvent {\n task: AgentTask;\n message: string;\n mode: SteerMode;\n source: SteeringSource;\n sender: {\n kind: "user" | "agent" | "system";\n userId?: string;\n agentId?: string;\n };\n messageTimestamps?: string[];\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n channelId: string;\n threadTs: string;\n userId?: string;\n };\n }\n export interface TaskSteerModify {\n message: string;\n }\n export type TaskFollowUpModify = Partial<\n Pick<CreateTaskOptions, "agentId" | "priority" | "followUpConfig">\n > & {\n description?: string;\n };\n export interface SlackRouteEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n botMentioned: boolean;\n threadContext?: {\n channelId: string;\n threadTs: string;\n };\n }\n export interface SlackRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n };\n }\n /** A Chat SDK message after its thread buffer flushed, before routing. */\n export interface ChatRouteEvent {\n /** Adapter name, such as `telegram` or `slack`. */\n adapter: string;\n channelId: string;\n /** The Chat SDK thread id, prefixed with the adapter name. */\n threadId: string;\n /** The first buffered sender. */\n userId: string;\n userName?: string;\n /** The buffered messages, joined. */\n text: string;\n /** True for an @mention and for a reply to one of the bot\'s messages. */\n botMentioned: boolean;\n isDirectMessage: boolean;\n /** Platform chat type, such as Telegram `private`, `group`, `supergroup` or `channel`. */\n chatType?: string;\n /** Set for a Telegram supergroup with topics. */\n isForum?: boolean;\n /** A buffered message replies to one of the bot\'s own messages. */\n replyToBot: boolean;\n /** Set when earlier swarm tasks exist in this thread. */\n threadContext?: {\n adapter: string;\n threadId: string;\n };\n }\n export interface ChatRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n }\n | {\n kind: "workflow";\n workflowId: string;\n };\n }\n export type HeartbeatClassification = "no-session" | "stale-session" | "fresh-stalled";\n export type HeartbeatAction = "supersede-resume" | "fail" | "record";\n export interface HeartbeatRemediateEvent {\n task: AgentTask;\n session?: ActiveSession;\n classification: HeartbeatClassification;\n proposedAction: HeartbeatAction;\n reason: string;\n taskAgeMs: number;\n sessionHeartbeatAgeMs?: number;\n }\n export interface HeartbeatRemediateModify {\n proposedAction: HeartbeatAction;\n }\n export interface ToolCallEvent {\n tool: string;\n /** Secret-scrubbed on native calls: a secret reads as `[REDACTED:<name>]`. */\n args: unknown;\n requestInfo: RequestInfo;\n /** Native calls only: the harness\'s own tool name, such as `Bash`. */\n nativeTool?: string;\n /** Native calls only: the harness\'s own argument shape, secret-scrubbed. */\n rawArgs?: unknown;\n /** Native calls only: the harness\'s call id, and its parent for a nested call. */\n toolCallId?: string;\n parentToolCallId?: string;\n }\n export interface ToolCallModify {\n args: unknown;\n }\n export interface TaskEvent {\n task: AgentTask;\n }\n export interface TaskCompletedEvent extends TaskEvent {\n output: string;\n }\n export interface TaskFailedEvent extends TaskEvent {\n failureReason: string;\n }\n export interface TaskSupersededEvent extends TaskEvent {\n supersededBy: string;\n }\n export interface TaskProgressEvent extends TaskEvent {\n progress: string;\n }\n export interface SlackMessageEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n taskId?: string;\n }\n /** A Chat SDK message the swarm received or sent. */\n export interface ChatMessageEvent {\n adapter: string;\n channelId: string;\n threadId: string;\n /** The sender, for an inbound message. */\n userId?: string;\n text: string;\n direction: "inbound" | "outbound";\n taskId?: string;\n messageId?: string;\n }\n /**\n * A person answered an approval request. Fires for workflow and standalone\n * requests. Timeouts and cancellations do not emit it today.\n */\n export interface ApprovalResolvedEvent {\n requestId: string;\n status: "approved" | "rejected" | "timeout" | "cancelled";\n responses: Record<string, unknown> | null;\n /** Set when a workflow human-in-the-loop step asked. Absent for a standalone request. */\n workflowRunId?: string;\n workflowRunStepId?: string;\n /** The task whose agent asked, for a standalone request. */\n sourceTaskId?: string;\n }\n /** A task was refused because a daily spend budget is used up. */\n export interface TaskBudgetRefusedEvent extends TaskEvent {\n /** The agent the task was refused for. */\n agentId: string;\n /** Which budget refused it. The matching spend and budget fields are set. */\n cause: "agent" | "global" | "user";\n agentSpendUsd?: number;\n agentBudgetUsd?: number;\n globalSpendUsd?: number;\n globalBudgetUsd?: number;\n userSpendUsd?: number;\n userBudgetUsd?: number;\n /** ISO 8601 time the daily budget resets. */\n resetAt: string;\n }\n /** An inbound AgentMail message. */\n export interface EmailReceivedEvent {\n inboxId: string;\n /** The From header as sent. */\n from: string;\n subject: string;\n /** The text body, or the HTML when there is no text, cut to 500 characters with `...` appended. */\n body: string;\n threadId: string;\n messageId: string;\n }\n /** An inbound Kapso (WhatsApp) message. */\n export interface KapsoMessageEvent {\n phoneNumberId: string;\n conversationId?: string;\n messageId: string;\n from?: string;\n /** Kapso message type, such as `text` or `image`. */\n type?: string;\n /** The text, or a placeholder naming the type for a non-text message. */\n text: string;\n }\n export type VcsProvider = "github" | "gitlab" | "azure-devops" | "bitbucket";\n /**\n * The provider object the event is about, as the provider names it. GitLab\n * calls a pull request a merge request, and a comment a `note`.\n */\n export type VcsEventKind =\n | "pull_request"\n | "merge_request"\n | "issue"\n | "issue_comment"\n | "note"\n | "pull_request_review"\n | "pipeline";\n /**\n * A webhook event from a connected code host. `action` is the provider\'s own\n * value: `opened`, `closed`, `synchronize`, `merge`, `created`, `commented`, or,\n * for a pipeline, its status such as `success` or `failed`. Fields a kind does\n * not carry are absent.\n */\n export interface VcsEvent {\n provider: VcsProvider;\n kind: VcsEventKind;\n action: string;\n /** `owner/name` on GitHub and GitLab, `workspace/repo_slug` on Bitbucket, the repository URL on Azure DevOps. */\n repo: string;\n /** The PR, merge request, or issue number. Absent for a pipeline outside a merge request. */\n number?: number;\n title?: string;\n body?: string | null;\n /** Login of the user behind the event. Set for pull requests, merge requests, and Azure DevOps comments. */\n author?: string;\n url?: string;\n merged?: boolean;\n changedFiles?: number;\n /** The review verdict, on a pull request review. */\n reviewState?: string;\n }\n export interface ToolCallCompletedEvent extends ToolCallEvent {\n result: unknown;\n durationMs: number;\n /** Native calls only: the harness reported the call as failed. */\n isError?: boolean;\n }\n export interface SwarmEventMap {\n "pre.task.create": {\n event: TaskCreateEvent;\n modify: TaskCreateModify;\n result: PreResult<TaskCreateModify>;\n };\n "pre.task.followUp": {\n event: TaskFollowUpEvent;\n modify: TaskFollowUpModify;\n result: PreResult<TaskFollowUpModify>;\n };\n "pre.task.steer": {\n event: TaskSteerEvent;\n modify: TaskSteerModify;\n result: PreResult<TaskSteerModify>;\n };\n "pre.slack.route": {\n event: SlackRouteEvent;\n modify: SlackRouteModify;\n result: PreResult<SlackRouteModify>;\n };\n "pre.chat.route": {\n event: ChatRouteEvent;\n modify: ChatRouteModify;\n result: PreResult<ChatRouteModify>;\n };\n "pre.heartbeat.remediate": {\n event: HeartbeatRemediateEvent;\n modify: HeartbeatRemediateModify;\n result: PreResult<HeartbeatRemediateModify>;\n };\n "pre.tool.call": {\n event: ToolCallEvent;\n modify: ToolCallModify;\n result: PreResult<ToolCallModify>;\n };\n "post.task.created": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.blocked": {\n event: TaskBlockedEvent;\n modify: never;\n result: void;\n };\n "post.task.completed": {\n event: TaskCompletedEvent;\n modify: never;\n result: void;\n };\n "post.task.failed": {\n event: TaskFailedEvent;\n modify: never;\n result: void;\n };\n "post.task.cancelled": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.superseded": {\n event: TaskSupersededEvent;\n modify: never;\n result: void;\n };\n "post.task.progress": {\n event: TaskProgressEvent;\n modify: never;\n result: void;\n };\n "post.slack.message": {\n event: SlackMessageEvent;\n modify: never;\n result: void;\n };\n "post.chat.message": {\n event: ChatMessageEvent;\n modify: never;\n result: void;\n };\n "post.approval.resolved": {\n event: ApprovalResolvedEvent;\n modify: never;\n result: void;\n };\n "post.task.budgetRefused": {\n event: TaskBudgetRefusedEvent;\n modify: never;\n result: void;\n };\n "post.email.received": {\n event: EmailReceivedEvent;\n modify: never;\n result: void;\n };\n "post.kapso.message": {\n event: KapsoMessageEvent;\n modify: never;\n result: void;\n };\n "post.vcs.event": {\n event: VcsEvent;\n modify: never;\n result: void;\n };\n "post.tool.call": {\n event: ToolCallCompletedEvent;\n modify: never;\n result: void;\n };\n }\n export interface ExtensionApi<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > {\n on<E extends keyof SwarmEventMap>(\n event: E,\n handler: (\n event: SwarmEventMap[E]["event"],\n ctx: CtxFor<M>,\n ) => Promise<SwarmEventMap[E]["result"]> | SwarmEventMap[E]["result"],\n opts?: {\n priority?: number;\n },\n ): void;\n }\n export type SwarmExtension<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > = (api: ExtensionApi<M>) => void;\n export { block, modify } from "./contract-runtime";\n}\n';
4
+ '// biome-ignore-all lint/suspicious/noConfusingVoidType: Extension handlers may explicitly return no result.\ndeclare module "swarm-extension" {\n export type CreateTaskOptions = {\n key?: string | undefined;\n agentId?: string | null | undefined;\n creatorAgentId?: string | undefined;\n source?:\n | "chat"\n | "workflow"\n | "schedule"\n | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "comb"\n | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n taskType?: string | undefined;\n tags?: string[] | undefined;\n priority?: number | undefined;\n dependsOn?: string[] | undefined;\n offeredTo?: string | undefined;\n status?: "draft" | "backlog" | "unassigned" | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n overrideSlackContext?: boolean | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | undefined;\n workflowRunStepId?: string | undefined;\n sourceTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n inheritParentOutputSchema?: boolean | undefined;\n inheritParentRequester?: boolean | undefined;\n inheritParentRoutingAffinity?: boolean | undefined;\n inheritParentFollowUpConfig?: boolean | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n requestedByUserId?: string | undefined;\n contextKey?: string | undefined;\n bypassTrackerContextDedup?: boolean | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n };\n\n export type AgentTask = {\n id: string;\n key: string;\n agentId: string | null;\n task: string;\n status:\n | "skipped"\n | "draft"\n | "backlog"\n | "unassigned"\n | "offered"\n | "reviewing"\n | "pending"\n | "in_progress"\n | "paused"\n | "completed"\n | "failed"\n | "cancelled"\n | "superseded";\n source:\n | "chat"\n | "workflow"\n | "schedule"\n | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "linear"\n | "jira"\n | "comb";\n tags: string[];\n priority: number;\n dependsOn: string[];\n createdAt: string;\n lastUpdatedAt: string;\n slackReplySent: boolean;\n wasPaused: boolean;\n creatorAgentId?: string | undefined;\n title?: string | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n poolWakeAt?: string | undefined;\n taskType?: string | undefined;\n offeredTo?: string | undefined;\n offeredAt?: string | undefined;\n acceptedAt?: string | undefined;\n rejectionReason?: string | undefined;\n finishedAt?: string | undefined;\n notifiedAt?: string | undefined;\n statusKind?:\n | "error"\n | "workflow"\n | "external"\n | "agent"\n | "runner"\n | "deferred"\n | "cascade"\n | "user"\n | "system"\n | "graceful_shutdown"\n | "context_limits"\n | "manual_supersede"\n | "crash_recovery"\n | "provider_fallback"\n | "workflow_retry"\n | undefined;\n failureReason?: string | undefined;\n output?: string | undefined;\n progress?: string | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n slackProgressMessageTs?: string | undefined;\n slackTreeRootMessageTs?: string | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n claudeSessionId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n resolvedModel?: string | undefined;\n modelSource?: string | undefined;\n modelAlias?: string | undefined;\n resolvedEffort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n resolvedProfile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | null | undefined;\n workflowRunStepId?: string | null | undefined;\n contextKey?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n deferredAt?: string | undefined;\n deferredUntil?: string | undefined;\n compactionCount?: number | undefined;\n peakContextPercent?: number | undefined;\n peakContextTokens?: number | undefined;\n contextWindowSize?: number | undefined;\n credentialKeySuffix?: string | undefined;\n credentialKeyType?: string | undefined;\n requestedByUserId?: string | undefined;\n swarmVersion?: string | undefined;\n provider?:\n | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n providerMeta?: Record<string, unknown> | undefined;\n harnessVariant?: string | undefined;\n harnessVariantMeta?: Record<string, unknown> | undefined;\n totalCostUsd?: number | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n routingAffinityInvalid?: boolean | undefined;\n };\n\n export type ActiveSession = {\n id: string;\n agentId: string;\n taskId: string | null;\n triggerType: string;\n inboxMessageId: string | null;\n taskDescription: string | null;\n runnerSessionId: string | null;\n providerSessionId: string | null;\n startedAt: string;\n lastHeartbeatAt: string;\n runtimeInstanceId?: string | null | undefined;\n };\n\n export type SteerMode = "steer" | "queue";\n\n export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui" | "app-page";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n auditSourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "native" | "mcp" | "extension" | "script-sdk";\n harness?: string | undefined;\n };\n\n import type { SwarmSdk } from "swarm-sdk";\n import type { z } from "zod";\n export type Runtime = "api" | "worker";\n export interface ExtensionScriptAsset {\n name: string;\n file: string;\n description: string;\n intent?: string;\n }\n export interface ExtensionScheduleAsset {\n name: string;\n description?: string;\n script: string;\n cronExpression?: string;\n intervalMs?: number;\n timezone?: string;\n args?: Record<string, unknown>;\n }\n export interface ExtensionWorkflowAsset {\n file: string;\n }\n export interface ExtensionSkillAsset {\n dir: string;\n }\n export interface ExtensionManifest {\n $schema?: string;\n name: string;\n description: string;\n version: string;\n runtime: Runtime;\n assets: {\n hooks: string;\n scripts?: readonly ExtensionScriptAsset[];\n schedules?: readonly ExtensionScheduleAsset[];\n workflows?: readonly ExtensionWorkflowAsset[];\n skills?: readonly ExtensionSkillAsset[];\n };\n homepage?: string;\n author?: string;\n /** Tool-call sources this extension\'s tool handlers receive. Default `["mcp"]`. */\n toolSources?: readonly ToolSource[];\n }\n /** `mcp`: swarm MCP tools. `native`: harness built-ins reported by a worker shim. */\n export type ToolSource = "mcp" | "native";\n export interface HooksModule {\n default: SwarmExtension;\n config?: z.ZodTypeAny;\n }\n export interface ExtensionState {\n get<T = unknown>(key: string): Promise<T | null>;\n set<T>(key: string, value: T): Promise<void>;\n incr(key: string, by?: number): Promise<number>;\n del(key: string): Promise<void>;\n }\n export interface ExtensionLogger {\n debug(message: string, data?: unknown): void;\n info(message: string, data?: unknown): void;\n warn(message: string, data?: unknown): void;\n error(message: string, data?: unknown): void;\n }\n type ConfigFor<M extends ExtensionManifest> = M extends {\n config: infer C extends z.ZodTypeAny;\n }\n ? z.infer<C>\n : Record<string, unknown>;\n export interface ApiCtx<Config = Record<string, unknown>> {\n swarm: SwarmSdk;\n state: ExtensionState;\n config: Config;\n log: ExtensionLogger;\n signal: AbortSignal;\n event: {\n name: keyof SwarmEventMap;\n at: string;\n extension: {\n id: string;\n version: number;\n };\n };\n }\n export interface WorkerCtx<Config = Record<string, unknown>>\n extends Omit<ApiCtx<Config>, "swarm"> {\n swarm: SwarmSdk;\n worker: {\n agentId: string;\n taskId: string;\n harness: string;\n };\n }\n export type CtxFor<M extends ExtensionManifest> = M["runtime"] extends "api"\n ? ApiCtx<ConfigFor<M>>\n : WorkerCtx<ConfigFor<M>>;\n export type PreResult<Modify> =\n | void\n | {\n action: "continue";\n }\n | {\n action: "modify";\n data: Modify;\n }\n | {\n action: "block";\n reason: string;\n };\n export type TaskCreateOrigin =\n | "rest"\n | "app"\n | "mcp"\n | "slack"\n | "schedule"\n | "workflow"\n | "webhook"\n | "followUp"\n | `extension:${string}`;\n export interface TaskCreateEvent {\n options: CreateTaskOptions;\n description: string;\n origin: TaskCreateOrigin;\n requestInfo?: RequestInfo;\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n trigger: "mention" | "thread-buffer";\n messages: {\n ts: string;\n userId: string;\n text: string;\n }[];\n };\n }\n /** A pre.task.create hook blocked a task before it was created. */\n export interface TaskBlockedEvent {\n /** The extension that blocked, or whose model/agent rewrite was rejected. */\n extension: {\n id: string;\n name: string;\n };\n /** The scrubbed block reason. */\n reason: string;\n origin: TaskCreateOrigin;\n source?: AgentTask["source"];\n requester: {\n userId?: string;\n agentId?: string;\n slackUserId?: string;\n };\n context?: {\n contextKey?: string;\n scheduleId?: string;\n workflowRunId?: string;\n workflowRunStepId?: string;\n parentTaskId?: string;\n vcsRepo?: string;\n vcsNumber?: number;\n slackChannelId?: string;\n slackThreadTs?: string;\n };\n /** The original task description, scrubbed and cut to 500 characters. */\n description: string;\n }\n export type TaskCreateModify = Partial<\n Pick<\n CreateTaskOptions,\n | "agentId"\n | "creatorAgentId"\n | "source"\n | "taskType"\n | "tags"\n | "priority"\n | "dependsOn"\n | "offeredTo"\n | "vcsProvider"\n | "vcsRepo"\n | "vcsEventType"\n | "vcsNumber"\n | "vcsCommentId"\n | "vcsAuthor"\n | "vcsUrl"\n | "vcsInstallationId"\n | "vcsNodeId"\n | "agentmailInboxId"\n | "agentmailMessageId"\n | "agentmailThreadId"\n | "mentionMessageId"\n | "mentionChannelId"\n | "dir"\n | "model"\n | "modelTier"\n | "effort"\n | "outputSchema"\n | "followUpConfig"\n | "bypassTrackerContextDedup"\n >\n > & {\n description?: string;\n };\n export interface TaskFollowUpEvent {\n completedTask: AgentTask;\n status: "completed" | "failed";\n output?: string;\n failureReason?: string;\n workerAgentId: string;\n leadAgentId: string;\n summary: string;\n }\n export interface TaskSteerEvent {\n task: AgentTask;\n message: string;\n mode: SteerMode;\n source: SteeringSource;\n sender: {\n kind: "user" | "agent" | "system";\n userId?: string;\n agentId?: string;\n };\n messageTimestamps?: string[];\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n channelId: string;\n threadTs: string;\n userId?: string;\n };\n }\n export interface TaskSteerModify {\n message: string;\n }\n export type TaskFollowUpModify = Partial<\n Pick<CreateTaskOptions, "agentId" | "priority" | "followUpConfig">\n > & {\n description?: string;\n };\n export interface SlackRouteEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n botMentioned: boolean;\n threadContext?: {\n channelId: string;\n threadTs: string;\n };\n }\n export interface SlackRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n };\n }\n /** A Chat SDK message after its thread buffer flushed, before routing. */\n export interface ChatRouteEvent {\n /** Adapter name, such as `telegram` or `slack`. */\n adapter: string;\n channelId: string;\n /** The Chat SDK thread id, prefixed with the adapter name. */\n threadId: string;\n /** The first buffered sender. */\n userId: string;\n userName?: string;\n /** The buffered messages, joined. */\n text: string;\n /** True for an @mention and for a reply to one of the bot\'s messages. */\n botMentioned: boolean;\n isDirectMessage: boolean;\n /** Platform chat type, such as Telegram `private`, `group`, `supergroup` or `channel`. */\n chatType?: string;\n /** Set for a Telegram supergroup with topics. */\n isForum?: boolean;\n /** A buffered message replies to one of the bot\'s own messages. */\n replyToBot: boolean;\n /** Set when earlier swarm tasks exist in this thread. */\n threadContext?: {\n adapter: string;\n threadId: string;\n };\n }\n export interface ChatRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n }\n | {\n kind: "workflow";\n workflowId: string;\n };\n }\n export type HeartbeatClassification = "no-session" | "stale-session" | "fresh-stalled";\n export type HeartbeatAction = "supersede-resume" | "fail" | "record";\n export interface HeartbeatRemediateEvent {\n task: AgentTask;\n session?: ActiveSession;\n classification: HeartbeatClassification;\n proposedAction: HeartbeatAction;\n reason: string;\n taskAgeMs: number;\n sessionHeartbeatAgeMs?: number;\n }\n export interface HeartbeatRemediateModify {\n proposedAction: HeartbeatAction;\n }\n export interface ToolCallEvent {\n tool: string;\n /** Secret-scrubbed on native calls: a secret reads as `[REDACTED:<name>]`. */\n args: unknown;\n requestInfo: RequestInfo;\n /** Native calls only: the harness\'s own tool name, such as `Bash`. */\n nativeTool?: string;\n /** Native calls only: the harness\'s own argument shape, secret-scrubbed. */\n rawArgs?: unknown;\n /** Native calls only: the harness\'s call id, and its parent for a nested call. */\n toolCallId?: string;\n parentToolCallId?: string;\n }\n export interface ToolCallModify {\n args: unknown;\n }\n export interface TaskEvent {\n task: AgentTask;\n }\n export interface TaskCompletedEvent extends TaskEvent {\n output: string;\n }\n export interface TaskFailedEvent extends TaskEvent {\n failureReason: string;\n }\n export interface TaskSupersededEvent extends TaskEvent {\n supersededBy: string;\n }\n export interface TaskProgressEvent extends TaskEvent {\n progress: string;\n }\n export interface SlackMessageEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n taskId?: string;\n }\n /** A Chat SDK message the swarm received or sent. */\n export interface ChatMessageEvent {\n adapter: string;\n channelId: string;\n threadId: string;\n /** The sender, for an inbound message. */\n userId?: string;\n text: string;\n direction: "inbound" | "outbound";\n taskId?: string;\n messageId?: string;\n }\n /**\n * A person answered an approval request. Fires for workflow and standalone\n * requests. Timeouts and cancellations do not emit it today.\n */\n export interface ApprovalResolvedEvent {\n requestId: string;\n status: "approved" | "rejected" | "timeout" | "cancelled";\n responses: Record<string, unknown> | null;\n /** Set when a workflow human-in-the-loop step asked. Absent for a standalone request. */\n workflowRunId?: string;\n workflowRunStepId?: string;\n /** The task whose agent asked, for a standalone request. */\n sourceTaskId?: string;\n }\n /** A task was refused because a daily spend budget is used up. */\n export interface TaskBudgetRefusedEvent extends TaskEvent {\n /** The agent the task was refused for. */\n agentId: string;\n /** Which budget refused it. The matching spend and budget fields are set. */\n cause: "agent" | "global" | "user";\n agentSpendUsd?: number;\n agentBudgetUsd?: number;\n globalSpendUsd?: number;\n globalBudgetUsd?: number;\n userSpendUsd?: number;\n userBudgetUsd?: number;\n /** ISO 8601 time the daily budget resets. */\n resetAt: string;\n }\n /** An inbound AgentMail message. */\n export interface EmailReceivedEvent {\n inboxId: string;\n /** The From header as sent. */\n from: string;\n subject: string;\n /** The text body, or the HTML when there is no text, cut to 500 characters with `...` appended. */\n body: string;\n threadId: string;\n messageId: string;\n }\n /** An inbound Kapso (WhatsApp) message. */\n export interface KapsoMessageEvent {\n phoneNumberId: string;\n conversationId?: string;\n messageId: string;\n from?: string;\n /** Kapso message type, such as `text` or `image`. */\n type?: string;\n /** The text, or a placeholder naming the type for a non-text message. */\n text: string;\n }\n export type VcsProvider = "github" | "gitlab" | "azure-devops" | "bitbucket";\n /**\n * The provider object the event is about, as the provider names it. GitLab\n * calls a pull request a merge request, and a comment a `note`.\n */\n export type VcsEventKind =\n | "pull_request"\n | "merge_request"\n | "issue"\n | "issue_comment"\n | "note"\n | "pull_request_review"\n | "pipeline";\n /**\n * A webhook event from a connected code host. `action` is the provider\'s own\n * value: `opened`, `closed`, `synchronize`, `merge`, `created`, `commented`, or,\n * for a pipeline, its status such as `success` or `failed`. Fields a kind does\n * not carry are absent.\n */\n export interface VcsEvent {\n provider: VcsProvider;\n kind: VcsEventKind;\n action: string;\n /** `owner/name` on GitHub and GitLab, `workspace/repo_slug` on Bitbucket, the repository URL on Azure DevOps. */\n repo: string;\n /** The PR, merge request, or issue number. Absent for a pipeline outside a merge request. */\n number?: number;\n title?: string;\n body?: string | null;\n /** Login of the user behind the event. Set for pull requests, merge requests, and Azure DevOps comments. */\n author?: string;\n url?: string;\n merged?: boolean;\n changedFiles?: number;\n /** The review verdict, on a pull request review. */\n reviewState?: string;\n }\n export interface ToolCallCompletedEvent extends ToolCallEvent {\n result: unknown;\n durationMs: number;\n /** Native calls only: the harness reported the call as failed. */\n isError?: boolean;\n }\n export interface SwarmEventMap {\n "pre.task.create": {\n event: TaskCreateEvent;\n modify: TaskCreateModify;\n result: PreResult<TaskCreateModify>;\n };\n "pre.task.followUp": {\n event: TaskFollowUpEvent;\n modify: TaskFollowUpModify;\n result: PreResult<TaskFollowUpModify>;\n };\n "pre.task.steer": {\n event: TaskSteerEvent;\n modify: TaskSteerModify;\n result: PreResult<TaskSteerModify>;\n };\n "pre.slack.route": {\n event: SlackRouteEvent;\n modify: SlackRouteModify;\n result: PreResult<SlackRouteModify>;\n };\n "pre.chat.route": {\n event: ChatRouteEvent;\n modify: ChatRouteModify;\n result: PreResult<ChatRouteModify>;\n };\n "pre.heartbeat.remediate": {\n event: HeartbeatRemediateEvent;\n modify: HeartbeatRemediateModify;\n result: PreResult<HeartbeatRemediateModify>;\n };\n "pre.tool.call": {\n event: ToolCallEvent;\n modify: ToolCallModify;\n result: PreResult<ToolCallModify>;\n };\n "post.task.created": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.blocked": {\n event: TaskBlockedEvent;\n modify: never;\n result: void;\n };\n "post.task.completed": {\n event: TaskCompletedEvent;\n modify: never;\n result: void;\n };\n "post.task.failed": {\n event: TaskFailedEvent;\n modify: never;\n result: void;\n };\n "post.task.cancelled": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.superseded": {\n event: TaskSupersededEvent;\n modify: never;\n result: void;\n };\n "post.task.progress": {\n event: TaskProgressEvent;\n modify: never;\n result: void;\n };\n "post.slack.message": {\n event: SlackMessageEvent;\n modify: never;\n result: void;\n };\n "post.chat.message": {\n event: ChatMessageEvent;\n modify: never;\n result: void;\n };\n "post.approval.resolved": {\n event: ApprovalResolvedEvent;\n modify: never;\n result: void;\n };\n "post.task.budgetRefused": {\n event: TaskBudgetRefusedEvent;\n modify: never;\n result: void;\n };\n "post.email.received": {\n event: EmailReceivedEvent;\n modify: never;\n result: void;\n };\n "post.kapso.message": {\n event: KapsoMessageEvent;\n modify: never;\n result: void;\n };\n "post.vcs.event": {\n event: VcsEvent;\n modify: never;\n result: void;\n };\n "post.tool.call": {\n event: ToolCallCompletedEvent;\n modify: never;\n result: void;\n };\n }\n export interface ExtensionApi<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > {\n on<E extends keyof SwarmEventMap>(\n event: E,\n handler: (\n event: SwarmEventMap[E]["event"],\n ctx: CtxFor<M>,\n ) => Promise<SwarmEventMap[E]["result"]> | SwarmEventMap[E]["result"],\n opts?: {\n priority?: number;\n },\n ): void;\n }\n export type SwarmExtension<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > = (api: ExtensionApi<M>) => void;\n export { block, modify } from "./contract-runtime";\n}\n';
package/src/hooks/hook.ts CHANGED
@@ -63,11 +63,16 @@ type McpServerConfig = {
63
63
  };
64
64
  };
65
65
 
66
+ /**
67
+ * The worker-owned `/workspace/.mcp.json` wins over the project's, as in the
68
+ * session MCP config. The project file is used only when the workspace file
69
+ * has no swarm entry (a local setup with no `/workspace`).
70
+ */
66
71
  export async function loadHookMcpConfig(
67
72
  projectDir: string,
68
73
  workspaceDir = "/workspace",
69
74
  ): Promise<McpServerConfig | undefined> {
70
- for (const configDir of new Set([projectDir, workspaceDir])) {
75
+ for (const configDir of new Set([workspaceDir, projectDir])) {
71
76
  try {
72
77
  const mcpFile = Bun.file(`${configDir}/.mcp.json`);
73
78
  if (!(await mcpFile.exists())) continue;
@@ -551,7 +556,8 @@ export async function runSessionSummaryFromStdin(): Promise<void> {
551
556
  */
552
557
  export async function handleHook(): Promise<void> {
553
558
  const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
554
- const mcpConfig = await loadHookMcpConfig(projectDir);
559
+ // HOOK_WORKSPACE_DIR lets tests keep a worker's real /workspace/.mcp.json out of the hook.
560
+ const mcpConfig = await loadHookMcpConfig(projectDir, process.env.HOOK_WORKSPACE_DIR);
555
561
 
556
562
  let msg: HookMessage;
557
563
  try {
@@ -127,7 +127,9 @@ export async function nativeHooksActive(
127
127
  const key = cacheKey(target);
128
128
  const file = join(tmpdir(), `agent-swarm-native-hooks-${key}.json`);
129
129
  const cached = memoryStatus.get(key) ?? readStatusFile(file);
130
- if (cached && cached.until > now()) return cached.native;
130
+ // The shim never writes an expiry more than STATUS_TTL_MS ahead, so a later one is a miss.
131
+ const at = now();
132
+ if (cached && cached.until > at && cached.until <= at + STATUS_TTL_MS) return cached.native;
131
133
 
132
134
  let entry: StatusEntry;
133
135
  try {
@@ -143,7 +145,7 @@ export async function nativeHooksActive(
143
145
  }
144
146
  memoryStatus.set(key, entry);
145
147
  try {
146
- writeFileSync(file, JSON.stringify(entry));
148
+ writeFileSync(file, JSON.stringify(entry), { mode: 0o600 });
147
149
  } catch {
148
150
  // An unwritable temp dir only costs the cache.
149
151
  }
package/src/http/apps.ts CHANGED
@@ -38,6 +38,7 @@ import {
38
38
  migrateAppSchema,
39
39
  withAppDefinitionLock,
40
40
  } from "../apps/schema-migrate";
41
+ import { appWriteTypesWarnings } from "../apps/script-types";
41
42
  import {
42
43
  appDefinitionNeedsRepair,
43
44
  createApp,
@@ -62,7 +63,13 @@ import {
62
63
  rollbackApp,
63
64
  snapshotApp,
64
65
  } from "../apps/version";
65
- import { getAgentById, getAppVersion, getAppVersions, getTaskById } from "../be/db";
66
+ import {
67
+ getAgentById,
68
+ getAppVersion,
69
+ getAppVersions,
70
+ getTaskById,
71
+ withFavoriteFlags,
72
+ } from "../be/db";
66
73
  import type { RbacResource } from "../rbac";
67
74
  import { can } from "../rbac";
68
75
  import { APP_SESSION_KEY_PATTERN, appSessionContextKey } from "../tasks/context-key";
@@ -145,6 +152,8 @@ const AppSummarySchema = z.object({
145
152
  icon: AppIconSchema.optional(),
146
153
  createdAt: z.string(),
147
154
  updatedAt: z.string(),
155
+ /** Whether the caller starred the app (an `app` favorite). */
156
+ favorite: z.boolean(),
148
157
  });
149
158
 
150
159
  /**
@@ -234,7 +243,9 @@ const AppUserConfigSchema = z.record(AppNameSchema, AppUserConfigFieldSchema);
234
243
  const compatWarningsSchema = z
235
244
  .array(z.string())
236
245
  .optional()
237
- .describe("Advisory quickjs-executor compatibility findings for the app's scripts.");
246
+ .describe(
247
+ "Advisory findings: quickjs-executor compatibility of the app's scripts, and whether the app lost its generated script types to the type budget.",
248
+ );
238
249
  const appWriteResponseSchema = z.object({
239
250
  app: AppRecordSchema,
240
251
  migration: AppMigrationReportSchema,
@@ -1000,19 +1011,12 @@ function filtersFromQuery(
1000
1011
  return { filters, issues };
1001
1012
  }
1002
1013
 
1003
- function compareValues(
1004
- left: unknown,
1005
- right: unknown,
1006
- direction: "asc" | "desc",
1007
- dateValues = false,
1008
- ): number {
1014
+ function compareValues(left: unknown, right: unknown, direction: "asc" | "desc"): number {
1009
1015
  if (left === right) return 0;
1010
1016
  if (left === undefined || left === null) return 1;
1011
1017
  if (right === undefined || right === null) return -1;
1012
1018
  let result: number;
1013
- if (dateValues && typeof left === "string" && typeof right === "string") {
1014
- result = Date.parse(left) - Date.parse(right);
1015
- } else if (typeof left === "number" && typeof right === "number") {
1019
+ if (typeof left === "number" && typeof right === "number") {
1016
1020
  result = left - right;
1017
1021
  } else if (typeof left === "boolean" && typeof right === "boolean") {
1018
1022
  result = Number(left) - Number(right);
@@ -1026,6 +1030,30 @@ function rowValue(row: AppRow, column: string): unknown {
1026
1030
  return Object.hasOwn(row, column) ? row[column] : undefined;
1027
1031
  }
1028
1032
 
1033
+ // Sorts like compareValues but parses each date string once, not twice per
1034
+ // comparison: Date.parse inside the comparator froze the event loop for seconds
1035
+ // on large tables. Order is identical (nulls last, NaN compares as a tie).
1036
+ export function sortRowsByColumn(
1037
+ rows: AppRow[],
1038
+ column: string,
1039
+ dir: "asc" | "desc",
1040
+ dateValues: boolean,
1041
+ ): AppRow[] {
1042
+ const keyed = rows.map((row) => {
1043
+ const value = rowValue(row, column);
1044
+ return { row, value, ts: dateValues && typeof value === "string" ? Date.parse(value) : 0 };
1045
+ });
1046
+ keyed.sort((a, b) => {
1047
+ if (dateValues && typeof a.value === "string" && typeof b.value === "string") {
1048
+ if (a.value === b.value) return 0;
1049
+ const result = a.ts - b.ts;
1050
+ return dir === "asc" ? result : -result;
1051
+ }
1052
+ return compareValues(a.value, b.value, dir);
1053
+ });
1054
+ return keyed.map((k) => k.row);
1055
+ }
1056
+
1029
1057
  export function rowMatchesFilters(row: AppRow, filters: RowFilter[]): boolean {
1030
1058
  return filters.every((filter) => rowValue(row, filter.column) === filter.value);
1031
1059
  }
@@ -1043,17 +1071,13 @@ export function applyQuery(
1043
1071
  );
1044
1072
  const sort = query.sort;
1045
1073
  if (sort) {
1046
- selected = [...selected].sort((a, b) => {
1047
- const result = compareValues(
1048
- rowValue(a, sort.column),
1049
- rowValue(b, sort.column),
1050
- sort.dir,
1051
- SORTABLE_SYSTEM_DATE_COLUMNS.has(sort.column) ||
1052
- (Object.hasOwn(model.columns, sort.column) &&
1053
- model.columns[sort.column]!.kind === "date"),
1054
- );
1055
- return result;
1056
- });
1074
+ selected = sortRowsByColumn(
1075
+ selected,
1076
+ sort.column,
1077
+ sort.dir,
1078
+ SORTABLE_SYSTEM_DATE_COLUMNS.has(sort.column) ||
1079
+ (Object.hasOwn(model.columns, sort.column) && model.columns[sort.column]!.kind === "date"),
1080
+ );
1057
1081
  }
1058
1082
  return selected.slice(0, query.limit ?? 200);
1059
1083
  }
@@ -1077,7 +1101,7 @@ export async function selectAppRows(
1077
1101
  if (jsonFilterIssues.length > 0) throw new AppRowValidationError(jsonFilterIssues);
1078
1102
 
1079
1103
  // SQL narrows the scan; the `===` re-check keeps the exact filter semantics.
1080
- const rows = (
1104
+ let rows = (
1081
1105
  await listAppRows(
1082
1106
  appId,
1083
1107
  modelName,
@@ -1088,6 +1112,7 @@ export async function selectAppRows(
1088
1112
  ? [{ column: filter.column, value: filter.value }]
1089
1113
  : [],
1090
1114
  ),
1115
+ model.columns,
1091
1116
  )
1092
1117
  ).filter((row) => rowMatchesFilters(row, filters));
1093
1118
 
@@ -1108,16 +1133,13 @@ export async function selectAppRows(
1108
1133
  if (model.columns[column]?.kind === "json") {
1109
1134
  throw new AppRowValidationError([{ path: "sort", message: "json columns cannot be sorted" }]);
1110
1135
  }
1111
- rows.sort((a, b) => {
1112
- const result = compareValues(
1113
- rowValue(a, column),
1114
- rowValue(b, column),
1115
- dir,
1116
- SORTABLE_SYSTEM_DATE_COLUMNS.has(column) ||
1117
- (Object.hasOwn(model.columns, column) && model.columns[column]!.kind === "date"),
1118
- );
1119
- return result;
1120
- });
1136
+ rows = sortRowsByColumn(
1137
+ rows,
1138
+ column,
1139
+ dir,
1140
+ SORTABLE_SYSTEM_DATE_COLUMNS.has(column) ||
1141
+ (Object.hasOwn(model.columns, column) && model.columns[column]!.kind === "date"),
1142
+ );
1121
1143
  }
1122
1144
  const total = rows.length;
1123
1145
  return { rows: rows.slice(0, limit), total };
@@ -1153,13 +1175,17 @@ export async function handleApps(
1153
1175
  invalidDefinition(res, definition.issues);
1154
1176
  return true;
1155
1177
  }
1156
- const warnings = await scriptCompatWarnings(definition.definition);
1178
+ const app = await createApp({
1179
+ name: parsed.body.name,
1180
+ description: parsed.body.description,
1181
+ definition: definition.definition,
1182
+ });
1183
+ const warnings = [
1184
+ ...(await scriptCompatWarnings(definition.definition)),
1185
+ ...(await appWriteTypesWarnings(app.id)),
1186
+ ];
1157
1187
  createAppRoute.respond(res, 201, {
1158
- app: await createApp({
1159
- name: parsed.body.name,
1160
- description: parsed.body.description,
1161
- definition: definition.definition,
1162
- }),
1188
+ app,
1163
1189
  ...(warnings.length > 0 ? { warnings } : {}),
1164
1190
  });
1165
1191
  return true;
@@ -1168,8 +1194,12 @@ export async function handleApps(
1168
1194
  if (listAppsRoute.match(req.method, pathSegments)) {
1169
1195
  const parsed = await listAppsRoute.parse(req, res, pathSegments, queryParams);
1170
1196
  if (!parsed) return true;
1197
+ const favoriteScope = (await resolveHttpFavoriteOwner(req, myAgentId))?.scope;
1171
1198
  listAppsRoute.respond(res, 200, {
1172
- apps: await listApps({ q: parsed.query.q, limit: parsed.query.limit }),
1199
+ apps: await withFavoriteFlags(
1200
+ await listApps({ q: parsed.query.q, limit: parsed.query.limit }),
1201
+ { favoriteScope, itemType: "app" },
1202
+ ),
1173
1203
  });
1174
1204
  return true;
1175
1205
  }
@@ -1619,7 +1649,12 @@ export async function handleApps(
1619
1649
  return true;
1620
1650
  }
1621
1651
  const warnings =
1622
- writtenDefinition === undefined ? [] : await scriptCompatWarnings(writtenDefinition);
1652
+ writtenDefinition === undefined
1653
+ ? []
1654
+ : [
1655
+ ...(await scriptCompatWarnings(writtenDefinition)),
1656
+ ...(await appWriteTypesWarnings(parsed.params.id)),
1657
+ ];
1623
1658
  patchAppRoute.respond(res, 200, {
1624
1659
  app,
1625
1660
  migration,
@@ -1711,7 +1746,12 @@ export async function handleApps(
1711
1746
  return true;
1712
1747
  }
1713
1748
  const warnings =
1714
- writtenDefinition === undefined ? [] : await scriptCompatWarnings(writtenDefinition);
1749
+ writtenDefinition === undefined
1750
+ ? []
1751
+ : [
1752
+ ...(await scriptCompatWarnings(writtenDefinition)),
1753
+ ...(await appWriteTypesWarnings(parsed.params.id)),
1754
+ ];
1715
1755
  updateAppRoute.respond(res, 200, {
1716
1756
  app,
1717
1757
  migration,