@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,155 +0,0 @@
1
- import { describe, expect, test } from "bun:test";
2
- import { renderPageThemeCss, resolvePageTheme } from "../themes/page-theme";
3
- import { getThemePreset } from "../themes/presets";
4
- import { HIVE_PAGE_TOKENS, PAGE_THEME_TOKENS } from "../themes/tokens";
5
-
6
- const github = getThemePreset("github");
7
- const paper = getThemePreset("paper");
8
-
9
- /** The body of the first block that starts with `selector {`. */
10
- function blockBody(css: string, selector: string): string {
11
- const start = css.indexOf(`${selector} {\n`);
12
- if (start === -1) return "";
13
- return css.slice(start, css.indexOf("\n}", start));
14
- }
15
-
16
- describe("resolvePageTheme", () => {
17
- test("with no page theme and no viewer theme it is Hive", () => {
18
- const theme = resolvePageTheme({});
19
- expect(theme.presetId).toBe("hive");
20
- expect(theme.light).toEqual(HIVE_PAGE_TOKENS.light);
21
- expect(theme.dark).toEqual(HIVE_PAGE_TOKENS.dark);
22
- expect(resolvePageTheme({ pageTheme: null, viewerTheme: null, overrides: null })).toEqual(
23
- theme,
24
- );
25
- });
26
-
27
- test("a known viewer theme applies when the page has no theme", () => {
28
- const theme = resolvePageTheme({ pageTheme: null, viewerTheme: "github" });
29
- expect(theme.presetId).toBe("github");
30
- expect(theme.light["--color-primary"]).toBe(github?.vars.light["--color-primary"] ?? "");
31
- expect(theme.dark["--color-background"]).toBe(github?.vars.dark["--color-background"] ?? "");
32
- expect(theme.light["--color-status-error"]).toBe(
33
- github?.vars.light["--color-status-error"] ?? "",
34
- );
35
- // Tokens the preset leaves alone keep the Hive value.
36
- expect(theme.light["--color-destructive"]).toBe(HIVE_PAGE_TOKENS.light["--color-destructive"]);
37
- expect(theme.light["--font-sans"]).toBe(HIVE_PAGE_TOKENS.light["--font-sans"]);
38
- });
39
-
40
- test("only contract keys come from the preset", () => {
41
- const theme = resolvePageTheme({ viewerTheme: "github" });
42
- expect(Object.keys(theme.light).sort()).toEqual([...PAGE_THEME_TOKENS].sort());
43
- expect(Object.keys(theme.dark).sort()).toEqual([...PAGE_THEME_TOKENS].sort());
44
- expect(Object.keys(theme.light)).not.toContain("--color-sidebar");
45
- });
46
-
47
- test("the page theme wins over the viewer theme", () => {
48
- const theme = resolvePageTheme({ pageTheme: "paper", viewerTheme: "github" });
49
- expect(theme.presetId).toBe("paper");
50
- expect(theme.light["--color-background"]).toBe(paper?.vars.light["--color-background"] ?? "");
51
- expect(theme.dark["--color-primary"]).toBe(paper?.vars.dark["--color-primary"] ?? "");
52
- });
53
-
54
- test("an explicit hive page theme ignores the viewer theme", () => {
55
- const theme = resolvePageTheme({ pageTheme: "hive", viewerTheme: "github" });
56
- expect(theme.presetId).toBe("hive");
57
- expect(theme.light).toEqual(HIVE_PAGE_TOKENS.light);
58
- });
59
-
60
- test("an unknown viewer theme falls back to Hive", () => {
61
- const theme = resolvePageTheme({ viewerTheme: "not-a-preset" });
62
- expect(theme.presetId).toBe("hive");
63
- expect(theme.light).toEqual(HIVE_PAGE_TOKENS.light);
64
- });
65
-
66
- test("an unknown page theme is treated as no page theme", () => {
67
- expect(resolvePageTheme({ pageTheme: "gone", viewerTheme: "github" }).presetId).toBe("github");
68
- expect(resolvePageTheme({ pageTheme: "gone" }).presetId).toBe("hive");
69
- });
70
-
71
- test("overrides apply on top of the preset, per mode", () => {
72
- const theme = resolvePageTheme({
73
- pageTheme: "paper",
74
- overrides: {
75
- light: { "--color-primary": "oklch(0.5 0.2 30)" },
76
- dark: { "--color-primary": "oklch(0.7 0.15 30)" },
77
- },
78
- });
79
- expect(theme.light["--color-primary"]).toBe("oklch(0.5 0.2 30)");
80
- expect(theme.dark["--color-primary"]).toBe("oklch(0.7 0.15 30)");
81
- expect(theme.light["--color-background"]).toBe(paper?.vars.light["--color-background"] ?? "");
82
- });
83
-
84
- test("a color override set only in light does not reach dark", () => {
85
- const theme = resolvePageTheme({
86
- overrides: { light: { "--color-primary": "oklch(0.5 0.2 30)" }, dark: {} },
87
- });
88
- expect(theme.light["--color-primary"]).toBe("oklch(0.5 0.2 30)");
89
- expect(theme.dark["--color-primary"]).toBe(HIVE_PAGE_TOKENS.dark["--color-primary"]);
90
- });
91
-
92
- test("a shared override set only in light reaches dark, and a dark one wins in dark", () => {
93
- const theme = resolvePageTheme({
94
- overrides: {
95
- light: { "--font-sans": "Inter, sans-serif", "--radius-lg": "1rem" },
96
- dark: { "--radius-lg": "0.25rem" },
97
- },
98
- });
99
- expect(theme.light["--font-sans"]).toBe("Inter, sans-serif");
100
- expect(theme.dark["--font-sans"]).toBe("Inter, sans-serif");
101
- expect(theme.light["--radius-lg"]).toBe("1rem");
102
- expect(theme.dark["--radius-lg"]).toBe("0.25rem");
103
- });
104
-
105
- test("override keys outside the contract drop out", () => {
106
- const theme = resolvePageTheme({
107
- overrides: { light: { "--color-sidebar": "red", "--color-card": "white" }, dark: {} },
108
- });
109
- expect(Object.keys(theme.light)).not.toContain("--color-sidebar");
110
- expect(theme.light["--color-card"]).toBe("white");
111
- });
112
- });
113
-
114
- describe("renderPageThemeCss", () => {
115
- const theme = resolvePageTheme({
116
- pageTheme: "paper",
117
- overrides: { light: { "--color-primary": "oklch(0.5 0.2 30)" }, dark: {} },
118
- });
119
- const css = renderPageThemeCss(theme);
120
-
121
- test("has the light root, the dark root and the print block, unlayered", () => {
122
- expect(css).toContain(":root {\n color-scheme: light;");
123
- expect(css).toContain(":root.dark {\n color-scheme: dark;");
124
- expect(css).toContain("@media print {\n :root.dark {\n color-scheme: light;");
125
- expect(css).not.toContain("@layer");
126
- expect(css.indexOf(":root {")).toBeLessThan(css.indexOf(":root.dark {"));
127
- expect(css.indexOf(":root.dark {")).toBeLessThan(css.indexOf("@media print"));
128
- });
129
-
130
- test("declares every contract token in each block", () => {
131
- const light = blockBody(css, ":root");
132
- const dark = blockBody(css, ":root.dark");
133
- const print = css.slice(css.indexOf("@media print"));
134
- for (const token of PAGE_THEME_TOKENS) {
135
- expect(light).toContain(` ${token}: ${theme.light[token]};`);
136
- expect(dark).toContain(` ${token}: ${theme.dark[token]};`);
137
- expect(print).toContain(` ${token}: ${theme.light[token]};`);
138
- }
139
- expect(light).toContain("--color-primary: oklch(0.5 0.2 30);");
140
- });
141
-
142
- test("puts the --swarm-* aliases in :root only", () => {
143
- const aliases = [
144
- "--swarm-bg: var(--color-background);",
145
- "--swarm-card: var(--color-card);",
146
- "--swarm-border: var(--color-border);",
147
- "--swarm-text: var(--color-foreground);",
148
- "--swarm-muted: var(--color-muted-foreground);",
149
- "--swarm-primary: var(--color-primary);",
150
- ];
151
- const light = blockBody(css, ":root");
152
- for (const alias of aliases) expect(light).toContain(alias);
153
- expect(css.slice(css.indexOf(":root.dark {"))).not.toContain("--swarm-");
154
- });
155
- });
@@ -1,442 +0,0 @@
1
- import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
- import { unlink } from "node:fs/promises";
3
- import { closeDb, initDb } from "../be/db";
4
- import { SDK_TOOL_NAME_MAP } from "../scripts-runtime/sdk-allowlist";
5
- import { isReadOnlyBridgeCall } from "../scripts-runtime/swarm-sdk";
6
- import { createServer } from "../server";
7
- import { ALL_TOOLS, CORE_TOOLS, DEFERRED_TOOLS } from "../tools/tool-config";
8
-
9
- const TEST_DB_PATH = "./test-tool-annotations.sqlite";
10
-
11
- /**
12
- * Access registered tools from the MCP server.
13
- * _registeredTools is private, so we cast through `any`.
14
- */
15
- function getRegisteredTools(server: Awaited<ReturnType<typeof createServer>>) {
16
- const tools = (server as unknown as { _registeredTools: Record<string, RegisteredTool> })
17
- ._registeredTools;
18
- return tools;
19
- }
20
-
21
- type RegisteredTool = {
22
- title?: string;
23
- description?: string;
24
- annotations?: {
25
- readOnlyHint?: boolean;
26
- destructiveHint?: boolean;
27
- idempotentHint?: boolean;
28
- openWorldHint?: boolean;
29
- };
30
- enabled: boolean;
31
- };
32
-
33
- describe("Tool Annotations & Classification", () => {
34
- let server: Awaited<ReturnType<typeof createServer>>;
35
- let tools: Record<string, RegisteredTool>;
36
-
37
- beforeAll(async () => {
38
- for (const suffix of ["", "-wal", "-shm"]) {
39
- try {
40
- await unlink(TEST_DB_PATH + suffix);
41
- } catch {
42
- // File doesn't exist
43
- }
44
- }
45
- initDb(TEST_DB_PATH);
46
- // Tier classification (core vs deferred) spans every tool, including ones
47
- // behind default-disabled capabilities — build the full-surface server.
48
- const previousSteeringEnabled = process.env.STEERING_ENABLED;
49
- process.env.STEERING_ENABLED = "true";
50
- try {
51
- server = await createServer({ fullSurface: true, scriptsOnly: false });
52
- tools = getRegisteredTools(server);
53
- } finally {
54
- if (previousSteeringEnabled === undefined) delete process.env.STEERING_ENABLED;
55
- else process.env.STEERING_ENABLED = previousSteeringEnabled;
56
- }
57
- });
58
-
59
- afterAll(async () => {
60
- closeDb();
61
- for (const suffix of ["", "-wal", "-shm"]) {
62
- try {
63
- await unlink(TEST_DB_PATH + suffix);
64
- } catch {
65
- // ignore
66
- }
67
- }
68
- });
69
-
70
- // === Annotation Completeness ===
71
-
72
- test("every registered tool has annotations set", () => {
73
- const toolNames = Object.keys(tools);
74
- const missingAnnotations: string[] = [];
75
-
76
- for (const name of toolNames) {
77
- if (!tools[name].annotations) {
78
- missingAnnotations.push(name);
79
- }
80
- }
81
-
82
- expect(missingAnnotations).toEqual([]);
83
- });
84
-
85
- test("every registered tool has a title", () => {
86
- const toolNames = Object.keys(tools);
87
- const missingTitle: string[] = [];
88
-
89
- for (const name of toolNames) {
90
- if (!tools[name].title) {
91
- missingTitle.push(name);
92
- }
93
- }
94
-
95
- expect(missingTitle).toEqual([]);
96
- });
97
-
98
- test("every registered tool has a description", () => {
99
- const toolNames = Object.keys(tools);
100
- const missingDesc: string[] = [];
101
-
102
- for (const name of toolNames) {
103
- if (!tools[name].description) {
104
- missingDesc.push(name);
105
- }
106
- }
107
-
108
- expect(missingDesc).toEqual([]);
109
- });
110
-
111
- // === Annotation Correctness ===
112
-
113
- test("destructive tools have destructiveHint: true", () => {
114
- const expectedDestructive = [
115
- "cancel-task",
116
- "delete-channel",
117
- "delete-schedule",
118
- "delete-config",
119
- "delete-workflow",
120
- "delete-page",
121
- "slack-delete",
122
- "slack-archive-channel",
123
- ];
124
-
125
- for (const name of expectedDestructive) {
126
- if (tools[name]) {
127
- expect(tools[name].annotations?.destructiveHint).toBe(true);
128
- }
129
- }
130
- });
131
-
132
- test("read-only tools have readOnlyHint: true", () => {
133
- const expectedReadOnly = [
134
- "get-swarm",
135
- "get-task-details",
136
- "get-tasks",
137
- "get-config",
138
- "list-channels",
139
- "list-schedules",
140
- "list-config",
141
- "memory-get",
142
- "my-agent-info",
143
- "poll-task",
144
- "read-messages",
145
- "context-history",
146
- "context-diff",
147
- ];
148
-
149
- for (const name of expectedReadOnly) {
150
- if (tools[name]) {
151
- expect(tools[name].annotations?.readOnlyHint).toBe(true);
152
- }
153
- }
154
- });
155
-
156
- test("memory-search is not read-only because it records access telemetry", () => {
157
- expect(tools["memory-search"]?.annotations?.readOnlyHint).toBe(false);
158
- });
159
-
160
- test("no tool has both readOnlyHint and destructiveHint set to true", () => {
161
- const contradictions: string[] = [];
162
-
163
- for (const [name, tool] of Object.entries(tools)) {
164
- if (tool.annotations?.readOnlyHint === true && tool.annotations?.destructiveHint === true) {
165
- contradictions.push(name);
166
- }
167
- }
168
-
169
- expect(contradictions).toEqual([]);
170
- });
171
-
172
- test("Slack integration tools have openWorldHint: true", () => {
173
- const slackTools = [
174
- "slack-reply",
175
- "slack-read",
176
- "slack-post",
177
- "slack-start-thread",
178
- "slack-create-channel",
179
- "slack-invite-to-channel",
180
- "slack-archive-channel",
181
- "slack-upload-file",
182
- "slack-download-file",
183
- "slack-list-channels",
184
- "slack-delete",
185
- "slack-update",
186
- "slack-leave-thread",
187
- ];
188
-
189
- for (const name of slackTools) {
190
- if (tools[name]) {
191
- expect(tools[name].annotations?.openWorldHint).toBe(true);
192
- }
193
- }
194
- });
195
-
196
- // === Core vs Deferred Classification ===
197
-
198
- test("CORE_TOOLS and DEFERRED_TOOLS have no overlap", () => {
199
- const overlap = [...CORE_TOOLS].filter((t) => DEFERRED_TOOLS.has(t));
200
- expect(overlap).toEqual([]);
201
- });
202
-
203
- test("CORE_TOOLS contains exactly 26 tools", () => {
204
- expect(CORE_TOOLS.size).toBe(26);
205
- });
206
-
207
- test("ALL_TOOLS equals CORE_TOOLS union DEFERRED_TOOLS", () => {
208
- const union = new Set([...CORE_TOOLS, ...DEFERRED_TOOLS]);
209
- expect(ALL_TOOLS.size).toBe(union.size);
210
- for (const tool of ALL_TOOLS) {
211
- expect(union.has(tool)).toBe(true);
212
- }
213
- });
214
-
215
- test("every registered tool is classified as either core or deferred", () => {
216
- const toolNames = Object.keys(tools);
217
- const unclassified: string[] = [];
218
-
219
- for (const name of toolNames) {
220
- if (!ALL_TOOLS.has(name)) {
221
- unclassified.push(name);
222
- }
223
- }
224
-
225
- expect(unclassified).toEqual([]);
226
- });
227
-
228
- test("all core tools are registered in the server", () => {
229
- const toolNames = new Set(Object.keys(tools));
230
- const missingCore: string[] = [];
231
-
232
- for (const name of CORE_TOOLS) {
233
- if (!toolNames.has(name)) {
234
- missingCore.push(name);
235
- }
236
- }
237
-
238
- expect(missingCore).toEqual([]);
239
- });
240
-
241
- test("core tools include essential session bootstrap tools", () => {
242
- const bootstrapTools = ["join-swarm", "my-agent-info", "poll-task"];
243
- for (const tool of bootstrapTools) {
244
- expect(CORE_TOOLS.has(tool)).toBe(true);
245
- }
246
- });
247
-
248
- test("core tools include essential task lifecycle tools", () => {
249
- const lifecycleTools = [
250
- "get-task-details",
251
- "store-progress",
252
- "task-action",
253
- "send-task",
254
- "get-tasks",
255
- "defer-task",
256
- ];
257
- for (const tool of lifecycleTools) {
258
- expect(CORE_TOOLS.has(tool)).toBe(true);
259
- }
260
- });
261
-
262
- test("deprecated swarm messaging tools are deferred, not core", () => {
263
- const commTools = ["read-messages", "post-message"];
264
- for (const tool of commTools) {
265
- expect(CORE_TOOLS.has(tool)).toBe(false);
266
- expect(DEFERRED_TOOLS.has(tool)).toBe(true);
267
- }
268
- });
269
-
270
- test("core tools include memory tools", () => {
271
- const memTools = ["memory-search", "memory-get", "memory-store"];
272
- for (const tool of memTools) {
273
- expect(CORE_TOOLS.has(tool)).toBe(true);
274
- }
275
- });
276
-
277
- test("core tools include prevalent fleet operations", () => {
278
- const frequentTools = [
279
- "script-run",
280
- "db-query",
281
- "kv-get",
282
- "script-query-types",
283
- "get-repos",
284
- "accept-steer",
285
- "memory-edit",
286
- "script-search",
287
- "steer-task",
288
- "kv-list",
289
- "get-config",
290
- ];
291
- for (const tool of frequentTools) {
292
- expect(CORE_TOOLS.has(tool)).toBe(true);
293
- expect(DEFERRED_TOOLS.has(tool)).toBe(false);
294
- }
295
- });
296
-
297
- test("Slack tools stay deferred for task-context gating", () => {
298
- for (const tool of ALL_TOOLS) {
299
- if (!tool.startsWith("slack-")) continue;
300
- expect(CORE_TOOLS.has(tool)).toBe(false);
301
- expect(DEFERRED_TOOLS.has(tool)).toBe(true);
302
- }
303
- });
304
-
305
- test("scheduling tools are all deferred", () => {
306
- const scheduleTools = [
307
- "list-schedules",
308
- "create-schedule",
309
- "update-schedule",
310
- "patch-schedule",
311
- "delete-schedule",
312
- "run-schedule-now",
313
- ];
314
- for (const tool of scheduleTools) {
315
- expect(DEFERRED_TOOLS.has(tool)).toBe(true);
316
- }
317
- });
318
-
319
- test("workflow tools are all deferred", () => {
320
- const workflowTools = [
321
- "create-workflow",
322
- "list-workflows",
323
- "get-workflow",
324
- "update-workflow",
325
- "delete-workflow",
326
- "trigger-workflow",
327
- "list-workflow-runs",
328
- "get-workflow-run",
329
- "retry-workflow-run",
330
- "cancel-workflow-run",
331
- ];
332
- for (const tool of workflowTools) {
333
- expect(DEFERRED_TOOLS.has(tool)).toBe(true);
334
- }
335
- });
336
-
337
- test("all 10 workflow tools are registered in the server", () => {
338
- const workflowTools = [
339
- "create-workflow",
340
- "list-workflows",
341
- "get-workflow",
342
- "update-workflow",
343
- "delete-workflow",
344
- "trigger-workflow",
345
- "list-workflow-runs",
346
- "get-workflow-run",
347
- "retry-workflow-run",
348
- "cancel-workflow-run",
349
- ];
350
- const missing = workflowTools.filter((t) => !tools[t]);
351
- expect(missing).toEqual([]);
352
- });
353
-
354
- test("the removed PM2 service registry tools stay gone", () => {
355
- const serviceTools = [
356
- "register-service",
357
- "unregister-service",
358
- "list-services",
359
- "update-service-status",
360
- ];
361
- for (const tool of serviceTools) {
362
- expect(DEFERRED_TOOLS.has(tool)).toBe(false);
363
- expect(tools[tool]).toBeUndefined();
364
- }
365
- });
366
-
367
- test("config tools other than get-config are deferred", () => {
368
- const configTools = ["set-config", "list-config", "delete-config"];
369
- for (const tool of configTools) {
370
- expect(DEFERRED_TOOLS.has(tool)).toBe(true);
371
- }
372
- });
373
-
374
- // === Token Impact Estimation ===
375
-
376
- test("registered tool count matches expected total", () => {
377
- const count = Object.keys(tools).length;
378
- // We expect all tools to be registered when all capabilities are enabled
379
- // (this suite forces ALL_CAPABILITIES, including default-disabled ones).
380
- // Includes 11 skill tools, 7 MCP server tools, reusable script tools, and the
381
- // native Kapso/WhatsApp tools (register/unregister number + send/reply message),
382
- // the six Chat SDK tools (chat-* + register/unregister-chat-channel),
383
- // and the seven app row tools plus app-action-run.
384
- expect(count).toBeGreaterThanOrEqual(45);
385
- expect(count).toBeLessThanOrEqual(176);
386
- });
387
-
388
- test("core tools are fewer than deferred tools", () => {
389
- expect(CORE_TOOLS.size).toBeLessThan(DEFERRED_TOOLS.size);
390
- });
391
-
392
- // === Annotation Coverage Statistics ===
393
-
394
- test("annotation breakdown is reasonable", () => {
395
- const toolEntries = Object.entries(tools);
396
- let readOnly = 0;
397
- let destructive = 0;
398
- let idempotent = 0;
399
- let openWorld = 0;
400
-
401
- for (const [, tool] of toolEntries) {
402
- if (tool.annotations?.readOnlyHint) readOnly++;
403
- if (tool.annotations?.destructiveHint) destructive++;
404
- if (tool.annotations?.idempotentHint) idempotent++;
405
- if (tool.annotations?.openWorldHint) openWorld++;
406
- }
407
-
408
- // Most tools should have at least one hint set
409
- expect(readOnly).toBeGreaterThan(15); // many read-only tools
410
- expect(destructive).toBeGreaterThanOrEqual(5); // delete-* tools
411
- expect(idempotent).toBeGreaterThanOrEqual(5); // update/register tools
412
- expect(openWorld).toBeGreaterThanOrEqual(3); // Slack tools
413
- });
414
-
415
- // === ctx.swarm bridge retry classification ===
416
- // The bridge retries a 5xx or network error only for reads. Its read list is
417
- // hand-kept, so cross-check it against the tool annotations both ways. The
418
- // generic bridge sends every call as POST, the strictest case.
419
- // poll-task is annotated read-only but claims work, so it must not repeat.
420
- const READ_ANNOTATED_BUT_WRITES = new Set(["task_poll"]);
421
-
422
- test("every read-only SDK method retries as a read on the ctx.swarm bridge", () => {
423
- const missing = Object.entries(SDK_TOOL_NAME_MAP)
424
- .filter(([, tool]) => tools[tool]?.annotations?.readOnlyHint === true)
425
- .filter(([method]) => !READ_ANNOTATED_BUT_WRITES.has(method))
426
- .filter(([method]) => !isReadOnlyBridgeCall(method, "POST"))
427
- .map(([method]) => method);
428
- expect(missing).toEqual([]);
429
- for (const method of READ_ANNOTATED_BUT_WRITES) {
430
- expect(isReadOnlyBridgeCall(method, "POST")).toBe(false);
431
- expect(isReadOnlyBridgeCall(method, "GET")).toBe(false);
432
- }
433
- });
434
-
435
- test("no SDK method the bridge repeats as a read is annotated as a write", () => {
436
- const writes = Object.entries(SDK_TOOL_NAME_MAP)
437
- .filter(([method]) => isReadOnlyBridgeCall(method, "POST"))
438
- .filter(([, tool]) => tools[tool]?.annotations?.destructiveHint === true)
439
- .map(([method]) => method);
440
- expect(writes).toEqual([]);
441
- });
442
- });