@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
@@ -2,13 +2,14 @@ import { getDbClient, getWorkflow, updateWorkflow } from "../be/db";
2
2
  import type { Workflow, WorkflowDefinition, WorkflowPatch } from "../types";
3
3
  import { applyDefinitionPatch, definitionNodeIds, validateDefinition } from "./definition";
4
4
  import type { ExecutorRegistry } from "./executors/registry";
5
+ import { serverRefInputDeniedMessage, serverRefInputKeys } from "./input";
5
6
  import { workflowModelErrors } from "./model-validation";
6
7
  import { snapshotWorkflow } from "./version";
7
8
 
8
9
  export type PatchWorkflowDefinitionResult =
9
10
  | { ok: true; workflow: Workflow; version: number | null; definition: WorkflowDefinition }
10
11
  | { ok: false; reason: "not_found" }
11
- | { ok: false; reason: "patch" | "invalid"; errors: string[] };
12
+ | { ok: false; reason: "patch" | "invalid" | "forbidden"; errors: string[] };
12
13
 
13
14
  /**
14
15
  * Read a workflow, merge a node patch into its definition, snapshot the
@@ -36,12 +37,26 @@ export async function patchWorkflowDefinition(options: {
36
37
  /** HTTP handlers keep updating when the snapshot fails; tools surface it. */
37
38
  snapshotOptional?: boolean;
38
39
  updates?: Omit<Parameters<typeof updateWorkflow>[1], "definition">;
40
+ /**
41
+ * False when the caller lacks `config.read.secrets`. A workflow whose input
42
+ * holds `${ENV_VAR}` / `secret.NAME` references, stored or rendered from its
43
+ * (new) params, then refuses the patch, since a node or params edit decides
44
+ * where those resolved values go.
45
+ */
46
+ serverRefInputAllowed?: boolean;
39
47
  }): Promise<PatchWorkflowDefinitionResult> {
40
48
  const { id, patch, registry, snapshotAgentId, snapshotOptional, updates } = options;
41
49
  return await getDbClient().transaction(async (): Promise<PatchWorkflowDefinitionResult> => {
42
50
  const existing = await getWorkflow(id);
43
51
  if (!existing) return { ok: false, reason: "not_found" };
44
52
 
53
+ if (options.serverRefInputAllowed === false) {
54
+ const refKeys = serverRefInputKeys(existing.input, updates?.params ?? existing.params);
55
+ if (refKeys.length > 0) {
56
+ return { ok: false, reason: "forbidden", errors: [serverRefInputDeniedMessage(refKeys)] };
57
+ }
58
+ }
59
+
45
60
  const patchResult = applyDefinitionPatch(existing.definition, patch);
46
61
  if (patchResult.errors.length > 0) {
47
62
  return { ok: false, reason: "patch", errors: patchResult.errors };
@@ -71,7 +86,14 @@ export async function patchWorkflowDefinition(options: {
71
86
  version = (await snapshotWorkflow(id, snapshotAgentId)).version;
72
87
  }
73
88
 
74
- const workflow = await updateWorkflow(id, { ...updates, definition: patchResult.definition });
89
+ // Every caller is a user-intent write: record the pair for this write
90
+ // (person null = unknown), never a previous writer's person.
91
+ const workflow = await updateWorkflow(id, {
92
+ ...updates,
93
+ definition: patchResult.definition,
94
+ updatedBy: updates?.updatedBy ?? null,
95
+ updatedByAgentId: snapshotAgentId ?? null,
96
+ });
75
97
  if (!workflow) return { ok: false, reason: "not_found" };
76
98
 
77
99
  return { ok: true, workflow, version, definition: patchResult.definition };
@@ -27,7 +27,7 @@ import { FOREACH_ITEMS_WAIT_FOR, parkAndDriveForeach, runForeachDrive } from "./
27
27
  import { resolveForeachParent } from "./foreach-join";
28
28
  import { rebuildNodeExecutionInput } from "./step-input";
29
29
  import { hasOwedSuccessors } from "./successor-routing";
30
- import { runStepValidation } from "./validation";
30
+ import { runStepValidation, validateOutputSchema } from "./validation";
31
31
 
32
32
  let pollerTimeout: ReturnType<typeof setTimeout> | null = null;
33
33
  /** Bumped by every stop, so a tick in flight can tell that its poller was stopped. */
@@ -191,7 +191,20 @@ export function startRetryPoller(registry: ExecutorRegistry, intervalMs = 5000):
191
191
  await resumeFromChildRun(step.id, registry);
192
192
  }
193
193
  } else {
194
- // Success! Re-run validation if configured before checkpointing.
194
+ const outputSchemaError = validateOutputSchema(node, result);
195
+ if (outputSchemaError) {
196
+ await checkpointStepFailure(
197
+ run.id,
198
+ step.id,
199
+ outputSchemaError,
200
+ step.retryCount,
201
+ undefined,
202
+ { fence },
203
+ );
204
+ continue;
205
+ }
206
+
207
+ // Re-run validation if configured before checkpointing.
195
208
  let validationPassed: boolean | undefined;
196
209
  if (node.validation) {
197
210
  const validationResult = await runStepValidation(
@@ -136,6 +136,9 @@ export async function verifyWebhookRequest(
136
136
  case "hmac-sha256":
137
137
  isValid = verifyHmacSignature(secret, rawBody, signature);
138
138
  break;
139
+ case "hmac-sha1":
140
+ isValid = verifyHmacSignature(secret, rawBody, signature, "sha1");
141
+ break;
139
142
  case "timestamped-hmac-sha256":
140
143
  isValid = verifyTimestampedHmacSignature(secret, rawBody, signature, {
141
144
  timestampKey: verification.timestampKey,
@@ -354,21 +357,23 @@ export async function handleScheduleTrigger(
354
357
  }
355
358
 
356
359
  /**
357
- * Verify HMAC-SHA256 signature.
358
- * Supports both `sha256=<hex>` format and raw hex.
360
+ * Verify an HMAC signature (SHA-256 by default, SHA-1 for senders such as Vercel).
361
+ * Supports both `<algorithm>=<hex>` format and raw hex.
359
362
  */
360
363
  export function verifyHmacSignature(
361
364
  secret: string,
362
365
  body: string,
363
366
  providedSignature: string,
367
+ algorithm: "sha256" | "sha1" = "sha256",
364
368
  ): boolean {
365
- const hmac = crypto.createHmac("sha256", secret);
369
+ const hmac = crypto.createHmac(algorithm, secret);
366
370
  hmac.update(body);
367
371
  const expectedHex = hmac.digest("hex");
368
372
 
369
- // Support "sha256=<hex>" format (GitHub-style)
370
- const normalizedProvided = providedSignature.startsWith("sha256=")
371
- ? providedSignature.slice(7)
373
+ // Support "sha256=<hex>" / "sha1=<hex>" format (GitHub-style)
374
+ const prefix = `${algorithm}=`;
375
+ const normalizedProvided = providedSignature.startsWith(prefix)
376
+ ? providedSignature.slice(prefix.length)
372
377
  : providedSignature;
373
378
 
374
379
  // Constant-time comparison
@@ -1,5 +1,15 @@
1
1
  import type { ExecutorMeta, WorkflowNode } from "../types";
2
+ import type { ExecutorResult } from "./executors/base";
2
3
  import type { ExecutorRegistry } from "./executors/registry";
4
+ import { validateJsonSchema } from "./json-schema-validator";
5
+
6
+ /** Validate successful output before step validation or checkpointing. */
7
+ export function validateOutputSchema(node: WorkflowNode, result: ExecutorResult): string | null {
8
+ if (!node.outputSchema || result.status !== "success") return null;
9
+
10
+ const errors = validateJsonSchema(node.outputSchema as Record<string, unknown>, result.output);
11
+ return errors.length > 0 ? `Output schema validation failed: ${errors.join("; ")}` : null;
12
+ }
3
13
 
4
14
  export type ValidationOutcome = "pass" | "halt" | "retry";
5
15
 
@@ -95,7 +95,13 @@ export async function snapshotAndUpdateWorkflow(
95
95
  } else {
96
96
  version = await snapshotWorkflow(workflowId, opts.changedByAgentId);
97
97
  }
98
- const workflow = await updateWorkflow(workflowId, updates);
98
+ // Every caller is a user-intent write: record the pair for this write
99
+ // (person null = unknown), never a previous writer's person.
100
+ const workflow = await updateWorkflow(workflowId, {
101
+ ...updates,
102
+ updatedBy: updates.updatedBy ?? null,
103
+ updatedByAgentId: opts.changedByAgentId ?? null,
104
+ });
99
105
  return { workflow, version };
100
106
  });
101
107
  }
@@ -60,7 +60,7 @@
60
60
  "templates/skills/tackle-gh-comments/content.md": "5aff640173081dc5b965d023f2d53526a57ad5135229ac46eb248b496675eb34",
61
61
  "templates/skills/tackle-gh-comments/files/scripts/gh-pr-comments.ts": "85efca9bea5899ddf54fdb24586547f70939be43587d3137406b362fc51ba240",
62
62
  "templates/skills/tdd-planning/config.json": "d03fce2559b03f02ba962d9d79c6363238380ba7a89a1e2ebe316cbe9b6b4616",
63
- "templates/skills/tdd-planning/content.md": "87808dca0db0b224ac9dcb3722805fd61f64f6bde033847de3ec14ad3584d8ca",
63
+ "templates/skills/tdd-planning/content.md": "00f04fe2e44af076acb13988cdcba30aeb76e8f01f027b8f2cc4970a09915552",
64
64
  "templates/skills/tdd-planning/files/template.md": "61f0f6aad195067b1f13289f02523f5ef606ed33f22db94bda923dcd0bd0674c",
65
65
  "templates/skills/v-implementing/config.json": "e11fb54b78bebeb32a43c8ac92bd6754114445018fcfb2014d6c69691764574c",
66
66
  "templates/skills/v-implementing/content.md": "0d24db3e54bd6836766005d756512aa5f5af19108fb39889d33f4dbadf1ac455",
@@ -41,6 +41,7 @@ agent-browser close
41
41
  ```
42
42
 
43
43
  - Re-run `snapshot` after every navigation or state change. Refs are only valid for the snapshot that produced them.
44
+ - Pass `--session <task-or-name>` on every `agent-browser` command, including the first `open`. Parallel tasks in one container share the `default` session and collide without it.
44
45
  - Run one browser session at a time. Call `store-progress` between page batches so the heartbeat watchdog sees you.
45
46
  - The browser is headless. Local servers inside the worker container are reachable at `http://localhost:<port>`.
46
47
  - The image launches Chromium with `--no-sandbox,--disable-dev-shm-usage` through `AGENT_BROWSER_ARGS`. If you pass your own `--args`, include `--no-sandbox` again or Chrome will not start.
@@ -36,6 +36,7 @@ agent-browser close
36
36
  ```
37
37
 
38
38
  - Re-run `snapshot` after every navigation or state change. Refs are only valid for the snapshot that produced them.
39
+ - Pass `--session <task-or-name>` on every `agent-browser` command, including the first `open`. Parallel tasks in one container share the `default` session and collide without it.
39
40
  - Run one browser session at a time. Call `store-progress` between page batches so the heartbeat watchdog sees you.
40
41
  - The browser is headless. Local servers inside the worker container are reachable at `http://localhost:<port>`.
41
42
  - The image launches Chromium with `--no-sandbox,--disable-dev-shm-usage` through `AGENT_BROWSER_ARGS`. If you pass your own `--args`, include `--no-sandbox` again or Chrome will not start.
@@ -0,0 +1,14 @@
1
+ {
2
+ "kind": "skill",
3
+ "name": "boards-and-sheets",
4
+ "displayName": "Boards and sheets",
5
+ "slug": "boards-and-sheets",
6
+ "title": "Boards and sheets",
7
+ "description": "Make spreadsheets with live formulas (`ctx.sheets`) and Excalidraw diagrams (`ctx.boards`) as files on your agent-fs drive, from a script. Covers when to pick a sheet, a board or a Markdown table, how to call them, where to put files, value and range rules, limits, xlsx import and export, and how to hand the link over without announcing the feature.",
8
+ "version": "1.0.0",
9
+ "category": "skills",
10
+ "placeholders": [],
11
+ "runAllSeedersCandidate": true,
12
+ "systemDefault": true,
13
+ "tags": ["sheets", "boards", "spreadsheets", "excalidraw", "agent-fs"]
14
+ }
@@ -0,0 +1,163 @@
1
+ # Boards and sheets
2
+
3
+ Sheets are spreadsheets with live formulas. Boards are Excalidraw diagrams. Both are files on your default agent-fs drive with a stable object id, so a person can open, edit and comment on them like any other file.
4
+
5
+ ## Pick the format
6
+
7
+ | The result is... | Use |
8
+ |---|---|
9
+ | Tabular data that changes over time or needs formulas (tracker, budget, comparison, roll-up) | a sheet (`ctx.sheets`) |
10
+ | A diagram or plan someone will move around (flow, architecture, rollout, mind map) | a board (`ctx.boards`) |
11
+ | A static table the reader only reads once | a Markdown table in your reply or report |
12
+ | A person asked for an Excel file, or sent one | a sheet, plus `importXlsx` / `exportXlsx` |
13
+
14
+ ## How to call
15
+
16
+ The `sheet-*` and `board-*` MCP tools are off in the agent tool list. Call them from a script: an inline `script-run`, a saved script, a workflow `swarm-script` node or an app script action. All of them get `ctx.sheets` and `ctx.boards`.
17
+
18
+ - Each method returns the unwrapped result and throws on a refusal (bad range, path exists, limit hit).
19
+ - Calls run as your own agent-fs identity on your default drive.
20
+ - Identify a file by `id` (from `create` or `list`) or by `path`.
21
+ - Writes check the file version and re-apply on a concurrent edit (other cells or elements merge; the same cell or element is last writer wins). After 4 conflicting attempts the call throws "retry".
22
+ - `create` and `importXlsx` are create-only: they refuse when the path exists. Read or update the existing file instead.
23
+ - Every returned `object` carries `link`, the live app link to the file. Hand that link to the person.
24
+
25
+ ## Where to put files
26
+
27
+ Put each file under the task's asset key, the `key` in `get-task-details` (for example `shared/q4-planning/`). The drive path equals the key string. Later runs find earlier files there with `ctx.sheets.list({ prefix })` or `ctx.boards.list({ prefix })`.
28
+
29
+ Sheet paths end in `.sheet.json`. Board paths end in `.excalidraw`.
30
+
31
+ ## Sheets
32
+
33
+ Limits: 20 tabs, 50,000 non-empty cells and 5 MiB per sheet, 10,000 cells per range call. Tab names are 1-31 characters without `[]:*?/\`.
34
+
35
+ Value rules for `values` and `rows`:
36
+ - A string starting with `=` is a formula. Every write recomputes the workbook.
37
+ - Start a string with `'=` to store literal text that begins with `=`.
38
+ - Send numbers as numbers. A string such as `"42"` stays text.
39
+ - `null` clears a cell in `setRange` and skips it in `appendRows`.
40
+
41
+ Ranges: `Tasks!B2:C3`, `A1:C10` (first tab), `'My tab'!A:A` (a whole column, capped to the used range) or a single cell `B2`. For `setRange`, a single cell is the top-left corner; a larger range must match the size of `values`.
42
+
43
+ Create a sheet, add a totals row, read it back:
44
+
45
+ ```ts
46
+ export default async function (args, ctx) {
47
+ const dir = "shared/q4-planning/"; // the task's asset key
48
+ const { object, link } = await ctx.sheets.create({
49
+ path: `${dir}tracker.sheet.json`,
50
+ title: "Q4 tracker",
51
+ tabs: [
52
+ {
53
+ name: "Tasks",
54
+ rows: [
55
+ ["Task", "Hours", "Cost"],
56
+ ["Design", 3, "=B2*80"],
57
+ ["Build", 5, "=B3*80"],
58
+ ],
59
+ },
60
+ ],
61
+ });
62
+ await ctx.sheets.appendRows({
63
+ id: object.id,
64
+ tab: "Tasks",
65
+ rows: [["Total", "=SUM(B2:B3)", "=SUM(C2:C3)"]],
66
+ });
67
+ const { values } = await ctx.sheets.getRange({ id: object.id, range: "Tasks!A1:C4" });
68
+ return { id: object.id, link, values }; // values[3] is ["Total", 8, 640]
69
+ }
70
+ ```
71
+
72
+ Update cells, add a tab, read formulas next to values:
73
+
74
+ ```ts
75
+ export default async function (args, ctx) {
76
+ const path = "shared/q4-planning/tracker.sheet.json";
77
+ const write = await ctx.sheets.setRange({ path, range: "Tasks!B2", values: [[4]] });
78
+ await ctx.sheets.addTab({ path, name: "Notes" });
79
+ await ctx.sheets.setRange({ path, range: "Notes!A1", values: [["'=B2 is a cell, not a formula"]] });
80
+ const read = await ctx.sheets.getRange({ path, range: "Tasks!C2:C4", formulas: true });
81
+ const { tabs, version } = await ctx.sheets.get({ path });
82
+ // write.recalculated counts the formulas that changed; read.values is [[320], [400], [720]]
83
+ return { recalculated: write.recalculated, values: read.values, formulas: read.formulas, tabs, version };
84
+ }
85
+ ```
86
+
87
+ `clearRange({ path, range })` empties a range and recomputes what depends on it.
88
+
89
+ ## xlsx import and export
90
+
91
+ Import when a person hands you an `.xlsx`; export when they asked for one. The sheet stays the working copy: edit the sheet, then export again.
92
+
93
+ - `importXlsx({ sourcePath, path })` reads an `.xlsx` on your drive and creates a sheet. It keeps tabs, values, formulas (recomputed), number formats, column widths and merges. Limits: a 5 MiB file, 20 tabs, 50,000 cells; nothing is created when a limit refuses.
94
+ - `exportXlsx({ id | path, targetPath, overwrite? })` writes formulas with their cached values, number formats, widths and merges. It refuses an existing `targetPath` unless `overwrite: true`.
95
+ - Both return `dropped`: what the other format cannot hold (styles, charts, comments, frozen panes, spilled array cells). Tell the person when `dropped` is not empty.
96
+
97
+ ```ts
98
+ export default async function (args, ctx) {
99
+ const dir = "shared/q4-planning/";
100
+ const out = await ctx.sheets.exportXlsx({
101
+ path: `${dir}tracker.sheet.json`,
102
+ targetPath: `${dir}tracker.xlsx`,
103
+ overwrite: true,
104
+ });
105
+ const back = await ctx.sheets.importXlsx({
106
+ sourcePath: `${dir}tracker.xlsx`,
107
+ path: `${dir}tracker-from-xlsx.sheet.json`,
108
+ });
109
+ return { xlsx: out.link, exportDropped: out.dropped, sheet: back.link, importDropped: back.dropped };
110
+ }
111
+ ```
112
+
113
+ ## Boards
114
+
115
+ Shapes are `rectangle`, `ellipse`, `diamond` or `text`, at most 200 per call. A shape's `key` names it so an arrow in the same call can point at it. An arrow's `from` and `to` take a key from the same call or an existing element id, and both ends bind. Shapes without `x`/`y` are laid out below existing content: `layout` is `row` (default), `column` or `grid`. Colors are `blue`, `green`, `yellow`, `red`, `violet`, `orange`, `gray`, `teal` or `#rrggbb`. A shape grows to fit its label.
116
+
117
+ Create a board with a flow:
118
+
119
+ ```ts
120
+ export default async function (args, ctx) {
121
+ const { object, added } = await ctx.boards.create({
122
+ path: "shared/q4-planning/rollout.excalidraw",
123
+ title: "Rollout plan",
124
+ shapes: [
125
+ { key: "plan", type: "rectangle", label: "Plan" },
126
+ { key: "build", type: "rectangle", label: "Build", color: "blue" },
127
+ { key: "ship", type: "diamond", label: "Ship?", color: "yellow" },
128
+ ],
129
+ arrows: [
130
+ { from: "plan", to: "build" },
131
+ { from: "build", to: "ship", label: "QA green" },
132
+ ],
133
+ });
134
+ return { id: object.id, link: object.link, added }; // added maps plan, build, ship, arrows[0], arrows[1] to element ids
135
+ }
136
+ ```
137
+
138
+ Read, then edit by element id:
139
+
140
+ ```ts
141
+ export default async function (args, ctx) {
142
+ const path = "shared/q4-planning/rollout.excalidraw";
143
+ const { elements } = await ctx.boards.get({ path }); // summary: id, type, text, x, y, width, height, boundTo
144
+ const ship = elements.find((e) => e.text === "Ship?");
145
+ const plan = elements.find((e) => e.text === "Plan");
146
+ const { added } = await ctx.boards.addElements({
147
+ path,
148
+ shapes: [{ key: "rollback", type: "ellipse", label: "Roll back", color: "red" }],
149
+ arrows: [{ from: ship.id, to: "rollback", label: "no" }],
150
+ });
151
+ await ctx.boards.updateElements({ path, patches: [{ elementId: ship.id, label: "Ship to prod?" }] });
152
+ const { removed, version } = await ctx.boards.removeElements({ path, elementIds: [plan.id] });
153
+ return { added, removed, version };
154
+ }
155
+ ```
156
+
157
+ - `get({ detail: "full" })` returns the raw Excalidraw elements instead of the summary.
158
+ - `updateElements` patches `label` (an empty string removes it), `x`, `y`, `width`, `height` and `color`. Bound labels and arrows follow. Arrows take only `label` and `color`.
159
+ - `removeElements` sets `isDeleted: true`. A shape takes its label with it and unbinds its arrows.
160
+
161
+ ## Hand it over quietly
162
+
163
+ Put the file where the person already works: send its `link` in the thread reply, the report or the task output they asked for. Do not announce sheets or boards as a feature and do not post about them unprompted. If they ask what the link is, say it is an editable spreadsheet or diagram on the shared drive.
@@ -78,6 +78,11 @@ writing CSS from scratch.
78
78
  page-session cookie via the launch endpoint) before the page can call the
79
79
  swarm API.
80
80
 
81
+ ## Known limits
82
+
83
+ - The page CSP sets `connect-src 'self'`, so `fetch` to another origin is blocked. Inline the data you need, or read it through the Browser SDK.
84
+ - The pages API returns 403 for a page owned by another agent. To restyle someone else's page, create a new page you own.
85
+
81
86
  ---
82
87
 
83
88
  # Design system
@@ -48,6 +48,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
48
48
  - [Email Domain Health](https://docs.agent-swarm.dev/docs/playbooks/email-domain-health). When: Someone wants the domains they send email from watched for SPF, DKIM, DMARC or blocklist problems.
49
49
  - [Open Oncall](https://docs.agent-swarm.dev/docs/playbooks/open-oncall). When: Someone wants alerts from PagerDuty, Datadog, Sentry or a webhook investigated and fixed, with a person approving each fix. Not when: A one-off question about a single incident.
50
50
  - [PR Review](https://docs.agent-swarm.dev/docs/playbooks/pr-review). When: Someone wants every pull request reviewed automatically before a person looks at it.
51
+ - [Software Factory](https://docs.agent-swarm.dev/docs/playbooks/software-factory). When: Someone wants labeled issues to become reviewed draft pull requests without a person driving each step.
51
52
  - [Linear Delivery Loop](https://docs.agent-swarm.dev/docs/playbooks/linear-delivery-loop). When: Someone wants agents to take Linear issues through implementation, CI and review to merged pull requests, with a person approving each one. Template: `community/linear-delivery-loop`.
52
53
  - [Slack Reply Gate](https://docs.agent-swarm.dev/docs/playbooks/slack-reply-gate). When: Someone wants Lead to stop answering or waking on Slack thread banter, reactions, or messages meant for other people. Not when: Someone wants to route Slack messages to a specific agent or channel, which is a pre.slack.route extension.
53
54
  - [Small-Company Workflows](https://docs.agent-swarm.dev/docs/playbooks/small-company-workflows). When: Someone at a small company asks which recurring cross-team workflows they could run with agents, with people approving the decisions. Not when: Someone wants a documented production playbook for one job, which is the linked playbook itself.
@@ -63,22 +64,33 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
63
64
  - [Choosing an AI operating model](https://docs.agent-swarm.dev/docs/guides/choosing-an-ai-operating-model). Reference.
64
65
  - [Small tech team operating model](https://docs.agent-swarm.dev/docs/guides/small-tech-team-operating-model). Reference.
65
66
  - [Customer renewal review](https://docs.agent-swarm.dev/docs/guides/customer-renewal-review). Reference.
67
+ - [Customer commitment tracking](https://docs.agent-swarm.dev/docs/guides/customer-commitment-tracking). Reference.
66
68
  - [Reviewing supplier invoice and purchase order discrepancies with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-invoice-discrepancy-review). Reference.
69
+ - [Reviewing marketplace partner payout discrepancies with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-payout-exception-review). Reference.
70
+ - [Preparing marketplace moderation appeals for human review with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-moderation-appeals). Reference.
71
+ - [Reviewing customer billing disputes with AI agents](https://docs.agent-swarm.dev/docs/guides/customer-billing-dispute-review). Reference.
72
+ - [Escalating a customer support issue to engineering with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-support-escalation-handoff). Reference.
73
+ - [Reviewing inconsistent product listings across sales channels with AI agents](https://docs.agent-swarm.dev/docs/guides/marketplace-catalog-discrepancy-review). Reference.
74
+ - [Handing off inventory discrepancies from operations to purchasing with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-inventory-exception-handoff). Reference.
75
+ - [Handing off unresolved operational work between shifts with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-operations-shift-handoff). Reference.
76
+ - [Reviewing a supplier's security evidence before onboarding with AI agents](https://docs.agent-swarm.dev/docs/guides/supplier-security-evidence-review). Reference.
67
77
  - [Deployment Guide](https://docs.agent-swarm.dev/docs/guides/deployment). When: Someone wants to run Agent Swarm on their own server with Docker Compose.
68
78
  - [One-click deploy](https://docs.agent-swarm.dev/docs/guides/one-click-deploy). When: Someone has no server yet and wants Agent Swarm running in the cloud with HTTPS.
69
79
  - [Kubernetes and Helm](https://docs.agent-swarm.dev/docs/guides/kubernetes). When: Someone wants to install Agent Swarm on Kubernetes.
70
80
  - [Worker Recovery: What Happens to Running Work When a Worker Stops](https://docs.agent-swarm.dev/docs/guides/worker-recovery-decision). Reference.
81
+ - [Deleting and Restoring Agents](https://docs.agent-swarm.dev/docs/guides/agent-deletion). Reference.
71
82
  - [Rootless Podman](https://docs.agent-swarm.dev/docs/guides/podman-rootless). When: Someone wants to run Agent Swarm under rootless Podman.
72
83
  - [Published Artifacts](https://docs.agent-swarm.dev/docs/guides/published-artifacts). Reference.
73
84
  - [Asset Namespaces](https://docs.agent-swarm.dev/docs/guides/asset-namespaces). Reference.
74
85
  - [agent-fs Co-deployment](https://docs.agent-swarm.dev/docs/guides/agent-fs-co-deployment). When: Someone wants shared persistent files for agents on a self-hosted swarm.
75
86
  - [Self-Hosted SSO](https://docs.agent-swarm.dev/docs/guides/self-hosted-sso). When: Someone wants their self-hosted swarm dashboard behind single sign-on.
76
87
  - [AI operations governance for small companies](https://docs.agent-swarm.dev/docs/guides/ai-operations-governance). Reference.
88
+ - [Repo merge policy](https://docs.agent-swarm.dev/docs/guides/repo-merge-policy). Reference.
77
89
  - [E2B Provider Smoke Tests](https://docs.agent-swarm.dev/docs/guides/e2b-provider-smoke-tests). Reference.
78
90
  - [Evals Harness](https://docs.agent-swarm.dev/docs/guides/evals-harness). Reference.
79
91
  - [Personalization & Status](https://docs.agent-swarm.dev/docs/guides/personalization). Reference.
80
92
  - [Secrets Encryption](https://docs.agent-swarm.dev/docs/guides/secrets-encryption). When: Someone asks how swarm secrets are stored, encrypted or backed up.
81
- - [Harness Configuration](https://docs.agent-swarm.dev/docs/guides/harness-configuration). When: Someone wants agents to run on a different AI provider or coding CLI.
93
+ - [Harness Configuration](https://docs.agent-swarm.dev/docs/guides/harness-configuration). When: Someone wants agents to run on a different harness or coding CLI.
82
94
  - [Provider Capability Matrix](https://docs.agent-swarm.dev/docs/guides/provider-capability-matrix). Reference.
83
95
  - [Adding a Harness Provider](https://docs.agent-swarm.dev/docs/guides/harness-providers). Reference.
84
96
  - [Steer a Running Task](https://docs.agent-swarm.dev/docs/guides/task-steering). Reference.
@@ -113,6 +125,8 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
113
125
  - [Multi-runtime agents](https://docs.agent-swarm.dev/docs/guides/multi-runtime-agents). Reference.
114
126
  - [Runtime pools (beta)](https://docs.agent-swarm.dev/docs/guides/runtime-pools). Reference.
115
127
  - [boxd runtime provider](https://docs.agent-swarm.dev/docs/guides/boxd-runtime-provider). Reference.
128
+ - [Coordinating delivery delay investigations between operations and support with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-delivery-delay-handoff). Reference.
129
+ - [Preparing a service capacity planning brief with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-service-capacity-planning). Reference.
116
130
  - [Reviewing customer help content for conflicts with AI agents](https://docs.agent-swarm.dev/docs/guides/support-knowledge-conflict-review). Reference.
117
131
 
118
132
  ## Other docs
@@ -70,6 +70,7 @@ export default async function (args: z.infer<typeof argsSchema>, ctx: ScriptCont
70
70
  - Both `zod` and `zod/mini` imports work. Use `import * as z from "zod/mini"` for smaller QuickJS bundles. Mini uses functional forms: `z.optional(z.string())`, `z._default(z.number(), 10)`, and `z.string().check(z.minLength(1))`; its schemas still have `.parse()` and `.safeParse()`.
71
71
  - Inline source through `script-run` runs without a typecheck. `script-upsert` typechecks before it saves. Import `ScriptContext` from `"swarm-sdk"` in inline code too, so promotion to a named script works. A worker's `script-upsert` saves at agent scope; a global-scope upsert is rejected unless you are the lead. To share a script, send the lead its name and `contentHash` to promote.
72
72
  - SDK methods return `Promise<unknown>`. Responses are usually wrapped: read `res?.data ?? res`. Exception: `app_query` with a literal `appId` and `query` returns rows typed from the app's columns.
73
+ - When a script returns an array, return a scalar count beside it (for example `{ count, rows }`). A bounded or elided reply can show an empty array as a clean zero; the count is the only reliable signal that rows existed.
73
74
  - `agentId` is propagated through the `X-Agent-ID` header, so SDK calls run as you. `taskId` is not ambient: pass it in `args` when the script calls `task_storeProgress`.
74
75
  - A script invoked from a workflow node may run under a workflow identity. The node may also supply arguments the script needs: when you run that script directly, pass the same arguments the node maps. A script without a strict `argsSchema` then fails deeper in, often as a not-found or resource error instead of a validation error.
75
76
  - Return compact structured data. Raw logs, full HTML, big JSON arrays, and file contents stay inside the script.
@@ -65,6 +65,7 @@ export default async function (args: z.infer<typeof argsSchema>, ctx: ScriptCont
65
65
  - Both `zod` and `zod/mini` imports work. Use `import * as z from "zod/mini"` for smaller QuickJS bundles. Mini uses functional forms: `z.optional(z.string())`, `z._default(z.number(), 10)`, and `z.string().check(z.minLength(1))`; its schemas still have `.parse()` and `.safeParse()`.
66
66
  - Inline source through `script-run` runs without a typecheck. `script-upsert` typechecks before it saves. Import `ScriptContext` from `"swarm-sdk"` in inline code too, so promotion to a named script works. A worker's `script-upsert` saves at agent scope; a global-scope upsert is rejected unless you are the lead. To share a script, send the lead its name and `contentHash` to promote.
67
67
  - SDK methods return `Promise<unknown>`. Responses are usually wrapped: read `res?.data ?? res`. Exception: `app_query` with a literal `appId` and `query` returns rows typed from the app's columns.
68
+ - When a script returns an array, return a scalar count beside it (for example `{ count, rows }`). A bounded or elided reply can show an empty array as a clean zero; the count is the only reliable signal that rows existed.
68
69
  - `agentId` is propagated through the `X-Agent-ID` header, so SDK calls run as you. `taskId` is not ambient: pass it in `args` when the script calls `task_storeProgress`.
69
70
  - A script invoked from a workflow node may run under a workflow identity. The node may also supply arguments the script needs: when you run that script directly, pass the same arguments the node maps. A script without a strict `argsSchema` then fails deeper in, often as a not-found or resource error instead of a validation error.
70
71
  - Return compact structured data. Raw logs, full HTML, big JSON arrays, and file contents stay inside the script.
@@ -12,6 +12,8 @@ This skill enforces a disciplined TDD workflow:
12
12
 
13
13
  **No implementation code is written without a failing test first.** This is non-negotiable.
14
14
 
15
+ **Write the test at the level the repo asks for.** When the repo proves behavior through a black-box e2e suite and limits new unit tests, RED is a failing e2e scenario, not a new unit test. In agent-swarm that is a scenario in `scripts/e2e/scenarios/`, run alone with `bun run e2e --only <name>`. A new unit test there may import only the code listed in `scripts/unit-test-allowlist.txt` (worker runtime, tooling, rule corpora), and `bun run check:unit-test-allowlist` fails the PR otherwise.
16
+
15
17
  ## Working Agreement
16
18
 
17
19
  These instructions establish a working agreement between you and the user. The key principles are:
@@ -78,6 +80,7 @@ The autonomy mode is passed by the invoking command. If not specified, default t
78
80
  - **CRITICAL**: Read files yourself before spawning sub-tasks
79
81
 
80
82
  2. **Analyze test infrastructure:**
83
+ - Does the repo's CLAUDE.md or AGENTS.md require e2e scenarios over unit tests? That decides what every RED phase writes.
81
84
  - What testing framework is used? (Jest, pytest, Go testing, etc.)
82
85
  - Where do tests live? (co-located, `__tests__/`, `tests/`, etc.)
83
86
  - What's the test command? (`npm test`, `make test`, `pytest`, etc.)
@@ -106,8 +109,8 @@ The autonomy mode is passed by the invoking command. If not specified, default t
106
109
 
107
110
  ### Step 2: Test Strategy Design
108
111
 
109
- 1. **Identify testable units:**
110
- - What are the smallest testable pieces?
112
+ 1. **Identify testable behaviors:**
113
+ - What are the smallest behaviors a test can check, at the level the repo asks for (an e2e scenario where it has one)?
111
114
  - What inputs/outputs can be verified?
112
115
  - What edge cases matter?
113
116
 
@@ -1,16 +0,0 @@
1
- import {
2
- ACPAdapter2
3
- } from "./cli-2aacfdcn.js";
4
- import"./cli-p1a4khta.js";
5
- import"./cli-s9twe4x0.js";
6
- import"./cli-0bgj4rh5.js";
7
- import"./cli-rytq7dm2.js";
8
- import"./cli-czvvnfr9.js";
9
- import"./cli-0726awxw.js";
10
- import"./cli-9g12h1aq.js";
11
- import"./cli-r813c7rb.js";
12
- import"./cli-4kzp7r0q.js";
13
- import"./cli-fwjwkw66.js";
14
- export {
15
- ACPAdapter2 as ACPAdapter
16
- };
@@ -1,39 +0,0 @@
1
- import {
2
- getDeploymentEnvValue2,
3
- loadGlobalConfigsIntoEnv2,
4
- reloadGlobalConfigsAndIntegrations2,
5
- scheduleIntegrationsReload2,
6
- handleCore2,
7
- init_core
8
- } from "./cli-075ccjh6.js";
9
- import"./cli-f8yhybxr.js";
10
- import"./cli-hnh8erra.js";
11
- import"./cli-wz4e5am2.js";
12
- import"./cli-4aswccje.js";
13
- import"./cli-7cp6aa1q.js";
14
- import"./cli-v3zcnr8g.js";
15
- import"./cli-14xdms9a.js";
16
- import"./cli-m00c47q6.js";
17
- import"./cli-raqw9fw9.js";
18
- import"./cli-nc39ym5q.js";
19
- import"./cli-8zmpwe79.js";
20
- import"./cli-6a3j25xd.js";
21
- import"./cli-bq97k63w.js";
22
- import"./cli-47hz21se.js";
23
- import"./cli-n3qe7tyr.js";
24
- import"./cli-9w8712tq.js";
25
- import"./cli-rhsc2zyx.js";
26
- import"./cli-thd3005a.js";
27
- import"./cli-t2s7j5cy.js";
28
- import"./cli-cstggwq7.js";
29
- import"./cli-yzxqwcvq.js";
30
- import"./cli-zhn4r1rz.js";
31
- init_core();
32
-
33
- export {
34
- getDeploymentEnvValue2 as getDeploymentEnvValue,
35
- handleCore2 as handleCore,
36
- loadGlobalConfigsIntoEnv2 as loadGlobalConfigsIntoEnv,
37
- reloadGlobalConfigsAndIntegrations2 as reloadGlobalConfigsAndIntegrations,
38
- scheduleIntegrationsReload2 as scheduleIntegrationsReload
39
- };
@@ -1,19 +0,0 @@
1
- import {
2
- checkFxCredentials2,
3
- FxAdapter2
4
- } from "./cli-vy3fn0mz.js";
5
- import"./cli-2aacfdcn.js";
6
- import"./cli-p1a4khta.js";
7
- import"./cli-s9twe4x0.js";
8
- import"./cli-0bgj4rh5.js";
9
- import"./cli-rytq7dm2.js";
10
- import"./cli-czvvnfr9.js";
11
- import"./cli-0726awxw.js";
12
- import"./cli-9g12h1aq.js";
13
- import"./cli-r813c7rb.js";
14
- import"./cli-4kzp7r0q.js";
15
- import"./cli-fwjwkw66.js";
16
- export {
17
- FxAdapter2 as FxAdapter,
18
- checkFxCredentials2 as checkFxCredentials
19
- };
@@ -1,19 +0,0 @@
1
- import {
2
- checkGrokCredentials2,
3
- GrokAdapter2
4
- } from "./cli-6tvh1fwq.js";
5
- import"./cli-2aacfdcn.js";
6
- import"./cli-p1a4khta.js";
7
- import"./cli-s9twe4x0.js";
8
- import"./cli-0bgj4rh5.js";
9
- import"./cli-rytq7dm2.js";
10
- import"./cli-czvvnfr9.js";
11
- import"./cli-0726awxw.js";
12
- import"./cli-9g12h1aq.js";
13
- import"./cli-r813c7rb.js";
14
- import"./cli-4kzp7r0q.js";
15
- import"./cli-fwjwkw66.js";
16
- export {
17
- GrokAdapter2 as GrokAdapter,
18
- checkGrokCredentials2 as checkGrokCredentials
19
- };
@@ -1,36 +0,0 @@
1
- import {
2
- isUserAllowed2,
3
- registerMessageHandler2,
4
- init_handlers
5
- } from "./cli-xqbqwpxr.js";
6
- import"./cli-892y3vfp.js";
7
- import"./cli-nbakg5xh.js";
8
- import"./cli-075ccjh6.js";
9
- import"./cli-f8yhybxr.js";
10
- import"./cli-hnh8erra.js";
11
- import"./cli-wz4e5am2.js";
12
- import"./cli-4aswccje.js";
13
- import"./cli-7cp6aa1q.js";
14
- import"./cli-v3zcnr8g.js";
15
- import"./cli-14xdms9a.js";
16
- import"./cli-m00c47q6.js";
17
- import"./cli-raqw9fw9.js";
18
- import"./cli-nc39ym5q.js";
19
- import"./cli-8zmpwe79.js";
20
- import"./cli-6a3j25xd.js";
21
- import"./cli-bq97k63w.js";
22
- import"./cli-47hz21se.js";
23
- import"./cli-n3qe7tyr.js";
24
- import"./cli-9w8712tq.js";
25
- import"./cli-rhsc2zyx.js";
26
- import"./cli-thd3005a.js";
27
- import"./cli-t2s7j5cy.js";
28
- import"./cli-cstggwq7.js";
29
- import"./cli-yzxqwcvq.js";
30
- import"./cli-zhn4r1rz.js";
31
- init_handlers();
32
-
33
- export {
34
- isUserAllowed2 as isUserAllowed,
35
- registerMessageHandler2 as registerMessageHandler
36
- };