@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
@@ -23,6 +23,10 @@
23
23
  * the reason to stderr, which codex-cli 0.160.0 turns into
24
24
  * "Command blocked by PreToolUse hook: <reason>".
25
25
  *
26
+ * Native tool calls (Bash, apply_patch) also go to `POST /api/tool-hooks`
27
+ * (`native-tool-hooks.ts`), so an extension with `toolSources: ["native"]`
28
+ * can observe, block (exit 2) or rewrite a Bash command (`updatedInput`).
29
+ *
26
30
  * One-shot guarantee: a message is included in hook output only after its
27
31
  * `/delivered` POST succeeded, so a message is injected at most once. A
28
32
  * failed POST leaves the row `pending` for the next lifecycle event; rows a
@@ -34,6 +38,14 @@ import type { SteeringMessage } from "../types";
34
38
  import { getApiKey } from "../utils/api-key";
35
39
  import { getMcpBaseUrl } from "../utils/constants";
36
40
  import { isSteeringEnabled } from "../utils/steering-enabled";
41
+ import {
42
+ canonicalArgs,
43
+ canonicalToolName,
44
+ type NativeCall,
45
+ type NativeHookTarget,
46
+ runNativePost,
47
+ runNativePre,
48
+ } from "./native-tool-hooks";
37
49
  import { guardGhPrBody, type PrBodyGuardDeps } from "./pr-body-guard";
38
50
  import { guardGhPrRoom, type PrRoomGuardDeps } from "./pr-room-guard";
39
51
 
@@ -45,6 +57,8 @@ export interface CodexHookMessage {
45
57
  cwd?: string;
46
58
  tool_name?: string;
47
59
  tool_input?: unknown;
60
+ tool_response?: unknown;
61
+ tool_use_id?: string;
48
62
  }
49
63
 
50
64
  export interface CodexHookConfig {
@@ -177,11 +191,78 @@ export async function codexPreToolUseBlock(
177
191
  roomDeps?: PrRoomGuardDeps,
178
192
  ): Promise<string | null> {
179
193
  if (msg.hook_event_name !== "PreToolUse") return null;
194
+ // An apply_patch payload is patch text, never a shell command: `gh pr create` inside a patched file is not one.
195
+ if (msg.tool_name === "apply_patch") return null;
180
196
  const cwd = msg.cwd ?? process.cwd();
181
197
  const block = await guardGhPrBody(msg.tool_input, cwd, deps);
182
198
  return block ?? (await guardGhPrRoom(msg.tool_input, cwd, roomDeps));
183
199
  }
184
200
 
201
+ /** Codex's own tool calls; its MCP tools (`mcp__server__tool`) reach extensions through the MCP path. */
202
+ function nativeCallOf(msg: CodexHookMessage): NativeCall | undefined {
203
+ if (!msg.tool_name || msg.tool_name.startsWith("mcp__")) return undefined;
204
+ return {
205
+ harness: "codex",
206
+ tool: canonicalToolName(msg.tool_name),
207
+ nativeTool: msg.tool_name,
208
+ args: canonicalArgs(msg.tool_input),
209
+ rawArgs: msg.tool_input,
210
+ toolCallId: msg.tool_use_id,
211
+ };
212
+ }
213
+
214
+ function nativeTargetOf(config: CodexHookConfig | null): NativeHookTarget | undefined {
215
+ if (!config) return undefined;
216
+ return {
217
+ apiUrl: config.apiUrl,
218
+ headers: { Authorization: `Bearer ${config.apiKey}`, "X-Agent-ID": config.agentId },
219
+ taskId: config.taskId,
220
+ };
221
+ }
222
+
223
+ export type CodexNativePre =
224
+ | { action: "continue" }
225
+ | { action: "block"; reason: string }
226
+ | { action: "modify"; output: Record<string, unknown> };
227
+
228
+ /** PreToolUse: what the native-tool extensions decided, as codex hook output. */
229
+ export async function codexNativePre(
230
+ msg: CodexHookMessage,
231
+ config: CodexHookConfig | null,
232
+ fetchImpl: typeof fetch = fetch,
233
+ deps?: PrBodyGuardDeps,
234
+ roomDeps?: PrRoomGuardDeps,
235
+ ): Promise<CodexNativePre> {
236
+ const call = nativeCallOf(msg);
237
+ const target = nativeTargetOf(config);
238
+ if (msg.hook_event_name !== "PreToolUse" || !call || !target) return { action: "continue" };
239
+ const decision = await runNativePre(target, call, fetchImpl);
240
+ if (decision.action === "block") return decision;
241
+ // shortcut: only a Bash rewrite is applied; codex's rewrite support for apply_patch payloads is
242
+ // unverified, so that modify is dropped. Upgrade once a codex run proves updatedInput there.
243
+ if (decision.action === "modify" && call.tool === "bash") {
244
+ // The rewrite is input the PreToolUse guards never saw: check the final command too.
245
+ const reason = await codexPreToolUseBlock(
246
+ { ...msg, tool_input: decision.args },
247
+ deps,
248
+ roomDeps,
249
+ );
250
+ if (reason) return { action: "block", reason };
251
+ return {
252
+ action: "modify",
253
+ output: {
254
+ hookSpecificOutput: {
255
+ hookEventName: "PreToolUse",
256
+ permissionDecision: "allow",
257
+ permissionDecisionReason: "Tool input rewritten by an extension",
258
+ updatedInput: decision.args,
259
+ },
260
+ },
261
+ };
262
+ }
263
+ return { action: "continue" };
264
+ }
265
+
185
266
  /** stdin/stdout entry point used by the `codex-hook` CLI command. */
186
267
  export async function handleCodexHook(): Promise<void> {
187
268
  let msg: CodexHookMessage;
@@ -196,8 +277,25 @@ export async function handleCodexHook(): Promise<void> {
196
277
  process.exitCode = 2;
197
278
  return;
198
279
  }
280
+ const config = resolveCodexHookConfig();
281
+ const native = await codexNativePre(msg, config);
282
+ if (native.action === "block") {
283
+ console.error(native.reason);
284
+ process.exitCode = 2;
285
+ return;
286
+ }
287
+ if (native.action === "modify") {
288
+ console.log(JSON.stringify(native.output));
289
+ return;
290
+ }
291
+ const postCall = msg.hook_event_name === "PostToolUse" ? nativeCallOf(msg) : undefined;
292
+ const postTarget = nativeTargetOf(config);
293
+ if (postCall && postTarget) {
294
+ // shortcut: pre and post are separate processes, so durationMs is sent as 0.
295
+ await runNativePost(postTarget, postCall, { result: msg.tool_response, durationMs: 0 });
296
+ }
199
297
  try {
200
- const output = await handleCodexHookEvent(msg, resolveCodexHookConfig());
298
+ const output = await handleCodexHookEvent(msg, config);
201
299
  if (output) console.log(JSON.stringify(output));
202
300
  } catch {
203
301
  // Never fail the harness over steering delivery.
package/src/hooks/hook.ts CHANGED
@@ -26,6 +26,15 @@ import { isSessionSummarySkipped } from "../utils/env-flag";
26
26
  import { summarizeSession as runSummarize } from "../utils/internal-ai";
27
27
  import { scrubSecrets } from "../utils/secret-scrubber";
28
28
  import { contextBoundNoteThreshold, injectClaimedContextBoundNote } from "./context-bound-note";
29
+ import {
30
+ canonicalArgs,
31
+ canonicalToolName,
32
+ type NativeCall,
33
+ type NativeHookTarget,
34
+ rawArgsFromCanonical,
35
+ runNativePost,
36
+ runNativePre,
37
+ } from "./native-tool-hooks";
29
38
  import { guardGhPrBody } from "./pr-body-guard";
30
39
  import { guardGhPrRoom } from "./pr-room-guard";
31
40
  import { checkToolLoop, clearToolHistory } from "./tool-loop-detection";
@@ -1033,6 +1042,25 @@ export async function handleHook(): Promise<void> {
1033
1042
  return lines.join("\n");
1034
1043
  };
1035
1044
 
1045
+ /** Claude's own tool calls only: swarm MCP tools reach extensions through the MCP path. */
1046
+ const nativeCallOf = (): NativeCall | undefined => {
1047
+ if (!msg.tool_name || msg.tool_name.startsWith("mcp__")) return undefined;
1048
+ return {
1049
+ harness: "claude",
1050
+ tool: canonicalToolName(msg.tool_name),
1051
+ nativeTool: msg.tool_name,
1052
+ args: canonicalArgs(msg.tool_input),
1053
+ rawArgs: msg.tool_input,
1054
+ toolCallId: msg.tool_use_id,
1055
+ };
1056
+ };
1057
+
1058
+ const nativeTargetOf = async (): Promise<NativeHookTarget | undefined> => {
1059
+ const apiUrl = getBaseUrl();
1060
+ if (!mcpConfig || !apiUrl) return undefined;
1061
+ return { apiUrl, headers: mcpConfig.headers, taskId: (await readTaskFile())?.taskId };
1062
+ };
1063
+
1036
1064
  const isToolEvent = msg.hook_event_name === "PreToolUse" || msg.hook_event_name === "PostToolUse";
1037
1065
 
1038
1066
  // Ping the server to indicate activity, then get current agent info.
@@ -1206,16 +1234,13 @@ export async function handleHook(): Promise<void> {
1206
1234
 
1207
1235
  // Block `gh pr create|edit` when the body for a public repo leaks internal
1208
1236
  // identifiers. Exit code 2 blocks the call and stderr reaches the model.
1237
+ const prGuardBlock = async (toolInput: unknown): Promise<string | null> =>
1238
+ (await guardGhPrBody(toolInput, msg.cwd ?? process.cwd())) ??
1239
+ (await guardGhPrRoom(toolInput, msg.cwd ?? process.cwd()));
1209
1240
  if (msg.tool_name === "Bash") {
1210
- const prBodyBlock = await guardGhPrBody(msg.tool_input, msg.cwd ?? process.cwd());
1211
- if (prBodyBlock) {
1212
- console.error(prBodyBlock);
1213
- process.exitCode = 2;
1214
- return;
1215
- }
1216
- const prRoomBlock = await guardGhPrRoom(msg.tool_input, msg.cwd ?? process.cwd());
1217
- if (prRoomBlock) {
1218
- console.error(prRoomBlock);
1241
+ const prBlock = await prGuardBlock(msg.tool_input);
1242
+ if (prBlock) {
1243
+ console.error(prBlock);
1219
1244
  process.exitCode = 2;
1220
1245
  return;
1221
1246
  }
@@ -1261,13 +1286,61 @@ export async function handleHook(): Promise<void> {
1261
1286
  }
1262
1287
  }
1263
1288
 
1264
- if (loopWarning) {
1289
+ // Extensions with toolSources "native" see the call last, so every guard above wins.
1290
+ // Block: exit 2, stderr reaches the model. Modify: updatedInput, plus any loop warning in
1291
+ // the same JSON object (stdout must be exactly one).
1292
+ let rewrittenInput: unknown;
1293
+ const nativeCall = nativeCallOf();
1294
+ const nativeTarget = nativeCall ? await nativeTargetOf() : undefined;
1295
+ if (nativeCall && nativeTarget) {
1296
+ const decision = await runNativePre(nativeTarget, nativeCall);
1297
+ if (decision.action === "block") {
1298
+ console.error(decision.reason);
1299
+ process.exitCode = 2;
1300
+ return;
1301
+ }
1302
+ if (decision.action === "modify") {
1303
+ rewrittenInput = rawArgsFromCanonical(decision.args, msg.tool_input);
1304
+ // The rewrite is input the guards above never saw: check the final Bash command too.
1305
+ const rewriteBlock = msg.tool_name === "Bash" ? await prGuardBlock(rewrittenInput) : null;
1306
+ if (rewriteBlock) {
1307
+ console.error(rewriteBlock);
1308
+ process.exitCode = 2;
1309
+ return;
1310
+ }
1311
+ }
1312
+ }
1313
+
1314
+ if (rewrittenInput !== undefined) {
1315
+ console.log(
1316
+ JSON.stringify({
1317
+ hookSpecificOutput: {
1318
+ hookEventName: "PreToolUse",
1319
+ permissionDecision: "allow",
1320
+ permissionDecisionReason: "Tool input rewritten by an extension",
1321
+ updatedInput: rewrittenInput,
1322
+ ...(loopWarning ? { additionalContext: loopWarning } : {}),
1323
+ },
1324
+ }),
1325
+ );
1326
+ } else if (loopWarning) {
1265
1327
  outputToolContext("PreToolUse", loopWarning);
1266
1328
  }
1267
1329
  break;
1268
1330
  }
1269
1331
 
1270
- case "PostToolUse":
1332
+ case "PostToolUse": {
1333
+ // Observe-only report to extensions with toolSources "native".
1334
+ // shortcut: pre and post run in separate hook processes, so durationMs is sent as 0;
1335
+ // upgrade by stamping the pre call in a temp file keyed by tool_use_id.
1336
+ const postCall = nativeCallOf();
1337
+ const postTarget = postCall ? await nativeTargetOf() : undefined;
1338
+ if (postCall && postTarget) {
1339
+ await runNativePost(postTarget, postCall, {
1340
+ result: msg.tool_response,
1341
+ durationMs: 0,
1342
+ });
1343
+ }
1271
1344
  // Active session heartbeat (workers only, fire-and-forget)
1272
1345
  if (agentInfo && !agentInfo.isLead) {
1273
1346
  const heartbeatTaskFile = await readTaskFile();
@@ -1373,6 +1446,7 @@ export async function handleHook(): Promise<void> {
1373
1446
  }
1374
1447
  }
1375
1448
  break;
1449
+ }
1376
1450
 
1377
1451
  case "Stop":
1378
1452
  // Sync CLAUDE.md (then restore its backup), identity files, and setup script back to database
@@ -0,0 +1,245 @@
1
+ /**
2
+ * Worker shim for harness-native tool calls (bash, read, write, edit, ...).
3
+ *
4
+ * Every harness reports its own built-in tool calls to `POST /api/tool-hooks`, where
5
+ * extensions whose manifest lists `toolSources: ["native"]` can observe, block or rewrite
6
+ * them. One module serves all four harnesses (claude and codex run it per hook process, pi
7
+ * and opencode run it in-process); each harness only maps its own event to a `NativeCall`
8
+ * and applies the `NativeDecision`.
9
+ *
10
+ * Contract, in order of importance:
11
+ * - Fail open. An API that is down, slow (2 s) or answers non-2xx lets the call run.
12
+ * - Skip the round trip when no enabled extension takes native calls: a cached
13
+ * `GET /api/tool-hooks/status` answer (30 s) gates everything else.
14
+ * - Scrub arguments worker-side before they leave the process. The server scrubs again, but
15
+ * only knows its own env; a worker holds per-task credentials the server never sees.
16
+ * - Talk HTTP only. Never import the DB layer.
17
+ */
18
+
19
+ import { createHash } from "node:crypto";
20
+ import { readFileSync, writeFileSync } from "node:fs";
21
+ import { tmpdir } from "node:os";
22
+ import { join } from "node:path";
23
+ import { scrubObject } from "../utils/secret-scrubber";
24
+
25
+ const REQUEST_TIMEOUT_MS = 2_000;
26
+ const STATUS_TTL_MS = 30_000;
27
+ /** After a failed status read: stay quiet this long so a dead API costs one timeout, not one per call. */
28
+ const STATUS_FAILURE_TTL_MS = 10_000;
29
+
30
+ export interface NativeHookTarget {
31
+ apiUrl: string;
32
+ /** Authorization and X-Agent-ID, as the rest of the worker sends them. */
33
+ headers: Record<string, string>;
34
+ /** The running task, forwarded as `X-Source-Task-ID` so an extension run points at it. */
35
+ taskId?: string;
36
+ }
37
+
38
+ export interface NativeCall {
39
+ harness: "claude" | "codex" | "pi" | "opencode";
40
+ /** Canonical name: `bash`, `read`, `write`, `edit`, otherwise the harness name, lowercased. */
41
+ tool: string;
42
+ /** The harness's own tool name, such as `Bash`. */
43
+ nativeTool: string;
44
+ args: Record<string, unknown>;
45
+ rawArgs: unknown;
46
+ toolCallId?: string;
47
+ }
48
+
49
+ export type NativeDecision =
50
+ | { action: "continue" }
51
+ | { action: "modify"; args: Record<string, unknown> }
52
+ | { action: "block"; reason: string };
53
+
54
+ const CONTINUE: NativeDecision = { action: "continue" };
55
+
56
+ const CANONICAL_NAMES: Record<string, string> = {
57
+ bash: "bash",
58
+ shell: "bash",
59
+ read: "read",
60
+ write: "write",
61
+ edit: "edit",
62
+ multiedit: "edit",
63
+ };
64
+
65
+ /** Canonical tool name: the four shared ones are the same on every harness. */
66
+ export function canonicalToolName(nativeTool: string): string {
67
+ const lower = nativeTool.toLowerCase();
68
+ return CANONICAL_NAMES[lower] ?? lower;
69
+ }
70
+
71
+ /**
72
+ * Canonical args are the harness's own keys with Claude's `file_path` renamed `path`, the key
73
+ * pi and opencode already use.
74
+ * shortcut: no per-tool schema (edit shapes still differ per harness), upgrade when an
75
+ * extension needs to treat an edit identically across harnesses.
76
+ */
77
+ export function canonicalArgs(raw: unknown): Record<string, unknown> {
78
+ if (typeof raw !== "object" || raw === null || Array.isArray(raw)) return {};
79
+ const { file_path, ...rest } = raw as Record<string, unknown>;
80
+ return file_path === undefined ? rest : { ...rest, path: file_path };
81
+ }
82
+
83
+ /** Back to the harness's key names, so a rewritten `path` reaches a tool that reads `file_path`. */
84
+ export function rawArgsFromCanonical(args: Record<string, unknown>, raw: unknown): unknown {
85
+ const usesFilePath = typeof raw === "object" && raw !== null && "file_path" in raw;
86
+ if (!usesFilePath || args.path === undefined) return args;
87
+ const { path, ...rest } = args;
88
+ return { ...rest, file_path: path };
89
+ }
90
+
91
+ function cacheKey(target: NativeHookTarget): string {
92
+ return createHash("sha256")
93
+ .update(`${target.apiUrl}\n${target.headers["X-Agent-ID"] ?? ""}`)
94
+ .digest("hex")
95
+ .slice(0, 16);
96
+ }
97
+
98
+ interface StatusEntry {
99
+ native: boolean;
100
+ /** When this answer stops being trusted. */
101
+ until: number;
102
+ }
103
+
104
+ const memoryStatus = new Map<string, StatusEntry>();
105
+
106
+ function readStatusFile(path: string): StatusEntry | undefined {
107
+ try {
108
+ const parsed = JSON.parse(readFileSync(path, "utf8")) as Partial<StatusEntry>;
109
+ if (typeof parsed.native === "boolean" && typeof parsed.until === "number") {
110
+ return { native: parsed.native, until: parsed.until };
111
+ }
112
+ } catch {
113
+ // No file, or a half-written one: read the API instead.
114
+ }
115
+ return undefined;
116
+ }
117
+
118
+ /**
119
+ * Whether any enabled extension takes native tool calls. The claude and codex hooks are a new
120
+ * process per call, so the answer lives in a small file under the temp dir as well as in memory.
121
+ */
122
+ export async function nativeHooksActive(
123
+ target: NativeHookTarget,
124
+ fetchImpl: typeof fetch = fetch,
125
+ now: () => number = Date.now,
126
+ ): Promise<boolean> {
127
+ const key = cacheKey(target);
128
+ const file = join(tmpdir(), `agent-swarm-native-hooks-${key}.json`);
129
+ const cached = memoryStatus.get(key) ?? readStatusFile(file);
130
+ if (cached && cached.until > now()) return cached.native;
131
+
132
+ let entry: StatusEntry;
133
+ try {
134
+ const response = await fetchImpl(`${target.apiUrl}/api/tool-hooks/status`, {
135
+ headers: target.headers,
136
+ signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
137
+ });
138
+ if (!response.ok) throw new Error(`status ${response.status}`);
139
+ const body = (await response.json()) as { native?: unknown };
140
+ entry = { native: body.native === true, until: now() + STATUS_TTL_MS };
141
+ } catch {
142
+ entry = { native: false, until: now() + STATUS_FAILURE_TTL_MS };
143
+ }
144
+ memoryStatus.set(key, entry);
145
+ try {
146
+ writeFileSync(file, JSON.stringify(entry));
147
+ } catch {
148
+ // An unwritable temp dir only costs the cache.
149
+ }
150
+ return entry.native;
151
+ }
152
+
153
+ /** Drop the cached answers. Tests and e2e runs that flip an extension need a fresh read. */
154
+ export function resetNativeHookCache(): void {
155
+ memoryStatus.clear();
156
+ }
157
+
158
+ function postHeaders(target: NativeHookTarget): Record<string, string> {
159
+ return {
160
+ ...target.headers,
161
+ "Content-Type": "application/json",
162
+ ...(target.taskId ? { "X-Source-Task-ID": target.taskId } : {}),
163
+ };
164
+ }
165
+
166
+ function wireBody(call: NativeCall) {
167
+ return scrubObject({
168
+ harness: call.harness,
169
+ tool: call.tool,
170
+ nativeTool: call.nativeTool,
171
+ args: call.args,
172
+ rawArgs: call.rawArgs,
173
+ ...(call.toolCallId ? { toolCallId: call.toolCallId } : {}),
174
+ });
175
+ }
176
+
177
+ /**
178
+ * Ask the extensions about a native call before it runs. Returns `continue` when no extension
179
+ * takes native calls (no request is made), unless one blocked or rewrote it; any failure is
180
+ * `continue`. A body over the route's 2 MB limit is refused with a 4xx and so is not intercepted.
181
+ */
182
+ export async function runNativePre(
183
+ target: NativeHookTarget,
184
+ call: NativeCall,
185
+ fetchImpl: typeof fetch = fetch,
186
+ ): Promise<NativeDecision> {
187
+ if (!(await nativeHooksActive(target, fetchImpl))) return CONTINUE;
188
+ try {
189
+ const response = await fetchImpl(`${target.apiUrl}/api/tool-hooks`, {
190
+ method: "POST",
191
+ headers: postHeaders(target),
192
+ body: JSON.stringify({ phase: "pre", ...wireBody(call) }),
193
+ signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
194
+ });
195
+ if (!response.ok) return CONTINUE;
196
+ const decision = (await response.json()) as Record<string, unknown>;
197
+ if (decision.action === "block" && typeof decision.reason === "string") {
198
+ return { action: "block", reason: decision.reason };
199
+ }
200
+ if (decision.action === "modify") {
201
+ const args = decision.args;
202
+ if (typeof args === "object" && args !== null && !Array.isArray(args)) {
203
+ return { action: "modify", args: args as Record<string, unknown> };
204
+ }
205
+ }
206
+ } catch {
207
+ // Fail open.
208
+ }
209
+ return CONTINUE;
210
+ }
211
+
212
+ const MAX_RESULT_CHARS = 64_000;
213
+
214
+ /** A tool result can be megabytes; an observer needs the head of it, not all of it. */
215
+ function clipResult(result: unknown): unknown {
216
+ const text = typeof result === "string" ? result : JSON.stringify(result);
217
+ if (text === undefined || text.length <= MAX_RESULT_CHARS) return result;
218
+ return `${text.slice(0, MAX_RESULT_CHARS)}… [clipped, ${text.length} chars]`;
219
+ }
220
+
221
+ /** Report a finished native call. Observe-only: the answer is 202 and nothing can change. */
222
+ export async function runNativePost(
223
+ target: NativeHookTarget,
224
+ call: NativeCall,
225
+ outcome: { result: unknown; isError?: boolean; durationMs: number },
226
+ fetchImpl: typeof fetch = fetch,
227
+ ): Promise<void> {
228
+ if (!(await nativeHooksActive(target, fetchImpl))) return;
229
+ try {
230
+ await fetchImpl(`${target.apiUrl}/api/tool-hooks`, {
231
+ method: "POST",
232
+ headers: postHeaders(target),
233
+ body: JSON.stringify({
234
+ phase: "post",
235
+ ...wireBody(call),
236
+ ...scrubObject({ result: clipResult(outcome.result) }),
237
+ ...(outcome.isError === undefined ? {} : { isError: outcome.isError }),
238
+ durationMs: Math.max(0, outcome.durationMs),
239
+ }),
240
+ signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
241
+ });
242
+ } catch {
243
+ // Fail open.
244
+ }
245
+ }
@@ -0,0 +1,152 @@
1
+ /**
2
+ * Operator-only agent delete and restore (src/be/agent-history.ts). Every route
3
+ * checks `agent.lifecycle.manage`, which only the shared key without
4
+ * `X-Agent-ID` (operator) and user tokens hold, so no agent, the lead included,
5
+ * can delete or restore one. There is deliberately no MCP tool.
6
+ */
7
+ import type { IncomingMessage, ServerResponse } from "node:http";
8
+ import { z } from "zod";
9
+ import {
10
+ AgentHistoryError,
11
+ deleteAgentToHistory,
12
+ listAgentHistory,
13
+ restoreAgentFromHistory,
14
+ } from "../be/agent-history";
15
+ import { can } from "../rbac";
16
+ import { AgentHistoryEventSchema, AgentSchema } from "../types";
17
+ import { scrubSecrets } from "../utils/secret-scrubber";
18
+ import { getOperatorActor } from "./operator-actor";
19
+ import { agentFirstPrincipal } from "./request-principal";
20
+ import { route } from "./route-def";
21
+ import { jsonError } from "./utils";
22
+
23
+ const params = z.object({ id: z.string().min(1) });
24
+ const reason = z.string().trim().min(3).max(2000);
25
+ const RefusalSchema = z.object({
26
+ error: z.string(),
27
+ code: z.string(),
28
+ blockers: z.array(z.object({ code: z.string(), message: z.string() })),
29
+ });
30
+ const RBAC = { permission: "agent.lifecycle.manage" } as const;
31
+ const DENIED = { description: "Operator or user credentials required" };
32
+
33
+ const deleteRoute = route({
34
+ method: "post",
35
+ path: "/api/agents/{id}/delete",
36
+ pattern: ["api", "agents", null, "delete"],
37
+ summary: "Delete an agent into agent_history",
38
+ description:
39
+ "Appends the agent row to `agent_history`, revokes its session tokens, and deletes the row. Refused with 409 while the agent is the lead, an extension identity, not offline, pool-bound, holds open tasks or enabled schedules, or owns skills, MCP servers or inboxes.",
40
+ tags: ["Agents"],
41
+ params,
42
+ body: z.object({ reason }),
43
+ responses: {
44
+ 200: { description: "Agent deleted", schema: z.object({ event: AgentHistoryEventSchema }) },
45
+ 400: { description: "Validation error" },
46
+ 403: DENIED,
47
+ 404: { description: "Agent not found" },
48
+ 409: { description: "A blocker refuses the delete", schema: RefusalSchema },
49
+ },
50
+ rbac: RBAC,
51
+ });
52
+
53
+ const restoreRoute = route({
54
+ method: "post",
55
+ path: "/api/agents/{id}/restore",
56
+ pattern: ["api", "agents", null, "restore"],
57
+ summary: "Restore a deleted agent from agent_history",
58
+ description:
59
+ "Reinserts the latest deleted snapshot under the same id. Rows a cascading foreign key removed on delete do not come back.",
60
+ tags: ["Agents"],
61
+ params,
62
+ body: z.object({ reason, newName: z.string().trim().min(1).optional() }),
63
+ responses: {
64
+ 200: {
65
+ description: "Agent restored",
66
+ schema: z.object({ agent: AgentSchema, event: AgentHistoryEventSchema }),
67
+ },
68
+ 400: { description: "Validation error" },
69
+ 403: DENIED,
70
+ 404: { description: "No deleted agent with this id" },
71
+ 409: { description: "The agent exists, or its name is taken", schema: RefusalSchema },
72
+ },
73
+ rbac: RBAC,
74
+ });
75
+
76
+ const historyRoute = route({
77
+ method: "get",
78
+ path: "/api/agent-history",
79
+ pattern: ["api", "agent-history"],
80
+ summary: "List agent delete and restore events",
81
+ description: "Newest first, at most 500. Filter by `agentId`.",
82
+ tags: ["Agents"],
83
+ query: z.object({ agentId: z.string().min(1).optional() }),
84
+ responses: {
85
+ 200: {
86
+ description: "Events",
87
+ schema: z.object({ events: z.array(AgentHistoryEventSchema) }),
88
+ },
89
+ 403: DENIED,
90
+ },
91
+ rbac: RBAC,
92
+ });
93
+
94
+ export async function handleAgentLifecycle(
95
+ req: IncomingMessage,
96
+ res: ServerResponse,
97
+ pathSegments: string[],
98
+ queryParams: URLSearchParams,
99
+ myAgentId: string | undefined,
100
+ ): Promise<boolean> {
101
+ const matched = [deleteRoute, restoreRoute, historyRoute].find((r) =>
102
+ r.match(req.method, pathSegments),
103
+ );
104
+ if (!matched) return false;
105
+ const decision = can({
106
+ principal: await agentFirstPrincipal(req, myAgentId),
107
+ verb: "agent.lifecycle.manage",
108
+ resource:
109
+ matched === historyRoute ? { kind: "none" } : { kind: "agent", agentId: pathSegments[2]! },
110
+ source: "http",
111
+ });
112
+ if (!decision.allow) {
113
+ jsonError(res, scrubSecrets(decision.reason), 403);
114
+ return true;
115
+ }
116
+ if (matched === historyRoute) {
117
+ const parsed = await historyRoute.parse(req, res, pathSegments, queryParams);
118
+ if (!parsed) return true;
119
+ historyRoute.respond(res, 200, { events: await listAgentHistory(parsed.query.agentId) });
120
+ return true;
121
+ }
122
+ const operator = getOperatorActor(req, res);
123
+ if (!operator) return true;
124
+ const actorRef = operator.kind === "user" ? `user:${operator.id}` : operator.id;
125
+ try {
126
+ if (matched === deleteRoute) {
127
+ const parsed = await deleteRoute.parse(req, res, pathSegments, queryParams);
128
+ if (!parsed) return true;
129
+ const event = await deleteAgentToHistory(parsed.params.id, parsed.body.reason, actorRef);
130
+ deleteRoute.respond(res, 200, { event });
131
+ return true;
132
+ }
133
+ const parsed = await restoreRoute.parse(req, res, pathSegments, queryParams);
134
+ if (!parsed) return true;
135
+ restoreRoute.respond(
136
+ res,
137
+ 200,
138
+ await restoreAgentFromHistory(parsed.params.id, parsed.body, actorRef),
139
+ );
140
+ return true;
141
+ } catch (error) {
142
+ if (!(error instanceof AgentHistoryError)) throw error;
143
+ if (error.status === 404) {
144
+ jsonError(res, error.message, 404);
145
+ return true;
146
+ }
147
+ const body = { error: error.message, code: error.code, blockers: error.blockers };
148
+ if (matched === restoreRoute) restoreRoute.respond(res, 409, body);
149
+ else deleteRoute.respond(res, 409, body);
150
+ return true;
151
+ }
152
+ }