@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
package/src/http/pages.ts CHANGED
@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
2
2
  import type { IncomingMessage, ServerResponse } from "node:http";
3
3
  import { z } from "zod";
4
4
  import { AssetKeyAuthorizationError, authorizeAssetKeyWrite } from "../be/asset-key-auth";
5
- import { resolveHttpAuditUserId } from "../be/audit-user";
5
+ import { resolveHttpRequesterUserId } from "../be/audit-user";
6
6
  import {
7
7
  countAllPages,
8
8
  countPagesByAgent,
@@ -631,7 +631,7 @@ export async function handlePages(
631
631
  const key = parsed.body.key
632
632
  ? await authorizeAssetKeyWrite(
633
633
  parsed.body.key,
634
- await resolveHttpAuditUserId(req, myAgentId),
634
+ await resolveHttpRequesterUserId(req, myAgentId),
635
635
  )
636
636
  : undefined;
637
637
  const page = await createPage({
@@ -878,7 +878,7 @@ export async function handlePages(
878
878
  try {
879
879
  key = await authorizeAssetKeyWrite(
880
880
  parsed.body.key,
881
- await resolveHttpAuditUserId(req, myAgentId),
881
+ await resolveHttpRequesterUserId(req, myAgentId),
882
882
  );
883
883
  } catch (error) {
884
884
  if (error instanceof AssetKeyAuthorizationError) {
package/src/http/poll.ts CHANGED
@@ -28,12 +28,17 @@ import {
28
28
  } from "../be/db";
29
29
  import { checkProfileForAgent } from "../be/model-profile-check";
30
30
  import {
31
+ modelTierOverridesDiffer,
31
32
  parseModelTierOverridesHeader,
32
33
  recordClaimModelResolution,
33
34
  setAgentModelTierOverrides,
34
35
  } from "../be/model-tier-resolution";
35
36
  import { poolTaskRunsOnHarness } from "../be/model-validation";
36
- import { getRuntimeInstanceById, touchRuntimeInstance } from "../be/multi-runtime";
37
+ import {
38
+ getRuntimeInstanceById,
39
+ isRuntimeInstanceFresh,
40
+ touchRuntimeInstance,
41
+ } from "../be/multi-runtime";
37
42
  import { hasCapability } from "../server";
38
43
  import { fetchChannelActivity } from "../slack/channel-activity";
39
44
  import { type TaskModelPinFields, taskModelPin } from "../tasks/model-pin";
@@ -208,6 +213,9 @@ const pollTriggers = route({
208
213
 
209
214
  // ─── Channel Activity Throttle ──────────────────────────────────────────────
210
215
 
216
+ /** The idle-poll probe hit a write: rerun the poll under the write lock. */
217
+ const NEEDS_WRITE = Symbol("poll-needs-write");
218
+
211
219
  const CHANNEL_ACTIVITY_INTERVAL_MS = 60_000; // Check at most once per 60s
212
220
  let lastChannelActivityCheckAt = 0;
213
221
 
@@ -390,7 +398,12 @@ export async function handlePoll(
390
398
  let runtimeDraining = false;
391
399
  let result: PollTxnResult;
392
400
  try {
393
- result = await getDbClient().transaction(async () => {
401
+ // Runs twice at most. The probe pass (`probe: true`) runs in a read-only
402
+ // transaction, so an idle poll never takes the SQLite write lock; at its
403
+ // first would-be write it returns NEEDS_WRITE instead. Only then does the
404
+ // same body run again under BEGIN IMMEDIATE, where every claim and its
405
+ // capacity/budget check stay atomic exactly as before.
406
+ const pollBody = async (probe: boolean): Promise<PollTxnResult | typeof NEEDS_WRITE> => {
394
407
  const agent = await getAgentById(myAgentId);
395
408
  if (!agent) {
396
409
  return { error: "Agent not found", status: 404 };
@@ -399,7 +412,8 @@ export async function handlePoll(
399
412
  // The worker's parsed MODEL_TIER_* env overrides ride on every poll so
400
413
  // claim-time resolution can honor them (no write when unchanged).
401
414
  if (modelTierOverrides) {
402
- await setAgentModelTierOverrides(agent.id, modelTierOverrides);
415
+ if (!probe) await setAgentModelTierOverrides(agent.id, modelTierOverrides);
416
+ else if (await modelTierOverridesDiffer(agent.id, modelTierOverrides)) return NEEDS_WRITE;
403
417
  }
404
418
 
405
419
  // Extension identities authenticate to the API but never execute
@@ -413,12 +427,15 @@ export async function handlePoll(
413
427
  // live runtime identity rather than on X-Agent-ID alone, which only
414
428
  // names the logical agent. Polling is worker activity, so this also
415
429
  // refreshes liveness — it cannot revive a retired runtime, since the
416
- // update only matches one that is still live.
417
- if (
418
- isMultiRuntimeEnabled() &&
419
- !(runtimeInstanceId && (await touchRuntimeInstance(runtimeInstanceId, agent.id)))
420
- ) {
421
- return { trigger: null };
430
+ // update only matches one that is still live. The probe skips the
431
+ // touch while the last one is fresh (well inside the stale window).
432
+ if (isMultiRuntimeEnabled()) {
433
+ if (!runtimeInstanceId) return { trigger: null };
434
+ if (probe) {
435
+ if (!(await isRuntimeInstanceFresh(runtimeInstanceId, agent.id))) return NEEDS_WRITE;
436
+ } else if (!(await touchRuntimeInstance(runtimeInstanceId, agent.id))) {
437
+ return { trigger: null };
438
+ }
422
439
  }
423
440
 
424
441
  if (
@@ -448,6 +465,7 @@ export async function handlePoll(
448
465
  : [];
449
466
  const firstOfferedTask = offeredTasks[0];
450
467
  if (firstOfferedTask) {
468
+ if (probe) return NEEDS_WRITE;
451
469
  const claimedTask = await claimOfferedTask(firstOfferedTask.id, myAgentId);
452
470
  if (claimedTask) {
453
471
  await recordRuntimeTask(claimedTask.id);
@@ -468,7 +486,10 @@ export async function handlePoll(
468
486
  // Check for pending tasks (assigned directly to this agent)
469
487
  // Only return a task if agent has capacity (server-side enforcement)
470
488
  if (await hasCapacity(myAgentId)) {
471
- const pendingTask = await getPendingTaskForAgent(myAgentId);
489
+ // The probe also escalates when only an affinity-skip log row is due.
490
+ const pendingProbe = probe ? { skipLogDue: false } : undefined;
491
+ const pendingTask = await getPendingTaskForAgent(myAgentId, pendingProbe);
492
+ if (pendingProbe && (pendingTask || pendingProbe.skipLogDue)) return NEEDS_WRITE;
472
493
  if (pendingTask) {
473
494
  // Budget admission gate (Phase 3). Runs in the same transaction as
474
495
  // the capacity check so capacity AND budget gates share atomicity.
@@ -586,8 +607,11 @@ export async function handlePoll(
586
607
  // Gated on the messaging capability: without it the read-messages /
587
608
  // post-message tools aren't registered, so an unread_mentions trigger
588
609
  // would instruct a missing tool and strand the claimed mentions.
589
- const claimedChannels = hasCapability("messaging") ? await claimMentions(myAgentId) : [];
610
+ const claimedChannels = hasCapability("messaging")
611
+ ? await claimMentions(myAgentId, { dryRun: probe })
612
+ : [];
590
613
  if (claimedChannels.length > 0) {
614
+ if (probe) return NEEDS_WRITE;
591
615
  // Count what this claim took: the inbox summary no longer sees mentions already
592
616
  // moved to "processing".
593
617
  return {
@@ -662,6 +686,7 @@ export async function handlePoll(
662
686
  // refusal, and the dedup is per-(task,date) so subsequent same-day
663
687
  // refusals on the same lead-candidate are suppressed.
664
688
  if (unassignedIds.length > 0) {
689
+ if (probe) return NEEDS_WRITE;
665
690
  const candidateId = unassignedIds[0]!;
666
691
  const candidateTask = await getTaskById(candidateId);
667
692
  const admission = await canClaim(
@@ -755,7 +780,13 @@ export async function handlePoll(
755
780
 
756
781
  // No trigger found
757
782
  return { trigger: null };
758
- });
783
+ };
784
+ const probed = await getDbClient().transaction(() => pollBody(true), { readOnly: true });
785
+ // The write pass never returns NEEDS_WRITE: every guard above is `if (probe)`.
786
+ result =
787
+ probed === NEEDS_WRITE
788
+ ? ((await getDbClient().transaction(() => pollBody(false))) as PollTxnResult)
789
+ : probed;
759
790
  } catch (error) {
760
791
  console.error("[/api/poll] Database error:", error);
761
792
  jsonError(
package/src/http/repos.ts CHANGED
@@ -2,7 +2,7 @@ import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
3
  import { createSwarmRepo, deleteSwarmRepo, getSwarmRepoById, getSwarmRepos } from "../be/db";
4
4
  import { updateSwarmRepoChecked } from "../be/repo-checked-update";
5
- import { changesAllowMerge } from "../be/repo-merge-policy";
5
+ import { changesMergePolicy } from "../be/repo-merge-policy";
6
6
  import { can } from "../rbac";
7
7
  import { emitIntegrationConnected } from "../telemetry";
8
8
  import { RepoGuidelinesInputSchema, RepoHooksSchema, SwarmRepoSchema } from "../types";
@@ -62,7 +62,8 @@ const createRepo = route({
62
62
  201: { description: "Repo created", schema: SwarmRepoSchema },
63
63
  400: { description: "Validation error", schema: z.object({ error: z.string() }) },
64
64
  403: {
65
- description: "Only the lead, the operator or a user can turn allowMerge on",
65
+ description:
66
+ "Only the lead, the operator or a user can turn allowMerge on or set a mergePolicy",
66
67
  schema: z.object({ error: z.string() }),
67
68
  },
68
69
  409: { description: "Duplicate repo", schema: z.object({ error: z.string() }) },
@@ -89,7 +90,7 @@ const updateRepo = route({
89
90
  responses: {
90
91
  200: { description: "Repo updated", schema: SwarmRepoSchema },
91
92
  403: {
92
- description: "Only the lead, the operator or a user can change allowMerge",
93
+ description: "Only the lead, the operator or a user can change allowMerge or mergePolicy",
93
94
  schema: z.object({ error: z.string() }),
94
95
  },
95
96
  404: { description: "Repo not found", schema: z.object({ error: z.string() }) },
@@ -113,7 +114,7 @@ const deleteRepo = route({
113
114
 
114
115
  // ─── Handler ─────────────────────────────────────────────────────────────────
115
116
 
116
- /** The refusal text when the caller may not change allowMerge, or null when they may. */
117
+ /** The refusal text when the caller may not change the merge policy, or null when they may. */
117
118
  async function allowMergeRefusal(
118
119
  req: IncomingMessage,
119
120
  myAgentId: string | undefined,
@@ -160,7 +161,7 @@ export async function handleRepos(
160
161
  if (createRepo.match(req.method, pathSegments)) {
161
162
  const parsed = await createRepo.parse(req, res, pathSegments, queryParams);
162
163
  if (!parsed) return true;
163
- if (changesAllowMerge(null, parsed.body.guidelines)) {
164
+ if (changesMergePolicy(null, parsed.body.guidelines)) {
164
165
  const refusal = await allowMergeRefusal(req, myAgentId);
165
166
  if (refusal) {
166
167
  jsonError(res, refusal, 403);
@@ -198,7 +199,7 @@ export async function handleRepos(
198
199
  const parsed = await updateRepo.parse(req, res, pathSegments, queryParams);
199
200
  if (!parsed) return true;
200
201
  try {
201
- // The comparison with the stored allowMerge, the decision and the write share one
202
+ // The comparison with the stored merge policy, the decision and the write share one
202
203
  // transaction, so a stale edit cannot overwrite a merge-policy change committed after it.
203
204
  const result = await updateSwarmRepoChecked(
204
205
  parsed.params.id,
@@ -2,7 +2,7 @@ import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { CronExpressionParser } from "cron-parser";
3
3
  import { z } from "zod";
4
4
  import { AssetKeyAuthorizationError, authorizeAssetKeyWrite } from "../be/asset-key-auth";
5
- import { resolveHttpAuditUserId } from "../be/audit-user";
5
+ import { resolveHttpAuditUserId, resolveHttpRequesterUserId } from "../be/audit-user";
6
6
  import {
7
7
  createScheduledTask,
8
8
  deleteScheduledTask,
@@ -432,7 +432,7 @@ export async function handleSchedules(
432
432
  }
433
433
 
434
434
  try {
435
- const trustedUserId = await resolveHttpAuditUserId(req, myAgentId);
435
+ const trustedUserId = await resolveHttpRequesterUserId(req, myAgentId);
436
436
  let key: string | undefined;
437
437
  try {
438
438
  key = body.key ? await authorizeAssetKeyWrite(body.key, trustedUserId) : undefined;
@@ -484,7 +484,9 @@ export async function handleSchedules(
484
484
  params: body.params,
485
485
  requiredParams: body.requiredParams,
486
486
  requires: body.requires,
487
- createdBy: (await resolveHttpAuditUserId(req, myAgentId)) ?? undefined,
487
+ createdByAgentId: myAgentId,
488
+ // Not the audit header: a schedule fires its tasks as requested by created_by.
489
+ createdBy: trustedUserId ?? undefined,
488
490
  });
489
491
 
490
492
  createSchedule.respond(res, 201, schedule);
@@ -573,7 +575,7 @@ export async function handleSchedules(
573
575
  try {
574
576
  body.key = await authorizeAssetKeyWrite(
575
577
  parsed.body.key,
576
- await resolveHttpAuditUserId(req, myAgentId),
578
+ await resolveHttpRequesterUserId(req, myAgentId),
577
579
  );
578
580
  } catch (error) {
579
581
  if (error instanceof AssetKeyAuthorizationError) {
@@ -779,8 +781,10 @@ export async function handleSchedules(
779
781
  }
780
782
  }
781
783
 
782
- const updatedBy = await resolveHttpAuditUserId(req, myAgentId);
783
- if (updatedBy !== null) body.updatedBy = updatedBy;
784
+ // The audit pair describes this write: the person is null when unknown,
785
+ // never left over from an earlier writer.
786
+ body.updatedBy = await resolveHttpAuditUserId(req, myAgentId);
787
+ body.updatedByAgentId = myAgentId ?? null;
784
788
  let schedule: Awaited<ReturnType<typeof updateScheduledTask>>;
785
789
  try {
786
790
  schedule = await updateScheduledTask(parsed.params.id, body);
@@ -1,6 +1,6 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
- import { resolveHttpAuditUserId } from "@/be/audit-user";
3
+ import { resolveHttpAuditUserId, resolveHttpRequesterUserId } from "@/be/audit-user";
4
4
  import { normalizeDate } from "@/be/date-utils";
5
5
  import { getDbClient } from "@/be/db";
6
6
  import {
@@ -2384,7 +2384,7 @@ export async function handleScriptConnections(
2384
2384
  label,
2385
2385
  flow: "generic",
2386
2386
  ...(parsed.body?.finalRedirect ? { finalRedirect: parsed.body.finalRedirect } : {}),
2387
- userId: await resolveHttpAuditUserId(req, agentId),
2387
+ userId: await resolveHttpRequesterUserId(req, agentId),
2388
2388
  });
2389
2389
  authorizeUrlRoute.respond(res, 200, {
2390
2390
  authorizeUrl: result.url,
@@ -762,6 +762,10 @@ export async function handleScripts(
762
762
  const runtimeInstanceId = ((h) => (Array.isArray(h) ? h[0] : h))(
763
763
  req.headers["x-runtime-instance-id"],
764
764
  );
765
+ // Forwarded to the run's `ctx.swarm` calls so their writes resolve the same
766
+ // audit person. Not trusted as-is: every resolver re-checks that the task
767
+ // belongs to the calling agent.
768
+ const sourceTaskId = ((h) => (Array.isArray(h) ? h[0] : h))(req.headers["x-source-task-id"]);
765
769
 
766
770
  // Inline source is saved as a scratch script and recorded on the run row:
767
771
  // refuse an embedded secret before it executes or persists.
@@ -820,6 +824,7 @@ export async function handleScripts(
820
824
  executor,
821
825
  agentId: agent.id,
822
826
  runtimeInstanceId,
827
+ sourceTaskId,
823
828
  egressSecrets: credentials.egressSecrets,
824
829
  failedBindings: credentials.failedBindings,
825
830
  userConfig: credentials.userConfig,
@@ -884,6 +889,7 @@ export async function handleScripts(
884
889
  isScratch: true,
885
890
  typeChecked: false,
886
891
  changeReason: "Auto-saved successful inline run",
892
+ createdBy: await resolveHttpAuditUserId(req, agent.id),
887
893
  });
888
894
  autoSaved = { slug, reason: "successful_inline_run" };
889
895
  }
@@ -993,6 +999,9 @@ export async function handleScripts(
993
999
  fsMode: script.fsMode,
994
1000
  executor: script.executor,
995
1001
  createdByAgentId: script.createdByAgentId,
1002
+ updatedByAgentId: script.updatedByAgentId,
1003
+ createdBy: script.createdBy,
1004
+ updatedBy: script.updatedBy,
996
1005
  createdAt: script.createdAt,
997
1006
  updatedAt: script.updatedAt,
998
1007
  }));
@@ -10,8 +10,9 @@ import {
10
10
  } from "../assets/key";
11
11
  import { SOURCE_GROUPS_READ_ONLY, sourceMoveError, sourceOfKey } from "../assets/source-key";
12
12
  import { AssetKeyAuthorizationError, authorizeAssetKeyWrite } from "../be/asset-key-auth";
13
- import { resolveHttpAuditUserId } from "../be/audit-user";
13
+ import { resolveHttpRequesterUserId } from "../be/audit-user";
14
14
  import {
15
+ AgentDeletedError,
15
16
  AssetKeyMovesBlockedError,
16
17
  assertAssetKeyMovesAllowed,
17
18
  countSessions,
@@ -179,6 +180,9 @@ const SessionTreeResponseSchema = z.object({
179
180
  labels: z.record(z.string(), z.string()).optional(),
180
181
  groups: z.array(SessionTreeGroupSchema),
181
182
  inbox: SessionSectionCountsSchema,
183
+ working: SessionSectionCountsSchema.describe(
184
+ "Inbox sessions with a task running and nothing for the person to answer. They list under Working, not Inbox.",
185
+ ),
182
186
  later: SessionSectionCountsSchema,
183
187
  done: SessionSectionCountsSchema,
184
188
  noGroup: SessionSectionCountsSchema,
@@ -325,6 +329,7 @@ const mintAgentTokenRoute = route({
325
329
  403: { description: "Operator or user credentials required" },
326
330
  404: { description: "Agent not found and no name given" },
327
331
  409: { description: "Agent already holds an active token" },
332
+ 410: { description: "An operator deleted this agent id (`agent_deleted`); restore it first" },
328
333
  },
329
334
  rbac: { permission: "agent.token.manage" },
330
335
  });
@@ -475,8 +480,13 @@ async function handleAgentTokens(
475
480
  })
476
481
  .catch((error) => {
477
482
  if (error instanceof AgentTokenExistsError) return { status: 409 as const };
483
+ if (error instanceof AgentDeletedError) return { status: 410 as const };
478
484
  throw error;
479
485
  });
486
+ if (result.status === 410) {
487
+ jsonError(res, "agent_deleted", 410);
488
+ return true;
489
+ }
480
490
  if (result.status === 404) {
481
491
  jsonError(res, "Agent not found; pass name to create it", 404);
482
492
  return true;
@@ -582,13 +592,15 @@ const listSessions = route({
582
592
  keyPrefix: SessionKeyFilterSchema.optional(),
583
593
  /** Exact asset group, including direct resource leaves. */
584
594
  groupKey: SessionKeyFilterSchema.optional(),
595
+ /** Comma-separated root task ids (the first 200 count): only these sessions, in any read state. */
596
+ ids: z.string().optional(),
585
597
  /** Shared and viewer-personal namespace roots and direct resource leaves. */
586
598
  noGroup: z
587
599
  .enum(["true", "false"])
588
600
  .transform((v) => v === "true")
589
601
  .optional(),
590
- /** Chain-wide read state or Inbox section. */
591
- triage: z.enum(["inbox", "later", "done", "unread"]).optional(),
602
+ /** Chain-wide read state, or the Inbox or Working section. */
603
+ triage: z.enum(["inbox", "working", "later", "done", "unread"]).optional(),
592
604
  /** Latest chain status or pending human attention. */
593
605
  status: z.enum(["running", "failed", "needs"]).optional(),
594
606
  /** Requester anywhere in the chain or active share recipient. */
@@ -661,23 +673,31 @@ const triageSessionListRoute = route({
661
673
  pattern: ["api", "session-triage"],
662
674
  summary: "Triage every session of one sidebar list",
663
675
  description:
664
- "The bulk bar's 'Select all N': Done, back to the Inbox, read, or unread for every session that one sessions v2 list shows the caller (the `GET /api/sessions?scope=tree` filters). Needs a picked user.",
676
+ "The bulk bar's 'Select all N': Done, back to the Inbox, read, or unread for every session that one sessions v2 list shows the caller (the `GET /api/sessions?scope=tree` filters), minus `exceptIds`. Needs a picked user.",
665
677
  tags: ["Sessions"],
666
678
  body: z
667
679
  .object({
668
680
  action: z.enum(["done", "inbox", "read", "unread"]),
669
- /** The list: one of Inbox, Later, Done, No group, or a group. */
670
- triage: z.enum(["inbox", "later", "done"]).optional(),
681
+ /** The list: one of Inbox, Later, Done, No group, a group, or a source group with its threads. */
682
+ triage: z.enum(["inbox", "working", "later", "done"]).optional(),
671
683
  noGroup: z.boolean().optional(),
672
684
  groupKey: SessionKeyFilterSchema.optional(),
685
+ /** A source group (`shared/slack/<channel>/`) with its nested threads, as the sidebar lists it. */
686
+ keyPrefix: SessionKeyFilterSchema.refine((key) => sourceOfKey(key) !== null, {
687
+ message: "keyPrefix must be a source group",
688
+ }).optional(),
673
689
  show: SessionShowSchema,
674
690
  hideSource: z.array(z.string().min(1)).max(32).optional(),
675
691
  /** Root sources to keep; an empty array keeps none. */
676
692
  showSource: z.array(z.string().min(1)).max(32).optional(),
693
+ /** Root task ids to leave out: rows unchecked after 'Select all N'. */
694
+ exceptIds: z.array(z.string().min(1)).max(500).optional(),
677
695
  })
678
- .refine((body) => [body.triage, body.noGroup, body.groupKey].filter(Boolean).length === 1, {
679
- message: "Name exactly one list: triage, noGroup, or groupKey",
680
- }),
696
+ .refine(
697
+ (body) =>
698
+ [body.triage, body.noGroup, body.groupKey, body.keyPrefix].filter(Boolean).length === 1,
699
+ { message: "Name exactly one list: triage, noGroup, groupKey, or keyPrefix" },
700
+ ),
681
701
  responses: {
682
702
  200: {
683
703
  description: "The number of sessions written",
@@ -750,7 +770,7 @@ async function withSessionMove(
750
770
  run: (context: { actor: SessionActor; changedBy?: string; key: string | null }) => Promise<void>,
751
771
  ): Promise<void> {
752
772
  try {
753
- const changedBy = await resolveHttpAuditUserId(req, myAgentId);
773
+ const changedBy = await resolveHttpRequesterUserId(req, myAgentId);
754
774
  const actor = await resolveSessionActor(req, myAgentId);
755
775
  const key = destination === null ? null : await authorizeAssetKeyWrite(destination, changedBy);
756
776
  await assertAssetKeyMovesAllowed();
@@ -1048,6 +1068,11 @@ export async function handleSessions(
1048
1068
  contextKeyPrefix: parsed.query.contextKeyPrefix,
1049
1069
  keyPrefix: parsed.query.keyPrefix,
1050
1070
  groupKey: parsed.query.groupKey,
1071
+ rootIds: parsed.query.ids
1072
+ ?.split(",")
1073
+ .map((id) => id.trim())
1074
+ .filter(Boolean)
1075
+ .slice(0, 200),
1051
1076
  noGroup: parsed.query.noGroup,
1052
1077
  triage: parsed.query.triage,
1053
1078
  status: parsed.query.status,
@@ -1125,10 +1150,10 @@ export async function handleSessions(
1125
1150
  jsonError(res, "Pick a user to triage sessions", 400);
1126
1151
  return true;
1127
1152
  }
1128
- const { action, show, ...list } = parsed.body;
1153
+ const { action, show, exceptIds, ...list } = parsed.body;
1129
1154
  const updated = await triageSessionList(
1130
1155
  actor.userId,
1131
- { ...list, mine: show !== "all" },
1156
+ { ...list, exceptRootIds: exceptIds, mine: show !== "all" },
1132
1157
  action,
1133
1158
  actor.readAll,
1134
1159
  );
@@ -1,5 +1,6 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
+ import { resolveHttpAuditActor, resolveHttpAuditUserId } from "../be/audit-user";
3
4
  import {
4
5
  createSkill,
5
6
  deleteSkill,
@@ -12,6 +13,7 @@ import {
12
13
  listSkillFileManifest,
13
14
  listSkills,
14
15
  searchSkills,
16
+ setSkillUpdatedBy,
15
17
  uninstallSkill,
16
18
  updateSkill,
17
19
  upsertSkillFile,
@@ -664,6 +666,8 @@ export async function handleSkills(
664
666
  sourcePath: parsed.body.sourcePath,
665
667
  sourceBranch: branch,
666
668
  isComplex: parsed.body.isComplex ?? false,
669
+ createdByAgentId: myAgentId ?? null,
670
+ createdBy: await resolveHttpAuditUserId(req, myAgentId),
667
671
  });
668
672
 
669
673
  installRemoteRoute.respond(res, 201, { skill });
@@ -687,6 +691,9 @@ export async function handleSkills(
687
691
 
688
692
  let updated = 0;
689
693
  const errors: string[] = [];
694
+ // A content change is attributed to the caller; a lastFetchedAt-only
695
+ // touch is a fetch, not an edit, and leaves the audit pair alone.
696
+ const actor = await resolveHttpAuditActor(req, myAgentId);
690
697
 
691
698
  for (const skill of remoteSkills) {
692
699
  if (skill.isComplex || !skill.sourceRepo) continue;
@@ -717,6 +724,8 @@ export async function handleSkills(
717
724
  userInvocable: pm.userInvocable,
718
725
  sourceHash: newHash,
719
726
  lastFetchedAt: now,
727
+ updatedBy: actor.userId,
728
+ updatedByAgentId: actor.agentId,
720
729
  });
721
730
  updated++;
722
731
  } else {
@@ -866,6 +875,7 @@ export async function handleSkills(
866
875
 
867
876
  try {
868
877
  const files = await upsertSkillFiles(parsed.params.id, parsed.body.files);
878
+ await setSkillUpdatedBy(parsed.params.id, await resolveHttpAuditActor(req, myAgentId));
869
879
  const updatedSkill = await getSkillById(parsed.params.id);
870
880
  bulkUpsertSkillFilesRoute.respond(res, 200, {
871
881
  files,
@@ -922,6 +932,7 @@ export async function handleSkills(
922
932
  path: decodeSkillFilePath(pathSegments),
923
933
  ...parsed.body,
924
934
  });
935
+ await setSkillUpdatedBy(parsed.params.id, await resolveHttpAuditActor(req, myAgentId));
925
936
  const updatedSkill = await getSkillById(parsed.params.id);
926
937
  upsertSkillFileRoute.respond(res, 200, { file, skill: updatedSkill });
927
938
  } catch (err) {
@@ -951,6 +962,7 @@ export async function handleSkills(
951
962
  jsonError(res, "Skill file not found", 404);
952
963
  return true;
953
964
  }
965
+ await setSkillUpdatedBy(parsed.params.id, await resolveHttpAuditActor(req, myAgentId));
954
966
  const updatedSkill = await getSkillById(parsed.params.id);
955
967
  deleteSkillFileRoute.respond(res, 200, { success: true, skill: updatedSkill });
956
968
  } catch (err) {
@@ -995,6 +1007,8 @@ export async function handleSkills(
995
1007
  disableModelInvocation: pm.disableModelInvocation,
996
1008
  userInvocable: pm.userInvocable,
997
1009
  systemDefault: parsed.body.systemDefault,
1010
+ createdByAgentId: myAgentId ?? null,
1011
+ createdBy: await resolveHttpAuditUserId(req, myAgentId),
998
1012
  });
999
1013
  createSkillRoute.respond(res, 201, { skill });
1000
1014
  } catch (err) {
@@ -1062,6 +1076,9 @@ export async function handleSkills(
1062
1076
  updates.disableModelInvocation = pm.disableModelInvocation;
1063
1077
  updates.userInvocable = pm.userInvocable;
1064
1078
  }
1079
+ const actor = await resolveHttpAuditActor(req, myAgentId);
1080
+ updates.updatedBy = actor.userId;
1081
+ updates.updatedByAgentId = actor.agentId;
1065
1082
 
1066
1083
  const skill = await updateSkill(parsed.params.id, updates as Parameters<typeof updateSkill>[1]);
1067
1084
  if (!skill) {
@@ -1,5 +1,5 @@
1
1
  import type { IncomingMessage } from "node:http";
2
- import { resolveHttpAuditUserId } from "../be/audit-user";
2
+ import { resolveHttpRequesterUserId } from "../be/audit-user";
3
3
  import { findUserById } from "../be/users";
4
4
  import { can } from "../rbac";
5
5
  import { agentFirstPrincipal } from "./request-principal";
@@ -31,7 +31,7 @@ export async function resolveTaskRequester(
31
31
  trustedUserId?: string | null,
32
32
  ): Promise<string | undefined> {
33
33
  const trusted =
34
- trustedUserId === undefined ? await resolveHttpAuditUserId(req, myAgentId) : trustedUserId;
34
+ trustedUserId === undefined ? await resolveHttpRequesterUserId(req, myAgentId) : trustedUserId;
35
35
  if (trusted) return trusted;
36
36
  if (process.env.TRUST_BODY_REQUESTED_BY_USER_ID === "false" || !bodyUserId) return undefined;
37
37
  // A worker on the shared key is not the operator: its X-Agent-ID names it, so the body
package/src/http/tasks.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
3
  import { AssetKeyAuthorizationError, authorizeAssetKeyWrite } from "../be/asset-key-auth";
4
- import { resolveHttpAuditUserId } from "../be/audit-user";
4
+ import { resolveHttpRequesterUserId } from "../be/audit-user";
5
5
  import {
6
6
  backfillSupersedeTaskResumeTaskId,
7
7
  cancelTask,
@@ -61,6 +61,7 @@ import { getTaskCitations, TaskCitationSchema } from "../be/task-citations";
61
61
  import { getTaskUiSpec, TaskUiSpecSchema } from "../be/task-ui-spec";
62
62
  import { findUserById } from "../be/users";
63
63
  import { can, isRbacEnabled, type RbacPrincipal, type RbacResource } from "../rbac";
64
+ import { mirrorSessionPrompt } from "../slack/session-mirror";
64
65
  import { chatThreadOfContextKey } from "../tasks/context-key";
65
66
  import { TaskCreationBlockedError, TaskRoutingAuthorizationError } from "../tasks/errors";
66
67
  import { createTaskWithSiblingAwareness } from "../tasks/sibling-awareness";
@@ -1140,7 +1141,7 @@ export async function handleTasks(
1140
1141
  if (!parsed) return true;
1141
1142
 
1142
1143
  // Trusted identity first, then the body hint; see resolveTaskRequester.
1143
- const trustedUserId = await resolveHttpAuditUserId(req, myAgentId);
1144
+ const trustedUserId = await resolveHttpRequesterUserId(req, myAgentId);
1144
1145
  const requestedByUserId = await resolveTaskRequester(
1145
1146
  req,
1146
1147
  myAgentId,
@@ -1317,6 +1318,11 @@ export async function handleTasks(
1317
1318
  },
1318
1319
  });
1319
1320
 
1321
+ // A person's Sessions follow-up shows up in the session's Slack thread too.
1322
+ if (principal.kind === "user" || principal.kind === "operator") {
1323
+ getDbClient().afterCommit(() => mirrorSessionPrompt(task));
1324
+ }
1325
+
1320
1326
  createTask.respond(res, 201, task);
1321
1327
  } catch (error) {
1322
1328
  if (error instanceof TaskRoutingAuthorizationError) {
@@ -1378,6 +1384,10 @@ export async function handleTasks(
1378
1384
  jsonError(res, "Task not found", 404);
1379
1385
  return true;
1380
1386
  }
1387
+ // A draft holds back its mirror until its uploads settle, like its claim.
1388
+ if (existingTask.status === "draft") {
1389
+ getDbClient().afterCommit(() => mirrorSessionPrompt(promoted));
1390
+ }
1381
1391
 
1382
1392
  promoteDraftTaskRoute.respond(res, 200, promoted);
1383
1393
  return true;
@@ -1533,7 +1543,7 @@ export async function handleTasks(
1533
1543
  return true;
1534
1544
  }
1535
1545
 
1536
- const trustedUserId = await await resolveHttpAuditUserId(req, myAgentId);
1546
+ const trustedUserId = await await resolveHttpRequesterUserId(req, myAgentId);
1537
1547
  let requestedByUserId = trustedUserId ?? undefined;
1538
1548
  if (
1539
1549
  process.env.TRUST_BODY_REQUESTED_BY_USER_ID !== "false" &&
@@ -1,7 +1,7 @@
1
1
  import type { IncomingMessage, ServerResponse } from "node:http";
2
2
  import { z } from "zod";
3
3
  import type { ToolCallEvent } from "../extensions/contract";
4
- import { dispatchPost, dispatchPre } from "../extensions/dispatcher";
4
+ import { dispatchPost, dispatchPre, hasNativeToolHandlers } from "../extensions/dispatcher";
5
5
  import type { RequestInfo } from "../tools/utils";
6
6
  import { scrubObject } from "../utils/secret-scrubber";
7
7
  import { route } from "./route-def";
@@ -64,6 +64,22 @@ const toolHookRoute = route({
64
64
  },
65
65
  });
66
66
 
67
+ const toolHookStatusRoute = route({
68
+ method: "get",
69
+ path: "/api/tool-hooks/status",
70
+ pattern: ["api", "tool-hooks", "status"],
71
+ summary: "Whether any enabled extension takes harness-native tool calls",
72
+ description:
73
+ "Worker shims read this before each native tool call and skip `POST /api/tool-hooks` while " +
74
+ "`native` is false, so a swarm with no native-tool extension pays no per-call round trip. " +
75
+ "Shims cache the answer for a short time.",
76
+ tags: ["Extensions"],
77
+ auth: { apiKey: true },
78
+ responses: {
79
+ 200: { description: "Native tool hook status", schema: z.object({ native: z.boolean() }) },
80
+ },
81
+ });
82
+
67
83
  function header(req: IncomingMessage, name: string): string | undefined {
68
84
  const raw = req.headers[name];
69
85
  return Array.isArray(raw) ? raw[0] : raw;
@@ -76,6 +92,10 @@ export async function handleToolHooks(
76
92
  queryParams: URLSearchParams,
77
93
  myAgentId: string | undefined,
78
94
  ): Promise<boolean> {
95
+ if (toolHookStatusRoute.match(req.method, pathSegments)) {
96
+ toolHookStatusRoute.respond(res, 200, { native: hasNativeToolHandlers() });
97
+ return true;
98
+ }
79
99
  if (!toolHookRoute.match(req.method, pathSegments)) return false;
80
100
  if (!myAgentId) {
81
101
  jsonError(res, "Missing X-Agent-ID header", 400);
@@ -86,11 +106,13 @@ export async function handleToolHooks(
86
106
 
87
107
  // Scrub at entry: handlers, extension_runs rows and logs only ever see the scrubbed body.
88
108
  const body = scrubObject(parsed.body);
109
+ const sourceTaskId = header(req, "x-source-task-id");
89
110
  const requestInfo: RequestInfo = {
90
111
  sessionId: undefined,
91
112
  agentId: myAgentId,
92
113
  runtimeInstanceId: header(req, "x-runtime-instance-id"),
93
- sourceTaskId: header(req, "x-source-task-id"),
114
+ sourceTaskId,
115
+ auditSourceTaskId: sourceTaskId ?? header(req, "x-audit-source-task-id"),
94
116
  contextKey: header(req, "x-context-key"),
95
117
  callOrigin: "native",
96
118
  harness: body.harness,