@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-patch.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (655) hide show
  1. package/dist/esm/index.d.ts +3 -0
  2. package/dist/esm/index.js +3 -0
  3. package/dist/esm/lib/inference.d.ts +65 -0
  4. package/dist/esm/lib/inference.js +333 -0
  5. package/dist/esm/lib/inference.js.map +1 -0
  6. package/dist/esm/lib/inferenceLogUtils.d.ts +12 -0
  7. package/dist/esm/lib/inferenceLogUtils.js +92 -0
  8. package/dist/esm/lib/inferenceLogUtils.js.map +1 -0
  9. package/dist/esm/lib/logger.d.ts +69 -0
  10. package/dist/esm/lib/logger.js +323 -0
  11. package/dist/esm/lib/logger.js.map +1 -0
  12. package/dist/esm/lib/modelUtils.d.ts +14 -0
  13. package/dist/esm/lib/modelUtils.js +48 -0
  14. package/dist/esm/lib/modelUtils.js.map +1 -0
  15. package/dist/esm/lib/prompt.d.ts +14 -0
  16. package/dist/esm/lib/prompt.js +230 -0
  17. package/dist/esm/lib/prompt.js.map +1 -0
  18. package/dist/esm/lib/utils.d.ts +68 -0
  19. package/dist/esm/lib/utils.js +654 -0
  20. package/dist/esm/lib/utils.js.map +1 -0
  21. package/dist/esm/lib/v3/agent/AgentClient.d.ts +19 -0
  22. package/dist/esm/lib/v3/agent/AgentClient.js +17 -0
  23. package/dist/esm/lib/v3/agent/AgentClient.js.map +1 -0
  24. package/dist/esm/lib/v3/agent/AgentProvider.d.ts +20 -0
  25. package/dist/esm/lib/v3/agent/AgentProvider.js +77 -0
  26. package/dist/esm/lib/v3/agent/AgentProvider.js.map +1 -0
  27. package/dist/esm/lib/v3/agent/AnthropicCUAClient.d.ts +57 -0
  28. package/dist/esm/lib/v3/agent/AnthropicCUAClient.js +822 -0
  29. package/dist/esm/lib/v3/agent/AnthropicCUAClient.js.map +1 -0
  30. package/dist/esm/lib/v3/agent/GoogleCUAClient.d.ts +74 -0
  31. package/dist/esm/lib/v3/agent/GoogleCUAClient.js +799 -0
  32. package/dist/esm/lib/v3/agent/GoogleCUAClient.js.map +1 -0
  33. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.d.ts +71 -0
  34. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.js +770 -0
  35. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.js.map +1 -0
  36. package/dist/esm/lib/v3/agent/OpenAICUAClient.d.ts +69 -0
  37. package/dist/esm/lib/v3/agent/OpenAICUAClient.js +615 -0
  38. package/dist/esm/lib/v3/agent/OpenAICUAClient.js.map +1 -0
  39. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.d.ts +12 -0
  40. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.js +186 -0
  41. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.js.map +1 -0
  42. package/dist/esm/lib/v3/agent/tools/act.d.ts +13 -0
  43. package/dist/esm/lib/v3/agent/tools/act.js +49 -0
  44. package/dist/esm/lib/v3/agent/tools/act.js.map +1 -0
  45. package/dist/esm/lib/v3/agent/tools/ariaTree.d.ts +5 -0
  46. package/dist/esm/lib/v3/agent/tools/ariaTree.js +31 -0
  47. package/dist/esm/lib/v3/agent/tools/ariaTree.js.map +1 -0
  48. package/dist/esm/lib/v3/agent/tools/click.d.ts +6 -0
  49. package/dist/esm/lib/v3/agent/tools/click.js +104 -0
  50. package/dist/esm/lib/v3/agent/tools/click.js.map +1 -0
  51. package/dist/esm/lib/v3/agent/tools/clickAndHold.d.ts +14 -0
  52. package/dist/esm/lib/v3/agent/tools/clickAndHold.js +68 -0
  53. package/dist/esm/lib/v3/agent/tools/clickAndHold.js.map +1 -0
  54. package/dist/esm/lib/v3/agent/tools/dragAndDrop.d.ts +7 -0
  55. package/dist/esm/lib/v3/agent/tools/dragAndDrop.js +105 -0
  56. package/dist/esm/lib/v3/agent/tools/dragAndDrop.js.map +1 -0
  57. package/dist/esm/lib/v3/agent/tools/extract.d.ts +21 -0
  58. package/dist/esm/lib/v3/agent/tools/extract.js +93 -0
  59. package/dist/esm/lib/v3/agent/tools/extract.js.map +1 -0
  60. package/dist/esm/lib/v3/agent/tools/fillFormVision.d.ts +12 -0
  61. package/dist/esm/lib/v3/agent/tools/fillFormVision.js +143 -0
  62. package/dist/esm/lib/v3/agent/tools/fillFormVision.js.map +1 -0
  63. package/dist/esm/lib/v3/agent/tools/fillform.d.ts +13 -0
  64. package/dist/esm/lib/v3/agent/tools/fillform.js +56 -0
  65. package/dist/esm/lib/v3/agent/tools/fillform.js.map +1 -0
  66. package/dist/esm/lib/v3/agent/tools/goto.d.ts +12 -0
  67. package/dist/esm/lib/v3/agent/tools/goto.js +31 -0
  68. package/dist/esm/lib/v3/agent/tools/goto.js.map +1 -0
  69. package/dist/esm/lib/v3/agent/tools/index.d.ts +92 -0
  70. package/dist/esm/lib/v3/agent/tools/index.js +74 -0
  71. package/dist/esm/lib/v3/agent/tools/index.js.map +1 -0
  72. package/dist/esm/lib/v3/agent/tools/keys.d.ts +24 -0
  73. package/dist/esm/lib/v3/agent/tools/keys.js +60 -0
  74. package/dist/esm/lib/v3/agent/tools/keys.js.map +1 -0
  75. package/dist/esm/lib/v3/agent/tools/navback.d.ts +6 -0
  76. package/dist/esm/lib/v3/agent/tools/navback.js +23 -0
  77. package/dist/esm/lib/v3/agent/tools/navback.js.map +1 -0
  78. package/dist/esm/lib/v3/agent/tools/screenshot.d.ts +6 -0
  79. package/dist/esm/lib/v3/agent/tools/screenshot.js +26 -0
  80. package/dist/esm/lib/v3/agent/tools/screenshot.js.map +1 -0
  81. package/dist/esm/lib/v3/agent/tools/scroll.d.ts +19 -0
  82. package/dist/esm/lib/v3/agent/tools/scroll.js +142 -0
  83. package/dist/esm/lib/v3/agent/tools/scroll.js.map +1 -0
  84. package/dist/esm/lib/v3/agent/tools/search.d.ts +15 -0
  85. package/dist/esm/lib/v3/agent/tools/search.js +73 -0
  86. package/dist/esm/lib/v3/agent/tools/search.js.map +1 -0
  87. package/dist/esm/lib/v3/agent/tools/think.d.ts +6 -0
  88. package/dist/esm/lib/v3/agent/tools/think.js +24 -0
  89. package/dist/esm/lib/v3/agent/tools/think.js.map +1 -0
  90. package/dist/esm/lib/v3/agent/tools/type.d.ts +7 -0
  91. package/dist/esm/lib/v3/agent/tools/type.js +106 -0
  92. package/dist/esm/lib/v3/agent/tools/type.js.map +1 -0
  93. package/dist/esm/lib/v3/agent/tools/wait.d.ts +5 -0
  94. package/dist/esm/lib/v3/agent/tools/wait.js +53 -0
  95. package/dist/esm/lib/v3/agent/tools/wait.js.map +1 -0
  96. package/dist/esm/lib/v3/agent/utils/actionMapping.d.ts +3 -0
  97. package/dist/esm/lib/v3/agent/utils/actionMapping.js +100 -0
  98. package/dist/esm/lib/v3/agent/utils/actionMapping.js.map +1 -0
  99. package/dist/esm/lib/v3/agent/utils/coordinateNormalization.d.ts +13 -0
  100. package/dist/esm/lib/v3/agent/utils/coordinateNormalization.js +28 -0
  101. package/dist/esm/lib/v3/agent/utils/coordinateNormalization.js.map +1 -0
  102. package/dist/esm/lib/v3/agent/utils/cuaKeyMapping.d.ts +10 -0
  103. package/dist/esm/lib/v3/agent/utils/cuaKeyMapping.js +62 -0
  104. package/dist/esm/lib/v3/agent/utils/cuaKeyMapping.js.map +1 -0
  105. package/dist/esm/lib/v3/agent/utils/googleCustomToolHandler.d.ts +25 -0
  106. package/dist/esm/lib/v3/agent/utils/googleCustomToolHandler.js +145 -0
  107. package/dist/esm/lib/v3/agent/utils/googleCustomToolHandler.js.map +1 -0
  108. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.d.ts +22 -0
  109. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.js +101 -0
  110. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.js.map +1 -0
  111. package/dist/esm/lib/v3/agent/utils/imageCompression.d.ts +53 -0
  112. package/dist/esm/lib/v3/agent/utils/imageCompression.js +204 -0
  113. package/dist/esm/lib/v3/agent/utils/imageCompression.js.map +1 -0
  114. package/dist/esm/lib/v3/agent/utils/messageProcessing.d.ts +12 -0
  115. package/dist/esm/lib/v3/agent/utils/messageProcessing.js +164 -0
  116. package/dist/esm/lib/v3/agent/utils/messageProcessing.js.map +1 -0
  117. package/dist/esm/lib/v3/agent/utils/screenshotHandler.d.ts +10 -0
  118. package/dist/esm/lib/v3/agent/utils/screenshotHandler.js +26 -0
  119. package/dist/esm/lib/v3/agent/utils/screenshotHandler.js.map +1 -0
  120. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.d.ts +26 -0
  121. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.js +79 -0
  122. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.js.map +1 -0
  123. package/dist/esm/lib/v3/agent/utils/xpath.d.ts +11 -0
  124. package/dist/esm/lib/v3/agent/utils/xpath.js +19 -0
  125. package/dist/esm/lib/v3/agent/utils/xpath.js.map +1 -0
  126. package/dist/esm/lib/v3/api.d.ts +86 -0
  127. package/dist/esm/lib/v3/api.js +484 -0
  128. package/dist/esm/lib/v3/api.js.map +1 -0
  129. package/dist/esm/lib/v3/cache/ActCache.d.ts +23 -0
  130. package/dist/esm/lib/v3/cache/ActCache.js +292 -0
  131. package/dist/esm/lib/v3/cache/ActCache.js.map +1 -0
  132. package/dist/esm/lib/v3/cache/AgentCache.d.ts +109 -0
  133. package/dist/esm/lib/v3/cache/AgentCache.js +640 -0
  134. package/dist/esm/lib/v3/cache/AgentCache.js.map +1 -0
  135. package/dist/esm/lib/v3/cache/CacheStorage.d.ts +17 -0
  136. package/dist/esm/lib/v3/cache/CacheStorage.js +98 -0
  137. package/dist/esm/lib/v3/cache/CacheStorage.js.map +1 -0
  138. package/dist/esm/lib/v3/cache/serverAgentCache.d.ts +7 -0
  139. package/dist/esm/lib/v3/cache/serverAgentCache.js +49 -0
  140. package/dist/esm/lib/v3/cache/serverAgentCache.js.map +1 -0
  141. package/dist/esm/lib/v3/cache/utils.d.ts +15 -0
  142. package/dist/esm/lib/v3/cache/utils.js +39 -0
  143. package/dist/esm/lib/v3/cache/utils.js.map +1 -0
  144. package/dist/esm/lib/v3/dom/a11yScripts/index.d.ts +11 -0
  145. package/dist/esm/lib/v3/dom/a11yScripts/index.js +117 -0
  146. package/dist/esm/lib/v3/dom/a11yScripts/index.js.map +1 -0
  147. package/dist/esm/lib/v3/dom/build/a11yScripts.generated.d.ts +16 -0
  148. package/dist/esm/lib/v3/dom/build/a11yScripts.generated.js +20 -0
  149. package/dist/esm/lib/v3/dom/build/a11yScripts.generated.js.map +1 -0
  150. package/dist/esm/lib/v3/dom/build/locatorScripts.generated.d.ts +52 -0
  151. package/dist/esm/lib/v3/dom/build/locatorScripts.generated.js +56 -0
  152. package/dist/esm/lib/v3/dom/build/locatorScripts.generated.js.map +1 -0
  153. package/dist/esm/lib/v3/dom/build/reRenderScriptContent.d.ts +1 -0
  154. package/dist/esm/lib/v3/dom/build/reRenderScriptContent.js +2 -0
  155. package/dist/esm/lib/v3/dom/build/reRenderScriptContent.js.map +1 -0
  156. package/dist/esm/lib/v3/dom/build/rerender-index.js +1 -0
  157. package/dist/esm/lib/v3/dom/build/screenshotScripts.generated.d.ts +4 -0
  158. package/dist/esm/lib/v3/dom/build/screenshotScripts.generated.js +8 -0
  159. package/dist/esm/lib/v3/dom/build/screenshotScripts.generated.js.map +1 -0
  160. package/dist/esm/lib/v3/dom/build/scriptV3Content.d.ts +1 -0
  161. package/dist/esm/lib/v3/dom/build/scriptV3Content.js +2 -0
  162. package/dist/esm/lib/v3/dom/build/scriptV3Content.js.map +1 -0
  163. package/dist/esm/lib/v3/dom/build/v3-index.js +1 -0
  164. package/dist/esm/lib/v3/dom/genA11yScripts.d.ts +1 -0
  165. package/dist/esm/lib/v3/dom/genA11yScripts.js +54 -0
  166. package/dist/esm/lib/v3/dom/genA11yScripts.js.map +1 -0
  167. package/dist/esm/lib/v3/dom/genDomScripts.d.ts +1 -0
  168. package/dist/esm/lib/v3/dom/genDomScripts.js +38 -0
  169. package/dist/esm/lib/v3/dom/genDomScripts.js.map +1 -0
  170. package/dist/esm/lib/v3/dom/genLocatorScripts.d.ts +1 -0
  171. package/dist/esm/lib/v3/dom/genLocatorScripts.js +51 -0
  172. package/dist/esm/lib/v3/dom/genLocatorScripts.js.map +1 -0
  173. package/dist/esm/lib/v3/dom/genScreenshotScripts.d.ts +1 -0
  174. package/dist/esm/lib/v3/dom/genScreenshotScripts.js +37 -0
  175. package/dist/esm/lib/v3/dom/genScreenshotScripts.js.map +1 -0
  176. package/dist/esm/lib/v3/dom/index.d.ts +1 -0
  177. package/dist/esm/lib/v3/dom/index.js +2 -0
  178. package/dist/esm/lib/v3/dom/index.js.map +1 -0
  179. package/dist/esm/lib/v3/dom/locatorScripts/counts.d.ts +15 -0
  180. package/dist/esm/lib/v3/dom/locatorScripts/counts.js +272 -0
  181. package/dist/esm/lib/v3/dom/locatorScripts/counts.js.map +1 -0
  182. package/dist/esm/lib/v3/dom/locatorScripts/index.d.ts +4 -0
  183. package/dist/esm/lib/v3/dom/locatorScripts/index.js +5 -0
  184. package/dist/esm/lib/v3/dom/locatorScripts/index.js.map +1 -0
  185. package/dist/esm/lib/v3/dom/locatorScripts/scripts.d.ts +37 -0
  186. package/dist/esm/lib/v3/dom/locatorScripts/scripts.js +458 -0
  187. package/dist/esm/lib/v3/dom/locatorScripts/scripts.js.map +1 -0
  188. package/dist/esm/lib/v3/dom/locatorScripts/selectors.d.ts +4 -0
  189. package/dist/esm/lib/v3/dom/locatorScripts/selectors.js +283 -0
  190. package/dist/esm/lib/v3/dom/locatorScripts/selectors.js.map +1 -0
  191. package/dist/esm/lib/v3/dom/locatorScripts/waitForSelector.d.ts +19 -0
  192. package/dist/esm/lib/v3/dom/locatorScripts/waitForSelector.js +283 -0
  193. package/dist/esm/lib/v3/dom/locatorScripts/waitForSelector.js.map +1 -0
  194. package/dist/esm/lib/v3/dom/locatorScripts/xpathParser.d.ts +76 -0
  195. package/dist/esm/lib/v3/dom/locatorScripts/xpathParser.js +376 -0
  196. package/dist/esm/lib/v3/dom/locatorScripts/xpathParser.js.map +1 -0
  197. package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.d.ts +9 -0
  198. package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.js +196 -0
  199. package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.js.map +1 -0
  200. package/dist/esm/lib/v3/dom/piercer.entry.d.ts +1 -0
  201. package/dist/esm/lib/v3/dom/piercer.entry.js +3 -0
  202. package/dist/esm/lib/v3/dom/piercer.entry.js.map +1 -0
  203. package/dist/esm/lib/v3/dom/piercer.runtime.d.ts +23 -0
  204. package/dist/esm/lib/v3/dom/piercer.runtime.js +90 -0
  205. package/dist/esm/lib/v3/dom/piercer.runtime.js.map +1 -0
  206. package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.d.ts +1 -0
  207. package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.js +3 -0
  208. package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.js.map +1 -0
  209. package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.d.ts +1 -0
  210. package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.js +40 -0
  211. package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.js.map +1 -0
  212. package/dist/esm/lib/v3/dom/screenshotScripts/index.d.ts +1 -0
  213. package/dist/esm/lib/v3/dom/screenshotScripts/index.js +2 -0
  214. package/dist/esm/lib/v3/dom/screenshotScripts/index.js.map +1 -0
  215. package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.d.ts +8 -0
  216. package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.js +82 -0
  217. package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.js.map +1 -0
  218. package/dist/esm/lib/v3/external_clients/aisdk.d.ts +11 -0
  219. package/dist/esm/lib/v3/external_clients/aisdk.js +103 -0
  220. package/dist/esm/lib/v3/external_clients/aisdk.js.map +1 -0
  221. package/dist/esm/lib/v3/external_clients/customOpenAI.d.ts +18 -0
  222. package/dist/esm/lib/v3/external_clients/customOpenAI.js +220 -0
  223. package/dist/esm/lib/v3/external_clients/customOpenAI.js.map +1 -0
  224. package/dist/esm/lib/v3/flowLogger.d.ts +139 -0
  225. package/dist/esm/lib/v3/flowLogger.js +868 -0
  226. package/dist/esm/lib/v3/flowLogger.js.map +1 -0
  227. package/dist/esm/lib/v3/handlers/actHandler.d.ts +21 -0
  228. package/dist/esm/lib/v3/handlers/actHandler.js +340 -0
  229. package/dist/esm/lib/v3/handlers/actHandler.js.map +1 -0
  230. package/dist/esm/lib/v3/handlers/extractHandler.d.ts +31 -0
  231. package/dist/esm/lib/v3/handlers/extractHandler.js +139 -0
  232. package/dist/esm/lib/v3/handlers/extractHandler.js.map +1 -0
  233. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.d.ts +24 -0
  234. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.js +623 -0
  235. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.js.map +1 -0
  236. package/dist/esm/lib/v3/handlers/handlerUtils/timeoutGuard.d.ts +2 -0
  237. package/dist/esm/lib/v3/handlers/handlerUtils/timeoutGuard.js +14 -0
  238. package/dist/esm/lib/v3/handlers/handlerUtils/timeoutGuard.js.map +1 -0
  239. package/dist/esm/lib/v3/handlers/observeHandler.d.ts +17 -0
  240. package/dist/esm/lib/v3/handlers/observeHandler.js +156 -0
  241. package/dist/esm/lib/v3/handlers/observeHandler.js.map +1 -0
  242. package/dist/esm/lib/v3/handlers/v3AgentHandler.d.ts +32 -0
  243. package/dist/esm/lib/v3/handlers/v3AgentHandler.js +461 -0
  244. package/dist/esm/lib/v3/handlers/v3AgentHandler.js.map +1 -0
  245. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.d.ts +33 -0
  246. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.js +528 -0
  247. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.js.map +1 -0
  248. package/dist/esm/lib/v3/index.d.ts +17 -0
  249. package/dist/esm/lib/v3/index.js +13 -0
  250. package/dist/esm/lib/v3/index.js.map +1 -0
  251. package/dist/esm/lib/v3/launch/browserbase.d.ts +7 -0
  252. package/dist/esm/lib/v3/launch/browserbase.js +46 -0
  253. package/dist/esm/lib/v3/launch/browserbase.js.map +1 -0
  254. package/dist/esm/lib/v3/launch/local.d.ts +15 -0
  255. package/dist/esm/lib/v3/launch/local.js +98 -0
  256. package/dist/esm/lib/v3/launch/local.js.map +1 -0
  257. package/dist/esm/lib/v3/llm/AnthropicClient.d.ts +16 -0
  258. package/dist/esm/lib/v3/llm/AnthropicClient.js +239 -0
  259. package/dist/esm/lib/v3/llm/AnthropicClient.js.map +1 -0
  260. package/dist/esm/lib/v3/llm/CerebrasClient.d.ts +17 -0
  261. package/dist/esm/lib/v3/llm/CerebrasClient.js +235 -0
  262. package/dist/esm/lib/v3/llm/CerebrasClient.js.map +1 -0
  263. package/dist/esm/lib/v3/llm/GoogleClient.d.ts +19 -0
  264. package/dist/esm/lib/v3/llm/GoogleClient.js +369 -0
  265. package/dist/esm/lib/v3/llm/GoogleClient.js.map +1 -0
  266. package/dist/esm/lib/v3/llm/GroqClient.d.ts +17 -0
  267. package/dist/esm/lib/v3/llm/GroqClient.js +236 -0
  268. package/dist/esm/lib/v3/llm/GroqClient.js.map +1 -0
  269. package/dist/esm/lib/v3/llm/LLMClient.d.ts +121 -0
  270. package/dist/esm/lib/v3/llm/LLMClient.js +23 -0
  271. package/dist/esm/lib/v3/llm/LLMClient.js.map +1 -0
  272. package/dist/esm/lib/v3/llm/LLMProvider.d.ts +13 -0
  273. package/dist/esm/lib/v3/llm/LLMProvider.js +194 -0
  274. package/dist/esm/lib/v3/llm/LLMProvider.js.map +1 -0
  275. package/dist/esm/lib/v3/llm/OpenAIClient.d.ts +15 -0
  276. package/dist/esm/lib/v3/llm/OpenAIClient.js +329 -0
  277. package/dist/esm/lib/v3/llm/OpenAIClient.js.map +1 -0
  278. package/dist/esm/lib/v3/llm/aisdk.d.ts +15 -0
  279. package/dist/esm/lib/v3/llm/aisdk.js +348 -0
  280. package/dist/esm/lib/v3/llm/aisdk.js.map +1 -0
  281. package/dist/esm/lib/v3/logger.d.ts +9 -0
  282. package/dist/esm/lib/v3/logger.js +96 -0
  283. package/dist/esm/lib/v3/logger.js.map +1 -0
  284. package/dist/esm/lib/v3/mcp/connection.d.ts +11 -0
  285. package/dist/esm/lib/v3/mcp/connection.js +49 -0
  286. package/dist/esm/lib/v3/mcp/connection.js.map +1 -0
  287. package/dist/esm/lib/v3/mcp/utils.d.ts +3 -0
  288. package/dist/esm/lib/v3/mcp/utils.js +36 -0
  289. package/dist/esm/lib/v3/mcp/utils.js.map +1 -0
  290. package/dist/esm/lib/v3/shutdown/cleanupLocal.d.ts +14 -0
  291. package/dist/esm/lib/v3/shutdown/cleanupLocal.js +30 -0
  292. package/dist/esm/lib/v3/shutdown/cleanupLocal.js.map +1 -0
  293. package/dist/esm/lib/v3/shutdown/supervisor.d.ts +9 -0
  294. package/dist/esm/lib/v3/shutdown/supervisor.js +156 -0
  295. package/dist/esm/lib/v3/shutdown/supervisor.js.map +1 -0
  296. package/dist/esm/lib/v3/shutdown/supervisorClient.d.ts +15 -0
  297. package/dist/esm/lib/v3/shutdown/supervisorClient.js +97 -0
  298. package/dist/esm/lib/v3/shutdown/supervisorClient.js.map +1 -0
  299. package/dist/esm/lib/v3/tests/agent-abort-signal.spec.js +113 -0
  300. package/dist/esm/lib/v3/tests/agent-abort-signal.spec.js.map +7 -0
  301. package/dist/esm/lib/v3/tests/agent-cache-self-heal.spec.js +80 -0
  302. package/dist/esm/lib/v3/tests/agent-cache-self-heal.spec.js.map +7 -0
  303. package/dist/esm/lib/v3/tests/agent-callbacks.spec.js +374 -0
  304. package/dist/esm/lib/v3/tests/agent-callbacks.spec.js.map +7 -0
  305. package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js +357 -0
  306. package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js.map +7 -0
  307. package/dist/esm/lib/v3/tests/agent-hybrid-mode.spec.js +247 -0
  308. package/dist/esm/lib/v3/tests/agent-hybrid-mode.spec.js.map +7 -0
  309. package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js +105 -0
  310. package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js.map +7 -0
  311. package/dist/esm/lib/v3/tests/agent-streaming.spec.js +126 -0
  312. package/dist/esm/lib/v3/tests/agent-streaming.spec.js.map +7 -0
  313. package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js +44 -0
  314. package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js.map +7 -0
  315. package/dist/esm/lib/v3/tests/click-count.spec.js +112 -0
  316. package/dist/esm/lib/v3/tests/click-count.spec.js.map +7 -0
  317. package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js +54 -0
  318. package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js.map +7 -0
  319. package/dist/esm/lib/v3/tests/context-addInitScript.spec.js +176 -0
  320. package/dist/esm/lib/v3/tests/context-addInitScript.spec.js.map +7 -0
  321. package/dist/esm/lib/v3/tests/default-page-tracking.spec.js +53 -0
  322. package/dist/esm/lib/v3/tests/default-page-tracking.spec.js.map +7 -0
  323. package/dist/esm/lib/v3/tests/downloads.spec.js +58 -0
  324. package/dist/esm/lib/v3/tests/downloads.spec.js.map +7 -0
  325. package/dist/esm/lib/v3/tests/envReporter.js +57 -0
  326. package/dist/esm/lib/v3/tests/envReporter.js.map +7 -0
  327. package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js +53 -0
  328. package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js.map +7 -0
  329. package/dist/esm/lib/v3/tests/iframe-ctx-addInitScript.spec.js +447 -0
  330. package/dist/esm/lib/v3/tests/iframe-ctx-addInitScript.spec.js.map +7 -0
  331. package/dist/esm/lib/v3/tests/keep-alive.child.js +92 -0
  332. package/dist/esm/lib/v3/tests/keep-alive.child.js.map +7 -0
  333. package/dist/esm/lib/v3/tests/keep-alive.helpers.js +532 -0
  334. package/dist/esm/lib/v3/tests/keep-alive.helpers.js.map +7 -0
  335. package/dist/esm/lib/v3/tests/keep-alive.spec.js +19 -0
  336. package/dist/esm/lib/v3/tests/keep-alive.spec.js.map +7 -0
  337. package/dist/esm/lib/v3/tests/keyboard.spec.js +296 -0
  338. package/dist/esm/lib/v3/tests/keyboard.spec.js.map +7 -0
  339. package/dist/esm/lib/v3/tests/locator-backend-node-id.spec.js +159 -0
  340. package/dist/esm/lib/v3/tests/locator-backend-node-id.spec.js.map +7 -0
  341. package/dist/esm/lib/v3/tests/locator-content-methods.spec.js +191 -0
  342. package/dist/esm/lib/v3/tests/locator-content-methods.spec.js.map +7 -0
  343. package/dist/esm/lib/v3/tests/locator-count-iframe.spec.js +108 -0
  344. package/dist/esm/lib/v3/tests/locator-count-iframe.spec.js.map +7 -0
  345. package/dist/esm/lib/v3/tests/locator-count.spec.js +71 -0
  346. package/dist/esm/lib/v3/tests/locator-count.spec.js.map +7 -0
  347. package/dist/esm/lib/v3/tests/locator-fill.spec.js +118 -0
  348. package/dist/esm/lib/v3/tests/locator-fill.spec.js.map +7 -0
  349. package/dist/esm/lib/v3/tests/locator-input-methods.spec.js +136 -0
  350. package/dist/esm/lib/v3/tests/locator-input-methods.spec.js.map +7 -0
  351. package/dist/esm/lib/v3/tests/locator-nth.spec.js +157 -0
  352. package/dist/esm/lib/v3/tests/locator-nth.spec.js.map +7 -0
  353. package/dist/esm/lib/v3/tests/locator-select-option.spec.js +242 -0
  354. package/dist/esm/lib/v3/tests/locator-select-option.spec.js.map +7 -0
  355. package/dist/esm/lib/v3/tests/logger-initialization.spec.js +552 -0
  356. package/dist/esm/lib/v3/tests/logger-initialization.spec.js.map +7 -0
  357. package/dist/esm/lib/v3/tests/multi-instance-logger.spec.js +269 -0
  358. package/dist/esm/lib/v3/tests/multi-instance-logger.spec.js.map +7 -0
  359. package/dist/esm/lib/v3/tests/nested-div.spec.js +23 -0
  360. package/dist/esm/lib/v3/tests/nested-div.spec.js.map +7 -0
  361. package/dist/esm/lib/v3/tests/page-addInitScript.spec.js +90 -0
  362. package/dist/esm/lib/v3/tests/page-addInitScript.spec.js.map +7 -0
  363. package/dist/esm/lib/v3/tests/page-console.spec.js +56 -0
  364. package/dist/esm/lib/v3/tests/page-console.spec.js.map +7 -0
  365. package/dist/esm/lib/v3/tests/page-drag-and-drop.spec.js +418 -0
  366. package/dist/esm/lib/v3/tests/page-drag-and-drop.spec.js.map +7 -0
  367. package/dist/esm/lib/v3/tests/page-goto-response.spec.js +35 -0
  368. package/dist/esm/lib/v3/tests/page-goto-response.spec.js.map +7 -0
  369. package/dist/esm/lib/v3/tests/page-hover.spec.js +167 -0
  370. package/dist/esm/lib/v3/tests/page-hover.spec.js.map +7 -0
  371. package/dist/esm/lib/v3/tests/page-screenshot.spec.js +273 -0
  372. package/dist/esm/lib/v3/tests/page-screenshot.spec.js.map +7 -0
  373. package/dist/esm/lib/v3/tests/page-scroll.spec.js +182 -0
  374. package/dist/esm/lib/v3/tests/page-scroll.spec.js.map +7 -0
  375. package/dist/esm/lib/v3/tests/page-send-cdp.spec.js +46 -0
  376. package/dist/esm/lib/v3/tests/page-send-cdp.spec.js.map +7 -0
  377. package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js +98 -0
  378. package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js.map +7 -0
  379. package/dist/esm/lib/v3/tests/setinputfiles.spec.js +126 -0
  380. package/dist/esm/lib/v3/tests/setinputfiles.spec.js.map +7 -0
  381. package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js +134 -0
  382. package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js.map +7 -0
  383. package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js +134 -0
  384. package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js.map +7 -0
  385. package/dist/esm/lib/v3/tests/testUtils.js +31 -0
  386. package/dist/esm/lib/v3/tests/testUtils.js.map +7 -0
  387. package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js +100 -0
  388. package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js.map +7 -0
  389. package/dist/esm/lib/v3/tests/timeouts.spec.js +32 -0
  390. package/dist/esm/lib/v3/tests/timeouts.spec.js.map +7 -0
  391. package/dist/esm/lib/v3/tests/user-data-dir.spec.js +43 -0
  392. package/dist/esm/lib/v3/tests/user-data-dir.spec.js.map +7 -0
  393. package/dist/esm/lib/v3/tests/v3.config.js +15 -0
  394. package/dist/esm/lib/v3/tests/v3.config.js.map +7 -0
  395. package/dist/esm/lib/v3/tests/v3.dynamic.config.js +43 -0
  396. package/dist/esm/lib/v3/tests/v3.dynamic.config.js.map +7 -0
  397. package/dist/esm/lib/v3/tests/v3.playwright.config.js +98 -0
  398. package/dist/esm/lib/v3/tests/v3.playwright.config.js.map +7 -0
  399. package/dist/esm/lib/v3/tests/wait-for-selector.spec.js +593 -0
  400. package/dist/esm/lib/v3/tests/wait-for-selector.spec.js.map +7 -0
  401. package/dist/esm/lib/v3/tests/wait-for-timeout.spec.js +97 -0
  402. package/dist/esm/lib/v3/tests/wait-for-timeout.spec.js.map +7 -0
  403. package/dist/esm/lib/v3/tests/xpath-for-location-deep.spec.js +77 -0
  404. package/dist/esm/lib/v3/tests/xpath-for-location-deep.spec.js.map +7 -0
  405. package/dist/esm/lib/v3/timeoutConfig.d.ts +2 -0
  406. package/dist/esm/lib/v3/timeoutConfig.js +27 -0
  407. package/dist/esm/lib/v3/timeoutConfig.js.map +1 -0
  408. package/dist/esm/lib/v3/types/private/agent.d.ts +6 -0
  409. package/dist/esm/lib/v3/types/private/agent.js +2 -0
  410. package/dist/esm/lib/v3/types/private/agent.js.map +1 -0
  411. package/dist/esm/lib/v3/types/private/api.d.ts +11 -0
  412. package/dist/esm/lib/v3/types/private/api.js +2 -0
  413. package/dist/esm/lib/v3/types/private/api.js.map +1 -0
  414. package/dist/esm/lib/v3/types/private/cache.d.ts +128 -0
  415. package/dist/esm/lib/v3/types/private/cache.js +2 -0
  416. package/dist/esm/lib/v3/types/private/cache.js.map +1 -0
  417. package/dist/esm/lib/v3/types/private/evaluator.d.ts +40 -0
  418. package/dist/esm/lib/v3/types/private/evaluator.js +2 -0
  419. package/dist/esm/lib/v3/types/private/evaluator.js.map +1 -0
  420. package/dist/esm/lib/v3/types/private/handlers.d.ts +38 -0
  421. package/dist/esm/lib/v3/types/private/handlers.js +16 -0
  422. package/dist/esm/lib/v3/types/private/handlers.js.map +1 -0
  423. package/dist/esm/lib/v3/types/private/index.d.ts +7 -0
  424. package/dist/esm/lib/v3/types/private/index.js +8 -0
  425. package/dist/esm/lib/v3/types/private/index.js.map +1 -0
  426. package/dist/esm/lib/v3/types/private/internal.d.ts +39 -0
  427. package/dist/esm/lib/v3/types/private/internal.js +2 -0
  428. package/dist/esm/lib/v3/types/private/internal.js.map +1 -0
  429. package/dist/esm/lib/v3/types/private/locator.d.ts +9 -0
  430. package/dist/esm/lib/v3/types/private/locator.js +2 -0
  431. package/dist/esm/lib/v3/types/private/locator.js.map +1 -0
  432. package/dist/esm/lib/v3/types/private/network.d.ts +34 -0
  433. package/dist/esm/lib/v3/types/private/network.js +3 -0
  434. package/dist/esm/lib/v3/types/private/network.js.map +1 -0
  435. package/dist/esm/lib/v3/types/private/shutdown.d.ts +31 -0
  436. package/dist/esm/lib/v3/types/private/shutdown.js +5 -0
  437. package/dist/esm/lib/v3/types/private/shutdown.js.map +1 -0
  438. package/dist/esm/lib/v3/types/private/shutdownErrors.d.ts +12 -0
  439. package/dist/esm/lib/v3/types/private/shutdownErrors.js +22 -0
  440. package/dist/esm/lib/v3/types/private/shutdownErrors.js.map +1 -0
  441. package/dist/esm/lib/v3/types/private/snapshot.d.ts +117 -0
  442. package/dist/esm/lib/v3/types/private/snapshot.js +2 -0
  443. package/dist/esm/lib/v3/types/private/snapshot.js.map +1 -0
  444. package/dist/esm/lib/v3/types/public/agent.d.ts +595 -0
  445. package/dist/esm/lib/v3/types/public/agent.js +15 -0
  446. package/dist/esm/lib/v3/types/public/agent.js.map +1 -0
  447. package/dist/esm/lib/v3/types/public/api.d.ts +1211 -0
  448. package/dist/esm/lib/v3/types/public/api.js +915 -0
  449. package/dist/esm/lib/v3/types/public/api.js.map +1 -0
  450. package/dist/esm/lib/v3/types/public/apiErrors.d.ts +18 -0
  451. package/dist/esm/lib/v3/types/public/apiErrors.js +32 -0
  452. package/dist/esm/lib/v3/types/public/apiErrors.js.map +1 -0
  453. package/dist/esm/lib/v3/types/public/index.d.ts +12 -0
  454. package/dist/esm/lib/v3/types/public/index.js +14 -0
  455. package/dist/esm/lib/v3/types/public/index.js.map +1 -0
  456. package/dist/esm/lib/v3/types/public/locator.d.ts +9 -0
  457. package/dist/esm/lib/v3/types/public/locator.js +2 -0
  458. package/dist/esm/lib/v3/types/public/locator.js.map +1 -0
  459. package/dist/esm/lib/v3/types/public/logs.d.ts +23 -0
  460. package/dist/esm/lib/v3/types/public/logs.js +13 -0
  461. package/dist/esm/lib/v3/types/public/logs.js.map +1 -0
  462. package/dist/esm/lib/v3/types/public/methods.d.ts +56 -0
  463. package/dist/esm/lib/v3/types/public/methods.js +15 -0
  464. package/dist/esm/lib/v3/types/public/methods.js.map +1 -0
  465. package/dist/esm/lib/v3/types/public/metrics.d.ts +27 -0
  466. package/dist/esm/lib/v3/types/public/metrics.js +2 -0
  467. package/dist/esm/lib/v3/types/public/metrics.js.map +1 -0
  468. package/dist/esm/lib/v3/types/public/model.d.ts +65 -0
  469. package/dist/esm/lib/v3/types/public/model.js +2 -0
  470. package/dist/esm/lib/v3/types/public/model.js.map +1 -0
  471. package/dist/esm/lib/v3/types/public/options.d.ts +70 -0
  472. package/dist/esm/lib/v3/types/public/options.js +4 -0
  473. package/dist/esm/lib/v3/types/public/options.js.map +1 -0
  474. package/dist/esm/lib/v3/types/public/page.d.ts +18 -0
  475. package/dist/esm/lib/v3/types/public/page.js +3 -0
  476. package/dist/esm/lib/v3/types/public/page.js.map +1 -0
  477. package/dist/esm/lib/v3/types/public/screenshotTypes.d.ts +25 -0
  478. package/dist/esm/lib/v3/types/public/screenshotTypes.js +2 -0
  479. package/dist/esm/lib/v3/types/public/screenshotTypes.js.map +1 -0
  480. package/dist/esm/lib/v3/types/public/sdkErrors.d.ts +152 -0
  481. package/dist/esm/lib/v3/types/public/sdkErrors.js +305 -0
  482. package/dist/esm/lib/v3/types/public/sdkErrors.js.map +1 -0
  483. package/dist/esm/lib/v3/understudy/a11y/snapshot/a11yTree.d.ts +15 -0
  484. package/dist/esm/lib/v3/understudy/a11y/snapshot/a11yTree.js +196 -0
  485. package/dist/esm/lib/v3/understudy/a11y/snapshot/a11yTree.js.map +1 -0
  486. package/dist/esm/lib/v3/understudy/a11y/snapshot/activeElement.d.ts +8 -0
  487. package/dist/esm/lib/v3/understudy/a11y/snapshot/activeElement.js +121 -0
  488. package/dist/esm/lib/v3/understudy/a11y/snapshot/activeElement.js.map +1 -0
  489. package/dist/esm/lib/v3/understudy/a11y/snapshot/capture.d.ts +77 -0
  490. package/dist/esm/lib/v3/understudy/a11y/snapshot/capture.js +336 -0
  491. package/dist/esm/lib/v3/understudy/a11y/snapshot/capture.js.map +1 -0
  492. package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.d.ts +7 -0
  493. package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js +129 -0
  494. package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js.map +1 -0
  495. package/dist/esm/lib/v3/understudy/a11y/snapshot/domTree.d.ts +46 -0
  496. package/dist/esm/lib/v3/understudy/a11y/snapshot/domTree.js +274 -0
  497. package/dist/esm/lib/v3/understudy/a11y/snapshot/domTree.js.map +1 -0
  498. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.d.ts +24 -0
  499. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.js +216 -0
  500. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.js.map +1 -0
  501. package/dist/esm/lib/v3/understudy/a11y/snapshot/index.d.ts +4 -0
  502. package/dist/esm/lib/v3/understudy/a11y/snapshot/index.js +5 -0
  503. package/dist/esm/lib/v3/understudy/a11y/snapshot/index.js.map +1 -0
  504. package/dist/esm/lib/v3/understudy/a11y/snapshot/sessions.d.ts +16 -0
  505. package/dist/esm/lib/v3/understudy/a11y/snapshot/sessions.js +22 -0
  506. package/dist/esm/lib/v3/understudy/a11y/snapshot/sessions.js.map +1 -0
  507. package/dist/esm/lib/v3/understudy/a11y/snapshot/treeFormatUtils.d.ts +28 -0
  508. package/dist/esm/lib/v3/understudy/a11y/snapshot/treeFormatUtils.js +135 -0
  509. package/dist/esm/lib/v3/understudy/a11y/snapshot/treeFormatUtils.js.map +1 -0
  510. package/dist/esm/lib/v3/understudy/a11y/snapshot/xpathUtils.d.ts +26 -0
  511. package/dist/esm/lib/v3/understudy/a11y/snapshot/xpathUtils.js +102 -0
  512. package/dist/esm/lib/v3/understudy/a11y/snapshot/xpathUtils.js.map +1 -0
  513. package/dist/esm/lib/v3/understudy/a11yInvocation.d.ts +8 -0
  514. package/dist/esm/lib/v3/understudy/a11yInvocation.js +12 -0
  515. package/dist/esm/lib/v3/understudy/a11yInvocation.js.map +1 -0
  516. package/dist/esm/lib/v3/understudy/cdp.d.ts +69 -0
  517. package/dist/esm/lib/v3/understudy/cdp.js +251 -0
  518. package/dist/esm/lib/v3/understudy/cdp.js.map +1 -0
  519. package/dist/esm/lib/v3/understudy/consoleMessage.d.ts +22 -0
  520. package/dist/esm/lib/v3/understudy/consoleMessage.js +66 -0
  521. package/dist/esm/lib/v3/understudy/consoleMessage.js.map +1 -0
  522. package/dist/esm/lib/v3/understudy/context.d.ts +132 -0
  523. package/dist/esm/lib/v3/understudy/context.js +687 -0
  524. package/dist/esm/lib/v3/understudy/context.js.map +1 -0
  525. package/dist/esm/lib/v3/understudy/deepLocator.d.ts +87 -0
  526. package/dist/esm/lib/v3/understudy/deepLocator.js +218 -0
  527. package/dist/esm/lib/v3/understudy/deepLocator.js.map +1 -0
  528. package/dist/esm/lib/v3/understudy/executionContextRegistry.d.ts +15 -0
  529. package/dist/esm/lib/v3/understudy/executionContextRegistry.js +83 -0
  530. package/dist/esm/lib/v3/understudy/executionContextRegistry.js.map +1 -0
  531. package/dist/esm/lib/v3/understudy/fileUploadUtils.d.ts +13 -0
  532. package/dist/esm/lib/v3/understudy/fileUploadUtils.js +81 -0
  533. package/dist/esm/lib/v3/understudy/fileUploadUtils.js.map +1 -0
  534. package/dist/esm/lib/v3/understudy/frame.d.ts +69 -0
  535. package/dist/esm/lib/v3/understudy/frame.js +211 -0
  536. package/dist/esm/lib/v3/understudy/frame.js.map +1 -0
  537. package/dist/esm/lib/v3/understudy/frameLocator.d.ts +50 -0
  538. package/dist/esm/lib/v3/understudy/frameLocator.js +255 -0
  539. package/dist/esm/lib/v3/understudy/frameLocator.js.map +1 -0
  540. package/dist/esm/lib/v3/understudy/frameRegistry.d.ts +101 -0
  541. package/dist/esm/lib/v3/understudy/frameRegistry.js +298 -0
  542. package/dist/esm/lib/v3/understudy/frameRegistry.js.map +1 -0
  543. package/dist/esm/lib/v3/understudy/initScripts.d.ts +2 -0
  544. package/dist/esm/lib/v3/understudy/initScripts.js +33 -0
  545. package/dist/esm/lib/v3/understudy/initScripts.js.map +1 -0
  546. package/dist/esm/lib/v3/understudy/lifecycleWatcher.d.ts +64 -0
  547. package/dist/esm/lib/v3/understudy/lifecycleWatcher.js +245 -0
  548. package/dist/esm/lib/v3/understudy/lifecycleWatcher.js.map +1 -0
  549. package/dist/esm/lib/v3/understudy/locator.d.ts +194 -0
  550. package/dist/esm/lib/v3/understudy/locator.js +753 -0
  551. package/dist/esm/lib/v3/understudy/locator.js.map +1 -0
  552. package/dist/esm/lib/v3/understudy/locatorInvocation.d.ts +8 -0
  553. package/dist/esm/lib/v3/understudy/locatorInvocation.js +12 -0
  554. package/dist/esm/lib/v3/understudy/locatorInvocation.js.map +1 -0
  555. package/dist/esm/lib/v3/understudy/navigationResponseTracker.d.ts +84 -0
  556. package/dist/esm/lib/v3/understudy/navigationResponseTracker.js +224 -0
  557. package/dist/esm/lib/v3/understudy/navigationResponseTracker.js.map +1 -0
  558. package/dist/esm/lib/v3/understudy/networkManager.d.ts +53 -0
  559. package/dist/esm/lib/v3/understudy/networkManager.js +306 -0
  560. package/dist/esm/lib/v3/understudy/networkManager.js.map +1 -0
  561. package/dist/esm/lib/v3/understudy/page.d.ts +354 -0
  562. package/dist/esm/lib/v3/understudy/page.js +1941 -0
  563. package/dist/esm/lib/v3/understudy/page.js.map +1 -0
  564. package/dist/esm/lib/v3/understudy/piercer.d.ts +4 -0
  565. package/dist/esm/lib/v3/understudy/piercer.js +61 -0
  566. package/dist/esm/lib/v3/understudy/piercer.js.map +1 -0
  567. package/dist/esm/lib/v3/understudy/response.d.ts +137 -0
  568. package/dist/esm/lib/v3/understudy/response.js +330 -0
  569. package/dist/esm/lib/v3/understudy/response.js.map +1 -0
  570. package/dist/esm/lib/v3/understudy/screenshotUtils.d.ts +16 -0
  571. package/dist/esm/lib/v3/understudy/screenshotUtils.js +352 -0
  572. package/dist/esm/lib/v3/understudy/screenshotUtils.js.map +1 -0
  573. package/dist/esm/lib/v3/understudy/selectorResolver.d.ts +38 -0
  574. package/dist/esm/lib/v3/understudy/selectorResolver.js +296 -0
  575. package/dist/esm/lib/v3/understudy/selectorResolver.js.map +1 -0
  576. package/dist/esm/lib/v3/v3.d.ts +191 -0
  577. package/dist/esm/lib/v3/v3.js +1572 -0
  578. package/dist/esm/lib/v3/v3.js.map +1 -0
  579. package/dist/esm/lib/v3/zodCompat.d.ts +12 -0
  580. package/dist/esm/lib/v3/zodCompat.js +17 -0
  581. package/dist/esm/lib/v3/zodCompat.js.map +1 -0
  582. package/dist/esm/lib/v3Evaluator.d.ts +19 -0
  583. package/dist/esm/lib/v3Evaluator.js +210 -0
  584. package/dist/esm/lib/v3Evaluator.js.map +1 -0
  585. package/dist/esm/lib/version.d.ts +5 -0
  586. package/dist/esm/lib/version.js +6 -0
  587. package/dist/esm/lib/version.js.map +1 -0
  588. package/dist/esm/package.json +3 -0
  589. package/dist/esm/tests/agent-execution-model.test.js +139 -0
  590. package/dist/esm/tests/agent-execution-model.test.js.map +7 -0
  591. package/dist/esm/tests/browserbase-session-accessors.test.js +101 -0
  592. package/dist/esm/tests/browserbase-session-accessors.test.js.map +7 -0
  593. package/dist/esm/tests/cache-llm-resolution.test.js +187 -0
  594. package/dist/esm/tests/cache-llm-resolution.test.js.map +7 -0
  595. package/dist/esm/tests/helpers/mockCDPSession.js +27 -0
  596. package/dist/esm/tests/helpers/mockCDPSession.js.map +7 -0
  597. package/dist/esm/tests/llm-provider.test.js +57 -0
  598. package/dist/esm/tests/llm-provider.test.js.map +7 -0
  599. package/dist/esm/tests/model-deprecation.test.js +135 -0
  600. package/dist/esm/tests/model-deprecation.test.js.map +7 -0
  601. package/dist/esm/tests/model-utils.test.js +43 -0
  602. package/dist/esm/tests/model-utils.test.js.map +7 -0
  603. package/dist/esm/tests/page-snapshot.test.js +36 -0
  604. package/dist/esm/tests/page-snapshot.test.js.map +7 -0
  605. package/dist/esm/tests/public-api/export-surface.test.js +53 -0
  606. package/dist/esm/tests/public-api/export-surface.test.js.map +7 -0
  607. package/dist/esm/tests/public-api/llm-and-agents.test.js +128 -0
  608. package/dist/esm/tests/public-api/llm-and-agents.test.js.map +7 -0
  609. package/dist/esm/tests/public-api/public-error-types.test.js +71 -0
  610. package/dist/esm/tests/public-api/public-error-types.test.js.map +7 -0
  611. package/dist/esm/tests/public-api/public-types.test.js +74 -0
  612. package/dist/esm/tests/public-api/public-types.test.js.map +7 -0
  613. package/dist/esm/tests/public-api/runtime-utils.test.js +31 -0
  614. package/dist/esm/tests/public-api/runtime-utils.test.js.map +7 -0
  615. package/dist/esm/tests/public-api/schema-utils.test.js +78 -0
  616. package/dist/esm/tests/public-api/schema-utils.test.js.map +7 -0
  617. package/dist/esm/tests/public-api/timeout-error-types.test.js +81 -0
  618. package/dist/esm/tests/public-api/timeout-error-types.test.js.map +7 -0
  619. package/dist/esm/tests/public-api/tool-type-export.test.js +25 -0
  620. package/dist/esm/tests/public-api/tool-type-export.test.js.map +7 -0
  621. package/dist/esm/tests/public-api/v3-core.test.js +82 -0
  622. package/dist/esm/tests/public-api/v3-core.test.js.map +7 -0
  623. package/dist/esm/tests/safety-confirmation.test.js +134 -0
  624. package/dist/esm/tests/safety-confirmation.test.js.map +7 -0
  625. package/dist/esm/tests/snapshot-a11y-resolvers.test.js +348 -0
  626. package/dist/esm/tests/snapshot-a11y-resolvers.test.js.map +7 -0
  627. package/dist/esm/tests/snapshot-a11y-tree-utils.test.js +300 -0
  628. package/dist/esm/tests/snapshot-a11y-tree-utils.test.js.map +7 -0
  629. package/dist/esm/tests/snapshot-capture-orchestration.test.js +381 -0
  630. package/dist/esm/tests/snapshot-capture-orchestration.test.js.map +7 -0
  631. package/dist/esm/tests/snapshot-cbor.test.js +197 -0
  632. package/dist/esm/tests/snapshot-cbor.test.js.map +7 -0
  633. package/dist/esm/tests/snapshot-dom-session-builders.test.js +251 -0
  634. package/dist/esm/tests/snapshot-dom-session-builders.test.js.map +7 -0
  635. package/dist/esm/tests/snapshot-dom-tree-utils.test.js +109 -0
  636. package/dist/esm/tests/snapshot-dom-tree-utils.test.js.map +7 -0
  637. package/dist/esm/tests/snapshot-focus-selectors-utils.test.js +49 -0
  638. package/dist/esm/tests/snapshot-focus-selectors-utils.test.js.map +7 -0
  639. package/dist/esm/tests/snapshot-frame-merge.test.js +391 -0
  640. package/dist/esm/tests/snapshot-frame-merge.test.js.map +7 -0
  641. package/dist/esm/tests/snapshot-tree-format-utils.test.js +113 -0
  642. package/dist/esm/tests/snapshot-tree-format-utils.test.js.map +7 -0
  643. package/dist/esm/tests/snapshot-xpath-utils.test.js +79 -0
  644. package/dist/esm/tests/snapshot-xpath-utils.test.js.map +7 -0
  645. package/dist/esm/tests/timeout-handlers.test.js +850 -0
  646. package/dist/esm/tests/timeout-handlers.test.js.map +7 -0
  647. package/dist/esm/tests/xpath-parser.test.js +317 -0
  648. package/dist/esm/tests/xpath-parser.test.js.map +7 -0
  649. package/dist/esm/tests/xpath-resolver.test.js +73 -0
  650. package/dist/esm/tests/xpath-resolver.test.js.map +7 -0
  651. package/dist/esm/tests/zod-enum-compatibility.test.js +97 -0
  652. package/dist/esm/tests/zod-enum-compatibility.test.js.map +7 -0
  653. package/package.json +37 -24
  654. package/dist/index.d.ts +0 -4363
  655. package/dist/index.js +0 -76530
@@ -0,0 +1,167 @@
1
+ import { test, expect } from "@playwright/test";
2
+ import { V3 } from "../v3.js";
3
+ import { v3TestConfig } from "./v3.config.js";
4
+ test.describe("Page.hover() - mouse hover at coordinates", () => {
5
+ let v3;
6
+ test.beforeEach(async () => {
7
+ v3 = new V3(v3TestConfig);
8
+ await v3.init();
9
+ });
10
+ test.afterEach(async () => {
11
+ await v3?.close?.().catch(() => {
12
+ });
13
+ });
14
+ test("hover triggers mouseover event at coordinates", async () => {
15
+ const page = v3.context.pages()[0];
16
+ await page.goto(
17
+ "data:text/html," + encodeURIComponent(
18
+ `<!doctype html><html><body style="margin: 0; padding: 0;">
19
+ <div id="target"
20
+ style="position: absolute; top: 100px; left: 100px; width: 200px; height: 200px; background: lightblue;"
21
+ onmouseover="this.dataset.hovered='true'"
22
+ onmouseout="this.dataset.hovered='false'">
23
+ Hover Me
24
+ </div>
25
+ </body></html>`
26
+ )
27
+ );
28
+ let hovered = await page.evaluate(() => {
29
+ const el = document.getElementById("target");
30
+ return el?.dataset.hovered === "true";
31
+ });
32
+ expect(hovered).toBe(false);
33
+ await page.hover(200, 200);
34
+ hovered = await page.evaluate(() => {
35
+ const el = document.getElementById("target");
36
+ return el?.dataset.hovered === "true";
37
+ });
38
+ expect(hovered).toBe(true);
39
+ });
40
+ test("hover moves mouse without clicking", async () => {
41
+ const page = v3.context.pages()[0];
42
+ await page.goto(
43
+ "data:text/html," + encodeURIComponent(
44
+ `<!doctype html><html><body style="margin: 0; padding: 0;">
45
+ <button id="btn"
46
+ style="position: absolute; top: 100px; left: 100px; width: 200px; height: 100px;"
47
+ onclick="this.dataset.clicked='true'"
48
+ onmouseover="this.dataset.hovered='true'">
49
+ Click Me
50
+ </button>
51
+ </body></html>`
52
+ )
53
+ );
54
+ await page.hover(200, 150);
55
+ const state = await page.evaluate(() => {
56
+ const btn = document.getElementById("btn");
57
+ return {
58
+ hovered: btn?.dataset.hovered === "true",
59
+ clicked: btn?.dataset.clicked === "true"
60
+ };
61
+ });
62
+ expect(state.hovered).toBe(true);
63
+ expect(state.clicked).toBe(false);
64
+ });
65
+ test("hover returns xpath when requested", async () => {
66
+ const page = v3.context.pages()[0];
67
+ await page.goto(
68
+ "data:text/html," + encodeURIComponent(
69
+ `<!doctype html><html><body style="margin: 0; padding: 0;">
70
+ <div id="target" style="position: absolute; top: 0px; left: 400px; width: 300px; height: 100px; background: blue;">
71
+ Target element
72
+ </div>
73
+ <p style="position: absolute; top: 200px; left: 0px;">Content below</p>
74
+ </body></html>`
75
+ )
76
+ );
77
+ const xpath = await page.hover(550, 50, { returnXpath: true });
78
+ expect(typeof xpath).toBe("string");
79
+ expect(xpath.length).toBeGreaterThan(0);
80
+ expect(xpath.toLowerCase()).toMatch(/div|target/);
81
+ });
82
+ test("hover without returnXpath returns empty string", async () => {
83
+ const page = v3.context.pages()[0];
84
+ await page.goto(
85
+ "data:text/html," + encodeURIComponent(
86
+ `<!doctype html><html><body style="margin: 0; padding: 0;">
87
+ <div style="width: 100px; height: 100px; background: lightblue;">Content</div>
88
+ </body></html>`
89
+ )
90
+ );
91
+ const result = await page.hover(50, 50);
92
+ expect(result).toBe("");
93
+ });
94
+ test("hover triggers CSS :hover styles", async () => {
95
+ const page = v3.context.pages()[0];
96
+ await page.goto(
97
+ "data:text/html," + encodeURIComponent(
98
+ `<!doctype html><html>
99
+ <head>
100
+ <style>
101
+ #hoverable {
102
+ position: absolute;
103
+ top: 100px;
104
+ left: 100px;
105
+ width: 200px;
106
+ height: 200px;
107
+ background: red;
108
+ }
109
+ #hoverable:hover {
110
+ background: green;
111
+ }
112
+ </style>
113
+ </head>
114
+ <body style="margin: 0; padding: 0;">
115
+ <div id="hoverable">Hover to change color</div>
116
+ </body></html>`
117
+ )
118
+ );
119
+ let bgColor = await page.evaluate(() => {
120
+ const el = document.getElementById("hoverable");
121
+ return getComputedStyle(el).backgroundColor;
122
+ });
123
+ expect(bgColor).toBe("rgb(255, 0, 0)");
124
+ await page.hover(200, 200);
125
+ bgColor = await page.evaluate(() => {
126
+ const el = document.getElementById("hoverable");
127
+ return getComputedStyle(el).backgroundColor;
128
+ });
129
+ expect(bgColor).toBe("rgb(0, 128, 0)");
130
+ });
131
+ test("multiple hovers move the mouse correctly", async () => {
132
+ const page = v3.context.pages()[0];
133
+ await page.goto(
134
+ "data:text/html," + encodeURIComponent(
135
+ `<!doctype html><html><body style="margin: 0; padding: 0;">
136
+ <div id="box1"
137
+ style="position: absolute; top: 0; left: 0; width: 100px; height: 100px; background: red;"
138
+ onmouseover="this.dataset.hovered='true'"
139
+ onmouseout="this.dataset.hovered='false'">
140
+ Box 1
141
+ </div>
142
+ <div id="box2"
143
+ style="position: absolute; top: 0; left: 200px; width: 100px; height: 100px; background: blue;"
144
+ onmouseover="this.dataset.hovered='true'"
145
+ onmouseout="this.dataset.hovered='false'">
146
+ Box 2
147
+ </div>
148
+ </body></html>`
149
+ )
150
+ );
151
+ await page.hover(50, 50);
152
+ let state = await page.evaluate(() => ({
153
+ box1: document.getElementById("box1")?.dataset.hovered === "true",
154
+ box2: document.getElementById("box2")?.dataset.hovered === "true"
155
+ }));
156
+ expect(state.box1).toBe(true);
157
+ expect(state.box2).toBe(false);
158
+ await page.hover(250, 50);
159
+ state = await page.evaluate(() => ({
160
+ box1: document.getElementById("box1")?.dataset.hovered === "true",
161
+ box2: document.getElementById("box2")?.dataset.hovered === "true"
162
+ }));
163
+ expect(state.box1).toBe(false);
164
+ expect(state.box2).toBe(true);
165
+ });
166
+ });
167
+ //# sourceMappingURL=page-hover.spec.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../lib/v3/tests/page-hover.spec.ts"],
4
+ "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\n\ntest.describe(\"Page.hover() - mouse hover at coordinates\", () => {\n let v3: V3;\n\n test.beforeEach(async () => {\n v3 = new V3(v3TestConfig);\n await v3.init();\n });\n\n test.afterEach(async () => {\n await v3?.close?.().catch(() => {});\n });\n\n test(\"hover triggers mouseover event at coordinates\", async () => {\n const page = v3.context.pages()[0];\n\n await page.goto(\n \"data:text/html,\" +\n encodeURIComponent(\n `<!doctype html><html><body style=\"margin: 0; padding: 0;\">\n <div id=\"target\" \n style=\"position: absolute; top: 100px; left: 100px; width: 200px; height: 200px; background: lightblue;\"\n onmouseover=\"this.dataset.hovered='true'\"\n onmouseout=\"this.dataset.hovered='false'\">\n Hover Me\n </div>\n </body></html>`,\n ),\n );\n\n // Check initial state\n let hovered = await page.evaluate(() => {\n const el = document.getElementById(\"target\");\n return el?.dataset.hovered === \"true\";\n });\n expect(hovered).toBe(false);\n\n // Hover at coordinates within the target element (200, 200 is center of the div)\n await page.hover(200, 200);\n\n // Verify mouseover was triggered\n hovered = await page.evaluate(() => {\n const el = document.getElementById(\"target\");\n return el?.dataset.hovered === \"true\";\n });\n expect(hovered).toBe(true);\n });\n\n test(\"hover moves mouse without clicking\", async () => {\n const page = v3.context.pages()[0];\n\n await page.goto(\n \"data:text/html,\" +\n encodeURIComponent(\n `<!doctype html><html><body style=\"margin: 0; padding: 0;\">\n <button id=\"btn\" \n style=\"position: absolute; top: 100px; left: 100px; width: 200px; height: 100px;\"\n onclick=\"this.dataset.clicked='true'\"\n onmouseover=\"this.dataset.hovered='true'\">\n Click Me\n </button>\n </body></html>`,\n ),\n );\n\n // Hover over the button\n await page.hover(200, 150);\n\n // Check that hover happened but click did not\n const state = await page.evaluate(() => {\n const btn = document.getElementById(\"btn\");\n return {\n hovered: btn?.dataset.hovered === \"true\",\n clicked: btn?.dataset.clicked === \"true\",\n };\n });\n\n expect(state.hovered).toBe(true);\n expect(state.clicked).toBe(false);\n });\n\n test(\"hover returns xpath when requested\", async () => {\n const page = v3.context.pages()[0];\n\n await page.goto(\n \"data:text/html,\" +\n encodeURIComponent(\n `<!doctype html><html><body style=\"margin: 0; padding: 0;\">\n <div id=\"target\" style=\"position: absolute; top: 0px; left: 400px; width: 300px; height: 100px; background: blue;\">\n Target element\n </div>\n <p style=\"position: absolute; top: 200px; left: 0px;\">Content below</p>\n </body></html>`,\n ),\n );\n\n // Hover at coordinate (550, 50) which should be directly over the target div\n const xpath = await page.hover(550, 50, { returnXpath: true });\n\n // Should return a non-empty xpath string for the element at that coordinate\n expect(typeof xpath).toBe(\"string\");\n expect(xpath.length).toBeGreaterThan(0);\n // Xpath should reference the div\n expect(xpath.toLowerCase()).toMatch(/div|target/);\n });\n\n test(\"hover without returnXpath returns empty string\", async () => {\n const page = v3.context.pages()[0];\n\n await page.goto(\n \"data:text/html,\" +\n encodeURIComponent(\n `<!doctype html><html><body style=\"margin: 0; padding: 0;\">\n <div style=\"width: 100px; height: 100px; background: lightblue;\">Content</div>\n </body></html>`,\n ),\n );\n\n // Hover without returnXpath\n const result = await page.hover(50, 50);\n\n // Should return empty string\n expect(result).toBe(\"\");\n });\n\n test(\"hover triggers CSS :hover styles\", async () => {\n const page = v3.context.pages()[0];\n\n await page.goto(\n \"data:text/html,\" +\n encodeURIComponent(\n `<!doctype html><html>\n <head>\n <style>\n #hoverable {\n position: absolute;\n top: 100px;\n left: 100px;\n width: 200px;\n height: 200px;\n background: red;\n }\n #hoverable:hover {\n background: green;\n }\n </style>\n </head>\n <body style=\"margin: 0; padding: 0;\">\n <div id=\"hoverable\">Hover to change color</div>\n </body></html>`,\n ),\n );\n\n // Get initial background color\n let bgColor = await page.evaluate(() => {\n const el = document.getElementById(\"hoverable\");\n return getComputedStyle(el!).backgroundColor;\n });\n expect(bgColor).toBe(\"rgb(255, 0, 0)\"); // red\n\n // Hover over the element\n await page.hover(200, 200);\n\n // Check that CSS :hover state is applied\n bgColor = await page.evaluate(() => {\n const el = document.getElementById(\"hoverable\");\n return getComputedStyle(el!).backgroundColor;\n });\n expect(bgColor).toBe(\"rgb(0, 128, 0)\"); // green\n });\n\n test(\"multiple hovers move the mouse correctly\", async () => {\n const page = v3.context.pages()[0];\n\n await page.goto(\n \"data:text/html,\" +\n encodeURIComponent(\n `<!doctype html><html><body style=\"margin: 0; padding: 0;\">\n <div id=\"box1\" \n style=\"position: absolute; top: 0; left: 0; width: 100px; height: 100px; background: red;\"\n onmouseover=\"this.dataset.hovered='true'\"\n onmouseout=\"this.dataset.hovered='false'\">\n Box 1\n </div>\n <div id=\"box2\" \n style=\"position: absolute; top: 0; left: 200px; width: 100px; height: 100px; background: blue;\"\n onmouseover=\"this.dataset.hovered='true'\"\n onmouseout=\"this.dataset.hovered='false'\">\n Box 2\n </div>\n </body></html>`,\n ),\n );\n\n // Hover over box1\n await page.hover(50, 50);\n\n let state = await page.evaluate(() => ({\n box1: document.getElementById(\"box1\")?.dataset.hovered === \"true\",\n box2: document.getElementById(\"box2\")?.dataset.hovered === \"true\",\n }));\n\n expect(state.box1).toBe(true);\n expect(state.box2).toBe(false);\n\n // Move hover to box2\n await page.hover(250, 50);\n\n state = await page.evaluate(() => ({\n box1: document.getElementById(\"box1\")?.dataset.hovered === \"true\",\n box2: document.getElementById(\"box2\")?.dataset.hovered === \"true\",\n }));\n\n expect(state.box1).toBe(false);\n expect(state.box2).toBe(true);\n });\n});\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,273 @@
1
+ import { test, expect } from "@playwright/test";
2
+ import { promises as fs } from "fs";
3
+ import * as os from "os";
4
+ import * as path from "path";
5
+ import { V3 } from "../v3.js";
6
+ import { v3TestConfig } from "./v3.config.js";
7
+ import { Frame } from "../understudy/frame.js";
8
+ const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
9
+ test.describe("Page.screenshot options", () => {
10
+ let v3;
11
+ test.beforeEach(async () => {
12
+ v3 = new V3(v3TestConfig);
13
+ await v3.init();
14
+ });
15
+ test.afterEach(async () => {
16
+ await v3?.close?.().catch(() => {
17
+ });
18
+ });
19
+ test("rejects clip combined with fullPage", async () => {
20
+ const page = v3.context.pages()[0];
21
+ await page.goto("data:text/html,<html><body>test</body></html>");
22
+ await expect(
23
+ page.screenshot({
24
+ fullPage: true,
25
+ clip: { x: 0, y: 0, width: 100, height: 100 }
26
+ })
27
+ ).rejects.toThrow(/clip and fullPage/);
28
+ });
29
+ test("rejects unsupported image type", async () => {
30
+ const page = v3.context.pages()[0];
31
+ await page.goto("data:text/html,<html><body>noop</body></html>");
32
+ await expect(
33
+ page.screenshot({
34
+ // @ts-expect-error intentional invalid type for runtime validation
35
+ type: "webp"
36
+ })
37
+ ).rejects.toThrow(/unsupported image type/);
38
+ });
39
+ test("rejects jpeg quality for png screenshots", async () => {
40
+ const page = v3.context.pages()[0];
41
+ await page.goto("data:text/html,<html><body>noop</body></html>");
42
+ await expect(page.screenshot({ type: "png", quality: 50 })).rejects.toThrow(
43
+ /quality option is only valid/
44
+ );
45
+ });
46
+ test("honours timeout option", async () => {
47
+ const page = v3.context.pages()[0];
48
+ await page.goto("data:text/html,<html><body>noop</body></html>");
49
+ const mainFrame = page.mainFrame();
50
+ const originalScreenshot = mainFrame.screenshot.bind(mainFrame);
51
+ mainFrame.screenshot = async () => {
52
+ await wait(50);
53
+ return Buffer.from("late");
54
+ };
55
+ try {
56
+ await expect(page.screenshot({ timeout: 10 })).rejects.toThrow(/timeout/);
57
+ } finally {
58
+ mainFrame.screenshot = originalScreenshot;
59
+ }
60
+ });
61
+ test("applies advanced options and cleans up overlays", async () => {
62
+ const page = v3.context.pages()[0];
63
+ const screenshotTimeout = process.env.CI ? 15e3 : 5e3;
64
+ const testStart = Date.now();
65
+ console.log(
66
+ `[screenshot-test] start ${new Date(testStart).toISOString()} timeout=${screenshotTimeout}`
67
+ );
68
+ const html = `
69
+ <!doctype html>
70
+ <html>
71
+ <head>
72
+ <meta charset="utf-8" />
73
+ <style>
74
+ body { background: #aaccee; margin: 0; height: 100vh; display: flex; flex-direction: column; align-items: flex-start; }
75
+ .mask-target { width: 80px; height: 80px; margin: 40px; background: rgb(0, 180, 60); animation: pulse 1s infinite alternate; }
76
+ @keyframes pulse { from { transform: scale(1); } to { transform: scale(1.2); } }
77
+ </style>
78
+ </head>
79
+ <body>
80
+ <div class="mask-target"></div>
81
+ <div class="mask-target"></div>
82
+ <input id="focus-me" value="focus" />
83
+ <script>document.getElementById('focus-me').focus();</script>
84
+ </body>
85
+ </html>
86
+ `;
87
+ await page.goto("data:text/html," + encodeURIComponent(html));
88
+ console.log(`[screenshot-test] page loaded in ${Date.now() - testStart}ms`);
89
+ const maskLocator = page.locator(".mask-target");
90
+ const tempPath = path.join(
91
+ os.tmpdir(),
92
+ `stagehand-screenshot-${Date.now()}-${Math.random().toString(36).slice(2)}.jpeg`
93
+ );
94
+ console.log(`[screenshot-test] tempPath=${tempPath}`);
95
+ const targetId = page.targetId();
96
+ const screenshotCalls = [];
97
+ const evaluateCalls = [];
98
+ const originalScreenshot = Frame.prototype.screenshot;
99
+ const originalEvaluate = Frame.prototype.evaluate;
100
+ Frame.prototype.screenshot = async function screenshotSpy(options) {
101
+ const frame = this;
102
+ if (frame.pageId === targetId) {
103
+ screenshotCalls.push({ frameId: frame.frameId, options });
104
+ return Buffer.from("stub-image");
105
+ }
106
+ return originalScreenshot.call(this, options);
107
+ };
108
+ Frame.prototype.evaluate = async function evaluateSpy(expression, arg) {
109
+ const frame = this;
110
+ if (frame.pageId === targetId) {
111
+ evaluateCalls.push({ frameId: frame.frameId, arg });
112
+ }
113
+ return originalEvaluate.call(this, expression, arg);
114
+ };
115
+ const internalPage = page;
116
+ const sendCalls = [];
117
+ const originalSend = internalPage.mainSession.send.bind(
118
+ internalPage.mainSession
119
+ );
120
+ internalPage.mainSession.send = async (method, params) => {
121
+ sendCalls.push({ method, params });
122
+ return originalSend(method, params);
123
+ };
124
+ try {
125
+ const maskCount = await maskLocator.count();
126
+ console.log(`[screenshot-test] maskLocator.count=${maskCount}`);
127
+ const buffer = await page.screenshot({
128
+ animations: "disabled",
129
+ caret: "hide",
130
+ clip: { x: 0, y: 0, width: 200, height: 200 },
131
+ mask: [maskLocator],
132
+ maskColor: "rgba(255, 0, 0, 0.4)",
133
+ omitBackground: true,
134
+ path: tempPath,
135
+ quality: 80,
136
+ scale: "css",
137
+ style: "body { border: 3px solid black; }",
138
+ timeout: screenshotTimeout,
139
+ type: "jpeg"
140
+ });
141
+ console.log(
142
+ `[screenshot-test] screenshot returned bytes=${buffer.length} elapsed=${Date.now() - testStart}ms`
143
+ );
144
+ expect(Buffer.isBuffer(buffer)).toBeTruthy();
145
+ expect(screenshotCalls.length).toBeGreaterThanOrEqual(1);
146
+ console.log(
147
+ `[screenshot-test] screenshotCalls=${screenshotCalls.length} evaluateCalls=${evaluateCalls.length} sendCalls=${sendCalls.length}`
148
+ );
149
+ const recorded = screenshotCalls[0]?.options ?? {};
150
+ expect(recorded).toMatchObject({ type: "jpeg", quality: 80 });
151
+ expect(recorded?.clip).toMatchObject({
152
+ x: 0,
153
+ y: 0,
154
+ width: 200,
155
+ height: 200
156
+ });
157
+ if (typeof recorded?.scale === "number") {
158
+ expect(recorded.scale).toBeGreaterThan(0);
159
+ expect(recorded.scale).toBeLessThanOrEqual(2);
160
+ }
161
+ await fs.stat(tempPath);
162
+ const maskNodes = await page.evaluate(
163
+ () => document.querySelectorAll("[data-stagehand-mask]").length
164
+ );
165
+ expect(maskNodes).toBe(0);
166
+ const styleNodes = await page.evaluate(
167
+ () => document.querySelectorAll("[data-stagehand-style]").length
168
+ );
169
+ expect(styleNodes).toBe(0);
170
+ const backgroundCalls = sendCalls.filter(
171
+ (call) => call.method === "Emulation.setDefaultBackgroundColorOverride"
172
+ );
173
+ expect(backgroundCalls.length).toBeGreaterThan(1);
174
+ expect(
175
+ backgroundCalls.some(
176
+ (call) => call.params && typeof call.params === "object" && "color" in call.params
177
+ )
178
+ ).toBeTruthy();
179
+ expect(
180
+ backgroundCalls.some(
181
+ (call) => !call.params || Object.keys(call.params).length === 0
182
+ )
183
+ ).toBeTruthy();
184
+ const cssArgs = evaluateCalls.map((entry) => {
185
+ const value = entry.arg;
186
+ return value?.css ?? null;
187
+ }).filter((css) => typeof css === "string");
188
+ const tokens = evaluateCalls.map((entry) => {
189
+ const arg = entry.arg;
190
+ return arg?.token ?? null;
191
+ }).filter((token) => typeof token === "string");
192
+ expect(tokens.some((token) => token.includes("animations"))).toBeTruthy();
193
+ expect(tokens.some((token) => token.includes("caret"))).toBeTruthy();
194
+ expect(tokens.some((token) => token.includes("custom"))).toBeTruthy();
195
+ expect(
196
+ cssArgs.some((css) => css.includes("border: 3px solid black"))
197
+ ).toBeTruthy();
198
+ const maskCalls = evaluateCalls.filter((entry) => {
199
+ const arg = entry.arg;
200
+ return arg && typeof arg === "object" && "rects" in arg;
201
+ });
202
+ expect(maskCalls.length).toBeGreaterThan(0);
203
+ const rects = maskCalls[0]?.arg?.rects;
204
+ expect(Array.isArray(rects)).toBeTruthy();
205
+ expect(rects.length).toBe(2);
206
+ } finally {
207
+ Frame.prototype.screenshot = originalScreenshot;
208
+ Frame.prototype.evaluate = originalEvaluate;
209
+ internalPage.mainSession.send = originalSend;
210
+ await fs.unlink(tempPath).catch(() => {
211
+ });
212
+ }
213
+ });
214
+ test("masks elements inside dialog top layer", async () => {
215
+ const page = v3.context.pages()[0];
216
+ const html = `
217
+ <!doctype html>
218
+ <html>
219
+ <head>
220
+ <meta charset="utf-8" />
221
+ <style>
222
+ dialog { padding: 16px; border: 2px solid #444; }
223
+ #dialog-input { display: block; width: 160px; height: 32px; }
224
+ </style>
225
+ </head>
226
+ <body>
227
+ <dialog id="dialog">
228
+ <label>Secret <input id="dialog-input" value="top-layer" /></label>
229
+ </dialog>
230
+ <script>
231
+ const dialog = document.getElementById("dialog");
232
+ if (dialog) {
233
+ if (typeof dialog.showModal === "function") {
234
+ try {
235
+ dialog.showModal();
236
+ } catch {
237
+ dialog.setAttribute("open", "");
238
+ }
239
+ } else {
240
+ dialog.setAttribute("open", "");
241
+ }
242
+ }
243
+ </script>
244
+ </body>
245
+ </html>
246
+ `;
247
+ await page.goto("data:text/html," + encodeURIComponent(html));
248
+ const targetId = page.targetId();
249
+ const originalScreenshot = Frame.prototype.screenshot;
250
+ let dialogMaskCount = 0;
251
+ Frame.prototype.screenshot = async function screenshotSpy(options) {
252
+ const frame = this;
253
+ if (frame.pageId === targetId) {
254
+ dialogMaskCount = await frame.evaluate(() => {
255
+ const dialog = document.querySelector("dialog[open]");
256
+ if (!dialog) return 0;
257
+ return dialog.querySelectorAll("[data-stagehand-mask]").length;
258
+ });
259
+ return Buffer.from("stub-image");
260
+ }
261
+ return originalScreenshot.call(this, options);
262
+ };
263
+ try {
264
+ await page.screenshot({
265
+ mask: [page.locator("#dialog-input")]
266
+ });
267
+ expect(dialogMaskCount).toBeGreaterThan(0);
268
+ } finally {
269
+ Frame.prototype.screenshot = originalScreenshot;
270
+ }
271
+ });
272
+ });
273
+ //# sourceMappingURL=page-screenshot.spec.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../lib/v3/tests/page-screenshot.spec.ts"],
4
+ "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { promises as fs } from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport { Frame } from \"../understudy/frame.js\";\n\nconst wait = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));\n\ntest.describe(\"Page.screenshot options\", () => {\n let v3: V3;\n\n test.beforeEach(async () => {\n v3 = new V3(v3TestConfig);\n await v3.init();\n });\n\n test.afterEach(async () => {\n await v3?.close?.().catch(() => {});\n });\n\n test(\"rejects clip combined with fullPage\", async () => {\n const page = v3.context.pages()[0];\n await page.goto(\"data:text/html,<html><body>test</body></html>\");\n\n await expect(\n page.screenshot({\n fullPage: true,\n clip: { x: 0, y: 0, width: 100, height: 100 },\n }),\n ).rejects.toThrow(/clip and fullPage/);\n });\n\n test(\"rejects unsupported image type\", async () => {\n const page = v3.context.pages()[0];\n await page.goto(\"data:text/html,<html><body>noop</body></html>\");\n\n await expect(\n page.screenshot({\n // @ts-expect-error intentional invalid type for runtime validation\n type: \"webp\",\n }),\n ).rejects.toThrow(/unsupported image type/);\n });\n\n test(\"rejects jpeg quality for png screenshots\", async () => {\n const page = v3.context.pages()[0];\n await page.goto(\"data:text/html,<html><body>noop</body></html>\");\n\n await expect(page.screenshot({ type: \"png\", quality: 50 })).rejects.toThrow(\n /quality option is only valid/,\n );\n });\n\n test(\"honours timeout option\", async () => {\n const page = v3.context.pages()[0];\n await page.goto(\"data:text/html,<html><body>noop</body></html>\");\n\n const mainFrame = page.mainFrame();\n const originalScreenshot = mainFrame.screenshot.bind(mainFrame);\n\n (\n mainFrame as typeof mainFrame & {\n screenshot: typeof mainFrame.screenshot;\n }\n ).screenshot = async () => {\n await wait(50);\n return Buffer.from(\"late\");\n };\n\n try {\n await expect(page.screenshot({ timeout: 10 })).rejects.toThrow(/timeout/);\n } finally {\n (\n mainFrame as typeof mainFrame & {\n screenshot: typeof mainFrame.screenshot;\n }\n ).screenshot = originalScreenshot;\n }\n });\n\n test(\"applies advanced options and cleans up overlays\", async () => {\n const page = v3.context.pages()[0];\n const screenshotTimeout = process.env.CI ? 15000 : 5000;\n const testStart = Date.now();\n console.log(\n `[screenshot-test] start ${new Date(testStart).toISOString()} timeout=${screenshotTimeout}`,\n );\n\n const html = `\n <!doctype html>\n <html>\n <head>\n <meta charset=\"utf-8\" />\n <style>\n body { background: #aaccee; margin: 0; height: 100vh; display: flex; flex-direction: column; align-items: flex-start; }\n .mask-target { width: 80px; height: 80px; margin: 40px; background: rgb(0, 180, 60); animation: pulse 1s infinite alternate; }\n @keyframes pulse { from { transform: scale(1); } to { transform: scale(1.2); } }\n </style>\n </head>\n <body>\n <div class=\"mask-target\"></div>\n <div class=\"mask-target\"></div>\n <input id=\"focus-me\" value=\"focus\" />\n <script>document.getElementById('focus-me').focus();</script>\n </body>\n </html>\n `;\n\n await page.goto(\"data:text/html,\" + encodeURIComponent(html));\n console.log(`[screenshot-test] page loaded in ${Date.now() - testStart}ms`);\n\n const maskLocator = page.locator(\".mask-target\");\n const tempPath = path.join(\n os.tmpdir(),\n `stagehand-screenshot-${Date.now()}-${Math.random().toString(36).slice(2)}.jpeg`,\n );\n console.log(`[screenshot-test] tempPath=${tempPath}`);\n\n const targetId = page.targetId();\n const screenshotCalls: Array<{\n frameId: string;\n options: Parameters<Frame[\"screenshot\"]>[0];\n }> = [];\n const evaluateCalls: Array<{ frameId: string; arg: unknown }> = [];\n const originalScreenshot = Frame.prototype.screenshot;\n const originalEvaluate = Frame.prototype.evaluate;\n\n // Hook Frame.screenshot so we can assert which options reach CDP without writing real data.\n Frame.prototype.screenshot = async function screenshotSpy(options) {\n const frame = this as Frame;\n if (frame.pageId === targetId) {\n screenshotCalls.push({ frameId: frame.frameId, options });\n return Buffer.from(\"stub-image\");\n }\n return originalScreenshot.call(this, options);\n };\n\n // Spy on Frame.evaluate to capture the arguments used to inject CSS/masks.\n Frame.prototype.evaluate = async function evaluateSpy(expression, arg?) {\n const frame = this as Frame;\n if (frame.pageId === targetId) {\n evaluateCalls.push({ frameId: frame.frameId, arg });\n }\n return originalEvaluate.call(this, expression as never, arg);\n } as Frame[\"evaluate\"];\n\n const internalPage = page as unknown as {\n mainSession: {\n send: (method: string, params?: unknown) => Promise<unknown>;\n };\n };\n const sendCalls: Array<{ method: string; params: unknown }> = [];\n const originalSend = internalPage.mainSession.send.bind(\n internalPage.mainSession,\n ) as (method: string, params?: unknown) => Promise<unknown>;\n // Capture background overrides so we can confirm omitBackground toggles on/off.\n internalPage.mainSession.send = async (\n method: string,\n params?: unknown,\n ) => {\n sendCalls.push({ method, params });\n return originalSend(method, params);\n };\n\n try {\n const maskCount = await maskLocator.count();\n console.log(`[screenshot-test] maskLocator.count=${maskCount}`);\n\n const buffer = await page.screenshot({\n animations: \"disabled\",\n caret: \"hide\",\n clip: { x: 0, y: 0, width: 200, height: 200 },\n mask: [maskLocator],\n maskColor: \"rgba(255, 0, 0, 0.4)\",\n omitBackground: true,\n path: tempPath,\n quality: 80,\n scale: \"css\",\n style: \"body { border: 3px solid black; }\",\n timeout: screenshotTimeout,\n type: \"jpeg\",\n });\n console.log(\n `[screenshot-test] screenshot returned bytes=${buffer.length} elapsed=${Date.now() - testStart}ms`,\n );\n\n expect(Buffer.isBuffer(buffer)).toBeTruthy();\n expect(screenshotCalls.length).toBeGreaterThanOrEqual(1);\n console.log(\n `[screenshot-test] screenshotCalls=${screenshotCalls.length} evaluateCalls=${evaluateCalls.length} sendCalls=${sendCalls.length}`,\n );\n const recorded = screenshotCalls[0]?.options ?? {};\n expect(recorded).toMatchObject({ type: \"jpeg\", quality: 80 });\n expect(recorded?.clip).toMatchObject({\n x: 0,\n y: 0,\n width: 200,\n height: 200,\n });\n if (typeof recorded?.scale === \"number\") {\n expect(recorded.scale).toBeGreaterThan(0);\n expect(recorded.scale).toBeLessThanOrEqual(2);\n }\n\n await fs.stat(tempPath);\n\n const maskNodes = await page.evaluate(\n () => document.querySelectorAll(\"[data-stagehand-mask]\").length,\n );\n expect(maskNodes).toBe(0);\n\n const styleNodes = await page.evaluate(\n () => document.querySelectorAll(\"[data-stagehand-style]\").length,\n );\n expect(styleNodes).toBe(0);\n\n const backgroundCalls = sendCalls.filter(\n (call) => call.method === \"Emulation.setDefaultBackgroundColorOverride\",\n );\n expect(backgroundCalls.length).toBeGreaterThan(1);\n expect(\n backgroundCalls.some(\n (call) =>\n call.params &&\n typeof call.params === \"object\" &&\n \"color\" in (call.params as Record<string, unknown>),\n ),\n ).toBeTruthy();\n expect(\n backgroundCalls.some(\n (call) =>\n !call.params ||\n Object.keys(call.params as Record<string, unknown>).length === 0,\n ),\n ).toBeTruthy();\n\n const cssArgs = evaluateCalls\n .map((entry) => {\n const value = entry.arg as { css?: string } | undefined;\n return value?.css ?? null;\n })\n .filter((css): css is string => typeof css === \"string\");\n\n const tokens = evaluateCalls\n .map((entry) => {\n const arg = entry.arg as { token?: string } | undefined;\n return arg?.token ?? null;\n })\n .filter((token): token is string => typeof token === \"string\");\n\n // Tokens include which helper injected the style (animations/caret/custom).\n expect(tokens.some((token) => token.includes(\"animations\"))).toBeTruthy();\n expect(tokens.some((token) => token.includes(\"caret\"))).toBeTruthy();\n expect(tokens.some((token) => token.includes(\"custom\"))).toBeTruthy();\n // Custom style should bubble through so we check the actual CSS text.\n expect(\n cssArgs.some((css) => css.includes(\"border: 3px solid black\")),\n ).toBeTruthy();\n\n const maskCalls = evaluateCalls.filter((entry) => {\n const arg = entry.arg;\n return (\n arg &&\n typeof arg === \"object\" &&\n \"rects\" in (arg as Record<string, unknown>)\n );\n });\n expect(maskCalls.length).toBeGreaterThan(0);\n const rects = (maskCalls[0]?.arg as { rects?: unknown } | undefined)\n ?.rects;\n expect(Array.isArray(rects)).toBeTruthy();\n expect((rects as unknown[]).length).toBe(2);\n } finally {\n Frame.prototype.screenshot = originalScreenshot;\n Frame.prototype.evaluate = originalEvaluate;\n internalPage.mainSession.send = originalSend;\n await fs.unlink(tempPath).catch(() => {});\n }\n });\n\n test(\"masks elements inside dialog top layer\", async () => {\n const page = v3.context.pages()[0];\n\n const html = `\n <!doctype html>\n <html>\n <head>\n <meta charset=\"utf-8\" />\n <style>\n dialog { padding: 16px; border: 2px solid #444; }\n #dialog-input { display: block; width: 160px; height: 32px; }\n </style>\n </head>\n <body>\n <dialog id=\"dialog\">\n <label>Secret <input id=\"dialog-input\" value=\"top-layer\" /></label>\n </dialog>\n <script>\n const dialog = document.getElementById(\"dialog\");\n if (dialog) {\n if (typeof dialog.showModal === \"function\") {\n try {\n dialog.showModal();\n } catch {\n dialog.setAttribute(\"open\", \"\");\n }\n } else {\n dialog.setAttribute(\"open\", \"\");\n }\n }\n </script>\n </body>\n </html>\n `;\n\n await page.goto(\"data:text/html,\" + encodeURIComponent(html));\n\n const targetId = page.targetId();\n const originalScreenshot = Frame.prototype.screenshot;\n let dialogMaskCount = 0;\n\n Frame.prototype.screenshot = async function screenshotSpy(options) {\n const frame = this as Frame;\n if (frame.pageId === targetId) {\n dialogMaskCount = await frame.evaluate(() => {\n const dialog = document.querySelector(\"dialog[open]\");\n if (!dialog) return 0;\n return dialog.querySelectorAll(\"[data-stagehand-mask]\").length;\n });\n return Buffer.from(\"stub-image\");\n }\n return originalScreenshot.call(this, options);\n };\n\n try {\n await page.screenshot({\n mask: [page.locator(\"#dialog-input\")],\n });\n expect(dialogMaskCount).toBeGreaterThan(0);\n } finally {\n Frame.prototype.screenshot = originalScreenshot;\n }\n });\n});\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }