@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
@@ -0,0 +1,843 @@
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.AnthropicCUAClient = void 0;
7
+ const sdkErrors_js_1 = require("../types/public/sdkErrors.js");
8
+ const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
9
+ const AgentClient_js_1 = require("./AgentClient.js");
10
+ const imageCompression_js_1 = require("./utils/imageCompression.js");
11
+ const zodCompat_js_1 = require("../zodCompat.js");
12
+ const FlowLogger_js_1 = require("../flowlogger/FlowLogger.js");
13
+ const uuid_1 = require("uuid");
14
+ /**
15
+ * Client for Anthropic's Computer Use API
16
+ * This implementation uses the official Anthropic Messages API for Computer Use
17
+ */
18
+ class AnthropicCUAClient extends AgentClient_js_1.AgentClient {
19
+ apiKey;
20
+ baseURL;
21
+ client;
22
+ lastMessageId;
23
+ currentViewport = { width: 1288, height: 711 };
24
+ currentUrl;
25
+ screenshotProvider;
26
+ actionHandler;
27
+ thinkingBudget = null;
28
+ tools;
29
+ constructor(type, modelName, userProvidedInstructions, clientOptions, tools) {
30
+ super(type, modelName, userProvidedInstructions);
31
+ // Process client options
32
+ this.apiKey =
33
+ clientOptions?.apiKey || process.env.ANTHROPIC_API_KEY || "";
34
+ this.baseURL = clientOptions?.baseURL || undefined;
35
+ // Get thinking budget if specified
36
+ if (clientOptions?.thinkingBudget &&
37
+ typeof clientOptions.thinkingBudget === "number") {
38
+ this.thinkingBudget = clientOptions.thinkingBudget;
39
+ }
40
+ // Store client options for reference
41
+ this.clientOptions = {
42
+ apiKey: this.apiKey,
43
+ };
44
+ if (this.baseURL) {
45
+ this.clientOptions.baseURL = this.baseURL;
46
+ }
47
+ // Initialize the Anthropic client
48
+ this.client = new sdk_1.default(this.clientOptions);
49
+ this.tools = tools;
50
+ }
51
+ setViewport(width, height) {
52
+ this.currentViewport = { width, height };
53
+ }
54
+ setCurrentUrl(url) {
55
+ this.currentUrl = url;
56
+ }
57
+ setScreenshotProvider(provider) {
58
+ this.screenshotProvider = provider;
59
+ }
60
+ setActionHandler(handler) {
61
+ this.actionHandler = handler;
62
+ }
63
+ setTools(tools) {
64
+ this.tools = tools;
65
+ }
66
+ /**
67
+ * Execute a task with the Anthropic CUA
68
+ * This is the main entry point for the agent
69
+ * @implements AgentClient.execute
70
+ */
71
+ async execute(executionOptions) {
72
+ const { options, logger } = executionOptions;
73
+ const { instruction } = options;
74
+ const maxSteps = options.maxSteps || 10;
75
+ let currentStep = 0;
76
+ let completed = false;
77
+ const actions = [];
78
+ const messageList = [];
79
+ let finalMessage = "";
80
+ // Start with the initial instruction
81
+ let inputItems = this.createInitialInputItems(instruction);
82
+ logger({
83
+ category: "agent",
84
+ message: `Starting Anthropic agent execution with instruction: ${instruction}`,
85
+ level: 1,
86
+ });
87
+ let totalInputTokens = 0;
88
+ let totalOutputTokens = 0;
89
+ let totalInferenceTime = 0;
90
+ try {
91
+ // Execute steps until completion or max steps reached
92
+ while (!completed && currentStep < maxSteps) {
93
+ await this.preStepHook?.();
94
+ logger({
95
+ category: "agent",
96
+ message: `Executing step ${currentStep + 1}/${maxSteps}`,
97
+ level: 1,
98
+ });
99
+ const result = await this.executeStep(inputItems, logger);
100
+ totalInputTokens += result.usage.input_tokens;
101
+ totalOutputTokens += result.usage.output_tokens;
102
+ totalInferenceTime += result.usage.inference_time_ms;
103
+ // Add actions to the list
104
+ if (result.actions.length > 0) {
105
+ logger({
106
+ category: "agent",
107
+ message: `Step ${currentStep + 1} performed ${result.actions.length} actions`,
108
+ level: 2,
109
+ });
110
+ actions.push(...result.actions);
111
+ }
112
+ // Update completion status
113
+ completed = result.completed;
114
+ // Update the input items for the next step if we're continuing
115
+ if (!completed) {
116
+ inputItems = result.nextInputItems;
117
+ }
118
+ // Record any message for this step
119
+ if (result.message) {
120
+ messageList.push(result.message);
121
+ finalMessage = result.message;
122
+ }
123
+ // Increment step counter
124
+ currentStep++;
125
+ }
126
+ logger({
127
+ category: "agent",
128
+ message: `Anthropic agent execution completed: ${completed}, with ${actions.length} total actions performed`,
129
+ level: 1,
130
+ });
131
+ // Return the final result
132
+ return {
133
+ success: completed,
134
+ actions,
135
+ message: finalMessage,
136
+ completed,
137
+ usage: {
138
+ input_tokens: totalInputTokens,
139
+ output_tokens: totalOutputTokens,
140
+ inference_time_ms: totalInferenceTime,
141
+ },
142
+ };
143
+ }
144
+ catch (error) {
145
+ const errorMessage = error instanceof Error ? error.message : String(error);
146
+ logger({
147
+ category: "agent",
148
+ message: `Error executing agent task: ${errorMessage}`,
149
+ level: 0,
150
+ });
151
+ return {
152
+ success: false,
153
+ actions,
154
+ message: `Failed to execute task: ${errorMessage}`,
155
+ completed: false,
156
+ usage: {
157
+ input_tokens: totalInputTokens,
158
+ output_tokens: totalOutputTokens,
159
+ inference_time_ms: totalInferenceTime,
160
+ },
161
+ };
162
+ }
163
+ }
164
+ async executeStep(inputItems, logger) {
165
+ try {
166
+ // Get response from the model
167
+ const result = await this.getAction(inputItems);
168
+ const content = result.content;
169
+ const usage = {
170
+ input_tokens: result.usage.input_tokens,
171
+ output_tokens: result.usage.output_tokens,
172
+ inference_time_ms: result.usage.inference_time_ms,
173
+ };
174
+ logger({
175
+ category: "agent",
176
+ message: `Received response with ${content.length} content blocks`,
177
+ level: 2,
178
+ });
179
+ // Extract actions from the content
180
+ const stepActions = [];
181
+ const toolUseItems = [];
182
+ let message = "";
183
+ // Process content blocks to find tool use items and text content
184
+ for (const block of content) {
185
+ logger({
186
+ category: "agent",
187
+ message: `Processing block type: ${block.type}, id: ${block.id || "unknown"}`,
188
+ level: 2,
189
+ });
190
+ if (block.type === "tool_use") {
191
+ // Direct handling of tool_use type
192
+ logger({
193
+ category: "agent",
194
+ message: `Found tool_use block: ${JSON.stringify(block)}`,
195
+ level: 2,
196
+ });
197
+ // Cast to ToolUseItem and add to list
198
+ const toolUseItem = block;
199
+ toolUseItems.push(toolUseItem);
200
+ logger({
201
+ category: "agent",
202
+ message: `Added tool_use item: ${toolUseItem.name}, action: ${JSON.stringify(toolUseItem.input)}`,
203
+ level: 2,
204
+ });
205
+ // Convert tool use to action and add to actions list
206
+ const action = this.convertToolUseToAction(toolUseItem);
207
+ if (action) {
208
+ logger({
209
+ category: "agent",
210
+ message: `Created action from tool_use: ${toolUseItem.name}, action: ${action.type}`,
211
+ level: 2,
212
+ });
213
+ stepActions.push(action);
214
+ }
215
+ else if (this.tools && toolUseItem.name in this.tools) {
216
+ stepActions.push({
217
+ type: "custom_tool",
218
+ tool: toolUseItem.name,
219
+ input: toolUseItem.input,
220
+ });
221
+ }
222
+ }
223
+ else if (block.type === "text") {
224
+ // Safe to cast here since we've verified it's a text block
225
+ const textBlock = block;
226
+ message += textBlock.text + "\n";
227
+ logger({
228
+ category: "agent",
229
+ message: `Found text block: ${textBlock.text}`,
230
+ level: 2,
231
+ });
232
+ }
233
+ else {
234
+ logger({
235
+ category: "agent",
236
+ message: `Found unknown block type: ${block.type}`,
237
+ level: 2,
238
+ });
239
+ }
240
+ }
241
+ // Execute actions if an action handler is provided
242
+ if (this.actionHandler && stepActions.length > 0) {
243
+ for (const action of stepActions) {
244
+ try {
245
+ logger({
246
+ category: "agent",
247
+ message: `Executing action: ${action.type}`,
248
+ level: 1,
249
+ });
250
+ await this.actionHandler(action);
251
+ }
252
+ catch (error) {
253
+ if (error instanceof sdkErrors_js_1.StagehandClosedError) {
254
+ throw error;
255
+ }
256
+ const errorMessage = error instanceof Error ? error.message : String(error);
257
+ logger({
258
+ category: "agent",
259
+ message: `Error executing action ${action.type}: ${errorMessage}`,
260
+ level: 0,
261
+ });
262
+ }
263
+ }
264
+ }
265
+ // Create the assistant response message with all content blocks
266
+ const assistantMessage = {
267
+ role: "assistant",
268
+ content: content,
269
+ };
270
+ // Keep track of the conversation history by preserving all previous messages
271
+ // and adding new messages at the end
272
+ const nextInputItems = [...inputItems];
273
+ // Add the assistant message with tool_use blocks to the history
274
+ (0, imageCompression_js_1.compressConversationImages)(nextInputItems);
275
+ nextInputItems.push(assistantMessage);
276
+ // Generate tool results and add them as a user message
277
+ if (toolUseItems.length > 0) {
278
+ const toolResults = await this.takeAction(toolUseItems, logger);
279
+ if (toolResults.length > 0) {
280
+ // Tool results are AnthropicToolResult[] which are compatible with AnthropicContentBlock[]
281
+ const userToolResultsMessage = {
282
+ role: "user",
283
+ content: toolResults,
284
+ };
285
+ nextInputItems.push(userToolResultsMessage);
286
+ }
287
+ }
288
+ // The step is completed only if there were no tool_use items
289
+ const completed = toolUseItems.length === 0;
290
+ logger({
291
+ category: "agent",
292
+ message: `Step processed ${toolUseItems.length} tool use items, completed: ${completed}`,
293
+ level: 2,
294
+ });
295
+ return {
296
+ actions: stepActions,
297
+ message: message.trim(),
298
+ completed,
299
+ nextInputItems,
300
+ usage: usage,
301
+ };
302
+ }
303
+ catch (error) {
304
+ const errorMessage = error instanceof Error ? error.message : String(error);
305
+ logger({
306
+ category: "agent",
307
+ message: `Error executing step: ${errorMessage}`,
308
+ level: 0,
309
+ });
310
+ throw error;
311
+ }
312
+ }
313
+ createInitialInputItems(instruction) {
314
+ // For the initial request, we use a simple array with the user's instruction
315
+ return [
316
+ {
317
+ role: "system",
318
+ content: this.userProvidedInstructions,
319
+ },
320
+ {
321
+ role: "user",
322
+ content: instruction,
323
+ },
324
+ ];
325
+ }
326
+ async getAction(inputItems) {
327
+ try {
328
+ // For the API request, we use the inputItems directly
329
+ // These should already be properly formatted as a sequence of user/assistant messages
330
+ const messages = [];
331
+ for (const item of inputItems) {
332
+ if ("role" in item) {
333
+ // Skip system messages as Anthropic requires system as a top-level parameter
334
+ if (item.role !== "system") {
335
+ messages.push(item);
336
+ }
337
+ }
338
+ // Note: We don't need special handling for tool_result items here anymore
339
+ // as they should already be properly wrapped in user messages
340
+ }
341
+ // Configure thinking capability if available
342
+ const thinking = this.thinkingBudget
343
+ ? { type: "enabled", budget_tokens: this.thinkingBudget }
344
+ : undefined;
345
+ // Claude 4.6+ models require the newer computer_20251124 tool version
346
+ const modelBase = this.modelName.includes("/")
347
+ ? this.modelName.split("/")[1]
348
+ : this.modelName;
349
+ const shouldUseNewToolVersion = [
350
+ "claude-opus-4-6",
351
+ "claude-sonnet-4-6",
352
+ "claude-opus-4-5-20251101",
353
+ ].includes(modelBase);
354
+ const computerToolType = shouldUseNewToolVersion
355
+ ? "computer_20251124"
356
+ : "computer_20250124";
357
+ const betaFlag = shouldUseNewToolVersion
358
+ ? "computer-use-2025-11-24"
359
+ : "computer-use-2025-01-24";
360
+ // Create the request parameters
361
+ const requestParams = {
362
+ model: this.modelName,
363
+ max_tokens: 4096,
364
+ messages: messages,
365
+ tools: [
366
+ {
367
+ type: computerToolType,
368
+ name: "computer",
369
+ display_width_px: this.currentViewport.width,
370
+ display_height_px: this.currentViewport.height,
371
+ display_number: 1,
372
+ },
373
+ ],
374
+ betas: [betaFlag],
375
+ };
376
+ // Add custom tools if available
377
+ if (this.tools && Object.keys(this.tools).length > 0) {
378
+ const customTools = Object.entries(this.tools).map(([name, tool]) => {
379
+ const schema = tool.inputSchema;
380
+ // Convert Zod schema to proper JSON schema format for Anthropic
381
+ const jsonSchema = (0, zodCompat_js_1.toJsonSchema)(schema);
382
+ const inputSchema = {
383
+ type: "object",
384
+ properties: jsonSchema.properties || {},
385
+ required: jsonSchema.required || [],
386
+ };
387
+ return {
388
+ name,
389
+ description: tool.description,
390
+ input_schema: inputSchema,
391
+ };
392
+ });
393
+ requestParams.tools = [
394
+ ...requestParams.tools,
395
+ ...customTools,
396
+ ];
397
+ }
398
+ // Add system parameter if provided
399
+ if (this.userProvidedInstructions) {
400
+ requestParams.system = this.userProvidedInstructions;
401
+ }
402
+ // Add thinking parameter if available
403
+ if (thinking) {
404
+ requestParams.thinking = thinking;
405
+ }
406
+ // Log LLM request
407
+ const llmRequestId = (0, uuid_1.v7)();
408
+ FlowLogger_js_1.FlowLogger.logLlmRequest({
409
+ requestId: llmRequestId,
410
+ model: this.modelName,
411
+ prompt: (0, FlowLogger_js_1.extractLlmCuaPromptSummary)(messages),
412
+ });
413
+ const startTime = Date.now();
414
+ // Create the message using the Anthropic Messages API
415
+ // @ts-expect-error - The Anthropic SDK types are stricter than what we need
416
+ const response = await this.client.beta.messages.create(requestParams);
417
+ const endTime = Date.now();
418
+ const elapsedMs = endTime - startTime;
419
+ const usage = {
420
+ input_tokens: response.usage.input_tokens,
421
+ output_tokens: response.usage.output_tokens,
422
+ inference_time_ms: elapsedMs,
423
+ };
424
+ // Log LLM response
425
+ FlowLogger_js_1.FlowLogger.logLlmResponse({
426
+ requestId: llmRequestId,
427
+ model: this.modelName,
428
+ output: (0, FlowLogger_js_1.extractLlmCuaResponseSummary)(response.content),
429
+ inputTokens: response.usage.input_tokens,
430
+ outputTokens: response.usage.output_tokens,
431
+ });
432
+ // Store the message ID for future use
433
+ this.lastMessageId = response.id;
434
+ // Return the content and message ID
435
+ return {
436
+ // Cast the response content to our internal type
437
+ content: response.content,
438
+ id: response.id,
439
+ usage,
440
+ };
441
+ }
442
+ catch (error) {
443
+ console.error("Error getting action from Anthropic:", error);
444
+ throw error;
445
+ }
446
+ }
447
+ async takeAction(toolUseItems, logger) {
448
+ const toolResults = [];
449
+ logger({
450
+ category: "agent",
451
+ message: `Taking action on ${toolUseItems.length} tool use items`,
452
+ level: 2,
453
+ });
454
+ // Process each tool use item
455
+ for (const item of toolUseItems) {
456
+ try {
457
+ logger({
458
+ category: "agent",
459
+ message: `Processing tool use: ${item.name}, id: ${item.id}, action: ${JSON.stringify(item.input)}`,
460
+ level: 2,
461
+ });
462
+ // TODO: Normalize and migrate to agentHandler
463
+ // For computer tool, capture screenshot and return image
464
+ if (item.name === "computer") {
465
+ // Get action type
466
+ const action = item.input.action;
467
+ logger({
468
+ category: "agent",
469
+ message: `Computer action type: ${action}`,
470
+ level: 2,
471
+ });
472
+ // Capture a screenshot for the response
473
+ const screenshot = await this.captureScreenshot();
474
+ logger({
475
+ category: "agent",
476
+ message: `Screenshot captured, length: ${screenshot.length}`,
477
+ level: 2,
478
+ });
479
+ // Create proper image content block for Anthropic
480
+ const imageContent = [
481
+ {
482
+ type: "image",
483
+ source: {
484
+ type: "base64",
485
+ media_type: "image/png",
486
+ data: screenshot.replace(/^data:image\/png;base64,/, ""),
487
+ },
488
+ },
489
+ ];
490
+ // Add current URL if available
491
+ if (this.currentUrl) {
492
+ toolResults.push({
493
+ type: "tool_result",
494
+ tool_use_id: item.id,
495
+ content: [
496
+ ...imageContent,
497
+ {
498
+ type: "text",
499
+ text: `Current URL: ${this.currentUrl}`,
500
+ },
501
+ ],
502
+ });
503
+ }
504
+ else {
505
+ toolResults.push({
506
+ type: "tool_result",
507
+ tool_use_id: item.id,
508
+ content: imageContent,
509
+ });
510
+ }
511
+ logger({
512
+ category: "agent",
513
+ message: `Added computer tool result for tool_use_id: ${item.id}`,
514
+ level: 2,
515
+ });
516
+ }
517
+ else {
518
+ // Handle custom tools
519
+ let toolResult = "Tool executed successfully";
520
+ if (this.tools && item.name in this.tools) {
521
+ try {
522
+ const tool = this.tools[item.name];
523
+ logger({
524
+ category: "agent",
525
+ message: `Executing tool call: ${item.name} with args: ${JSON.stringify(item.input)}`,
526
+ level: 1,
527
+ });
528
+ const result = await tool.execute(item.input, {
529
+ toolCallId: item.id,
530
+ messages: [],
531
+ });
532
+ toolResult = JSON.stringify(result);
533
+ logger({
534
+ category: "agent",
535
+ message: `Tool ${item.name} completed successfully. Result: ${toolResult}`,
536
+ level: 1,
537
+ });
538
+ }
539
+ catch (toolError) {
540
+ const errorMessage = toolError instanceof Error
541
+ ? toolError.message
542
+ : String(toolError);
543
+ toolResult = `Error executing tool: ${errorMessage}`;
544
+ logger({
545
+ category: "agent",
546
+ message: `Error executing tool ${item.name}: ${errorMessage}`,
547
+ level: 0,
548
+ });
549
+ }
550
+ }
551
+ toolResults.push({
552
+ type: "tool_result",
553
+ tool_use_id: item.id,
554
+ content: [
555
+ {
556
+ type: "text",
557
+ text: toolResult,
558
+ },
559
+ ],
560
+ });
561
+ logger({
562
+ category: "agent",
563
+ message: `Added custom tool result for tool ${item.name}, tool_use_id: ${item.id}`,
564
+ level: 2,
565
+ });
566
+ }
567
+ }
568
+ catch (error) {
569
+ const errorMessage = error instanceof Error ? error.message : String(error);
570
+ logger({
571
+ category: "agent",
572
+ message: `Error executing tool use: ${errorMessage}`,
573
+ level: 0,
574
+ });
575
+ try {
576
+ // For computer tool, try to capture a screenshot even on error
577
+ if (item.name === "computer") {
578
+ const screenshot = await this.captureScreenshot();
579
+ toolResults.push({
580
+ type: "tool_result",
581
+ tool_use_id: item.id,
582
+ content: [
583
+ {
584
+ type: "image",
585
+ source: {
586
+ type: "base64",
587
+ media_type: "image/png",
588
+ data: screenshot.replace(/^data:image\/png;base64,/, ""),
589
+ },
590
+ },
591
+ {
592
+ type: "text",
593
+ text: `Error: ${errorMessage}`,
594
+ },
595
+ ],
596
+ });
597
+ logger({
598
+ category: "agent",
599
+ message: `Added error tool result with screenshot for tool_use_id: ${item.id}`,
600
+ level: 1,
601
+ });
602
+ }
603
+ else {
604
+ // For other tools, return an error message as a text content block
605
+ toolResults.push({
606
+ type: "tool_result",
607
+ tool_use_id: item.id,
608
+ content: [
609
+ {
610
+ type: "text",
611
+ text: `Error: ${errorMessage}`,
612
+ },
613
+ ],
614
+ });
615
+ logger({
616
+ category: "agent",
617
+ message: `Added error tool result for tool_use_id: ${item.id}`,
618
+ level: 1,
619
+ });
620
+ }
621
+ }
622
+ catch (screenshotError) {
623
+ // If we can't capture a screenshot, just send the error
624
+ logger({
625
+ category: "agent",
626
+ message: `Error capturing screenshot: ${String(screenshotError)}`,
627
+ level: 0,
628
+ });
629
+ toolResults.push({
630
+ type: "tool_result",
631
+ tool_use_id: item.id,
632
+ content: [
633
+ {
634
+ type: "text",
635
+ text: `Error: ${errorMessage}`,
636
+ },
637
+ ],
638
+ });
639
+ logger({
640
+ category: "agent",
641
+ message: `Added text error tool result for tool_use_id: ${item.id}`,
642
+ level: 1,
643
+ });
644
+ }
645
+ }
646
+ }
647
+ logger({
648
+ category: "agent",
649
+ message: `Prepared ${toolResults.length} tool results for next request`,
650
+ level: 2,
651
+ });
652
+ return toolResults;
653
+ }
654
+ convertToolUseToAction(item) {
655
+ try {
656
+ const { name, input } = item;
657
+ if (name === "computer") {
658
+ // For computer actions, format according to the action type
659
+ const action = input.action;
660
+ if (!action) {
661
+ console.warn("Missing action in tool use item:", item);
662
+ return null;
663
+ }
664
+ // Handle different action types specifically
665
+ if (action === "screenshot") {
666
+ return {
667
+ type: "screenshot",
668
+ ...input,
669
+ };
670
+ }
671
+ else if (action === "click") {
672
+ return {
673
+ type: "click",
674
+ x: input.x,
675
+ y: input.y,
676
+ button: input.button || "left",
677
+ ...input,
678
+ };
679
+ }
680
+ else if (action === "type") {
681
+ return {
682
+ type: "type",
683
+ text: input.text,
684
+ ...input,
685
+ };
686
+ }
687
+ else if (action === "keypress" || action === "key") {
688
+ return {
689
+ type: "keypress",
690
+ keys: [input.text],
691
+ ...input,
692
+ };
693
+ }
694
+ else if (action === "double_click" || action === "doubleClick") {
695
+ return {
696
+ type: "doubleClick",
697
+ x: input.x ||
698
+ (input.coordinate ? input.coordinate[0] : 0),
699
+ y: input.y ||
700
+ (input.coordinate ? input.coordinate[1] : 0),
701
+ ...input,
702
+ };
703
+ }
704
+ else if (action === "scroll") {
705
+ // Convert Anthropic's coordinate, scroll_amount and scroll_direction into scroll_x and scroll_y
706
+ const x = input.x ||
707
+ (input.coordinate ? input.coordinate[0] : 0);
708
+ const y = input.y ||
709
+ (input.coordinate ? input.coordinate[1] : 0);
710
+ // Calculate scroll_x and scroll_y based on scroll_amount and scroll_direction
711
+ let scroll_x = 0;
712
+ let scroll_y = 0;
713
+ const scrollAmount = input.scroll_amount || 5;
714
+ const scrollMultiplier = 100; // Pixels per unit of scroll_amount
715
+ if (input.scroll_direction) {
716
+ const direction = input.scroll_direction;
717
+ if (direction === "down") {
718
+ scroll_y = scrollAmount * scrollMultiplier;
719
+ }
720
+ else if (direction === "up") {
721
+ scroll_y = -scrollAmount * scrollMultiplier;
722
+ }
723
+ else if (direction === "right") {
724
+ scroll_x = scrollAmount * scrollMultiplier;
725
+ }
726
+ else if (direction === "left") {
727
+ scroll_x = -scrollAmount * scrollMultiplier;
728
+ }
729
+ }
730
+ else {
731
+ // Use direct scroll_x and scroll_y if provided
732
+ scroll_x = input.scroll_x || 0;
733
+ scroll_y = input.scroll_y || 0;
734
+ }
735
+ return {
736
+ type: "scroll",
737
+ x: x,
738
+ y: y,
739
+ scroll_x: scroll_x,
740
+ scroll_y: scroll_y,
741
+ ...input,
742
+ };
743
+ }
744
+ else if (action === "move") {
745
+ // Handle Anthropic's coordinate format
746
+ const coordinates = input.coordinate;
747
+ const x = coordinates ? coordinates[0] : input.x || 0;
748
+ const y = coordinates ? coordinates[1] : input.y || 0;
749
+ return {
750
+ type: "move",
751
+ x: x,
752
+ y: y,
753
+ ...input,
754
+ };
755
+ }
756
+ else if (action === "drag" || action === "left_click_drag") {
757
+ // Make sure path is properly formatted
758
+ const path = input.path ||
759
+ (input.coordinate
760
+ ? [
761
+ {
762
+ x: input.start_coordinate[0],
763
+ y: input.start_coordinate[1],
764
+ },
765
+ {
766
+ x: input.coordinate[0],
767
+ y: input.coordinate[1],
768
+ },
769
+ ]
770
+ : []);
771
+ return {
772
+ type: "drag",
773
+ path: path,
774
+ ...input,
775
+ };
776
+ }
777
+ else if (action === "wait") {
778
+ return {
779
+ type: "wait",
780
+ ...input,
781
+ };
782
+ }
783
+ else if (action === "left_click") {
784
+ // Convert left_click to regular click
785
+ const coordinates = input.coordinate;
786
+ const x = coordinates ? coordinates[0] : input.x || 0;
787
+ const y = coordinates ? coordinates[1] : input.y || 0;
788
+ return {
789
+ type: "click",
790
+ x: x,
791
+ y: y,
792
+ button: "left",
793
+ ...input,
794
+ };
795
+ }
796
+ else {
797
+ // For other computer actions, use the action type directly
798
+ return {
799
+ type: action,
800
+ ...input,
801
+ };
802
+ }
803
+ }
804
+ else if (name === "str_replace_editor" || name === "bash") {
805
+ // For editor or bash tools
806
+ return {
807
+ type: name,
808
+ params: input,
809
+ };
810
+ }
811
+ else if (this.tools && name in this.tools) {
812
+ return null;
813
+ }
814
+ console.warn(`Unknown tool name: ${name}`);
815
+ return null;
816
+ }
817
+ catch (error) {
818
+ console.error("Error converting tool use to action:", error);
819
+ return null;
820
+ }
821
+ }
822
+ async captureScreenshot(options) {
823
+ // Use provided options if available
824
+ if (options?.base64Image) {
825
+ return `data:image/png;base64,${options.base64Image}`;
826
+ }
827
+ // Use the screenshot provider if available
828
+ if (this.screenshotProvider) {
829
+ try {
830
+ const base64Image = await this.screenshotProvider();
831
+ return `data:image/png;base64,${base64Image}`;
832
+ }
833
+ catch (error) {
834
+ console.error("Error capturing screenshot:", error);
835
+ throw error;
836
+ }
837
+ }
838
+ throw new sdkErrors_js_1.AgentScreenshotProviderError("`screenshotProvider` has not been set. " +
839
+ "Please call `setScreenshotProvider()` with a valid function that returns a base64-encoded image");
840
+ }
841
+ }
842
+ exports.AnthropicCUAClient = AnthropicCUAClient;
843
+ //# sourceMappingURL=AnthropicCUAClient.js.map