@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
@@ -13,6 +13,7 @@ import {
13
13
  import type { WorkflowPatch } from "@/types";
14
14
  import { AssetKeySchema, WorkflowNodePatchSchema } from "@/types";
15
15
  import { getExecutorRegistry } from "@/workflows";
16
+ import { agentMaySetServerRefInput } from "@/workflows/input";
16
17
  import { patchWorkflowDefinition } from "@/workflows/patch-definition";
17
18
  import { withSaveWarnings, workflowSaveWarnings } from "@/workflows/readiness";
18
19
 
@@ -85,11 +86,14 @@ export const registerPatchWorkflowTool = (server: McpServer) => {
85
86
  async ({ id, key, update, delete: del, create, onNodeFailure, triggerSchema }, requestInfo) => {
86
87
  try {
87
88
  const updatedBy =
88
- (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
89
+ (await resolveTaskAuditUserId(requestInfo.auditSourceTaskId, requestInfo.agentId)) ??
89
90
  undefined;
90
91
  const updates: Omit<Parameters<typeof updateWorkflow>[1], "definition"> = {};
91
92
  if (key !== undefined) {
92
- updates.key = await authorizeAssetKeyWrite(key, updatedBy);
93
+ updates.key = await authorizeAssetKeyWrite(
94
+ key,
95
+ await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId),
96
+ );
93
97
  }
94
98
  if (triggerSchema !== undefined) {
95
99
  updates.triggerSchema = triggerSchema;
@@ -108,6 +112,8 @@ export const registerPatchWorkflowTool = (server: McpServer) => {
108
112
  },
109
113
  registry: getExecutorRegistry(),
110
114
  snapshotAgentId: requestInfo.agentId,
115
+ serverRefInputAllowed:
116
+ !!requestInfo.agentId && (await agentMaySetServerRefInput(requestInfo.agentId)),
111
117
  updates,
112
118
  });
113
119
  if (!result.ok) {
@@ -115,6 +121,7 @@ export const registerPatchWorkflowTool = (server: McpServer) => {
115
121
  if (result.reason === "patch") {
116
122
  return toolErr(`Patch errors: ${result.errors.join("; ")}`);
117
123
  }
124
+ if (result.reason === "forbidden") return toolErr(result.errors.join("; "));
118
125
  return toolErr(`Invalid definition: ${result.errors.join("; ")}`);
119
126
  }
120
127
  const { workflow, version } = result;
@@ -19,6 +19,11 @@ import {
19
19
  } from "@/types";
20
20
  import { getExecutorRegistry } from "@/workflows";
21
21
  import { definitionNodeIds, validateDefinition } from "@/workflows/definition";
22
+ import {
23
+ agentMaySetServerRefInput,
24
+ serverRefInputDeniedMessage,
25
+ serverRefInputKeys,
26
+ } from "@/workflows/input";
22
27
  import { workflowModelErrors } from "@/workflows/model-validation";
23
28
  import { withSaveWarnings, workflowSaveWarnings } from "@/workflows/readiness";
24
29
  import { snapshotAndUpdateWorkflow } from "@/workflows/version";
@@ -37,7 +42,7 @@ export const registerUpdateWorkflowTool = (server: McpServer) => {
37
42
  "Other JSON-Schema keywords (oneOf/anyOf/$ref/pattern/format/additionalProperties) are silently ignored. " +
38
43
  "WEBHOOK VERIFICATION: webhook triggers use hmacSecret for all verification formats. " +
39
44
  "Omit verification for legacy HMAC-SHA256 over the raw body with fallback header scanning; " +
40
- "or set verification to { format: 'hmac-sha256', header }, { format: 'timestamped-hmac-sha256', header, toleranceSeconds? }, " +
45
+ "or set verification to { format: 'hmac-sha256', header }, { format: 'hmac-sha1', header }, { format: 'timestamped-hmac-sha256', header, toleranceSeconds? }, " +
41
46
  "{ format: 'token-equality', header }, or { format: 'standard-webhooks', toleranceSeconds? } " +
42
47
  "(standardwebhooks.com: webhook-id/webhook-timestamp/webhook-signature headers, hmacSecret is the whsec_ signing secret). " +
43
48
  "WEBHOOK DELIVERY FILTER: optional filter on a webhook trigger drops deliveries after signature verification and before any run is saved " +
@@ -56,7 +61,7 @@ export const registerUpdateWorkflowTool = (server: McpServer) => {
56
61
  .array(TriggerConfigSchema)
57
62
  .optional()
58
63
  .describe(
59
- "Replacement trigger list. A webhook trigger accepts filter (headers and body allowlists) and preset (github, gitlab, standard-webhooks). events and eventHeader remain a deprecated alias of one filter clause. Verification formats: legacy omitted verification, hmac-sha256, timestamped-hmac-sha256, token-equality, standard-webhooks.",
64
+ "Replacement trigger list. A webhook trigger accepts filter (headers and body allowlists) and preset (github, gitlab, standard-webhooks). events and eventHeader remain a deprecated alias of one filter clause. Verification formats: legacy omitted verification, hmac-sha256, hmac-sha1, timestamped-hmac-sha256, token-equality, standard-webhooks.",
60
65
  ),
61
66
  cooldown: CooldownConfigSchema.optional()
62
67
  .nullable()
@@ -143,11 +148,29 @@ export const registerUpdateWorkflowTool = (server: McpServer) => {
143
148
  }
144
149
  }
145
150
 
151
+ // New ref input, or a new definition over stored ref input, decides
152
+ // where server-resolved values go: both need config.read.secrets.
153
+ const refKeys =
154
+ input !== undefined || definition
155
+ ? serverRefInputKeys(input !== undefined ? input : existing.input, existing.params)
156
+ : [];
157
+ if (
158
+ refKeys.length > 0 &&
159
+ !(requestInfo.agentId && (await agentMaySetServerRefInput(requestInfo.agentId)))
160
+ ) {
161
+ return toolErr(serverRefInputDeniedMessage(refKeys));
162
+ }
163
+
146
164
  const updatedBy =
147
- (await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId)) ??
165
+ (await resolveTaskAuditUserId(requestInfo.auditSourceTaskId, requestInfo.agentId)) ??
148
166
  undefined;
149
167
  const assetKey =
150
- key === undefined ? undefined : await authorizeAssetKeyWrite(key, updatedBy);
168
+ key === undefined
169
+ ? undefined
170
+ : await authorizeAssetKeyWrite(
171
+ key,
172
+ await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId),
173
+ );
151
174
  // Snapshot + update in one transaction: concurrent full updates would
152
175
  // otherwise allocate the same version number, and the loser would
153
176
  // fail (or worse, commit with no history row).
package/src/types.ts CHANGED
@@ -126,16 +126,18 @@ export const DEFAULT_MODEL_TIER_MAP: Record<ProviderName, Record<ModelTier, stri
126
126
  ultra: "fable",
127
127
  },
128
128
  "claude-managed": {
129
- smol: "claude-haiku-4-5",
130
- regular: "claude-sonnet-5",
131
- smart: "claude-opus-4-8",
132
- ultra: "claude-fable-5",
129
+ smol: "claude-haiku-5-5",
130
+ regular: "claude-sonnet-5-5",
131
+ smart: "claude-opus-5-5",
132
+ ultra: "claude-fable-5-1",
133
133
  },
134
+ // The newest model of each GPT family (luna, terra, sol, astra) in the
135
+ // catalog; apps/ui/src/lib/model-catalog-drift.test.ts fails when one ages.
134
136
  codex: {
135
- smol: "gpt-5.6-luna",
136
- regular: "gpt-5.6-terra",
137
- smart: "gpt-5.6-sol",
138
- ultra: "gpt-5.6-sol",
137
+ smol: "gpt-6-luna",
138
+ regular: "gpt-6.1-terra",
139
+ smart: "gpt-6.1-sol",
140
+ ultra: "gpt-6-astra",
139
141
  },
140
142
  pi: {
141
143
  smol: "openrouter/deepseek/deepseek-v4.1-flash",
@@ -1431,6 +1433,8 @@ export const FavoriteItemTypeSchema = z.enum([
1431
1433
  "schedule",
1432
1434
  "agent-fs-path",
1433
1435
  "key",
1436
+ "session",
1437
+ "hidden-key",
1434
1438
  ]);
1435
1439
  export type FavoriteItemType = z.infer<typeof FavoriteItemTypeSchema>;
1436
1440
 
@@ -1659,6 +1663,22 @@ export const AgentSchema = z
1659
1663
  })
1660
1664
  .openapi("Agent");
1661
1665
 
1666
+ /** One `agent_history` row (migration 334): a delete or restore, append-only. */
1667
+ export const AgentHistoryEventSchema = z
1668
+ .object({
1669
+ id: z.string(),
1670
+ agentId: z.string(),
1671
+ event: z.enum(["deleted", "restored"]),
1672
+ // `user:<id>` or the operator key fingerprint `op:<hex>`.
1673
+ actorRef: z.string(),
1674
+ reason: z.string(),
1675
+ // The `agents` row at the event, as stored columns.
1676
+ snapshot: z.record(z.string(), z.unknown()),
1677
+ createdAt: z.string(),
1678
+ })
1679
+ .openapi("AgentHistoryEvent");
1680
+ export type AgentHistoryEvent = z.infer<typeof AgentHistoryEventSchema>;
1681
+
1662
1682
  // ---------------------------------------------------------------------------
1663
1683
  // Worker-reported credential snapshot
1664
1684
  // ---------------------------------------------------------------------------
@@ -2222,6 +2242,7 @@ export const ScheduledTaskSchema = z
2222
2242
  lastRunAt: z.iso.datetime().optional(),
2223
2243
  nextRunAt: z.iso.datetime().optional(),
2224
2244
  createdByAgentId: z.string().optional(),
2245
+ updatedByAgentId: z.string().optional(),
2225
2246
  // Set only by `defer-task`: the task this schedule wakes up to continue.
2226
2247
  // Passed through as the created task's `parentTaskId`.
2227
2248
  parentTaskId: z.string().optional(),
@@ -2318,21 +2339,72 @@ export type SwarmConfig = z.infer<typeof SwarmConfigSchema>;
2318
2339
  // Swarm Repos Types (Centralized Repository Management)
2319
2340
  // ============================================================================
2320
2341
 
2342
+ /** Upper bound per guideline list. The repository prompt section renders every
2343
+ * entry outside the bootstrap budget, so the cap lives at the write boundary. */
2344
+ export const REPO_GUIDELINES_MAX_ENTRIES = 50;
2345
+
2346
+ /**
2347
+ * One merge-policy record per repo, stored inside `swarm_repos.guidelines` (a JSON text column,
2348
+ * so no migration). The prompt generator reads it; the swarm-config scorer and merge scripts read
2349
+ * it through `get-repos`. An empty `baseScores`, `maxLines`, `riskyPaths` or `classes` means "use
2350
+ * the scorer's built-in value".
2351
+ */
2352
+ export const RepoMergePolicySchema = z
2353
+ .object({
2354
+ autoMerge: z
2355
+ .object({
2356
+ /** Kill switch: false keeps the swarm from enqueuing a PR on its own. */
2357
+ enabled: z.boolean().default(false),
2358
+ /** Minimum score (0-100) for a PR to qualify. */
2359
+ threshold: z.number().int().min(0).max(100).default(80),
2360
+ /** Base score per PR class, e.g. `{ docs: 85 }`. */
2361
+ baseScores: z
2362
+ .record(z.string().min(1).max(60), z.number().int().min(0).max(100))
2363
+ .default({}),
2364
+ /** Hard size cap per PR class, in code lines. */
2365
+ maxLines: z
2366
+ .record(z.string().min(1).max(60), z.number().int().min(0).max(100000))
2367
+ .default({}),
2368
+ /** Path globs that always keep a PR out of auto-merge. */
2369
+ riskyPaths: z
2370
+ .array(z.string().min(1).max(200))
2371
+ .max(REPO_GUIDELINES_MAX_ENTRIES)
2372
+ .default([]),
2373
+ /** PR classes allowed to auto-merge. */
2374
+ classes: z.array(z.string().min(1).max(60)).max(REPO_GUIDELINES_MAX_ENTRIES).default([]),
2375
+ })
2376
+ .optional(),
2377
+ /** Whether an agent may merge a PR itself. Absent: reads fall back to `allowMerge`. */
2378
+ agentsMayMerge: z.boolean().optional(),
2379
+ notify: z
2380
+ .object({
2381
+ /** DM the requester when a PR will not auto-merge. */
2382
+ dmWhenNotAutoMerging: z.boolean().default(true),
2383
+ /** Daily digest time, `HH:MM` in `timezone`. */
2384
+ digestAt: z
2385
+ .string()
2386
+ .regex(/^([01]\d|2[0-3]):[0-5]\d$/)
2387
+ .optional(),
2388
+ timezone: z.string().min(1).max(60).optional(),
2389
+ })
2390
+ .optional(),
2391
+ })
2392
+ .openapi("RepoMergePolicy");
2393
+
2394
+ export type RepoMergePolicy = z.infer<typeof RepoMergePolicySchema>;
2395
+
2321
2396
  export const RepoGuidelinesSchema = z
2322
2397
  .object({
2323
2398
  prChecks: z.array(z.string()),
2324
2399
  mergeChecks: z.array(z.string()),
2325
2400
  allowMerge: z.boolean().optional().default(false),
2326
2401
  review: z.array(z.string()),
2402
+ mergePolicy: RepoMergePolicySchema.optional(),
2327
2403
  })
2328
2404
  .openapi("RepoGuidelines");
2329
2405
 
2330
2406
  export type RepoGuidelines = z.infer<typeof RepoGuidelinesSchema>;
2331
2407
 
2332
- /** Upper bound per guideline list. The repository prompt section renders every
2333
- * entry outside the bootstrap budget, so the cap lives at the write boundary. */
2334
- export const REPO_GUIDELINES_MAX_ENTRIES = 50;
2335
-
2336
2408
  /** Write-side guidelines schema: same shape, bounded lists. Reads keep the
2337
2409
  * unbounded `RepoGuidelinesSchema` so an older row never fails a response. */
2338
2410
  export const RepoGuidelinesInputSchema = z
@@ -2341,9 +2413,17 @@ export const RepoGuidelinesInputSchema = z
2341
2413
  mergeChecks: z.array(z.string()).max(REPO_GUIDELINES_MAX_ENTRIES),
2342
2414
  allowMerge: z.boolean().optional().default(false),
2343
2415
  review: z.array(z.string()).max(REPO_GUIDELINES_MAX_ENTRIES),
2416
+ mergePolicy: RepoMergePolicySchema.optional(),
2344
2417
  })
2345
2418
  .openapi("RepoGuidelinesInput");
2346
2419
 
2420
+ /** Whether agents may merge a PR themselves: the record's `agentsMayMerge`, else today's `allowMerge`. */
2421
+ export function agentsMayMerge(
2422
+ g: { allowMerge?: boolean; mergePolicy?: { agentsMayMerge?: boolean } | null } | null | undefined,
2423
+ ): boolean {
2424
+ return g?.mergePolicy?.agentsMayMerge ?? g?.allowMerge === true;
2425
+ }
2426
+
2347
2427
  export const RepoHooksSchema = z
2348
2428
  .object({
2349
2429
  enabled: z.boolean().default(false),
@@ -2871,6 +2951,15 @@ export const WebhookVerificationSchema = z.discriminatedUnion("format", [
2871
2951
  "Header containing HMAC-SHA256 over the raw request body. Accepts sha256=<hex> or bare hex.",
2872
2952
  ),
2873
2953
  }),
2954
+ z.object({
2955
+ format: z.literal("hmac-sha1"),
2956
+ header: z
2957
+ .string()
2958
+ .default("X-Hub-Signature")
2959
+ .describe(
2960
+ "Header containing HMAC-SHA1 over the raw request body. Accepts sha1=<hex> or bare hex.",
2961
+ ),
2962
+ }),
2874
2963
  z.object({
2875
2964
  format: z.literal("timestamped-hmac-sha256"),
2876
2965
  header: z
@@ -3179,6 +3268,7 @@ export const WorkflowSchema = z
3179
3268
  dir: z.string().min(1).startsWith("/").optional(),
3180
3269
  vcsRepo: z.string().min(1).optional(),
3181
3270
  createdByAgentId: z.string().optional(),
3271
+ updatedByAgentId: z.string().optional(),
3182
3272
  createdAt: z.string(),
3183
3273
  lastUpdatedAt: z.string(),
3184
3274
  createdBy: z.string().optional(),
@@ -3817,6 +3907,10 @@ export const ScriptRecordSchema = z
3817
3907
  fsMode: ScriptFsModeSchema,
3818
3908
  executor: ScriptExecutorNameSchema.nullable().default(null),
3819
3909
  createdByAgentId: z.string().nullable(),
3910
+ // Audit: last writing agent, and the person behind the create / last update.
3911
+ updatedByAgentId: z.string().nullable().default(null),
3912
+ createdBy: z.string().nullable().default(null),
3913
+ updatedBy: z.string().nullable().default(null),
3820
3914
  createdAt: z.string(),
3821
3915
  updatedAt: z.string(),
3822
3916
  })
@@ -4195,6 +4289,12 @@ export const SkillSchema = z
4195
4289
  .int()
4196
4290
  .describe("Confirmed invocations across all harnesses, at most one per runner session"),
4197
4291
  lastInvokedAt: z.string().nullable(),
4292
+ // Audit: who created / last updated the skill (agent and person). NULL on
4293
+ // seeded and system rows. ownerAgentId is ownership, not the creator.
4294
+ createdByAgentId: z.string().nullable().default(null),
4295
+ updatedByAgentId: z.string().nullable().default(null),
4296
+ createdBy: z.string().nullable().default(null),
4297
+ updatedBy: z.string().nullable().default(null),
4198
4298
  createdAt: z.string(),
4199
4299
  lastUpdatedAt: z.string(),
4200
4300
  lastFetchedAt: z.string().nullable(),
@@ -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,6 @@
1
- import { getSwarmConfigs } from "../be/db";
1
+ import { renderAutomationTokens } from "../be/automation-preflight";
2
+ import { getAgentById, getSwarmConfigs } from "../be/db";
3
+ import { can } from "../rbac/can";
2
4
  import { isSensitiveKey } from "../utils/secret-scrubber";
3
5
 
4
6
  /**
@@ -53,6 +55,39 @@ export async function resolveInputValue(value: string): Promise<string> {
53
55
  return value;
54
56
  }
55
57
 
58
+ /**
59
+ * Input keys whose value `resolveInputValue` reads with the API server's own
60
+ * authority: `${ENV_VAR}` (server process env) or `secret.NAME` (global secrets).
61
+ * Writers may store these only with `config.read.secrets`. The run renders
62
+ * `params` into input before resolving it, so a key counts when its stored or
63
+ * its param-rendered value is a ref.
64
+ */
65
+ export function serverRefInputKeys(
66
+ input: Record<string, unknown> | null | undefined,
67
+ params?: Record<string, unknown> | null,
68
+ ): string[] {
69
+ if (!input) return [];
70
+ const rendered = params ? renderAutomationTokens(input, params) : input;
71
+ const isRef = (v: unknown) =>
72
+ typeof v === "string" && (/^\$\{(.+)\}$/.test(v) || v.startsWith("secret."));
73
+ return Object.keys(input).filter((k) => isRef(input[k]) || isRef(rendered[k]));
74
+ }
75
+
76
+ export function serverRefInputDeniedMessage(keys: string[]): string {
77
+ return `Input ${keys.map((k) => `"${k}"`).join(", ")} references an env var or swarm secret (\${VAR} / secret.NAME); setting it requires config.read.secrets.`;
78
+ }
79
+
80
+ /** Whether an agent may store `${ENV_VAR}` / `secret.NAME` workflow input (same gate as get-config). */
81
+ export async function agentMaySetServerRefInput(agentId: string): Promise<boolean> {
82
+ const agent = await getAgentById(agentId);
83
+ return can({
84
+ principal: { kind: "agent", agentId, isLead: agent?.isLead ?? false },
85
+ verb: "config.read.secrets",
86
+ resource: { kind: "none" },
87
+ source: "mcp",
88
+ }).allow;
89
+ }
90
+
56
91
  /**
57
92
  * Marker placed in persisted step inputs in place of a secret value.
58
93
  * Kept short and stable so future readers (logs, debug tools) can grep for it.