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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (655) hide show
  1. package/dist/esm/index.d.ts +3 -0
  2. package/dist/esm/index.js +3 -0
  3. package/dist/esm/lib/inference.d.ts +65 -0
  4. package/dist/esm/lib/inference.js +333 -0
  5. package/dist/esm/lib/inference.js.map +1 -0
  6. package/dist/esm/lib/inferenceLogUtils.d.ts +12 -0
  7. package/dist/esm/lib/inferenceLogUtils.js +92 -0
  8. package/dist/esm/lib/inferenceLogUtils.js.map +1 -0
  9. package/dist/esm/lib/logger.d.ts +69 -0
  10. package/dist/esm/lib/logger.js +323 -0
  11. package/dist/esm/lib/logger.js.map +1 -0
  12. package/dist/esm/lib/modelUtils.d.ts +14 -0
  13. package/dist/esm/lib/modelUtils.js +48 -0
  14. package/dist/esm/lib/modelUtils.js.map +1 -0
  15. package/dist/esm/lib/prompt.d.ts +14 -0
  16. package/dist/esm/lib/prompt.js +230 -0
  17. package/dist/esm/lib/prompt.js.map +1 -0
  18. package/dist/esm/lib/utils.d.ts +68 -0
  19. package/dist/esm/lib/utils.js +654 -0
  20. package/dist/esm/lib/utils.js.map +1 -0
  21. package/dist/esm/lib/v3/agent/AgentClient.d.ts +19 -0
  22. package/dist/esm/lib/v3/agent/AgentClient.js +17 -0
  23. package/dist/esm/lib/v3/agent/AgentClient.js.map +1 -0
  24. package/dist/esm/lib/v3/agent/AgentProvider.d.ts +20 -0
  25. package/dist/esm/lib/v3/agent/AgentProvider.js +77 -0
  26. package/dist/esm/lib/v3/agent/AgentProvider.js.map +1 -0
  27. package/dist/esm/lib/v3/agent/AnthropicCUAClient.d.ts +57 -0
  28. package/dist/esm/lib/v3/agent/AnthropicCUAClient.js +822 -0
  29. package/dist/esm/lib/v3/agent/AnthropicCUAClient.js.map +1 -0
  30. package/dist/esm/lib/v3/agent/GoogleCUAClient.d.ts +74 -0
  31. package/dist/esm/lib/v3/agent/GoogleCUAClient.js +799 -0
  32. package/dist/esm/lib/v3/agent/GoogleCUAClient.js.map +1 -0
  33. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.d.ts +71 -0
  34. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.js +770 -0
  35. package/dist/esm/lib/v3/agent/MicrosoftCUAClient.js.map +1 -0
  36. package/dist/esm/lib/v3/agent/OpenAICUAClient.d.ts +69 -0
  37. package/dist/esm/lib/v3/agent/OpenAICUAClient.js +615 -0
  38. package/dist/esm/lib/v3/agent/OpenAICUAClient.js.map +1 -0
  39. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.d.ts +12 -0
  40. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.js +186 -0
  41. package/dist/esm/lib/v3/agent/prompts/agentSystemPrompt.js.map +1 -0
  42. package/dist/esm/lib/v3/agent/tools/act.d.ts +13 -0
  43. package/dist/esm/lib/v3/agent/tools/act.js +49 -0
  44. package/dist/esm/lib/v3/agent/tools/act.js.map +1 -0
  45. package/dist/esm/lib/v3/agent/tools/ariaTree.d.ts +5 -0
  46. package/dist/esm/lib/v3/agent/tools/ariaTree.js +31 -0
  47. package/dist/esm/lib/v3/agent/tools/ariaTree.js.map +1 -0
  48. package/dist/esm/lib/v3/agent/tools/click.d.ts +6 -0
  49. package/dist/esm/lib/v3/agent/tools/click.js +104 -0
  50. package/dist/esm/lib/v3/agent/tools/click.js.map +1 -0
  51. package/dist/esm/lib/v3/agent/tools/clickAndHold.d.ts +14 -0
  52. package/dist/esm/lib/v3/agent/tools/clickAndHold.js +68 -0
  53. package/dist/esm/lib/v3/agent/tools/clickAndHold.js.map +1 -0
  54. package/dist/esm/lib/v3/agent/tools/dragAndDrop.d.ts +7 -0
  55. package/dist/esm/lib/v3/agent/tools/dragAndDrop.js +105 -0
  56. package/dist/esm/lib/v3/agent/tools/dragAndDrop.js.map +1 -0
  57. package/dist/esm/lib/v3/agent/tools/extract.d.ts +21 -0
  58. package/dist/esm/lib/v3/agent/tools/extract.js +93 -0
  59. package/dist/esm/lib/v3/agent/tools/extract.js.map +1 -0
  60. package/dist/esm/lib/v3/agent/tools/fillFormVision.d.ts +12 -0
  61. package/dist/esm/lib/v3/agent/tools/fillFormVision.js +143 -0
  62. package/dist/esm/lib/v3/agent/tools/fillFormVision.js.map +1 -0
  63. package/dist/esm/lib/v3/agent/tools/fillform.d.ts +13 -0
  64. package/dist/esm/lib/v3/agent/tools/fillform.js +56 -0
  65. package/dist/esm/lib/v3/agent/tools/fillform.js.map +1 -0
  66. package/dist/esm/lib/v3/agent/tools/goto.d.ts +12 -0
  67. package/dist/esm/lib/v3/agent/tools/goto.js +31 -0
  68. package/dist/esm/lib/v3/agent/tools/goto.js.map +1 -0
  69. package/dist/esm/lib/v3/agent/tools/index.d.ts +92 -0
  70. package/dist/esm/lib/v3/agent/tools/index.js +74 -0
  71. package/dist/esm/lib/v3/agent/tools/index.js.map +1 -0
  72. package/dist/esm/lib/v3/agent/tools/keys.d.ts +24 -0
  73. package/dist/esm/lib/v3/agent/tools/keys.js +60 -0
  74. package/dist/esm/lib/v3/agent/tools/keys.js.map +1 -0
  75. package/dist/esm/lib/v3/agent/tools/navback.d.ts +6 -0
  76. package/dist/esm/lib/v3/agent/tools/navback.js +23 -0
  77. package/dist/esm/lib/v3/agent/tools/navback.js.map +1 -0
  78. package/dist/esm/lib/v3/agent/tools/screenshot.d.ts +6 -0
  79. package/dist/esm/lib/v3/agent/tools/screenshot.js +26 -0
  80. package/dist/esm/lib/v3/agent/tools/screenshot.js.map +1 -0
  81. package/dist/esm/lib/v3/agent/tools/scroll.d.ts +19 -0
  82. package/dist/esm/lib/v3/agent/tools/scroll.js +142 -0
  83. package/dist/esm/lib/v3/agent/tools/scroll.js.map +1 -0
  84. package/dist/esm/lib/v3/agent/tools/search.d.ts +15 -0
  85. package/dist/esm/lib/v3/agent/tools/search.js +73 -0
  86. package/dist/esm/lib/v3/agent/tools/search.js.map +1 -0
  87. package/dist/esm/lib/v3/agent/tools/think.d.ts +6 -0
  88. package/dist/esm/lib/v3/agent/tools/think.js +24 -0
  89. package/dist/esm/lib/v3/agent/tools/think.js.map +1 -0
  90. package/dist/esm/lib/v3/agent/tools/type.d.ts +7 -0
  91. package/dist/esm/lib/v3/agent/tools/type.js +106 -0
  92. package/dist/esm/lib/v3/agent/tools/type.js.map +1 -0
  93. package/dist/esm/lib/v3/agent/tools/wait.d.ts +5 -0
  94. package/dist/esm/lib/v3/agent/tools/wait.js +53 -0
  95. package/dist/esm/lib/v3/agent/tools/wait.js.map +1 -0
  96. package/dist/esm/lib/v3/agent/utils/actionMapping.d.ts +3 -0
  97. package/dist/esm/lib/v3/agent/utils/actionMapping.js +100 -0
  98. package/dist/esm/lib/v3/agent/utils/actionMapping.js.map +1 -0
  99. package/dist/esm/lib/v3/agent/utils/coordinateNormalization.d.ts +13 -0
  100. package/dist/esm/lib/v3/agent/utils/coordinateNormalization.js +28 -0
  101. package/dist/esm/lib/v3/agent/utils/coordinateNormalization.js.map +1 -0
  102. package/dist/esm/lib/v3/agent/utils/cuaKeyMapping.d.ts +10 -0
  103. package/dist/esm/lib/v3/agent/utils/cuaKeyMapping.js +62 -0
  104. package/dist/esm/lib/v3/agent/utils/cuaKeyMapping.js.map +1 -0
  105. package/dist/esm/lib/v3/agent/utils/googleCustomToolHandler.d.ts +25 -0
  106. package/dist/esm/lib/v3/agent/utils/googleCustomToolHandler.js +145 -0
  107. package/dist/esm/lib/v3/agent/utils/googleCustomToolHandler.js.map +1 -0
  108. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.d.ts +22 -0
  109. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.js +101 -0
  110. package/dist/esm/lib/v3/agent/utils/handleDoneToolCall.js.map +1 -0
  111. package/dist/esm/lib/v3/agent/utils/imageCompression.d.ts +53 -0
  112. package/dist/esm/lib/v3/agent/utils/imageCompression.js +204 -0
  113. package/dist/esm/lib/v3/agent/utils/imageCompression.js.map +1 -0
  114. package/dist/esm/lib/v3/agent/utils/messageProcessing.d.ts +12 -0
  115. package/dist/esm/lib/v3/agent/utils/messageProcessing.js +164 -0
  116. package/dist/esm/lib/v3/agent/utils/messageProcessing.js.map +1 -0
  117. package/dist/esm/lib/v3/agent/utils/screenshotHandler.d.ts +10 -0
  118. package/dist/esm/lib/v3/agent/utils/screenshotHandler.js +26 -0
  119. package/dist/esm/lib/v3/agent/utils/screenshotHandler.js.map +1 -0
  120. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.d.ts +26 -0
  121. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.js +79 -0
  122. package/dist/esm/lib/v3/agent/utils/validateExperimentalFeatures.js.map +1 -0
  123. package/dist/esm/lib/v3/agent/utils/xpath.d.ts +11 -0
  124. package/dist/esm/lib/v3/agent/utils/xpath.js +19 -0
  125. package/dist/esm/lib/v3/agent/utils/xpath.js.map +1 -0
  126. package/dist/esm/lib/v3/api.d.ts +86 -0
  127. package/dist/esm/lib/v3/api.js +484 -0
  128. package/dist/esm/lib/v3/api.js.map +1 -0
  129. package/dist/esm/lib/v3/cache/ActCache.d.ts +23 -0
  130. package/dist/esm/lib/v3/cache/ActCache.js +292 -0
  131. package/dist/esm/lib/v3/cache/ActCache.js.map +1 -0
  132. package/dist/esm/lib/v3/cache/AgentCache.d.ts +109 -0
  133. package/dist/esm/lib/v3/cache/AgentCache.js +640 -0
  134. package/dist/esm/lib/v3/cache/AgentCache.js.map +1 -0
  135. package/dist/esm/lib/v3/cache/CacheStorage.d.ts +17 -0
  136. package/dist/esm/lib/v3/cache/CacheStorage.js +98 -0
  137. package/dist/esm/lib/v3/cache/CacheStorage.js.map +1 -0
  138. package/dist/esm/lib/v3/cache/serverAgentCache.d.ts +7 -0
  139. package/dist/esm/lib/v3/cache/serverAgentCache.js +49 -0
  140. package/dist/esm/lib/v3/cache/serverAgentCache.js.map +1 -0
  141. package/dist/esm/lib/v3/cache/utils.d.ts +15 -0
  142. package/dist/esm/lib/v3/cache/utils.js +39 -0
  143. package/dist/esm/lib/v3/cache/utils.js.map +1 -0
  144. package/dist/esm/lib/v3/dom/a11yScripts/index.d.ts +11 -0
  145. package/dist/esm/lib/v3/dom/a11yScripts/index.js +117 -0
  146. package/dist/esm/lib/v3/dom/a11yScripts/index.js.map +1 -0
  147. package/dist/esm/lib/v3/dom/build/a11yScripts.generated.d.ts +16 -0
  148. package/dist/esm/lib/v3/dom/build/a11yScripts.generated.js +20 -0
  149. package/dist/esm/lib/v3/dom/build/a11yScripts.generated.js.map +1 -0
  150. package/dist/esm/lib/v3/dom/build/locatorScripts.generated.d.ts +52 -0
  151. package/dist/esm/lib/v3/dom/build/locatorScripts.generated.js +56 -0
  152. package/dist/esm/lib/v3/dom/build/locatorScripts.generated.js.map +1 -0
  153. package/dist/esm/lib/v3/dom/build/reRenderScriptContent.d.ts +1 -0
  154. package/dist/esm/lib/v3/dom/build/reRenderScriptContent.js +2 -0
  155. package/dist/esm/lib/v3/dom/build/reRenderScriptContent.js.map +1 -0
  156. package/dist/esm/lib/v3/dom/build/rerender-index.js +1 -0
  157. package/dist/esm/lib/v3/dom/build/screenshotScripts.generated.d.ts +4 -0
  158. package/dist/esm/lib/v3/dom/build/screenshotScripts.generated.js +8 -0
  159. package/dist/esm/lib/v3/dom/build/screenshotScripts.generated.js.map +1 -0
  160. package/dist/esm/lib/v3/dom/build/scriptV3Content.d.ts +1 -0
  161. package/dist/esm/lib/v3/dom/build/scriptV3Content.js +2 -0
  162. package/dist/esm/lib/v3/dom/build/scriptV3Content.js.map +1 -0
  163. package/dist/esm/lib/v3/dom/build/v3-index.js +1 -0
  164. package/dist/esm/lib/v3/dom/genA11yScripts.d.ts +1 -0
  165. package/dist/esm/lib/v3/dom/genA11yScripts.js +54 -0
  166. package/dist/esm/lib/v3/dom/genA11yScripts.js.map +1 -0
  167. package/dist/esm/lib/v3/dom/genDomScripts.d.ts +1 -0
  168. package/dist/esm/lib/v3/dom/genDomScripts.js +38 -0
  169. package/dist/esm/lib/v3/dom/genDomScripts.js.map +1 -0
  170. package/dist/esm/lib/v3/dom/genLocatorScripts.d.ts +1 -0
  171. package/dist/esm/lib/v3/dom/genLocatorScripts.js +51 -0
  172. package/dist/esm/lib/v3/dom/genLocatorScripts.js.map +1 -0
  173. package/dist/esm/lib/v3/dom/genScreenshotScripts.d.ts +1 -0
  174. package/dist/esm/lib/v3/dom/genScreenshotScripts.js +37 -0
  175. package/dist/esm/lib/v3/dom/genScreenshotScripts.js.map +1 -0
  176. package/dist/esm/lib/v3/dom/index.d.ts +1 -0
  177. package/dist/esm/lib/v3/dom/index.js +2 -0
  178. package/dist/esm/lib/v3/dom/index.js.map +1 -0
  179. package/dist/esm/lib/v3/dom/locatorScripts/counts.d.ts +15 -0
  180. package/dist/esm/lib/v3/dom/locatorScripts/counts.js +272 -0
  181. package/dist/esm/lib/v3/dom/locatorScripts/counts.js.map +1 -0
  182. package/dist/esm/lib/v3/dom/locatorScripts/index.d.ts +4 -0
  183. package/dist/esm/lib/v3/dom/locatorScripts/index.js +5 -0
  184. package/dist/esm/lib/v3/dom/locatorScripts/index.js.map +1 -0
  185. package/dist/esm/lib/v3/dom/locatorScripts/scripts.d.ts +37 -0
  186. package/dist/esm/lib/v3/dom/locatorScripts/scripts.js +458 -0
  187. package/dist/esm/lib/v3/dom/locatorScripts/scripts.js.map +1 -0
  188. package/dist/esm/lib/v3/dom/locatorScripts/selectors.d.ts +4 -0
  189. package/dist/esm/lib/v3/dom/locatorScripts/selectors.js +283 -0
  190. package/dist/esm/lib/v3/dom/locatorScripts/selectors.js.map +1 -0
  191. package/dist/esm/lib/v3/dom/locatorScripts/waitForSelector.d.ts +19 -0
  192. package/dist/esm/lib/v3/dom/locatorScripts/waitForSelector.js +283 -0
  193. package/dist/esm/lib/v3/dom/locatorScripts/waitForSelector.js.map +1 -0
  194. package/dist/esm/lib/v3/dom/locatorScripts/xpathParser.d.ts +76 -0
  195. package/dist/esm/lib/v3/dom/locatorScripts/xpathParser.js +376 -0
  196. package/dist/esm/lib/v3/dom/locatorScripts/xpathParser.js.map +1 -0
  197. package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.d.ts +9 -0
  198. package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.js +196 -0
  199. package/dist/esm/lib/v3/dom/locatorScripts/xpathResolver.js.map +1 -0
  200. package/dist/esm/lib/v3/dom/piercer.entry.d.ts +1 -0
  201. package/dist/esm/lib/v3/dom/piercer.entry.js +3 -0
  202. package/dist/esm/lib/v3/dom/piercer.entry.js.map +1 -0
  203. package/dist/esm/lib/v3/dom/piercer.runtime.d.ts +23 -0
  204. package/dist/esm/lib/v3/dom/piercer.runtime.js +90 -0
  205. package/dist/esm/lib/v3/dom/piercer.runtime.js.map +1 -0
  206. package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.d.ts +1 -0
  207. package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.js +3 -0
  208. package/dist/esm/lib/v3/dom/rerenderMissingShadows.entry.js.map +1 -0
  209. package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.d.ts +1 -0
  210. package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.js +40 -0
  211. package/dist/esm/lib/v3/dom/rerenderMissingShadows.runtime.js.map +1 -0
  212. package/dist/esm/lib/v3/dom/screenshotScripts/index.d.ts +1 -0
  213. package/dist/esm/lib/v3/dom/screenshotScripts/index.js +2 -0
  214. package/dist/esm/lib/v3/dom/screenshotScripts/index.js.map +1 -0
  215. package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.d.ts +8 -0
  216. package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.js +82 -0
  217. package/dist/esm/lib/v3/dom/screenshotScripts/resolveMaskRect.js.map +1 -0
  218. package/dist/esm/lib/v3/external_clients/aisdk.d.ts +11 -0
  219. package/dist/esm/lib/v3/external_clients/aisdk.js +103 -0
  220. package/dist/esm/lib/v3/external_clients/aisdk.js.map +1 -0
  221. package/dist/esm/lib/v3/external_clients/customOpenAI.d.ts +18 -0
  222. package/dist/esm/lib/v3/external_clients/customOpenAI.js +220 -0
  223. package/dist/esm/lib/v3/external_clients/customOpenAI.js.map +1 -0
  224. package/dist/esm/lib/v3/flowLogger.d.ts +139 -0
  225. package/dist/esm/lib/v3/flowLogger.js +868 -0
  226. package/dist/esm/lib/v3/flowLogger.js.map +1 -0
  227. package/dist/esm/lib/v3/handlers/actHandler.d.ts +21 -0
  228. package/dist/esm/lib/v3/handlers/actHandler.js +340 -0
  229. package/dist/esm/lib/v3/handlers/actHandler.js.map +1 -0
  230. package/dist/esm/lib/v3/handlers/extractHandler.d.ts +31 -0
  231. package/dist/esm/lib/v3/handlers/extractHandler.js +139 -0
  232. package/dist/esm/lib/v3/handlers/extractHandler.js.map +1 -0
  233. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.d.ts +24 -0
  234. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.js +623 -0
  235. package/dist/esm/lib/v3/handlers/handlerUtils/actHandlerUtils.js.map +1 -0
  236. package/dist/esm/lib/v3/handlers/handlerUtils/timeoutGuard.d.ts +2 -0
  237. package/dist/esm/lib/v3/handlers/handlerUtils/timeoutGuard.js +14 -0
  238. package/dist/esm/lib/v3/handlers/handlerUtils/timeoutGuard.js.map +1 -0
  239. package/dist/esm/lib/v3/handlers/observeHandler.d.ts +17 -0
  240. package/dist/esm/lib/v3/handlers/observeHandler.js +156 -0
  241. package/dist/esm/lib/v3/handlers/observeHandler.js.map +1 -0
  242. package/dist/esm/lib/v3/handlers/v3AgentHandler.d.ts +32 -0
  243. package/dist/esm/lib/v3/handlers/v3AgentHandler.js +461 -0
  244. package/dist/esm/lib/v3/handlers/v3AgentHandler.js.map +1 -0
  245. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.d.ts +33 -0
  246. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.js +528 -0
  247. package/dist/esm/lib/v3/handlers/v3CuaAgentHandler.js.map +1 -0
  248. package/dist/esm/lib/v3/index.d.ts +17 -0
  249. package/dist/esm/lib/v3/index.js +13 -0
  250. package/dist/esm/lib/v3/index.js.map +1 -0
  251. package/dist/esm/lib/v3/launch/browserbase.d.ts +7 -0
  252. package/dist/esm/lib/v3/launch/browserbase.js +46 -0
  253. package/dist/esm/lib/v3/launch/browserbase.js.map +1 -0
  254. package/dist/esm/lib/v3/launch/local.d.ts +15 -0
  255. package/dist/esm/lib/v3/launch/local.js +98 -0
  256. package/dist/esm/lib/v3/launch/local.js.map +1 -0
  257. package/dist/esm/lib/v3/llm/AnthropicClient.d.ts +16 -0
  258. package/dist/esm/lib/v3/llm/AnthropicClient.js +239 -0
  259. package/dist/esm/lib/v3/llm/AnthropicClient.js.map +1 -0
  260. package/dist/esm/lib/v3/llm/CerebrasClient.d.ts +17 -0
  261. package/dist/esm/lib/v3/llm/CerebrasClient.js +235 -0
  262. package/dist/esm/lib/v3/llm/CerebrasClient.js.map +1 -0
  263. package/dist/esm/lib/v3/llm/GoogleClient.d.ts +19 -0
  264. package/dist/esm/lib/v3/llm/GoogleClient.js +369 -0
  265. package/dist/esm/lib/v3/llm/GoogleClient.js.map +1 -0
  266. package/dist/esm/lib/v3/llm/GroqClient.d.ts +17 -0
  267. package/dist/esm/lib/v3/llm/GroqClient.js +236 -0
  268. package/dist/esm/lib/v3/llm/GroqClient.js.map +1 -0
  269. package/dist/esm/lib/v3/llm/LLMClient.d.ts +121 -0
  270. package/dist/esm/lib/v3/llm/LLMClient.js +23 -0
  271. package/dist/esm/lib/v3/llm/LLMClient.js.map +1 -0
  272. package/dist/esm/lib/v3/llm/LLMProvider.d.ts +13 -0
  273. package/dist/esm/lib/v3/llm/LLMProvider.js +194 -0
  274. package/dist/esm/lib/v3/llm/LLMProvider.js.map +1 -0
  275. package/dist/esm/lib/v3/llm/OpenAIClient.d.ts +15 -0
  276. package/dist/esm/lib/v3/llm/OpenAIClient.js +329 -0
  277. package/dist/esm/lib/v3/llm/OpenAIClient.js.map +1 -0
  278. package/dist/esm/lib/v3/llm/aisdk.d.ts +15 -0
  279. package/dist/esm/lib/v3/llm/aisdk.js +348 -0
  280. package/dist/esm/lib/v3/llm/aisdk.js.map +1 -0
  281. package/dist/esm/lib/v3/logger.d.ts +9 -0
  282. package/dist/esm/lib/v3/logger.js +96 -0
  283. package/dist/esm/lib/v3/logger.js.map +1 -0
  284. package/dist/esm/lib/v3/mcp/connection.d.ts +11 -0
  285. package/dist/esm/lib/v3/mcp/connection.js +49 -0
  286. package/dist/esm/lib/v3/mcp/connection.js.map +1 -0
  287. package/dist/esm/lib/v3/mcp/utils.d.ts +3 -0
  288. package/dist/esm/lib/v3/mcp/utils.js +36 -0
  289. package/dist/esm/lib/v3/mcp/utils.js.map +1 -0
  290. package/dist/esm/lib/v3/shutdown/cleanupLocal.d.ts +14 -0
  291. package/dist/esm/lib/v3/shutdown/cleanupLocal.js +30 -0
  292. package/dist/esm/lib/v3/shutdown/cleanupLocal.js.map +1 -0
  293. package/dist/esm/lib/v3/shutdown/supervisor.d.ts +9 -0
  294. package/dist/esm/lib/v3/shutdown/supervisor.js +156 -0
  295. package/dist/esm/lib/v3/shutdown/supervisor.js.map +1 -0
  296. package/dist/esm/lib/v3/shutdown/supervisorClient.d.ts +15 -0
  297. package/dist/esm/lib/v3/shutdown/supervisorClient.js +97 -0
  298. package/dist/esm/lib/v3/shutdown/supervisorClient.js.map +1 -0
  299. package/dist/esm/lib/v3/tests/agent-abort-signal.spec.js +113 -0
  300. package/dist/esm/lib/v3/tests/agent-abort-signal.spec.js.map +7 -0
  301. package/dist/esm/lib/v3/tests/agent-cache-self-heal.spec.js +80 -0
  302. package/dist/esm/lib/v3/tests/agent-cache-self-heal.spec.js.map +7 -0
  303. package/dist/esm/lib/v3/tests/agent-callbacks.spec.js +374 -0
  304. package/dist/esm/lib/v3/tests/agent-callbacks.spec.js.map +7 -0
  305. package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js +357 -0
  306. package/dist/esm/lib/v3/tests/agent-experimental-validation.spec.js.map +7 -0
  307. package/dist/esm/lib/v3/tests/agent-hybrid-mode.spec.js +247 -0
  308. package/dist/esm/lib/v3/tests/agent-hybrid-mode.spec.js.map +7 -0
  309. package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js +105 -0
  310. package/dist/esm/lib/v3/tests/agent-message-continuation.spec.js.map +7 -0
  311. package/dist/esm/lib/v3/tests/agent-streaming.spec.js +126 -0
  312. package/dist/esm/lib/v3/tests/agent-streaming.spec.js.map +7 -0
  313. package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js +44 -0
  314. package/dist/esm/lib/v3/tests/cdp-session-detached.spec.js.map +7 -0
  315. package/dist/esm/lib/v3/tests/click-count.spec.js +112 -0
  316. package/dist/esm/lib/v3/tests/click-count.spec.js.map +7 -0
  317. package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js +54 -0
  318. package/dist/esm/lib/v3/tests/connect-to-existing-browser.spec.js.map +7 -0
  319. package/dist/esm/lib/v3/tests/context-addInitScript.spec.js +176 -0
  320. package/dist/esm/lib/v3/tests/context-addInitScript.spec.js.map +7 -0
  321. package/dist/esm/lib/v3/tests/default-page-tracking.spec.js +53 -0
  322. package/dist/esm/lib/v3/tests/default-page-tracking.spec.js.map +7 -0
  323. package/dist/esm/lib/v3/tests/downloads.spec.js +58 -0
  324. package/dist/esm/lib/v3/tests/downloads.spec.js.map +7 -0
  325. package/dist/esm/lib/v3/tests/envReporter.js +57 -0
  326. package/dist/esm/lib/v3/tests/envReporter.js.map +7 -0
  327. package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js +53 -0
  328. package/dist/esm/lib/v3/tests/frame-get-location-and-click.spec.js.map +7 -0
  329. package/dist/esm/lib/v3/tests/iframe-ctx-addInitScript.spec.js +447 -0
  330. package/dist/esm/lib/v3/tests/iframe-ctx-addInitScript.spec.js.map +7 -0
  331. package/dist/esm/lib/v3/tests/keep-alive.child.js +92 -0
  332. package/dist/esm/lib/v3/tests/keep-alive.child.js.map +7 -0
  333. package/dist/esm/lib/v3/tests/keep-alive.helpers.js +532 -0
  334. package/dist/esm/lib/v3/tests/keep-alive.helpers.js.map +7 -0
  335. package/dist/esm/lib/v3/tests/keep-alive.spec.js +19 -0
  336. package/dist/esm/lib/v3/tests/keep-alive.spec.js.map +7 -0
  337. package/dist/esm/lib/v3/tests/keyboard.spec.js +296 -0
  338. package/dist/esm/lib/v3/tests/keyboard.spec.js.map +7 -0
  339. package/dist/esm/lib/v3/tests/locator-backend-node-id.spec.js +159 -0
  340. package/dist/esm/lib/v3/tests/locator-backend-node-id.spec.js.map +7 -0
  341. package/dist/esm/lib/v3/tests/locator-content-methods.spec.js +191 -0
  342. package/dist/esm/lib/v3/tests/locator-content-methods.spec.js.map +7 -0
  343. package/dist/esm/lib/v3/tests/locator-count-iframe.spec.js +108 -0
  344. package/dist/esm/lib/v3/tests/locator-count-iframe.spec.js.map +7 -0
  345. package/dist/esm/lib/v3/tests/locator-count.spec.js +71 -0
  346. package/dist/esm/lib/v3/tests/locator-count.spec.js.map +7 -0
  347. package/dist/esm/lib/v3/tests/locator-fill.spec.js +118 -0
  348. package/dist/esm/lib/v3/tests/locator-fill.spec.js.map +7 -0
  349. package/dist/esm/lib/v3/tests/locator-input-methods.spec.js +136 -0
  350. package/dist/esm/lib/v3/tests/locator-input-methods.spec.js.map +7 -0
  351. package/dist/esm/lib/v3/tests/locator-nth.spec.js +157 -0
  352. package/dist/esm/lib/v3/tests/locator-nth.spec.js.map +7 -0
  353. package/dist/esm/lib/v3/tests/locator-select-option.spec.js +242 -0
  354. package/dist/esm/lib/v3/tests/locator-select-option.spec.js.map +7 -0
  355. package/dist/esm/lib/v3/tests/logger-initialization.spec.js +552 -0
  356. package/dist/esm/lib/v3/tests/logger-initialization.spec.js.map +7 -0
  357. package/dist/esm/lib/v3/tests/multi-instance-logger.spec.js +269 -0
  358. package/dist/esm/lib/v3/tests/multi-instance-logger.spec.js.map +7 -0
  359. package/dist/esm/lib/v3/tests/nested-div.spec.js +23 -0
  360. package/dist/esm/lib/v3/tests/nested-div.spec.js.map +7 -0
  361. package/dist/esm/lib/v3/tests/page-addInitScript.spec.js +90 -0
  362. package/dist/esm/lib/v3/tests/page-addInitScript.spec.js.map +7 -0
  363. package/dist/esm/lib/v3/tests/page-console.spec.js +56 -0
  364. package/dist/esm/lib/v3/tests/page-console.spec.js.map +7 -0
  365. package/dist/esm/lib/v3/tests/page-drag-and-drop.spec.js +418 -0
  366. package/dist/esm/lib/v3/tests/page-drag-and-drop.spec.js.map +7 -0
  367. package/dist/esm/lib/v3/tests/page-goto-response.spec.js +35 -0
  368. package/dist/esm/lib/v3/tests/page-goto-response.spec.js.map +7 -0
  369. package/dist/esm/lib/v3/tests/page-hover.spec.js +167 -0
  370. package/dist/esm/lib/v3/tests/page-hover.spec.js.map +7 -0
  371. package/dist/esm/lib/v3/tests/page-screenshot.spec.js +273 -0
  372. package/dist/esm/lib/v3/tests/page-screenshot.spec.js.map +7 -0
  373. package/dist/esm/lib/v3/tests/page-scroll.spec.js +182 -0
  374. package/dist/esm/lib/v3/tests/page-scroll.spec.js.map +7 -0
  375. package/dist/esm/lib/v3/tests/page-send-cdp.spec.js +46 -0
  376. package/dist/esm/lib/v3/tests/page-send-cdp.spec.js.map +7 -0
  377. package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js +98 -0
  378. package/dist/esm/lib/v3/tests/perform-understudy-method.spec.js.map +7 -0
  379. package/dist/esm/lib/v3/tests/setinputfiles.spec.js +126 -0
  380. package/dist/esm/lib/v3/tests/setinputfiles.spec.js.map +7 -0
  381. package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js +134 -0
  382. package/dist/esm/lib/v3/tests/shadow-iframe-oopif.spec.js.map +7 -0
  383. package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js +134 -0
  384. package/dist/esm/lib/v3/tests/shadow-iframe-spif.spec.js.map +7 -0
  385. package/dist/esm/lib/v3/tests/testUtils.js +31 -0
  386. package/dist/esm/lib/v3/tests/testUtils.js.map +7 -0
  387. package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js +100 -0
  388. package/dist/esm/lib/v3/tests/text-selector-innermost.spec.js.map +7 -0
  389. package/dist/esm/lib/v3/tests/timeouts.spec.js +32 -0
  390. package/dist/esm/lib/v3/tests/timeouts.spec.js.map +7 -0
  391. package/dist/esm/lib/v3/tests/user-data-dir.spec.js +43 -0
  392. package/dist/esm/lib/v3/tests/user-data-dir.spec.js.map +7 -0
  393. package/dist/esm/lib/v3/tests/v3.config.js +15 -0
  394. package/dist/esm/lib/v3/tests/v3.config.js.map +7 -0
  395. package/dist/esm/lib/v3/tests/v3.dynamic.config.js +43 -0
  396. package/dist/esm/lib/v3/tests/v3.dynamic.config.js.map +7 -0
  397. package/dist/esm/lib/v3/tests/v3.playwright.config.js +98 -0
  398. package/dist/esm/lib/v3/tests/v3.playwright.config.js.map +7 -0
  399. package/dist/esm/lib/v3/tests/wait-for-selector.spec.js +593 -0
  400. package/dist/esm/lib/v3/tests/wait-for-selector.spec.js.map +7 -0
  401. package/dist/esm/lib/v3/tests/wait-for-timeout.spec.js +97 -0
  402. package/dist/esm/lib/v3/tests/wait-for-timeout.spec.js.map +7 -0
  403. package/dist/esm/lib/v3/tests/xpath-for-location-deep.spec.js +77 -0
  404. package/dist/esm/lib/v3/tests/xpath-for-location-deep.spec.js.map +7 -0
  405. package/dist/esm/lib/v3/timeoutConfig.d.ts +2 -0
  406. package/dist/esm/lib/v3/timeoutConfig.js +27 -0
  407. package/dist/esm/lib/v3/timeoutConfig.js.map +1 -0
  408. package/dist/esm/lib/v3/types/private/agent.d.ts +6 -0
  409. package/dist/esm/lib/v3/types/private/agent.js +2 -0
  410. package/dist/esm/lib/v3/types/private/agent.js.map +1 -0
  411. package/dist/esm/lib/v3/types/private/api.d.ts +11 -0
  412. package/dist/esm/lib/v3/types/private/api.js +2 -0
  413. package/dist/esm/lib/v3/types/private/api.js.map +1 -0
  414. package/dist/esm/lib/v3/types/private/cache.d.ts +128 -0
  415. package/dist/esm/lib/v3/types/private/cache.js +2 -0
  416. package/dist/esm/lib/v3/types/private/cache.js.map +1 -0
  417. package/dist/esm/lib/v3/types/private/evaluator.d.ts +40 -0
  418. package/dist/esm/lib/v3/types/private/evaluator.js +2 -0
  419. package/dist/esm/lib/v3/types/private/evaluator.js.map +1 -0
  420. package/dist/esm/lib/v3/types/private/handlers.d.ts +38 -0
  421. package/dist/esm/lib/v3/types/private/handlers.js +16 -0
  422. package/dist/esm/lib/v3/types/private/handlers.js.map +1 -0
  423. package/dist/esm/lib/v3/types/private/index.d.ts +7 -0
  424. package/dist/esm/lib/v3/types/private/index.js +8 -0
  425. package/dist/esm/lib/v3/types/private/index.js.map +1 -0
  426. package/dist/esm/lib/v3/types/private/internal.d.ts +39 -0
  427. package/dist/esm/lib/v3/types/private/internal.js +2 -0
  428. package/dist/esm/lib/v3/types/private/internal.js.map +1 -0
  429. package/dist/esm/lib/v3/types/private/locator.d.ts +9 -0
  430. package/dist/esm/lib/v3/types/private/locator.js +2 -0
  431. package/dist/esm/lib/v3/types/private/locator.js.map +1 -0
  432. package/dist/esm/lib/v3/types/private/network.d.ts +34 -0
  433. package/dist/esm/lib/v3/types/private/network.js +3 -0
  434. package/dist/esm/lib/v3/types/private/network.js.map +1 -0
  435. package/dist/esm/lib/v3/types/private/shutdown.d.ts +31 -0
  436. package/dist/esm/lib/v3/types/private/shutdown.js +5 -0
  437. package/dist/esm/lib/v3/types/private/shutdown.js.map +1 -0
  438. package/dist/esm/lib/v3/types/private/shutdownErrors.d.ts +12 -0
  439. package/dist/esm/lib/v3/types/private/shutdownErrors.js +22 -0
  440. package/dist/esm/lib/v3/types/private/shutdownErrors.js.map +1 -0
  441. package/dist/esm/lib/v3/types/private/snapshot.d.ts +117 -0
  442. package/dist/esm/lib/v3/types/private/snapshot.js +2 -0
  443. package/dist/esm/lib/v3/types/private/snapshot.js.map +1 -0
  444. package/dist/esm/lib/v3/types/public/agent.d.ts +595 -0
  445. package/dist/esm/lib/v3/types/public/agent.js +15 -0
  446. package/dist/esm/lib/v3/types/public/agent.js.map +1 -0
  447. package/dist/esm/lib/v3/types/public/api.d.ts +1211 -0
  448. package/dist/esm/lib/v3/types/public/api.js +915 -0
  449. package/dist/esm/lib/v3/types/public/api.js.map +1 -0
  450. package/dist/esm/lib/v3/types/public/apiErrors.d.ts +18 -0
  451. package/dist/esm/lib/v3/types/public/apiErrors.js +32 -0
  452. package/dist/esm/lib/v3/types/public/apiErrors.js.map +1 -0
  453. package/dist/esm/lib/v3/types/public/index.d.ts +12 -0
  454. package/dist/esm/lib/v3/types/public/index.js +14 -0
  455. package/dist/esm/lib/v3/types/public/index.js.map +1 -0
  456. package/dist/esm/lib/v3/types/public/locator.d.ts +9 -0
  457. package/dist/esm/lib/v3/types/public/locator.js +2 -0
  458. package/dist/esm/lib/v3/types/public/locator.js.map +1 -0
  459. package/dist/esm/lib/v3/types/public/logs.d.ts +23 -0
  460. package/dist/esm/lib/v3/types/public/logs.js +13 -0
  461. package/dist/esm/lib/v3/types/public/logs.js.map +1 -0
  462. package/dist/esm/lib/v3/types/public/methods.d.ts +56 -0
  463. package/dist/esm/lib/v3/types/public/methods.js +15 -0
  464. package/dist/esm/lib/v3/types/public/methods.js.map +1 -0
  465. package/dist/esm/lib/v3/types/public/metrics.d.ts +27 -0
  466. package/dist/esm/lib/v3/types/public/metrics.js +2 -0
  467. package/dist/esm/lib/v3/types/public/metrics.js.map +1 -0
  468. package/dist/esm/lib/v3/types/public/model.d.ts +65 -0
  469. package/dist/esm/lib/v3/types/public/model.js +2 -0
  470. package/dist/esm/lib/v3/types/public/model.js.map +1 -0
  471. package/dist/esm/lib/v3/types/public/options.d.ts +70 -0
  472. package/dist/esm/lib/v3/types/public/options.js +4 -0
  473. package/dist/esm/lib/v3/types/public/options.js.map +1 -0
  474. package/dist/esm/lib/v3/types/public/page.d.ts +18 -0
  475. package/dist/esm/lib/v3/types/public/page.js +3 -0
  476. package/dist/esm/lib/v3/types/public/page.js.map +1 -0
  477. package/dist/esm/lib/v3/types/public/screenshotTypes.d.ts +25 -0
  478. package/dist/esm/lib/v3/types/public/screenshotTypes.js +2 -0
  479. package/dist/esm/lib/v3/types/public/screenshotTypes.js.map +1 -0
  480. package/dist/esm/lib/v3/types/public/sdkErrors.d.ts +152 -0
  481. package/dist/esm/lib/v3/types/public/sdkErrors.js +305 -0
  482. package/dist/esm/lib/v3/types/public/sdkErrors.js.map +1 -0
  483. package/dist/esm/lib/v3/understudy/a11y/snapshot/a11yTree.d.ts +15 -0
  484. package/dist/esm/lib/v3/understudy/a11y/snapshot/a11yTree.js +196 -0
  485. package/dist/esm/lib/v3/understudy/a11y/snapshot/a11yTree.js.map +1 -0
  486. package/dist/esm/lib/v3/understudy/a11y/snapshot/activeElement.d.ts +8 -0
  487. package/dist/esm/lib/v3/understudy/a11y/snapshot/activeElement.js +121 -0
  488. package/dist/esm/lib/v3/understudy/a11y/snapshot/activeElement.js.map +1 -0
  489. package/dist/esm/lib/v3/understudy/a11y/snapshot/capture.d.ts +77 -0
  490. package/dist/esm/lib/v3/understudy/a11y/snapshot/capture.js +336 -0
  491. package/dist/esm/lib/v3/understudy/a11y/snapshot/capture.js.map +1 -0
  492. package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.d.ts +7 -0
  493. package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js +129 -0
  494. package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js.map +1 -0
  495. package/dist/esm/lib/v3/understudy/a11y/snapshot/domTree.d.ts +46 -0
  496. package/dist/esm/lib/v3/understudy/a11y/snapshot/domTree.js +274 -0
  497. package/dist/esm/lib/v3/understudy/a11y/snapshot/domTree.js.map +1 -0
  498. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.d.ts +24 -0
  499. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.js +216 -0
  500. package/dist/esm/lib/v3/understudy/a11y/snapshot/focusSelectors.js.map +1 -0
  501. package/dist/esm/lib/v3/understudy/a11y/snapshot/index.d.ts +4 -0
  502. package/dist/esm/lib/v3/understudy/a11y/snapshot/index.js +5 -0
  503. package/dist/esm/lib/v3/understudy/a11y/snapshot/index.js.map +1 -0
  504. package/dist/esm/lib/v3/understudy/a11y/snapshot/sessions.d.ts +16 -0
  505. package/dist/esm/lib/v3/understudy/a11y/snapshot/sessions.js +22 -0
  506. package/dist/esm/lib/v3/understudy/a11y/snapshot/sessions.js.map +1 -0
  507. package/dist/esm/lib/v3/understudy/a11y/snapshot/treeFormatUtils.d.ts +28 -0
  508. package/dist/esm/lib/v3/understudy/a11y/snapshot/treeFormatUtils.js +135 -0
  509. package/dist/esm/lib/v3/understudy/a11y/snapshot/treeFormatUtils.js.map +1 -0
  510. package/dist/esm/lib/v3/understudy/a11y/snapshot/xpathUtils.d.ts +26 -0
  511. package/dist/esm/lib/v3/understudy/a11y/snapshot/xpathUtils.js +102 -0
  512. package/dist/esm/lib/v3/understudy/a11y/snapshot/xpathUtils.js.map +1 -0
  513. package/dist/esm/lib/v3/understudy/a11yInvocation.d.ts +8 -0
  514. package/dist/esm/lib/v3/understudy/a11yInvocation.js +12 -0
  515. package/dist/esm/lib/v3/understudy/a11yInvocation.js.map +1 -0
  516. package/dist/esm/lib/v3/understudy/cdp.d.ts +69 -0
  517. package/dist/esm/lib/v3/understudy/cdp.js +251 -0
  518. package/dist/esm/lib/v3/understudy/cdp.js.map +1 -0
  519. package/dist/esm/lib/v3/understudy/consoleMessage.d.ts +22 -0
  520. package/dist/esm/lib/v3/understudy/consoleMessage.js +66 -0
  521. package/dist/esm/lib/v3/understudy/consoleMessage.js.map +1 -0
  522. package/dist/esm/lib/v3/understudy/context.d.ts +132 -0
  523. package/dist/esm/lib/v3/understudy/context.js +687 -0
  524. package/dist/esm/lib/v3/understudy/context.js.map +1 -0
  525. package/dist/esm/lib/v3/understudy/deepLocator.d.ts +87 -0
  526. package/dist/esm/lib/v3/understudy/deepLocator.js +218 -0
  527. package/dist/esm/lib/v3/understudy/deepLocator.js.map +1 -0
  528. package/dist/esm/lib/v3/understudy/executionContextRegistry.d.ts +15 -0
  529. package/dist/esm/lib/v3/understudy/executionContextRegistry.js +83 -0
  530. package/dist/esm/lib/v3/understudy/executionContextRegistry.js.map +1 -0
  531. package/dist/esm/lib/v3/understudy/fileUploadUtils.d.ts +13 -0
  532. package/dist/esm/lib/v3/understudy/fileUploadUtils.js +81 -0
  533. package/dist/esm/lib/v3/understudy/fileUploadUtils.js.map +1 -0
  534. package/dist/esm/lib/v3/understudy/frame.d.ts +69 -0
  535. package/dist/esm/lib/v3/understudy/frame.js +211 -0
  536. package/dist/esm/lib/v3/understudy/frame.js.map +1 -0
  537. package/dist/esm/lib/v3/understudy/frameLocator.d.ts +50 -0
  538. package/dist/esm/lib/v3/understudy/frameLocator.js +255 -0
  539. package/dist/esm/lib/v3/understudy/frameLocator.js.map +1 -0
  540. package/dist/esm/lib/v3/understudy/frameRegistry.d.ts +101 -0
  541. package/dist/esm/lib/v3/understudy/frameRegistry.js +298 -0
  542. package/dist/esm/lib/v3/understudy/frameRegistry.js.map +1 -0
  543. package/dist/esm/lib/v3/understudy/initScripts.d.ts +2 -0
  544. package/dist/esm/lib/v3/understudy/initScripts.js +33 -0
  545. package/dist/esm/lib/v3/understudy/initScripts.js.map +1 -0
  546. package/dist/esm/lib/v3/understudy/lifecycleWatcher.d.ts +64 -0
  547. package/dist/esm/lib/v3/understudy/lifecycleWatcher.js +245 -0
  548. package/dist/esm/lib/v3/understudy/lifecycleWatcher.js.map +1 -0
  549. package/dist/esm/lib/v3/understudy/locator.d.ts +194 -0
  550. package/dist/esm/lib/v3/understudy/locator.js +753 -0
  551. package/dist/esm/lib/v3/understudy/locator.js.map +1 -0
  552. package/dist/esm/lib/v3/understudy/locatorInvocation.d.ts +8 -0
  553. package/dist/esm/lib/v3/understudy/locatorInvocation.js +12 -0
  554. package/dist/esm/lib/v3/understudy/locatorInvocation.js.map +1 -0
  555. package/dist/esm/lib/v3/understudy/navigationResponseTracker.d.ts +84 -0
  556. package/dist/esm/lib/v3/understudy/navigationResponseTracker.js +224 -0
  557. package/dist/esm/lib/v3/understudy/navigationResponseTracker.js.map +1 -0
  558. package/dist/esm/lib/v3/understudy/networkManager.d.ts +53 -0
  559. package/dist/esm/lib/v3/understudy/networkManager.js +306 -0
  560. package/dist/esm/lib/v3/understudy/networkManager.js.map +1 -0
  561. package/dist/esm/lib/v3/understudy/page.d.ts +354 -0
  562. package/dist/esm/lib/v3/understudy/page.js +1941 -0
  563. package/dist/esm/lib/v3/understudy/page.js.map +1 -0
  564. package/dist/esm/lib/v3/understudy/piercer.d.ts +4 -0
  565. package/dist/esm/lib/v3/understudy/piercer.js +61 -0
  566. package/dist/esm/lib/v3/understudy/piercer.js.map +1 -0
  567. package/dist/esm/lib/v3/understudy/response.d.ts +137 -0
  568. package/dist/esm/lib/v3/understudy/response.js +330 -0
  569. package/dist/esm/lib/v3/understudy/response.js.map +1 -0
  570. package/dist/esm/lib/v3/understudy/screenshotUtils.d.ts +16 -0
  571. package/dist/esm/lib/v3/understudy/screenshotUtils.js +352 -0
  572. package/dist/esm/lib/v3/understudy/screenshotUtils.js.map +1 -0
  573. package/dist/esm/lib/v3/understudy/selectorResolver.d.ts +38 -0
  574. package/dist/esm/lib/v3/understudy/selectorResolver.js +296 -0
  575. package/dist/esm/lib/v3/understudy/selectorResolver.js.map +1 -0
  576. package/dist/esm/lib/v3/v3.d.ts +191 -0
  577. package/dist/esm/lib/v3/v3.js +1572 -0
  578. package/dist/esm/lib/v3/v3.js.map +1 -0
  579. package/dist/esm/lib/v3/zodCompat.d.ts +12 -0
  580. package/dist/esm/lib/v3/zodCompat.js +17 -0
  581. package/dist/esm/lib/v3/zodCompat.js.map +1 -0
  582. package/dist/esm/lib/v3Evaluator.d.ts +19 -0
  583. package/dist/esm/lib/v3Evaluator.js +210 -0
  584. package/dist/esm/lib/v3Evaluator.js.map +1 -0
  585. package/dist/esm/lib/version.d.ts +5 -0
  586. package/dist/esm/lib/version.js +6 -0
  587. package/dist/esm/lib/version.js.map +1 -0
  588. package/dist/esm/package.json +3 -0
  589. package/dist/esm/tests/agent-execution-model.test.js +139 -0
  590. package/dist/esm/tests/agent-execution-model.test.js.map +7 -0
  591. package/dist/esm/tests/browserbase-session-accessors.test.js +101 -0
  592. package/dist/esm/tests/browserbase-session-accessors.test.js.map +7 -0
  593. package/dist/esm/tests/cache-llm-resolution.test.js +187 -0
  594. package/dist/esm/tests/cache-llm-resolution.test.js.map +7 -0
  595. package/dist/esm/tests/helpers/mockCDPSession.js +27 -0
  596. package/dist/esm/tests/helpers/mockCDPSession.js.map +7 -0
  597. package/dist/esm/tests/llm-provider.test.js +57 -0
  598. package/dist/esm/tests/llm-provider.test.js.map +7 -0
  599. package/dist/esm/tests/model-deprecation.test.js +135 -0
  600. package/dist/esm/tests/model-deprecation.test.js.map +7 -0
  601. package/dist/esm/tests/model-utils.test.js +43 -0
  602. package/dist/esm/tests/model-utils.test.js.map +7 -0
  603. package/dist/esm/tests/page-snapshot.test.js +36 -0
  604. package/dist/esm/tests/page-snapshot.test.js.map +7 -0
  605. package/dist/esm/tests/public-api/export-surface.test.js +53 -0
  606. package/dist/esm/tests/public-api/export-surface.test.js.map +7 -0
  607. package/dist/esm/tests/public-api/llm-and-agents.test.js +128 -0
  608. package/dist/esm/tests/public-api/llm-and-agents.test.js.map +7 -0
  609. package/dist/esm/tests/public-api/public-error-types.test.js +71 -0
  610. package/dist/esm/tests/public-api/public-error-types.test.js.map +7 -0
  611. package/dist/esm/tests/public-api/public-types.test.js +74 -0
  612. package/dist/esm/tests/public-api/public-types.test.js.map +7 -0
  613. package/dist/esm/tests/public-api/runtime-utils.test.js +31 -0
  614. package/dist/esm/tests/public-api/runtime-utils.test.js.map +7 -0
  615. package/dist/esm/tests/public-api/schema-utils.test.js +78 -0
  616. package/dist/esm/tests/public-api/schema-utils.test.js.map +7 -0
  617. package/dist/esm/tests/public-api/timeout-error-types.test.js +81 -0
  618. package/dist/esm/tests/public-api/timeout-error-types.test.js.map +7 -0
  619. package/dist/esm/tests/public-api/tool-type-export.test.js +25 -0
  620. package/dist/esm/tests/public-api/tool-type-export.test.js.map +7 -0
  621. package/dist/esm/tests/public-api/v3-core.test.js +82 -0
  622. package/dist/esm/tests/public-api/v3-core.test.js.map +7 -0
  623. package/dist/esm/tests/safety-confirmation.test.js +134 -0
  624. package/dist/esm/tests/safety-confirmation.test.js.map +7 -0
  625. package/dist/esm/tests/snapshot-a11y-resolvers.test.js +348 -0
  626. package/dist/esm/tests/snapshot-a11y-resolvers.test.js.map +7 -0
  627. package/dist/esm/tests/snapshot-a11y-tree-utils.test.js +300 -0
  628. package/dist/esm/tests/snapshot-a11y-tree-utils.test.js.map +7 -0
  629. package/dist/esm/tests/snapshot-capture-orchestration.test.js +381 -0
  630. package/dist/esm/tests/snapshot-capture-orchestration.test.js.map +7 -0
  631. package/dist/esm/tests/snapshot-cbor.test.js +197 -0
  632. package/dist/esm/tests/snapshot-cbor.test.js.map +7 -0
  633. package/dist/esm/tests/snapshot-dom-session-builders.test.js +251 -0
  634. package/dist/esm/tests/snapshot-dom-session-builders.test.js.map +7 -0
  635. package/dist/esm/tests/snapshot-dom-tree-utils.test.js +109 -0
  636. package/dist/esm/tests/snapshot-dom-tree-utils.test.js.map +7 -0
  637. package/dist/esm/tests/snapshot-focus-selectors-utils.test.js +49 -0
  638. package/dist/esm/tests/snapshot-focus-selectors-utils.test.js.map +7 -0
  639. package/dist/esm/tests/snapshot-frame-merge.test.js +391 -0
  640. package/dist/esm/tests/snapshot-frame-merge.test.js.map +7 -0
  641. package/dist/esm/tests/snapshot-tree-format-utils.test.js +113 -0
  642. package/dist/esm/tests/snapshot-tree-format-utils.test.js.map +7 -0
  643. package/dist/esm/tests/snapshot-xpath-utils.test.js +79 -0
  644. package/dist/esm/tests/snapshot-xpath-utils.test.js.map +7 -0
  645. package/dist/esm/tests/timeout-handlers.test.js +850 -0
  646. package/dist/esm/tests/timeout-handlers.test.js.map +7 -0
  647. package/dist/esm/tests/xpath-parser.test.js +317 -0
  648. package/dist/esm/tests/xpath-parser.test.js.map +7 -0
  649. package/dist/esm/tests/xpath-resolver.test.js +73 -0
  650. package/dist/esm/tests/xpath-resolver.test.js.map +7 -0
  651. package/dist/esm/tests/zod-enum-compatibility.test.js +97 -0
  652. package/dist/esm/tests/zod-enum-compatibility.test.js.map +7 -0
  653. package/package.json +37 -24
  654. package/dist/index.d.ts +0 -4363
  655. package/dist/index.js +0 -76530
@@ -0,0 +1,381 @@
1
+ import { beforeEach, describe, expect, it, vi } from "vitest";
2
+ import * as capture from "../lib/v3/understudy/a11y/snapshot/capture.js";
3
+ import * as a11yTree from "../lib/v3/understudy/a11y/snapshot/a11yTree.js";
4
+ import * as domTree from "../lib/v3/understudy/a11y/snapshot/domTree.js";
5
+ import * as focusSelectors from "../lib/v3/understudy/a11y/snapshot/focusSelectors.js";
6
+ import { MockCDPSession } from "./helpers/mockCDPSession.js";
7
+ const makeProtocolFrame = (id) => ({
8
+ id,
9
+ loaderId: `${id}-loader`,
10
+ url: "https://example.com",
11
+ securityOrigin: "https://example.com",
12
+ mimeType: "text/html"
13
+ });
14
+ const makeFrameTree = (id, children = []) => ({
15
+ frame: makeProtocolFrame(id),
16
+ childFrames: children
17
+ });
18
+ const makePage = (overrides = {}) => {
19
+ const defaultSession = new MockCDPSession({}, "default-session");
20
+ const base = {
21
+ mainFrameId: () => "frame-1",
22
+ asProtocolFrameTree: () => makeFrameTree("frame-1"),
23
+ listAllFrameIds: () => ["frame-1"],
24
+ getSessionForFrame: () => defaultSession,
25
+ getOrdinal: () => 0
26
+ };
27
+ return { ...base, ...overrides };
28
+ };
29
+ const makeSessionIndex = () => ({
30
+ rootBackend: 100,
31
+ absByBe: /* @__PURE__ */ new Map([
32
+ [100, "/"],
33
+ [101, "/html[1]"],
34
+ [102, "/html[1]/body[1]"],
35
+ [150, "/html[1]/body[1]/iframe[1]"],
36
+ [200, "/html[1]/body[1]/iframe[1]"],
37
+ [201, "/html[1]/body[1]/iframe[1]/div[1]"]
38
+ ]),
39
+ tagByBe: /* @__PURE__ */ new Map([
40
+ [100, "#document"],
41
+ [101, "html"],
42
+ [102, "body"],
43
+ [150, "iframe"],
44
+ [200, "#document"],
45
+ [201, "div"]
46
+ ]),
47
+ scrollByBe: /* @__PURE__ */ new Map([[201, true]]),
48
+ docRootOf: /* @__PURE__ */ new Map([
49
+ [100, 100],
50
+ [101, 100],
51
+ [102, 100],
52
+ [150, 100],
53
+ [200, 200],
54
+ [201, 200]
55
+ ]),
56
+ contentDocRootByIframe: /* @__PURE__ */ new Map([[150, 200]])
57
+ });
58
+ beforeEach(() => {
59
+ vi.restoreAllMocks();
60
+ });
61
+ describe("buildFrameContext", () => {
62
+ it("indexes parent relationships from the frame tree", () => {
63
+ const frameTree = makeFrameTree("frame-1", [
64
+ makeFrameTree("frame-2", [makeFrameTree("frame-3")]),
65
+ makeFrameTree("frame-4")
66
+ ]);
67
+ const page = makePage({
68
+ asProtocolFrameTree: () => frameTree,
69
+ listAllFrameIds: () => ["frame-1", "frame-2", "frame-3", "frame-4"]
70
+ });
71
+ const context = capture.buildFrameContext(page);
72
+ expect(context.rootId).toBe("frame-1");
73
+ expect(context.frames).toEqual([
74
+ "frame-1",
75
+ "frame-2",
76
+ "frame-3",
77
+ "frame-4"
78
+ ]);
79
+ expect(context.parentByFrame.get("frame-1")).toBeNull();
80
+ expect(context.parentByFrame.get("frame-2")).toBe("frame-1");
81
+ expect(context.parentByFrame.get("frame-3")).toBe("frame-2");
82
+ expect(context.parentByFrame.get("frame-4")).toBe("frame-1");
83
+ });
84
+ });
85
+ describe("buildSessionIndexes", () => {
86
+ it("deduplicates frames that share the same CDP session id", async () => {
87
+ const session = new MockCDPSession({}, "session-a");
88
+ const page = makePage({
89
+ // Every frame lookup returns the same session instance, so buildSessionIndexes
90
+ // should call buildSessionDomIndex only once and reuse the result.
91
+ getSessionForFrame: () => session
92
+ });
93
+ const idx = makeSessionIndex();
94
+ const spy = vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValue(idx);
95
+ const result = await capture.buildSessionIndexes(
96
+ page,
97
+ ["frame-1", "frame-2"],
98
+ true
99
+ );
100
+ expect(spy).toHaveBeenCalledTimes(1);
101
+ expect(spy).toHaveBeenCalledWith(session, true);
102
+ expect(result.get("session-a")).toBe(idx);
103
+ });
104
+ it("builds indexes for sessions without ids using the 'root' key", async () => {
105
+ const sessionWithoutId = {
106
+ id: void 0,
107
+ async send(_method, _params) {
108
+ return {};
109
+ },
110
+ on() {
111
+ },
112
+ off() {
113
+ },
114
+ async close() {
115
+ }
116
+ };
117
+ const sessionWithId = new MockCDPSession({}, "child-session");
118
+ const page = makePage({
119
+ getSessionForFrame: (frameId) => frameId === "frame-1" ? sessionWithoutId : sessionWithId
120
+ });
121
+ const idxA = makeSessionIndex();
122
+ const idxB = makeSessionIndex();
123
+ const spy = vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValueOnce(idxA).mockResolvedValueOnce(idxB);
124
+ const result = await capture.buildSessionIndexes(
125
+ page,
126
+ ["frame-1", "frame-2"],
127
+ false
128
+ );
129
+ expect(spy).toHaveBeenNthCalledWith(1, sessionWithoutId, false);
130
+ expect(spy).toHaveBeenNthCalledWith(2, sessionWithId, false);
131
+ expect(result.get("root")).toBe(idxA);
132
+ expect(result.get("child-session")).toBe(idxB);
133
+ });
134
+ });
135
+ describe("collectPerFrameMaps", () => {
136
+ it("builds per-frame xpath/tag maps and outlines from a shared session index", async () => {
137
+ const session = new MockCDPSession(
138
+ {
139
+ "DOM.getFrameOwner": async () => ({ backendNodeId: 150 })
140
+ },
141
+ "session-a"
142
+ );
143
+ const page = makePage({
144
+ getSessionForFrame: () => session,
145
+ getOrdinal: (frameId) => frameId === "frame-1" ? 0 : 1
146
+ });
147
+ const context = {
148
+ rootId: "frame-1",
149
+ frames: ["frame-1", "frame-2"],
150
+ parentByFrame: /* @__PURE__ */ new Map([
151
+ ["frame-1", null],
152
+ ["frame-2", "frame-1"]
153
+ ])
154
+ };
155
+ const sessionIndex = makeSessionIndex();
156
+ const sessionToIndex = /* @__PURE__ */ new Map([[session.id, sessionIndex]]);
157
+ vi.spyOn(a11yTree, "a11yForFrame").mockImplementation(
158
+ async (_sess, frameId) => ({
159
+ outline: `outline-${frameId}`,
160
+ urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },
161
+ scopeApplied: false
162
+ })
163
+ );
164
+ const result = await capture.collectPerFrameMaps(
165
+ page,
166
+ context,
167
+ sessionToIndex,
168
+ { experimental: true },
169
+ true,
170
+ context.frames
171
+ );
172
+ expect(result.perFrameOutlines).toEqual([
173
+ { frameId: "frame-1", outline: "outline-frame-1" },
174
+ { frameId: "frame-2", outline: "outline-frame-2" }
175
+ ]);
176
+ const rootMaps = result.perFrameMaps.get("frame-1");
177
+ expect(rootMaps?.xpathMap["0-100"]).toBe("/");
178
+ expect(rootMaps?.xpathMap["0-101"]).toBe("/html[1]");
179
+ expect(rootMaps?.xpathMap["0-102"]).toBe("/html[1]/body[1]");
180
+ const childMaps = result.perFrameMaps.get("frame-2");
181
+ expect(childMaps?.xpathMap["1-200"]).toBe("/");
182
+ expect(childMaps?.xpathMap["1-201"]).toBe("/div[1]");
183
+ expect(childMaps?.scrollableMap["1-201"]).toBe(true);
184
+ expect(childMaps?.urlMap).toEqual({
185
+ "url-frame-2": "https://frame-2.test"
186
+ });
187
+ expect(session.callsFor("DOM.getFrameOwner")).toHaveLength(1);
188
+ });
189
+ it("builds a missing session index on demand and memoizes it", async () => {
190
+ const session = new MockCDPSession({}, "new-session");
191
+ const page = makePage({
192
+ getSessionForFrame: () => session,
193
+ getOrdinal: () => 2
194
+ });
195
+ const context = {
196
+ rootId: "frame-9",
197
+ frames: ["frame-9"],
198
+ parentByFrame: /* @__PURE__ */ new Map([["frame-9", null]])
199
+ };
200
+ const idx = makeSessionIndex();
201
+ const buildSpy = vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValue(idx);
202
+ vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
203
+ outline: "outline",
204
+ urlMap: {},
205
+ scopeApplied: false
206
+ });
207
+ const sessionToIndex = /* @__PURE__ */ new Map();
208
+ const result = await capture.collectPerFrameMaps(
209
+ page,
210
+ context,
211
+ sessionToIndex,
212
+ void 0,
213
+ false,
214
+ context.frames
215
+ );
216
+ expect(buildSpy).toHaveBeenCalledWith(session, false);
217
+ expect(sessionToIndex.get("new-session")).toBe(idx);
218
+ expect(result.perFrameMaps.get("frame-9")?.xpathMap["2-100"]).toBe("/");
219
+ });
220
+ it("skips frames that are not listed in the frameIds argument", async () => {
221
+ const session = new MockCDPSession({}, "session-a");
222
+ const page = makePage({
223
+ getSessionForFrame: () => session,
224
+ getOrdinal: (frameId) => frameId === "frame-1" ? 0 : 1
225
+ });
226
+ const context = {
227
+ rootId: "frame-1",
228
+ frames: ["frame-1", "frame-2"],
229
+ parentByFrame: /* @__PURE__ */ new Map([
230
+ ["frame-1", null],
231
+ ["frame-2", "frame-1"]
232
+ ])
233
+ };
234
+ const sessionIndex = makeSessionIndex();
235
+ const sessionToIndex = /* @__PURE__ */ new Map([[session.id, sessionIndex]]);
236
+ const a11ySpy = vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
237
+ outline: "outline",
238
+ urlMap: {},
239
+ scopeApplied: false
240
+ });
241
+ const result = await capture.collectPerFrameMaps(
242
+ page,
243
+ context,
244
+ sessionToIndex,
245
+ void 0,
246
+ true,
247
+ ["frame-1"]
248
+ );
249
+ expect(a11ySpy).toHaveBeenCalledTimes(1);
250
+ expect(result.perFrameMaps.has("frame-2")).toBe(false);
251
+ expect(result.perFrameOutlines.map((o) => o.frameId)).toEqual(["frame-1"]);
252
+ });
253
+ });
254
+ describe("captureHybridSnapshot", () => {
255
+ it("returns early when the scoped snapshot path succeeds", async () => {
256
+ const session = new MockCDPSession({}, "session-a");
257
+ const page = makePage({
258
+ getSessionForFrame: () => session
259
+ });
260
+ const options = { focusSelector: "/html" };
261
+ vi.spyOn(focusSelectors, "resolveFocusFrameAndTail").mockResolvedValue({
262
+ targetFrameId: "frame-1",
263
+ tailXPath: "",
264
+ absPrefix: ""
265
+ });
266
+ const domMapsSpy = vi.spyOn(domTree, "domMapsForSession").mockResolvedValue({
267
+ tagNameMap: { "0-100": "#document" },
268
+ xpathMap: { "0-100": "/" },
269
+ scrollableMap: {}
270
+ });
271
+ const a11ySpy = vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
272
+ outline: "scoped outline",
273
+ urlMap: { "0-100": "https://frame-1.test" },
274
+ scopeApplied: true
275
+ });
276
+ const buildIndexSpy = vi.spyOn(domTree, "buildSessionDomIndex").mockImplementation(() => {
277
+ throw new Error("should not build session index when scoped");
278
+ });
279
+ const result = await capture.captureHybridSnapshot(page, options);
280
+ expect(result.combinedTree).toBe("scoped outline");
281
+ expect(result.combinedUrlMap["0-100"]).toBe("https://frame-1.test");
282
+ expect(domMapsSpy).toHaveBeenCalled();
283
+ expect(a11ySpy).toHaveBeenCalled();
284
+ expect(buildIndexSpy).not.toHaveBeenCalled();
285
+ });
286
+ it("scoped snapshot still succeeds when iframe inclusion is disabled", async () => {
287
+ const session = new MockCDPSession({}, "session-a");
288
+ const page = makePage({
289
+ getSessionForFrame: () => session
290
+ });
291
+ const options = { focusSelector: "/html", includeIframes: false };
292
+ vi.spyOn(focusSelectors, "resolveFocusFrameAndTail").mockResolvedValue({
293
+ targetFrameId: "frame-1",
294
+ tailXPath: "",
295
+ absPrefix: ""
296
+ });
297
+ const domMapsSpy = vi.spyOn(domTree, "domMapsForSession").mockResolvedValue({
298
+ tagNameMap: { "0-100": "#document" },
299
+ xpathMap: { "0-100": "/" },
300
+ scrollableMap: {}
301
+ });
302
+ const a11ySpy = vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
303
+ outline: "scoped outline",
304
+ urlMap: { "0-100": "https://frame-1.test" },
305
+ scopeApplied: true
306
+ });
307
+ const buildIndexSpy = vi.spyOn(domTree, "buildSessionDomIndex").mockImplementation(() => {
308
+ throw new Error("should not build session index when scoped");
309
+ });
310
+ const result = await capture.captureHybridSnapshot(page, options);
311
+ expect(result.combinedTree).toBe("scoped outline");
312
+ expect(result.combinedUrlMap["0-100"]).toBe("https://frame-1.test");
313
+ expect(domMapsSpy).toHaveBeenCalled();
314
+ expect(a11ySpy).toHaveBeenCalled();
315
+ expect(buildIndexSpy).not.toHaveBeenCalled();
316
+ });
317
+ it("collects per-frame data and merges it when no scoped snapshot is available", async () => {
318
+ const session = new MockCDPSession(
319
+ {
320
+ "DOM.getFrameOwner": async () => ({ backendNodeId: 150 })
321
+ },
322
+ "session-a"
323
+ );
324
+ const page = makePage({
325
+ asProtocolFrameTree: () => makeFrameTree("frame-1", [makeFrameTree("frame-2")]),
326
+ listAllFrameIds: () => ["frame-1", "frame-2"],
327
+ getSessionForFrame: () => session,
328
+ getOrdinal: (frameId) => frameId === "frame-1" ? 0 : 1
329
+ });
330
+ const idx = makeSessionIndex();
331
+ vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValue(idx);
332
+ vi.spyOn(a11yTree, "a11yForFrame").mockImplementation(
333
+ async (_sess, frameId) => ({
334
+ outline: frameId === "frame-1" ? "[0-150] iframe host" : "[1-200] child subtree",
335
+ urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },
336
+ scopeApplied: false
337
+ })
338
+ );
339
+ const snapshot = await capture.captureHybridSnapshot(page);
340
+ expect(snapshot.combinedTree).toContain("[1-200] child subtree");
341
+ expect(snapshot.combinedXpathMap["0-100"]).toBe("/");
342
+ expect(snapshot.combinedXpathMap["1-201"]).toBe(
343
+ "/html[1]/body[1]/iframe[1]/div[1]"
344
+ );
345
+ expect(snapshot.combinedUrlMap["url-frame-2"]).toBe("https://frame-2.test");
346
+ expect(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual([
347
+ "frame-1",
348
+ "frame-2"
349
+ ]);
350
+ });
351
+ it("omits iframe frames when includeIframes is false", async () => {
352
+ const session = new MockCDPSession(
353
+ {
354
+ "DOM.getFrameOwner": async () => ({ backendNodeId: 150 })
355
+ },
356
+ "session-a"
357
+ );
358
+ const page = makePage({
359
+ asProtocolFrameTree: () => makeFrameTree("frame-1", [makeFrameTree("frame-2")]),
360
+ listAllFrameIds: () => ["frame-1", "frame-2"],
361
+ getSessionForFrame: () => session,
362
+ getOrdinal: (frameId) => frameId === "frame-1" ? 0 : 1
363
+ });
364
+ const idx = makeSessionIndex();
365
+ vi.spyOn(domTree, "buildSessionDomIndex").mockResolvedValue(idx);
366
+ const a11ySpy = vi.spyOn(a11yTree, "a11yForFrame").mockImplementation(async (_sess, frameId) => ({
367
+ outline: frameId === "frame-1" ? "[0-150] iframe host" : "[1-200] child subtree",
368
+ urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },
369
+ scopeApplied: false
370
+ }));
371
+ const snapshot = await capture.captureHybridSnapshot(page, {
372
+ includeIframes: false
373
+ });
374
+ expect(a11ySpy).toHaveBeenCalledTimes(1);
375
+ expect(session.callsFor("DOM.getFrameOwner")).toHaveLength(0);
376
+ expect(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual(["frame-1"]);
377
+ expect(snapshot.combinedXpathMap["1-201"]).toBeUndefined();
378
+ expect(snapshot.combinedTree).not.toContain("[1-200] child subtree");
379
+ });
380
+ });
381
+ //# sourceMappingURL=snapshot-capture-orchestration.test.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../tests/snapshot-capture-orchestration.test.ts"],
4
+ "sourcesContent": ["import type { Protocol } from \"devtools-protocol\";\nimport { beforeEach, describe, expect, it, vi } from \"vitest\";\nimport type { CDPSessionLike } from \"../lib/v3/understudy/cdp.js\";\nimport type { Page } from \"../lib/v3/understudy/page.js\";\nimport type {\n FrameContext,\n SessionDomIndex,\n} from \"../lib/v3/types/private/index.js\";\nimport * as capture from \"../lib/v3/understudy/a11y/snapshot/capture.js\";\nimport * as a11yTree from \"../lib/v3/understudy/a11y/snapshot/a11yTree.js\";\nimport * as domTree from \"../lib/v3/understudy/a11y/snapshot/domTree.js\";\nimport * as focusSelectors from \"../lib/v3/understudy/a11y/snapshot/focusSelectors.js\";\nimport { MockCDPSession } from \"./helpers/mockCDPSession.js\";\n\nconst makeProtocolFrame = (id: string): Protocol.Page.Frame =>\n ({\n id,\n loaderId: `${id}-loader`,\n url: \"https://example.com\",\n securityOrigin: \"https://example.com\",\n mimeType: \"text/html\",\n }) as unknown as Protocol.Page.Frame;\n\nconst makeFrameTree = (\n id: string,\n children: Protocol.Page.FrameTree[] = [],\n): Protocol.Page.FrameTree => ({\n frame: makeProtocolFrame(id),\n childFrames: children,\n});\n\ntype PageStub = Pick<\n Page,\n | \"mainFrameId\"\n | \"asProtocolFrameTree\"\n | \"listAllFrameIds\"\n | \"getSessionForFrame\"\n | \"getOrdinal\"\n>;\n\nconst makePage = (overrides: Partial<PageStub> = {}): Page => {\n const defaultSession = new MockCDPSession({}, \"default-session\");\n const base: PageStub = {\n mainFrameId: () => \"frame-1\",\n asProtocolFrameTree: () => makeFrameTree(\"frame-1\"),\n listAllFrameIds: () => [\"frame-1\"],\n getSessionForFrame: () => defaultSession,\n getOrdinal: () => 0,\n };\n return { ...base, ...overrides } as unknown as Page;\n};\n\nconst makeSessionIndex = (): SessionDomIndex => ({\n rootBackend: 100,\n absByBe: new Map([\n [100, \"/\"],\n [101, \"/html[1]\"],\n [102, \"/html[1]/body[1]\"],\n [150, \"/html[1]/body[1]/iframe[1]\"],\n [200, \"/html[1]/body[1]/iframe[1]\"],\n [201, \"/html[1]/body[1]/iframe[1]/div[1]\"],\n ]),\n tagByBe: new Map([\n [100, \"#document\"],\n [101, \"html\"],\n [102, \"body\"],\n [150, \"iframe\"],\n [200, \"#document\"],\n [201, \"div\"],\n ]),\n scrollByBe: new Map([[201, true]]),\n docRootOf: new Map([\n [100, 100],\n [101, 100],\n [102, 100],\n [150, 100],\n [200, 200],\n [201, 200],\n ]),\n contentDocRootByIframe: new Map([[150, 200]]),\n});\n\nbeforeEach(() => {\n vi.restoreAllMocks();\n});\n\ndescribe(\"buildFrameContext\", () => {\n it(\"indexes parent relationships from the frame tree\", () => {\n const frameTree = makeFrameTree(\"frame-1\", [\n makeFrameTree(\"frame-2\", [makeFrameTree(\"frame-3\")]),\n makeFrameTree(\"frame-4\"),\n ]);\n const page = makePage({\n asProtocolFrameTree: () => frameTree,\n listAllFrameIds: () => [\"frame-1\", \"frame-2\", \"frame-3\", \"frame-4\"],\n });\n\n const context = capture.buildFrameContext(page);\n\n expect(context.rootId).toBe(\"frame-1\");\n expect(context.frames).toEqual([\n \"frame-1\",\n \"frame-2\",\n \"frame-3\",\n \"frame-4\",\n ]);\n expect(context.parentByFrame.get(\"frame-1\")).toBeNull();\n expect(context.parentByFrame.get(\"frame-2\")).toBe(\"frame-1\");\n expect(context.parentByFrame.get(\"frame-3\")).toBe(\"frame-2\");\n expect(context.parentByFrame.get(\"frame-4\")).toBe(\"frame-1\");\n });\n});\n\ndescribe(\"buildSessionIndexes\", () => {\n it(\"deduplicates frames that share the same CDP session id\", async () => {\n const session = new MockCDPSession({}, \"session-a\");\n const page = makePage({\n // Every frame lookup returns the same session instance, so buildSessionIndexes\n // should call buildSessionDomIndex only once and reuse the result.\n getSessionForFrame: () => session,\n });\n const idx = makeSessionIndex();\n const spy = vi\n .spyOn(domTree, \"buildSessionDomIndex\")\n .mockResolvedValue(idx);\n\n const result = await capture.buildSessionIndexes(\n page,\n [\"frame-1\", \"frame-2\"],\n true,\n );\n\n expect(spy).toHaveBeenCalledTimes(1); // only one DOM.getDocument per session id\n expect(spy).toHaveBeenCalledWith(session, true);\n expect(result.get(\"session-a\")).toBe(idx);\n });\n\n it(\"builds indexes for sessions without ids using the 'root' key\", async () => {\n const sessionWithoutId: CDPSessionLike = {\n id: undefined,\n async send<R = unknown>(\n _method: string,\n _params?: Record<string, unknown>,\n ): Promise<R> {\n void _method;\n void _params;\n return {} as R;\n },\n on() {},\n off() {},\n async close() {},\n };\n const sessionWithId = new MockCDPSession({}, \"child-session\");\n const page = makePage({\n getSessionForFrame: (frameId: string) =>\n frameId === \"frame-1\" ? sessionWithoutId : sessionWithId,\n });\n\n const idxA = makeSessionIndex();\n const idxB = makeSessionIndex();\n const spy = vi\n .spyOn(domTree, \"buildSessionDomIndex\")\n .mockResolvedValueOnce(idxA)\n .mockResolvedValueOnce(idxB);\n\n const result = await capture.buildSessionIndexes(\n page,\n [\"frame-1\", \"frame-2\"],\n false,\n );\n\n // Verifies the helper invokes buildSessionDomIndex once for each unique session,\n // keying anonymous sessions as \"root\" so downstream lookups remain stable.\n expect(spy).toHaveBeenNthCalledWith(1, sessionWithoutId, false);\n expect(spy).toHaveBeenNthCalledWith(2, sessionWithId, false);\n expect(result.get(\"root\")).toBe(idxA);\n expect(result.get(\"child-session\")).toBe(idxB);\n });\n});\n\ndescribe(\"collectPerFrameMaps\", () => {\n it(\"builds per-frame xpath/tag maps and outlines from a shared session index\", async () => {\n const session = new MockCDPSession(\n {\n \"DOM.getFrameOwner\": async () => ({ backendNodeId: 150 }),\n },\n \"session-a\",\n );\n const page = makePage({\n getSessionForFrame: () => session,\n getOrdinal: (frameId: string) => (frameId === \"frame-1\" ? 0 : 1),\n });\n const context: FrameContext = {\n rootId: \"frame-1\",\n frames: [\"frame-1\", \"frame-2\"],\n parentByFrame: new Map([\n [\"frame-1\", null],\n [\"frame-2\", \"frame-1\"],\n ]),\n };\n const sessionIndex = makeSessionIndex();\n const sessionToIndex = new Map([[session.id, sessionIndex]]);\n\n vi.spyOn(a11yTree, \"a11yForFrame\").mockImplementation(\n async (_sess, frameId) => ({\n outline: `outline-${frameId}`,\n urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },\n scopeApplied: false,\n }),\n );\n\n const result = await capture.collectPerFrameMaps(\n page,\n context,\n sessionToIndex,\n { experimental: true },\n true,\n context.frames,\n );\n\n expect(result.perFrameOutlines).toEqual([\n { frameId: \"frame-1\", outline: \"outline-frame-1\" },\n { frameId: \"frame-2\", outline: \"outline-frame-2\" },\n ]);\n const rootMaps = result.perFrameMaps.get(\"frame-1\");\n expect(rootMaps?.xpathMap[\"0-100\"]).toBe(\"/\");\n expect(rootMaps?.xpathMap[\"0-101\"]).toBe(\"/html[1]\");\n expect(rootMaps?.xpathMap[\"0-102\"]).toBe(\"/html[1]/body[1]\");\n const childMaps = result.perFrameMaps.get(\"frame-2\");\n expect(childMaps?.xpathMap[\"1-200\"]).toBe(\"/\");\n expect(childMaps?.xpathMap[\"1-201\"]).toBe(\"/div[1]\");\n expect(childMaps?.scrollableMap[\"1-201\"]).toBe(true);\n expect(childMaps?.urlMap).toEqual({\n \"url-frame-2\": \"https://frame-2.test\",\n });\n expect(session.callsFor(\"DOM.getFrameOwner\")).toHaveLength(1);\n });\n\n it(\"builds a missing session index on demand and memoizes it\", async () => {\n const session = new MockCDPSession({}, \"new-session\");\n const page = makePage({\n getSessionForFrame: () => session,\n getOrdinal: () => 2,\n });\n const context: FrameContext = {\n rootId: \"frame-9\",\n frames: [\"frame-9\"],\n parentByFrame: new Map([[\"frame-9\", null]]),\n };\n const idx = makeSessionIndex();\n const buildSpy = vi\n .spyOn(domTree, \"buildSessionDomIndex\")\n .mockResolvedValue(idx);\n vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n outline: \"outline\",\n urlMap: {},\n scopeApplied: false,\n });\n\n const sessionToIndex = new Map<string, SessionDomIndex>();\n const result = await capture.collectPerFrameMaps(\n page,\n context,\n sessionToIndex,\n undefined,\n false,\n context.frames,\n );\n\n expect(buildSpy).toHaveBeenCalledWith(session, false);\n expect(sessionToIndex.get(\"new-session\")).toBe(idx);\n expect(result.perFrameMaps.get(\"frame-9\")?.xpathMap[\"2-100\"]).toBe(\"/\");\n });\n\n it(\"skips frames that are not listed in the frameIds argument\", async () => {\n const session = new MockCDPSession({}, \"session-a\");\n const page = makePage({\n getSessionForFrame: () => session,\n getOrdinal: (frameId: string) => (frameId === \"frame-1\" ? 0 : 1),\n });\n const context: FrameContext = {\n rootId: \"frame-1\",\n frames: [\"frame-1\", \"frame-2\"],\n parentByFrame: new Map([\n [\"frame-1\", null],\n [\"frame-2\", \"frame-1\"],\n ]),\n };\n const sessionIndex = makeSessionIndex();\n const sessionToIndex = new Map([[session.id, sessionIndex]]);\n\n const a11ySpy = vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n outline: \"outline\",\n urlMap: {},\n scopeApplied: false,\n });\n\n const result = await capture.collectPerFrameMaps(\n page,\n context,\n sessionToIndex,\n undefined,\n true,\n [\"frame-1\"],\n );\n\n expect(a11ySpy).toHaveBeenCalledTimes(1);\n expect(result.perFrameMaps.has(\"frame-2\")).toBe(false);\n expect(result.perFrameOutlines.map((o) => o.frameId)).toEqual([\"frame-1\"]);\n });\n});\n\ndescribe(\"captureHybridSnapshot\", () => {\n it(\"returns early when the scoped snapshot path succeeds\", async () => {\n const session = new MockCDPSession({}, \"session-a\");\n const page = makePage({\n getSessionForFrame: () => session,\n });\n const options = { focusSelector: \"/html\" };\n\n vi.spyOn(focusSelectors, \"resolveFocusFrameAndTail\").mockResolvedValue({\n targetFrameId: \"frame-1\",\n tailXPath: \"\",\n absPrefix: \"\",\n });\n const domMapsSpy = vi\n .spyOn(domTree, \"domMapsForSession\")\n .mockResolvedValue({\n tagNameMap: { \"0-100\": \"#document\" },\n xpathMap: { \"0-100\": \"/\" },\n scrollableMap: {},\n });\n const a11ySpy = vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n outline: \"scoped outline\",\n urlMap: { \"0-100\": \"https://frame-1.test\" },\n scopeApplied: true,\n });\n const buildIndexSpy = vi\n .spyOn(domTree, \"buildSessionDomIndex\")\n .mockImplementation(() => {\n throw new Error(\"should not build session index when scoped\");\n });\n\n const result = await capture.captureHybridSnapshot(page, options);\n\n expect(result.combinedTree).toBe(\"scoped outline\");\n expect(result.combinedUrlMap[\"0-100\"]).toBe(\"https://frame-1.test\");\n expect(domMapsSpy).toHaveBeenCalled();\n expect(a11ySpy).toHaveBeenCalled();\n expect(buildIndexSpy).not.toHaveBeenCalled();\n });\n\n it(\"scoped snapshot still succeeds when iframe inclusion is disabled\", async () => {\n const session = new MockCDPSession({}, \"session-a\");\n const page = makePage({\n getSessionForFrame: () => session,\n });\n const options = { focusSelector: \"/html\", includeIframes: false };\n\n vi.spyOn(focusSelectors, \"resolveFocusFrameAndTail\").mockResolvedValue({\n targetFrameId: \"frame-1\",\n tailXPath: \"\",\n absPrefix: \"\",\n });\n const domMapsSpy = vi\n .spyOn(domTree, \"domMapsForSession\")\n .mockResolvedValue({\n tagNameMap: { \"0-100\": \"#document\" },\n xpathMap: { \"0-100\": \"/\" },\n scrollableMap: {},\n });\n const a11ySpy = vi.spyOn(a11yTree, \"a11yForFrame\").mockResolvedValue({\n outline: \"scoped outline\",\n urlMap: { \"0-100\": \"https://frame-1.test\" },\n scopeApplied: true,\n });\n const buildIndexSpy = vi\n .spyOn(domTree, \"buildSessionDomIndex\")\n .mockImplementation(() => {\n throw new Error(\"should not build session index when scoped\");\n });\n\n const result = await capture.captureHybridSnapshot(page, options);\n\n expect(result.combinedTree).toBe(\"scoped outline\");\n expect(result.combinedUrlMap[\"0-100\"]).toBe(\"https://frame-1.test\");\n expect(domMapsSpy).toHaveBeenCalled();\n expect(a11ySpy).toHaveBeenCalled();\n expect(buildIndexSpy).not.toHaveBeenCalled();\n });\n\n it(\"collects per-frame data and merges it when no scoped snapshot is available\", async () => {\n const session = new MockCDPSession(\n {\n \"DOM.getFrameOwner\": async () => ({ backendNodeId: 150 }),\n },\n \"session-a\",\n );\n const page = makePage({\n asProtocolFrameTree: () =>\n makeFrameTree(\"frame-1\", [makeFrameTree(\"frame-2\")]),\n listAllFrameIds: () => [\"frame-1\", \"frame-2\"],\n getSessionForFrame: () => session,\n getOrdinal: (frameId: string) => (frameId === \"frame-1\" ? 0 : 1),\n });\n\n const idx = makeSessionIndex();\n vi.spyOn(domTree, \"buildSessionDomIndex\").mockResolvedValue(idx);\n vi.spyOn(a11yTree, \"a11yForFrame\").mockImplementation(\n async (_sess, frameId) => ({\n outline:\n frameId === \"frame-1\"\n ? \"[0-150] iframe host\"\n : \"[1-200] child subtree\",\n urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },\n scopeApplied: false,\n }),\n );\n\n const snapshot = await capture.captureHybridSnapshot(page);\n\n expect(snapshot.combinedTree).toContain(\"[1-200] child subtree\");\n expect(snapshot.combinedXpathMap[\"0-100\"]).toBe(\"/\");\n expect(snapshot.combinedXpathMap[\"1-201\"]).toBe(\n \"/html[1]/body[1]/iframe[1]/div[1]\",\n );\n expect(snapshot.combinedUrlMap[\"url-frame-2\"]).toBe(\"https://frame-2.test\");\n expect(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual([\n \"frame-1\",\n \"frame-2\",\n ]);\n });\n\n it(\"omits iframe frames when includeIframes is false\", async () => {\n const session = new MockCDPSession(\n {\n \"DOM.getFrameOwner\": async () => ({ backendNodeId: 150 }),\n },\n \"session-a\",\n );\n const page = makePage({\n asProtocolFrameTree: () =>\n makeFrameTree(\"frame-1\", [makeFrameTree(\"frame-2\")]),\n listAllFrameIds: () => [\"frame-1\", \"frame-2\"],\n getSessionForFrame: () => session,\n getOrdinal: (frameId: string) => (frameId === \"frame-1\" ? 0 : 1),\n });\n\n const idx = makeSessionIndex();\n vi.spyOn(domTree, \"buildSessionDomIndex\").mockResolvedValue(idx);\n const a11ySpy = vi\n .spyOn(a11yTree, \"a11yForFrame\")\n .mockImplementation(async (_sess, frameId) => ({\n outline:\n frameId === \"frame-1\"\n ? \"[0-150] iframe host\"\n : \"[1-200] child subtree\",\n urlMap: { [`url-${frameId}`]: `https://${frameId}.test` },\n scopeApplied: false,\n }));\n\n const snapshot = await capture.captureHybridSnapshot(page, {\n includeIframes: false,\n });\n\n expect(a11ySpy).toHaveBeenCalledTimes(1);\n expect(session.callsFor(\"DOM.getFrameOwner\")).toHaveLength(0);\n expect(snapshot.perFrame?.map((pf) => pf.frameId)).toEqual([\"frame-1\"]);\n expect(snapshot.combinedXpathMap[\"1-201\"]).toBeUndefined();\n expect(snapshot.combinedTree).not.toContain(\"[1-200] child subtree\");\n });\n});\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,197 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { captureHybridSnapshot } from "../lib/v3/understudy/a11y/snapshot/index.js";
3
+ import { MockCDPSession } from "./helpers/mockCDPSession.js";
4
+ import { StagehandDomProcessError } from "../lib/v3/types/public/sdkErrors.js";
5
+ function createFakePage(session) {
6
+ const frameTree = {
7
+ frame: {
8
+ id: "root",
9
+ loaderId: "root-loader",
10
+ url: "http://fake",
11
+ domainAndRegistry: "fake",
12
+ securityOrigin: "http://fake",
13
+ mimeType: "text/html",
14
+ secureContextType: "Secure",
15
+ crossOriginIsolatedContextType: "NotIsolated",
16
+ gatedAPIFeatures: []
17
+ },
18
+ childFrames: []
19
+ };
20
+ return {
21
+ mainFrameId: () => "root",
22
+ asProtocolFrameTree: () => frameTree,
23
+ listAllFrameIds: () => ["root"],
24
+ getSessionForFrame: () => session,
25
+ getOrdinal: () => 0
26
+ };
27
+ }
28
+ function completeDomTree() {
29
+ return {
30
+ nodeId: 1,
31
+ backendNodeId: 1,
32
+ nodeType: 9,
33
+ nodeName: "#document",
34
+ childNodeCount: 1,
35
+ children: [
36
+ {
37
+ nodeId: 2,
38
+ backendNodeId: 2,
39
+ nodeType: 1,
40
+ nodeName: "HTML",
41
+ childNodeCount: 1,
42
+ children: [
43
+ {
44
+ nodeId: 3,
45
+ backendNodeId: 3,
46
+ nodeType: 1,
47
+ nodeName: "BODY",
48
+ childNodeCount: 1,
49
+ children: [
50
+ {
51
+ nodeId: 4,
52
+ backendNodeId: 4,
53
+ nodeType: 1,
54
+ nodeName: "DIV",
55
+ childNodeCount: 0,
56
+ children: []
57
+ }
58
+ ]
59
+ }
60
+ ]
61
+ }
62
+ ]
63
+ };
64
+ }
65
+ function truncatedDomTree() {
66
+ return {
67
+ nodeId: 1,
68
+ backendNodeId: 1,
69
+ nodeType: 9,
70
+ nodeName: "#document",
71
+ childNodeCount: 1,
72
+ children: [
73
+ {
74
+ nodeId: 2,
75
+ backendNodeId: 2,
76
+ nodeType: 1,
77
+ nodeName: "HTML",
78
+ childNodeCount: 1,
79
+ children: []
80
+ }
81
+ ]
82
+ };
83
+ }
84
+ function htmlWithChildren() {
85
+ return {
86
+ nodeId: 2,
87
+ backendNodeId: 2,
88
+ nodeType: 1,
89
+ nodeName: "HTML",
90
+ childNodeCount: 1,
91
+ children: [
92
+ {
93
+ nodeId: 3,
94
+ backendNodeId: 3,
95
+ nodeType: 1,
96
+ nodeName: "BODY",
97
+ childNodeCount: 1,
98
+ children: [
99
+ {
100
+ nodeId: 4,
101
+ backendNodeId: 4,
102
+ nodeType: 1,
103
+ nodeName: "DIV",
104
+ childNodeCount: 0,
105
+ children: []
106
+ }
107
+ ]
108
+ }
109
+ ]
110
+ };
111
+ }
112
+ function simpleAxNodes() {
113
+ const stringType = "string";
114
+ return [
115
+ {
116
+ nodeId: "1",
117
+ role: { type: stringType, value: "RootWebArea" },
118
+ backendDOMNodeId: 2,
119
+ childIds: ["2"],
120
+ ignored: false
121
+ },
122
+ {
123
+ nodeId: "2",
124
+ role: { type: stringType, value: "generic" },
125
+ name: { type: stringType, value: "Content" },
126
+ backendDOMNodeId: 4,
127
+ parentId: "1",
128
+ childIds: [],
129
+ ignored: false
130
+ }
131
+ ];
132
+ }
133
+ const baseHandlers = {
134
+ "DOM.enable": async () => ({}),
135
+ "Runtime.enable": async () => ({}),
136
+ "Accessibility.enable": async () => ({}),
137
+ "Accessibility.getFullAXTree": async () => ({ nodes: simpleAxNodes() })
138
+ };
139
+ function makeCborError() {
140
+ return new Error("CBOR: stack limit exceeded");
141
+ }
142
+ describe("captureHybridSnapshot CBOR fallbacks", () => {
143
+ it("retries DOM.getDocument with reduced depths before succeeding", async () => {
144
+ let domCalls = 0;
145
+ const session = new MockCDPSession({
146
+ ...baseHandlers,
147
+ "DOM.getDocument": async (params) => {
148
+ domCalls += 1;
149
+ if (domCalls === 1) throw makeCborError();
150
+ expect(params?.depth).toBe(256);
151
+ return { root: completeDomTree() };
152
+ }
153
+ });
154
+ const page = createFakePage(session);
155
+ const snapshot = await captureHybridSnapshot(page);
156
+ expect(snapshot.combinedTree).toContain("html");
157
+ const depths = session.callsFor("DOM.getDocument").map((c) => c.params?.depth);
158
+ expect(depths).toEqual([-1, 256]);
159
+ });
160
+ it("throws StagehandDomProcessError after all DOM.getDocument attempts fail", async () => {
161
+ const session = new MockCDPSession({
162
+ ...baseHandlers,
163
+ "DOM.getDocument": async () => {
164
+ throw makeCborError();
165
+ }
166
+ });
167
+ const page = createFakePage(session);
168
+ await expect(captureHybridSnapshot(page)).rejects.toThrow(
169
+ StagehandDomProcessError
170
+ );
171
+ });
172
+ it("hydrates truncated nodes by retrying DOM.describeNode depths", async () => {
173
+ let domAttempts = 0;
174
+ let describeAttempts = 0;
175
+ const session = new MockCDPSession({
176
+ ...baseHandlers,
177
+ "DOM.getDocument": async (params) => {
178
+ domAttempts += 1;
179
+ if (domAttempts === 1) throw makeCborError();
180
+ expect(params?.depth).toBe(256);
181
+ return { root: truncatedDomTree() };
182
+ },
183
+ "DOM.describeNode": async (params) => {
184
+ describeAttempts += 1;
185
+ if (describeAttempts === 1) throw makeCborError();
186
+ expect(params?.depth).toBe(64);
187
+ return { node: htmlWithChildren() };
188
+ }
189
+ });
190
+ const page = createFakePage(session);
191
+ const snapshot = await captureHybridSnapshot(page);
192
+ const describeDepths = session.callsFor("DOM.describeNode").map((c) => c.params?.depth);
193
+ expect(describeDepths).toEqual([-1, 64]);
194
+ expect(snapshot.combinedXpathMap["0-4"]).toBe("/html[1]/body[1]/div[1]");
195
+ });
196
+ });
197
+ //# sourceMappingURL=snapshot-cbor.test.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../tests/snapshot-cbor.test.ts"],
4
+ "sourcesContent": ["import { describe, expect, it } from \"vitest\";\nimport type { Protocol } from \"devtools-protocol\";\n\nimport { captureHybridSnapshot } from \"../lib/v3/understudy/a11y/snapshot/index.js\";\nimport { MockCDPSession } from \"./helpers/mockCDPSession.js\";\nimport type { Page } from \"../lib/v3/understudy/page.js\";\nimport { StagehandDomProcessError } from \"../lib/v3/types/public/sdkErrors.js\";\nimport { CDPSessionLike } from \"../lib/v3/understudy/cdp.js\";\n\ntype Handler = (params?: Record<string, unknown>) => Promise<unknown> | unknown;\n\nfunction createFakePage(session: CDPSessionLike): Page {\n const frameTree: Protocol.Page.FrameTree = {\n frame: {\n id: \"root\" as Protocol.Page.FrameId,\n loaderId: \"root-loader\" as Protocol.Network.LoaderId,\n url: \"http://fake\",\n domainAndRegistry: \"fake\",\n securityOrigin: \"http://fake\",\n mimeType: \"text/html\",\n secureContextType: \"Secure\",\n crossOriginIsolatedContextType: \"NotIsolated\",\n gatedAPIFeatures: [],\n },\n childFrames: [],\n };\n\n return {\n mainFrameId: () => \"root\",\n asProtocolFrameTree: () => frameTree,\n listAllFrameIds: () => [\"root\"],\n getSessionForFrame: () => session,\n getOrdinal: () => 0,\n } as unknown as Page;\n}\n\nfunction completeDomTree(): Protocol.DOM.Node {\n return {\n nodeId: 1,\n backendNodeId: 1,\n nodeType: 9,\n nodeName: \"#document\",\n childNodeCount: 1,\n children: [\n {\n nodeId: 2,\n backendNodeId: 2,\n nodeType: 1,\n nodeName: \"HTML\",\n childNodeCount: 1,\n children: [\n {\n nodeId: 3,\n backendNodeId: 3,\n nodeType: 1,\n nodeName: \"BODY\",\n childNodeCount: 1,\n children: [\n {\n nodeId: 4,\n backendNodeId: 4,\n nodeType: 1,\n nodeName: \"DIV\",\n childNodeCount: 0,\n children: [],\n },\n ],\n },\n ],\n },\n ],\n } as Protocol.DOM.Node;\n}\n\nfunction truncatedDomTree(): Protocol.DOM.Node {\n return {\n nodeId: 1,\n backendNodeId: 1,\n nodeType: 9,\n nodeName: \"#document\",\n childNodeCount: 1,\n children: [\n {\n nodeId: 2,\n backendNodeId: 2,\n nodeType: 1,\n nodeName: \"HTML\",\n childNodeCount: 1,\n children: [],\n },\n ],\n } as Protocol.DOM.Node;\n}\n\nfunction htmlWithChildren(): Protocol.DOM.Node {\n return {\n nodeId: 2,\n backendNodeId: 2,\n nodeType: 1,\n nodeName: \"HTML\",\n childNodeCount: 1,\n children: [\n {\n nodeId: 3,\n backendNodeId: 3,\n nodeType: 1,\n nodeName: \"BODY\",\n childNodeCount: 1,\n children: [\n {\n nodeId: 4,\n backendNodeId: 4,\n nodeType: 1,\n nodeName: \"DIV\",\n childNodeCount: 0,\n children: [],\n },\n ],\n },\n ],\n } as Protocol.DOM.Node;\n}\n\nfunction simpleAxNodes(): Protocol.Accessibility.AXNode[] {\n const stringType: Protocol.Accessibility.AXValueType = \"string\";\n return [\n {\n nodeId: \"1\",\n role: { type: stringType, value: \"RootWebArea\" },\n backendDOMNodeId: 2,\n childIds: [\"2\"],\n ignored: false,\n },\n {\n nodeId: \"2\",\n role: { type: stringType, value: \"generic\" },\n name: { type: stringType, value: \"Content\" },\n backendDOMNodeId: 4,\n parentId: \"1\",\n childIds: [] as string[],\n ignored: false,\n },\n ];\n}\n\nconst baseHandlers: Record<string, Handler> = {\n \"DOM.enable\": async () => ({}),\n \"Runtime.enable\": async () => ({}),\n \"Accessibility.enable\": async () => ({}),\n \"Accessibility.getFullAXTree\": async () => ({ nodes: simpleAxNodes() }),\n};\n\nfunction makeCborError(): Error {\n return new Error(\"CBOR: stack limit exceeded\");\n}\n\ndescribe(\"captureHybridSnapshot CBOR fallbacks\", () => {\n it(\"retries DOM.getDocument with reduced depths before succeeding\", async () => {\n let domCalls = 0;\n const session = new MockCDPSession({\n ...baseHandlers,\n \"DOM.getDocument\": async (params) => {\n domCalls += 1;\n if (domCalls === 1) throw makeCborError();\n expect(params?.depth).toBe(256);\n return { root: completeDomTree() };\n },\n });\n\n const page = createFakePage(session);\n const snapshot = await captureHybridSnapshot(page);\n\n expect(snapshot.combinedTree).toContain(\"html\");\n const depths = session\n .callsFor(\"DOM.getDocument\")\n .map((c) => c.params?.depth);\n expect(depths).toEqual([-1, 256]);\n });\n\n it(\"throws StagehandDomProcessError after all DOM.getDocument attempts fail\", async () => {\n const session = new MockCDPSession({\n ...baseHandlers,\n \"DOM.getDocument\": async () => {\n throw makeCborError();\n },\n });\n\n const page = createFakePage(session);\n await expect(captureHybridSnapshot(page)).rejects.toThrow(\n StagehandDomProcessError,\n );\n });\n\n it(\"hydrates truncated nodes by retrying DOM.describeNode depths\", async () => {\n let domAttempts = 0;\n let describeAttempts = 0;\n\n const session = new MockCDPSession({\n ...baseHandlers,\n \"DOM.getDocument\": async (params) => {\n domAttempts += 1;\n if (domAttempts === 1) throw makeCborError();\n expect(params?.depth).toBe(256);\n return { root: truncatedDomTree() };\n },\n \"DOM.describeNode\": async (params) => {\n describeAttempts += 1;\n if (describeAttempts === 1) throw makeCborError();\n expect(params?.depth).toBe(64);\n return { node: htmlWithChildren() };\n },\n });\n\n const page = createFakePage(session);\n const snapshot = await captureHybridSnapshot(page);\n\n const describeDepths = session\n .callsFor(\"DOM.describeNode\")\n .map((c) => c.params?.depth);\n expect(describeDepths).toEqual([-1, 64]);\n expect(snapshot.combinedXpathMap[\"0-4\"]).toBe(\"/html[1]/body[1]/div[1]\");\n });\n});\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }