From 977b976152c60ea98062be6ecb1d3dc83c330a8c Mon Sep 17 00:00:00 2001
From: Mochael <mkronovet@gmail.com>
Date: Mon, 14 Jul 2025 13:59:53 -0700
Subject: [PATCH 01/11] fixed deepLocator pathing

---
 lib/handlers/handlerUtils/actHandlerUtils.ts | 73 ++++++++++++--------
 1 file changed, 44 insertions(+), 29 deletions(-)

diff --git a/lib/handlers/handlerUtils/actHandlerUtils.ts b/lib/handlers/handlerUtils/actHandlerUtils.ts
index c3f9a19b4..1419b75a3 100644
--- a/lib/handlers/handlerUtils/actHandlerUtils.ts
+++ b/lib/handlers/handlerUtils/actHandlerUtils.ts
@@ -9,37 +9,52 @@ import { StagehandClickError } from "@/types/stagehandErrors";
 const IFRAME_STEP_RE = /^iframe(\[[^\]]+])?$/i;
 
 export function deepLocator(
-  root: Page | FrameLocator,
-  rawXPath: string,
-): Locator {
-  // 1 ─ strip optional 'xpath=' prefix and whitespace
-  let xpath = rawXPath.replace(/^xpath=/i, "").trim();
-  if (!xpath.startsWith("/")) xpath = "/" + xpath;
-
-  // 2 ─ split into steps, accumulate until we hit an iframe step
-  const steps = xpath.split("/").filter(Boolean); // tokens
-  let ctx: Page | FrameLocator = root;
-  let buffer: string[] = [];
-
-  const flushIntoFrame = () => {
-    if (buffer.length === 0) return;
-    const selector = "xpath=/" + buffer.join("/");
-    ctx = (ctx as Page | FrameLocator).frameLocator(selector);
-    buffer = [];
-  };
-
-  for (const step of steps) {
-    buffer.push(step);
-    if (IFRAME_STEP_RE.test(step)) {
-      // we've included the <iframe> element in buffer ⇒ descend
-      flushIntoFrame();
+    root: Page | FrameLocator,
+    rawXPath: string,
+  ): Locator {
+    // 1 ─ strip optional 'xpath=' prefix and whitespace
+    let xpath = rawXPath.replace(/^xpath=/i, "").trim();
+
+    // Split the path by sequences of slashes, but keep the slashes as
+    // separate elements in the array. This preserves separators like '//'.
+    // e.g., '//a/b' becomes ['//', 'a', '/', 'b']
+    const parts = xpath.split(/(\/+)/).filter(Boolean);
+
+    let ctx: Page | FrameLocator = root;
+    let buffer: string[] = [];
+
+    const flushIntoFrame = () => {
+      if (buffer.length === 0) return;
+
+      // Join the buffered parts to form the selector for the iframe.
+      // .join('') is used because the separators are already in the buffer.
+      const selector = "xpath=" + buffer.join("");
+      ctx = (ctx as Page | FrameLocator).frameLocator(selector);
+      buffer = []; // Reset buffer for the next path segment.
+    };
+
+    // Iterate through all parts (which include both steps and their separators).
+    for (const part of parts) {
+      buffer.push(part);
+
+      // A "step" is a part of the path that is NOT a separator.
+      // We test if the current step (a non-slash part) is an iframe locator.
+      const isStep = !/^\/+$/.test(part);
+      if (isStep && IFRAME_STEP_RE.test(part)) {
+        flushIntoFrame();
+      }
     }
-  }
 
-  // 3 ─ whatever is left in buffer addresses the target *inside* the last ctx
-  const finalSelector = "xpath=/" + buffer.join("/");
-  return (ctx as Page | FrameLocator).locator(finalSelector);
-}
+    // If the XPath ended with an iframe, the buffer will be empty. In this case,
+    // we return a locator for the root element ('*') within the final frame.
+    if (buffer.length === 0) {
+      return (ctx as Page | FrameLocator).locator("xpath=/*");
+    }
+
+    // Join the remaining parts for the final locator.
+    const finalSelector = "xpath=" + buffer.join("");
+    return (ctx as Page | FrameLocator).locator(finalSelector);
+  }
 
 /**
  * A mapping of playwright methods that may be chosen by the LLM to their

From db0e7030f80e8dce142883c59289543dab6db310 Mon Sep 17 00:00:00 2001
From: Mochael <mkronovet@gmail.com>
Date: Mon, 14 Jul 2025 15:53:07 -0700
Subject: [PATCH 02/11] let -> const

---
 lib/handlers/handlerUtils/actHandlerUtils.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/handlers/handlerUtils/actHandlerUtils.ts b/lib/handlers/handlerUtils/actHandlerUtils.ts
index 1419b75a3..2e3623fc6 100644
--- a/lib/handlers/handlerUtils/actHandlerUtils.ts
+++ b/lib/handlers/handlerUtils/actHandlerUtils.ts
@@ -13,7 +13,7 @@ export function deepLocator(
     rawXPath: string,
   ): Locator {
     // 1 ─ strip optional 'xpath=' prefix and whitespace
-    let xpath = rawXPath.replace(/^xpath=/i, "").trim();
+    const xpath = rawXPath.replace(/^xpath=/i, "").trim();
 
     // Split the path by sequences of slashes, but keep the slashes as
     // separate elements in the array. This preserves separators like '//'.

From d28e56370ac4a43a041e32b94304e3d59d928110 Mon Sep 17 00:00:00 2001
From: Mochael <mkronovet@gmail.com>
Date: Tue, 15 Jul 2025 15:47:34 -0700
Subject: [PATCH 03/11] fix extract xpath bug

---
 lib/handlers/extractHandler.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/handlers/extractHandler.ts b/lib/handlers/extractHandler.ts
index e9e0cada7..6e3b614bd 100644
--- a/lib/handlers/extractHandler.ts
+++ b/lib/handlers/extractHandler.ts
@@ -156,7 +156,7 @@ export class StagehandExtractHandler {
           combinedXpathMap: {} as Record<EncodedId, string>,
           discoveredIframes: [] as undefined,
         }))
-      : getAccessibilityTree(this.stagehandPage, this.logger, selector).then(
+      : getAccessibilityTree(this.stagehandPage, this.logger, targetXpath).then(
           ({ simplified, idToUrl, iframes: frameNodes }) => ({
             combinedTree: simplified,
             combinedUrlMap: idToUrl as Record<EncodedId, string>,

From b733aebeaf4fa697a8a56b2b7b83103a6b72d477 Mon Sep 17 00:00:00 2001
From: Mochael <mkronovet@gmail.com>
Date: Tue, 15 Jul 2025 15:58:45 -0700
Subject: [PATCH 04/11] installing updates

---
 lib/handlers/handlerUtils/actHandlerUtils.ts | 86 ++++++++++----------
 pnpm-lock.yaml                               | 35 ++++++++
 2 files changed, 78 insertions(+), 43 deletions(-)

diff --git a/lib/handlers/handlerUtils/actHandlerUtils.ts b/lib/handlers/handlerUtils/actHandlerUtils.ts
index 2e3623fc6..644c20827 100644
--- a/lib/handlers/handlerUtils/actHandlerUtils.ts
+++ b/lib/handlers/handlerUtils/actHandlerUtils.ts
@@ -9,53 +9,53 @@ import { StagehandClickError } from "@/types/stagehandErrors";
 const IFRAME_STEP_RE = /^iframe(\[[^\]]+])?$/i;
 
 export function deepLocator(
-    root: Page | FrameLocator,
-    rawXPath: string,
-  ): Locator {
-    // 1 ─ strip optional 'xpath=' prefix and whitespace
-    const xpath = rawXPath.replace(/^xpath=/i, "").trim();
-
-    // Split the path by sequences of slashes, but keep the slashes as
-    // separate elements in the array. This preserves separators like '//'.
-    // e.g., '//a/b' becomes ['//', 'a', '/', 'b']
-    const parts = xpath.split(/(\/+)/).filter(Boolean);
-
-    let ctx: Page | FrameLocator = root;
-    let buffer: string[] = [];
-
-    const flushIntoFrame = () => {
-      if (buffer.length === 0) return;
-
-      // Join the buffered parts to form the selector for the iframe.
-      // .join('') is used because the separators are already in the buffer.
-      const selector = "xpath=" + buffer.join("");
-      ctx = (ctx as Page | FrameLocator).frameLocator(selector);
-      buffer = []; // Reset buffer for the next path segment.
-    };
-
-    // Iterate through all parts (which include both steps and their separators).
-    for (const part of parts) {
-      buffer.push(part);
-
-      // A "step" is a part of the path that is NOT a separator.
-      // We test if the current step (a non-slash part) is an iframe locator.
-      const isStep = !/^\/+$/.test(part);
-      if (isStep && IFRAME_STEP_RE.test(part)) {
-        flushIntoFrame();
-      }
-    }
-
-    // If the XPath ended with an iframe, the buffer will be empty. In this case,
-    // we return a locator for the root element ('*') within the final frame.
-    if (buffer.length === 0) {
-      return (ctx as Page | FrameLocator).locator("xpath=/*");
+  root: Page | FrameLocator,
+  rawXPath: string,
+): Locator {
+  // 1 ─ strip optional 'xpath=' prefix and whitespace
+  const xpath = rawXPath.replace(/^xpath=/i, "").trim();
+
+  // Split the path by sequences of slashes, but keep the slashes as
+  // separate elements in the array. This preserves separators like '//'.
+  // e.g., '//a/b' becomes ['//', 'a', '/', 'b']
+  const parts = xpath.split(/(\/+)/).filter(Boolean);
+
+  let ctx: Page | FrameLocator = root;
+  let buffer: string[] = [];
+
+  const flushIntoFrame = () => {
+    if (buffer.length === 0) return;
+
+    // Join the buffered parts to form the selector for the iframe.
+    // .join('') is used because the separators are already in the buffer.
+    const selector = "xpath=" + buffer.join("");
+    ctx = (ctx as Page | FrameLocator).frameLocator(selector);
+    buffer = []; // Reset buffer for the next path segment.
+  };
+
+  // Iterate through all parts (which include both steps and their separators).
+  for (const part of parts) {
+    buffer.push(part);
+
+    // A "step" is a part of the path that is NOT a separator.
+    // We test if the current step (a non-slash part) is an iframe locator.
+    const isStep = !/^\/+$/.test(part);
+    if (isStep && IFRAME_STEP_RE.test(part)) {
+      flushIntoFrame();
     }
+  }
 
-    // Join the remaining parts for the final locator.
-    const finalSelector = "xpath=" + buffer.join("");
-    return (ctx as Page | FrameLocator).locator(finalSelector);
+  // If the XPath ended with an iframe, the buffer will be empty. In this case,
+  // we return a locator for the root element ('*') within the final frame.
+  if (buffer.length === 0) {
+    return (ctx as Page | FrameLocator).locator("xpath=/*");
   }
 
+  // Join the remaining parts for the final locator.
+  const finalSelector = "xpath=" + buffer.join("");
+  return (ctx as Page | FrameLocator).locator(finalSelector);
+}
+
 /**
  * A mapping of playwright methods that may be chosen by the LLM to their
  * implementation.
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index b81dabcd6..035dfa4dc 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -204,6 +204,9 @@ importers:
         specifier: workspace:*
         version: link:..
     devDependencies:
+      jszip:
+        specifier: ^3.10.1
+        version: 3.10.1
       tsx:
         specifier: ^4.10.5
         version: 4.19.4
@@ -3153,6 +3156,9 @@ packages:
     resolution: {integrity: sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==}
     engines: {node: '>= 4'}
 
+  immediate@3.0.6:
+    resolution: {integrity: sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==}
+
   immer@9.0.21:
     resolution: {integrity: sha512-bc4NBHqOqSfRW7POMkHd51LvClaeMXpm8dx0e8oE2GORbq5aRK7Bxl4FyzVLdGtLmvLKL7BTDBG5ACQm4HWjTA==}
 
@@ -3464,6 +3470,9 @@ packages:
     resolution: {integrity: sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ==}
     engines: {node: '>=0.10.0'}
 
+  jszip@3.10.1:
+    resolution: {integrity: sha512-xXDvecyTpGLrqFrvkrUSoxxfJI5AH7U8zxxtVclpsUtMCq4JQ290LY8AW5c7Ggnr/Y/oK+bQMbqK2qmtk3pN4g==}
+
   jwa@2.0.0:
     resolution: {integrity: sha512-jrZ2Qx916EA+fq9cEAeCROWPTfCwi1IVHqT2tapuqLEVVDKFDENFw1oL+MwrTvH6msKxsd1YTDVw6uKEcsrLEA==}
 
@@ -3504,6 +3513,9 @@ packages:
     resolution: {integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==}
     engines: {node: '>= 0.8.0'}
 
+  lie@3.3.0:
+    resolution: {integrity: sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==}
+
   lilconfig@3.1.3:
     resolution: {integrity: sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==}
     engines: {node: '>=14'}
@@ -4109,6 +4121,9 @@ packages:
   package-manager-detector@0.2.11:
     resolution: {integrity: sha512-BEnLolu+yuz22S56CU1SUKq3XC3PkwD5wv4ikR4MfGvnRVcmzXR9DwSlW2fEamyTPyXHomBJRzgapeuBvRNzJQ==}
 
+  pako@1.0.11:
+    resolution: {integrity: sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==}
+
   parent-module@1.0.1:
     resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}
     engines: {node: '>=6'}
@@ -4560,6 +4575,9 @@ packages:
     resolution: {integrity: sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw==}
     engines: {node: '>= 0.4'}
 
+  setimmediate@1.0.5:
+    resolution: {integrity: sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==}
+
   setprototypeof@1.2.0:
     resolution: {integrity: sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==}
 
@@ -8825,6 +8843,8 @@ snapshots:
 
   ignore@5.3.2: {}
 
+  immediate@3.0.6: {}
+
   immer@9.0.21: {}
 
   import-fresh@3.3.1:
@@ -9111,6 +9131,13 @@ snapshots:
 
   jsonpointer@5.0.1: {}
 
+  jszip@3.10.1:
+    dependencies:
+      lie: 3.3.0
+      pako: 1.0.11
+      readable-stream: 2.3.8
+      setimmediate: 1.0.5
+
   jwa@2.0.0:
     dependencies:
       buffer-equal-constant-time: 1.0.1
@@ -9157,6 +9184,10 @@ snapshots:
       prelude-ls: 1.2.1
       type-check: 0.4.0
 
+  lie@3.3.0:
+    dependencies:
+      immediate: 3.0.6
+
   lilconfig@3.1.3: {}
 
   linear-sum-assignment@1.0.7:
@@ -10068,6 +10099,8 @@ snapshots:
     dependencies:
       quansync: 0.2.10
 
+  pako@1.0.11: {}
+
   parent-module@1.0.1:
     dependencies:
       callsites: 3.1.0
@@ -10694,6 +10727,8 @@ snapshots:
       es-errors: 1.3.0
       es-object-atoms: 1.1.1
 
+  setimmediate@1.0.5: {}
+
   setprototypeof@1.2.0: {}
 
   sharp@0.33.5:

From 853c4eab86f55b4e790fedc4443080f6ddb3b599 Mon Sep 17 00:00:00 2001
From: Tanishq Kancharla <tanishqkancharla3@gmail.com>
Date: Wed, 30 Jul 2025 16:05:34 -0700
Subject: [PATCH 05/11] fix google api client options

---
 lib/llm/GoogleClient.ts | 35 ++++++++++++++++++++++-------------
 types/model.ts          |  6 +++++-
 2 files changed, 27 insertions(+), 14 deletions(-)

diff --git a/lib/llm/GoogleClient.ts b/lib/llm/GoogleClient.ts
index 5460bea73..3aaa8e877 100644
--- a/lib/llm/GoogleClient.ts
+++ b/lib/llm/GoogleClient.ts
@@ -1,32 +1,33 @@
 import {
+  Content,
+  FunctionCall,
   GoogleGenAI,
-  HarmCategory,
+  GoogleGenAIOptions,
   HarmBlockThreshold,
-  Content,
+  HarmCategory,
   Part,
-  Tool,
-  FunctionCall,
   Schema,
+  Tool,
   Type,
 } from "@google/genai";
 import zodToJsonSchema from "zod-to-json-schema";
 
+import {
+  CreateChatCompletionResponseError,
+  StagehandError,
+} from "@/types/stagehandErrors";
 import { LogLine } from "../../types/log";
 import { AvailableModel, ClientOptions } from "../../types/model";
 import { LLMCache } from "../cache/LLMCache";
-import { validateZodSchema, toGeminiSchema, loadApiKeyFromEnv } from "../utils";
+import { loadApiKeyFromEnv, toGeminiSchema, validateZodSchema } from "../utils";
 import {
+  AnnotatedScreenshotText,
   ChatCompletionOptions,
   ChatMessage,
   CreateChatCompletionOptions,
   LLMClient,
   LLMResponse,
-  AnnotatedScreenshotText,
 } from "./LLMClient";
-import {
-  CreateChatCompletionResponseError,
-  StagehandError,
-} from "@/types/stagehandErrors";
 
 // Mapping from generic roles to Gemini roles
 const roleMap: { [key in ChatMessage["role"]]: string } = {
@@ -60,7 +61,7 @@ export class GoogleClient extends LLMClient {
   private client: GoogleGenAI;
   private cache: LLMCache | undefined;
   private enableCaching: boolean;
-  public clientOptions: ClientOptions;
+  public clientOptions: GoogleGenAIOptions;
   public hasVision: boolean;
   private logger: (message: LogLine) => void;
 
@@ -82,8 +83,16 @@ export class GoogleClient extends LLMClient {
       // Try to get the API key from the environment variable GOOGLE_API_KEY
       clientOptions.apiKey = loadApiKeyFromEnv("google_legacy", logger);
     }
-    this.clientOptions = clientOptions;
-    this.client = new GoogleGenAI({ apiKey: clientOptions.apiKey });
+    this.clientOptions = clientOptions as GoogleGenAIOptions;
+    this.client = new GoogleGenAI({
+      apiKey: this.clientOptions.apiKey,
+      vertexai: this.clientOptions.vertexai,
+      project: this.clientOptions.project,
+      location: this.clientOptions.location,
+      apiVersion: this.clientOptions.apiVersion,
+      googleAuthOptions: this.clientOptions.googleAuthOptions,
+      httpOptions: this.clientOptions.httpOptions,
+    });
     this.cache = cache;
     this.enableCaching = enableCaching;
     this.modelName = modelName;
diff --git a/types/model.ts b/types/model.ts
index bdd9324b2..b96dff66a 100644
--- a/types/model.ts
+++ b/types/model.ts
@@ -1,4 +1,5 @@
 import type { ClientOptions as AnthropicClientOptions } from "@anthropic-ai/sdk";
+import type { GoogleGenAIOptions as GoogleClientOptions } from "@google/genai";
 import type { ClientOptions as OpenAIClientOptions } from "openai";
 import { z } from "zod";
 
@@ -44,7 +45,10 @@ export type ModelProvider =
   | "google"
   | "aisdk";
 
-export type ClientOptions = OpenAIClientOptions | AnthropicClientOptions;
+export type ClientOptions =
+  | OpenAIClientOptions
+  | AnthropicClientOptions
+  | GoogleClientOptions;
 
 export interface AnthropicJsonSchemaObject {
   definitions?: {

From 1c10a8c4dc27c70154945d31186204f98db11f14 Mon Sep 17 00:00:00 2001
From: Tanishq Kancharla <tanishqkancharla3@gmail.com>
Date: Wed, 30 Jul 2025 16:46:00 -0700
Subject: [PATCH 06/11] bump

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 06231a908..39eb10e71 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "An AI web browsing framework focused on simplicity and extensibility.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

From cc3a194eaef0d8f129ee631e3edc27c68e28e595 Mon Sep 17 00:00:00 2001
From: Tanishq Kancharla <tanishqkancharla3@gmail.com>
Date: Thu, 31 Jul 2025 15:42:01 -0700
Subject: [PATCH 07/11] refactor: clean up GoogleClient and LLMProvider imports

- Removed the loading of API key from environment in GoogleClient.
- Consolidated and organized imports in LLMProvider for better readability.
- Added new model mappings for Google in LLMProvider.
---
 lib/llm/GoogleClient.ts |  6 +-----
 lib/llm/LLMProvider.ts  | 28 +++++++++++++++-------------
 2 files changed, 16 insertions(+), 18 deletions(-)

diff --git a/lib/llm/GoogleClient.ts b/lib/llm/GoogleClient.ts
index 3aaa8e877..4adff5230 100644
--- a/lib/llm/GoogleClient.ts
+++ b/lib/llm/GoogleClient.ts
@@ -19,7 +19,7 @@ import {
 import { LogLine } from "../../types/log";
 import { AvailableModel, ClientOptions } from "../../types/model";
 import { LLMCache } from "../cache/LLMCache";
-import { loadApiKeyFromEnv, toGeminiSchema, validateZodSchema } from "../utils";
+import { toGeminiSchema, validateZodSchema } from "../utils";
 import {
   AnnotatedScreenshotText,
   ChatCompletionOptions,
@@ -79,10 +79,6 @@ export class GoogleClient extends LLMClient {
     clientOptions?: ClientOptions; // Expecting { apiKey: string } here
   }) {
     super(modelName);
-    if (!clientOptions?.apiKey) {
-      // Try to get the API key from the environment variable GOOGLE_API_KEY
-      clientOptions.apiKey = loadApiKeyFromEnv("google_legacy", logger);
-    }
     this.clientOptions = clientOptions as GoogleGenAIOptions;
     this.client = new GoogleGenAI({
       apiKey: this.clientOptions.apiKey,
diff --git a/lib/llm/LLMProvider.ts b/lib/llm/LLMProvider.ts
index 4c7e9f1d8..8b0e29442 100644
--- a/lib/llm/LLMProvider.ts
+++ b/lib/llm/LLMProvider.ts
@@ -1,8 +1,21 @@
+import { AISDKCustomProvider, AISDKProvider } from "@/types/llm";
 import {
   UnsupportedAISDKModelProviderError,
   UnsupportedModelError,
   UnsupportedModelProviderError,
 } from "@/types/stagehandErrors";
+import { anthropic, createAnthropic } from "@ai-sdk/anthropic";
+import { azure, createAzure } from "@ai-sdk/azure";
+import { cerebras, createCerebras } from "@ai-sdk/cerebras";
+import { createDeepSeek, deepseek } from "@ai-sdk/deepseek";
+import { createGoogleGenerativeAI, google } from "@ai-sdk/google";
+import { createGroq, groq } from "@ai-sdk/groq";
+import { createMistral, mistral } from "@ai-sdk/mistral";
+import { createOpenAI, openai } from "@ai-sdk/openai";
+import { createPerplexity, perplexity } from "@ai-sdk/perplexity";
+import { createTogetherAI, togetherai } from "@ai-sdk/togetherai";
+import { createXai, xai } from "@ai-sdk/xai";
+import { ollama } from "ollama-ai-provider";
 import { LogLine } from "../../types/log";
 import {
   AvailableModel,
@@ -17,19 +30,6 @@ import { GoogleClient } from "./GoogleClient";
 import { GroqClient } from "./GroqClient";
 import { LLMClient } from "./LLMClient";
 import { OpenAIClient } from "./OpenAIClient";
-import { openai, createOpenAI } from "@ai-sdk/openai";
-import { anthropic, createAnthropic } from "@ai-sdk/anthropic";
-import { google, createGoogleGenerativeAI } from "@ai-sdk/google";
-import { xai, createXai } from "@ai-sdk/xai";
-import { azure, createAzure } from "@ai-sdk/azure";
-import { groq, createGroq } from "@ai-sdk/groq";
-import { cerebras, createCerebras } from "@ai-sdk/cerebras";
-import { togetherai, createTogetherAI } from "@ai-sdk/togetherai";
-import { mistral, createMistral } from "@ai-sdk/mistral";
-import { deepseek, createDeepSeek } from "@ai-sdk/deepseek";
-import { perplexity, createPerplexity } from "@ai-sdk/perplexity";
-import { ollama } from "ollama-ai-provider";
-import { AISDKProvider, AISDKCustomProvider } from "@/types/llm";
 
 const AISDKProviders: Record<string, AISDKProvider> = {
   openai,
@@ -91,7 +91,9 @@ const modelToProviderMap: { [key in AvailableModel]: ModelProvider } = {
   "gemini-2.0-flash-lite": "google",
   "gemini-2.0-flash": "google",
   "gemini-2.5-flash-preview-04-17": "google",
+  "gemini-2.5-flash": "google",
   "gemini-2.5-pro-preview-03-25": "google",
+  "gemini-2.5-pro": "google",
 };
 
 export function getAISDKLanguageModel(

From 17e53c1343db4c927150f0f27d9ff1a94ca5ed60 Mon Sep 17 00:00:00 2001
From: Mochael <mkronovet@gmail.com>
Date: Thu, 31 Jul 2025 17:18:07 -0700
Subject: [PATCH 08/11] enabling vertex ai

---
 lib/StagehandPage.ts | 27 ++++++++++++++++++++++++---
 lib/index.ts         |  7 ++++++-
 2 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/lib/StagehandPage.ts b/lib/StagehandPage.ts
index 353631963..98db37bc6 100644
--- a/lib/StagehandPage.ts
+++ b/lib/StagehandPage.ts
@@ -668,9 +668,16 @@ ${scriptContent} \
       }
 
       const requestId = Math.random().toString(36).substring(2);
+
+      // Use provided modelName if available, otherwise use the configured llmClient
       const llmClient: LLMClient = modelName
         ? this.stagehand.llmProvider.getClient(modelName, modelClientOptions)
-        : this.llmClient;
+        : this.stagehand.llmClient;
+
+      // Add null check for llmClient before accessing modelName
+      if (!llmClient) {
+        throw new MissingLLMConfigurationError();
+      }
 
       this.stagehand.log({
         category: "act",
@@ -765,9 +772,16 @@ ${scriptContent} \
       }
 
       const requestId = Math.random().toString(36).substring(2);
+
+      // Use provided modelName if available, otherwise use the configured llmClient
       const llmClient = modelName
         ? this.stagehand.llmProvider.getClient(modelName, modelClientOptions)
-        : this.llmClient;
+        : this.stagehand.llmClient;
+
+      // Add null check for llmClient before accessing modelName
+      if (!llmClient) {
+        throw new MissingLLMConfigurationError();
+      }
 
       this.stagehand.log({
         category: "extract",
@@ -872,9 +886,16 @@ ${scriptContent} \
       }
 
       const requestId = Math.random().toString(36).substring(2);
+
+      // Use provided modelName if available, otherwise use the configured llmClient
       const llmClient = modelName
         ? this.stagehand.llmProvider.getClient(modelName, modelClientOptions)
-        : this.llmClient;
+        : this.stagehand.llmClient;
+
+      // Add null check for llmClient before accessing modelName
+      if (!llmClient) {
+        throw new MissingLLMConfigurationError();
+      }
 
       this.stagehand.log({
         category: "observe",
diff --git a/lib/index.ts b/lib/index.ts
index 60551d331..09f20f60c 100644
--- a/lib/index.ts
+++ b/lib/index.ts
@@ -8,6 +8,7 @@ import { BrowserResult } from "../types/browser";
 import { EnhancedContext } from "../types/context";
 import { LogLine } from "../types/log";
 import { AvailableModel } from "../types/model";
+import type { GoogleGenAIOptions as GoogleClientOptions } from "@google/genai";
 import { BrowserContext, Page } from "../types/page";
 import {
   ConstructorParams,
@@ -583,7 +584,11 @@ export class Stagehand {
 
     let modelApiKey: string | undefined;
 
-    if (!modelClientOptions?.apiKey) {
+    if (
+      !modelClientOptions?.apiKey ||
+      (LLMProvider.getModelProvider(this.modelName) === "google" &&
+        !(modelClientOptions as GoogleClientOptions)?.vertexai)
+    ) {
       // If no API key is provided, try to load it from the environment
       if (LLMProvider.getModelProvider(this.modelName) === "aisdk") {
         modelApiKey = loadApiKeyFromEnv(

From 60e0224d93ce20bdd94045d7b4cc741f243551de Mon Sep 17 00:00:00 2001
From: Mochael <mkronovet@gmail.com>
Date: Thu, 31 Jul 2025 18:34:01 -0700
Subject: [PATCH 09/11] trying to fix vertex

---
 examples/external_clients/google_vertex.ts | 39 +++++++++++++++++
 lib/StagehandPage.ts                       | 27 ++++++------
 lib/index.ts                               |  7 +--
 lib/llm/GoogleVertexClient.ts              | 50 ++++++++++++++++++++++
 lib/llm/LLMProvider.ts                     | 28 ++++++++++++
 5 files changed, 136 insertions(+), 15 deletions(-)
 create mode 100644 examples/external_clients/google_vertex.ts
 create mode 100644 lib/llm/GoogleVertexClient.ts

diff --git a/examples/external_clients/google_vertex.ts b/examples/external_clients/google_vertex.ts
new file mode 100644
index 000000000..e802d96c3
--- /dev/null
+++ b/examples/external_clients/google_vertex.ts
@@ -0,0 +1,39 @@
+import { Stagehand } from "@browserbasehq/stagehand";
+import { z } from "zod";
+
+/**
+ * Example of using Google Vertex AI directly (not through AI SDK).
+ * When you provide `vertexai: true` in the client options,
+ * the system will route to GoogleVertexClient instead of using AI SDK.
+ */
+async function main() {
+  const stagehand = new Stagehand({
+    env: "LOCAL",
+    enableCaching: false,
+    modelName: "google/gemini-1.5-pro", // Google model with slash notation
+    modelClientOptions: {
+      // Vertex AI specific configuration - bypasses AI SDK
+      vertexai: true,
+      project: "your-gcp-project-id",
+      location: "us-central1",
+      // Optional: API key if not using default auth
+      // apiKey: process.env.GOOGLE_API_KEY,
+    },
+  });
+
+  await stagehand.init();
+  await stagehand.page.goto("https://docs.stagehand.dev");
+
+  // Extract some text using Vertex AI (not AI SDK)
+  const result = await stagehand.page.extract({
+    instruction: "extract the main heading of this page",
+    schema: z.object({
+      heading: z.string(),
+    }),
+  });
+
+  console.log("Extracted:", result);
+  await stagehand.close();
+}
+
+main().catch(console.error);
diff --git a/lib/StagehandPage.ts b/lib/StagehandPage.ts
index 98db37bc6..e50583dde 100644
--- a/lib/StagehandPage.ts
+++ b/lib/StagehandPage.ts
@@ -669,10 +669,11 @@ ${scriptContent} \
 
       const requestId = Math.random().toString(36).substring(2);
 
-      // Use provided modelName if available, otherwise use the configured llmClient
-      const llmClient: LLMClient = modelName
-        ? this.stagehand.llmProvider.getClient(modelName, modelClientOptions)
-        : this.stagehand.llmClient;
+      // Use provided modelName if available AND if modelClientOptions has an API key, otherwise use the configured llmClient
+      const llmClient =
+        modelName && modelClientOptions?.apiKey
+          ? this.stagehand.llmProvider.getClient(modelName, modelClientOptions)
+          : this.stagehand.llmClient;
 
       // Add null check for llmClient before accessing modelName
       if (!llmClient) {
@@ -773,10 +774,11 @@ ${scriptContent} \
 
       const requestId = Math.random().toString(36).substring(2);
 
-      // Use provided modelName if available, otherwise use the configured llmClient
-      const llmClient = modelName
-        ? this.stagehand.llmProvider.getClient(modelName, modelClientOptions)
-        : this.stagehand.llmClient;
+      // Use provided modelName if available AND if modelClientOptions has an API key, otherwise use the configured llmClient
+      const llmClient =
+        modelName && modelClientOptions?.apiKey
+          ? this.stagehand.llmProvider.getClient(modelName, modelClientOptions)
+          : this.stagehand.llmClient;
 
       // Add null check for llmClient before accessing modelName
       if (!llmClient) {
@@ -887,10 +889,11 @@ ${scriptContent} \
 
       const requestId = Math.random().toString(36).substring(2);
 
-      // Use provided modelName if available, otherwise use the configured llmClient
-      const llmClient = modelName
-        ? this.stagehand.llmProvider.getClient(modelName, modelClientOptions)
-        : this.stagehand.llmClient;
+      // Use provided modelName if available AND if modelClientOptions has an API key, otherwise use the configured llmClient
+      const llmClient =
+        modelName && modelClientOptions?.apiKey
+          ? this.stagehand.llmProvider.getClient(modelName, modelClientOptions)
+          : this.stagehand.llmClient;
 
       // Add null check for llmClient before accessing modelName
       if (!llmClient) {
diff --git a/lib/index.ts b/lib/index.ts
index 09f20f60c..9068f6828 100644
--- a/lib/index.ts
+++ b/lib/index.ts
@@ -585,9 +585,10 @@ export class Stagehand {
     let modelApiKey: string | undefined;
 
     if (
-      !modelClientOptions?.apiKey ||
-      (LLMProvider.getModelProvider(this.modelName) === "google" &&
-        !(modelClientOptions as GoogleClientOptions)?.vertexai)
+      !modelClientOptions?.apiKey &&
+      ((LLMProvider.getModelProvider(this.modelName) === "google" &&
+        !(modelClientOptions as GoogleClientOptions)?.vertexai) ||
+        LLMProvider.getModelProvider(this.modelName) !== "google")
     ) {
       // If no API key is provided, try to load it from the environment
       if (LLMProvider.getModelProvider(this.modelName) === "aisdk") {
diff --git a/lib/llm/GoogleVertexClient.ts b/lib/llm/GoogleVertexClient.ts
new file mode 100644
index 000000000..3c939b104
--- /dev/null
+++ b/lib/llm/GoogleVertexClient.ts
@@ -0,0 +1,50 @@
+import { GoogleGenAIOptions } from "@google/genai";
+import { LogLine } from "../../types/log";
+import { AvailableModel, ClientOptions } from "../../types/model";
+import { LLMCache } from "../cache/LLMCache";
+import { GoogleClient } from "./GoogleClient";
+
+export interface GoogleVertexClientOptions extends GoogleGenAIOptions {
+  vertexai: boolean;
+  project: string;
+  location: string;
+}
+
+export class GoogleVertexClient extends GoogleClient {
+  constructor({
+    logger,
+    enableCaching = false,
+    cache,
+    modelName,
+    clientOptions,
+  }: {
+    logger: (message: LogLine) => void;
+    enableCaching?: boolean;
+    cache?: LLMCache;
+    modelName: AvailableModel;
+    clientOptions?: ClientOptions;
+  }) {
+    // Ensure vertex ai configuration is present
+    const vertexOptions = clientOptions as GoogleVertexClientOptions;
+    if (!vertexOptions?.vertexai) {
+      throw new Error("GoogleVertexClient requires vertexai option to be true");
+    }
+    if (!vertexOptions?.project) {
+      throw new Error("GoogleVertexClient requires project configuration");
+    }
+    if (!vertexOptions?.location) {
+      throw new Error("GoogleVertexClient requires location configuration");
+    }
+
+    super({
+      logger,
+      enableCaching,
+      cache,
+      modelName,
+      clientOptions: {
+        ...vertexOptions,
+        vertexai: true,
+      },
+    });
+  }
+}
diff --git a/lib/llm/LLMProvider.ts b/lib/llm/LLMProvider.ts
index 8b0e29442..41e1d1853 100644
--- a/lib/llm/LLMProvider.ts
+++ b/lib/llm/LLMProvider.ts
@@ -27,6 +27,7 @@ import { AISdkClient } from "./aisdk";
 import { AnthropicClient } from "./AnthropicClient";
 import { CerebrasClient } from "./CerebrasClient";
 import { GoogleClient } from "./GoogleClient";
+import { GoogleVertexClient } from "./GoogleVertexClient";
 import { GroqClient } from "./GroqClient";
 import { LLMClient } from "./LLMClient";
 import { OpenAIClient } from "./OpenAIClient";
@@ -96,11 +97,26 @@ const modelToProviderMap: { [key in AvailableModel]: ModelProvider } = {
   "gemini-2.5-pro": "google",
 };
 
+function isVertexAIRequest(clientOptions?: ClientOptions): boolean {
+  return !!(
+    clientOptions &&
+    "vertexai" in clientOptions &&
+    clientOptions.vertexai
+  );
+}
+
 export function getAISDKLanguageModel(
   subProvider: string,
   subModelName: string,
   apiKey?: string,
+  clientOptions?: ClientOptions,
 ) {
+  // If this is a google model with vertex AI configuration, don't use AI SDK
+  if (subProvider === "google" && isVertexAIRequest(clientOptions)) {
+    throw new Error(
+      "Vertex AI models should use GoogleVertexClient, not AI SDK",
+    );
+  }
   if (apiKey) {
     const creator = AISDKProvidersWithAPIKey[subProvider];
     if (!creator) {
@@ -164,10 +180,22 @@ export class LLMProvider {
       const subProvider = modelName.substring(0, firstSlashIndex);
       const subModelName = modelName.substring(firstSlashIndex + 1);
 
+      // Check if this is a vertex AI request for google models
+      if (subProvider === "google" && isVertexAIRequest(clientOptions)) {
+        return new GoogleVertexClient({
+          logger: this.logger,
+          enableCaching: this.enableCaching,
+          cache: this.cache,
+          modelName: modelName,
+          clientOptions,
+        });
+      }
+
       const languageModel = getAISDKLanguageModel(
         subProvider,
         subModelName,
         clientOptions?.apiKey,
+        clientOptions,
       );
 
       return new AISdkClient({

From 4ad83f86a5c357ec82a9fd792f5fd1af466e058e Mon Sep 17 00:00:00 2001
From: Mochael <mkronovet@gmail.com>
Date: Thu, 31 Jul 2025 18:48:19 -0700
Subject: [PATCH 10/11] fixing package to allow og providers

---
 lib/index.ts           | 23 ++++++++++++-----------
 lib/llm/LLMProvider.ts |  7 +++++--
 2 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/lib/index.ts b/lib/index.ts
index 9068f6828..a800408fc 100644
--- a/lib/index.ts
+++ b/lib/index.ts
@@ -8,7 +8,6 @@ import { BrowserResult } from "../types/browser";
 import { EnhancedContext } from "../types/context";
 import { LogLine } from "../types/log";
 import { AvailableModel } from "../types/model";
-import type { GoogleGenAIOptions as GoogleClientOptions } from "@google/genai";
 import { BrowserContext, Page } from "../types/page";
 import {
   ConstructorParams,
@@ -584,14 +583,16 @@ export class Stagehand {
 
     let modelApiKey: string | undefined;
 
-    if (
-      !modelClientOptions?.apiKey &&
-      ((LLMProvider.getModelProvider(this.modelName) === "google" &&
-        !(modelClientOptions as GoogleClientOptions)?.vertexai) ||
-        LLMProvider.getModelProvider(this.modelName) !== "google")
-    ) {
+    const usingVertexAI =
+      "vertexai" in modelClientOptions && modelClientOptions.vertexai;
+    const provider = LLMProvider.getModelProvider(
+      this.modelName,
+      usingVertexAI,
+    );
+
+    if (!modelClientOptions?.apiKey && !usingVertexAI) {
       // If no API key is provided, try to load it from the environment
-      if (LLMProvider.getModelProvider(this.modelName) === "aisdk") {
+      if (provider === "aisdk") {
         modelApiKey = loadApiKeyFromEnv(
           this.modelName.split("/")[0],
           this.logger,
@@ -599,13 +600,13 @@ export class Stagehand {
       } else {
         // Temporary add for legacy providers
         modelApiKey =
-          LLMProvider.getModelProvider(this.modelName) === "openai"
+          provider === "openai"
             ? process.env.OPENAI_API_KEY ||
               this.llmClient?.clientOptions?.apiKey
-            : LLMProvider.getModelProvider(this.modelName) === "anthropic"
+            : provider === "anthropic"
               ? process.env.ANTHROPIC_API_KEY ||
                 this.llmClient?.clientOptions?.apiKey
-              : LLMProvider.getModelProvider(this.modelName) === "google"
+              : provider === "google"
                 ? process.env.GOOGLE_API_KEY ||
                   this.llmClient?.clientOptions?.apiKey
                 : undefined;
diff --git a/lib/llm/LLMProvider.ts b/lib/llm/LLMProvider.ts
index 41e1d1853..a630b3e4b 100644
--- a/lib/llm/LLMProvider.ts
+++ b/lib/llm/LLMProvider.ts
@@ -259,8 +259,11 @@ export class LLMProvider {
     }
   }
 
-  static getModelProvider(modelName: AvailableModel): ModelProvider {
-    if (modelName.includes("/")) {
+  static getModelProvider(
+    modelName: AvailableModel,
+    usingOriginalProvider: boolean,
+  ): ModelProvider {
+    if (modelName.includes("/") && !usingOriginalProvider) {
       const firstSlashIndex = modelName.indexOf("/");
       const subProvider = modelName.substring(0, firstSlashIndex);
       if (AISDKProviders[subProvider]) {

From 7be1a57318121b9fc8433e160b774fd9d6643b41 Mon Sep 17 00:00:00 2001
From: Mochael <mkronovet@gmail.com>
Date: Fri, 1 Aug 2025 14:23:37 -0700
Subject: [PATCH 11/11] update google genai package

---
 package.json   |   2 +-
 pnpm-lock.yaml | 120 ++++++++++++++++++++++++++++++++-----------------
 2 files changed, 81 insertions(+), 41 deletions(-)

diff --git a/package.json b/package.json
index 39eb10e71..0d550939d 100644
--- a/package.json
+++ b/package.json
@@ -73,7 +73,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "0.39.0",
     "@browserbasehq/sdk": "^2.4.0",
-    "@google/genai": "^0.8.0",
+    "@google/genai": "^1.12.0",
     "ai": "^4.3.9",
     "devtools-protocol": "^0.0.1464554",
     "fetch-cookie": "^3.1.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 035dfa4dc..63493d0ac 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -15,8 +15,8 @@ importers:
         specifier: ^2.4.0
         version: 2.5.0
       '@google/genai':
-        specifier: ^0.8.0
-        version: 0.8.0
+        specifier: ^1.12.0
+        version: 1.12.0
       ai:
         specifier: ^4.3.9
         version: 4.3.12(react@19.1.0)(zod@3.24.3)
@@ -165,7 +165,7 @@ importers:
         version: 1.3.0
       tsup:
         specifier: ^8.2.1
-        version: 8.4.0(postcss@8.5.3)(tsx@4.19.4)(typescript@5.8.3)(yaml@2.7.1)
+        version: 8.4.0(postcss@8.5.6)(tsx@4.19.4)(typescript@5.8.3)(yaml@2.7.1)
       tsx:
         specifier: ^4.10.5
         version: 4.19.4
@@ -408,8 +408,8 @@ packages:
     resolution: {integrity: sha512-D2hP9eA+Sqx1kBZgzxZh0y1trbuU+JoDkiEwqhQ36nodYqJwyEIhPSdMNd7lOm/4io72luTPWH20Yda0xOuUow==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/parser@7.27.2':
-    resolution: {integrity: sha512-QYLs8299NA7WM/bZAdp+CviYYkVoYXlDW2rzliy3chxd1PQjej7JORuMJDJXJUb9g0TT+B99EwaVLKmX+sPXWw==}
+  '@babel/parser@7.28.0':
+    resolution: {integrity: sha512-jVZGvOxOuNSsuQuLRTh13nU0AogFlw32w/MT+LV6D3sP5WdbW61E77RnkbaO2dUvmPAYrBDJXGn5gGS6tH4j8g==}
     engines: {node: '>=6.0.0'}
     hasBin: true
 
@@ -417,8 +417,8 @@ packages:
     resolution: {integrity: sha512-1x3D2xEk2fRo3PAhwQwu5UubzgiVWSXTBfWpVd2Mx2AzRqJuDJCsgaDVZ7HB5iGzDW1Hl1sWN2mFyKjmR9uAog==}
     engines: {node: '>=6.9.0'}
 
-  '@babel/types@7.27.1':
-    resolution: {integrity: sha512-+EzkxvLNfiUeKMgy/3luqfsCWFRXLb7U6wNQTk60tovuckwB15B191tJWvpp4HjiQWdJkCxO3Wbvc6jlk3Xb2Q==}
+  '@babel/types@7.28.2':
+    resolution: {integrity: sha512-ruv7Ae4J5dUYULmeXw1gmb7rYRz57OWCPM57pHojnLq/3Z1CK2lNSLTCVjxVk1F/TZHwOZZrOWi0ur95BbLxNQ==}
     engines: {node: '>=6.9.0'}
 
   '@braintrust/core@0.0.34':
@@ -955,9 +955,14 @@ packages:
     resolution: {integrity: sha512-ZAoA40rNMPwSm+AeHpCq8STiNAwzWLJuP8Xv4CHIc9wv/PSuExjMrmjfYNj682vW0OOiZ1HKxzvjQr9XZIisQA==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
 
-  '@google/genai@0.8.0':
-    resolution: {integrity: sha512-Zs+OGyZKyMbFofGJTR9/jTQSv8kITh735N3tEuIZj4VlMQXTC0soCFahysJ9NaeenRlD7xGb6fyqmX+FwrpU6Q==}
-    engines: {node: '>=18.0.0'}
+  '@google/genai@1.12.0':
+    resolution: {integrity: sha512-JBkQsULVexdM9zY4iXbm3A2dJ7El/hSPGCnxuRWPJNgeqcfYuyUnPTSy+I/v+MvTbz/occVmONSD6wn+17QLkg==}
+    engines: {node: '>=20.0.0'}
+    peerDependencies:
+      '@modelcontextprotocol/sdk': ^1.11.0
+    peerDependenciesMeta:
+      '@modelcontextprotocol/sdk':
+        optional: true
 
   '@humanfs/core@0.19.1':
     resolution: {integrity: sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==}
@@ -1209,6 +1214,9 @@ packages:
     resolution: {integrity: sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==}
     engines: {node: '>=12'}
 
+  '@jridgewell/gen-mapping@0.3.12':
+    resolution: {integrity: sha512-OuLGC46TjB5BbN1dH8JULVVZY4WTdkF7tV9Ys6wLL1rubZnCMstOhNHueU5bLCrnRuDhKPDM4g6sw4Bel5Gzqg==}
+
   '@jridgewell/gen-mapping@0.3.8':
     resolution: {integrity: sha512-imAbBGkb+ebQyxKgzv5Hu2nmROxoDOXHh80evxdoXNOrvAnVx7zimzc1Oo5h9RlfV4vPXaE2iM5pOFbvOCClWA==}
     engines: {node: '>=6.0.0'}
@@ -1224,9 +1232,15 @@ packages:
   '@jridgewell/sourcemap-codec@1.5.0':
     resolution: {integrity: sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==}
 
+  '@jridgewell/sourcemap-codec@1.5.4':
+    resolution: {integrity: sha512-VT2+G1VQs/9oz078bLrYbecdZKs912zQlkelYpuf+SXF+QvZDYJlbx/LSx+meSAwdDFnF8FVXW92AVjjkVmgFw==}
+
   '@jridgewell/trace-mapping@0.3.25':
     resolution: {integrity: sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ==}
 
+  '@jridgewell/trace-mapping@0.3.29':
+    resolution: {integrity: sha512-uw6guiW/gcAGPDhLmd77/6lW8QLeiV5RUTsAX46Db6oLhGaVj4lhnPwb184s1bkc8kdVg/+h988dro8GRDpmYQ==}
+
   '@jsep-plugin/assignment@1.3.0':
     resolution: {integrity: sha512-VVgV+CXrhbMI3aSusQyclHkenWSAm95WaiKrMxRFam3JSUiIaQjoMIw2sEs/OX4XifnqeQUN4DYbJjlA8EfktQ==}
     engines: {node: '>= 10.16.0'}
@@ -1582,6 +1596,9 @@ packages:
   '@types/estree@1.0.7':
     resolution: {integrity: sha512-w28IoSUCJpidD/TGviZwwMJckNESJZXFu7NBZ5YJ4mEUnNraUn9Pm8HSZm/jDF1pDWYKspWE7oVphigUPRakIQ==}
 
+  '@types/estree@1.0.8':
+    resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
+
   '@types/express-serve-static-core@4.19.6':
     resolution: {integrity: sha512-N4LZ2xG7DatVqhCZzOGb1Yi5lMbXSZcmdLDe9EzSndPV2HpWYWzRbaerl2n27irrm94EPpprqa8KpskPT085+A==}
 
@@ -1778,6 +1795,11 @@ packages:
     engines: {node: '>=0.4.0'}
     hasBin: true
 
+  acorn@8.15.0:
+    resolution: {integrity: sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==}
+    engines: {node: '>=0.4.0'}
+    hasBin: true
+
   address@1.2.2:
     resolution: {integrity: sha512-4B/qKCfeE/ODUaAUpSwfzazo5x29WD4r3vXiWsB7I2mSDAihwEqKO+g8GELZUQSSAo5e1XTYh3ZVfLyxBc12nA==}
     engines: {node: '>= 10.0.0'}
@@ -2669,8 +2691,8 @@ packages:
     resolution: {integrity: sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==}
     engines: {node: '>=0.10'}
 
-  esrap@1.4.6:
-    resolution: {integrity: sha512-F/D2mADJ9SHY3IwksD4DAXjTt7qt7GWUf3/8RhCNWmC/67tyb55dpimHmy7EplakFaflV0R/PC+fdSPqrRHAQw==}
+  esrap@1.4.9:
+    resolution: {integrity: sha512-3OMlcd0a03UGuZpPeUC1HxR3nA23l+HEyCiZw3b3FumJIN9KphoGzDJKMXI1S72jVS1dsenDyQC0kJlO1U9E1g==}
 
   esrecurse@4.3.0:
     resolution: {integrity: sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==}
@@ -3882,6 +3904,7 @@ packages:
   multer@1.4.5-lts.2:
     resolution: {integrity: sha512-VzGiVigcG9zUAoCNU+xShztrlr1auZOlurXynNvO9GiWD1/mTBbUljOKY+qMeazBqXgRnjzeEgJI/wyjJUHg9A==}
     engines: {node: '>= 6.0.0'}
+    deprecated: Multer 1.x is impacted by a number of vulnerabilities, which have been patched in 2.x. You should upgrade to the latest 2.x version.
 
   mustache@4.2.0:
     resolution: {integrity: sha512-71ippSywq5Yb7/tVYyGbkBggbU8H3u5Rz56fH60jGFgr8uHwxs+aSKeqmluIVzM0m0kB7xQjKS6qPfd0b2ZoqQ==}
@@ -4249,8 +4272,8 @@ packages:
       yaml:
         optional: true
 
-  postcss@8.5.3:
-    resolution: {integrity: sha512-dle9A3yYxlBSrt8Fu+IpjGT8SY8hN0mlaA6GY8t0P5PjIOZemULz/E2Bnm/2dcUOena75OTNkHI76uZBNUUq3A==}
+  postcss@8.5.6:
+    resolution: {integrity: sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==}
     engines: {node: ^10 || ^12 || >=14}
 
   prelude-ls@1.2.1:
@@ -4678,6 +4701,7 @@ packages:
   source-map@0.8.0-beta.0:
     resolution: {integrity: sha512-2ymg6oRBpebeZi9UUNsgQ89bhx01TcTkmNTGnNO88imTmbSgy4nfujrgVEFKWpMTEGA11EDkTt7mqObTPdigIA==}
     engines: {node: '>= 8'}
+    deprecated: The work that was done in this beta branch won't be included in future versions
 
   space-separated-tokens@2.0.2:
     resolution: {integrity: sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==}
@@ -5452,8 +5476,8 @@ snapshots:
 
   '@ampproject/remapping@2.3.0':
     dependencies:
-      '@jridgewell/gen-mapping': 0.3.8
-      '@jridgewell/trace-mapping': 0.3.25
+      '@jridgewell/gen-mapping': 0.3.12
+      '@jridgewell/trace-mapping': 0.3.29
 
   '@anthropic-ai/sdk@0.39.0':
     dependencies:
@@ -5510,13 +5534,13 @@ snapshots:
 
   '@babel/helper-validator-identifier@7.27.1': {}
 
-  '@babel/parser@7.27.2':
+  '@babel/parser@7.28.0':
     dependencies:
-      '@babel/types': 7.27.1
+      '@babel/types': 7.28.2
 
   '@babel/runtime@7.27.1': {}
 
-  '@babel/types@7.27.1':
+  '@babel/types@7.28.2':
     dependencies:
       '@babel/helper-string-parser': 7.27.1
       '@babel/helper-validator-identifier': 7.27.1
@@ -5963,7 +5987,7 @@ snapshots:
       '@eslint/core': 0.13.0
       levn: 0.4.1
 
-  '@google/genai@0.8.0':
+  '@google/genai@1.12.0':
     dependencies:
       google-auth-library: 9.15.1
       ws: 8.18.1
@@ -6186,6 +6210,11 @@ snapshots:
       wrap-ansi: 8.1.0
       wrap-ansi-cjs: wrap-ansi@7.0.0
 
+  '@jridgewell/gen-mapping@0.3.12':
+    dependencies:
+      '@jridgewell/sourcemap-codec': 1.5.4
+      '@jridgewell/trace-mapping': 0.3.29
+
   '@jridgewell/gen-mapping@0.3.8':
     dependencies:
       '@jridgewell/set-array': 1.2.1
@@ -6198,11 +6227,18 @@ snapshots:
 
   '@jridgewell/sourcemap-codec@1.5.0': {}
 
+  '@jridgewell/sourcemap-codec@1.5.4': {}
+
   '@jridgewell/trace-mapping@0.3.25':
     dependencies:
       '@jridgewell/resolve-uri': 3.1.2
       '@jridgewell/sourcemap-codec': 1.5.0
 
+  '@jridgewell/trace-mapping@0.3.29':
+    dependencies:
+      '@jridgewell/resolve-uri': 3.1.2
+      '@jridgewell/sourcemap-codec': 1.5.4
+
   '@jsep-plugin/assignment@1.3.0(jsep@1.4.0)':
     dependencies:
       jsep: 1.4.0
@@ -6796,9 +6832,9 @@ snapshots:
       '@stoplight/yaml-ast-parser': 0.0.50
       tslib: 2.8.1
 
-  '@sveltejs/acorn-typescript@1.0.5(acorn@8.14.1)':
+  '@sveltejs/acorn-typescript@1.0.5(acorn@8.15.0)':
     dependencies:
-      acorn: 8.14.1
+      acorn: 8.15.0
 
   '@szmarczak/http-timer@5.0.1':
     dependencies:
@@ -6843,6 +6879,8 @@ snapshots:
 
   '@types/estree@1.0.7': {}
 
+  '@types/estree@1.0.8': {}
+
   '@types/express-serve-static-core@4.19.6':
     dependencies:
       '@types/node': 20.17.32
@@ -7025,7 +7063,7 @@ snapshots:
 
   '@vue/compiler-core@3.5.13':
     dependencies:
-      '@babel/parser': 7.27.2
+      '@babel/parser': 7.28.0
       '@vue/shared': 3.5.13
       entities: 4.5.0
       estree-walker: 2.0.2
@@ -7038,14 +7076,14 @@ snapshots:
 
   '@vue/compiler-sfc@3.5.13':
     dependencies:
-      '@babel/parser': 7.27.2
+      '@babel/parser': 7.28.0
       '@vue/compiler-core': 3.5.13
       '@vue/compiler-dom': 3.5.13
       '@vue/compiler-ssr': 3.5.13
       '@vue/shared': 3.5.13
       estree-walker: 2.0.2
       magic-string: 0.30.17
-      postcss: 8.5.3
+      postcss: 8.5.6
       source-map-js: 1.2.1
 
   '@vue/compiler-ssr@3.5.13':
@@ -7092,6 +7130,8 @@ snapshots:
 
   acorn@8.14.1: {}
 
+  acorn@8.15.0: {}
+
   address@1.2.2: {}
 
   adm-zip@0.5.16: {}
@@ -8141,9 +8181,9 @@ snapshots:
     dependencies:
       estraverse: 5.3.0
 
-  esrap@1.4.6:
+  esrap@1.4.9:
     dependencies:
-      '@jridgewell/sourcemap-codec': 1.5.0
+      '@jridgewell/sourcemap-codec': 1.5.4
 
   esrecurse@4.3.0:
     dependencies:
@@ -8999,7 +9039,7 @@ snapshots:
 
   is-reference@3.0.3:
     dependencies:
-      '@types/estree': 1.0.7
+      '@types/estree': 1.0.8
 
   is-regex@1.2.1:
     dependencies:
@@ -9240,7 +9280,7 @@ snapshots:
 
   magic-string@0.30.17:
     dependencies:
-      '@jridgewell/sourcemap-codec': 1.5.0
+      '@jridgewell/sourcemap-codec': 1.5.4
 
   markdown-extensions@2.0.0: {}
 
@@ -10224,15 +10264,15 @@ snapshots:
 
   possible-typed-array-names@1.1.0: {}
 
-  postcss-load-config@6.0.1(postcss@8.5.3)(tsx@4.19.4)(yaml@2.7.1):
+  postcss-load-config@6.0.1(postcss@8.5.6)(tsx@4.19.4)(yaml@2.7.1):
     dependencies:
       lilconfig: 3.1.3
     optionalDependencies:
-      postcss: 8.5.3
+      postcss: 8.5.6
       tsx: 4.19.4
       yaml: 2.7.1
 
-  postcss@8.5.3:
+  postcss@8.5.6:
     dependencies:
       nanoid: 3.3.11
       picocolors: 1.1.1
@@ -10995,15 +11035,15 @@ snapshots:
   svelte@5.28.2:
     dependencies:
       '@ampproject/remapping': 2.3.0
-      '@jridgewell/sourcemap-codec': 1.5.0
-      '@sveltejs/acorn-typescript': 1.0.5(acorn@8.14.1)
-      '@types/estree': 1.0.7
-      acorn: 8.14.1
+      '@jridgewell/sourcemap-codec': 1.5.4
+      '@sveltejs/acorn-typescript': 1.0.5(acorn@8.15.0)
+      '@types/estree': 1.0.8
+      acorn: 8.15.0
       aria-query: 5.3.2
       axobject-query: 4.1.0
       clsx: 2.1.1
       esm-env: 1.2.2
-      esrap: 1.4.6
+      esrap: 1.4.9
       is-reference: 3.0.3
       locate-character: 3.0.0
       magic-string: 0.30.17
@@ -11119,7 +11159,7 @@ snapshots:
 
   tslib@2.8.1: {}
 
-  tsup@8.4.0(postcss@8.5.3)(tsx@4.19.4)(typescript@5.8.3)(yaml@2.7.1):
+  tsup@8.4.0(postcss@8.5.6)(tsx@4.19.4)(typescript@5.8.3)(yaml@2.7.1):
     dependencies:
       bundle-require: 5.1.0(esbuild@0.25.3)
       cac: 6.7.14
@@ -11129,7 +11169,7 @@ snapshots:
       esbuild: 0.25.3
       joycon: 3.1.1
       picocolors: 1.1.1
-      postcss-load-config: 6.0.1(postcss@8.5.3)(tsx@4.19.4)(yaml@2.7.1)
+      postcss-load-config: 6.0.1(postcss@8.5.6)(tsx@4.19.4)(yaml@2.7.1)
       resolve-from: 5.0.0
       rollup: 4.40.1
       source-map: 0.8.0-beta.0
@@ -11138,7 +11178,7 @@ snapshots:
       tinyglobby: 0.2.13
       tree-kill: 1.2.2
     optionalDependencies:
-      postcss: 8.5.3
+      postcss: 8.5.6
       typescript: 5.8.3
     transitivePeerDependencies:
       - jiti