claude-chrome-parallel 1.0.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 (395) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +501 -0
  3. package/assets/demo.svg +278 -0
  4. package/dist/cdp/client.d.ts +218 -0
  5. package/dist/cdp/client.d.ts.map +1 -0
  6. package/dist/cdp/client.js +797 -0
  7. package/dist/cdp/client.js.map +1 -0
  8. package/dist/cdp/connection-pool.d.ts +125 -0
  9. package/dist/cdp/connection-pool.d.ts.map +1 -0
  10. package/dist/cdp/connection-pool.js +443 -0
  11. package/dist/cdp/connection-pool.js.map +1 -0
  12. package/dist/cdp/screenshot-scheduler.d.ts +54 -0
  13. package/dist/cdp/screenshot-scheduler.d.ts.map +1 -0
  14. package/dist/cdp/screenshot-scheduler.js +87 -0
  15. package/dist/cdp/screenshot-scheduler.js.map +1 -0
  16. package/dist/chrome/launcher.d.ts +55 -0
  17. package/dist/chrome/launcher.d.ts.map +1 -0
  18. package/dist/chrome/launcher.js +383 -0
  19. package/dist/chrome/launcher.js.map +1 -0
  20. package/dist/chrome/pool.d.ts +54 -0
  21. package/dist/chrome/pool.d.ts.map +1 -0
  22. package/dist/chrome/pool.js +301 -0
  23. package/dist/chrome/pool.js.map +1 -0
  24. package/dist/chrome/profile-detector.d.ts +52 -0
  25. package/dist/chrome/profile-detector.d.ts.map +1 -0
  26. package/dist/chrome/profile-detector.js +246 -0
  27. package/dist/chrome/profile-detector.js.map +1 -0
  28. package/dist/cli/claude-session.d.ts +11 -0
  29. package/dist/cli/claude-session.js +349 -0
  30. package/dist/cli/claude-session.js.map +1 -0
  31. package/dist/cli/index.d.ts +14 -0
  32. package/dist/cli/index.js +858 -0
  33. package/dist/cli/index.js.map +1 -0
  34. package/dist/cli/install.d.ts +16 -0
  35. package/dist/cli/install.js +185 -0
  36. package/dist/cli/install.js.map +1 -0
  37. package/dist/cli/uninstall.d.ts +7 -0
  38. package/dist/cli/uninstall.js +126 -0
  39. package/dist/cli/uninstall.js.map +1 -0
  40. package/dist/cli/update-check.d.ts +9 -0
  41. package/dist/cli/update-check.js +141 -0
  42. package/dist/cli/update-check.js.map +1 -0
  43. package/dist/config/config-recovery.d.ts +69 -0
  44. package/dist/config/config-recovery.d.ts.map +1 -0
  45. package/dist/config/config-recovery.js +302 -0
  46. package/dist/config/config-recovery.js.map +1 -0
  47. package/dist/config/global.d.ts +49 -0
  48. package/dist/config/global.d.ts.map +1 -0
  49. package/dist/config/global.js +24 -0
  50. package/dist/config/global.js.map +1 -0
  51. package/dist/config/index.d.ts +7 -0
  52. package/dist/config/index.d.ts.map +1 -0
  53. package/dist/config/index.js +23 -0
  54. package/dist/config/index.js.map +1 -0
  55. package/dist/config/session-isolator.d.ts +76 -0
  56. package/dist/config/session-isolator.d.ts.map +1 -0
  57. package/dist/config/session-isolator.js +268 -0
  58. package/dist/config/session-isolator.js.map +1 -0
  59. package/dist/dashboard/activity-tracker.d.ts +76 -0
  60. package/dist/dashboard/activity-tracker.d.ts.map +1 -0
  61. package/dist/dashboard/activity-tracker.js +219 -0
  62. package/dist/dashboard/activity-tracker.js.map +1 -0
  63. package/dist/dashboard/ansi.d.ts +117 -0
  64. package/dist/dashboard/ansi.d.ts.map +1 -0
  65. package/dist/dashboard/ansi.js +199 -0
  66. package/dist/dashboard/ansi.js.map +1 -0
  67. package/dist/dashboard/index.d.ts +110 -0
  68. package/dist/dashboard/index.d.ts.map +1 -0
  69. package/dist/dashboard/index.js +412 -0
  70. package/dist/dashboard/index.js.map +1 -0
  71. package/dist/dashboard/keyboard-handler.d.ts +43 -0
  72. package/dist/dashboard/keyboard-handler.d.ts.map +1 -0
  73. package/dist/dashboard/keyboard-handler.js +215 -0
  74. package/dist/dashboard/keyboard-handler.js.map +1 -0
  75. package/dist/dashboard/operation-controller.d.ts +76 -0
  76. package/dist/dashboard/operation-controller.d.ts.map +1 -0
  77. package/dist/dashboard/operation-controller.js +167 -0
  78. package/dist/dashboard/operation-controller.js.map +1 -0
  79. package/dist/dashboard/renderer.d.ts +76 -0
  80. package/dist/dashboard/renderer.d.ts.map +1 -0
  81. package/dist/dashboard/renderer.js +193 -0
  82. package/dist/dashboard/renderer.js.map +1 -0
  83. package/dist/dashboard/types.d.ts +56 -0
  84. package/dist/dashboard/types.d.ts.map +1 -0
  85. package/dist/dashboard/types.js +12 -0
  86. package/dist/dashboard/types.js.map +1 -0
  87. package/dist/dashboard/views/main-view.d.ts +23 -0
  88. package/dist/dashboard/views/main-view.d.ts.map +1 -0
  89. package/dist/dashboard/views/main-view.js +143 -0
  90. package/dist/dashboard/views/main-view.js.map +1 -0
  91. package/dist/dashboard/views/sessions-view.d.ts +22 -0
  92. package/dist/dashboard/views/sessions-view.d.ts.map +1 -0
  93. package/dist/dashboard/views/sessions-view.js +104 -0
  94. package/dist/dashboard/views/sessions-view.js.map +1 -0
  95. package/dist/dashboard/views/tabs-view.d.ts +21 -0
  96. package/dist/dashboard/views/tabs-view.d.ts.map +1 -0
  97. package/dist/dashboard/views/tabs-view.js +92 -0
  98. package/dist/dashboard/views/tabs-view.js.map +1 -0
  99. package/dist/hints/hint-engine.d.ts +77 -0
  100. package/dist/hints/hint-engine.d.ts.map +1 -0
  101. package/dist/hints/hint-engine.js +191 -0
  102. package/dist/hints/hint-engine.js.map +1 -0
  103. package/dist/hints/index.d.ts +8 -0
  104. package/dist/hints/index.d.ts.map +1 -0
  105. package/dist/hints/index.js +11 -0
  106. package/dist/hints/index.js.map +1 -0
  107. package/dist/hints/pattern-learner.d.ts +76 -0
  108. package/dist/hints/pattern-learner.d.ts.map +1 -0
  109. package/dist/hints/pattern-learner.js +254 -0
  110. package/dist/hints/pattern-learner.js.map +1 -0
  111. package/dist/hints/rules/composite-suggestions.d.ts +6 -0
  112. package/dist/hints/rules/composite-suggestions.d.ts.map +1 -0
  113. package/dist/hints/rules/composite-suggestions.js +66 -0
  114. package/dist/hints/rules/composite-suggestions.js.map +1 -0
  115. package/dist/hints/rules/error-recovery.d.ts +7 -0
  116. package/dist/hints/rules/error-recovery.d.ts.map +1 -0
  117. package/dist/hints/rules/error-recovery.js +55 -0
  118. package/dist/hints/rules/error-recovery.js.map +1 -0
  119. package/dist/hints/rules/learned-rules.d.ts +13 -0
  120. package/dist/hints/rules/learned-rules.d.ts.map +1 -0
  121. package/dist/hints/rules/learned-rules.js +27 -0
  122. package/dist/hints/rules/learned-rules.js.map +1 -0
  123. package/dist/hints/rules/repetition-detection.d.ts +7 -0
  124. package/dist/hints/rules/repetition-detection.d.ts.map +1 -0
  125. package/dist/hints/rules/repetition-detection.js +82 -0
  126. package/dist/hints/rules/repetition-detection.js.map +1 -0
  127. package/dist/hints/rules/sequence-detection.d.ts +6 -0
  128. package/dist/hints/rules/sequence-detection.d.ts.map +1 -0
  129. package/dist/hints/rules/sequence-detection.js +89 -0
  130. package/dist/hints/rules/sequence-detection.js.map +1 -0
  131. package/dist/hints/rules/success-hints.d.ts +6 -0
  132. package/dist/hints/rules/success-hints.d.ts.map +1 -0
  133. package/dist/hints/rules/success-hints.js +62 -0
  134. package/dist/hints/rules/success-hints.js.map +1 -0
  135. package/dist/index.d.ts +10 -0
  136. package/dist/index.d.ts.map +1 -0
  137. package/dist/index.js +272 -0
  138. package/dist/index.js.map +1 -0
  139. package/dist/lightpanda/launcher.d.ts +58 -0
  140. package/dist/lightpanda/launcher.d.ts.map +1 -0
  141. package/dist/lightpanda/launcher.js +199 -0
  142. package/dist/lightpanda/launcher.js.map +1 -0
  143. package/dist/mcp-server.d.ts +129 -0
  144. package/dist/mcp-server.d.ts.map +1 -0
  145. package/dist/mcp-server.js +641 -0
  146. package/dist/mcp-server.js.map +1 -0
  147. package/dist/memory/domain-memory.d.ts +68 -0
  148. package/dist/memory/domain-memory.d.ts.map +1 -0
  149. package/dist/memory/domain-memory.js +227 -0
  150. package/dist/memory/domain-memory.js.map +1 -0
  151. package/dist/orchestration/plan-executor.d.ts +19 -0
  152. package/dist/orchestration/plan-executor.d.ts.map +1 -0
  153. package/dist/orchestration/plan-executor.js +284 -0
  154. package/dist/orchestration/plan-executor.js.map +1 -0
  155. package/dist/orchestration/plan-registry.d.ts +55 -0
  156. package/dist/orchestration/plan-registry.d.ts.map +1 -0
  157. package/dist/orchestration/plan-registry.js +255 -0
  158. package/dist/orchestration/plan-registry.js.map +1 -0
  159. package/dist/orchestration/state-manager.d.ts +127 -0
  160. package/dist/orchestration/state-manager.d.ts.map +1 -0
  161. package/dist/orchestration/state-manager.js +438 -0
  162. package/dist/orchestration/state-manager.js.map +1 -0
  163. package/dist/orchestration/workflow-engine.d.ts +162 -0
  164. package/dist/orchestration/workflow-engine.d.ts.map +1 -0
  165. package/dist/orchestration/workflow-engine.js +731 -0
  166. package/dist/orchestration/workflow-engine.js.map +1 -0
  167. package/dist/resources/usage-guide.d.ts +13 -0
  168. package/dist/resources/usage-guide.d.ts.map +1 -0
  169. package/dist/resources/usage-guide.js +101 -0
  170. package/dist/resources/usage-guide.js.map +1 -0
  171. package/dist/router/browser-router.d.ts +51 -0
  172. package/dist/router/browser-router.d.ts.map +1 -0
  173. package/dist/router/browser-router.js +178 -0
  174. package/dist/router/browser-router.js.map +1 -0
  175. package/dist/router/cookie-sync.d.ts +48 -0
  176. package/dist/router/cookie-sync.d.ts.map +1 -0
  177. package/dist/router/cookie-sync.js +106 -0
  178. package/dist/router/cookie-sync.js.map +1 -0
  179. package/dist/router/index.d.ts +5 -0
  180. package/dist/router/index.d.ts.map +1 -0
  181. package/dist/router/index.js +10 -0
  182. package/dist/router/index.js.map +1 -0
  183. package/dist/router/tool-routing-registry.d.ts +21 -0
  184. package/dist/router/tool-routing-registry.d.ts.map +1 -0
  185. package/dist/router/tool-routing-registry.js +90 -0
  186. package/dist/router/tool-routing-registry.js.map +1 -0
  187. package/dist/session-manager.d.ts +251 -0
  188. package/dist/session-manager.d.ts.map +1 -0
  189. package/dist/session-manager.js +912 -0
  190. package/dist/session-manager.js.map +1 -0
  191. package/dist/tools/batch-execute.d.ts +11 -0
  192. package/dist/tools/batch-execute.d.ts.map +1 -0
  193. package/dist/tools/batch-execute.js +226 -0
  194. package/dist/tools/batch-execute.js.map +1 -0
  195. package/dist/tools/click-element.d.ts +8 -0
  196. package/dist/tools/click-element.d.ts.map +1 -0
  197. package/dist/tools/click-element.js +455 -0
  198. package/dist/tools/click-element.js.map +1 -0
  199. package/dist/tools/computer.d.ts +6 -0
  200. package/dist/tools/computer.d.ts.map +1 -0
  201. package/dist/tools/computer.js +638 -0
  202. package/dist/tools/computer.js.map +1 -0
  203. package/dist/tools/console-capture.d.ts +6 -0
  204. package/dist/tools/console-capture.d.ts.map +1 -0
  205. package/dist/tools/console-capture.js +320 -0
  206. package/dist/tools/console-capture.js.map +1 -0
  207. package/dist/tools/cookies.d.ts +6 -0
  208. package/dist/tools/cookies.d.ts.map +1 -0
  209. package/dist/tools/cookies.js +263 -0
  210. package/dist/tools/cookies.js.map +1 -0
  211. package/dist/tools/drag-drop.d.ts +6 -0
  212. package/dist/tools/drag-drop.d.ts.map +1 -0
  213. package/dist/tools/drag-drop.js +252 -0
  214. package/dist/tools/drag-drop.js.map +1 -0
  215. package/dist/tools/emulate-device.d.ts +6 -0
  216. package/dist/tools/emulate-device.d.ts.map +1 -0
  217. package/dist/tools/emulate-device.js +221 -0
  218. package/dist/tools/emulate-device.js.map +1 -0
  219. package/dist/tools/file-upload.d.ts +6 -0
  220. package/dist/tools/file-upload.d.ts.map +1 -0
  221. package/dist/tools/file-upload.js +208 -0
  222. package/dist/tools/file-upload.js.map +1 -0
  223. package/dist/tools/fill-form.d.ts +8 -0
  224. package/dist/tools/fill-form.d.ts.map +1 -0
  225. package/dist/tools/fill-form.js +342 -0
  226. package/dist/tools/fill-form.js.map +1 -0
  227. package/dist/tools/find.d.ts +6 -0
  228. package/dist/tools/find.d.ts.map +1 -0
  229. package/dist/tools/find.js +330 -0
  230. package/dist/tools/find.js.map +1 -0
  231. package/dist/tools/form-input.d.ts +6 -0
  232. package/dist/tools/form-input.d.ts.map +1 -0
  233. package/dist/tools/form-input.js +181 -0
  234. package/dist/tools/form-input.js.map +1 -0
  235. package/dist/tools/geolocation.d.ts +6 -0
  236. package/dist/tools/geolocation.d.ts.map +1 -0
  237. package/dist/tools/geolocation.js +172 -0
  238. package/dist/tools/geolocation.js.map +1 -0
  239. package/dist/tools/http-auth.d.ts +6 -0
  240. package/dist/tools/http-auth.d.ts.map +1 -0
  241. package/dist/tools/http-auth.js +136 -0
  242. package/dist/tools/http-auth.js.map +1 -0
  243. package/dist/tools/index.d.ts +6 -0
  244. package/dist/tools/index.d.ts.map +1 -0
  245. package/dist/tools/index.js +104 -0
  246. package/dist/tools/index.js.map +1 -0
  247. package/dist/tools/javascript.d.ts +6 -0
  248. package/dist/tools/javascript.d.ts.map +1 -0
  249. package/dist/tools/javascript.js +138 -0
  250. package/dist/tools/javascript.js.map +1 -0
  251. package/dist/tools/lightweight-scroll.d.ts +11 -0
  252. package/dist/tools/lightweight-scroll.d.ts.map +1 -0
  253. package/dist/tools/lightweight-scroll.js +266 -0
  254. package/dist/tools/lightweight-scroll.js.map +1 -0
  255. package/dist/tools/memory.d.ts +10 -0
  256. package/dist/tools/memory.d.ts.map +1 -0
  257. package/dist/tools/memory.js +141 -0
  258. package/dist/tools/memory.js.map +1 -0
  259. package/dist/tools/navigate.d.ts +6 -0
  260. package/dist/tools/navigate.d.ts.map +1 -0
  261. package/dist/tools/navigate.js +241 -0
  262. package/dist/tools/navigate.js.map +1 -0
  263. package/dist/tools/network.d.ts +6 -0
  264. package/dist/tools/network.d.ts.map +1 -0
  265. package/dist/tools/network.js +215 -0
  266. package/dist/tools/network.js.map +1 -0
  267. package/dist/tools/orchestration.d.ts +6 -0
  268. package/dist/tools/orchestration.d.ts.map +1 -0
  269. package/dist/tools/orchestration.js +746 -0
  270. package/dist/tools/orchestration.js.map +1 -0
  271. package/dist/tools/page-content.d.ts +6 -0
  272. package/dist/tools/page-content.d.ts.map +1 -0
  273. package/dist/tools/page-content.js +120 -0
  274. package/dist/tools/page-content.js.map +1 -0
  275. package/dist/tools/page-pdf.d.ts +6 -0
  276. package/dist/tools/page-pdf.d.ts.map +1 -0
  277. package/dist/tools/page-pdf.js +245 -0
  278. package/dist/tools/page-pdf.js.map +1 -0
  279. package/dist/tools/page-reload.d.ts +6 -0
  280. package/dist/tools/page-reload.d.ts.map +1 -0
  281. package/dist/tools/page-reload.js +89 -0
  282. package/dist/tools/page-reload.js.map +1 -0
  283. package/dist/tools/performance-metrics.d.ts +6 -0
  284. package/dist/tools/performance-metrics.d.ts.map +1 -0
  285. package/dist/tools/performance-metrics.js +158 -0
  286. package/dist/tools/performance-metrics.js.map +1 -0
  287. package/dist/tools/read-page.d.ts +6 -0
  288. package/dist/tools/read-page.d.ts.map +1 -0
  289. package/dist/tools/read-page.js +287 -0
  290. package/dist/tools/read-page.js.map +1 -0
  291. package/dist/tools/request-intercept.d.ts +6 -0
  292. package/dist/tools/request-intercept.d.ts.map +1 -0
  293. package/dist/tools/request-intercept.js +439 -0
  294. package/dist/tools/request-intercept.js.map +1 -0
  295. package/dist/tools/selector-query.d.ts +6 -0
  296. package/dist/tools/selector-query.d.ts.map +1 -0
  297. package/dist/tools/selector-query.js +206 -0
  298. package/dist/tools/selector-query.js.map +1 -0
  299. package/dist/tools/shutdown.d.ts +12 -0
  300. package/dist/tools/shutdown.d.ts.map +1 -0
  301. package/dist/tools/shutdown.js +120 -0
  302. package/dist/tools/shutdown.js.map +1 -0
  303. package/dist/tools/storage.d.ts +6 -0
  304. package/dist/tools/storage.d.ts.map +1 -0
  305. package/dist/tools/storage.js +264 -0
  306. package/dist/tools/storage.js.map +1 -0
  307. package/dist/tools/tabs-close.d.ts +6 -0
  308. package/dist/tools/tabs-close.d.ts.map +1 -0
  309. package/dist/tools/tabs-close.js +124 -0
  310. package/dist/tools/tabs-close.js.map +1 -0
  311. package/dist/tools/tabs-context.d.ts +6 -0
  312. package/dist/tools/tabs-context.d.ts.map +1 -0
  313. package/dist/tools/tabs-context.js +92 -0
  314. package/dist/tools/tabs-context.js.map +1 -0
  315. package/dist/tools/tabs-create.d.ts +6 -0
  316. package/dist/tools/tabs-create.d.ts.map +1 -0
  317. package/dist/tools/tabs-create.js +73 -0
  318. package/dist/tools/tabs-create.js.map +1 -0
  319. package/dist/tools/user-agent.d.ts +6 -0
  320. package/dist/tools/user-agent.d.ts.map +1 -0
  321. package/dist/tools/user-agent.js +128 -0
  322. package/dist/tools/user-agent.js.map +1 -0
  323. package/dist/tools/wait-and-click.d.ts +8 -0
  324. package/dist/tools/wait-and-click.d.ts.map +1 -0
  325. package/dist/tools/wait-and-click.js +290 -0
  326. package/dist/tools/wait-and-click.js.map +1 -0
  327. package/dist/tools/wait-for.d.ts +6 -0
  328. package/dist/tools/wait-for.d.ts.map +1 -0
  329. package/dist/tools/wait-for.js +248 -0
  330. package/dist/tools/wait-for.js.map +1 -0
  331. package/dist/tools/worker-create.d.ts +7 -0
  332. package/dist/tools/worker-create.d.ts.map +1 -0
  333. package/dist/tools/worker-create.js +62 -0
  334. package/dist/tools/worker-create.js.map +1 -0
  335. package/dist/tools/worker-delete.d.ts +6 -0
  336. package/dist/tools/worker-delete.d.ts.map +1 -0
  337. package/dist/tools/worker-delete.js +80 -0
  338. package/dist/tools/worker-delete.js.map +1 -0
  339. package/dist/tools/worker-list.d.ts +6 -0
  340. package/dist/tools/worker-list.d.ts.map +1 -0
  341. package/dist/tools/worker-list.js +67 -0
  342. package/dist/tools/worker-list.js.map +1 -0
  343. package/dist/tools/xpath-query.d.ts +6 -0
  344. package/dist/tools/xpath-query.d.ts.map +1 -0
  345. package/dist/tools/xpath-query.js +230 -0
  346. package/dist/tools/xpath-query.js.map +1 -0
  347. package/dist/types/browser-backend.d.ts +30 -0
  348. package/dist/types/browser-backend.d.ts.map +1 -0
  349. package/dist/types/browser-backend.js +9 -0
  350. package/dist/types/browser-backend.js.map +1 -0
  351. package/dist/types/index.d.ts +3 -0
  352. package/dist/types/index.d.ts.map +1 -0
  353. package/dist/types/index.js +19 -0
  354. package/dist/types/index.js.map +1 -0
  355. package/dist/types/mcp.d.ts +54 -0
  356. package/dist/types/mcp.d.ts.map +1 -0
  357. package/dist/types/mcp.js +14 -0
  358. package/dist/types/mcp.js.map +1 -0
  359. package/dist/types/plan-cache.d.ts +121 -0
  360. package/dist/types/plan-cache.d.ts.map +1 -0
  361. package/dist/types/plan-cache.js +9 -0
  362. package/dist/types/plan-cache.js.map +1 -0
  363. package/dist/types/profile.d.ts +76 -0
  364. package/dist/types/profile.d.ts.map +1 -0
  365. package/dist/types/profile.js +35 -0
  366. package/dist/types/profile.js.map +1 -0
  367. package/dist/types/session.d.ts +65 -0
  368. package/dist/types/session.d.ts.map +1 -0
  369. package/dist/types/session.js +6 -0
  370. package/dist/types/session.js.map +1 -0
  371. package/dist/types/tool-manifest.d.ts +52 -0
  372. package/dist/types/tool-manifest.d.ts.map +1 -0
  373. package/dist/types/tool-manifest.js +37 -0
  374. package/dist/types/tool-manifest.js.map +1 -0
  375. package/dist/utils/atomic-file.d.ts +50 -0
  376. package/dist/utils/atomic-file.d.ts.map +1 -0
  377. package/dist/utils/atomic-file.js +217 -0
  378. package/dist/utils/atomic-file.js.map +1 -0
  379. package/dist/utils/index.d.ts +6 -0
  380. package/dist/utils/index.d.ts.map +1 -0
  381. package/dist/utils/index.js +22 -0
  382. package/dist/utils/index.js.map +1 -0
  383. package/dist/utils/json-validator.d.ts +40 -0
  384. package/dist/utils/json-validator.d.ts.map +1 -0
  385. package/dist/utils/json-validator.js +295 -0
  386. package/dist/utils/json-validator.js.map +1 -0
  387. package/dist/utils/ref-id-manager.d.ts +26 -0
  388. package/dist/utils/ref-id-manager.d.ts.map +1 -0
  389. package/dist/utils/ref-id-manager.js +81 -0
  390. package/dist/utils/ref-id-manager.js.map +1 -0
  391. package/dist/utils/request-queue.d.ts +37 -0
  392. package/dist/utils/request-queue.d.ts.map +1 -0
  393. package/dist/utils/request-queue.js +110 -0
  394. package/dist/utils/request-queue.js.map +1 -0
  395. package/package.json +78 -0
@@ -0,0 +1,439 @@
1
+ "use strict";
2
+ /**
3
+ * Request Intercept Tool - Intercept and modify network requests
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.registerRequestInterceptTool = registerRequestInterceptTool;
7
+ const session_manager_1 = require("../session-manager");
8
+ // Module-level state storage
9
+ const interceptStates = new Map();
10
+ // Helper function to match URL patterns (glob-like)
11
+ function matchesPattern(url, pattern) {
12
+ // Convert glob pattern to regex
13
+ const regexPattern = pattern
14
+ .replace(/[.+^${}()|[\]\\]/g, '\\$&')
15
+ .replace(/\*/g, '.*')
16
+ .replace(/\?/g, '.');
17
+ try {
18
+ return new RegExp(`^${regexPattern}$`, 'i').test(url);
19
+ }
20
+ catch {
21
+ return url.includes(pattern);
22
+ }
23
+ }
24
+ const definition = {
25
+ name: 'request_intercept',
26
+ description: `Intercept and control network requests.
27
+ Actions:
28
+ - "enable": Enable request interception
29
+ - "disable": Disable request interception
30
+ - "addRule": Add an intercept rule
31
+ - "removeRule": Remove a rule by ID
32
+ - "listRules": List all active rules
33
+ - "getLogs": Get logged requests
34
+ - "clearLogs": Clear request logs
35
+
36
+ Rule actions: "block" (abort request), "modify" (change response), "log" (just log)`,
37
+ inputSchema: {
38
+ type: 'object',
39
+ properties: {
40
+ tabId: {
41
+ type: 'string',
42
+ description: 'Tab ID to intercept requests for',
43
+ },
44
+ action: {
45
+ type: 'string',
46
+ enum: ['enable', 'disable', 'addRule', 'removeRule', 'listRules', 'getLogs', 'clearLogs'],
47
+ description: 'Action to perform',
48
+ },
49
+ rule: {
50
+ type: 'object',
51
+ description: 'Rule definition for addRule action',
52
+ properties: {
53
+ pattern: {
54
+ type: 'string',
55
+ description: 'URL pattern to match (glob-like, e.g., "*://example.com/*")',
56
+ },
57
+ resourceTypes: {
58
+ type: 'array',
59
+ items: { type: 'string' },
60
+ description: 'Resource types: document, stylesheet, image, font, script, xhr, fetch',
61
+ },
62
+ action: {
63
+ type: 'string',
64
+ enum: ['block', 'modify', 'log'],
65
+ description: 'What to do with matched requests',
66
+ },
67
+ modifyOptions: {
68
+ type: 'object',
69
+ description: 'Options for modify action',
70
+ properties: {
71
+ status: { type: 'number' },
72
+ headers: { type: 'object' },
73
+ body: { type: 'string' },
74
+ },
75
+ },
76
+ },
77
+ },
78
+ ruleId: {
79
+ type: 'string',
80
+ description: 'Rule ID for removeRule action',
81
+ },
82
+ limit: {
83
+ type: 'number',
84
+ description: 'Maximum logs to return for getLogs action',
85
+ },
86
+ },
87
+ required: ['tabId', 'action'],
88
+ },
89
+ };
90
+ // Cleanup listener when session ends
91
+ const setupCleanupListener = (() => {
92
+ let initialized = false;
93
+ return () => {
94
+ if (initialized)
95
+ return;
96
+ initialized = true;
97
+ const sessionManager = (0, session_manager_1.getSessionManager)();
98
+ sessionManager.addEventListener((event) => {
99
+ if (event.type === 'session:target-closed' ||
100
+ event.type === 'session:target-removed') {
101
+ const targetId = event.targetId;
102
+ if (targetId) {
103
+ interceptStates.delete(targetId);
104
+ console.error(`[RequestIntercept] Cleaned up state for closed tab ${targetId}`);
105
+ }
106
+ }
107
+ });
108
+ };
109
+ })();
110
+ const handler = async (sessionId, args) => {
111
+ const tabId = args.tabId;
112
+ const action = args.action;
113
+ const ruleArg = args.rule;
114
+ const ruleId = args.ruleId;
115
+ const limit = args.limit;
116
+ const sessionManager = (0, session_manager_1.getSessionManager)();
117
+ // Setup cleanup listener on first use
118
+ setupCleanupListener();
119
+ if (!tabId) {
120
+ return {
121
+ content: [{ type: 'text', text: 'Error: tabId is required' }],
122
+ isError: true,
123
+ };
124
+ }
125
+ if (!action) {
126
+ return {
127
+ content: [{ type: 'text', text: 'Error: action is required' }],
128
+ isError: true,
129
+ };
130
+ }
131
+ try {
132
+ const page = await sessionManager.getPage(sessionId, tabId, undefined, 'request_intercept');
133
+ if (!page) {
134
+ return {
135
+ content: [{ type: 'text', text: `Error: Tab ${tabId} not found` }],
136
+ isError: true,
137
+ };
138
+ }
139
+ // Get or create state
140
+ let state = interceptStates.get(tabId);
141
+ if (!state) {
142
+ state = {
143
+ enabled: false,
144
+ rules: [],
145
+ listener: null,
146
+ loggedRequests: [],
147
+ maxLogs: 500,
148
+ };
149
+ interceptStates.set(tabId, state);
150
+ }
151
+ switch (action) {
152
+ case 'enable': {
153
+ if (state.enabled) {
154
+ return {
155
+ content: [
156
+ {
157
+ type: 'text',
158
+ text: JSON.stringify({
159
+ action: 'enable',
160
+ status: 'already_enabled',
161
+ rulesCount: state.rules.length,
162
+ }),
163
+ },
164
+ ],
165
+ };
166
+ }
167
+ await page.setRequestInterception(true);
168
+ // Create request listener
169
+ state.listener = async (request) => {
170
+ const url = request.url();
171
+ const resourceType = request.resourceType();
172
+ let matched = false;
173
+ let matchedRule = null;
174
+ // Check rules in order
175
+ for (const rule of state.rules) {
176
+ if (matchesPattern(url, rule.pattern)) {
177
+ // Check resource type filter
178
+ if (rule.resourceTypes && rule.resourceTypes.length > 0) {
179
+ if (!rule.resourceTypes.includes(resourceType)) {
180
+ continue;
181
+ }
182
+ }
183
+ matched = true;
184
+ matchedRule = rule;
185
+ break;
186
+ }
187
+ }
188
+ // Log request if any log rules exist or matched
189
+ const shouldLog = matched || state.rules.some(r => r.action === 'log');
190
+ if (shouldLog) {
191
+ state.loggedRequests.push({
192
+ url: url.slice(0, 200),
193
+ resourceType,
194
+ method: request.method(),
195
+ headers: request.headers(),
196
+ timestamp: Date.now(),
197
+ matched,
198
+ ruleId: matchedRule?.id,
199
+ });
200
+ // Trim logs
201
+ if (state.loggedRequests.length > state.maxLogs) {
202
+ state.loggedRequests = state.loggedRequests.slice(-state.maxLogs);
203
+ }
204
+ }
205
+ // Apply rule action
206
+ if (matchedRule) {
207
+ try {
208
+ if (matchedRule.action === 'block') {
209
+ await request.abort('blockedbyclient');
210
+ return;
211
+ }
212
+ if (matchedRule.action === 'modify' && matchedRule.modifyOptions) {
213
+ await request.respond({
214
+ status: matchedRule.modifyOptions.status || 200,
215
+ headers: matchedRule.modifyOptions.headers || {},
216
+ body: matchedRule.modifyOptions.body || '',
217
+ });
218
+ return;
219
+ }
220
+ }
221
+ catch (e) {
222
+ // Request might already be handled
223
+ }
224
+ }
225
+ // Continue with request
226
+ try {
227
+ await request.continue();
228
+ }
229
+ catch {
230
+ // Request might already be handled
231
+ }
232
+ };
233
+ page.on('request', state.listener);
234
+ state.enabled = true;
235
+ return {
236
+ content: [
237
+ {
238
+ type: 'text',
239
+ text: JSON.stringify({
240
+ action: 'enable',
241
+ status: 'enabled',
242
+ rulesCount: state.rules.length,
243
+ message: 'Request interception enabled',
244
+ }),
245
+ },
246
+ ],
247
+ };
248
+ }
249
+ case 'disable': {
250
+ if (!state.enabled) {
251
+ return {
252
+ content: [
253
+ {
254
+ type: 'text',
255
+ text: JSON.stringify({
256
+ action: 'disable',
257
+ status: 'already_disabled',
258
+ }),
259
+ },
260
+ ],
261
+ };
262
+ }
263
+ if (state.listener) {
264
+ page.off('request', state.listener);
265
+ state.listener = null;
266
+ }
267
+ await page.setRequestInterception(false);
268
+ state.enabled = false;
269
+ return {
270
+ content: [
271
+ {
272
+ type: 'text',
273
+ text: JSON.stringify({
274
+ action: 'disable',
275
+ status: 'disabled',
276
+ message: 'Request interception disabled',
277
+ }),
278
+ },
279
+ ],
280
+ };
281
+ }
282
+ case 'addRule': {
283
+ if (!ruleArg || !ruleArg.pattern || !ruleArg.action) {
284
+ return {
285
+ content: [
286
+ {
287
+ type: 'text',
288
+ text: 'Error: rule with pattern and action is required',
289
+ },
290
+ ],
291
+ isError: true,
292
+ };
293
+ }
294
+ const newRule = {
295
+ id: `rule-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
296
+ pattern: ruleArg.pattern,
297
+ resourceTypes: ruleArg.resourceTypes,
298
+ action: ruleArg.action,
299
+ modifyOptions: ruleArg.modifyOptions,
300
+ };
301
+ state.rules.push(newRule);
302
+ return {
303
+ content: [
304
+ {
305
+ type: 'text',
306
+ text: JSON.stringify({
307
+ action: 'addRule',
308
+ rule: newRule,
309
+ totalRules: state.rules.length,
310
+ message: `Added rule ${newRule.id}`,
311
+ }),
312
+ },
313
+ ],
314
+ };
315
+ }
316
+ case 'removeRule': {
317
+ if (!ruleId) {
318
+ return {
319
+ content: [{ type: 'text', text: 'Error: ruleId is required' }],
320
+ isError: true,
321
+ };
322
+ }
323
+ const index = state.rules.findIndex((r) => r.id === ruleId);
324
+ if (index === -1) {
325
+ return {
326
+ content: [
327
+ {
328
+ type: 'text',
329
+ text: JSON.stringify({
330
+ action: 'removeRule',
331
+ status: 'not_found',
332
+ message: `Rule ${ruleId} not found`,
333
+ }),
334
+ },
335
+ ],
336
+ };
337
+ }
338
+ state.rules.splice(index, 1);
339
+ return {
340
+ content: [
341
+ {
342
+ type: 'text',
343
+ text: JSON.stringify({
344
+ action: 'removeRule',
345
+ removedId: ruleId,
346
+ remainingRules: state.rules.length,
347
+ message: `Removed rule ${ruleId}`,
348
+ }),
349
+ },
350
+ ],
351
+ };
352
+ }
353
+ case 'listRules': {
354
+ return {
355
+ content: [
356
+ {
357
+ type: 'text',
358
+ text: JSON.stringify({
359
+ action: 'listRules',
360
+ enabled: state.enabled,
361
+ rules: state.rules,
362
+ count: state.rules.length,
363
+ }),
364
+ },
365
+ ],
366
+ };
367
+ }
368
+ case 'getLogs': {
369
+ let logs = state.loggedRequests;
370
+ if (limit && limit > 0) {
371
+ logs = logs.slice(-limit);
372
+ }
373
+ // Calculate stats
374
+ const stats = {
375
+ total: state.loggedRequests.length,
376
+ returned: logs.length,
377
+ blocked: state.loggedRequests.filter(l => l.matched).length,
378
+ byType: {},
379
+ };
380
+ for (const log of state.loggedRequests) {
381
+ stats.byType[log.resourceType] = (stats.byType[log.resourceType] || 0) + 1;
382
+ }
383
+ return {
384
+ content: [
385
+ {
386
+ type: 'text',
387
+ text: JSON.stringify({
388
+ action: 'getLogs',
389
+ logs,
390
+ stats,
391
+ }),
392
+ },
393
+ ],
394
+ };
395
+ }
396
+ case 'clearLogs': {
397
+ const clearedCount = state.loggedRequests.length;
398
+ state.loggedRequests = [];
399
+ return {
400
+ content: [
401
+ {
402
+ type: 'text',
403
+ text: JSON.stringify({
404
+ action: 'clearLogs',
405
+ clearedCount,
406
+ message: `Cleared ${clearedCount} request logs`,
407
+ }),
408
+ },
409
+ ],
410
+ };
411
+ }
412
+ default:
413
+ return {
414
+ content: [
415
+ {
416
+ type: 'text',
417
+ text: `Error: Unknown action "${action}"`,
418
+ },
419
+ ],
420
+ isError: true,
421
+ };
422
+ }
423
+ }
424
+ catch (error) {
425
+ return {
426
+ content: [
427
+ {
428
+ type: 'text',
429
+ text: `Request intercept error: ${error instanceof Error ? error.message : String(error)}`,
430
+ },
431
+ ],
432
+ isError: true,
433
+ };
434
+ }
435
+ };
436
+ function registerRequestInterceptTool(server) {
437
+ server.registerTool('request_intercept', handler, definition);
438
+ }
439
+ //# sourceMappingURL=request-intercept.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"request-intercept.js","sourceRoot":"","sources":["../../src/tools/request-intercept.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Selector Query Tool - Query DOM elements using CSS selectors
3
+ */
4
+ import { MCPServer } from '../mcp-server';
5
+ export declare function registerSelectorQueryTool(server: MCPServer): void;
6
+ //# sourceMappingURL=selector-query.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"selector-query.d.ts","sourceRoot":"","sources":["../../src/tools/selector-query.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA6O1C,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEjE"}
@@ -0,0 +1,206 @@
1
+ "use strict";
2
+ /**
3
+ * Selector Query Tool - Query DOM elements using CSS selectors
4
+ */
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.registerSelectorQueryTool = registerSelectorQueryTool;
7
+ const session_manager_1 = require("../session-manager");
8
+ const definition = {
9
+ name: 'selector_query',
10
+ description: `Query DOM elements using CSS selectors.
11
+ Returns element information including tag, id, classes, attributes, and a reference ID for use with other tools.
12
+ Use "multiple: true" to find all matching elements.`,
13
+ inputSchema: {
14
+ type: 'object',
15
+ properties: {
16
+ tabId: {
17
+ type: 'string',
18
+ description: 'Tab ID to query',
19
+ },
20
+ selector: {
21
+ type: 'string',
22
+ description: 'CSS selector to query (e.g., "#search", ".button", "input[type=text]")',
23
+ },
24
+ multiple: {
25
+ type: 'boolean',
26
+ description: 'If true, returns all matching elements. If false, returns only the first match. Default: false',
27
+ },
28
+ },
29
+ required: ['tabId', 'selector'],
30
+ },
31
+ };
32
+ const handler = async (sessionId, args) => {
33
+ const tabId = args.tabId;
34
+ const selector = args.selector;
35
+ const multiple = args.multiple ?? false;
36
+ const sessionManager = (0, session_manager_1.getSessionManager)();
37
+ if (!tabId) {
38
+ return {
39
+ content: [{ type: 'text', text: 'Error: tabId is required' }],
40
+ isError: true,
41
+ };
42
+ }
43
+ if (!selector) {
44
+ return {
45
+ content: [{ type: 'text', text: 'Error: selector is required' }],
46
+ isError: true,
47
+ };
48
+ }
49
+ try {
50
+ const page = await sessionManager.getPage(sessionId, tabId, undefined, 'selector_query');
51
+ if (!page) {
52
+ return {
53
+ content: [{ type: 'text', text: `Error: Tab ${tabId} not found` }],
54
+ isError: true,
55
+ };
56
+ }
57
+ if (multiple) {
58
+ // Query all matching elements
59
+ const elements = await page.$$(selector);
60
+ if (elements.length === 0) {
61
+ return {
62
+ content: [
63
+ {
64
+ type: 'text',
65
+ text: JSON.stringify({
66
+ action: 'selector_query',
67
+ selector,
68
+ multiple: true,
69
+ elements: [],
70
+ count: 0,
71
+ message: `No elements found matching "${selector}"`,
72
+ }),
73
+ },
74
+ ],
75
+ };
76
+ }
77
+ const elementInfos = [];
78
+ for (let i = 0; i < elements.length; i++) {
79
+ const element = elements[i];
80
+ const info = await page.evaluate((el, index) => {
81
+ const rect = el.getBoundingClientRect();
82
+ const style = window.getComputedStyle(el);
83
+ const isVisible = style.display !== 'none' &&
84
+ style.visibility !== 'hidden' &&
85
+ style.opacity !== '0' &&
86
+ rect.width > 0 &&
87
+ rect.height > 0;
88
+ const attributes = {};
89
+ for (const attr of el.attributes) {
90
+ attributes[attr.name] = attr.value;
91
+ }
92
+ return {
93
+ ref: `ref_${index}`,
94
+ tagName: el.tagName.toLowerCase(),
95
+ id: el.id || null,
96
+ className: el.className,
97
+ attributes,
98
+ textContent: (el.textContent || '').trim().slice(0, 100),
99
+ isVisible,
100
+ boundingBox: rect.width > 0 && rect.height > 0
101
+ ? {
102
+ x: Math.round(rect.x),
103
+ y: Math.round(rect.y),
104
+ width: Math.round(rect.width),
105
+ height: Math.round(rect.height),
106
+ }
107
+ : null,
108
+ };
109
+ }, element, i);
110
+ elementInfos.push(info);
111
+ }
112
+ return {
113
+ content: [
114
+ {
115
+ type: 'text',
116
+ text: JSON.stringify({
117
+ action: 'selector_query',
118
+ selector,
119
+ multiple: true,
120
+ elements: elementInfos,
121
+ count: elementInfos.length,
122
+ }),
123
+ },
124
+ ],
125
+ };
126
+ }
127
+ else {
128
+ // Query single element
129
+ const element = await page.$(selector);
130
+ if (!element) {
131
+ return {
132
+ content: [
133
+ {
134
+ type: 'text',
135
+ text: JSON.stringify({
136
+ action: 'selector_query',
137
+ selector,
138
+ multiple: false,
139
+ element: null,
140
+ message: `No element found matching "${selector}"`,
141
+ }),
142
+ },
143
+ ],
144
+ };
145
+ }
146
+ const info = await page.evaluate((el) => {
147
+ const rect = el.getBoundingClientRect();
148
+ const style = window.getComputedStyle(el);
149
+ const isVisible = style.display !== 'none' &&
150
+ style.visibility !== 'hidden' &&
151
+ style.opacity !== '0' &&
152
+ rect.width > 0 &&
153
+ rect.height > 0;
154
+ const attributes = {};
155
+ for (const attr of el.attributes) {
156
+ attributes[attr.name] = attr.value;
157
+ }
158
+ return {
159
+ ref: 'ref_0',
160
+ tagName: el.tagName.toLowerCase(),
161
+ id: el.id || null,
162
+ className: el.className,
163
+ attributes,
164
+ textContent: (el.textContent || '').trim().slice(0, 100),
165
+ isVisible,
166
+ boundingBox: rect.width > 0 && rect.height > 0
167
+ ? {
168
+ x: Math.round(rect.x),
169
+ y: Math.round(rect.y),
170
+ width: Math.round(rect.width),
171
+ height: Math.round(rect.height),
172
+ }
173
+ : null,
174
+ };
175
+ }, element);
176
+ return {
177
+ content: [
178
+ {
179
+ type: 'text',
180
+ text: JSON.stringify({
181
+ action: 'selector_query',
182
+ selector,
183
+ multiple: false,
184
+ element: info,
185
+ }),
186
+ },
187
+ ],
188
+ };
189
+ }
190
+ }
191
+ catch (error) {
192
+ return {
193
+ content: [
194
+ {
195
+ type: 'text',
196
+ text: `Selector query error: ${error instanceof Error ? error.message : String(error)}`,
197
+ },
198
+ ],
199
+ isError: true,
200
+ };
201
+ }
202
+ };
203
+ function registerSelectorQueryTool(server) {
204
+ server.registerTool('selector_query', handler, definition);
205
+ }
206
+ //# sourceMappingURL=selector-query.js.map