@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,247 @@
1
+ var import_test = require("@playwright/test");
2
+ var import_v3 = require("../v3.js");
3
+ var import_v3_config = require("./v3.config.js");
4
+ var import_tools = require("../agent/tools/index.js");
5
+ var import_agentSystemPrompt = require("../agent/prompts/agentSystemPrompt.js");
6
+ import_test.test.describe("Stagehand agent hybrid mode", () => {
7
+ let v3;
8
+ import_test.test.beforeEach(async () => {
9
+ v3 = new import_v3.V3({
10
+ ...import_v3_config.v3TestConfig,
11
+ experimental: true
12
+ });
13
+ await v3.init();
14
+ });
15
+ import_test.test.afterEach(async () => {
16
+ await v3?.close?.().catch(() => {
17
+ });
18
+ });
19
+ import_test.test.describe("Tool filtering by mode", () => {
20
+ (0, import_test.test)("DOM mode includes DOM-based tools and excludes coordinate-based tools", () => {
21
+ const tools = (0, import_tools.createAgentTools)(v3, { mode: "dom" });
22
+ (0, import_test.expect)(tools).toHaveProperty("act");
23
+ (0, import_test.expect)(tools).toHaveProperty("fillForm");
24
+ (0, import_test.expect)(tools).toHaveProperty("ariaTree");
25
+ (0, import_test.expect)(tools).toHaveProperty("screenshot");
26
+ (0, import_test.expect)(tools).toHaveProperty("extract");
27
+ (0, import_test.expect)(tools).toHaveProperty("goto");
28
+ (0, import_test.expect)(tools).toHaveProperty("scroll");
29
+ (0, import_test.expect)(tools).toHaveProperty("wait");
30
+ (0, import_test.expect)(tools).toHaveProperty("navback");
31
+ (0, import_test.expect)(tools).toHaveProperty("keys");
32
+ (0, import_test.expect)(tools).toHaveProperty("think");
33
+ (0, import_test.expect)(tools).not.toHaveProperty("click");
34
+ (0, import_test.expect)(tools).not.toHaveProperty("type");
35
+ (0, import_test.expect)(tools).not.toHaveProperty("dragAndDrop");
36
+ (0, import_test.expect)(tools).not.toHaveProperty("clickAndHold");
37
+ (0, import_test.expect)(tools).not.toHaveProperty("fillFormVision");
38
+ });
39
+ (0, import_test.test)("Hybrid mode includes coordinate-based tools and excludes DOM fillForm", () => {
40
+ const tools = (0, import_tools.createAgentTools)(v3, { mode: "hybrid" });
41
+ (0, import_test.expect)(tools).toHaveProperty("click");
42
+ (0, import_test.expect)(tools).toHaveProperty("type");
43
+ (0, import_test.expect)(tools).toHaveProperty("dragAndDrop");
44
+ (0, import_test.expect)(tools).toHaveProperty("clickAndHold");
45
+ (0, import_test.expect)(tools).toHaveProperty("fillFormVision");
46
+ (0, import_test.expect)(tools).toHaveProperty("act");
47
+ (0, import_test.expect)(tools).toHaveProperty("ariaTree");
48
+ (0, import_test.expect)(tools).toHaveProperty("screenshot");
49
+ (0, import_test.expect)(tools).toHaveProperty("extract");
50
+ (0, import_test.expect)(tools).toHaveProperty("goto");
51
+ (0, import_test.expect)(tools).toHaveProperty("scroll");
52
+ (0, import_test.expect)(tools).toHaveProperty("wait");
53
+ (0, import_test.expect)(tools).toHaveProperty("navback");
54
+ (0, import_test.expect)(tools).toHaveProperty("keys");
55
+ (0, import_test.expect)(tools).toHaveProperty("think");
56
+ (0, import_test.expect)(tools).not.toHaveProperty("fillForm");
57
+ });
58
+ (0, import_test.test)("Default mode is DOM when not specified", () => {
59
+ const tools = (0, import_tools.createAgentTools)(v3, {});
60
+ (0, import_test.expect)(tools).toHaveProperty("fillForm");
61
+ (0, import_test.expect)(tools).not.toHaveProperty("click");
62
+ (0, import_test.expect)(tools).not.toHaveProperty("type");
63
+ });
64
+ });
65
+ import_test.test.describe("System prompt generation", () => {
66
+ (0, import_test.test)("DOM mode system prompt emphasizes ariaTree and act tool", () => {
67
+ const prompt = (0, import_agentSystemPrompt.buildAgentSystemPrompt)({
68
+ url: "https://example.com",
69
+ executionInstruction: "Test instruction",
70
+ mode: "dom"
71
+ });
72
+ (0, import_test.expect)(prompt).toContain("ariaTree");
73
+ (0, import_test.expect)(prompt).toContain("act");
74
+ (0, import_test.expect)(prompt).toContain("fillForm");
75
+ (0, import_test.expect)(prompt).toContain("Use act tool for all clicking and typing");
76
+ (0, import_test.expect)(prompt).toContain("Always check ariaTree first");
77
+ });
78
+ (0, import_test.test)("Hybrid mode system prompt emphasizes screenshot and coordinate tools", () => {
79
+ const prompt = (0, import_agentSystemPrompt.buildAgentSystemPrompt)({
80
+ url: "https://example.com",
81
+ executionInstruction: "Test instruction",
82
+ mode: "hybrid"
83
+ });
84
+ (0, import_test.expect)(prompt).toContain("click");
85
+ (0, import_test.expect)(prompt).toContain("type");
86
+ (0, import_test.expect)(prompt).toContain("fillFormVision");
87
+ (0, import_test.expect)(prompt).toContain("dragAndDrop");
88
+ (0, import_test.expect)(prompt).toContain(
89
+ "Use specific tools (click, type) when elements are visible"
90
+ );
91
+ (0, import_test.expect)(prompt).toContain("Always use screenshot");
92
+ });
93
+ (0, import_test.test)("System prompt includes custom instructions when provided", () => {
94
+ const customInstructions = "Always be polite and thorough";
95
+ const prompt = (0, import_agentSystemPrompt.buildAgentSystemPrompt)({
96
+ url: "https://example.com",
97
+ executionInstruction: "Test instruction",
98
+ mode: "dom",
99
+ systemInstructions: customInstructions
100
+ });
101
+ (0, import_test.expect)(prompt).toContain("customInstructions");
102
+ (0, import_test.expect)(prompt).toContain(customInstructions);
103
+ });
104
+ (0, import_test.test)("System prompt includes Browserbase captcha message when isBrowserbase is true", () => {
105
+ const prompt = (0, import_agentSystemPrompt.buildAgentSystemPrompt)({
106
+ url: "https://example.com",
107
+ executionInstruction: "Test instruction",
108
+ mode: "dom",
109
+ isBrowserbase: true
110
+ });
111
+ (0, import_test.expect)(prompt).toContain("captcha");
112
+ (0, import_test.expect)(prompt).toContain("automatically be solved");
113
+ });
114
+ (0, import_test.test)("System prompt does not include captcha message when isBrowserbase is false", () => {
115
+ const prompt = (0, import_agentSystemPrompt.buildAgentSystemPrompt)({
116
+ url: "https://example.com",
117
+ executionInstruction: "Test instruction",
118
+ mode: "dom",
119
+ isBrowserbase: false
120
+ });
121
+ (0, import_test.expect)(prompt).not.toContain("automatically be solved");
122
+ });
123
+ });
124
+ import_test.test.describe("Agent creation with mode", () => {
125
+ (0, import_test.test)("agent({ mode: 'dom' }) creates DOM-mode agent", () => {
126
+ const agent = v3.agent({
127
+ mode: "dom",
128
+ model: "anthropic/claude-haiku-4-5-20251001"
129
+ });
130
+ (0, import_test.expect)(agent).toHaveProperty("execute");
131
+ });
132
+ (0, import_test.test)("agent({ mode: 'hybrid' }) creates hybrid-mode agent", () => {
133
+ const agent = v3.agent({
134
+ mode: "hybrid",
135
+ model: "anthropic/claude-haiku-4-5-20251001"
136
+ });
137
+ (0, import_test.expect)(agent).toHaveProperty("execute");
138
+ });
139
+ (0, import_test.test)("agent without mode defaults to DOM mode", () => {
140
+ const agent = v3.agent({
141
+ model: "anthropic/claude-haiku-4-5-20251001"
142
+ });
143
+ (0, import_test.expect)(agent).toHaveProperty("execute");
144
+ });
145
+ (0, import_test.test)("hybrid mode can be combined with streaming", () => {
146
+ const agent = v3.agent({
147
+ mode: "hybrid",
148
+ stream: true,
149
+ model: "anthropic/claude-haiku-4-5-20251001"
150
+ });
151
+ (0, import_test.expect)(agent).toHaveProperty("execute");
152
+ });
153
+ });
154
+ import_test.test.describe("Hybrid mode execution", () => {
155
+ (0, import_test.test)("hybrid mode agent uses coordinate-based tools when available", async () => {
156
+ import_test.test.setTimeout(9e4);
157
+ const toolCalls = [];
158
+ const agent = v3.agent({
159
+ mode: "hybrid",
160
+ model: "anthropic/claude-haiku-4-5-20251001"
161
+ });
162
+ const page = v3.context.pages()[0];
163
+ await page.goto("https://example.com");
164
+ await agent.execute({
165
+ instruction: "Take a screenshot to see the page, then describe what you see briefly and mark the task as complete.",
166
+ maxSteps: 5,
167
+ callbacks: {
168
+ onStepFinish: async (event) => {
169
+ if (event.toolCalls) {
170
+ for (const tc of event.toolCalls) {
171
+ toolCalls.push({
172
+ toolName: tc.toolName,
173
+ input: tc.input
174
+ });
175
+ }
176
+ }
177
+ }
178
+ }
179
+ });
180
+ (0, import_test.expect)(toolCalls.length).toBeGreaterThan(0);
181
+ const toolNames = toolCalls.map((tc) => tc.toolName);
182
+ (0, import_test.expect)(toolNames).toContain("screenshot");
183
+ });
184
+ (0, import_test.test)("DOM mode agent uses DOM-based tools", async () => {
185
+ import_test.test.setTimeout(9e4);
186
+ const toolCalls = [];
187
+ const agent = v3.agent({
188
+ mode: "dom",
189
+ model: "anthropic/claude-haiku-4-5-20251001"
190
+ });
191
+ const page = v3.context.pages()[0];
192
+ await page.goto("https://example.com");
193
+ await agent.execute({
194
+ instruction: "Use the ariaTree to understand the page, then provide the final requested output or a summary of the page.",
195
+ maxSteps: 5,
196
+ callbacks: {
197
+ onStepFinish: async (event) => {
198
+ if (event.toolCalls) {
199
+ for (const tc of event.toolCalls) {
200
+ toolCalls.push({
201
+ toolName: tc.toolName,
202
+ input: tc.input
203
+ });
204
+ }
205
+ }
206
+ }
207
+ }
208
+ });
209
+ (0, import_test.expect)(toolCalls.length).toBeGreaterThan(0);
210
+ const toolNames = toolCalls.map((tc) => tc.toolName);
211
+ (0, import_test.expect)(toolNames).toContain("ariaTree");
212
+ });
213
+ });
214
+ import_test.test.describe("Scroll tool variants by mode", () => {
215
+ (0, import_test.test)("DOM mode uses simple scroll tool without coordinates", () => {
216
+ const tools = (0, import_tools.createAgentTools)(v3, { mode: "dom" });
217
+ (0, import_test.expect)(tools).toHaveProperty("scroll");
218
+ (0, import_test.expect)(typeof tools.scroll).toBe("object");
219
+ });
220
+ (0, import_test.test)("Hybrid mode uses vision scroll tool with optional coordinates", () => {
221
+ const tools = (0, import_tools.createAgentTools)(v3, { mode: "hybrid" });
222
+ (0, import_test.expect)(tools).toHaveProperty("scroll");
223
+ (0, import_test.expect)(typeof tools.scroll).toBe("object");
224
+ });
225
+ });
226
+ import_test.test.describe("Keys tool availability in both modes", () => {
227
+ (0, import_test.test)("Keys tool is available in DOM mode", () => {
228
+ const tools = (0, import_tools.createAgentTools)(v3, { mode: "dom" });
229
+ (0, import_test.expect)(tools).toHaveProperty("keys");
230
+ });
231
+ (0, import_test.test)("Keys tool is available in hybrid mode", () => {
232
+ const tools = (0, import_tools.createAgentTools)(v3, { mode: "hybrid" });
233
+ (0, import_test.expect)(tools).toHaveProperty("keys");
234
+ });
235
+ });
236
+ import_test.test.describe("Think tool availability", () => {
237
+ (0, import_test.test)("Think tool is available in DOM mode", () => {
238
+ const tools = (0, import_tools.createAgentTools)(v3, { mode: "dom" });
239
+ (0, import_test.expect)(tools).toHaveProperty("think");
240
+ });
241
+ (0, import_test.test)("Think tool is available in hybrid mode", () => {
242
+ const tools = (0, import_tools.createAgentTools)(v3, { mode: "hybrid" });
243
+ (0, import_test.expect)(tools).toHaveProperty("think");
244
+ });
245
+ });
246
+ });
247
+ //# sourceMappingURL=agent-hybrid-mode.spec.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../lib/v3/tests/agent-hybrid-mode.spec.ts"],
4
+ "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport { createAgentTools } from \"../agent/tools/index.js\";\nimport { buildAgentSystemPrompt } from \"../agent/prompts/agentSystemPrompt.js\";\nimport type { StepResult, ToolSet } from \"ai\";\n\ntest.describe(\"Stagehand agent hybrid mode\", () => {\n let v3: V3;\n\n test.beforeEach(async () => {\n v3 = new V3({\n ...v3TestConfig,\n experimental: true,\n });\n await v3.init();\n });\n\n test.afterEach(async () => {\n await v3?.close?.().catch(() => {});\n });\n\n test.describe(\"Tool filtering by mode\", () => {\n test(\"DOM mode includes DOM-based tools and excludes coordinate-based tools\", () => {\n const tools = createAgentTools(v3, { mode: \"dom\" });\n\n // DOM mode should have these tools\n expect(tools).toHaveProperty(\"act\");\n expect(tools).toHaveProperty(\"fillForm\");\n expect(tools).toHaveProperty(\"ariaTree\");\n expect(tools).toHaveProperty(\"screenshot\");\n expect(tools).toHaveProperty(\"extract\");\n expect(tools).toHaveProperty(\"goto\");\n expect(tools).toHaveProperty(\"scroll\");\n expect(tools).toHaveProperty(\"wait\");\n expect(tools).toHaveProperty(\"navback\");\n expect(tools).toHaveProperty(\"keys\");\n expect(tools).toHaveProperty(\"think\");\n\n // DOM mode should NOT have coordinate-based tools\n expect(tools).not.toHaveProperty(\"click\");\n expect(tools).not.toHaveProperty(\"type\");\n expect(tools).not.toHaveProperty(\"dragAndDrop\");\n expect(tools).not.toHaveProperty(\"clickAndHold\");\n expect(tools).not.toHaveProperty(\"fillFormVision\");\n });\n\n test(\"Hybrid mode includes coordinate-based tools and excludes DOM fillForm\", () => {\n const tools = createAgentTools(v3, { mode: \"hybrid\" });\n\n // Hybrid mode should have coordinate-based tools\n expect(tools).toHaveProperty(\"click\");\n expect(tools).toHaveProperty(\"type\");\n expect(tools).toHaveProperty(\"dragAndDrop\");\n expect(tools).toHaveProperty(\"clickAndHold\");\n expect(tools).toHaveProperty(\"fillFormVision\");\n\n // Hybrid mode should also have common tools\n expect(tools).toHaveProperty(\"act\");\n expect(tools).toHaveProperty(\"ariaTree\");\n expect(tools).toHaveProperty(\"screenshot\");\n expect(tools).toHaveProperty(\"extract\");\n expect(tools).toHaveProperty(\"goto\");\n expect(tools).toHaveProperty(\"scroll\");\n expect(tools).toHaveProperty(\"wait\");\n expect(tools).toHaveProperty(\"navback\");\n expect(tools).toHaveProperty(\"keys\");\n expect(tools).toHaveProperty(\"think\");\n\n // Hybrid mode should NOT have DOM-based fillForm\n expect(tools).not.toHaveProperty(\"fillForm\");\n });\n\n test(\"Default mode is DOM when not specified\", () => {\n const tools = createAgentTools(v3, {});\n\n // Should behave like DOM mode\n expect(tools).toHaveProperty(\"fillForm\");\n expect(tools).not.toHaveProperty(\"click\");\n expect(tools).not.toHaveProperty(\"type\");\n });\n });\n\n test.describe(\"System prompt generation\", () => {\n test(\"DOM mode system prompt emphasizes ariaTree and act tool\", () => {\n const prompt = buildAgentSystemPrompt({\n url: \"https://example.com\",\n executionInstruction: \"Test instruction\",\n mode: \"dom\",\n });\n\n // DOM mode should prioritize ariaTree\n expect(prompt).toContain(\"ariaTree\");\n expect(prompt).toContain(\"act\");\n expect(prompt).toContain(\"fillForm\");\n\n // Should have DOM-specific strategy\n expect(prompt).toContain(\"Use act tool for all clicking and typing\");\n expect(prompt).toContain(\"Always check ariaTree first\");\n });\n\n test(\"Hybrid mode system prompt emphasizes screenshot and coordinate tools\", () => {\n const prompt = buildAgentSystemPrompt({\n url: \"https://example.com\",\n executionInstruction: \"Test instruction\",\n mode: \"hybrid\",\n });\n\n // Hybrid mode should have coordinate-based tools mentioned\n expect(prompt).toContain(\"click\");\n expect(prompt).toContain(\"type\");\n expect(prompt).toContain(\"fillFormVision\");\n expect(prompt).toContain(\"dragAndDrop\");\n\n // Should have hybrid-specific strategy\n expect(prompt).toContain(\n \"Use specific tools (click, type) when elements are visible\",\n );\n expect(prompt).toContain(\"Always use screenshot\");\n });\n\n test(\"System prompt includes custom instructions when provided\", () => {\n const customInstructions = \"Always be polite and thorough\";\n const prompt = buildAgentSystemPrompt({\n url: \"https://example.com\",\n executionInstruction: \"Test instruction\",\n mode: \"dom\",\n systemInstructions: customInstructions,\n });\n\n expect(prompt).toContain(\"customInstructions\");\n expect(prompt).toContain(customInstructions);\n });\n\n test(\"System prompt includes Browserbase captcha message when isBrowserbase is true\", () => {\n const prompt = buildAgentSystemPrompt({\n url: \"https://example.com\",\n executionInstruction: \"Test instruction\",\n mode: \"dom\",\n isBrowserbase: true,\n });\n\n expect(prompt).toContain(\"captcha\");\n expect(prompt).toContain(\"automatically be solved\");\n });\n\n test(\"System prompt does not include captcha message when isBrowserbase is false\", () => {\n const prompt = buildAgentSystemPrompt({\n url: \"https://example.com\",\n executionInstruction: \"Test instruction\",\n mode: \"dom\",\n isBrowserbase: false,\n });\n\n expect(prompt).not.toContain(\"automatically be solved\");\n });\n });\n\n test.describe(\"Agent creation with mode\", () => {\n test(\"agent({ mode: 'dom' }) creates DOM-mode agent\", () => {\n const agent = v3.agent({\n mode: \"dom\",\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n expect(agent).toHaveProperty(\"execute\");\n });\n\n test(\"agent({ mode: 'hybrid' }) creates hybrid-mode agent\", () => {\n const agent = v3.agent({\n mode: \"hybrid\",\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n expect(agent).toHaveProperty(\"execute\");\n });\n\n test(\"agent without mode defaults to DOM mode\", () => {\n const agent = v3.agent({\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n expect(agent).toHaveProperty(\"execute\");\n });\n\n test(\"hybrid mode can be combined with streaming\", () => {\n const agent = v3.agent({\n mode: \"hybrid\",\n stream: true,\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n expect(agent).toHaveProperty(\"execute\");\n });\n });\n\n test.describe(\"Hybrid mode execution\", () => {\n test(\"hybrid mode agent uses coordinate-based tools when available\", async () => {\n test.setTimeout(90000);\n\n const toolCalls: Array<{ toolName: string; input: unknown }> = [];\n\n const agent = v3.agent({\n mode: \"hybrid\",\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n await agent.execute({\n instruction:\n \"Take a screenshot to see the page, then describe what you see briefly and mark the task as complete.\",\n maxSteps: 5,\n callbacks: {\n onStepFinish: async (event: StepResult<ToolSet>) => {\n if (event.toolCalls) {\n for (const tc of event.toolCalls) {\n toolCalls.push({\n toolName: tc.toolName,\n input: tc.input,\n });\n }\n }\n },\n },\n });\n\n // Should have captured tool calls\n expect(toolCalls.length).toBeGreaterThan(0);\n\n const toolNames = toolCalls.map((tc) => tc.toolName);\n // Should include screenshot (hybrid mode emphasizes visual)\n expect(toolNames).toContain(\"screenshot\");\n });\n\n test(\"DOM mode agent uses DOM-based tools\", async () => {\n test.setTimeout(90000);\n\n const toolCalls: Array<{ toolName: string; input: unknown }> = [];\n\n const agent = v3.agent({\n mode: \"dom\",\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n await agent.execute({\n instruction:\n \"Use the ariaTree to understand the page, then provide the final requested output or a summary of the page.\",\n maxSteps: 5,\n callbacks: {\n onStepFinish: async (event: StepResult<ToolSet>) => {\n if (event.toolCalls) {\n for (const tc of event.toolCalls) {\n toolCalls.push({\n toolName: tc.toolName,\n input: tc.input,\n });\n }\n }\n },\n },\n });\n\n // Should have captured tool calls\n expect(toolCalls.length).toBeGreaterThan(0);\n\n // Should include ariaTree (DOM mode emphasizes aria-based interaction)\n const toolNames = toolCalls.map((tc) => tc.toolName);\n expect(toolNames).toContain(\"ariaTree\");\n });\n });\n\n test.describe(\"Scroll tool variants by mode\", () => {\n test(\"DOM mode uses simple scroll tool without coordinates\", () => {\n const tools = createAgentTools(v3, { mode: \"dom\" });\n\n expect(tools).toHaveProperty(\"scroll\");\n // The DOM scroll tool should exist\n expect(typeof tools.scroll).toBe(\"object\");\n });\n\n test(\"Hybrid mode uses vision scroll tool with optional coordinates\", () => {\n const tools = createAgentTools(v3, { mode: \"hybrid\" });\n\n expect(tools).toHaveProperty(\"scroll\");\n // The hybrid scroll tool should exist\n expect(typeof tools.scroll).toBe(\"object\");\n });\n });\n\n test.describe(\"Keys tool availability in both modes\", () => {\n test(\"Keys tool is available in DOM mode\", () => {\n const tools = createAgentTools(v3, { mode: \"dom\" });\n expect(tools).toHaveProperty(\"keys\");\n });\n\n test(\"Keys tool is available in hybrid mode\", () => {\n const tools = createAgentTools(v3, { mode: \"hybrid\" });\n expect(tools).toHaveProperty(\"keys\");\n });\n });\n\n test.describe(\"Think tool availability\", () => {\n test(\"Think tool is available in DOM mode\", () => {\n const tools = createAgentTools(v3, { mode: \"dom\" });\n expect(tools).toHaveProperty(\"think\");\n });\n\n test(\"Think tool is available in hybrid mode\", () => {\n const tools = createAgentTools(v3, { mode: \"hybrid\" });\n expect(tools).toHaveProperty(\"think\");\n });\n });\n});\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,105 @@
1
+ var import_test = require("@playwright/test");
2
+ var import_v3 = require("../v3.js");
3
+ var import_v3_config = require("./v3.config.js");
4
+ import_test.test.describe("Stagehand agent message continuation", () => {
5
+ let v3;
6
+ import_test.test.beforeEach(async () => {
7
+ v3 = new import_v3.V3({
8
+ ...import_v3_config.v3TestConfig,
9
+ experimental: true
10
+ });
11
+ await v3.init();
12
+ });
13
+ import_test.test.afterEach(async () => {
14
+ await v3?.close?.().catch(() => {
15
+ });
16
+ });
17
+ (0, import_test.test)("execute returns messages in the result", async () => {
18
+ import_test.test.setTimeout(6e4);
19
+ const agent = v3.agent({
20
+ model: "anthropic/claude-haiku-4-5-20251001"
21
+ });
22
+ const page = v3.context.pages()[0];
23
+ await page.goto("https://example.com");
24
+ const result = await agent.execute({
25
+ instruction: "What is the title of this page? Describe it briefly.",
26
+ maxSteps: 5
27
+ });
28
+ (0, import_test.expect)(result.messages).toBeDefined();
29
+ (0, import_test.expect)(Array.isArray(result.messages)).toBe(true);
30
+ (0, import_test.expect)(result.messages.length).toBeGreaterThan(0);
31
+ const firstMessage = result.messages[0];
32
+ (0, import_test.expect)(firstMessage.role).toBe("user");
33
+ });
34
+ (0, import_test.test)("can continue conversation with previous messages", async () => {
35
+ import_test.test.setTimeout(12e4);
36
+ const agent = v3.agent({
37
+ model: "anthropic/claude-haiku-4-5-20251001"
38
+ });
39
+ const page = v3.context.pages()[0];
40
+ await page.goto("https://example.com");
41
+ const result1 = await agent.execute({
42
+ instruction: "What is the title of this page? Describe it briefly.",
43
+ maxSteps: 5
44
+ });
45
+ (0, import_test.expect)(result1.messages).toBeDefined();
46
+ (0, import_test.expect)(result1.messages.length).toBeGreaterThan(0);
47
+ const result2 = await agent.execute({
48
+ instruction: "Based on what you just told me, is this a simple or complex website? Answer briefly.",
49
+ maxSteps: 5,
50
+ messages: result1.messages
51
+ });
52
+ (0, import_test.expect)(result2.messages).toBeDefined();
53
+ (0, import_test.expect)(result2.messages.length).toBeGreaterThan(result1.messages.length);
54
+ });
55
+ (0, import_test.test)("messages include tool calls and results", async () => {
56
+ import_test.test.setTimeout(6e4);
57
+ const agent = v3.agent({
58
+ model: "anthropic/claude-haiku-4-5-20251001"
59
+ });
60
+ const page = v3.context.pages()[0];
61
+ await page.goto("https://example.com");
62
+ const result = await agent.execute({
63
+ instruction: "Use the ariaTree tool to see the page, then describe what you found briefly.",
64
+ maxSteps: 5
65
+ });
66
+ (0, import_test.expect)(result.messages).toBeDefined();
67
+ const assistantMessages = result.messages.filter(
68
+ (m) => m.role === "assistant"
69
+ );
70
+ (0, import_test.expect)(assistantMessages.length).toBeGreaterThan(0);
71
+ const hasToolCalls = assistantMessages.some((m) => {
72
+ if (Array.isArray(m.content)) {
73
+ return m.content.some(
74
+ (part) => typeof part === "object" && part.type === "tool-call"
75
+ );
76
+ }
77
+ return false;
78
+ });
79
+ (0, import_test.expect)(hasToolCalls).toBe(true);
80
+ const hasToolResults = result.messages.some(
81
+ (m) => m.role === "tool"
82
+ );
83
+ (0, import_test.expect)(hasToolResults).toBe(true);
84
+ });
85
+ (0, import_test.test)("streaming mode also returns messages", async () => {
86
+ import_test.test.setTimeout(6e4);
87
+ const agent = v3.agent({
88
+ stream: true,
89
+ model: "anthropic/claude-haiku-4-5-20251001"
90
+ });
91
+ const page = v3.context.pages()[0];
92
+ await page.goto("https://example.com");
93
+ const streamResult = await agent.execute({
94
+ instruction: "What is this page? Describe it briefly.",
95
+ maxSteps: 5
96
+ });
97
+ for await (const _ of streamResult.textStream) {
98
+ }
99
+ const result = await streamResult.result;
100
+ (0, import_test.expect)(result.messages).toBeDefined();
101
+ (0, import_test.expect)(Array.isArray(result.messages)).toBe(true);
102
+ (0, import_test.expect)(result.messages.length).toBeGreaterThan(0);
103
+ });
104
+ });
105
+ //# sourceMappingURL=agent-message-continuation.spec.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../lib/v3/tests/agent-message-continuation.spec.ts"],
4
+ "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport type { ModelMessage } from \"ai\";\n\ntest.describe(\"Stagehand agent message continuation\", () => {\n let v3: V3;\n\n test.beforeEach(async () => {\n v3 = new V3({\n ...v3TestConfig,\n experimental: true,\n });\n await v3.init();\n });\n\n test.afterEach(async () => {\n await v3?.close?.().catch(() => {});\n });\n\n test(\"execute returns messages in the result\", async () => {\n test.setTimeout(60000);\n\n const agent = v3.agent({\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n const result = await agent.execute({\n instruction: \"What is the title of this page? Describe it briefly.\",\n maxSteps: 5,\n });\n\n // Result should contain messages\n expect(result.messages).toBeDefined();\n expect(Array.isArray(result.messages)).toBe(true);\n expect(result.messages!.length).toBeGreaterThan(0);\n\n // First message should be the user instruction\n const firstMessage = result.messages![0];\n expect(firstMessage.role).toBe(\"user\");\n });\n\n test(\"can continue conversation with previous messages\", async () => {\n test.setTimeout(120000);\n\n const agent = v3.agent({\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n // First execution\n const result1 = await agent.execute({\n instruction: \"What is the title of this page? Describe it briefly.\",\n maxSteps: 5,\n });\n\n expect(result1.messages).toBeDefined();\n expect(result1.messages!.length).toBeGreaterThan(0);\n\n // Second execution continuing from first\n const result2 = await agent.execute({\n instruction:\n \"Based on what you just told me, is this a simple or complex website? Answer briefly.\",\n maxSteps: 5,\n messages: result1.messages,\n });\n\n expect(result2.messages).toBeDefined();\n // Second result should have more messages (includes first conversation)\n expect(result2.messages!.length).toBeGreaterThan(result1.messages!.length);\n });\n\n test(\"messages include tool calls and results\", async () => {\n test.setTimeout(60000);\n\n const agent = v3.agent({\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n const result = await agent.execute({\n instruction:\n \"Use the ariaTree tool to see the page, then describe what you found briefly.\",\n maxSteps: 5,\n });\n\n expect(result.messages).toBeDefined();\n\n // Verify there are assistant messages\n const assistantMessages = result.messages!.filter(\n (m: ModelMessage) => m.role === \"assistant\",\n );\n expect(assistantMessages.length).toBeGreaterThan(0);\n\n // Verify at least one assistant message contains tool calls\n const hasToolCalls = assistantMessages.some((m: ModelMessage) => {\n if (Array.isArray(m.content)) {\n return m.content.some(\n (part) => typeof part === \"object\" && part.type === \"tool-call\",\n );\n }\n return false;\n });\n expect(hasToolCalls).toBe(true);\n\n // Verify there are tool result messages\n const hasToolResults = result.messages!.some(\n (m: ModelMessage) => m.role === \"tool\",\n );\n expect(hasToolResults).toBe(true);\n });\n\n test(\"streaming mode also returns messages\", async () => {\n test.setTimeout(60000);\n\n const agent = v3.agent({\n stream: true,\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n const streamResult = await agent.execute({\n instruction: \"What is this page? Describe it briefly.\",\n maxSteps: 5,\n });\n\n // Consume the stream\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n for await (const _ of streamResult.textStream) {\n // Just consume\n }\n\n const result = await streamResult.result;\n\n // Result should contain messages\n expect(result.messages).toBeDefined();\n expect(Array.isArray(result.messages)).toBe(true);\n expect(result.messages!.length).toBeGreaterThan(0);\n });\n});\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,126 @@
1
+ var import_test = require("@playwright/test");
2
+ var import_v3 = require("../v3.js");
3
+ var import_v3_config = require("./v3.config.js");
4
+ import_test.test.describe("Stagehand agent streaming behavior", () => {
5
+ let v3;
6
+ import_test.test.beforeEach(async () => {
7
+ v3 = new import_v3.V3({
8
+ ...import_v3_config.v3TestConfig,
9
+ experimental: true
10
+ // Required for streaming
11
+ });
12
+ await v3.init();
13
+ });
14
+ import_test.test.afterEach(async () => {
15
+ await v3?.close?.().catch(() => {
16
+ });
17
+ });
18
+ import_test.test.describe("agent({ stream: true })", () => {
19
+ (0, import_test.test)("AgentStreamResult has textStream as async iterable", async () => {
20
+ import_test.test.setTimeout(6e4);
21
+ const agent = v3.agent({
22
+ stream: true,
23
+ model: "anthropic/claude-haiku-4-5-20251001"
24
+ });
25
+ const page = v3.context.pages()[0];
26
+ await page.goto("https://example.com");
27
+ const streamResult = await agent.execute({
28
+ instruction: "What is the title of this page? Describe it briefly.",
29
+ maxSteps: 3
30
+ });
31
+ (0, import_test.expect)(streamResult).toHaveProperty("textStream");
32
+ (0, import_test.expect)(streamResult).toHaveProperty("result");
33
+ (0, import_test.expect)(typeof streamResult.textStream[Symbol.asyncIterator]).toBe(
34
+ "function"
35
+ );
36
+ (0, import_test.expect)(streamResult.result).toBeInstanceOf(Promise);
37
+ });
38
+ (0, import_test.test)("textStream yields chunks incrementally", async () => {
39
+ import_test.test.setTimeout(6e4);
40
+ const agent = v3.agent({
41
+ stream: true,
42
+ model: "anthropic/claude-haiku-4-5-20251001"
43
+ });
44
+ const page = v3.context.pages()[0];
45
+ await page.goto("https://example.com");
46
+ const streamResult = await agent.execute({
47
+ instruction: "Say hello briefly.",
48
+ maxSteps: 3
49
+ });
50
+ const chunks = [];
51
+ for await (const chunk of streamResult.textStream) {
52
+ chunks.push(chunk);
53
+ }
54
+ (0, import_test.expect)(Array.isArray(chunks)).toBe(true);
55
+ (0, import_test.expect)(chunks.length).toBeGreaterThan(0);
56
+ });
57
+ (0, import_test.test)("result promise resolves to AgentResult after stream completes", async () => {
58
+ import_test.test.setTimeout(6e4);
59
+ const agent = v3.agent({
60
+ stream: true,
61
+ model: "anthropic/claude-haiku-4-5-20251001"
62
+ });
63
+ const page = v3.context.pages()[0];
64
+ await page.goto("https://example.com");
65
+ const streamResult = await agent.execute({
66
+ instruction: "What is this page about? Describe it briefly.",
67
+ maxSteps: 5
68
+ });
69
+ for await (const _ of streamResult.textStream) {
70
+ }
71
+ const finalResult = await streamResult.result;
72
+ (0, import_test.expect)(finalResult).toHaveProperty("success");
73
+ (0, import_test.expect)(finalResult).toHaveProperty("message");
74
+ (0, import_test.expect)(finalResult).toHaveProperty("actions");
75
+ (0, import_test.expect)(finalResult).toHaveProperty("completed");
76
+ (0, import_test.expect)(typeof finalResult.success).toBe("boolean");
77
+ (0, import_test.expect)(typeof finalResult.message).toBe("string");
78
+ (0, import_test.expect)(Array.isArray(finalResult.actions)).toBe(true);
79
+ });
80
+ });
81
+ import_test.test.describe("agent({ stream: false }) or agent()", () => {
82
+ (0, import_test.test)("execute returns AgentResult without streaming properties", async () => {
83
+ import_test.test.setTimeout(6e4);
84
+ const agent = v3.agent({
85
+ model: "anthropic/claude-haiku-4-5-20251001"
86
+ });
87
+ const page = v3.context.pages()[0];
88
+ await page.goto("https://example.com");
89
+ const result = await agent.execute({
90
+ instruction: "What is this page? Describe it briefly.",
91
+ maxSteps: 3
92
+ });
93
+ (0, import_test.expect)(result).toHaveProperty("success");
94
+ (0, import_test.expect)(result).toHaveProperty("message");
95
+ (0, import_test.expect)(result).toHaveProperty("actions");
96
+ (0, import_test.expect)(result).toHaveProperty("completed");
97
+ (0, import_test.expect)(result).not.toHaveProperty("textStream");
98
+ });
99
+ });
100
+ import_test.test.describe("CUA disables streaming", () => {
101
+ (0, import_test.test)("throws StagehandInvalidArgumentError when cua: true and stream: true", () => {
102
+ (0, import_test.expect)(() => {
103
+ v3.agent({
104
+ cua: true,
105
+ stream: true,
106
+ model: "anthropic/claude-haiku-4-5-20251001"
107
+ });
108
+ }).toThrow("streaming is not supported with CUA");
109
+ });
110
+ (0, import_test.test)("allows cua: true without stream", () => {
111
+ const agent = v3.agent({
112
+ cua: true,
113
+ model: "anthropic/claude-haiku-4-5-20251001"
114
+ });
115
+ (0, import_test.expect)(agent).toHaveProperty("execute");
116
+ });
117
+ (0, import_test.test)("allows stream: true without cua", () => {
118
+ const agent = v3.agent({
119
+ stream: true,
120
+ model: "anthropic/claude-haiku-4-5-20251001"
121
+ });
122
+ (0, import_test.expect)(agent).toHaveProperty("execute");
123
+ });
124
+ });
125
+ });
126
+ //# sourceMappingURL=agent-streaming.spec.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../lib/v3/tests/agent-streaming.spec.ts"],
4
+ "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport type { AgentResult } from \"../types/public/agent.js\";\n\ntest.describe(\"Stagehand agent streaming behavior\", () => {\n let v3: V3;\n\n test.beforeEach(async () => {\n v3 = new V3({\n ...v3TestConfig,\n experimental: true, // Required for streaming\n });\n await v3.init();\n });\n\n test.afterEach(async () => {\n await v3?.close?.().catch(() => {});\n });\n\n test.describe(\"agent({ stream: true })\", () => {\n test(\"AgentStreamResult has textStream as async iterable\", async () => {\n test.setTimeout(60000);\n\n const agent = v3.agent({\n stream: true,\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n // Navigate to a simple page first\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n const streamResult = await agent.execute({\n instruction: \"What is the title of this page? Describe it briefly.\",\n maxSteps: 3,\n });\n\n // Verify it's an AgentStreamResult with streaming capabilities\n expect(streamResult).toHaveProperty(\"textStream\");\n expect(streamResult).toHaveProperty(\"result\");\n\n // textStream should be async iterable\n expect(typeof streamResult.textStream[Symbol.asyncIterator]).toBe(\n \"function\",\n );\n\n // result should be a promise\n expect(streamResult.result).toBeInstanceOf(Promise);\n });\n\n test(\"textStream yields chunks incrementally\", async () => {\n test.setTimeout(60000);\n\n const agent = v3.agent({\n stream: true,\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n const streamResult = await agent.execute({\n instruction: \"Say hello briefly.\",\n maxSteps: 3,\n });\n\n // Collect chunks from the stream\n const chunks: string[] = [];\n for await (const chunk of streamResult.textStream) {\n chunks.push(chunk);\n }\n\n // Should have received at least some chunks (streaming behavior)\n // The exact content depends on the LLM response\n expect(Array.isArray(chunks)).toBe(true);\n expect(chunks.length).toBeGreaterThan(0);\n });\n\n test(\"result promise resolves to AgentResult after stream completes\", async () => {\n test.setTimeout(60000);\n\n const agent = v3.agent({\n stream: true,\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n const streamResult = await agent.execute({\n instruction: \"What is this page about? Describe it briefly.\",\n maxSteps: 5,\n });\n\n // Consume the stream first\n // eslint-disable-next-line @typescript-eslint/no-unused-vars\n for await (const _ of streamResult.textStream) {\n // Just consume\n }\n\n // Now get the final result\n const finalResult: AgentResult = await streamResult.result;\n\n // Verify it's a proper AgentResult\n expect(finalResult).toHaveProperty(\"success\");\n expect(finalResult).toHaveProperty(\"message\");\n expect(finalResult).toHaveProperty(\"actions\");\n expect(finalResult).toHaveProperty(\"completed\");\n expect(typeof finalResult.success).toBe(\"boolean\");\n expect(typeof finalResult.message).toBe(\"string\");\n expect(Array.isArray(finalResult.actions)).toBe(true);\n });\n });\n\n test.describe(\"agent({ stream: false }) or agent()\", () => {\n test(\"execute returns AgentResult without streaming properties\", async () => {\n test.setTimeout(60000);\n\n const agent = v3.agent({\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n const page = v3.context.pages()[0];\n await page.goto(\"https://example.com\");\n\n const result = await agent.execute({\n instruction: \"What is this page? Describe it briefly.\",\n maxSteps: 3,\n });\n // Should be AgentResult, not AgentStreamResult\n expect(result).toHaveProperty(\"success\");\n expect(result).toHaveProperty(\"message\");\n expect(result).toHaveProperty(\"actions\");\n expect(result).toHaveProperty(\"completed\");\n\n // Should NOT have streaming properties\n expect(result).not.toHaveProperty(\"textStream\");\n });\n });\n\n test.describe(\"CUA disables streaming\", () => {\n test(\"throws StagehandInvalidArgumentError when cua: true and stream: true\", () => {\n expect(() => {\n v3.agent({\n cua: true,\n stream: true,\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n }).toThrow(\"streaming is not supported with CUA\");\n });\n\n test(\"allows cua: true without stream\", () => {\n // Should not throw\n const agent = v3.agent({\n cua: true,\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n expect(agent).toHaveProperty(\"execute\");\n });\n\n test(\"allows stream: true without cua\", () => {\n // Should not throw\n const agent = v3.agent({\n stream: true,\n model: \"anthropic/claude-haiku-4-5-20251001\",\n });\n\n expect(agent).toHaveProperty(\"execute\");\n });\n });\n});\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,44 @@
1
+ var import_test = require("@playwright/test");
2
+ var import_playwright = require("playwright");
3
+ var import_v3 = require("../v3.js");
4
+ var import_v3_config = require("./v3.config.js");
5
+ import_test.test.describe("CDP session detach handling", () => {
6
+ let v3;
7
+ import_test.test.beforeEach(async () => {
8
+ v3 = new import_v3.V3(import_v3_config.v3TestConfig);
9
+ await v3.init();
10
+ });
11
+ import_test.test.afterEach(async () => {
12
+ await v3?.close?.().catch(() => {
13
+ });
14
+ });
15
+ (0, import_test.test)("rejects inflight CDP calls when a target is closed", async () => {
16
+ const unhandled = [];
17
+ const onUnhandled = (reason) => {
18
+ unhandled.push(reason);
19
+ };
20
+ process.on("unhandledRejection", onUnhandled);
21
+ let pwBrowser = null;
22
+ try {
23
+ pwBrowser = await import_playwright.chromium.connectOverCDP(v3.connectURL());
24
+ const pwContext = pwBrowser.contexts()[0];
25
+ const pwPage = pwContext.pages()[0];
26
+ const v3Page = v3.context.pages()[0];
27
+ await v3Page.goto("data:text/html,<html><body>cdp</body></html>");
28
+ const pending = v3Page.sendCDP("Runtime.evaluate", {
29
+ expression: "new Promise(r => setTimeout(() => r('done'), 5000))",
30
+ awaitPromise: true,
31
+ returnByValue: true
32
+ });
33
+ await pwPage.close();
34
+ await (0, import_test.expect)(pending).rejects.toThrow(/CDP session detached/);
35
+ await new Promise((r) => setTimeout(r, 50));
36
+ (0, import_test.expect)(unhandled).toHaveLength(0);
37
+ } finally {
38
+ process.off("unhandledRejection", onUnhandled);
39
+ await pwBrowser?.close().catch(() => {
40
+ });
41
+ }
42
+ });
43
+ });
44
+ //# sourceMappingURL=cdp-session-detached.spec.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../lib/v3/tests/cdp-session-detached.spec.ts"],
4
+ "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { chromium as playwrightChromium } from \"playwright\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\n\ntest.describe(\"CDP session detach handling\", () => {\n let v3: V3;\n\n test.beforeEach(async () => {\n v3 = new V3(v3TestConfig);\n await v3.init();\n });\n\n test.afterEach(async () => {\n await v3?.close?.().catch(() => {});\n });\n\n test(\"rejects inflight CDP calls when a target is closed\", async () => {\n const unhandled: unknown[] = [];\n const onUnhandled = (reason: unknown) => {\n unhandled.push(reason);\n };\n\n process.on(\"unhandledRejection\", onUnhandled);\n\n let pwBrowser: Awaited<\n ReturnType<typeof playwrightChromium.connectOverCDP>\n > | null = null;\n\n try {\n pwBrowser = await playwrightChromium.connectOverCDP(v3.connectURL());\n const pwContext = pwBrowser.contexts()[0];\n const pwPage = pwContext.pages()[0];\n\n const v3Page = v3.context.pages()[0];\n await v3Page.goto(\"data:text/html,<html><body>cdp</body></html>\");\n\n const pending = v3Page.sendCDP(\"Runtime.evaluate\", {\n expression: \"new Promise(r => setTimeout(() => r('done'), 5000))\",\n awaitPromise: true,\n returnByValue: true,\n });\n\n await pwPage.close();\n\n await expect(pending).rejects.toThrow(/CDP session detached/);\n\n await new Promise((r) => setTimeout(r, 50));\n expect(unhandled).toHaveLength(0);\n } finally {\n process.off(\"unhandledRejection\", onUnhandled);\n await pwBrowser?.close().catch(() => {});\n }\n });\n});\n"],
5
+ "mappings": "AAAA,kBAA6B;AAC7B,wBAA+C;AAC/C,gBAAmB;AACnB,uBAA6B;AAE7B,iBAAK,SAAS,+BAA+B,MAAM;AACjD,MAAI;AAEJ,mBAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,aAAG,6BAAY;AACxB,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,mBAAK,UAAU,YAAY;AACzB,UAAM,IAAI,QAAQ,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACpC,CAAC;AAED,wBAAK,sDAAsD,YAAY;AACrE,UAAM,YAAuB,CAAC;AAC9B,UAAM,cAAc,CAAC,WAAoB;AACvC,gBAAU,KAAK,MAAM;AAAA,IACvB;AAEA,YAAQ,GAAG,sBAAsB,WAAW;AAE5C,QAAI,YAEO;AAEX,QAAI;AACF,kBAAY,MAAM,kBAAAA,SAAmB,eAAe,GAAG,WAAW,CAAC;AACnE,YAAM,YAAY,UAAU,SAAS,EAAE,CAAC;AACxC,YAAM,SAAS,UAAU,MAAM,EAAE,CAAC;AAElC,YAAM,SAAS,GAAG,QAAQ,MAAM,EAAE,CAAC;AACnC,YAAM,OAAO,KAAK,8CAA8C;AAEhE,YAAM,UAAU,OAAO,QAAQ,oBAAoB;AAAA,QACjD,YAAY;AAAA,QACZ,cAAc;AAAA,QACd,eAAe;AAAA,MACjB,CAAC;AAED,YAAM,OAAO,MAAM;AAEnB,gBAAM,oBAAO,OAAO,EAAE,QAAQ,QAAQ,sBAAsB;AAE5D,YAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAC1C,8BAAO,SAAS,EAAE,aAAa,CAAC;AAAA,IAClC,UAAE;AACA,cAAQ,IAAI,sBAAsB,WAAW;AAC7C,YAAM,WAAW,MAAM,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAAA,IACzC;AAAA,EACF,CAAC;AACH,CAAC;",
6
+ "names": ["playwrightChromium"]
7
+ }