@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-patch.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 (990) hide show
  1. package/dist/cjs/cli.js +183 -0
  2. package/dist/cjs/cli.js.map +7 -0
  3. package/dist/cjs/index.d.ts +1 -0
  4. package/dist/cjs/index.js +24956 -0
  5. package/dist/cjs/index.js.map +7 -0
  6. package/dist/cjs/lib/inference.d.ts +65 -0
  7. package/dist/cjs/lib/inferenceLogUtils.d.ts +12 -0
  8. package/dist/cjs/lib/logger.d.ts +69 -0
  9. package/dist/cjs/lib/modelUtils.d.ts +11 -0
  10. package/dist/cjs/lib/prompt.d.ts +14 -0
  11. package/dist/cjs/lib/utils.d.ts +68 -0
  12. package/dist/cjs/lib/v3/agent/AgentClient.d.ts +19 -0
  13. package/dist/cjs/lib/v3/agent/AgentProvider.d.ts +20 -0
  14. package/dist/cjs/lib/v3/agent/AnthropicCUAClient.d.ts +57 -0
  15. package/dist/cjs/lib/v3/agent/GoogleCUAClient.d.ts +74 -0
  16. package/dist/cjs/lib/v3/agent/MicrosoftCUAClient.d.ts +71 -0
  17. package/dist/cjs/lib/v3/agent/OpenAICUAClient.d.ts +69 -0
  18. package/dist/cjs/lib/v3/agent/prompts/agentSystemPrompt.d.ts +12 -0
  19. package/dist/cjs/lib/v3/agent/tools/act.d.ts +12 -0
  20. package/dist/cjs/lib/v3/agent/tools/ariaTree.d.ts +5 -0
  21. package/dist/cjs/lib/v3/agent/tools/click.d.ts +6 -0
  22. package/dist/cjs/lib/v3/agent/tools/clickAndHold.d.ts +14 -0
  23. package/dist/cjs/lib/v3/agent/tools/dragAndDrop.d.ts +7 -0
  24. package/dist/cjs/lib/v3/agent/tools/extract.d.ts +20 -0
  25. package/dist/cjs/lib/v3/agent/tools/fillFormVision.d.ts +12 -0
  26. package/dist/cjs/lib/v3/agent/tools/fillform.d.ts +12 -0
  27. package/dist/cjs/lib/v3/agent/tools/goto.d.ts +12 -0
  28. package/dist/cjs/lib/v3/agent/tools/index.d.ts +92 -0
  29. package/dist/cjs/lib/v3/agent/tools/keys.d.ts +24 -0
  30. package/dist/cjs/lib/v3/agent/tools/navback.d.ts +6 -0
  31. package/dist/cjs/lib/v3/agent/tools/screenshot.d.ts +6 -0
  32. package/dist/cjs/lib/v3/agent/tools/scroll.d.ts +19 -0
  33. package/dist/cjs/lib/v3/agent/tools/search.d.ts +15 -0
  34. package/dist/cjs/lib/v3/agent/tools/think.d.ts +6 -0
  35. package/dist/cjs/lib/v3/agent/tools/type.d.ts +7 -0
  36. package/dist/cjs/lib/v3/agent/tools/wait.d.ts +5 -0
  37. package/dist/cjs/lib/v3/agent/utils/actionMapping.d.ts +3 -0
  38. package/dist/cjs/lib/v3/agent/utils/coordinateNormalization.d.ts +13 -0
  39. package/dist/cjs/lib/v3/agent/utils/cuaKeyMapping.d.ts +10 -0
  40. package/dist/cjs/lib/v3/agent/utils/googleCustomToolHandler.d.ts +25 -0
  41. package/dist/cjs/lib/v3/agent/utils/handleDoneToolCall.d.ts +22 -0
  42. package/dist/cjs/lib/v3/agent/utils/imageCompression.d.ts +53 -0
  43. package/dist/cjs/lib/v3/agent/utils/messageProcessing.d.ts +12 -0
  44. package/dist/cjs/lib/v3/agent/utils/screenshotHandler.d.ts +10 -0
  45. package/dist/cjs/lib/v3/agent/utils/validateExperimentalFeatures.d.ts +26 -0
  46. package/dist/cjs/lib/v3/agent/utils/xpath.d.ts +11 -0
  47. package/dist/cjs/lib/v3/api.d.ts +86 -0
  48. package/dist/cjs/lib/v3/cache/ActCache.d.ts +23 -0
  49. package/dist/cjs/lib/v3/cache/AgentCache.d.ts +109 -0
  50. package/dist/cjs/lib/v3/cache/CacheStorage.d.ts +17 -0
  51. package/dist/cjs/lib/v3/cache/serverAgentCache.d.ts +7 -0
  52. package/dist/cjs/lib/v3/cache/utils.d.ts +15 -0
  53. package/dist/cjs/lib/v3/cli.d.ts +2 -0
  54. package/dist/cjs/lib/v3/dom/a11yScripts/index.d.ts +11 -0
  55. package/dist/cjs/lib/v3/dom/build/a11yScripts.generated.d.ts +16 -0
  56. package/dist/cjs/lib/v3/dom/build/locatorScripts.generated.d.ts +52 -0
  57. package/dist/cjs/lib/v3/dom/build/reRenderScriptContent.d.ts +1 -0
  58. package/dist/cjs/lib/v3/dom/build/rerender-index.d.ts +0 -0
  59. package/dist/cjs/lib/v3/dom/build/rerender-index.js +1 -0
  60. package/dist/cjs/lib/v3/dom/build/screenshotScripts.generated.d.ts +4 -0
  61. package/dist/cjs/lib/v3/dom/build/scriptV3Content.d.ts +1 -0
  62. package/dist/cjs/lib/v3/dom/build/v3-index.d.ts +0 -0
  63. package/dist/cjs/lib/v3/dom/build/v3-index.js +1 -0
  64. package/dist/cjs/lib/v3/dom/genA11yScripts.d.ts +1 -0
  65. package/dist/cjs/lib/v3/dom/genDomScripts.d.ts +1 -0
  66. package/dist/cjs/lib/v3/dom/genLocatorScripts.d.ts +1 -0
  67. package/dist/cjs/lib/v3/dom/genScreenshotScripts.d.ts +1 -0
  68. package/dist/cjs/lib/v3/dom/index.d.ts +1 -0
  69. package/dist/cjs/lib/v3/dom/locatorScripts/counts.d.ts +15 -0
  70. package/dist/cjs/lib/v3/dom/locatorScripts/index.d.ts +4 -0
  71. package/dist/cjs/lib/v3/dom/locatorScripts/scripts.d.ts +37 -0
  72. package/dist/cjs/lib/v3/dom/locatorScripts/selectors.d.ts +4 -0
  73. package/dist/cjs/lib/v3/dom/locatorScripts/waitForSelector.d.ts +19 -0
  74. package/dist/cjs/lib/v3/dom/locatorScripts/xpathParser.d.ts +76 -0
  75. package/dist/cjs/lib/v3/dom/locatorScripts/xpathResolver.d.ts +9 -0
  76. package/dist/cjs/lib/v3/dom/piercer.entry.d.ts +1 -0
  77. package/dist/cjs/lib/v3/dom/piercer.runtime.d.ts +23 -0
  78. package/dist/cjs/lib/v3/dom/rerenderMissingShadows.entry.d.ts +1 -0
  79. package/dist/cjs/lib/v3/dom/rerenderMissingShadows.runtime.d.ts +1 -0
  80. package/dist/cjs/lib/v3/dom/screenshotScripts/index.d.ts +1 -0
  81. package/dist/cjs/lib/v3/dom/screenshotScripts/resolveMaskRect.d.ts +8 -0
  82. package/dist/cjs/lib/v3/external_clients/aisdk.d.ts +11 -0
  83. package/dist/cjs/lib/v3/external_clients/customOpenAI.d.ts +18 -0
  84. package/dist/cjs/lib/v3/flowLogger.d.ts +139 -0
  85. package/dist/cjs/lib/v3/handlers/actHandler.d.ts +21 -0
  86. package/dist/cjs/lib/v3/handlers/extractHandler.d.ts +31 -0
  87. package/dist/cjs/lib/v3/handlers/handlerUtils/actHandlerUtils.d.ts +24 -0
  88. package/dist/cjs/lib/v3/handlers/handlerUtils/timeoutGuard.d.ts +2 -0
  89. package/dist/cjs/lib/v3/handlers/observeHandler.d.ts +17 -0
  90. package/dist/cjs/lib/v3/handlers/v3AgentHandler.d.ts +32 -0
  91. package/dist/cjs/lib/v3/handlers/v3CuaAgentHandler.d.ts +33 -0
  92. package/dist/cjs/lib/v3/index.d.ts +18 -0
  93. package/dist/cjs/lib/v3/launch/browserbase.d.ts +7 -0
  94. package/dist/cjs/lib/v3/launch/local.d.ts +15 -0
  95. package/dist/cjs/lib/v3/llm/AnthropicClient.d.ts +16 -0
  96. package/dist/cjs/lib/v3/llm/CerebrasClient.d.ts +17 -0
  97. package/dist/cjs/lib/v3/llm/GoogleClient.d.ts +19 -0
  98. package/dist/cjs/lib/v3/llm/GroqClient.d.ts +17 -0
  99. package/dist/cjs/lib/v3/llm/LLMClient.d.ts +121 -0
  100. package/dist/cjs/lib/v3/llm/LLMProvider.d.ts +13 -0
  101. package/dist/cjs/lib/v3/llm/OpenAIClient.d.ts +15 -0
  102. package/dist/cjs/lib/v3/llm/aisdk.d.ts +15 -0
  103. package/dist/cjs/lib/v3/logger.d.ts +9 -0
  104. package/dist/cjs/lib/v3/mcp/connection.d.ts +11 -0
  105. package/dist/cjs/lib/v3/mcp/utils.d.ts +3 -0
  106. package/dist/cjs/lib/v3/shutdown/cleanupLocal.d.ts +14 -0
  107. package/dist/cjs/lib/v3/shutdown/supervisor.d.ts +11 -0
  108. package/dist/cjs/lib/v3/shutdown/supervisorClient.d.ts +15 -0
  109. package/dist/cjs/lib/v3/tests/agent-abort-signal.spec.js +113 -0
  110. package/dist/cjs/lib/v3/tests/agent-abort-signal.spec.js.map +7 -0
  111. package/dist/cjs/lib/v3/tests/agent-cache-self-heal.spec.js +102 -0
  112. package/dist/cjs/lib/v3/tests/agent-cache-self-heal.spec.js.map +7 -0
  113. package/dist/cjs/lib/v3/tests/agent-callbacks.spec.js +374 -0
  114. package/dist/cjs/lib/v3/tests/agent-callbacks.spec.js.map +7 -0
  115. package/dist/cjs/lib/v3/tests/agent-experimental-validation.spec.js +354 -0
  116. package/dist/cjs/lib/v3/tests/agent-experimental-validation.spec.js.map +7 -0
  117. package/dist/cjs/lib/v3/tests/agent-hybrid-mode.spec.js +247 -0
  118. package/dist/cjs/lib/v3/tests/agent-hybrid-mode.spec.js.map +7 -0
  119. package/dist/cjs/lib/v3/tests/agent-message-continuation.spec.js +105 -0
  120. package/dist/cjs/lib/v3/tests/agent-message-continuation.spec.js.map +7 -0
  121. package/dist/cjs/lib/v3/tests/agent-streaming.spec.js +126 -0
  122. package/dist/cjs/lib/v3/tests/agent-streaming.spec.js.map +7 -0
  123. package/dist/cjs/lib/v3/tests/cdp-session-detached.spec.js +44 -0
  124. package/dist/cjs/lib/v3/tests/cdp-session-detached.spec.js.map +7 -0
  125. package/dist/cjs/lib/v3/tests/click-count.spec.js +147 -0
  126. package/dist/cjs/lib/v3/tests/click-count.spec.js.map +7 -0
  127. package/dist/cjs/lib/v3/tests/connect-to-existing-browser.spec.js +54 -0
  128. package/dist/cjs/lib/v3/tests/connect-to-existing-browser.spec.js.map +7 -0
  129. package/dist/cjs/lib/v3/tests/context-addInitScript.spec.js +176 -0
  130. package/dist/cjs/lib/v3/tests/context-addInitScript.spec.js.map +7 -0
  131. package/dist/cjs/lib/v3/tests/default-page-tracking.spec.js +53 -0
  132. package/dist/cjs/lib/v3/tests/default-page-tracking.spec.js.map +7 -0
  133. package/dist/cjs/lib/v3/tests/downloads.spec.js +80 -0
  134. package/dist/cjs/lib/v3/tests/downloads.spec.js.map +7 -0
  135. package/dist/cjs/lib/v3/tests/frame-get-location-and-click.spec.js +53 -0
  136. package/dist/cjs/lib/v3/tests/frame-get-location-and-click.spec.js.map +7 -0
  137. package/dist/cjs/lib/v3/tests/iframe-ctx-addInitScript.spec.js +493 -0
  138. package/dist/cjs/lib/v3/tests/iframe-ctx-addInitScript.spec.js.map +7 -0
  139. package/dist/cjs/lib/v3/tests/keep-alive.child.js +92 -0
  140. package/dist/cjs/lib/v3/tests/keep-alive.child.js.map +7 -0
  141. package/dist/cjs/lib/v3/tests/keep-alive.helpers.js +568 -0
  142. package/dist/cjs/lib/v3/tests/keep-alive.helpers.js.map +7 -0
  143. package/dist/cjs/lib/v3/tests/keep-alive.spec.js +15 -0
  144. package/dist/cjs/lib/v3/tests/keep-alive.spec.js.map +7 -0
  145. package/dist/cjs/lib/v3/tests/keyboard.spec.js +296 -0
  146. package/dist/cjs/lib/v3/tests/keyboard.spec.js.map +7 -0
  147. package/dist/cjs/lib/v3/tests/locator-backend-node-id.spec.js +159 -0
  148. package/dist/cjs/lib/v3/tests/locator-backend-node-id.spec.js.map +7 -0
  149. package/dist/cjs/lib/v3/tests/locator-content-methods.spec.js +191 -0
  150. package/dist/cjs/lib/v3/tests/locator-content-methods.spec.js.map +7 -0
  151. package/dist/cjs/lib/v3/tests/locator-count-iframe.spec.js +108 -0
  152. package/dist/cjs/lib/v3/tests/locator-count-iframe.spec.js.map +7 -0
  153. package/dist/cjs/lib/v3/tests/locator-count.spec.js +71 -0
  154. package/dist/cjs/lib/v3/tests/locator-count.spec.js.map +7 -0
  155. package/dist/cjs/lib/v3/tests/locator-fill.spec.js +118 -0
  156. package/dist/cjs/lib/v3/tests/locator-fill.spec.js.map +7 -0
  157. package/dist/cjs/lib/v3/tests/locator-input-methods.spec.js +136 -0
  158. package/dist/cjs/lib/v3/tests/locator-input-methods.spec.js.map +7 -0
  159. package/dist/cjs/lib/v3/tests/locator-nth.spec.js +157 -0
  160. package/dist/cjs/lib/v3/tests/locator-nth.spec.js.map +7 -0
  161. package/dist/cjs/lib/v3/tests/locator-select-option.spec.js +242 -0
  162. package/dist/cjs/lib/v3/tests/locator-select-option.spec.js.map +7 -0
  163. package/dist/cjs/lib/v3/tests/logger-initialization.spec.js +547 -0
  164. package/dist/cjs/lib/v3/tests/logger-initialization.spec.js.map +7 -0
  165. package/dist/cjs/lib/v3/tests/multi-instance-logger.spec.js +269 -0
  166. package/dist/cjs/lib/v3/tests/multi-instance-logger.spec.js.map +7 -0
  167. package/dist/cjs/lib/v3/tests/nested-div.spec.js +23 -0
  168. package/dist/cjs/lib/v3/tests/nested-div.spec.js.map +7 -0
  169. package/dist/cjs/lib/v3/tests/page-addInitScript.spec.js +90 -0
  170. package/dist/cjs/lib/v3/tests/page-addInitScript.spec.js.map +7 -0
  171. package/dist/cjs/lib/v3/tests/page-console.spec.js +56 -0
  172. package/dist/cjs/lib/v3/tests/page-console.spec.js.map +7 -0
  173. package/dist/cjs/lib/v3/tests/page-drag-and-drop.spec.js +418 -0
  174. package/dist/cjs/lib/v3/tests/page-drag-and-drop.spec.js.map +7 -0
  175. package/dist/cjs/lib/v3/tests/page-goto-response.spec.js +35 -0
  176. package/dist/cjs/lib/v3/tests/page-goto-response.spec.js.map +7 -0
  177. package/dist/cjs/lib/v3/tests/page-hover.spec.js +167 -0
  178. package/dist/cjs/lib/v3/tests/page-hover.spec.js.map +7 -0
  179. package/dist/cjs/lib/v3/tests/page-screenshot.spec.js +295 -0
  180. package/dist/cjs/lib/v3/tests/page-screenshot.spec.js.map +7 -0
  181. package/dist/cjs/lib/v3/tests/page-scroll.spec.js +182 -0
  182. package/dist/cjs/lib/v3/tests/page-scroll.spec.js.map +7 -0
  183. package/dist/cjs/lib/v3/tests/page-send-cdp.spec.js +46 -0
  184. package/dist/cjs/lib/v3/tests/page-send-cdp.spec.js.map +7 -0
  185. package/dist/cjs/lib/v3/tests/perform-understudy-method.spec.js +98 -0
  186. package/dist/cjs/lib/v3/tests/perform-understudy-method.spec.js.map +7 -0
  187. package/dist/cjs/lib/v3/tests/setinputfiles.spec.js +148 -0
  188. package/dist/cjs/lib/v3/tests/setinputfiles.spec.js.map +7 -0
  189. package/dist/cjs/lib/v3/tests/shadow-iframe-oopif.spec.js +156 -0
  190. package/dist/cjs/lib/v3/tests/shadow-iframe-oopif.spec.js.map +7 -0
  191. package/dist/cjs/lib/v3/tests/shadow-iframe-spif.spec.js +156 -0
  192. package/dist/cjs/lib/v3/tests/shadow-iframe-spif.spec.js.map +7 -0
  193. package/dist/cjs/lib/v3/tests/testUtils.js +54 -0
  194. package/dist/cjs/lib/v3/tests/testUtils.js.map +7 -0
  195. package/dist/cjs/lib/v3/tests/text-selector-innermost.spec.js +100 -0
  196. package/dist/cjs/lib/v3/tests/text-selector-innermost.spec.js.map +7 -0
  197. package/dist/cjs/lib/v3/tests/timeouts.spec.js +32 -0
  198. package/dist/cjs/lib/v3/tests/timeouts.spec.js.map +7 -0
  199. package/dist/cjs/lib/v3/tests/user-data-dir.spec.js +65 -0
  200. package/dist/cjs/lib/v3/tests/user-data-dir.spec.js.map +7 -0
  201. package/dist/cjs/lib/v3/tests/v3.config.js +36 -0
  202. package/dist/cjs/lib/v3/tests/v3.config.js.map +7 -0
  203. package/dist/cjs/lib/v3/tests/v3.dynamic.config.js +67 -0
  204. package/dist/cjs/lib/v3/tests/v3.dynamic.config.js.map +7 -0
  205. package/dist/cjs/lib/v3/tests/v3.playwright.config.js +61 -0
  206. package/dist/cjs/lib/v3/tests/v3.playwright.config.js.map +7 -0
  207. package/dist/cjs/lib/v3/tests/wait-for-selector.spec.js +593 -0
  208. package/dist/cjs/lib/v3/tests/wait-for-selector.spec.js.map +7 -0
  209. package/dist/cjs/lib/v3/tests/wait-for-timeout.spec.js +97 -0
  210. package/dist/cjs/lib/v3/tests/wait-for-timeout.spec.js.map +7 -0
  211. package/dist/cjs/lib/v3/tests/xpath-for-location-deep.spec.js +77 -0
  212. package/dist/cjs/lib/v3/tests/xpath-for-location-deep.spec.js.map +7 -0
  213. package/dist/cjs/lib/v3/timeoutConfig.d.ts +2 -0
  214. package/dist/cjs/lib/v3/types/private/agent.d.ts +6 -0
  215. package/dist/cjs/lib/v3/types/private/api.d.ts +11 -0
  216. package/dist/cjs/lib/v3/types/private/cache.d.ts +128 -0
  217. package/dist/cjs/lib/v3/types/private/evaluator.d.ts +40 -0
  218. package/dist/cjs/lib/v3/types/private/handlers.d.ts +38 -0
  219. package/dist/cjs/lib/v3/types/private/index.d.ts +7 -0
  220. package/dist/cjs/lib/v3/types/private/internal.d.ts +39 -0
  221. package/dist/cjs/lib/v3/types/private/locator.d.ts +9 -0
  222. package/dist/cjs/lib/v3/types/private/network.d.ts +34 -0
  223. package/dist/cjs/lib/v3/types/private/shutdown.d.ts +19 -0
  224. package/dist/cjs/lib/v3/types/private/shutdownErrors.d.ts +12 -0
  225. package/dist/cjs/lib/v3/types/private/snapshot.d.ts +117 -0
  226. package/dist/cjs/lib/v3/types/public/agent.d.ts +595 -0
  227. package/dist/cjs/lib/v3/types/public/api.d.ts +1211 -0
  228. package/dist/cjs/lib/v3/types/public/apiErrors.d.ts +18 -0
  229. package/dist/cjs/lib/v3/types/public/index.d.ts +12 -0
  230. package/dist/cjs/lib/v3/types/public/locator.d.ts +9 -0
  231. package/dist/cjs/lib/v3/types/public/logs.d.ts +23 -0
  232. package/dist/cjs/lib/v3/types/public/methods.d.ts +56 -0
  233. package/dist/cjs/lib/v3/types/public/metrics.d.ts +27 -0
  234. package/dist/cjs/lib/v3/types/public/model.d.ts +65 -0
  235. package/dist/cjs/lib/v3/types/public/options.d.ts +70 -0
  236. package/dist/cjs/lib/v3/types/public/page.d.ts +18 -0
  237. package/dist/cjs/lib/v3/types/public/screenshotTypes.d.ts +25 -0
  238. package/dist/cjs/lib/v3/types/public/sdkErrors.d.ts +152 -0
  239. package/dist/cjs/lib/v3/understudy/a11y/snapshot/a11yTree.d.ts +15 -0
  240. package/dist/cjs/lib/v3/understudy/a11y/snapshot/activeElement.d.ts +8 -0
  241. package/dist/cjs/lib/v3/understudy/a11y/snapshot/capture.d.ts +77 -0
  242. package/dist/cjs/lib/v3/understudy/a11y/snapshot/coordinateResolver.d.ts +7 -0
  243. package/dist/cjs/lib/v3/understudy/a11y/snapshot/domTree.d.ts +46 -0
  244. package/dist/cjs/lib/v3/understudy/a11y/snapshot/focusSelectors.d.ts +24 -0
  245. package/dist/cjs/lib/v3/understudy/a11y/snapshot/index.d.ts +4 -0
  246. package/dist/cjs/lib/v3/understudy/a11y/snapshot/sessions.d.ts +16 -0
  247. package/dist/cjs/lib/v3/understudy/a11y/snapshot/treeFormatUtils.d.ts +28 -0
  248. package/dist/cjs/lib/v3/understudy/a11y/snapshot/xpathUtils.d.ts +26 -0
  249. package/dist/cjs/lib/v3/understudy/a11yInvocation.d.ts +8 -0
  250. package/dist/cjs/lib/v3/understudy/cdp.d.ts +69 -0
  251. package/dist/cjs/lib/v3/understudy/consoleMessage.d.ts +22 -0
  252. package/dist/cjs/lib/v3/understudy/context.d.ts +132 -0
  253. package/dist/cjs/lib/v3/understudy/deepLocator.d.ts +87 -0
  254. package/dist/cjs/lib/v3/understudy/executionContextRegistry.d.ts +15 -0
  255. package/dist/cjs/lib/v3/understudy/fileUploadUtils.d.ts +13 -0
  256. package/dist/cjs/lib/v3/understudy/frame.d.ts +69 -0
  257. package/dist/cjs/lib/v3/understudy/frameLocator.d.ts +50 -0
  258. package/dist/cjs/lib/v3/understudy/frameRegistry.d.ts +101 -0
  259. package/dist/cjs/lib/v3/understudy/initScripts.d.ts +2 -0
  260. package/dist/cjs/lib/v3/understudy/lifecycleWatcher.d.ts +64 -0
  261. package/dist/cjs/lib/v3/understudy/locator.d.ts +194 -0
  262. package/dist/cjs/lib/v3/understudy/locatorInvocation.d.ts +8 -0
  263. package/dist/cjs/lib/v3/understudy/navigationResponseTracker.d.ts +84 -0
  264. package/dist/cjs/lib/v3/understudy/networkManager.d.ts +53 -0
  265. package/dist/cjs/lib/v3/understudy/page.d.ts +354 -0
  266. package/dist/cjs/lib/v3/understudy/piercer.d.ts +4 -0
  267. package/dist/cjs/lib/v3/understudy/response.d.ts +137 -0
  268. package/dist/cjs/lib/v3/understudy/screenshotUtils.d.ts +16 -0
  269. package/dist/cjs/lib/v3/understudy/selectorResolver.d.ts +38 -0
  270. package/dist/cjs/lib/v3/v3.d.ts +191 -0
  271. package/dist/cjs/lib/v3/zodCompat.d.ts +12 -0
  272. package/dist/cjs/lib/v3Evaluator.d.ts +19 -0
  273. package/dist/cjs/lib/version.d.ts +5 -0
  274. package/dist/cjs/package.json +3 -0
  275. package/dist/cjs/tests/browserbase-session-accessors.test.js +101 -0
  276. package/dist/cjs/tests/browserbase-session-accessors.test.js.map +7 -0
  277. package/dist/cjs/tests/cache-llm-resolution.test.js +187 -0
  278. package/dist/cjs/tests/cache-llm-resolution.test.js.map +7 -0
  279. package/dist/cjs/tests/helpers/mockCDPSession.js +50 -0
  280. package/dist/cjs/tests/helpers/mockCDPSession.js.map +7 -0
  281. package/dist/cjs/tests/llm-provider.test.js +57 -0
  282. package/dist/cjs/tests/llm-provider.test.js.map +7 -0
  283. package/dist/cjs/tests/model-deprecation.test.js +132 -0
  284. package/dist/cjs/tests/model-deprecation.test.js.map +7 -0
  285. package/dist/cjs/tests/page-snapshot.test.js +58 -0
  286. package/dist/cjs/tests/page-snapshot.test.js.map +7 -0
  287. package/dist/cjs/tests/public-api/export-surface.test.js +76 -0
  288. package/dist/cjs/tests/public-api/export-surface.test.js.map +7 -0
  289. package/dist/cjs/tests/public-api/llm-and-agents.test.js +150 -0
  290. package/dist/cjs/tests/public-api/llm-and-agents.test.js.map +7 -0
  291. package/dist/cjs/tests/public-api/public-error-types.test.js +104 -0
  292. package/dist/cjs/tests/public-api/public-error-types.test.js.map +7 -0
  293. package/dist/cjs/tests/public-api/public-types.test.js +74 -0
  294. package/dist/cjs/tests/public-api/public-types.test.js.map +7 -0
  295. package/dist/cjs/tests/public-api/runtime-utils.test.js +53 -0
  296. package/dist/cjs/tests/public-api/runtime-utils.test.js.map +7 -0
  297. package/dist/cjs/tests/public-api/schema-utils.test.js +100 -0
  298. package/dist/cjs/tests/public-api/schema-utils.test.js.map +7 -0
  299. package/dist/cjs/tests/public-api/timeout-error-types.test.js +103 -0
  300. package/dist/cjs/tests/public-api/timeout-error-types.test.js.map +7 -0
  301. package/dist/cjs/tests/public-api/tool-type-export.test.js +47 -0
  302. package/dist/cjs/tests/public-api/tool-type-export.test.js.map +7 -0
  303. package/dist/cjs/tests/public-api/v3-core.test.js +104 -0
  304. package/dist/cjs/tests/public-api/v3-core.test.js.map +7 -0
  305. package/dist/cjs/tests/safety-confirmation.test.js +134 -0
  306. package/dist/cjs/tests/safety-confirmation.test.js.map +7 -0
  307. package/dist/cjs/tests/snapshot-a11y-resolvers.test.js +370 -0
  308. package/dist/cjs/tests/snapshot-a11y-resolvers.test.js.map +7 -0
  309. package/dist/cjs/tests/snapshot-a11y-tree-utils.test.js +294 -0
  310. package/dist/cjs/tests/snapshot-a11y-tree-utils.test.js.map +7 -0
  311. package/dist/cjs/tests/snapshot-capture-orchestration.test.js +403 -0
  312. package/dist/cjs/tests/snapshot-capture-orchestration.test.js.map +7 -0
  313. package/dist/cjs/tests/snapshot-cbor.test.js +197 -0
  314. package/dist/cjs/tests/snapshot-cbor.test.js.map +7 -0
  315. package/dist/cjs/tests/snapshot-dom-session-builders.test.js +246 -0
  316. package/dist/cjs/tests/snapshot-dom-session-builders.test.js.map +7 -0
  317. package/dist/cjs/tests/snapshot-dom-tree-utils.test.js +104 -0
  318. package/dist/cjs/tests/snapshot-dom-tree-utils.test.js.map +7 -0
  319. package/dist/cjs/tests/snapshot-focus-selectors-utils.test.js +45 -0
  320. package/dist/cjs/tests/snapshot-focus-selectors-utils.test.js.map +7 -0
  321. package/dist/cjs/tests/snapshot-frame-merge.test.js +388 -0
  322. package/dist/cjs/tests/snapshot-frame-merge.test.js.map +7 -0
  323. package/dist/cjs/tests/snapshot-tree-format-utils.test.js +106 -0
  324. package/dist/cjs/tests/snapshot-tree-format-utils.test.js.map +7 -0
  325. package/dist/cjs/tests/snapshot-xpath-utils.test.js +74 -0
  326. package/dist/cjs/tests/snapshot-xpath-utils.test.js.map +7 -0
  327. package/dist/cjs/tests/timeout-handlers.test.js +864 -0
  328. package/dist/cjs/tests/timeout-handlers.test.js.map +7 -0
  329. package/dist/cjs/tests/xpath-parser.test.js +314 -0
  330. package/dist/cjs/tests/xpath-parser.test.js.map +7 -0
  331. package/dist/cjs/tests/xpath-resolver.test.js +70 -0
  332. package/dist/cjs/tests/xpath-resolver.test.js.map +7 -0
  333. package/dist/cjs/tests/zod-enum-compatibility.test.js +119 -0
  334. package/dist/cjs/tests/zod-enum-compatibility.test.js.map +7 -0
  335. package/dist/esm/index.d.ts +3 -0
  336. package/dist/esm/index.js +3 -0
  337. package/dist/esm/lib/inference.d.ts +65 -0
  338. package/dist/esm/lib/inference.js +333 -0
  339. package/dist/esm/lib/inference.js.map +1 -0
  340. package/dist/esm/lib/inferenceLogUtils.d.ts +12 -0
  341. package/dist/esm/lib/inferenceLogUtils.js +92 -0
  342. package/dist/esm/lib/inferenceLogUtils.js.map +1 -0
  343. package/dist/esm/lib/logger.d.ts +69 -0
  344. package/dist/esm/lib/logger.js +323 -0
  345. package/dist/esm/lib/logger.js.map +1 -0
  346. package/dist/esm/lib/modelUtils.d.ts +11 -0
  347. package/dist/esm/lib/modelUtils.js +43 -0
  348. package/dist/esm/lib/modelUtils.js.map +1 -0
  349. package/dist/esm/lib/prompt.d.ts +14 -0
  350. package/dist/esm/lib/prompt.js +230 -0
  351. package/dist/esm/lib/prompt.js.map +1 -0
  352. package/dist/esm/lib/utils.d.ts +68 -0
  353. package/dist/esm/lib/utils.js +654 -0
  354. package/dist/esm/lib/utils.js.map +1 -0
  355. package/dist/esm/lib/v3/agent/AgentClient.d.ts +19 -0
  356. package/dist/esm/lib/v3/agent/AgentClient.js +17 -0
  357. package/dist/esm/lib/v3/agent/AgentClient.js.map +1 -0
  358. package/dist/esm/lib/v3/agent/AgentProvider.d.ts +20 -0
  359. package/dist/esm/lib/v3/agent/AgentProvider.js +77 -0
  360. package/dist/esm/lib/v3/agent/AgentProvider.js.map +1 -0
  361. package/dist/esm/lib/v3/agent/AnthropicCUAClient.d.ts +57 -0
  362. package/dist/esm/lib/v3/agent/AnthropicCUAClient.js +822 -0
  363. package/dist/esm/lib/v3/agent/AnthropicCUAClient.js.map +1 -0
  364. package/dist/esm/lib/v3/agent/GoogleCUAClient.d.ts +74 -0
  365. package/dist/esm/lib/v3/agent/GoogleCUAClient.js +799 -0
  366. package/dist/esm/lib/v3/agent/GoogleCUAClient.js.map +1 -0
  367. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.d.ts +71 -0
  368. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.js +770 -0
  369. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.js.map +1 -0
  370. package/dist/esm/lib/v3/agent/OpenAICUAClient.d.ts +69 -0
  371. package/dist/esm/lib/v3/agent/OpenAICUAClient.js +615 -0
  372. package/dist/esm/lib/v3/agent/OpenAICUAClient.js.map +1 -0
  373. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.d.ts +12 -0
  374. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.js +186 -0
  375. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.js.map +1 -0
  376. package/dist/esm/lib/v3/agent/tools/act.d.ts +12 -0
  377. package/dist/esm/lib/v3/agent/tools/act.js +49 -0
  378. package/dist/esm/lib/v3/agent/tools/act.js.map +1 -0
  379. package/dist/esm/lib/v3/agent/tools/ariaTree.d.ts +5 -0
  380. package/dist/esm/lib/v3/agent/tools/ariaTree.js +31 -0
  381. package/dist/esm/lib/v3/agent/tools/ariaTree.js.map +1 -0
  382. package/dist/esm/lib/v3/agent/tools/click.d.ts +6 -0
  383. package/dist/esm/lib/v3/agent/tools/click.js +104 -0
  384. package/dist/esm/lib/v3/agent/tools/click.js.map +1 -0
  385. package/dist/esm/lib/v3/agent/tools/clickAndHold.d.ts +14 -0
  386. package/dist/esm/lib/v3/agent/tools/clickAndHold.js +68 -0
  387. package/dist/esm/lib/v3/agent/tools/clickAndHold.js.map +1 -0
  388. package/dist/esm/lib/v3/agent/tools/dragAndDrop.d.ts +7 -0
  389. package/dist/esm/lib/v3/agent/tools/dragAndDrop.js +105 -0
  390. package/dist/esm/lib/v3/agent/tools/dragAndDrop.js.map +1 -0
  391. package/dist/esm/lib/v3/agent/tools/extract.d.ts +20 -0
  392. package/dist/esm/lib/v3/agent/tools/extract.js +93 -0
  393. package/dist/esm/lib/v3/agent/tools/extract.js.map +1 -0
  394. package/dist/esm/lib/v3/agent/tools/fillFormVision.d.ts +12 -0
  395. package/dist/esm/lib/v3/agent/tools/fillFormVision.js +143 -0
  396. package/dist/esm/lib/v3/agent/tools/fillFormVision.js.map +1 -0
  397. package/dist/esm/lib/v3/agent/tools/fillform.d.ts +12 -0
  398. package/dist/esm/lib/v3/agent/tools/fillform.js +56 -0
  399. package/dist/esm/lib/v3/agent/tools/fillform.js.map +1 -0
  400. package/dist/esm/lib/v3/agent/tools/goto.d.ts +12 -0
  401. package/dist/esm/lib/v3/agent/tools/goto.js +31 -0
  402. package/dist/esm/lib/v3/agent/tools/goto.js.map +1 -0
  403. package/dist/esm/lib/v3/agent/tools/index.d.ts +92 -0
  404. package/dist/esm/lib/v3/agent/tools/index.js +74 -0
  405. package/dist/esm/lib/v3/agent/tools/index.js.map +1 -0
  406. package/dist/esm/lib/v3/agent/tools/keys.d.ts +24 -0
  407. package/dist/esm/lib/v3/agent/tools/keys.js +60 -0
  408. package/dist/esm/lib/v3/agent/tools/keys.js.map +1 -0
  409. package/dist/esm/lib/v3/agent/tools/navback.d.ts +6 -0
  410. package/dist/esm/lib/v3/agent/tools/navback.js +23 -0
  411. package/dist/esm/lib/v3/agent/tools/navback.js.map +1 -0
  412. package/dist/esm/lib/v3/agent/tools/screenshot.d.ts +6 -0
  413. package/dist/esm/lib/v3/agent/tools/screenshot.js +26 -0
  414. package/dist/esm/lib/v3/agent/tools/screenshot.js.map +1 -0
  415. package/dist/esm/lib/v3/agent/tools/scroll.d.ts +19 -0
  416. package/dist/esm/lib/v3/agent/tools/scroll.js +142 -0
  417. package/dist/esm/lib/v3/agent/tools/scroll.js.map +1 -0
  418. package/dist/esm/lib/v3/agent/tools/search.d.ts +15 -0
  419. package/dist/esm/lib/v3/agent/tools/search.js +73 -0
  420. package/dist/esm/lib/v3/agent/tools/search.js.map +1 -0
  421. package/dist/esm/lib/v3/agent/tools/think.d.ts +6 -0
  422. package/dist/esm/lib/v3/agent/tools/think.js +24 -0
  423. package/dist/esm/lib/v3/agent/tools/think.js.map +1 -0
  424. package/dist/esm/lib/v3/agent/tools/type.d.ts +7 -0
  425. package/dist/esm/lib/v3/agent/tools/type.js +106 -0
  426. package/dist/esm/lib/v3/agent/tools/type.js.map +1 -0
  427. package/dist/esm/lib/v3/agent/tools/wait.d.ts +5 -0
  428. package/dist/esm/lib/v3/agent/tools/wait.js +53 -0
  429. package/dist/esm/lib/v3/agent/tools/wait.js.map +1 -0
  430. package/dist/esm/lib/v3/agent/utils/actionMapping.d.ts +3 -0
  431. package/dist/esm/lib/v3/agent/utils/actionMapping.js +100 -0
  432. package/dist/esm/lib/v3/agent/utils/actionMapping.js.map +1 -0
  433. package/dist/esm/lib/v3/agent/utils/coordinateNormalization.d.ts +13 -0
  434. package/dist/esm/lib/v3/agent/utils/coordinateNormalization.js +28 -0
  435. package/dist/esm/lib/v3/agent/utils/coordinateNormalization.js.map +1 -0
  436. package/dist/esm/lib/v3/agent/utils/cuaKeyMapping.d.ts +10 -0
  437. package/dist/esm/lib/v3/agent/utils/cuaKeyMapping.js +62 -0
  438. package/dist/esm/lib/v3/agent/utils/cuaKeyMapping.js.map +1 -0
  439. package/dist/esm/lib/v3/agent/utils/googleCustomToolHandler.d.ts +25 -0
  440. package/dist/esm/lib/v3/agent/utils/googleCustomToolHandler.js +145 -0
  441. package/dist/esm/lib/v3/agent/utils/googleCustomToolHandler.js.map +1 -0
  442. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.d.ts +22 -0
  443. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.js +101 -0
  444. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.js.map +1 -0
  445. package/dist/esm/lib/v3/agent/utils/imageCompression.d.ts +53 -0
  446. package/dist/esm/lib/v3/agent/utils/imageCompression.js +204 -0
  447. package/dist/esm/lib/v3/agent/utils/imageCompression.js.map +1 -0
  448. package/dist/esm/lib/v3/agent/utils/messageProcessing.d.ts +12 -0
  449. package/dist/esm/lib/v3/agent/utils/messageProcessing.js +164 -0
  450. package/dist/esm/lib/v3/agent/utils/messageProcessing.js.map +1 -0
  451. package/dist/esm/lib/v3/agent/utils/screenshotHandler.d.ts +10 -0
  452. package/dist/esm/lib/v3/agent/utils/screenshotHandler.js +26 -0
  453. package/dist/esm/lib/v3/agent/utils/screenshotHandler.js.map +1 -0
  454. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.d.ts +26 -0
  455. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.js +79 -0
  456. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.js.map +1 -0
  457. package/dist/esm/lib/v3/agent/utils/xpath.d.ts +11 -0
  458. package/dist/esm/lib/v3/agent/utils/xpath.js +19 -0
  459. package/dist/esm/lib/v3/agent/utils/xpath.js.map +1 -0
  460. package/dist/esm/lib/v3/api.d.ts +86 -0
  461. package/dist/esm/lib/v3/api.js +484 -0
  462. package/dist/esm/lib/v3/api.js.map +1 -0
  463. package/dist/esm/lib/v3/cache/ActCache.d.ts +23 -0
  464. package/dist/esm/lib/v3/cache/ActCache.js +292 -0
  465. package/dist/esm/lib/v3/cache/ActCache.js.map +1 -0
  466. package/dist/esm/lib/v3/cache/AgentCache.d.ts +109 -0
  467. package/dist/esm/lib/v3/cache/AgentCache.js +640 -0
  468. package/dist/esm/lib/v3/cache/AgentCache.js.map +1 -0
  469. package/dist/esm/lib/v3/cache/CacheStorage.d.ts +17 -0
  470. package/dist/esm/lib/v3/cache/CacheStorage.js +98 -0
  471. package/dist/esm/lib/v3/cache/CacheStorage.js.map +1 -0
  472. package/dist/esm/lib/v3/cache/serverAgentCache.d.ts +7 -0
  473. package/dist/esm/lib/v3/cache/serverAgentCache.js +49 -0
  474. package/dist/esm/lib/v3/cache/serverAgentCache.js.map +1 -0
  475. package/dist/esm/lib/v3/cache/utils.d.ts +15 -0
  476. package/dist/esm/lib/v3/cache/utils.js +39 -0
  477. package/dist/esm/lib/v3/cache/utils.js.map +1 -0
  478. package/dist/esm/lib/v3/cli.d.ts +2 -0
  479. package/dist/esm/lib/v3/cli.js +10 -0
  480. package/dist/esm/lib/v3/cli.js.map +1 -0
  481. package/dist/esm/lib/v3/dom/a11yScripts/index.d.ts +11 -0
  482. package/dist/esm/lib/v3/dom/a11yScripts/index.js +117 -0
  483. package/dist/esm/lib/v3/dom/a11yScripts/index.js.map +1 -0
  484. package/dist/esm/lib/v3/dom/build/a11yScripts.generated.d.ts +16 -0
  485. package/dist/esm/lib/v3/dom/build/a11yScripts.generated.js +20 -0
  486. package/dist/esm/lib/v3/dom/build/a11yScripts.generated.js.map +1 -0
  487. package/dist/esm/lib/v3/dom/build/locatorScripts.generated.d.ts +52 -0
  488. package/dist/esm/lib/v3/dom/build/locatorScripts.generated.js +56 -0
  489. package/dist/esm/lib/v3/dom/build/locatorScripts.generated.js.map +1 -0
  490. package/dist/esm/lib/v3/dom/build/reRenderScriptContent.d.ts +1 -0
  491. package/dist/esm/lib/v3/dom/build/reRenderScriptContent.js +2 -0
  492. package/dist/esm/lib/v3/dom/build/reRenderScriptContent.js.map +1 -0
  493. package/dist/esm/lib/v3/dom/build/rerender-index.d.ts +0 -0
  494. package/dist/esm/lib/v3/dom/build/rerender-index.js +1 -0
  495. package/dist/esm/lib/v3/dom/build/rerender-index.js.map +1 -0
  496. package/dist/esm/lib/v3/dom/build/screenshotScripts.generated.d.ts +4 -0
  497. package/dist/esm/lib/v3/dom/build/screenshotScripts.generated.js +8 -0
  498. package/dist/esm/lib/v3/dom/build/screenshotScripts.generated.js.map +1 -0
  499. package/dist/esm/lib/v3/dom/build/scriptV3Content.d.ts +1 -0
  500. package/dist/esm/lib/v3/dom/build/scriptV3Content.js +2 -0
  501. package/dist/esm/lib/v3/dom/build/scriptV3Content.js.map +1 -0
  502. package/dist/esm/lib/v3/dom/build/v3-index.d.ts +0 -0
  503. package/dist/esm/lib/v3/dom/build/v3-index.js +1 -0
  504. package/dist/esm/lib/v3/dom/build/v3-index.js.map +1 -0
  505. package/dist/esm/lib/v3/dom/genA11yScripts.d.ts +1 -0
  506. package/dist/esm/lib/v3/dom/genA11yScripts.js +54 -0
  507. package/dist/esm/lib/v3/dom/genA11yScripts.js.map +1 -0
  508. package/dist/esm/lib/v3/dom/genDomScripts.d.ts +1 -0
  509. package/dist/esm/lib/v3/dom/genDomScripts.js +38 -0
  510. package/dist/esm/lib/v3/dom/genDomScripts.js.map +1 -0
  511. package/dist/esm/lib/v3/dom/genLocatorScripts.d.ts +1 -0
  512. package/dist/esm/lib/v3/dom/genLocatorScripts.js +51 -0
  513. package/dist/esm/lib/v3/dom/genLocatorScripts.js.map +1 -0
  514. package/dist/esm/lib/v3/dom/genScreenshotScripts.d.ts +1 -0
  515. package/dist/esm/lib/v3/dom/genScreenshotScripts.js +37 -0
  516. package/dist/esm/lib/v3/dom/genScreenshotScripts.js.map +1 -0
  517. package/dist/esm/lib/v3/dom/index.d.ts +1 -0
  518. package/dist/esm/lib/v3/dom/index.js +2 -0
  519. package/dist/esm/lib/v3/dom/index.js.map +1 -0
  520. package/dist/esm/lib/v3/dom/locatorScripts/counts.d.ts +15 -0
  521. package/dist/esm/lib/v3/dom/locatorScripts/counts.js +272 -0
  522. package/dist/esm/lib/v3/dom/locatorScripts/counts.js.map +1 -0
  523. package/dist/esm/lib/v3/dom/locatorScripts/index.d.ts +4 -0
  524. package/dist/esm/lib/v3/dom/locatorScripts/index.js +5 -0
  525. package/dist/esm/lib/v3/dom/locatorScripts/index.js.map +1 -0
  526. package/dist/esm/lib/v3/dom/locatorScripts/scripts.d.ts +37 -0
  527. package/dist/esm/lib/v3/dom/locatorScripts/scripts.js +458 -0
  528. package/dist/esm/lib/v3/dom/locatorScripts/scripts.js.map +1 -0
  529. package/dist/esm/lib/v3/dom/locatorScripts/selectors.d.ts +4 -0
  530. package/dist/esm/lib/v3/dom/locatorScripts/selectors.js +283 -0
  531. package/dist/esm/lib/v3/dom/locatorScripts/selectors.js.map +1 -0
  532. package/dist/esm/lib/v3/dom/locatorScripts/waitForSelector.d.ts +19 -0
  533. package/dist/esm/lib/v3/dom/locatorScripts/waitForSelector.js +283 -0
  534. package/dist/esm/lib/v3/dom/locatorScripts/waitForSelector.js.map +1 -0
  535. package/dist/esm/lib/v3/dom/locatorScripts/xpathParser.d.ts +76 -0
  536. package/dist/esm/lib/v3/dom/locatorScripts/xpathParser.js +376 -0
  537. package/dist/esm/lib/v3/dom/locatorScripts/xpathParser.js.map +1 -0
  538. package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.d.ts +9 -0
  539. package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.js +196 -0
  540. package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.js.map +1 -0
  541. package/dist/esm/lib/v3/dom/piercer.entry.d.ts +1 -0
  542. package/dist/esm/lib/v3/dom/piercer.entry.js +3 -0
  543. package/dist/esm/lib/v3/dom/piercer.entry.js.map +1 -0
  544. package/dist/esm/lib/v3/dom/piercer.runtime.d.ts +23 -0
  545. package/dist/esm/lib/v3/dom/piercer.runtime.js +90 -0
  546. package/dist/esm/lib/v3/dom/piercer.runtime.js.map +1 -0
  547. package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.d.ts +1 -0
  548. package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.js +3 -0
  549. package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.js.map +1 -0
  550. package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.d.ts +1 -0
  551. package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.js +40 -0
  552. package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.js.map +1 -0
  553. package/dist/esm/lib/v3/dom/screenshotScripts/index.d.ts +1 -0
  554. package/dist/esm/lib/v3/dom/screenshotScripts/index.js +2 -0
  555. package/dist/esm/lib/v3/dom/screenshotScripts/index.js.map +1 -0
  556. package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.d.ts +8 -0
  557. package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.js +82 -0
  558. package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.js.map +1 -0
  559. package/dist/esm/lib/v3/external_clients/aisdk.d.ts +11 -0
  560. package/dist/esm/lib/v3/external_clients/aisdk.js +103 -0
  561. package/dist/esm/lib/v3/external_clients/aisdk.js.map +1 -0
  562. package/dist/esm/lib/v3/external_clients/customOpenAI.d.ts +18 -0
  563. package/dist/esm/lib/v3/external_clients/customOpenAI.js +220 -0
  564. package/dist/esm/lib/v3/external_clients/customOpenAI.js.map +1 -0
  565. package/dist/esm/lib/v3/flowLogger.d.ts +139 -0
  566. package/dist/esm/lib/v3/flowLogger.js +868 -0
  567. package/dist/esm/lib/v3/flowLogger.js.map +1 -0
  568. package/dist/esm/lib/v3/handlers/actHandler.d.ts +21 -0
  569. package/dist/esm/lib/v3/handlers/actHandler.js +340 -0
  570. package/dist/esm/lib/v3/handlers/actHandler.js.map +1 -0
  571. package/dist/esm/lib/v3/handlers/extractHandler.d.ts +31 -0
  572. package/dist/esm/lib/v3/handlers/extractHandler.js +139 -0
  573. package/dist/esm/lib/v3/handlers/extractHandler.js.map +1 -0
  574. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.d.ts +24 -0
  575. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.js +623 -0
  576. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.js.map +1 -0
  577. package/dist/esm/lib/v3/handlers/handlerUtils/timeoutGuard.d.ts +2 -0
  578. package/dist/esm/lib/v3/handlers/handlerUtils/timeoutGuard.js +14 -0
  579. package/dist/esm/lib/v3/handlers/handlerUtils/timeoutGuard.js.map +1 -0
  580. package/dist/esm/lib/v3/handlers/observeHandler.d.ts +17 -0
  581. package/dist/esm/lib/v3/handlers/observeHandler.js +156 -0
  582. package/dist/esm/lib/v3/handlers/observeHandler.js.map +1 -0
  583. package/dist/esm/lib/v3/handlers/v3AgentHandler.d.ts +32 -0
  584. package/dist/esm/lib/v3/handlers/v3AgentHandler.js +461 -0
  585. package/dist/esm/lib/v3/handlers/v3AgentHandler.js.map +1 -0
  586. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.d.ts +33 -0
  587. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.js +528 -0
  588. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.js.map +1 -0
  589. package/dist/esm/lib/v3/index.d.ts +18 -0
  590. package/dist/esm/lib/v3/index.js +14 -0
  591. package/dist/esm/lib/v3/index.js.map +1 -0
  592. package/dist/esm/lib/v3/launch/browserbase.d.ts +7 -0
  593. package/dist/esm/lib/v3/launch/browserbase.js +46 -0
  594. package/dist/esm/lib/v3/launch/browserbase.js.map +1 -0
  595. package/dist/esm/lib/v3/launch/local.d.ts +15 -0
  596. package/dist/esm/lib/v3/launch/local.js +98 -0
  597. package/dist/esm/lib/v3/launch/local.js.map +1 -0
  598. package/dist/esm/lib/v3/llm/AnthropicClient.d.ts +16 -0
  599. package/dist/esm/lib/v3/llm/AnthropicClient.js +239 -0
  600. package/dist/esm/lib/v3/llm/AnthropicClient.js.map +1 -0
  601. package/dist/esm/lib/v3/llm/CerebrasClient.d.ts +17 -0
  602. package/dist/esm/lib/v3/llm/CerebrasClient.js +235 -0
  603. package/dist/esm/lib/v3/llm/CerebrasClient.js.map +1 -0
  604. package/dist/esm/lib/v3/llm/GoogleClient.d.ts +19 -0
  605. package/dist/esm/lib/v3/llm/GoogleClient.js +369 -0
  606. package/dist/esm/lib/v3/llm/GoogleClient.js.map +1 -0
  607. package/dist/esm/lib/v3/llm/GroqClient.d.ts +17 -0
  608. package/dist/esm/lib/v3/llm/GroqClient.js +236 -0
  609. package/dist/esm/lib/v3/llm/GroqClient.js.map +1 -0
  610. package/dist/esm/lib/v3/llm/LLMClient.d.ts +121 -0
  611. package/dist/esm/lib/v3/llm/LLMClient.js +23 -0
  612. package/dist/esm/lib/v3/llm/LLMClient.js.map +1 -0
  613. package/dist/esm/lib/v3/llm/LLMProvider.d.ts +13 -0
  614. package/dist/esm/lib/v3/llm/LLMProvider.js +194 -0
  615. package/dist/esm/lib/v3/llm/LLMProvider.js.map +1 -0
  616. package/dist/esm/lib/v3/llm/OpenAIClient.d.ts +15 -0
  617. package/dist/esm/lib/v3/llm/OpenAIClient.js +329 -0
  618. package/dist/esm/lib/v3/llm/OpenAIClient.js.map +1 -0
  619. package/dist/esm/lib/v3/llm/aisdk.d.ts +15 -0
  620. package/dist/esm/lib/v3/llm/aisdk.js +348 -0
  621. package/dist/esm/lib/v3/llm/aisdk.js.map +1 -0
  622. package/dist/esm/lib/v3/logger.d.ts +9 -0
  623. package/dist/esm/lib/v3/logger.js +96 -0
  624. package/dist/esm/lib/v3/logger.js.map +1 -0
  625. package/dist/esm/lib/v3/mcp/connection.d.ts +11 -0
  626. package/dist/esm/lib/v3/mcp/connection.js +49 -0
  627. package/dist/esm/lib/v3/mcp/connection.js.map +1 -0
  628. package/dist/esm/lib/v3/mcp/utils.d.ts +3 -0
  629. package/dist/esm/lib/v3/mcp/utils.js +36 -0
  630. package/dist/esm/lib/v3/mcp/utils.js.map +1 -0
  631. package/dist/esm/lib/v3/shutdown/cleanupLocal.d.ts +14 -0
  632. package/dist/esm/lib/v3/shutdown/cleanupLocal.js +30 -0
  633. package/dist/esm/lib/v3/shutdown/cleanupLocal.js.map +1 -0
  634. package/dist/esm/lib/v3/shutdown/supervisor.d.ts +11 -0
  635. package/dist/esm/lib/v3/shutdown/supervisor.js +166 -0
  636. package/dist/esm/lib/v3/shutdown/supervisor.js.map +1 -0
  637. package/dist/esm/lib/v3/shutdown/supervisorClient.d.ts +15 -0
  638. package/dist/esm/lib/v3/shutdown/supervisorClient.js +93 -0
  639. package/dist/esm/lib/v3/shutdown/supervisorClient.js.map +1 -0
  640. package/dist/esm/lib/v3/tests/agent-abort-signal.spec.js +113 -0
  641. package/dist/esm/lib/v3/tests/agent-abort-signal.spec.js.map +7 -0
  642. package/dist/esm/lib/v3/tests/agent-cache-self-heal.spec.js +80 -0
  643. package/dist/esm/lib/v3/tests/agent-cache-self-heal.spec.js.map +7 -0
  644. package/dist/esm/lib/v3/tests/agent-callbacks.spec.js +374 -0
  645. package/dist/esm/lib/v3/tests/agent-callbacks.spec.js.map +7 -0
  646. package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js +357 -0
  647. package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js.map +7 -0
  648. package/dist/esm/lib/v3/tests/agent-hybrid-mode.spec.js +247 -0
  649. package/dist/esm/lib/v3/tests/agent-hybrid-mode.spec.js.map +7 -0
  650. package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js +105 -0
  651. package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js.map +7 -0
  652. package/dist/esm/lib/v3/tests/agent-streaming.spec.js +126 -0
  653. package/dist/esm/lib/v3/tests/agent-streaming.spec.js.map +7 -0
  654. package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js +44 -0
  655. package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js.map +7 -0
  656. package/dist/esm/lib/v3/tests/click-count.spec.js +147 -0
  657. package/dist/esm/lib/v3/tests/click-count.spec.js.map +7 -0
  658. package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js +54 -0
  659. package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js.map +7 -0
  660. package/dist/esm/lib/v3/tests/context-addInitScript.spec.js +176 -0
  661. package/dist/esm/lib/v3/tests/context-addInitScript.spec.js.map +7 -0
  662. package/dist/esm/lib/v3/tests/default-page-tracking.spec.js +53 -0
  663. package/dist/esm/lib/v3/tests/default-page-tracking.spec.js.map +7 -0
  664. package/dist/esm/lib/v3/tests/downloads.spec.js +58 -0
  665. package/dist/esm/lib/v3/tests/downloads.spec.js.map +7 -0
  666. package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js +53 -0
  667. package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js.map +7 -0
  668. package/dist/esm/lib/v3/tests/iframe-ctx-addInitScript.spec.js +493 -0
  669. package/dist/esm/lib/v3/tests/iframe-ctx-addInitScript.spec.js.map +7 -0
  670. package/dist/esm/lib/v3/tests/keep-alive.child.js +92 -0
  671. package/dist/esm/lib/v3/tests/keep-alive.child.js.map +7 -0
  672. package/dist/esm/lib/v3/tests/keep-alive.helpers.js +532 -0
  673. package/dist/esm/lib/v3/tests/keep-alive.helpers.js.map +7 -0
  674. package/dist/esm/lib/v3/tests/keep-alive.spec.js +19 -0
  675. package/dist/esm/lib/v3/tests/keep-alive.spec.js.map +7 -0
  676. package/dist/esm/lib/v3/tests/keyboard.spec.js +296 -0
  677. package/dist/esm/lib/v3/tests/keyboard.spec.js.map +7 -0
  678. package/dist/esm/lib/v3/tests/locator-backend-node-id.spec.js +159 -0
  679. package/dist/esm/lib/v3/tests/locator-backend-node-id.spec.js.map +7 -0
  680. package/dist/esm/lib/v3/tests/locator-content-methods.spec.js +191 -0
  681. package/dist/esm/lib/v3/tests/locator-content-methods.spec.js.map +7 -0
  682. package/dist/esm/lib/v3/tests/locator-count-iframe.spec.js +108 -0
  683. package/dist/esm/lib/v3/tests/locator-count-iframe.spec.js.map +7 -0
  684. package/dist/esm/lib/v3/tests/locator-count.spec.js +71 -0
  685. package/dist/esm/lib/v3/tests/locator-count.spec.js.map +7 -0
  686. package/dist/esm/lib/v3/tests/locator-fill.spec.js +118 -0
  687. package/dist/esm/lib/v3/tests/locator-fill.spec.js.map +7 -0
  688. package/dist/esm/lib/v3/tests/locator-input-methods.spec.js +136 -0
  689. package/dist/esm/lib/v3/tests/locator-input-methods.spec.js.map +7 -0
  690. package/dist/esm/lib/v3/tests/locator-nth.spec.js +157 -0
  691. package/dist/esm/lib/v3/tests/locator-nth.spec.js.map +7 -0
  692. package/dist/esm/lib/v3/tests/locator-select-option.spec.js +242 -0
  693. package/dist/esm/lib/v3/tests/locator-select-option.spec.js.map +7 -0
  694. package/dist/esm/lib/v3/tests/logger-initialization.spec.js +552 -0
  695. package/dist/esm/lib/v3/tests/logger-initialization.spec.js.map +7 -0
  696. package/dist/esm/lib/v3/tests/multi-instance-logger.spec.js +269 -0
  697. package/dist/esm/lib/v3/tests/multi-instance-logger.spec.js.map +7 -0
  698. package/dist/esm/lib/v3/tests/nested-div.spec.js +23 -0
  699. package/dist/esm/lib/v3/tests/nested-div.spec.js.map +7 -0
  700. package/dist/esm/lib/v3/tests/page-addInitScript.spec.js +90 -0
  701. package/dist/esm/lib/v3/tests/page-addInitScript.spec.js.map +7 -0
  702. package/dist/esm/lib/v3/tests/page-console.spec.js +56 -0
  703. package/dist/esm/lib/v3/tests/page-console.spec.js.map +7 -0
  704. package/dist/esm/lib/v3/tests/page-drag-and-drop.spec.js +418 -0
  705. package/dist/esm/lib/v3/tests/page-drag-and-drop.spec.js.map +7 -0
  706. package/dist/esm/lib/v3/tests/page-goto-response.spec.js +35 -0
  707. package/dist/esm/lib/v3/tests/page-goto-response.spec.js.map +7 -0
  708. package/dist/esm/lib/v3/tests/page-hover.spec.js +167 -0
  709. package/dist/esm/lib/v3/tests/page-hover.spec.js.map +7 -0
  710. package/dist/esm/lib/v3/tests/page-screenshot.spec.js +273 -0
  711. package/dist/esm/lib/v3/tests/page-screenshot.spec.js.map +7 -0
  712. package/dist/esm/lib/v3/tests/page-scroll.spec.js +182 -0
  713. package/dist/esm/lib/v3/tests/page-scroll.spec.js.map +7 -0
  714. package/dist/esm/lib/v3/tests/page-send-cdp.spec.js +46 -0
  715. package/dist/esm/lib/v3/tests/page-send-cdp.spec.js.map +7 -0
  716. package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js +98 -0
  717. package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js.map +7 -0
  718. package/dist/esm/lib/v3/tests/setinputfiles.spec.js +126 -0
  719. package/dist/esm/lib/v3/tests/setinputfiles.spec.js.map +7 -0
  720. package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js +134 -0
  721. package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js.map +7 -0
  722. package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js +134 -0
  723. package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js.map +7 -0
  724. package/dist/esm/lib/v3/tests/testUtils.js +31 -0
  725. package/dist/esm/lib/v3/tests/testUtils.js.map +7 -0
  726. package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js +100 -0
  727. package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js.map +7 -0
  728. package/dist/esm/lib/v3/tests/timeouts.spec.js +32 -0
  729. package/dist/esm/lib/v3/tests/timeouts.spec.js.map +7 -0
  730. package/dist/esm/lib/v3/tests/user-data-dir.spec.js +43 -0
  731. package/dist/esm/lib/v3/tests/user-data-dir.spec.js.map +7 -0
  732. package/dist/esm/lib/v3/tests/v3.config.js +15 -0
  733. package/dist/esm/lib/v3/tests/v3.config.js.map +7 -0
  734. package/dist/esm/lib/v3/tests/v3.dynamic.config.js +43 -0
  735. package/dist/esm/lib/v3/tests/v3.dynamic.config.js.map +7 -0
  736. package/dist/esm/lib/v3/tests/v3.playwright.config.js +41 -0
  737. package/dist/esm/lib/v3/tests/v3.playwright.config.js.map +7 -0
  738. package/dist/esm/lib/v3/tests/wait-for-selector.spec.js +593 -0
  739. package/dist/esm/lib/v3/tests/wait-for-selector.spec.js.map +7 -0
  740. package/dist/esm/lib/v3/tests/wait-for-timeout.spec.js +97 -0
  741. package/dist/esm/lib/v3/tests/wait-for-timeout.spec.js.map +7 -0
  742. package/dist/esm/lib/v3/tests/xpath-for-location-deep.spec.js +77 -0
  743. package/dist/esm/lib/v3/tests/xpath-for-location-deep.spec.js.map +7 -0
  744. package/dist/esm/lib/v3/timeoutConfig.d.ts +2 -0
  745. package/dist/esm/lib/v3/timeoutConfig.js +27 -0
  746. package/dist/esm/lib/v3/timeoutConfig.js.map +1 -0
  747. package/dist/esm/lib/v3/types/private/agent.d.ts +6 -0
  748. package/dist/esm/lib/v3/types/private/agent.js +2 -0
  749. package/dist/esm/lib/v3/types/private/agent.js.map +1 -0
  750. package/dist/esm/lib/v3/types/private/api.d.ts +11 -0
  751. package/dist/esm/lib/v3/types/private/api.js +2 -0
  752. package/dist/esm/lib/v3/types/private/api.js.map +1 -0
  753. package/dist/esm/lib/v3/types/private/cache.d.ts +128 -0
  754. package/dist/esm/lib/v3/types/private/cache.js +2 -0
  755. package/dist/esm/lib/v3/types/private/cache.js.map +1 -0
  756. package/dist/esm/lib/v3/types/private/evaluator.d.ts +40 -0
  757. package/dist/esm/lib/v3/types/private/evaluator.js +2 -0
  758. package/dist/esm/lib/v3/types/private/evaluator.js.map +1 -0
  759. package/dist/esm/lib/v3/types/private/handlers.d.ts +38 -0
  760. package/dist/esm/lib/v3/types/private/handlers.js +16 -0
  761. package/dist/esm/lib/v3/types/private/handlers.js.map +1 -0
  762. package/dist/esm/lib/v3/types/private/index.d.ts +7 -0
  763. package/dist/esm/lib/v3/types/private/index.js +8 -0
  764. package/dist/esm/lib/v3/types/private/index.js.map +1 -0
  765. package/dist/esm/lib/v3/types/private/internal.d.ts +39 -0
  766. package/dist/esm/lib/v3/types/private/internal.js +2 -0
  767. package/dist/esm/lib/v3/types/private/internal.js.map +1 -0
  768. package/dist/esm/lib/v3/types/private/locator.d.ts +9 -0
  769. package/dist/esm/lib/v3/types/private/locator.js +2 -0
  770. package/dist/esm/lib/v3/types/private/locator.js.map +1 -0
  771. package/dist/esm/lib/v3/types/private/network.d.ts +34 -0
  772. package/dist/esm/lib/v3/types/private/network.js +3 -0
  773. package/dist/esm/lib/v3/types/private/network.js.map +1 -0
  774. package/dist/esm/lib/v3/types/private/shutdown.d.ts +19 -0
  775. package/dist/esm/lib/v3/types/private/shutdown.js +5 -0
  776. package/dist/esm/lib/v3/types/private/shutdown.js.map +1 -0
  777. package/dist/esm/lib/v3/types/private/shutdownErrors.d.ts +12 -0
  778. package/dist/esm/lib/v3/types/private/shutdownErrors.js +22 -0
  779. package/dist/esm/lib/v3/types/private/shutdownErrors.js.map +1 -0
  780. package/dist/esm/lib/v3/types/private/snapshot.d.ts +117 -0
  781. package/dist/esm/lib/v3/types/private/snapshot.js +2 -0
  782. package/dist/esm/lib/v3/types/private/snapshot.js.map +1 -0
  783. package/dist/esm/lib/v3/types/public/agent.d.ts +595 -0
  784. package/dist/esm/lib/v3/types/public/agent.js +15 -0
  785. package/dist/esm/lib/v3/types/public/agent.js.map +1 -0
  786. package/dist/esm/lib/v3/types/public/api.d.ts +1211 -0
  787. package/dist/esm/lib/v3/types/public/api.js +915 -0
  788. package/dist/esm/lib/v3/types/public/api.js.map +1 -0
  789. package/dist/esm/lib/v3/types/public/apiErrors.d.ts +18 -0
  790. package/dist/esm/lib/v3/types/public/apiErrors.js +32 -0
  791. package/dist/esm/lib/v3/types/public/apiErrors.js.map +1 -0
  792. package/dist/esm/lib/v3/types/public/index.d.ts +12 -0
  793. package/dist/esm/lib/v3/types/public/index.js +14 -0
  794. package/dist/esm/lib/v3/types/public/index.js.map +1 -0
  795. package/dist/esm/lib/v3/types/public/locator.d.ts +9 -0
  796. package/dist/esm/lib/v3/types/public/locator.js +2 -0
  797. package/dist/esm/lib/v3/types/public/locator.js.map +1 -0
  798. package/dist/esm/lib/v3/types/public/logs.d.ts +23 -0
  799. package/dist/esm/lib/v3/types/public/logs.js +13 -0
  800. package/dist/esm/lib/v3/types/public/logs.js.map +1 -0
  801. package/dist/esm/lib/v3/types/public/methods.d.ts +56 -0
  802. package/dist/esm/lib/v3/types/public/methods.js +15 -0
  803. package/dist/esm/lib/v3/types/public/methods.js.map +1 -0
  804. package/dist/esm/lib/v3/types/public/metrics.d.ts +27 -0
  805. package/dist/esm/lib/v3/types/public/metrics.js +2 -0
  806. package/dist/esm/lib/v3/types/public/metrics.js.map +1 -0
  807. package/dist/esm/lib/v3/types/public/model.d.ts +65 -0
  808. package/dist/esm/lib/v3/types/public/model.js +2 -0
  809. package/dist/esm/lib/v3/types/public/model.js.map +1 -0
  810. package/dist/esm/lib/v3/types/public/options.d.ts +70 -0
  811. package/dist/esm/lib/v3/types/public/options.js +4 -0
  812. package/dist/esm/lib/v3/types/public/options.js.map +1 -0
  813. package/dist/esm/lib/v3/types/public/page.d.ts +18 -0
  814. package/dist/esm/lib/v3/types/public/page.js +3 -0
  815. package/dist/esm/lib/v3/types/public/page.js.map +1 -0
  816. package/dist/esm/lib/v3/types/public/screenshotTypes.d.ts +25 -0
  817. package/dist/esm/lib/v3/types/public/screenshotTypes.js +2 -0
  818. package/dist/esm/lib/v3/types/public/screenshotTypes.js.map +1 -0
  819. package/dist/esm/lib/v3/types/public/sdkErrors.d.ts +152 -0
  820. package/dist/esm/lib/v3/types/public/sdkErrors.js +305 -0
  821. package/dist/esm/lib/v3/types/public/sdkErrors.js.map +1 -0
  822. package/dist/esm/lib/v3/understudy/a11y/snapshot/a11yTree.d.ts +15 -0
  823. package/dist/esm/lib/v3/understudy/a11y/snapshot/a11yTree.js +196 -0
  824. package/dist/esm/lib/v3/understudy/a11y/snapshot/a11yTree.js.map +1 -0
  825. package/dist/esm/lib/v3/understudy/a11y/snapshot/activeElement.d.ts +8 -0
  826. package/dist/esm/lib/v3/understudy/a11y/snapshot/activeElement.js +121 -0
  827. package/dist/esm/lib/v3/understudy/a11y/snapshot/activeElement.js.map +1 -0
  828. package/dist/esm/lib/v3/understudy/a11y/snapshot/capture.d.ts +77 -0
  829. package/dist/esm/lib/v3/understudy/a11y/snapshot/capture.js +336 -0
  830. package/dist/esm/lib/v3/understudy/a11y/snapshot/capture.js.map +1 -0
  831. package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.d.ts +7 -0
  832. package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js +129 -0
  833. package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js.map +1 -0
  834. package/dist/esm/lib/v3/understudy/a11y/snapshot/domTree.d.ts +46 -0
  835. package/dist/esm/lib/v3/understudy/a11y/snapshot/domTree.js +274 -0
  836. package/dist/esm/lib/v3/understudy/a11y/snapshot/domTree.js.map +1 -0
  837. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.d.ts +24 -0
  838. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.js +216 -0
  839. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.js.map +1 -0
  840. package/dist/esm/lib/v3/understudy/a11y/snapshot/index.d.ts +4 -0
  841. package/dist/esm/lib/v3/understudy/a11y/snapshot/index.js +5 -0
  842. package/dist/esm/lib/v3/understudy/a11y/snapshot/index.js.map +1 -0
  843. package/dist/esm/lib/v3/understudy/a11y/snapshot/sessions.d.ts +16 -0
  844. package/dist/esm/lib/v3/understudy/a11y/snapshot/sessions.js +22 -0
  845. package/dist/esm/lib/v3/understudy/a11y/snapshot/sessions.js.map +1 -0
  846. package/dist/esm/lib/v3/understudy/a11y/snapshot/treeFormatUtils.d.ts +28 -0
  847. package/dist/esm/lib/v3/understudy/a11y/snapshot/treeFormatUtils.js +135 -0
  848. package/dist/esm/lib/v3/understudy/a11y/snapshot/treeFormatUtils.js.map +1 -0
  849. package/dist/esm/lib/v3/understudy/a11y/snapshot/xpathUtils.d.ts +26 -0
  850. package/dist/esm/lib/v3/understudy/a11y/snapshot/xpathUtils.js +102 -0
  851. package/dist/esm/lib/v3/understudy/a11y/snapshot/xpathUtils.js.map +1 -0
  852. package/dist/esm/lib/v3/understudy/a11yInvocation.d.ts +8 -0
  853. package/dist/esm/lib/v3/understudy/a11yInvocation.js +12 -0
  854. package/dist/esm/lib/v3/understudy/a11yInvocation.js.map +1 -0
  855. package/dist/esm/lib/v3/understudy/cdp.d.ts +69 -0
  856. package/dist/esm/lib/v3/understudy/cdp.js +251 -0
  857. package/dist/esm/lib/v3/understudy/cdp.js.map +1 -0
  858. package/dist/esm/lib/v3/understudy/consoleMessage.d.ts +22 -0
  859. package/dist/esm/lib/v3/understudy/consoleMessage.js +66 -0
  860. package/dist/esm/lib/v3/understudy/consoleMessage.js.map +1 -0
  861. package/dist/esm/lib/v3/understudy/context.d.ts +132 -0
  862. package/dist/esm/lib/v3/understudy/context.js +696 -0
  863. package/dist/esm/lib/v3/understudy/context.js.map +1 -0
  864. package/dist/esm/lib/v3/understudy/deepLocator.d.ts +87 -0
  865. package/dist/esm/lib/v3/understudy/deepLocator.js +218 -0
  866. package/dist/esm/lib/v3/understudy/deepLocator.js.map +1 -0
  867. package/dist/esm/lib/v3/understudy/executionContextRegistry.d.ts +15 -0
  868. package/dist/esm/lib/v3/understudy/executionContextRegistry.js +83 -0
  869. package/dist/esm/lib/v3/understudy/executionContextRegistry.js.map +1 -0
  870. package/dist/esm/lib/v3/understudy/fileUploadUtils.d.ts +13 -0
  871. package/dist/esm/lib/v3/understudy/fileUploadUtils.js +81 -0
  872. package/dist/esm/lib/v3/understudy/fileUploadUtils.js.map +1 -0
  873. package/dist/esm/lib/v3/understudy/frame.d.ts +69 -0
  874. package/dist/esm/lib/v3/understudy/frame.js +211 -0
  875. package/dist/esm/lib/v3/understudy/frame.js.map +1 -0
  876. package/dist/esm/lib/v3/understudy/frameLocator.d.ts +50 -0
  877. package/dist/esm/lib/v3/understudy/frameLocator.js +255 -0
  878. package/dist/esm/lib/v3/understudy/frameLocator.js.map +1 -0
  879. package/dist/esm/lib/v3/understudy/frameRegistry.d.ts +101 -0
  880. package/dist/esm/lib/v3/understudy/frameRegistry.js +298 -0
  881. package/dist/esm/lib/v3/understudy/frameRegistry.js.map +1 -0
  882. package/dist/esm/lib/v3/understudy/initScripts.d.ts +2 -0
  883. package/dist/esm/lib/v3/understudy/initScripts.js +33 -0
  884. package/dist/esm/lib/v3/understudy/initScripts.js.map +1 -0
  885. package/dist/esm/lib/v3/understudy/lifecycleWatcher.d.ts +64 -0
  886. package/dist/esm/lib/v3/understudy/lifecycleWatcher.js +245 -0
  887. package/dist/esm/lib/v3/understudy/lifecycleWatcher.js.map +1 -0
  888. package/dist/esm/lib/v3/understudy/locator.d.ts +194 -0
  889. package/dist/esm/lib/v3/understudy/locator.js +753 -0
  890. package/dist/esm/lib/v3/understudy/locator.js.map +1 -0
  891. package/dist/esm/lib/v3/understudy/locatorInvocation.d.ts +8 -0
  892. package/dist/esm/lib/v3/understudy/locatorInvocation.js +12 -0
  893. package/dist/esm/lib/v3/understudy/locatorInvocation.js.map +1 -0
  894. package/dist/esm/lib/v3/understudy/navigationResponseTracker.d.ts +84 -0
  895. package/dist/esm/lib/v3/understudy/navigationResponseTracker.js +224 -0
  896. package/dist/esm/lib/v3/understudy/navigationResponseTracker.js.map +1 -0
  897. package/dist/esm/lib/v3/understudy/networkManager.d.ts +53 -0
  898. package/dist/esm/lib/v3/understudy/networkManager.js +306 -0
  899. package/dist/esm/lib/v3/understudy/networkManager.js.map +1 -0
  900. package/dist/esm/lib/v3/understudy/page.d.ts +354 -0
  901. package/dist/esm/lib/v3/understudy/page.js +1942 -0
  902. package/dist/esm/lib/v3/understudy/page.js.map +1 -0
  903. package/dist/esm/lib/v3/understudy/piercer.d.ts +4 -0
  904. package/dist/esm/lib/v3/understudy/piercer.js +61 -0
  905. package/dist/esm/lib/v3/understudy/piercer.js.map +1 -0
  906. package/dist/esm/lib/v3/understudy/response.d.ts +137 -0
  907. package/dist/esm/lib/v3/understudy/response.js +330 -0
  908. package/dist/esm/lib/v3/understudy/response.js.map +1 -0
  909. package/dist/esm/lib/v3/understudy/screenshotUtils.d.ts +16 -0
  910. package/dist/esm/lib/v3/understudy/screenshotUtils.js +352 -0
  911. package/dist/esm/lib/v3/understudy/screenshotUtils.js.map +1 -0
  912. package/dist/esm/lib/v3/understudy/selectorResolver.d.ts +38 -0
  913. package/dist/esm/lib/v3/understudy/selectorResolver.js +296 -0
  914. package/dist/esm/lib/v3/understudy/selectorResolver.js.map +1 -0
  915. package/dist/esm/lib/v3/v3.d.ts +191 -0
  916. package/dist/esm/lib/v3/v3.js +1569 -0
  917. package/dist/esm/lib/v3/v3.js.map +1 -0
  918. package/dist/esm/lib/v3/zodCompat.d.ts +12 -0
  919. package/dist/esm/lib/v3/zodCompat.js +17 -0
  920. package/dist/esm/lib/v3/zodCompat.js.map +1 -0
  921. package/dist/esm/lib/v3Evaluator.d.ts +19 -0
  922. package/dist/esm/lib/v3Evaluator.js +210 -0
  923. package/dist/esm/lib/v3Evaluator.js.map +1 -0
  924. package/dist/esm/lib/version.d.ts +5 -0
  925. package/dist/esm/lib/version.js +6 -0
  926. package/dist/esm/lib/version.js.map +1 -0
  927. package/dist/esm/package.json +3 -0
  928. package/dist/esm/tests/browserbase-session-accessors.test.js +101 -0
  929. package/dist/esm/tests/browserbase-session-accessors.test.js.map +7 -0
  930. package/dist/esm/tests/cache-llm-resolution.test.js +187 -0
  931. package/dist/esm/tests/cache-llm-resolution.test.js.map +7 -0
  932. package/dist/esm/tests/helpers/mockCDPSession.js +27 -0
  933. package/dist/esm/tests/helpers/mockCDPSession.js.map +7 -0
  934. package/dist/esm/tests/llm-provider.test.js +57 -0
  935. package/dist/esm/tests/llm-provider.test.js.map +7 -0
  936. package/dist/esm/tests/model-deprecation.test.js +135 -0
  937. package/dist/esm/tests/model-deprecation.test.js.map +7 -0
  938. package/dist/esm/tests/page-snapshot.test.js +36 -0
  939. package/dist/esm/tests/page-snapshot.test.js.map +7 -0
  940. package/dist/esm/tests/public-api/export-surface.test.js +54 -0
  941. package/dist/esm/tests/public-api/export-surface.test.js.map +7 -0
  942. package/dist/esm/tests/public-api/llm-and-agents.test.js +128 -0
  943. package/dist/esm/tests/public-api/llm-and-agents.test.js.map +7 -0
  944. package/dist/esm/tests/public-api/public-error-types.test.js +71 -0
  945. package/dist/esm/tests/public-api/public-error-types.test.js.map +7 -0
  946. package/dist/esm/tests/public-api/public-types.test.js +74 -0
  947. package/dist/esm/tests/public-api/public-types.test.js.map +7 -0
  948. package/dist/esm/tests/public-api/runtime-utils.test.js +31 -0
  949. package/dist/esm/tests/public-api/runtime-utils.test.js.map +7 -0
  950. package/dist/esm/tests/public-api/schema-utils.test.js +78 -0
  951. package/dist/esm/tests/public-api/schema-utils.test.js.map +7 -0
  952. package/dist/esm/tests/public-api/timeout-error-types.test.js +81 -0
  953. package/dist/esm/tests/public-api/timeout-error-types.test.js.map +7 -0
  954. package/dist/esm/tests/public-api/tool-type-export.test.js +25 -0
  955. package/dist/esm/tests/public-api/tool-type-export.test.js.map +7 -0
  956. package/dist/esm/tests/public-api/v3-core.test.js +82 -0
  957. package/dist/esm/tests/public-api/v3-core.test.js.map +7 -0
  958. package/dist/esm/tests/safety-confirmation.test.js +134 -0
  959. package/dist/esm/tests/safety-confirmation.test.js.map +7 -0
  960. package/dist/esm/tests/snapshot-a11y-resolvers.test.js +348 -0
  961. package/dist/esm/tests/snapshot-a11y-resolvers.test.js.map +7 -0
  962. package/dist/esm/tests/snapshot-a11y-tree-utils.test.js +300 -0
  963. package/dist/esm/tests/snapshot-a11y-tree-utils.test.js.map +7 -0
  964. package/dist/esm/tests/snapshot-capture-orchestration.test.js +381 -0
  965. package/dist/esm/tests/snapshot-capture-orchestration.test.js.map +7 -0
  966. package/dist/esm/tests/snapshot-cbor.test.js +197 -0
  967. package/dist/esm/tests/snapshot-cbor.test.js.map +7 -0
  968. package/dist/esm/tests/snapshot-dom-session-builders.test.js +251 -0
  969. package/dist/esm/tests/snapshot-dom-session-builders.test.js.map +7 -0
  970. package/dist/esm/tests/snapshot-dom-tree-utils.test.js +109 -0
  971. package/dist/esm/tests/snapshot-dom-tree-utils.test.js.map +7 -0
  972. package/dist/esm/tests/snapshot-focus-selectors-utils.test.js +49 -0
  973. package/dist/esm/tests/snapshot-focus-selectors-utils.test.js.map +7 -0
  974. package/dist/esm/tests/snapshot-frame-merge.test.js +391 -0
  975. package/dist/esm/tests/snapshot-frame-merge.test.js.map +7 -0
  976. package/dist/esm/tests/snapshot-tree-format-utils.test.js +113 -0
  977. package/dist/esm/tests/snapshot-tree-format-utils.test.js.map +7 -0
  978. package/dist/esm/tests/snapshot-xpath-utils.test.js +79 -0
  979. package/dist/esm/tests/snapshot-xpath-utils.test.js.map +7 -0
  980. package/dist/esm/tests/timeout-handlers.test.js +850 -0
  981. package/dist/esm/tests/timeout-handlers.test.js.map +7 -0
  982. package/dist/esm/tests/xpath-parser.test.js +317 -0
  983. package/dist/esm/tests/xpath-parser.test.js.map +7 -0
  984. package/dist/esm/tests/xpath-resolver.test.js +73 -0
  985. package/dist/esm/tests/xpath-resolver.test.js.map +7 -0
  986. package/dist/esm/tests/zod-enum-compatibility.test.js +97 -0
  987. package/dist/esm/tests/zod-enum-compatibility.test.js.map +7 -0
  988. package/package.json +41 -24
  989. package/dist/index.d.ts +0 -4363
  990. package/dist/index.js +0 -76530
@@ -0,0 +1,493 @@
1
+ import { test, expect } from "@playwright/test";
2
+ import { V3 } from "../v3.js";
3
+ import { v3TestConfig } from "./v3.config.js";
4
+ const isBrowserbase = (process.env.STAGEHAND_BROWSER_TARGET ?? "local").toLowerCase() === "browserbase";
5
+ const MIN_TIMEOUT_MS = 3e3;
6
+ const MAX_TIMEOUT_MS = 12e4;
7
+ const parseBoundedTimeoutMs = (value, fallbackMs) => {
8
+ const parsed = Number(value ?? fallbackMs);
9
+ if (!Number.isFinite(parsed)) return fallbackMs;
10
+ return Math.max(MIN_TIMEOUT_MS, Math.min(MAX_TIMEOUT_MS, parsed));
11
+ };
12
+ const CHILD_FRAME_TIMEOUT_MS = parseBoundedTimeoutMs(
13
+ process.env.IFRAME_CHILD_FRAME_TIMEOUT_MS,
14
+ isBrowserbase ? 8e4 : 4e4
15
+ );
16
+ const POPUP_TIMEOUT_MS = parseBoundedTimeoutMs(
17
+ process.env.IFRAME_POPUP_TIMEOUT_MS,
18
+ isBrowserbase ? 6e4 : 4e4
19
+ );
20
+ const POPUP_URL_TIMEOUT_MS = parseBoundedTimeoutMs(
21
+ process.env.IFRAME_POPUP_URL_TIMEOUT_MS,
22
+ isBrowserbase ? 8e4 : 4e4
23
+ );
24
+ const DEBUG_INTERVAL_MS = 5e3;
25
+ const iframeDebugEnabled = isBrowserbase || process.env.IFRAME_DEBUG === "1";
26
+ const TEST_VIEWPORT = { width: 1288, height: 711 };
27
+ const formatError = (error) => {
28
+ if (error instanceof Error) return error.message;
29
+ return String(error);
30
+ };
31
+ const flattenFrameTree = (node, out = []) => {
32
+ out.push({
33
+ id: node.frame.id,
34
+ parentId: node.frame.parentId ?? null,
35
+ url: node.frame.url ?? ""
36
+ });
37
+ for (const child of node.childFrames ?? []) {
38
+ flattenFrameTree(child, out);
39
+ }
40
+ return out;
41
+ };
42
+ function debugLog(step, payload) {
43
+ if (!iframeDebugEnabled) return;
44
+ if (payload === void 0) {
45
+ console.log(`[iframe-debug] ${step}`);
46
+ return;
47
+ }
48
+ if (typeof payload === "string") {
49
+ console.log(`[iframe-debug] ${step}: ${payload}`);
50
+ return;
51
+ }
52
+ try {
53
+ console.log(`[iframe-debug] ${step}: ${JSON.stringify(payload)}`);
54
+ } catch {
55
+ console.log(`[iframe-debug] ${step}: <unserializable payload>`);
56
+ }
57
+ }
58
+ async function collectFrameSnapshot(page) {
59
+ const known = /* @__PURE__ */ new Map();
60
+ known.set(page.mainFrame().frameId, page.mainFrame());
61
+ for (const frame of page.frames()) known.set(frame.frameId, frame);
62
+ return Promise.all(
63
+ [...known.values()].map(async (frame) => {
64
+ try {
65
+ const state = await frame.evaluate(() => {
66
+ return {
67
+ href: location.href,
68
+ readyState: document.readyState,
69
+ visibilityState: document.visibilityState,
70
+ iframeCount: document.querySelectorAll("iframe").length,
71
+ hasShadowHost: Boolean(document.querySelector("shadow-host"))
72
+ };
73
+ });
74
+ return {
75
+ frameId: frame.frameId,
76
+ sessionId: frame.sessionId ?? "root",
77
+ ...state
78
+ };
79
+ } catch (error) {
80
+ return {
81
+ frameId: frame.frameId,
82
+ sessionId: frame.sessionId ?? "root",
83
+ error: formatError(error)
84
+ };
85
+ }
86
+ })
87
+ );
88
+ }
89
+ async function logPageDiagnostics(page, reason, markerSelector) {
90
+ if (!iframeDebugEnabled) return;
91
+ const diagnostics = {
92
+ reason,
93
+ pageUrl: page.url(),
94
+ mainFrameId: page.mainFrame().frameId,
95
+ knownFrameCount: page.frames().length
96
+ };
97
+ try {
98
+ const domState = await page.mainFrame().evaluate((marker) => {
99
+ const el = marker ? document.querySelector(marker) : null;
100
+ const rect = el instanceof Element ? el.getBoundingClientRect().toJSON() : null;
101
+ return {
102
+ href: location.href,
103
+ readyState: document.readyState,
104
+ visibilityState: document.visibilityState,
105
+ hidden: document.hidden,
106
+ hasFocus: document.hasFocus(),
107
+ innerWidth: window.innerWidth,
108
+ innerHeight: window.innerHeight,
109
+ devicePixelRatio: window.devicePixelRatio,
110
+ markerSelector: marker,
111
+ markerPresent: Boolean(el),
112
+ markerRect: rect,
113
+ iframeCount: document.querySelectorAll("iframe").length
114
+ };
115
+ }, markerSelector);
116
+ diagnostics.domState = domState;
117
+ } catch (error) {
118
+ diagnostics.domStateError = formatError(error);
119
+ }
120
+ try {
121
+ const frameTreeResponse = await page.sendCDP("Page.getFrameTree");
122
+ if (frameTreeResponse.frameTree) {
123
+ diagnostics.cdpFrameTree = flattenFrameTree(frameTreeResponse.frameTree);
124
+ }
125
+ } catch (error) {
126
+ diagnostics.cdpFrameTreeError = formatError(error);
127
+ }
128
+ diagnostics.frameSnapshot = await collectFrameSnapshot(page);
129
+ debugLog("page-diagnostics", diagnostics);
130
+ }
131
+ async function closeAllPages(ctx) {
132
+ const pages = ctx.pages();
133
+ await Promise.allSettled(pages.map((page) => page.close()));
134
+ }
135
+ async function waitForChildFrame(page, expectedChildUrl, timeoutMs = CHILD_FRAME_TIMEOUT_MS) {
136
+ const mainFrameId = page.mainFrame().frameId;
137
+ const deadline = Date.now() + timeoutMs;
138
+ let observedFrameCount = 0;
139
+ const observedChildFrameIds = /* @__PURE__ */ new Set();
140
+ let lastUrl = "";
141
+ let lastLogAt = Date.now();
142
+ while (Date.now() < deadline) {
143
+ const frames = page.frames();
144
+ observedFrameCount = Math.max(observedFrameCount, frames.length);
145
+ lastUrl = page.url();
146
+ const childIds = frames.filter((f) => f.frameId !== mainFrameId).map((f) => f.frameId);
147
+ if (iframeDebugEnabled && Date.now() - lastLogAt >= DEBUG_INTERVAL_MS) {
148
+ debugLog("waitForChildFrame:progress", {
149
+ url: lastUrl,
150
+ mainFrameId,
151
+ observedFrameCount,
152
+ childIds,
153
+ expectedChildUrl
154
+ });
155
+ lastLogAt = Date.now();
156
+ }
157
+ for (const childId of childIds) observedChildFrameIds.add(childId);
158
+ const childFrames = frames.filter((f) => f.frameId !== mainFrameId).reverse();
159
+ if (childFrames.length) {
160
+ const probes = await Promise.all(
161
+ childFrames.map(async (child) => {
162
+ try {
163
+ const state = await child.evaluate(() => ({
164
+ href: location.href,
165
+ readyState: document.readyState
166
+ }));
167
+ return {
168
+ child,
169
+ href: state.href,
170
+ readyState: state.readyState,
171
+ error: void 0
172
+ };
173
+ } catch (error) {
174
+ return {
175
+ child,
176
+ href: void 0,
177
+ readyState: void 0,
178
+ error: formatError(error)
179
+ };
180
+ }
181
+ })
182
+ );
183
+ const ready = probes.find(
184
+ (probe) => probe.readyState === "complete" && probe.href === expectedChildUrl
185
+ );
186
+ if (ready) {
187
+ debugLog("waitForChildFrame:ready", {
188
+ childFrameId: ready.child.frameId,
189
+ childSessionId: ready.child.sessionId ?? "root",
190
+ childUrl: ready.href ?? "<unknown>",
191
+ expectedChildUrl,
192
+ url: lastUrl
193
+ });
194
+ return ready.child;
195
+ }
196
+ if (iframeDebugEnabled && Date.now() - lastLogAt >= DEBUG_INTERVAL_MS) {
197
+ debugLog("waitForChildFrame:not-ready", {
198
+ url: lastUrl,
199
+ mainFrameId,
200
+ expectedChildUrl,
201
+ probes: probes.map((probe) => ({
202
+ frameId: probe.child.frameId,
203
+ sessionId: probe.child.sessionId ?? "root",
204
+ readyState: probe.readyState ?? "<unknown>",
205
+ href: probe.href ?? "<unknown>",
206
+ error: probe.error ?? "<none>"
207
+ }))
208
+ });
209
+ lastLogAt = Date.now();
210
+ }
211
+ }
212
+ await new Promise((r) => setTimeout(r, 100));
213
+ }
214
+ await logPageDiagnostics(page, "waitForChildFrame timeout");
215
+ throw new Error(
216
+ `Timed out waiting for child frame to load (timeout=${timeoutMs}ms, mainFrameId=${mainFrameId}, expectedChildUrl=${expectedChildUrl}, maxObservedFrames=${observedFrameCount}, observedChildFrameIds=[${[...observedChildFrameIds].join(",")}], url=${lastUrl || "<unknown>"})`
217
+ );
218
+ }
219
+ async function waitForPageUrl(page, expectedUrlSubstring, timeoutMs = POPUP_URL_TIMEOUT_MS) {
220
+ const deadline = Date.now() + timeoutMs;
221
+ let lastUrl = "";
222
+ let lastLogAt = Date.now();
223
+ while (Date.now() < deadline) {
224
+ lastUrl = page.url();
225
+ if (iframeDebugEnabled && Date.now() - lastLogAt >= DEBUG_INTERVAL_MS) {
226
+ debugLog("waitForPageUrl:progress", {
227
+ expectedUrlSubstring,
228
+ lastUrl
229
+ });
230
+ lastLogAt = Date.now();
231
+ }
232
+ if (lastUrl.includes(expectedUrlSubstring)) {
233
+ debugLog("waitForPageUrl:ready", {
234
+ expectedUrlSubstring,
235
+ lastUrl
236
+ });
237
+ return;
238
+ }
239
+ await new Promise((r) => setTimeout(r, 100));
240
+ }
241
+ await logPageDiagnostics(
242
+ page,
243
+ `waitForPageUrl timeout for ${expectedUrlSubstring}`
244
+ );
245
+ throw new Error(
246
+ `Timed out waiting for popup URL to include "${expectedUrlSubstring}" (timeout=${timeoutMs}ms, lastUrl=${lastUrl || "<unknown>"})`
247
+ );
248
+ }
249
+ async function preparePopupForFrameAttach(page, markerSelector, timeoutMs = CHILD_FRAME_TIMEOUT_MS) {
250
+ debugLog("preparePopupForFrameAttach:start", {
251
+ markerSelector,
252
+ timeoutMs,
253
+ url: page.url()
254
+ });
255
+ await page.waitForLoadState("domcontentloaded", timeoutMs);
256
+ await page.waitForSelector(markerSelector, {
257
+ state: "attached",
258
+ timeout: timeoutMs
259
+ });
260
+ await page.mainFrame().evaluate(() => {
261
+ const host = document.querySelector("shadow-host");
262
+ if (host instanceof HTMLElement) {
263
+ host.scrollIntoView({ block: "center", inline: "center" });
264
+ } else {
265
+ window.scrollTo(0, document.body.scrollHeight);
266
+ window.scrollTo(0, 0);
267
+ }
268
+ window.dispatchEvent(new Event("scroll"));
269
+ });
270
+ await logPageDiagnostics(
271
+ page,
272
+ "preparePopupForFrameAttach:ready",
273
+ markerSelector
274
+ );
275
+ }
276
+ async function ensurePopupViewport(page) {
277
+ await page.setViewportSize(TEST_VIEWPORT.width, TEST_VIEWPORT.height);
278
+ await logPageDiagnostics(page, "ensurePopupViewport");
279
+ }
280
+ async function waitForPopupPage(ctx, opener, timeoutMs = POPUP_TIMEOUT_MS) {
281
+ const openerMainFrameId = opener.mainFrame().frameId;
282
+ const deadline = Date.now() + timeoutMs;
283
+ let lastLogAt = Date.now();
284
+ while (Date.now() < deadline) {
285
+ const pages = ctx.pages();
286
+ const popup = pages.find((candidate) => {
287
+ return candidate.mainFrame().frameId !== openerMainFrameId;
288
+ });
289
+ if (popup) {
290
+ debugLog("waitForPopupPage:found", {
291
+ openerMainFrameId,
292
+ popupMainFrameId: popup.mainFrame().frameId,
293
+ popupUrl: popup.url()
294
+ });
295
+ return popup;
296
+ }
297
+ if (iframeDebugEnabled && Date.now() - lastLogAt >= DEBUG_INTERVAL_MS) {
298
+ debugLog("waitForPopupPage:progress", {
299
+ openerMainFrameId,
300
+ observedPageIds: pages.map((p) => p.mainFrame().frameId)
301
+ });
302
+ lastLogAt = Date.now();
303
+ }
304
+ try {
305
+ const active = await ctx.awaitActivePage(500);
306
+ if (active.mainFrame().frameId !== openerMainFrameId) {
307
+ debugLog("waitForPopupPage:active-non-opener", {
308
+ openerMainFrameId,
309
+ activeMainFrameId: active.mainFrame().frameId,
310
+ activeUrl: active.url()
311
+ });
312
+ return active;
313
+ }
314
+ } catch {
315
+ }
316
+ await new Promise((r) => setTimeout(r, 100));
317
+ }
318
+ const pageIds = ctx.pages().map((p) => p.mainFrame().frameId).join(", ");
319
+ throw new Error(
320
+ `Timed out waiting for popup page (timeout=${timeoutMs}ms, openerMainFrameId=${openerMainFrameId}, observedPages=[${pageIds}])`
321
+ );
322
+ }
323
+ test.describe("context.addInitScript with iframes", () => {
324
+ const OOPIF_CHILD_URL = "https://seanmcguire12.github.io/stagehand-oopif-sites/sites/form-filling/";
325
+ const SPIF_CHILD_URL = "https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/iframe.html";
326
+ const POPUP_SPIF_CHILD_URL = "https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-dom-in-spif/embedded.html";
327
+ if (isBrowserbase) {
328
+ test.describe.configure({ mode: "serial" });
329
+ }
330
+ let v3;
331
+ let ctx;
332
+ test.beforeAll(async () => {
333
+ debugLog("beforeAll:config", {
334
+ browserTarget: process.env.STAGEHAND_BROWSER_TARGET ?? "local",
335
+ childFrameTimeoutMs: CHILD_FRAME_TIMEOUT_MS,
336
+ popupTimeoutMs: POPUP_TIMEOUT_MS,
337
+ popupUrlTimeoutMs: POPUP_URL_TIMEOUT_MS
338
+ });
339
+ v3 = new V3(v3TestConfig);
340
+ await v3.init();
341
+ ctx = v3.context;
342
+ await ctx.addInitScript(`
343
+ (() => {
344
+ document.addEventListener('DOMContentLoaded', () => {
345
+ document.documentElement.style.backgroundColor = 'red';
346
+ });
347
+ })();
348
+ `);
349
+ });
350
+ test.beforeEach(async () => {
351
+ await closeAllPages(ctx);
352
+ });
353
+ test.afterEach(async () => {
354
+ await closeAllPages(ctx);
355
+ });
356
+ test.afterAll(async () => {
357
+ await v3?.close?.().catch(() => {
358
+ });
359
+ });
360
+ test.describe("direct navigation", () => {
361
+ test("with OOPIF - sets background red in main page and iframe", async () => {
362
+ const page = await ctx.newPage();
363
+ await page.goto(
364
+ "https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/",
365
+ { waitUntil: "networkidle" }
366
+ );
367
+ const iframe = await waitForChildFrame(page, OOPIF_CHILD_URL);
368
+ const mainBgColor = await page.mainFrame().evaluate(() => {
369
+ return getComputedStyle(document.documentElement).backgroundColor;
370
+ });
371
+ expect(mainBgColor).toBe("rgb(255, 0, 0)");
372
+ const iframeBgColor = await iframe.evaluate(() => {
373
+ return getComputedStyle(document.documentElement).backgroundColor;
374
+ });
375
+ expect(iframeBgColor).toBe("rgb(255, 0, 0)");
376
+ });
377
+ test("with SPIF - sets background red in main page and iframe", async () => {
378
+ const page = await ctx.newPage();
379
+ await page.goto(
380
+ "https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/",
381
+ { waitUntil: "networkidle" }
382
+ );
383
+ const iframe = await waitForChildFrame(page, SPIF_CHILD_URL);
384
+ const mainBgColor = await page.mainFrame().evaluate(() => {
385
+ return getComputedStyle(document.documentElement).backgroundColor;
386
+ });
387
+ expect(mainBgColor).toBe("rgb(255, 0, 0)");
388
+ const iframeBgColor = await iframe.evaluate(() => {
389
+ return getComputedStyle(document.documentElement).backgroundColor;
390
+ });
391
+ expect(iframeBgColor).toBe("rgb(255, 0, 0)");
392
+ });
393
+ });
394
+ test.describe("via newPage", () => {
395
+ test("with OOPIF - sets background red in main page and iframe", async () => {
396
+ const page = await ctx.newPage();
397
+ await page.goto(
398
+ "https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/",
399
+ { waitUntil: "networkidle" }
400
+ );
401
+ const iframe = await waitForChildFrame(page, OOPIF_CHILD_URL);
402
+ const mainBgColor = await page.mainFrame().evaluate(() => {
403
+ return getComputedStyle(document.documentElement).backgroundColor;
404
+ });
405
+ expect(mainBgColor).toBe("rgb(255, 0, 0)");
406
+ const iframeBgColor = await iframe.evaluate(() => {
407
+ return getComputedStyle(document.documentElement).backgroundColor;
408
+ });
409
+ expect(iframeBgColor).toBe("rgb(255, 0, 0)");
410
+ });
411
+ test("with SPIF - sets background red in main page and iframe", async () => {
412
+ const page = await ctx.newPage();
413
+ await page.goto(
414
+ "https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/",
415
+ { waitUntil: "networkidle" }
416
+ );
417
+ const iframe = await waitForChildFrame(page, SPIF_CHILD_URL);
418
+ const mainBgColor = await page.mainFrame().evaluate(() => {
419
+ return getComputedStyle(document.documentElement).backgroundColor;
420
+ });
421
+ expect(mainBgColor).toBe("rgb(255, 0, 0)");
422
+ const iframeBgColor = await iframe.evaluate(() => {
423
+ return getComputedStyle(document.documentElement).backgroundColor;
424
+ });
425
+ expect(iframeBgColor).toBe("rgb(255, 0, 0)");
426
+ });
427
+ });
428
+ test.describe("via popup", () => {
429
+ test("with OOPIF - sets background red in main page and iframe", async () => {
430
+ const page = await ctx.newPage();
431
+ await page.goto(
432
+ "https://browserbase.github.io/stagehand-eval-sites/sites/ctx-add-init-script-oopif/",
433
+ { waitUntil: "networkidle" }
434
+ );
435
+ await page.locator("a").click();
436
+ debugLog("popup-oopif:clicked-link", { openerUrl: page.url() });
437
+ const popup = await waitForPopupPage(ctx, page);
438
+ ctx.setActivePage(popup);
439
+ await ensurePopupViewport(popup);
440
+ await waitForPageUrl(
441
+ popup,
442
+ "/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/"
443
+ );
444
+ debugLog("popup-oopif:refresh-navigation", { url: popup.url() });
445
+ await popup.goto(
446
+ "https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/",
447
+ { waitUntil: "networkidle" }
448
+ );
449
+ await logPageDiagnostics(
450
+ popup,
451
+ "popup-oopif:after-refresh",
452
+ "shadow-host"
453
+ );
454
+ await preparePopupForFrameAttach(popup, "shadow-host");
455
+ const iframe = await waitForChildFrame(popup, OOPIF_CHILD_URL);
456
+ const mainBgColor = await popup.mainFrame().evaluate(() => {
457
+ return getComputedStyle(document.documentElement).backgroundColor;
458
+ });
459
+ expect(mainBgColor).toBe("rgb(255, 0, 0)");
460
+ const iframeBgColor = await iframe.evaluate(() => {
461
+ return getComputedStyle(document.documentElement).backgroundColor;
462
+ });
463
+ expect(iframeBgColor).toBe("rgb(255, 0, 0)");
464
+ });
465
+ test("with SPIF - sets background red in main page and iframe", async () => {
466
+ const page = await ctx.newPage();
467
+ await page.goto(
468
+ "https://browserbase.github.io/stagehand-eval-sites/sites/ctx-add-init-script-spif/",
469
+ { waitUntil: "networkidle" }
470
+ );
471
+ await page.locator("a").click();
472
+ debugLog("popup-spif:clicked-link", { openerUrl: page.url() });
473
+ const popup = await waitForPopupPage(ctx, page);
474
+ ctx.setActivePage(popup);
475
+ await ensurePopupViewport(popup);
476
+ await waitForPageUrl(
477
+ popup,
478
+ "/stagehand-eval-sites/sites/closed-shadow-dom-in-spif/"
479
+ );
480
+ await preparePopupForFrameAttach(popup, "iframe");
481
+ const iframe = await waitForChildFrame(popup, POPUP_SPIF_CHILD_URL);
482
+ const mainBgColor = await popup.mainFrame().evaluate(() => {
483
+ return getComputedStyle(document.documentElement).backgroundColor;
484
+ });
485
+ expect(mainBgColor).toBe("rgb(255, 0, 0)");
486
+ const iframeBgColor = await iframe.evaluate(() => {
487
+ return getComputedStyle(document.documentElement).backgroundColor;
488
+ });
489
+ expect(iframeBgColor).toBe("rgb(255, 0, 0)");
490
+ });
491
+ });
492
+ });
493
+ //# sourceMappingURL=iframe-ctx-addInitScript.spec.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../lib/v3/tests/iframe-ctx-addInitScript.spec.ts"],
4
+ "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport { V3Context } from \"../understudy/context.js\";\nimport type { Page } from \"../understudy/page.js\";\n\nconst isBrowserbase =\n (process.env.STAGEHAND_BROWSER_TARGET ?? \"local\").toLowerCase() ===\n \"browserbase\";\nconst MIN_TIMEOUT_MS = 3_000;\nconst MAX_TIMEOUT_MS = 120_000;\n\nconst parseBoundedTimeoutMs = (\n value: string | undefined,\n fallbackMs: number,\n): number => {\n const parsed = Number(value ?? fallbackMs);\n if (!Number.isFinite(parsed)) return fallbackMs;\n return Math.max(MIN_TIMEOUT_MS, Math.min(MAX_TIMEOUT_MS, parsed));\n};\n\nconst CHILD_FRAME_TIMEOUT_MS = parseBoundedTimeoutMs(\n process.env.IFRAME_CHILD_FRAME_TIMEOUT_MS,\n isBrowserbase ? 80_000 : 40_000,\n);\nconst POPUP_TIMEOUT_MS = parseBoundedTimeoutMs(\n process.env.IFRAME_POPUP_TIMEOUT_MS,\n isBrowserbase ? 60_000 : 40_000,\n);\nconst POPUP_URL_TIMEOUT_MS = parseBoundedTimeoutMs(\n process.env.IFRAME_POPUP_URL_TIMEOUT_MS,\n isBrowserbase ? 80_000 : 40_000,\n);\nconst DEBUG_INTERVAL_MS = 5_000;\nconst iframeDebugEnabled = isBrowserbase || process.env.IFRAME_DEBUG === \"1\";\nconst TEST_VIEWPORT = { width: 1288, height: 711 };\n\ntype FrameTreeNode = {\n frame: { id: string; parentId?: string; url?: string };\n childFrames?: FrameTreeNode[];\n};\n\nconst formatError = (error: unknown): string => {\n if (error instanceof Error) return error.message;\n return String(error);\n};\n\nconst flattenFrameTree = (\n node: FrameTreeNode,\n out: Array<{ id: string; parentId: string | null; url: string }> = [],\n): Array<{ id: string; parentId: string | null; url: string }> => {\n out.push({\n id: node.frame.id,\n parentId: node.frame.parentId ?? null,\n url: node.frame.url ?? \"\",\n });\n for (const child of node.childFrames ?? []) {\n flattenFrameTree(child, out);\n }\n return out;\n};\n\nfunction debugLog(\n step: string,\n payload?: Record<string, unknown> | string,\n): void {\n if (!iframeDebugEnabled) return;\n if (payload === undefined) {\n console.log(`[iframe-debug] ${step}`);\n return;\n }\n if (typeof payload === \"string\") {\n console.log(`[iframe-debug] ${step}: ${payload}`);\n return;\n }\n try {\n console.log(`[iframe-debug] ${step}: ${JSON.stringify(payload)}`);\n } catch {\n console.log(`[iframe-debug] ${step}: <unserializable payload>`);\n }\n}\n\nasync function collectFrameSnapshot(\n page: Page,\n): Promise<Array<Record<string, unknown>>> {\n const known = new Map<string, ReturnType<Page[\"frames\"]>[number]>();\n known.set(page.mainFrame().frameId, page.mainFrame());\n for (const frame of page.frames()) known.set(frame.frameId, frame);\n\n return Promise.all(\n [...known.values()].map(async (frame) => {\n try {\n const state = await frame.evaluate(() => {\n return {\n href: location.href,\n readyState: document.readyState,\n visibilityState: document.visibilityState,\n iframeCount: document.querySelectorAll(\"iframe\").length,\n hasShadowHost: Boolean(document.querySelector(\"shadow-host\")),\n };\n });\n return {\n frameId: frame.frameId,\n sessionId: frame.sessionId ?? \"root\",\n ...state,\n };\n } catch (error) {\n return {\n frameId: frame.frameId,\n sessionId: frame.sessionId ?? \"root\",\n error: formatError(error),\n };\n }\n }),\n );\n}\n\nasync function logPageDiagnostics(\n page: Page,\n reason: string,\n markerSelector?: string,\n): Promise<void> {\n if (!iframeDebugEnabled) return;\n const diagnostics: Record<string, unknown> = {\n reason,\n pageUrl: page.url(),\n mainFrameId: page.mainFrame().frameId,\n knownFrameCount: page.frames().length,\n };\n\n try {\n const domState = await page.mainFrame().evaluate((marker) => {\n const el = marker ? document.querySelector(marker) : null;\n const rect =\n el instanceof Element ? el.getBoundingClientRect().toJSON() : null;\n return {\n href: location.href,\n readyState: document.readyState,\n visibilityState: document.visibilityState,\n hidden: document.hidden,\n hasFocus: document.hasFocus(),\n innerWidth: window.innerWidth,\n innerHeight: window.innerHeight,\n devicePixelRatio: window.devicePixelRatio,\n markerSelector: marker,\n markerPresent: Boolean(el),\n markerRect: rect,\n iframeCount: document.querySelectorAll(\"iframe\").length,\n };\n }, markerSelector);\n diagnostics.domState = domState;\n } catch (error) {\n diagnostics.domStateError = formatError(error);\n }\n\n try {\n const frameTreeResponse = (await page.sendCDP(\"Page.getFrameTree\")) as {\n frameTree?: FrameTreeNode;\n };\n if (frameTreeResponse.frameTree) {\n diagnostics.cdpFrameTree = flattenFrameTree(frameTreeResponse.frameTree);\n }\n } catch (error) {\n diagnostics.cdpFrameTreeError = formatError(error);\n }\n\n diagnostics.frameSnapshot = await collectFrameSnapshot(page);\n debugLog(\"page-diagnostics\", diagnostics);\n}\n\nasync function closeAllPages(ctx: V3Context): Promise<void> {\n const pages = ctx.pages();\n await Promise.allSettled(pages.map((page) => page.close()));\n}\n\n/**\n * Poll until a child frame (non-main) appears on `page` and its document\n * has finished loading. Returns the child frame.\n */\nasync function waitForChildFrame(\n page: Page,\n expectedChildUrl: string,\n timeoutMs = CHILD_FRAME_TIMEOUT_MS,\n): Promise<ReturnType<Page[\"frames\"]>[number]> {\n const mainFrameId = page.mainFrame().frameId;\n const deadline = Date.now() + timeoutMs;\n let observedFrameCount = 0;\n const observedChildFrameIds = new Set<string>();\n let lastUrl = \"\";\n let lastLogAt = Date.now();\n\n while (Date.now() < deadline) {\n const frames = page.frames();\n observedFrameCount = Math.max(observedFrameCount, frames.length);\n lastUrl = page.url();\n const childIds = frames\n .filter((f) => f.frameId !== mainFrameId)\n .map((f) => f.frameId);\n if (iframeDebugEnabled && Date.now() - lastLogAt >= DEBUG_INTERVAL_MS) {\n debugLog(\"waitForChildFrame:progress\", {\n url: lastUrl,\n mainFrameId,\n observedFrameCount,\n childIds,\n expectedChildUrl,\n });\n lastLogAt = Date.now();\n }\n for (const childId of childIds) observedChildFrameIds.add(childId);\n\n const childFrames = frames\n .filter((f) => f.frameId !== mainFrameId)\n // Prefer recently-discovered frames first; stale swapped frame ids\n // can remain visible in the registry while the live OOPIF is ready.\n .reverse();\n\n if (childFrames.length) {\n const probes = await Promise.all(\n childFrames.map(async (child) => {\n try {\n const state = await child.evaluate(() => ({\n href: location.href,\n readyState: document.readyState,\n }));\n return {\n child,\n href: state.href,\n readyState: state.readyState,\n error: undefined,\n };\n } catch (error) {\n return {\n child,\n href: undefined,\n readyState: undefined,\n error: formatError(error),\n };\n }\n }),\n );\n\n const ready = probes.find(\n (probe) =>\n probe.readyState === \"complete\" && probe.href === expectedChildUrl,\n );\n if (ready) {\n debugLog(\"waitForChildFrame:ready\", {\n childFrameId: ready.child.frameId,\n childSessionId: ready.child.sessionId ?? \"root\",\n childUrl: ready.href ?? \"<unknown>\",\n expectedChildUrl,\n url: lastUrl,\n });\n return ready.child;\n }\n\n if (iframeDebugEnabled && Date.now() - lastLogAt >= DEBUG_INTERVAL_MS) {\n debugLog(\"waitForChildFrame:not-ready\", {\n url: lastUrl,\n mainFrameId,\n expectedChildUrl,\n probes: probes.map((probe) => ({\n frameId: probe.child.frameId,\n sessionId: probe.child.sessionId ?? \"root\",\n readyState: probe.readyState ?? \"<unknown>\",\n href: probe.href ?? \"<unknown>\",\n error: probe.error ?? \"<none>\",\n })),\n });\n lastLogAt = Date.now();\n }\n }\n await new Promise((r) => setTimeout(r, 100));\n }\n await logPageDiagnostics(page, \"waitForChildFrame timeout\");\n throw new Error(\n `Timed out waiting for child frame to load (timeout=${timeoutMs}ms, mainFrameId=${mainFrameId}, expectedChildUrl=${expectedChildUrl}, maxObservedFrames=${observedFrameCount}, observedChildFrameIds=[${[...observedChildFrameIds].join(\",\")}], url=${lastUrl || \"<unknown>\"})`,\n );\n}\n\nasync function waitForPageUrl(\n page: Page,\n expectedUrlSubstring: string,\n timeoutMs = POPUP_URL_TIMEOUT_MS,\n): Promise<void> {\n const deadline = Date.now() + timeoutMs;\n let lastUrl = \"\";\n let lastLogAt = Date.now();\n while (Date.now() < deadline) {\n lastUrl = page.url();\n if (iframeDebugEnabled && Date.now() - lastLogAt >= DEBUG_INTERVAL_MS) {\n debugLog(\"waitForPageUrl:progress\", {\n expectedUrlSubstring,\n lastUrl,\n });\n lastLogAt = Date.now();\n }\n if (lastUrl.includes(expectedUrlSubstring)) {\n debugLog(\"waitForPageUrl:ready\", {\n expectedUrlSubstring,\n lastUrl,\n });\n return;\n }\n await new Promise((r) => setTimeout(r, 100));\n }\n await logPageDiagnostics(\n page,\n `waitForPageUrl timeout for ${expectedUrlSubstring}`,\n );\n throw new Error(\n `Timed out waiting for popup URL to include \"${expectedUrlSubstring}\" (timeout=${timeoutMs}ms, lastUrl=${lastUrl || \"<unknown>\"})`,\n );\n}\n\nasync function preparePopupForFrameAttach(\n page: Page,\n markerSelector: string,\n timeoutMs = CHILD_FRAME_TIMEOUT_MS,\n): Promise<void> {\n debugLog(\"preparePopupForFrameAttach:start\", {\n markerSelector,\n timeoutMs,\n url: page.url(),\n });\n await page.waitForLoadState(\"domcontentloaded\", timeoutMs);\n await page.waitForSelector(markerSelector, {\n state: \"attached\",\n timeout: timeoutMs,\n });\n await page.mainFrame().evaluate(() => {\n const host = document.querySelector(\"shadow-host\");\n if (host instanceof HTMLElement) {\n host.scrollIntoView({ block: \"center\", inline: \"center\" });\n } else {\n window.scrollTo(0, document.body.scrollHeight);\n window.scrollTo(0, 0);\n }\n window.dispatchEvent(new Event(\"scroll\"));\n });\n await logPageDiagnostics(\n page,\n \"preparePopupForFrameAttach:ready\",\n markerSelector,\n );\n}\n\nasync function ensurePopupViewport(page: Page): Promise<void> {\n await page.setViewportSize(TEST_VIEWPORT.width, TEST_VIEWPORT.height);\n await logPageDiagnostics(page, \"ensurePopupViewport\");\n}\n\nasync function waitForPopupPage(\n ctx: V3Context,\n opener: Page,\n timeoutMs = POPUP_TIMEOUT_MS,\n): Promise<Page> {\n const openerMainFrameId = opener.mainFrame().frameId;\n const deadline = Date.now() + timeoutMs;\n let lastLogAt = Date.now();\n\n while (Date.now() < deadline) {\n const pages = ctx.pages();\n const popup = pages.find((candidate) => {\n return candidate.mainFrame().frameId !== openerMainFrameId;\n });\n if (popup) {\n debugLog(\"waitForPopupPage:found\", {\n openerMainFrameId,\n popupMainFrameId: popup.mainFrame().frameId,\n popupUrl: popup.url(),\n });\n return popup;\n }\n\n if (iframeDebugEnabled && Date.now() - lastLogAt >= DEBUG_INTERVAL_MS) {\n debugLog(\"waitForPopupPage:progress\", {\n openerMainFrameId,\n observedPageIds: pages.map((p) => p.mainFrame().frameId),\n });\n lastLogAt = Date.now();\n }\n\n try {\n const active = await ctx.awaitActivePage(500);\n if (active.mainFrame().frameId !== openerMainFrameId) {\n debugLog(\"waitForPopupPage:active-non-opener\", {\n openerMainFrameId,\n activeMainFrameId: active.mainFrame().frameId,\n activeUrl: active.url(),\n });\n return active;\n }\n } catch {\n // keep polling until timeout\n }\n\n await new Promise((r) => setTimeout(r, 100));\n }\n\n const pageIds = ctx\n .pages()\n .map((p) => p.mainFrame().frameId)\n .join(\", \");\n throw new Error(\n `Timed out waiting for popup page (timeout=${timeoutMs}ms, openerMainFrameId=${openerMainFrameId}, observedPages=[${pageIds}])`,\n );\n}\n\ntest.describe(\"context.addInitScript with iframes\", () => {\n const OOPIF_CHILD_URL =\n \"https://seanmcguire12.github.io/stagehand-oopif-sites/sites/form-filling/\";\n const SPIF_CHILD_URL =\n \"https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/iframe.html\";\n const POPUP_SPIF_CHILD_URL =\n \"https://browserbase.github.io/stagehand-eval-sites/sites/closed-shadow-dom-in-spif/embedded.html\";\n\n if (isBrowserbase) {\n test.describe.configure({ mode: \"serial\" });\n }\n\n let v3: V3;\n let ctx: V3Context;\n\n test.beforeAll(async () => {\n debugLog(\"beforeAll:config\", {\n browserTarget: process.env.STAGEHAND_BROWSER_TARGET ?? \"local\",\n childFrameTimeoutMs: CHILD_FRAME_TIMEOUT_MS,\n popupTimeoutMs: POPUP_TIMEOUT_MS,\n popupUrlTimeoutMs: POPUP_URL_TIMEOUT_MS,\n });\n v3 = new V3(v3TestConfig);\n await v3.init();\n ctx = v3.context;\n\n // Add init script that sets background to red\n await ctx.addInitScript(`\n (() => {\n document.addEventListener('DOMContentLoaded', () => {\n document.documentElement.style.backgroundColor = 'red';\n });\n })();\n `);\n });\n\n test.beforeEach(async () => {\n await closeAllPages(ctx);\n });\n\n test.afterEach(async () => {\n await closeAllPages(ctx);\n });\n\n test.afterAll(async () => {\n await v3?.close?.().catch(() => {});\n });\n\n test.describe(\"direct navigation\", () => {\n test(\"with OOPIF - sets background red in main page and iframe\", async () => {\n const page = await ctx.newPage();\n\n await page.goto(\n \"https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/\",\n { waitUntil: \"networkidle\" },\n );\n\n const iframe = await waitForChildFrame(page, OOPIF_CHILD_URL);\n\n // Check main page background\n const mainBgColor = await page.mainFrame().evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(mainBgColor).toBe(\"rgb(255, 0, 0)\");\n\n const iframeBgColor = await iframe.evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(iframeBgColor).toBe(\"rgb(255, 0, 0)\");\n });\n\n test(\"with SPIF - sets background red in main page and iframe\", async () => {\n const page = await ctx.newPage();\n\n await page.goto(\n \"https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/\",\n { waitUntil: \"networkidle\" },\n );\n\n const iframe = await waitForChildFrame(page, SPIF_CHILD_URL);\n\n // Check main page background\n const mainBgColor = await page.mainFrame().evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(mainBgColor).toBe(\"rgb(255, 0, 0)\");\n\n const iframeBgColor = await iframe.evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(iframeBgColor).toBe(\"rgb(255, 0, 0)\");\n });\n });\n\n test.describe(\"via newPage\", () => {\n test(\"with OOPIF - sets background red in main page and iframe\", async () => {\n const page = await ctx.newPage();\n\n await page.goto(\n \"https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/\",\n { waitUntil: \"networkidle\" },\n );\n\n const iframe = await waitForChildFrame(page, OOPIF_CHILD_URL);\n\n // Check main page background\n const mainBgColor = await page.mainFrame().evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(mainBgColor).toBe(\"rgb(255, 0, 0)\");\n\n const iframeBgColor = await iframe.evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(iframeBgColor).toBe(\"rgb(255, 0, 0)\");\n });\n\n test(\"with SPIF - sets background red in main page and iframe\", async () => {\n const page = await ctx.newPage();\n\n await page.goto(\n \"https://browserbase.github.io/stagehand-eval-sites/sites/spif-in-closed-shadow-dom/\",\n { waitUntil: \"networkidle\" },\n );\n\n const iframe = await waitForChildFrame(page, SPIF_CHILD_URL);\n\n // Check main page background\n const mainBgColor = await page.mainFrame().evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(mainBgColor).toBe(\"rgb(255, 0, 0)\");\n\n const iframeBgColor = await iframe.evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(iframeBgColor).toBe(\"rgb(255, 0, 0)\");\n });\n });\n\n test.describe(\"via popup\", () => {\n test(\"with OOPIF - sets background red in main page and iframe\", async () => {\n const page = await ctx.newPage();\n\n await page.goto(\n \"https://browserbase.github.io/stagehand-eval-sites/sites/ctx-add-init-script-oopif/\",\n { waitUntil: \"networkidle\" },\n );\n\n // Click link to open popup\n await page.locator(\"a\").click();\n debugLog(\"popup-oopif:clicked-link\", { openerUrl: page.url() });\n\n // Wait for popup to open and become active\n const popup = await waitForPopupPage(ctx, page);\n ctx.setActivePage(popup);\n await ensurePopupViewport(popup);\n await waitForPageUrl(\n popup,\n \"/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/\",\n );\n debugLog(\"popup-oopif:refresh-navigation\", { url: popup.url() });\n await popup.goto(\n \"https://browserbase.github.io/stagehand-eval-sites/sites/oopif-in-closed-shadow-dom/\",\n { waitUntil: \"networkidle\" },\n );\n await logPageDiagnostics(\n popup,\n \"popup-oopif:after-refresh\",\n \"shadow-host\",\n );\n await preparePopupForFrameAttach(popup, \"shadow-host\");\n const iframe = await waitForChildFrame(popup, OOPIF_CHILD_URL);\n\n // Check popup main page background\n const mainBgColor = await popup.mainFrame().evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(mainBgColor).toBe(\"rgb(255, 0, 0)\");\n\n const iframeBgColor = await iframe.evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(iframeBgColor).toBe(\"rgb(255, 0, 0)\");\n });\n\n test(\"with SPIF - sets background red in main page and iframe\", async () => {\n const page = await ctx.newPage();\n\n await page.goto(\n \"https://browserbase.github.io/stagehand-eval-sites/sites/ctx-add-init-script-spif/\",\n { waitUntil: \"networkidle\" },\n );\n\n // Click link to open popup\n await page.locator(\"a\").click();\n debugLog(\"popup-spif:clicked-link\", { openerUrl: page.url() });\n\n // Wait for popup to open and become active\n const popup = await waitForPopupPage(ctx, page);\n ctx.setActivePage(popup);\n await ensurePopupViewport(popup);\n await waitForPageUrl(\n popup,\n \"/stagehand-eval-sites/sites/closed-shadow-dom-in-spif/\",\n );\n await preparePopupForFrameAttach(popup, \"iframe\");\n const iframe = await waitForChildFrame(popup, POPUP_SPIF_CHILD_URL);\n\n // Check popup main page background\n const mainBgColor = await popup.mainFrame().evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(mainBgColor).toBe(\"rgb(255, 0, 0)\");\n\n const iframeBgColor = await iframe.evaluate(() => {\n return getComputedStyle(document.documentElement).backgroundColor;\n });\n expect(iframeBgColor).toBe(\"rgb(255, 0, 0)\");\n });\n });\n});\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,92 @@
1
+ import { V3 } from "../v3.js";
2
+ async function main() {
3
+ const encoded = process.argv.find((arg) => arg.startsWith("cfg:"));
4
+ if (!encoded) {
5
+ throw new Error("Missing child config payload.");
6
+ }
7
+ const raw = Buffer.from(encoded.slice(4), "base64").toString("utf8");
8
+ const cfg = JSON.parse(raw);
9
+ const {
10
+ env,
11
+ keepAlive,
12
+ disableAPI,
13
+ scenario,
14
+ apiKey,
15
+ projectId,
16
+ debug = false,
17
+ viewMs = 0
18
+ } = cfg;
19
+ const log = (message) => {
20
+ if (debug) {
21
+ console.log(message);
22
+ }
23
+ };
24
+ if (env !== "LOCAL" && env !== "BROWSERBASE") {
25
+ throw new Error("KEEP_ALIVE_ENV must be LOCAL or BROWSERBASE");
26
+ }
27
+ if (!scenario) {
28
+ throw new Error("KEEP_ALIVE_SCENARIO is required");
29
+ }
30
+ log(
31
+ `[keep-alive-child] env=${env} keepAlive=${keepAlive} disableAPI=${disableAPI} scenario=${scenario} apiKey=${apiKey ? "set" : "missing"} projectId=${projectId ? "set" : "missing"}`
32
+ );
33
+ const showBrowser = viewMs > 0;
34
+ const v3 = new V3({
35
+ env,
36
+ keepAlive,
37
+ disableAPI,
38
+ apiKey,
39
+ projectId,
40
+ browserbaseSessionCreateParams: void 0,
41
+ localBrowserLaunchOptions: env === "LOCAL" ? {
42
+ executablePath: process.env.CHROME_PATH,
43
+ args: process.env.CI ? ["--no-sandbox"] : void 0,
44
+ headless: !showBrowser,
45
+ viewport: { width: 1288, height: 711 }
46
+ } : void 0,
47
+ verbose: debug ? 2 : 0,
48
+ disablePino: true,
49
+ logger: debug ? (line) => console.log(line) : void 0
50
+ });
51
+ await v3.init();
52
+ const info = {
53
+ connectURL: v3.connectURL(),
54
+ sessionId: v3.browserbaseSessionId ?? null
55
+ };
56
+ await new Promise((resolve, reject) => {
57
+ process.stdout.write(`__KEEPALIVE__${JSON.stringify(info)}
58
+ `, (error) => {
59
+ if (error) {
60
+ reject(error);
61
+ return;
62
+ }
63
+ resolve();
64
+ });
65
+ });
66
+ if (env === "LOCAL" && viewMs > 0) {
67
+ await new Promise((r) => setTimeout(r, viewMs));
68
+ }
69
+ if (scenario === "close") {
70
+ await v3.close().catch(() => {
71
+ });
72
+ process.exit(0);
73
+ }
74
+ if (scenario === "sigterm") {
75
+ return;
76
+ }
77
+ if (scenario === "sigint") {
78
+ return;
79
+ }
80
+ if (scenario === "unhandled") {
81
+ setTimeout(() => {
82
+ void Promise.reject(new Error("keepAlive unhandled rejection"));
83
+ }, 0);
84
+ return;
85
+ }
86
+ throw new Error(`Unknown scenario: ${scenario}`);
87
+ }
88
+ main().catch((err) => {
89
+ console.error(err);
90
+ process.exit(1);
91
+ });
92
+ //# sourceMappingURL=keep-alive.child.js.map