@desplega.ai/agent-swarm 2.11.0 → 2.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (521) hide show
  1. package/dist/acp-adapter-cn53011z.js +17 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-86f0sh6g.js} +10 -9
  3. package/dist/{actions-4nxq386s.js → actions-zv8vcxvr.js} +25 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-jqshb33y.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-gt503ywc.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-6t4k5rh1.js} +7 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-fcfw063h.js} +8 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-9dzybh12.js} +26 -23
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-xzfp2feg.js} +1 -1
  10. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-3jz0p2jk.js} +1 -1
  11. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-r88wngfg.js} +5 -2
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-scrqhw48.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-vb2dcrrb.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-h3mp9hgs.js} +9 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-kpbyj2vb.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-0efr3wkg.js} +7 -7
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-03dw669q.js} +11 -10
  19. package/dist/{cli-14xdms9a.js → cli-0b655smz.js} +6 -6
  20. package/dist/{cli-wz4e5am2.js → cli-0dg7ytxm.js} +400 -72
  21. package/dist/cli-0jkenasr.js +148 -0
  22. package/dist/{cli-0bgj4rh5.js → cli-0pazkmd4.js} +4 -4
  23. package/dist/{cli-892y3vfp.js → cli-117g15t4.js} +9 -12
  24. package/dist/{cli-v3zcnr8g.js → cli-1dbv9mj9.js} +1 -1
  25. package/dist/{cli-8zmpwe79.js → cli-1v82d2w6.js} +5 -5
  26. package/dist/{cli-6tvh1fwq.js → cli-2jk4s7z1.js} +3 -3
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-atm0hkes.js → cli-2skf1mdf.js} +11 -11
  29. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  30. package/dist/{cli-a02habn6.js → cli-48nvk6sb.js} +3 -3
  31. package/dist/{cli-q71g5q39.js → cli-49f5jyhh.js} +3 -3
  32. package/dist/{cli-2z2c4k6q.js → cli-50w82h6m.js} +21 -0
  33. package/dist/{cli-dd2k2mcd.js → cli-6a40p4kv.js} +1 -1
  34. package/dist/{cli-rwgwen5v.js → cli-6h88mn9q.js} +4 -4
  35. package/dist/cli-7dbhnsj9.js +681 -0
  36. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  37. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  38. package/dist/{cli-rhsc2zyx.js → cli-9fsagra4.js} +1 -1
  39. package/dist/{cli-f8yhybxr.js → cli-9m9kyw77.js} +3 -3
  40. package/dist/{cli-yzxqwcvq.js → cli-ajjvqhf3.js} +10 -3
  41. package/dist/cli-avqkr20b.js +69 -0
  42. package/dist/{cli-nbakg5xh.js → cli-avxh26pd.js} +46 -15
  43. package/dist/{cli-n6ygvrrm.js → cli-b2jh3dyb.js} +4 -4
  44. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  45. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  46. package/dist/{cli-czvvnfr9.js → cli-c8v2yvej.js} +2 -2
  47. package/dist/{cli-raqw9fw9.js → cli-ct8sz3np.js} +18 -11
  48. package/dist/{cli-t2s7j5cy.js → cli-dka73bak.js} +2 -2
  49. package/dist/{cli-tb4j757d.js → cli-dkejt425.js} +76 -17
  50. package/dist/{cli-27fat7st.js → cli-dnh64e8e.js} +7 -7
  51. package/dist/{cli-453497a0.js → cli-eb279wn3.js} +2 -2
  52. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  53. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  54. package/dist/{cli-vy3fn0mz.js → cli-f1952kjy.js} +4 -4
  55. package/dist/{cli-1h4njv9y.js → cli-f8rcvf2x.js} +58 -13
  56. package/dist/{cli-xqbqwpxr.js → cli-fhvk2nvp.js} +26 -13
  57. package/dist/{cli-2jtfm8kh.js → cli-fz9pcjsw.js} +4 -4
  58. package/dist/{cli-bq97k63w.js → cli-g6j6ac3h.js} +2 -2
  59. package/dist/{cli-f7dhm7hh.js → cli-gfcv679k.js} +1 -1
  60. package/dist/cli-hbq0kwxz.js +252 -0
  61. package/dist/{cli-nc39ym5q.js → cli-hc6e4tac.js} +29 -150
  62. package/dist/{cli-m00c47q6.js → cli-hgsxnjyg.js} +58 -25
  63. package/dist/{cli-s9twe4x0.js → cli-hpb9x72z.js} +58 -13
  64. package/dist/{cli-9g12h1aq.js → cli-j53hpbsm.js} +2 -2
  65. package/dist/{cli-zhn4r1rz.js → cli-jj3c5nyb.js} +519 -144
  66. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  67. package/dist/{cli-kbm659dk.js → cli-kde4ky90.js} +2 -2
  68. package/dist/{cli-4aswccje.js → cli-kspxjftk.js} +2 -2
  69. package/dist/{cli-p8zqbbt1.js → cli-m4ejz4nj.js} +1 -1
  70. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  71. package/dist/{cli-b82a13ga.js → cli-mh7pdxe0.js} +23 -27
  72. package/dist/{cli-rpmw4fsv.js → cli-mz34pxbk.js} +12 -12
  73. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  74. package/dist/{cli-cstggwq7.js → cli-nc6a8b5b.js} +7 -4
  75. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  76. package/dist/{cli-j2r1apqm.js → cli-prf7kz78.js} +59 -58
  77. package/dist/{cli-2gvdvsxj.js → cli-qec9bynj.js} +63 -60
  78. package/dist/{cli-zb1hff00.js → cli-qhhb30e8.js} +12 -12
  79. package/dist/{cli-h2qtafm4.js → cli-qm3ntjqs.js} +21 -21
  80. package/dist/{cli-5ptj757f.js → cli-rfejbpe1.js} +1 -1
  81. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  82. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  83. package/dist/{cli-mhrr4d5b.js → cli-sdh61g52.js} +38 -20
  84. package/dist/{cli-7cp6aa1q.js → cli-skd2c4ej.js} +25 -178
  85. package/dist/{cli-ynph3b70.js → cli-sq913bh1.js} +8 -8
  86. package/dist/{cli-hnh8erra.js → cli-t35hx078.js} +2 -2
  87. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  88. package/dist/{cli-yvzxbztc.js → cli-tn91wc6e.js} +2 -2
  89. package/dist/{cli-075ccjh6.js → cli-tstj6e8e.js} +3660 -232
  90. package/dist/{cli-4g323fjh.js → cli-w14j2z4k.js} +2 -2
  91. package/dist/{cli-4kzp7r0q.js → cli-wndegmns.js} +3 -3
  92. package/dist/{cli-p1a4khta.js → cli-wrhbym01.js} +10 -10
  93. package/dist/{cli-djt6wmrc.js → cli-wv20kbr3.js} +9 -9
  94. package/dist/{cli-2aacfdcn.js → cli-wxwv3t11.js} +64 -3
  95. package/dist/{cli-rytq7dm2.js → cli-xfjn2kyq.js} +59 -5
  96. package/dist/cli-y260hgep.js +186 -0
  97. package/dist/{cli-9knhkkgr.js → cli-y4a4458j.js} +3 -3
  98. package/dist/{cli-a6q6x15h.js → cli-y518qkjg.js} +10 -5
  99. package/dist/{cli-0b4zam62.js → cli-yfvhvw8m.js} +20 -0
  100. package/dist/cli-yn4kt85g.js +148 -0
  101. package/dist/{cli-k4r5sfaj.js → cli-ytc7fpza.js} +11 -11
  102. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  103. package/dist/{cli-6n7y5ypy.js → cli-z64t9pe6.js} +1 -1
  104. package/dist/{cli-6a3j25xd.js → cli-zqmmy073.js} +200 -20
  105. package/dist/cli.js +27 -22
  106. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-f3yp0kaj.js} +8 -8
  107. package/dist/{codex-hook-aqtj17yr.js → codex-hook-262cekfp.js} +73 -2
  108. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  109. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ns4mv70p.js} +9 -9
  110. package/dist/{commands-ctey7tr5.js → commands-5bzf2tfw.js} +3 -3
  111. package/dist/{controller-rqhbppg9.js → controller-5xt7kvfm.js} +4 -4
  112. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-0gg13mzp.js} +26 -23
  113. package/dist/core-0fqtbrxa.js +42 -0
  114. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-p0c5zv6r.js} +2 -2
  115. package/dist/{db-p5drc1d1.js → db-2s68ycq7.js} +3 -3
  116. package/dist/{db-2ah39cyx.js → db-q7q639k5.js} +8 -2
  117. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  118. package/dist/{dispatcher-x6w14pde.js → dispatcher-j2y1q7ae.js} +25 -20
  119. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  120. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-pgnkf4st.js} +2 -2
  121. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  122. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  123. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-0kea97jf.js} +1 -1
  124. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-3n6mhhmy.js} +6 -6
  125. package/dist/{embeddings-0sxb1d2h.js → embeddings-jfmj6yme.js} +1 -1
  126. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  127. package/dist/{execute-6m1ex8ce.js → execute-tjrej979.js} +1 -1
  128. package/dist/{external-channel-ezer7pk0.js → external-channel-jy8w2gg3.js} +2 -2
  129. package/dist/fx-adapter-k6w3jvz9.js +20 -0
  130. package/dist/grok-adapter-4q5tssw0.js +20 -0
  131. package/dist/handlers-qxgfvvsf.js +41 -0
  132. package/dist/{heartbeat-6c4fr49t.js → heartbeat-6tr2w2da.js} +26 -23
  133. package/dist/{hook-02rt5tvq.js → hook-bpnncsec.js} +77 -18
  134. package/dist/{hook-t1c5avbv.js → hook-fv1jwrv7.js} +6 -5
  135. package/dist/{http-qa3h32a1.js → http-bpa26czn.js} +1277 -249
  136. package/dist/index-0mcxjdsa.js +44 -0
  137. package/dist/{index-akbgsdhh.js → index-52tgbhrw.js} +30 -27
  138. package/dist/index-dz4q23ag.js +40 -0
  139. package/dist/{index-kqv9ebfj.js → index-mpj0z9e0.js} +1 -1
  140. package/dist/index-s175jckx.js +39 -0
  141. package/dist/{index-qpjk2hxk.js → index-s8re7mvq.js} +1 -1
  142. package/dist/{index-e42j998x.js → index-w216g9y9.js} +222 -165
  143. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  144. package/dist/{keepalive-jmf6pn8c.js → keepalive-d6z12s04.js} +4 -4
  145. package/dist/lead-p3hx7h35.js +79 -0
  146. package/dist/{maintenance-g7v15tj1.js → maintenance-7kac6g2g.js} +1 -1
  147. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-t1xjetbh.js} +3 -3
  148. package/dist/object-webhooks-6rdagg0r.js +21 -0
  149. package/dist/{onboard-m3fedypq.js → onboard-32y1cfxy.js} +5 -5
  150. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-enp3v31n.js} +8 -7
  151. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-k0tm5ptj.js} +2 -2
  152. package/dist/{pending-fwj2fatd.js → pending-24zebgvs.js} +24 -21
  153. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-yj72xxxe.js} +89 -20
  154. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-cf25x38j.js} +2 -2
  155. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-0wydd22m.js} +3 -3
  156. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-at6crb3r.js} +7 -4
  157. package/dist/{registry-32b1mft6.js → registry-zv0zvxsx.js} +1 -1
  158. package/dist/{render-v2-j7qggj8h.js → render-v2-nvcw0jd7.js} +9 -5
  159. package/dist/{resume-hj1mn65y.js → resume-y4w0k5v3.js} +10 -9
  160. package/dist/{runtime-z31mdsgv.js → runtime-vpe43hx0.js} +1 -1
  161. package/dist/{session-access-w38fh09a.js → session-access-gkyvnfye.js} +5 -4
  162. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-3w2st4m2.js} +3 -3
  163. package/dist/{setup-dsqmpfcr.js → setup-axxvqtys.js} +1 -1
  164. package/dist/thread-buffer-rwa7d4dx.js +42 -0
  165. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-y4fqvab5.js} +2 -2
  166. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-kcmwvrc6.js} +3 -3
  167. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-7d92dct1.js} +3 -3
  168. package/dist/{work-objects-4ahy5es5.js → work-objects-f708e069.js} +28 -24
  169. package/dist/worker-8rg9gz74.js +79 -0
  170. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-0by8wztc.js} +23 -20
  171. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  172. package/dist/xlsx-9acfmxr1.js +31534 -0
  173. package/openapi.json +5227 -3511
  174. package/package.json +10 -5
  175. package/src/agentmail/handlers.ts +26 -19
  176. package/src/apps/catalog.generated.json +31 -0
  177. package/src/apps/row-store.ts +37 -14
  178. package/src/azure-devops/auth.ts +2 -3
  179. package/src/azure-devops/handlers.ts +2 -0
  180. package/src/be/agent-fs-identity.ts +46 -0
  181. package/src/be/agent-history.ts +215 -0
  182. package/src/be/audit-user.ts +46 -6
  183. package/src/be/db/agents.ts +34 -12
  184. package/src/be/db/kv-windows.ts +22 -0
  185. package/src/be/db/session-moves.ts +3 -3
  186. package/src/be/db/session-tree.ts +52 -5
  187. package/src/be/db/skill-audit.ts +17 -0
  188. package/src/be/db/tasks/write.ts +20 -5
  189. package/src/be/db.ts +116 -23
  190. package/src/be/extensions/assets.ts +11 -7
  191. package/src/be/memory/demotion-evidence.ts +2 -2
  192. package/src/be/memory/providers/sqlite-store.ts +151 -18
  193. package/src/be/memory/search-read-worker.ts +60 -0
  194. package/src/be/memory/search-reader.ts +223 -0
  195. package/src/be/migrations/332_primitive_objects.sql +31 -0
  196. package/src/be/migrations/334_agent_history.sql +23 -0
  197. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  198. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  199. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  200. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  201. package/src/be/model-tier-resolution.ts +18 -1
  202. package/src/be/multi-runtime.ts +17 -0
  203. package/src/be/primitives/boards/elements.ts +717 -0
  204. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  205. package/src/be/primitives/boards/service.ts +121 -0
  206. package/src/be/primitives/object-embed.ts +250 -0
  207. package/src/be/primitives/object-webhooks.ts +348 -0
  208. package/src/be/primitives/objects.ts +706 -0
  209. package/src/be/primitives/sheets/a1.ts +136 -0
  210. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  211. package/src/be/primitives/sheets/engine.ts +199 -0
  212. package/src/be/primitives/sheets/format.ts +106 -0
  213. package/src/be/primitives/sheets/service.ts +547 -0
  214. package/src/be/primitives/sheets/xlsx.ts +367 -0
  215. package/src/be/primitives/write-object.ts +83 -0
  216. package/src/be/rbac-roles.ts +3 -0
  217. package/src/be/repo-checked-update.ts +4 -4
  218. package/src/be/repo-merge-policy.ts +26 -9
  219. package/src/be/script-credential-broker.ts +8 -27
  220. package/src/be/scripts/boot-reembed.ts +6 -0
  221. package/src/be/scripts/db.ts +17 -5
  222. package/src/be/scripts/embeddings.ts +6 -0
  223. package/src/be/scripts/typecheck.ts +257 -0
  224. package/src/be/seed/agent-fs-provision.ts +18 -0
  225. package/src/be/seed/schedules-seeder.ts +9 -1
  226. package/src/be/seed/workflows-seeder.ts +9 -1
  227. package/src/be/seed-scripts/index.ts +2 -0
  228. package/src/be/seed-skills/index.ts +12 -0
  229. package/src/be/swarm-config-guard.ts +1 -0
  230. package/src/be/unmapped-identities.ts +95 -1
  231. package/src/be/users.ts +19 -0
  232. package/src/bitbucket/handlers.ts +2 -0
  233. package/src/commands/onboard/agent-fs-version.ts +1 -1
  234. package/src/commands/onboard/steps/harness.tsx +1 -1
  235. package/src/commands/provider-credentials.ts +1 -0
  236. package/src/e2b/env.ts +3 -1
  237. package/src/event-waits/github.ts +43 -0
  238. package/src/event-waits/index.ts +29 -0
  239. package/src/event-waits/types.ts +51 -0
  240. package/src/extensions/contract-types.generated.ts +1 -1
  241. package/src/extensions/dispatcher.ts +9 -0
  242. package/src/fs/agent-fs-provider.ts +37 -3
  243. package/src/github/handlers.ts +3 -1
  244. package/src/github/pull-request-state.ts +34 -0
  245. package/src/gitlab/auth.ts +3 -4
  246. package/src/gitlab/handlers.ts +12 -7
  247. package/src/heartbeat/heartbeat.ts +11 -11
  248. package/src/hooks/codex-hook.ts +99 -1
  249. package/src/hooks/hook.ts +85 -11
  250. package/src/hooks/native-tool-hooks.ts +245 -0
  251. package/src/http/agent-lifecycle.ts +152 -0
  252. package/src/http/agents.ts +12 -0
  253. package/src/http/all-routes.ts +3 -0
  254. package/src/http/assets.ts +4 -3
  255. package/src/http/auth.ts +2 -1
  256. package/src/http/comb.ts +2 -2
  257. package/src/http/favorite-owner.ts +2 -2
  258. package/src/http/favorites.ts +3 -2
  259. package/src/http/fs.ts +13 -4
  260. package/src/http/index.ts +17 -0
  261. package/src/http/mcp-bridge.ts +4 -0
  262. package/src/http/object-webhooks.ts +101 -0
  263. package/src/http/objects.ts +265 -0
  264. package/src/http/operator-actor.ts +2 -1
  265. package/src/http/pages.ts +3 -3
  266. package/src/http/poll.ts +43 -12
  267. package/src/http/repos.ts +7 -6
  268. package/src/http/schedules.ts +10 -6
  269. package/src/http/script-connections.ts +2 -2
  270. package/src/http/scripts.ts +9 -0
  271. package/src/http/sessions.ts +37 -12
  272. package/src/http/skills.ts +17 -0
  273. package/src/http/task-requester.ts +2 -2
  274. package/src/http/tasks.ts +13 -3
  275. package/src/http/tool-hooks.ts +24 -2
  276. package/src/http/trackers/authorize-gate.ts +2 -2
  277. package/src/http/users.ts +136 -1
  278. package/src/http/workflow-events.ts +13 -0
  279. package/src/http/workflows.ts +47 -5
  280. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  281. package/src/linear/sync.ts +3 -1
  282. package/src/prompts/base-prompt.ts +35 -13
  283. package/src/prompts/session-templates.ts +25 -0
  284. package/src/providers/acp-targets.ts +2 -2
  285. package/src/providers/amp-adapter.ts +1 -1
  286. package/src/providers/dsh-adapter.ts +1 -1
  287. package/src/providers/opencode-adapter.ts +5 -1
  288. package/src/providers/opencode-swarm-plugin.ts +50 -1
  289. package/src/providers/pi-mono-adapter.ts +139 -9
  290. package/src/providers/pi-mono-extension.ts +69 -0
  291. package/src/providers/runtime-dependencies.ts +1 -1
  292. package/src/rbac/legacy-policy.ts +5 -0
  293. package/src/rbac/permissions.ts +16 -1
  294. package/src/scheduler/deferred-task-waits.ts +170 -13
  295. package/src/script-workflows/guest-ctx.ts +32 -0
  296. package/src/script-workflows/workflow-ctx.ts +2 -0
  297. package/src/scripts-runtime/ctx.ts +9 -1
  298. package/src/scripts-runtime/executors/native.ts +106 -21
  299. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  300. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  301. package/src/scripts-runtime/executors/types.ts +5 -0
  302. package/src/scripts-runtime/loader.ts +8 -0
  303. package/src/scripts-runtime/mcp-client.ts +4 -0
  304. package/src/scripts-runtime/sdk-allowlist.ts +101 -0
  305. package/src/scripts-runtime/swarm-config.ts +8 -0
  306. package/src/scripts-runtime/swarm-sdk.ts +55 -3
  307. package/src/scripts-runtime/types/stdlib.d.ts +310 -0
  308. package/src/scripts-runtime/types/swarm-extension.d.ts +1 -0
  309. package/src/scripts-runtime/types/swarm-sdk.d.ts +310 -0
  310. package/src/server.ts +52 -0
  311. package/src/slack/enrich.ts +81 -21
  312. package/src/slack/handlers.test.ts +55 -2
  313. package/src/slack/handlers.ts +38 -3
  314. package/src/slack/render-v2.ts +19 -0
  315. package/src/slack/session-mirror.ts +208 -0
  316. package/src/slack/thread-participants.ts +0 -5
  317. package/src/slack/watcher.ts +3 -0
  318. package/src/slack/work-objects.test.ts +2 -1
  319. package/src/slack/work-objects.ts +7 -2
  320. package/src/tests/agent-history.test.ts +313 -0
  321. package/src/tests/agentmail-filters.test.ts +4 -3
  322. package/src/tests/audit-agent-person.test.ts +825 -0
  323. package/src/tests/audit-updated-by.test.ts +19 -12
  324. package/src/tests/azure-devops-auth.test.ts +6 -0
  325. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  326. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  327. package/src/tests/claude-hook-output.test.ts +107 -2
  328. package/src/tests/claude-managed-setup.test.ts +1 -1
  329. package/src/tests/codex-adapter.test.ts +6 -6
  330. package/src/tests/codex-gpt6-release.test.ts +4 -4
  331. package/src/tests/credential-check.test.ts +12 -0
  332. package/src/tests/db-task-read-contract.test.ts +3 -0
  333. package/src/tests/db-task-write-contract.test.ts +3 -0
  334. package/src/tests/dsh-adapter.test.ts +1 -1
  335. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  336. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  337. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  338. package/src/tests/e2e-shards.test.ts +137 -0
  339. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  340. package/src/tests/extensions-catalog.test.ts +33 -25
  341. package/src/tests/extensions-heartbeat.test.ts +34 -0
  342. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  343. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  344. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  345. package/src/tests/gitlab-auth.test.ts +10 -0
  346. package/src/tests/heartbeat.test.ts +38 -0
  347. package/src/tests/http-api-integration.test.ts +0 -6
  348. package/src/tests/kv-storage.test.ts +3 -0
  349. package/src/tests/memory-search-reader.test.ts +258 -0
  350. package/src/tests/memory-search-stall.test.ts +197 -20
  351. package/src/tests/model-control.test.ts +4 -4
  352. package/src/tests/model-tier-resolution.test.ts +2 -2
  353. package/src/tests/multi-runtime-registration.test.ts +8 -2
  354. package/src/tests/native-tool-hooks.test.ts +188 -0
  355. package/src/tests/opencode-adapter.test.ts +11 -0
  356. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  357. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  358. package/src/tests/poll-probe-readonly.test.ts +108 -0
  359. package/src/tests/primitives-boards.test.ts +686 -0
  360. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  361. package/src/tests/primitives-objects.test.ts +248 -0
  362. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  363. package/src/tests/prompt-template-session.test.ts +3 -2
  364. package/src/tests/rbac-roles.test.ts +3 -0
  365. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  366. package/src/tests/script-connections.test.ts +4 -0
  367. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  368. package/src/tests/scripts-namespaces.test.ts +211 -0
  369. package/src/tests/secret-scrub-gate.test.ts +1 -0
  370. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  371. package/src/tests/secret-scrubber.test.ts +1 -1
  372. package/src/tests/seed-model-profiles.test.ts +1 -1
  373. package/src/tests/session-tokens.test.ts +27 -0
  374. package/src/tests/sessions-tree.test.ts +10 -2
  375. package/src/tests/sheet-engine.test.ts +58 -0
  376. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  377. package/src/tests/slack-read-boundaries.test.ts +4 -2
  378. package/src/tests/slack-thread-participants.test.ts +66 -4
  379. package/src/tests/task-start-after-commit.test.ts +82 -0
  380. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  381. package/src/tests/ui-logs-parser.test.ts +67 -0
  382. package/src/tests/workflow-retry-v2.test.ts +101 -0
  383. package/src/tests/workflow-tla-races.test.ts +29 -0
  384. package/src/tools/boards.ts +260 -0
  385. package/src/tools/defer-task.ts +154 -12
  386. package/src/tools/objects.ts +196 -0
  387. package/src/tools/repos/update-repo.ts +6 -6
  388. package/src/tools/schedules/create-schedule.ts +1 -0
  389. package/src/tools/schedules/list-schedules.ts +3 -0
  390. package/src/tools/schedules/patch-schedule.ts +12 -3
  391. package/src/tools/schedules/update-schedule.ts +12 -3
  392. package/src/tools/sheets.ts +378 -0
  393. package/src/tools/skills/skill-create.ts +6 -0
  394. package/src/tools/skills/skill-install-remote.ts +6 -0
  395. package/src/tools/skills/skill-sync-remote.ts +9 -0
  396. package/src/tools/skills/skill-update.ts +9 -1
  397. package/src/tools/slack-read.ts +10 -3
  398. package/src/tools/tool-config.ts +25 -0
  399. package/src/tools/utils.ts +15 -0
  400. package/src/tools/workflows/create-workflow.ts +20 -5
  401. package/src/tools/workflows/patch-workflow-node.ts +5 -1
  402. package/src/tools/workflows/patch-workflow.ts +9 -2
  403. package/src/tools/workflows/update-workflow.ts +27 -4
  404. package/src/types.ts +112 -12
  405. package/src/utils/sandboxed-process.ts +47 -2
  406. package/src/utils/secret-scrubber.ts +61 -6
  407. package/src/workflows/engine.ts +35 -21
  408. package/src/workflows/input.ts +36 -1
  409. package/src/workflows/patch-definition.ts +24 -2
  410. package/src/workflows/retry-poller.ts +15 -2
  411. package/src/workflows/triggers.ts +11 -6
  412. package/src/workflows/validation.ts +10 -0
  413. package/src/workflows/version.ts +7 -1
  414. package/templates/ai-toolbox.manifest.json +1 -1
  415. package/templates/skills/agent-browser/SKILL.md +1 -0
  416. package/templates/skills/agent-browser/content.md +1 -0
  417. package/templates/skills/boards-and-sheets/config.json +14 -0
  418. package/templates/skills/boards-and-sheets/content.md +163 -0
  419. package/templates/skills/pages/content.md +5 -0
  420. package/templates/skills/swarm-docs/content.md +15 -1
  421. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  422. package/templates/skills/swarm-scripts/content.md +1 -0
  423. package/templates/skills/tdd-planning/content.md +5 -2
  424. package/dist/acp-adapter-weaaxey3.js +0 -16
  425. package/dist/core-df1n049h.js +0 -39
  426. package/dist/fx-adapter-zwmps9re.js +0 -19
  427. package/dist/grok-adapter-q0avf919.js +0 -19
  428. package/dist/handlers-g5jq0e4q.js +0 -36
  429. package/dist/index-1f6m47mq.js +0 -37
  430. package/dist/index-1p1mpqda.js +0 -36
  431. package/dist/index-tnkd410q.js +0 -41
  432. package/dist/lead-m5e7xt93.js +0 -75
  433. package/dist/thread-buffer-nf55vwx3.js +0 -39
  434. package/dist/worker-ews1nyhw.js +0 -75
  435. package/src/slack/socket-mode-guard.test.ts +0 -25
  436. package/src/tests/agent-activity.test.ts +0 -247
  437. package/src/tests/agent-fs-live-url.test.ts +0 -55
  438. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  439. package/src/tests/approval-sweeps-config.test.ts +0 -47
  440. package/src/tests/cards.test.ts +0 -169
  441. package/src/tests/chat-sdk-facts.test.ts +0 -23
  442. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  443. package/src/tests/core-auth.test.ts +0 -156
  444. package/src/tests/date-utils.test.ts +0 -48
  445. package/src/tests/db-context-versions.test.ts +0 -37
  446. package/src/tests/db-runtime.test.ts +0 -132
  447. package/src/tests/enabled-capabilities.test.ts +0 -20
  448. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  449. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  450. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  451. package/src/tests/github-event-labels.test.ts +0 -24
  452. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  453. package/src/tests/http-log-scrubbing.test.ts +0 -123
  454. package/src/tests/http-semconv-attributes.test.ts +0 -92
  455. package/src/tests/identity.test.ts +0 -117
  456. package/src/tests/inbox-state.test.ts +0 -167
  457. package/src/tests/internal-ai/models.test.ts +0 -54
  458. package/src/tests/launch-password-rejection.test.ts +0 -140
  459. package/src/tests/list-total-cache.test.ts +0 -88
  460. package/src/tests/match-route.test.ts +0 -187
  461. package/src/tests/memory-feature-flags.test.ts +0 -45
  462. package/src/tests/memory-get-tool.test.ts +0 -269
  463. package/src/tests/memory-health-endpoint.test.ts +0 -78
  464. package/src/tests/memory-http-access.test.ts +0 -221
  465. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  466. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  467. package/src/tests/openai-embedding-provider.test.ts +0 -159
  468. package/src/tests/org-identity.test.ts +0 -44
  469. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  470. package/src/tests/pages-browser-sdk.test.ts +0 -76
  471. package/src/tests/pages-feedback-keys.test.ts +0 -121
  472. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  473. package/src/tests/pages-list-endpoint.test.ts +0 -148
  474. package/src/tests/pages-password-mode.test.ts +0 -266
  475. package/src/tests/pages-public-authed-401.test.ts +0 -103
  476. package/src/tests/pages-public-html.test.ts +0 -297
  477. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  478. package/src/tests/pages-view-count.test.ts +0 -245
  479. package/src/tests/prompt-templates-db.test.ts +0 -616
  480. package/src/tests/rbac-engine.test.ts +0 -742
  481. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  482. package/src/tests/route-def-find-route.test.ts +0 -192
  483. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  484. package/src/tests/schedule-validation-helper.test.ts +0 -51
  485. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  486. package/src/tests/scheduler-backoff.test.ts +0 -166
  487. package/src/tests/script-run-token.test.ts +0 -75
  488. package/src/tests/scripts-extract-signature.test.ts +0 -47
  489. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  490. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  491. package/src/tests/short-id.test.ts +0 -23
  492. package/src/tests/skill-files-http.test.ts +0 -222
  493. package/src/tests/skill-get-file-tool.test.ts +0 -110
  494. package/src/tests/skill-script-refs.test.ts +0 -63
  495. package/src/tests/skill-update-scope.test.ts +0 -252
  496. package/src/tests/skills-bundle.test.ts +0 -99
  497. package/src/tests/slack-app-icon.test.ts +0 -94
  498. package/src/tests/slack-assistant-comention.test.ts +0 -139
  499. package/src/tests/slack-delete.test.ts +0 -157
  500. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  501. package/src/tests/slack-manifest.test.ts +0 -23
  502. package/src/tests/slack-task-output.test.ts +0 -90
  503. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  504. package/src/tests/swarm-diff.test.ts +0 -728
  505. package/src/tests/task-lifecycle-events.test.ts +0 -53
  506. package/src/tests/template-asset-config.test.ts +0 -18
  507. package/src/tests/template-fetch.test.ts +0 -490
  508. package/src/tests/themes-page-theme.test.ts +0 -155
  509. package/src/tests/tool-annotations.test.ts +0 -442
  510. package/src/tests/tool-output-agent-id.test.ts +0 -202
  511. package/src/tests/update-profile-agentid.test.ts +0 -248
  512. package/src/tests/whoami-route.test.ts +0 -162
  513. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  514. package/src/tests/workflow-patch.test.ts +0 -169
  515. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  516. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  517. package/src/tests/workflow-step-claims.test.ts +0 -152
  518. package/src/tests/workflow-step-order.test.ts +0 -92
  519. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  520. package/src/tests/workflow-versions.test.ts +0 -240
  521. package/src/tests/workflow-wait.test.ts +0 -26
@@ -11,13 +11,83 @@ import {
11
11
  getUserById,
12
12
  updateAgentStatusFromCapacity,
13
13
  } from "@/be/db";
14
- import { reconcileDeferredTaskWaits } from "@/scheduler/deferred-task-waits";
14
+ import {
15
+ describeEventWait,
16
+ type EventMatch,
17
+ EXTERNAL_EVENT_ADAPTERS,
18
+ EXTERNAL_EVENT_NAMES,
19
+ EXTERNAL_EVENTS_DOC,
20
+ type ExternalEventAdapter,
21
+ getExternalEventAdapter,
22
+ matchKeyOf,
23
+ } from "@/event-waits";
24
+ import {
25
+ MAX_PENDING_EVENT_WAITS_PER_AGENT,
26
+ reconcileDeferredEventWaits,
27
+ reconcileDeferredTaskWaits,
28
+ } from "@/scheduler/deferred-task-waits";
15
29
  import { runTaskTerminalEffects } from "@/tasks/task-terminal-effects";
16
30
  import { getTaskOutputValidationError } from "@/tasks/terminal-result-guard";
17
31
  import { assertOwnsTask, ownerCtx } from "@/tools/task-tool-ctx";
18
32
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
19
33
  import { isTerminalTaskStatus } from "@/types";
20
34
  import { ensure } from "../utils/business-use";
35
+ import { getCurrentRequestAuth } from "../utils/request-auth-context";
36
+
37
+ const isExternalEvent = (event: string) => EXTERNAL_EVENT_NAMES.includes(event);
38
+
39
+ /**
40
+ * Resolve and vet an external-event wait before any write: the adapter exists and
41
+ * serves the event, its integration is on, the match parses, and the event has not
42
+ * already happened (a read, when the adapter can confirm). Returns a user-facing error otherwise.
43
+ */
44
+ async function admitExternalWait(
45
+ event: string,
46
+ source: string,
47
+ rawMatch: unknown,
48
+ ): Promise<{ adapter: ExternalEventAdapter; match: EventMatch } | { error: string }> {
49
+ const adapter = getExternalEventAdapter(source);
50
+ if (!adapter?.events.includes(event)) {
51
+ const served = EXTERNAL_EVENT_ADAPTERS.filter((a) => a.events.includes(event)).map(
52
+ (a) => a.source,
53
+ );
54
+ return {
55
+ error: `Source "${source}" does not serve ${event}; use one of: ${served.join(", ")}.`,
56
+ };
57
+ }
58
+ let match: EventMatch;
59
+ try {
60
+ match = adapter.parseMatch(event, rawMatch);
61
+ } catch (error) {
62
+ return { error: error instanceof Error ? error.message : "Invalid match." };
63
+ }
64
+ const target = describeEventWait(source, event, match);
65
+ // A confirm read may use server-held credentials: refuse the ACP task tokens that
66
+ // /api/github/installation-token also refuses.
67
+ const auth = getCurrentRequestAuth();
68
+ if (adapter.readsWithServerCredentials && auth?.kind === "agent" && auth.tokenKind === "task") {
69
+ return {
70
+ error: "A task-scoped token cannot defer on an external event; defer on a timer instead.",
71
+ };
72
+ }
73
+ if (!adapter.isEnabled()) {
74
+ return {
75
+ error: `The ${source} integration is off, so no event can wake you; defer on a timer instead.`,
76
+ };
77
+ }
78
+ if (adapter.confirm) {
79
+ try {
80
+ if (await adapter.confirm(event, match)) {
81
+ return { error: `${target} already happened; read its result instead of deferring.` };
82
+ }
83
+ } catch (error) {
84
+ return {
85
+ error: `Could not read ${target} from ${source} (${error instanceof Error ? error.message : "unknown error"}); defer on a timer instead.`,
86
+ };
87
+ }
88
+ }
89
+ return { adapter, match };
90
+ }
21
91
 
22
92
  /** Thrown inside the transaction to abort and roll back the schedule INSERT. */
23
93
  class DeferAbortedError extends Error {}
@@ -161,7 +231,7 @@ export const registerDeferTaskTool = (server: McpServer) => {
161
231
  title: "Defer Task",
162
232
  annotations: { destructiveHint: false, idempotentHint: false },
163
233
  description:
164
- "Completes this task now with status `completed` and books a wake-up for you. Use when the result needs time: a build, a deploy, a reply. The task reaches its final state on this call; the lead sees your summary as its output unless the task has an outputSchema. For a task with an outputSchema, provide output as a JSON string matching that schema; it is stored verbatim as terminal output, while deferral details remain visible in the task log. A one-off schedule wakes you up later with a child task that carries this task as its parent. Optionally provide wakeOn with taskId or taskIds to wake early on task outcomes; mode defaults to all, or use any for the first match. delayMs or runAt remains required as the ceiling for the whole set. Provide delayMs or runAt, a summary of what you did, and a note that says what is pending and what to check.",
234
+ 'Completes this task now with status `completed` and books a wake-up for you. Use when the result needs time: a build, a deploy, a reply. The task reaches its final state on this call; the lead sees your summary as its output unless the task has an outputSchema. For a task with an outputSchema, provide output as a JSON string matching that schema; it is stored verbatim as terminal output, while deferral details remain visible in the task log. A one-off schedule wakes you up later with a child task that carries this task as its parent. Optionally provide wakeOn with taskId or taskIds to wake early on task outcomes; mode defaults to all, or use any for the first match. Or provide wakeOn {event, source, match} to wake on an external event, e.g. {event: "vcs.pr.merged", source: "github", match: {repo, number}}. delayMs or runAt remains required as the ceiling for the whole set. Provide delayMs or runAt, a summary of what you did, and a note that says what is pending and what to check.',
165
235
  inputSchema: z.object({
166
236
  taskId: z.string().describe("The ID of the task you are working on."),
167
237
  delayMs: z
@@ -177,21 +247,40 @@ export const registerDeferTaskTool = (server: McpServer) => {
177
247
  .describe("Wake up at this ISO datetime (e.g. '2026-03-06T15:00:00Z'). Must be future."),
178
248
  wakeOn: z
179
249
  .object({
180
- event: z.enum(["task.completed", "task.failed", "settled"]),
250
+ event: z.enum(["task.completed", "task.failed", "settled", ...EXTERNAL_EVENT_NAMES]),
181
251
  taskId: z.string().min(1).optional(),
182
252
  taskIds: z.array(z.string().min(1)).min(1).optional(),
183
253
  mode: z.enum(["all", "any"]).optional(),
254
+ source: z.string().min(1).optional(),
255
+ match: z.record(z.string(), z.union([z.string(), z.number()])).optional(),
184
256
  })
185
257
  .strict()
186
- .refine((wake) => (wake.taskId !== undefined) !== (wake.taskIds !== undefined), {
187
- message: "Provide exactly one of wakeOn.taskId or wakeOn.taskIds.",
188
- })
258
+ .refine(
259
+ (wake) =>
260
+ isExternalEvent(wake.event) ||
261
+ (wake.taskId !== undefined) !== (wake.taskIds !== undefined),
262
+ { message: "Provide exactly one of wakeOn.taskId or wakeOn.taskIds." },
263
+ )
264
+ .refine(
265
+ (wake) =>
266
+ isExternalEvent(wake.event)
267
+ ? wake.source !== undefined &&
268
+ wake.match !== undefined &&
269
+ wake.taskId === undefined &&
270
+ wake.taskIds === undefined &&
271
+ wake.mode === undefined
272
+ : wake.source === undefined && wake.match === undefined,
273
+ {
274
+ message:
275
+ "External events (e.g. vcs.pr.merged) take source and match only; task events take no source or match.",
276
+ },
277
+ )
189
278
  .refine((wake) => !wake.taskIds || new Set(wake.taskIds).size === wake.taskIds.length, {
190
279
  message: "wakeOn.taskIds must not contain duplicates.",
191
280
  })
192
281
  .optional()
193
282
  .describe(
194
- "Wake early on a task event. Provide taskId or nonempty, unique taskIds. mode defaults to all (every member must match); any wakes on the first match. settled covers completed, failed, cancelled, or skipped. Deferred and superseded members follow their continuations; a superseded member without a resume child holds to the ceiling, except a workflow step superseded by its queued retry, which counts as failed. Any already-terminal member rejects the request; one delayMs/runAt ceiling is still required for the whole set. The member whose settlement wakes you creates no separate lead follow-up for your agent unless its followUpConfig sets onCompleted/onFailed; an all-mode member that settles while others are pending still does.",
283
+ `Wake early on a task event. Provide taskId or nonempty, unique taskIds. mode defaults to all (every member must match); any wakes on the first match. settled covers completed, failed, cancelled, or skipped. Deferred and superseded members follow their continuations; a superseded member without a resume child holds to the ceiling, except a workflow step superseded by its queued retry, which counts as failed. Any already-terminal member rejects the request; one delayMs/runAt ceiling is still required for the whole set. External events: ${EXTERNAL_EVENTS_DOC}. They are rejected when the event already happened, the provider cannot be read, or its integration is off; an agent holds at most ${MAX_PENDING_EVENT_WAITS_PER_AGENT} pending external waits. The member whose settlement wakes you creates no separate lead follow-up for your agent unless its followUpConfig sets onCompleted/onFailed; an all-mode member that settles while others are pending still does.`,
195
284
  ),
196
285
  summary: z
197
286
  .string()
@@ -281,11 +370,15 @@ export const registerDeferTaskTool = (server: McpServer) => {
281
370
 
282
371
  const watchedTaskIds = wakeOn?.taskIds ?? (wakeOn?.taskId ? [wakeOn.taskId] : []);
283
372
  const wakeMode = wakeOn?.mode ?? "all";
284
- const wakeDescription = wakeOn
285
- ? `on ${wakeOn.event} for ${wakeMode} of tasks ${watchedTaskIds.join(", ")}, or by ${nextRunAt}`
286
- : `at ${nextRunAt}`;
373
+ const eventWait = wakeOn && isExternalEvent(wakeOn.event) ? wakeOn : undefined;
374
+ const wakeDescription = eventWait
375
+ ? `on ${eventWait.event} from ${eventWait.source}, or by ${nextRunAt}`
376
+ : wakeOn
377
+ ? `on ${wakeOn.event} for ${wakeMode} of tasks ${watchedTaskIds.join(", ")}, or by ${nextRunAt}`
378
+ : `at ${nextRunAt}`;
287
379
  const checksBlock = renderChecks(checks);
288
380
  const taskTemplate = `Resume task ${taskId}: ${note}${checksBlock}`;
381
+ // Not the audit task: the wake-up task is requested by the schedule's created_by.
289
382
  const createdBy =
290
383
  (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ?? undefined;
291
384
 
@@ -304,8 +397,29 @@ export const registerDeferTaskTool = (server: McpServer) => {
304
397
  task.requestedByUserId,
305
398
  );
306
399
 
400
+ // Read the provider before the transaction: no network call under the write lock.
401
+ let admitted: { adapter: ExternalEventAdapter; match: EventMatch } | undefined;
402
+ if (eventWait) {
403
+ const result = await admitExternalWait(eventWait.event, eventWait.source!, eventWait.match);
404
+ if ("error" in result) return toolErr(result.error);
405
+ admitted = result;
406
+ }
407
+
307
408
  try {
308
409
  const committed = await getDbClient().transaction(async () => {
410
+ if (admitted) {
411
+ const pending = await getDbClient().get<{ n: number }>(
412
+ `SELECT COUNT(*) AS n FROM deferred_event_waits w
413
+ JOIN scheduled_tasks s ON s.id = w.scheduleId
414
+ WHERE w.status = 'pending' AND s.enabled = 1 AND s.targetAgentId = ?`,
415
+ [agent.id],
416
+ );
417
+ if ((pending?.n ?? 0) >= MAX_PENDING_EVENT_WAITS_PER_AGENT) {
418
+ throw new DeferAbortedError(
419
+ `You already hold ${MAX_PENDING_EVENT_WAITS_PER_AGENT} pending external event waits; wait for one to fire.`,
420
+ );
421
+ }
422
+ }
309
423
  // The transaction's write lock makes admission atomic with the INSERT.
310
424
  if (watchedTaskIds.length) {
311
425
  const existing = await getDbClient().get<{ scheduleId: string; parentTaskId: string }>(
@@ -366,7 +480,31 @@ export const registerDeferTaskTool = (server: McpServer) => {
366
480
  createdBy,
367
481
  });
368
482
 
369
- if (wakeOn) {
483
+ if (admitted && eventWait) {
484
+ const matchKey = matchKeyOf(admitted.match);
485
+ await getDbClient().run(
486
+ "INSERT INTO deferred_event_waits (scheduleId, source, event, matchKey, matchJson, created_by, updated_by) VALUES (?, ?, ?, ?, ?, ?, ?)",
487
+ [
488
+ schedule.id,
489
+ admitted.adapter.source,
490
+ eventWait.event,
491
+ matchKey,
492
+ JSON.stringify(admitted.match),
493
+ createdBy ?? null,
494
+ createdBy ?? null,
495
+ ],
496
+ );
497
+ // The event may land between the read above and this commit; recheck after it.
498
+ getDbClient().afterCommit(() => {
499
+ void reconcileDeferredEventWaits({
500
+ source: admitted.adapter.source,
501
+ event: eventWait.event,
502
+ matchKey,
503
+ }).catch((err) => {
504
+ console.error("[defer-task] external event wake reconciliation failed:", err);
505
+ });
506
+ });
507
+ } else if (wakeOn) {
370
508
  await getDbClient().run(
371
509
  "INSERT INTO deferred_task_waits (scheduleId, eventName, mode, created_by, updated_by) VALUES (?, ?, ?, ?, ?)",
372
510
  [schedule.id, wakeOn.event, wakeMode, createdBy ?? null, createdBy ?? null],
@@ -397,7 +535,11 @@ export const registerDeferTaskTool = (server: McpServer) => {
397
535
  nextRunAt,
398
536
  requesterTz,
399
537
  isFallbackTz,
400
- wakeOn ? renderWaitingOn(watchedAgentNames, watchedTaskIds.length) : undefined,
538
+ admitted && eventWait
539
+ ? describeEventWait(admitted.adapter.source, eventWait.event, admitted.match)
540
+ : wakeOn
541
+ ? renderWaitingOn(watchedAgentNames, watchedTaskIds.length)
542
+ : undefined,
401
543
  );
402
544
  const completed = await completeTask(taskId, terminalOutput, {
403
545
  addTags: ["deferred"],
@@ -0,0 +1,196 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import * as z from "zod";
3
+ import {
4
+ createObject,
5
+ getObject,
6
+ listObjects,
7
+ ObjectsError,
8
+ PRIMITIVE_KIND_NAMES,
9
+ type PrimitiveObject,
10
+ reindexObjects,
11
+ } from "@/be/primitives/objects";
12
+ import { FilesError } from "@/fs/provider";
13
+ import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
14
+
15
+ // Loose, format-pin-free mirror of PrimitiveObject for MCP output validation.
16
+ export const objectOutputSchema = z.looseObject({
17
+ id: z.string().optional(),
18
+ kind: z.string().optional(),
19
+ orgId: z.string().optional(),
20
+ driveId: z.string().optional(),
21
+ path: z.string().optional(),
22
+ title: z.string().nullable().optional(),
23
+ fileVersion: z.number().nullable().optional(),
24
+ ownerAgentId: z.string().nullable().optional(),
25
+ deletedAt: z.string().nullable().optional(),
26
+ createdAt: z.string().optional(),
27
+ updatedAt: z.string().optional(),
28
+ link: z.string().nullable().optional(),
29
+ });
30
+
31
+ const KindSchema = z.enum(PRIMITIVE_KIND_NAMES);
32
+
33
+ /** Refusals (bad input, no agent-fs identity, agent-fs errors) become toolErr; bugs still throw. */
34
+ export async function refusing<T>(
35
+ agentId: string | undefined,
36
+ run: () => Promise<T>,
37
+ ): Promise<{ value: T } | { error: ReturnType<typeof toolErr> }> {
38
+ try {
39
+ return { value: await run() };
40
+ } catch (error) {
41
+ if (error instanceof ObjectsError || error instanceof FilesError) {
42
+ return { error: toolErr(error.message, { data: { yourAgentId: agentId } }) };
43
+ }
44
+ throw error;
45
+ }
46
+ }
47
+
48
+ const summary = (o: PrimitiveObject) =>
49
+ `${o.kind} ${o.id} at ${o.path}${o.link ? ` (${o.link})` : ""}`;
50
+
51
+ export const registerObjectCreateTool = (server: McpServer) => {
52
+ createToolRegistrar(server)(
53
+ "object-create",
54
+ {
55
+ title: "Create primitive object",
56
+ annotations: { readOnlyHint: false, idempotentHint: false },
57
+ description:
58
+ "Create a primitive object file on your default agent-fs drive, as your own agent-fs identity, and give it a stable id. Create-only: refuses when the path exists (use object-reindex to adopt an existing file). Kind `board` writes an empty Excalidraw scene and needs a `.excalidraw` path. Kind `sheet` writes an empty `swarm-sheet/1` workbook and needs a `.sheet.json` path (edit it with the sheet-* tools).",
59
+ inputSchema: z.object({
60
+ kind: KindSchema.describe(
61
+ "Object kind. `board`: an Excalidraw scene (.excalidraw). `sheet`: a spreadsheet (.sheet.json).",
62
+ ),
63
+ path: z.string().min(1).describe("Drive path, e.g. /boards/roadmap.excalidraw."),
64
+ title: z.string().max(200).optional(),
65
+ }),
66
+ outputSchema: swarmToolOutputSchema({
67
+ yourAgentId: z.string().optional(),
68
+ object: objectOutputSchema.optional(),
69
+ }),
70
+ },
71
+ async ({ kind, path, title }, requestInfo) => {
72
+ const result = await refusing(requestInfo.agentId, () =>
73
+ createObject({ agentId: requestInfo.agentId, kind, path, title }),
74
+ );
75
+ if ("error" in result) return result.error;
76
+ return toolOk(`Created ${summary(result.value)}.`, {
77
+ data: { yourAgentId: requestInfo.agentId, object: result.value },
78
+ });
79
+ },
80
+ );
81
+ };
82
+
83
+ export const registerObjectGetTool = (server: McpServer) => {
84
+ createToolRegistrar(server)(
85
+ "object-get",
86
+ {
87
+ title: "Get primitive object",
88
+ description:
89
+ "Get a primitive object on your default agent-fs drive by `id` or `path`. `missing: true` means the row exists but the file is gone. `includeContent` returns the parsed file.",
90
+ annotations: { readOnlyHint: true },
91
+ inputSchema: z.object({
92
+ id: z.string().min(1).optional(),
93
+ path: z.string().min(1).optional(),
94
+ includeContent: z.boolean().optional(),
95
+ }),
96
+ outputSchema: swarmToolOutputSchema({
97
+ yourAgentId: z.string().optional(),
98
+ object: objectOutputSchema.optional(),
99
+ missing: z.boolean().optional(),
100
+ content: z.unknown().optional(),
101
+ }),
102
+ },
103
+ async ({ id, path, includeContent }, requestInfo) => {
104
+ const result = await refusing(requestInfo.agentId, () =>
105
+ getObject({ agentId: requestInfo.agentId, id, path, includeContent }),
106
+ );
107
+ if ("error" in result) return result.error;
108
+ const { object, missing, content } = result.value;
109
+ return toolOk(
110
+ missing ? `File for ${summary(object)} is missing.` : `Found ${summary(object)}.`,
111
+ {
112
+ data: {
113
+ yourAgentId: requestInfo.agentId,
114
+ object,
115
+ missing,
116
+ ...(content === undefined ? {} : { content }),
117
+ },
118
+ },
119
+ );
120
+ },
121
+ );
122
+ };
123
+
124
+ export const registerObjectListTool = (server: McpServer) => {
125
+ createToolRegistrar(server)(
126
+ "object-list",
127
+ {
128
+ title: "List primitive objects",
129
+ description:
130
+ "List primitive objects on your default agent-fs drive, newest first. Hides objects whose file agent-fs reported deleted. Filter by `kind` and path `prefix`. Pagination via limit (max 200) and offset.",
131
+ annotations: { readOnlyHint: true },
132
+ inputSchema: z.object({
133
+ kind: KindSchema.optional(),
134
+ prefix: z.string().optional(),
135
+ limit: z.number().int().positive().max(200).optional(),
136
+ offset: z.number().int().nonnegative().optional(),
137
+ }),
138
+ outputSchema: swarmToolOutputSchema({
139
+ yourAgentId: z.string().optional(),
140
+ objects: z.array(objectOutputSchema).optional(),
141
+ total: z.number().optional(),
142
+ }),
143
+ },
144
+ async ({ kind, prefix, limit, offset }, requestInfo) => {
145
+ const result = await refusing(requestInfo.agentId, () =>
146
+ listObjects({ agentId: requestInfo.agentId, kind, prefix, limit, offset }),
147
+ );
148
+ if ("error" in result) return result.error;
149
+ const { objects, total } = result.value;
150
+ return toolOk(`Found ${objects.length} of ${total} objects.`, {
151
+ details: objects.length > 0 ? objects.map((o) => `- ${summary(o)}`).join("\n") : undefined,
152
+ data: { yourAgentId: requestInfo.agentId, objects, total },
153
+ });
154
+ },
155
+ );
156
+ };
157
+
158
+ export const registerObjectReindexTool = (server: McpServer) => {
159
+ createToolRegistrar(server)(
160
+ "object-reindex",
161
+ {
162
+ title: "Reindex primitive objects",
163
+ annotations: { readOnlyHint: false, idempotentHint: true },
164
+ description:
165
+ "Rebuild the object index from the files on your default agent-fs drive. Keeps each file's embedded id; a file with no id (for example a stock Excalidraw save) keeps the id of the row at its path, else gets a new one written back. Rows whose file is gone are reported as `missing`, never deleted. Without `prefix` it touches every id-less file of the kind on the drive, including files other people put there: pass `prefix` (same path-prefix match as object-list; end it with `/` for one folder, or give one file's path) to limit it, and `dryRun: true` to get the same report with nothing written. Files whose version matches the index are checked, not re-read (`unchanged`); one call reads at most 50 changed files, 16 MiB, or 20 seconds of work, so run it again while `truncated` is true (`cutBy` names the limit). agent-fs file.changed webhooks keep the index current between runs when the swarm can register them.",
166
+ inputSchema: z.object({
167
+ kind: KindSchema.optional(),
168
+ prefix: z.string().optional(),
169
+ dryRun: z.boolean().optional(),
170
+ }),
171
+ outputSchema: swarmToolOutputSchema({
172
+ yourAgentId: z.string().optional(),
173
+ scanned: z.number().optional(),
174
+ unchanged: z.number().optional(),
175
+ adopted: z.array(z.string()).optional(),
176
+ restored: z.array(z.string()).optional(),
177
+ missing: z.array(z.string()).optional(),
178
+ conflicts: z.array(z.looseObject({ path: z.string(), reason: z.string() })).optional(),
179
+ truncated: z.boolean().optional(),
180
+ cutBy: z.enum(["files", "reads", "time", "bytes"]).nullable().optional(),
181
+ dryRun: z.boolean().optional(),
182
+ }),
183
+ },
184
+ async ({ kind, prefix, dryRun }, requestInfo) => {
185
+ const result = await refusing(requestInfo.agentId, () =>
186
+ reindexObjects({ agentId: requestInfo.agentId, kind, prefix, dryRun }),
187
+ );
188
+ if ("error" in result) return result.error;
189
+ const report = result.value;
190
+ return toolOk(
191
+ `${report.dryRun ? "Dry run, nothing written. " : ""}Scanned ${report.scanned} files: ${report.unchanged} unchanged, ${report.adopted.length} adopted, ${report.restored.length} restored, ${report.missing.length} missing, ${report.conflicts.length} skipped${report.truncated ? ` (truncated: ${report.cutBy} limit)` : ""}.`,
192
+ { data: { yourAgentId: requestInfo.agentId, ...report } },
193
+ );
194
+ },
195
+ );
196
+ };
@@ -4,7 +4,7 @@ import { getAgentById } from "@/be/db";
4
4
  import { updateSwarmRepoChecked } from "@/be/repo-checked-update";
5
5
  import { can } from "@/rbac";
6
6
  import { createToolRegistrar, swarmToolOutputSchema, toolErr, toolOk } from "@/tools/utils";
7
- import { RepoGuidelinesInputSchema, RepoHooksSchema } from "@/types";
7
+ import { agentsMayMerge, RepoGuidelinesInputSchema, RepoHooksSchema } from "@/types";
8
8
 
9
9
  const swarmRepoOutputShape = z.looseObject({
10
10
  id: z.string().optional(),
@@ -33,7 +33,7 @@ export const registerUpdateRepoTool = (server: McpServer) => {
33
33
  {
34
34
  title: "Update Repo",
35
35
  description:
36
- "Update a repo's configuration including guidelines (PR checks, merge policy, review guidance). The lead uses this to set guidelines after asking the user. Pass null for guidelines to clear them. Only the lead can change allowMerge: resend its current value to edit other guidelines.",
36
+ "Update a repo's configuration including guidelines (PR checks, merge policy, review guidance). The lead uses this to set guidelines after asking the user. Pass null for guidelines to clear them. Only the lead can change allowMerge or mergePolicy: resend their current values to edit other guidelines.",
37
37
  annotations: { readOnlyHint: false },
38
38
 
39
39
  inputSchema: z.object({
@@ -51,7 +51,7 @@ export const registerUpdateRepoTool = (server: McpServer) => {
51
51
  guidelines: RepoGuidelinesInputSchema.nullable()
52
52
  .optional()
53
53
  .describe(
54
- "Repository guidelines: prChecks (commands before PR), mergeChecks (conditions before merge), allowMerge (default false), review (guidance for reviewers). Pass null to clear.",
54
+ "Repository guidelines: prChecks (commands before PR), mergeChecks (conditions before merge), allowMerge (default false), review (guidance for reviewers), mergePolicy (per-repo merge policy record: autoMerge, agentsMayMerge, notify). Pass null to clear.",
55
55
  ),
56
56
  }),
57
57
  outputSchema: swarmToolOutputSchema({
@@ -59,7 +59,7 @@ export const registerUpdateRepoTool = (server: McpServer) => {
59
59
  }),
60
60
  },
61
61
  async ({ id, ...updates }, requestInfo) => {
62
- // The comparison with the stored allowMerge, the decision and the write share one
62
+ // The comparison with the stored merge policy, the decision and the write share one
63
63
  // transaction, so a stale edit cannot overwrite a merge-policy change committed after it.
64
64
  const result = await updateSwarmRepoChecked(id, updates, async (existing) => {
65
65
  const agent = requestInfo.agentId ? await getAgentById(requestInfo.agentId) : null;
@@ -72,8 +72,8 @@ export const registerUpdateRepoTool = (server: McpServer) => {
72
72
  source: "mcp",
73
73
  });
74
74
  if (decision.allow) return null;
75
- const current = existing.guidelines?.allowMerge === true;
76
- return `Only lead agents can change allowMerge (it is currently ${current}). Resend ${current} to keep it while you edit the other guidelines.`;
75
+ const current = agentsMayMerge(existing.guidelines);
76
+ return `Only lead agents can change allowMerge or mergePolicy (agents may merge: ${current}). Resend the current allowMerge and mergePolicy to keep them while you edit the other guidelines.`;
77
77
  });
78
78
 
79
79
  if (result.kind === "refused") {
@@ -326,6 +326,7 @@ export const registerCreateScheduleTool = (server: McpServer) => {
326
326
  nextRunAt = calculateNextRun(tempSchedule, new Date());
327
327
  }
328
328
 
329
+ // Not the audit task: a schedule fires its tasks as requested by created_by.
329
330
  const createdBy =
330
331
  (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
331
332
  undefined;
@@ -22,6 +22,9 @@ const scheduleRowShape = {
22
22
  lastRunAt: z.string().optional(),
23
23
  nextRunAt: z.string().optional(),
24
24
  createdByAgentId: z.string().optional(),
25
+ updatedByAgentId: z.string().optional(),
26
+ createdBy: z.string().optional(),
27
+ updatedBy: z.string().optional(),
25
28
  parentTaskId: z.string().optional(),
26
29
  timezone: z.string().optional(),
27
30
  consecutiveErrors: z.number().optional(),
@@ -378,10 +378,19 @@ export const registerPatchScheduleTool = (server: McpServer) => {
378
378
  }
379
379
 
380
380
  const updatedBy =
381
- (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
381
+ (await resolveTaskAuditUserId(requestInfo.auditSourceTaskId, requestInfo.agentId)) ??
382
382
  undefined;
383
- if (key !== undefined) updateData.key = await authorizeAssetKeyWrite(key, updatedBy);
384
- const updated = await updateScheduledTask(schedule.id, { ...updateData, updatedBy });
383
+ if (key !== undefined) {
384
+ updateData.key = await authorizeAssetKeyWrite(
385
+ key,
386
+ await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId),
387
+ );
388
+ }
389
+ const updated = await updateScheduledTask(schedule.id, {
390
+ ...updateData,
391
+ updatedBy: updatedBy ?? null,
392
+ updatedByAgentId: requestInfo.agentId ?? null,
393
+ });
385
394
 
386
395
  if (!updated) {
387
396
  return toolErr("Failed to update schedule.");
@@ -377,10 +377,19 @@ export const registerUpdateScheduleTool = (server: McpServer) => {
377
377
  }
378
378
 
379
379
  const updatedBy =
380
- (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
380
+ (await resolveTaskAuditUserId(requestInfo.auditSourceTaskId, requestInfo.agentId)) ??
381
381
  undefined;
382
- if (key !== undefined) updateData.key = await authorizeAssetKeyWrite(key, updatedBy);
383
- const updated = await updateScheduledTask(schedule.id, { ...updateData, updatedBy });
382
+ if (key !== undefined) {
383
+ updateData.key = await authorizeAssetKeyWrite(
384
+ key,
385
+ await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId),
386
+ );
387
+ }
388
+ const updated = await updateScheduledTask(schedule.id, {
389
+ ...updateData,
390
+ updatedBy: updatedBy ?? null,
391
+ updatedByAgentId: requestInfo.agentId ?? null,
392
+ });
384
393
 
385
394
  if (!updated) {
386
395
  return toolErr("Failed to update schedule.");