@desplega.ai/agent-swarm 2.12.0 → 2.13.1

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 (417) hide show
  1. package/dist/acp-adapter-xtj40wd8.js +17 -0
  2. package/dist/{acp-targets-311gcyvw.js → acp-targets-n7vm5atw.js} +10 -9
  3. package/dist/{actions-c4chgxp6.js → actions-hq6wp9xv.js} +28 -27
  4. package/dist/{agent-fs-provision-0b9awm5n.js → agent-fs-provision-y0qc1rdd.js} +4 -4
  5. package/dist/{amp-adapter-r0veq6x5.js → amp-adapter-1qqs6h91.js} +3 -3
  6. package/dist/{app-hn5fftf5.js → app-7m4z44rv.js} +10 -8
  7. package/dist/{approval-notifications-3g6yc8nv.js → approval-notifications-8sr41gjx.js} +11 -10
  8. package/dist/{assistant-cpjgpjvp.js → assistant-hkczwfv6.js} +29 -28
  9. package/dist/{boot-args-schema-hce1av1h.js → boot-args-schema-8025snev.js} +1 -1
  10. package/dist/{boot-reembed-bztbxc4z.js → boot-reembed-15m87nr1.js} +5 -2
  11. package/dist/{boot-reembed-d7xcym0j.js → boot-reembed-4bbpxjh1.js} +1 -1
  12. package/dist/{boot-scrub-sweep-mkmm16gk.js → boot-scrub-sweep-eajr97e9.js} +2 -2
  13. package/dist/{boot-seeds-arrkbe8t.js → boot-seeds-9cwy39jx.js} +4 -4
  14. package/dist/{boxd-68n75y1s.js → boxd-hr8rsxzq.js} +1 -1
  15. package/dist/{claude-adapter-ykpyr5p8.js → claude-adapter-g61wa4rt.js} +9 -8
  16. package/dist/{claude-managed-adapter-ssg6z4bt.js → claude-managed-adapter-znkk0prm.js} +4 -4
  17. package/dist/{claude-managed-setup-trd59v7b.js → claude-managed-setup-f1wndkr2.js} +7 -7
  18. package/dist/{claude-sdk-session-yjcze0j1.js → claude-sdk-session-687xzf21.js} +20763 -19380
  19. package/dist/{cli-ya3kf4gs.js → cli-04103ryh.js} +1 -1
  20. package/dist/{cli-55tc8cj4.js → cli-0a336ze7.js} +5 -5
  21. package/dist/{cli-q8tc22bj.js → cli-0fx95c06.js} +5 -5
  22. package/dist/{cli-mq2fbgva.js → cli-0m77n7ej.js} +3 -3
  23. package/dist/{cli-7yn42w6m.js → cli-0xwb7zpt.js} +2 -2
  24. package/dist/{cli-mcymtvwn.js → cli-13t0smbk.js} +1000 -28
  25. package/dist/{cli-c7j31hq9.js → cli-1b5axkt1.js} +4 -4
  26. package/dist/{cli-yegz2g06.js → cli-1carhg8g.js} +4 -4
  27. package/dist/{cli-j5gtytvg.js → cli-1dr5at77.js} +15 -12
  28. package/dist/cli-2v4xxnx2.js +148 -0
  29. package/dist/{cli-sv2r3bw8.js → cli-32xndx6b.js} +7 -7
  30. package/dist/{cli-h70a2mxy.js → cli-3m8vqehw.js} +53 -13
  31. package/dist/{cli-ercwc8xn.js → cli-3mf04tkh.js} +1 -1
  32. package/dist/{cli-52nfye5j.js → cli-3zyme1wt.js} +24 -16
  33. package/dist/{cli-s6zk31gr.js → cli-43dsqhcp.js} +4 -4
  34. package/dist/{cli-b93d81yg.js → cli-4h90xaet.js} +2 -2
  35. package/dist/{cli-5tg94mdw.js → cli-4mj5g29m.js} +9 -12
  36. package/dist/{cli-47hz21se.js → cli-4tbvndmm.js} +4 -5
  37. package/dist/{cli-r0mz92by.js → cli-50whymxq.js} +2 -2
  38. package/dist/{cli-js10kdk7.js → cli-5basv0e7.js} +19 -5
  39. package/dist/{cli-krbcr00p.js → cli-5v6b2am8.js} +59 -5
  40. package/dist/{cli-en6dmkxd.js → cli-6r1dwegd.js} +3 -3
  41. package/dist/{cli-9qe5y107.js → cli-7ewre3dm.js} +15 -6
  42. package/dist/{cli-n3qe7tyr.js → cli-84xtgbn6.js} +35 -2
  43. package/dist/{cli-xm34qj8m.js → cli-8cmjkbvj.js} +2 -2
  44. package/dist/{cli-2m6yaq6b.js → cli-8fj8yfmk.js} +1 -1
  45. package/dist/{cli-nja15knq.js → cli-8rbkw18r.js} +3 -3
  46. package/dist/{cli-x05p2d05.js → cli-9tevdxyf.js} +1 -1
  47. package/dist/{cli-hhc47ack.js → cli-9xx36trj.js} +4 -4
  48. package/dist/{cli-39qm0rtm.js → cli-a8ts6x1n.js} +29 -150
  49. package/dist/{cli-bp6k9acz.js → cli-aebswqmz.js} +18 -18
  50. package/dist/{cli-ex1y88j3.js → cli-at67kvnp.js} +1 -1
  51. package/dist/{cli-q2dywc8h.js → cli-bjmq14k9.js} +4 -4
  52. package/dist/{cli-v9ya390t.js → cli-byxsctca.js} +12 -12
  53. package/dist/{cli-bz97ff9n.js → cli-c0tyzt73.js} +152 -12
  54. package/dist/{cli-fyaq4zdv.js → cli-c8kqmzzf.js} +9 -9
  55. package/dist/{cli-t75xngj1.js → cli-cd9acnvd.js} +12 -12
  56. package/dist/{cli-eqq0hwvx.js → cli-cmgdptmx.js} +3 -3
  57. package/dist/{cli-r14ac1y0.js → cli-cn6fpa1p.js} +1 -1
  58. package/dist/{cli-0k1a0sde.js → cli-cp0m07wb.js} +10 -10
  59. package/dist/{cli-3p288654.js → cli-cpkxh68d.js} +2 -2
  60. package/dist/{cli-fxd1mwtr.js → cli-cqxwjb93.js} +2 -2
  61. package/dist/{cli-8hp56wat.js → cli-d2epqm0y.js} +1 -1
  62. package/dist/{cli-73q4g5nx.js → cli-dd57p1gd.js} +21 -21
  63. package/dist/{cli-5z0g0e8v.js → cli-f8rcvf2x.js} +49 -13
  64. package/dist/{cli-wvjqaqcp.js → cli-fn8aj7gb.js} +1330 -249
  65. package/dist/{cli-bpje8n65.js → cli-fp65jdp2.js} +31 -6
  66. package/dist/{cli-0pp1yjg2.js → cli-gedf48yw.js} +11 -11
  67. package/dist/{cli-m5qtmrbc.js → cli-gq6qhmrr.js} +2 -2
  68. package/dist/{cli-5x03v6en.js → cli-grcc2h2g.js} +8 -8
  69. package/dist/{cli-01tvvtad.js → cli-h03j6je3.js} +4 -4
  70. package/dist/{cli-mbwmqb5w.js → cli-h0ewec3d.js} +1 -1
  71. package/dist/{cli-12vek61e.js → cli-h9bejmkf.js} +535 -146
  72. package/dist/{cli-gfy6hbd9.js → cli-hs3mqswp.js} +18 -11
  73. package/dist/{cli-tdk7jtka.js → cli-hv3820ez.js} +1 -1
  74. package/dist/{cli-pqfecppn.js → cli-je587f74.js} +1 -1
  75. package/dist/{cli-cjqyse9q.js → cli-jhtvt7gn.js} +3 -3
  76. package/dist/{cli-dkvtfgn4.js → cli-mmw2sjaf.js} +76 -17
  77. package/dist/{cli-2z2c4k6q.js → cli-mwxez0pz.js} +22 -0
  78. package/dist/{cli-yfpc6qy9.js → cli-nk8swfpx.js} +47 -16
  79. package/dist/{cli-eq4kew31.js → cli-p7g7wd9n.js} +26 -13
  80. package/dist/{cli-bhgrhedp.js → cli-q8aq48v1.js} +1 -1
  81. package/dist/{cli-dd2k2mcd.js → cli-qn79645p.js} +1 -1
  82. package/dist/{cli-ma9ys8rt.js → cli-qx1dwrr5.js} +7 -4
  83. package/dist/{cli-tm60vtax.js → cli-rfejbpe1.js} +1 -1
  84. package/dist/{cli-agjbj5x0.js → cli-s6fhqbz1.js} +38 -20
  85. package/dist/{cli-kwr5qv5g.js → cli-sfajkbd7.js} +2 -2
  86. package/dist/{cli-9y4tgrkf.js → cli-skd2c4ej.js} +2 -1
  87. package/dist/{cli-e8n0hdzd.js → cli-snypfjgj.js} +1 -1
  88. package/dist/{cli-n8f0fs3c.js → cli-t25rq8mg.js} +11 -11
  89. package/dist/{cli-72yms3ey.js → cli-t90k0phh.js} +201 -21
  90. package/dist/{cli-xf4z5bdn.js → cli-tzzas8rb.js} +4 -4
  91. package/dist/{cli-rtmqzat7.js → cli-vdfngx2g.js} +2 -2
  92. package/dist/{cli-9w8712tq.js → cli-vr4eyq6p.js} +43 -14
  93. package/dist/{cli-z4f346g5.js → cli-vx9acp12.js} +1 -1
  94. package/dist/{cli-2amwhyv2.js → cli-w24f3j49.js} +13 -11
  95. package/dist/cli-w41bvvms.js +148 -0
  96. package/dist/{cli-04zc3f7b.js → cli-w6c6dj91.js} +1 -1
  97. package/dist/{cli-fy4gb74g.js → cli-x5yb8zc8.js} +2 -2
  98. package/dist/{cli-2tw284hj.js → cli-xhkek467.js} +3 -3
  99. package/dist/{cli-5r95eqbh.js → cli-y260hgep.js} +1 -1
  100. package/dist/{cli-hbvgzjq4.js → cli-y6qqbpwc.js} +3 -3
  101. package/dist/{cli-7wy8gbwb.js → cli-ya1cj689.js} +1 -1
  102. package/dist/{cli-1htmtqc2.js → cli-yeh3g1q6.js} +620 -95
  103. package/dist/{cli-0vcqcwfn.js → cli-yfvhvw8m.js} +2 -0
  104. package/dist/{cli-k5jx8jya.js → cli-z6m6xzxt.js} +2 -2
  105. package/dist/{cli-pe3yxedk.js → cli-zaate0rd.js} +3 -3
  106. package/dist/{cli-n85m2wkq.js → cli-zkbz8m2q.js} +3 -2
  107. package/dist/{cli-e3ahxq5y.js → cli-zvpkrgsc.js} +6 -6
  108. package/dist/cli.js +30 -28
  109. package/dist/{codex-adapter-wc6e4wct.js → codex-adapter-ysfg6ty3.js} +8 -8
  110. package/dist/{codex-hook-aqtj17yr.js → codex-hook-c0nvm30r.js} +73 -2
  111. package/dist/{codex-login-1ven7yje.js → codex-login-ven5cz5j.js} +1 -1
  112. package/dist/{codex-session-runner-ppfgjd97.js → codex-session-runner-823scr6g.js} +9 -9
  113. package/dist/{commands-tsv2vx5b.js → commands-5rbm07fz.js} +3 -3
  114. package/dist/{controller-ye4sdwsy.js → controller-wn3vd217.js} +4 -4
  115. package/dist/{controllers-connect-zn4dg69h.js → controllers-connect-34jzhfft.js} +29 -28
  116. package/dist/core-kdehq26g.js +42 -0
  117. package/dist/{cursor-adapter-q2g9vwts.js → cursor-adapter-w1681kp1.js} +2 -2
  118. package/dist/{db-g111qn9j.js → db-6bkgbfwk.js} +3 -3
  119. package/dist/{db-3r1fyr2n.js → db-hcj16x7z.js} +4 -2
  120. package/dist/{devin-adapter-t8d86q9x.js → devin-adapter-fs90ab4v.js} +1 -1
  121. package/dist/{dispatcher-4q8s0mx8.js → dispatcher-jgjqrfzv.js} +28 -25
  122. package/dist/{docker-1b41eysj.js → docker-1h33jvh9.js} +2 -2
  123. package/dist/{dsh-adapter-mmcw1z5s.js → dsh-adapter-g9yqv09y.js} +2 -2
  124. package/dist/{e2b-xm60c8ad.js → e2b-jnk0yeva.js} +2 -2
  125. package/dist/{e2b-ew8c5j5v.js → e2b-y7e5kmzf.js} +2 -2
  126. package/dist/{easter-egg-3d-04ke6hcp.js → easter-egg-3d-w17nsny6.js} +1 -1
  127. package/dist/{embedding-space-kcdn52vz.js → embedding-space-v06fwy7b.js} +6 -6
  128. package/dist/{embeddings-jnzcd91a.js → embeddings-g50dxea4.js} +1 -1
  129. package/dist/{event-bus-v4ywhc2p.js → event-bus-08t2b4y2.js} +1 -1
  130. package/dist/{execute-74amghty.js → execute-1n36haw1.js} +1 -1
  131. package/dist/{external-channel-v9zgxnxz.js → external-channel-43tv8pg6.js} +2 -2
  132. package/dist/fx-adapter-bvh05t4a.js +20 -0
  133. package/dist/grok-adapter-my5j8mdf.js +20 -0
  134. package/dist/handlers-wyymeeqh.js +41 -0
  135. package/dist/heartbeat-sf3nk937.js +50 -0
  136. package/dist/{hook-p5reemds.js → hook-dqph1e05.js} +77 -18
  137. package/dist/{hook-k1h73zd7.js → hook-m1m9dm6w.js} +6 -5
  138. package/dist/{http-ms1z5xxy.js → http-w0th1cz9.js} +888 -226
  139. package/dist/index-22khdtby.js +44 -0
  140. package/dist/{index-76zzxtzf.js → index-c0e8en64.js} +1 -1
  141. package/dist/{index-620y7jzq.js → index-e8pz8qdg.js} +3 -3
  142. package/dist/{index-8p0j4h4j.js → index-ez823q84.js} +94 -89
  143. package/dist/{index-fbkqhvvj.js → index-ffba0z8q.js} +217 -165
  144. package/dist/{index-gjn6qfgn.js → index-gkpfgpg7.js} +1 -1
  145. package/dist/{index-4k7m5dgj.js → index-k8ajc0g0.js} +143 -103
  146. package/dist/index-np0582ac.js +40 -0
  147. package/dist/{index-kn63q1gr.js → index-pb03vans.js} +33 -32
  148. package/dist/index-vgkrj1jt.js +39 -0
  149. package/dist/{index-pe3d8jfy.js → index-whysn1wf.js} +1 -1
  150. package/dist/{index-0h6qd4p1.js → index-y4vd4mhn.js} +3 -4
  151. package/dist/{k8s-fy8hbhkg.js → k8s-8326q0rq.js} +2 -2
  152. package/dist/{keepalive-031js8jz.js → keepalive-2v06q2e8.js} +5 -4
  153. package/dist/lead-55z813ng.js +79 -0
  154. package/dist/{maintenance-sq9v3qx9.js → maintenance-vx7vjhhy.js} +1 -1
  155. package/dist/{oauth-refresh-sweep-zqmnyvs8.js → oauth-refresh-sweep-g06k4bza.js} +4 -3
  156. package/dist/{object-webhooks-r24wwb5y.js → object-webhooks-3dzdq4fm.js} +7 -7
  157. package/dist/{onboard-p25yhh7t.js → onboard-232pazny.js} +4 -4
  158. package/dist/{opencode-adapter-wcjc4zdk.js → opencode-adapter-t0paqbh8.js} +8 -7
  159. package/dist/{otel-impl-ff1gf20m.js → otel-impl-kmpkyp4y.js} +2 -2
  160. package/dist/{pending-hxj5yatb.js → pending-x0z3vx1x.js} +27 -26
  161. package/dist/{pi-mono-adapter-vkp4zz7p.js → pi-mono-adapter-7pmypn6d.js} +93 -22
  162. package/dist/{pricing-refresh-9w7gx41w.js → pricing-refresh-ytjmtyd7.js} +2 -2
  163. package/dist/{rbac-roles-84aw10nz.js → rbac-roles-fgm5mxr2.js} +3 -3
  164. package/dist/{rbac-roles-hz74vckp.js → rbac-roles-xyaxekh3.js} +7 -4
  165. package/dist/{registry-eeyx1201.js → registry-zv0zvxsx.js} +1 -1
  166. package/dist/{render-v2-nrdkg9gf.js → render-v2-ws972g4r.js} +12 -8
  167. package/dist/{resume-s6ey36rh.js → resume-m6mjzhkp.js} +13 -12
  168. package/dist/{runtime-x0b4pyam.js → runtime-zzpc0c8a.js} +1 -1
  169. package/dist/{session-access-xv49tk14.js → session-access-vp35xs91.js} +5 -4
  170. package/dist/{session-source-backfill-r5j988ah.js → session-source-backfill-p73e8zbe.js} +3 -3
  171. package/dist/{setup-mj0krk1p.js → setup-r4kd7rxg.js} +1 -1
  172. package/dist/thread-buffer-cm2nzq6t.js +42 -0
  173. package/dist/{tree-visibility-cbrsfaar.js → tree-visibility-07h2tbs2.js} +2 -2
  174. package/dist/{user-merge-jobs-f9d8nwnw.js → user-merge-jobs-96vg9rpe.js} +3 -3
  175. package/dist/{virtual-modules-ns0ryw05.js → virtual-modules-vgn3f2x4.js} +3 -3
  176. package/dist/{work-objects-pydhzast.js → work-objects-74hbcx3e.js} +31 -29
  177. package/dist/worker-5pn2vzx6.js +79 -0
  178. package/dist/{worker-follow-up-9z2xec5e.js → worker-follow-up-ezavwn5d.js} +26 -25
  179. package/dist/{x-3dtaf2r9.js → x-asbrnafg.js} +2 -2
  180. package/dist/xlsx-9acfmxr1.js +31534 -0
  181. package/openapi.json +2816 -1464
  182. package/package.json +13 -11
  183. package/src/agentmail/handlers.ts +26 -19
  184. package/src/apps/catalog.generated.json +757 -0
  185. package/src/apps/definition.ts +24 -7
  186. package/src/apps/page-validator.ts +225 -3
  187. package/src/apps/row-store.ts +37 -14
  188. package/src/azure-devops/handlers.ts +2 -0
  189. package/src/be/audit-user.ts +46 -6
  190. package/src/be/db/kv-windows.ts +22 -0
  191. package/src/be/db/session-moves.ts +3 -3
  192. package/src/be/db/session-tree.ts +52 -5
  193. package/src/be/db/skill-audit.ts +17 -0
  194. package/src/be/db/tasks/write.ts +18 -3
  195. package/src/be/db.ts +152 -33
  196. package/src/be/extensions/assets.ts +11 -7
  197. package/src/be/mcp-proxy.ts +5 -4
  198. package/src/be/memory/demotion-evidence.ts +2 -2
  199. package/src/be/memory/providers/sqlite-store.ts +151 -18
  200. package/src/be/memory/search-read-worker.ts +60 -0
  201. package/src/be/memory/search-reader.ts +223 -0
  202. package/src/be/migrations/337_favorites_session_hidden_key.sql +39 -0
  203. package/src/be/migrations/338_audit_agent_columns.sql +30 -0
  204. package/src/be/migrations/339_deferred_event_waits.sql +26 -0
  205. package/src/be/migrations/340_api_key_spend_cap.sql +5 -0
  206. package/src/be/model-tier-resolution.ts +18 -1
  207. package/src/be/multi-runtime.ts +17 -0
  208. package/src/be/primitives/object-embed.ts +250 -0
  209. package/src/be/primitives/objects.ts +29 -9
  210. package/src/be/primitives/sheets/service.ts +138 -6
  211. package/src/be/primitives/sheets/xlsx.ts +367 -0
  212. package/src/be/rbac-roles.ts +3 -0
  213. package/src/be/repo-checked-update.ts +4 -4
  214. package/src/be/repo-merge-policy.ts +26 -9
  215. package/src/be/schedules/validate.ts +26 -0
  216. package/src/be/scripts/boot-reembed.ts +6 -0
  217. package/src/be/scripts/db.ts +17 -5
  218. package/src/be/scripts/embeddings.ts +6 -0
  219. package/src/be/scripts/typecheck.ts +43 -2
  220. package/src/be/seed/schedules-seeder.ts +9 -1
  221. package/src/be/seed/workflows-seeder.ts +9 -1
  222. package/src/be/seed-scripts/index.ts +2 -0
  223. package/src/be/seed-skills/index.ts +12 -0
  224. package/src/be/swarm-config-guard.ts +5 -0
  225. package/src/be/unmapped-identities.ts +95 -1
  226. package/src/bitbucket/handlers.ts +2 -0
  227. package/src/commands/credential-outcome-report.ts +5 -2
  228. package/src/commands/onboard/agent-fs-version.ts +1 -1
  229. package/src/commands/provider-credentials.ts +19 -0
  230. package/src/commands/provider-error-class.ts +4 -1
  231. package/src/commands/rate-limit-outcome.ts +48 -3
  232. package/src/commands/runner.ts +113 -55
  233. package/src/commands/worktree-reaper.ts +600 -0
  234. package/src/event-waits/github.ts +43 -0
  235. package/src/event-waits/index.ts +29 -0
  236. package/src/event-waits/types.ts +51 -0
  237. package/src/extensions/contract-types.generated.ts +1 -1
  238. package/src/extensions/dispatcher.ts +9 -0
  239. package/src/fs/agent-fs-provider.ts +4 -1
  240. package/src/github/handlers.ts +3 -1
  241. package/src/github/pull-request-state.ts +34 -0
  242. package/src/gitlab/handlers.ts +12 -7
  243. package/src/hooks/codex-hook.ts +99 -1
  244. package/src/hooks/hook.ts +85 -11
  245. package/src/hooks/native-tool-hooks.ts +245 -0
  246. package/src/http/agents.ts +4 -0
  247. package/src/http/all-routes.ts +1 -0
  248. package/src/http/api-keys.ts +27 -3
  249. package/src/http/assets.ts +4 -3
  250. package/src/http/comb.ts +2 -2
  251. package/src/http/favorite-owner.ts +2 -2
  252. package/src/http/favorites.ts +3 -2
  253. package/src/http/fs.ts +13 -4
  254. package/src/http/index.ts +2 -0
  255. package/src/http/mcp-bridge.ts +4 -0
  256. package/src/http/objects.ts +265 -0
  257. package/src/http/pages-public.ts +40 -4
  258. package/src/http/pages.ts +3 -3
  259. package/src/http/poll.ts +43 -12
  260. package/src/http/pool-keys.ts +21 -2
  261. package/src/http/repos.ts +7 -6
  262. package/src/http/schedules.ts +38 -9
  263. package/src/http/script-connections.ts +14 -6
  264. package/src/http/script-runs.ts +12 -3
  265. package/src/http/scripts.ts +9 -0
  266. package/src/http/sessions.ts +30 -12
  267. package/src/http/skills.ts +17 -0
  268. package/src/http/task-requester.ts +2 -2
  269. package/src/http/tasks.ts +18 -12
  270. package/src/http/tool-hooks.ts +24 -2
  271. package/src/http/trackers/authorize-gate.ts +2 -2
  272. package/src/http/users.ts +136 -1
  273. package/src/http/workflow-events.ts +13 -0
  274. package/src/http/workflows.ts +21 -11
  275. package/src/linear/sync.ts +3 -1
  276. package/src/mcp-client/http-client.ts +3 -1
  277. package/src/oauth/identity-capture.ts +6 -1
  278. package/src/oauth/mcp-wrapper.ts +10 -3
  279. package/src/oauth/wrapper.ts +15 -3
  280. package/src/prompts/base-prompt.ts +35 -13
  281. package/src/prompts/session-templates.ts +26 -0
  282. package/src/providers/acp-targets.ts +2 -2
  283. package/src/providers/amp-adapter.ts +1 -1
  284. package/src/providers/dsh-adapter.ts +1 -1
  285. package/src/providers/opencode-adapter.ts +1 -0
  286. package/src/providers/opencode-swarm-plugin.ts +50 -1
  287. package/src/providers/pi-mono-adapter.ts +143 -11
  288. package/src/providers/pi-mono-extension.ts +69 -0
  289. package/src/providers/runtime-dependencies.ts +1 -1
  290. package/src/rbac/legacy-policy.ts +5 -0
  291. package/src/rbac/permissions.ts +16 -1
  292. package/src/scheduler/deferred-task-waits.ts +170 -13
  293. package/src/scripts-runtime/executors/types.ts +5 -0
  294. package/src/scripts-runtime/loader.ts +8 -0
  295. package/src/scripts-runtime/mcp-client.ts +4 -0
  296. package/src/scripts-runtime/sdk-allowlist.ts +14 -1
  297. package/src/scripts-runtime/swarm-config.ts +8 -0
  298. package/src/scripts-runtime/swarm-sdk.ts +4 -0
  299. package/src/scripts-runtime/types/stdlib.d.ts +47 -4
  300. package/src/scripts-runtime/types/swarm-extension.d.ts +8 -7
  301. package/src/scripts-runtime/types/swarm-sdk.d.ts +47 -4
  302. package/src/server.ts +4 -0
  303. package/src/slack/enrich.ts +94 -31
  304. package/src/slack/handlers.test.ts +55 -2
  305. package/src/slack/handlers.ts +38 -3
  306. package/src/slack/render-v2.ts +19 -0
  307. package/src/slack/session-mirror.ts +208 -0
  308. package/src/slack/thread-participants.ts +0 -5
  309. package/src/slack/watcher.ts +3 -0
  310. package/src/slack/work-objects.test.ts +2 -1
  311. package/src/slack/work-objects.ts +7 -2
  312. package/src/tests/agentmail-filters.test.ts +4 -3
  313. package/src/tests/agents-list-model-display.test.ts +23 -0
  314. package/src/tests/apps-spike2.test.ts +35 -0
  315. package/src/tests/audit-agent-person.test.ts +825 -0
  316. package/src/tests/audit-updated-by.test.ts +19 -12
  317. package/src/tests/base-prompt.test.ts +1 -0
  318. package/src/tests/claude-hook-output.test.ts +107 -2
  319. package/src/tests/claude-managed-setup.test.ts +1 -1
  320. package/src/tests/codex-adapter.test.ts +6 -6
  321. package/src/tests/codex-gpt6-release.test.ts +4 -4
  322. package/src/tests/db-task-read-contract.test.ts +1 -0
  323. package/src/tests/db-task-write-contract.test.ts +1 -0
  324. package/src/tests/deploy-guard.test.ts +24 -0
  325. package/src/tests/dsh-adapter.test.ts +1 -1
  326. package/src/tests/ensure-token.test.ts +2 -2
  327. package/src/tests/entrypoint-repo-autoclone-args.test.ts +202 -0
  328. package/src/tests/extensions-catalog.test.ts +33 -25
  329. package/src/tests/fake-dns.ts +47 -0
  330. package/src/tests/fixtures/base-prompt-baseline.json +12 -12
  331. package/src/tests/fixtures/sheets/eocd-count-mismatch.xlsx +0 -0
  332. package/src/tests/fixtures/sheets/rich-budget.xlsx +0 -0
  333. package/src/tests/fixtures/sheets/tracker-export.xlsx +0 -0
  334. package/src/tests/kv-storage.test.ts +3 -0
  335. package/src/tests/latest-model-report.test.ts +138 -0
  336. package/src/tests/mcp-oauth-dcr-reuse.test.ts +5 -2
  337. package/src/tests/mcp-oauth-ensure-token.test.ts +3 -2
  338. package/src/tests/mcp-oauth-manual-client.test.ts +6 -1
  339. package/src/tests/mcp-oauth-wrapper.test.ts +20 -4
  340. package/src/tests/mcp-outbound-fetch-guard.test.ts +169 -0
  341. package/src/tests/mcp-server-ssrf.test.ts +2 -0
  342. package/src/tests/memory-search-reader.test.ts +258 -0
  343. package/src/tests/memory-search-stall.test.ts +202 -20
  344. package/src/tests/model-control.test.ts +4 -4
  345. package/src/tests/model-tier-resolution.test.ts +2 -2
  346. package/src/tests/multi-runtime-registration.test.ts +8 -2
  347. package/src/tests/native-tool-hooks.test.ts +188 -0
  348. package/src/tests/oauth-connection-fetch-guard.test.ts +162 -0
  349. package/src/tests/oauth-token-endpoint-fetch-guard.test.ts +121 -0
  350. package/src/tests/oauth-wrapper.test.ts +1 -2
  351. package/src/tests/opencode-swarm-plugin.test.ts +6 -1
  352. package/src/tests/pages-head-v2.test.ts +2 -1
  353. package/src/tests/pi-provider-runtime-keys.test.ts +163 -0
  354. package/src/tests/poll-probe-readonly.test.ts +108 -0
  355. package/src/tests/primitives-sheets-xlsx.test.ts +549 -0
  356. package/src/tests/prompt-template-session.test.ts +3 -2
  357. package/src/tests/rbac-roles.test.ts +3 -0
  358. package/src/tests/script-connections-http.test.ts +8 -3
  359. package/src/tests/script-connections.test.ts +6 -0
  360. package/src/tests/seed-model-profiles.test.ts +1 -1
  361. package/src/tests/sessions-tree.test.ts +10 -2
  362. package/src/tests/slack-thread-participants.test.ts +77 -4
  363. package/src/tests/spend-cap-credentials.test.ts +34 -0
  364. package/src/tests/spend-cap-outcome.test.ts +67 -0
  365. package/src/tests/subscription-first.test.ts +119 -0
  366. package/src/tests/tool-registrar-no-input.test.ts +1 -0
  367. package/src/tests/worktree-reaper.test.ts +424 -0
  368. package/src/tools/defer-task.ts +154 -12
  369. package/src/tools/get-task-details.ts +247 -5
  370. package/src/tools/objects.ts +10 -5
  371. package/src/tools/repos/update-repo.ts +6 -6
  372. package/src/tools/schedules/create-schedule.ts +1 -0
  373. package/src/tools/schedules/list-schedules.ts +3 -0
  374. package/src/tools/schedules/patch-schedule.ts +38 -4
  375. package/src/tools/schedules/update-schedule.ts +40 -5
  376. package/src/tools/sheets.ts +66 -0
  377. package/src/tools/skills/skill-create.ts +6 -0
  378. package/src/tools/skills/skill-install-remote.ts +6 -0
  379. package/src/tools/skills/skill-sync-remote.ts +9 -0
  380. package/src/tools/skills/skill-update.ts +9 -1
  381. package/src/tools/tool-config.ts +3 -1
  382. package/src/tools/utils.ts +15 -0
  383. package/src/tools/workflows/create-workflow.ts +9 -4
  384. package/src/tools/workflows/patch-workflow-node.ts +1 -1
  385. package/src/tools/workflows/patch-workflow.ts +5 -2
  386. package/src/tools/workflows/update-workflow.ts +13 -7
  387. package/src/types.ts +96 -12
  388. package/src/utils/credentials.ts +36 -1
  389. package/src/utils/egress-guard.ts +40 -10
  390. package/src/utils/error-tracker.ts +17 -0
  391. package/src/workflows/input.ts +12 -5
  392. package/src/workflows/patch-definition.ts +13 -5
  393. package/src/workflows/triggers.ts +11 -6
  394. package/src/workflows/version.ts +7 -1
  395. package/templates/skills/apps/SKILL.md +191 -2
  396. package/templates/skills/apps/content.md +191 -2
  397. package/templates/skills/boards-and-sheets/config.json +14 -0
  398. package/templates/skills/boards-and-sheets/content.md +174 -0
  399. package/templates/skills/pages/content.md +11 -0
  400. package/templates/skills/swarm-docs/content.md +11 -0
  401. package/templates/skills/swarm-scripts/SKILL.md +1 -0
  402. package/templates/skills/swarm-scripts/content.md +1 -0
  403. package/templates/workflows/ralph-loop/content.md +6 -6
  404. package/dist/acp-adapter-11m13kx4.js +0 -16
  405. package/dist/cli-pr0eze3x.js +0 -149
  406. package/dist/core-dxcy02sc.js +0 -41
  407. package/dist/fx-adapter-0ar6pqm3.js +0 -19
  408. package/dist/grok-adapter-t6m74fb1.js +0 -19
  409. package/dist/handlers-9kwcrc4k.js +0 -38
  410. package/dist/heartbeat-p8pk1msj.js +0 -49
  411. package/dist/index-23cdfzr6.js +0 -39
  412. package/dist/index-g7kkjs5b.js +0 -38
  413. package/dist/index-stk36pa5.js +0 -43
  414. package/dist/lead-mfggjtfk.js +0 -77
  415. package/dist/thread-buffer-temgaqsy.js +0 -41
  416. package/dist/worker-efcemc22.js +0 -77
  417. /package/dist/{cli-cah298e5.js → cli-m4ejz4nj.js} +0 -0
@@ -0,0 +1,51 @@
1
+ /**
2
+ * External-event waits: `defer-task wakeOn {event, source, match}` wakes an agent
3
+ * when a provider event arrives. Events enter through the webhook ingest that
4
+ * already emits on `workflowEventBus` (src/http/webhooks.ts); a provider plugs in
5
+ * by implementing this interface and registering in ./index.ts. The scheduler,
6
+ * the tool schema and the table know nothing about any one provider.
7
+ */
8
+
9
+ /** What a wait targets, normalized by the adapter (e.g. `{repo: "owner/name", number: 7}`). */
10
+ export type EventMatch = Record<string, string | number>;
11
+
12
+ /** A provider event reduced to the shared vocabulary (e.g. `vcs.pr.merged`). */
13
+ export type ExternalEvent = { event: string; match: EventMatch };
14
+
15
+ export interface ExternalEventAdapter {
16
+ /** Provider id as agents write it in `wakeOn.source`, e.g. `github`. */
17
+ readonly source: string;
18
+ /** Shared event names this adapter can serve, e.g. `vcs.pr.merged`. */
19
+ readonly events: readonly string[];
20
+ /** What `match` holds, for the tool description, e.g. `repo (owner/name), number`. */
21
+ readonly matchHint: string;
22
+ /** `workflowEventBus` name prefix the provider's webhook handler emits under, e.g. `github.`. */
23
+ readonly busPrefix: string;
24
+ /** True when `confirm` reads with server-held credentials, so task-scoped tokens may not trigger it. */
25
+ readonly readsWithServerCredentials?: boolean;
26
+ /** False when the provider integration is off, so no event could ever arrive. */
27
+ isEnabled(): boolean;
28
+ /** Validate and normalize the agent's match for `event`; throw an Error whose message names the fix. */
29
+ parseMatch(event: string, match: unknown): EventMatch;
30
+ /** Map one bus event to the shared events it signals (usually zero or one). Must not throw. */
31
+ fromBusEvent(busEvent: string, payload: unknown): ExternalEvent[];
32
+ /**
33
+ * Optional authoritative read: has `event` already happened for `match`? Throws
34
+ * when the provider cannot be read. With it, a webhook only names a candidate and
35
+ * the wait fires only on `true`, and boot re-checks pending waits (a delivery
36
+ * missed while the API was down). Without it, the verified webhook is trusted.
37
+ */
38
+ confirm?(event: string, match: EventMatch): Promise<boolean>;
39
+ }
40
+
41
+ /** Canonical key for lookup: the same match always yields the same string. */
42
+ export function matchKeyOf(match: EventMatch): string {
43
+ return JSON.stringify(Object.entries(match).sort(([a], [b]) => (a < b ? -1 : 1)));
44
+ }
45
+
46
+ export function describeEventWait(source: string, event: string, match: EventMatch): string {
47
+ const target = Object.entries(match)
48
+ .map(([key, value]) => `${key}=${value}`)
49
+ .join(", ");
50
+ return `${event} on ${source} (${target})`;
51
+ }
@@ -1,4 +1,4 @@
1
1
  // Generated by scripts/bundle-extension-types.ts. Do not edit.
2
2
  // biome-ignore-all lint/suspicious/noTemplateCurlyInString: Type declarations contain literal template placeholders.
3
3
  export const EXTENSION_TYPE_DEFINITIONS =
4
- '// biome-ignore-all lint/suspicious/noConfusingVoidType: Extension handlers may explicitly return no result.\ndeclare module "swarm-extension" {\n export type CreateTaskOptions = {\n key?: string | undefined;\n agentId?: string | null | undefined;\n creatorAgentId?: string | undefined;\n source?:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "system"\n | "linear"\n | "jira"\n | "comb"\n | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n taskType?: string | undefined;\n tags?: string[] | undefined;\n priority?: number | undefined;\n dependsOn?: string[] | undefined;\n offeredTo?: string | undefined;\n status?: "draft" | "backlog" | "unassigned" | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n overrideSlackContext?: boolean | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | undefined;\n workflowRunStepId?: string | undefined;\n sourceTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n inheritParentOutputSchema?: boolean | undefined;\n inheritParentRequester?: boolean | undefined;\n inheritParentRoutingAffinity?: boolean | undefined;\n inheritParentFollowUpConfig?: boolean | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n requestedByUserId?: string | undefined;\n contextKey?: string | undefined;\n bypassTrackerContextDedup?: boolean | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n };\n\n export type AgentTask = {\n id: string;\n key: string;\n agentId: string | null;\n task: string;\n status:\n | "skipped"\n | "draft"\n | "backlog"\n | "unassigned"\n | "offered"\n | "reviewing"\n | "pending"\n | "in_progress"\n | "paused"\n | "completed"\n | "failed"\n | "cancelled"\n | "superseded";\n source:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "system"\n | "linear"\n | "jira"\n | "comb";\n tags: string[];\n priority: number;\n dependsOn: string[];\n createdAt: string;\n lastUpdatedAt: string;\n slackReplySent: boolean;\n wasPaused: boolean;\n creatorAgentId?: string | undefined;\n title?: string | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n poolWakeAt?: string | undefined;\n taskType?: string | undefined;\n offeredTo?: string | undefined;\n offeredAt?: string | undefined;\n acceptedAt?: string | undefined;\n rejectionReason?: string | undefined;\n finishedAt?: string | undefined;\n notifiedAt?: string | undefined;\n failureReason?: string | undefined;\n output?: string | undefined;\n progress?: string | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n slackProgressMessageTs?: string | undefined;\n slackTreeRootMessageTs?: string | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n claudeSessionId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n resolvedModel?: string | undefined;\n modelSource?: string | undefined;\n modelAlias?: string | undefined;\n resolvedEffort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n resolvedProfile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | null | undefined;\n workflowRunStepId?: string | null | undefined;\n contextKey?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n deferredAt?: string | undefined;\n compactionCount?: number | undefined;\n peakContextPercent?: number | undefined;\n peakContextTokens?: number | undefined;\n contextWindowSize?: number | undefined;\n credentialKeySuffix?: string | undefined;\n credentialKeyType?: string | undefined;\n requestedByUserId?: string | undefined;\n swarmVersion?: string | undefined;\n provider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n providerMeta?: Record<string, unknown> | undefined;\n harnessVariant?: string | undefined;\n harnessVariantMeta?: Record<string, unknown> | undefined;\n totalCostUsd?: number | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "pi"\n | "claude"\n | "claude-managed"\n | "codex"\n | "grok"\n | "fx"\n | "opencode"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n routingAffinityInvalid?: boolean | undefined;\n };\n\n export type ActiveSession = {\n id: string;\n agentId: string;\n taskId: string | null;\n triggerType: string;\n inboxMessageId: string | null;\n taskDescription: string | null;\n runnerSessionId: string | null;\n providerSessionId: string | null;\n startedAt: string;\n lastHeartbeatAt: string;\n runtimeInstanceId?: string | null | undefined;\n };\n\n export type SteerMode = "steer" | "queue";\n\n export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui" | "app-page";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "mcp" | "native" | "extension" | "script-sdk";\n harness?: string | undefined;\n };\n\n import type { SwarmSdk } from "swarm-sdk";\n import type { z } from "zod";\n export type Runtime = "api" | "worker";\n export interface ExtensionScriptAsset {\n name: string;\n file: string;\n description: string;\n intent?: string;\n }\n export interface ExtensionScheduleAsset {\n name: string;\n description?: string;\n script: string;\n cronExpression?: string;\n intervalMs?: number;\n timezone?: string;\n args?: Record<string, unknown>;\n }\n export interface ExtensionWorkflowAsset {\n file: string;\n }\n export interface ExtensionSkillAsset {\n dir: string;\n }\n export interface ExtensionManifest {\n $schema?: string;\n name: string;\n description: string;\n version: string;\n runtime: Runtime;\n assets: {\n hooks: string;\n scripts?: readonly ExtensionScriptAsset[];\n schedules?: readonly ExtensionScheduleAsset[];\n workflows?: readonly ExtensionWorkflowAsset[];\n skills?: readonly ExtensionSkillAsset[];\n };\n homepage?: string;\n author?: string;\n /** Tool-call sources this extension\'s tool handlers receive. Default `["mcp"]`. */\n toolSources?: readonly ToolSource[];\n }\n /** `mcp`: swarm MCP tools. `native`: harness built-ins reported by a worker shim. */\n export type ToolSource = "mcp" | "native";\n export interface HooksModule {\n default: SwarmExtension;\n config?: z.ZodTypeAny;\n }\n export interface ExtensionState {\n get<T = unknown>(key: string): Promise<T | null>;\n set<T>(key: string, value: T): Promise<void>;\n incr(key: string, by?: number): Promise<number>;\n del(key: string): Promise<void>;\n }\n export interface ExtensionLogger {\n debug(message: string, data?: unknown): void;\n info(message: string, data?: unknown): void;\n warn(message: string, data?: unknown): void;\n error(message: string, data?: unknown): void;\n }\n type ConfigFor<M extends ExtensionManifest> = M extends {\n config: infer C extends z.ZodTypeAny;\n }\n ? z.infer<C>\n : Record<string, unknown>;\n export interface ApiCtx<Config = Record<string, unknown>> {\n swarm: SwarmSdk;\n state: ExtensionState;\n config: Config;\n log: ExtensionLogger;\n signal: AbortSignal;\n event: {\n name: keyof SwarmEventMap;\n at: string;\n extension: {\n id: string;\n version: number;\n };\n };\n }\n export interface WorkerCtx<Config = Record<string, unknown>>\n extends Omit<ApiCtx<Config>, "swarm"> {\n swarm: SwarmSdk;\n worker: {\n agentId: string;\n taskId: string;\n harness: string;\n };\n }\n export type CtxFor<M extends ExtensionManifest> = M["runtime"] extends "api"\n ? ApiCtx<ConfigFor<M>>\n : WorkerCtx<ConfigFor<M>>;\n export type PreResult<Modify> =\n | void\n | {\n action: "continue";\n }\n | {\n action: "modify";\n data: Modify;\n }\n | {\n action: "block";\n reason: string;\n };\n export type TaskCreateOrigin =\n | "rest"\n | "app"\n | "mcp"\n | "slack"\n | "schedule"\n | "workflow"\n | "webhook"\n | "followUp"\n | `extension:${string}`;\n export interface TaskCreateEvent {\n options: CreateTaskOptions;\n description: string;\n origin: TaskCreateOrigin;\n requestInfo?: RequestInfo;\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n trigger: "mention" | "thread-buffer";\n messages: {\n ts: string;\n userId: string;\n text: string;\n }[];\n };\n }\n /** A pre.task.create hook blocked a task before it was created. */\n export interface TaskBlockedEvent {\n /** The extension that blocked, or whose model/agent rewrite was rejected. */\n extension: {\n id: string;\n name: string;\n };\n /** The scrubbed block reason. */\n reason: string;\n origin: TaskCreateOrigin;\n source?: AgentTask["source"];\n requester: {\n userId?: string;\n agentId?: string;\n slackUserId?: string;\n };\n context?: {\n contextKey?: string;\n scheduleId?: string;\n workflowRunId?: string;\n workflowRunStepId?: string;\n parentTaskId?: string;\n vcsRepo?: string;\n vcsNumber?: number;\n slackChannelId?: string;\n slackThreadTs?: string;\n };\n /** The original task description, scrubbed and cut to 500 characters. */\n description: string;\n }\n export type TaskCreateModify = Partial<\n Pick<\n CreateTaskOptions,\n | "agentId"\n | "creatorAgentId"\n | "source"\n | "taskType"\n | "tags"\n | "priority"\n | "dependsOn"\n | "offeredTo"\n | "vcsProvider"\n | "vcsRepo"\n | "vcsEventType"\n | "vcsNumber"\n | "vcsCommentId"\n | "vcsAuthor"\n | "vcsUrl"\n | "vcsInstallationId"\n | "vcsNodeId"\n | "agentmailInboxId"\n | "agentmailMessageId"\n | "agentmailThreadId"\n | "mentionMessageId"\n | "mentionChannelId"\n | "dir"\n | "model"\n | "modelTier"\n | "effort"\n | "outputSchema"\n | "followUpConfig"\n | "bypassTrackerContextDedup"\n >\n > & {\n description?: string;\n };\n export interface TaskFollowUpEvent {\n completedTask: AgentTask;\n status: "completed" | "failed";\n output?: string;\n failureReason?: string;\n workerAgentId: string;\n leadAgentId: string;\n summary: string;\n }\n export interface TaskSteerEvent {\n task: AgentTask;\n message: string;\n mode: SteerMode;\n source: SteeringSource;\n sender: {\n kind: "user" | "agent" | "system";\n userId?: string;\n agentId?: string;\n };\n messageTimestamps?: string[];\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n channelId: string;\n threadTs: string;\n userId?: string;\n };\n }\n export interface TaskSteerModify {\n message: string;\n }\n export type TaskFollowUpModify = Partial<\n Pick<CreateTaskOptions, "agentId" | "priority" | "followUpConfig">\n > & {\n description?: string;\n };\n export interface SlackRouteEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n botMentioned: boolean;\n threadContext?: {\n channelId: string;\n threadTs: string;\n };\n }\n export interface SlackRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n };\n }\n /** A Chat SDK message after its thread buffer flushed, before routing. */\n export interface ChatRouteEvent {\n /** Adapter name, such as `telegram` or `slack`. */\n adapter: string;\n channelId: string;\n /** The Chat SDK thread id, prefixed with the adapter name. */\n threadId: string;\n /** The first buffered sender. */\n userId: string;\n userName?: string;\n /** The buffered messages, joined. */\n text: string;\n /** True for an @mention and for a reply to one of the bot\'s messages. */\n botMentioned: boolean;\n isDirectMessage: boolean;\n /** Platform chat type, such as Telegram `private`, `group`, `supergroup` or `channel`. */\n chatType?: string;\n /** Set for a Telegram supergroup with topics. */\n isForum?: boolean;\n /** A buffered message replies to one of the bot\'s own messages. */\n replyToBot: boolean;\n /** Set when earlier swarm tasks exist in this thread. */\n threadContext?: {\n adapter: string;\n threadId: string;\n };\n }\n export interface ChatRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n }\n | {\n kind: "workflow";\n workflowId: string;\n };\n }\n export type HeartbeatClassification = "no-session" | "stale-session" | "fresh-stalled";\n export type HeartbeatAction = "supersede-resume" | "fail" | "record";\n export interface HeartbeatRemediateEvent {\n task: AgentTask;\n session?: ActiveSession;\n classification: HeartbeatClassification;\n proposedAction: HeartbeatAction;\n reason: string;\n taskAgeMs: number;\n sessionHeartbeatAgeMs?: number;\n }\n export interface HeartbeatRemediateModify {\n proposedAction: HeartbeatAction;\n }\n export interface ToolCallEvent {\n tool: string;\n /** Secret-scrubbed on native calls: a secret reads as `[REDACTED:<name>]`. */\n args: unknown;\n requestInfo: RequestInfo;\n /** Native calls only: the harness\'s own tool name, such as `Bash`. */\n nativeTool?: string;\n /** Native calls only: the harness\'s own argument shape, secret-scrubbed. */\n rawArgs?: unknown;\n /** Native calls only: the harness\'s call id, and its parent for a nested call. */\n toolCallId?: string;\n parentToolCallId?: string;\n }\n export interface ToolCallModify {\n args: unknown;\n }\n export interface TaskEvent {\n task: AgentTask;\n }\n export interface TaskCompletedEvent extends TaskEvent {\n output: string;\n }\n export interface TaskFailedEvent extends TaskEvent {\n failureReason: string;\n }\n export interface TaskSupersededEvent extends TaskEvent {\n supersededBy: string;\n }\n export interface TaskProgressEvent extends TaskEvent {\n progress: string;\n }\n export interface SlackMessageEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n taskId?: string;\n }\n /** A Chat SDK message the swarm received or sent. */\n export interface ChatMessageEvent {\n adapter: string;\n channelId: string;\n threadId: string;\n /** The sender, for an inbound message. */\n userId?: string;\n text: string;\n direction: "inbound" | "outbound";\n taskId?: string;\n messageId?: string;\n }\n /**\n * A person answered an approval request. Fires for workflow and standalone\n * requests. Timeouts and cancellations do not emit it today.\n */\n export interface ApprovalResolvedEvent {\n requestId: string;\n status: "approved" | "rejected" | "timeout" | "cancelled";\n responses: Record<string, unknown> | null;\n /** Set when a workflow human-in-the-loop step asked. Absent for a standalone request. */\n workflowRunId?: string;\n workflowRunStepId?: string;\n /** The task whose agent asked, for a standalone request. */\n sourceTaskId?: string;\n }\n /** A task was refused because a daily spend budget is used up. */\n export interface TaskBudgetRefusedEvent extends TaskEvent {\n /** The agent the task was refused for. */\n agentId: string;\n /** Which budget refused it. The matching spend and budget fields are set. */\n cause: "agent" | "global" | "user";\n agentSpendUsd?: number;\n agentBudgetUsd?: number;\n globalSpendUsd?: number;\n globalBudgetUsd?: number;\n userSpendUsd?: number;\n userBudgetUsd?: number;\n /** ISO 8601 time the daily budget resets. */\n resetAt: string;\n }\n /** An inbound AgentMail message. */\n export interface EmailReceivedEvent {\n inboxId: string;\n /** The From header as sent. */\n from: string;\n subject: string;\n /** The text body, or the HTML when there is no text, cut to 500 characters with `...` appended. */\n body: string;\n threadId: string;\n messageId: string;\n }\n /** An inbound Kapso (WhatsApp) message. */\n export interface KapsoMessageEvent {\n phoneNumberId: string;\n conversationId?: string;\n messageId: string;\n from?: string;\n /** Kapso message type, such as `text` or `image`. */\n type?: string;\n /** The text, or a placeholder naming the type for a non-text message. */\n text: string;\n }\n export type VcsProvider = "github" | "gitlab" | "azure-devops" | "bitbucket";\n /**\n * The provider object the event is about, as the provider names it. GitLab\n * calls a pull request a merge request, and a comment a `note`.\n */\n export type VcsEventKind =\n | "pull_request"\n | "merge_request"\n | "issue"\n | "issue_comment"\n | "note"\n | "pull_request_review"\n | "pipeline";\n /**\n * A webhook event from a connected code host. `action` is the provider\'s own\n * value: `opened`, `closed`, `synchronize`, `merge`, `created`, `commented`, or,\n * for a pipeline, its status such as `success` or `failed`. Fields a kind does\n * not carry are absent.\n */\n export interface VcsEvent {\n provider: VcsProvider;\n kind: VcsEventKind;\n action: string;\n /** `owner/name` on GitHub and GitLab, `workspace/repo_slug` on Bitbucket, the repository URL on Azure DevOps. */\n repo: string;\n /** The PR, merge request, or issue number. Absent for a pipeline outside a merge request. */\n number?: number;\n title?: string;\n body?: string | null;\n /** Login of the user behind the event. Set for pull requests, merge requests, and Azure DevOps comments. */\n author?: string;\n url?: string;\n merged?: boolean;\n changedFiles?: number;\n /** The review verdict, on a pull request review. */\n reviewState?: string;\n }\n export interface ToolCallCompletedEvent extends ToolCallEvent {\n result: unknown;\n durationMs: number;\n /** Native calls only: the harness reported the call as failed. */\n isError?: boolean;\n }\n export interface SwarmEventMap {\n "pre.task.create": {\n event: TaskCreateEvent;\n modify: TaskCreateModify;\n result: PreResult<TaskCreateModify>;\n };\n "pre.task.followUp": {\n event: TaskFollowUpEvent;\n modify: TaskFollowUpModify;\n result: PreResult<TaskFollowUpModify>;\n };\n "pre.task.steer": {\n event: TaskSteerEvent;\n modify: TaskSteerModify;\n result: PreResult<TaskSteerModify>;\n };\n "pre.slack.route": {\n event: SlackRouteEvent;\n modify: SlackRouteModify;\n result: PreResult<SlackRouteModify>;\n };\n "pre.chat.route": {\n event: ChatRouteEvent;\n modify: ChatRouteModify;\n result: PreResult<ChatRouteModify>;\n };\n "pre.heartbeat.remediate": {\n event: HeartbeatRemediateEvent;\n modify: HeartbeatRemediateModify;\n result: PreResult<HeartbeatRemediateModify>;\n };\n "pre.tool.call": {\n event: ToolCallEvent;\n modify: ToolCallModify;\n result: PreResult<ToolCallModify>;\n };\n "post.task.created": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.blocked": {\n event: TaskBlockedEvent;\n modify: never;\n result: void;\n };\n "post.task.completed": {\n event: TaskCompletedEvent;\n modify: never;\n result: void;\n };\n "post.task.failed": {\n event: TaskFailedEvent;\n modify: never;\n result: void;\n };\n "post.task.cancelled": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.superseded": {\n event: TaskSupersededEvent;\n modify: never;\n result: void;\n };\n "post.task.progress": {\n event: TaskProgressEvent;\n modify: never;\n result: void;\n };\n "post.slack.message": {\n event: SlackMessageEvent;\n modify: never;\n result: void;\n };\n "post.chat.message": {\n event: ChatMessageEvent;\n modify: never;\n result: void;\n };\n "post.approval.resolved": {\n event: ApprovalResolvedEvent;\n modify: never;\n result: void;\n };\n "post.task.budgetRefused": {\n event: TaskBudgetRefusedEvent;\n modify: never;\n result: void;\n };\n "post.email.received": {\n event: EmailReceivedEvent;\n modify: never;\n result: void;\n };\n "post.kapso.message": {\n event: KapsoMessageEvent;\n modify: never;\n result: void;\n };\n "post.vcs.event": {\n event: VcsEvent;\n modify: never;\n result: void;\n };\n "post.tool.call": {\n event: ToolCallCompletedEvent;\n modify: never;\n result: void;\n };\n }\n export interface ExtensionApi<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > {\n on<E extends keyof SwarmEventMap>(\n event: E,\n handler: (\n event: SwarmEventMap[E]["event"],\n ctx: CtxFor<M>,\n ) => Promise<SwarmEventMap[E]["result"]> | SwarmEventMap[E]["result"],\n opts?: {\n priority?: number;\n },\n ): void;\n }\n export type SwarmExtension<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > = (api: ExtensionApi<M>) => void;\n export { block, modify } from "./contract-runtime";\n}\n';
4
+ '// biome-ignore-all lint/suspicious/noConfusingVoidType: Extension handlers may explicitly return no result.\ndeclare module "swarm-extension" {\n export type CreateTaskOptions = {\n key?: string | undefined;\n agentId?: string | null | undefined;\n creatorAgentId?: string | undefined;\n source?:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "system"\n | "linear"\n | "jira"\n | "comb"\n | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n taskType?: string | undefined;\n tags?: string[] | undefined;\n priority?: number | undefined;\n dependsOn?: string[] | undefined;\n offeredTo?: string | undefined;\n status?: "draft" | "backlog" | "unassigned" | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n overrideSlackContext?: boolean | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | undefined;\n workflowRunStepId?: string | undefined;\n sourceTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n inheritParentOutputSchema?: boolean | undefined;\n inheritParentRequester?: boolean | undefined;\n inheritParentRoutingAffinity?: boolean | undefined;\n inheritParentFollowUpConfig?: boolean | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n requestedByUserId?: string | undefined;\n contextKey?: string | undefined;\n bypassTrackerContextDedup?: boolean | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n };\n\n export type AgentTask = {\n id: string;\n key: string;\n agentId: string | null;\n task: string;\n status:\n | "skipped"\n | "draft"\n | "backlog"\n | "unassigned"\n | "offered"\n | "reviewing"\n | "pending"\n | "in_progress"\n | "paused"\n | "completed"\n | "failed"\n | "cancelled"\n | "superseded";\n source:\n | "chat"\n | "workflow"\n | "schedule"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\n | "system"\n | "linear"\n | "jira"\n | "comb";\n tags: string[];\n priority: number;\n dependsOn: string[];\n createdAt: string;\n lastUpdatedAt: string;\n slackReplySent: boolean;\n wasPaused: boolean;\n creatorAgentId?: string | undefined;\n title?: string | undefined;\n routingReason?:\n | "skill"\n | "continuity"\n | "overflow"\n | "human_pinned"\n | "reroute_fault"\n | undefined;\n routingSource?: "declared" | "engine_default" | undefined;\n routingNote?: string | undefined;\n poolWakeAt?: string | undefined;\n taskType?: string | undefined;\n offeredTo?: string | undefined;\n offeredAt?: string | undefined;\n acceptedAt?: string | undefined;\n rejectionReason?: string | undefined;\n finishedAt?: string | undefined;\n notifiedAt?: string | undefined;\n failureReason?: string | undefined;\n output?: string | undefined;\n progress?: string | undefined;\n slackChannelId?: string | undefined;\n slackThreadTs?: string | undefined;\n slackTriggerMessageTs?: string | undefined;\n slackUserId?: string | undefined;\n slackParticipants?:\n | {\n people: {\n slackUserId: string;\n trust: "external" | "unknown" | "internal";\n userId?: string | undefined;\n starter?: boolean | undefined;\n newest?: boolean | undefined;\n asked?: boolean | undefined;\n }[];\n more: number;\n }\n | undefined;\n slackProgressMessageTs?: string | undefined;\n slackTreeRootMessageTs?: string | undefined;\n vcsProvider?: "github" | "gitlab" | "azure-devops" | "bitbucket" | undefined;\n vcsRepo?: string | undefined;\n vcsEventType?: string | undefined;\n vcsNumber?: number | undefined;\n vcsCommentId?: number | undefined;\n vcsAuthor?: string | undefined;\n vcsUrl?: string | undefined;\n vcsInstallationId?: number | undefined;\n vcsNodeId?: string | undefined;\n agentmailInboxId?: string | undefined;\n agentmailMessageId?: string | undefined;\n agentmailThreadId?: string | undefined;\n mentionMessageId?: string | undefined;\n mentionChannelId?: string | undefined;\n dir?: string | undefined;\n parentTaskId?: string | undefined;\n dispatchedByTaskId?: string | undefined;\n claudeSessionId?: string | undefined;\n model?: string | undefined;\n modelTier?: "smol" | "regular" | "smart" | "ultra" | undefined;\n effort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n resolvedModel?: string | undefined;\n modelSource?: string | undefined;\n modelAlias?: string | undefined;\n resolvedEffort?: "low" | "medium" | "high" | "max" | "off" | "xhigh" | undefined;\n profile?: string | undefined;\n resolvedProfile?: string | undefined;\n fallbackHops?:\n | {\n from: string;\n profile: string;\n errorClass:\n | "rate_limit"\n | "model_window"\n | "seat"\n | "credits"\n | "overloaded"\n | "server_error"\n | "auth"\n | "pool_empty";\n at: string;\n skipped?: { profile: string; reason: string }[] | undefined;\n }[]\n | undefined;\n scheduleId?: string | undefined;\n workflowRunId?: string | null | undefined;\n workflowRunStepId?: string | null | undefined;\n contextKey?: string | undefined;\n outputSchema?: Record<string, unknown> | undefined;\n followUpConfig?:\n | {\n disabled?: boolean | undefined;\n onCompleted?: string | undefined;\n onFailed?: string | undefined;\n }\n | undefined;\n deferredAt?: string | undefined;\n compactionCount?: number | undefined;\n peakContextPercent?: number | undefined;\n peakContextTokens?: number | undefined;\n contextWindowSize?: number | undefined;\n credentialKeySuffix?: string | undefined;\n credentialKeyType?: string | undefined;\n requestedByUserId?: string | undefined;\n swarmVersion?: string | undefined;\n provider?:\n | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n providerMeta?: Record<string, unknown> | undefined;\n harnessVariant?: string | undefined;\n harnessVariantMeta?: Record<string, unknown> | undefined;\n totalCostUsd?: number | undefined;\n routingAffinity?:\n | {\n capabilities: string[];\n sourceAgentId?: string | undefined;\n role?: string | undefined;\n harnessProvider?:\n | "codex"\n | "pi"\n | "opencode"\n | "claude"\n | "claude-managed"\n | "grok"\n | "fx"\n | "dsh"\n | "cursor"\n | "amp"\n | "devin"\n | "acp"\n | undefined;\n leadOnly?: boolean | undefined;\n }\n | undefined;\n routingAffinityInvalid?: boolean | undefined;\n };\n\n export type ActiveSession = {\n id: string;\n agentId: string;\n taskId: string | null;\n triggerType: string;\n inboxMessageId: string | null;\n taskDescription: string | null;\n runnerSessionId: string | null;\n providerSessionId: string | null;\n startedAt: string;\n lastHeartbeatAt: string;\n runtimeInstanceId?: string | null | undefined;\n };\n\n export type SteerMode = "steer" | "queue";\n\n export type SteeringSource = "chat" | "script" | "slack" | "mcp" | "api" | "ui" | "app-page";\n\n export type RequestInfo = {\n sessionId: string | undefined;\n agentId: string | undefined;\n runtimeInstanceId: string | undefined;\n sourceTaskId: string | undefined;\n auditSourceTaskId: string | undefined;\n contextKey: string | undefined;\n callOrigin: "native" | "mcp" | "extension" | "script-sdk";\n harness?: string | undefined;\n };\n\n import type { SwarmSdk } from "swarm-sdk";\n import type { z } from "zod";\n export type Runtime = "api" | "worker";\n export interface ExtensionScriptAsset {\n name: string;\n file: string;\n description: string;\n intent?: string;\n }\n export interface ExtensionScheduleAsset {\n name: string;\n description?: string;\n script: string;\n cronExpression?: string;\n intervalMs?: number;\n timezone?: string;\n args?: Record<string, unknown>;\n }\n export interface ExtensionWorkflowAsset {\n file: string;\n }\n export interface ExtensionSkillAsset {\n dir: string;\n }\n export interface ExtensionManifest {\n $schema?: string;\n name: string;\n description: string;\n version: string;\n runtime: Runtime;\n assets: {\n hooks: string;\n scripts?: readonly ExtensionScriptAsset[];\n schedules?: readonly ExtensionScheduleAsset[];\n workflows?: readonly ExtensionWorkflowAsset[];\n skills?: readonly ExtensionSkillAsset[];\n };\n homepage?: string;\n author?: string;\n /** Tool-call sources this extension\'s tool handlers receive. Default `["mcp"]`. */\n toolSources?: readonly ToolSource[];\n }\n /** `mcp`: swarm MCP tools. `native`: harness built-ins reported by a worker shim. */\n export type ToolSource = "mcp" | "native";\n export interface HooksModule {\n default: SwarmExtension;\n config?: z.ZodTypeAny;\n }\n export interface ExtensionState {\n get<T = unknown>(key: string): Promise<T | null>;\n set<T>(key: string, value: T): Promise<void>;\n incr(key: string, by?: number): Promise<number>;\n del(key: string): Promise<void>;\n }\n export interface ExtensionLogger {\n debug(message: string, data?: unknown): void;\n info(message: string, data?: unknown): void;\n warn(message: string, data?: unknown): void;\n error(message: string, data?: unknown): void;\n }\n type ConfigFor<M extends ExtensionManifest> = M extends {\n config: infer C extends z.ZodTypeAny;\n }\n ? z.infer<C>\n : Record<string, unknown>;\n export interface ApiCtx<Config = Record<string, unknown>> {\n swarm: SwarmSdk;\n state: ExtensionState;\n config: Config;\n log: ExtensionLogger;\n signal: AbortSignal;\n event: {\n name: keyof SwarmEventMap;\n at: string;\n extension: {\n id: string;\n version: number;\n };\n };\n }\n export interface WorkerCtx<Config = Record<string, unknown>>\n extends Omit<ApiCtx<Config>, "swarm"> {\n swarm: SwarmSdk;\n worker: {\n agentId: string;\n taskId: string;\n harness: string;\n };\n }\n export type CtxFor<M extends ExtensionManifest> = M["runtime"] extends "api"\n ? ApiCtx<ConfigFor<M>>\n : WorkerCtx<ConfigFor<M>>;\n export type PreResult<Modify> =\n | void\n | {\n action: "continue";\n }\n | {\n action: "modify";\n data: Modify;\n }\n | {\n action: "block";\n reason: string;\n };\n export type TaskCreateOrigin =\n | "rest"\n | "app"\n | "mcp"\n | "slack"\n | "schedule"\n | "workflow"\n | "webhook"\n | "followUp"\n | `extension:${string}`;\n export interface TaskCreateEvent {\n options: CreateTaskOptions;\n description: string;\n origin: TaskCreateOrigin;\n requestInfo?: RequestInfo;\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n trigger: "mention" | "thread-buffer";\n messages: {\n ts: string;\n userId: string;\n text: string;\n }[];\n };\n }\n /** A pre.task.create hook blocked a task before it was created. */\n export interface TaskBlockedEvent {\n /** The extension that blocked, or whose model/agent rewrite was rejected. */\n extension: {\n id: string;\n name: string;\n };\n /** The scrubbed block reason. */\n reason: string;\n origin: TaskCreateOrigin;\n source?: AgentTask["source"];\n requester: {\n userId?: string;\n agentId?: string;\n slackUserId?: string;\n };\n context?: {\n contextKey?: string;\n scheduleId?: string;\n workflowRunId?: string;\n workflowRunStepId?: string;\n parentTaskId?: string;\n vcsRepo?: string;\n vcsNumber?: number;\n slackChannelId?: string;\n slackThreadTs?: string;\n };\n /** The original task description, scrubbed and cut to 500 characters. */\n description: string;\n }\n export type TaskCreateModify = Partial<\n Pick<\n CreateTaskOptions,\n | "agentId"\n | "creatorAgentId"\n | "source"\n | "taskType"\n | "tags"\n | "priority"\n | "dependsOn"\n | "offeredTo"\n | "vcsProvider"\n | "vcsRepo"\n | "vcsEventType"\n | "vcsNumber"\n | "vcsCommentId"\n | "vcsAuthor"\n | "vcsUrl"\n | "vcsInstallationId"\n | "vcsNodeId"\n | "agentmailInboxId"\n | "agentmailMessageId"\n | "agentmailThreadId"\n | "mentionMessageId"\n | "mentionChannelId"\n | "dir"\n | "model"\n | "modelTier"\n | "effort"\n | "outputSchema"\n | "followUpConfig"\n | "bypassTrackerContextDedup"\n >\n > & {\n description?: string;\n };\n export interface TaskFollowUpEvent {\n completedTask: AgentTask;\n status: "completed" | "failed";\n output?: string;\n failureReason?: string;\n workerAgentId: string;\n leadAgentId: string;\n summary: string;\n }\n export interface TaskSteerEvent {\n task: AgentTask;\n message: string;\n mode: SteerMode;\n source: SteeringSource;\n sender: {\n kind: "user" | "agent" | "system";\n userId?: string;\n agentId?: string;\n };\n messageTimestamps?: string[];\n /** Slack ingress metadata; not persisted or writable through modify. */\n slack?: {\n channelId: string;\n threadTs: string;\n userId?: string;\n };\n }\n export interface TaskSteerModify {\n message: string;\n }\n export type TaskFollowUpModify = Partial<\n Pick<CreateTaskOptions, "agentId" | "priority" | "followUpConfig">\n > & {\n description?: string;\n };\n export interface SlackRouteEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n botMentioned: boolean;\n threadContext?: {\n channelId: string;\n threadTs: string;\n };\n }\n export interface SlackRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n };\n }\n /** A Chat SDK message after its thread buffer flushed, before routing. */\n export interface ChatRouteEvent {\n /** Adapter name, such as `telegram` or `slack`. */\n adapter: string;\n channelId: string;\n /** The Chat SDK thread id, prefixed with the adapter name. */\n threadId: string;\n /** The first buffered sender. */\n userId: string;\n userName?: string;\n /** The buffered messages, joined. */\n text: string;\n /** True for an @mention and for a reply to one of the bot\'s messages. */\n botMentioned: boolean;\n isDirectMessage: boolean;\n /** Platform chat type, such as Telegram `private`, `group`, `supergroup` or `channel`. */\n chatType?: string;\n /** Set for a Telegram supergroup with topics. */\n isForum?: boolean;\n /** A buffered message replies to one of the bot\'s own messages. */\n replyToBot: boolean;\n /** Set when earlier swarm tasks exist in this thread. */\n threadContext?: {\n adapter: string;\n threadId: string;\n };\n }\n export interface ChatRouteModify {\n target:\n | {\n kind: "agent";\n agentId: string;\n }\n | {\n kind: "lead";\n }\n | {\n kind: "broadcast";\n }\n | {\n kind: "workflow";\n workflowId: string;\n };\n }\n export type HeartbeatClassification = "no-session" | "stale-session" | "fresh-stalled";\n export type HeartbeatAction = "supersede-resume" | "fail" | "record";\n export interface HeartbeatRemediateEvent {\n task: AgentTask;\n session?: ActiveSession;\n classification: HeartbeatClassification;\n proposedAction: HeartbeatAction;\n reason: string;\n taskAgeMs: number;\n sessionHeartbeatAgeMs?: number;\n }\n export interface HeartbeatRemediateModify {\n proposedAction: HeartbeatAction;\n }\n export interface ToolCallEvent {\n tool: string;\n /** Secret-scrubbed on native calls: a secret reads as `[REDACTED:<name>]`. */\n args: unknown;\n requestInfo: RequestInfo;\n /** Native calls only: the harness\'s own tool name, such as `Bash`. */\n nativeTool?: string;\n /** Native calls only: the harness\'s own argument shape, secret-scrubbed. */\n rawArgs?: unknown;\n /** Native calls only: the harness\'s call id, and its parent for a nested call. */\n toolCallId?: string;\n parentToolCallId?: string;\n }\n export interface ToolCallModify {\n args: unknown;\n }\n export interface TaskEvent {\n task: AgentTask;\n }\n export interface TaskCompletedEvent extends TaskEvent {\n output: string;\n }\n export interface TaskFailedEvent extends TaskEvent {\n failureReason: string;\n }\n export interface TaskSupersededEvent extends TaskEvent {\n supersededBy: string;\n }\n export interface TaskProgressEvent extends TaskEvent {\n progress: string;\n }\n export interface SlackMessageEvent {\n channelId: string;\n userId: string;\n text: string;\n threadTs?: string;\n taskId?: string;\n }\n /** A Chat SDK message the swarm received or sent. */\n export interface ChatMessageEvent {\n adapter: string;\n channelId: string;\n threadId: string;\n /** The sender, for an inbound message. */\n userId?: string;\n text: string;\n direction: "inbound" | "outbound";\n taskId?: string;\n messageId?: string;\n }\n /**\n * A person answered an approval request. Fires for workflow and standalone\n * requests. Timeouts and cancellations do not emit it today.\n */\n export interface ApprovalResolvedEvent {\n requestId: string;\n status: "approved" | "rejected" | "timeout" | "cancelled";\n responses: Record<string, unknown> | null;\n /** Set when a workflow human-in-the-loop step asked. Absent for a standalone request. */\n workflowRunId?: string;\n workflowRunStepId?: string;\n /** The task whose agent asked, for a standalone request. */\n sourceTaskId?: string;\n }\n /** A task was refused because a daily spend budget is used up. */\n export interface TaskBudgetRefusedEvent extends TaskEvent {\n /** The agent the task was refused for. */\n agentId: string;\n /** Which budget refused it. The matching spend and budget fields are set. */\n cause: "agent" | "global" | "user";\n agentSpendUsd?: number;\n agentBudgetUsd?: number;\n globalSpendUsd?: number;\n globalBudgetUsd?: number;\n userSpendUsd?: number;\n userBudgetUsd?: number;\n /** ISO 8601 time the daily budget resets. */\n resetAt: string;\n }\n /** An inbound AgentMail message. */\n export interface EmailReceivedEvent {\n inboxId: string;\n /** The From header as sent. */\n from: string;\n subject: string;\n /** The text body, or the HTML when there is no text, cut to 500 characters with `...` appended. */\n body: string;\n threadId: string;\n messageId: string;\n }\n /** An inbound Kapso (WhatsApp) message. */\n export interface KapsoMessageEvent {\n phoneNumberId: string;\n conversationId?: string;\n messageId: string;\n from?: string;\n /** Kapso message type, such as `text` or `image`. */\n type?: string;\n /** The text, or a placeholder naming the type for a non-text message. */\n text: string;\n }\n export type VcsProvider = "github" | "gitlab" | "azure-devops" | "bitbucket";\n /**\n * The provider object the event is about, as the provider names it. GitLab\n * calls a pull request a merge request, and a comment a `note`.\n */\n export type VcsEventKind =\n | "pull_request"\n | "merge_request"\n | "issue"\n | "issue_comment"\n | "note"\n | "pull_request_review"\n | "pipeline";\n /**\n * A webhook event from a connected code host. `action` is the provider\'s own\n * value: `opened`, `closed`, `synchronize`, `merge`, `created`, `commented`, or,\n * for a pipeline, its status such as `success` or `failed`. Fields a kind does\n * not carry are absent.\n */\n export interface VcsEvent {\n provider: VcsProvider;\n kind: VcsEventKind;\n action: string;\n /** `owner/name` on GitHub and GitLab, `workspace/repo_slug` on Bitbucket, the repository URL on Azure DevOps. */\n repo: string;\n /** The PR, merge request, or issue number. Absent for a pipeline outside a merge request. */\n number?: number;\n title?: string;\n body?: string | null;\n /** Login of the user behind the event. Set for pull requests, merge requests, and Azure DevOps comments. */\n author?: string;\n url?: string;\n merged?: boolean;\n changedFiles?: number;\n /** The review verdict, on a pull request review. */\n reviewState?: string;\n }\n export interface ToolCallCompletedEvent extends ToolCallEvent {\n result: unknown;\n durationMs: number;\n /** Native calls only: the harness reported the call as failed. */\n isError?: boolean;\n }\n export interface SwarmEventMap {\n "pre.task.create": {\n event: TaskCreateEvent;\n modify: TaskCreateModify;\n result: PreResult<TaskCreateModify>;\n };\n "pre.task.followUp": {\n event: TaskFollowUpEvent;\n modify: TaskFollowUpModify;\n result: PreResult<TaskFollowUpModify>;\n };\n "pre.task.steer": {\n event: TaskSteerEvent;\n modify: TaskSteerModify;\n result: PreResult<TaskSteerModify>;\n };\n "pre.slack.route": {\n event: SlackRouteEvent;\n modify: SlackRouteModify;\n result: PreResult<SlackRouteModify>;\n };\n "pre.chat.route": {\n event: ChatRouteEvent;\n modify: ChatRouteModify;\n result: PreResult<ChatRouteModify>;\n };\n "pre.heartbeat.remediate": {\n event: HeartbeatRemediateEvent;\n modify: HeartbeatRemediateModify;\n result: PreResult<HeartbeatRemediateModify>;\n };\n "pre.tool.call": {\n event: ToolCallEvent;\n modify: ToolCallModify;\n result: PreResult<ToolCallModify>;\n };\n "post.task.created": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.blocked": {\n event: TaskBlockedEvent;\n modify: never;\n result: void;\n };\n "post.task.completed": {\n event: TaskCompletedEvent;\n modify: never;\n result: void;\n };\n "post.task.failed": {\n event: TaskFailedEvent;\n modify: never;\n result: void;\n };\n "post.task.cancelled": {\n event: TaskEvent;\n modify: never;\n result: void;\n };\n "post.task.superseded": {\n event: TaskSupersededEvent;\n modify: never;\n result: void;\n };\n "post.task.progress": {\n event: TaskProgressEvent;\n modify: never;\n result: void;\n };\n "post.slack.message": {\n event: SlackMessageEvent;\n modify: never;\n result: void;\n };\n "post.chat.message": {\n event: ChatMessageEvent;\n modify: never;\n result: void;\n };\n "post.approval.resolved": {\n event: ApprovalResolvedEvent;\n modify: never;\n result: void;\n };\n "post.task.budgetRefused": {\n event: TaskBudgetRefusedEvent;\n modify: never;\n result: void;\n };\n "post.email.received": {\n event: EmailReceivedEvent;\n modify: never;\n result: void;\n };\n "post.kapso.message": {\n event: KapsoMessageEvent;\n modify: never;\n result: void;\n };\n "post.vcs.event": {\n event: VcsEvent;\n modify: never;\n result: void;\n };\n "post.tool.call": {\n event: ToolCallCompletedEvent;\n modify: never;\n result: void;\n };\n }\n export interface ExtensionApi<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > {\n on<E extends keyof SwarmEventMap>(\n event: E,\n handler: (\n event: SwarmEventMap[E]["event"],\n ctx: CtxFor<M>,\n ) => Promise<SwarmEventMap[E]["result"]> | SwarmEventMap[E]["result"],\n opts?: {\n priority?: number;\n },\n ): void;\n }\n export type SwarmExtension<\n M extends ExtensionManifest = ExtensionManifest & {\n runtime: "api";\n },\n > = (api: ExtensionApi<M>) => void;\n export { block, modify } from "./contract-runtime";\n}\n';
@@ -385,6 +385,15 @@ export function unregister(extensionId: string): LoadedExtension | undefined {
385
385
  return loaded;
386
386
  }
387
387
 
388
+ /** True when an enabled extension takes native tool calls: workers skip the hook round trip otherwise. */
389
+ export function hasNativeToolHandlers(): boolean {
390
+ return [...registry.values()].some(
391
+ (loaded) =>
392
+ (loaded.manifest.toolSources ?? ["mcp"]).includes("native") &&
393
+ loaded.handlers.some((h) => h.event === "pre.tool.call" || h.event === "post.tool.call"),
394
+ );
395
+ }
396
+
388
397
  export function listRegistered(): LoadedExtension[] {
389
398
  return [...registry.values()];
390
399
  }
@@ -129,7 +129,10 @@ export class AgentFsProvider implements FileStorageProvider {
129
129
  async upload(scope: FileScope, body: FileBody, options: UploadOptions = {}): Promise<FileObject> {
130
130
  const headers = new Headers(this.authHeaders());
131
131
  if (options.contentType) {
132
- headers.set("content-type", options.contentType);
132
+ // agent-fs answers a JSON content type on PUT /raw with 415 and stores the type it detects
133
+ // from the path, so JSON goes out as octet-stream; the returned FileObject keeps the caller's type.
134
+ const isJson = options.contentType.trim().toLowerCase().startsWith("application/json");
135
+ headers.set("content-type", isJson ? "application/octet-stream" : options.contentType);
133
136
  }
134
137
  if (options.ifNoneMatch) {
135
138
  headers.set("if-none-match", options.ifNoneMatch);
@@ -1,5 +1,6 @@
1
1
  import { failTask, findTaskByVcs, getAllAgents, getSwarmConfigs, incrKv, upsertKv } from "../be/db";
2
2
  import { renderIdentity, resolveIdentity } from "../be/identity";
3
+ import { isUnmappedIdentityDismissed } from "../be/unmapped-identities";
3
4
  import { findUserByExternalId } from "../be/users";
4
5
  import { resolveTemplate } from "../prompts/resolver";
5
6
  import { githubContextKey } from "../tasks/context-key";
@@ -182,7 +183,8 @@ async function resolveGitHubSender(
182
183
  const existing = await findUserByExternalId("github", login);
183
184
  if (existing) return existing.id;
184
185
 
185
- // No mapping → unmapped tracker.
186
+ // No mapping → unmapped tracker, unless an operator dismissed this login.
187
+ if (await isUnmappedIdentityDismissed("github", login)) return undefined;
186
188
  await upsertKv({
187
189
  namespace: UNMAPPED_NAMESPACE,
188
190
  key: `${login}:meta`,
@@ -0,0 +1,34 @@
1
+ import { githubApiUrl } from "../utils/github-host";
2
+ import { getWorkerInstallationToken } from "./app";
3
+
4
+ export type PullRequestState = { merged: boolean; state: "open" | "closed" };
5
+
6
+ /**
7
+ * Read one PR from GitHub. A webhook only names a candidate; callers that wake
8
+ * an agent confirm here first. Sends the App installation token when one is
9
+ * configured, otherwise reads unauthenticated (enough for a public repo).
10
+ * Throws on any non-2xx so a failed read never counts as an answer.
11
+ */
12
+ export async function fetchPullRequestState(
13
+ repo: string,
14
+ number: number,
15
+ ): Promise<PullRequestState> {
16
+ const auth = await getWorkerInstallationToken();
17
+ const response = await fetch(githubApiUrl(`/repos/${repo}/pulls/${number}`), {
18
+ headers: {
19
+ Accept: "application/vnd.github+json",
20
+ "X-GitHub-Api-Version": "2022-11-28",
21
+ ...(auth.status === "ok" ? { Authorization: `Bearer ${auth.token}` } : {}),
22
+ },
23
+ signal: AbortSignal.timeout(10_000),
24
+ });
25
+ if (!response.ok) throw new Error(`GitHub returned ${response.status} for ${repo}#${number}`);
26
+ const pr = (await response.json()) as {
27
+ merged?: boolean;
28
+ state?: string;
29
+ };
30
+ return {
31
+ merged: pr.merged === true,
32
+ state: pr.state === "open" ? "open" : "closed",
33
+ };
34
+ }
@@ -17,6 +17,7 @@ import {
17
17
  upsertKv,
18
18
  } from "../be/db";
19
19
  import { renderIdentity, resolveIdentity } from "../be/identity";
20
+ import { isUnmappedIdentityDismissed } from "../be/unmapped-identities";
20
21
  import { findOrCreateUserByEmail, findUserByExternalId, linkIdentity } from "../be/users";
21
22
  import { resolveTemplate } from "../prompts/resolver";
22
23
  import { gitlabContextKey } from "../tasks/context-key";
@@ -95,15 +96,18 @@ async function findLeadAgent() {
95
96
  const UNMAPPED_NAMESPACE = "integration:unmapped:gitlab";
96
97
  const UNMAPPED_TTL_MS = 30 * 24 * 60 * 60 * 1000; // 30 days
97
98
  const GITLAB_WEBHOOK_ACTOR = { kind: "system", id: "webhook:gitlab" } as const;
99
+ const EMAIL_ADDRESS_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
98
100
 
99
101
  /**
100
102
  * Resolve a GitLab webhook sender to a `users.id`.
101
103
  *
102
104
  * Cascade (Q17):
103
105
  * 1. Fast path — `findUserByExternalId('gitlab', user.username)`.
104
- * 2. If missing AND `user.email` is a real non-empty string (some GitLab
105
- * installations send `email: ""` instead of omitting the field — Q17.E
106
- * manual spot-check), run `findOrCreateUserByEmail` + `linkIdentity`.
106
+ * 2. If missing AND `user.email` is an email address, run
107
+ * `findOrCreateUserByEmail` + `linkIdentity`. GitLab sends other values
108
+ * for senders without a public email (`""` on some installations — Q17.E
109
+ * manual spot-check — or a redaction marker such as `[REDACTED]`). Many
110
+ * senders share such a value, so it never identifies one person.
107
111
  * 3. Otherwise record an unmapped tracker entry (kv) for operator triage.
108
112
  *
109
113
  * Returns `undefined` when no mapping could be established — callers pass
@@ -117,10 +121,10 @@ async function resolveGitLabSender(
117
121
  const existing = await findUserByExternalId("gitlab", user.username);
118
122
  if (existing) return existing.id;
119
123
 
120
- // Inline-email cascade — only run when email is a real non-empty string.
121
- // Some GitLab installations emit `email: ""` instead of omitting the field.
124
+ // Inline-email cascade — only run when email is an address. Empty strings and
125
+ // redaction markers fall through to the unmapped tracker.
122
126
  const inlineEmail = typeof user.email === "string" ? user.email.trim() : "";
123
- if (inlineEmail !== "") {
127
+ if (EMAIL_ADDRESS_RE.test(inlineEmail)) {
124
128
  const { user: linked } = await findOrCreateUserByEmail(
125
129
  inlineEmail,
126
130
  { name: user.name },
@@ -130,7 +134,8 @@ async function resolveGitLabSender(
130
134
  return linked.id;
131
135
  }
132
136
 
133
- // No mapping + no inline email → unmapped tracker.
137
+ // No mapping + no inline email → unmapped tracker, unless an operator dismissed it.
138
+ if (await isUnmappedIdentityDismissed("gitlab", user.username)) return undefined;
134
139
  await upsertKv({
135
140
  namespace: UNMAPPED_NAMESPACE,
136
141
  key: `${user.username}:meta`,
@@ -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