@browserbasehq/orca 3.0.9-alpha-3 → 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 +42 -27
  654. package/dist/index.d.ts +0 -4321
  655. package/dist/index.js +0 -69585
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GoogleClient.js","sourceRoot":"","sources":["../../../../../lib/v3/llm/GoogleClient.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n GoogleGenAI,\n HarmCategory,\n HarmBlockThreshold,\n Content,\n Part,\n Tool,\n FunctionCall,\n Schema,\n Type,\n} from \"@google/genai\";\n\nimport { LogLine } from \"../types/public/logs.js\";\nimport { AvailableModel, ClientOptions } from \"../types/public/model.js\";\nimport {\n validateZodSchema,\n toGeminiSchema,\n loadApiKeyFromEnv,\n} from \"../../utils.js\";\nimport {\n ChatCompletionOptions,\n ChatMessage,\n CreateChatCompletionOptions,\n LLMClient,\n LLMResponse,\n AnnotatedScreenshotText,\n} from \"./LLMClient.js\";\nimport {\n CreateChatCompletionResponseError,\n StagehandError,\n} from \"../types/public/sdkErrors.js\";\n\n// Mapping from generic roles to Gemini roles\nconst roleMap: { [key in ChatMessage[\"role\"]]: string } = {\n user: \"user\",\n assistant: \"model\",\n system: \"user\", // Gemini API prefers system instructions either via system_instruction or at the start of 'user' content\n};\n\n// Basic safety settings - adjust as needed\nconst safetySettings = [\n {\n category: HarmCategory.HARM_CATEGORY_HARASSMENT,\n threshold: HarmBlockThreshold.BLOCK_MEDIUM_AND_ABOVE,\n },\n {\n category: HarmCategory.HARM_CATEGORY_HATE_SPEECH,\n threshold: HarmBlockThreshold.BLOCK_MEDIUM_AND_ABOVE,\n },\n {\n category: HarmCategory.HARM_CATEGORY_SEXUALLY_EXPLICIT,\n threshold: HarmBlockThreshold.BLOCK_MEDIUM_AND_ABOVE,\n },\n {\n category: HarmCategory.HARM_CATEGORY_DANGEROUS_CONTENT,\n threshold: HarmBlockThreshold.BLOCK_MEDIUM_AND_ABOVE,\n },\n];\n\nexport class GoogleClient extends LLMClient {\n public type = \"google\" as const;\n private client: GoogleGenAI;\n declare public clientOptions: ClientOptions;\n declare public hasVision: boolean;\n private logger: (message: LogLine) => void;\n\n constructor({\n logger, // Added logger based on other clients\n modelName,\n clientOptions,\n }: {\n logger: (message: LogLine) => void; // Added logger type\n modelName: AvailableModel;\n clientOptions?: ClientOptions; // Expecting { apiKey: string } here\n }) {\n super(modelName);\n if (!clientOptions?.apiKey) {\n // Try to get the API key from the environment variable GOOGLE_API_KEY\n clientOptions.apiKey = loadApiKeyFromEnv(\"google_legacy\", logger);\n }\n this.clientOptions = clientOptions;\n this.client = new GoogleGenAI({ apiKey: clientOptions.apiKey });\n this.modelName = modelName;\n this.logger = logger;\n // Determine vision capability based on model name (adjust as needed)\n this.hasVision =\n modelName.includes(\"vision\") || modelName.includes(\"gemini-1.5\"); // Example logic\n }\n\n // Helper to convert project's ChatMessage[] to Gemini's Content[]\n private formatMessages(\n messages: ChatMessage[],\n image?: ChatCompletionOptions[\"image\"],\n ): Content[] {\n const contents: Content[] = [];\n let systemInstruction: string | null = null;\n\n messages.forEach((msg, index) => {\n const role = roleMap[msg.role];\n if (!role) {\n this.logger({\n category: \"google\",\n message: `WARNING: Unsupported role: ${msg.role}`,\n level: 1,\n });\n return; // Skip unsupported roles\n }\n\n // Handle system messages - prepend to the first user message or use system_instruction if available\n if (msg.role === \"system\") {\n if (typeof msg.content === \"string\") {\n systemInstruction =\n (systemInstruction ? systemInstruction + \"\\n\\n\" : \"\") + msg.content;\n }\n return; // Don't add system messages directly to contents yet\n }\n\n const parts: Part[] = [];\n\n if (Array.isArray(msg.content)) {\n msg.content.forEach((partContent) => {\n if (partContent.type === \"text\") {\n parts.push({ text: partContent.text });\n } else if (partContent.type === \"image_url\") {\n if (\"image_url\" in partContent && partContent.image_url?.url) {\n // Assuming base64 data URI format: data:[<mediatype>];base64,<data>\n const base64Data = partContent.image_url.url.split(\",\")[1];\n const mimeTypeMatch = partContent.image_url.url.match(\n /^data:(image\\/\\w+);base64,/,\n );\n if (base64Data && mimeTypeMatch) {\n parts.push({\n inlineData: { mimeType: mimeTypeMatch[1], data: base64Data },\n });\n } else {\n this.logger({\n category: \"google\",\n message: \"WARNING: Could not parse image data URI format\",\n level: 1,\n });\n }\n }\n }\n });\n } else if (typeof msg.content === \"string\") {\n parts.push({ text: msg.content });\n }\n\n // Add image from options if this is the last message and it's a user message\n if (image && index === messages.length - 1 && msg.role === \"user\") {\n const imageDesc = image.description || AnnotatedScreenshotText;\n parts.push({ text: imageDesc }); // Add description first\n parts.push({\n inlineData: {\n mimeType: \"image/jpeg\", // Assuming JPEG, adjust if needed\n data: image.buffer.toString(\"base64\"),\n },\n });\n }\n\n // Apply system instruction to the first non-system message if needed\n if (systemInstruction && contents.length === 0 && role === \"user\") {\n const firstPartText = parts.find((p) => \"text\" in p);\n if (firstPartText && \"text\" in firstPartText) {\n firstPartText.text = `${systemInstruction}\\n\\n${firstPartText.text}`;\n } else {\n parts.unshift({ text: systemInstruction });\n }\n systemInstruction = null; // Clear after applying\n }\n\n if (parts.length > 0) {\n contents.push({ role, parts });\n }\n });\n\n // If system instruction wasn't applied (e.g., no user messages followed it), add it as a final user message\n if (systemInstruction) {\n contents.unshift({ role: \"user\", parts: [{ text: systemInstruction }] });\n }\n\n return contents;\n }\n\n // Helper to convert LLMTool[] to Gemini's Tool[]\n private formatTools(\n tools?: ChatCompletionOptions[\"tools\"],\n ): Tool[] | undefined {\n if (!tools || tools.length === 0) {\n return undefined;\n }\n\n return [\n {\n functionDeclarations: tools.map((tool) => {\n let parameters: Schema | undefined = undefined;\n if (tool.parameters) {\n parameters = {\n type: Type.OBJECT,\n properties: tool.parameters.properties as {\n [key: string]: Schema;\n },\n required: tool.parameters.required as string[] | undefined,\n };\n }\n return {\n name: tool.name,\n description: tool.description,\n parameters: parameters,\n };\n }),\n },\n ];\n }\n\n async createChatCompletion<T = LLMResponse>({\n // Ensure LLMResponse is compatible\n options,\n logger,\n retries = 3,\n }: CreateChatCompletionOptions): Promise<T> {\n const {\n image,\n requestId,\n response_model,\n tools,\n temperature,\n top_p,\n maxOutputTokens,\n } = options;\n\n const formattedMessages = this.formatMessages(options.messages, image);\n const formattedTools = this.formatTools(tools);\n\n const generationConfig = {\n maxOutputTokens: maxOutputTokens,\n temperature: temperature,\n topP: top_p,\n responseMimeType: response_model ? \"application/json\" : undefined,\n responseSchema: response_model\n ? toGeminiSchema(response_model.schema)\n : undefined,\n };\n\n logger({\n category: \"google\",\n message: \"creating chat completion\",\n level: 2,\n auxiliary: {\n modelName: { value: this.modelName, type: \"string\" },\n requestId: { value: requestId, type: \"string\" },\n requestPayloadSummary: {\n value: `Model: ${this.modelName}, Messages: ${formattedMessages.length}, Config Keys: ${Object.keys(generationConfig).join(\", \")}, Tools: ${formattedTools ? formattedTools.length : 0}, Safety Categories: ${safetySettings.map((s) => s.category).join(\", \")}`,\n type: \"string\",\n },\n },\n });\n\n // Construct the full request object\n const requestPayload = {\n model: this.modelName,\n contents: formattedMessages,\n config: {\n ...generationConfig,\n safetySettings: safetySettings,\n tools: formattedTools,\n },\n };\n\n // Log the full payload safely\n try {\n logger({\n category: \"google\",\n message: \"Full request payload\",\n level: 2,\n auxiliary: {\n requestId: { value: requestId, type: \"string\" },\n fullPayload: {\n value: JSON.stringify(requestPayload),\n type: \"object\",\n },\n },\n });\n } catch (e) {\n logger({\n category: \"google\",\n message: \"Failed to stringify full request payload for logging\",\n level: 0,\n auxiliary: {\n requestId: { value: requestId, type: \"string\" },\n error: { value: e.message, type: \"string\" },\n },\n });\n }\n\n try {\n const result = await this.client.models.generateContent(requestPayload); // Pass the constructed payload\n\n logger({\n category: \"google\",\n message: \"received response\",\n level: 2,\n auxiliary: {\n requestId: { value: requestId, type: \"string\" },\n response: {\n value: JSON.stringify(result),\n type: \"object\",\n },\n },\n });\n\n const finishReason = result.candidates?.[0]?.finishReason || \"unknown\";\n const toolCalls = result.functionCalls?.map(\n (fc: FunctionCall, index: number) => ({\n id: `tool_call_${requestId}_${index}`,\n type: \"function\" as const,\n function: {\n name: fc.name,\n arguments: JSON.stringify(fc.args),\n },\n }),\n );\n\n let content: string | null = null;\n try {\n content = result.text;\n } catch (e) {\n logger({\n category: \"google\",\n message: `Could not extract text content: ${e.message}`,\n level: 1,\n auxiliary: { requestId: { value: requestId, type: \"string\" } },\n });\n content = null;\n }\n\n // Construct LLMResponse shape\n const llmResponse: LLMResponse = {\n id: result.candidates?.[0]?.index?.toString() || requestId,\n object: \"chat.completion\",\n created: Math.floor(Date.now() / 1000),\n model: this.modelName,\n choices: [\n {\n index: 0,\n message: {\n role: \"assistant\",\n content: content,\n tool_calls: toolCalls,\n },\n finish_reason: finishReason,\n },\n ],\n usage: {\n prompt_tokens: result.usageMetadata?.promptTokenCount || 0,\n completion_tokens: result.usageMetadata?.candidatesTokenCount || 0,\n total_tokens: result.usageMetadata?.totalTokenCount || 0,\n },\n };\n\n // Validate schema if response_model was provided\n if (response_model) {\n let parsedData;\n try {\n // Need to handle potential markdown fences if the model didn't follow instructions perfectly\n const potentialJson =\n content?.trim().replace(/^```json\\n?|\\n?```$/g, \"\") || \"{}\";\n parsedData = JSON.parse(potentialJson);\n } catch (e) {\n logger({\n category: \"google\",\n message: `Failed to parse JSON response: ${e.message}`,\n level: 0,\n auxiliary: {\n content: { value: content || \"null\", type: \"string\" },\n },\n });\n if (retries > 0) {\n return this.createChatCompletion({\n options,\n logger,\n retries: retries - 1,\n });\n }\n throw new CreateChatCompletionResponseError(\n `Failed to parse JSON response: ${e.message}`,\n );\n }\n\n try {\n validateZodSchema(response_model.schema, parsedData);\n } catch (err) {\n logger({\n category: \"google\",\n message: \"Response failed Zod schema validation\",\n level: 0,\n });\n if (retries > 0) {\n return this.createChatCompletion({\n options,\n logger,\n retries: retries - 1,\n });\n }\n throw err;\n }\n\n // If schema validation passes, structure the response for extraction use case\n const extractionResult = {\n data: parsedData,\n usage: llmResponse.usage,\n };\n\n return extractionResult as T;\n }\n\n return llmResponse as T;\n } catch (error) {\n logger({\n category: \"google\",\n message: `Error during Google AI chat completion: ${error.message}`,\n level: 0,\n auxiliary: {\n errorDetails: {\n value: `Message: ${error.message}${error.stack ? \"\\nStack: \" + error.stack : \"\"}`,\n type: \"string\",\n },\n requestId: { value: requestId, type: \"string\" },\n },\n });\n\n // Basic retry logic\n if (retries > 0) {\n logger({\n category: \"google\",\n message: `Retrying... (${retries} attempts left)`,\n level: 1,\n });\n await new Promise((resolve) =>\n setTimeout(resolve, 1000 * (4 - retries)),\n ); // Simple backoff\n return this.createChatCompletion({\n options,\n logger,\n retries: retries - 1,\n });\n }\n\n // Re-throw specific Stagehand errors or a generic one\n if (error instanceof StagehandError) {\n throw error;\n }\n throw new StagehandError(\n `Google AI API request failed: ${error.message}`,\n );\n }\n }\n}\n"]}
@@ -0,0 +1,17 @@
1
+ import type { ClientOptions } from "openai";
2
+ import { LogLine } from "../types/public/logs.js";
3
+ import { AvailableModel } from "../types/public/model.js";
4
+ import { CreateChatCompletionOptions, LLMClient, LLMResponse } from "./LLMClient.js";
5
+ export declare class GroqClient extends LLMClient {
6
+ type: "groq";
7
+ private client;
8
+ clientOptions: ClientOptions;
9
+ hasVision: boolean;
10
+ constructor({ modelName, clientOptions, userProvidedInstructions, }: {
11
+ logger: (message: LogLine) => void;
12
+ modelName: AvailableModel;
13
+ clientOptions?: ClientOptions;
14
+ userProvidedInstructions?: string;
15
+ });
16
+ createChatCompletion<T = LLMResponse>({ options, retries, logger, }: CreateChatCompletionOptions): Promise<T>;
17
+ }
@@ -0,0 +1,236 @@
1
+ import OpenAI from "openai";
2
+ import { LLMClient, } from "./LLMClient.js";
3
+ import { CreateChatCompletionResponseError } from "../types/public/sdkErrors.js";
4
+ import { toJsonSchema } from "../zodCompat.js";
5
+ export class GroqClient extends LLMClient {
6
+ type = "groq";
7
+ client;
8
+ hasVision = false;
9
+ constructor({ modelName, clientOptions, userProvidedInstructions, }) {
10
+ super(modelName, userProvidedInstructions);
11
+ // Create OpenAI client with the base URL set to Groq API
12
+ this.client = new OpenAI({
13
+ baseURL: "https://api.groq.com/openai/v1",
14
+ apiKey: clientOptions?.apiKey || process.env.GROQ_API_KEY,
15
+ ...clientOptions,
16
+ });
17
+ this.modelName = modelName;
18
+ this.clientOptions = clientOptions;
19
+ }
20
+ async createChatCompletion({ options, retries, logger, }) {
21
+ const optionsWithoutImage = { ...options };
22
+ delete optionsWithoutImage.image;
23
+ logger({
24
+ category: "groq",
25
+ message: "creating chat completion",
26
+ level: 2,
27
+ auxiliary: {
28
+ options: {
29
+ value: JSON.stringify(optionsWithoutImage),
30
+ type: "object",
31
+ },
32
+ },
33
+ });
34
+ // Format messages for Groq API (using OpenAI format)
35
+ const formattedMessages = options.messages.map((msg) => {
36
+ const baseMessage = {
37
+ content: typeof msg.content === "string"
38
+ ? msg.content
39
+ : Array.isArray(msg.content) &&
40
+ msg.content.length > 0 &&
41
+ "text" in msg.content[0]
42
+ ? msg.content[0].text
43
+ : "",
44
+ };
45
+ // Groq supports system, user, and assistant roles
46
+ if (msg.role === "system") {
47
+ return { ...baseMessage, role: "system" };
48
+ }
49
+ else if (msg.role === "assistant") {
50
+ return { ...baseMessage, role: "assistant" };
51
+ }
52
+ else {
53
+ // Default to user for any other role
54
+ return { ...baseMessage, role: "user" };
55
+ }
56
+ });
57
+ // Format tools if provided
58
+ let tools = options.tools?.map((tool) => ({
59
+ type: "function",
60
+ function: {
61
+ name: tool.name,
62
+ description: tool.description,
63
+ parameters: {
64
+ type: "object",
65
+ properties: tool.parameters.properties,
66
+ required: tool.parameters.required,
67
+ },
68
+ },
69
+ }));
70
+ // Add response model as a tool if provided
71
+ if (options.response_model) {
72
+ const jsonSchema = toJsonSchema(options.response_model.schema);
73
+ const schemaProperties = jsonSchema.properties || {};
74
+ const schemaRequired = jsonSchema.required || [];
75
+ const responseTool = {
76
+ type: "function",
77
+ function: {
78
+ name: "print_extracted_data",
79
+ description: "Prints the extracted data based on the provided schema.",
80
+ parameters: {
81
+ type: "object",
82
+ properties: schemaProperties,
83
+ required: schemaRequired,
84
+ },
85
+ },
86
+ };
87
+ tools = tools ? [...tools, responseTool] : [responseTool];
88
+ }
89
+ try {
90
+ // Use OpenAI client with Groq API
91
+ const apiResponse = await this.client.chat.completions.create({
92
+ model: this.modelName.split("groq-")[1],
93
+ messages: [
94
+ ...formattedMessages,
95
+ // Add explicit instruction to return JSON if we have a response model
96
+ ...(options.response_model
97
+ ? [
98
+ {
99
+ role: "system",
100
+ content: `IMPORTANT: Your response must be valid JSON that matches this schema: ${JSON.stringify(options.response_model.schema)}`,
101
+ },
102
+ ]
103
+ : []),
104
+ ],
105
+ temperature: options.temperature || 0.7,
106
+ max_tokens: options.maxOutputTokens,
107
+ tools: tools,
108
+ tool_choice: options.tool_choice || "auto",
109
+ });
110
+ // Format the response to match the expected LLMResponse format
111
+ const response = {
112
+ id: apiResponse.id,
113
+ object: "chat.completion",
114
+ created: Date.now(),
115
+ model: this.modelName.split("groq-")[1],
116
+ choices: [
117
+ {
118
+ index: 0,
119
+ message: {
120
+ role: "assistant",
121
+ content: apiResponse.choices[0]?.message?.content || null,
122
+ tool_calls: apiResponse.choices[0]?.message?.tool_calls || [],
123
+ },
124
+ finish_reason: apiResponse.choices[0]?.finish_reason || "stop",
125
+ },
126
+ ],
127
+ usage: {
128
+ prompt_tokens: apiResponse.usage?.prompt_tokens || 0,
129
+ completion_tokens: apiResponse.usage?.completion_tokens || 0,
130
+ total_tokens: apiResponse.usage?.total_tokens || 0,
131
+ },
132
+ };
133
+ logger({
134
+ category: "groq",
135
+ message: "response",
136
+ level: 2,
137
+ auxiliary: {
138
+ response: {
139
+ value: JSON.stringify(response),
140
+ type: "object",
141
+ },
142
+ requestId: {
143
+ value: options.requestId,
144
+ type: "string",
145
+ },
146
+ },
147
+ });
148
+ // If there's no response model, return the entire response object
149
+ if (!options.response_model) {
150
+ return response;
151
+ }
152
+ // Otherwise, try parsing the JSON from the tool call or content
153
+ const toolCall = response.choices[0]?.message?.tool_calls?.[0];
154
+ if (toolCall?.function?.arguments) {
155
+ try {
156
+ const result = JSON.parse(toolCall.function.arguments);
157
+ const finalResponse = {
158
+ data: result,
159
+ usage: response.usage,
160
+ };
161
+ return finalResponse;
162
+ }
163
+ catch (e) {
164
+ logger({
165
+ category: "groq",
166
+ message: "failed to parse tool call arguments as JSON, retrying",
167
+ level: 0,
168
+ auxiliary: {
169
+ error: {
170
+ value: e.message,
171
+ type: "string",
172
+ },
173
+ },
174
+ });
175
+ }
176
+ }
177
+ // If we have content but no tool calls, try to parse the content as JSON
178
+ const content = response.choices[0]?.message?.content;
179
+ if (content) {
180
+ try {
181
+ // Try to extract JSON from the content
182
+ const jsonMatch = content.match(/\{[\s\S]*\}/);
183
+ if (jsonMatch) {
184
+ const result = JSON.parse(jsonMatch[0]);
185
+ const finalResponse = {
186
+ data: result,
187
+ usage: response.usage,
188
+ };
189
+ return finalResponse;
190
+ }
191
+ }
192
+ catch (e) {
193
+ logger({
194
+ category: "groq",
195
+ message: "failed to parse content as JSON",
196
+ level: 0,
197
+ auxiliary: {
198
+ error: {
199
+ value: e.message,
200
+ type: "string",
201
+ },
202
+ },
203
+ });
204
+ }
205
+ }
206
+ // If we still haven't found valid JSON and have retries left, try again
207
+ if (!retries || retries < 5) {
208
+ return this.createChatCompletion({
209
+ options,
210
+ logger,
211
+ retries: (retries ?? 0) + 1,
212
+ });
213
+ }
214
+ throw new CreateChatCompletionResponseError("Invalid response schema");
215
+ }
216
+ catch (error) {
217
+ logger({
218
+ category: "groq",
219
+ message: "error creating chat completion",
220
+ level: 0,
221
+ auxiliary: {
222
+ error: {
223
+ value: error.message,
224
+ type: "string",
225
+ },
226
+ requestId: {
227
+ value: options.requestId,
228
+ type: "string",
229
+ },
230
+ },
231
+ });
232
+ throw error;
233
+ }
234
+ }
235
+ }
236
+ //# sourceMappingURL=GroqClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"GroqClient.js","sourceRoot":"","sources":["../../../../../lib/v3/llm/GroqClient.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAGL,SAAS,GAEV,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,OAAO,UAAW,SAAQ,SAAS;IAChC,IAAI,GAAG,MAAe,CAAC;IACtB,MAAM,CAAS;IAEhB,SAAS,GAAG,KAAK,CAAC;IAEzB,YAAY,EACV,SAAS,EACT,aAAa,EACb,wBAAwB,GAMzB;QACC,KAAK,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;QAE3C,yDAAyD;QACzD,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC;YACvB,OAAO,EAAE,gCAAgC;YACzC,MAAM,EAAE,aAAa,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY;YACzD,GAAG,aAAa;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAkB,EAC1C,OAAO,EACP,OAAO,EACP,MAAM,GACsB;QAC5B,MAAM,mBAAmB,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAC3C,OAAO,mBAAmB,CAAC,KAAK,CAAC;QAEjC,MAAM,CAAC;YACL,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,CAAC;YACR,SAAS,EAAE;gBACT,OAAO,EAAE;oBACP,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC;oBAC1C,IAAI,EAAE,QAAQ;iBACf;aACF;SACF,CAAC,CAAC;QAEH,qDAAqD;QACrD,MAAM,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAgB,EAAE,EAAE;YAClE,MAAM,WAAW,GAAG;gBAClB,OAAO,EACL,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;oBAC7B,CAAC,CAAC,GAAG,CAAC,OAAO;oBACb,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;wBACxB,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;wBACtB,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;wBAC1B,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;wBACrB,CAAC,CAAC,EAAE;aACX,CAAC;YAEF,kDAAkD;YAClD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,OAAO,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,QAAiB,EAAE,CAAC;YACrD,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACpC,OAAO,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,WAAoB,EAAE,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,qCAAqC;gBACrC,OAAO,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;YACnD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,2BAA2B;QAC3B,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACxC,IAAI,EAAE,UAAmB;YACzB,QAAQ,EAAE;gBACR,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU;oBACtC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ;iBACnC;aACF;SACF,CAAC,CAAC,CAAC;QAEJ,2CAA2C;QAC3C,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAG5D,CAAC;YACF,MAAM,gBAAgB,GAAG,UAAU,CAAC,UAAU,IAAI,EAAE,CAAC;YACrD,MAAM,cAAc,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;YAEjD,MAAM,YAAY,GAAG;gBACnB,IAAI,EAAE,UAAmB;gBACzB,QAAQ,EAAE;oBACR,IAAI,EAAE,sBAAsB;oBAC5B,WAAW,EACT,yDAAyD;oBAC3D,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE,gBAAgB;wBAC5B,QAAQ,EAAE,cAAc;qBACzB;iBACF;aACF,CAAC;YAEF,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC;YACH,kCAAkC;YAClC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;gBAC5D,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACvC,QAAQ,EAAE;oBACR,GAAG,iBAAiB;oBACpB,sEAAsE;oBACtE,GAAG,CAAC,OAAO,CAAC,cAAc;wBACxB,CAAC,CAAC;4BACE;gCACE,IAAI,EAAE,QAAiB;gCACvB,OAAO,EAAE,yEAAyE,IAAI,CAAC,SAAS,CAC9F,OAAO,CAAC,cAAc,CAAC,MAAM,CAC9B,EAAE;6BACJ;yBACF;wBACH,CAAC,CAAC,EAAE,CAAC;iBACR;gBACD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,GAAG;gBACvC,UAAU,EAAE,OAAO,CAAC,eAAe;gBACnC,KAAK,EAAE,KAAK;gBACZ,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,MAAM;aAC3C,CAAC,CAAC;YAEH,+DAA+D;YAC/D,MAAM,QAAQ,GAAgB;gBAC5B,EAAE,EAAE,WAAW,CAAC,EAAE;gBAClB,MAAM,EAAE,iBAAiB;gBACzB,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;gBACnB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBACvC,OAAO,EAAE;oBACP;wBACE,KAAK,EAAE,CAAC;wBACR,OAAO,EAAE;4BACP,IAAI,EAAE,WAAW;4BACjB,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;4BACzD,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,IAAI,EAAE;yBAC9D;wBACD,aAAa,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,aAAa,IAAI,MAAM;qBAC/D;iBACF;gBACD,KAAK,EAAE;oBACL,aAAa,EAAE,WAAW,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;oBACpD,iBAAiB,EAAE,WAAW,CAAC,KAAK,EAAE,iBAAiB,IAAI,CAAC;oBAC5D,YAAY,EAAE,WAAW,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;iBACnD;aACF,CAAC;YAEF,MAAM,CAAC;gBACL,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;wBAC/B,IAAI,EAAE,QAAQ;qBACf;oBACD,SAAS,EAAE;wBACT,KAAK,EAAE,OAAO,CAAC,SAAS;wBACxB,IAAI,EAAE,QAAQ;qBACf;iBACF;aACF,CAAC,CAAC;YAEH,kEAAkE;YAClE,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC5B,OAAO,QAAa,CAAC;YACvB,CAAC;YAED,gEAAgE;YAChE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/D,IAAI,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;oBACvD,MAAM,aAAa,GAAG;wBACpB,IAAI,EAAE,MAAM;wBACZ,KAAK,EAAE,QAAQ,CAAC,KAAK;qBACtB,CAAC;oBACF,OAAO,aAAkB,CAAC;gBAC5B,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,CAAC;wBACL,QAAQ,EAAE,MAAM;wBAChB,OAAO,EAAE,uDAAuD;wBAChE,KAAK,EAAE,CAAC;wBACR,SAAS,EAAE;4BACT,KAAK,EAAE;gCACL,KAAK,EAAE,CAAC,CAAC,OAAO;gCAChB,IAAI,EAAE,QAAQ;6BACf;yBACF;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,yEAAyE;YACzE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC;YACtD,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC;oBACH,uCAAuC;oBACvC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;oBAC/C,IAAI,SAAS,EAAE,CAAC;wBACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;wBACxC,MAAM,aAAa,GAAG;4BACpB,IAAI,EAAE,MAAM;4BACZ,KAAK,EAAE,QAAQ,CAAC,KAAK;yBACtB,CAAC;wBACF,OAAO,aAAkB,CAAC;oBAC5B,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,CAAC;wBACL,QAAQ,EAAE,MAAM;wBAChB,OAAO,EAAE,iCAAiC;wBAC1C,KAAK,EAAE,CAAC;wBACR,SAAS,EAAE;4BACT,KAAK,EAAE;gCACL,KAAK,EAAE,CAAC,CAAC,OAAO;gCAChB,IAAI,EAAE,QAAQ;6BACf;yBACF;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,wEAAwE;YACxE,IAAI,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC,oBAAoB,CAAC;oBAC/B,OAAO;oBACP,MAAM;oBACN,OAAO,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC;iBAC5B,CAAC,CAAC;YACL,CAAC;YAED,MAAM,IAAI,iCAAiC,CAAC,yBAAyB,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC;gBACL,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,gCAAgC;gBACzC,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE;oBACT,KAAK,EAAE;wBACL,KAAK,EAAE,KAAK,CAAC,OAAO;wBACpB,IAAI,EAAE,QAAQ;qBACf;oBACD,SAAS,EAAE;wBACT,KAAK,EAAE,OAAO,CAAC,SAAS;wBACxB,IAAI,EAAE,QAAQ;qBACf;iBACF;aACF,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF","sourcesContent":["import type { ClientOptions } from \"openai\";\nimport OpenAI from \"openai\";\nimport { LogLine } from \"../types/public/logs.js\";\nimport { AvailableModel } from \"../types/public/model.js\";\nimport {\n ChatMessage,\n CreateChatCompletionOptions,\n LLMClient,\n LLMResponse,\n} from \"./LLMClient.js\";\nimport { CreateChatCompletionResponseError } from \"../types/public/sdkErrors.js\";\nimport { toJsonSchema } from \"../zodCompat.js\";\n\nexport class GroqClient extends LLMClient {\n public type = \"groq\" as const;\n private client: OpenAI;\n declare public clientOptions: ClientOptions;\n public hasVision = false;\n\n constructor({\n modelName,\n clientOptions,\n userProvidedInstructions,\n }: {\n logger: (message: LogLine) => void;\n modelName: AvailableModel;\n clientOptions?: ClientOptions;\n userProvidedInstructions?: string;\n }) {\n super(modelName, userProvidedInstructions);\n\n // Create OpenAI client with the base URL set to Groq API\n this.client = new OpenAI({\n baseURL: \"https://api.groq.com/openai/v1\",\n apiKey: clientOptions?.apiKey || process.env.GROQ_API_KEY,\n ...clientOptions,\n });\n\n this.modelName = modelName;\n this.clientOptions = clientOptions;\n }\n\n async createChatCompletion<T = LLMResponse>({\n options,\n retries,\n logger,\n }: CreateChatCompletionOptions): Promise<T> {\n const optionsWithoutImage = { ...options };\n delete optionsWithoutImage.image;\n\n logger({\n category: \"groq\",\n message: \"creating chat completion\",\n level: 2,\n auxiliary: {\n options: {\n value: JSON.stringify(optionsWithoutImage),\n type: \"object\",\n },\n },\n });\n\n // Format messages for Groq API (using OpenAI format)\n const formattedMessages = options.messages.map((msg: ChatMessage) => {\n const baseMessage = {\n content:\n typeof msg.content === \"string\"\n ? msg.content\n : Array.isArray(msg.content) &&\n msg.content.length > 0 &&\n \"text\" in msg.content[0]\n ? msg.content[0].text\n : \"\",\n };\n\n // Groq supports system, user, and assistant roles\n if (msg.role === \"system\") {\n return { ...baseMessage, role: \"system\" as const };\n } else if (msg.role === \"assistant\") {\n return { ...baseMessage, role: \"assistant\" as const };\n } else {\n // Default to user for any other role\n return { ...baseMessage, role: \"user\" as const };\n }\n });\n\n // Format tools if provided\n let tools = options.tools?.map((tool) => ({\n type: \"function\" as const,\n function: {\n name: tool.name,\n description: tool.description,\n parameters: {\n type: \"object\",\n properties: tool.parameters.properties,\n required: tool.parameters.required,\n },\n },\n }));\n\n // Add response model as a tool if provided\n if (options.response_model) {\n const jsonSchema = toJsonSchema(options.response_model.schema) as {\n properties?: Record<string, unknown>;\n required?: string[];\n };\n const schemaProperties = jsonSchema.properties || {};\n const schemaRequired = jsonSchema.required || [];\n\n const responseTool = {\n type: \"function\" as const,\n function: {\n name: \"print_extracted_data\",\n description:\n \"Prints the extracted data based on the provided schema.\",\n parameters: {\n type: \"object\",\n properties: schemaProperties,\n required: schemaRequired,\n },\n },\n };\n\n tools = tools ? [...tools, responseTool] : [responseTool];\n }\n\n try {\n // Use OpenAI client with Groq API\n const apiResponse = await this.client.chat.completions.create({\n model: this.modelName.split(\"groq-\")[1],\n messages: [\n ...formattedMessages,\n // Add explicit instruction to return JSON if we have a response model\n ...(options.response_model\n ? [\n {\n role: \"system\" as const,\n content: `IMPORTANT: Your response must be valid JSON that matches this schema: ${JSON.stringify(\n options.response_model.schema,\n )}`,\n },\n ]\n : []),\n ],\n temperature: options.temperature || 0.7,\n max_tokens: options.maxOutputTokens,\n tools: tools,\n tool_choice: options.tool_choice || \"auto\",\n });\n\n // Format the response to match the expected LLMResponse format\n const response: LLMResponse = {\n id: apiResponse.id,\n object: \"chat.completion\",\n created: Date.now(),\n model: this.modelName.split(\"groq-\")[1],\n choices: [\n {\n index: 0,\n message: {\n role: \"assistant\",\n content: apiResponse.choices[0]?.message?.content || null,\n tool_calls: apiResponse.choices[0]?.message?.tool_calls || [],\n },\n finish_reason: apiResponse.choices[0]?.finish_reason || \"stop\",\n },\n ],\n usage: {\n prompt_tokens: apiResponse.usage?.prompt_tokens || 0,\n completion_tokens: apiResponse.usage?.completion_tokens || 0,\n total_tokens: apiResponse.usage?.total_tokens || 0,\n },\n };\n\n logger({\n category: \"groq\",\n message: \"response\",\n level: 2,\n auxiliary: {\n response: {\n value: JSON.stringify(response),\n type: \"object\",\n },\n requestId: {\n value: options.requestId,\n type: \"string\",\n },\n },\n });\n\n // If there's no response model, return the entire response object\n if (!options.response_model) {\n return response as T;\n }\n\n // Otherwise, try parsing the JSON from the tool call or content\n const toolCall = response.choices[0]?.message?.tool_calls?.[0];\n if (toolCall?.function?.arguments) {\n try {\n const result = JSON.parse(toolCall.function.arguments);\n const finalResponse = {\n data: result,\n usage: response.usage,\n };\n return finalResponse as T;\n } catch (e) {\n logger({\n category: \"groq\",\n message: \"failed to parse tool call arguments as JSON, retrying\",\n level: 0,\n auxiliary: {\n error: {\n value: e.message,\n type: \"string\",\n },\n },\n });\n }\n }\n\n // If we have content but no tool calls, try to parse the content as JSON\n const content = response.choices[0]?.message?.content;\n if (content) {\n try {\n // Try to extract JSON from the content\n const jsonMatch = content.match(/\\{[\\s\\S]*\\}/);\n if (jsonMatch) {\n const result = JSON.parse(jsonMatch[0]);\n const finalResponse = {\n data: result,\n usage: response.usage,\n };\n return finalResponse as T;\n }\n } catch (e) {\n logger({\n category: \"groq\",\n message: \"failed to parse content as JSON\",\n level: 0,\n auxiliary: {\n error: {\n value: e.message,\n type: \"string\",\n },\n },\n });\n }\n }\n\n // If we still haven't found valid JSON and have retries left, try again\n if (!retries || retries < 5) {\n return this.createChatCompletion({\n options,\n logger,\n retries: (retries ?? 0) + 1,\n });\n }\n\n throw new CreateChatCompletionResponseError(\"Invalid response schema\");\n } catch (error) {\n logger({\n category: \"groq\",\n message: \"error creating chat completion\",\n level: 0,\n auxiliary: {\n error: {\n value: error.message,\n type: \"string\",\n },\n requestId: {\n value: options.requestId,\n type: \"string\",\n },\n },\n });\n throw error;\n }\n }\n}\n"]}
@@ -0,0 +1,121 @@
1
+ import { LLMTool } from "../types/public/model.js";
2
+ import { embed, embedMany, experimental_generateImage, experimental_generateSpeech, experimental_transcribe, generateObject, generateText, streamObject, streamText } from "ai";
3
+ import type { LanguageModelV2 } from "@ai-sdk/provider";
4
+ import { LogLine } from "../types/public/logs.js";
5
+ import { AvailableModel, ClientOptions } from "../types/public/model.js";
6
+ import type { StagehandZodSchema } from "../zodCompat.js";
7
+ export interface ChatMessage {
8
+ role: "system" | "user" | "assistant";
9
+ content: ChatMessageContent;
10
+ }
11
+ export type ChatMessageContent = string | (ChatMessageImageContent | ChatMessageTextContent)[];
12
+ export interface ChatMessageImageContent {
13
+ type: string;
14
+ image_url?: {
15
+ url: string;
16
+ };
17
+ text?: string;
18
+ source?: {
19
+ type: string;
20
+ media_type: string;
21
+ data: string;
22
+ };
23
+ }
24
+ export interface ChatMessageTextContent {
25
+ type: string;
26
+ text: string;
27
+ }
28
+ export declare const AnnotatedScreenshotText = "This is a screenshot of the current page state with the elements annotated on it. Each element id is annotated with a number to the top left of it. Duplicate annotations at the same location are under each other vertically.";
29
+ export interface ChatCompletionOptions {
30
+ messages: ChatMessage[];
31
+ temperature?: number;
32
+ top_p?: number;
33
+ frequency_penalty?: number;
34
+ presence_penalty?: number;
35
+ image?: {
36
+ buffer: Buffer;
37
+ description?: string;
38
+ };
39
+ response_model?: {
40
+ name: string;
41
+ schema: StagehandZodSchema;
42
+ };
43
+ tools?: LLMTool[];
44
+ tool_choice?: "auto" | "none" | "required";
45
+ maxOutputTokens?: number;
46
+ requestId?: string;
47
+ }
48
+ export type LLMResponse = {
49
+ id: string;
50
+ object: string;
51
+ created: number;
52
+ model: string;
53
+ choices: {
54
+ index: number;
55
+ message: {
56
+ role: string;
57
+ content: string | null;
58
+ tool_calls: {
59
+ id: string;
60
+ type: string;
61
+ function: {
62
+ name: string;
63
+ arguments: string;
64
+ };
65
+ }[];
66
+ };
67
+ finish_reason: string;
68
+ }[];
69
+ usage: {
70
+ prompt_tokens: number;
71
+ completion_tokens: number;
72
+ total_tokens: number;
73
+ };
74
+ };
75
+ export interface CreateChatCompletionOptions {
76
+ options: ChatCompletionOptions;
77
+ logger: (message: LogLine) => void;
78
+ retries?: number;
79
+ }
80
+ /** Simple usage shape if your LLM returns usage tokens. */
81
+ export interface LLMUsage {
82
+ prompt_tokens: number;
83
+ completion_tokens: number;
84
+ total_tokens: number;
85
+ reasoning_tokens?: number;
86
+ cached_input_tokens?: number;
87
+ }
88
+ /**
89
+ * For calls that use a schema: the LLMClient may return { data: T; usage?: LLMUsage }
90
+ */
91
+ export interface LLMParsedResponse<T> {
92
+ data: T;
93
+ usage?: LLMUsage;
94
+ }
95
+ export declare abstract class LLMClient {
96
+ type: "openai" | "anthropic" | "cerebras" | "groq" | (string & {});
97
+ modelName: AvailableModel | (string & {});
98
+ hasVision: boolean;
99
+ clientOptions: ClientOptions;
100
+ userProvidedInstructions?: string;
101
+ constructor(modelName: AvailableModel, userProvidedInstructions?: string);
102
+ abstract createChatCompletion<T>(options: CreateChatCompletionOptions & {
103
+ options: {
104
+ response_model: {
105
+ name: string;
106
+ schema: StagehandZodSchema;
107
+ };
108
+ };
109
+ }): Promise<LLMParsedResponse<T>>;
110
+ abstract createChatCompletion<T = LLMResponse>(options: CreateChatCompletionOptions): Promise<T>;
111
+ generateObject: typeof generateObject;
112
+ generateText: typeof generateText;
113
+ streamText: typeof streamText;
114
+ streamObject: typeof streamObject;
115
+ generateImage: typeof experimental_generateImage;
116
+ embed: typeof embed;
117
+ embedMany: typeof embedMany;
118
+ transcribe: typeof experimental_transcribe;
119
+ generateSpeech: typeof experimental_generateSpeech;
120
+ getLanguageModel?(): LanguageModelV2;
121
+ }
@@ -0,0 +1,23 @@
1
+ import { embed, embedMany, experimental_generateImage, experimental_generateSpeech, experimental_transcribe, generateObject, generateText, streamObject, streamText, } from "ai";
2
+ export const AnnotatedScreenshotText = "This is a screenshot of the current page state with the elements annotated on it. Each element id is annotated with a number to the top left of it. Duplicate annotations at the same location are under each other vertically.";
3
+ export class LLMClient {
4
+ type;
5
+ modelName;
6
+ hasVision;
7
+ clientOptions;
8
+ userProvidedInstructions;
9
+ constructor(modelName, userProvidedInstructions) {
10
+ this.modelName = modelName;
11
+ this.userProvidedInstructions = userProvidedInstructions;
12
+ }
13
+ generateObject = generateObject;
14
+ generateText = generateText;
15
+ streamText = streamText;
16
+ streamObject = streamObject;
17
+ generateImage = experimental_generateImage;
18
+ embed = embed;
19
+ embedMany = embedMany;
20
+ transcribe = experimental_transcribe;
21
+ generateSpeech = experimental_generateSpeech;
22
+ }
23
+ //# sourceMappingURL=LLMClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LLMClient.js","sourceRoot":"","sources":["../../../../../lib/v3/llm/LLMClient.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,EACL,SAAS,EACT,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,GACX,MAAM,IAAI,CAAC;AA+BZ,MAAM,CAAC,MAAM,uBAAuB,GAClC,iOAAiO,CAAC;AAyEpO,MAAM,OAAgB,SAAS;IACtB,IAAI,CAA+D;IACnE,SAAS,CAAiC;IAC1C,SAAS,CAAU;IACnB,aAAa,CAAgB;IAC7B,wBAAwB,CAAU;IAEzC,YAAY,SAAyB,EAAE,wBAAiC;QACtE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,wBAAwB,GAAG,wBAAwB,CAAC;IAC3D,CAAC;IAgBM,cAAc,GAAG,cAAc,CAAC;IAChC,YAAY,GAAG,YAAY,CAAC;IAC5B,UAAU,GAAG,UAAU,CAAC;IACxB,YAAY,GAAG,YAAY,CAAC;IAC5B,aAAa,GAAG,0BAA0B,CAAC;IAC3C,KAAK,GAAG,KAAK,CAAC;IACd,SAAS,GAAG,SAAS,CAAC;IACtB,UAAU,GAAG,uBAAuB,CAAC;IACrC,cAAc,GAAG,2BAA2B,CAAC;CAGrD","sourcesContent":["import { LLMTool } from \"../types/public/model.js\";\nimport {\n embed,\n embedMany,\n experimental_generateImage,\n experimental_generateSpeech,\n experimental_transcribe,\n generateObject,\n generateText,\n streamObject,\n streamText,\n} from \"ai\";\nimport type { LanguageModelV2 } from \"@ai-sdk/provider\";\nimport { LogLine } from \"../types/public/logs.js\";\nimport { AvailableModel, ClientOptions } from \"../types/public/model.js\";\nimport type { StagehandZodSchema } from \"../zodCompat.js\";\n\nexport interface ChatMessage {\n role: \"system\" | \"user\" | \"assistant\";\n content: ChatMessageContent;\n}\n\nexport type ChatMessageContent =\n | string\n | (ChatMessageImageContent | ChatMessageTextContent)[];\n\nexport interface ChatMessageImageContent {\n type: string;\n image_url?: { url: string };\n text?: string;\n source?: {\n type: string;\n media_type: string;\n data: string;\n };\n}\n\nexport interface ChatMessageTextContent {\n type: string;\n text: string;\n}\n\nexport const AnnotatedScreenshotText =\n \"This is a screenshot of the current page state with the elements annotated on it. Each element id is annotated with a number to the top left of it. Duplicate annotations at the same location are under each other vertically.\";\n\nexport interface ChatCompletionOptions {\n messages: ChatMessage[];\n temperature?: number;\n top_p?: number;\n frequency_penalty?: number;\n presence_penalty?: number;\n image?: {\n buffer: Buffer;\n description?: string;\n };\n response_model?: {\n name: string;\n schema: StagehandZodSchema;\n };\n tools?: LLMTool[];\n tool_choice?: \"auto\" | \"none\" | \"required\";\n maxOutputTokens?: number;\n requestId?: string;\n}\n\nexport type LLMResponse = {\n id: string;\n object: string;\n created: number;\n model: string;\n choices: {\n index: number;\n message: {\n role: string;\n content: string | null;\n tool_calls: {\n id: string;\n type: string;\n function: {\n name: string;\n arguments: string;\n };\n }[];\n };\n finish_reason: string;\n }[];\n usage: {\n prompt_tokens: number;\n completion_tokens: number;\n total_tokens: number;\n };\n};\n\nexport interface CreateChatCompletionOptions {\n options: ChatCompletionOptions;\n logger: (message: LogLine) => void;\n retries?: number;\n}\n\n/** Simple usage shape if your LLM returns usage tokens. */\nexport interface LLMUsage {\n prompt_tokens: number;\n completion_tokens: number;\n total_tokens: number;\n reasoning_tokens?: number;\n cached_input_tokens?: number;\n}\n\n/**\n * For calls that use a schema: the LLMClient may return { data: T; usage?: LLMUsage }\n */\nexport interface LLMParsedResponse<T> {\n data: T;\n usage?: LLMUsage;\n}\n\nexport abstract class LLMClient {\n public type: \"openai\" | \"anthropic\" | \"cerebras\" | \"groq\" | (string & {});\n public modelName: AvailableModel | (string & {});\n public hasVision: boolean;\n public clientOptions: ClientOptions;\n public userProvidedInstructions?: string;\n\n constructor(modelName: AvailableModel, userProvidedInstructions?: string) {\n this.modelName = modelName;\n this.userProvidedInstructions = userProvidedInstructions;\n }\n\n // Overload 1: When response_model is provided, returns LLMParsedResponse<T>\n abstract createChatCompletion<T>(\n options: CreateChatCompletionOptions & {\n options: {\n response_model: { name: string; schema: StagehandZodSchema };\n };\n },\n ): Promise<LLMParsedResponse<T>>;\n\n // Overload 2: When response_model is not provided, returns T (defaults to LLMResponse)\n abstract createChatCompletion<T = LLMResponse>(\n options: CreateChatCompletionOptions,\n ): Promise<T>;\n\n public generateObject = generateObject;\n public generateText = generateText;\n public streamText = streamText;\n public streamObject = streamObject;\n public generateImage = experimental_generateImage;\n public embed = embed;\n public embedMany = embedMany;\n public transcribe = experimental_transcribe;\n public generateSpeech = experimental_generateSpeech;\n\n getLanguageModel?(): LanguageModelV2;\n}\n"]}
@@ -0,0 +1,13 @@
1
+ import { LogLine } from "../types/public/logs.js";
2
+ import { AvailableModel, ClientOptions, ModelProvider } from "../types/public/model.js";
3
+ import { LLMClient } from "./LLMClient.js";
4
+ export declare function getAISDKLanguageModel(subProvider: string, subModelName: string, clientOptions?: ClientOptions): import("@ai-sdk/provider").LanguageModelV2;
5
+ export declare class LLMProvider {
6
+ private logger;
7
+ constructor(logger: (message: LogLine) => void);
8
+ getClient(modelName: AvailableModel, clientOptions?: ClientOptions, options?: {
9
+ experimental?: boolean;
10
+ disableAPI?: boolean;
11
+ }): LLMClient;
12
+ static getModelProvider(modelName: AvailableModel): ModelProvider;
13
+ }