@staticn0va/wigolo 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (982) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +195 -73
  3. package/SKILL.md +382 -0
  4. package/assets/blocks/claude-code/CLAUDE.md.block +20 -0
  5. package/assets/blocks/claude-code/wigolo-command.md +40 -0
  6. package/assets/blocks/cursor/wigolo.mdc +46 -0
  7. package/assets/blocks/gemini-cli/GEMINI.md.block +18 -0
  8. package/assets/blocks/vscode/copilot-instructions.md.block +18 -0
  9. package/assets/skills/wigolo/SKILL.md +50 -0
  10. package/assets/skills/wigolo/rules/cache-first.md +30 -0
  11. package/assets/skills/wigolo/rules/synthesis.md +43 -0
  12. package/assets/skills/wigolo-agent/SKILL.md +73 -0
  13. package/assets/skills/wigolo-crawl/SKILL.md +60 -0
  14. package/assets/skills/wigolo-extract/SKILL.md +59 -0
  15. package/assets/skills/wigolo-fetch/SKILL.md +65 -0
  16. package/assets/skills/wigolo-find-similar/SKILL.md +72 -0
  17. package/assets/skills/wigolo-research/SKILL.md +77 -0
  18. package/assets/skills/wigolo-search/SKILL.md +78 -0
  19. package/dist/agent/executor.d.ts +33 -0
  20. package/dist/agent/executor.d.ts.map +1 -0
  21. package/dist/agent/executor.js +233 -0
  22. package/dist/agent/executor.js.map +1 -0
  23. package/dist/agent/pipeline.d.ts +5 -0
  24. package/dist/agent/pipeline.d.ts.map +1 -0
  25. package/dist/agent/pipeline.js +208 -0
  26. package/dist/agent/pipeline.js.map +1 -0
  27. package/dist/agent/planner.d.ts +13 -0
  28. package/dist/agent/planner.d.ts.map +1 -0
  29. package/dist/agent/planner.js +271 -0
  30. package/dist/agent/planner.js.map +1 -0
  31. package/dist/agent/relevance.d.ts +15 -0
  32. package/dist/agent/relevance.d.ts.map +1 -0
  33. package/dist/agent/relevance.js +60 -0
  34. package/dist/agent/relevance.js.map +1 -0
  35. package/dist/cache/backfill-embeddings.d.ts +23 -0
  36. package/dist/cache/backfill-embeddings.d.ts.map +1 -0
  37. package/dist/cache/backfill-embeddings.js +105 -0
  38. package/dist/cache/backfill-embeddings.js.map +1 -0
  39. package/dist/cache/change-detector.d.ts +7 -0
  40. package/dist/cache/change-detector.d.ts.map +1 -0
  41. package/dist/cache/change-detector.js +43 -0
  42. package/dist/cache/change-detector.js.map +1 -0
  43. package/dist/cache/db.d.ts +1 -0
  44. package/dist/cache/db.d.ts.map +1 -1
  45. package/dist/cache/db.js +94 -22
  46. package/dist/cache/db.js.map +1 -1
  47. package/dist/cache/diff-summary.d.ts +2 -0
  48. package/dist/cache/diff-summary.d.ts.map +1 -0
  49. package/dist/cache/diff-summary.js +82 -0
  50. package/dist/cache/diff-summary.js.map +1 -0
  51. package/dist/cache/migrations/runner.d.ts +29 -0
  52. package/dist/cache/migrations/runner.d.ts.map +1 -0
  53. package/dist/cache/migrations/runner.js +147 -0
  54. package/dist/cache/migrations/runner.js.map +1 -0
  55. package/dist/cache/sqlite-vec-store.d.ts +42 -0
  56. package/dist/cache/sqlite-vec-store.d.ts.map +1 -0
  57. package/dist/cache/sqlite-vec-store.js +176 -0
  58. package/dist/cache/sqlite-vec-store.js.map +1 -0
  59. package/dist/cache/store.d.ts +46 -1
  60. package/dist/cache/store.d.ts.map +1 -1
  61. package/dist/cache/store.js +362 -168
  62. package/dist/cache/store.js.map +1 -1
  63. package/dist/cli/agents/antigravity.d.ts +20 -0
  64. package/dist/cli/agents/antigravity.d.ts.map +1 -0
  65. package/dist/cli/agents/antigravity.js +49 -0
  66. package/dist/cli/agents/antigravity.js.map +1 -0
  67. package/dist/cli/agents/claude-code.d.ts +25 -0
  68. package/dist/cli/agents/claude-code.d.ts.map +1 -0
  69. package/dist/cli/agents/claude-code.js +111 -0
  70. package/dist/cli/agents/claude-code.js.map +1 -0
  71. package/dist/cli/agents/cursor.d.ts +21 -0
  72. package/dist/cli/agents/cursor.d.ts.map +1 -0
  73. package/dist/cli/agents/cursor.js +58 -0
  74. package/dist/cli/agents/cursor.js.map +1 -0
  75. package/dist/cli/agents/gemini-cli.d.ts +21 -0
  76. package/dist/cli/agents/gemini-cli.d.ts.map +1 -0
  77. package/dist/cli/agents/gemini-cli.js +55 -0
  78. package/dist/cli/agents/gemini-cli.js.map +1 -0
  79. package/dist/cli/agents/registry.d.ts +21 -0
  80. package/dist/cli/agents/registry.d.ts.map +1 -0
  81. package/dist/cli/agents/registry.js +27 -0
  82. package/dist/cli/agents/registry.js.map +1 -0
  83. package/dist/cli/agents/utils.d.ts +26 -0
  84. package/dist/cli/agents/utils.d.ts.map +1 -0
  85. package/dist/cli/agents/utils.js +136 -0
  86. package/dist/cli/agents/utils.js.map +1 -0
  87. package/dist/cli/agents/vscode.d.ts +21 -0
  88. package/dist/cli/agents/vscode.d.ts.map +1 -0
  89. package/dist/cli/agents/vscode.js +62 -0
  90. package/dist/cli/agents/vscode.js.map +1 -0
  91. package/dist/cli/auth.d.ts +2 -0
  92. package/dist/cli/auth.d.ts.map +1 -0
  93. package/dist/cli/auth.js +94 -0
  94. package/dist/cli/auth.js.map +1 -0
  95. package/dist/cli/backfill.d.ts +2 -0
  96. package/dist/cli/backfill.d.ts.map +1 -0
  97. package/dist/cli/backfill.js +58 -0
  98. package/dist/cli/backfill.js.map +1 -0
  99. package/dist/cli/daemon.d.ts +6 -1
  100. package/dist/cli/daemon.d.ts.map +1 -1
  101. package/dist/cli/daemon.js +61 -3
  102. package/dist/cli/daemon.js.map +1 -1
  103. package/dist/cli/doctor.d.ts +8 -0
  104. package/dist/cli/doctor.d.ts.map +1 -0
  105. package/dist/cli/doctor.js +318 -0
  106. package/dist/cli/doctor.js.map +1 -0
  107. package/dist/cli/health.d.ts +1 -1
  108. package/dist/cli/health.d.ts.map +1 -1
  109. package/dist/cli/health.js +42 -3
  110. package/dist/cli/health.js.map +1 -1
  111. package/dist/cli/help.d.ts +6 -0
  112. package/dist/cli/help.d.ts.map +1 -0
  113. package/dist/cli/help.js +63 -0
  114. package/dist/cli/help.js.map +1 -0
  115. package/dist/cli/index.d.ts +1 -1
  116. package/dist/cli/index.d.ts.map +1 -1
  117. package/dist/cli/index.js +35 -7
  118. package/dist/cli/index.js.map +1 -1
  119. package/dist/cli/init.d.ts +2 -0
  120. package/dist/cli/init.d.ts.map +1 -0
  121. package/dist/cli/init.js +201 -0
  122. package/dist/cli/init.js.map +1 -0
  123. package/dist/cli/plugin.d.ts +5 -0
  124. package/dist/cli/plugin.d.ts.map +1 -0
  125. package/dist/cli/plugin.js +185 -0
  126. package/dist/cli/plugin.js.map +1 -0
  127. package/dist/cli/setup-mcp.d.ts +2 -0
  128. package/dist/cli/setup-mcp.d.ts.map +1 -0
  129. package/dist/cli/setup-mcp.js +114 -0
  130. package/dist/cli/setup-mcp.js.map +1 -0
  131. package/dist/cli/shell.d.ts +2 -0
  132. package/dist/cli/shell.d.ts.map +1 -0
  133. package/dist/cli/shell.js +86 -0
  134. package/dist/cli/shell.js.map +1 -0
  135. package/dist/cli/status.d.ts +2 -0
  136. package/dist/cli/status.d.ts.map +1 -0
  137. package/dist/cli/status.js +31 -0
  138. package/dist/cli/status.js.map +1 -0
  139. package/dist/cli/telemetry.d.ts +10 -0
  140. package/dist/cli/telemetry.d.ts.map +1 -0
  141. package/dist/cli/telemetry.js +56 -0
  142. package/dist/cli/telemetry.js.map +1 -0
  143. package/dist/cli/tui/agents-types.d.ts +28 -0
  144. package/dist/cli/tui/agents-types.d.ts.map +1 -0
  145. package/dist/cli/tui/agents-types.js +1 -0
  146. package/dist/cli/tui/agents-types.js.map +1 -0
  147. package/dist/cli/tui/agents.d.ts +11 -0
  148. package/dist/cli/tui/agents.d.ts.map +1 -0
  149. package/dist/cli/tui/agents.js +93 -0
  150. package/dist/cli/tui/agents.js.map +1 -0
  151. package/dist/cli/tui/banner.d.ts +3 -0
  152. package/dist/cli/tui/banner.d.ts.map +1 -0
  153. package/dist/cli/tui/banner.js +30 -0
  154. package/dist/cli/tui/banner.js.map +1 -0
  155. package/dist/cli/tui/components/AgentSelect.d.ts +13 -0
  156. package/dist/cli/tui/components/AgentSelect.d.ts.map +1 -0
  157. package/dist/cli/tui/components/AgentSelect.js +116 -0
  158. package/dist/cli/tui/components/AgentSelect.js.map +1 -0
  159. package/dist/cli/tui/components/Banner.d.ts +6 -0
  160. package/dist/cli/tui/components/Banner.d.ts.map +1 -0
  161. package/dist/cli/tui/components/Banner.js +25 -0
  162. package/dist/cli/tui/components/Banner.js.map +1 -0
  163. package/dist/cli/tui/components/BrowserSelect.d.ts +7 -0
  164. package/dist/cli/tui/components/BrowserSelect.d.ts.map +1 -0
  165. package/dist/cli/tui/components/BrowserSelect.js +19 -0
  166. package/dist/cli/tui/components/BrowserSelect.js.map +1 -0
  167. package/dist/cli/tui/components/InstallProgress.d.ts +9 -0
  168. package/dist/cli/tui/components/InstallProgress.d.ts.map +1 -0
  169. package/dist/cli/tui/components/InstallProgress.js +67 -0
  170. package/dist/cli/tui/components/InstallProgress.js.map +1 -0
  171. package/dist/cli/tui/components/SkillInstall.d.ts +14 -0
  172. package/dist/cli/tui/components/SkillInstall.d.ts.map +1 -0
  173. package/dist/cli/tui/components/SkillInstall.js +94 -0
  174. package/dist/cli/tui/components/SkillInstall.js.map +1 -0
  175. package/dist/cli/tui/components/Summary.d.ts +22 -0
  176. package/dist/cli/tui/components/Summary.d.ts.map +1 -0
  177. package/dist/cli/tui/components/Summary.js +135 -0
  178. package/dist/cli/tui/components/Summary.js.map +1 -0
  179. package/dist/cli/tui/components/SystemCheck.d.ts +8 -0
  180. package/dist/cli/tui/components/SystemCheck.d.ts.map +1 -0
  181. package/dist/cli/tui/components/SystemCheck.js +71 -0
  182. package/dist/cli/tui/components/SystemCheck.js.map +1 -0
  183. package/dist/cli/tui/components/Verification.d.ts +8 -0
  184. package/dist/cli/tui/components/Verification.d.ts.map +1 -0
  185. package/dist/cli/tui/components/Verification.js +63 -0
  186. package/dist/cli/tui/components/Verification.js.map +1 -0
  187. package/dist/cli/tui/config-writer-cli.d.ts +12 -0
  188. package/dist/cli/tui/config-writer-cli.d.ts.map +1 -0
  189. package/dist/cli/tui/config-writer-cli.js +39 -0
  190. package/dist/cli/tui/config-writer-cli.js.map +1 -0
  191. package/dist/cli/tui/config-writer-json.d.ts +16 -0
  192. package/dist/cli/tui/config-writer-json.d.ts.map +1 -0
  193. package/dist/cli/tui/config-writer-json.js +86 -0
  194. package/dist/cli/tui/config-writer-json.js.map +1 -0
  195. package/dist/cli/tui/config-writer-toml.d.ts +16 -0
  196. package/dist/cli/tui/config-writer-toml.d.ts.map +1 -0
  197. package/dist/cli/tui/config-writer-toml.js +83 -0
  198. package/dist/cli/tui/config-writer-toml.js.map +1 -0
  199. package/dist/cli/tui/config-writer.d.ts +25 -0
  200. package/dist/cli/tui/config-writer.d.ts.map +1 -0
  201. package/dist/cli/tui/config-writer.js +101 -0
  202. package/dist/cli/tui/config-writer.js.map +1 -0
  203. package/dist/cli/tui/detect-helpers.d.ts +6 -0
  204. package/dist/cli/tui/detect-helpers.d.ts.map +1 -0
  205. package/dist/cli/tui/detect-helpers.js +45 -0
  206. package/dist/cli/tui/detect-helpers.js.map +1 -0
  207. package/dist/cli/tui/extras-prompt.d.ts +7 -0
  208. package/dist/cli/tui/extras-prompt.d.ts.map +1 -0
  209. package/dist/cli/tui/extras-prompt.js +42 -0
  210. package/dist/cli/tui/extras-prompt.js.map +1 -0
  211. package/dist/cli/tui/flags-types.d.ts +19 -0
  212. package/dist/cli/tui/flags-types.d.ts.map +1 -0
  213. package/dist/cli/tui/flags-types.js +23 -0
  214. package/dist/cli/tui/flags-types.js.map +1 -0
  215. package/dist/cli/tui/flags.d.ts +5 -0
  216. package/dist/cli/tui/flags.d.ts.map +1 -0
  217. package/dist/cli/tui/flags.js +132 -0
  218. package/dist/cli/tui/flags.js.map +1 -0
  219. package/dist/cli/tui/format.d.ts +14 -0
  220. package/dist/cli/tui/format.d.ts.map +1 -0
  221. package/dist/cli/tui/format.js +37 -0
  222. package/dist/cli/tui/format.js.map +1 -0
  223. package/dist/cli/tui/hooks/useAgentDetect.d.ts +6 -0
  224. package/dist/cli/tui/hooks/useAgentDetect.d.ts.map +1 -0
  225. package/dist/cli/tui/hooks/useAgentDetect.js +19 -0
  226. package/dist/cli/tui/hooks/useAgentDetect.js.map +1 -0
  227. package/dist/cli/tui/hooks/useInstall.d.ts +14 -0
  228. package/dist/cli/tui/hooks/useInstall.d.ts.map +1 -0
  229. package/dist/cli/tui/hooks/useInstall.js +90 -0
  230. package/dist/cli/tui/hooks/useInstall.js.map +1 -0
  231. package/dist/cli/tui/hooks/useSystemCheck.d.ts +13 -0
  232. package/dist/cli/tui/hooks/useSystemCheck.d.ts.map +1 -0
  233. package/dist/cli/tui/hooks/useSystemCheck.js +95 -0
  234. package/dist/cli/tui/hooks/useSystemCheck.js.map +1 -0
  235. package/dist/cli/tui/hooks/useVerify.d.ts +14 -0
  236. package/dist/cli/tui/hooks/useVerify.d.ts.map +1 -0
  237. package/dist/cli/tui/hooks/useVerify.js +71 -0
  238. package/dist/cli/tui/hooks/useVerify.js.map +1 -0
  239. package/dist/cli/tui/ink-init.d.ts +2 -0
  240. package/dist/cli/tui/ink-init.d.ts.map +1 -0
  241. package/dist/cli/tui/ink-init.js +198 -0
  242. package/dist/cli/tui/ink-init.js.map +1 -0
  243. package/dist/cli/tui/reporter-auto.d.ts +7 -0
  244. package/dist/cli/tui/reporter-auto.d.ts.map +1 -0
  245. package/dist/cli/tui/reporter-auto.js +15 -0
  246. package/dist/cli/tui/reporter-auto.js.map +1 -0
  247. package/dist/cli/tui/reporter.d.ts +26 -0
  248. package/dist/cli/tui/reporter.d.ts.map +1 -0
  249. package/dist/cli/tui/reporter.js +32 -0
  250. package/dist/cli/tui/reporter.js.map +1 -0
  251. package/dist/cli/tui/run-command.d.ts +14 -0
  252. package/dist/cli/tui/run-command.d.ts.map +1 -0
  253. package/dist/cli/tui/run-command.js +72 -0
  254. package/dist/cli/tui/run-command.js.map +1 -0
  255. package/dist/cli/tui/select-agents.d.ts +6 -0
  256. package/dist/cli/tui/select-agents.d.ts.map +1 -0
  257. package/dist/cli/tui/select-agents.js +32 -0
  258. package/dist/cli/tui/select-agents.js.map +1 -0
  259. package/dist/cli/tui/status-agents.d.ts +11 -0
  260. package/dist/cli/tui/status-agents.d.ts.map +1 -0
  261. package/dist/cli/tui/status-agents.js +53 -0
  262. package/dist/cli/tui/status-agents.js.map +1 -0
  263. package/dist/cli/tui/status-cache.d.ts +6 -0
  264. package/dist/cli/tui/status-cache.d.ts.map +1 -0
  265. package/dist/cli/tui/status-cache.js +39 -0
  266. package/dist/cli/tui/status-cache.js.map +1 -0
  267. package/dist/cli/tui/status-format.d.ts +14 -0
  268. package/dist/cli/tui/status-format.d.ts.map +1 -0
  269. package/dist/cli/tui/status-format.js +41 -0
  270. package/dist/cli/tui/status-format.js.map +1 -0
  271. package/dist/cli/tui/status-python.d.ts +6 -0
  272. package/dist/cli/tui/status-python.d.ts.map +1 -0
  273. package/dist/cli/tui/status-python.js +30 -0
  274. package/dist/cli/tui/status-python.js.map +1 -0
  275. package/dist/cli/tui/system-check.d.ts +24 -0
  276. package/dist/cli/tui/system-check.d.ts.map +1 -0
  277. package/dist/cli/tui/system-check.js +103 -0
  278. package/dist/cli/tui/system-check.js.map +1 -0
  279. package/dist/cli/tui/tui-reporter.d.ts +19 -0
  280. package/dist/cli/tui/tui-reporter.d.ts.map +1 -0
  281. package/dist/cli/tui/tui-reporter.js +95 -0
  282. package/dist/cli/tui/tui-reporter.js.map +1 -0
  283. package/dist/cli/tui/utils/config-writer.d.ts +3 -0
  284. package/dist/cli/tui/utils/config-writer.d.ts.map +1 -0
  285. package/dist/cli/tui/utils/config-writer.js +22 -0
  286. package/dist/cli/tui/utils/config-writer.js.map +1 -0
  287. package/dist/cli/tui/utils/suppress-logs.d.ts +3 -0
  288. package/dist/cli/tui/utils/suppress-logs.d.ts.map +1 -0
  289. package/dist/cli/tui/utils/suppress-logs.js +11 -0
  290. package/dist/cli/tui/utils/suppress-logs.js.map +1 -0
  291. package/dist/cli/tui/verify-suggestions.d.ts +5 -0
  292. package/dist/cli/tui/verify-suggestions.d.ts.map +1 -0
  293. package/dist/cli/tui/verify-suggestions.js +20 -0
  294. package/dist/cli/tui/verify-suggestions.js.map +1 -0
  295. package/dist/cli/tui/verify.d.ts +14 -0
  296. package/dist/cli/tui/verify.d.ts.map +1 -0
  297. package/dist/cli/tui/verify.js +101 -0
  298. package/dist/cli/tui/verify.js.map +1 -0
  299. package/dist/cli/tui/version.d.ts +2 -0
  300. package/dist/cli/tui/version.d.ts.map +1 -0
  301. package/dist/cli/tui/version.js +14 -0
  302. package/dist/cli/tui/version.js.map +1 -0
  303. package/dist/cli/uninstall.d.ts +2 -0
  304. package/dist/cli/uninstall.d.ts.map +1 -0
  305. package/dist/cli/uninstall.js +57 -0
  306. package/dist/cli/uninstall.js.map +1 -0
  307. package/dist/cli/warmup.d.ts +10 -2
  308. package/dist/cli/warmup.d.ts.map +1 -1
  309. package/dist/cli/warmup.js +226 -93
  310. package/dist/cli/warmup.js.map +1 -1
  311. package/dist/config.d.ts +28 -2
  312. package/dist/config.d.ts.map +1 -1
  313. package/dist/config.js +106 -56
  314. package/dist/config.js.map +1 -1
  315. package/dist/crawl/crawler.d.ts +6 -0
  316. package/dist/crawl/crawler.d.ts.map +1 -1
  317. package/dist/crawl/crawler.js +210 -209
  318. package/dist/crawl/crawler.js.map +1 -1
  319. package/dist/crawl/dedup.d.ts +1 -0
  320. package/dist/crawl/dedup.d.ts.map +1 -1
  321. package/dist/crawl/dedup.js +124 -81
  322. package/dist/crawl/dedup.js.map +1 -1
  323. package/dist/crawl/etag-incremental.d.ts +43 -0
  324. package/dist/crawl/etag-incremental.d.ts.map +1 -0
  325. package/dist/crawl/etag-incremental.js +94 -0
  326. package/dist/crawl/etag-incremental.js.map +1 -0
  327. package/dist/crawl/index-to-vec.d.ts +10 -0
  328. package/dist/crawl/index-to-vec.d.ts.map +1 -0
  329. package/dist/crawl/index-to-vec.js +44 -0
  330. package/dist/crawl/index-to-vec.js.map +1 -0
  331. package/dist/crawl/mapper.js +136 -164
  332. package/dist/crawl/mapper.js.map +1 -1
  333. package/dist/crawl/rate-limiter.js +63 -66
  334. package/dist/crawl/rate-limiter.js.map +1 -1
  335. package/dist/crawl/robots.js +58 -57
  336. package/dist/crawl/robots.js.map +1 -1
  337. package/dist/crawl/sitemap-first.d.ts +12 -0
  338. package/dist/crawl/sitemap-first.d.ts.map +1 -0
  339. package/dist/crawl/sitemap-first.js +47 -0
  340. package/dist/crawl/sitemap-first.js.map +1 -0
  341. package/dist/crawl/sitemap.js +33 -32
  342. package/dist/crawl/sitemap.js.map +1 -1
  343. package/dist/crawl/url-utils.d.ts +1 -0
  344. package/dist/crawl/url-utils.d.ts.map +1 -1
  345. package/dist/crawl/url-utils.js +49 -37
  346. package/dist/crawl/url-utils.js.map +1 -1
  347. package/dist/daemon/health-check.d.ts +16 -0
  348. package/dist/daemon/health-check.d.ts.map +1 -0
  349. package/dist/daemon/health-check.js +33 -0
  350. package/dist/daemon/health-check.js.map +1 -0
  351. package/dist/daemon/http-server.d.ts +26 -0
  352. package/dist/daemon/http-server.d.ts.map +1 -0
  353. package/dist/daemon/http-server.js +275 -0
  354. package/dist/daemon/http-server.js.map +1 -0
  355. package/dist/daemon/proxy.d.ts +10 -0
  356. package/dist/daemon/proxy.d.ts.map +1 -0
  357. package/dist/daemon/proxy.js +93 -0
  358. package/dist/daemon/proxy.js.map +1 -0
  359. package/dist/embedding/embed.d.ts +59 -0
  360. package/dist/embedding/embed.d.ts.map +1 -0
  361. package/dist/embedding/embed.js +233 -0
  362. package/dist/embedding/embed.js.map +1 -0
  363. package/dist/embedding/fastembed-provider.d.ts +19 -0
  364. package/dist/embedding/fastembed-provider.d.ts.map +1 -0
  365. package/dist/embedding/fastembed-provider.js +51 -0
  366. package/dist/embedding/fastembed-provider.js.map +1 -0
  367. package/dist/embedding/key-terms.d.ts +12 -0
  368. package/dist/embedding/key-terms.d.ts.map +1 -0
  369. package/dist/embedding/key-terms.js +234 -0
  370. package/dist/embedding/key-terms.js.map +1 -0
  371. package/dist/extraction/boilerplate.d.ts +15 -0
  372. package/dist/extraction/boilerplate.d.ts.map +1 -0
  373. package/dist/extraction/boilerplate.js +52 -0
  374. package/dist/extraction/boilerplate.js.map +1 -0
  375. package/dist/extraction/defuddle.d.ts.map +1 -1
  376. package/dist/extraction/defuddle.js +27 -23
  377. package/dist/extraction/defuddle.js.map +1 -1
  378. package/dist/extraction/extract.d.ts.map +1 -1
  379. package/dist/extraction/extract.js +76 -76
  380. package/dist/extraction/extract.js.map +1 -1
  381. package/dist/extraction/jsonld.js +50 -54
  382. package/dist/extraction/jsonld.js.map +1 -1
  383. package/dist/extraction/lang-hints.d.ts +2 -0
  384. package/dist/extraction/lang-hints.d.ts.map +1 -0
  385. package/dist/extraction/lang-hints.js +30 -0
  386. package/dist/extraction/lang-hints.js.map +1 -0
  387. package/dist/extraction/llm-fallback.d.ts +17 -0
  388. package/dist/extraction/llm-fallback.d.ts.map +1 -0
  389. package/dist/extraction/llm-fallback.js +130 -0
  390. package/dist/extraction/llm-fallback.js.map +1 -0
  391. package/dist/extraction/markdown-sanitize.d.ts +2 -0
  392. package/dist/extraction/markdown-sanitize.d.ts.map +1 -0
  393. package/dist/extraction/markdown-sanitize.js +151 -0
  394. package/dist/extraction/markdown-sanitize.js.map +1 -0
  395. package/dist/extraction/markdown.d.ts +11 -0
  396. package/dist/extraction/markdown.d.ts.map +1 -1
  397. package/dist/extraction/markdown.js +195 -91
  398. package/dist/extraction/markdown.js.map +1 -1
  399. package/dist/extraction/pipeline.d.ts +8 -0
  400. package/dist/extraction/pipeline.d.ts.map +1 -1
  401. package/dist/extraction/pipeline.js +57 -91
  402. package/dist/extraction/pipeline.js.map +1 -1
  403. package/dist/extraction/readability.d.ts +1 -1
  404. package/dist/extraction/readability.d.ts.map +1 -1
  405. package/dist/extraction/readability.js +28 -29
  406. package/dist/extraction/readability.js.map +1 -1
  407. package/dist/extraction/schema.d.ts +12 -0
  408. package/dist/extraction/schema.d.ts.map +1 -1
  409. package/dist/extraction/schema.js +135 -72
  410. package/dist/extraction/schema.js.map +1 -1
  411. package/dist/extraction/site-extractors/docs-generic.d.ts.map +1 -1
  412. package/dist/extraction/site-extractors/docs-generic.js +81 -91
  413. package/dist/extraction/site-extractors/docs-generic.js.map +1 -1
  414. package/dist/extraction/site-extractors/github.d.ts.map +1 -1
  415. package/dist/extraction/site-extractors/github.js +87 -95
  416. package/dist/extraction/site-extractors/github.js.map +1 -1
  417. package/dist/extraction/site-extractors/mdn.d.ts.map +1 -1
  418. package/dist/extraction/site-extractors/mdn.js +46 -54
  419. package/dist/extraction/site-extractors/mdn.js.map +1 -1
  420. package/dist/extraction/site-extractors/stackoverflow.d.ts.map +1 -1
  421. package/dist/extraction/site-extractors/stackoverflow.js +71 -80
  422. package/dist/extraction/site-extractors/stackoverflow.js.map +1 -1
  423. package/dist/extraction/structured-data.d.ts +4 -0
  424. package/dist/extraction/structured-data.d.ts.map +1 -0
  425. package/dist/extraction/structured-data.js +173 -0
  426. package/dist/extraction/structured-data.js.map +1 -0
  427. package/dist/extraction/structured.d.ts +4 -0
  428. package/dist/extraction/structured.d.ts.map +1 -0
  429. package/dist/extraction/structured.js +163 -0
  430. package/dist/extraction/structured.js.map +1 -0
  431. package/dist/extraction/v1/classifier.d.ts +3 -0
  432. package/dist/extraction/v1/classifier.d.ts.map +1 -0
  433. package/dist/extraction/v1/classifier.js +110 -0
  434. package/dist/extraction/v1/classifier.js.map +1 -0
  435. package/dist/extraction/v1/extract-provider.d.ts +16 -0
  436. package/dist/extraction/v1/extract-provider.d.ts.map +1 -0
  437. package/dist/extraction/v1/extract-provider.js +43 -0
  438. package/dist/extraction/v1/extract-provider.js.map +1 -0
  439. package/dist/extraction/v1/local-llm.d.ts +8 -0
  440. package/dist/extraction/v1/local-llm.d.ts.map +1 -0
  441. package/dist/extraction/v1/local-llm.js +58 -0
  442. package/dist/extraction/v1/local-llm.js.map +1 -0
  443. package/dist/extraction/v1/news.d.ts +3 -0
  444. package/dist/extraction/v1/news.d.ts.map +1 -0
  445. package/dist/extraction/v1/news.js +61 -0
  446. package/dist/extraction/v1/news.js.map +1 -0
  447. package/dist/extraction/v1/product.d.ts +3 -0
  448. package/dist/extraction/v1/product.d.ts.map +1 -0
  449. package/dist/extraction/v1/product.js +166 -0
  450. package/dist/extraction/v1/product.js.map +1 -0
  451. package/dist/extraction/v1/recipe.d.ts +3 -0
  452. package/dist/extraction/v1/recipe.d.ts.map +1 -0
  453. package/dist/extraction/v1/recipe.js +136 -0
  454. package/dist/extraction/v1/recipe.js.map +1 -0
  455. package/dist/extraction/v1/routed.d.ts +17 -0
  456. package/dist/extraction/v1/routed.d.ts.map +1 -0
  457. package/dist/extraction/v1/routed.js +68 -0
  458. package/dist/extraction/v1/routed.js.map +1 -0
  459. package/dist/extraction/v1/schemas/Article.d.ts +11 -0
  460. package/dist/extraction/v1/schemas/Article.d.ts.map +1 -0
  461. package/dist/extraction/v1/schemas/Article.js +23 -0
  462. package/dist/extraction/v1/schemas/Article.js.map +1 -0
  463. package/dist/extraction/v1/schemas/CodeSnippet.d.ts +9 -0
  464. package/dist/extraction/v1/schemas/CodeSnippet.d.ts.map +1 -0
  465. package/dist/extraction/v1/schemas/CodeSnippet.js +90 -0
  466. package/dist/extraction/v1/schemas/CodeSnippet.js.map +1 -0
  467. package/dist/extraction/v1/schemas/EventListing.d.ts +10 -0
  468. package/dist/extraction/v1/schemas/EventListing.d.ts.map +1 -0
  469. package/dist/extraction/v1/schemas/EventListing.js +122 -0
  470. package/dist/extraction/v1/schemas/EventListing.js.map +1 -0
  471. package/dist/extraction/v1/schemas/Paper.d.ts +10 -0
  472. package/dist/extraction/v1/schemas/Paper.d.ts.map +1 -0
  473. package/dist/extraction/v1/schemas/Paper.js +156 -0
  474. package/dist/extraction/v1/schemas/Paper.js.map +1 -0
  475. package/dist/extraction/v1/schemas/Product.d.ts +17 -0
  476. package/dist/extraction/v1/schemas/Product.d.ts.map +1 -0
  477. package/dist/extraction/v1/schemas/Product.js +149 -0
  478. package/dist/extraction/v1/schemas/Product.js.map +1 -0
  479. package/dist/extraction/v1/schemas/Recipe.d.ts +14 -0
  480. package/dist/extraction/v1/schemas/Recipe.d.ts.map +1 -0
  481. package/dist/extraction/v1/schemas/Recipe.js +160 -0
  482. package/dist/extraction/v1/schemas/Recipe.js.map +1 -0
  483. package/dist/extraction/v1/schemas/index.d.ts +13 -0
  484. package/dist/extraction/v1/schemas/index.d.ts.map +1 -0
  485. package/dist/extraction/v1/schemas/index.js +44 -0
  486. package/dist/extraction/v1/schemas/index.js.map +1 -0
  487. package/dist/extraction/v1/site-extractors.d.ts +5 -0
  488. package/dist/extraction/v1/site-extractors.d.ts.map +1 -0
  489. package/dist/extraction/v1/site-extractors.js +31 -0
  490. package/dist/extraction/v1/site-extractors.js.map +1 -0
  491. package/dist/fetch/action-executor.d.ts +28 -0
  492. package/dist/fetch/action-executor.d.ts.map +1 -0
  493. package/dist/fetch/action-executor.js +88 -0
  494. package/dist/fetch/action-executor.js.map +1 -0
  495. package/dist/fetch/auth.d.ts +2 -1
  496. package/dist/fetch/auth.d.ts.map +1 -1
  497. package/dist/fetch/auth.js +56 -26
  498. package/dist/fetch/auth.js.map +1 -1
  499. package/dist/fetch/browser-pool.d.ts +30 -11
  500. package/dist/fetch/browser-pool.d.ts.map +1 -1
  501. package/dist/fetch/browser-pool.js +303 -127
  502. package/dist/fetch/browser-pool.js.map +1 -1
  503. package/dist/fetch/browser-selector.d.ts +17 -0
  504. package/dist/fetch/browser-selector.d.ts.map +1 -0
  505. package/dist/fetch/browser-selector.js +72 -0
  506. package/dist/fetch/browser-selector.js.map +1 -0
  507. package/dist/fetch/browser-types.d.ts +3 -0
  508. package/dist/fetch/browser-types.d.ts.map +1 -0
  509. package/dist/fetch/browser-types.js +45 -0
  510. package/dist/fetch/browser-types.js.map +1 -0
  511. package/dist/fetch/cdp-client.d.ts +9 -0
  512. package/dist/fetch/cdp-client.d.ts.map +1 -0
  513. package/dist/fetch/cdp-client.js +89 -0
  514. package/dist/fetch/cdp-client.js.map +1 -0
  515. package/dist/fetch/content-check.js +39 -46
  516. package/dist/fetch/content-check.js.map +1 -1
  517. package/dist/fetch/http-client.d.ts +4 -0
  518. package/dist/fetch/http-client.d.ts.map +1 -1
  519. package/dist/fetch/http-client.js +147 -128
  520. package/dist/fetch/http-client.js.map +1 -1
  521. package/dist/fetch/lightpanda.d.ts +28 -0
  522. package/dist/fetch/lightpanda.d.ts.map +1 -0
  523. package/dist/fetch/lightpanda.js +174 -0
  524. package/dist/fetch/lightpanda.js.map +1 -0
  525. package/dist/fetch/playwright-tier.d.ts +19 -0
  526. package/dist/fetch/playwright-tier.d.ts.map +1 -0
  527. package/dist/fetch/playwright-tier.js +76 -0
  528. package/dist/fetch/playwright-tier.js.map +1 -0
  529. package/dist/fetch/router.d.ts +49 -3
  530. package/dist/fetch/router.d.ts.map +1 -1
  531. package/dist/fetch/router.js +185 -81
  532. package/dist/fetch/router.js.map +1 -1
  533. package/dist/index.js +97 -17
  534. package/dist/index.js.map +1 -1
  535. package/dist/instructions.d.ts +31 -0
  536. package/dist/instructions.d.ts.map +1 -0
  537. package/dist/instructions.js +245 -0
  538. package/dist/instructions.js.map +1 -0
  539. package/dist/integrations/cloud/llm/anthropic.d.ts +3 -0
  540. package/dist/integrations/cloud/llm/anthropic.d.ts.map +1 -0
  541. package/dist/integrations/cloud/llm/anthropic.js +41 -0
  542. package/dist/integrations/cloud/llm/anthropic.js.map +1 -0
  543. package/dist/integrations/cloud/llm/cache.d.ts +5 -0
  544. package/dist/integrations/cloud/llm/cache.d.ts.map +1 -0
  545. package/dist/integrations/cloud/llm/cache.js +49 -0
  546. package/dist/integrations/cloud/llm/cache.js.map +1 -0
  547. package/dist/integrations/cloud/llm/gemini.d.ts +3 -0
  548. package/dist/integrations/cloud/llm/gemini.d.ts.map +1 -0
  549. package/dist/integrations/cloud/llm/gemini.js +37 -0
  550. package/dist/integrations/cloud/llm/gemini.js.map +1 -0
  551. package/dist/integrations/cloud/llm/groq.d.ts +3 -0
  552. package/dist/integrations/cloud/llm/groq.d.ts.map +1 -0
  553. package/dist/integrations/cloud/llm/groq.js +74 -0
  554. package/dist/integrations/cloud/llm/groq.js.map +1 -0
  555. package/dist/integrations/cloud/llm/hash.d.ts +3 -0
  556. package/dist/integrations/cloud/llm/hash.d.ts.map +1 -0
  557. package/dist/integrations/cloud/llm/hash.js +26 -0
  558. package/dist/integrations/cloud/llm/hash.js.map +1 -0
  559. package/dist/integrations/cloud/llm/openai.d.ts +3 -0
  560. package/dist/integrations/cloud/llm/openai.d.ts.map +1 -0
  561. package/dist/integrations/cloud/llm/openai.js +43 -0
  562. package/dist/integrations/cloud/llm/openai.js.map +1 -0
  563. package/dist/integrations/cloud/llm/select.d.ts +5 -0
  564. package/dist/integrations/cloud/llm/select.d.ts.map +1 -0
  565. package/dist/integrations/cloud/llm/select.js +30 -0
  566. package/dist/integrations/cloud/llm/select.js.map +1 -0
  567. package/dist/integrations/cloud/llm/types.d.ts +24 -0
  568. package/dist/integrations/cloud/llm/types.d.ts.map +1 -0
  569. package/dist/integrations/cloud/llm/types.js +1 -0
  570. package/dist/integrations/cloud/llm/types.js.map +1 -0
  571. package/dist/integrations/cloud/llm/validate.d.ts +6 -0
  572. package/dist/integrations/cloud/llm/validate.d.ts.map +1 -0
  573. package/dist/integrations/cloud/llm/validate.js +63 -0
  574. package/dist/integrations/cloud/llm/validate.js.map +1 -0
  575. package/dist/logger.d.ts +4 -1
  576. package/dist/logger.d.ts.map +1 -1
  577. package/dist/logger.js +71 -30
  578. package/dist/logger.js.map +1 -1
  579. package/dist/pdf-parse.d.js +1 -0
  580. package/dist/pdf-parse.d.js.map +1 -0
  581. package/dist/plugins/loader.d.ts +20 -0
  582. package/dist/plugins/loader.d.ts.map +1 -0
  583. package/dist/plugins/loader.js +157 -0
  584. package/dist/plugins/loader.js.map +1 -0
  585. package/dist/plugins/registry.d.ts +26 -0
  586. package/dist/plugins/registry.d.ts.map +1 -0
  587. package/dist/plugins/registry.js +71 -0
  588. package/dist/plugins/registry.js.map +1 -0
  589. package/dist/plugins/validate.d.ts +9 -0
  590. package/dist/plugins/validate.d.ts.map +1 -0
  591. package/dist/plugins/validate.js +79 -0
  592. package/dist/plugins/validate.js.map +1 -0
  593. package/dist/providers/embed-provider.d.ts +11 -0
  594. package/dist/providers/embed-provider.d.ts.map +1 -0
  595. package/dist/providers/embed-provider.js +24 -0
  596. package/dist/providers/embed-provider.js.map +1 -0
  597. package/dist/providers/extract-provider.d.ts +23 -0
  598. package/dist/providers/extract-provider.d.ts.map +1 -0
  599. package/dist/providers/extract-provider.js +25 -0
  600. package/dist/providers/extract-provider.js.map +1 -0
  601. package/dist/providers/rerank-provider.d.ts +16 -0
  602. package/dist/providers/rerank-provider.d.ts.map +1 -0
  603. package/dist/providers/rerank-provider.js +28 -0
  604. package/dist/providers/rerank-provider.js.map +1 -0
  605. package/dist/providers/search-provider.d.ts +25 -0
  606. package/dist/providers/search-provider.d.ts.map +1 -0
  607. package/dist/providers/search-provider.js +44 -0
  608. package/dist/providers/search-provider.js.map +1 -0
  609. package/dist/providers/vector-store.d.ts +27 -0
  610. package/dist/providers/vector-store.d.ts.map +1 -0
  611. package/dist/providers/vector-store.js +27 -0
  612. package/dist/providers/vector-store.js.map +1 -0
  613. package/dist/python-env.d.ts +9 -0
  614. package/dist/python-env.d.ts.map +1 -0
  615. package/dist/python-env.js +13 -0
  616. package/dist/python-env.js.map +1 -0
  617. package/dist/repl/commands/agent.d.ts +5 -0
  618. package/dist/repl/commands/agent.d.ts.map +1 -0
  619. package/dist/repl/commands/agent.js +62 -0
  620. package/dist/repl/commands/agent.js.map +1 -0
  621. package/dist/repl/commands/cache.d.ts +4 -0
  622. package/dist/repl/commands/cache.d.ts.map +1 -0
  623. package/dist/repl/commands/cache.js +43 -0
  624. package/dist/repl/commands/cache.js.map +1 -0
  625. package/dist/repl/commands/crawl.d.ts +7 -0
  626. package/dist/repl/commands/crawl.d.ts.map +1 -0
  627. package/dist/repl/commands/crawl.js +44 -0
  628. package/dist/repl/commands/crawl.js.map +1 -0
  629. package/dist/repl/commands/extract.d.ts +5 -0
  630. package/dist/repl/commands/extract.d.ts.map +1 -0
  631. package/dist/repl/commands/extract.js +47 -0
  632. package/dist/repl/commands/extract.js.map +1 -0
  633. package/dist/repl/commands/fetch.d.ts +5 -0
  634. package/dist/repl/commands/fetch.d.ts.map +1 -0
  635. package/dist/repl/commands/fetch.js +67 -0
  636. package/dist/repl/commands/fetch.js.map +1 -0
  637. package/dist/repl/commands/find-similar.d.ts +5 -0
  638. package/dist/repl/commands/find-similar.d.ts.map +1 -0
  639. package/dist/repl/commands/find-similar.js +74 -0
  640. package/dist/repl/commands/find-similar.js.map +1 -0
  641. package/dist/repl/commands/research.d.ts +5 -0
  642. package/dist/repl/commands/research.d.ts.map +1 -0
  643. package/dist/repl/commands/research.js +65 -0
  644. package/dist/repl/commands/research.js.map +1 -0
  645. package/dist/repl/commands/search.d.ts +5 -0
  646. package/dist/repl/commands/search.d.ts.map +1 -0
  647. package/dist/repl/commands/search.js +74 -0
  648. package/dist/repl/commands/search.js.map +1 -0
  649. package/dist/repl/commands/types.d.ts +9 -0
  650. package/dist/repl/commands/types.d.ts.map +1 -0
  651. package/dist/repl/commands/types.js +1 -0
  652. package/dist/repl/commands/types.js.map +1 -0
  653. package/dist/repl/formatters.d.ts +13 -0
  654. package/dist/repl/formatters.d.ts.map +1 -0
  655. package/dist/repl/formatters.js +283 -0
  656. package/dist/repl/formatters.js.map +1 -0
  657. package/dist/repl/parser.d.ts +9 -0
  658. package/dist/repl/parser.d.ts.map +1 -0
  659. package/dist/repl/parser.js +86 -0
  660. package/dist/repl/parser.js.map +1 -0
  661. package/dist/repl/shell.d.ts +8 -0
  662. package/dist/repl/shell.d.ts.map +1 -0
  663. package/dist/repl/shell.js +184 -0
  664. package/dist/repl/shell.js.map +1 -0
  665. package/dist/research/branch-exploration.d.ts +14 -0
  666. package/dist/research/branch-exploration.d.ts.map +1 -0
  667. package/dist/research/branch-exploration.js +100 -0
  668. package/dist/research/branch-exploration.js.map +1 -0
  669. package/dist/research/brief.d.ts +5 -0
  670. package/dist/research/brief.d.ts.map +1 -0
  671. package/dist/research/brief.js +242 -0
  672. package/dist/research/brief.js.map +1 -0
  673. package/dist/research/citation-graph.d.ts +9 -0
  674. package/dist/research/citation-graph.d.ts.map +1 -0
  675. package/dist/research/citation-graph.js +114 -0
  676. package/dist/research/citation-graph.js.map +1 -0
  677. package/dist/research/decompose.d.ts +14 -0
  678. package/dist/research/decompose.d.ts.map +1 -0
  679. package/dist/research/decompose.js +439 -0
  680. package/dist/research/decompose.js.map +1 -0
  681. package/dist/research/pipeline.d.ts +5 -0
  682. package/dist/research/pipeline.d.ts.map +1 -0
  683. package/dist/research/pipeline.js +269 -0
  684. package/dist/research/pipeline.js.map +1 -0
  685. package/dist/research/synthesis-local.d.ts +16 -0
  686. package/dist/research/synthesis-local.d.ts.map +1 -0
  687. package/dist/research/synthesis-local.js +73 -0
  688. package/dist/research/synthesis-local.js.map +1 -0
  689. package/dist/research/synthesize.d.ts +10 -0
  690. package/dist/research/synthesize.d.ts.map +1 -0
  691. package/dist/research/synthesize.js +137 -0
  692. package/dist/research/synthesize.js.map +1 -0
  693. package/dist/search/answer-synthesis.d.ts +33 -0
  694. package/dist/search/answer-synthesis.d.ts.map +1 -0
  695. package/dist/search/answer-synthesis.js +244 -0
  696. package/dist/search/answer-synthesis.js.map +1 -0
  697. package/dist/search/context-formatter.d.ts +3 -0
  698. package/dist/search/context-formatter.d.ts.map +1 -0
  699. package/dist/search/context-formatter.js +56 -0
  700. package/dist/search/context-formatter.js.map +1 -0
  701. package/dist/search/dedup.d.ts +1 -0
  702. package/dist/search/dedup.d.ts.map +1 -1
  703. package/dist/search/dedup.js +40 -32
  704. package/dist/search/dedup.js.map +1 -1
  705. package/dist/search/engines/arxiv.d.ts +7 -0
  706. package/dist/search/engines/arxiv.d.ts.map +1 -0
  707. package/dist/search/engines/arxiv.js +70 -0
  708. package/dist/search/engines/arxiv.js.map +1 -0
  709. package/dist/search/engines/bing-news.d.ts +7 -0
  710. package/dist/search/engines/bing-news.d.ts.map +1 -0
  711. package/dist/search/engines/bing-news.js +97 -0
  712. package/dist/search/engines/bing-news.js.map +1 -0
  713. package/dist/search/engines/bing.d.ts +1 -0
  714. package/dist/search/engines/bing.d.ts.map +1 -1
  715. package/dist/search/engines/bing.js +100 -44
  716. package/dist/search/engines/bing.js.map +1 -1
  717. package/dist/search/engines/devdocs.d.ts +6 -0
  718. package/dist/search/engines/devdocs.d.ts.map +1 -0
  719. package/dist/search/engines/devdocs.js +56 -0
  720. package/dist/search/engines/devdocs.js.map +1 -0
  721. package/dist/search/engines/duckduckgo.d.ts.map +1 -1
  722. package/dist/search/engines/duckduckgo.js +56 -44
  723. package/dist/search/engines/duckduckgo.js.map +1 -1
  724. package/dist/search/engines/github-code.d.ts +7 -0
  725. package/dist/search/engines/github-code.d.ts.map +1 -0
  726. package/dist/search/engines/github-code.js +55 -0
  727. package/dist/search/engines/github-code.js.map +1 -0
  728. package/dist/search/engines/hn-algolia.d.ts +7 -0
  729. package/dist/search/engines/hn-algolia.d.ts.map +1 -0
  730. package/dist/search/engines/hn-algolia.js +76 -0
  731. package/dist/search/engines/hn-algolia.js.map +1 -0
  732. package/dist/search/engines/lobsters.d.ts +7 -0
  733. package/dist/search/engines/lobsters.d.ts.map +1 -0
  734. package/dist/search/engines/lobsters.js +83 -0
  735. package/dist/search/engines/lobsters.js.map +1 -0
  736. package/dist/search/engines/mdn.d.ts +7 -0
  737. package/dist/search/engines/mdn.d.ts.map +1 -0
  738. package/dist/search/engines/mdn.js +48 -0
  739. package/dist/search/engines/mdn.js.map +1 -0
  740. package/dist/search/engines/semantic-scholar.d.ts +7 -0
  741. package/dist/search/engines/semantic-scholar.d.ts.map +1 -0
  742. package/dist/search/engines/semantic-scholar.js +69 -0
  743. package/dist/search/engines/semantic-scholar.js.map +1 -0
  744. package/dist/search/engines/stackoverflow.d.ts +7 -0
  745. package/dist/search/engines/stackoverflow.d.ts.map +1 -0
  746. package/dist/search/engines/stackoverflow.js +73 -0
  747. package/dist/search/engines/stackoverflow.js.map +1 -0
  748. package/dist/search/engines/startpage.d.ts.map +1 -1
  749. package/dist/search/engines/startpage.js +65 -46
  750. package/dist/search/engines/startpage.js.map +1 -1
  751. package/dist/search/evidence.d.ts +25 -0
  752. package/dist/search/evidence.d.ts.map +1 -0
  753. package/dist/search/evidence.js +220 -0
  754. package/dist/search/evidence.js.map +1 -0
  755. package/dist/search/filters.js +49 -55
  756. package/dist/search/filters.js.map +1 -1
  757. package/dist/search/find-similar/crawl-rank.d.ts +9 -0
  758. package/dist/search/find-similar/crawl-rank.d.ts.map +1 -0
  759. package/dist/search/find-similar/crawl-rank.js +272 -0
  760. package/dist/search/find-similar/crawl-rank.js.map +1 -0
  761. package/dist/search/find-similar/mode.d.ts +4 -0
  762. package/dist/search/find-similar/mode.d.ts.map +1 -0
  763. package/dist/search/find-similar/mode.js +12 -0
  764. package/dist/search/find-similar/mode.js.map +1 -0
  765. package/dist/search/find-similar.d.ts +5 -0
  766. package/dist/search/find-similar.d.ts.map +1 -0
  767. package/dist/search/find-similar.js +509 -0
  768. package/dist/search/find-similar.js.map +1 -0
  769. package/dist/search/highlights.d.ts +19 -0
  770. package/dist/search/highlights.d.ts.map +1 -0
  771. package/dist/search/highlights.js +167 -0
  772. package/dist/search/highlights.js.map +1 -0
  773. package/dist/search/language-filter.d.ts +29 -0
  774. package/dist/search/language-filter.d.ts.map +1 -0
  775. package/dist/search/language-filter.js +126 -0
  776. package/dist/search/language-filter.js.map +1 -0
  777. package/dist/search/legacy/searxng-orchestrator.d.ts +4 -0
  778. package/dist/search/legacy/searxng-orchestrator.d.ts.map +1 -0
  779. package/dist/search/legacy/searxng-orchestrator.js +501 -0
  780. package/dist/search/legacy/searxng-orchestrator.js.map +1 -0
  781. package/dist/search/legacy/searxng-provider.d.ts +7 -0
  782. package/dist/search/legacy/searxng-provider.d.ts.map +1 -0
  783. package/dist/search/legacy/searxng-provider.js +11 -0
  784. package/dist/search/legacy/searxng-provider.js.map +1 -0
  785. package/dist/search/multi-query.d.ts +25 -0
  786. package/dist/search/multi-query.d.ts.map +1 -0
  787. package/dist/search/multi-query.js +228 -0
  788. package/dist/search/multi-query.js.map +1 -0
  789. package/dist/search/query.js +32 -34
  790. package/dist/search/query.js.map +1 -1
  791. package/dist/search/rerank.d.ts +3 -1
  792. package/dist/search/rerank.d.ts.map +1 -1
  793. package/dist/search/rerank.js +44 -35
  794. package/dist/search/rerank.js.map +1 -1
  795. package/dist/search/reranker/authority-boost.d.ts +3 -0
  796. package/dist/search/reranker/authority-boost.d.ts.map +1 -0
  797. package/dist/search/reranker/authority-boost.js +179 -0
  798. package/dist/search/reranker/authority-boost.js.map +1 -0
  799. package/dist/search/reranker/consensus-boost.d.ts +3 -0
  800. package/dist/search/reranker/consensus-boost.d.ts.map +1 -0
  801. package/dist/search/reranker/consensus-boost.js +27 -0
  802. package/dist/search/reranker/consensus-boost.js.map +1 -0
  803. package/dist/search/reranker/recency-boost.d.ts +3 -0
  804. package/dist/search/reranker/recency-boost.d.ts.map +1 -0
  805. package/dist/search/reranker/recency-boost.js +13 -0
  806. package/dist/search/reranker/recency-boost.js.map +1 -0
  807. package/dist/search/reranker/recency.d.ts +3 -0
  808. package/dist/search/reranker/recency.d.ts.map +1 -0
  809. package/dist/search/reranker/recency.js +23 -0
  810. package/dist/search/reranker/recency.js.map +1 -0
  811. package/dist/search/reranker/transformers-rerank-provider.d.ts +12 -0
  812. package/dist/search/reranker/transformers-rerank-provider.d.ts.map +1 -0
  813. package/dist/search/reranker/transformers-rerank-provider.js +78 -0
  814. package/dist/search/reranker/transformers-rerank-provider.js.map +1 -0
  815. package/dist/search/rrf.d.ts +17 -0
  816. package/dist/search/rrf.d.ts.map +1 -0
  817. package/dist/search/rrf.js +39 -0
  818. package/dist/search/rrf.js.map +1 -0
  819. package/dist/search/sampling.d.ts +25 -0
  820. package/dist/search/sampling.d.ts.map +1 -0
  821. package/dist/search/sampling.js +52 -0
  822. package/dist/search/sampling.js.map +1 -0
  823. package/dist/search/searxng.d.ts.map +1 -1
  824. package/dist/search/searxng.js +69 -79
  825. package/dist/search/searxng.js.map +1 -1
  826. package/dist/search/tokens.d.ts +3 -0
  827. package/dist/search/tokens.d.ts.map +1 -0
  828. package/dist/search/tokens.js +39 -0
  829. package/dist/search/tokens.js.map +1 -0
  830. package/dist/search/truncate.d.ts +6 -0
  831. package/dist/search/truncate.d.ts.map +1 -0
  832. package/dist/search/truncate.js +26 -0
  833. package/dist/search/truncate.js.map +1 -0
  834. package/dist/search/url-unwrap.d.ts +3 -0
  835. package/dist/search/url-unwrap.d.ts.map +1 -0
  836. package/dist/search/url-unwrap.js +43 -0
  837. package/dist/search/url-unwrap.js.map +1 -0
  838. package/dist/search/v1/context-rank.d.ts +13 -0
  839. package/dist/search/v1/context-rank.d.ts.map +1 -0
  840. package/dist/search/v1/context-rank.js +74 -0
  841. package/dist/search/v1/context-rank.js.map +1 -0
  842. package/dist/search/v1/engine-base.d.ts +27 -0
  843. package/dist/search/v1/engine-base.d.ts.map +1 -0
  844. package/dist/search/v1/engine-base.js +110 -0
  845. package/dist/search/v1/engine-base.js.map +1 -0
  846. package/dist/search/v1/intent-router.d.ts +22 -0
  847. package/dist/search/v1/intent-router.d.ts.map +1 -0
  848. package/dist/search/v1/intent-router.js +138 -0
  849. package/dist/search/v1/intent-router.js.map +1 -0
  850. package/dist/search/v1/orchestrator.d.ts +24 -0
  851. package/dist/search/v1/orchestrator.d.ts.map +1 -0
  852. package/dist/search/v1/orchestrator.js +163 -0
  853. package/dist/search/v1/orchestrator.js.map +1 -0
  854. package/dist/search/v1/recency-boost.d.ts +9 -0
  855. package/dist/search/v1/recency-boost.d.ts.map +1 -0
  856. package/dist/search/v1/recency-boost.js +37 -0
  857. package/dist/search/v1/recency-boost.js.map +1 -0
  858. package/dist/search/v1/recent-cache-dedup.d.ts +6 -0
  859. package/dist/search/v1/recent-cache-dedup.d.ts.map +1 -0
  860. package/dist/search/v1/recent-cache-dedup.js +85 -0
  861. package/dist/search/v1/recent-cache-dedup.js.map +1 -0
  862. package/dist/search/v1/rss/feed-config.d.ts +21 -0
  863. package/dist/search/v1/rss/feed-config.d.ts.map +1 -0
  864. package/dist/search/v1/rss/feed-config.js +90 -0
  865. package/dist/search/v1/rss/feed-config.js.map +1 -0
  866. package/dist/search/v1/rss/feed-parser.d.ts +14 -0
  867. package/dist/search/v1/rss/feed-parser.d.ts.map +1 -0
  868. package/dist/search/v1/rss/feed-parser.js +104 -0
  869. package/dist/search/v1/rss/feed-parser.js.map +1 -0
  870. package/dist/search/v1/rss/feed-poller.d.ts +22 -0
  871. package/dist/search/v1/rss/feed-poller.d.ts.map +1 -0
  872. package/dist/search/v1/rss/feed-poller.js +102 -0
  873. package/dist/search/v1/rss/feed-poller.js.map +1 -0
  874. package/dist/search/v1/rss/feed-store.d.ts +30 -0
  875. package/dist/search/v1/rss/feed-store.d.ts.map +1 -0
  876. package/dist/search/v1/rss/feed-store.js +134 -0
  877. package/dist/search/v1/rss/feed-store.js.map +1 -0
  878. package/dist/search/v1/rss/rss-engine.d.ts +6 -0
  879. package/dist/search/v1/rss/rss-engine.d.ts.map +1 -0
  880. package/dist/search/v1/rss/rss-engine.js +28 -0
  881. package/dist/search/v1/rss/rss-engine.js.map +1 -0
  882. package/dist/search/v1/v1-provider.d.ts +7 -0
  883. package/dist/search/v1/v1-provider.d.ts.map +1 -0
  884. package/dist/search/v1/v1-provider.js +68 -0
  885. package/dist/search/v1/v1-provider.js.map +1 -0
  886. package/dist/search/v1/verticals/code.d.ts +4 -0
  887. package/dist/search/v1/verticals/code.d.ts.map +1 -0
  888. package/dist/search/v1/verticals/code.js +20 -0
  889. package/dist/search/v1/verticals/code.js.map +1 -0
  890. package/dist/search/v1/verticals/docs.d.ts +4 -0
  891. package/dist/search/v1/verticals/docs.d.ts.map +1 -0
  892. package/dist/search/v1/verticals/docs.js +20 -0
  893. package/dist/search/v1/verticals/docs.js.map +1 -0
  894. package/dist/search/v1/verticals/general.d.ts +4 -0
  895. package/dist/search/v1/verticals/general.d.ts.map +1 -0
  896. package/dist/search/v1/verticals/general.js +22 -0
  897. package/dist/search/v1/verticals/general.js.map +1 -0
  898. package/dist/search/v1/verticals/news.d.ts +10 -0
  899. package/dist/search/v1/verticals/news.d.ts.map +1 -0
  900. package/dist/search/v1/verticals/news.js +52 -0
  901. package/dist/search/v1/verticals/news.js.map +1 -0
  902. package/dist/search/v1/verticals/papers.d.ts +4 -0
  903. package/dist/search/v1/verticals/papers.d.ts.map +1 -0
  904. package/dist/search/v1/verticals/papers.js +23 -0
  905. package/dist/search/v1/verticals/papers.js.map +1 -0
  906. package/dist/search/validator.js +31 -31
  907. package/dist/search/validator.js.map +1 -1
  908. package/dist/searxng/bootstrap.d.ts +30 -0
  909. package/dist/searxng/bootstrap.d.ts.map +1 -1
  910. package/dist/searxng/bootstrap.js +223 -85
  911. package/dist/searxng/bootstrap.js.map +1 -1
  912. package/dist/searxng/docker.d.ts.map +1 -1
  913. package/dist/searxng/docker.js +69 -60
  914. package/dist/searxng/docker.js.map +1 -1
  915. package/dist/searxng/process.d.ts +13 -1
  916. package/dist/searxng/process.d.ts.map +1 -1
  917. package/dist/searxng/process.js +231 -164
  918. package/dist/searxng/process.js.map +1 -1
  919. package/dist/server/backend-status.d.ts +13 -0
  920. package/dist/server/backend-status.d.ts.map +1 -0
  921. package/dist/server/backend-status.js +40 -0
  922. package/dist/server/backend-status.js.map +1 -0
  923. package/dist/server/tool-schemas.d.ts +549 -0
  924. package/dist/server/tool-schemas.d.ts.map +1 -0
  925. package/dist/server/tool-schemas.js +464 -0
  926. package/dist/server/tool-schemas.js.map +1 -0
  927. package/dist/server/warmup-on-start.d.ts +9 -0
  928. package/dist/server/warmup-on-start.d.ts.map +1 -0
  929. package/dist/server/warmup-on-start.js +55 -0
  930. package/dist/server/warmup-on-start.js.map +1 -0
  931. package/dist/server.d.ts +17 -0
  932. package/dist/server.d.ts.map +1 -1
  933. package/dist/server.js +454 -297
  934. package/dist/server.js.map +1 -1
  935. package/dist/tools/agent.d.ts +5 -0
  936. package/dist/tools/agent.d.ts.map +1 -0
  937. package/dist/tools/agent.js +128 -0
  938. package/dist/tools/agent.js.map +1 -0
  939. package/dist/tools/cache.d.ts +2 -1
  940. package/dist/tools/cache.d.ts.map +1 -1
  941. package/dist/tools/cache.js +175 -44
  942. package/dist/tools/cache.js.map +1 -1
  943. package/dist/tools/crawl.d.ts.map +1 -1
  944. package/dist/tools/crawl.js +171 -88
  945. package/dist/tools/crawl.js.map +1 -1
  946. package/dist/tools/extract.d.ts +2 -2
  947. package/dist/tools/extract.d.ts.map +1 -1
  948. package/dist/tools/extract.js +175 -59
  949. package/dist/tools/extract.js.map +1 -1
  950. package/dist/tools/fetch.d.ts +2 -2
  951. package/dist/tools/fetch.d.ts.map +1 -1
  952. package/dist/tools/fetch.js +161 -68
  953. package/dist/tools/fetch.js.map +1 -1
  954. package/dist/tools/find-similar.d.ts +5 -0
  955. package/dist/tools/find-similar.d.ts.map +1 -0
  956. package/dist/tools/find-similar.js +127 -0
  957. package/dist/tools/find-similar.js.map +1 -0
  958. package/dist/tools/research.d.ts +5 -0
  959. package/dist/tools/research.d.ts.map +1 -0
  960. package/dist/tools/research.js +107 -0
  961. package/dist/tools/research.js.map +1 -0
  962. package/dist/tools/search.d.ts +10 -2
  963. package/dist/tools/search.d.ts.map +1 -1
  964. package/dist/tools/search.js +13 -158
  965. package/dist/tools/search.js.map +1 -1
  966. package/dist/types.d.ts +350 -7
  967. package/dist/types.d.ts.map +1 -1
  968. package/dist/types.js +6 -1
  969. package/dist/types.js.map +1 -1
  970. package/dist/util/mode.d.ts +4 -0
  971. package/dist/util/mode.d.ts.map +1 -0
  972. package/dist/util/mode.js +34 -0
  973. package/dist/util/mode.js.map +1 -0
  974. package/package.json +78 -8
  975. package/dist/extraction/trafilatura.d.ts +0 -6
  976. package/dist/extraction/trafilatura.d.ts.map +0 -1
  977. package/dist/extraction/trafilatura.js +0 -105
  978. package/dist/extraction/trafilatura.js.map +0 -1
  979. package/dist/search/flashrank.d.ts +0 -12
  980. package/dist/search/flashrank.d.ts.map +0 -1
  981. package/dist/search/flashrank.js +0 -63
  982. package/dist/search/flashrank.js.map +0 -1
@@ -1,138 +1,314 @@
1
- import { chromium, firefox, webkit } from 'playwright';
2
- import { getConfig } from '../config.js';
3
- import { createLogger } from '../logger.js';
4
- export class BrowserPool {
5
- browser = null;
6
- pool = [];
7
- activeCount = 0;
8
- waitQueue = [];
9
- idleTimers = new Map();
10
- shutdownCalled = false;
11
- browserType;
12
- constructor(options) {
13
- this.browserType = options?.browserType ?? 'chromium';
1
+ import { chromium, firefox, webkit } from "playwright";
2
+ import { getConfig } from "../config.js";
3
+ import { createLogger } from "../logger.js";
4
+ import { BrowserSelector } from "./browser-selector.js";
5
+ import { executeActions } from "./action-executor.js";
6
+ const log = createLogger("fetch");
7
+ function getLauncher(type) {
8
+ switch (type) {
9
+ case "firefox":
10
+ return firefox;
11
+ case "webkit":
12
+ return webkit;
13
+ default:
14
+ return chromium;
15
+ }
16
+ }
17
+ class MultiBrowserPool {
18
+ pools = /* @__PURE__ */ new Map();
19
+ selector;
20
+ configuredTypes;
21
+ shutdownCalled = false;
22
+ constructor(options) {
23
+ let types = options?.browserTypes ?? ["chromium"];
24
+ if (types.length === 0) {
25
+ log.warn("empty browserTypes, defaulting to chromium");
26
+ types = ["chromium"];
14
27
  }
15
- async launchBrowser() {
16
- if (!this.browser) {
17
- const launcher = this.browserType === 'firefox' ? firefox
18
- : this.browserType === 'webkit' ? webkit
19
- : chromium;
20
- this.browser = await launcher.launch({ headless: true });
21
- }
22
- return this.browser;
28
+ this.configuredTypes = [...types];
29
+ this.selector = new BrowserSelector(types, options?.selectionStrategy ?? "round-robin");
30
+ for (const type of types) {
31
+ this.pools.set(type, {
32
+ browser: null,
33
+ pool: [],
34
+ activeCount: 0,
35
+ waitQueue: [],
36
+ idleTimers: /* @__PURE__ */ new Map()
37
+ });
23
38
  }
24
- async acquire() {
25
- const config = getConfig();
26
- const maxBrowsers = config.maxBrowsers;
27
- if (this.pool.length > 0) {
28
- const ctx = this.pool.pop();
29
- const timer = this.idleTimers.get(ctx);
30
- if (timer !== undefined) {
31
- clearTimeout(timer);
32
- this.idleTimers.delete(ctx);
33
- }
34
- return ctx;
35
- }
36
- if (this.activeCount < maxBrowsers) {
37
- this.activeCount++;
38
- const browser = await this.launchBrowser();
39
- return browser.newContext();
40
- }
41
- return new Promise((resolve) => {
42
- this.waitQueue.push(resolve);
43
- });
39
+ log.info("multi-browser pool initialized", {
40
+ types: this.configuredTypes,
41
+ strategy: options?.selectionStrategy ?? "round-robin"
42
+ });
43
+ }
44
+ getConfiguredTypes() {
45
+ return [...this.configuredTypes];
46
+ }
47
+ getStats() {
48
+ return this.configuredTypes.map((type) => {
49
+ const p = this.pools.get(type);
50
+ return {
51
+ type,
52
+ activeCount: p.activeCount,
53
+ pooledCount: p.pool.length
54
+ };
55
+ });
56
+ }
57
+ resolveType(requested, url) {
58
+ if (requested && this.pools.has(requested)) {
59
+ return requested;
44
60
  }
45
- release(ctx) {
46
- const config = getConfig();
47
- const idleTimeoutMs = config.browserIdleTimeoutMs;
48
- if (this.waitQueue.length > 0) {
49
- const resolve = this.waitQueue.shift();
50
- resolve(ctx);
51
- return;
52
- }
53
- this.pool.push(ctx);
54
- const timer = setTimeout(() => {
55
- const idx = this.pool.indexOf(ctx);
56
- if (idx !== -1) {
57
- this.pool.splice(idx, 1);
58
- this.idleTimers.delete(ctx);
59
- this.activeCount = Math.max(0, this.activeCount - 1);
60
- ctx.close().catch(() => { });
61
- }
62
- }, idleTimeoutMs);
63
- this.idleTimers.set(ctx, timer);
61
+ if (requested && !this.pools.has(requested)) {
62
+ log.warn("requested browser type not configured, falling back", {
63
+ requested,
64
+ available: this.configuredTypes
65
+ });
66
+ return this.configuredTypes[0];
64
67
  }
65
- async fetchWithBrowser(url, options = {}) {
66
- const config = getConfig();
67
- const logger = createLogger('fetch');
68
- const navTimeoutMs = options.timeoutMs ?? config.playwrightNavTimeoutMs;
69
- const loadTimeoutMs = config.playwrightLoadTimeoutMs;
70
- const ctx = await this.acquire();
71
- const page = await ctx.newPage();
72
- if (options.headers) {
73
- await page.setExtraHTTPHeaders(options.headers);
74
- }
75
- let statusCode = 200;
76
- let contentType = '';
77
- let responseHeaders = {};
78
- let finalUrl = url;
79
- try {
80
- const response = await page.goto(url, {
81
- timeout: navTimeoutMs,
82
- waitUntil: 'domcontentloaded',
83
- });
84
- if (response) {
85
- statusCode = response.status();
86
- finalUrl = response.url();
87
- const rawHeaders = response.headers();
88
- responseHeaders = rawHeaders;
89
- contentType = rawHeaders['content-type'] ?? '';
90
- }
68
+ if (url && this.selector.getStrategy() === "hostname-hash") {
69
+ try {
70
+ const hostname = new URL(url).hostname;
71
+ return this.selector.selectForHostname(hostname);
72
+ } catch {
73
+ return this.selector.select();
74
+ }
75
+ }
76
+ return this.selector.select();
77
+ }
78
+ async launchBrowser(type) {
79
+ const typePool = this.pools.get(type);
80
+ if (!typePool.browser) {
81
+ const launcher = getLauncher(type);
82
+ log.debug("launching browser", { type });
83
+ typePool.browser = await launcher.launch({ headless: true });
84
+ }
85
+ return typePool.browser;
86
+ }
87
+ async acquireForType(type) {
88
+ const config = getConfig();
89
+ const maxBrowsers = config.maxBrowsers;
90
+ const typePool = this.pools.get(type);
91
+ if (typePool.pool.length > 0) {
92
+ const ctx = typePool.pool.pop();
93
+ const timer = typePool.idleTimers.get(ctx);
94
+ if (timer !== void 0) {
95
+ clearTimeout(timer);
96
+ typePool.idleTimers.delete(ctx);
97
+ }
98
+ return ctx;
99
+ }
100
+ if (typePool.activeCount < maxBrowsers) {
101
+ typePool.activeCount++;
102
+ const browser = await this.launchBrowser(type);
103
+ return browser.newContext();
104
+ }
105
+ return new Promise((resolve) => {
106
+ typePool.waitQueue.push(resolve);
107
+ });
108
+ }
109
+ releaseForType(type, ctx) {
110
+ const config = getConfig();
111
+ const idleTimeoutMs = config.browserIdleTimeoutMs;
112
+ const typePool = this.pools.get(type);
113
+ if (typePool.waitQueue.length > 0) {
114
+ const resolve = typePool.waitQueue.shift();
115
+ resolve(ctx);
116
+ return;
117
+ }
118
+ typePool.pool.push(ctx);
119
+ const timer = setTimeout(() => {
120
+ const idx = typePool.pool.indexOf(ctx);
121
+ if (idx !== -1) {
122
+ typePool.pool.splice(idx, 1);
123
+ typePool.idleTimers.delete(ctx);
124
+ typePool.activeCount = Math.max(0, typePool.activeCount - 1);
125
+ ctx.close().catch(() => {
126
+ });
127
+ }
128
+ }, idleTimeoutMs);
129
+ typePool.idleTimers.set(ctx, timer);
130
+ }
131
+ async fetchWithBrowser(url, options = {}) {
132
+ const config = getConfig();
133
+ const navTimeoutMs = options.timeoutMs ?? config.playwrightNavTimeoutMs;
134
+ const loadTimeoutMs = config.playwrightLoadTimeoutMs;
135
+ let ctx;
136
+ let cdpBrowser = null;
137
+ let resolvedType;
138
+ if (!options.cdpUrl && config.lightpandaEnabled && config.lightpandaUrl) {
139
+ try {
140
+ const domain = new URL(url).hostname;
141
+ const { shouldUseLightpanda, recordSuccess, recordFailure, LightpandaAdapter } = await import("./lightpanda.js");
142
+ if (shouldUseLightpanda(domain)) {
143
+ log.debug("trying lightpanda for domain", { url, domain });
144
+ const adapter = new LightpandaAdapter(config.lightpandaUrl);
145
+ const connection = await adapter.connect();
146
+ if (connection.connected) {
91
147
  try {
92
- await page.waitForLoadState('networkidle', { timeout: loadTimeoutMs });
93
- }
94
- catch {
95
- // networkidle timeout is non-fatal — page content is still usable
96
- logger.debug('networkidle timeout, using page content as-is', { url });
97
- }
98
- const html = await page.content();
99
- let screenshotBase64;
100
- if (options.screenshot) {
101
- const buf = await page.screenshot({ fullPage: true });
102
- screenshotBase64 = buf.toString('base64');
103
- }
104
- return {
148
+ const lpCtx = await adapter.getContext();
149
+ if (lpCtx) {
150
+ const page2 = await lpCtx.newPage();
151
+ if (options.headers) await page2.setExtraHTTPHeaders(options.headers);
152
+ try {
153
+ const response = await page2.goto(url, {
154
+ timeout: navTimeoutMs,
155
+ waitUntil: "domcontentloaded"
156
+ });
157
+ const html = await page2.content();
158
+ const statusCode2 = response?.status() ?? 200;
159
+ const finalUrl2 = response?.url() ?? url;
160
+ const responseHeaders2 = response?.headers() ?? {};
161
+ const contentType2 = responseHeaders2["content-type"] ?? "";
162
+ await page2.close();
163
+ await adapter.disconnect();
164
+ recordSuccess(domain);
165
+ return {
166
+ url,
167
+ finalUrl: finalUrl2,
168
+ html,
169
+ contentType: contentType2,
170
+ statusCode: statusCode2,
171
+ method: "playwright",
172
+ headers: responseHeaders2
173
+ };
174
+ } catch (pageErr) {
175
+ await page2.close().catch(() => {
176
+ });
177
+ throw pageErr;
178
+ }
179
+ }
180
+ } catch (fetchErr) {
181
+ log.warn("lightpanda fetch failed, falling back to chromium", {
105
182
  url,
106
- finalUrl,
107
- html,
108
- contentType,
109
- statusCode,
110
- method: 'playwright',
111
- headers: responseHeaders,
112
- screenshot: screenshotBase64,
113
- };
114
- }
115
- finally {
116
- await page.close();
117
- this.release(ctx);
183
+ domain,
184
+ error: fetchErr instanceof Error ? fetchErr.message : String(fetchErr)
185
+ });
186
+ recordFailure(domain);
187
+ await adapter.disconnect();
188
+ }
189
+ }
118
190
  }
191
+ } catch (lpErr) {
192
+ log.debug("lightpanda integration error, using standard pool", {
193
+ error: lpErr instanceof Error ? lpErr.message : String(lpErr)
194
+ });
195
+ }
119
196
  }
120
- async shutdown() {
121
- if (this.shutdownCalled)
122
- return;
123
- this.shutdownCalled = true;
124
- for (const [, timer] of this.idleTimers) {
125
- clearTimeout(timer);
126
- }
127
- this.idleTimers.clear();
128
- const closePromises = this.pool.map((ctx) => ctx.close().catch(() => { }));
129
- this.pool = [];
130
- await Promise.all(closePromises);
131
- if (this.browser) {
132
- await this.browser.close().catch(() => { });
133
- this.browser = null;
134
- }
135
- this.activeCount = 0;
197
+ if (options.cdpUrl) {
198
+ resolvedType = "chromium";
199
+ try {
200
+ log.info("connecting via CDP", { cdpUrl: options.cdpUrl });
201
+ cdpBrowser = await chromium.connectOverCDP(options.cdpUrl);
202
+ const contexts = cdpBrowser.contexts();
203
+ ctx = contexts.length > 0 ? contexts[0] : await cdpBrowser.newContext();
204
+ } catch (err) {
205
+ log.warn("CDP connection failed, falling back to launch", {
206
+ cdpUrl: options.cdpUrl,
207
+ error: err instanceof Error ? err.message : String(err)
208
+ });
209
+ ctx = await this.acquireForType(resolvedType);
210
+ }
211
+ } else {
212
+ resolvedType = this.resolveType(options.browserType, url);
213
+ log.debug("fetching with browser", { url, type: resolvedType });
214
+ ctx = await this.acquireForType(resolvedType);
215
+ }
216
+ const page = await ctx.newPage();
217
+ if (options.headers) {
218
+ await page.setExtraHTTPHeaders(options.headers);
219
+ }
220
+ let statusCode = 200;
221
+ let contentType = "";
222
+ let responseHeaders = {};
223
+ let finalUrl = url;
224
+ try {
225
+ const response = await page.goto(url, {
226
+ timeout: navTimeoutMs,
227
+ waitUntil: "domcontentloaded"
228
+ });
229
+ if (response) {
230
+ statusCode = response.status();
231
+ finalUrl = response.url();
232
+ const rawHeaders = response.headers();
233
+ responseHeaders = rawHeaders;
234
+ contentType = rawHeaders["content-type"] ?? "";
235
+ }
236
+ try {
237
+ await page.waitForLoadState("networkidle", { timeout: loadTimeoutMs });
238
+ } catch {
239
+ log.debug("networkidle timeout, using page content as-is", { url, type: resolvedType });
240
+ }
241
+ let actionResults;
242
+ if (options.actions && options.actions.length > 0) {
243
+ actionResults = await executeActions(page, options.actions);
244
+ }
245
+ const html = await page.content();
246
+ let screenshotBase64;
247
+ if (options.screenshot) {
248
+ const buf = await page.screenshot({ fullPage: true });
249
+ screenshotBase64 = buf.toString("base64");
250
+ }
251
+ return {
252
+ url,
253
+ finalUrl,
254
+ html,
255
+ contentType,
256
+ statusCode,
257
+ method: "playwright",
258
+ headers: responseHeaders,
259
+ screenshot: screenshotBase64,
260
+ actionResults
261
+ };
262
+ } finally {
263
+ await page.close();
264
+ if (cdpBrowser) {
265
+ await cdpBrowser.close().catch(() => {
266
+ });
267
+ } else {
268
+ this.releaseForType(resolvedType, ctx);
269
+ }
136
270
  }
271
+ }
272
+ async shutdown() {
273
+ if (this.shutdownCalled) return;
274
+ this.shutdownCalled = true;
275
+ for (const [type, typePool] of this.pools) {
276
+ for (const [, timer] of typePool.idleTimers) {
277
+ clearTimeout(timer);
278
+ }
279
+ typePool.idleTimers.clear();
280
+ const closePromises = typePool.pool.map((ctx) => ctx.close().catch(() => {
281
+ }));
282
+ typePool.pool = [];
283
+ await Promise.all(closePromises);
284
+ if (typePool.browser) {
285
+ await typePool.browser.close().catch(() => {
286
+ });
287
+ typePool.browser = null;
288
+ }
289
+ typePool.activeCount = 0;
290
+ log.debug("browser pool shut down", { type });
291
+ }
292
+ }
293
+ }
294
+ class BrowserPool extends MultiBrowserPool {
295
+ singleType;
296
+ constructor(options) {
297
+ const type = options?.browserType ?? "chromium";
298
+ super({
299
+ browserTypes: [type]
300
+ });
301
+ this.singleType = type;
302
+ }
303
+ async acquire() {
304
+ return this.acquireForType(this.singleType);
305
+ }
306
+ release(ctx) {
307
+ this.releaseForType(this.singleType, ctx);
308
+ }
137
309
  }
310
+ export {
311
+ BrowserPool,
312
+ MultiBrowserPool
313
+ };
138
314
  //# sourceMappingURL=browser-pool.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"browser-pool.js","sourceRoot":"","sources":["../../src/fetch/browser-pool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"sources":["../../src/fetch/browser-pool.ts"],"sourcesContent":["import { chromium, firefox, webkit, type Browser, type BrowserContext } from 'playwright';\nimport { getConfig } from '../config.js';\nimport { createLogger } from '../logger.js';\nimport { BrowserSelector, type SelectionStrategy } from './browser-selector.js';\nimport { executeActions } from './action-executor.js';\nimport type { RawFetchResult, BrowserType, ActionResult, BrowserAction } from '../types.js';\n\nexport interface BrowserFetchOptions {\n timeoutMs?: number;\n storageStatePath?: string;\n userDataDir?: string;\n headers?: Record<string, string>;\n screenshot?: boolean;\n actions?: BrowserAction[];\n cdpUrl?: string;\n browserType?: BrowserType;\n}\n\nexport interface BrowserPoolOptions {\n browserType?: BrowserType;\n}\n\nexport interface MultiBrowserPoolOptions {\n browserTypes?: BrowserType[];\n selectionStrategy?: SelectionStrategy;\n}\n\nexport interface PoolTypeStat {\n type: BrowserType;\n activeCount: number;\n pooledCount: number;\n}\n\nconst log = createLogger('fetch');\n\nfunction getLauncher(type: BrowserType) {\n switch (type) {\n case 'firefox': return firefox;\n case 'webkit': return webkit;\n default: return chromium;\n }\n}\n\ninterface TypePool {\n browser: Browser | null;\n pool: BrowserContext[];\n activeCount: number;\n waitQueue: Array<(ctx: BrowserContext) => void>;\n idleTimers: Map<BrowserContext, ReturnType<typeof setTimeout>>;\n}\n\nexport class MultiBrowserPool {\n private readonly pools = new Map<BrowserType, TypePool>();\n private readonly selector: BrowserSelector;\n private readonly configuredTypes: BrowserType[];\n private shutdownCalled = false;\n\n constructor(options?: MultiBrowserPoolOptions) {\n let types = options?.browserTypes ?? ['chromium'];\n if (types.length === 0) {\n log.warn('empty browserTypes, defaulting to chromium');\n types = ['chromium'];\n }\n this.configuredTypes = [...types];\n this.selector = new BrowserSelector(types, options?.selectionStrategy ?? 'round-robin');\n\n for (const type of types) {\n this.pools.set(type, {\n browser: null,\n pool: [],\n activeCount: 0,\n waitQueue: [],\n idleTimers: new Map(),\n });\n }\n\n log.info('multi-browser pool initialized', {\n types: this.configuredTypes,\n strategy: options?.selectionStrategy ?? 'round-robin',\n });\n }\n\n getConfiguredTypes(): BrowserType[] {\n return [...this.configuredTypes];\n }\n\n getStats(): PoolTypeStat[] {\n return this.configuredTypes.map(type => {\n const p = this.pools.get(type)!;\n return {\n type,\n activeCount: p.activeCount,\n pooledCount: p.pool.length,\n };\n });\n }\n\n protected resolveType(requested?: BrowserType, url?: string): BrowserType {\n if (requested && this.pools.has(requested)) {\n return requested;\n }\n if (requested && !this.pools.has(requested)) {\n log.warn('requested browser type not configured, falling back', {\n requested,\n available: this.configuredTypes,\n });\n return this.configuredTypes[0];\n }\n // For hostname-hash strategy, use the URL hostname for deterministic selection\n if (url && this.selector.getStrategy() === 'hostname-hash') {\n try {\n const hostname = new URL(url).hostname;\n return this.selector.selectForHostname(hostname);\n } catch {\n return this.selector.select();\n }\n }\n return this.selector.select();\n }\n\n private async launchBrowser(type: BrowserType): Promise<Browser> {\n const typePool = this.pools.get(type)!;\n if (!typePool.browser) {\n const launcher = getLauncher(type);\n log.debug('launching browser', { type });\n typePool.browser = await launcher.launch({ headless: true });\n }\n return typePool.browser;\n }\n\n protected async acquireForType(type: BrowserType): Promise<BrowserContext> {\n const config = getConfig();\n const maxBrowsers = config.maxBrowsers;\n const typePool = this.pools.get(type)!;\n\n if (typePool.pool.length > 0) {\n const ctx = typePool.pool.pop()!;\n const timer = typePool.idleTimers.get(ctx);\n if (timer !== undefined) {\n clearTimeout(timer);\n typePool.idleTimers.delete(ctx);\n }\n return ctx;\n }\n\n if (typePool.activeCount < maxBrowsers) {\n typePool.activeCount++;\n const browser = await this.launchBrowser(type);\n return browser.newContext();\n }\n\n return new Promise<BrowserContext>((resolve) => {\n typePool.waitQueue.push(resolve);\n });\n }\n\n protected releaseForType(type: BrowserType, ctx: BrowserContext): void {\n const config = getConfig();\n const idleTimeoutMs = config.browserIdleTimeoutMs;\n const typePool = this.pools.get(type)!;\n\n if (typePool.waitQueue.length > 0) {\n const resolve = typePool.waitQueue.shift()!;\n resolve(ctx);\n return;\n }\n\n typePool.pool.push(ctx);\n\n const timer = setTimeout(() => {\n const idx = typePool.pool.indexOf(ctx);\n if (idx !== -1) {\n typePool.pool.splice(idx, 1);\n typePool.idleTimers.delete(ctx);\n typePool.activeCount = Math.max(0, typePool.activeCount - 1);\n ctx.close().catch(() => {});\n }\n }, idleTimeoutMs);\n\n typePool.idleTimers.set(ctx, timer);\n }\n\n async fetchWithBrowser(url: string, options: BrowserFetchOptions = {}): Promise<RawFetchResult> {\n const config = getConfig();\n const navTimeoutMs = options.timeoutMs ?? config.playwrightNavTimeoutMs;\n const loadTimeoutMs = config.playwrightLoadTimeoutMs;\n\n let ctx: BrowserContext;\n let cdpBrowser: Browser | null = null;\n let resolvedType: BrowserType;\n\n if (!options.cdpUrl && config.lightpandaEnabled && config.lightpandaUrl) {\n try {\n const domain = new URL(url).hostname;\n const { shouldUseLightpanda, recordSuccess, recordFailure, LightpandaAdapter } = await import('./lightpanda.js');\n\n if (shouldUseLightpanda(domain)) {\n log.debug('trying lightpanda for domain', { url, domain });\n const adapter = new LightpandaAdapter(config.lightpandaUrl);\n const connection = await adapter.connect();\n\n if (connection.connected) {\n try {\n const lpCtx = await adapter.getContext();\n if (lpCtx) {\n const page = await lpCtx.newPage();\n if (options.headers) await page.setExtraHTTPHeaders(options.headers);\n\n try {\n const response = await page.goto(url, {\n timeout: navTimeoutMs,\n waitUntil: 'domcontentloaded',\n });\n\n const html = await page.content();\n const statusCode = response?.status() ?? 200;\n const finalUrl = response?.url() ?? url;\n const responseHeaders = response?.headers() ?? {};\n const contentType = responseHeaders['content-type'] ?? '';\n\n await page.close();\n await adapter.disconnect();\n recordSuccess(domain);\n\n return {\n url,\n finalUrl,\n html,\n contentType,\n statusCode,\n method: 'playwright' as const,\n headers: responseHeaders,\n };\n } catch (pageErr) {\n await page.close().catch(() => {});\n throw pageErr;\n }\n }\n } catch (fetchErr) {\n log.warn('lightpanda fetch failed, falling back to chromium', {\n url, domain,\n error: fetchErr instanceof Error ? fetchErr.message : String(fetchErr),\n });\n recordFailure(domain);\n await adapter.disconnect();\n }\n }\n }\n } catch (lpErr) {\n log.debug('lightpanda integration error, using standard pool', {\n error: lpErr instanceof Error ? lpErr.message : String(lpErr),\n });\n }\n }\n\n if (options.cdpUrl) {\n // CDP is always Chromium\n resolvedType = 'chromium';\n try {\n log.info('connecting via CDP', { cdpUrl: options.cdpUrl });\n cdpBrowser = await chromium.connectOverCDP(options.cdpUrl);\n const contexts = cdpBrowser.contexts();\n ctx = contexts.length > 0 ? contexts[0] : await cdpBrowser.newContext();\n } catch (err) {\n log.warn('CDP connection failed, falling back to launch', {\n cdpUrl: options.cdpUrl,\n error: err instanceof Error ? err.message : String(err),\n });\n ctx = await this.acquireForType(resolvedType);\n }\n } else {\n resolvedType = this.resolveType(options.browserType, url);\n log.debug('fetching with browser', { url, type: resolvedType });\n ctx = await this.acquireForType(resolvedType);\n }\n\n const page = await ctx.newPage();\n\n if (options.headers) {\n await page.setExtraHTTPHeaders(options.headers);\n }\n\n let statusCode = 200;\n let contentType = '';\n let responseHeaders: Record<string, string> = {};\n let finalUrl = url;\n\n try {\n const response = await page.goto(url, {\n timeout: navTimeoutMs,\n waitUntil: 'domcontentloaded',\n });\n\n if (response) {\n statusCode = response.status();\n finalUrl = response.url();\n const rawHeaders = response.headers();\n responseHeaders = rawHeaders;\n contentType = rawHeaders['content-type'] ?? '';\n }\n\n try {\n await page.waitForLoadState('networkidle', { timeout: loadTimeoutMs });\n } catch {\n log.debug('networkidle timeout, using page content as-is', { url, type: resolvedType });\n }\n\n let actionResults: ActionResult[] | undefined;\n if (options.actions && options.actions.length > 0) {\n actionResults = await executeActions(page, options.actions);\n }\n\n const html = await page.content();\n\n let screenshotBase64: string | undefined;\n if (options.screenshot) {\n const buf = await page.screenshot({ fullPage: true });\n screenshotBase64 = buf.toString('base64');\n }\n\n return {\n url,\n finalUrl,\n html,\n contentType,\n statusCode,\n method: 'playwright',\n headers: responseHeaders,\n screenshot: screenshotBase64,\n actionResults,\n };\n } finally {\n await page.close();\n if (cdpBrowser) {\n await cdpBrowser.close().catch(() => {});\n } else {\n this.releaseForType(resolvedType, ctx);\n }\n }\n }\n\n async shutdown(): Promise<void> {\n if (this.shutdownCalled) return;\n this.shutdownCalled = true;\n\n for (const [type, typePool] of this.pools) {\n for (const [, timer] of typePool.idleTimers) {\n clearTimeout(timer);\n }\n typePool.idleTimers.clear();\n\n const closePromises = typePool.pool.map(ctx => ctx.close().catch(() => {}));\n typePool.pool = [];\n await Promise.all(closePromises);\n\n if (typePool.browser) {\n await typePool.browser.close().catch(() => {});\n typePool.browser = null;\n }\n\n typePool.activeCount = 0;\n log.debug('browser pool shut down', { type });\n }\n }\n}\n\n// Backwards-compatible wrapper for existing code\nexport class BrowserPool extends MultiBrowserPool {\n private readonly singleType: BrowserType;\n\n constructor(options?: BrowserPoolOptions) {\n const type = options?.browserType ?? 'chromium';\n super({\n browserTypes: [type],\n });\n this.singleType = type;\n }\n\n async acquire(): Promise<BrowserContext> {\n return this.acquireForType(this.singleType);\n }\n\n release(ctx: BrowserContext): void {\n this.releaseForType(this.singleType, ctx);\n }\n}\n"],"mappings":"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","names":["page","statusCode","finalUrl","responseHeaders","contentType"]}
@@ -0,0 +1,17 @@
1
+ import type { BrowserType } from '../types.js';
2
+ export type SelectionStrategy = 'round-robin' | 'hostname-hash' | 'random';
3
+ export declare class BrowserSelector {
4
+ private readonly types;
5
+ private readonly strategy;
6
+ private roundRobinIndex;
7
+ constructor(types: BrowserType[], strategy?: SelectionStrategy);
8
+ select(): BrowserType;
9
+ selectForHostname(hostname: string): BrowserType;
10
+ getTypes(): BrowserType[];
11
+ getStrategy(): SelectionStrategy;
12
+ reset(): void;
13
+ private selectRoundRobin;
14
+ private selectRandom;
15
+ private selectByHostnameHash;
16
+ }
17
+ //# sourceMappingURL=browser-selector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser-selector.d.ts","sourceRoot":"","sources":["../../src/fetch/browser-selector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,eAAe,GAAG,QAAQ,CAAC;AAY3E,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,eAAe,CAAK;gBAEhB,KAAK,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,EAAE,iBAAiB;IAY9D,MAAM,IAAI,WAAW;IAcrB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW;IAOhD,QAAQ,IAAI,WAAW,EAAE;IAIzB,WAAW,IAAI,iBAAiB;IAIhC,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,oBAAoB;CAK7B"}
@@ -0,0 +1,72 @@
1
+ import { createLogger } from "../logger.js";
2
+ const log = createLogger("fetch");
3
+ function hashString(str) {
4
+ let hash = 0;
5
+ for (let i = 0; i < str.length; i++) {
6
+ const char = str.charCodeAt(i);
7
+ hash = (hash << 5) - hash + char;
8
+ hash = hash & hash;
9
+ }
10
+ return Math.abs(hash);
11
+ }
12
+ class BrowserSelector {
13
+ types;
14
+ strategy;
15
+ roundRobinIndex = 0;
16
+ constructor(types, strategy) {
17
+ if (types.length === 0) {
18
+ throw new Error("BrowserSelector requires at least one browser type");
19
+ }
20
+ this.types = [...types];
21
+ this.strategy = strategy ?? "round-robin";
22
+ log.debug("browser selector initialized", {
23
+ types: this.types,
24
+ strategy: this.strategy
25
+ });
26
+ }
27
+ select() {
28
+ switch (this.strategy) {
29
+ case "round-robin":
30
+ return this.selectRoundRobin();
31
+ case "random":
32
+ return this.selectRandom();
33
+ case "hostname-hash":
34
+ return this.selectRoundRobin();
35
+ default:
36
+ return this.selectRoundRobin();
37
+ }
38
+ }
39
+ selectForHostname(hostname) {
40
+ if (this.strategy === "hostname-hash" && hostname) {
41
+ return this.selectByHostnameHash(hostname);
42
+ }
43
+ return this.select();
44
+ }
45
+ getTypes() {
46
+ return [...this.types];
47
+ }
48
+ getStrategy() {
49
+ return this.strategy;
50
+ }
51
+ reset() {
52
+ this.roundRobinIndex = 0;
53
+ }
54
+ selectRoundRobin() {
55
+ const type = this.types[this.roundRobinIndex % this.types.length];
56
+ this.roundRobinIndex++;
57
+ return type;
58
+ }
59
+ selectRandom() {
60
+ const index = Math.floor(Math.random() * this.types.length);
61
+ return this.types[index];
62
+ }
63
+ selectByHostnameHash(hostname) {
64
+ const hash = hashString(hostname);
65
+ const index = hash % this.types.length;
66
+ return this.types[index];
67
+ }
68
+ }
69
+ export {
70
+ BrowserSelector
71
+ };
72
+ //# sourceMappingURL=browser-selector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/fetch/browser-selector.ts"],"sourcesContent":["import { createLogger } from '../logger.js';\nimport type { BrowserType } from '../types.js';\n\nconst log = createLogger('fetch');\n\nexport type SelectionStrategy = 'round-robin' | 'hostname-hash' | 'random';\n\nfunction hashString(str: string): number {\n let hash = 0;\n for (let i = 0; i < str.length; i++) {\n const char = str.charCodeAt(i);\n hash = ((hash << 5) - hash) + char;\n hash = hash & hash; // Convert to 32-bit integer\n }\n return Math.abs(hash);\n}\n\nexport class BrowserSelector {\n private readonly types: BrowserType[];\n private readonly strategy: SelectionStrategy;\n private roundRobinIndex = 0;\n\n constructor(types: BrowserType[], strategy?: SelectionStrategy) {\n if (types.length === 0) {\n throw new Error('BrowserSelector requires at least one browser type');\n }\n this.types = [...types];\n this.strategy = strategy ?? 'round-robin';\n log.debug('browser selector initialized', {\n types: this.types,\n strategy: this.strategy,\n });\n }\n\n select(): BrowserType {\n switch (this.strategy) {\n case 'round-robin':\n return this.selectRoundRobin();\n case 'random':\n return this.selectRandom();\n case 'hostname-hash':\n // Without a hostname, fall back to round-robin\n return this.selectRoundRobin();\n default:\n return this.selectRoundRobin();\n }\n }\n\n selectForHostname(hostname: string): BrowserType {\n if (this.strategy === 'hostname-hash' && hostname) {\n return this.selectByHostnameHash(hostname);\n }\n return this.select();\n }\n\n getTypes(): BrowserType[] {\n return [...this.types];\n }\n\n getStrategy(): SelectionStrategy {\n return this.strategy;\n }\n\n reset(): void {\n this.roundRobinIndex = 0;\n }\n\n private selectRoundRobin(): BrowserType {\n const type = this.types[this.roundRobinIndex % this.types.length];\n this.roundRobinIndex++;\n return type;\n }\n\n private selectRandom(): BrowserType {\n const index = Math.floor(Math.random() * this.types.length);\n return this.types[index];\n }\n\n private selectByHostnameHash(hostname: string): BrowserType {\n const hash = hashString(hostname);\n const index = hash % this.types.length;\n return this.types[index];\n }\n}\n"],"mappings":"AAAA,SAAS,oBAAoB;AAG7B,MAAM,MAAM,aAAa,OAAO;AAIhC,SAAS,WAAW,KAAqB;AACvC,MAAI,OAAO;AACX,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,UAAM,OAAO,IAAI,WAAW,CAAC;AAC7B,YAAS,QAAQ,KAAK,OAAQ;AAC9B,WAAO,OAAO;AAAA,EAChB;AACA,SAAO,KAAK,IAAI,IAAI;AACtB;AAEO,MAAM,gBAAgB;AAAA,EACV;AAAA,EACA;AAAA,EACT,kBAAkB;AAAA,EAE1B,YAAY,OAAsB,UAA8B;AAC9D,QAAI,MAAM,WAAW,GAAG;AACtB,YAAM,IAAI,MAAM,oDAAoD;AAAA,IACtE;AACA,SAAK,QAAQ,CAAC,GAAG,KAAK;AACtB,SAAK,WAAW,YAAY;AAC5B,QAAI,MAAM,gCAAgC;AAAA,MACxC,OAAO,KAAK;AAAA,MACZ,UAAU,KAAK;AAAA,IACjB,CAAC;AAAA,EACH;AAAA,EAEA,SAAsB;AACpB,YAAQ,KAAK,UAAU;AAAA,MACrB,KAAK;AACH,eAAO,KAAK,iBAAiB;AAAA,MAC/B,KAAK;AACH,eAAO,KAAK,aAAa;AAAA,MAC3B,KAAK;AAEH,eAAO,KAAK,iBAAiB;AAAA,MAC/B;AACE,eAAO,KAAK,iBAAiB;AAAA,IACjC;AAAA,EACF;AAAA,EAEA,kBAAkB,UAA+B;AAC/C,QAAI,KAAK,aAAa,mBAAmB,UAAU;AACjD,aAAO,KAAK,qBAAqB,QAAQ;AAAA,IAC3C;AACA,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,WAA0B;AACxB,WAAO,CAAC,GAAG,KAAK,KAAK;AAAA,EACvB;AAAA,EAEA,cAAiC;AAC/B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,QAAc;AACZ,SAAK,kBAAkB;AAAA,EACzB;AAAA,EAEQ,mBAAgC;AACtC,UAAM,OAAO,KAAK,MAAM,KAAK,kBAAkB,KAAK,MAAM,MAAM;AAChE,SAAK;AACL,WAAO;AAAA,EACT;AAAA,EAEQ,eAA4B;AAClC,UAAM,QAAQ,KAAK,MAAM,KAAK,OAAO,IAAI,KAAK,MAAM,MAAM;AAC1D,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB;AAAA,EAEQ,qBAAqB,UAA+B;AAC1D,UAAM,OAAO,WAAW,QAAQ;AAChC,UAAM,QAAQ,OAAO,KAAK,MAAM;AAChC,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB;AACF;","names":[]}
@@ -0,0 +1,3 @@
1
+ import type { BrowserType } from '../types.js';
2
+ export declare function parseBrowserTypes(input: string | undefined | null): BrowserType[];
3
+ //# sourceMappingURL=browser-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"browser-types.d.ts","sourceRoot":"","sources":["../../src/fetch/browser-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAW/C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,WAAW,EAAE,CA6CjF"}
@@ -0,0 +1,45 @@
1
+ const VALID_BROWSER_TYPES = /* @__PURE__ */ new Set(["chromium", "firefox", "webkit", "lightpanda"]);
2
+ const DEFAULT_BROWSER_TYPES = ["chromium"];
3
+ function warn(msg, data) {
4
+ const line = JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), level: "warn", msg, module: "fetch", data });
5
+ process.stderr.write(line + "\n");
6
+ }
7
+ function parseBrowserTypes(input) {
8
+ if (!input || typeof input !== "string") {
9
+ return [...DEFAULT_BROWSER_TYPES];
10
+ }
11
+ const trimmed = input.trim();
12
+ if (trimmed.length === 0) {
13
+ return [...DEFAULT_BROWSER_TYPES];
14
+ }
15
+ const parts = trimmed.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
16
+ if (parts.length === 0) {
17
+ return [...DEFAULT_BROWSER_TYPES];
18
+ }
19
+ const seen = /* @__PURE__ */ new Set();
20
+ const valid = [];
21
+ const invalid = [];
22
+ for (const part of parts) {
23
+ if (!VALID_BROWSER_TYPES.has(part)) {
24
+ invalid.push(part);
25
+ continue;
26
+ }
27
+ if (seen.has(part)) {
28
+ continue;
29
+ }
30
+ seen.add(part);
31
+ valid.push(part);
32
+ }
33
+ if (invalid.length > 0) {
34
+ warn("ignored invalid browser types", { invalid, valid: [...valid] });
35
+ }
36
+ if (valid.length === 0) {
37
+ warn("no valid browser types found, falling back to chromium", { input });
38
+ return [...DEFAULT_BROWSER_TYPES];
39
+ }
40
+ return valid;
41
+ }
42
+ export {
43
+ parseBrowserTypes
44
+ };
45
+ //# sourceMappingURL=browser-types.js.map