@desplega.ai/agent-swarm 2.11.0 → 2.12.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 (382) hide show
  1. package/dist/acp-adapter-11m13kx4.js +16 -0
  2. package/dist/{acp-targets-5wyy2b9m.js → acp-targets-311gcyvw.js} +9 -9
  3. package/dist/{actions-4nxq386s.js → actions-c4chgxp6.js} +24 -22
  4. package/dist/{agent-fs-provision-v6enh76w.js → agent-fs-provision-0b9awm5n.js} +10 -5
  5. package/dist/{amp-adapter-ze3x22qn.js → amp-adapter-r0veq6x5.js} +3 -3
  6. package/dist/{app-kyqt8ehw.js → app-hn5fftf5.js} +5 -5
  7. package/dist/{approval-notifications-a0db0esw.js → approval-notifications-3g6yc8nv.js} +7 -7
  8. package/dist/{assistant-9g5jzq25.js → assistant-cpjgpjvp.js} +24 -22
  9. package/dist/{boot-args-schema-d7fme4q1.js → boot-args-schema-hce1av1h.js} +1 -1
  10. package/dist/{boot-reembed-jrwxeye2.js → boot-reembed-bztbxc4z.js} +1 -1
  11. package/dist/{boot-reembed-6wpazmpw.js → boot-reembed-d7xcym0j.js} +1 -1
  12. package/dist/{boot-scrub-sweep-52h7yntp.js → boot-scrub-sweep-mkmm16gk.js} +2 -2
  13. package/dist/{boot-seeds-kb3dxjex.js → boot-seeds-arrkbe8t.js} +4 -4
  14. package/dist/{boxd-jrrmkv3w.js → boxd-68n75y1s.js} +1 -1
  15. package/dist/{claude-adapter-0c0y8fqp.js → claude-adapter-ykpyr5p8.js} +8 -8
  16. package/dist/{claude-managed-adapter-w2es07qq.js → claude-managed-adapter-ssg6z4bt.js} +4 -4
  17. package/dist/{claude-managed-setup-9ssb7ct4.js → claude-managed-setup-trd59v7b.js} +4 -4
  18. package/dist/{claude-sdk-session-p6t0gyse.js → claude-sdk-session-yjcze0j1.js} +10 -10
  19. package/dist/{cli-2gvdvsxj.js → cli-01tvvtad.js} +63 -60
  20. package/dist/{cli-rhsc2zyx.js → cli-04zc3f7b.js} +1 -1
  21. package/dist/{cli-p1a4khta.js → cli-0k1a0sde.js} +6 -6
  22. package/dist/{cli-atm0hkes.js → cli-0pp1yjg2.js} +4 -4
  23. package/dist/{cli-0b4zam62.js → cli-0vcqcwfn.js} +18 -0
  24. package/dist/{cli-zhn4r1rz.js → cli-12vek61e.js} +72 -49
  25. package/dist/{cli-j2r1apqm.js → cli-1htmtqc2.js} +45 -44
  26. package/dist/{cli-a6q6x15h.js → cli-2amwhyv2.js} +8 -5
  27. package/dist/{cli-w5dar1bk.js → cli-2m6yaq6b.js} +1 -1
  28. package/dist/{cli-a02habn6.js → cli-2tw284hj.js} +2 -2
  29. package/dist/{cli-nc39ym5q.js → cli-39qm0rtm.js} +6 -6
  30. package/dist/{cli-6c9ve77f.js → cli-3p288654.js} +2 -2
  31. package/dist/cli-52nfye5j.js +673 -0
  32. package/dist/cli-55tc8cj4.js +252 -0
  33. package/dist/cli-5r95eqbh.js +186 -0
  34. package/dist/{cli-892y3vfp.js → cli-5tg94mdw.js} +7 -7
  35. package/dist/{cli-ynph3b70.js → cli-5x03v6en.js} +8 -8
  36. package/dist/{cli-1h4njv9y.js → cli-5z0g0e8v.js} +11 -2
  37. package/dist/{cli-6a3j25xd.js → cli-72yms3ey.js} +16 -16
  38. package/dist/{cli-h2qtafm4.js → cli-73q4g5nx.js} +17 -17
  39. package/dist/{cli-k3c13za2.js → cli-7wy8gbwb.js} +1 -1
  40. package/dist/{cli-9g12h1aq.js → cli-7yn42w6m.js} +1 -1
  41. package/dist/{cli-g56fxddf.js → cli-8hp56wat.js} +3 -2
  42. package/dist/{cli-4aswccje.js → cli-9qe5y107.js} +2 -2
  43. package/dist/{cli-7cp6aa1q.js → cli-9y4tgrkf.js} +23 -177
  44. package/dist/{cli-mhrr4d5b.js → cli-agjbj5x0.js} +1 -1
  45. package/dist/{cli-hnh8erra.js → cli-b93d81yg.js} +2 -2
  46. package/dist/{cli-9yjhshah.js → cli-bhgrhedp.js} +1 -1
  47. package/dist/{cli-b82a13ga.js → cli-bp6k9acz.js} +17 -21
  48. package/dist/{cli-7e8sxqv5.js → cli-bpje8n65.js} +30 -3
  49. package/dist/{cli-t2s7j5cy.js → cli-bz97ff9n.js} +2 -2
  50. package/dist/{cli-0bgj4rh5.js → cli-c7j31hq9.js} +3 -3
  51. package/dist/{cli-p8zqbbt1.js → cli-cah298e5.js} +1 -1
  52. package/dist/{cli-9knhkkgr.js → cli-cjqyse9q.js} +3 -3
  53. package/dist/{cli-tb4j757d.js → cli-dkvtfgn4.js} +6 -6
  54. package/dist/{cli-14xdms9a.js → cli-e3ahxq5y.js} +6 -6
  55. package/dist/{cli-6n7y5ypy.js → cli-e8n0hdzd.js} +1 -1
  56. package/dist/{cli-q71g5q39.js → cli-en6dmkxd.js} +3 -3
  57. package/dist/{cli-xqbqwpxr.js → cli-eq4kew31.js} +9 -9
  58. package/dist/{cli-4kzp7r0q.js → cli-eqq0hwvx.js} +3 -3
  59. package/dist/{cli-bf0t77nf.js → cli-ercwc8xn.js} +1 -1
  60. package/dist/{cli-qncx2r0s.js → cli-ex1y88j3.js} +1 -1
  61. package/dist/{cli-bq97k63w.js → cli-fxd1mwtr.js} +2 -2
  62. package/dist/{cli-kbm659dk.js → cli-fy4gb74g.js} +2 -2
  63. package/dist/{cli-djt6wmrc.js → cli-fyaq4zdv.js} +6 -6
  64. package/dist/{cli-raqw9fw9.js → cli-gfy6hbd9.js} +6 -6
  65. package/dist/{cli-s9twe4x0.js → cli-h70a2mxy.js} +13 -8
  66. package/dist/cli-hbvgzjq4.js +69 -0
  67. package/dist/{cli-vy3fn0mz.js → cli-hhc47ack.js} +4 -4
  68. package/dist/{cli-m00c47q6.js → cli-j5gtytvg.js} +54 -24
  69. package/dist/{cli-ha4ek2nb.js → cli-js10kdk7.js} +1 -1
  70. package/dist/{cli-yzxqwcvq.js → cli-k5jx8jya.js} +10 -3
  71. package/dist/{cli-rytq7dm2.js → cli-krbcr00p.js} +3 -3
  72. package/dist/{cli-453497a0.js → cli-kwr5qv5g.js} +2 -2
  73. package/dist/{cli-czvvnfr9.js → cli-m5qtmrbc.js} +2 -2
  74. package/dist/{cli-cstggwq7.js → cli-ma9ys8rt.js} +2 -2
  75. package/dist/{cli-htymm48w.js → cli-mbwmqb5w.js} +1 -1
  76. package/dist/{cli-wz4e5am2.js → cli-mcymtvwn.js} +320 -70
  77. package/dist/{cli-2aacfdcn.js → cli-mq2fbgva.js} +64 -3
  78. package/dist/{cli-ramn8jae.js → cli-n85m2wkq.js} +1 -1
  79. package/dist/{cli-k4r5sfaj.js → cli-n8f0fs3c.js} +4 -4
  80. package/dist/{cli-f8yhybxr.js → cli-nja15knq.js} +3 -3
  81. package/dist/{cli-6tvh1fwq.js → cli-pe3yxedk.js} +3 -3
  82. package/dist/{cli-3bpr3wks.js → cli-pqfecppn.js} +1 -1
  83. package/dist/{cli-n6ygvrrm.js → cli-q2dywc8h.js} +4 -4
  84. package/dist/{cli-8zmpwe79.js → cli-q8tc22bj.js} +5 -5
  85. package/dist/{cli-yvzxbztc.js → cli-r0mz92by.js} +2 -2
  86. package/dist/{cli-v3zcnr8g.js → cli-r14ac1y0.js} +1 -1
  87. package/dist/{cli-fwjwkw66.js → cli-rtmqzat7.js} +2 -2
  88. package/dist/{cli-zqq57pgx.js → cli-s6zk31gr.js} +4 -4
  89. package/dist/{cli-27fat7st.js → cli-sv2r3bw8.js} +7 -7
  90. package/dist/{cli-zb1hff00.js → cli-t75xngj1.js} +9 -9
  91. package/dist/{cli-r813c7rb.js → cli-tdk7jtka.js} +1 -1
  92. package/dist/{cli-5ptj757f.js → cli-tm60vtax.js} +1 -1
  93. package/dist/{cli-rpmw4fsv.js → cli-v9ya390t.js} +12 -12
  94. package/dist/{cli-075ccjh6.js → cli-wvjqaqcp.js} +2607 -65
  95. package/dist/{cli-2jtfm8kh.js → cli-xf4z5bdn.js} +4 -4
  96. package/dist/{cli-4g323fjh.js → cli-xm34qj8m.js} +2 -2
  97. package/dist/{cli-f7dhm7hh.js → cli-ya3kf4gs.js} +1 -1
  98. package/dist/{cli-rwgwen5v.js → cli-yegz2g06.js} +4 -4
  99. package/dist/{cli-nbakg5xh.js → cli-yfpc6qy9.js} +3 -3
  100. package/dist/{cli-thd3005a.js → cli-z4f346g5.js} +1 -1
  101. package/dist/cli.js +24 -21
  102. package/dist/{codex-adapter-ssahg4h4.js → codex-adapter-wc6e4wct.js} +8 -8
  103. package/dist/{codex-login-9c7aggxe.js → codex-login-1ven7yje.js} +1 -1
  104. package/dist/{codex-session-runner-xn63q3h7.js → codex-session-runner-ppfgjd97.js} +9 -9
  105. package/dist/{commands-ctey7tr5.js → commands-tsv2vx5b.js} +3 -3
  106. package/dist/{controller-rqhbppg9.js → controller-ye4sdwsy.js} +4 -4
  107. package/dist/{controllers-connect-w3qbpbt1.js → controllers-connect-zn4dg69h.js} +25 -23
  108. package/dist/core-dxcy02sc.js +41 -0
  109. package/dist/{cursor-adapter-r819hf1a.js → cursor-adapter-q2g9vwts.js} +2 -2
  110. package/dist/{db-2ah39cyx.js → db-3r1fyr2n.js} +6 -2
  111. package/dist/{db-p5drc1d1.js → db-g111qn9j.js} +3 -3
  112. package/dist/{devin-adapter-bc6g0x29.js → devin-adapter-t8d86q9x.js} +1 -1
  113. package/dist/{dispatcher-x6w14pde.js → dispatcher-4q8s0mx8.js} +22 -20
  114. package/dist/{docker-6c4reetq.js → docker-1b41eysj.js} +2 -2
  115. package/dist/{dsh-adapter-h8qn14n4.js → dsh-adapter-mmcw1z5s.js} +2 -2
  116. package/dist/{e2b-z4ec0qve.js → e2b-ew8c5j5v.js} +2 -2
  117. package/dist/{e2b-jg7kyyef.js → e2b-xm60c8ad.js} +2 -2
  118. package/dist/{easter-egg-3d-1y6r9gxy.js → easter-egg-3d-04ke6hcp.js} +1 -1
  119. package/dist/{embedding-space-z6ptw3jk.js → embedding-space-kcdn52vz.js} +6 -6
  120. package/dist/{embeddings-0sxb1d2h.js → embeddings-jnzcd91a.js} +1 -1
  121. package/dist/{event-bus-swr88jg5.js → event-bus-v4ywhc2p.js} +1 -1
  122. package/dist/{execute-6m1ex8ce.js → execute-74amghty.js} +1 -1
  123. package/dist/{external-channel-ezer7pk0.js → external-channel-v9zgxnxz.js} +2 -2
  124. package/dist/fx-adapter-0ar6pqm3.js +19 -0
  125. package/dist/grok-adapter-t6m74fb1.js +19 -0
  126. package/dist/handlers-9kwcrc4k.js +38 -0
  127. package/dist/{heartbeat-6c4fr49t.js → heartbeat-p8pk1msj.js} +25 -23
  128. package/dist/{hook-t1c5avbv.js → hook-k1h73zd7.js} +5 -5
  129. package/dist/{hook-02rt5tvq.js → hook-p5reemds.js} +7 -7
  130. package/dist/{http-qa3h32a1.js → http-ms1z5xxy.js} +565 -141
  131. package/dist/index-23cdfzr6.js +39 -0
  132. package/dist/{index-kqv9ebfj.js → index-76zzxtzf.js} +1 -1
  133. package/dist/{index-e42j998x.js → index-fbkqhvvj.js} +38 -19
  134. package/dist/index-g7kkjs5b.js +38 -0
  135. package/dist/{index-qpjk2hxk.js → index-gjn6qfgn.js} +1 -1
  136. package/dist/{index-akbgsdhh.js → index-kn63q1gr.js} +26 -24
  137. package/dist/index-stk36pa5.js +43 -0
  138. package/dist/{k8s-7jrh5va2.js → k8s-fy8hbhkg.js} +2 -2
  139. package/dist/{keepalive-jmf6pn8c.js → keepalive-031js8jz.js} +4 -4
  140. package/dist/lead-mfggjtfk.js +77 -0
  141. package/dist/{maintenance-g7v15tj1.js → maintenance-sq9v3qx9.js} +1 -1
  142. package/dist/{oauth-refresh-sweep-ywgf8tbr.js → oauth-refresh-sweep-zqmnyvs8.js} +3 -3
  143. package/dist/object-webhooks-r24wwb5y.js +21 -0
  144. package/dist/{onboard-m3fedypq.js → onboard-p25yhh7t.js} +5 -5
  145. package/dist/{opencode-adapter-19ktcbb9.js → opencode-adapter-wcjc4zdk.js} +7 -7
  146. package/dist/{otel-impl-3ehm1hgc.js → otel-impl-ff1gf20m.js} +2 -2
  147. package/dist/{pending-fwj2fatd.js → pending-hxj5yatb.js} +23 -21
  148. package/dist/{pi-mono-adapter-xdeesvc4.js → pi-mono-adapter-vkp4zz7p.js} +12 -12
  149. package/dist/{pricing-refresh-4j8dzvxg.js → pricing-refresh-9w7gx41w.js} +2 -2
  150. package/dist/{rbac-roles-8msjr07m.js → rbac-roles-84aw10nz.js} +3 -3
  151. package/dist/{rbac-roles-n7t2acv8.js → rbac-roles-hz74vckp.js} +2 -2
  152. package/dist/{registry-32b1mft6.js → registry-eeyx1201.js} +1 -1
  153. package/dist/{render-v2-j7qggj8h.js → render-v2-nrdkg9gf.js} +5 -5
  154. package/dist/{resume-hj1mn65y.js → resume-s6ey36rh.js} +9 -9
  155. package/dist/{runtime-z31mdsgv.js → runtime-x0b4pyam.js} +1 -1
  156. package/dist/{session-access-w38fh09a.js → session-access-xv49tk14.js} +4 -4
  157. package/dist/{session-source-backfill-ax6qxv20.js → session-source-backfill-r5j988ah.js} +3 -3
  158. package/dist/{setup-dsqmpfcr.js → setup-mj0krk1p.js} +1 -1
  159. package/dist/thread-buffer-temgaqsy.js +41 -0
  160. package/dist/{tree-visibility-6vqmnr71.js → tree-visibility-cbrsfaar.js} +2 -2
  161. package/dist/{user-merge-jobs-mvheb3ed.js → user-merge-jobs-f9d8nwnw.js} +3 -3
  162. package/dist/{virtual-modules-w2qk2wew.js → virtual-modules-ns0ryw05.js} +3 -3
  163. package/dist/{work-objects-4ahy5es5.js → work-objects-pydhzast.js} +25 -23
  164. package/dist/worker-efcemc22.js +77 -0
  165. package/dist/{worker-follow-up-1gs4aw7y.js → worker-follow-up-9z2xec5e.js} +22 -20
  166. package/dist/{x-3wr8c5sh.js → x-3dtaf2r9.js} +2 -2
  167. package/openapi.json +788 -253
  168. package/package.json +8 -5
  169. package/src/azure-devops/auth.ts +2 -3
  170. package/src/be/agent-fs-identity.ts +46 -0
  171. package/src/be/agent-history.ts +215 -0
  172. package/src/be/db/agents.ts +34 -12
  173. package/src/be/db/tasks/write.ts +2 -2
  174. package/src/be/db.ts +2 -0
  175. package/src/be/migrations/332_primitive_objects.sql +31 -0
  176. package/src/be/migrations/334_agent_history.sql +23 -0
  177. package/src/be/migrations/335_primitive_object_webhooks.sql +36 -0
  178. package/src/be/primitives/boards/elements.ts +717 -0
  179. package/src/be/primitives/boards/excalifont-metrics.json +516 -0
  180. package/src/be/primitives/boards/service.ts +121 -0
  181. package/src/be/primitives/object-webhooks.ts +348 -0
  182. package/src/be/primitives/objects.ts +686 -0
  183. package/src/be/primitives/sheets/a1.ts +136 -0
  184. package/src/be/primitives/sheets/engine-worker.ts +194 -0
  185. package/src/be/primitives/sheets/engine.ts +199 -0
  186. package/src/be/primitives/sheets/format.ts +106 -0
  187. package/src/be/primitives/sheets/service.ts +415 -0
  188. package/src/be/primitives/write-object.ts +83 -0
  189. package/src/be/script-credential-broker.ts +8 -27
  190. package/src/be/scripts/typecheck.ts +216 -0
  191. package/src/be/seed/agent-fs-provision.ts +18 -0
  192. package/src/be/users.ts +19 -0
  193. package/src/commands/onboard/agent-fs-version.ts +1 -1
  194. package/src/commands/onboard/steps/harness.tsx +1 -1
  195. package/src/commands/provider-credentials.ts +1 -0
  196. package/src/e2b/env.ts +3 -1
  197. package/src/fs/agent-fs-provider.ts +33 -2
  198. package/src/gitlab/auth.ts +3 -4
  199. package/src/heartbeat/heartbeat.ts +11 -11
  200. package/src/http/agent-lifecycle.ts +152 -0
  201. package/src/http/agents.ts +12 -0
  202. package/src/http/all-routes.ts +2 -0
  203. package/src/http/auth.ts +2 -1
  204. package/src/http/index.ts +15 -0
  205. package/src/http/object-webhooks.ts +101 -0
  206. package/src/http/operator-actor.ts +2 -1
  207. package/src/http/sessions.ts +7 -0
  208. package/src/http/workflows.ts +32 -0
  209. package/src/integrations/chat-sdk/outbound-files.ts +3 -2
  210. package/src/providers/acp-targets.ts +2 -2
  211. package/src/providers/amp-adapter.ts +1 -1
  212. package/src/providers/opencode-adapter.ts +4 -1
  213. package/src/rbac/legacy-policy.ts +2 -0
  214. package/src/rbac/permissions.ts +5 -0
  215. package/src/script-workflows/guest-ctx.ts +32 -0
  216. package/src/script-workflows/workflow-ctx.ts +2 -0
  217. package/src/scripts-runtime/ctx.ts +9 -1
  218. package/src/scripts-runtime/executors/native.ts +106 -21
  219. package/src/scripts-runtime/executors/quickjs-prelude.ts +9 -2
  220. package/src/scripts-runtime/executors/quickjs-runner.ts +12 -1
  221. package/src/scripts-runtime/sdk-allowlist.ts +88 -0
  222. package/src/scripts-runtime/swarm-sdk.ts +51 -3
  223. package/src/scripts-runtime/types/stdlib.d.ts +267 -0
  224. package/src/scripts-runtime/types/swarm-sdk.d.ts +267 -0
  225. package/src/server.ts +48 -0
  226. package/src/tests/agent-history.test.ts +313 -0
  227. package/src/tests/azure-devops-auth.test.ts +6 -0
  228. package/src/tests/chat-sdk-outbound-files.test.ts +3 -1
  229. package/src/tests/check-unit-test-allowlist.test.ts +193 -0
  230. package/src/tests/credential-check.test.ts +12 -0
  231. package/src/tests/db-task-read-contract.test.ts +2 -0
  232. package/src/tests/db-task-write-contract.test.ts +2 -0
  233. package/src/tests/e2e-coverage-contract.test.ts +6 -2
  234. package/src/tests/e2e-diff-coverage.test.ts +154 -0
  235. package/src/tests/e2e-rerun-quarantine.test.ts +180 -0
  236. package/src/tests/e2e-shards.test.ts +137 -0
  237. package/src/tests/e2e-tracker-ingest.test.ts +266 -0
  238. package/src/tests/extensions-heartbeat.test.ts +34 -0
  239. package/src/tests/gitlab-auth.test.ts +10 -0
  240. package/src/tests/heartbeat.test.ts +38 -0
  241. package/src/tests/http-api-integration.test.ts +0 -6
  242. package/src/tests/opencode-adapter.test.ts +11 -0
  243. package/src/tests/primitives-boards.test.ts +686 -0
  244. package/src/tests/primitives-object-webhooks.test.ts +642 -0
  245. package/src/tests/primitives-objects.test.ts +248 -0
  246. package/src/tests/reasoning-kind-ui-parity.test.ts +112 -0
  247. package/src/tests/script-native-sandbox-identity.test.ts +264 -0
  248. package/src/tests/scripts-namespaces.test.ts +211 -0
  249. package/src/tests/secret-scrub-gate.test.ts +1 -0
  250. package/src/tests/secret-scrubber-convex.test.ts +168 -0
  251. package/src/tests/secret-scrubber.test.ts +1 -1
  252. package/src/tests/session-tokens.test.ts +27 -0
  253. package/src/tests/sheet-engine.test.ts +58 -0
  254. package/src/tests/slack-file-tools-attachments.test.ts +74 -6
  255. package/src/tests/slack-read-boundaries.test.ts +4 -2
  256. package/src/tests/task-start-after-commit.test.ts +82 -0
  257. package/src/tests/ui-logs-parser.test.ts +67 -0
  258. package/src/tests/workflow-retry-v2.test.ts +101 -0
  259. package/src/tests/workflow-tla-races.test.ts +29 -0
  260. package/src/tools/boards.ts +260 -0
  261. package/src/tools/objects.ts +191 -0
  262. package/src/tools/sheets.ts +312 -0
  263. package/src/tools/slack-read.ts +10 -3
  264. package/src/tools/tool-config.ts +23 -0
  265. package/src/tools/workflows/create-workflow.ts +11 -1
  266. package/src/tools/workflows/patch-workflow-node.ts +4 -0
  267. package/src/tools/workflows/patch-workflow.ts +4 -0
  268. package/src/tools/workflows/update-workflow.ts +17 -0
  269. package/src/types.ts +16 -0
  270. package/src/utils/sandboxed-process.ts +47 -2
  271. package/src/utils/secret-scrubber.ts +61 -6
  272. package/src/workflows/engine.ts +35 -21
  273. package/src/workflows/input.ts +29 -1
  274. package/src/workflows/patch-definition.ts +15 -1
  275. package/src/workflows/retry-poller.ts +15 -2
  276. package/src/workflows/validation.ts +10 -0
  277. package/templates/ai-toolbox.manifest.json +1 -1
  278. package/templates/skills/agent-browser/SKILL.md +1 -0
  279. package/templates/skills/agent-browser/content.md +1 -0
  280. package/templates/skills/pages/content.md +5 -0
  281. package/templates/skills/swarm-docs/content.md +6 -1
  282. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  283. package/templates/skills/swarm-scripts/content.md +1 -0
  284. package/templates/skills/tdd-planning/content.md +5 -2
  285. package/dist/acp-adapter-weaaxey3.js +0 -16
  286. package/dist/core-df1n049h.js +0 -39
  287. package/dist/fx-adapter-zwmps9re.js +0 -19
  288. package/dist/grok-adapter-q0avf919.js +0 -19
  289. package/dist/handlers-g5jq0e4q.js +0 -36
  290. package/dist/index-1f6m47mq.js +0 -37
  291. package/dist/index-1p1mpqda.js +0 -36
  292. package/dist/index-tnkd410q.js +0 -41
  293. package/dist/lead-m5e7xt93.js +0 -75
  294. package/dist/thread-buffer-nf55vwx3.js +0 -39
  295. package/dist/worker-ews1nyhw.js +0 -75
  296. package/src/slack/socket-mode-guard.test.ts +0 -25
  297. package/src/tests/agent-activity.test.ts +0 -247
  298. package/src/tests/agent-fs-live-url.test.ts +0 -55
  299. package/src/tests/agentmail-inbox-mapping.test.ts +0 -73
  300. package/src/tests/approval-sweeps-config.test.ts +0 -47
  301. package/src/tests/cards.test.ts +0 -169
  302. package/src/tests/chat-sdk-facts.test.ts +0 -23
  303. package/src/tests/config-env-export-chat-sdk.test.ts +0 -11
  304. package/src/tests/core-auth.test.ts +0 -156
  305. package/src/tests/date-utils.test.ts +0 -48
  306. package/src/tests/db-context-versions.test.ts +0 -37
  307. package/src/tests/db-runtime.test.ts +0 -132
  308. package/src/tests/enabled-capabilities.test.ts +0 -20
  309. package/src/tests/extensions-example-mcp-install.test.ts +0 -67
  310. package/src/tests/extensions-lead-equivalence.test.ts +0 -70
  311. package/src/tests/get-workflow-run-tool.test.ts +0 -98
  312. package/src/tests/github-event-labels.test.ts +0 -24
  313. package/src/tests/haiku-5-5-pricing.test.ts +0 -38
  314. package/src/tests/http-log-scrubbing.test.ts +0 -123
  315. package/src/tests/http-semconv-attributes.test.ts +0 -92
  316. package/src/tests/identity.test.ts +0 -117
  317. package/src/tests/inbox-state.test.ts +0 -167
  318. package/src/tests/internal-ai/models.test.ts +0 -54
  319. package/src/tests/launch-password-rejection.test.ts +0 -140
  320. package/src/tests/list-total-cache.test.ts +0 -88
  321. package/src/tests/match-route.test.ts +0 -187
  322. package/src/tests/memory-feature-flags.test.ts +0 -45
  323. package/src/tests/memory-get-tool.test.ts +0 -269
  324. package/src/tests/memory-health-endpoint.test.ts +0 -78
  325. package/src/tests/memory-http-access.test.ts +0 -221
  326. package/src/tests/memory-retrieval-purge.test.ts +0 -99
  327. package/src/tests/multi-runtime-enabled-stats.test.ts +0 -229
  328. package/src/tests/openai-embedding-provider.test.ts +0 -159
  329. package/src/tests/org-identity.test.ts +0 -44
  330. package/src/tests/pages-actions-endpoint.test.ts +0 -103
  331. package/src/tests/pages-browser-sdk.test.ts +0 -76
  332. package/src/tests/pages-feedback-keys.test.ts +0 -121
  333. package/src/tests/pages-frame-ancestors.test.ts +0 -189
  334. package/src/tests/pages-list-endpoint.test.ts +0 -148
  335. package/src/tests/pages-password-mode.test.ts +0 -266
  336. package/src/tests/pages-public-authed-401.test.ts +0 -103
  337. package/src/tests/pages-public-html.test.ts +0 -297
  338. package/src/tests/pages-public-json-redirect.test.ts +0 -122
  339. package/src/tests/pages-view-count.test.ts +0 -245
  340. package/src/tests/prompt-templates-db.test.ts +0 -616
  341. package/src/tests/rbac-engine.test.ts +0 -742
  342. package/src/tests/repo-allow-merge-gate.test.ts +0 -389
  343. package/src/tests/route-def-find-route.test.ts +0 -192
  344. package/src/tests/runtime-stale-threshold.test.ts +0 -40
  345. package/src/tests/schedule-validation-helper.test.ts +0 -51
  346. package/src/tests/scheduled-tasks-api.test.ts +0 -355
  347. package/src/tests/scheduler-backoff.test.ts +0 -166
  348. package/src/tests/script-run-token.test.ts +0 -75
  349. package/src/tests/scripts-extract-signature.test.ts +0 -47
  350. package/src/tests/scripts-sdk-bridge-tool-failure.test.ts +0 -141
  351. package/src/tests/seed-workflow-dreaming.test.ts +0 -117
  352. package/src/tests/short-id.test.ts +0 -23
  353. package/src/tests/skill-files-http.test.ts +0 -222
  354. package/src/tests/skill-get-file-tool.test.ts +0 -110
  355. package/src/tests/skill-script-refs.test.ts +0 -63
  356. package/src/tests/skill-update-scope.test.ts +0 -252
  357. package/src/tests/skills-bundle.test.ts +0 -99
  358. package/src/tests/slack-app-icon.test.ts +0 -94
  359. package/src/tests/slack-assistant-comention.test.ts +0 -139
  360. package/src/tests/slack-delete.test.ts +0 -157
  361. package/src/tests/slack-inbound-diagnostics-auth.test.ts +0 -93
  362. package/src/tests/slack-manifest.test.ts +0 -23
  363. package/src/tests/slack-task-output.test.ts +0 -90
  364. package/src/tests/store-progress-output-guidance.test.ts +0 -34
  365. package/src/tests/swarm-diff.test.ts +0 -728
  366. package/src/tests/task-lifecycle-events.test.ts +0 -53
  367. package/src/tests/template-asset-config.test.ts +0 -18
  368. package/src/tests/template-fetch.test.ts +0 -490
  369. package/src/tests/themes-page-theme.test.ts +0 -155
  370. package/src/tests/tool-annotations.test.ts +0 -442
  371. package/src/tests/tool-output-agent-id.test.ts +0 -202
  372. package/src/tests/update-profile-agentid.test.ts +0 -248
  373. package/src/tests/whoami-route.test.ts +0 -162
  374. package/src/tests/workflow-definition-telemetry.test.ts +0 -144
  375. package/src/tests/workflow-patch.test.ts +0 -169
  376. package/src/tests/workflow-run-steps-index.test.ts +0 -65
  377. package/src/tests/workflow-schedule-trigger.test.ts +0 -104
  378. package/src/tests/workflow-step-claims.test.ts +0 -152
  379. package/src/tests/workflow-step-order.test.ts +0 -92
  380. package/src/tests/workflow-trigger-schema.test.ts +0 -359
  381. package/src/tests/workflow-versions.test.ts +0 -240
  382. package/src/tests/workflow-wait.test.ts +0 -26
package/src/types.ts CHANGED
@@ -1659,6 +1659,22 @@ export const AgentSchema = z
1659
1659
  })
1660
1660
  .openapi("Agent");
1661
1661
 
1662
+ /** One `agent_history` row (migration 334): a delete or restore, append-only. */
1663
+ export const AgentHistoryEventSchema = z
1664
+ .object({
1665
+ id: z.string(),
1666
+ agentId: z.string(),
1667
+ event: z.enum(["deleted", "restored"]),
1668
+ // `user:<id>` or the operator key fingerprint `op:<hex>`.
1669
+ actorRef: z.string(),
1670
+ reason: z.string(),
1671
+ // The `agents` row at the event, as stored columns.
1672
+ snapshot: z.record(z.string(), z.unknown()),
1673
+ createdAt: z.string(),
1674
+ })
1675
+ .openapi("AgentHistoryEvent");
1676
+ export type AgentHistoryEvent = z.infer<typeof AgentHistoryEventSchema>;
1677
+
1662
1678
  // ---------------------------------------------------------------------------
1663
1679
  // Worker-reported credential snapshot
1664
1680
  // ---------------------------------------------------------------------------
@@ -126,11 +126,52 @@ export type SandboxEnvironmentMode = {
126
126
  env: Readonly<Record<string, string>>;
127
127
  };
128
128
 
129
+ /** Identity a sandboxed child switches to before exec'ing the inner command. */
130
+ export interface SandboxIdentity {
131
+ uid: number;
132
+ gid: number;
133
+ }
134
+
135
+ /** `nobody:nogroup`: owns nothing the API process writes. */
136
+ export const UNPRIVILEGED_SANDBOX_IDENTITY: SandboxIdentity = { uid: 65534, gid: 65534 };
137
+
138
+ let warnedMissingSetpriv = false;
139
+
140
+ /**
141
+ * Identity the native script child should run as. An API running as root
142
+ * hands the child `nobody:nogroup` through `setpriv`, so script code cannot
143
+ * read root-owned 0600 files (the secrets key) or inspect the API process.
144
+ * A non-root API has no identity to drop to and keeps today's behavior.
145
+ */
146
+ export function resolveSandboxIdentity(
147
+ euid: number | undefined = process.geteuid?.(),
148
+ hasSetpriv: () => boolean = () => Bun.which("setpriv") !== null,
149
+ ): SandboxIdentity | undefined {
150
+ if (process.platform === "win32" || euid !== 0) return undefined;
151
+ if (!hasSetpriv()) {
152
+ // Every shipped image has util-linux; keep scripts working elsewhere, loudly.
153
+ if (!warnedMissingSetpriv) {
154
+ warnedMissingSetpriv = true;
155
+ console.warn(
156
+ "[scripts] running as root without setpriv: native script children keep the API's UID",
157
+ );
158
+ }
159
+ return undefined;
160
+ }
161
+ return UNPRIVILEGED_SANDBOX_IDENTITY;
162
+ }
163
+
164
+ function setprivPrefix(runAs: SandboxIdentity | undefined): string {
165
+ if (!runAs) return "";
166
+ return `setpriv --reuid=${runAs.uid} --regid=${runAs.gid} --clear-groups --no-new-privs `;
167
+ }
168
+
129
169
  function buildSandboxedCommandCore(
130
170
  innerCommand: readonly string[],
131
171
  limits: SandboxResourceLimits,
132
172
  profile: { useBashShell: boolean; applyInterpreterFloor: boolean },
133
173
  environment: SandboxEnvironmentMode,
174
+ runAs?: SandboxIdentity,
134
175
  ): string[] {
135
176
  if (process.platform === "win32") return [...innerCommand];
136
177
 
@@ -165,6 +206,8 @@ function buildSandboxedCommandCore(
165
206
  .join(" ")
166
207
  : "";
167
208
  const quotedInner = withBunNoOrphans(innerCommand).map(shellQuote).join(" ");
209
+ // After the ulimits: they are set as the caller and survive the UID switch.
210
+ const dropPrivileges = setprivPrefix(runAs);
168
211
 
169
212
  if (environment.kind === "spawn") {
170
213
  // -p ignores BASH_ENV and imported shell options/functions before ulimit.
@@ -175,14 +218,14 @@ function buildSandboxedCommandCore(
175
218
  "--norc",
176
219
  "-p",
177
220
  "-c",
178
- `${ulimits}; exec env -u PWD -u SHLVL ${quotedInner}`,
221
+ `${ulimits}; exec ${dropPrivileges}env -u PWD -u SHLVL ${quotedInner}`,
179
222
  ];
180
223
  }
181
224
 
182
225
  return [
183
226
  useBashShell ? "bash" : "sh",
184
227
  "-c",
185
- `${ulimits}; exec env -i ${envAssignments} ${quotedInner}`,
228
+ `${ulimits}; exec ${dropPrivileges}env -i ${envAssignments} ${quotedInner}`,
186
229
  ];
187
230
  }
188
231
 
@@ -191,6 +234,7 @@ export function buildSandboxedCommand(
191
234
  env: Readonly<Record<string, string>>,
192
235
  limits: SandboxResourceLimits = DEFAULT_SANDBOX_LIMITS,
193
236
  environmentKind: SandboxEnvironmentMode["kind"] = "inline",
237
+ runAs?: SandboxIdentity,
194
238
  ): string[] {
195
239
  return buildSandboxedCommandCore(
196
240
  innerCommand,
@@ -200,6 +244,7 @@ export function buildSandboxedCommand(
200
244
  applyInterpreterFloor: usesInterpreterSandboxProfile(innerCommand),
201
245
  },
202
246
  { kind: environmentKind, env },
247
+ runAs,
203
248
  );
204
249
  }
205
250
 
@@ -51,8 +51,13 @@ import { GITLEAKS_RULES } from "./secret-rules.generated";
51
51
  * v12 = the gitleaks global allowlist `^true|false|null$` is anchored as a
52
52
  * whole, so a secret containing "false", starting with "true" or ending with
53
53
  * "null" is no longer allowed.
54
+ * v13 = pass 2 redacts Convex deploy keys (`prod:`, `dev:`, `preview:`,
55
+ * `project:`; `|` or `%7C`), and pass 1 also matches each known value's
56
+ * URL-decoded and URL-encoded forms.
57
+ * v14 = pass 1 also matches a known value URL-encoded as stored, so a value
58
+ * with a literal `%` is redacted in its `%25` form.
54
59
  */
55
- export const SCRUBBER_RULES_VERSION = 12;
60
+ export const SCRUBBER_RULES_VERSION = 14;
56
61
 
57
62
  /** Env-var names that are always considered secrets, even without suffix hints. */
58
63
  const SENSITIVE_KEY_EXACT = new Set<string>([
@@ -185,13 +190,46 @@ export function normalizeKey(key: string): string {
185
190
  const MIN_VALUE_LENGTH = 12;
186
191
 
187
192
  /**
188
- * Every form a known value can take in a log line: raw, escaped inside shell
189
- * double quotes (`declare -x` / `export -p` prefix `\`, `$`, `"` and backtick
190
- * with a backslash), inside shell single quotes, and each of those again as a
191
- * JSON string body (session logs are JSONL).
193
+ * A known value, the value URL-encoded, its URL-decoded form and that form
194
+ * URL-encoded. A secret stored percent-encoded (`a%7Cb`) is often decoded
195
+ * before use (`${KEY//%7C/|}`), and a raw one is encoded into URLs, so any of
196
+ * these can reach a log without equalling the stored value. The stored value
197
+ * is encoded directly too: a literal `%` in it (`abc%41x`) makes the decoded
198
+ * form a different string, or makes decoding throw.
199
+ */
200
+ export function urlForms(value: string): string[] {
201
+ const forms = new Set([value]);
202
+ const addDerived = (derive: () => string[]) => {
203
+ try {
204
+ for (const form of derive()) forms.add(form);
205
+ } catch {
206
+ // Not valid percent-encoding, or a lone surrogate: skip this form.
207
+ }
208
+ };
209
+ addDerived(() => [encodeURIComponent(value)]);
210
+ addDerived(() => {
211
+ const decoded = decodeURIComponent(value);
212
+ return [decoded, encodeURIComponent(decoded)];
213
+ });
214
+ return [...forms];
215
+ }
216
+
217
+ /**
218
+ * Every form a known value can take in a log line: raw, URL-decoded and
219
+ * URL-encoded (see `urlForms`), each escaped inside shell double quotes
220
+ * (`declare -x` / `export -p` prefix `\`, `$`, `"` and backtick with a
221
+ * backslash), inside shell single quotes, and each of those again as a JSON
222
+ * string body (session logs are JSONL). A URL form shorter than
223
+ * MIN_VALUE_LENGTH is dropped; the caller has already checked `value`.
192
224
  */
193
225
  function escapedForms(value: string): string[] {
194
- const forms = new Set([value, value.replace(/[\\$"`]/g, "\\$&"), value.replaceAll("'", "'\\''")]);
226
+ const forms = new Set<string>();
227
+ for (const base of urlForms(value)) {
228
+ if (base !== value && base.length < MIN_VALUE_LENGTH) continue;
229
+ forms.add(base);
230
+ forms.add(base.replace(/[\\$"`]/g, "\\$&"));
231
+ forms.add(base.replaceAll("'", "'\\''"));
232
+ }
195
233
  for (const form of [...forms]) forms.add(JSON.stringify(form).slice(1, -1));
196
234
  return [...forms];
197
235
  }
@@ -504,6 +542,9 @@ const TB = String.raw`(?:(?<=\\[nrtbfu0])|(?<!\w))`;
504
542
  // ending in `-` has no word boundary after it, so `\b` backtracks and leaves
505
543
  // the last character behind.
506
544
 
545
+ /** A Convex deployment name, team slug or project slug. */
546
+ const CONVEX_SLUG = "[a-z0-9][a-z0-9-]{0,63}";
547
+
507
548
  const TOKEN_REGEXES: ReadonlyArray<{ name: string; lits: string[]; re: RegExp }> = [
508
549
  // GitHub fine-grained PATs
509
550
  { name: "github_pat", lits: ["github_pat_"], re: /github_pat_[A-Za-z0-9_]{20,}/g },
@@ -660,6 +701,20 @@ const TOKEN_REGEXES: ReadonlyArray<{ name: string; lits: string[]; re: RegExp }>
660
701
  lits: [":AA"],
661
702
  re: new RegExp(String.raw`${TB}\d{8,10}:AA[A-Za-z0-9_-]{33}(?![A-Za-z0-9_-])`, "g"),
662
703
  },
704
+ // Convex deploy keys and project tokens (docs.convex.dev/cli/deploy-key-types):
705
+ // `prod:<deployment>|<token>`, `dev:<deployment>|<token>`,
706
+ // `preview:<team>:<project>|<token>`, `project:<team>:<project>|<token>`.
707
+ // The `|` often arrives URL-encoded as `%7C`, and the base64 token's `+`, `/`
708
+ // and `=` as `%2B`, `%2F` and `%3D`. The 20-char token floor keeps prose
709
+ // (`prod: done`) and short URL params (`q=dev:a%7Cb`) out.
710
+ {
711
+ name: "convex_deploy_key",
712
+ lits: ["prod:", "dev:", "preview:", "project:"],
713
+ re: new RegExp(
714
+ String.raw`${TB}(?:(?:prod|dev):${CONVEX_SLUG}|(?:preview|project):${CONVEX_SLUG}:${CONVEX_SLUG})(?:\||%7[Cc])(?:[A-Za-z0-9+/_-]|%2[BbFf]){20,}(?:=|%3[Dd]){0,2}`,
715
+ "g",
716
+ ),
717
+ },
663
718
  ];
664
719
 
665
720
  /**
@@ -49,7 +49,11 @@ import {
49
49
  systemOneUnresolvedError,
50
50
  } from "./executors/system-one-decision";
51
51
  import { parkAndDriveForeach } from "./foreach-driver";
52
- import { FOREACH_TERMINAL_STEP_STATUSES, resolveForeachParent } from "./foreach-join";
52
+ import {
53
+ FOREACH_TERMINAL_STEP_STATUSES,
54
+ isRetryPending,
55
+ resolveForeachParent,
56
+ } from "./foreach-join";
53
57
  import { getSecretInputKeys, redactSecretsForStorage, resolveInputs } from "./input";
54
58
  import { validateJsonSchema } from "./json-schema-validator";
55
59
  import { getMaxWorkflowStepsPerRun } from "./limits";
@@ -61,7 +65,7 @@ import {
61
65
  type SuccessorWalkDebt,
62
66
  } from "./successor-routing";
63
67
  import { deepInterpolate } from "./template";
64
- import { runStepValidation, type ValidationRunResult } from "./validation";
68
+ import { runStepValidation, type ValidationRunResult, validateOutputSchema } from "./validation";
65
69
 
66
70
  // Read dynamically, NOT captured at module load: `src/http/index.ts` imports
67
71
  // this module before `loadGlobalConfigsIntoEnv()` hydrates `swarm_config` into
@@ -667,7 +671,13 @@ async function walkGraphOwned(
667
671
  const activePreds = allPreds.filter(
668
672
  (predId) => activeEdges.has(`${predId}→${nodeId}`) || batchAwaited.has(predId),
669
673
  );
670
- const allActivePredsCompleted = activePreds.every((p) => completedNodeIds.has(p));
674
+ // A branch pending its retry was added to completedNodeIds by this walk
675
+ // (executeStep reports it as completed with no successors), but its
676
+ // output does not exist yet: hold the join until the retry settles.
677
+ const allActivePredsCompleted = activePreds.every((p) => {
678
+ const latest = batchLatest.get(p);
679
+ return completedNodeIds.has(p) && !(latest && isRetryPending(latest));
680
+ });
671
681
 
672
682
  if (allActivePredsCompleted) {
673
683
  readyNext.push(node);
@@ -759,17 +769,20 @@ function latestStepByNode(steps: WorkflowRunStep[]): Map<string, WorkflowRunStep
759
769
 
760
770
  /**
761
771
  * Nodes a join must wait for even without an active edge to it: the node's
762
- * latest step is running or waiting, or a predecessor routed to it and it has
763
- * no step yet. A terminally failed node is not awaited, so partial failure
764
- * still lets the join run. An older `running` row superseded by a newer one
765
- * (crash recovery) and the `pending` row a user retry leaves behind are
766
- * ignored because only the latest step counts.
772
+ * latest step is running, waiting, or failed with a retry pending, or a
773
+ * predecessor routed to it and it has no step yet. A terminally failed node
774
+ * (no retry left) is not awaited, so partial failure still lets the join run.
775
+ * An older `running` row superseded by a newer one (crash recovery) and the
776
+ * `pending` row a user retry leaves behind are ignored because only the
777
+ * latest step counts.
767
778
  */
768
779
  function awaitedNodeIds(steps: WorkflowRunStep[], activeEdges: Set<string>): Set<string> {
769
780
  const latest = latestStepByNode(steps);
770
781
  const awaited = new Set<string>();
771
782
  for (const [nodeId, step] of latest) {
772
- if (step.status === "running" || step.status === "waiting") awaited.add(nodeId);
783
+ if (step.status === "running" || step.status === "waiting" || isRetryPending(step)) {
784
+ awaited.add(nodeId);
785
+ }
773
786
  }
774
787
  for (const edge of activeEdges) {
775
788
  const target = edge.slice(edge.indexOf("→") + 1);
@@ -1200,19 +1213,20 @@ async function runClaimedStep(
1200
1213
  }
1201
1214
 
1202
1215
  // 6b. Validate output against node-level outputSchema if defined
1203
- if (node.outputSchema && result.status === "success") {
1204
- const outputErrors = validateJsonSchema(
1205
- node.outputSchema as Record<string, unknown>,
1206
- result.output,
1207
- );
1208
- if (outputErrors.length > 0) {
1209
- const errorMsg = `Output schema validation failed: ${outputErrors.join("; ")}`;
1210
- const { stale: lost } = await checkpointStepFailure(runId, stepId, errorMsg, 0, undefined, {
1216
+ const outputSchemaError = validateOutputSchema(node, result);
1217
+ if (outputSchemaError) {
1218
+ const { stale: lost } = await checkpointStepFailure(
1219
+ runId,
1220
+ stepId,
1221
+ outputSchemaError,
1222
+ 0,
1223
+ undefined,
1224
+ {
1211
1225
  fence,
1212
- });
1213
- if (lost) return stale;
1214
- throw new Error(errorMsg);
1215
- }
1226
+ },
1227
+ );
1228
+ if (lost) return stale;
1229
+ throw new Error(outputSchemaError);
1216
1230
  }
1217
1231
 
1218
1232
  // 7. Run validation if configured
@@ -1,4 +1,5 @@
1
- import { getSwarmConfigs } from "../be/db";
1
+ import { getAgentById, getSwarmConfigs } from "../be/db";
2
+ import { can } from "../rbac/can";
2
3
  import { isSensitiveKey } from "../utils/secret-scrubber";
3
4
 
4
5
  /**
@@ -53,6 +54,33 @@ export async function resolveInputValue(value: string): Promise<string> {
53
54
  return value;
54
55
  }
55
56
 
57
+ /**
58
+ * Input keys whose value `resolveInputValue` reads with the API server's own
59
+ * authority: `${ENV_VAR}` (server process env) or `secret.NAME` (global secrets).
60
+ * Writers may store these only with `config.read.secrets`.
61
+ */
62
+ export function serverRefInputKeys(input: Record<string, unknown> | null | undefined): string[] {
63
+ if (!input) return [];
64
+ return Object.entries(input)
65
+ .filter(([, v]) => typeof v === "string" && (/^\$\{(.+)\}$/.test(v) || v.startsWith("secret.")))
66
+ .map(([k]) => k);
67
+ }
68
+
69
+ export function serverRefInputDeniedMessage(keys: string[]): string {
70
+ return `Input ${keys.map((k) => `"${k}"`).join(", ")} references an env var or swarm secret (\${VAR} / secret.NAME); setting it requires config.read.secrets.`;
71
+ }
72
+
73
+ /** Whether an agent may store `${ENV_VAR}` / `secret.NAME` workflow input (same gate as get-config). */
74
+ export async function agentMaySetServerRefInput(agentId: string): Promise<boolean> {
75
+ const agent = await getAgentById(agentId);
76
+ return can({
77
+ principal: { kind: "agent", agentId, isLead: agent?.isLead ?? false },
78
+ verb: "config.read.secrets",
79
+ resource: { kind: "none" },
80
+ source: "mcp",
81
+ }).allow;
82
+ }
83
+
56
84
  /**
57
85
  * Marker placed in persisted step inputs in place of a secret value.
58
86
  * Kept short and stable so future readers (logs, debug tools) can grep for it.
@@ -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,25 @@ 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 stored
42
+ * input holds `${ENV_VAR}` / `secret.NAME` references then refuses the
43
+ * patch, since a node edit decides where those resolved values go.
44
+ */
45
+ serverRefInputAllowed?: boolean;
39
46
  }): Promise<PatchWorkflowDefinitionResult> {
40
47
  const { id, patch, registry, snapshotAgentId, snapshotOptional, updates } = options;
41
48
  return await getDbClient().transaction(async (): Promise<PatchWorkflowDefinitionResult> => {
42
49
  const existing = await getWorkflow(id);
43
50
  if (!existing) return { ok: false, reason: "not_found" };
44
51
 
52
+ if (options.serverRefInputAllowed === false) {
53
+ const refKeys = serverRefInputKeys(existing.input);
54
+ if (refKeys.length > 0) {
55
+ return { ok: false, reason: "forbidden", errors: [serverRefInputDeniedMessage(refKeys)] };
56
+ }
57
+ }
58
+
45
59
  const patchResult = applyDefinitionPatch(existing.definition, patch);
46
60
  if (patchResult.errors.length > 0) {
47
61
  return { ok: false, reason: "patch", errors: patchResult.errors };
@@ -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(
@@ -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
 
@@ -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.
@@ -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
@@ -63,11 +63,15 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
63
63
  - [Choosing an AI operating model](https://docs.agent-swarm.dev/docs/guides/choosing-an-ai-operating-model). Reference.
64
64
  - [Small tech team operating model](https://docs.agent-swarm.dev/docs/guides/small-tech-team-operating-model). Reference.
65
65
  - [Customer renewal review](https://docs.agent-swarm.dev/docs/guides/customer-renewal-review). Reference.
66
+ - [Customer commitment tracking](https://docs.agent-swarm.dev/docs/guides/customer-commitment-tracking). Reference.
66
67
  - [Reviewing supplier invoice and purchase order discrepancies with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-invoice-discrepancy-review). Reference.
68
+ - [Handing off unresolved operational work between shifts with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-operations-shift-handoff). Reference.
69
+ - [Reviewing a supplier's security evidence before onboarding with AI agents](https://docs.agent-swarm.dev/docs/guides/supplier-security-evidence-review). Reference.
67
70
  - [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
71
  - [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
72
  - [Kubernetes and Helm](https://docs.agent-swarm.dev/docs/guides/kubernetes). When: Someone wants to install Agent Swarm on Kubernetes.
70
73
  - [Worker Recovery: What Happens to Running Work When a Worker Stops](https://docs.agent-swarm.dev/docs/guides/worker-recovery-decision). Reference.
74
+ - [Deleting and Restoring Agents](https://docs.agent-swarm.dev/docs/guides/agent-deletion). Reference.
71
75
  - [Rootless Podman](https://docs.agent-swarm.dev/docs/guides/podman-rootless). When: Someone wants to run Agent Swarm under rootless Podman.
72
76
  - [Published Artifacts](https://docs.agent-swarm.dev/docs/guides/published-artifacts). Reference.
73
77
  - [Asset Namespaces](https://docs.agent-swarm.dev/docs/guides/asset-namespaces). Reference.
@@ -78,7 +82,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
78
82
  - [Evals Harness](https://docs.agent-swarm.dev/docs/guides/evals-harness). Reference.
79
83
  - [Personalization & Status](https://docs.agent-swarm.dev/docs/guides/personalization). Reference.
80
84
  - [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.
85
+ - [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
86
  - [Provider Capability Matrix](https://docs.agent-swarm.dev/docs/guides/provider-capability-matrix). Reference.
83
87
  - [Adding a Harness Provider](https://docs.agent-swarm.dev/docs/guides/harness-providers). Reference.
84
88
  - [Steer a Running Task](https://docs.agent-swarm.dev/docs/guides/task-steering). Reference.
@@ -113,6 +117,7 @@ Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/do
113
117
  - [Multi-runtime agents](https://docs.agent-swarm.dev/docs/guides/multi-runtime-agents). Reference.
114
118
  - [Runtime pools (beta)](https://docs.agent-swarm.dev/docs/guides/runtime-pools). Reference.
115
119
  - [boxd runtime provider](https://docs.agent-swarm.dev/docs/guides/boxd-runtime-provider). Reference.
120
+ - [Coordinating delivery delay investigations between operations and support with AI agents](https://docs.agent-swarm.dev/docs/guides/ai-delivery-delay-handoff). Reference.
116
121
  - [Reviewing customer help content for conflicts with AI agents](https://docs.agent-swarm.dev/docs/guides/support-knowledge-conflict-review). Reference.
117
122
 
118
123
  ## 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
- };