@browserbasehq/orca 3.1.0-patch.3 → 3.2.0-middleware.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 (1588) hide show
  1. package/dist/cjs/cli.js +2 -210
  2. package/dist/cjs/index.d.ts +1 -0
  3. package/dist/cjs/index.js +2 -25025
  4. package/dist/cjs/lib/inference.js +335 -0
  5. package/dist/cjs/lib/inference.js.map +1 -0
  6. package/dist/cjs/lib/inferenceLogUtils.js +99 -0
  7. package/dist/cjs/lib/inferenceLogUtils.js.map +1 -0
  8. package/dist/cjs/lib/logger.js +331 -0
  9. package/dist/cjs/lib/logger.js.map +1 -0
  10. package/dist/cjs/lib/modelUtils.d.ts +1 -0
  11. package/dist/cjs/lib/modelUtils.js +53 -0
  12. package/dist/cjs/lib/modelUtils.js.map +1 -0
  13. package/dist/cjs/lib/prompt.d.ts +3 -2
  14. package/dist/cjs/lib/prompt.js +245 -0
  15. package/dist/cjs/lib/prompt.js.map +1 -0
  16. package/dist/cjs/lib/utils.d.ts +1 -0
  17. package/dist/cjs/lib/utils.js +674 -0
  18. package/dist/cjs/lib/utils.js.map +1 -0
  19. package/dist/cjs/lib/v3/agent/AgentClient.d.ts +8 -0
  20. package/dist/cjs/lib/v3/agent/AgentClient.js +34 -0
  21. package/dist/cjs/lib/v3/agent/AgentClient.js.map +1 -0
  22. package/dist/cjs/lib/v3/agent/AgentProvider.js +81 -0
  23. package/dist/cjs/lib/v3/agent/AgentProvider.js.map +1 -0
  24. package/dist/cjs/lib/v3/agent/AnthropicCUAClient.js +843 -0
  25. package/dist/cjs/lib/v3/agent/AnthropicCUAClient.js.map +1 -0
  26. package/dist/cjs/lib/v3/agent/GoogleCUAClient.js +802 -0
  27. package/dist/cjs/lib/v3/agent/GoogleCUAClient.js.map +1 -0
  28. package/dist/cjs/lib/v3/agent/MicrosoftCUAClient.js +778 -0
  29. package/dist/cjs/lib/v3/agent/MicrosoftCUAClient.js.map +1 -0
  30. package/dist/cjs/lib/v3/agent/OpenAICUAClient.d.ts +4 -4
  31. package/dist/cjs/lib/v3/agent/OpenAICUAClient.js +681 -0
  32. package/dist/cjs/lib/v3/agent/OpenAICUAClient.js.map +1 -0
  33. package/dist/cjs/lib/v3/agent/prompts/agentSystemPrompt.d.ts +7 -3
  34. package/dist/cjs/lib/v3/agent/prompts/agentSystemPrompt.js +212 -0
  35. package/dist/cjs/lib/v3/agent/prompts/agentSystemPrompt.js.map +1 -0
  36. package/dist/cjs/lib/v3/agent/tools/act.d.ts +2 -2
  37. package/dist/cjs/lib/v3/agent/tools/act.js +66 -0
  38. package/dist/cjs/lib/v3/agent/tools/act.js.map +1 -0
  39. package/dist/cjs/lib/v3/agent/tools/ariaTree.d.ts +8 -1
  40. package/dist/cjs/lib/v3/agent/tools/ariaTree.js +62 -0
  41. package/dist/cjs/lib/v3/agent/tools/ariaTree.js.map +1 -0
  42. package/dist/cjs/lib/v3/agent/tools/braveSearch.js +77 -0
  43. package/dist/cjs/lib/v3/agent/tools/braveSearch.js.map +1 -0
  44. package/dist/cjs/lib/v3/agent/tools/browserbaseSearch.d.ts +13 -0
  45. package/dist/cjs/lib/v3/agent/tools/browserbaseSearch.js +70 -0
  46. package/dist/cjs/lib/v3/agent/tools/browserbaseSearch.js.map +1 -0
  47. package/dist/cjs/lib/v3/agent/tools/click.js +100 -0
  48. package/dist/cjs/lib/v3/agent/tools/click.js.map +1 -0
  49. package/dist/cjs/lib/v3/agent/tools/clickAndHold.js +72 -0
  50. package/dist/cjs/lib/v3/agent/tools/clickAndHold.js.map +1 -0
  51. package/dist/cjs/lib/v3/agent/tools/dragAndDrop.js +101 -0
  52. package/dist/cjs/lib/v3/agent/tools/dragAndDrop.js.map +1 -0
  53. package/dist/cjs/lib/v3/agent/tools/extract.d.ts +2 -2
  54. package/dist/cjs/lib/v3/agent/tools/extract.js +101 -0
  55. package/dist/cjs/lib/v3/agent/tools/extract.js.map +1 -0
  56. package/dist/cjs/lib/v3/agent/tools/fillFormVision.d.ts +2 -2
  57. package/dist/cjs/lib/v3/agent/tools/fillFormVision.js +158 -0
  58. package/dist/cjs/lib/v3/agent/tools/fillFormVision.js.map +1 -0
  59. package/dist/cjs/lib/v3/agent/tools/fillform.d.ts +8 -3
  60. package/dist/cjs/lib/v3/agent/tools/fillform.js +78 -0
  61. package/dist/cjs/lib/v3/agent/tools/fillform.js.map +1 -0
  62. package/dist/cjs/lib/v3/agent/tools/goto.js +35 -0
  63. package/dist/cjs/lib/v3/agent/tools/goto.js.map +1 -0
  64. package/dist/cjs/lib/v3/agent/tools/index.d.ts +25 -4
  65. package/dist/cjs/lib/v3/agent/tools/index.js +130 -0
  66. package/dist/cjs/lib/v3/agent/tools/index.js.map +1 -0
  67. package/dist/cjs/lib/v3/agent/tools/keys.d.ts +1 -1
  68. package/dist/cjs/lib/v3/agent/tools/keys.js +64 -0
  69. package/dist/cjs/lib/v3/agent/tools/keys.js.map +1 -0
  70. package/dist/cjs/lib/v3/agent/tools/navback.js +27 -0
  71. package/dist/cjs/lib/v3/agent/tools/navback.js.map +1 -0
  72. package/dist/cjs/lib/v3/agent/tools/screenshot.d.ts +8 -0
  73. package/dist/cjs/lib/v3/agent/tools/screenshot.js +47 -0
  74. package/dist/cjs/lib/v3/agent/tools/screenshot.js.map +1 -0
  75. package/dist/cjs/lib/v3/agent/tools/scroll.js +159 -0
  76. package/dist/cjs/lib/v3/agent/tools/scroll.js.map +1 -0
  77. package/dist/cjs/lib/v3/agent/tools/think.js +28 -0
  78. package/dist/cjs/lib/v3/agent/tools/think.js.map +1 -0
  79. package/dist/cjs/lib/v3/agent/tools/type.d.ts +2 -2
  80. package/dist/cjs/lib/v3/agent/tools/type.js +111 -0
  81. package/dist/cjs/lib/v3/agent/tools/type.js.map +1 -0
  82. package/dist/cjs/lib/v3/agent/tools/wait.js +63 -0
  83. package/dist/cjs/lib/v3/agent/tools/wait.js.map +1 -0
  84. package/dist/cjs/lib/v3/agent/utils/actionMapping.js +103 -0
  85. package/dist/cjs/lib/v3/agent/utils/actionMapping.js.map +1 -0
  86. package/dist/cjs/lib/v3/agent/utils/captchaSolver.d.ts +76 -0
  87. package/dist/cjs/lib/v3/agent/utils/captchaSolver.js +175 -0
  88. package/dist/cjs/lib/v3/agent/utils/captchaSolver.js.map +1 -0
  89. package/dist/cjs/lib/v3/agent/utils/coordinateNormalization.js +33 -0
  90. package/dist/cjs/lib/v3/agent/utils/coordinateNormalization.js.map +1 -0
  91. package/dist/cjs/lib/v3/agent/utils/cuaKeyMapping.js +65 -0
  92. package/dist/cjs/lib/v3/agent/utils/cuaKeyMapping.js.map +1 -0
  93. package/dist/cjs/lib/v3/agent/utils/googleCustomToolHandler.js +150 -0
  94. package/dist/cjs/lib/v3/agent/utils/googleCustomToolHandler.js.map +1 -0
  95. package/dist/cjs/lib/v3/agent/utils/handleDoneToolCall.js +108 -0
  96. package/dist/cjs/lib/v3/agent/utils/handleDoneToolCall.js.map +1 -0
  97. package/dist/cjs/lib/v3/agent/utils/imageCompression.js +212 -0
  98. package/dist/cjs/lib/v3/agent/utils/imageCompression.js.map +1 -0
  99. package/dist/cjs/lib/v3/agent/utils/messageProcessing.js +167 -0
  100. package/dist/cjs/lib/v3/agent/utils/messageProcessing.js.map +1 -0
  101. package/dist/cjs/lib/v3/agent/utils/screenshotHandler.js +29 -0
  102. package/dist/cjs/lib/v3/agent/utils/screenshotHandler.js.map +1 -0
  103. package/dist/cjs/lib/v3/agent/utils/validateExperimentalFeatures.js +90 -0
  104. package/dist/cjs/lib/v3/agent/utils/validateExperimentalFeatures.js.map +1 -0
  105. package/dist/cjs/lib/v3/agent/utils/variables.d.ts +21 -0
  106. package/dist/cjs/lib/v3/agent/utils/variables.js +54 -0
  107. package/dist/cjs/lib/v3/agent/utils/variables.js.map +1 -0
  108. package/dist/cjs/lib/v3/agent/utils/xpath.js +22 -0
  109. package/dist/cjs/lib/v3/agent/utils/xpath.js.map +1 -0
  110. package/dist/cjs/lib/v3/api.d.ts +23 -5
  111. package/dist/cjs/lib/v3/api.js +589 -0
  112. package/dist/cjs/lib/v3/api.js.map +1 -0
  113. package/dist/cjs/lib/v3/cache/ActCache.d.ts +0 -1
  114. package/dist/cjs/lib/v3/cache/ActCache.js +280 -0
  115. package/dist/cjs/lib/v3/cache/ActCache.js.map +1 -0
  116. package/dist/cjs/lib/v3/cache/AgentCache.d.ts +1 -0
  117. package/dist/cjs/lib/v3/cache/AgentCache.js +651 -0
  118. package/dist/cjs/lib/v3/cache/AgentCache.js.map +1 -0
  119. package/dist/cjs/lib/v3/cache/CacheStorage.js +105 -0
  120. package/dist/cjs/lib/v3/cache/CacheStorage.js.map +1 -0
  121. package/dist/cjs/lib/v3/cache/serverAgentCache.js +52 -0
  122. package/dist/cjs/lib/v3/cache/serverAgentCache.js.map +1 -0
  123. package/dist/cjs/lib/v3/cache/utils.js +44 -0
  124. package/dist/cjs/lib/v3/cache/utils.js.map +1 -0
  125. package/dist/cjs/lib/v3/cli.js +15 -0
  126. package/dist/cjs/lib/v3/cli.js.map +1 -0
  127. package/dist/cjs/lib/v3/dom/a11yScripts/index.js +124 -0
  128. package/dist/cjs/lib/v3/dom/a11yScripts/index.js.map +1 -0
  129. package/dist/cjs/lib/v3/dom/build/a11yScripts.generated.js +23 -0
  130. package/dist/cjs/lib/v3/dom/build/a11yScripts.generated.js.map +1 -0
  131. package/dist/cjs/lib/v3/dom/build/locatorScripts.generated.js +59 -0
  132. package/dist/cjs/lib/v3/dom/build/locatorScripts.generated.js.map +1 -0
  133. package/dist/cjs/lib/v3/dom/build/reRenderScriptContent.js +5 -0
  134. package/dist/cjs/lib/v3/dom/build/reRenderScriptContent.js.map +1 -0
  135. package/dist/cjs/lib/v3/dom/build/screenshotScripts.generated.js +11 -0
  136. package/dist/cjs/lib/v3/dom/build/screenshotScripts.generated.js.map +1 -0
  137. package/dist/cjs/lib/v3/dom/build/scriptV3Content.js +5 -0
  138. package/dist/cjs/lib/v3/dom/build/scriptV3Content.js.map +1 -0
  139. package/dist/cjs/lib/v3/dom/index.js +18 -0
  140. package/dist/cjs/lib/v3/dom/index.js.map +1 -0
  141. package/dist/cjs/lib/v3/dom/locatorScripts/counts.js +278 -0
  142. package/dist/cjs/lib/v3/dom/locatorScripts/counts.js.map +1 -0
  143. package/dist/cjs/lib/v3/dom/locatorScripts/index.js +21 -0
  144. package/dist/cjs/lib/v3/dom/locatorScripts/index.js.map +1 -0
  145. package/dist/cjs/lib/v3/dom/locatorScripts/scripts.js +474 -0
  146. package/dist/cjs/lib/v3/dom/locatorScripts/scripts.js.map +1 -0
  147. package/dist/cjs/lib/v3/dom/locatorScripts/selectors.js +289 -0
  148. package/dist/cjs/lib/v3/dom/locatorScripts/selectors.js.map +1 -0
  149. package/dist/cjs/lib/v3/dom/locatorScripts/waitForSelector.js +286 -0
  150. package/dist/cjs/lib/v3/dom/locatorScripts/waitForSelector.js.map +1 -0
  151. package/dist/cjs/lib/v3/dom/locatorScripts/xpathParser.js +381 -0
  152. package/dist/cjs/lib/v3/dom/locatorScripts/xpathParser.js.map +1 -0
  153. package/dist/cjs/lib/v3/dom/locatorScripts/xpathResolver.js +202 -0
  154. package/dist/cjs/lib/v3/dom/locatorScripts/xpathResolver.js.map +1 -0
  155. package/dist/cjs/lib/v3/dom/piercer.entry.js +5 -0
  156. package/dist/cjs/lib/v3/dom/piercer.entry.js.map +1 -0
  157. package/dist/cjs/lib/v3/dom/piercer.runtime.js +93 -0
  158. package/dist/cjs/lib/v3/dom/piercer.runtime.js.map +1 -0
  159. package/dist/cjs/lib/v3/dom/rerenderMissingShadows.entry.js +5 -0
  160. package/dist/cjs/lib/v3/dom/rerenderMissingShadows.entry.js.map +1 -0
  161. package/dist/cjs/lib/v3/dom/rerenderMissingShadows.runtime.js +43 -0
  162. package/dist/cjs/lib/v3/dom/rerenderMissingShadows.runtime.js.map +1 -0
  163. package/dist/cjs/lib/v3/dom/screenshotScripts/index.js +6 -0
  164. package/dist/cjs/lib/v3/dom/screenshotScripts/index.js.map +1 -0
  165. package/dist/cjs/lib/v3/dom/screenshotScripts/resolveMaskRect.js +85 -0
  166. package/dist/cjs/lib/v3/dom/screenshotScripts/resolveMaskRect.js.map +1 -0
  167. package/dist/cjs/lib/v3/external_clients/aisdk.js +107 -0
  168. package/dist/cjs/lib/v3/external_clients/aisdk.js.map +1 -0
  169. package/dist/cjs/lib/v3/external_clients/customOpenAI.js +224 -0
  170. package/dist/cjs/lib/v3/external_clients/customOpenAI.js.map +1 -0
  171. package/dist/cjs/lib/v3/flowlogger/EventEmitter.d.ts +7 -0
  172. package/dist/cjs/lib/v3/flowlogger/EventEmitter.js +30 -0
  173. package/dist/cjs/lib/v3/flowlogger/EventEmitter.js.map +1 -0
  174. package/dist/cjs/lib/v3/flowlogger/EventSink.d.ts +44 -0
  175. package/dist/cjs/lib/v3/flowlogger/EventSink.js +217 -0
  176. package/dist/cjs/lib/v3/flowlogger/EventSink.js.map +1 -0
  177. package/dist/cjs/lib/v3/flowlogger/EventStore.d.ts +26 -0
  178. package/dist/cjs/lib/v3/flowlogger/EventStore.js +135 -0
  179. package/dist/cjs/lib/v3/flowlogger/EventStore.js.map +1 -0
  180. package/dist/cjs/lib/v3/flowlogger/FlowLogger.d.ts +99 -0
  181. package/dist/cjs/lib/v3/flowlogger/FlowLogger.js +591 -0
  182. package/dist/cjs/lib/v3/flowlogger/FlowLogger.js.map +1 -0
  183. package/dist/cjs/lib/v3/flowlogger/prettify.d.ts +6 -0
  184. package/dist/cjs/lib/v3/flowlogger/prettify.js +395 -0
  185. package/dist/cjs/lib/v3/flowlogger/prettify.js.map +1 -0
  186. package/dist/cjs/lib/v3/handlers/actHandler.d.ts +2 -1
  187. package/dist/cjs/lib/v3/handlers/actHandler.js +344 -0
  188. package/dist/cjs/lib/v3/handlers/actHandler.js.map +1 -0
  189. package/dist/cjs/lib/v3/handlers/extractHandler.js +144 -0
  190. package/dist/cjs/lib/v3/handlers/extractHandler.js.map +1 -0
  191. package/dist/cjs/lib/v3/handlers/handlerUtils/actHandlerUtils.js +590 -0
  192. package/dist/cjs/lib/v3/handlers/handlerUtils/actHandlerUtils.js.map +1 -0
  193. package/dist/cjs/lib/v3/handlers/handlerUtils/timeoutGuard.js +17 -0
  194. package/dist/cjs/lib/v3/handlers/handlerUtils/timeoutGuard.js.map +1 -0
  195. package/dist/cjs/lib/v3/handlers/observeHandler.js +159 -0
  196. package/dist/cjs/lib/v3/handlers/observeHandler.js.map +1 -0
  197. package/dist/cjs/lib/v3/handlers/v3AgentHandler.d.ts +2 -5
  198. package/dist/cjs/lib/v3/handlers/v3AgentHandler.js +506 -0
  199. package/dist/cjs/lib/v3/handlers/v3AgentHandler.js.map +1 -0
  200. package/dist/cjs/lib/v3/handlers/v3CuaAgentHandler.d.ts +5 -0
  201. package/dist/cjs/lib/v3/handlers/v3CuaAgentHandler.js +652 -0
  202. package/dist/cjs/lib/v3/handlers/v3CuaAgentHandler.js.map +1 -0
  203. package/dist/cjs/lib/v3/index.d.ts +143 -0
  204. package/dist/cjs/lib/v3/index.js +119 -0
  205. package/dist/cjs/lib/v3/index.js.map +1 -0
  206. package/dist/cjs/lib/v3/launch/browserbase.d.ts +1 -1
  207. package/dist/cjs/lib/v3/launch/browserbase.js +47 -0
  208. package/dist/cjs/lib/v3/launch/browserbase.js.map +1 -0
  209. package/dist/cjs/lib/v3/launch/local.js +104 -0
  210. package/dist/cjs/lib/v3/launch/local.js.map +1 -0
  211. package/dist/cjs/lib/v3/llm/AnthropicClient.js +246 -0
  212. package/dist/cjs/lib/v3/llm/AnthropicClient.js.map +1 -0
  213. package/dist/cjs/lib/v3/llm/CerebrasClient.js +242 -0
  214. package/dist/cjs/lib/v3/llm/CerebrasClient.js.map +1 -0
  215. package/dist/cjs/lib/v3/llm/GoogleClient.js +373 -0
  216. package/dist/cjs/lib/v3/llm/GoogleClient.js.map +1 -0
  217. package/dist/cjs/lib/v3/llm/GroqClient.js +243 -0
  218. package/dist/cjs/lib/v3/llm/GroqClient.js.map +1 -0
  219. package/dist/cjs/lib/v3/llm/LLMClient.js +27 -0
  220. package/dist/cjs/lib/v3/llm/LLMClient.js.map +1 -0
  221. package/dist/cjs/lib/v3/llm/LLMProvider.d.ts +5 -2
  222. package/dist/cjs/lib/v3/llm/LLMProvider.js +201 -0
  223. package/dist/cjs/lib/v3/llm/LLMProvider.js.map +1 -0
  224. package/dist/cjs/lib/v3/llm/OpenAIClient.js +336 -0
  225. package/dist/cjs/lib/v3/llm/OpenAIClient.js.map +1 -0
  226. package/dist/cjs/lib/v3/llm/aisdk.js +349 -0
  227. package/dist/cjs/lib/v3/llm/aisdk.js.map +1 -0
  228. package/dist/cjs/lib/v3/logger.js +102 -0
  229. package/dist/cjs/lib/v3/logger.js.map +1 -0
  230. package/dist/cjs/lib/v3/mcp/connection.d.ts +2 -0
  231. package/dist/cjs/lib/v3/mcp/connection.js +56 -0
  232. package/dist/cjs/lib/v3/mcp/connection.js.map +1 -0
  233. package/dist/cjs/lib/v3/mcp/utils.js +40 -0
  234. package/dist/cjs/lib/v3/mcp/utils.js.map +1 -0
  235. package/dist/cjs/lib/v3/runtimePaths.d.ts +6 -0
  236. package/dist/cjs/lib/v3/runtimePaths.js +119 -0
  237. package/dist/cjs/lib/v3/runtimePaths.js.map +1 -0
  238. package/dist/cjs/lib/v3/shutdown/cleanupLocal.js +36 -0
  239. package/dist/cjs/lib/v3/shutdown/cleanupLocal.js.map +1 -0
  240. package/dist/cjs/lib/v3/shutdown/supervisor.js +193 -0
  241. package/dist/cjs/lib/v3/shutdown/supervisor.js.map +1 -0
  242. package/dist/cjs/lib/v3/shutdown/supervisorClient.js +95 -0
  243. package/dist/cjs/lib/v3/shutdown/supervisorClient.js.map +1 -0
  244. package/dist/cjs/lib/v3/timeoutConfig.d.ts +1 -1
  245. package/dist/cjs/lib/v3/timeoutConfig.js +36 -0
  246. package/dist/cjs/lib/v3/timeoutConfig.js.map +1 -0
  247. package/dist/cjs/lib/v3/types/private/agent.js +3 -0
  248. package/dist/cjs/lib/v3/types/private/agent.js.map +1 -0
  249. package/dist/cjs/lib/v3/types/private/api.js +3 -0
  250. package/dist/cjs/lib/v3/types/private/api.js.map +1 -0
  251. package/dist/cjs/lib/v3/types/private/cache.d.ts +3 -1
  252. package/dist/cjs/lib/v3/types/private/cache.js +3 -0
  253. package/dist/cjs/lib/v3/types/private/cache.js.map +1 -0
  254. package/dist/cjs/lib/v3/types/private/evaluator.js +3 -0
  255. package/dist/cjs/lib/v3/types/private/evaluator.js.map +1 -0
  256. package/dist/cjs/lib/v3/types/private/handlers.d.ts +2 -1
  257. package/dist/cjs/lib/v3/types/private/handlers.js +19 -0
  258. package/dist/cjs/lib/v3/types/private/handlers.js.map +1 -0
  259. package/dist/cjs/lib/v3/types/private/index.js +24 -0
  260. package/dist/cjs/lib/v3/types/private/index.js.map +1 -0
  261. package/dist/cjs/lib/v3/types/private/internal.js +3 -0
  262. package/dist/cjs/lib/v3/types/private/internal.js.map +1 -0
  263. package/dist/cjs/lib/v3/types/private/locator.js +3 -0
  264. package/dist/cjs/lib/v3/types/private/locator.js.map +1 -0
  265. package/dist/cjs/lib/v3/types/private/network.js +6 -0
  266. package/dist/cjs/lib/v3/types/private/network.js.map +1 -0
  267. package/dist/cjs/lib/v3/types/private/shutdown.d.ts +1 -1
  268. package/dist/cjs/lib/v3/types/private/shutdown.js +6 -0
  269. package/dist/cjs/lib/v3/types/private/shutdown.js.map +1 -0
  270. package/dist/cjs/lib/v3/types/private/shutdownErrors.js +28 -0
  271. package/dist/cjs/lib/v3/types/private/shutdownErrors.js.map +1 -0
  272. package/dist/cjs/lib/v3/types/private/snapshot.js +3 -0
  273. package/dist/cjs/lib/v3/types/private/snapshot.js.map +1 -0
  274. package/dist/cjs/lib/v3/types/public/agent.d.ts +76 -4
  275. package/dist/cjs/lib/v3/types/public/agent.js +18 -0
  276. package/dist/cjs/lib/v3/types/public/agent.js.map +1 -0
  277. package/dist/cjs/lib/v3/types/public/api.d.ts +21 -0
  278. package/dist/cjs/lib/v3/types/public/api.js +930 -0
  279. package/dist/cjs/lib/v3/types/public/api.js.map +1 -0
  280. package/dist/cjs/lib/v3/types/public/apiErrors.js +41 -0
  281. package/dist/cjs/lib/v3/types/public/apiErrors.js.map +1 -0
  282. package/dist/cjs/lib/v3/types/public/context.d.ts +32 -0
  283. package/dist/cjs/lib/v3/types/public/context.js +3 -0
  284. package/dist/cjs/lib/v3/types/public/context.js.map +1 -0
  285. package/dist/cjs/lib/v3/types/public/index.d.ts +1 -0
  286. package/dist/cjs/lib/v3/types/public/index.js +56 -0
  287. package/dist/cjs/lib/v3/types/public/index.js.map +1 -0
  288. package/dist/cjs/lib/v3/types/public/locator.js +3 -0
  289. package/dist/cjs/lib/v3/types/public/locator.js.map +1 -0
  290. package/dist/cjs/lib/v3/types/public/logs.js +16 -0
  291. package/dist/cjs/lib/v3/types/public/logs.js.map +1 -0
  292. package/dist/cjs/lib/v3/types/public/methods.d.ts +33 -2
  293. package/dist/cjs/lib/v3/types/public/methods.js +18 -0
  294. package/dist/cjs/lib/v3/types/public/methods.js.map +1 -0
  295. package/dist/cjs/lib/v3/types/public/metrics.js +3 -0
  296. package/dist/cjs/lib/v3/types/public/metrics.js.map +1 -0
  297. package/dist/cjs/lib/v3/types/public/model.d.ts +12 -3
  298. package/dist/cjs/lib/v3/types/public/model.js +3 -0
  299. package/dist/cjs/lib/v3/types/public/model.js.map +1 -0
  300. package/dist/cjs/lib/v3/types/public/options.d.ts +15 -0
  301. package/dist/cjs/lib/v3/types/public/options.js +7 -0
  302. package/dist/cjs/lib/v3/types/public/options.js.map +1 -0
  303. package/dist/cjs/lib/v3/types/public/page.js +8 -0
  304. package/dist/cjs/lib/v3/types/public/page.js.map +1 -0
  305. package/dist/cjs/lib/v3/types/public/screenshotTypes.js +3 -0
  306. package/dist/cjs/lib/v3/types/public/screenshotTypes.js.map +1 -0
  307. package/dist/cjs/lib/v3/types/public/sdkErrors.d.ts +13 -0
  308. package/dist/cjs/lib/v3/types/public/sdkErrors.js +390 -0
  309. package/dist/cjs/lib/v3/types/public/sdkErrors.js.map +1 -0
  310. package/dist/cjs/lib/v3/understudy/a11y/snapshot/a11yTree.js +204 -0
  311. package/dist/cjs/lib/v3/understudy/a11y/snapshot/a11yTree.js.map +1 -0
  312. package/dist/cjs/lib/v3/understudy/a11y/snapshot/activeElement.js +124 -0
  313. package/dist/cjs/lib/v3/understudy/a11y/snapshot/activeElement.js.map +1 -0
  314. package/dist/cjs/lib/v3/understudy/a11y/snapshot/capture.js +345 -0
  315. package/dist/cjs/lib/v3/understudy/a11y/snapshot/capture.js.map +1 -0
  316. package/dist/cjs/lib/v3/understudy/a11y/snapshot/coordinateResolver.js +132 -0
  317. package/dist/cjs/lib/v3/understudy/a11y/snapshot/coordinateResolver.js.map +1 -0
  318. package/dist/cjs/lib/v3/understudy/a11y/snapshot/domTree.js +285 -0
  319. package/dist/cjs/lib/v3/understudy/a11y/snapshot/domTree.js.map +1 -0
  320. package/dist/cjs/lib/v3/understudy/a11y/snapshot/focusSelectors.d.ts +1 -0
  321. package/dist/cjs/lib/v3/understudy/a11y/snapshot/focusSelectors.js +226 -0
  322. package/dist/cjs/lib/v3/understudy/a11y/snapshot/focusSelectors.js.map +1 -0
  323. package/dist/cjs/lib/v3/understudy/a11y/snapshot/index.js +12 -0
  324. package/dist/cjs/lib/v3/understudy/a11y/snapshot/index.js.map +1 -0
  325. package/dist/cjs/lib/v3/understudy/a11y/snapshot/sessions.js +26 -0
  326. package/dist/cjs/lib/v3/understudy/a11y/snapshot/sessions.js.map +1 -0
  327. package/dist/cjs/lib/v3/understudy/a11y/snapshot/treeFormatUtils.js +143 -0
  328. package/dist/cjs/lib/v3/understudy/a11y/snapshot/treeFormatUtils.js.map +1 -0
  329. package/dist/cjs/lib/v3/understudy/a11y/snapshot/xpathUtils.js +110 -0
  330. package/dist/cjs/lib/v3/understudy/a11y/snapshot/xpathUtils.js.map +1 -0
  331. package/dist/cjs/lib/v3/understudy/a11yInvocation.js +15 -0
  332. package/dist/cjs/lib/v3/understudy/a11yInvocation.js.map +1 -0
  333. package/dist/cjs/lib/v3/understudy/cdp.d.ts +9 -13
  334. package/dist/cjs/lib/v3/understudy/cdp.js +430 -0
  335. package/dist/cjs/lib/v3/understudy/cdp.js.map +1 -0
  336. package/dist/cjs/lib/v3/understudy/consoleMessage.js +70 -0
  337. package/dist/cjs/lib/v3/understudy/consoleMessage.js.map +1 -0
  338. package/dist/cjs/lib/v3/understudy/context.d.ts +34 -0
  339. package/dist/cjs/lib/v3/understudy/context.js +960 -0
  340. package/dist/cjs/lib/v3/understudy/context.js.map +1 -0
  341. package/dist/cjs/lib/v3/understudy/cookies.d.ts +32 -0
  342. package/dist/cjs/lib/v3/understudy/cookies.js +142 -0
  343. package/dist/cjs/lib/v3/understudy/cookies.js.map +1 -0
  344. package/dist/cjs/lib/v3/understudy/deepLocator.js +204 -0
  345. package/dist/cjs/lib/v3/understudy/deepLocator.js.map +1 -0
  346. package/dist/cjs/lib/v3/understudy/executionContextRegistry.js +87 -0
  347. package/dist/cjs/lib/v3/understudy/executionContextRegistry.js.map +1 -0
  348. package/dist/cjs/lib/v3/understudy/fileUploadUtils.js +88 -0
  349. package/dist/cjs/lib/v3/understudy/fileUploadUtils.js.map +1 -0
  350. package/dist/cjs/lib/v3/understudy/frame.js +232 -0
  351. package/dist/cjs/lib/v3/understudy/frame.js.map +1 -0
  352. package/dist/cjs/lib/v3/understudy/frameLocator.js +260 -0
  353. package/dist/cjs/lib/v3/understudy/frameLocator.js.map +1 -0
  354. package/dist/cjs/lib/v3/understudy/frameRegistry.js +302 -0
  355. package/dist/cjs/lib/v3/understudy/frameRegistry.js.map +1 -0
  356. package/dist/cjs/lib/v3/understudy/initScripts.js +36 -0
  357. package/dist/cjs/lib/v3/understudy/initScripts.js.map +1 -0
  358. package/dist/cjs/lib/v3/understudy/lifecycleWatcher.js +249 -0
  359. package/dist/cjs/lib/v3/understudy/lifecycleWatcher.js.map +1 -0
  360. package/dist/cjs/lib/v3/understudy/locator.js +790 -0
  361. package/dist/cjs/lib/v3/understudy/locator.js.map +1 -0
  362. package/dist/cjs/lib/v3/understudy/locatorInvocation.js +15 -0
  363. package/dist/cjs/lib/v3/understudy/locatorInvocation.js.map +1 -0
  364. package/dist/cjs/lib/v3/understudy/navigationResponseTracker.js +228 -0
  365. package/dist/cjs/lib/v3/understudy/navigationResponseTracker.js.map +1 -0
  366. package/dist/cjs/lib/v3/understudy/networkManager.js +310 -0
  367. package/dist/cjs/lib/v3/understudy/networkManager.js.map +1 -0
  368. package/dist/cjs/lib/v3/understudy/page.d.ts +13 -0
  369. package/dist/cjs/lib/v3/understudy/page.js +2008 -0
  370. package/dist/cjs/lib/v3/understudy/page.js.map +1 -0
  371. package/dist/cjs/lib/v3/understudy/piercer.js +65 -0
  372. package/dist/cjs/lib/v3/understudy/piercer.js.map +1 -0
  373. package/dist/cjs/lib/v3/understudy/response.js +335 -0
  374. package/dist/cjs/lib/v3/understudy/response.js.map +1 -0
  375. package/dist/cjs/lib/v3/understudy/screenshotUtils.d.ts +0 -1
  376. package/dist/cjs/lib/v3/understudy/screenshotUtils.js +345 -0
  377. package/dist/cjs/lib/v3/understudy/screenshotUtils.js.map +1 -0
  378. package/dist/cjs/lib/v3/understudy/selectorResolver.js +300 -0
  379. package/dist/cjs/lib/v3/understudy/selectorResolver.js.map +1 -0
  380. package/dist/cjs/lib/v3/v3.d.ts +26 -3
  381. package/dist/cjs/lib/v3/v3.js +1679 -0
  382. package/dist/cjs/lib/v3/v3.js.map +1 -0
  383. package/dist/cjs/lib/v3/zodCompat.js +26 -0
  384. package/dist/cjs/lib/v3/zodCompat.js.map +1 -0
  385. package/dist/cjs/lib/v3Evaluator.js +214 -0
  386. package/dist/cjs/lib/v3Evaluator.js.map +1 -0
  387. package/dist/cjs/lib/version.d.ts +1 -1
  388. package/dist/cjs/lib/version.js +9 -0
  389. package/dist/cjs/lib/version.js.map +1 -0
  390. package/dist/cjs/tests/cache-variables.test.js +221 -0
  391. package/dist/cjs/tests/cache-variables.test.js.map +1 -0
  392. package/dist/cjs/tests/integration/agent-abort-signal.spec.js +123 -0
  393. package/dist/cjs/tests/integration/agent-abort-signal.spec.js.map +1 -0
  394. package/dist/cjs/tests/integration/agent-cache-self-heal.spec.js +83 -0
  395. package/dist/cjs/tests/integration/agent-cache-self-heal.spec.js.map +1 -0
  396. package/dist/cjs/tests/integration/agent-callbacks.spec.js +385 -0
  397. package/dist/cjs/tests/integration/agent-callbacks.spec.js.map +1 -0
  398. package/dist/cjs/tests/integration/agent-captcha-autosolve.spec.js +56 -0
  399. package/dist/cjs/tests/integration/agent-captcha-autosolve.spec.js.map +1 -0
  400. package/dist/cjs/tests/integration/agent-experimental-validation.spec.js +362 -0
  401. package/dist/cjs/tests/integration/agent-experimental-validation.spec.js.map +1 -0
  402. package/dist/cjs/tests/integration/agent-hybrid-mode.spec.js +262 -0
  403. package/dist/cjs/tests/integration/agent-hybrid-mode.spec.js.map +1 -0
  404. package/dist/cjs/tests/integration/agent-message-continuation.spec.js +112 -0
  405. package/dist/cjs/tests/integration/agent-message-continuation.spec.js.map +1 -0
  406. package/dist/cjs/tests/integration/agent-streaming.spec.d.ts +1 -0
  407. package/dist/cjs/tests/integration/agent-streaming.spec.js +140 -0
  408. package/dist/cjs/tests/integration/agent-streaming.spec.js.map +1 -0
  409. package/dist/cjs/tests/integration/cdp-close-api-region.spec.d.ts +1 -0
  410. package/dist/cjs/tests/integration/cdp-close-api-region.spec.js +41 -0
  411. package/dist/cjs/tests/integration/cdp-close-api-region.spec.js.map +1 -0
  412. package/dist/cjs/tests/integration/cdp-connection-close.spec.d.ts +1 -0
  413. package/dist/cjs/tests/integration/cdp-connection-close.spec.js +76 -0
  414. package/dist/cjs/tests/integration/cdp-connection-close.spec.js.map +1 -0
  415. package/dist/cjs/tests/integration/cdp-session-detached.spec.d.ts +1 -0
  416. package/dist/cjs/tests/integration/cdp-session-detached.spec.js +45 -0
  417. package/dist/cjs/tests/integration/cdp-session-detached.spec.js.map +1 -0
  418. package/dist/cjs/tests/integration/click-count.spec.d.ts +1 -0
  419. package/dist/cjs/tests/integration/click-count.spec.js +163 -0
  420. package/dist/cjs/tests/integration/click-count.spec.js.map +1 -0
  421. package/dist/cjs/tests/integration/connect-to-existing-browser.spec.d.ts +1 -0
  422. package/dist/cjs/tests/integration/connect-to-existing-browser.spec.js +99 -0
  423. package/dist/cjs/tests/integration/connect-to-existing-browser.spec.js.map +1 -0
  424. package/dist/cjs/tests/integration/context-addInitScript.spec.d.ts +1 -0
  425. package/dist/cjs/tests/integration/context-addInitScript.spec.js +285 -0
  426. package/dist/cjs/tests/integration/context-addInitScript.spec.js.map +1 -0
  427. package/dist/cjs/tests/integration/context-extra-http-headers.spec.d.ts +1 -0
  428. package/dist/cjs/tests/integration/context-extra-http-headers.spec.js +49 -0
  429. package/dist/cjs/tests/integration/context-extra-http-headers.spec.js.map +1 -0
  430. package/dist/cjs/tests/integration/cookies.spec.d.ts +1 -0
  431. package/dist/cjs/tests/integration/cookies.spec.js +187 -0
  432. package/dist/cjs/tests/integration/cookies.spec.js.map +1 -0
  433. package/dist/cjs/tests/integration/default-page-tracking.spec.d.ts +1 -0
  434. package/dist/cjs/tests/integration/default-page-tracking.spec.js +52 -0
  435. package/dist/cjs/tests/integration/default-page-tracking.spec.js.map +1 -0
  436. package/dist/cjs/tests/integration/downloads.spec.d.ts +1 -0
  437. package/dist/cjs/tests/integration/downloads.spec.js +52 -0
  438. package/dist/cjs/tests/integration/downloads.spec.js.map +1 -0
  439. package/dist/cjs/tests/integration/flowLogger.spec.d.ts +1 -0
  440. package/dist/cjs/tests/integration/flowLogger.spec.js +714 -0
  441. package/dist/cjs/tests/integration/flowLogger.spec.js.map +1 -0
  442. package/dist/cjs/tests/integration/frame-get-location-and-click.spec.d.ts +1 -0
  443. package/dist/cjs/tests/integration/frame-get-location-and-click.spec.js +57 -0
  444. package/dist/cjs/tests/integration/frame-get-location-and-click.spec.js.map +1 -0
  445. package/dist/cjs/tests/integration/iframe-ctx-addInitScript-race.spec.d.ts +1 -0
  446. package/dist/cjs/tests/integration/iframe-ctx-addInitScript-race.spec.js +219 -0
  447. package/dist/cjs/tests/integration/iframe-ctx-addInitScript-race.spec.js.map +1 -0
  448. package/dist/cjs/tests/integration/iframe-ctx-addInitScript.spec.d.ts +1 -0
  449. package/dist/cjs/tests/integration/iframe-ctx-addInitScript.spec.js +474 -0
  450. package/dist/cjs/tests/integration/iframe-ctx-addInitScript.spec.js.map +1 -0
  451. package/dist/cjs/tests/integration/keep-alive.child.d.ts +1 -0
  452. package/dist/cjs/tests/integration/keep-alive.child.js +85 -0
  453. package/dist/cjs/tests/integration/keep-alive.child.js.map +1 -0
  454. package/dist/cjs/tests/integration/keep-alive.spec.d.ts +22 -0
  455. package/dist/cjs/tests/integration/keep-alive.spec.js +490 -0
  456. package/dist/cjs/tests/integration/keep-alive.spec.js.map +1 -0
  457. package/dist/cjs/tests/integration/keyboard.spec.d.ts +1 -0
  458. package/dist/cjs/tests/integration/keyboard.spec.js +259 -0
  459. package/dist/cjs/tests/integration/keyboard.spec.js.map +1 -0
  460. package/dist/cjs/tests/integration/locator-backend-node-id.spec.d.ts +1 -0
  461. package/dist/cjs/tests/integration/locator-backend-node-id.spec.js +150 -0
  462. package/dist/cjs/tests/integration/locator-backend-node-id.spec.js.map +1 -0
  463. package/dist/cjs/tests/integration/locator-content-methods.spec.d.ts +1 -0
  464. package/dist/cjs/tests/integration/locator-content-methods.spec.js +180 -0
  465. package/dist/cjs/tests/integration/locator-content-methods.spec.js.map +1 -0
  466. package/dist/cjs/tests/integration/locator-count-iframe.spec.d.ts +1 -0
  467. package/dist/cjs/tests/integration/locator-count-iframe.spec.js +129 -0
  468. package/dist/cjs/tests/integration/locator-count-iframe.spec.js.map +1 -0
  469. package/dist/cjs/tests/integration/locator-count.spec.d.ts +1 -0
  470. package/dist/cjs/tests/integration/locator-count.spec.js +68 -0
  471. package/dist/cjs/tests/integration/locator-count.spec.js.map +1 -0
  472. package/dist/cjs/tests/integration/locator-fill.spec.d.ts +1 -0
  473. package/dist/cjs/tests/integration/locator-fill.spec.js +117 -0
  474. package/dist/cjs/tests/integration/locator-fill.spec.js.map +1 -0
  475. package/dist/cjs/tests/integration/locator-input-methods.spec.d.ts +1 -0
  476. package/dist/cjs/tests/integration/locator-input-methods.spec.js +127 -0
  477. package/dist/cjs/tests/integration/locator-input-methods.spec.js.map +1 -0
  478. package/dist/cjs/tests/integration/locator-nth.spec.d.ts +1 -0
  479. package/dist/cjs/tests/integration/locator-nth.spec.js +175 -0
  480. package/dist/cjs/tests/integration/locator-nth.spec.js.map +1 -0
  481. package/dist/cjs/tests/integration/locator-select-option.spec.d.ts +1 -0
  482. package/dist/cjs/tests/integration/locator-select-option.spec.js +216 -0
  483. package/dist/cjs/tests/integration/locator-select-option.spec.js.map +1 -0
  484. package/dist/cjs/tests/integration/logger-initialization.spec.d.ts +1 -0
  485. package/dist/cjs/tests/integration/logger-initialization.spec.js +597 -0
  486. package/dist/cjs/tests/integration/logger-initialization.spec.js.map +1 -0
  487. package/dist/cjs/tests/integration/multi-instance-logger.spec.d.ts +1 -0
  488. package/dist/cjs/tests/integration/multi-instance-logger.spec.js +293 -0
  489. package/dist/cjs/tests/integration/multi-instance-logger.spec.js.map +1 -0
  490. package/dist/cjs/tests/integration/nested-div.spec.d.ts +1 -0
  491. package/dist/cjs/tests/integration/nested-div.spec.js +22 -0
  492. package/dist/cjs/tests/integration/nested-div.spec.js.map +1 -0
  493. package/dist/cjs/tests/integration/page-addInitScript.spec.d.ts +1 -0
  494. package/dist/cjs/tests/integration/page-addInitScript.spec.js +94 -0
  495. package/dist/cjs/tests/integration/page-addInitScript.spec.js.map +1 -0
  496. package/dist/cjs/tests/integration/page-console.spec.d.ts +1 -0
  497. package/dist/cjs/tests/integration/page-console.spec.js +47 -0
  498. package/dist/cjs/tests/integration/page-console.spec.js.map +1 -0
  499. package/dist/cjs/tests/integration/page-drag-and-drop.spec.d.ts +1 -0
  500. package/dist/cjs/tests/integration/page-drag-and-drop.spec.js +437 -0
  501. package/dist/cjs/tests/integration/page-drag-and-drop.spec.js.map +1 -0
  502. package/dist/cjs/tests/integration/page-extra-http-headers.spec.d.ts +1 -0
  503. package/dist/cjs/tests/integration/page-extra-http-headers.spec.js +85 -0
  504. package/dist/cjs/tests/integration/page-extra-http-headers.spec.js.map +1 -0
  505. package/dist/cjs/tests/integration/page-goto-response.spec.d.ts +1 -0
  506. package/dist/cjs/tests/integration/page-goto-response.spec.js +34 -0
  507. package/dist/cjs/tests/integration/page-goto-response.spec.js.map +1 -0
  508. package/dist/cjs/tests/integration/page-hover.spec.d.ts +1 -0
  509. package/dist/cjs/tests/integration/page-hover.spec.js +165 -0
  510. package/dist/cjs/tests/integration/page-hover.spec.js.map +1 -0
  511. package/dist/cjs/tests/integration/page-screenshot.spec.d.ts +1 -0
  512. package/dist/cjs/tests/integration/page-screenshot.spec.js +292 -0
  513. package/dist/cjs/tests/integration/page-screenshot.spec.js.map +1 -0
  514. package/dist/cjs/tests/integration/page-scroll.spec.d.ts +1 -0
  515. package/dist/cjs/tests/integration/page-scroll.spec.js +183 -0
  516. package/dist/cjs/tests/integration/page-scroll.spec.js.map +1 -0
  517. package/dist/cjs/tests/integration/page-send-cdp.spec.d.ts +1 -0
  518. package/dist/cjs/tests/integration/page-send-cdp.spec.js +47 -0
  519. package/dist/cjs/tests/integration/page-send-cdp.spec.js.map +1 -0
  520. package/dist/cjs/tests/integration/perform-understudy-method.spec.d.ts +1 -0
  521. package/dist/cjs/tests/integration/perform-understudy-method.spec.js +63 -0
  522. package/dist/cjs/tests/integration/perform-understudy-method.spec.js.map +1 -0
  523. package/dist/cjs/tests/integration/setinputfiles.spec.d.ts +1 -0
  524. package/dist/cjs/tests/integration/setinputfiles.spec.js +133 -0
  525. package/dist/cjs/tests/integration/setinputfiles.spec.js.map +1 -0
  526. package/dist/cjs/tests/integration/shadow-iframe-oopif.spec.d.ts +1 -0
  527. package/dist/cjs/tests/integration/shadow-iframe-oopif.spec.js +161 -0
  528. package/dist/cjs/tests/integration/shadow-iframe-oopif.spec.js.map +1 -0
  529. package/dist/cjs/tests/integration/shadow-iframe-spif.spec.d.ts +1 -0
  530. package/dist/cjs/tests/integration/shadow-iframe-spif.spec.js +160 -0
  531. package/dist/cjs/tests/integration/shadow-iframe-spif.spec.js.map +1 -0
  532. package/dist/cjs/tests/integration/testUtils.d.ts +40 -0
  533. package/dist/cjs/tests/integration/testUtils.js +188 -0
  534. package/dist/cjs/tests/integration/testUtils.js.map +1 -0
  535. package/dist/cjs/tests/integration/text-selector-innermost.spec.d.ts +1 -0
  536. package/dist/cjs/tests/integration/text-selector-innermost.spec.js +105 -0
  537. package/dist/cjs/tests/integration/text-selector-innermost.spec.js.map +1 -0
  538. package/dist/cjs/tests/integration/timeouts.spec.d.ts +1 -0
  539. package/dist/cjs/tests/integration/timeouts.spec.js +307 -0
  540. package/dist/cjs/tests/integration/timeouts.spec.js.map +1 -0
  541. package/dist/cjs/tests/integration/user-data-dir.spec.d.ts +1 -0
  542. package/dist/cjs/tests/integration/user-data-dir.spec.js +77 -0
  543. package/dist/cjs/tests/integration/user-data-dir.spec.js.map +1 -0
  544. package/dist/cjs/tests/integration/v3.config.d.ts +4 -0
  545. package/dist/cjs/tests/integration/v3.config.js +11 -0
  546. package/dist/cjs/tests/integration/v3.config.js.map +1 -0
  547. package/dist/cjs/tests/integration/v3.dynamic.config.d.ts +4 -0
  548. package/dist/cjs/tests/integration/v3.dynamic.config.js +48 -0
  549. package/dist/cjs/tests/integration/v3.dynamic.config.js.map +1 -0
  550. package/dist/cjs/tests/integration/v3.playwright.config.d.ts +2 -0
  551. package/dist/cjs/tests/integration/v3.playwright.config.js +48 -0
  552. package/dist/cjs/tests/integration/v3.playwright.config.js.map +1 -0
  553. package/dist/cjs/tests/integration/wait-for-selector.spec.d.ts +1 -0
  554. package/dist/cjs/tests/integration/wait-for-selector.spec.js +683 -0
  555. package/dist/cjs/tests/integration/wait-for-selector.spec.js.map +1 -0
  556. package/dist/cjs/tests/integration/wait-for-timeout.spec.d.ts +1 -0
  557. package/dist/cjs/tests/integration/wait-for-timeout.spec.js +118 -0
  558. package/dist/cjs/tests/integration/wait-for-timeout.spec.js.map +1 -0
  559. package/dist/cjs/tests/integration/xpath-for-location-deep.spec.d.ts +1 -0
  560. package/dist/cjs/tests/integration/xpath-for-location-deep.spec.js +87 -0
  561. package/dist/cjs/tests/integration/xpath-for-location-deep.spec.js.map +1 -0
  562. package/dist/cjs/tests/unit/agent-captcha-hooks.test.d.ts +1 -0
  563. package/dist/cjs/tests/unit/agent-captcha-hooks.test.js +285 -0
  564. package/dist/cjs/tests/unit/agent-captcha-hooks.test.js.map +1 -0
  565. package/dist/cjs/tests/unit/agent-execution-model.test.d.ts +1 -0
  566. package/dist/cjs/tests/unit/agent-execution-model.test.js +128 -0
  567. package/dist/cjs/tests/unit/agent-execution-model.test.js.map +1 -0
  568. package/dist/cjs/tests/unit/api-multiregion.test.d.ts +1 -0
  569. package/dist/cjs/tests/unit/api-multiregion.test.js +58 -0
  570. package/dist/cjs/tests/unit/api-multiregion.test.js.map +1 -0
  571. package/dist/cjs/tests/unit/browserbase-session-accessors.test.d.ts +1 -0
  572. package/dist/cjs/tests/unit/browserbase-session-accessors.test.js +122 -0
  573. package/dist/cjs/tests/unit/browserbase-session-accessors.test.js.map +1 -0
  574. package/dist/cjs/tests/unit/cache-llm-resolution.test.d.ts +1 -0
  575. package/dist/cjs/tests/unit/cache-llm-resolution.test.js +186 -0
  576. package/dist/cjs/tests/unit/cache-llm-resolution.test.js.map +1 -0
  577. package/dist/cjs/tests/unit/captcha-solver.test.d.ts +1 -0
  578. package/dist/cjs/tests/unit/captcha-solver.test.js +154 -0
  579. package/dist/cjs/tests/unit/captcha-solver.test.js.map +1 -0
  580. package/dist/cjs/tests/unit/cdp-connection-close.test.d.ts +1 -0
  581. package/dist/cjs/tests/unit/cdp-connection-close.test.js +74 -0
  582. package/dist/cjs/tests/unit/cdp-connection-close.test.js.map +1 -0
  583. package/dist/cjs/tests/unit/context-extra-http-headers.test.d.ts +1 -0
  584. package/dist/cjs/tests/unit/context-extra-http-headers.test.js +58 -0
  585. package/dist/cjs/tests/unit/context-extra-http-headers.test.js.map +1 -0
  586. package/dist/cjs/tests/unit/cookies.test.d.ts +1 -0
  587. package/dist/cjs/tests/unit/cookies.test.js +944 -0
  588. package/dist/cjs/tests/unit/cookies.test.js.map +1 -0
  589. package/dist/cjs/tests/unit/flowlogger-capturing-cdp.test.d.ts +1 -0
  590. package/dist/cjs/tests/unit/flowlogger-capturing-cdp.test.js +95 -0
  591. package/dist/cjs/tests/unit/flowlogger-capturing-cdp.test.js.map +1 -0
  592. package/dist/cjs/tests/unit/flowlogger-capturing-llm.test.d.ts +1 -0
  593. package/dist/cjs/tests/unit/flowlogger-capturing-llm.test.js +43 -0
  594. package/dist/cjs/tests/unit/flowlogger-capturing-llm.test.js.map +1 -0
  595. package/dist/cjs/tests/unit/flowlogger-eventstore.test.d.ts +1 -0
  596. package/dist/cjs/tests/unit/flowlogger-eventstore.test.js +250 -0
  597. package/dist/cjs/tests/unit/flowlogger-eventstore.test.js.map +1 -0
  598. package/dist/cjs/tests/unit/helpers/mockCDPSession.d.ts +19 -0
  599. package/dist/cjs/tests/unit/helpers/mockCDPSession.js +29 -0
  600. package/dist/cjs/tests/unit/helpers/mockCDPSession.js.map +1 -0
  601. package/dist/cjs/tests/unit/llm-middleware.test.d.ts +1 -0
  602. package/dist/cjs/tests/unit/llm-middleware.test.js +495 -0
  603. package/dist/cjs/tests/unit/llm-middleware.test.js.map +1 -0
  604. package/dist/cjs/tests/unit/llm-provider.test.d.ts +1 -0
  605. package/dist/cjs/tests/unit/llm-provider.test.js +64 -0
  606. package/dist/cjs/tests/unit/llm-provider.test.js.map +1 -0
  607. package/dist/cjs/tests/unit/model-deprecation.test.d.ts +1 -0
  608. package/dist/cjs/tests/unit/model-deprecation.test.js +142 -0
  609. package/dist/cjs/tests/unit/model-deprecation.test.js.map +1 -0
  610. package/dist/cjs/tests/unit/model-utils.test.d.ts +1 -0
  611. package/dist/cjs/tests/unit/model-utils.test.js +42 -0
  612. package/dist/cjs/tests/unit/model-utils.test.js.map +1 -0
  613. package/dist/cjs/tests/unit/openai-cua-client.test.d.ts +1 -0
  614. package/dist/cjs/tests/unit/openai-cua-client.test.js +71 -0
  615. package/dist/cjs/tests/unit/openai-cua-client.test.js.map +1 -0
  616. package/dist/cjs/tests/unit/page-extra-http-headers.test.d.ts +1 -0
  617. package/dist/cjs/tests/unit/page-extra-http-headers.test.js +92 -0
  618. package/dist/cjs/tests/unit/page-extra-http-headers.test.js.map +1 -0
  619. package/dist/cjs/tests/unit/page-snapshot.test.d.ts +1 -0
  620. package/dist/cjs/tests/unit/page-snapshot.test.js +75 -0
  621. package/dist/cjs/tests/unit/page-snapshot.test.js.map +1 -0
  622. package/dist/cjs/tests/unit/public-api/export-surface.test.d.ts +1 -0
  623. package/dist/cjs/tests/unit/public-api/export-surface.test.js +107 -0
  624. package/dist/cjs/tests/unit/public-api/export-surface.test.js.map +1 -0
  625. package/dist/cjs/tests/unit/public-api/llm-and-agents.test.d.ts +1 -0
  626. package/dist/cjs/tests/unit/public-api/llm-and-agents.test.js +175 -0
  627. package/dist/cjs/tests/unit/public-api/llm-and-agents.test.js.map +1 -0
  628. package/dist/cjs/tests/unit/public-api/public-error-types.test.d.ts +62 -0
  629. package/dist/cjs/tests/unit/public-api/public-error-types.test.js +110 -0
  630. package/dist/cjs/tests/unit/public-api/public-error-types.test.js.map +1 -0
  631. package/dist/cjs/tests/unit/public-api/public-types.test.d.ts +1 -0
  632. package/dist/cjs/tests/unit/public-api/public-types.test.js +99 -0
  633. package/dist/cjs/tests/unit/public-api/public-types.test.js.map +1 -0
  634. package/dist/cjs/tests/unit/public-api/runtime-utils.test.d.ts +1 -0
  635. package/dist/cjs/tests/unit/public-api/runtime-utils.test.js +60 -0
  636. package/dist/cjs/tests/unit/public-api/runtime-utils.test.js.map +1 -0
  637. package/dist/cjs/tests/unit/public-api/schema-utils.test.d.ts +1 -0
  638. package/dist/cjs/tests/unit/public-api/schema-utils.test.js +95 -0
  639. package/dist/cjs/tests/unit/public-api/schema-utils.test.js.map +1 -0
  640. package/dist/cjs/tests/unit/public-api/timeout-error-types.test.d.ts +1 -0
  641. package/dist/cjs/tests/unit/public-api/timeout-error-types.test.js +121 -0
  642. package/dist/cjs/tests/unit/public-api/timeout-error-types.test.js.map +1 -0
  643. package/dist/cjs/tests/unit/public-api/tool-type-export.test.d.ts +1 -0
  644. package/dist/cjs/tests/unit/public-api/tool-type-export.test.js +65 -0
  645. package/dist/cjs/tests/unit/public-api/tool-type-export.test.js.map +1 -0
  646. package/dist/cjs/tests/unit/public-api/v3-core.test.d.ts +1 -0
  647. package/dist/cjs/tests/unit/public-api/v3-core.test.js +108 -0
  648. package/dist/cjs/tests/unit/public-api/v3-core.test.js.map +1 -0
  649. package/dist/cjs/tests/unit/safety-confirmation.test.d.ts +1 -0
  650. package/dist/cjs/tests/unit/safety-confirmation.test.js +110 -0
  651. package/dist/cjs/tests/unit/safety-confirmation.test.js.map +1 -0
  652. package/dist/cjs/tests/unit/snapshot-a11y-resolvers.test.d.ts +1 -0
  653. package/dist/cjs/tests/unit/snapshot-a11y-resolvers.test.js +330 -0
  654. package/dist/cjs/tests/unit/snapshot-a11y-resolvers.test.js.map +1 -0
  655. package/dist/cjs/tests/unit/snapshot-a11y-tree-utils.test.d.ts +1 -0
  656. package/dist/cjs/tests/unit/snapshot-a11y-tree-utils.test.js +286 -0
  657. package/dist/cjs/tests/unit/snapshot-a11y-tree-utils.test.js.map +1 -0
  658. package/dist/cjs/tests/unit/snapshot-capture-orchestration.test.d.ts +1 -0
  659. package/dist/cjs/tests/unit/snapshot-capture-orchestration.test.js +394 -0
  660. package/dist/cjs/tests/unit/snapshot-capture-orchestration.test.js.map +1 -0
  661. package/dist/cjs/tests/unit/snapshot-cbor.test.d.ts +1 -0
  662. package/dist/cjs/tests/unit/snapshot-cbor.test.js +204 -0
  663. package/dist/cjs/tests/unit/snapshot-cbor.test.js.map +1 -0
  664. package/dist/cjs/tests/unit/snapshot-dom-session-builders.test.d.ts +1 -0
  665. package/dist/cjs/tests/unit/snapshot-dom-session-builders.test.js +220 -0
  666. package/dist/cjs/tests/unit/snapshot-dom-session-builders.test.js.map +1 -0
  667. package/dist/cjs/tests/unit/snapshot-dom-tree-utils.test.d.ts +1 -0
  668. package/dist/cjs/tests/unit/snapshot-dom-tree-utils.test.js +107 -0
  669. package/dist/cjs/tests/unit/snapshot-dom-tree-utils.test.js.map +1 -0
  670. package/dist/cjs/tests/unit/snapshot-focus-selectors-utils.test.d.ts +1 -0
  671. package/dist/cjs/tests/unit/snapshot-focus-selectors-utils.test.js +89 -0
  672. package/dist/cjs/tests/unit/snapshot-focus-selectors-utils.test.js.map +1 -0
  673. package/dist/cjs/tests/unit/snapshot-frame-merge.test.d.ts +1 -0
  674. package/dist/cjs/tests/unit/snapshot-frame-merge.test.js +335 -0
  675. package/dist/cjs/tests/unit/snapshot-frame-merge.test.js.map +1 -0
  676. package/dist/cjs/tests/unit/snapshot-tree-format-utils.test.d.ts +1 -0
  677. package/dist/cjs/tests/unit/snapshot-tree-format-utils.test.js +84 -0
  678. package/dist/cjs/tests/unit/snapshot-tree-format-utils.test.js.map +1 -0
  679. package/dist/cjs/tests/unit/snapshot-xpath-utils.test.d.ts +1 -0
  680. package/dist/cjs/tests/unit/snapshot-xpath-utils.test.js +74 -0
  681. package/dist/cjs/tests/unit/snapshot-xpath-utils.test.js.map +1 -0
  682. package/dist/cjs/tests/unit/timeout-handlers.test.d.ts +1 -0
  683. package/dist/cjs/tests/unit/timeout-handlers.test.js +847 -0
  684. package/dist/cjs/tests/unit/timeout-handlers.test.js.map +1 -0
  685. package/dist/cjs/tests/unit/understudy-command-exception.test.d.ts +1 -0
  686. package/dist/cjs/tests/unit/understudy-command-exception.test.js +57 -0
  687. package/dist/cjs/tests/unit/understudy-command-exception.test.js.map +1 -0
  688. package/dist/cjs/tests/unit/xpath-parser.test.d.ts +1 -0
  689. package/dist/cjs/tests/unit/xpath-parser.test.js +311 -0
  690. package/dist/cjs/tests/unit/xpath-parser.test.js.map +1 -0
  691. package/dist/cjs/tests/unit/xpath-resolver.test.d.ts +1 -0
  692. package/dist/cjs/tests/unit/xpath-resolver.test.js +80 -0
  693. package/dist/cjs/tests/unit/xpath-resolver.test.js.map +1 -0
  694. package/dist/cjs/tests/unit/zod-enum-compatibility.test.d.ts +1 -0
  695. package/dist/cjs/tests/unit/zod-enum-compatibility.test.js +149 -0
  696. package/dist/cjs/tests/unit/zod-enum-compatibility.test.js.map +1 -0
  697. package/dist/esm/index.d.ts +1 -2
  698. package/dist/esm/index.js +1 -2
  699. package/dist/esm/lib/inference.js +5 -8
  700. package/dist/esm/lib/inference.js.map +1 -1
  701. package/dist/esm/lib/modelUtils.d.ts +1 -0
  702. package/dist/esm/lib/modelUtils.js.map +1 -1
  703. package/dist/esm/lib/prompt.d.ts +3 -2
  704. package/dist/esm/lib/prompt.js.map +1 -1
  705. package/dist/esm/lib/utils.d.ts +1 -0
  706. package/dist/esm/lib/utils.js +3 -0
  707. package/dist/esm/lib/utils.js.map +1 -1
  708. package/dist/esm/lib/v3/agent/AgentClient.d.ts +8 -0
  709. package/dist/esm/lib/v3/agent/AgentClient.js +13 -0
  710. package/dist/esm/lib/v3/agent/AgentClient.js.map +1 -1
  711. package/dist/esm/lib/v3/agent/AgentProvider.js +1 -1
  712. package/dist/esm/lib/v3/agent/AgentProvider.js.map +1 -1
  713. package/dist/esm/lib/v3/agent/AnthropicCUAClient.js +23 -9
  714. package/dist/esm/lib/v3/agent/AnthropicCUAClient.js.map +1 -1
  715. package/dist/esm/lib/v3/agent/GoogleCUAClient.js +6 -7
  716. package/dist/esm/lib/v3/agent/GoogleCUAClient.js.map +1 -1
  717. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.js +5 -4
  718. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.js.map +1 -1
  719. package/dist/esm/lib/v3/agent/OpenAICUAClient.d.ts +4 -4
  720. package/dist/esm/lib/v3/agent/OpenAICUAClient.js +67 -8
  721. package/dist/esm/lib/v3/agent/OpenAICUAClient.js.map +1 -1
  722. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.d.ts +7 -3
  723. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.js +29 -6
  724. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.js.map +1 -1
  725. package/dist/esm/lib/v3/agent/tools/act.d.ts +2 -2
  726. package/dist/esm/lib/v3/agent/tools/act.js +57 -44
  727. package/dist/esm/lib/v3/agent/tools/act.js.map +1 -1
  728. package/dist/esm/lib/v3/agent/tools/ariaTree.d.ts +8 -1
  729. package/dist/esm/lib/v3/agent/tools/ariaTree.js +49 -22
  730. package/dist/esm/lib/v3/agent/tools/ariaTree.js.map +1 -1
  731. package/dist/esm/lib/v3/agent/tools/braveSearch.js +73 -0
  732. package/dist/esm/lib/v3/agent/tools/braveSearch.js.map +1 -0
  733. package/dist/esm/lib/v3/agent/tools/browserbaseSearch.d.ts +13 -0
  734. package/dist/esm/lib/v3/agent/tools/browserbaseSearch.js +66 -0
  735. package/dist/esm/lib/v3/agent/tools/browserbaseSearch.js.map +1 -0
  736. package/dist/esm/lib/v3/agent/tools/click.js +23 -31
  737. package/dist/esm/lib/v3/agent/tools/click.js.map +1 -1
  738. package/dist/esm/lib/v3/agent/tools/clickAndHold.js.map +1 -1
  739. package/dist/esm/lib/v3/agent/tools/dragAndDrop.js +22 -30
  740. package/dist/esm/lib/v3/agent/tools/dragAndDrop.js.map +1 -1
  741. package/dist/esm/lib/v3/agent/tools/extract.d.ts +2 -2
  742. package/dist/esm/lib/v3/agent/tools/extract.js +7 -3
  743. package/dist/esm/lib/v3/agent/tools/extract.js.map +1 -1
  744. package/dist/esm/lib/v3/agent/tools/fillFormVision.d.ts +2 -2
  745. package/dist/esm/lib/v3/agent/tools/fillFormVision.js +109 -98
  746. package/dist/esm/lib/v3/agent/tools/fillFormVision.js.map +1 -1
  747. package/dist/esm/lib/v3/agent/tools/fillform.d.ts +8 -3
  748. package/dist/esm/lib/v3/agent/tools/fillform.js +70 -52
  749. package/dist/esm/lib/v3/agent/tools/fillform.js.map +1 -1
  750. package/dist/esm/lib/v3/agent/tools/index.d.ts +25 -4
  751. package/dist/esm/lib/v3/agent/tools/index.js +65 -12
  752. package/dist/esm/lib/v3/agent/tools/index.js.map +1 -1
  753. package/dist/esm/lib/v3/agent/tools/keys.d.ts +1 -1
  754. package/dist/esm/lib/v3/agent/tools/keys.js.map +1 -1
  755. package/dist/esm/lib/v3/agent/tools/screenshot.d.ts +8 -0
  756. package/dist/esm/lib/v3/agent/tools/screenshot.js +32 -15
  757. package/dist/esm/lib/v3/agent/tools/screenshot.js.map +1 -1
  758. package/dist/esm/lib/v3/agent/tools/scroll.js +12 -0
  759. package/dist/esm/lib/v3/agent/tools/scroll.js.map +1 -1
  760. package/dist/esm/lib/v3/agent/tools/type.d.ts +2 -2
  761. package/dist/esm/lib/v3/agent/tools/type.js +80 -79
  762. package/dist/esm/lib/v3/agent/tools/type.js.map +1 -1
  763. package/dist/esm/lib/v3/agent/tools/wait.js +6 -0
  764. package/dist/esm/lib/v3/agent/tools/wait.js.map +1 -1
  765. package/dist/esm/lib/v3/agent/utils/captchaSolver.d.ts +76 -0
  766. package/dist/esm/lib/v3/agent/utils/captchaSolver.js +171 -0
  767. package/dist/esm/lib/v3/agent/utils/captchaSolver.js.map +1 -0
  768. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.js +4 -0
  769. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.js.map +1 -1
  770. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.js +8 -0
  771. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.js.map +1 -1
  772. package/dist/esm/lib/v3/agent/utils/variables.d.ts +21 -0
  773. package/dist/esm/lib/v3/agent/utils/variables.js +48 -0
  774. package/dist/esm/lib/v3/agent/utils/variables.js.map +1 -0
  775. package/dist/esm/lib/v3/api.d.ts +23 -5
  776. package/dist/esm/lib/v3/api.js +74 -13
  777. package/dist/esm/lib/v3/api.js.map +1 -1
  778. package/dist/esm/lib/v3/cache/ActCache.d.ts +0 -1
  779. package/dist/esm/lib/v3/cache/ActCache.js +2 -18
  780. package/dist/esm/lib/v3/cache/ActCache.js.map +1 -1
  781. package/dist/esm/lib/v3/cache/AgentCache.d.ts +1 -0
  782. package/dist/esm/lib/v3/cache/AgentCache.js +18 -11
  783. package/dist/esm/lib/v3/cache/AgentCache.js.map +1 -1
  784. package/dist/esm/lib/v3/flowlogger/EventEmitter.d.ts +7 -0
  785. package/dist/esm/lib/v3/flowlogger/EventEmitter.js +26 -0
  786. package/dist/esm/lib/v3/flowlogger/EventEmitter.js.map +1 -0
  787. package/dist/esm/lib/v3/flowlogger/EventSink.d.ts +44 -0
  788. package/dist/esm/lib/v3/flowlogger/EventSink.js +206 -0
  789. package/dist/esm/lib/v3/flowlogger/EventSink.js.map +1 -0
  790. package/dist/esm/lib/v3/flowlogger/EventStore.d.ts +26 -0
  791. package/dist/esm/lib/v3/flowlogger/EventStore.js +127 -0
  792. package/dist/esm/lib/v3/flowlogger/EventStore.js.map +1 -0
  793. package/dist/esm/lib/v3/flowlogger/FlowLogger.d.ts +99 -0
  794. package/dist/esm/lib/v3/flowlogger/FlowLogger.js +583 -0
  795. package/dist/esm/lib/v3/flowlogger/FlowLogger.js.map +1 -0
  796. package/dist/esm/lib/v3/flowlogger/prettify.d.ts +6 -0
  797. package/dist/esm/lib/v3/flowlogger/prettify.js +389 -0
  798. package/dist/esm/lib/v3/flowlogger/prettify.js.map +1 -0
  799. package/dist/esm/lib/v3/handlers/actHandler.d.ts +2 -1
  800. package/dist/esm/lib/v3/handlers/actHandler.js +4 -4
  801. package/dist/esm/lib/v3/handlers/actHandler.js.map +1 -1
  802. package/dist/esm/lib/v3/handlers/extractHandler.js +2 -2
  803. package/dist/esm/lib/v3/handlers/extractHandler.js.map +1 -1
  804. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.js +43 -84
  805. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.js.map +1 -1
  806. package/dist/esm/lib/v3/handlers/observeHandler.js +1 -2
  807. package/dist/esm/lib/v3/handlers/observeHandler.js.map +1 -1
  808. package/dist/esm/lib/v3/handlers/v3AgentHandler.d.ts +2 -5
  809. package/dist/esm/lib/v3/handlers/v3AgentHandler.js +133 -92
  810. package/dist/esm/lib/v3/handlers/v3AgentHandler.js.map +1 -1
  811. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.d.ts +5 -0
  812. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.js +134 -14
  813. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.js.map +1 -1
  814. package/dist/esm/lib/v3/index.d.ts +143 -0
  815. package/dist/esm/lib/v3/index.js +41 -0
  816. package/dist/esm/lib/v3/index.js.map +1 -1
  817. package/dist/esm/lib/v3/launch/browserbase.d.ts +1 -1
  818. package/dist/esm/lib/v3/launch/browserbase.js +4 -9
  819. package/dist/esm/lib/v3/launch/browserbase.js.map +1 -1
  820. package/dist/esm/lib/v3/llm/LLMProvider.d.ts +5 -2
  821. package/dist/esm/lib/v3/llm/LLMProvider.js +14 -12
  822. package/dist/esm/lib/v3/llm/LLMProvider.js.map +1 -1
  823. package/dist/esm/lib/v3/llm/OpenAIClient.js +2 -2
  824. package/dist/esm/lib/v3/llm/OpenAIClient.js.map +1 -1
  825. package/dist/esm/lib/v3/llm/aisdk.js +11 -17
  826. package/dist/esm/lib/v3/llm/aisdk.js.map +1 -1
  827. package/dist/esm/lib/v3/mcp/connection.d.ts +2 -0
  828. package/dist/esm/lib/v3/mcp/connection.js +5 -2
  829. package/dist/esm/lib/v3/mcp/connection.js.map +1 -1
  830. package/dist/esm/lib/v3/runtimePaths.d.ts +6 -0
  831. package/dist/esm/lib/v3/runtimePaths.js +107 -0
  832. package/dist/esm/lib/v3/runtimePaths.js.map +1 -0
  833. package/dist/esm/lib/v3/shutdown/supervisor.js +2 -2
  834. package/dist/esm/lib/v3/shutdown/supervisor.js.map +1 -1
  835. package/dist/esm/lib/v3/shutdown/supervisorClient.js +9 -14
  836. package/dist/esm/lib/v3/shutdown/supervisorClient.js.map +1 -1
  837. package/dist/esm/lib/v3/timeoutConfig.d.ts +1 -1
  838. package/dist/esm/lib/v3/timeoutConfig.js +5 -0
  839. package/dist/esm/lib/v3/timeoutConfig.js.map +1 -1
  840. package/dist/esm/lib/v3/types/private/cache.d.ts +3 -1
  841. package/dist/esm/lib/v3/types/private/cache.js.map +1 -1
  842. package/dist/esm/lib/v3/types/private/handlers.d.ts +2 -1
  843. package/dist/esm/lib/v3/types/private/handlers.js.map +1 -1
  844. package/dist/esm/lib/v3/types/private/shutdown.d.ts +1 -1
  845. package/dist/esm/lib/v3/types/private/shutdown.js.map +1 -1
  846. package/dist/esm/lib/v3/types/public/agent.d.ts +76 -4
  847. package/dist/esm/lib/v3/types/public/agent.js +1 -1
  848. package/dist/esm/lib/v3/types/public/agent.js.map +1 -1
  849. package/dist/esm/lib/v3/types/public/api.d.ts +21 -0
  850. package/dist/esm/lib/v3/types/public/api.js +11 -2
  851. package/dist/esm/lib/v3/types/public/api.js.map +1 -1
  852. package/dist/esm/lib/v3/types/public/context.d.ts +32 -0
  853. package/dist/esm/lib/v3/types/public/context.js +2 -0
  854. package/dist/esm/lib/v3/types/public/context.js.map +1 -0
  855. package/dist/esm/lib/v3/types/public/index.d.ts +1 -0
  856. package/dist/esm/lib/v3/types/public/index.js +1 -0
  857. package/dist/esm/lib/v3/types/public/index.js.map +1 -1
  858. package/dist/esm/lib/v3/types/public/methods.d.ts +33 -2
  859. package/dist/esm/lib/v3/types/public/methods.js.map +1 -1
  860. package/dist/esm/lib/v3/types/public/model.d.ts +12 -3
  861. package/dist/esm/lib/v3/types/public/model.js.map +1 -1
  862. package/dist/esm/lib/v3/types/public/options.d.ts +15 -0
  863. package/dist/esm/lib/v3/types/public/options.js.map +1 -1
  864. package/dist/esm/lib/v3/types/public/sdkErrors.d.ts +13 -0
  865. package/dist/esm/lib/v3/types/public/sdkErrors.js +22 -0
  866. package/dist/esm/lib/v3/types/public/sdkErrors.js.map +1 -1
  867. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.d.ts +1 -0
  868. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.js +1 -1
  869. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.js.map +1 -1
  870. package/dist/esm/lib/v3/understudy/cdp.d.ts +9 -13
  871. package/dist/esm/lib/v3/understudy/cdp.js +191 -20
  872. package/dist/esm/lib/v3/understudy/cdp.js.map +1 -1
  873. package/dist/esm/lib/v3/understudy/context.d.ts +34 -0
  874. package/dist/esm/lib/v3/understudy/context.js +327 -67
  875. package/dist/esm/lib/v3/understudy/context.js.map +1 -1
  876. package/dist/esm/lib/v3/understudy/cookies.d.ts +32 -0
  877. package/dist/esm/lib/v3/understudy/cookies.js +136 -0
  878. package/dist/esm/lib/v3/understudy/cookies.js.map +1 -0
  879. package/dist/esm/lib/v3/understudy/deepLocator.js +1 -23
  880. package/dist/esm/lib/v3/understudy/deepLocator.js.map +1 -1
  881. package/dist/esm/lib/v3/understudy/frame.js +24 -7
  882. package/dist/esm/lib/v3/understudy/frame.js.map +1 -1
  883. package/dist/esm/lib/v3/understudy/page.d.ts +13 -0
  884. package/dist/esm/lib/v3/understudy/page.js +86 -23
  885. package/dist/esm/lib/v3/understudy/page.js.map +1 -1
  886. package/dist/esm/lib/v3/understudy/screenshotUtils.d.ts +0 -1
  887. package/dist/esm/lib/v3/understudy/screenshotUtils.js +1 -19
  888. package/dist/esm/lib/v3/understudy/screenshotUtils.js.map +1 -1
  889. package/dist/esm/lib/v3/understudy/selectorResolver.js +1 -1
  890. package/dist/esm/lib/v3/understudy/selectorResolver.js.map +1 -1
  891. package/dist/esm/lib/v3/v3.d.ts +26 -3
  892. package/dist/esm/lib/v3/v3.js +261 -190
  893. package/dist/esm/lib/v3/v3.js.map +1 -1
  894. package/dist/esm/lib/version.d.ts +1 -1
  895. package/dist/esm/lib/version.js +1 -1
  896. package/dist/esm/lib/version.js.map +1 -1
  897. package/dist/esm/tests/cache-variables.test.d.ts +1 -0
  898. package/dist/esm/tests/cache-variables.test.js +219 -0
  899. package/dist/esm/tests/cache-variables.test.js.map +1 -0
  900. package/dist/esm/tests/integration/agent-abort-signal.spec.d.ts +1 -0
  901. package/dist/esm/tests/integration/agent-abort-signal.spec.js +121 -0
  902. package/dist/esm/tests/integration/agent-abort-signal.spec.js.map +1 -0
  903. package/dist/esm/tests/integration/agent-cache-self-heal.spec.d.ts +1 -0
  904. package/dist/esm/tests/integration/agent-cache-self-heal.spec.js +78 -0
  905. package/dist/esm/tests/integration/agent-cache-self-heal.spec.js.map +1 -0
  906. package/dist/esm/tests/integration/agent-callbacks.spec.d.ts +1 -0
  907. package/dist/esm/tests/integration/agent-callbacks.spec.js +383 -0
  908. package/dist/esm/tests/integration/agent-callbacks.spec.js.map +1 -0
  909. package/dist/esm/tests/integration/agent-captcha-autosolve.spec.d.ts +1 -0
  910. package/dist/esm/tests/integration/agent-captcha-autosolve.spec.js +54 -0
  911. package/dist/esm/tests/integration/agent-captcha-autosolve.spec.js.map +1 -0
  912. package/dist/esm/tests/integration/agent-experimental-validation.spec.d.ts +1 -0
  913. package/dist/esm/tests/integration/agent-experimental-validation.spec.js +360 -0
  914. package/dist/esm/tests/integration/agent-experimental-validation.spec.js.map +1 -0
  915. package/dist/esm/tests/integration/agent-hybrid-mode.spec.d.ts +1 -0
  916. package/dist/esm/tests/integration/agent-hybrid-mode.spec.js +260 -0
  917. package/dist/esm/tests/integration/agent-hybrid-mode.spec.js.map +1 -0
  918. package/dist/esm/tests/integration/agent-message-continuation.spec.d.ts +1 -0
  919. package/dist/esm/tests/integration/agent-message-continuation.spec.js +110 -0
  920. package/dist/esm/tests/integration/agent-message-continuation.spec.js.map +1 -0
  921. package/dist/esm/tests/integration/agent-streaming.spec.d.ts +1 -0
  922. package/dist/esm/tests/integration/agent-streaming.spec.js +138 -0
  923. package/dist/esm/tests/integration/agent-streaming.spec.js.map +1 -0
  924. package/dist/esm/tests/integration/cdp-close-api-region.spec.d.ts +1 -0
  925. package/dist/esm/tests/integration/cdp-close-api-region.spec.js +39 -0
  926. package/dist/esm/tests/integration/cdp-close-api-region.spec.js.map +1 -0
  927. package/dist/esm/tests/integration/cdp-connection-close.spec.d.ts +1 -0
  928. package/dist/esm/tests/integration/cdp-connection-close.spec.js +74 -0
  929. package/dist/esm/tests/integration/cdp-connection-close.spec.js.map +1 -0
  930. package/dist/esm/tests/integration/cdp-session-detached.spec.d.ts +1 -0
  931. package/dist/esm/tests/integration/cdp-session-detached.spec.js +43 -0
  932. package/dist/esm/tests/integration/cdp-session-detached.spec.js.map +1 -0
  933. package/dist/esm/tests/integration/click-count.spec.d.ts +1 -0
  934. package/dist/esm/tests/integration/click-count.spec.js +161 -0
  935. package/dist/esm/tests/integration/click-count.spec.js.map +1 -0
  936. package/dist/esm/tests/integration/connect-to-existing-browser.spec.d.ts +1 -0
  937. package/dist/esm/tests/integration/connect-to-existing-browser.spec.js +97 -0
  938. package/dist/esm/tests/integration/connect-to-existing-browser.spec.js.map +1 -0
  939. package/dist/esm/tests/integration/context-addInitScript.spec.d.ts +1 -0
  940. package/dist/esm/tests/integration/context-addInitScript.spec.js +283 -0
  941. package/dist/esm/tests/integration/context-addInitScript.spec.js.map +1 -0
  942. package/dist/esm/tests/integration/context-extra-http-headers.spec.d.ts +1 -0
  943. package/dist/esm/tests/integration/context-extra-http-headers.spec.js +47 -0
  944. package/dist/esm/tests/integration/context-extra-http-headers.spec.js.map +1 -0
  945. package/dist/esm/tests/integration/cookies.spec.d.ts +1 -0
  946. package/dist/esm/tests/integration/cookies.spec.js +185 -0
  947. package/dist/esm/tests/integration/cookies.spec.js.map +1 -0
  948. package/dist/esm/tests/integration/default-page-tracking.spec.d.ts +1 -0
  949. package/dist/esm/tests/integration/default-page-tracking.spec.js +50 -0
  950. package/dist/esm/tests/integration/default-page-tracking.spec.js.map +1 -0
  951. package/dist/esm/tests/integration/downloads.spec.d.ts +1 -0
  952. package/dist/esm/tests/integration/downloads.spec.js +47 -0
  953. package/dist/esm/tests/integration/downloads.spec.js.map +1 -0
  954. package/dist/esm/tests/integration/flowLogger.spec.d.ts +1 -0
  955. package/dist/esm/tests/integration/flowLogger.spec.js +712 -0
  956. package/dist/esm/tests/integration/flowLogger.spec.js.map +1 -0
  957. package/dist/esm/tests/integration/frame-get-location-and-click.spec.d.ts +1 -0
  958. package/dist/esm/tests/integration/frame-get-location-and-click.spec.js +55 -0
  959. package/dist/esm/tests/integration/frame-get-location-and-click.spec.js.map +1 -0
  960. package/dist/esm/tests/integration/iframe-ctx-addInitScript-race.spec.d.ts +1 -0
  961. package/dist/esm/tests/integration/iframe-ctx-addInitScript-race.spec.js +217 -0
  962. package/dist/esm/tests/integration/iframe-ctx-addInitScript-race.spec.js.map +1 -0
  963. package/dist/esm/tests/integration/iframe-ctx-addInitScript.spec.d.ts +1 -0
  964. package/dist/esm/tests/integration/iframe-ctx-addInitScript.spec.js +472 -0
  965. package/dist/esm/tests/integration/iframe-ctx-addInitScript.spec.js.map +1 -0
  966. package/dist/esm/tests/integration/keep-alive.child.d.ts +1 -0
  967. package/dist/esm/tests/integration/keep-alive.child.js +83 -0
  968. package/dist/esm/tests/integration/keep-alive.child.js.map +1 -0
  969. package/dist/esm/tests/integration/keep-alive.spec.d.ts +22 -0
  970. package/dist/esm/tests/integration/keep-alive.spec.js +482 -0
  971. package/dist/esm/tests/integration/keep-alive.spec.js.map +1 -0
  972. package/dist/esm/tests/integration/keyboard.spec.d.ts +1 -0
  973. package/dist/esm/tests/integration/keyboard.spec.js +257 -0
  974. package/dist/esm/tests/integration/keyboard.spec.js.map +1 -0
  975. package/dist/esm/tests/integration/locator-backend-node-id.spec.d.ts +1 -0
  976. package/dist/esm/tests/integration/locator-backend-node-id.spec.js +148 -0
  977. package/dist/esm/tests/integration/locator-backend-node-id.spec.js.map +1 -0
  978. package/dist/esm/tests/integration/locator-content-methods.spec.d.ts +1 -0
  979. package/dist/esm/tests/integration/locator-content-methods.spec.js +178 -0
  980. package/dist/esm/tests/integration/locator-content-methods.spec.js.map +1 -0
  981. package/dist/esm/tests/integration/locator-count-iframe.spec.d.ts +1 -0
  982. package/dist/esm/tests/integration/locator-count-iframe.spec.js +127 -0
  983. package/dist/esm/tests/integration/locator-count-iframe.spec.js.map +1 -0
  984. package/dist/esm/tests/integration/locator-count.spec.d.ts +1 -0
  985. package/dist/esm/tests/integration/locator-count.spec.js +66 -0
  986. package/dist/esm/tests/integration/locator-count.spec.js.map +1 -0
  987. package/dist/esm/tests/integration/locator-fill.spec.d.ts +1 -0
  988. package/dist/esm/tests/integration/locator-fill.spec.js +115 -0
  989. package/dist/esm/tests/integration/locator-fill.spec.js.map +1 -0
  990. package/dist/esm/tests/integration/locator-input-methods.spec.d.ts +1 -0
  991. package/dist/esm/tests/integration/locator-input-methods.spec.js +125 -0
  992. package/dist/esm/tests/integration/locator-input-methods.spec.js.map +1 -0
  993. package/dist/esm/tests/integration/locator-nth.spec.d.ts +1 -0
  994. package/dist/esm/tests/integration/locator-nth.spec.js +173 -0
  995. package/dist/esm/tests/integration/locator-nth.spec.js.map +1 -0
  996. package/dist/esm/tests/integration/locator-select-option.spec.d.ts +1 -0
  997. package/dist/esm/tests/integration/locator-select-option.spec.js +214 -0
  998. package/dist/esm/tests/integration/locator-select-option.spec.js.map +1 -0
  999. package/dist/esm/tests/integration/logger-initialization.spec.d.ts +1 -0
  1000. package/dist/esm/tests/integration/logger-initialization.spec.js +595 -0
  1001. package/dist/esm/tests/integration/logger-initialization.spec.js.map +1 -0
  1002. package/dist/esm/tests/integration/multi-instance-logger.spec.d.ts +1 -0
  1003. package/dist/esm/tests/integration/multi-instance-logger.spec.js +291 -0
  1004. package/dist/esm/tests/integration/multi-instance-logger.spec.js.map +1 -0
  1005. package/dist/esm/tests/integration/nested-div.spec.d.ts +1 -0
  1006. package/dist/esm/tests/integration/nested-div.spec.js +20 -0
  1007. package/dist/esm/tests/integration/nested-div.spec.js.map +1 -0
  1008. package/dist/esm/tests/integration/page-addInitScript.spec.d.ts +1 -0
  1009. package/dist/esm/tests/integration/page-addInitScript.spec.js +92 -0
  1010. package/dist/esm/tests/integration/page-addInitScript.spec.js.map +1 -0
  1011. package/dist/esm/tests/integration/page-console.spec.d.ts +1 -0
  1012. package/dist/esm/tests/integration/page-console.spec.js +45 -0
  1013. package/dist/esm/tests/integration/page-console.spec.js.map +1 -0
  1014. package/dist/esm/tests/integration/page-drag-and-drop.spec.d.ts +1 -0
  1015. package/dist/esm/tests/integration/page-drag-and-drop.spec.js +435 -0
  1016. package/dist/esm/tests/integration/page-drag-and-drop.spec.js.map +1 -0
  1017. package/dist/esm/tests/integration/page-extra-http-headers.spec.d.ts +1 -0
  1018. package/dist/esm/tests/integration/page-extra-http-headers.spec.js +83 -0
  1019. package/dist/esm/tests/integration/page-extra-http-headers.spec.js.map +1 -0
  1020. package/dist/esm/tests/integration/page-goto-response.spec.d.ts +1 -0
  1021. package/dist/esm/tests/integration/page-goto-response.spec.js +32 -0
  1022. package/dist/esm/tests/integration/page-goto-response.spec.js.map +1 -0
  1023. package/dist/esm/tests/integration/page-hover.spec.d.ts +1 -0
  1024. package/dist/esm/tests/integration/page-hover.spec.js +163 -0
  1025. package/dist/esm/tests/integration/page-hover.spec.js.map +1 -0
  1026. package/dist/esm/tests/integration/page-screenshot.spec.d.ts +1 -0
  1027. package/dist/esm/tests/integration/page-screenshot.spec.js +257 -0
  1028. package/dist/esm/tests/integration/page-screenshot.spec.js.map +1 -0
  1029. package/dist/esm/tests/integration/page-scroll.spec.d.ts +1 -0
  1030. package/dist/esm/tests/integration/page-scroll.spec.js +181 -0
  1031. package/dist/esm/tests/integration/page-scroll.spec.js.map +1 -0
  1032. package/dist/esm/tests/integration/page-send-cdp.spec.d.ts +1 -0
  1033. package/dist/esm/tests/integration/page-send-cdp.spec.js +45 -0
  1034. package/dist/esm/tests/integration/page-send-cdp.spec.js.map +1 -0
  1035. package/dist/esm/tests/integration/perform-understudy-method.spec.d.ts +1 -0
  1036. package/dist/esm/tests/integration/perform-understudy-method.spec.js +61 -0
  1037. package/dist/esm/tests/integration/perform-understudy-method.spec.js.map +1 -0
  1038. package/dist/esm/tests/integration/setinputfiles.spec.d.ts +1 -0
  1039. package/dist/esm/tests/integration/setinputfiles.spec.js +128 -0
  1040. package/dist/esm/tests/integration/setinputfiles.spec.js.map +1 -0
  1041. package/dist/esm/tests/integration/shadow-iframe-oopif.spec.d.ts +1 -0
  1042. package/dist/esm/tests/integration/shadow-iframe-oopif.spec.js +156 -0
  1043. package/dist/esm/tests/integration/shadow-iframe-oopif.spec.js.map +1 -0
  1044. package/dist/esm/tests/integration/shadow-iframe-spif.spec.d.ts +1 -0
  1045. package/dist/esm/tests/integration/shadow-iframe-spif.spec.js +155 -0
  1046. package/dist/esm/tests/integration/shadow-iframe-spif.spec.js.map +1 -0
  1047. package/dist/esm/tests/integration/testUtils.d.ts +40 -0
  1048. package/dist/esm/tests/integration/testUtils.js +178 -0
  1049. package/dist/esm/tests/integration/testUtils.js.map +1 -0
  1050. package/dist/esm/tests/integration/text-selector-innermost.spec.d.ts +1 -0
  1051. package/dist/esm/tests/integration/text-selector-innermost.spec.js +103 -0
  1052. package/dist/esm/tests/integration/text-selector-innermost.spec.js.map +1 -0
  1053. package/dist/esm/tests/integration/timeouts.spec.d.ts +1 -0
  1054. package/dist/esm/tests/integration/timeouts.spec.js +305 -0
  1055. package/dist/esm/tests/integration/timeouts.spec.js.map +1 -0
  1056. package/dist/esm/tests/integration/user-data-dir.spec.d.ts +1 -0
  1057. package/dist/esm/tests/integration/user-data-dir.spec.js +42 -0
  1058. package/dist/esm/tests/integration/user-data-dir.spec.js.map +1 -0
  1059. package/dist/esm/tests/integration/v3.config.d.ts +4 -0
  1060. package/dist/esm/tests/integration/v3.config.js +7 -0
  1061. package/dist/esm/tests/integration/v3.config.js.map +1 -0
  1062. package/dist/esm/tests/integration/v3.dynamic.config.d.ts +4 -0
  1063. package/dist/esm/tests/integration/v3.dynamic.config.js +44 -0
  1064. package/dist/esm/tests/integration/v3.dynamic.config.js.map +1 -0
  1065. package/dist/esm/tests/integration/v3.playwright.config.d.ts +2 -0
  1066. package/dist/esm/tests/integration/v3.playwright.config.js +46 -0
  1067. package/dist/esm/tests/integration/v3.playwright.config.js.map +1 -0
  1068. package/dist/esm/tests/integration/wait-for-selector.spec.d.ts +1 -0
  1069. package/dist/esm/tests/integration/wait-for-selector.spec.js +681 -0
  1070. package/dist/esm/tests/integration/wait-for-selector.spec.js.map +1 -0
  1071. package/dist/esm/tests/integration/wait-for-timeout.spec.d.ts +1 -0
  1072. package/dist/esm/tests/integration/wait-for-timeout.spec.js +116 -0
  1073. package/dist/esm/tests/integration/wait-for-timeout.spec.js.map +1 -0
  1074. package/dist/esm/tests/integration/xpath-for-location-deep.spec.d.ts +1 -0
  1075. package/dist/esm/tests/integration/xpath-for-location-deep.spec.js +85 -0
  1076. package/dist/esm/tests/integration/xpath-for-location-deep.spec.js.map +1 -0
  1077. package/dist/esm/tests/unit/agent-captcha-hooks.test.d.ts +1 -0
  1078. package/dist/esm/tests/unit/agent-captcha-hooks.test.js +283 -0
  1079. package/dist/esm/tests/unit/agent-captcha-hooks.test.js.map +1 -0
  1080. package/dist/esm/tests/unit/agent-execution-model.test.d.ts +1 -0
  1081. package/dist/esm/tests/unit/agent-execution-model.test.js +126 -0
  1082. package/dist/esm/tests/unit/agent-execution-model.test.js.map +1 -0
  1083. package/dist/esm/tests/unit/api-multiregion.test.d.ts +1 -0
  1084. package/dist/esm/tests/unit/api-multiregion.test.js +56 -0
  1085. package/dist/esm/tests/unit/api-multiregion.test.js.map +1 -0
  1086. package/dist/esm/tests/unit/browserbase-session-accessors.test.d.ts +1 -0
  1087. package/dist/esm/tests/unit/browserbase-session-accessors.test.js +120 -0
  1088. package/dist/esm/tests/unit/browserbase-session-accessors.test.js.map +1 -0
  1089. package/dist/esm/tests/unit/cache-llm-resolution.test.d.ts +1 -0
  1090. package/dist/esm/tests/unit/cache-llm-resolution.test.js +184 -0
  1091. package/dist/esm/tests/unit/cache-llm-resolution.test.js.map +1 -0
  1092. package/dist/esm/tests/unit/captcha-solver.test.d.ts +1 -0
  1093. package/dist/esm/tests/unit/captcha-solver.test.js +152 -0
  1094. package/dist/esm/tests/unit/captcha-solver.test.js.map +1 -0
  1095. package/dist/esm/tests/unit/cdp-connection-close.test.d.ts +1 -0
  1096. package/dist/esm/tests/unit/cdp-connection-close.test.js +72 -0
  1097. package/dist/esm/tests/unit/cdp-connection-close.test.js.map +1 -0
  1098. package/dist/esm/tests/unit/context-extra-http-headers.test.d.ts +1 -0
  1099. package/dist/esm/tests/unit/context-extra-http-headers.test.js +56 -0
  1100. package/dist/esm/tests/unit/context-extra-http-headers.test.js.map +1 -0
  1101. package/dist/esm/tests/unit/cookies.test.d.ts +1 -0
  1102. package/dist/esm/tests/unit/cookies.test.js +909 -0
  1103. package/dist/esm/tests/unit/cookies.test.js.map +1 -0
  1104. package/dist/esm/tests/unit/flowlogger-capturing-cdp.test.d.ts +1 -0
  1105. package/dist/esm/tests/unit/flowlogger-capturing-cdp.test.js +93 -0
  1106. package/dist/esm/tests/unit/flowlogger-capturing-cdp.test.js.map +1 -0
  1107. package/dist/esm/tests/unit/flowlogger-capturing-llm.test.d.ts +1 -0
  1108. package/dist/esm/tests/unit/flowlogger-capturing-llm.test.js +41 -0
  1109. package/dist/esm/tests/unit/flowlogger-capturing-llm.test.js.map +1 -0
  1110. package/dist/esm/tests/unit/flowlogger-eventstore.test.d.ts +1 -0
  1111. package/dist/esm/tests/unit/flowlogger-eventstore.test.js +248 -0
  1112. package/dist/esm/tests/unit/flowlogger-eventstore.test.js.map +1 -0
  1113. package/dist/esm/tests/unit/helpers/mockCDPSession.d.ts +19 -0
  1114. package/dist/esm/tests/unit/helpers/mockCDPSession.js +25 -0
  1115. package/dist/esm/tests/unit/helpers/mockCDPSession.js.map +1 -0
  1116. package/dist/esm/tests/unit/llm-middleware.test.d.ts +1 -0
  1117. package/dist/esm/tests/unit/llm-middleware.test.js +460 -0
  1118. package/dist/esm/tests/unit/llm-middleware.test.js.map +1 -0
  1119. package/dist/esm/tests/unit/llm-provider.test.d.ts +1 -0
  1120. package/dist/esm/tests/unit/llm-provider.test.js +62 -0
  1121. package/dist/esm/tests/unit/llm-provider.test.js.map +1 -0
  1122. package/dist/esm/tests/unit/model-deprecation.test.d.ts +1 -0
  1123. package/dist/esm/tests/unit/model-deprecation.test.js +140 -0
  1124. package/dist/esm/tests/unit/model-deprecation.test.js.map +1 -0
  1125. package/dist/esm/tests/unit/model-utils.test.d.ts +1 -0
  1126. package/dist/esm/tests/unit/model-utils.test.js +40 -0
  1127. package/dist/esm/tests/unit/model-utils.test.js.map +1 -0
  1128. package/dist/esm/tests/unit/openai-cua-client.test.d.ts +1 -0
  1129. package/dist/esm/tests/unit/openai-cua-client.test.js +69 -0
  1130. package/dist/esm/tests/unit/openai-cua-client.test.js.map +1 -0
  1131. package/dist/esm/tests/unit/page-extra-http-headers.test.d.ts +1 -0
  1132. package/dist/esm/tests/unit/page-extra-http-headers.test.js +90 -0
  1133. package/dist/esm/tests/unit/page-extra-http-headers.test.js.map +1 -0
  1134. package/dist/esm/tests/unit/page-snapshot.test.d.ts +1 -0
  1135. package/dist/esm/tests/unit/page-snapshot.test.js +40 -0
  1136. package/dist/esm/tests/unit/page-snapshot.test.js.map +1 -0
  1137. package/dist/esm/tests/unit/public-api/export-surface.test.d.ts +1 -0
  1138. package/dist/esm/tests/unit/public-api/export-surface.test.js +72 -0
  1139. package/dist/esm/tests/unit/public-api/export-surface.test.js.map +1 -0
  1140. package/dist/esm/tests/unit/public-api/llm-and-agents.test.d.ts +1 -0
  1141. package/dist/esm/tests/unit/public-api/llm-and-agents.test.js +140 -0
  1142. package/dist/esm/tests/unit/public-api/llm-and-agents.test.js.map +1 -0
  1143. package/dist/esm/tests/unit/public-api/public-error-types.test.d.ts +62 -0
  1144. package/dist/esm/tests/unit/public-api/public-error-types.test.js +74 -0
  1145. package/dist/esm/tests/unit/public-api/public-error-types.test.js.map +1 -0
  1146. package/dist/esm/tests/unit/public-api/public-types.test.d.ts +1 -0
  1147. package/dist/esm/tests/unit/public-api/public-types.test.js +97 -0
  1148. package/dist/esm/tests/unit/public-api/public-types.test.js.map +1 -0
  1149. package/dist/esm/tests/unit/public-api/runtime-utils.test.d.ts +1 -0
  1150. package/dist/esm/tests/unit/public-api/runtime-utils.test.js +25 -0
  1151. package/dist/esm/tests/unit/public-api/runtime-utils.test.js.map +1 -0
  1152. package/dist/esm/tests/unit/public-api/schema-utils.test.d.ts +1 -0
  1153. package/dist/esm/tests/unit/public-api/schema-utils.test.js +60 -0
  1154. package/dist/esm/tests/unit/public-api/schema-utils.test.js.map +1 -0
  1155. package/dist/esm/tests/unit/public-api/timeout-error-types.test.d.ts +1 -0
  1156. package/dist/esm/tests/unit/public-api/timeout-error-types.test.js +86 -0
  1157. package/dist/esm/tests/unit/public-api/timeout-error-types.test.js.map +1 -0
  1158. package/dist/esm/tests/unit/public-api/tool-type-export.test.d.ts +1 -0
  1159. package/dist/esm/tests/unit/public-api/tool-type-export.test.js +30 -0
  1160. package/dist/esm/tests/unit/public-api/tool-type-export.test.js.map +1 -0
  1161. package/dist/esm/tests/unit/public-api/v3-core.test.d.ts +1 -0
  1162. package/dist/esm/tests/unit/public-api/v3-core.test.js +73 -0
  1163. package/dist/esm/tests/unit/public-api/v3-core.test.js.map +1 -0
  1164. package/dist/esm/tests/unit/safety-confirmation.test.d.ts +1 -0
  1165. package/dist/esm/tests/unit/safety-confirmation.test.js +108 -0
  1166. package/dist/esm/tests/unit/safety-confirmation.test.js.map +1 -0
  1167. package/dist/esm/tests/unit/snapshot-a11y-resolvers.test.d.ts +1 -0
  1168. package/dist/esm/tests/unit/snapshot-a11y-resolvers.test.js +295 -0
  1169. package/dist/esm/tests/unit/snapshot-a11y-resolvers.test.js.map +1 -0
  1170. package/dist/esm/tests/unit/snapshot-a11y-tree-utils.test.d.ts +1 -0
  1171. package/dist/esm/tests/unit/snapshot-a11y-tree-utils.test.js +284 -0
  1172. package/dist/esm/tests/unit/snapshot-a11y-tree-utils.test.js.map +1 -0
  1173. package/dist/esm/tests/unit/snapshot-capture-orchestration.test.d.ts +1 -0
  1174. package/dist/esm/tests/unit/snapshot-capture-orchestration.test.js +359 -0
  1175. package/dist/esm/tests/unit/snapshot-capture-orchestration.test.js.map +1 -0
  1176. package/dist/esm/tests/unit/snapshot-cbor.test.d.ts +1 -0
  1177. package/dist/esm/tests/unit/snapshot-cbor.test.js +202 -0
  1178. package/dist/esm/tests/unit/snapshot-cbor.test.js.map +1 -0
  1179. package/dist/esm/tests/unit/snapshot-dom-session-builders.test.d.ts +1 -0
  1180. package/dist/esm/tests/unit/snapshot-dom-session-builders.test.js +218 -0
  1181. package/dist/esm/tests/unit/snapshot-dom-session-builders.test.js.map +1 -0
  1182. package/dist/esm/tests/unit/snapshot-dom-tree-utils.test.d.ts +1 -0
  1183. package/dist/esm/tests/unit/snapshot-dom-tree-utils.test.js +105 -0
  1184. package/dist/esm/tests/unit/snapshot-dom-tree-utils.test.js.map +1 -0
  1185. package/dist/esm/tests/unit/snapshot-focus-selectors-utils.test.d.ts +1 -0
  1186. package/dist/esm/tests/unit/snapshot-focus-selectors-utils.test.js +87 -0
  1187. package/dist/esm/tests/unit/snapshot-focus-selectors-utils.test.js.map +1 -0
  1188. package/dist/esm/tests/unit/snapshot-frame-merge.test.d.ts +1 -0
  1189. package/dist/esm/tests/unit/snapshot-frame-merge.test.js +333 -0
  1190. package/dist/esm/tests/unit/snapshot-frame-merge.test.js.map +1 -0
  1191. package/dist/esm/tests/unit/snapshot-tree-format-utils.test.d.ts +1 -0
  1192. package/dist/esm/tests/unit/snapshot-tree-format-utils.test.js +82 -0
  1193. package/dist/esm/tests/unit/snapshot-tree-format-utils.test.js.map +1 -0
  1194. package/dist/esm/tests/unit/snapshot-xpath-utils.test.d.ts +1 -0
  1195. package/dist/esm/tests/unit/snapshot-xpath-utils.test.js +72 -0
  1196. package/dist/esm/tests/unit/snapshot-xpath-utils.test.js.map +1 -0
  1197. package/dist/esm/tests/unit/timeout-handlers.test.d.ts +1 -0
  1198. package/dist/esm/tests/unit/timeout-handlers.test.js +812 -0
  1199. package/dist/esm/tests/unit/timeout-handlers.test.js.map +1 -0
  1200. package/dist/esm/tests/unit/understudy-command-exception.test.d.ts +1 -0
  1201. package/dist/esm/tests/unit/understudy-command-exception.test.js +55 -0
  1202. package/dist/esm/tests/unit/understudy-command-exception.test.js.map +1 -0
  1203. package/dist/esm/tests/unit/xpath-parser.test.d.ts +1 -0
  1204. package/dist/esm/tests/unit/xpath-parser.test.js +309 -0
  1205. package/dist/esm/tests/unit/xpath-parser.test.js.map +1 -0
  1206. package/dist/esm/tests/unit/xpath-resolver.test.d.ts +1 -0
  1207. package/dist/esm/tests/unit/xpath-resolver.test.js +78 -0
  1208. package/dist/esm/tests/unit/xpath-resolver.test.js.map +1 -0
  1209. package/dist/esm/tests/unit/zod-enum-compatibility.test.d.ts +1 -0
  1210. package/dist/esm/tests/unit/zod-enum-compatibility.test.js +114 -0
  1211. package/dist/esm/tests/unit/zod-enum-compatibility.test.js.map +1 -0
  1212. package/package.json +19 -8
  1213. package/dist/cjs/cli.js.map +0 -7
  1214. package/dist/cjs/index.js.map +0 -7
  1215. package/dist/cjs/lib/v3/dom/build/rerender-index.d.ts +0 -0
  1216. package/dist/cjs/lib/v3/dom/build/v3-index.d.ts +0 -0
  1217. package/dist/cjs/lib/v3/flowLogger.d.ts +0 -139
  1218. package/dist/cjs/lib/v3/tests/agent-abort-signal.spec.js +0 -113
  1219. package/dist/cjs/lib/v3/tests/agent-abort-signal.spec.js.map +0 -7
  1220. package/dist/cjs/lib/v3/tests/agent-cache-self-heal.spec.js +0 -102
  1221. package/dist/cjs/lib/v3/tests/agent-cache-self-heal.spec.js.map +0 -7
  1222. package/dist/cjs/lib/v3/tests/agent-callbacks.spec.js +0 -374
  1223. package/dist/cjs/lib/v3/tests/agent-callbacks.spec.js.map +0 -7
  1224. package/dist/cjs/lib/v3/tests/agent-experimental-validation.spec.js +0 -354
  1225. package/dist/cjs/lib/v3/tests/agent-experimental-validation.spec.js.map +0 -7
  1226. package/dist/cjs/lib/v3/tests/agent-hybrid-mode.spec.js +0 -247
  1227. package/dist/cjs/lib/v3/tests/agent-hybrid-mode.spec.js.map +0 -7
  1228. package/dist/cjs/lib/v3/tests/agent-message-continuation.spec.js +0 -105
  1229. package/dist/cjs/lib/v3/tests/agent-message-continuation.spec.js.map +0 -7
  1230. package/dist/cjs/lib/v3/tests/agent-streaming.spec.js +0 -126
  1231. package/dist/cjs/lib/v3/tests/agent-streaming.spec.js.map +0 -7
  1232. package/dist/cjs/lib/v3/tests/cdp-session-detached.spec.js +0 -44
  1233. package/dist/cjs/lib/v3/tests/cdp-session-detached.spec.js.map +0 -7
  1234. package/dist/cjs/lib/v3/tests/click-count.spec.js +0 -147
  1235. package/dist/cjs/lib/v3/tests/click-count.spec.js.map +0 -7
  1236. package/dist/cjs/lib/v3/tests/connect-to-existing-browser.spec.js +0 -54
  1237. package/dist/cjs/lib/v3/tests/connect-to-existing-browser.spec.js.map +0 -7
  1238. package/dist/cjs/lib/v3/tests/context-addInitScript.spec.js +0 -176
  1239. package/dist/cjs/lib/v3/tests/context-addInitScript.spec.js.map +0 -7
  1240. package/dist/cjs/lib/v3/tests/default-page-tracking.spec.js +0 -53
  1241. package/dist/cjs/lib/v3/tests/default-page-tracking.spec.js.map +0 -7
  1242. package/dist/cjs/lib/v3/tests/downloads.spec.js +0 -80
  1243. package/dist/cjs/lib/v3/tests/downloads.spec.js.map +0 -7
  1244. package/dist/cjs/lib/v3/tests/frame-get-location-and-click.spec.js +0 -53
  1245. package/dist/cjs/lib/v3/tests/frame-get-location-and-click.spec.js.map +0 -7
  1246. package/dist/cjs/lib/v3/tests/iframe-ctx-addInitScript.spec.js +0 -493
  1247. package/dist/cjs/lib/v3/tests/iframe-ctx-addInitScript.spec.js.map +0 -7
  1248. package/dist/cjs/lib/v3/tests/keep-alive.child.js +0 -92
  1249. package/dist/cjs/lib/v3/tests/keep-alive.child.js.map +0 -7
  1250. package/dist/cjs/lib/v3/tests/keep-alive.helpers.js +0 -568
  1251. package/dist/cjs/lib/v3/tests/keep-alive.helpers.js.map +0 -7
  1252. package/dist/cjs/lib/v3/tests/keep-alive.spec.js +0 -15
  1253. package/dist/cjs/lib/v3/tests/keep-alive.spec.js.map +0 -7
  1254. package/dist/cjs/lib/v3/tests/keyboard.spec.js +0 -296
  1255. package/dist/cjs/lib/v3/tests/keyboard.spec.js.map +0 -7
  1256. package/dist/cjs/lib/v3/tests/locator-backend-node-id.spec.js +0 -159
  1257. package/dist/cjs/lib/v3/tests/locator-backend-node-id.spec.js.map +0 -7
  1258. package/dist/cjs/lib/v3/tests/locator-content-methods.spec.js +0 -192
  1259. package/dist/cjs/lib/v3/tests/locator-content-methods.spec.js.map +0 -7
  1260. package/dist/cjs/lib/v3/tests/locator-count-iframe.spec.js +0 -108
  1261. package/dist/cjs/lib/v3/tests/locator-count-iframe.spec.js.map +0 -7
  1262. package/dist/cjs/lib/v3/tests/locator-count.spec.js +0 -71
  1263. package/dist/cjs/lib/v3/tests/locator-count.spec.js.map +0 -7
  1264. package/dist/cjs/lib/v3/tests/locator-fill.spec.js +0 -119
  1265. package/dist/cjs/lib/v3/tests/locator-fill.spec.js.map +0 -7
  1266. package/dist/cjs/lib/v3/tests/locator-input-methods.spec.js +0 -137
  1267. package/dist/cjs/lib/v3/tests/locator-input-methods.spec.js.map +0 -7
  1268. package/dist/cjs/lib/v3/tests/locator-nth.spec.js +0 -157
  1269. package/dist/cjs/lib/v3/tests/locator-nth.spec.js.map +0 -7
  1270. package/dist/cjs/lib/v3/tests/locator-select-option.spec.js +0 -243
  1271. package/dist/cjs/lib/v3/tests/locator-select-option.spec.js.map +0 -7
  1272. package/dist/cjs/lib/v3/tests/logger-initialization.spec.js +0 -547
  1273. package/dist/cjs/lib/v3/tests/logger-initialization.spec.js.map +0 -7
  1274. package/dist/cjs/lib/v3/tests/multi-instance-logger.spec.js +0 -269
  1275. package/dist/cjs/lib/v3/tests/multi-instance-logger.spec.js.map +0 -7
  1276. package/dist/cjs/lib/v3/tests/nested-div.spec.js +0 -23
  1277. package/dist/cjs/lib/v3/tests/nested-div.spec.js.map +0 -7
  1278. package/dist/cjs/lib/v3/tests/page-addInitScript.spec.js +0 -90
  1279. package/dist/cjs/lib/v3/tests/page-addInitScript.spec.js.map +0 -7
  1280. package/dist/cjs/lib/v3/tests/page-console.spec.js +0 -56
  1281. package/dist/cjs/lib/v3/tests/page-console.spec.js.map +0 -7
  1282. package/dist/cjs/lib/v3/tests/page-drag-and-drop.spec.js +0 -418
  1283. package/dist/cjs/lib/v3/tests/page-drag-and-drop.spec.js.map +0 -7
  1284. package/dist/cjs/lib/v3/tests/page-goto-response.spec.js +0 -35
  1285. package/dist/cjs/lib/v3/tests/page-goto-response.spec.js.map +0 -7
  1286. package/dist/cjs/lib/v3/tests/page-hover.spec.js +0 -167
  1287. package/dist/cjs/lib/v3/tests/page-hover.spec.js.map +0 -7
  1288. package/dist/cjs/lib/v3/tests/page-screenshot.spec.js +0 -295
  1289. package/dist/cjs/lib/v3/tests/page-screenshot.spec.js.map +0 -7
  1290. package/dist/cjs/lib/v3/tests/page-scroll.spec.js +0 -182
  1291. package/dist/cjs/lib/v3/tests/page-scroll.spec.js.map +0 -7
  1292. package/dist/cjs/lib/v3/tests/page-send-cdp.spec.js +0 -46
  1293. package/dist/cjs/lib/v3/tests/page-send-cdp.spec.js.map +0 -7
  1294. package/dist/cjs/lib/v3/tests/perform-understudy-method.spec.js +0 -98
  1295. package/dist/cjs/lib/v3/tests/perform-understudy-method.spec.js.map +0 -7
  1296. package/dist/cjs/lib/v3/tests/setinputfiles.spec.js +0 -148
  1297. package/dist/cjs/lib/v3/tests/setinputfiles.spec.js.map +0 -7
  1298. package/dist/cjs/lib/v3/tests/shadow-iframe-oopif.spec.js +0 -156
  1299. package/dist/cjs/lib/v3/tests/shadow-iframe-oopif.spec.js.map +0 -7
  1300. package/dist/cjs/lib/v3/tests/shadow-iframe-spif.spec.js +0 -156
  1301. package/dist/cjs/lib/v3/tests/shadow-iframe-spif.spec.js.map +0 -7
  1302. package/dist/cjs/lib/v3/tests/testUtils.js +0 -54
  1303. package/dist/cjs/lib/v3/tests/testUtils.js.map +0 -7
  1304. package/dist/cjs/lib/v3/tests/text-selector-innermost.spec.js +0 -100
  1305. package/dist/cjs/lib/v3/tests/text-selector-innermost.spec.js.map +0 -7
  1306. package/dist/cjs/lib/v3/tests/timeouts.spec.js +0 -32
  1307. package/dist/cjs/lib/v3/tests/timeouts.spec.js.map +0 -7
  1308. package/dist/cjs/lib/v3/tests/user-data-dir.spec.js +0 -65
  1309. package/dist/cjs/lib/v3/tests/user-data-dir.spec.js.map +0 -7
  1310. package/dist/cjs/lib/v3/tests/v3.config.js +0 -36
  1311. package/dist/cjs/lib/v3/tests/v3.config.js.map +0 -7
  1312. package/dist/cjs/lib/v3/tests/v3.dynamic.config.js +0 -67
  1313. package/dist/cjs/lib/v3/tests/v3.dynamic.config.js.map +0 -7
  1314. package/dist/cjs/lib/v3/tests/v3.playwright.config.js +0 -61
  1315. package/dist/cjs/lib/v3/tests/v3.playwright.config.js.map +0 -7
  1316. package/dist/cjs/lib/v3/tests/wait-for-selector.spec.js +0 -593
  1317. package/dist/cjs/lib/v3/tests/wait-for-selector.spec.js.map +0 -7
  1318. package/dist/cjs/lib/v3/tests/wait-for-timeout.spec.js +0 -97
  1319. package/dist/cjs/lib/v3/tests/wait-for-timeout.spec.js.map +0 -7
  1320. package/dist/cjs/lib/v3/tests/xpath-for-location-deep.spec.js +0 -77
  1321. package/dist/cjs/lib/v3/tests/xpath-for-location-deep.spec.js.map +0 -7
  1322. package/dist/cjs/tests/agent-execution-model.test.js +0 -139
  1323. package/dist/cjs/tests/agent-execution-model.test.js.map +0 -7
  1324. package/dist/cjs/tests/api-multiregion.test.js +0 -73
  1325. package/dist/cjs/tests/api-multiregion.test.js.map +0 -7
  1326. package/dist/cjs/tests/browserbase-session-accessors.test.js +0 -101
  1327. package/dist/cjs/tests/browserbase-session-accessors.test.js.map +0 -7
  1328. package/dist/cjs/tests/cache-llm-resolution.test.js +0 -187
  1329. package/dist/cjs/tests/cache-llm-resolution.test.js.map +0 -7
  1330. package/dist/cjs/tests/helpers/mockCDPSession.js +0 -50
  1331. package/dist/cjs/tests/helpers/mockCDPSession.js.map +0 -7
  1332. package/dist/cjs/tests/llm-provider.test.js +0 -57
  1333. package/dist/cjs/tests/llm-provider.test.js.map +0 -7
  1334. package/dist/cjs/tests/model-deprecation.test.js +0 -132
  1335. package/dist/cjs/tests/model-deprecation.test.js.map +0 -7
  1336. package/dist/cjs/tests/model-utils.test.js +0 -43
  1337. package/dist/cjs/tests/model-utils.test.js.map +0 -7
  1338. package/dist/cjs/tests/page-snapshot.test.js +0 -58
  1339. package/dist/cjs/tests/page-snapshot.test.js.map +0 -7
  1340. package/dist/cjs/tests/public-api/export-surface.test.js +0 -77
  1341. package/dist/cjs/tests/public-api/export-surface.test.js.map +0 -7
  1342. package/dist/cjs/tests/public-api/llm-and-agents.test.js +0 -151
  1343. package/dist/cjs/tests/public-api/llm-and-agents.test.js.map +0 -7
  1344. package/dist/cjs/tests/public-api/public-error-types.test.js +0 -106
  1345. package/dist/cjs/tests/public-api/public-error-types.test.js.map +0 -7
  1346. package/dist/cjs/tests/public-api/public-types.test.js +0 -74
  1347. package/dist/cjs/tests/public-api/public-types.test.js.map +0 -7
  1348. package/dist/cjs/tests/public-api/runtime-utils.test.js +0 -53
  1349. package/dist/cjs/tests/public-api/runtime-utils.test.js.map +0 -7
  1350. package/dist/cjs/tests/public-api/schema-utils.test.js +0 -100
  1351. package/dist/cjs/tests/public-api/schema-utils.test.js.map +0 -7
  1352. package/dist/cjs/tests/public-api/timeout-error-types.test.js +0 -103
  1353. package/dist/cjs/tests/public-api/timeout-error-types.test.js.map +0 -7
  1354. package/dist/cjs/tests/public-api/tool-type-export.test.js +0 -47
  1355. package/dist/cjs/tests/public-api/tool-type-export.test.js.map +0 -7
  1356. package/dist/cjs/tests/public-api/v3-core.test.js +0 -105
  1357. package/dist/cjs/tests/public-api/v3-core.test.js.map +0 -7
  1358. package/dist/cjs/tests/safety-confirmation.test.js +0 -134
  1359. package/dist/cjs/tests/safety-confirmation.test.js.map +0 -7
  1360. package/dist/cjs/tests/snapshot-a11y-resolvers.test.js +0 -370
  1361. package/dist/cjs/tests/snapshot-a11y-resolvers.test.js.map +0 -7
  1362. package/dist/cjs/tests/snapshot-a11y-tree-utils.test.js +0 -294
  1363. package/dist/cjs/tests/snapshot-a11y-tree-utils.test.js.map +0 -7
  1364. package/dist/cjs/tests/snapshot-capture-orchestration.test.js +0 -405
  1365. package/dist/cjs/tests/snapshot-capture-orchestration.test.js.map +0 -7
  1366. package/dist/cjs/tests/snapshot-cbor.test.js +0 -197
  1367. package/dist/cjs/tests/snapshot-cbor.test.js.map +0 -7
  1368. package/dist/cjs/tests/snapshot-dom-session-builders.test.js +0 -246
  1369. package/dist/cjs/tests/snapshot-dom-session-builders.test.js.map +0 -7
  1370. package/dist/cjs/tests/snapshot-dom-tree-utils.test.js +0 -104
  1371. package/dist/cjs/tests/snapshot-dom-tree-utils.test.js.map +0 -7
  1372. package/dist/cjs/tests/snapshot-focus-selectors-utils.test.js +0 -45
  1373. package/dist/cjs/tests/snapshot-focus-selectors-utils.test.js.map +0 -7
  1374. package/dist/cjs/tests/snapshot-frame-merge.test.js +0 -388
  1375. package/dist/cjs/tests/snapshot-frame-merge.test.js.map +0 -7
  1376. package/dist/cjs/tests/snapshot-tree-format-utils.test.js +0 -106
  1377. package/dist/cjs/tests/snapshot-tree-format-utils.test.js.map +0 -7
  1378. package/dist/cjs/tests/snapshot-xpath-utils.test.js +0 -74
  1379. package/dist/cjs/tests/snapshot-xpath-utils.test.js.map +0 -7
  1380. package/dist/cjs/tests/timeout-handlers.test.js +0 -864
  1381. package/dist/cjs/tests/timeout-handlers.test.js.map +0 -7
  1382. package/dist/cjs/tests/understudy-command-exception.test.js +0 -52
  1383. package/dist/cjs/tests/understudy-command-exception.test.js.map +0 -7
  1384. package/dist/cjs/tests/xpath-parser.test.js +0 -314
  1385. package/dist/cjs/tests/xpath-parser.test.js.map +0 -7
  1386. package/dist/cjs/tests/xpath-resolver.test.js +0 -70
  1387. package/dist/cjs/tests/xpath-resolver.test.js.map +0 -7
  1388. package/dist/cjs/tests/zod-enum-compatibility.test.js +0 -119
  1389. package/dist/cjs/tests/zod-enum-compatibility.test.js.map +0 -7
  1390. package/dist/esm/lib/v3/agent/tools/search.js +0 -73
  1391. package/dist/esm/lib/v3/agent/tools/search.js.map +0 -1
  1392. package/dist/esm/lib/v3/dom/build/rerender-index.d.ts +0 -0
  1393. package/dist/esm/lib/v3/dom/build/rerender-index.js.map +0 -1
  1394. package/dist/esm/lib/v3/dom/build/v3-index.d.ts +0 -0
  1395. package/dist/esm/lib/v3/dom/build/v3-index.js.map +0 -1
  1396. package/dist/esm/lib/v3/dom/genA11yScripts.js +0 -54
  1397. package/dist/esm/lib/v3/dom/genA11yScripts.js.map +0 -1
  1398. package/dist/esm/lib/v3/dom/genDomScripts.js +0 -38
  1399. package/dist/esm/lib/v3/dom/genDomScripts.js.map +0 -1
  1400. package/dist/esm/lib/v3/dom/genLocatorScripts.js +0 -51
  1401. package/dist/esm/lib/v3/dom/genLocatorScripts.js.map +0 -1
  1402. package/dist/esm/lib/v3/dom/genScreenshotScripts.js +0 -37
  1403. package/dist/esm/lib/v3/dom/genScreenshotScripts.js.map +0 -1
  1404. package/dist/esm/lib/v3/flowLogger.d.ts +0 -139
  1405. package/dist/esm/lib/v3/flowLogger.js +0 -868
  1406. package/dist/esm/lib/v3/flowLogger.js.map +0 -1
  1407. package/dist/esm/lib/v3/tests/agent-abort-signal.spec.js +0 -113
  1408. package/dist/esm/lib/v3/tests/agent-abort-signal.spec.js.map +0 -7
  1409. package/dist/esm/lib/v3/tests/agent-cache-self-heal.spec.js +0 -80
  1410. package/dist/esm/lib/v3/tests/agent-cache-self-heal.spec.js.map +0 -7
  1411. package/dist/esm/lib/v3/tests/agent-callbacks.spec.js +0 -374
  1412. package/dist/esm/lib/v3/tests/agent-callbacks.spec.js.map +0 -7
  1413. package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js +0 -357
  1414. package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js.map +0 -7
  1415. package/dist/esm/lib/v3/tests/agent-hybrid-mode.spec.js +0 -247
  1416. package/dist/esm/lib/v3/tests/agent-hybrid-mode.spec.js.map +0 -7
  1417. package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js +0 -105
  1418. package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js.map +0 -7
  1419. package/dist/esm/lib/v3/tests/agent-streaming.spec.js +0 -126
  1420. package/dist/esm/lib/v3/tests/agent-streaming.spec.js.map +0 -7
  1421. package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js +0 -44
  1422. package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js.map +0 -7
  1423. package/dist/esm/lib/v3/tests/click-count.spec.js +0 -147
  1424. package/dist/esm/lib/v3/tests/click-count.spec.js.map +0 -7
  1425. package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js +0 -54
  1426. package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js.map +0 -7
  1427. package/dist/esm/lib/v3/tests/context-addInitScript.spec.js +0 -176
  1428. package/dist/esm/lib/v3/tests/context-addInitScript.spec.js.map +0 -7
  1429. package/dist/esm/lib/v3/tests/default-page-tracking.spec.js +0 -53
  1430. package/dist/esm/lib/v3/tests/default-page-tracking.spec.js.map +0 -7
  1431. package/dist/esm/lib/v3/tests/downloads.spec.js +0 -58
  1432. package/dist/esm/lib/v3/tests/downloads.spec.js.map +0 -7
  1433. package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js +0 -53
  1434. package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js.map +0 -7
  1435. package/dist/esm/lib/v3/tests/iframe-ctx-addInitScript.spec.js +0 -493
  1436. package/dist/esm/lib/v3/tests/iframe-ctx-addInitScript.spec.js.map +0 -7
  1437. package/dist/esm/lib/v3/tests/keep-alive.child.js +0 -92
  1438. package/dist/esm/lib/v3/tests/keep-alive.child.js.map +0 -7
  1439. package/dist/esm/lib/v3/tests/keep-alive.helpers.js +0 -532
  1440. package/dist/esm/lib/v3/tests/keep-alive.helpers.js.map +0 -7
  1441. package/dist/esm/lib/v3/tests/keep-alive.spec.js +0 -19
  1442. package/dist/esm/lib/v3/tests/keep-alive.spec.js.map +0 -7
  1443. package/dist/esm/lib/v3/tests/keyboard.spec.js +0 -296
  1444. package/dist/esm/lib/v3/tests/keyboard.spec.js.map +0 -7
  1445. package/dist/esm/lib/v3/tests/locator-backend-node-id.spec.js +0 -159
  1446. package/dist/esm/lib/v3/tests/locator-backend-node-id.spec.js.map +0 -7
  1447. package/dist/esm/lib/v3/tests/locator-content-methods.spec.js +0 -192
  1448. package/dist/esm/lib/v3/tests/locator-content-methods.spec.js.map +0 -7
  1449. package/dist/esm/lib/v3/tests/locator-count-iframe.spec.js +0 -108
  1450. package/dist/esm/lib/v3/tests/locator-count-iframe.spec.js.map +0 -7
  1451. package/dist/esm/lib/v3/tests/locator-count.spec.js +0 -71
  1452. package/dist/esm/lib/v3/tests/locator-count.spec.js.map +0 -7
  1453. package/dist/esm/lib/v3/tests/locator-fill.spec.js +0 -119
  1454. package/dist/esm/lib/v3/tests/locator-fill.spec.js.map +0 -7
  1455. package/dist/esm/lib/v3/tests/locator-input-methods.spec.js +0 -137
  1456. package/dist/esm/lib/v3/tests/locator-input-methods.spec.js.map +0 -7
  1457. package/dist/esm/lib/v3/tests/locator-nth.spec.js +0 -157
  1458. package/dist/esm/lib/v3/tests/locator-nth.spec.js.map +0 -7
  1459. package/dist/esm/lib/v3/tests/locator-select-option.spec.js +0 -243
  1460. package/dist/esm/lib/v3/tests/locator-select-option.spec.js.map +0 -7
  1461. package/dist/esm/lib/v3/tests/logger-initialization.spec.js +0 -552
  1462. package/dist/esm/lib/v3/tests/logger-initialization.spec.js.map +0 -7
  1463. package/dist/esm/lib/v3/tests/multi-instance-logger.spec.js +0 -269
  1464. package/dist/esm/lib/v3/tests/multi-instance-logger.spec.js.map +0 -7
  1465. package/dist/esm/lib/v3/tests/nested-div.spec.js +0 -23
  1466. package/dist/esm/lib/v3/tests/nested-div.spec.js.map +0 -7
  1467. package/dist/esm/lib/v3/tests/page-addInitScript.spec.js +0 -90
  1468. package/dist/esm/lib/v3/tests/page-addInitScript.spec.js.map +0 -7
  1469. package/dist/esm/lib/v3/tests/page-console.spec.js +0 -56
  1470. package/dist/esm/lib/v3/tests/page-console.spec.js.map +0 -7
  1471. package/dist/esm/lib/v3/tests/page-drag-and-drop.spec.js +0 -418
  1472. package/dist/esm/lib/v3/tests/page-drag-and-drop.spec.js.map +0 -7
  1473. package/dist/esm/lib/v3/tests/page-goto-response.spec.js +0 -35
  1474. package/dist/esm/lib/v3/tests/page-goto-response.spec.js.map +0 -7
  1475. package/dist/esm/lib/v3/tests/page-hover.spec.js +0 -167
  1476. package/dist/esm/lib/v3/tests/page-hover.spec.js.map +0 -7
  1477. package/dist/esm/lib/v3/tests/page-screenshot.spec.js +0 -273
  1478. package/dist/esm/lib/v3/tests/page-screenshot.spec.js.map +0 -7
  1479. package/dist/esm/lib/v3/tests/page-scroll.spec.js +0 -182
  1480. package/dist/esm/lib/v3/tests/page-scroll.spec.js.map +0 -7
  1481. package/dist/esm/lib/v3/tests/page-send-cdp.spec.js +0 -46
  1482. package/dist/esm/lib/v3/tests/page-send-cdp.spec.js.map +0 -7
  1483. package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js +0 -98
  1484. package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js.map +0 -7
  1485. package/dist/esm/lib/v3/tests/setinputfiles.spec.js +0 -126
  1486. package/dist/esm/lib/v3/tests/setinputfiles.spec.js.map +0 -7
  1487. package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js +0 -134
  1488. package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js.map +0 -7
  1489. package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js +0 -134
  1490. package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js.map +0 -7
  1491. package/dist/esm/lib/v3/tests/testUtils.js +0 -31
  1492. package/dist/esm/lib/v3/tests/testUtils.js.map +0 -7
  1493. package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js +0 -100
  1494. package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js.map +0 -7
  1495. package/dist/esm/lib/v3/tests/timeouts.spec.js +0 -32
  1496. package/dist/esm/lib/v3/tests/timeouts.spec.js.map +0 -7
  1497. package/dist/esm/lib/v3/tests/user-data-dir.spec.js +0 -43
  1498. package/dist/esm/lib/v3/tests/user-data-dir.spec.js.map +0 -7
  1499. package/dist/esm/lib/v3/tests/v3.config.js +0 -15
  1500. package/dist/esm/lib/v3/tests/v3.config.js.map +0 -7
  1501. package/dist/esm/lib/v3/tests/v3.dynamic.config.js +0 -43
  1502. package/dist/esm/lib/v3/tests/v3.dynamic.config.js.map +0 -7
  1503. package/dist/esm/lib/v3/tests/v3.playwright.config.js +0 -41
  1504. package/dist/esm/lib/v3/tests/v3.playwright.config.js.map +0 -7
  1505. package/dist/esm/lib/v3/tests/wait-for-selector.spec.js +0 -593
  1506. package/dist/esm/lib/v3/tests/wait-for-selector.spec.js.map +0 -7
  1507. package/dist/esm/lib/v3/tests/wait-for-timeout.spec.js +0 -97
  1508. package/dist/esm/lib/v3/tests/wait-for-timeout.spec.js.map +0 -7
  1509. package/dist/esm/lib/v3/tests/xpath-for-location-deep.spec.js +0 -77
  1510. package/dist/esm/lib/v3/tests/xpath-for-location-deep.spec.js.map +0 -7
  1511. package/dist/esm/tests/agent-execution-model.test.js +0 -139
  1512. package/dist/esm/tests/agent-execution-model.test.js.map +0 -7
  1513. package/dist/esm/tests/api-multiregion.test.js +0 -73
  1514. package/dist/esm/tests/api-multiregion.test.js.map +0 -7
  1515. package/dist/esm/tests/browserbase-session-accessors.test.js +0 -101
  1516. package/dist/esm/tests/browserbase-session-accessors.test.js.map +0 -7
  1517. package/dist/esm/tests/cache-llm-resolution.test.js +0 -187
  1518. package/dist/esm/tests/cache-llm-resolution.test.js.map +0 -7
  1519. package/dist/esm/tests/helpers/mockCDPSession.js +0 -27
  1520. package/dist/esm/tests/helpers/mockCDPSession.js.map +0 -7
  1521. package/dist/esm/tests/llm-provider.test.js +0 -57
  1522. package/dist/esm/tests/llm-provider.test.js.map +0 -7
  1523. package/dist/esm/tests/model-deprecation.test.js +0 -135
  1524. package/dist/esm/tests/model-deprecation.test.js.map +0 -7
  1525. package/dist/esm/tests/model-utils.test.js +0 -43
  1526. package/dist/esm/tests/model-utils.test.js.map +0 -7
  1527. package/dist/esm/tests/page-snapshot.test.js +0 -36
  1528. package/dist/esm/tests/page-snapshot.test.js.map +0 -7
  1529. package/dist/esm/tests/public-api/export-surface.test.js +0 -55
  1530. package/dist/esm/tests/public-api/export-surface.test.js.map +0 -7
  1531. package/dist/esm/tests/public-api/llm-and-agents.test.js +0 -129
  1532. package/dist/esm/tests/public-api/llm-and-agents.test.js.map +0 -7
  1533. package/dist/esm/tests/public-api/public-error-types.test.js +0 -73
  1534. package/dist/esm/tests/public-api/public-error-types.test.js.map +0 -7
  1535. package/dist/esm/tests/public-api/public-types.test.js +0 -74
  1536. package/dist/esm/tests/public-api/public-types.test.js.map +0 -7
  1537. package/dist/esm/tests/public-api/runtime-utils.test.js +0 -31
  1538. package/dist/esm/tests/public-api/runtime-utils.test.js.map +0 -7
  1539. package/dist/esm/tests/public-api/schema-utils.test.js +0 -78
  1540. package/dist/esm/tests/public-api/schema-utils.test.js.map +0 -7
  1541. package/dist/esm/tests/public-api/timeout-error-types.test.js +0 -81
  1542. package/dist/esm/tests/public-api/timeout-error-types.test.js.map +0 -7
  1543. package/dist/esm/tests/public-api/tool-type-export.test.js +0 -25
  1544. package/dist/esm/tests/public-api/tool-type-export.test.js.map +0 -7
  1545. package/dist/esm/tests/public-api/v3-core.test.js +0 -83
  1546. package/dist/esm/tests/public-api/v3-core.test.js.map +0 -7
  1547. package/dist/esm/tests/safety-confirmation.test.js +0 -134
  1548. package/dist/esm/tests/safety-confirmation.test.js.map +0 -7
  1549. package/dist/esm/tests/snapshot-a11y-resolvers.test.js +0 -348
  1550. package/dist/esm/tests/snapshot-a11y-resolvers.test.js.map +0 -7
  1551. package/dist/esm/tests/snapshot-a11y-tree-utils.test.js +0 -300
  1552. package/dist/esm/tests/snapshot-a11y-tree-utils.test.js.map +0 -7
  1553. package/dist/esm/tests/snapshot-capture-orchestration.test.js +0 -383
  1554. package/dist/esm/tests/snapshot-capture-orchestration.test.js.map +0 -7
  1555. package/dist/esm/tests/snapshot-cbor.test.js +0 -197
  1556. package/dist/esm/tests/snapshot-cbor.test.js.map +0 -7
  1557. package/dist/esm/tests/snapshot-dom-session-builders.test.js +0 -251
  1558. package/dist/esm/tests/snapshot-dom-session-builders.test.js.map +0 -7
  1559. package/dist/esm/tests/snapshot-dom-tree-utils.test.js +0 -109
  1560. package/dist/esm/tests/snapshot-dom-tree-utils.test.js.map +0 -7
  1561. package/dist/esm/tests/snapshot-focus-selectors-utils.test.js +0 -49
  1562. package/dist/esm/tests/snapshot-focus-selectors-utils.test.js.map +0 -7
  1563. package/dist/esm/tests/snapshot-frame-merge.test.js +0 -391
  1564. package/dist/esm/tests/snapshot-frame-merge.test.js.map +0 -7
  1565. package/dist/esm/tests/snapshot-tree-format-utils.test.js +0 -113
  1566. package/dist/esm/tests/snapshot-tree-format-utils.test.js.map +0 -7
  1567. package/dist/esm/tests/snapshot-xpath-utils.test.js +0 -79
  1568. package/dist/esm/tests/snapshot-xpath-utils.test.js.map +0 -7
  1569. package/dist/esm/tests/timeout-handlers.test.js +0 -850
  1570. package/dist/esm/tests/timeout-handlers.test.js.map +0 -7
  1571. package/dist/esm/tests/understudy-command-exception.test.js +0 -55
  1572. package/dist/esm/tests/understudy-command-exception.test.js.map +0 -7
  1573. package/dist/esm/tests/xpath-parser.test.js +0 -317
  1574. package/dist/esm/tests/xpath-parser.test.js.map +0 -7
  1575. package/dist/esm/tests/xpath-resolver.test.js +0 -73
  1576. package/dist/esm/tests/xpath-resolver.test.js.map +0 -7
  1577. package/dist/esm/tests/zod-enum-compatibility.test.js +0 -97
  1578. package/dist/esm/tests/zod-enum-compatibility.test.js.map +0 -7
  1579. /package/dist/cjs/lib/v3/agent/tools/{search.d.ts → braveSearch.d.ts} +0 -0
  1580. /package/dist/cjs/{lib/v3/dom/genA11yScripts.d.ts → tests/cache-variables.test.d.ts} +0 -0
  1581. /package/dist/cjs/{lib/v3/dom/genDomScripts.d.ts → tests/integration/agent-abort-signal.spec.d.ts} +0 -0
  1582. /package/dist/cjs/{lib/v3/dom/genLocatorScripts.d.ts → tests/integration/agent-cache-self-heal.spec.d.ts} +0 -0
  1583. /package/dist/cjs/{lib/v3/dom/genScreenshotScripts.d.ts → tests/integration/agent-callbacks.spec.d.ts} +0 -0
  1584. /package/dist/{esm/lib/v3/dom/genA11yScripts.d.ts → cjs/tests/integration/agent-captcha-autosolve.spec.d.ts} +0 -0
  1585. /package/dist/{esm/lib/v3/dom/genDomScripts.d.ts → cjs/tests/integration/agent-experimental-validation.spec.d.ts} +0 -0
  1586. /package/dist/{esm/lib/v3/dom/genLocatorScripts.d.ts → cjs/tests/integration/agent-hybrid-mode.spec.d.ts} +0 -0
  1587. /package/dist/{esm/lib/v3/dom/genScreenshotScripts.d.ts → cjs/tests/integration/agent-message-continuation.spec.d.ts} +0 -0
  1588. /package/dist/esm/lib/v3/agent/tools/{search.d.ts → braveSearch.d.ts} +0 -0
@@ -1,4 +1,5 @@
1
1
  import type { Protocol } from "devtools-protocol";
2
+ import { type FlowLoggerContext } from "../flowlogger/FlowLogger.js";
2
3
  /**
3
4
  * CDP transport & session multiplexer
4
5
  *
@@ -19,35 +20,30 @@ export declare class CdpConnection implements CDPSessionLike {
19
20
  private ws;
20
21
  private nextId;
21
22
  private inflight;
23
+ private latestCdpCallEvent;
22
24
  private eventHandlers;
23
25
  private sessions;
24
26
  /** Maps sessionId -> targetId (1:1 mapping) */
25
27
  private sessionToTarget;
28
+ private sessionDispatchWaiters;
26
29
  readonly id: string | null;
27
30
  private transportCloseHandlers;
28
- /** Optional CDP logger - set this to receive all outgoing CDP method calls */
29
- cdpLogger?: (info: {
30
- method: string;
31
- params?: object;
32
- targetId?: string | null;
33
- }) => void;
34
- /** Optional CDP event logger - set this to receive all incoming CDP events */
35
- cdpEventLogger?: (info: {
36
- method: string;
37
- params?: unknown;
38
- targetId?: string | null;
39
- }) => void;
31
+ flowLoggerContext?: FlowLoggerContext;
40
32
  onTransportClosed(handler: (why: string) => void): void;
41
33
  offTransportClosed(handler: (why: string) => void): void;
42
34
  private emitTransportClosed;
43
35
  private constructor();
44
- static connect(wsUrl: string): Promise<CdpConnection>;
36
+ static connect(wsUrl: string, options?: {
37
+ headers?: Record<string, string>;
38
+ }): Promise<CdpConnection>;
45
39
  enableAutoAttach(): Promise<void>;
46
40
  send<R = unknown>(method: string, params?: object): Promise<R>;
47
41
  on<P = unknown>(event: string, handler: (params: P) => void): void;
48
42
  off<P = unknown>(event: string, handler: (params: P) => void): void;
49
43
  close(): Promise<void>;
44
+ private rejectAllInflight;
50
45
  getSession(sessionId: string): CdpSession | undefined;
46
+ waitForSessionDispatch(sessionId: string, method: string, match?: (params?: object) => boolean): Promise<void>;
51
47
  attachToTarget(targetId: string): Promise<CdpSession>;
52
48
  getTargets(): Promise<Protocol.Target.TargetInfo[]>;
53
49
  private onMessage;
@@ -0,0 +1,430 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.CdpSession = exports.CdpConnection = void 0;
7
+ // lib/v3/understudy/cdp.ts
8
+ const ws_1 = __importDefault(require("ws"));
9
+ const version_js_1 = require("../../version.js");
10
+ const FlowLogger_js_1 = require("../flowlogger/FlowLogger.js");
11
+ const sdkErrors_js_1 = require("../types/public/sdkErrors.js");
12
+ class CdpConnection {
13
+ ws;
14
+ nextId = 1;
15
+ inflight = new Map(); // Outstanding request records; `_sendViaSession()` inserts and `onMessage()` removes/resolves them.
16
+ latestCdpCallEvent = new Map();
17
+ eventHandlers = new Map();
18
+ sessions = new Map();
19
+ /** Maps sessionId -> targetId (1:1 mapping) */
20
+ sessionToTarget = new Map();
21
+ sessionDispatchWaiters = new Set();
22
+ id = null; // root
23
+ transportCloseHandlers = new Set();
24
+ flowLoggerContext; // Instance-owned fallback flow context; V3 sets this once and later sends/callbacks re-enter it when ALS is absent.
25
+ onTransportClosed(handler) {
26
+ this.transportCloseHandlers.add(handler);
27
+ }
28
+ offTransportClosed(handler) {
29
+ this.transportCloseHandlers.delete(handler);
30
+ }
31
+ emitTransportClosed(why) {
32
+ for (const h of this.transportCloseHandlers) {
33
+ try {
34
+ h(why);
35
+ }
36
+ catch {
37
+ //
38
+ }
39
+ }
40
+ }
41
+ constructor(ws) {
42
+ this.ws = ws;
43
+ this.ws.on("close", (code, reason) => {
44
+ // Reason is a Buffer in ws; stringify defensively
45
+ const why = `socket-close code=${code} reason=${String(reason || "")}`;
46
+ this.rejectAllInflight(why);
47
+ this.emitTransportClosed(why);
48
+ });
49
+ this.ws.on("error", (err) => {
50
+ const why = `socket-error ${err?.message ?? String(err)}`;
51
+ this.rejectAllInflight(why);
52
+ this.emitTransportClosed(why);
53
+ });
54
+ this.ws.on("message", (data) => this.onMessage(data.toString()));
55
+ }
56
+ static async connect(wsUrl, options) {
57
+ // Include User-Agent header for server-side observability and version tracking
58
+ // Merge user-provided headers, letting them override defaults
59
+ const headers = {
60
+ "User-Agent": `Stagehand/${version_js_1.STAGEHAND_VERSION}`,
61
+ ...options?.headers,
62
+ };
63
+ const ws = new ws_1.default(wsUrl, { headers });
64
+ await new Promise((resolve, reject) => {
65
+ ws.once("open", () => resolve());
66
+ ws.once("error", (e) => reject(e));
67
+ });
68
+ return new CdpConnection(ws);
69
+ }
70
+ async enableAutoAttach() {
71
+ await this.send("Target.setAutoAttach", {
72
+ autoAttach: true,
73
+ flatten: true,
74
+ waitForDebuggerOnStart: true,
75
+ });
76
+ await this.send("Target.setDiscoverTargets", { discover: true });
77
+ }
78
+ async send(method, params) {
79
+ const id = this.nextId++;
80
+ const payload = { id, method, params };
81
+ const stack = new Error().stack?.split("\n").slice(1, 4).join("\n");
82
+ const flowLoggerContext = FlowLogger_js_1.FlowLogger.resolveContext(this.flowLoggerContext);
83
+ const cdpCallEvent = flowLoggerContext
84
+ ? FlowLogger_js_1.FlowLogger.logCdpCallEvent(flowLoggerContext, {
85
+ method,
86
+ params,
87
+ targetId: null,
88
+ })
89
+ : null;
90
+ if (flowLoggerContext && cdpCallEvent) {
91
+ this.latestCdpCallEvent.set(null, {
92
+ flowLoggerContext,
93
+ cdpCallEvent,
94
+ });
95
+ }
96
+ const p = new Promise((resolve, reject) => {
97
+ this.inflight.set(id, {
98
+ resolve,
99
+ reject,
100
+ sessionId: null,
101
+ method,
102
+ params,
103
+ stack,
104
+ ts: Date.now(),
105
+ flowLoggerContext,
106
+ cdpCallEvent,
107
+ });
108
+ });
109
+ // Prevent unhandledRejection if a session detaches before the caller awaits.
110
+ void p.catch(() => { });
111
+ this.ws.send(JSON.stringify(payload));
112
+ return p;
113
+ }
114
+ on(event, handler) {
115
+ const set = this.eventHandlers.get(event) ?? new Set();
116
+ set.add(handler);
117
+ this.eventHandlers.set(event, set);
118
+ }
119
+ off(event, handler) {
120
+ const set = this.eventHandlers.get(event);
121
+ if (set)
122
+ set.delete(handler);
123
+ }
124
+ async close() {
125
+ if (this.ws.readyState === ws_1.default.CLOSED)
126
+ return;
127
+ await new Promise((resolve) => {
128
+ this.ws.once("close", () => resolve());
129
+ this.ws.close();
130
+ });
131
+ }
132
+ rejectAllInflight(why) {
133
+ for (const [id, entry] of this.inflight.entries()) {
134
+ entry.reject(new sdkErrors_js_1.CdpConnectionClosedError(why));
135
+ this.inflight.delete(id);
136
+ }
137
+ this.latestCdpCallEvent.clear();
138
+ for (const waiter of Array.from(this.sessionDispatchWaiters)) {
139
+ waiter.reject(new sdkErrors_js_1.CdpConnectionClosedError(why));
140
+ }
141
+ }
142
+ getSession(sessionId) {
143
+ return this.sessions.get(sessionId);
144
+ }
145
+ waitForSessionDispatch(sessionId, method, match) {
146
+ return new Promise((resolve, reject) => {
147
+ const waiter = {
148
+ sessionId,
149
+ method,
150
+ match,
151
+ resolve: () => {
152
+ this.sessionDispatchWaiters.delete(waiter);
153
+ resolve();
154
+ },
155
+ reject: (error) => {
156
+ this.sessionDispatchWaiters.delete(waiter);
157
+ reject(error);
158
+ },
159
+ };
160
+ this.sessionDispatchWaiters.add(waiter);
161
+ });
162
+ }
163
+ async attachToTarget(targetId) {
164
+ const { sessionId } = (await this.send("Target.attachToTarget", { targetId, flatten: true }));
165
+ let session = this.sessions.get(sessionId);
166
+ if (!session) {
167
+ session = new CdpSession(this, sessionId);
168
+ this.sessions.set(sessionId, session);
169
+ }
170
+ this.sessionToTarget.set(sessionId, targetId);
171
+ return session;
172
+ }
173
+ async getTargets() {
174
+ const res = await this.send("Target.getTargets");
175
+ return res.targetInfos;
176
+ }
177
+ onMessage(json) {
178
+ const msg = JSON.parse(json);
179
+ if ("id" in msg) {
180
+ const rec = this.inflight.get(msg.id);
181
+ if (!rec)
182
+ return;
183
+ this.inflight.delete(msg.id);
184
+ if ("error" in msg && msg.error) {
185
+ // Response/error events only make sense if the original send captured
186
+ // both a flow context to re-enter and the emitted CdpCallEvent to hang
187
+ // the terminal edge under.
188
+ if (rec.flowLoggerContext && rec.cdpCallEvent) {
189
+ let targetId;
190
+ if (rec.sessionId) {
191
+ const mappedTargetId = this.sessionToTarget.get(rec.sessionId);
192
+ if (mappedTargetId) {
193
+ targetId = mappedTargetId;
194
+ }
195
+ else {
196
+ targetId = rec.sessionId;
197
+ }
198
+ }
199
+ else {
200
+ targetId = null;
201
+ }
202
+ FlowLogger_js_1.FlowLogger.logCdpResponseEvent(rec.flowLoggerContext, rec.cdpCallEvent, {
203
+ method: rec.method,
204
+ error: `${msg.error.code} ${msg.error.message}`,
205
+ targetId,
206
+ });
207
+ }
208
+ rec.reject(new Error(`${msg.error.code} ${msg.error.message}`));
209
+ }
210
+ else {
211
+ // Successful responses reuse the same cached call context so the
212
+ // response lands under the exact CdpCallEvent emitted at send time.
213
+ if (rec.flowLoggerContext && rec.cdpCallEvent) {
214
+ let targetId;
215
+ if (rec.sessionId) {
216
+ const mappedTargetId = this.sessionToTarget.get(rec.sessionId);
217
+ if (mappedTargetId) {
218
+ targetId = mappedTargetId;
219
+ }
220
+ else {
221
+ targetId = rec.sessionId;
222
+ }
223
+ }
224
+ else {
225
+ targetId = null;
226
+ }
227
+ FlowLogger_js_1.FlowLogger.logCdpResponseEvent(rec.flowLoggerContext, rec.cdpCallEvent, {
228
+ method: rec.method,
229
+ result: msg.result,
230
+ targetId,
231
+ });
232
+ }
233
+ rec.resolve(msg.result);
234
+ }
235
+ return;
236
+ }
237
+ if ("method" in msg) {
238
+ if (msg.method === "Target.attachedToTarget") {
239
+ const p = msg
240
+ .params;
241
+ if (!this.sessions.has(p.sessionId)) {
242
+ this.sessions.set(p.sessionId, new CdpSession(this, p.sessionId));
243
+ }
244
+ this.sessionToTarget.set(p.sessionId, p.targetInfo.targetId);
245
+ }
246
+ else if (msg.method === "Target.detachedFromTarget") {
247
+ const p = msg
248
+ .params;
249
+ for (const [id, entry] of this.inflight.entries()) {
250
+ if (entry.sessionId === p.sessionId) {
251
+ entry.reject(new sdkErrors_js_1.PageNotFoundError(`target closed before CDP response (sessionId=${p.sessionId}, targetId=${p.targetId})`));
252
+ this.inflight.delete(id);
253
+ }
254
+ }
255
+ for (const waiter of Array.from(this.sessionDispatchWaiters)) {
256
+ if (waiter.sessionId === p.sessionId) {
257
+ waiter.reject(new sdkErrors_js_1.PageNotFoundError(`target closed before CDP send (sessionId=${p.sessionId}, targetId=${p.targetId})`));
258
+ }
259
+ }
260
+ this.sessions.delete(p.sessionId);
261
+ this.sessionToTarget.delete(p.sessionId);
262
+ this.latestCdpCallEvent.delete(p.sessionId);
263
+ }
264
+ else if (msg.method === "Target.targetDestroyed") {
265
+ const p = msg.params;
266
+ // Remove any session mapping for this target
267
+ for (const [sessionId, targetId] of this.sessionToTarget.entries()) {
268
+ if (targetId === p.targetId) {
269
+ this.sessionToTarget.delete(sessionId);
270
+ this.latestCdpCallEvent.delete(sessionId);
271
+ break;
272
+ }
273
+ }
274
+ }
275
+ const { method, params, sessionId } = msg;
276
+ const latestCdpCallEvent = this.latestCdpCallEvent.get(sessionId ?? null) ??
277
+ (sessionId ? this.latestCdpCallEvent.get(null) : null);
278
+ let targetId;
279
+ if (sessionId) {
280
+ const mappedTargetId = this.sessionToTarget.get(sessionId);
281
+ if (mappedTargetId) {
282
+ targetId = mappedTargetId;
283
+ }
284
+ else {
285
+ targetId = sessionId;
286
+ }
287
+ }
288
+ else {
289
+ targetId = null;
290
+ }
291
+ // Unsolicited protocol messages are attached under the most recent call on
292
+ // that session/root when one is known, so later callbacks still show up
293
+ // in the same flow subtree.
294
+ if (latestCdpCallEvent) {
295
+ FlowLogger_js_1.FlowLogger.logCdpMessageEvent(latestCdpCallEvent.flowLoggerContext, latestCdpCallEvent.cdpCallEvent, {
296
+ method,
297
+ params,
298
+ targetId,
299
+ });
300
+ }
301
+ const dispatch = () => {
302
+ if (sessionId) {
303
+ const session = this.sessions.get(sessionId);
304
+ session?.dispatch(method, params);
305
+ // Forward target lifecycle events to root listeners as well.
306
+ // Some browsers emit these via a parent session rather than the root
307
+ // connection; fan-out keeps target tracking consistent.
308
+ if (method.startsWith("Target.")) {
309
+ const handlers = this.eventHandlers.get(method);
310
+ if (handlers)
311
+ for (const h of handlers)
312
+ h(params);
313
+ }
314
+ return;
315
+ }
316
+ const handlers = this.eventHandlers.get(method);
317
+ if (handlers)
318
+ for (const h of handlers)
319
+ h(params);
320
+ };
321
+ if (latestCdpCallEvent) {
322
+ FlowLogger_js_1.FlowLogger.withContext(latestCdpCallEvent.flowLoggerContext, dispatch);
323
+ }
324
+ else {
325
+ dispatch();
326
+ }
327
+ }
328
+ }
329
+ _sendViaSession(sessionId, method, params) {
330
+ const id = this.nextId++;
331
+ const payload = { id, method, params, sessionId };
332
+ const stack = new Error().stack?.split("\n").slice(1, 4).join("\n");
333
+ const flowLoggerContext = FlowLogger_js_1.FlowLogger.resolveContext(this.flowLoggerContext);
334
+ let targetId;
335
+ const mappedTargetId = this.sessionToTarget.get(sessionId);
336
+ if (mappedTargetId) {
337
+ targetId = mappedTargetId;
338
+ }
339
+ else {
340
+ targetId = null;
341
+ }
342
+ const cdpCallEvent = flowLoggerContext
343
+ ? FlowLogger_js_1.FlowLogger.logCdpCallEvent(flowLoggerContext, {
344
+ method,
345
+ params,
346
+ targetId,
347
+ })
348
+ : null;
349
+ if (flowLoggerContext && cdpCallEvent) {
350
+ this.latestCdpCallEvent.set(sessionId, {
351
+ flowLoggerContext,
352
+ cdpCallEvent,
353
+ });
354
+ }
355
+ const p = new Promise((resolve, reject) => {
356
+ this.inflight.set(id, {
357
+ resolve,
358
+ reject,
359
+ sessionId,
360
+ method,
361
+ params,
362
+ stack,
363
+ ts: Date.now(),
364
+ flowLoggerContext,
365
+ cdpCallEvent,
366
+ });
367
+ });
368
+ // Prevent unhandledRejection if a session detaches before the caller awaits.
369
+ void p.catch(() => { });
370
+ for (const waiter of Array.from(this.sessionDispatchWaiters)) {
371
+ if (waiter.sessionId !== sessionId)
372
+ continue;
373
+ if (waiter.method !== method)
374
+ continue;
375
+ if (waiter.match && !waiter.match(params))
376
+ continue;
377
+ waiter.resolve();
378
+ break;
379
+ }
380
+ this.ws.send(JSON.stringify(payload));
381
+ return p;
382
+ }
383
+ _onSessionEvent(sessionId, event, handler) {
384
+ const key = `${sessionId}:${event}`;
385
+ const set = this.eventHandlers.get(key) ?? new Set();
386
+ set.add(handler);
387
+ this.eventHandlers.set(key, set);
388
+ }
389
+ _offSessionEvent(sessionId, event, handler) {
390
+ const key = `${sessionId}:${event}`;
391
+ const set = this.eventHandlers.get(key);
392
+ if (set)
393
+ set.delete(handler);
394
+ }
395
+ _dispatchToSession(sessionId, event, params) {
396
+ const key = `${sessionId}:${event}`;
397
+ const handlers = this.eventHandlers.get(key);
398
+ if (handlers)
399
+ for (const h of handlers)
400
+ h(params);
401
+ }
402
+ }
403
+ exports.CdpConnection = CdpConnection;
404
+ class CdpSession {
405
+ root;
406
+ id;
407
+ constructor(root, id) {
408
+ this.root = root;
409
+ this.id = id;
410
+ }
411
+ send(method, params) {
412
+ return this.root._sendViaSession(this.id, method, params);
413
+ }
414
+ on(event, handler) {
415
+ this.root._onSessionEvent(this.id, event, handler);
416
+ }
417
+ off(event, handler) {
418
+ this.root._offSessionEvent(this.id, event, handler);
419
+ }
420
+ async close() {
421
+ await this.root.send("Target.detachFromTarget", {
422
+ sessionId: this.id,
423
+ });
424
+ }
425
+ dispatch(event, params) {
426
+ this.root._dispatchToSession(this.id, event, params);
427
+ }
428
+ }
429
+ exports.CdpSession = CdpSession;
430
+ //# sourceMappingURL=cdp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cdp.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/cdp.ts"],"names":[],"mappings":"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","sourcesContent":["// lib/v3/understudy/cdp.ts\nimport WebSocket from \"ws\";\nimport type { Protocol } from \"devtools-protocol\";\nimport { STAGEHAND_VERSION } from \"../../version.js\";\nimport {\n FlowLogger,\n type FlowEvent,\n type FlowLoggerContext,\n} from \"../flowlogger/FlowLogger.js\";\nimport {\n CdpConnectionClosedError,\n PageNotFoundError,\n} from \"../types/public/sdkErrors.js\";\n\n/**\n * CDP transport & session multiplexer\n *\n * Owns the browser WebSocket and multiplexes flattened Target sessions.\n * Tracks inflight CDP calls, routes responses to the right session, and forwards events.\n *\n * This does not interpret Page/DOM/Runtime semantics — callers own that logic.\n */\nexport interface CDPSessionLike {\n send<R = unknown>(method: string, params?: object): Promise<R>;\n on<P = unknown>(event: string, handler: (params: P) => void): void;\n off<P = unknown>(event: string, handler: (params: P) => void): void;\n close(): Promise<void>;\n readonly id: string | null;\n}\n\ntype Inflight = {\n resolve: (v: unknown) => void;\n reject: (e: Error) => void;\n sessionId?: string | null;\n method: string;\n params?: object;\n stack?: string;\n ts: number;\n flowLoggerContext?: FlowLoggerContext | null; // Snapshot of the flow context captured when the request was sent; response handling re-enters this if ALS is gone.\n cdpCallEvent?: Pick<FlowEvent, \"eventId\" | \"eventParentIds\"> | null; // The emitted CdpCallEvent identity; later response/error events attach under this exact parent.\n};\n\ntype EventHandler = (params: unknown) => void;\ntype SessionDispatchWaiter = {\n sessionId: string;\n method: string;\n match?: (params?: object) => boolean;\n resolve: () => void;\n reject: (error: Error) => void;\n};\n\ntype RawMessage =\n | {\n id: number;\n result?: unknown;\n error?: { code: number; message: string; data?: unknown };\n sessionId?: string;\n }\n | { method: string; params?: unknown; sessionId?: string };\n\nexport class CdpConnection implements CDPSessionLike {\n private ws: WebSocket;\n private nextId = 1;\n private inflight = new Map<number, Inflight>(); // Outstanding request records; `_sendViaSession()` inserts and `onMessage()` removes/resolves them.\n private latestCdpCallEvent = new Map<\n // Most recent CDP call per session/root; `_sendViaSession()` refreshes it and later unsolicited messages reuse it as their parent anchor.\n string | null,\n {\n flowLoggerContext: FlowLoggerContext; // Flow context captured when the latest call on this session/root was emitted.\n cdpCallEvent: Pick<FlowEvent, \"eventId\" | \"eventParentIds\">; // Identity of that latest call event; unsolicited messages reuse it as their parent.\n }\n >();\n private eventHandlers = new Map<string, Set<EventHandler>>();\n private sessions = new Map<string, CdpSession>();\n /** Maps sessionId -> targetId (1:1 mapping) */\n private sessionToTarget = new Map<string, string>();\n private sessionDispatchWaiters = new Set<SessionDispatchWaiter>();\n public readonly id: string | null = null; // root\n private transportCloseHandlers = new Set<(why: string) => void>();\n\n public flowLoggerContext?: FlowLoggerContext; // Instance-owned fallback flow context; V3 sets this once and later sends/callbacks re-enter it when ALS is absent.\n\n public onTransportClosed(handler: (why: string) => void): void {\n this.transportCloseHandlers.add(handler);\n }\n public offTransportClosed(handler: (why: string) => void): void {\n this.transportCloseHandlers.delete(handler);\n }\n\n private emitTransportClosed(why: string) {\n for (const h of this.transportCloseHandlers) {\n try {\n h(why);\n } catch {\n //\n }\n }\n }\n\n private constructor(ws: WebSocket) {\n this.ws = ws;\n this.ws.on(\"close\", (code, reason) => {\n // Reason is a Buffer in ws; stringify defensively\n const why = `socket-close code=${code} reason=${String(reason || \"\")}`;\n this.rejectAllInflight(why);\n this.emitTransportClosed(why);\n });\n\n this.ws.on(\"error\", (err) => {\n const why = `socket-error ${err?.message ?? String(err)}`;\n this.rejectAllInflight(why);\n this.emitTransportClosed(why);\n });\n this.ws.on(\"message\", (data) => this.onMessage(data.toString()));\n }\n\n static async connect(\n wsUrl: string,\n options?: { headers?: Record<string, string> },\n ): Promise<CdpConnection> {\n // Include User-Agent header for server-side observability and version tracking\n // Merge user-provided headers, letting them override defaults\n const headers = {\n \"User-Agent\": `Stagehand/${STAGEHAND_VERSION}`,\n ...options?.headers,\n };\n const ws = new WebSocket(wsUrl, { headers });\n await new Promise<void>((resolve, reject) => {\n ws.once(\"open\", () => resolve());\n ws.once(\"error\", (e) => reject(e));\n });\n return new CdpConnection(ws);\n }\n\n async enableAutoAttach(): Promise<void> {\n await this.send(\"Target.setAutoAttach\", {\n autoAttach: true,\n flatten: true,\n waitForDebuggerOnStart: true,\n });\n await this.send(\"Target.setDiscoverTargets\", { discover: true });\n }\n\n async send<R = unknown>(method: string, params?: object): Promise<R> {\n const id = this.nextId++;\n const payload = { id, method, params };\n const stack = new Error().stack?.split(\"\\n\").slice(1, 4).join(\"\\n\");\n const flowLoggerContext = FlowLogger.resolveContext(this.flowLoggerContext);\n const cdpCallEvent = flowLoggerContext\n ? FlowLogger.logCdpCallEvent(flowLoggerContext, {\n method,\n params,\n targetId: null,\n })\n : null;\n if (flowLoggerContext && cdpCallEvent) {\n this.latestCdpCallEvent.set(null, {\n flowLoggerContext,\n cdpCallEvent,\n });\n }\n const p = new Promise<R>((resolve, reject) => {\n this.inflight.set(id, {\n resolve,\n reject,\n sessionId: null,\n method,\n params,\n stack,\n ts: Date.now(),\n flowLoggerContext,\n cdpCallEvent,\n });\n });\n // Prevent unhandledRejection if a session detaches before the caller awaits.\n void p.catch(() => {});\n this.ws.send(JSON.stringify(payload));\n return p;\n }\n\n on<P = unknown>(event: string, handler: (params: P) => void): void {\n const set = this.eventHandlers.get(event) ?? new Set<EventHandler>();\n set.add(handler as EventHandler);\n this.eventHandlers.set(event, set);\n }\n\n off<P = unknown>(event: string, handler: (params: P) => void): void {\n const set = this.eventHandlers.get(event);\n if (set) set.delete(handler as EventHandler);\n }\n\n async close(): Promise<void> {\n if (this.ws.readyState === WebSocket.CLOSED) return;\n await new Promise<void>((resolve) => {\n this.ws.once(\"close\", () => resolve());\n this.ws.close();\n });\n }\n\n private rejectAllInflight(why: string): void {\n for (const [id, entry] of this.inflight.entries()) {\n entry.reject(new CdpConnectionClosedError(why));\n this.inflight.delete(id);\n }\n this.latestCdpCallEvent.clear();\n for (const waiter of Array.from(this.sessionDispatchWaiters)) {\n waiter.reject(new CdpConnectionClosedError(why));\n }\n }\n\n getSession(sessionId: string): CdpSession | undefined {\n return this.sessions.get(sessionId);\n }\n\n waitForSessionDispatch(\n sessionId: string,\n method: string,\n match?: (params?: object) => boolean,\n ): Promise<void> {\n return new Promise<void>((resolve, reject) => {\n const waiter: SessionDispatchWaiter = {\n sessionId,\n method,\n match,\n resolve: () => {\n this.sessionDispatchWaiters.delete(waiter);\n resolve();\n },\n reject: (error: Error) => {\n this.sessionDispatchWaiters.delete(waiter);\n reject(error);\n },\n };\n this.sessionDispatchWaiters.add(waiter);\n });\n }\n\n async attachToTarget(targetId: string): Promise<CdpSession> {\n const { sessionId } = (await this.send<{ sessionId: string }>(\n \"Target.attachToTarget\",\n { targetId, flatten: true },\n )) as { sessionId: string };\n\n let session = this.sessions.get(sessionId);\n if (!session) {\n session = new CdpSession(this, sessionId);\n this.sessions.set(sessionId, session);\n }\n this.sessionToTarget.set(sessionId, targetId);\n return session;\n }\n\n async getTargets(): Promise<Protocol.Target.TargetInfo[]> {\n const res = await this.send<{\n targetInfos: Protocol.Target.TargetInfo[];\n }>(\"Target.getTargets\");\n return res.targetInfos;\n }\n\n private onMessage(json: string): void {\n const msg = JSON.parse(json) as RawMessage;\n\n if (\"id\" in msg) {\n const rec = this.inflight.get(msg.id);\n if (!rec) return;\n\n this.inflight.delete(msg.id);\n\n if (\"error\" in msg && msg.error) {\n // Response/error events only make sense if the original send captured\n // both a flow context to re-enter and the emitted CdpCallEvent to hang\n // the terminal edge under.\n if (rec.flowLoggerContext && rec.cdpCallEvent) {\n let targetId: string | null;\n if (rec.sessionId) {\n const mappedTargetId = this.sessionToTarget.get(rec.sessionId);\n if (mappedTargetId) {\n targetId = mappedTargetId;\n } else {\n targetId = rec.sessionId;\n }\n } else {\n targetId = null;\n }\n FlowLogger.logCdpResponseEvent(\n rec.flowLoggerContext,\n rec.cdpCallEvent,\n {\n method: rec.method,\n error: `${msg.error.code} ${msg.error.message}`,\n targetId,\n },\n );\n }\n rec.reject(new Error(`${msg.error.code} ${msg.error.message}`));\n } else {\n // Successful responses reuse the same cached call context so the\n // response lands under the exact CdpCallEvent emitted at send time.\n if (rec.flowLoggerContext && rec.cdpCallEvent) {\n let targetId: string | null;\n if (rec.sessionId) {\n const mappedTargetId = this.sessionToTarget.get(rec.sessionId);\n if (mappedTargetId) {\n targetId = mappedTargetId;\n } else {\n targetId = rec.sessionId;\n }\n } else {\n targetId = null;\n }\n FlowLogger.logCdpResponseEvent(\n rec.flowLoggerContext,\n rec.cdpCallEvent,\n {\n method: rec.method,\n result: (msg as { result?: unknown }).result,\n targetId,\n },\n );\n }\n rec.resolve((msg as { result?: unknown }).result);\n }\n return;\n }\n\n if (\"method\" in msg) {\n if (msg.method === \"Target.attachedToTarget\") {\n const p = (msg as { params: Protocol.Target.AttachedToTargetEvent })\n .params;\n if (!this.sessions.has(p.sessionId)) {\n this.sessions.set(p.sessionId, new CdpSession(this, p.sessionId));\n }\n this.sessionToTarget.set(p.sessionId, p.targetInfo.targetId);\n } else if (msg.method === \"Target.detachedFromTarget\") {\n const p = (msg as { params: Protocol.Target.DetachedFromTargetEvent })\n .params;\n for (const [id, entry] of this.inflight.entries()) {\n if (entry.sessionId === p.sessionId) {\n entry.reject(\n new PageNotFoundError(\n `target closed before CDP response (sessionId=${p.sessionId}, targetId=${p.targetId})`,\n ),\n );\n this.inflight.delete(id);\n }\n }\n for (const waiter of Array.from(this.sessionDispatchWaiters)) {\n if (waiter.sessionId === p.sessionId) {\n waiter.reject(\n new PageNotFoundError(\n `target closed before CDP send (sessionId=${p.sessionId}, targetId=${p.targetId})`,\n ),\n );\n }\n }\n this.sessions.delete(p.sessionId);\n this.sessionToTarget.delete(p.sessionId);\n this.latestCdpCallEvent.delete(p.sessionId);\n } else if (msg.method === \"Target.targetDestroyed\") {\n const p = (msg as { params: { targetId: string } }).params;\n // Remove any session mapping for this target\n for (const [sessionId, targetId] of this.sessionToTarget.entries()) {\n if (targetId === p.targetId) {\n this.sessionToTarget.delete(sessionId);\n this.latestCdpCallEvent.delete(sessionId);\n break;\n }\n }\n }\n\n const { method, params, sessionId } = msg;\n const latestCdpCallEvent =\n this.latestCdpCallEvent.get(sessionId ?? null) ??\n (sessionId ? this.latestCdpCallEvent.get(null) : null);\n let targetId: string | null;\n if (sessionId) {\n const mappedTargetId = this.sessionToTarget.get(sessionId);\n if (mappedTargetId) {\n targetId = mappedTargetId;\n } else {\n targetId = sessionId;\n }\n } else {\n targetId = null;\n }\n\n // Unsolicited protocol messages are attached under the most recent call on\n // that session/root when one is known, so later callbacks still show up\n // in the same flow subtree.\n if (latestCdpCallEvent) {\n FlowLogger.logCdpMessageEvent(\n latestCdpCallEvent.flowLoggerContext,\n latestCdpCallEvent.cdpCallEvent,\n {\n method,\n params,\n targetId,\n },\n );\n }\n\n const dispatch = () => {\n if (sessionId) {\n const session = this.sessions.get(sessionId);\n session?.dispatch(method, params);\n\n // Forward target lifecycle events to root listeners as well.\n // Some browsers emit these via a parent session rather than the root\n // connection; fan-out keeps target tracking consistent.\n if (method.startsWith(\"Target.\")) {\n const handlers = this.eventHandlers.get(method);\n if (handlers) for (const h of handlers) h(params);\n }\n return;\n }\n\n const handlers = this.eventHandlers.get(method);\n if (handlers) for (const h of handlers) h(params);\n };\n\n if (latestCdpCallEvent) {\n FlowLogger.withContext(latestCdpCallEvent.flowLoggerContext, dispatch);\n } else {\n dispatch();\n }\n }\n }\n\n _sendViaSession<R = unknown>(\n sessionId: string,\n method: string,\n params?: object,\n ): Promise<R> {\n const id = this.nextId++;\n const payload = { id, method, params, sessionId };\n const stack = new Error().stack?.split(\"\\n\").slice(1, 4).join(\"\\n\");\n const flowLoggerContext = FlowLogger.resolveContext(this.flowLoggerContext);\n let targetId: string | null;\n const mappedTargetId = this.sessionToTarget.get(sessionId);\n if (mappedTargetId) {\n targetId = mappedTargetId;\n } else {\n targetId = null;\n }\n const cdpCallEvent = flowLoggerContext\n ? FlowLogger.logCdpCallEvent(flowLoggerContext, {\n method,\n params,\n targetId,\n })\n : null;\n if (flowLoggerContext && cdpCallEvent) {\n this.latestCdpCallEvent.set(sessionId, {\n flowLoggerContext,\n cdpCallEvent,\n });\n }\n\n const p = new Promise<R>((resolve, reject) => {\n this.inflight.set(id, {\n resolve,\n reject,\n sessionId,\n method,\n params,\n stack,\n ts: Date.now(),\n flowLoggerContext,\n cdpCallEvent,\n });\n });\n // Prevent unhandledRejection if a session detaches before the caller awaits.\n void p.catch(() => {});\n for (const waiter of Array.from(this.sessionDispatchWaiters)) {\n if (waiter.sessionId !== sessionId) continue;\n if (waiter.method !== method) continue;\n if (waiter.match && !waiter.match(params)) continue;\n waiter.resolve();\n break;\n }\n this.ws.send(JSON.stringify(payload));\n return p;\n }\n\n _onSessionEvent(\n sessionId: string,\n event: string,\n handler: EventHandler,\n ): void {\n const key = `${sessionId}:${event}`;\n const set = this.eventHandlers.get(key) ?? new Set<EventHandler>();\n set.add(handler);\n this.eventHandlers.set(key, set);\n }\n\n _offSessionEvent(\n sessionId: string,\n event: string,\n handler: EventHandler,\n ): void {\n const key = `${sessionId}:${event}`;\n const set = this.eventHandlers.get(key);\n if (set) set.delete(handler);\n }\n\n _dispatchToSession(sessionId: string, event: string, params: unknown): void {\n const key = `${sessionId}:${event}`;\n const handlers = this.eventHandlers.get(key);\n if (handlers) for (const h of handlers) h(params);\n }\n}\n\nexport class CdpSession implements CDPSessionLike {\n constructor(\n private readonly root: CdpConnection,\n public readonly id: string,\n ) {}\n\n send<R = unknown>(method: string, params?: object): Promise<R> {\n return this.root._sendViaSession<R>(this.id, method, params);\n }\n\n on<P = unknown>(event: string, handler: (params: P) => void): void {\n this.root._onSessionEvent(this.id, event, handler as EventHandler);\n }\n\n off<P = unknown>(event: string, handler: (params: P) => void): void {\n this.root._offSessionEvent(this.id, event, handler as EventHandler);\n }\n\n async close(): Promise<void> {\n await this.root.send<void>(\"Target.detachFromTarget\", {\n sessionId: this.id,\n });\n }\n\n dispatch(event: string, params: unknown): void {\n this.root._dispatchToSession(this.id, event, params);\n }\n}\n"]}
@@ -0,0 +1,70 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ConsoleMessage = void 0;
4
+ function formatRemoteObject(obj) {
5
+ if (!obj)
6
+ return "";
7
+ if ("value" in obj) {
8
+ const value = obj.value;
9
+ if (value === undefined)
10
+ return "";
11
+ if (typeof value === "string")
12
+ return value;
13
+ try {
14
+ return JSON.stringify(value);
15
+ }
16
+ catch {
17
+ return String(value);
18
+ }
19
+ }
20
+ if (obj.unserializableValue)
21
+ return obj.unserializableValue;
22
+ if (obj.description)
23
+ return obj.description;
24
+ return obj.type ?? "";
25
+ }
26
+ class ConsoleMessage {
27
+ event;
28
+ pageRef;
29
+ constructor(event, pageRef) {
30
+ this.event = event;
31
+ this.pageRef = pageRef;
32
+ }
33
+ type() {
34
+ return this.event.type;
35
+ }
36
+ text() {
37
+ const args = this.args();
38
+ if (!args.length)
39
+ return "";
40
+ return args
41
+ .map((arg) => formatRemoteObject(arg))
42
+ .filter((chunk) => chunk.length > 0)
43
+ .join(" ");
44
+ }
45
+ args() {
46
+ return this.event.args ? [...this.event.args] : [];
47
+ }
48
+ location() {
49
+ const frame = this.event.stackTrace?.callFrames?.[0];
50
+ return {
51
+ url: frame?.url,
52
+ lineNumber: frame?.lineNumber,
53
+ columnNumber: frame?.columnNumber,
54
+ };
55
+ }
56
+ page() {
57
+ return this.pageRef;
58
+ }
59
+ timestamp() {
60
+ return this.event.timestamp;
61
+ }
62
+ raw() {
63
+ return this.event;
64
+ }
65
+ toString() {
66
+ return this.text();
67
+ }
68
+ }
69
+ exports.ConsoleMessage = ConsoleMessage;
70
+ //# sourceMappingURL=consoleMessage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consoleMessage.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/consoleMessage.ts"],"names":[],"mappings":";;;AAOA,SAAS,kBAAkB,CAAC,GAA6B;IACvD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,mBAAmB;QAAE,OAAO,GAAG,CAAC,mBAAmB,CAAC;IAC5D,IAAI,GAAG,CAAC,WAAW;QAAE,OAAO,GAAG,CAAC,WAAW,CAAC;IAE5C,OAAO,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAa,cAAc;IAEN;IACA;IAFnB,YACmB,KAA6C,EAC7C,OAAc;QADd,UAAK,GAAL,KAAK,CAAwC;QAC7C,YAAO,GAAP,OAAO,CAAO;IAC9B,CAAC;IAEJ,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC;QAC5B,OAAO,IAAI;aACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;aACrC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;aACnC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO;YACL,GAAG,EAAE,KAAK,EAAE,GAAG;YACf,UAAU,EAAE,KAAK,EAAE,UAAU;YAC7B,YAAY,EAAE,KAAK,EAAE,YAAY;SAClC,CAAC;IACJ,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC;IAC9B,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF;AA/CD,wCA+CC","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { Page } from \"./page.js\";\n\ntype RemoteObject = Protocol.Runtime.RemoteObject;\n\nexport type ConsoleListener = (message: ConsoleMessage) => void;\n\nfunction formatRemoteObject(obj: RemoteObject | undefined): string {\n if (!obj) return \"\";\n\n if (\"value\" in obj) {\n const value = obj.value;\n if (value === undefined) return \"\";\n if (typeof value === \"string\") return value;\n try {\n return JSON.stringify(value);\n } catch {\n return String(value);\n }\n }\n\n if (obj.unserializableValue) return obj.unserializableValue;\n if (obj.description) return obj.description;\n\n return obj.type ?? \"\";\n}\n\nexport class ConsoleMessage {\n constructor(\n private readonly event: Protocol.Runtime.ConsoleAPICalledEvent,\n private readonly pageRef?: Page,\n ) {}\n\n type(): Protocol.Runtime.ConsoleAPICalledEvent[\"type\"] {\n return this.event.type;\n }\n\n text(): string {\n const args = this.args();\n if (!args.length) return \"\";\n return args\n .map((arg) => formatRemoteObject(arg))\n .filter((chunk) => chunk.length > 0)\n .join(\" \");\n }\n\n args(): RemoteObject[] {\n return this.event.args ? [...this.event.args] : [];\n }\n\n location(): { url?: string; lineNumber?: number; columnNumber?: number } {\n const frame = this.event.stackTrace?.callFrames?.[0];\n return {\n url: frame?.url,\n lineNumber: frame?.lineNumber,\n columnNumber: frame?.columnNumber,\n };\n }\n\n page(): Page | undefined {\n return this.pageRef;\n }\n\n timestamp(): number | undefined {\n return this.event.timestamp;\n }\n\n raw(): Protocol.Runtime.ConsoleAPICalledEvent {\n return this.event;\n }\n\n toString(): string {\n return this.text();\n }\n}\n"]}