@desplega.ai/agent-swarm 2.8.2 → 2.9.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 (558) hide show
  1. package/dist/acp-adapter-jqn86aam.js +16 -0
  2. package/dist/acp-targets-swxq55dr.js +23 -0
  3. package/dist/{actions-kxek041g.js → actions-pb678g3e.js} +22 -20
  4. package/dist/agent-fs-provision-dmhnc38q.js +27 -0
  5. package/dist/{amp-adapter-ce7jjke4.js → amp-adapter-3pa66q27.js} +3 -3
  6. package/dist/{anthropic-messages-jkva0zps.js → anthropic-messages-x2cp5fvf.js} +41 -41
  7. package/dist/{app-v6zz8yh0.js → app-17d12ev4.js} +6 -4
  8. package/dist/approval-notifications-h7vd9pmg.js +20 -0
  9. package/dist/{assistant-m0sw9xx2.js → assistant-t7k39ree.js} +56 -34
  10. package/dist/{azure-openai-responses-wgtqkbr3.js → azure-openai-responses-590s1eea.js} +10 -10
  11. package/dist/{boot-args-schema-66bk37wv.js → boot-args-schema-0gqmkfbe.js} +1 -1
  12. package/dist/{boot-reembed-edjpwsc1.js → boot-reembed-f064w382.js} +1 -1
  13. package/dist/{boot-reembed-y27n09tz.js → boot-reembed-n6anc01d.js} +1 -1
  14. package/dist/{boot-scrub-sweep-1xc35965.js → boot-scrub-sweep-ejd5dnrz.js} +84 -13
  15. package/dist/{boot-seeds-7hjj91qj.js → boot-seeds-f99fjs5q.js} +4 -4
  16. package/dist/{boxd-ent8ch04.js → boxd-wn235q80.js} +7 -7
  17. package/dist/claude-adapter-gvznwxgc.js +28 -0
  18. package/dist/{claude-managed-adapter-jh6c523j.js → claude-managed-adapter-pbrbvc64.js} +4 -4
  19. package/dist/{claude-managed-setup-y6z2perp.js → claude-managed-setup-kdxttvc3.js} +11 -11
  20. package/dist/{claude-sdk-session-vvya8wqk.js → claude-sdk-session-0t2teq6n.js} +9386 -9197
  21. package/dist/{cli-yjdgea32.js → cli-1jx0srjt.js} +17 -17
  22. package/dist/{cli-rmzsadkf.js → cli-1tvdx9t5.js} +2 -2
  23. package/dist/{cli-3vmb0n58.js → cli-25nstr34.js} +1 -1
  24. package/dist/{cli-959kp5h2.js → cli-2kg31ted.js} +45 -38
  25. package/dist/{cli-4vzgeta4.js → cli-2tnbc3gw.js} +375 -127
  26. package/dist/{cli-tekytdq9.js → cli-3zxdz9r7.js} +9 -9
  27. package/dist/{cli-bsywb58a.js → cli-4ghh072d.js} +16 -16
  28. package/dist/{cli-9mb2q6pb.js → cli-57pvhnyt.js} +4 -4
  29. package/dist/{cli-d84byzn8.js → cli-5a6pqy45.js} +441 -53
  30. package/dist/{cli-jrzkw01m.js → cli-5gpqgs8b.js} +2 -2
  31. package/dist/{cli-0cq8y6m7.js → cli-5gygrr67.js} +9 -9
  32. package/dist/{cli-z1w943va.js → cli-5kcmxwxv.js} +3 -3
  33. package/dist/{cli-3e875j5p.js → cli-5ntc4we6.js} +3189 -328
  34. package/dist/{cli-bst1vp7e.js → cli-5y2fvw4z.js} +13 -5
  35. package/dist/{cli-mrt48bx7.js → cli-6237rnyr.js} +1 -1
  36. package/dist/cli-6dp0jkfj.js +754 -0
  37. package/dist/{cli-b98a65ed.js → cli-7831nhaw.js} +5 -5
  38. package/dist/{cli-kjtwrhea.js → cli-7cgf614g.js} +10 -10
  39. package/dist/{cli-fwy8kfd6.js → cli-7fx9jyfs.js} +942 -63
  40. package/dist/{cli-28fq781p.js → cli-7zm3b3f5.js} +1 -1
  41. package/dist/{cli-v1dv1r37.js → cli-812paz57.js} +143 -9
  42. package/dist/{cli-837vfs2x.js → cli-8axx8vnw.js} +4 -4
  43. package/dist/cli-8x8y70av.js +103 -0
  44. package/dist/{cli-vj75tyaw.js → cli-95930z69.js} +15 -7
  45. package/dist/{cli-j24zbska.js → cli-9a2rtd77.js} +16 -14
  46. package/dist/cli-9ttx00s3.js +137 -0
  47. package/dist/{cli-6ek0hff4.js → cli-a9hfzg2r.js} +3 -3
  48. package/dist/{cli-dzpc6en0.js → cli-aa8s22gn.js} +19 -14
  49. package/dist/{cli-x1wa213s.js → cli-bk9v1xrv.js} +21 -21
  50. package/dist/{cli-a0z912j7.js → cli-c07v0qfa.js} +194 -75
  51. package/dist/{cli-1qkz151v.js → cli-c5cspahx.js} +28 -36
  52. package/dist/{cli-vdektqgf.js → cli-cw7mc1je.js} +4 -4
  53. package/dist/{cli-n6vtrcht.js → cli-dd37e0cm.js} +2 -2
  54. package/dist/cli-dqgnbnxs.js +132 -0
  55. package/dist/{cli-kc7v1nfv.js → cli-dx439zpg.js} +1 -1
  56. package/dist/{cli-q6mfk1ej.js → cli-dzzh58sy.js} +2 -2
  57. package/dist/{cli-f6bahpn5.js → cli-e9973bf0.js} +8 -6
  58. package/dist/{cli-2znm3dzj.js → cli-eds5xnsz.js} +2 -2
  59. package/dist/{cli-6rc5frdm.js → cli-eepnpee7.js} +34 -37
  60. package/dist/{cli-rvhdmjvt.js → cli-eg437b5p.js} +1 -1
  61. package/dist/cli-faf46gdq.js +714 -0
  62. package/dist/{cli-f4r3g076.js → cli-fgphc007.js} +2 -2
  63. package/dist/{cli-5y340nzn.js → cli-fnh4b12r.js} +24 -18
  64. package/dist/{cli-fsgttth8.js → cli-g0vv9dg4.js} +13 -13
  65. package/dist/{cli-e1p3n5gq.js → cli-g3zzby8t.js} +13 -13
  66. package/dist/{cli-3vjhs18n.js → cli-gabsjg8x.js} +3 -1
  67. package/dist/{cli-1pz0330a.js → cli-gddgcnav.js} +3 -3
  68. package/dist/{cli-97ae65rz.js → cli-h474mvp5.js} +11 -11
  69. package/dist/{cli-m88rpzkh.js → cli-hnamkvnc.js} +2 -2
  70. package/dist/{cli-8bpgbr8k.js → cli-j49yqpvh.js} +6 -6
  71. package/dist/{cli-w401b9tq.js → cli-jd3kxppb.js} +1 -1
  72. package/dist/{cli-m9s2qff2.js → cli-jg5txpm6.js} +187 -93
  73. package/dist/{cli-8aes17e4.js → cli-js8zrfyg.js} +3 -3
  74. package/dist/{cli-pfs8adn4.js → cli-k09cxm6m.js} +9 -7
  75. package/dist/{cli-q24n86d2.js → cli-k7pt28ad.js} +10 -3
  76. package/dist/{cli-zh9rsbqf.js → cli-kaa4bd7x.js} +11 -8
  77. package/dist/cli-kj0hyr43.js +51 -0
  78. package/dist/{cli-g70vxtjh.js → cli-kmvcm34h.js} +2 -2
  79. package/dist/{cli-t2tma8gb.js → cli-kqh27v2y.js} +2 -2
  80. package/dist/{cli-mxn1qvbn.js → cli-m1fbz2wj.js} +32 -57
  81. package/dist/{cli-2kvhc7x8.js → cli-mc1fx4xd.js} +51 -90
  82. package/dist/{cli-pchypa1s.js → cli-me4maa4j.js} +61 -6
  83. package/dist/{cli-504akrp9.js → cli-meydjstb.js} +3 -3
  84. package/dist/{cli-n30e0hcp.js → cli-mna6pmfx.js} +2 -2
  85. package/dist/cli-nhq5js1b.js +142 -0
  86. package/dist/cli-nmcpzbty.js +296 -0
  87. package/dist/cli-nr46j5pw.js +78 -0
  88. package/dist/{cli-5mrq3ake.js → cli-pn1v1pb0.js} +1 -1
  89. package/dist/{cli-f4e8r23x.js → cli-pwsax0vp.js} +11 -6
  90. package/dist/{cli-gyt3zydq.js → cli-pz1c00aa.js} +9 -754
  91. package/dist/{cli-eddnyg3t.js → cli-q2d3e1k1.js} +1 -1
  92. package/dist/{cli-fpjmegdb.js → cli-q8cfh1t9.js} +2 -2
  93. package/dist/{cli-vqva1teb.js → cli-qe909n63.js} +2 -2
  94. package/dist/{cli-2r0jcc3k.js → cli-qj39vrc6.js} +1 -1
  95. package/dist/{cli-0agcv1v5.js → cli-rqx70rcz.js} +2 -2
  96. package/dist/{cli-0jzra9ad.js → cli-rts1qvb4.js} +2 -2
  97. package/dist/{cli-3rkdne1h.js → cli-sn4pc4qx.js} +2 -2
  98. package/dist/{cli-98rwmcyc.js → cli-snxhtehz.js} +3 -3
  99. package/dist/{cli-d829z3xc.js → cli-spfz393q.js} +6 -6
  100. package/dist/{cli-6wj7p986.js → cli-spzkdgtg.js} +3 -3
  101. package/dist/{cli-m2z8jagn.js → cli-srtkr1h2.js} +18 -18
  102. package/dist/{cli-2gxeg5gr.js → cli-ssvdrk4y.js} +1 -1
  103. package/dist/{cli-jdknh18m.js → cli-svc803vq.js} +69 -816
  104. package/dist/{cli-7349va39.js → cli-t9ga4qmb.js} +935 -445
  105. package/dist/{cli-m5akxq8q.js → cli-vs9vdpy0.js} +1 -1
  106. package/dist/{cli-26ctbcdp.js → cli-vvgaz8t6.js} +93 -44
  107. package/dist/{cli-3sy2xags.js → cli-vw5x18yj.js} +39 -69
  108. package/dist/{cli-kchjb7qy.js → cli-w16kwbzw.js} +1 -1
  109. package/dist/cli-w7dxb2fj.js +921 -0
  110. package/dist/{cli-x6t50dmw.js → cli-wr1h0k28.js} +3 -3
  111. package/dist/{cli-d6521kb5.js → cli-x40a0w9j.js} +1 -1
  112. package/dist/{cli-k28wkapa.js → cli-xf1wn5ns.js} +2 -2
  113. package/dist/{cli-rh15cakt.js → cli-xwsm6xkr.js} +1 -1
  114. package/dist/{cli-rcecc3yq.js → cli-ymct0ycy.js} +321 -111
  115. package/dist/{cli-xzm9vcfg.js → cli-zg3z63x3.js} +2 -2
  116. package/dist/cli.js +29 -26
  117. package/dist/{codex-adapter-zerf5qsp.js → codex-adapter-44yq2fkn.js} +9 -9
  118. package/dist/{codex-hook-30gyhzxe.js → codex-hook-h1zb7cfk.js} +6 -6
  119. package/dist/{codex-login-bcda78ge.js → codex-login-cdyrr5y1.js} +1 -1
  120. package/dist/{codex-session-runner-89s304py.js → codex-session-runner-zbh26gbw.js} +10 -10
  121. package/dist/{commands-jeh1b51j.js → commands-54f02v5b.js} +3 -3
  122. package/dist/{controller-mctfbrse.js → controller-9gpwcdek.js} +6 -6
  123. package/dist/{controllers-connect-nxa1ddwn.js → controllers-connect-61re6k1n.js} +26 -25
  124. package/dist/{cursor-adapter-qj8vehv6.js → cursor-adapter-7e4g81vd.js} +2 -2
  125. package/dist/{db-b36qn6k3.js → db-dg2gc7fd.js} +17 -13
  126. package/dist/{db-2dvay0es.js → db-wnh0qjy1.js} +3 -3
  127. package/dist/{devin-adapter-xedz98zv.js → devin-adapter-zp4tqq53.js} +1 -1
  128. package/dist/{dispatcher-gndbta01.js → dispatcher-jrm24r43.js} +19 -18
  129. package/dist/{docker-866qpzt9.js → docker-9aq30pp2.js} +5 -5
  130. package/dist/{dsh-adapter-f75sz821.js → dsh-adapter-1yqk267c.js} +2 -2
  131. package/dist/{e2b-3gpc2n3w.js → e2b-3v1e745x.js} +6 -6
  132. package/dist/{e2b-jbm7mj93.js → e2b-sm28k0k3.js} +6 -6
  133. package/dist/{easter-egg-3d-533knw22.js → easter-egg-3d-r4h9cs9m.js} +1 -1
  134. package/dist/{embedding-space-4p05vb2x.js → embedding-space-bafjr5f7.js} +6 -6
  135. package/dist/{embeddings-m6768mgh.js → embeddings-7xmgqe0e.js} +1 -1
  136. package/dist/{event-bus-e66gh7cc.js → event-bus-xr83x566.js} +1 -1
  137. package/dist/{execute-b3mrb1mv.js → execute-d6jg5ns0.js} +1 -1
  138. package/dist/{external-channel-gjv3jne3.js → external-channel-frq1xvq2.js} +2 -2
  139. package/dist/fx-adapter-0zrkfbkd.js +19 -0
  140. package/dist/{getMachineId-bsd-nfgrzarv.js → getMachineId-bsd-637a7rbk.js} +3 -3
  141. package/dist/{getMachineId-darwin-wz886dsk.js → getMachineId-darwin-9vytrcnn.js} +3 -3
  142. package/dist/{getMachineId-linux-1nng3p1p.js → getMachineId-linux-mkzsvyyz.js} +3 -3
  143. package/dist/{getMachineId-unsupported-a0428vw9.js → getMachineId-unsupported-4cfs2n11.js} +3 -3
  144. package/dist/{getMachineId-win-h45922nq.js → getMachineId-win-154s3qma.js} +3 -3
  145. package/dist/{google-generative-ai-h7s3e9kk.js → google-generative-ai-hh7strj3.js} +1 -1
  146. package/dist/{google-vertex-fhxaafzw.js → google-vertex-fy5bw2pm.js} +5 -5
  147. package/dist/grok-adapter-3db1c538.js +19 -0
  148. package/dist/handlers-k22n8mnn.js +33 -0
  149. package/dist/{heartbeat-a1tv60gt.js → heartbeat-6bpa611t.js} +22 -21
  150. package/dist/{hook-8h5dzcgq.js → hook-hvm5nf46.js} +5 -5
  151. package/dist/{hook-cyaps9ba.js → hook-w12k146y.js} +14 -14
  152. package/dist/{http-t15mhbd9.js → http-43tthdvs.js} +5838 -2600
  153. package/dist/{index-d6wkh8ar.js → index-1f0vypbg.js} +2 -2
  154. package/dist/{index-enn321kd.js → index-42jq9yy3.js} +3 -3
  155. package/dist/{index-khe3gp0k.js → index-4b1q8kan.js} +20 -20
  156. package/dist/{index-hjhfk3ra.js → index-585gyczt.js} +1 -1
  157. package/dist/index-8xcyd3mc.js +33 -0
  158. package/dist/index-9sy2bh6n.js +38 -0
  159. package/dist/{index-2skqtd76.js → index-b24j7t2m.js} +30 -28
  160. package/dist/{index-gjwaqaq8.js → index-cret47a5.js} +6 -6
  161. package/dist/{index-qwj6ntem.js → index-e3krvkh2.js} +4 -4
  162. package/dist/{index-w1zqf680.js → index-fn054vsf.js} +1 -1
  163. package/dist/{index-qav6455f.js → index-ftywhyr0.js} +214 -152
  164. package/dist/{index-tvfafeyy.js → index-mhq4sh5w.js} +1 -1
  165. package/dist/index-tx9mc2ap.js +570 -0
  166. package/dist/index-wjd56k1v.js +34 -0
  167. package/dist/{keepalive-91s7hzrb.js → keepalive-rk0j0jvh.js} +4 -4
  168. package/dist/lead-atxf3q6e.js +72 -0
  169. package/dist/{maintenance-7pjmy5xy.js → maintenance-g6z6kaxw.js} +1 -1
  170. package/dist/{node-4c5jqxr3.js → node-7qsx5kvm.js} +1 -1
  171. package/dist/{node-252anz2h.js → node-jftbyawr.js} +4 -4
  172. package/dist/{node-ray25snp.js → node-zd6shky9.js} +3 -3
  173. package/dist/{oauth-refresh-sweep-rzqfm94j.js → oauth-refresh-sweep-2k3g2q4w.js} +3 -3
  174. package/dist/{onboard-74st7pag.js → onboard-6fdbvh3v.js} +8 -8
  175. package/dist/{openai-codex-responses-k9gapdze.js → openai-codex-responses-bkcd8pjj.js} +9 -9
  176. package/dist/{openai-responses-4d5dx3c7.js → openai-responses-gbh0wfqe.js} +13 -13
  177. package/dist/{opencode-adapter-arn7gm8q.js → opencode-adapter-fdbsvts7.js} +7 -7
  178. package/dist/{otel-impl-rnzey8cb.js → otel-impl-rvwtc09q.js} +110 -110
  179. package/dist/pending-sqkrb836.js +80 -0
  180. package/dist/{pi-mono-adapter-6mkwq64n.js → pi-mono-adapter-asqayqcg.js} +13 -13
  181. package/dist/{pricing-refresh-ha21jhk7.js → pricing-refresh-f5tkgmw2.js} +2 -2
  182. package/dist/{rbac-roles-wqhma4dr.js → rbac-roles-06s555fa.js} +3 -3
  183. package/dist/{rbac-roles-59dxachk.js → rbac-roles-szxsg8t1.js} +10 -3
  184. package/dist/{render-v2-14kpzx12.js → render-v2-103p266q.js} +4 -4
  185. package/dist/{resume-gsa5fb5f.js → resume-v7kjewt9.js} +8 -7
  186. package/dist/{runtime-1hv06jsn.js → runtime-f1gmk0b7.js} +1 -1
  187. package/dist/{session-access-skm7bnp6.js → session-access-6shev8ts.js} +4 -4
  188. package/dist/{session-source-backfill-pbqzbncv.js → session-source-backfill-bd7spzjd.js} +3 -3
  189. package/dist/{setup-5yermsem.js → setup-kmxmztdb.js} +1 -1
  190. package/dist/thread-buffer-4yz236d0.js +36 -0
  191. package/dist/{virtual-modules-gazyapte.js → virtual-modules-57eje5wy.js} +5 -5
  192. package/dist/{work-objects-xj0ck0w4.js → work-objects-zr47ygmf.js} +23 -21
  193. package/dist/{worker-follow-up-911xc0b8.js → worker-follow-up-grrr3fda.js} +19 -18
  194. package/dist/worker-p4hbtcy3.js +72 -0
  195. package/dist/{x-2fyrt5pp.js → x-wg164ss9.js} +2 -2
  196. package/openapi.json +4518 -2356
  197. package/package.json +11 -8
  198. package/plugin/commands/create-pr.md +1 -1
  199. package/plugin/pi-skills/create-pr/SKILL.md +1 -1
  200. package/src/apps/action-runner.ts +21 -1
  201. package/src/apps/catalog.generated.json +626 -17
  202. package/src/apps/page-validator.ts +314 -8
  203. package/src/assets/key.ts +6 -0
  204. package/src/be/agent-fs-user-keys.ts +186 -0
  205. package/src/be/audit-user.ts +27 -13
  206. package/src/be/automation-preflight.test.ts +14 -14
  207. package/src/be/automation-preflight.ts +24 -16
  208. package/src/be/boot-scrub-sweep.ts +143 -14
  209. package/src/be/caller-session-group.ts +86 -0
  210. package/src/be/checklist.ts +375 -0
  211. package/src/be/db/agents.ts +12 -1
  212. package/src/be/db/approvals.ts +26 -0
  213. package/src/be/db/session-moves.ts +23 -0
  214. package/src/be/db/session-tree.ts +78 -19
  215. package/src/be/db/tasks/eligibility-scan.ts +14 -0
  216. package/src/be/db/tasks/read.ts +33 -0
  217. package/src/be/db/tasks/slack-fold.ts +116 -0
  218. package/src/be/db/tasks/write.ts +34 -0
  219. package/src/be/db-queries/mcp-servers.ts +13 -0
  220. package/src/be/db-queries/oauth.ts +6 -0
  221. package/src/be/db-queries/task-artifacts.ts +10 -8
  222. package/src/be/db.ts +74 -22
  223. package/src/be/extensions/assets.ts +17 -13
  224. package/src/be/import/config.ts +54 -0
  225. package/src/be/import/dir-source.ts +372 -0
  226. package/src/be/import/index.ts +149 -0
  227. package/src/be/import/pending.ts +71 -0
  228. package/src/be/import/schema.ts +137 -0
  229. package/src/be/import/seeders.ts +462 -0
  230. package/src/be/migrations/289_automation_savings_daily.sql +47 -0
  231. package/src/be/migrations/291_task_slack_participants.sql +4 -0
  232. package/src/be/migrations/293_savings_component_links.sql +58 -0
  233. package/src/be/migrations/296_automation_savings_daily_read_index.sql +6 -0
  234. package/src/be/migrations/297_import_ownership.sql +34 -0
  235. package/src/be/migrations/301_favorites_key_type.sql +36 -0
  236. package/src/be/migrations/302_checklist_items.sql +23 -0
  237. package/src/be/model-profile-check.ts +10 -2
  238. package/src/be/multi-runtime.ts +8 -1
  239. package/src/be/rbac-roles.ts +8 -1
  240. package/src/be/runtime-pools/demand.ts +20 -2
  241. package/src/be/runtime-pools/reachability.ts +31 -0
  242. package/src/be/runtime-pools/routing.ts +8 -1
  243. package/src/be/runtime-pools/supervisor.ts +6 -7
  244. package/src/be/savings/compute.ts +511 -16
  245. package/src/be/savings/model.ts +282 -14
  246. package/src/be/savings/read.ts +1502 -0
  247. package/src/be/savings/rollup.ts +571 -0
  248. package/src/be/script-credential-broker.ts +2 -2
  249. package/src/be/scripts/run-credential.ts +15 -3
  250. package/src/be/scripts/typecheck.ts +90 -8
  251. package/src/be/seed/agent-fs-provision.ts +104 -19
  252. package/src/be/seed/index.ts +1 -1
  253. package/src/be/seed/registry.ts +27 -8
  254. package/src/be/seed/runner.ts +1 -1
  255. package/src/be/seed/schedules-seeder.ts +24 -6
  256. package/src/be/seed/seed-toggle.ts +32 -0
  257. package/src/be/seed/types.ts +6 -0
  258. package/src/be/seed-scripts/catalog/dreaming-gather.ts +2 -2
  259. package/src/be/seed-scripts/catalog/dreaming-learnings.ts +10 -2
  260. package/src/be/seed-scripts/catalog/dreaming-memtax-create.ts +70 -4
  261. package/src/be/steering.ts +27 -4
  262. package/src/be/swarm-config-guard.ts +38 -0
  263. package/src/be/task-citations.ts +8 -5
  264. package/src/be/users.ts +29 -2
  265. package/src/commands/onboard/agent-fs-version.ts +1 -1
  266. package/src/commands/runner.ts +219 -42
  267. package/src/e2b/env.ts +2 -0
  268. package/src/extensions/catalog.generated.json +17 -0
  269. package/src/extensions/contract-types.generated.ts +1 -1
  270. package/src/github/app.ts +10 -1
  271. package/src/github/handlers.ts +6 -3
  272. package/src/github/reactions.ts +12 -14
  273. package/src/heartbeat/heartbeat.ts +14 -4
  274. package/src/http/agents.ts +19 -10
  275. package/src/http/all-routes.ts +2 -0
  276. package/src/http/approval-requests.ts +24 -4
  277. package/src/http/apps.ts +69 -5
  278. package/src/http/checklist.ts +176 -0
  279. package/src/http/db-query-bounded.ts +256 -11
  280. package/src/http/db-query-shared.ts +9 -0
  281. package/src/http/favorites.ts +14 -2
  282. package/src/http/fs.ts +346 -1
  283. package/src/http/index.ts +37 -2
  284. package/src/http/kv.ts +13 -0
  285. package/src/http/mcp-oauth.ts +1 -1
  286. package/src/http/mcp-servers.ts +15 -2
  287. package/src/http/onboarding.ts +2 -9
  288. package/src/http/poll.ts +59 -1
  289. package/src/http/requested-by.ts +97 -1
  290. package/src/http/savings.ts +676 -190
  291. package/src/http/script-connections.ts +1 -0
  292. package/src/http/scripts.ts +26 -15
  293. package/src/http/sessions.ts +17 -0
  294. package/src/http/slack-events.ts +101 -0
  295. package/src/http/status.ts +25 -7
  296. package/src/http/task-requester.ts +46 -0
  297. package/src/http/tasks.ts +107 -42
  298. package/src/http/users.ts +14 -0
  299. package/src/http/webhooks.ts +15 -0
  300. package/src/integrations/cards/index.ts +151 -0
  301. package/src/integrations/chat-sdk/outbound.ts +39 -13
  302. package/src/integrations/chat-sdk/runtime.ts +7 -1
  303. package/src/integrations/chat-sdk/status.ts +17 -0
  304. package/src/integrations/chat-sdk/telegram-api.ts +6 -1
  305. package/src/kv-reserved-namespaces.ts +17 -2
  306. package/src/oauth/presets.ts +29 -2
  307. package/src/prompts/base-prompt.ts +17 -4
  308. package/src/prompts/session-templates.ts +163 -9
  309. package/src/providers/acp-targets.ts +2 -2
  310. package/src/providers/amp-adapter.ts +1 -1
  311. package/src/providers/claude-adapter.ts +0 -20
  312. package/src/providers/claude-flag-settings.ts +12 -10
  313. package/src/providers/claude-managed-adapter.ts +5 -1
  314. package/src/providers/codex-adapter.ts +10 -35
  315. package/src/providers/codex-app-server.ts +2 -11
  316. package/src/providers/opencode-adapter.ts +41 -31
  317. package/src/providers/runtime-dependencies.ts +158 -0
  318. package/src/rbac/legacy-policy.ts +2 -0
  319. package/src/rbac/permissions.ts +10 -1
  320. package/src/scheduler/scheduler.ts +20 -14
  321. package/src/scripts-runtime/credential-broker/default-bindings.ts +19 -11
  322. package/src/scripts-runtime/credential-broker/index.ts +1 -1
  323. package/src/scripts-runtime/ctx.ts +1 -1
  324. package/src/scripts-runtime/egress-secrets.ts +2 -2
  325. package/src/scripts-runtime/executors/quickjs-bundle.ts +1 -0
  326. package/src/scripts-runtime/executors/quickjs-prelude.ts +162 -2
  327. package/src/scripts-runtime/executors/quickjs-runner.ts +4 -1
  328. package/src/scripts-runtime/stdlib/fetch.ts +113 -15
  329. package/src/scripts-runtime/stdlib/index.ts +3 -1
  330. package/src/scripts-runtime/stdlib/retry.ts +174 -0
  331. package/src/scripts-runtime/swarm-sdk.ts +187 -17
  332. package/src/scripts-runtime/types/stdlib.d.ts +97 -8
  333. package/src/scripts-runtime/types/swarm-extension.d.ts +27 -1
  334. package/src/scripts-runtime/types/swarm-sdk.d.ts +71 -6
  335. package/src/server.ts +4 -4
  336. package/src/slack/actions.ts +1 -0
  337. package/src/slack/app.ts +87 -46
  338. package/src/slack/assistant.ts +35 -7
  339. package/src/slack/enrich.ts +144 -50
  340. package/src/slack/handlers.ts +43 -99
  341. package/src/slack/http-receiver.ts +284 -0
  342. package/src/slack/inbound-dispatch.ts +43 -7
  343. package/src/slack/inbound-files.ts +33 -14
  344. package/src/slack/message-text.ts +47 -4
  345. package/src/slack/render-v2.ts +2 -1
  346. package/src/slack/socket-ack.ts +17 -10
  347. package/src/slack/steering.ts +5 -0
  348. package/src/slack/templates.ts +9 -0
  349. package/src/slack/thread-buffer-store.ts +58 -0
  350. package/src/slack/thread-buffer.ts +367 -109
  351. package/src/slack/thread-participants.ts +187 -0
  352. package/src/tasks/context-key.ts +24 -0
  353. package/src/tasks/sibling-awareness.ts +13 -1
  354. package/src/tests/agent-fs-live-url.test.ts +15 -0
  355. package/src/tests/agent-fs-provision-seeder.test.ts +140 -0
  356. package/src/tests/agent-fs-user-keys.test.ts +483 -0
  357. package/src/tests/agentfs-proxy.test.ts +8 -8
  358. package/src/tests/approval-card-resolution.test.ts +396 -0
  359. package/src/tests/approval-requests-notifications.test.ts +1 -1
  360. package/src/tests/approval-respond-auth.test.ts +28 -0
  361. package/src/tests/apps-action-parent-task.test.ts +140 -0
  362. package/src/tests/apps-catalog-additions.test.ts +315 -0
  363. package/src/tests/apps-catalog-files.test.ts +114 -0
  364. package/src/tests/apps-catalog-hitl.test.ts +117 -0
  365. package/src/tests/apps-catalog-inputs.test.ts +86 -0
  366. package/src/tests/apps-catalog-table.test.ts +47 -0
  367. package/src/tests/apps-chart-shell.test.ts +1 -1
  368. package/src/tests/apps-element-assembly.test.ts +52 -3
  369. package/src/tests/apps-session-thread.test.ts +182 -0
  370. package/src/tests/asset-key-invariants.test.ts +14 -0
  371. package/src/tests/base-prompt.test.ts +108 -23
  372. package/src/tests/boot-scrub-sweep.test.ts +172 -0
  373. package/src/tests/caller-session-group.test.ts +199 -0
  374. package/src/tests/cards.test.ts +169 -0
  375. package/src/tests/chat-sdk-status-route.test.ts +16 -3
  376. package/src/tests/chat-sdk-telegram-token.test.ts +76 -0
  377. package/src/tests/chat-sdk-tools.test.ts +147 -0
  378. package/src/tests/checklist-nudge.test.ts +208 -0
  379. package/src/tests/checklist.test.ts +686 -0
  380. package/src/tests/claude-adapter-binary.test.ts +7 -1
  381. package/src/tests/claude-adapter.test.ts +10 -64
  382. package/src/tests/claude-flag-settings.test.ts +15 -11
  383. package/src/tests/claude-hook-credentials.test.ts +0 -1
  384. package/src/tests/claude-sdk-lifecycle.test.ts +5 -1
  385. package/src/tests/codex-adapter.test.ts +17 -78
  386. package/src/tests/codex-app-server.test.ts +16 -0
  387. package/src/tests/comb-config-guard.test.ts +21 -0
  388. package/src/tests/comb-default.test.ts +59 -97
  389. package/src/tests/comb-links.test.ts +86 -16
  390. package/src/tests/comb-status.test.ts +24 -27
  391. package/src/tests/create-page-tool.test.ts +101 -1
  392. package/src/tests/create-schedule-key.test.ts +105 -0
  393. package/src/tests/create-task-vcs-repo.test.ts +136 -0
  394. package/src/tests/credential-broker.test.ts +2 -2
  395. package/src/tests/db-query.test.ts +87 -1
  396. package/src/tests/db-task-read-contract.test.ts +3 -0
  397. package/src/tests/db-task-write-contract.test.ts +3 -1
  398. package/src/tests/docs-index-footprint.test.js +3 -3
  399. package/src/tests/dreaming-learnings.test.ts +104 -0
  400. package/src/tests/entrypoint-github-enterprise.test.ts +158 -0
  401. package/src/tests/extensions-assets.test.ts +7 -3
  402. package/src/tests/extensions-catalog.test.ts +1 -0
  403. package/src/tests/extensions-example-sql-admin-only.test.ts +198 -0
  404. package/src/tests/extensions-pre-task.test.ts +7 -5
  405. package/src/tests/extensions-steering.test.ts +14 -2
  406. package/src/tests/favorites-agent-fs-path.test.ts +124 -0
  407. package/src/tests/fetch-resolved-env.test.ts +115 -1
  408. package/src/tests/fixtures/import-package.ts +32 -0
  409. package/src/tests/fixtures/runner-missing-dependency.ts +129 -0
  410. package/src/tests/fs-routes.test.ts +505 -2
  411. package/src/tests/github-ghes-mock.test.ts +196 -0
  412. package/src/tests/github-host.test.ts +285 -0
  413. package/src/tests/heartbeat-supersede-resume.test.ts +73 -0
  414. package/src/tests/heartbeat.test.ts +56 -0
  415. package/src/tests/import-config.test.ts +209 -0
  416. package/src/tests/import.test.ts +464 -0
  417. package/src/tests/invites-http.test.ts +144 -1
  418. package/src/tests/kv-http.test.ts +11 -0
  419. package/src/tests/literal-matcher.test.ts +58 -0
  420. package/src/tests/mcp-oauth-manual-client.test.ts +1 -1
  421. package/src/tests/oauth-presets.test.ts +12 -0
  422. package/src/tests/opencode-adapter.test.ts +53 -6
  423. package/src/tests/pool-affinity.test.ts +50 -0
  424. package/src/tests/prompt-template-session.test.ts +69 -6
  425. package/src/tests/provider-registration.test.ts +2 -55
  426. package/src/tests/provider-runtime-dependencies.test.ts +212 -0
  427. package/src/tests/rbac-admission.test.ts +19 -0
  428. package/src/tests/rbac-charact-misc-tools.test.ts +31 -0
  429. package/src/tests/rbac-engine.test.ts +2 -0
  430. package/src/tests/rbac-roles.test.ts +2 -0
  431. package/src/tests/runner-missing-dependency.test.ts +61 -0
  432. package/src/tests/runner-requester-profile.test.ts +139 -1
  433. package/src/tests/runtime-pool-reachability.test.ts +135 -1
  434. package/src/tests/runtime-pool-routing.test.ts +52 -0
  435. package/src/tests/runtime-stale-threshold.test.ts +40 -0
  436. package/src/tests/savings-compound.test.ts +774 -0
  437. package/src/tests/savings-compute.test.ts +7 -198
  438. package/src/tests/savings-fleet-latency.test.ts +143 -0
  439. package/src/tests/savings-fleet-read.test.ts +195 -0
  440. package/src/tests/savings-fleet-scale.test.ts +222 -0
  441. package/src/tests/savings-fleet-slices.test.ts +122 -0
  442. package/src/tests/savings-model.test.ts +212 -0
  443. package/src/tests/savings-read.test.ts +408 -0
  444. package/src/tests/savings-rollup.test.ts +766 -0
  445. package/src/tests/savings-scripts.test.ts +617 -0
  446. package/src/tests/script-connections.test.ts +4 -0
  447. package/src/tests/script-executor-conformance.test.ts +481 -0
  448. package/src/tests/scripts-http.test.ts +55 -0
  449. package/src/tests/scripts-runtime-fetch.test.ts +2 -2
  450. package/src/tests/secret-rules.test.ts +124 -1
  451. package/src/tests/secret-scrub-gate.test.ts +257 -0
  452. package/src/tests/secret-scrubber.test.ts +1 -1
  453. package/src/tests/seed-registry.test.ts +142 -9
  454. package/src/tests/session-source-keys.test.ts +42 -1
  455. package/src/tests/sessions-move.test.ts +70 -0
  456. package/src/tests/sessions-tree.test.ts +98 -0
  457. package/src/tests/sessions.test.ts +69 -0
  458. package/src/tests/slack-config.test.ts +4 -18
  459. package/src/tests/slack-dm-implicit-mention.test.ts +20 -1
  460. package/src/tests/slack-http-receiver.test.ts +472 -0
  461. package/src/tests/slack-identity-resolution.test.ts +23 -0
  462. package/src/tests/slack-inbound-files.test.ts +2 -1
  463. package/src/tests/slack-inbound-logging.test.ts +64 -0
  464. package/src/tests/slack-leave-thread.test.ts +1 -1
  465. package/src/tests/slack-message-text.test.ts +104 -0
  466. package/src/tests/slack-mode-lifecycle.test.ts +6 -4
  467. package/src/tests/slack-render-v2.test.ts +48 -0
  468. package/src/tests/slack-skip-reaction.test.ts +2 -2
  469. package/src/tests/slack-steering.test.ts +22 -10
  470. package/src/tests/slack-thread-buffer-context.test.ts +1 -1
  471. package/src/tests/slack-thread-buffer-fold.test.ts +417 -0
  472. package/src/tests/slack-thread-buffer-restore.test.ts +198 -0
  473. package/src/tests/slack-thread-buffer-startup-restore.test.ts +86 -0
  474. package/src/tests/slack-thread-buffer.test.ts +34 -34
  475. package/src/tests/slack-thread-participants.test.ts +447 -0
  476. package/src/tests/slack-tool-blocks.test.ts +167 -0
  477. package/src/tests/status.test.ts +32 -6
  478. package/src/tests/steering-core.test.ts +13 -0
  479. package/src/tests/steering-enabled.test.ts +7 -1
  480. package/src/tests/steering-promotion.test.ts +24 -0
  481. package/src/tests/swarm-config-reserved-keys.test.ts +17 -0
  482. package/src/tests/system-one-hosts-ui-mirror.test.ts +67 -0
  483. package/src/tests/task-artifacts.test.ts +50 -0
  484. package/src/tests/task-session-prompts.test.ts +95 -1
  485. package/src/tests/tool-annotations.test.ts +30 -0
  486. package/src/tests/workflow-system-one-extraction.test.ts +149 -1
  487. package/src/tools/chat-post.ts +19 -4
  488. package/src/tools/chat-reply.ts +20 -4
  489. package/src/tools/create-page.ts +21 -4
  490. package/src/tools/get-swarm.ts +18 -2
  491. package/src/tools/join-swarm.ts +2 -1
  492. package/src/tools/kv/kv-write-auth.ts +17 -1
  493. package/src/tools/schedules/create-schedule.ts +22 -4
  494. package/src/tools/slack-post.ts +40 -7
  495. package/src/tools/slack-reply.ts +50 -14
  496. package/src/types.ts +74 -2
  497. package/src/utils/constants.ts +60 -138
  498. package/src/utils/github-host.ts +217 -0
  499. package/src/utils/github-pull-request.ts +8 -5
  500. package/src/utils/literal-matcher.ts +118 -0
  501. package/src/utils/mcp-server-fetcher.test.ts +89 -0
  502. package/src/utils/mcp-server-fetcher.ts +13 -5
  503. package/src/utils/request-auth-context.ts +24 -0
  504. package/src/utils/secret-rules.generated.ts +1 -1
  505. package/src/utils/secret-scrubber.ts +485 -54
  506. package/src/utils/task-attachment-links.ts +9 -12
  507. package/src/vcs/index.ts +3 -0
  508. package/src/workflows/approval-notifications.ts +188 -12
  509. package/src/workflows/executors/swarm-script.ts +23 -19
  510. package/src/workflows/executors/system-one-extraction.ts +14 -7
  511. package/src/workflows/executors/system-one-providers.ts +22 -1
  512. package/templates/community/open-prompt-showreel/PLAYBOOK.md +1 -1
  513. package/templates/community/open-prompt-showreel/skills/open-prompt-showreel/SKILL.md +1 -1
  514. package/templates/extensions/README.md +1 -0
  515. package/templates/extensions/sql-admin-only/README.md +19 -0
  516. package/templates/extensions/sql-admin-only/hooks.ts +96 -0
  517. package/templates/extensions/sql-admin-only/manifest.json +8 -0
  518. package/templates/import/manifest.schema.json +136 -0
  519. package/templates/import/sources.schema.json +44 -0
  520. package/templates/skills/agent-browser/SKILL.md +1 -1
  521. package/templates/skills/agent-browser/content.md +1 -1
  522. package/templates/skills/apps/SKILL.md +122 -12
  523. package/templates/skills/apps/content.md +122 -12
  524. package/templates/skills/asset-namespaces/content.md +2 -1
  525. package/templates/skills/chat-sdk/content.md +17 -0
  526. package/templates/skills/db-query-guidance/content.md +2 -1
  527. package/templates/skills/scheduling/content.md +27 -0
  528. package/templates/skills/slack-interaction/content.md +12 -2
  529. package/templates/skills/swarm-docs/content.md +1 -0
  530. package/templates/skills/swarm-extensions/config.json +1 -1
  531. package/templates/skills/swarm-extensions/content.md +33 -23
  532. package/templates/skills/swarm-scripts/SKILL.md +18 -4
  533. package/templates/skills/swarm-scripts/content.md +18 -4
  534. package/templates/skills/work-on-task/SKILL.md +1 -1
  535. package/templates/skills/work-on-task/content.md +1 -1
  536. package/templates/skills/workflow-iterate/content.md +4 -7
  537. package/templates/workflows/dreaming/content.md +3 -3
  538. package/dist/acp-adapter-fqzkxyra.js +0 -15
  539. package/dist/claude-adapter-stw7jdcf.js +0 -25
  540. package/dist/cli-4bd1rck6.js +0 -4
  541. package/dist/cli-dns0y538.js +0 -194
  542. package/dist/cli-g5mtmf6t.js +0 -432
  543. package/dist/cli-xf3qw745.js +0 -104
  544. package/dist/fx-adapter-rpsgb1tw.js +0 -18
  545. package/dist/grok-adapter-n2m3zjg1.js +0 -18
  546. package/dist/handlers-nv8edn19.js +0 -32
  547. package/dist/index-ksmyd6kc.js +0 -37
  548. package/dist/index-rjnrje98.js +0 -32
  549. package/dist/index-tv3413wy.js +0 -33
  550. package/dist/lead-3hmddvrm.js +0 -70
  551. package/dist/worker-qgg0m2gw.js +0 -70
  552. package/src/providers/ctx-mode-env.ts +0 -10
  553. package/src/tests/entrypoint-acp-target-binary.test.ts +0 -439
  554. package/dist/{cli-4caa1x7d.js → cli-tsa40663.js} +4 -4
  555. package/dist/{index-0rvk3vd4.js → index-bs7gw5fd.js} +3 -3
  556. package/dist/{mistral-conversations-a45tx39a.js → mistral-conversations-0c30em7t.js} +4 -4
  557. package/dist/{openai-completions-xd579js7.js → openai-completions-f3n69rep.js} +18 -18
  558. package/dist/{pi-messages-hjbv8v10.js → pi-messages-zebyt7gb.js} +5 -5
@@ -112,32 +112,46 @@ export function getAgentFsLiveUrl(): string {
112
112
  export type AgentFsLinkTarget = "dashboard" | "live";
113
113
 
114
114
  /**
115
- * The operator's `AGENT_FS_LINK_TARGET` choice (trimmed, lowercased). Null when
116
- * unset, blank, or invalid: every surface then keeps its automatic behavior.
115
+ * Where people-facing file links point. An explicit `AGENT_FS_LINK_TARGET`
116
+ * (trimmed, lowercased) wins. Unset, blank, or invalid: `dashboard` when an
117
+ * `APP_URL` / `DASHBOARD_URL` is configured (not the hosted fallback) and
118
+ * Comb is not explicitly off (`COMB_ENABLED=false`), else `live`.
117
119
  */
118
- export function readAgentFsLinkTarget(): AgentFsLinkTarget | null {
120
+ export function readAgentFsLinkTarget(): AgentFsLinkTarget {
119
121
  const raw = process.env.AGENT_FS_LINK_TARGET?.trim().toLowerCase();
120
- return raw === "dashboard" || raw === "live" ? raw : null;
122
+ if (raw === "dashboard" || raw === "live") return raw;
123
+ return getConfiguredAppUrls().length > 0 && !isCombExplicitlyOff() ? "dashboard" : "live";
121
124
  }
122
125
 
123
126
  /**
124
127
  * The base URL (no trailing slash) that a people-facing file link starts with,
125
128
  * per {@link readAgentFsLinkTarget}. `dashboard` uses `APP_URL` when one is
126
- * configured (and, for attachments, Comb is on), else the live app. Null when
127
- * no target is set: the caller keeps its current code path.
129
+ * configured and Comb is on, else the live app.
128
130
  *
129
- * The prompt surface skips the Comb check: workers do not get `COMB_ENABLED`,
130
- * and an explicit `dashboard` is the operator's choice.
131
+ * The prompt surface checks only an explicit `COMB_ENABLED=false`: a worker
132
+ * sees `COMB_ENABLED` only from a swarm_config row (RELOADABLE_ENV_KEYS in
133
+ * runner.ts) and may lack the API's agent-fs settings, so `isCombEnabled()`
134
+ * does not hold there.
131
135
  */
132
- export function resolveAgentFsLinkBase(surface: "prompt" | "attachment"): string | null {
133
- const target = readAgentFsLinkTarget();
134
- if (target === null) return null;
135
- if (target === "dashboard" && getConfiguredAppUrls().length > 0) {
136
- if (surface === "prompt" || isCombEnabled()) return getAppUrl();
136
+ export function resolveAgentFsLinkBase(surface: "prompt" | "attachment"): string {
137
+ if (readAgentFsLinkTarget() === "dashboard" && getConfiguredAppUrls().length > 0) {
138
+ if (surface === "prompt" ? !isCombExplicitlyOff() : isCombEnabled()) return getAppUrl();
137
139
  }
138
140
  return getAgentFsLiveUrl();
139
141
  }
140
142
 
143
+ /**
144
+ * The query string for a file link that starts with `base`. A live-app link
145
+ * gets `?apiUrl=<AGENT_FS_PUBLIC_URL>` when that URL is set, so a browser with
146
+ * no agent-fs key knows which agent-fs to sign in to (the agent-fs invite link
147
+ * convention). Empty for a dashboard link or with no public agent-fs URL.
148
+ */
149
+ export function agentFsFileLinkQuery(base: string): string {
150
+ if (base !== getAgentFsLiveUrl()) return "";
151
+ const publicUrl = process.env.AGENT_FS_PUBLIC_URL?.trim().replace(/\/+$/, "");
152
+ return publicUrl ? `?apiUrl=${encodeURIComponent(publicUrl)}` : "";
153
+ }
154
+
141
155
  /**
142
156
  * Optional fallback agent-fs `org_id` for attachments that store only `path`.
143
157
  * Strictly opt-in — when neither env var is set, the renderer keeps the
@@ -199,93 +213,12 @@ export function agentFsFileRoute(opts: AgentFsFileRef): string | null {
199
213
  * when that route is null; callers fall back to the raw `agent-fs:<path>`
200
214
  * display instead.
201
215
  *
202
- * Shape: ${liveHost}/file/~/<orgId>/<driveId>/<normalized-path>
216
+ * Shape: ${liveHost}/file/~/<orgId>/<driveId>/<normalized-path>[?apiUrl=<AGENT_FS_PUBLIC_URL>]
203
217
  */
204
218
  export function buildAgentFsLiveUrl(opts: AgentFsFileRef): string | null {
205
219
  const route = agentFsFileRoute(opts);
206
- return route ? `${getAgentFsLiveUrl()}/file/~/${route}` : null;
207
- }
208
-
209
- /** RFC 1918 private and 169.254/16 link-local IPv4 space, by its first two octets. */
210
- function isPrivateIpv4(a: number, b: number): boolean {
211
- return (
212
- a === 10 ||
213
- (a === 172 && b >= 16 && b <= 31) ||
214
- (a === 192 && b === 168) ||
215
- (a === 169 && b === 254)
216
- );
217
- }
218
-
219
- /**
220
- * The eight 16-bit groups of an IPv6 literal (no brackets), or null when it is
221
- * malformed. `new URL` already normalizes a host to compressed hex, so a
222
- * dotted IPv4 tail never reaches here; one is rejected rather than parsed.
223
- */
224
- function parseIpv6(addr: string): number[] | null {
225
- if (addr.includes(".")) return null;
226
- const halves = addr.split("::");
227
- if (halves.length > 2) return null;
228
- const toGroups = (part: string): number[] | null => {
229
- if (!part) return [];
230
- const groups = part
231
- .split(":")
232
- .map((g) => (/^[0-9a-f]{1,4}$/.test(g) ? Number.parseInt(g, 16) : Number.NaN));
233
- return groups.some(Number.isNaN) ? null : groups;
234
- };
235
- const head = toGroups(halves[0] ?? "");
236
- const tail = toGroups(halves[1] ?? "");
237
- if (!head || !tail) return null;
238
- if (halves.length === 1) return head.length === 8 ? head : null;
239
- const missing = 8 - head.length - tail.length;
240
- return missing < 1 ? null : [...head, ...new Array<number>(missing).fill(0), ...tail];
241
- }
242
-
243
- /**
244
- * Whether a browser can plausibly open this URL. False for the addresses only
245
- * the swarm's own network resolves: a single-label host (a docker or compose
246
- * service such as `agent-fs`), `*.internal` (Railway, Fly, GCP),
247
- * `*.svc` / `*.cluster.local` (Kubernetes), and private, link-local or
248
- * unique-local IPs, including IPv4-mapped IPv6 (`::ffff:10.0.0.5`), `::` and
249
- * multicast `ff00::/8`. Loopback counts as reachable: a localhost URL means the
250
- * API and agent-fs share a host, which only works for a browser on that same
251
- * machine (the local dev setup), and a remote operator can set `COMB_ENABLED`.
252
- * An unparseable value is not reachable.
253
- */
254
- export function isBrowserReachableUrl(value: string): boolean {
255
- let host: string;
256
- try {
257
- host = new URL(value).hostname.toLowerCase().replace(/\.$/, "");
258
- } catch {
259
- return false;
260
- }
261
- if (!host) return false;
262
- if (host === "localhost" || host.endsWith(".localhost")) return true;
263
- if (host.startsWith("[")) {
264
- const parsed = parseIpv6(host.slice(1, -1));
265
- if (!parsed) return false;
266
- const g = (i: number) => parsed[i] ?? 0;
267
- // Loopback is reachable (the local dev setup).
268
- if (parsed.slice(0, 7).every((x) => x === 0) && g(7) === 1) return true;
269
- // `::` and multicast `ff00::/8` are not addresses a browser can open.
270
- if (parsed.every((x) => x === 0) || (g(0) & 0xff00) === 0xff00) return false;
271
- // Unique-local `fc00::/7` and link-local `fe80::/10`.
272
- if ((g(0) & 0xfe00) === 0xfc00 || (g(0) & 0xffc0) === 0xfe80) return false;
273
- // IPv4-mapped `::ffff:a.b.c.d`: judge the embedded IPv4 address.
274
- if (parsed.slice(0, 5).every((x) => x === 0) && g(5) === 0xffff) {
275
- const a = g(6) >> 8;
276
- if (a === 0) return false;
277
- return a === 127 || !isPrivateIpv4(a, g(6) & 0xff);
278
- }
279
- return true;
280
- }
281
- const octets = host.match(/^(\d{1,3})\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})$/);
282
- if (octets) {
283
- const [a, b] = [Number(octets[1]), Number(octets[2])];
284
- if (a === 0) return false;
285
- return a === 127 || !isPrivateIpv4(a, b);
286
- }
287
- if (!host.includes(".")) return false;
288
- return !(host.endsWith(".internal") || host.endsWith(".svc") || host.endsWith(".cluster.local"));
220
+ const live = getAgentFsLiveUrl();
221
+ return route ? `${live}/file/~/${route}${agentFsFileLinkQuery(live)}` : null;
289
222
  }
290
223
 
291
224
  export interface CombState {
@@ -297,38 +230,40 @@ export interface CombState {
297
230
  }
298
231
 
299
232
  /**
300
- * Comb (the agent-fs review space in the dashboard). An explicit
301
- * `COMB_ENABLED` wins both ways, but still needs `AGENT_FS_API_URL`. Unset, it
302
- * is on only when a browser can reach agent-fs: `AGENT_FS_PUBLIC_URL` is set,
303
- * `AGENT_FS_PROXY` is on and the public API URL is {@link isBrowserReachableUrl}
304
- * (the browser goes through the API), or, with no proxy, `AGENT_FS_API_URL` is
305
- * itself reachable. Otherwise the browser would land on a private host.
233
+ * Comb (the agent-fs review space in the dashboard). It always needs
234
+ * `AGENT_FS_API_URL`, and an explicit `COMB_ENABLED=false` turns it off. An
235
+ * explicit `COMB_ENABLED=true` turns it on. Unset, it is on only when the
236
+ * browser has an agent-fs address: `AGENT_FS_PUBLIC_URL`, or the API's
237
+ * `/agentfs` proxy (`AGENT_FS_PROXY`, on by default with `AGENT_FS_API_URL`).
306
238
  * Reads `process.env` per call, so a config reload applies without a restart.
307
239
  */
308
240
  export function getCombState(): CombState {
309
241
  const apiUrl = process.env.AGENT_FS_API_URL?.trim().replace(/\/+$/, "");
310
- const raw = process.env.COMB_ENABLED;
311
- // The two parses agree only when the value is a recognized flag literal.
312
- const explicit = parseEnvFlag(raw, true) === parseEnvFlag(raw, false);
313
- if (explicit && !isEnvFlagEnabled("COMB_ENABLED", false)) {
242
+ const explicit = isCombFlagExplicit();
243
+ if (isCombExplicitlyOff()) {
314
244
  return { enabled: false, explicit, reason: "COMB_ENABLED is false." };
315
245
  }
316
246
  if (!apiUrl) return { enabled: false, explicit, reason: "AGENT_FS_API_URL is not set." };
317
- if (explicit) return { enabled: true, explicit, reason: null };
318
- if (process.env.AGENT_FS_PUBLIC_URL?.trim()) return { enabled: true, explicit, reason: null };
319
- // With the proxy on, the browser goes to `<public API URL>/agentfs`, so that
320
- // is the address to check, not `AGENT_FS_API_URL`.
321
- const proxy = isAgentFsProxyEnabled();
322
- const browserUrl = proxy ? getPublicMcpBaseUrl() : apiUrl;
323
- return isBrowserReachableUrl(browserUrl)
324
- ? { enabled: true, explicit, reason: null }
325
- : {
326
- enabled: false,
327
- explicit,
328
- reason: proxy
329
- ? `AGENT_FS_PROXY is on, but the API address ${browserUrl} is not reachable from a browser. Set PUBLIC_MCP_BASE_URL to the public API URL, or set COMB_ENABLED=true to force Files on.`
330
- : `AGENT_FS_API_URL (${apiUrl}) is not reachable from a browser. Set AGENT_FS_PUBLIC_URL or AGENT_FS_PROXY=true, or set COMB_ENABLED=true to force Files on.`,
331
- };
247
+ if (!explicit && !process.env.AGENT_FS_PUBLIC_URL?.trim() && !isAgentFsProxyEnabled()) {
248
+ return {
249
+ enabled: false,
250
+ explicit,
251
+ reason:
252
+ "AGENT_FS_PROXY is false and AGENT_FS_PUBLIC_URL is not set, so a browser has no agent-fs address.",
253
+ };
254
+ }
255
+ return { enabled: true, explicit, reason: null };
256
+ }
257
+
258
+ /** `COMB_ENABLED` holds a recognized flag literal (the two parses agree only then). */
259
+ function isCombFlagExplicit(): boolean {
260
+ const raw = process.env.COMB_ENABLED;
261
+ return parseEnvFlag(raw, true) === parseEnvFlag(raw, false);
262
+ }
263
+
264
+ /** `COMB_ENABLED` is an explicit false. Also readable on a worker, unlike {@link isCombEnabled}. */
265
+ export function isCombExplicitlyOff(): boolean {
266
+ return isCombFlagExplicit() && !isEnvFlagEnabled("COMB_ENABLED", false);
332
267
  }
333
268
 
334
269
  /**
@@ -342,22 +277,9 @@ export function isCombEnabled(): boolean {
342
277
  /**
343
278
  * `AGENT_FS_PROXY`: the API serves agent-fs at `/agentfs/*` (plus the public
344
279
  * `/share/*` and `/site/*` pages), and Comb uses `<public API URL>/agentfs`.
345
- * Read per request, so a config upsert applies without a restart. Off by default.
280
+ * Read per request, so a config upsert applies without a restart.
281
+ * Defaults on when `AGENT_FS_API_URL` is nonblank. An explicit flag wins.
346
282
  */
347
283
  export function isAgentFsProxyEnabled(): boolean {
348
- return isEnvFlagEnabled("AGENT_FS_PROXY", false);
349
- }
350
-
351
- /**
352
- * The dashboard (Comb) URL for an agent-fs file, same id and encoding rules as
353
- * {@link buildAgentFsLiveUrl}. Null unless Comb is on AND an explicit
354
- * `APP_URL` / `DASHBOARD_URL` is set: the hosted default dashboard cannot open
355
- * a self-hosted swarm's files.
356
- *
357
- * Shape: ${appUrl}/file/~/<orgId>/<driveId>/<normalized-path>
358
- */
359
- export function buildCombFileUrl(opts: AgentFsFileRef): string | null {
360
- if (!isCombEnabled() || getConfiguredAppUrls().length === 0) return null;
361
- const route = agentFsFileRoute(opts);
362
- return route ? `${getAppUrl()}/file/~/${route}` : null;
284
+ return isEnvFlagEnabled("AGENT_FS_PROXY", Boolean(process.env.AGENT_FS_API_URL?.trim()));
363
285
  }
@@ -0,0 +1,217 @@
1
+ /**
2
+ * GitHub host resolver: one place that owns the web, REST and GraphQL bases.
3
+ *
4
+ * `GITHUB_URL` (web base, default https://github.com) and `GITHUB_API_URL`
5
+ * (REST override) target a GitHub Enterprise Server instance. Both are
6
+ * deployment-env only (reserved in swarm-config-guard): the API base receives
7
+ * the PAT, the App JWT and installation tokens.
8
+ *
9
+ * Env is read on every call (no cache) so tests and config reloads both work.
10
+ * No DB imports: API and worker code both use this module.
11
+ */
12
+
13
+ const DEFAULT_WEB_URL = "https://github.com";
14
+ const DEFAULT_API_URL = "https://api.github.com";
15
+ /** Hosts the SQL helpers can splice into a string literal or GLOB pattern. */
16
+ const SQL_SAFE_HOST = /^[a-z0-9._:-]+$/;
17
+
18
+ export interface GitHubHostConfig {
19
+ /** Web base, no trailing slash, e.g. `https://ghe.corp`. */
20
+ webUrl: string;
21
+ /** REST base, no trailing slash, e.g. `https://ghe.corp/api/v3`. */
22
+ apiUrl: string;
23
+ graphqlUrl: string;
24
+ /** Host (with port when set) for git/gh, e.g. `ghe.corp`. */
25
+ host: string;
26
+ /** Host (with port) of the REST base, e.g. `api.github.com`. */
27
+ apiHost: string;
28
+ enterprise: boolean;
29
+ }
30
+
31
+ export type GitHubHostResult =
32
+ | { ok: true; config: GitHubHostConfig; warning?: string }
33
+ | { ok: false; error: string };
34
+
35
+ type Env = Record<string, string | undefined>;
36
+
37
+ const DEFAULT_CONFIG: GitHubHostConfig = {
38
+ webUrl: DEFAULT_WEB_URL,
39
+ apiUrl: DEFAULT_API_URL,
40
+ graphqlUrl: `${DEFAULT_API_URL}/graphql`,
41
+ host: "github.com",
42
+ apiHost: "api.github.com",
43
+ enterprise: false,
44
+ };
45
+
46
+ // Error messages never echo the raw value or its path: either can carry a token
47
+ // (`https://user:ghp_x@host`, `https://host/ghp_x`), and they reach boot logs and /status.
48
+
49
+ function parseBase(name: string, raw: string, allowPath: boolean): URL | string {
50
+ let url: URL;
51
+ try {
52
+ url = new URL(raw);
53
+ } catch {
54
+ return `${name} is not a valid URL`;
55
+ }
56
+ if (url.protocol !== "https:" && url.protocol !== "http:") {
57
+ return `${name} must use https:// (got ${url.protocol})`;
58
+ }
59
+ if (url.username || url.password) return `${name} must not contain credentials`;
60
+ if (url.search || url.hash || raw.includes("?") || raw.includes("#")) {
61
+ return `${name} must not contain a query or fragment`;
62
+ }
63
+ if (!allowPath && url.pathname !== "/") {
64
+ return `${name} must be the instance root, without a path`;
65
+ }
66
+ if (!SQL_SAFE_HOST.test(url.host)) {
67
+ // shortcut: IPv6 literals (`[::1]`) are refused because `[` is a GLOB class, upgrade by escaping if one is needed.
68
+ return `${name} host must be a DNS name or IPv4 address`;
69
+ }
70
+ return url;
71
+ }
72
+
73
+ function stripSlash(value: string): string {
74
+ return value.replace(/\/+$/, "");
75
+ }
76
+
77
+ /** Resolve and validate the GitHub host config from env. Never throws. */
78
+ export function resolveGitHubHost(env: Env = process.env): GitHubHostResult {
79
+ const rawWeb = env.GITHUB_URL?.trim() ?? "";
80
+ const rawApi = env.GITHUB_API_URL?.trim() ?? "";
81
+ const warnings: string[] = [];
82
+
83
+ let webUrl = DEFAULT_WEB_URL;
84
+ let host = "github.com";
85
+ if (rawWeb) {
86
+ const parsed = parseBase("GITHUB_URL", rawWeb, false);
87
+ if (typeof parsed === "string") return { ok: false, error: parsed };
88
+ if (parsed.protocol === "http:")
89
+ warnings.push("GITHUB_URL uses http://; tokens travel unencrypted");
90
+ // URL lowercases the host already; `origin` drops the trailing slash.
91
+ webUrl = parsed.origin;
92
+ host = parsed.host;
93
+ }
94
+
95
+ // An explicit github.com (or www.) is the default, whatever the scheme.
96
+ const enterprise = host !== "github.com" && host !== "www.github.com";
97
+ if (!enterprise) {
98
+ webUrl = DEFAULT_WEB_URL;
99
+ host = "github.com";
100
+ warnings.length = 0;
101
+ }
102
+
103
+ let apiUrl: string;
104
+ if (rawApi) {
105
+ const parsed = parseBase("GITHUB_API_URL", rawApi, true);
106
+ if (typeof parsed === "string") return { ok: false, error: parsed };
107
+ if (parsed.protocol === "http:")
108
+ warnings.push("GITHUB_API_URL uses http://; tokens travel unencrypted");
109
+ apiUrl = stripSlash(`${parsed.origin}${parsed.pathname}`);
110
+ } else if (!enterprise) {
111
+ apiUrl = DEFAULT_API_URL;
112
+ } else if (host.endsWith(".ghe.com")) {
113
+ // GHE.com data residency: the API lives on an `api.` subdomain.
114
+ apiUrl = `${webUrl.replace("://", "://api.")}`;
115
+ } else {
116
+ apiUrl = `${webUrl}/api/v3`;
117
+ }
118
+
119
+ const graphqlUrl = apiUrl.endsWith("/api/v3")
120
+ ? `${apiUrl.slice(0, -"/api/v3".length)}/api/graphql`
121
+ : `${apiUrl}/graphql`;
122
+
123
+ return {
124
+ ok: true,
125
+ config: { webUrl, apiUrl, graphqlUrl, host, apiHost: new URL(apiUrl).host, enterprise },
126
+ ...(warnings.length ? { warning: warnings.join("; ") } : {}),
127
+ };
128
+ }
129
+
130
+ /**
131
+ * The resolved config. Throws on an invalid value rather than falling back to github.com.
132
+ * For readers that pick where a token goes; parse/link readers use getGitHubLinkConfig.
133
+ */
134
+ export function getGitHubHostConfig(): GitHubHostConfig {
135
+ const result = resolveGitHubHost();
136
+ if (!result.ok) throw new Error(`Invalid GitHub host config: ${result.error}`);
137
+ return result.config;
138
+ }
139
+
140
+ /**
141
+ * The resolved config, or the github.com default when the config is invalid. Never throws.
142
+ * Only for readers that parse or link (PR extraction, SQL host match, citations, presets,
143
+ * VCS detection); never use it to pick where a token goes.
144
+ */
145
+ export function getGitHubLinkConfig(): GitHubHostConfig {
146
+ const result = resolveGitHubHost();
147
+ return result.ok ? result.config : { ...DEFAULT_CONFIG };
148
+ }
149
+
150
+ export const getGitHubWebUrl = (): string => getGitHubHostConfig().webUrl;
151
+ export const getGitHubApiUrl = (): string => getGitHubHostConfig().apiUrl;
152
+ export const getGitHubGraphqlUrl = (): string => getGitHubHostConfig().graphqlUrl;
153
+ export const getGitHubHost = (): string => getGitHubHostConfig().host;
154
+ export const isGitHubEnterprise = (): boolean => getGitHubHostConfig().enterprise;
155
+
156
+ /** `${apiBase}${path}`, path starting with `/`. */
157
+ export function githubApiUrl(path: string): string {
158
+ return `${getGitHubApiUrl()}${path}`;
159
+ }
160
+
161
+ /** `${webBase}${path}`, path starting with `/`. */
162
+ export function githubWebLink(path: string): string {
163
+ return `${getGitHubWebUrl()}${path}`;
164
+ }
165
+
166
+ /**
167
+ * The configured host (github.com on an invalid config), safe to splice into a SQL
168
+ * string literal or GLOB pattern: resolveGitHubHost refuses any other host shape. Never throws.
169
+ */
170
+ export function getGitHubHostForSql(): string {
171
+ const host = getGitHubLinkConfig().host;
172
+ return SQL_SAFE_HOST.test(host) ? host : DEFAULT_CONFIG.host;
173
+ }
174
+
175
+ /**
176
+ * On GHES, gh sends GITHUB_TOKEN / GH_TOKEN to github.com. Move the PAT to
177
+ * GH_ENTERPRISE_TOKEN (GHES hosts only) and drop the github.com variables, so a
178
+ * harness session never carries the GHES PAT where gh would send it to github.com.
179
+ * Mirrors the GHES branch of docker-entrypoint.sh. No-op on github.com or an invalid config.
180
+ */
181
+ export function scopeGitHubTokenToEnterprise(env: Env): void {
182
+ const host = resolveGitHubHost(env);
183
+ if (!host.ok || !host.config.enterprise) return;
184
+ const token = env.GITHUB_TOKEN || env.GH_TOKEN;
185
+ if (token) env.GH_ENTERPRISE_TOKEN = token;
186
+ delete env.GITHUB_TOKEN;
187
+ delete env.GH_TOKEN;
188
+ }
189
+
190
+ /**
191
+ * Host of a URL (https://, git://, ssh:// or scp-like `git@host:owner/repo`),
192
+ * lowercased, or null.
193
+ */
194
+ function urlHost(url: string): string | null {
195
+ const scp = url.match(/^[\w.-]+@([^:/]+):(?!\/)/);
196
+ if (scp) return scp[1]!.toLowerCase();
197
+ try {
198
+ const parsed = new URL(/^[a-z][a-z0-9+.-]*:\/\//i.test(url) ? url : `https://${url}`);
199
+ return parsed.host.toLowerCase();
200
+ } catch {
201
+ return null;
202
+ }
203
+ }
204
+
205
+ /**
206
+ * True when `url` points at the configured GitHub host (plus www.github.com in default mode).
207
+ * Parse-only: github.com rules on an invalid config. Never throws.
208
+ */
209
+ export function isGitHubUrl(url: string): boolean {
210
+ const host = urlHost(url.trim());
211
+ if (!host) return false;
212
+ const config = getGitHubLinkConfig();
213
+ if (host === config.host) return true;
214
+ // scp-like and ssh URLs never carry the web port.
215
+ if (host === new URL(config.webUrl).hostname) return true;
216
+ return !config.enterprise && host === "www.github.com";
217
+ }
@@ -1,3 +1,5 @@
1
+ import { getGitHubLinkConfig } from "./github-host";
2
+
1
3
  export interface GitHubPullRequestUrl {
2
4
  url: string;
3
5
  owner: string;
@@ -12,10 +14,11 @@ const GITHUB_PATH_SEGMENT_RE = /^[\w.-]+$/;
12
14
  function parseGitHubPullRequestToken(token: string): GitHubPullRequestUrl | null {
13
15
  const candidate = token.replace(TRAILING_PROSE_PUNCTUATION_RE, "");
14
16
  const lowerCandidate = candidate.toLowerCase();
17
+ const { host, webUrl } = getGitHubLinkConfig();
15
18
  if (
16
- !lowerCandidate.startsWith("https://github.com/") &&
17
- !lowerCandidate.startsWith("http://github.com/") &&
18
- !lowerCandidate.startsWith("github.com/")
19
+ !lowerCandidate.startsWith(`https://${host}/`) &&
20
+ !lowerCandidate.startsWith(`http://${host}/`) &&
21
+ !lowerCandidate.startsWith(`${host}/`)
19
22
  ) {
20
23
  return null;
21
24
  }
@@ -28,7 +31,7 @@ function parseGitHubPullRequestToken(token: string): GitHubPullRequestUrl | null
28
31
  return null;
29
32
  }
30
33
  if (
31
- parsed.host.toLowerCase() !== "github.com" ||
34
+ parsed.host.toLowerCase() !== host ||
32
35
  parsed.username.length > 0 ||
33
36
  parsed.password.length > 0
34
37
  ) {
@@ -49,7 +52,7 @@ function parseGitHubPullRequestToken(token: string): GitHubPullRequestUrl | null
49
52
  }
50
53
 
51
54
  return {
52
- url: `https://github.com/${owner}/${repo}/pull/${numberText}`,
55
+ url: `${webUrl}/${owner}/${repo}/pull/${numberText}`,
53
56
  owner,
54
57
  repo,
55
58
  number: Number(numberText),
@@ -0,0 +1,118 @@
1
+ /**
2
+ * Aho-Corasick search for a fixed set of ASCII literals, in one pass over the
3
+ * text. A regex alternation of a few hundred literals costs about 30 ns per
4
+ * character in JSC; this automaton costs a few ns.
5
+ *
6
+ * Matching is ASCII case-insensitive and exact otherwise: a character outside
7
+ * ASCII matches no pattern, which is what a `/i` regex does for ASCII
8
+ * patterns. With `skip`, those characters are ignored in the text (a text
9
+ * `to-ken` then matches `token`), so a hit is a superset of the exact match.
10
+ */
11
+ export interface LiteralMatcherOptions {
12
+ /** Text characters to ignore. A pattern must not contain one. */
13
+ skip?: string;
14
+ }
15
+
16
+ export class LiteralMatcher {
17
+ readonly classes = new Uint8Array(128);
18
+ readonly width: number;
19
+ readonly next: Int32Array;
20
+ /** Pattern ids ending at a state, fail links included. */
21
+ readonly outputs: Array<number[] | undefined>;
22
+ readonly skipped = new Uint8Array(128);
23
+ readonly hasOutput: Uint8Array;
24
+
25
+ constructor(patterns: readonly string[], opts: LiteralMatcherOptions = {}) {
26
+ for (const ch of opts.skip ?? "") this.skipped[ch.charCodeAt(0)] = 1;
27
+ // Class 0 is "any other character"; each distinct pattern character gets one.
28
+ let classCount = 1;
29
+ const fold = (code: number) => (code >= 65 && code <= 90 ? code + 32 : code);
30
+ for (const pattern of patterns) {
31
+ for (let i = 0; i < pattern.length; i++) {
32
+ const code = fold(pattern.charCodeAt(i));
33
+ if (code >= 128 || this.skipped[code]) throw new Error(`unsupported pattern: ${pattern}`);
34
+ if (this.classes[code] === 0) this.classes[code] = classCount++;
35
+ }
36
+ }
37
+ for (let code = 65; code <= 90; code++) this.classes[code] = this.classes[code + 32] as number;
38
+ this.width = classCount;
39
+
40
+ // Trie, then failure links breadth-first, then a dense transition table.
41
+ const children: Array<Map<number, number>> = [new Map()];
42
+ const outputs: Array<number[] | undefined> = [undefined];
43
+ patterns.forEach((pattern, id) => {
44
+ let state = 0;
45
+ for (let i = 0; i < pattern.length; i++) {
46
+ const cls = this.classes[pattern.charCodeAt(i)] as number;
47
+ let child = children[state]?.get(cls);
48
+ if (child === undefined) {
49
+ child = children.length;
50
+ children.push(new Map());
51
+ outputs.push(undefined);
52
+ children[state]?.set(cls, child);
53
+ }
54
+ state = child;
55
+ }
56
+ outputs[state] = [...(outputs[state] ?? []), id];
57
+ });
58
+ const next = new Int32Array(children.length * classCount);
59
+ const fail = new Int32Array(children.length);
60
+ const queue: number[] = [];
61
+ for (const [cls, child] of children[0] ?? []) {
62
+ next[cls] = child;
63
+ queue.push(child);
64
+ }
65
+ for (let head = 0; head < queue.length; head++) {
66
+ const state = queue[head] as number;
67
+ const failState = fail[state] as number;
68
+ const inherited = outputs[failState];
69
+ if (inherited) outputs[state] = [...(outputs[state] ?? []), ...inherited];
70
+ for (let cls = 0; cls < classCount; cls++) {
71
+ const child = children[state]?.get(cls);
72
+ if (child === undefined) {
73
+ next[state * classCount + cls] = next[failState * classCount + cls] as number;
74
+ } else {
75
+ fail[child] = next[failState * classCount + cls] as number;
76
+ next[state * classCount + cls] = child;
77
+ queue.push(child);
78
+ }
79
+ }
80
+ }
81
+ this.next = next;
82
+ this.outputs = outputs;
83
+ this.hasOutput = Uint8Array.from(outputs, (out) => (out ? 1 : 0));
84
+ }
85
+
86
+ /** True when any pattern occurs in `text`. Stops at the first. */
87
+ has(text: string): boolean {
88
+ const { classes, skipped, next, hasOutput, width } = this;
89
+ let state = 0;
90
+ for (let i = 0; i < text.length; i++) {
91
+ const code = text.charCodeAt(i);
92
+ if (code >= 128) {
93
+ state = 0;
94
+ continue;
95
+ }
96
+ if (skipped[code]) continue;
97
+ state = next[state * width + (classes[code] as number)] as number;
98
+ if (hasOutput[state]) return true;
99
+ }
100
+ return false;
101
+ }
102
+
103
+ /** Sets `found[id] = 1` for every pattern that occurs in `text`. */
104
+ collect(text: string, found: Uint8Array): void {
105
+ const { classes, skipped, next, hasOutput, outputs, width } = this;
106
+ let state = 0;
107
+ for (let i = 0; i < text.length; i++) {
108
+ const code = text.charCodeAt(i);
109
+ if (code >= 128) {
110
+ state = 0;
111
+ continue;
112
+ }
113
+ if (skipped[code]) continue;
114
+ state = next[state * width + (classes[code] as number)] as number;
115
+ if (hasOutput[state]) for (const id of outputs[state] as number[]) found[id] = 1;
116
+ }
117
+ }
118
+ }