@desplega.ai/agent-swarm 2.13.4 → 2.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (526) hide show
  1. package/dist/acp-adapter-99n6z9ky.js +17 -0
  2. package/dist/{acp-targets-zrk9k0n7.js → acp-targets-23exz4z4.js} +10 -10
  3. package/dist/{actions-acqqj9jn.js → actions-zcr25x27.js} +61 -40
  4. package/dist/{agent-fs-provision-zmaykqnd.js → agent-fs-provision-7fa9e12e.js} +4 -4
  5. package/dist/{amp-adapter-a7ts8tmw.js → amp-adapter-s7ytmv6b.js} +3 -3
  6. package/dist/{anthropic-messages-88b7s3n9.js → anthropic-messages-vdd1zmha.js} +10 -10
  7. package/dist/{app-tmwa442h.js → app-5d3sz1hy.js} +7 -7
  8. package/dist/{approval-notifications-6psaaaye.js → approval-notifications-7qgkzkzx.js} +8 -8
  9. package/dist/{assistant-564v6emv.js → assistant-p2yvhc3j.js} +37 -32
  10. package/dist/{boot-args-schema-n099e0f2.js → boot-args-schema-ry6cb0p7.js} +1 -1
  11. package/dist/{boot-reembed-epvg4fp9.js → boot-reembed-2hkm3vz2.js} +1 -1
  12. package/dist/{boot-reembed-chx66qfk.js → boot-reembed-c9643ms3.js} +1 -1
  13. package/dist/{boot-scrub-sweep-dhkfp0a7.js → boot-scrub-sweep-3ycxr51t.js} +2 -2
  14. package/dist/{boot-seeds-m74fc07r.js → boot-seeds-2hzvvzg0.js} +4 -4
  15. package/dist/{boxd-451q55ys.js → boxd-9py3x0jb.js} +2 -2
  16. package/dist/{claude-adapter-hw63yj3j.js → claude-adapter-dnkww93e.js} +9 -9
  17. package/dist/{claude-managed-adapter-z5s7fx6p.js → claude-managed-adapter-yk0cr5x6.js} +4 -4
  18. package/dist/{claude-managed-setup-wee1762m.js → claude-managed-setup-4byxpp47.js} +5 -5
  19. package/dist/{claude-sdk-session-cktyqkpk.js → claude-sdk-session-4wf3dbvs.js} +13163 -12195
  20. package/dist/{cli-5rxsb3wq.js → cli-096aftq6.js} +12 -7
  21. package/dist/{cli-5rgm8p39.js → cli-0e914dp9.js} +3 -3
  22. package/dist/{cli-bzcwwebm.js → cli-0h6m6z5g.js} +1 -1
  23. package/dist/{cli-cah298e5.js → cli-0k7ppk9k.js} +231 -124
  24. package/dist/{cli-ja450998.js → cli-1nfabrt4.js} +8 -8
  25. package/dist/{cli-jzerrzgc.js → cli-2414h5r9.js} +8 -8
  26. package/dist/{cli-b768ek79.js → cli-24wervhz.js} +38 -0
  27. package/dist/{cli-93n305hm.js → cli-2ayk9gn8.js} +2 -2
  28. package/dist/{cli-kr0jpw9c.js → cli-2ckwgs7q.js} +1 -1
  29. package/dist/{cli-d5pc8ep0.js → cli-2savn6mm.js} +11 -100
  30. package/dist/{cli-jbrc98qb.js → cli-2zjxake1.js} +4 -4
  31. package/dist/{cli-4q2c8rxw.js → cli-37p61fcg.js} +15 -9
  32. package/dist/{cli-2vp0z049.js → cli-39t9d248.js} +1 -1
  33. package/dist/{cli-sa02jsqt.js → cli-3mhdmcd4.js} +1 -1
  34. package/dist/{cli-x2cem5vy.js → cli-3wsabyt0.js} +2 -2
  35. package/dist/{cli-dqgnbnxs.js → cli-466jjrwe.js} +16 -2
  36. package/dist/{cli-zhwjdhjr.js → cli-6ajyhxh7.js} +2 -2
  37. package/dist/{cli-3bxrrh53.js → cli-6yy4fepf.js} +4 -4
  38. package/dist/{cli-hhtbandk.js → cli-73rmgm45.js} +2 -2
  39. package/dist/{cli-8b4rpnwj.js → cli-7ca8hczj.js} +1 -1
  40. package/dist/{cli-0h8skzss.js → cli-7g5qj2ca.js} +4 -3
  41. package/dist/{cli-m1sns1da.js → cli-7w1fs01q.js} +2 -2
  42. package/dist/{cli-xwsm6xkr.js → cli-84wxwt3z.js} +1 -1
  43. package/dist/{cli-qzz6tz8s.js → cli-84xn7bgz.js} +1 -1
  44. package/dist/{cli-49aq3cyn.js → cli-879txsac.js} +5 -5
  45. package/dist/{cli-bv4vvnmg.js → cli-8vbxjzk0.js} +3 -3
  46. package/dist/{cli-7by7vp6m.js → cli-91amj3md.js} +3 -3
  47. package/dist/{cli-60dwk8tx.js → cli-930zbczq.js} +3 -3
  48. package/dist/{cli-7g3fg4gf.js → cli-9fwznq4p.js} +10 -10
  49. package/dist/{cli-4pbwg7sn.js → cli-9j1t3kf6.js} +2 -2
  50. package/dist/{cli-tzw1jr2t.js → cli-9j47sgzy.js} +2 -2
  51. package/dist/{cli-0fgvnb0x.js → cli-ad00h1st.js} +7 -7
  52. package/dist/{cli-kj84fqxz.js → cli-adzmmcvf.js} +19 -7
  53. package/dist/{cli-3tzmh38q.js → cli-ayxxkk3p.js} +68 -25
  54. package/dist/{cli-4vynxtrb.js → cli-bqfx72e6.js} +10 -3
  55. package/dist/{cli-8cas2xvp.js → cli-cbg0j1yt.js} +2716 -2643
  56. package/dist/{cli-fw67mnyc.js → cli-cg1q8ymp.js} +1 -1
  57. package/dist/{cli-he5nxaa8.js → cli-dw9rtjm3.js} +1 -1
  58. package/dist/{cli-jg5txpm6.js → cli-dy754erz.js} +83 -1
  59. package/dist/{cli-tsc3pdfd.js → cli-edxfzgah.js} +4 -4
  60. package/dist/{cli-hyqksecw.js → cli-ejnhs815.js} +15 -15
  61. package/dist/{cli-k0nebh10.js → cli-enavhq6r.js} +1 -1
  62. package/dist/{cli-ea7nz50q.js → cli-f2rwt43y.js} +14 -14
  63. package/dist/{cli-zjdhrzm0.js → cli-f9g96z28.js} +8 -8
  64. package/dist/{cli-rmgvwcmy.js → cli-fww016hh.js} +534 -70
  65. package/dist/{cli-rv3y60bt.js → cli-g6a696c0.js} +4 -4
  66. package/dist/{cli-z1vam71h.js → cli-gc6b94tj.js} +2 -2
  67. package/dist/{cli-p436yrzp.js → cli-gcyws2bp.js} +2 -2
  68. package/dist/{cli-srktrbby.js → cli-hzhv7yac.js} +1 -1
  69. package/dist/{cli-0p76my9q.js → cli-jcnc5ret.js} +44 -32
  70. package/dist/{cli-tr19nyn9.js → cli-jgq9xptq.js} +7 -7
  71. package/dist/{cli-pz1dp12c.js → cli-jwnac23b.js} +1 -1
  72. package/dist/{cli-904wk98s.js → cli-kc7vd07m.js} +917 -350
  73. package/dist/{cli-t0jmkcah.js → cli-kg63yp1r.js} +14 -14
  74. package/dist/{cli-ts5yv7dn.js → cli-krk8y8c7.js} +835 -157
  75. package/dist/{cli-jyhbvdga.js → cli-m0ea8ggd.js} +8 -10
  76. package/dist/{cli-944w9wb4.js → cli-md4tn21h.js} +20 -15
  77. package/dist/{cli-zexwhj3f.js → cli-mv8ft7b0.js} +10 -9
  78. package/dist/{cli-phdzn699.js → cli-mw1tmn3x.js} +217 -27
  79. package/dist/{cli-5ashycw3.js → cli-njvpngc6.js} +3 -3
  80. package/dist/{cli-9ah37a8a.js → cli-phe2vcw5.js} +10 -7
  81. package/dist/{cli-eds5xnsz.js → cli-phmy14hb.js} +2 -2
  82. package/dist/{cli-n1kjs58m.js → cli-pq0kv31y.js} +5 -5
  83. package/dist/{cli-pz1nq5xm.js → cli-q457ga28.js} +6 -6
  84. package/dist/{cli-s33bzmk0.js → cli-q5n3deaf.js} +1 -1
  85. package/dist/{cli-4fpa0zns.js → cli-qkbevqer.js} +3 -3
  86. package/dist/{cli-29h5239w.js → cli-qrwjk4xy.js} +5 -5
  87. package/dist/{cli-kezzteka.js → cli-r04ve9xw.js} +1 -1
  88. package/dist/{cli-3xqad83h.js → cli-r495stwd.js} +2 -2
  89. package/dist/{cli-1kvcsd2f.js → cli-r9d2tya0.js} +71 -3
  90. package/dist/{cli-ybte1fqc.js → cli-rp1n2xpd.js} +1 -1
  91. package/dist/{cli-fkpnx3vf.js → cli-rs1rzwp4.js} +3 -2
  92. package/dist/{cli-h9d3sdnc.js → cli-rzbsh6bw.js} +1 -1
  93. package/dist/{cli-94gx6ze9.js → cli-s4pccby1.js} +1 -1
  94. package/dist/{cli-cq4am6vg.js → cli-shyhb4t5.js} +10 -10
  95. package/dist/{cli-gtj12v95.js → cli-srq69pn1.js} +1 -1
  96. package/dist/{cli-azj9t1f9.js → cli-tc165vrb.js} +48 -5
  97. package/dist/{cli-gse7bp3z.js → cli-v4z5v3jd.js} +300 -81
  98. package/dist/{cli-p3knvk62.js → cli-vxmmttmt.js} +132 -53
  99. package/dist/{cli-404am6f3.js → cli-w4bvtxet.js} +7 -7
  100. package/dist/{cli-gkv0r2hq.js → cli-wd7b5hgc.js} +71 -9
  101. package/dist/{cli-akm6y2a8.js → cli-wvbaq052.js} +1 -1
  102. package/dist/{cli-ywy8yz6t.js → cli-wvgg7r4j.js} +2 -2
  103. package/dist/{cli-ka48vpev.js → cli-wym6rxgt.js} +165 -6
  104. package/dist/{cli-nc4pbwmp.js → cli-yd7e590v.js} +12 -12
  105. package/dist/{cli-3zrwrnz7.js → cli-yjb3cddd.js} +1 -1
  106. package/dist/{cli-7gbff32z.js → cli-z8t4485r.js} +2 -2
  107. package/dist/{cli-hdhpdrka.js → cli-ze1ndjs4.js} +4 -6
  108. package/dist/{cli-50wa8k4h.js → cli-zy9bb22b.js} +1 -2
  109. package/dist/cli.js +28 -28
  110. package/dist/{codex-adapter-2fs2c0n6.js → codex-adapter-eq61radw.js} +8 -8
  111. package/dist/{codex-hook-jxjv6dy5.js → codex-hook-8nmepvz6.js} +3 -3
  112. package/dist/{codex-login-ktfg1cxk.js → codex-login-vbd9707w.js} +1 -1
  113. package/dist/{codex-session-runner-r55tmx4c.js → codex-session-runner-rfx355h4.js} +9 -9
  114. package/dist/{commands-0mxdy9x8.js → commands-d1z0sx62.js} +3 -3
  115. package/dist/{controller-g3vkfhr4.js → controller-9hz6d8x3.js} +4 -4
  116. package/dist/{controllers-connect-4wdmncqt.js → controllers-connect-tz07d2xr.js} +24 -25
  117. package/dist/core-dynsv289.js +41 -0
  118. package/dist/{cursor-adapter-t9qb96q2.js → cursor-adapter-ef22ze3j.js} +2 -2
  119. package/dist/{db-487vvyv9.js → db-gd81d68c.js} +3 -3
  120. package/dist/{db-76p7w3gr.js → db-vrckks6q.js} +4 -2
  121. package/dist/{devin-adapter-3bp6rape.js → devin-adapter-kdt6a2bh.js} +1 -1
  122. package/dist/{dispatcher-64rp6w67.js → dispatcher-76as8w2t.js} +21 -22
  123. package/dist/{docker-a59g3ebm.js → docker-51ta7jsh.js} +2 -2
  124. package/dist/dsh-adapter-ypfvcdyz.js +11 -0
  125. package/dist/{e2b-dc8f6ctq.js → e2b-05kn3kpq.js} +16 -5
  126. package/dist/{e2b-3ykbe805.js → e2b-dm9r8hpy.js} +3 -3
  127. package/dist/{easter-egg-3d-jrrwyf55.js → easter-egg-3d-sg21j15g.js} +1 -1
  128. package/dist/{embedding-space-001hhhpk.js → embedding-space-zsdw37bb.js} +13 -23
  129. package/dist/{embeddings-esj19cnw.js → embeddings-p4e3e1m6.js} +1 -1
  130. package/dist/{event-bus-7gbsr0g4.js → event-bus-tvf2grf4.js} +1 -1
  131. package/dist/{execute-301hkxqg.js → execute-nztd0af0.js} +1 -1
  132. package/dist/{external-channel-w10e2j05.js → external-channel-717yzn4d.js} +2 -2
  133. package/dist/fx-adapter-9k0hptnz.js +20 -0
  134. package/dist/grok-adapter-skdj2pce.js +20 -0
  135. package/dist/handlers-5btjqkz6.js +39 -0
  136. package/dist/{heartbeat-tbrj7vhq.js → heartbeat-vfb1gy84.js} +24 -25
  137. package/dist/{hook-tx917rqw.js → hook-ctz0xmp3.js} +11 -11
  138. package/dist/{hook-3am1sq68.js → hook-eh52p7yd.js} +6 -6
  139. package/dist/{http-3rmemtqy.js → http-zregegrx.js} +902 -198
  140. package/dist/{index-s7xtvc0f.js → index-5kx15d19.js} +1 -1
  141. package/dist/index-7w8p6em0.js +41 -0
  142. package/dist/index-evay0xyk.js +17 -0
  143. package/dist/{index-2jw11t8s.js → index-fdym6ryb.js} +25 -26
  144. package/dist/{index-3j803vnb.js → index-mtnbhe12.js} +20533 -19786
  145. package/dist/index-vz4semsx.js +38 -0
  146. package/dist/{index-gfnq66t1.js → index-x9qf8dg7.js} +294 -29
  147. package/dist/index-y3s0xp2v.js +43 -0
  148. package/dist/{k8s-36gfn847.js → k8s-ejkk0aw7.js} +2 -2
  149. package/dist/{keepalive-9px3t7qj.js → keepalive-zdqay870.js} +4 -5
  150. package/dist/lead-6cscw8a5.js +82 -0
  151. package/dist/{maintenance-vwqjwst6.js → maintenance-t5ndg11m.js} +1 -1
  152. package/dist/{node-2wfcey7d.js → node-0as4n1ef.js} +3 -3
  153. package/dist/{node-zd6shky9.js → node-dhxbt01p.js} +3 -3
  154. package/dist/{node-z67yjre7.js → node-jkdd5w7m.js} +290 -70
  155. package/dist/{node-hjn5n1yp.js → node-t0ct2zpw.js} +3 -5
  156. package/dist/{oauth-refresh-sweep-yqry3wn4.js → oauth-refresh-sweep-y9zyd7t6.js} +3 -4
  157. package/dist/{object-webhooks-8s1wtths.js → object-webhooks-mkca91s0.js} +7 -7
  158. package/dist/{onboard-hb8czx0p.js → onboard-ss995244.js} +11 -9
  159. package/dist/{opencode-adapter-djd6m6dk.js → opencode-adapter-mwpz0278.js} +8 -8
  160. package/dist/{otel-impl-2ymwyczz.js → otel-impl-6n6vva3x.js} +2 -2
  161. package/dist/{pending-nxavtvx7.js → pending-2sxh1t6j.js} +22 -23
  162. package/dist/{pi-mono-adapter-d2cpmcy4.js → pi-mono-adapter-sfb7zy43.js} +13 -13
  163. package/dist/{pricing-refresh-1yz8jkqv.js → pricing-refresh-h79bg4cf.js} +2 -2
  164. package/dist/{rbac-roles-7s6m31xw.js → rbac-roles-ckq0czp4.js} +2 -2
  165. package/dist/{rbac-roles-dbpx0x9v.js → rbac-roles-jg2e260w.js} +3 -3
  166. package/dist/{render-v2-7y20rjrn.js → render-v2-ymbshmn0.js} +7 -7
  167. package/dist/{resume-wz546x47.js → resume-jdhnt4jk.js} +10 -10
  168. package/dist/{runtime-cb5bd9tz.js → runtime-y28jhhnf.js} +1 -1
  169. package/dist/{session-access-4vcft8kq.js → session-access-k4ta5hvp.js} +5 -5
  170. package/dist/{session-source-backfill-57b50tpw.js → session-source-backfill-528j4s8j.js} +3 -3
  171. package/dist/{setup-e1tevjyj.js → setup-d6pj82fr.js} +15 -6
  172. package/dist/thread-buffer-9w6x5zec.js +40 -0
  173. package/dist/{tree-visibility-07wf1nct.js → tree-visibility-kjxv3nxk.js} +2 -2
  174. package/dist/{user-merge-jobs-n20qpv6s.js → user-merge-jobs-rabbncf6.js} +3 -3
  175. package/dist/{virtual-modules-6fxmn1yv.js → virtual-modules-22k51txd.js} +3 -3
  176. package/dist/{work-objects-eg7y48pe.js → work-objects-xtjbar3r.js} +26 -30
  177. package/dist/{worker-follow-up-jnvnnf2b.js → worker-follow-up-fg48vk6d.js} +21 -22
  178. package/dist/worker-g4aj93dt.js +82 -0
  179. package/dist/{x-d27jj7z7.js → x-vfsqypht.js} +2 -2
  180. package/openapi.json +633 -25
  181. package/package.json +10 -10
  182. package/src/apps/definition.ts +76 -24
  183. package/src/apps/row-store.ts +67 -0
  184. package/src/apps/script-types.ts +131 -21
  185. package/src/apps/store.ts +4 -1
  186. package/src/apps/sync.ts +20 -5
  187. package/src/azure-devops/boards-sync.ts +1 -1
  188. package/src/be/db/script-runs.ts +33 -0
  189. package/src/be/db/slack-card-groups.ts +147 -0
  190. package/src/be/db/slack-trees.ts +38 -1
  191. package/src/be/db/task-idempotency.ts +63 -0
  192. package/src/be/db/tasks/read.ts +27 -1
  193. package/src/be/db/tasks/write.ts +51 -14
  194. package/src/be/db/users/avatar.ts +12 -0
  195. package/src/be/db/workflow-idempotency.ts +6 -1
  196. package/src/be/db/workflows/read.ts +79 -0
  197. package/src/be/db.ts +129 -152
  198. package/src/be/improvements.ts +24 -2
  199. package/src/be/mcp-proxy.ts +45 -11
  200. package/src/be/memory/embedding-space.ts +10 -20
  201. package/src/be/memory/index.ts +35 -0
  202. package/src/be/memory/providers/openai-embedding.ts +10 -0
  203. package/src/be/migrations/344_user_avatar.sql +4 -0
  204. package/src/be/migrations/345_task_status_kind.sql +6 -0
  205. package/src/be/migrations/348_task_deferred_until.sql +4 -0
  206. package/src/be/migrations/354_durable_objects.sql +9 -0
  207. package/src/be/migrations/356_slack_outcome_card_groups.sql +14 -0
  208. package/src/be/migrations/357_task_idempotency_keys.sql +27 -0
  209. package/src/be/migrations/362_favorites_app.sql +36 -0
  210. package/src/be/primitives/object-embed.ts +2 -2
  211. package/src/be/primitives/objects.ts +2 -2
  212. package/src/be/repo-checked-update.ts +58 -5
  213. package/src/be/requester-timezone.ts +10 -0
  214. package/src/be/runtime-pools/supervisor.ts +1 -0
  215. package/src/be/script-connections.ts +5 -1
  216. package/src/be/script-credential-broker.ts +29 -2
  217. package/src/be/scripts/durable.ts +204 -0
  218. package/src/be/scripts/extract-schema.ts +29 -4
  219. package/src/be/scripts/run-credential.ts +1 -8
  220. package/src/be/scripts/typecheck.ts +33 -8
  221. package/src/be/seed-scripts/catalog/memory-eval.ts +11 -2
  222. package/src/be/seed-scripts/catalog/tool-usage.ts +27 -8
  223. package/src/be/swarm-config-guard.ts +91 -7
  224. package/src/be/users.ts +33 -12
  225. package/src/bitbucket/handlers.ts +1 -1
  226. package/src/comb/review-batch.ts +16 -5
  227. package/src/commands/context-preamble.ts +237 -0
  228. package/src/commands/credential-outcome-report.ts +96 -0
  229. package/src/commands/e2b.ts +14 -0
  230. package/src/commands/entrypoint-mcp-config.ts +231 -0
  231. package/src/commands/onboard/agent-fs-version.ts +1 -1
  232. package/src/commands/onboard/compose-generator.ts +2 -1
  233. package/src/commands/onboard/env-generator.ts +16 -7
  234. package/src/commands/runner.ts +72 -10
  235. package/src/commands/setup.tsx +17 -3
  236. package/src/event-waits/github.ts +39 -6
  237. package/src/event-waits/index.ts +4 -2
  238. package/src/event-waits/types.ts +10 -3
  239. package/src/extensions/contract-types.generated.ts +1 -1
  240. package/src/github/app.ts +177 -13
  241. package/src/github/handlers.ts +7 -2
  242. package/src/github/pull-request-state.ts +100 -11
  243. package/src/gitlab/handlers.ts +2 -2
  244. package/src/heartbeat/heartbeat.ts +6 -1
  245. package/src/hooks/hook.ts +8 -2
  246. package/src/hooks/native-tool-hooks.ts +4 -2
  247. package/src/http/api-keys.ts +26 -0
  248. package/src/http/apps.ts +82 -42
  249. package/src/http/asset-key-write.ts +45 -0
  250. package/src/http/assets.ts +4 -3
  251. package/src/http/comb.ts +21 -5
  252. package/src/http/config.ts +8 -4
  253. package/src/http/github-token.ts +27 -6
  254. package/src/http/heartbeat.ts +5 -0
  255. package/src/http/index.ts +12 -6
  256. package/src/http/kv.ts +7 -5
  257. package/src/http/mcp-oauth.ts +16 -0
  258. package/src/http/mcp-servers.ts +43 -3
  259. package/src/http/memory.ts +28 -1
  260. package/src/http/metrics.ts +11 -4
  261. package/src/http/onboarding.ts +12 -1
  262. package/src/http/pages.ts +4 -10
  263. package/src/http/repos.ts +27 -11
  264. package/src/http/request-principal.ts +27 -1
  265. package/src/http/schedules.ts +42 -14
  266. package/src/http/script-connection-proxy.ts +3 -1
  267. package/src/http/script-runs.ts +21 -10
  268. package/src/http/scripts.ts +177 -26
  269. package/src/http/session-cost-recompute.ts +9 -4
  270. package/src/http/sessions.ts +7 -2
  271. package/src/http/skills.ts +70 -0
  272. package/src/http/status.ts +2 -0
  273. package/src/http/tasks.ts +115 -19
  274. package/src/http/trackers/jira.ts +18 -3
  275. package/src/http/trackers/linear.ts +3 -0
  276. package/src/http/users.ts +5 -0
  277. package/src/http/webhooks.ts +19 -1
  278. package/src/http/workflows.ts +5 -10
  279. package/src/integrations/chat-sdk/commands.ts +3 -1
  280. package/src/jira/sync.ts +1 -1
  281. package/src/kv-limits.ts +2 -0
  282. package/src/kv-reserved-namespaces.ts +25 -2
  283. package/src/linear/sync.ts +5 -3
  284. package/src/prompts/session-templates.ts +50 -0
  285. package/src/prompts/session-turns.ts +30 -0
  286. package/src/providers/acp-targets.ts +2 -2
  287. package/src/providers/amp-adapter.ts +1 -1
  288. package/src/providers/claude-adapter.ts +5 -0
  289. package/src/providers/claude-managed-adapter.ts +14 -0
  290. package/src/providers/claude-sdk-session.ts +19 -1
  291. package/src/providers/cursor-adapter.ts +1 -1
  292. package/src/providers/dsh-adapter.ts +1 -1
  293. package/src/providers/opencode-adapter.ts +3 -5
  294. package/src/providers/runtime-dependencies.ts +11 -8
  295. package/src/rbac/legacy-policy.ts +7 -0
  296. package/src/rbac/permissions.ts +27 -0
  297. package/src/scheduler/deferred-task-waits.ts +74 -13
  298. package/src/scheduler/scheduler.ts +36 -18
  299. package/src/script-workflows/executor.ts +37 -8
  300. package/src/script-workflows/supervisor.ts +14 -0
  301. package/src/scripts-runtime/ctx.ts +5 -1
  302. package/src/scripts-runtime/durable-object-base.ts +19 -0
  303. package/src/scripts-runtime/eval-harness.ts +46 -1
  304. package/src/scripts-runtime/executors/native.ts +13 -1
  305. package/src/scripts-runtime/executors/quickjs-bundle.ts +20 -1
  306. package/src/scripts-runtime/executors/quickjs-prelude.ts +40 -1
  307. package/src/scripts-runtime/executors/quickjs-runner.ts +26 -3
  308. package/src/scripts-runtime/executors/quickjs-worker.ts +2 -1
  309. package/src/scripts-runtime/executors/types.ts +26 -0
  310. package/src/scripts-runtime/extract-signature.ts +96 -1
  311. package/src/scripts-runtime/loader.ts +11 -5
  312. package/src/scripts-runtime/mcp-client.ts +1 -1
  313. package/src/scripts-runtime/sdk-allowlist.ts +1 -0
  314. package/src/scripts-runtime/swarm-config.ts +7 -0
  315. package/src/scripts-runtime/swarm-sdk.ts +12 -2
  316. package/src/scripts-runtime/types/stdlib.d.ts +27 -1
  317. package/src/scripts-runtime/types/swarm-extension.d.ts +20 -2
  318. package/src/scripts-runtime/types/swarm-sdk.d.ts +27 -1
  319. package/src/slack/actions.ts +25 -1
  320. package/src/slack/assistant.ts +8 -0
  321. package/src/slack/blocks.ts +35 -0
  322. package/src/slack/channel-activity.ts +7 -0
  323. package/src/slack/enrich.ts +46 -54
  324. package/src/slack/files.ts +173 -23
  325. package/src/slack/handlers.test.ts +17 -19
  326. package/src/slack/handlers.ts +15 -14
  327. package/src/slack/render-v2.ts +403 -17
  328. package/src/slack/responses.ts +61 -5
  329. package/src/slack/session-mirror.ts +10 -5
  330. package/src/slack/task-output.ts +25 -14
  331. package/src/slack/templates.ts +9 -0
  332. package/src/slack/thread-participants.ts +64 -24
  333. package/src/slack/watcher.ts +4 -4
  334. package/src/slack/work-objects.ts +1 -1
  335. package/src/stdio.ts +5 -0
  336. package/src/tests/agents-list-model-display.test.ts +4 -0
  337. package/src/tests/api-drain-worker-e2e.test.ts +0 -2
  338. package/src/tests/approval-auto-cancellation-migration.test.ts +8 -19
  339. package/src/tests/approval-card-resolution.test.ts +2 -17
  340. package/src/tests/approval-requests-notifications.test.ts +41 -27
  341. package/src/tests/approval-requests.test.ts +137 -369
  342. package/src/tests/apps-script-types.test.ts +63 -16
  343. package/src/tests/apps-sort-order.test.ts +87 -0
  344. package/src/tests/apps-sync-engine.test.ts +5 -3
  345. package/src/tests/apps-table-filters-migration.test.ts +44 -25
  346. package/src/tests/bedrock-model-groups.test.ts +4 -0
  347. package/src/tests/bitbucket-handlers.test.ts +2 -0
  348. package/src/tests/channel-activity.test.ts +9 -0
  349. package/src/tests/chat-sdk-commands.test.ts +1 -0
  350. package/src/tests/chatgpt-subscription-model-groups.test.ts +4 -0
  351. package/src/tests/claude-adapter.test.ts +35 -0
  352. package/src/tests/claude-hook-output.test.ts +2 -0
  353. package/src/tests/claude-managed-adapter.test.ts +15 -3
  354. package/src/tests/claude-sdk-stderr.test.ts +28 -0
  355. package/src/tests/codex-adapter.test.ts +3 -92
  356. package/src/tests/codex-gpt6-release.test.ts +4 -9
  357. package/src/tests/codex-oauth-credential-info.test.ts +35 -18
  358. package/src/tests/codex-oauth.test.ts +0 -6
  359. package/src/tests/codex-pool.test.ts +5 -214
  360. package/src/tests/codex-rate-limit-parse.test.ts +0 -7
  361. package/src/tests/codex-swarm-events.test.ts +11 -54
  362. package/src/tests/comb-review-batch.test.ts +17 -4
  363. package/src/tests/comb-status.test.ts +1 -0
  364. package/src/tests/db-client-busy-retry.test.ts +49 -16
  365. package/src/tests/db-client.test.ts +11 -5
  366. package/src/tests/db-task-read-contract.test.ts +1 -0
  367. package/src/tests/db-task-write-contract.test.ts +2 -2
  368. package/src/tests/defer-task.test.ts +24 -1
  369. package/src/tests/dsh-adapter.test.ts +1 -1
  370. package/src/tests/e2b-dispatch.test.ts +13 -1
  371. package/src/tests/e2e-shards.test.ts +9 -9
  372. package/src/tests/enabled-tools.test.ts +0 -2
  373. package/src/tests/entrypoint-mcp-config.test.ts +642 -0
  374. package/src/tests/fixtures/base-prompt-baseline.json +6 -6
  375. package/src/tests/fixtures/onboard/content.env.txt +2 -2
  376. package/src/tests/fixtures/onboard/dev.env.txt +2 -2
  377. package/src/tests/fixtures/onboard/full-all.env.txt +2 -2
  378. package/src/tests/fixtures/onboard/full.env.txt +2 -2
  379. package/src/tests/fixtures/onboard/research.env.txt +2 -2
  380. package/src/tests/fixtures/onboard/solo.env.txt +2 -2
  381. package/src/tests/fixtures/runner-missing-dependency.ts +2 -1
  382. package/src/tests/fx-adapter.test.ts +4 -5
  383. package/src/tests/github-app-worker-auth-helper.test.ts +147 -1
  384. package/src/tests/gitlab-handlers.test.ts +2 -0
  385. package/src/tests/heartbeat-jev-gate.test.ts +9 -241
  386. package/src/tests/heartbeat-reroute-decision.test.ts +2 -0
  387. package/src/tests/heartbeat-supersede-resume.test.ts +2 -0
  388. package/src/tests/heartbeat.test.ts +1 -0
  389. package/src/tests/hook-mcp-config-precedence.test.ts +59 -0
  390. package/src/tests/hook-ping-me-order.test.ts +1 -0
  391. package/src/tests/hook-runtime-close.test.ts +1 -0
  392. package/src/tests/improvements-payload.test.ts +2 -2
  393. package/src/tests/key-usage-selection.test.ts +302 -0
  394. package/src/tests/memory-e2e.test.ts +34 -103
  395. package/src/tests/memory-key-paths.test.ts +5 -0
  396. package/src/tests/memory-rater-llm.test.ts +33 -149
  397. package/src/tests/memory-store.test.ts +24 -125
  398. package/src/tests/memory.test.ts +31 -100
  399. package/src/tests/merge-gate-detect-changes.test.ts +108 -2
  400. package/src/tests/model-groups-live-catalog.test.ts +4 -0
  401. package/src/tests/oauth-credential-bindings.test.ts +8 -3
  402. package/src/tests/oauth-refresh-failure.test.ts +15 -3
  403. package/src/tests/onboard-env.test.ts +1 -1
  404. package/src/tests/openai-compatible-providers.test.ts +5 -0
  405. package/src/tests/openapi-route-headers.test.ts +2 -1
  406. package/src/tests/opus-5-5-registry.test.ts +4 -0
  407. package/src/tests/otel-service-name.test.ts +0 -9
  408. package/src/tests/otel-session-cost-metrics.test.ts +1 -38
  409. package/src/tests/pool-session-logs.test.ts +8 -42
  410. package/src/tests/pre-push-affected-tests.test.ts +106 -0
  411. package/src/tests/prompt-template-session.test.ts +3 -0
  412. package/src/tests/provider-runtime-dependencies.test.ts +26 -15
  413. package/src/tests/routing-affinity-inventory.test.ts +11 -0
  414. package/src/tests/runner-api-drain.test.ts +2 -17
  415. package/src/tests/runner-context-preamble.test.ts +202 -0
  416. package/src/tests/runner-repo-clone-args.test.ts +116 -0
  417. package/src/tests/runner-terminal-window-report.test.ts +132 -0
  418. package/src/tests/runtime-supervisor-failures.test.ts +1 -0
  419. package/src/tests/sandboxed-process.test.ts +26 -21
  420. package/src/tests/schedule-http-triage-tools.test.ts +12 -9
  421. package/src/tests/scheduled-tasks.test.ts +14 -51
  422. package/src/tests/scheduler-occurrence.test.ts +60 -9
  423. package/src/tests/script-connections-mcp.test.ts +6 -3
  424. package/src/tests/script-connections.test.ts +4 -0
  425. package/src/tests/script-executor-conformance.test.ts +4 -48
  426. package/src/tests/script-executor-quickjs-pool.test.ts +9 -7
  427. package/src/tests/script-native-startup.test.ts +21 -25
  428. package/src/tests/scripts-namespaces.test.ts +3 -1
  429. package/src/tests/secret-rules.test.ts +4 -2
  430. package/src/tests/secret-scrubber.test.ts +8 -2
  431. package/src/tests/session-cost-recompute-unit.test.ts +39 -0
  432. package/src/tests/session-costs-recompute-all-providers.test.ts +6 -3
  433. package/src/tests/session-logs.test.ts +1 -260
  434. package/src/tests/session-route-posture.test.ts +7 -1
  435. package/src/tests/slack-file-tools-attachments.test.ts +14 -9
  436. package/src/tests/slack-identity-resolution.test.ts +10 -3
  437. package/src/tests/slack-inline-output.test.ts +10 -8
  438. package/src/tests/slack-render-v2.test.ts +14 -152
  439. package/src/tests/slack-steering.test.ts +8 -2
  440. package/src/tests/slack-thread-participants.test.ts +11 -1
  441. package/src/tests/sonnet-5-5-registry.test.ts +4 -0
  442. package/src/tests/swarm-config-encryption.test.ts +5 -8
  443. package/src/tests/task-cascade-fail.test.ts +1 -0
  444. package/src/tests/task-supersede-resume.test.ts +1 -0
  445. package/src/tests/test-proc.ts +5 -2
  446. package/src/tests/ui-spec-script-actions-config.test.ts +7 -3
  447. package/src/tests/window-stream-reporter.test.ts +122 -0
  448. package/src/tests/workflow-agent-task-retry.test.ts +1 -3
  449. package/src/tests/workflow-cascade-cancel.test.ts +1 -0
  450. package/src/tests/workflow-retry-v2.test.ts +34 -43
  451. package/src/tests/workflow-retry-validation.test.ts +8 -48
  452. package/src/tests/workflow-triggers-v2.test.ts +35 -11
  453. package/src/tests/worktree-reaper.test.ts +2 -2
  454. package/src/tools/app-patch.ts +6 -2
  455. package/src/tools/app-upsert.ts +8 -4
  456. package/src/tools/cancel-task.ts +2 -2
  457. package/src/tools/defer-task.ts +24 -79
  458. package/src/tools/get-task-details.ts +8 -4
  459. package/src/tools/get-tasks.ts +13 -2
  460. package/src/tools/kv/kv-get.ts +2 -0
  461. package/src/tools/kv/kv-list.ts +11 -5
  462. package/src/tools/kv/kv-set.ts +1 -3
  463. package/src/tools/manage-user.ts +9 -0
  464. package/src/tools/repos/update-repo.ts +37 -19
  465. package/src/tools/schedules/run-schedule-now.ts +21 -1
  466. package/src/tools/script-apis.ts +9 -4
  467. package/src/tools/script-common.ts +2 -2
  468. package/src/tools/script-run.ts +8 -0
  469. package/src/tools/script-upsert.ts +1 -1
  470. package/src/tools/slack-download-file.ts +15 -12
  471. package/src/tools/slack-post.ts +7 -1
  472. package/src/tools/slack-read.ts +3 -1
  473. package/src/tools/slack-reply.ts +16 -0
  474. package/src/tools/slack-start-thread.ts +8 -1
  475. package/src/tools/slack-upload-file.ts +99 -96
  476. package/src/tools/store-progress.ts +5 -3
  477. package/src/tools/swarm-config/set-config.ts +3 -1
  478. package/src/tools/swarm-x.ts +0 -2
  479. package/src/tools/utils.ts +3 -0
  480. package/src/types.ts +101 -2
  481. package/src/utils/constants.ts +32 -0
  482. package/src/utils/credentials.ts +42 -5
  483. package/src/utils/deferral-time.ts +61 -0
  484. package/src/utils/error-tracker.ts +6 -0
  485. package/src/utils/key-usage.ts +114 -0
  486. package/src/utils/request-auth-context.ts +15 -16
  487. package/src/utils/sandboxed-process.ts +1 -0
  488. package/src/utils/secret-scrubber.ts +1 -1
  489. package/src/workflows/engine.ts +6 -11
  490. package/src/workflows/executors/swarm-script.ts +0 -2
  491. package/src/workflows/foreach-driver.ts +6 -12
  492. package/src/workflows/input.ts +24 -1
  493. package/src/workflows/node-timeout.ts +18 -0
  494. package/src/workflows/resume.ts +5 -2
  495. package/src/workflows/retry-poller.ts +2 -1
  496. package/src/workflows/triggers.ts +21 -11
  497. package/src/x/composio.ts +10 -1
  498. package/templates/skills/apps/SKILL.md +6 -2
  499. package/templates/skills/apps/content.md +6 -2
  500. package/templates/skills/boards-and-sheets/content.md +4 -2
  501. package/templates/skills/code-quality/content.md +4 -4
  502. package/templates/skills/pages/content.md +7 -0
  503. package/templates/skills/scheduled-task-resilience/SKILL.md +2 -0
  504. package/templates/skills/scheduled-task-resilience/content.md +2 -0
  505. package/templates/skills/swarm-docs/content.md +8 -0
  506. package/templates/skills/swarm-scripts/SKILL.md +45 -0
  507. package/templates/skills/swarm-scripts/content.md +45 -0
  508. package/dist/acp-adapter-mr4temec.js +0 -17
  509. package/dist/cli-1vmhnncj.js +0 -173
  510. package/dist/cli-kj0hyr43.js +0 -51
  511. package/dist/cli-ysv0k1we.js +0 -459
  512. package/dist/core-gsvj5f3z.js +0 -42
  513. package/dist/dsh-adapter-8abzqk5c.js +0 -9
  514. package/dist/fx-adapter-4sjrbdne.js +0 -20
  515. package/dist/grok-adapter-3a0ezfee.js +0 -20
  516. package/dist/handlers-ef3k11hb.js +0 -41
  517. package/dist/index-aetfyx6p.js +0 -13
  518. package/dist/index-e6bq0exk.js +0 -42
  519. package/dist/index-hf2k1vge.js +0 -39
  520. package/dist/index-taxmejj3.js +0 -44
  521. package/dist/lead-5vt6f174.js +0 -83
  522. package/dist/thread-buffer-686pa1p1.js +0 -42
  523. package/dist/worker-4vp616ms.js +0 -83
  524. package/src/tests/apps-table-selection-migration.test.ts +0 -95
  525. package/src/tests/extensions-example-heartbeat-remediate.test.ts +0 -69
  526. package/src/tests/extensions-example-rewrite-and-suppress.test.ts +0 -70
@@ -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 | "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';
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 | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\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 | "system"\n | "slack"\n | "agentmail"\n | "mcp"\n | "api"\n | "ui"\n | "github"\n | "gitlab"\n | "azure-devops"\n | "bitbucket"\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 statusKind?:\n | "error"\n | "workflow"\n | "external"\n | "agent"\n | "runner"\n | "deferred"\n | "cascade"\n | "user"\n | "system"\n | "graceful_shutdown"\n | "context_limits"\n | "manual_supersede"\n | "crash_recovery"\n | "provider_fallback"\n | "workflow_retry"\n | 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 deferredUntil?: 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';
package/src/github/app.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import { getSwarmRepos } from "../be/db";
1
2
  import { isEnvFlagEnabled } from "../utils/env-flag";
2
3
  import { githubApiUrl, resolveGitHubHost } from "../utils/github-host";
3
4
 
@@ -9,6 +10,15 @@ let privateKey: string | null = null;
9
10
  // Token cache: installationId -> { token, expiresAt }
10
11
  const tokenCache = new Map<number, { token: string; expiresAt: number }>();
11
12
 
13
+ // Repo -> installation cache, so a worker's every git/gh call does not cost a
14
+ // `GET /repos/{owner}/{repo}/installation`. A "no installation" answer is kept
15
+ // for a minute only: a registered repo that GitHub refuses cannot turn each mint
16
+ // request into an App JWT plus a GitHub call, and an installation added later
17
+ // still works without restarting the API.
18
+ const INSTALLATION_CACHE_TTL_MS = 10 * 60_000;
19
+ const NO_INSTALLATION_CACHE_TTL_MS = 60_000;
20
+ const installationCache = new Map<string, { id: number | null; expiresAt: number }>();
21
+
12
22
  /** Raw PEM (with literal `\\n` escapes) or base64-encoded PEM. */
13
23
  function decodePrivateKey(raw: string): string {
14
24
  return raw.startsWith("-----BEGIN")
@@ -31,6 +41,7 @@ export function resetGitHub(): void {
31
41
  appId = null;
32
42
  privateKey = null;
33
43
  tokenCache.clear();
44
+ installationCache.clear();
34
45
  }
35
46
 
36
47
  export function initGitHub(): boolean {
@@ -264,30 +275,183 @@ async function mintInstallationToken(
264
275
  export type WorkerInstallationToken =
265
276
  | { status: "ok"; token: string; expiresAt: string }
266
277
  | { status: "unconfigured" }
278
+ | { status: "forbidden" }
267
279
  | { status: "error" };
268
280
 
269
281
  /**
270
- * Installation token for worker `git` / `gh`, minted for the one installation
271
- * named by `GITHUB_APP_INSTALLATION_ID`. Callers never pick the installation, so
272
- * no request can get a token for an installation the swarm is not configured for.
282
+ * `owner/name`, lowercased, from a swarm repo URL (`https://github.com/o/r.git`),
283
+ * an scp-like remote (`git@host:o/r`) or the shorthand itself. GitHub treats
284
+ * owner and repo names case-insensitively, so the `swarm_repos` comparison does
285
+ * too; the last two path segments are the identity, whichever form the caller got.
286
+ * A `.`/`..` segment returns `""`, which matches no registered repo, so a caller
287
+ * cannot aim the installation lookup at another API path.
288
+ */
289
+ export function normalizeRepo(repo: string): string {
290
+ const trimmed = repo.trim().replace(/\/+$/, "");
291
+ const lastTwo = trimmed.replace(/\.git$/i, "").match(/([^/:]+\/[^/:]+)$/);
292
+ if (!lastTwo) return trimmed.toLowerCase();
293
+ const [owner, name] = lastTwo[1]!.split("/") as [string, string];
294
+ if (owner === "." || owner === ".." || name === "." || name === "..") return "";
295
+ return lastTwo[1]!.toLowerCase();
296
+ }
297
+
298
+ /**
299
+ * Owners (GitHub user or org logins, lowercased) whose repos may get a token for
300
+ * their own installation, from the deployment env `GITHUB_APP_REPO_OWNERS`
301
+ * (comma-separated). It is a reserved key, so no config writer can extend it.
302
+ * Empty: every call mints for `GITHUB_APP_INSTALLATION_ID`, as before.
303
+ */
304
+ function allowedRepoOwners(): Set<string> {
305
+ return new Set(
306
+ (process.env.GITHUB_APP_REPO_OWNERS ?? "")
307
+ .split(",")
308
+ .map((owner) => owner.trim().toLowerCase())
309
+ .filter(Boolean),
310
+ );
311
+ }
312
+
313
+ /**
314
+ * `owner/name` of a `swarm_repos` URL when it points at the configured GitHub
315
+ * host (https, ssh or scp-like) or is the bare `owner/name` shorthand; `null`
316
+ * for any other host or shape. A URL on another host whose path merely ends in
317
+ * `owner/name` is not that repository.
318
+ */
319
+ function registeredSlugOnHost(url: string, host: string): string | null {
320
+ const trimmed = url
321
+ .trim()
322
+ .replace(/\/+$/, "")
323
+ .replace(/\.git$/i, "");
324
+ let urlHost: string | null = null;
325
+ let path: string;
326
+ const scp = trimmed.match(/^[^@/:]+@([^:/]+):(.+)$/);
327
+ if (scp) {
328
+ urlHost = scp[1]!.toLowerCase();
329
+ path = scp[2]!;
330
+ } else if (/^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed)) {
331
+ try {
332
+ const parsed = new URL(trimmed);
333
+ urlHost = parsed.host.toLowerCase();
334
+ path = parsed.pathname;
335
+ } catch {
336
+ return null;
337
+ }
338
+ } else {
339
+ path = trimmed;
340
+ }
341
+ if (
342
+ urlHost !== null &&
343
+ urlHost !== host &&
344
+ !(host === "github.com" && urlHost === "www.github.com")
345
+ ) {
346
+ return null;
347
+ }
348
+ const segments = path.replace(/^\/+/, "").split("/");
349
+ if (segments.length !== 2) return null;
350
+ const slug = normalizeRepo(segments.join("/"));
351
+ return slug || null;
352
+ }
353
+
354
+ /**
355
+ * The App installation that owns `repo`, asked of GitHub with an App JWT
356
+ * (`GET /repos/{owner}/{repo}/installation`). Cached for ten minutes because a
357
+ * worker asks once per git/gh call. `null` when GitHub does not answer 200:
358
+ * no installation, a revoked one, or an App that cannot see the repository.
359
+ * Also `null` when the installation's account is not an allowed owner (a
360
+ * transferred repo redirects to its new owner's installation).
361
+ */
362
+ async function resolveInstallationId(
363
+ repo: string,
364
+ creds: { appId: string | null; privateKey: string | null },
365
+ owners: Set<string>,
366
+ ): Promise<number | null> {
367
+ const cached = installationCache.get(repo);
368
+ if (cached && cached.expiresAt > Date.now()) return cached.id;
369
+
370
+ const jwt = await generateAppJWT(creds);
371
+ if (!jwt) return null;
372
+
373
+ const refuse = (): null => {
374
+ installationCache.set(repo, { id: null, expiresAt: Date.now() + NO_INSTALLATION_CACHE_TTL_MS });
375
+ return null;
376
+ };
377
+ try {
378
+ const response = await fetch(githubApiUrl(`/repos/${repo}/installation`), {
379
+ headers: {
380
+ Accept: "application/vnd.github+json",
381
+ Authorization: `Bearer ${jwt}`,
382
+ "X-GitHub-Api-Version": "2022-11-28",
383
+ },
384
+ });
385
+ if (response.status !== 200) {
386
+ console.log(`[GitHub] No installation for ${repo}: ${response.status}`);
387
+ return refuse();
388
+ }
389
+ const data = (await response.json()) as { id?: unknown; account?: { login?: unknown } };
390
+ if (typeof data.id !== "number") return refuse();
391
+ const account = typeof data.account?.login === "string" ? data.account.login.toLowerCase() : "";
392
+ if (!owners.has(account)) {
393
+ console.log(`[GitHub] Installation for ${repo} belongs to an owner that is not allowed`);
394
+ return refuse();
395
+ }
396
+ installationCache.set(repo, {
397
+ id: data.id,
398
+ expiresAt: Date.now() + INSTALLATION_CACHE_TTL_MS,
399
+ });
400
+ return data.id;
401
+ } catch (error) {
402
+ console.error("[GitHub] Error resolving the repo installation:", error);
403
+ return null;
404
+ }
405
+ }
406
+
407
+ /**
408
+ * Installation token for worker `git` / `gh`.
409
+ *
410
+ * With a `repo` (`owner/name`) whose owner is listed in the deployment env
411
+ * `GITHUB_APP_REPO_OWNERS`, the token is minted for that repository's App
412
+ * installation, resolved with the App JWT: one App with an installation per
413
+ * owner can then serve repos from more than one account. The operator's owner
414
+ * list is the boundary; the repository must also be registered in `swarm_repos`
415
+ * on the configured GitHub host.
416
+ *
417
+ * Any other call, with no repo or a repo of an unlisted owner, mints for the
418
+ * fixed `GITHUB_APP_INSTALLATION_ID`, so a single-installation deployment
419
+ * behaves exactly as before and a caller never picks an installation the
420
+ * operator did not list.
421
+ *
273
422
  * Reads env on each call: it works without the webhook (`initGitHub` loads App
274
423
  * credentials only when `GITHUB_WEBHOOK_SECRET` is set).
275
424
  */
276
- export async function getWorkerInstallationToken(): Promise<WorkerInstallationToken> {
425
+ export async function getWorkerInstallationToken(repo?: string): Promise<WorkerInstallationToken> {
277
426
  if (isEnvFlagEnabled("GITHUB_DISABLE", false)) return { status: "unconfigured" };
278
427
  const workerAppId = process.env.GITHUB_APP_ID?.trim();
279
428
  const rawKey = process.env.GITHUB_APP_PRIVATE_KEY?.trim();
280
- const rawInstallation = process.env.GITHUB_APP_INSTALLATION_ID?.trim() ?? "";
281
- if (!workerAppId || !rawKey || !/^[1-9][0-9]{0,15}$/.test(rawInstallation)) {
282
- return { status: "unconfigured" };
429
+ if (!workerAppId || !rawKey) return { status: "unconfigured" };
430
+ const host = resolveGitHubHost();
431
+ if (!host.ok) return { status: "error" };
432
+ const creds = { appId: workerAppId, privateKey: decodePrivateKey(rawKey) };
433
+
434
+ const owners = allowedRepoOwners();
435
+ const target = repo ? normalizeRepo(repo) : "";
436
+ const owner = target.split("/")[0] ?? "";
437
+ let installationId: number;
438
+ if (target && owners.has(owner)) {
439
+ // An allowed owner: the repo must also be one the swarm manages on this host.
440
+ const registered = (await getSwarmRepos()).some(
441
+ (r) => registeredSlugOnHost(r.url, host.config.host) === target,
442
+ );
443
+ if (!registered) return { status: "forbidden" };
444
+ const resolved = await resolveInstallationId(target, creds, owners);
445
+ if (resolved === null) return { status: "error" };
446
+ installationId = resolved;
447
+ } else {
448
+ const rawInstallation = process.env.GITHUB_APP_INSTALLATION_ID?.trim() ?? "";
449
+ if (!/^[1-9][0-9]{0,15}$/.test(rawInstallation)) return { status: "unconfigured" };
450
+ installationId = Number(rawInstallation);
283
451
  }
284
- if (!resolveGitHubHost().ok) return { status: "error" };
452
+
285
453
  // Hand out a token with at least 10 minutes left, so a worker can cache it.
286
- const minted = await mintInstallationToken(
287
- Number(rawInstallation),
288
- { appId: workerAppId, privateKey: decodePrivateKey(rawKey) },
289
- 10 * 60_000,
290
- );
454
+ const minted = await mintInstallationToken(installationId, creds, 10 * 60_000);
291
455
  if (!minted) return { status: "error" };
292
456
  return { status: "ok", token: minted.token, expiresAt: new Date(minted.expiresAt).toISOString() };
293
457
  }
@@ -355,7 +355,9 @@ export async function handlePullRequest(
355
355
  }
356
356
 
357
357
  // Cancel the task
358
- const cancelledTask = await failTask(task.id, `Unassigned from GitHub PR #${pr.number}`);
358
+ const cancelledTask = await failTask(task.id, `Unassigned from GitHub PR #${pr.number}`, {
359
+ statusKind: "external",
360
+ });
359
361
  if (cancelledTask) {
360
362
  console.log(`[GitHub] Cancelled task ${task.id} for PR #${pr.number} (unassigned)`);
361
363
  return { created: false, taskId: task.id };
@@ -470,6 +472,7 @@ export async function handlePullRequest(
470
472
  const cancelledTask = await failTask(
471
473
  task.id,
472
474
  `Review request removed from GitHub PR #${pr.number}`,
475
+ { statusKind: "external" },
473
476
  );
474
477
  if (cancelledTask) {
475
478
  console.log(
@@ -756,7 +759,9 @@ export async function handleIssue(
756
759
  }
757
760
 
758
761
  // Cancel the task
759
- const cancelledTask = await failTask(task.id, `Unassigned from GitHub issue #${issue.number}`);
762
+ const cancelledTask = await failTask(task.id, `Unassigned from GitHub issue #${issue.number}`, {
763
+ statusKind: "external",
764
+ });
760
765
  if (cancelledTask) {
761
766
  console.log(`[GitHub] Cancelled task ${task.id} for issue #${issue.number} (unassigned)`);
762
767
  return { created: false, taskId: task.id };
@@ -1,20 +1,21 @@
1
1
  import { githubApiUrl } from "../utils/github-host";
2
2
  import { getWorkerInstallationToken } from "./app";
3
3
 
4
- export type PullRequestState = { merged: boolean; state: "open" | "closed" };
4
+ export type PullRequestState = {
5
+ merged: boolean;
6
+ state: "open" | "closed";
7
+ headSha: string;
8
+ baseRef: string;
9
+ };
5
10
 
6
11
  /**
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
12
+ * GET one GitHub REST path. Sends the App installation token when one is
9
13
  * configured, otherwise reads unauthenticated (enough for a public repo).
10
14
  * Throws on any non-2xx so a failed read never counts as an answer.
11
15
  */
12
- export async function fetchPullRequestState(
13
- repo: string,
14
- number: number,
15
- ): Promise<PullRequestState> {
16
+ async function githubGet<T>(path: string, what: string): Promise<T> {
16
17
  const auth = await getWorkerInstallationToken();
17
- const response = await fetch(githubApiUrl(`/repos/${repo}/pulls/${number}`), {
18
+ const response = await fetch(githubApiUrl(path), {
18
19
  headers: {
19
20
  Accept: "application/vnd.github+json",
20
21
  "X-GitHub-Api-Version": "2022-11-28",
@@ -22,13 +23,101 @@ export async function fetchPullRequestState(
22
23
  },
23
24
  signal: AbortSignal.timeout(10_000),
24
25
  });
25
- if (!response.ok) throw new Error(`GitHub returned ${response.status} for ${repo}#${number}`);
26
- const pr = (await response.json()) as {
26
+ if (!response.ok) throw new Error(`GitHub returned ${response.status} for ${what}`);
27
+ return (await response.json()) as T;
28
+ }
29
+
30
+ /** Read one PR from GitHub. A webhook only names a candidate; callers that wake an agent confirm here first. */
31
+ export async function fetchPullRequestState(
32
+ repo: string,
33
+ number: number,
34
+ ): Promise<PullRequestState> {
35
+ const pr = await githubGet<{
27
36
  merged?: boolean;
28
37
  state?: string;
29
- };
38
+ head?: { sha?: string };
39
+ base?: { ref?: string };
40
+ }>(`/repos/${repo}/pulls/${number}`, `${repo}#${number}`);
30
41
  return {
31
42
  merged: pr.merged === true,
32
43
  state: pr.state === "open" ? "open" : "closed",
44
+ headSha: pr.head?.sha ?? "",
45
+ baseRef: pr.base?.ref ?? "",
33
46
  };
34
47
  }
48
+
49
+ export type RequiredCheckState = {
50
+ name: string;
51
+ /** False while the check is queued, running, or has not reported on the SHA yet. */
52
+ complete: boolean;
53
+ conclusion: string | null;
54
+ completedAt: string | null;
55
+ };
56
+
57
+ /**
58
+ * The required status checks the base branch's rulesets name, each read on `sha`.
59
+ * A check counts as complete on any conclusion; a required check that has not
60
+ * reported yet is incomplete. Throws when the branch has no required checks:
61
+ * "all required checks are done" would then be vacuously true.
62
+ */
63
+ export async function fetchRequiredCheckStates(
64
+ repo: string,
65
+ baseRef: string,
66
+ sha: string,
67
+ ): Promise<RequiredCheckState[]> {
68
+ const rules = await githubGet<
69
+ Array<{
70
+ type?: string;
71
+ parameters?: { required_status_checks?: Array<{ context: string; integration_id?: number }> };
72
+ }>
73
+ >(`/repos/${repo}/rules/branches/${encodeURIComponent(baseRef)}`, `${repo} rules on ${baseRef}`);
74
+ const required = new Map<string, number | undefined>();
75
+ for (const rule of rules) {
76
+ if (rule.type !== "required_status_checks") continue;
77
+ for (const check of rule.parameters?.required_status_checks ?? [])
78
+ required.set(check.context, check.integration_id);
79
+ }
80
+ if (!required.size) throw new Error(`${repo} has no required status checks on ${baseRef}`);
81
+
82
+ let statuses: Array<{ context: string; state: string; updated_at: string }> | undefined;
83
+ const states: RequiredCheckState[] = [];
84
+ for (const [name, appId] of required) {
85
+ const runs = await githubGet<{
86
+ check_runs?: Array<{
87
+ status?: string;
88
+ conclusion?: string | null;
89
+ completed_at?: string | null;
90
+ app?: { id?: number };
91
+ }>;
92
+ }>(
93
+ `/repos/${repo}/commits/${sha}/check-runs?check_name=${encodeURIComponent(name)}&filter=latest&per_page=100`,
94
+ `${repo} check runs on ${sha}`,
95
+ );
96
+ const run = (runs.check_runs ?? []).find((r) => appId === undefined || r.app?.id === appId);
97
+ if (run) {
98
+ states.push({
99
+ name,
100
+ complete: run.status === "completed",
101
+ conclusion: run.conclusion ?? null,
102
+ completedAt: run.completed_at ?? null,
103
+ });
104
+ continue;
105
+ }
106
+ // A required check can also be a commit status (context), not a check run.
107
+ statuses ??=
108
+ (
109
+ await githubGet<{
110
+ statuses?: Array<{ context: string; state: string; updated_at: string }>;
111
+ }>(`/repos/${repo}/commits/${sha}/status?per_page=100`, `${repo} statuses on ${sha}`)
112
+ ).statuses ?? [];
113
+ const status = statuses.find((s) => s.context === name);
114
+ const complete = status !== undefined && status.state !== "pending";
115
+ states.push({
116
+ name,
117
+ complete,
118
+ conclusion: complete ? status.state : null,
119
+ completedAt: complete ? status.updated_at : null,
120
+ });
121
+ }
122
+ return states;
123
+ }
@@ -256,7 +256,7 @@ export async function handleMergeRequest(
256
256
  const tasks = await findActiveTasksByVcs(repo, mr.iid, "gitlab");
257
257
  for (const task of tasks.filter((t) => isScopedTask(t, "mr", mrContextKey))) {
258
258
  console.log(`[GitLab] Cancelling task ${task.id} — ${reason}`);
259
- await failTask(task.id, reason);
259
+ await failTask(task.id, reason, { statusKind: "external" });
260
260
  }
261
261
  return { created: false };
262
262
  }
@@ -374,7 +374,7 @@ export async function handleIssue(
374
374
  );
375
375
  if (existingTask) {
376
376
  console.log(`[GitLab] Cancelling task ${existingTask.id} — issue closed`);
377
- await failTask(existingTask.id, "Issue was closed");
377
+ await failTask(existingTask.id, "Issue was closed", { statusKind: "external" });
378
378
  }
379
379
  return { created: false };
380
380
  }
@@ -812,6 +812,7 @@ async function remediateCrashedWorkerTask(
812
812
  // CAS on the lastUpdatedAt this sweep read: progress since then wins.
813
813
  const failed = await failTask(task.id, decision.reason, {
814
814
  expectedLastUpdatedAt: task.lastUpdatedAt,
815
+ statusKind: "error",
815
816
  });
816
817
  if (failed) {
817
818
  await opts.onRemediated?.();
@@ -834,6 +835,7 @@ async function remediateCrashedWorkerTask(
834
835
 
835
836
  const superseded = await supersedeTask(task.id, {
836
837
  reason: decision.reason,
838
+ statusKind: "crash_recovery",
837
839
  resumeTaskId: null,
838
840
  // CAS on the lastUpdatedAt this sweep read: progress since then wins.
839
841
  expectedLastUpdatedAt: task.lastUpdatedAt,
@@ -1010,7 +1012,10 @@ export async function runRebootSweep(): Promise<void> {
1010
1012
  // Auto-fail the task. Its dependents are settled in the `finally` below
1011
1013
  // (re-pointed to the retry child, or cascade-failed when there is none)
1012
1014
  // instead of by failTask's unconditional cascade.
1013
- const failed = await failTask(task.id, reason, { cascadeDependents: false });
1015
+ const failed = await failTask(task.id, reason, {
1016
+ cascadeDependents: false,
1017
+ statusKind: "error",
1018
+ });
1014
1019
  if (!failed) continue;
1015
1020
 
1016
1021
  let retryTaskId: string | null = null;
package/src/hooks/hook.ts CHANGED
@@ -63,11 +63,16 @@ type McpServerConfig = {
63
63
  };
64
64
  };
65
65
 
66
+ /**
67
+ * The worker-owned `/workspace/.mcp.json` wins over the project's, as in the
68
+ * session MCP config. The project file is used only when the workspace file
69
+ * has no swarm entry (a local setup with no `/workspace`).
70
+ */
66
71
  export async function loadHookMcpConfig(
67
72
  projectDir: string,
68
73
  workspaceDir = "/workspace",
69
74
  ): Promise<McpServerConfig | undefined> {
70
- for (const configDir of new Set([projectDir, workspaceDir])) {
75
+ for (const configDir of new Set([workspaceDir, projectDir])) {
71
76
  try {
72
77
  const mcpFile = Bun.file(`${configDir}/.mcp.json`);
73
78
  if (!(await mcpFile.exists())) continue;
@@ -551,7 +556,8 @@ export async function runSessionSummaryFromStdin(): Promise<void> {
551
556
  */
552
557
  export async function handleHook(): Promise<void> {
553
558
  const projectDir = process.env.CLAUDE_PROJECT_DIR || process.cwd();
554
- const mcpConfig = await loadHookMcpConfig(projectDir);
559
+ // HOOK_WORKSPACE_DIR lets tests keep a worker's real /workspace/.mcp.json out of the hook.
560
+ const mcpConfig = await loadHookMcpConfig(projectDir, process.env.HOOK_WORKSPACE_DIR);
555
561
 
556
562
  let msg: HookMessage;
557
563
  try {
@@ -127,7 +127,9 @@ export async function nativeHooksActive(
127
127
  const key = cacheKey(target);
128
128
  const file = join(tmpdir(), `agent-swarm-native-hooks-${key}.json`);
129
129
  const cached = memoryStatus.get(key) ?? readStatusFile(file);
130
- if (cached && cached.until > now()) return cached.native;
130
+ // The shim never writes an expiry more than STATUS_TTL_MS ahead, so a later one is a miss.
131
+ const at = now();
132
+ if (cached && cached.until > at && cached.until <= at + STATUS_TTL_MS) return cached.native;
131
133
 
132
134
  let entry: StatusEntry;
133
135
  try {
@@ -143,7 +145,7 @@ export async function nativeHooksActive(
143
145
  }
144
146
  memoryStatus.set(key, entry);
145
147
  try {
146
- writeFileSync(file, JSON.stringify(entry));
148
+ writeFileSync(file, JSON.stringify(entry), { mode: 0o600 });
147
149
  } catch {
148
150
  // An unwritable temp dir only costs the cache.
149
151
  }