@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
@@ -1,53 +0,0 @@
1
- import { describe, expect, test } from "bun:test";
2
- import { emitTaskStarted, onTaskStarted } from "../be/task-lifecycle-events";
3
- import type { AgentTask } from "../types";
4
-
5
- function makeTask(overrides: Partial<AgentTask> = {}): AgentTask {
6
- return {
7
- id: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
8
- agentId: "11111111-2222-3333-4444-555555555555",
9
- task: "Test task",
10
- status: "in_progress",
11
- source: "github",
12
- priority: 50,
13
- tags: [],
14
- dependsOn: [],
15
- wasPaused: false,
16
- createdAt: new Date().toISOString(),
17
- lastUpdatedAt: new Date().toISOString(),
18
- ...overrides,
19
- } as AgentTask;
20
- }
21
-
22
- describe("task-lifecycle-events", () => {
23
- test("emitTaskStarted invokes a registered onTaskStarted handler with the task", () => {
24
- const received: AgentTask[] = [];
25
- onTaskStarted((task) => {
26
- received.push(task);
27
- });
28
-
29
- const task = makeTask();
30
- emitTaskStarted(task);
31
-
32
- expect(received).toContain(task);
33
- });
34
-
35
- test("a throwing handler does not break emit and later handlers still run", () => {
36
- let laterRan = false;
37
- onTaskStarted(() => {
38
- throw new Error("boom");
39
- });
40
- onTaskStarted(() => {
41
- laterRan = true;
42
- });
43
-
44
- expect(() => emitTaskStarted(makeTask())).not.toThrow();
45
- expect(laterRan).toBe(true);
46
- });
47
-
48
- test("a promise-rejecting handler is fire-and-forget and does not throw", () => {
49
- onTaskStarted(() => Promise.reject(new Error("async boom")));
50
-
51
- expect(() => emitTaskStarted(makeTask())).not.toThrow();
52
- });
53
- });
@@ -1,18 +0,0 @@
1
- import { expect, test } from "bun:test";
2
- import { ASSET_CATEGORIES } from "../../templates/schema";
3
-
4
- const templatesDir = new URL("../../templates/", import.meta.url).pathname;
5
-
6
- for (const category of ASSET_CATEGORIES) {
7
- for (const configPath of new Bun.Glob(`${category}/*/config.json`).scanSync(templatesDir)) {
8
- test(`${configPath} declares the arrays consumed by the template gallery`, async () => {
9
- const config = await Bun.file(`${templatesDir}${configPath}`).json();
10
- expect(config.placeholders).toBeArray();
11
- expect(config.placeholders.every((value: unknown) => typeof value === "string")).toBe(true);
12
- if (category === "workflows") {
13
- expect(config.requires).toBeArray();
14
- expect(config.requires.every((value: unknown) => typeof value === "string")).toBe(true);
15
- }
16
- });
17
- }
18
- }
@@ -1,490 +0,0 @@
1
- import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
- import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
3
- import http from "node:http";
4
- import type { TemplateResponse } from "../../templates/schema.ts";
5
- import { interpolate } from "../workflows/template.ts";
6
-
7
- const CACHE_DIR = "/tmp/test-template-cache";
8
-
9
- const mockTemplate: TemplateResponse = {
10
- config: {
11
- name: "coder",
12
- displayName: "Coder",
13
- description: "Test coder template",
14
- version: "1.0.0",
15
- category: "official",
16
- icon: "code",
17
- author: "Test <test@test.com>",
18
- createdAt: "2026-03-09",
19
- lastUpdatedAt: "2026-03-09",
20
- agentDefaults: {
21
- role: "worker",
22
- capabilities: ["typescript", "react"],
23
- maxTasks: 3,
24
- },
25
- files: {
26
- claudeMd: "CLAUDE.md",
27
- soulMd: "SOUL.md",
28
- identityMd: "IDENTITY.md",
29
- toolsMd: "TOOLS.md",
30
- setupScript: "start-up.sh",
31
- },
32
- },
33
- files: {
34
- claudeMd: "# {{agent.name}} - {{agent.role}} Agent",
35
- soulMd: "You are {{agent.name}}, a {{agent.role}} agent.",
36
- identityMd: "Name: {{agent.name}}\nCapabilities: {{agent.capabilities}}",
37
- toolsMd: "# Tools for {{agent.name}}",
38
- setupScript: '#!/bin/bash\necho "Template: {{agent.role}}"',
39
- },
40
- };
41
-
42
- let server: http.Server;
43
- let serverPort: number;
44
- let fetchCount = 0;
45
-
46
- beforeAll(async () => {
47
- await mkdir(CACHE_DIR, { recursive: true });
48
-
49
- server = http.createServer((_req, res) => {
50
- fetchCount++;
51
- const url = _req.url || "";
52
-
53
- if (url.includes("/api/templates/official/coder")) {
54
- res.writeHead(200, { "Content-Type": "application/json" });
55
- res.end(JSON.stringify(mockTemplate));
56
- } else {
57
- res.writeHead(404, { "Content-Type": "application/json" });
58
- res.end(JSON.stringify({ error: "Not found" }));
59
- }
60
- });
61
-
62
- await new Promise<void>((resolve) => {
63
- server.listen(0, () => {
64
- const addr = server.address();
65
- serverPort = typeof addr === "object" && addr ? addr.port : 0;
66
- resolve();
67
- });
68
- });
69
- });
70
-
71
- afterAll(async () => {
72
- server.close();
73
- await rm(CACHE_DIR, { recursive: true, force: true });
74
- });
75
-
76
- describe("Template interpolation", () => {
77
- test("interpolates {{agent.name}} and {{agent.role}}", () => {
78
- const result = interpolate("Hello {{agent.name}}, you are a {{agent.role}}", {
79
- agent: { name: "TestBot", role: "worker" },
80
- }).result;
81
- expect(result).toBe("Hello TestBot, you are a worker");
82
- });
83
-
84
- test("replaces unknown placeholders with empty string", () => {
85
- const result = interpolate("Hello {{agent.unknown}}", {
86
- agent: { name: "TestBot" },
87
- }).result;
88
- expect(result).toBe("Hello ");
89
- });
90
-
91
- test("handles capabilities join", () => {
92
- const ctx = {
93
- agent: {
94
- name: "Coder",
95
- role: "worker",
96
- capabilities: "typescript, react",
97
- },
98
- };
99
- const result = interpolate("Caps: {{agent.capabilities}}", ctx).result;
100
- expect(result).toBe("Caps: typescript, react");
101
- });
102
- });
103
-
104
- describe("Template fetch and cache", () => {
105
- test("fetches template from registry", async () => {
106
- fetchCount = 0;
107
- const resp = await fetch(`http://localhost:${serverPort}/api/templates/official/coder`);
108
- expect(resp.ok).toBe(true);
109
- const template = (await resp.json()) as TemplateResponse;
110
- expect(template.config.name).toBe("coder");
111
- expect(template.files.claudeMd).toContain("{{agent.name}}");
112
- expect(fetchCount).toBe(1);
113
- });
114
-
115
- test("returns 404 for nonexistent template", async () => {
116
- const resp = await fetch(`http://localhost:${serverPort}/api/templates/official/nonexistent`);
117
- expect(resp.status).toBe(404);
118
- });
119
-
120
- test("caching: write and read from cache", async () => {
121
- const cachePath = `${CACHE_DIR}/official_coder.json`;
122
- await writeFile(cachePath, JSON.stringify(mockTemplate), "utf-8");
123
-
124
- const cached = await readFile(cachePath, "utf-8");
125
- const parsed = JSON.parse(cached) as TemplateResponse;
126
- expect(parsed.config.name).toBe("coder");
127
- expect(parsed.files.soulMd).toContain("{{agent.name}}");
128
- });
129
- });
130
-
131
- describe("Template idempotency", () => {
132
- test("first boot: empty profile fields get template content", () => {
133
- let soulMd: string | undefined;
134
- let identityMd: string | undefined;
135
-
136
- const ctx = {
137
- agent: { name: "MyAgent", role: "worker", capabilities: "ts, react" },
138
- };
139
-
140
- // Simulate: profile fields are empty, apply template
141
- if (!soulMd) soulMd = interpolate(mockTemplate.files.soulMd, ctx).result;
142
- if (!identityMd) identityMd = interpolate(mockTemplate.files.identityMd, ctx).result;
143
-
144
- expect(soulMd).toBe("You are MyAgent, a worker agent.");
145
- expect(identityMd).toContain("MyAgent");
146
- });
147
-
148
- test("second boot: existing profile fields are preserved (template NOT re-applied)", () => {
149
- const existingSoul = "I am a customized soul that the agent edited.";
150
- let soulMd: string | undefined = existingSoul;
151
-
152
- const ctx = {
153
- agent: { name: "MyAgent", role: "worker", capabilities: "ts, react" },
154
- };
155
-
156
- // Simulate: profile already exists, guard prevents template application
157
- if (!soulMd) soulMd = interpolate(mockTemplate.files.soulMd, ctx).result;
158
-
159
- // Original content preserved
160
- expect(soulMd).toBe(existingSoul);
161
- });
162
-
163
- test("partial profile: only missing fields get template content", () => {
164
- let soulMd: string | undefined = "Existing soul";
165
- let claudeMd: string | undefined;
166
-
167
- const ctx = {
168
- agent: { name: "MyAgent", role: "worker", capabilities: "ts, react" },
169
- };
170
-
171
- if (!soulMd) soulMd = interpolate(mockTemplate.files.soulMd, ctx).result;
172
- if (!claudeMd) claudeMd = interpolate(mockTemplate.files.claudeMd, ctx).result;
173
-
174
- expect(soulMd).toBe("Existing soul");
175
- expect(claudeMd).toBe("# MyAgent - worker Agent");
176
- });
177
-
178
- test("TEMPLATE_ID set but registry unreachable: falls back to defaults", () => {
179
- // Simulate: fetch returned null, fallback to default
180
- const template: TemplateResponse | null = null;
181
- let soulMd: string | undefined;
182
-
183
- if (template) {
184
- soulMd = interpolate(template.files.soulMd, {}).result;
185
- }
186
-
187
- // Template not applied, soulMd still undefined -> fallback will generate default
188
- expect(soulMd).toBeUndefined();
189
- });
190
- });
191
-
192
- // ---------------------------------------------------------------------------
193
- // Template registration defaults — tests the priority logic from runner.ts
194
- // that applies template agentDefaults before registration
195
- // ---------------------------------------------------------------------------
196
-
197
- describe("Template registration defaults", () => {
198
- // Helper: simulates the agentName priority chain from runner.ts
199
- function resolveAgentName(
200
- envName: string | undefined,
201
- templateDisplayName: string | undefined,
202
- role: string,
203
- agentId: string,
204
- ): string {
205
- return envName || templateDisplayName || `${role}-${agentId.slice(0, 8)}`;
206
- }
207
-
208
- // ---- name priority ----
209
-
210
- test("name: AGENT_NAME env takes precedence over template displayName", () => {
211
- const name = resolveAgentName("my-custom-name", "Coder", "worker", "abc12345-dead-beef");
212
- expect(name).toBe("my-custom-name");
213
- });
214
-
215
- test("name: template displayName used when AGENT_NAME not set", () => {
216
- const name = resolveAgentName(undefined, "Coder", "worker", "abc12345-dead-beef");
217
- expect(name).toBe("Coder");
218
- });
219
-
220
- test("name: falls back to role-id when no env name and no template", () => {
221
- const name = resolveAgentName(undefined, undefined, "worker", "abc12345-dead-beef");
222
- expect(name).toBe("worker-abc12345");
223
- });
224
-
225
- test("name: template role feeds into fallback name when role overridden", () => {
226
- // If template overrides role from "worker" to "coder", the fallback name uses the new role
227
- const name = resolveAgentName(undefined, undefined, "coder", "abc12345-dead-beef");
228
- expect(name).toBe("coder-abc12345");
229
- });
230
-
231
- // ---- role priority ----
232
-
233
- test("role: template role overrides generic 'worker' default", () => {
234
- let role = "worker";
235
- const configRole = "worker";
236
- const defaults = { role: "coder", capabilities: ["typescript"], maxTasks: 3 };
237
-
238
- if (configRole === "worker" && defaults.role) {
239
- role = defaults.role;
240
- }
241
-
242
- expect(role).toBe("coder");
243
- });
244
-
245
- test("role: explicit 'lead' config is NOT overridden by template", () => {
246
- let role = "lead";
247
- const configRole = "lead";
248
- const defaults = { role: "coder", capabilities: ["typescript"], maxTasks: 3 };
249
-
250
- if (configRole === "worker" && defaults.role) {
251
- role = defaults.role;
252
- }
253
-
254
- expect(role).toBe("lead");
255
- });
256
-
257
- test("role: stays 'worker' when template has no role", () => {
258
- let role = "worker";
259
- const configRole = "worker";
260
- const defaults = { role: "", capabilities: [], maxTasks: 1 };
261
-
262
- if (configRole === "worker" && defaults.role) {
263
- role = defaults.role;
264
- }
265
-
266
- expect(role).toBe("worker");
267
- });
268
-
269
- // ---- capabilities priority ----
270
-
271
- test("capabilities: template caps used when config has none", () => {
272
- let capabilities: string[] | undefined;
273
- const defaults = { capabilities: ["typescript", "react"] };
274
-
275
- if (!capabilities?.length && defaults.capabilities?.length) {
276
- capabilities = defaults.capabilities;
277
- }
278
-
279
- expect(capabilities).toEqual(["typescript", "react"]);
280
- });
281
-
282
- test("capabilities: config caps take precedence over template", () => {
283
- let capabilities: string[] | undefined = ["python", "django"];
284
- const defaults = { capabilities: ["typescript", "react"] };
285
-
286
- if (!capabilities?.length && defaults.capabilities?.length) {
287
- capabilities = defaults.capabilities;
288
- }
289
-
290
- expect(capabilities).toEqual(["python", "django"]);
291
- });
292
-
293
- test("capabilities: empty array config still gets template caps", () => {
294
- let capabilities: string[] | undefined = [];
295
- const defaults = { capabilities: ["typescript", "react"] };
296
-
297
- if (!capabilities?.length && defaults.capabilities?.length) {
298
- capabilities = defaults.capabilities;
299
- }
300
-
301
- expect(capabilities).toEqual(["typescript", "react"]);
302
- });
303
-
304
- // ---- maxTasks priority ----
305
-
306
- test("maxTasks: env var takes precedence over template and default", () => {
307
- const envMaxTasks = "5";
308
- const templateMaxTasks = 3;
309
- const defaultMaxTasks = 1;
310
-
311
- const maxConcurrent = envMaxTasks
312
- ? parseInt(envMaxTasks, 10)
313
- : (templateMaxTasks ?? defaultMaxTasks);
314
-
315
- expect(maxConcurrent).toBe(5);
316
- });
317
-
318
- test("maxTasks: template value used when env not set", () => {
319
- const envMaxTasks = "";
320
- const templateMaxTasks = 3;
321
- const defaultMaxTasks = 1;
322
-
323
- const maxConcurrent = envMaxTasks
324
- ? parseInt(envMaxTasks, 10)
325
- : (templateMaxTasks ?? defaultMaxTasks);
326
-
327
- expect(maxConcurrent).toBe(3);
328
- });
329
-
330
- test("maxTasks: hardcoded default used when no env and no template", () => {
331
- const envMaxTasks = "";
332
- const templateMaxTasks = undefined;
333
- const defaultMaxTasks = 1;
334
-
335
- const maxConcurrent = envMaxTasks
336
- ? parseInt(envMaxTasks, 10)
337
- : (templateMaxTasks ?? defaultMaxTasks);
338
-
339
- expect(maxConcurrent).toBe(1);
340
- });
341
-
342
- // ---- isLead priority ----
343
-
344
- test("isLead: config lead role takes precedence", () => {
345
- const configRole = "lead";
346
- const templateIsLead = false;
347
-
348
- const isLead = configRole === "lead" || (templateIsLead ?? false);
349
- expect(isLead).toBe(true);
350
- });
351
-
352
- test("isLead: template isLead=true used when config is worker", () => {
353
- const configRole = "worker";
354
- const templateIsLead = true;
355
-
356
- const isLead = configRole === "lead" || (templateIsLead ?? false);
357
- expect(isLead).toBe(true);
358
- });
359
-
360
- test("isLead: defaults to false when config is worker and template has no isLead", () => {
361
- const configRole = "worker";
362
- const templateIsLead = undefined;
363
-
364
- const isLead = configRole === "lead" || (templateIsLead ?? false);
365
- expect(isLead).toBe(false);
366
- });
367
-
368
- // ---- combined flow ----
369
-
370
- test("full flow: template with agentDefaults applies all fallbacks", () => {
371
- const configRole = "worker";
372
- const template: TemplateResponse = {
373
- ...mockTemplate,
374
- config: {
375
- ...mockTemplate.config,
376
- displayName: "Research Assistant",
377
- agentDefaults: {
378
- role: "researcher",
379
- capabilities: ["web-search", "analysis"],
380
- maxTasks: 4,
381
- isLead: false,
382
- },
383
- },
384
- };
385
-
386
- // Apply role
387
- let role = configRole;
388
- if (configRole === "worker" && template.config.agentDefaults.role) {
389
- role = template.config.agentDefaults.role;
390
- }
391
-
392
- // Apply capabilities
393
- let capabilities: string[] | undefined;
394
- const defaults = template.config.agentDefaults;
395
- if (!capabilities?.length && defaults.capabilities?.length) {
396
- capabilities = defaults.capabilities;
397
- }
398
-
399
- // Apply maxTasks (no env var)
400
- const maxConcurrent = defaults.maxTasks ?? 1;
401
-
402
- // Apply isLead
403
- const isLead = configRole === "lead" || (defaults.isLead ?? false);
404
-
405
- // Apply name
406
- const agentName = resolveAgentName(undefined, template.config.displayName, role, "abc12345");
407
-
408
- expect(role).toBe("researcher");
409
- expect(capabilities).toEqual(["web-search", "analysis"]);
410
- expect(maxConcurrent).toBe(4);
411
- expect(isLead).toBe(false);
412
- expect(agentName).toBe("Research Assistant");
413
- });
414
-
415
- test("full flow: env/config overrides beat template defaults", () => {
416
- const configRole = "lead";
417
- const template: TemplateResponse = {
418
- ...mockTemplate,
419
- config: {
420
- ...mockTemplate.config,
421
- displayName: "Coder",
422
- agentDefaults: {
423
- role: "coder",
424
- capabilities: ["typescript"],
425
- maxTasks: 3,
426
- isLead: false,
427
- },
428
- },
429
- };
430
-
431
- // Apply role — lead is NOT overridden
432
- let role = configRole;
433
- if (configRole === "worker" && template.config.agentDefaults.role) {
434
- role = template.config.agentDefaults.role;
435
- }
436
-
437
- // Config capabilities take precedence
438
- let capabilities: string[] | undefined = ["python"];
439
- const defaults = template.config.agentDefaults;
440
- if (!capabilities?.length && defaults.capabilities?.length) {
441
- capabilities = defaults.capabilities;
442
- }
443
-
444
- // Env var takes precedence for maxTasks
445
- const envMaxTasks = "10";
446
- const maxConcurrent = envMaxTasks ? parseInt(envMaxTasks, 10) : (defaults.maxTasks ?? 1);
447
-
448
- // isLead from config role
449
- const isLead = configRole === "lead" || (defaults.isLead ?? false);
450
-
451
- // AGENT_NAME takes precedence
452
- const agentName = resolveAgentName("my-lead", template.config.displayName, role, "abc12345");
453
-
454
- expect(role).toBe("lead");
455
- expect(capabilities).toEqual(["python"]);
456
- expect(maxConcurrent).toBe(10);
457
- expect(isLead).toBe(true);
458
- expect(agentName).toBe("my-lead");
459
- });
460
-
461
- test("full flow: no template — all values use config/hardcoded defaults", () => {
462
- const configRole = "worker";
463
- const cachedTemplate: TemplateResponse | null = null;
464
-
465
- let role = configRole;
466
- let capabilities: string[] | undefined;
467
-
468
- if (cachedTemplate?.config.agentDefaults) {
469
- const defaults = cachedTemplate.config.agentDefaults;
470
- if (configRole === "worker" && defaults.role) role = defaults.role;
471
- if (!capabilities?.length && defaults.capabilities?.length)
472
- capabilities = defaults.capabilities;
473
- }
474
-
475
- const isLead = configRole === "lead" || (cachedTemplate?.config.agentDefaults?.isLead ?? false);
476
- const maxConcurrent = cachedTemplate?.config.agentDefaults?.maxTasks ?? (isLead ? 2 : 1);
477
- const agentName = resolveAgentName(
478
- undefined,
479
- cachedTemplate?.config.displayName,
480
- role,
481
- "abc12345",
482
- );
483
-
484
- expect(role).toBe("worker");
485
- expect(capabilities).toBeUndefined();
486
- expect(maxConcurrent).toBe(1);
487
- expect(isLead).toBe(false);
488
- expect(agentName).toBe("worker-abc12345");
489
- });
490
- });