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

package/dist/cjs/tests/llm-provider.test.js

@@ -0,0 +1,57 @@
+var import_vitest = require("vitest");
+var import_LLMProvider = require("../lib/v3/llm/LLMProvider.js");
+(0, import_vitest.describe)("getAISDKLanguageModel", () => {
+  (0, import_vitest.describe)("ollama provider", () => {
+    (0, import_vitest.it)("works without clientOptions", () => {
+      const model = (0, import_LLMProvider.getAISDKLanguageModel)("ollama", "llama3.2");
+      (0, import_vitest.expect)(model).toBeDefined();
+    });
+    (0, import_vitest.it)("works with empty clientOptions", () => {
+      const model = (0, import_LLMProvider.getAISDKLanguageModel)("ollama", "llama3.2", {});
+      (0, import_vitest.expect)(model).toBeDefined();
+    });
+    (0, import_vitest.it)("works with clientOptions containing only undefined values", () => {
+      const model = (0, import_LLMProvider.getAISDKLanguageModel)("ollama", "llama3.2", {
+        apiKey: void 0
+      });
+      (0, import_vitest.expect)(model).toBeDefined();
+    });
+    (0, import_vitest.it)("works with clientOptions containing only null values", () => {
+      const model = (0, import_LLMProvider.getAISDKLanguageModel)("ollama", "llama3.2", {
+        apiKey: null
+      });
+      (0, import_vitest.expect)(model).toBeDefined();
+    });
+    (0, import_vitest.it)("works with custom baseURL", () => {
+      const model = (0, import_LLMProvider.getAISDKLanguageModel)("ollama", "llama3.2", {
+        baseURL: "http://custom-ollama:11434"
+      });
+      (0, import_vitest.expect)(model).toBeDefined();
+    });
+    (0, import_vitest.it)("works even when apiKey is mistakenly provided", () => {
+      const model = (0, import_LLMProvider.getAISDKLanguageModel)("ollama", "llama3.2", {
+        apiKey: "unnecessary-key"
+      });
+      (0, import_vitest.expect)(model).toBeDefined();
+    });
+  });
+  (0, import_vitest.describe)("providers with API keys", () => {
+    (0, import_vitest.it)("openai requires valid clientOptions for custom configuration", () => {
+      const defaultModel = (0, import_LLMProvider.getAISDKLanguageModel)("openai", "gpt-4o");
+      (0, import_vitest.expect)(defaultModel).toBeDefined();
+      const customModel = (0, import_LLMProvider.getAISDKLanguageModel)("openai", "gpt-4o", {
+        apiKey: "test-key"
+      });
+      (0, import_vitest.expect)(customModel).toBeDefined();
+    });
+  });
+  (0, import_vitest.describe)("hasValidOptions logic", () => {
+    (0, import_vitest.it)("treats undefined apiKey as no options", () => {
+      const model = (0, import_LLMProvider.getAISDKLanguageModel)("ollama", "llama3.2", {
+        apiKey: void 0
+      });
+      (0, import_vitest.expect)(model).toBeDefined();
+    });
+  });
+});
+//# sourceMappingURL=llm-provider.test.js.map

package/dist/cjs/tests/llm-provider.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/llm-provider.test.ts"],
+  "sourcesContent": ["import { describe, expect, it } from \"vitest\";\nimport { getAISDKLanguageModel } from \"../lib/v3/llm/LLMProvider.js\";\n\ndescribe(\"getAISDKLanguageModel\", () => {\n  describe(\"ollama provider\", () => {\n    it(\"works without clientOptions\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\");\n      expect(model).toBeDefined();\n    });\n\n    it(\"works with empty clientOptions\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {});\n      expect(model).toBeDefined();\n    });\n\n    it(\"works with clientOptions containing only undefined values\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        apiKey: undefined,\n      });\n      expect(model).toBeDefined();\n    });\n\n    it(\"works with clientOptions containing only null values\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        apiKey: null as unknown as string,\n      });\n      expect(model).toBeDefined();\n    });\n\n    it(\"works with custom baseURL\", () => {\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        baseURL: \"http://custom-ollama:11434\",\n      });\n      expect(model).toBeDefined();\n    });\n\n    it(\"works even when apiKey is mistakenly provided\", () => {\n      // Ollama doesn't need an API key, but users might set one anyway\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        apiKey: \"unnecessary-key\",\n      });\n      expect(model).toBeDefined();\n    });\n  });\n\n  describe(\"providers with API keys\", () => {\n    it(\"openai requires valid clientOptions for custom configuration\", () => {\n      // Without clientOptions, uses default provider\n      const defaultModel = getAISDKLanguageModel(\"openai\", \"gpt-4o\");\n      expect(defaultModel).toBeDefined();\n\n      // With valid apiKey, uses custom provider\n      const customModel = getAISDKLanguageModel(\"openai\", \"gpt-4o\", {\n        apiKey: \"test-key\",\n      });\n      expect(customModel).toBeDefined();\n    });\n  });\n\n  describe(\"hasValidOptions logic\", () => {\n    it(\"treats undefined apiKey as no options\", () => {\n      // This should use the default provider path (AISDKProviders)\n      // not the custom provider path (AISDKProvidersWithAPIKey)\n      const model = getAISDKLanguageModel(\"ollama\", \"llama3.2\", {\n        apiKey: undefined,\n      });\n      expect(model).toBeDefined();\n    });\n  });\n});\n"],
+  "mappings": "AAAA,oBAAqC;AACrC,yBAAsC;AAAA,IAEtC,wBAAS,yBAAyB,MAAM;AACtC,8BAAS,mBAAmB,MAAM;AAChC,0BAAG,+BAA+B,MAAM;AACtC,YAAM,YAAQ,0CAAsB,UAAU,UAAU;AACxD,gCAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,0BAAG,kCAAkC,MAAM;AACzC,YAAM,YAAQ,0CAAsB,UAAU,YAAY,CAAC,CAAC;AAC5D,gCAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,0BAAG,6DAA6D,MAAM;AACpE,YAAM,YAAQ,0CAAsB,UAAU,YAAY;AAAA,QACxD,QAAQ;AAAA,MACV,CAAC;AACD,gCAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,0BAAG,wDAAwD,MAAM;AAC/D,YAAM,YAAQ,0CAAsB,UAAU,YAAY;AAAA,QACxD,QAAQ;AAAA,MACV,CAAC;AACD,gCAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,0BAAG,6BAA6B,MAAM;AACpC,YAAM,YAAQ,0CAAsB,UAAU,YAAY;AAAA,QACxD,SAAS;AAAA,MACX,CAAC;AACD,gCAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAED,0BAAG,iDAAiD,MAAM;AAExD,YAAM,YAAQ,0CAAsB,UAAU,YAAY;AAAA,QACxD,QAAQ;AAAA,MACV,CAAC;AACD,gCAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAAA,EACH,CAAC;AAED,8BAAS,2BAA2B,MAAM;AACxC,0BAAG,gEAAgE,MAAM;AAEvE,YAAM,mBAAe,0CAAsB,UAAU,QAAQ;AAC7D,gCAAO,YAAY,EAAE,YAAY;AAGjC,YAAM,kBAAc,0CAAsB,UAAU,UAAU;AAAA,QAC5D,QAAQ;AAAA,MACV,CAAC;AACD,gCAAO,WAAW,EAAE,YAAY;AAAA,IAClC,CAAC;AAAA,EACH,CAAC;AAED,8BAAS,yBAAyB,MAAM;AACtC,0BAAG,yCAAyC,MAAM;AAGhD,YAAM,YAAQ,0CAAsB,UAAU,YAAY;AAAA,QACxD,QAAQ;AAAA,MACV,CAAC;AACD,gCAAO,KAAK,EAAE,YAAY;AAAA,IAC5B,CAAC;AAAA,EACH,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/cjs/tests/model-deprecation.test.js

@@ -0,0 +1,132 @@
+var import_vitest = require("vitest");
+var import_LLMProvider = require("../lib/v3/llm/LLMProvider.js");
+var import_sdkErrors = require("../lib/v3/types/public/sdkErrors.js");
+const mockClientOptions = { apiKey: "test-api-key-for-testing" };
+(0, import_vitest.describe)("Model format deprecation", () => {
+  (0, import_vitest.describe)("UnsupportedModelError", () => {
+    (0, import_vitest.it)("includes guidance to use provider/model format for unknown model names", () => {
+      const error = new import_sdkErrors.UnsupportedModelError([
+        "gpt-4o",
+        "claude-3-5-sonnet-latest"
+      ]);
+      (0, import_vitest.expect)(error.message).toContain("provider/model");
+      (0, import_vitest.expect)(error.message).toContain(
+        "https://docs.stagehand.dev/v3/configuration/models"
+      );
+    });
+    (0, import_vitest.it)("includes example of provider/model format", () => {
+      const error = new import_sdkErrors.UnsupportedModelError(["gpt-4o"]);
+      (0, import_vitest.expect)(error.message).toContain("openai/gpt-4o");
+      (0, import_vitest.expect)(error.message).toContain("anthropic/claude-sonnet-4");
+    });
+    (0, import_vitest.it)("works with feature parameter", () => {
+      const error = new import_sdkErrors.UnsupportedModelError(["gpt-4o"], "extract");
+      (0, import_vitest.expect)(error.message).toContain("extract");
+      (0, import_vitest.expect)(error.message).toContain("provider/model");
+      (0, import_vitest.expect)(error.message).toContain(
+        "https://docs.stagehand.dev/v3/configuration/models"
+      );
+    });
+  });
+  (0, import_vitest.describe)("LLMProvider.getClient deprecation warning", () => {
+    (0, import_vitest.it)("logs deprecation warning for legacy model names", () => {
+      const logs = [];
+      const logger = (line) => logs.push(line);
+      const provider = new import_LLMProvider.LLMProvider(logger);
+      const client = provider.getClient("gpt-4o", mockClientOptions);
+      (0, import_vitest.expect)(client).toBeDefined();
+      const deprecationWarning = logs.find(
+        (log) => log.message.toLowerCase().includes("deprecated") || log.message.toLowerCase().includes("deprecation")
+      );
+      (0, import_vitest.expect)(deprecationWarning).toBeDefined();
+      (0, import_vitest.expect)(deprecationWarning.level).toBe(0);
+    });
+    (0, import_vitest.it)("deprecation warning mentions provider/model format", () => {
+      const logs = [];
+      const logger = (line) => logs.push(line);
+      const provider = new import_LLMProvider.LLMProvider(logger);
+      provider.getClient("gpt-4o", mockClientOptions);
+      const deprecationWarning = logs.find(
+        (log) => log.message.toLowerCase().includes("deprecated") || log.message.toLowerCase().includes("deprecation")
+      );
+      (0, import_vitest.expect)(deprecationWarning).toBeDefined();
+      const message = deprecationWarning.message;
+      (0, import_vitest.expect)(message).toContain("provider/model");
+      (0, import_vitest.expect)(message).toContain("openai/gpt-5");
+    });
+    (0, import_vitest.it)("returns OpenAIClient for legacy OpenAI model names", () => {
+      const logs = [];
+      const logger = (line) => logs.push(line);
+      const provider = new import_LLMProvider.LLMProvider(logger);
+      const client = provider.getClient("gpt-4o", mockClientOptions);
+      (0, import_vitest.expect)(client).toBeDefined();
+      (0, import_vitest.expect)(client.constructor.name).toBe("OpenAIClient");
+    });
+    (0, import_vitest.it)("returns AnthropicClient for legacy Anthropic model names", () => {
+      const logs = [];
+      const logger = (line) => logs.push(line);
+      const provider = new import_LLMProvider.LLMProvider(logger);
+      const client = provider.getClient(
+        "claude-3-5-sonnet-latest",
+        mockClientOptions
+      );
+      (0, import_vitest.expect)(client).toBeDefined();
+      (0, import_vitest.expect)(client.constructor.name).toBe("AnthropicClient");
+    });
+  });
+  (0, import_vitest.describe)("LLMProvider.getClient error handling", () => {
+    (0, import_vitest.it)("throws UnsupportedModelError for unknown model without slash", () => {
+      const logs = [];
+      const logger = (line) => logs.push(line);
+      const provider = new import_LLMProvider.LLMProvider(logger);
+      (0, import_vitest.expect)(() => {
+        provider.getClient("some-unknown-model", mockClientOptions);
+      }).toThrow(import_sdkErrors.UnsupportedModelError);
+    });
+    (0, import_vitest.it)("UnsupportedModelError includes provider/model format guidance", () => {
+      const logs = [];
+      const logger = (line) => logs.push(line);
+      const provider = new import_LLMProvider.LLMProvider(logger);
+      try {
+        provider.getClient("some-unknown-model", mockClientOptions);
+      } catch (error) {
+        (0, import_vitest.expect)(error.message).toContain("provider/model");
+      }
+    });
+    (0, import_vitest.it)("throws UnsupportedAISDKModelProviderError for invalid provider in provider/model format", () => {
+      const logs = [];
+      const logger = (line) => logs.push(line);
+      const provider = new import_LLMProvider.LLMProvider(logger);
+      (0, import_vitest.expect)(() => {
+        provider.getClient("invalid-provider/some-model", mockClientOptions);
+      }).toThrow(import_sdkErrors.UnsupportedAISDKModelProviderError);
+    });
+    (0, import_vitest.it)("UnsupportedAISDKModelProviderError lists valid providers", () => {
+      const logs = [];
+      const logger = (line) => logs.push(line);
+      const provider = new import_LLMProvider.LLMProvider(logger);
+      try {
+        provider.getClient("invalid-provider/some-model", mockClientOptions);
+      } catch (error) {
+        const message = error.message;
+        (0, import_vitest.expect)(message).toContain("openai");
+        (0, import_vitest.expect)(message).toContain("anthropic");
+        (0, import_vitest.expect)(message).toContain("google");
+      }
+    });
+  });
+  (0, import_vitest.describe)("new provider/model format", () => {
+    (0, import_vitest.it)("does not log deprecation warning for provider/model format", () => {
+      const logs = [];
+      const logger = (line) => logs.push(line);
+      const provider = new import_LLMProvider.LLMProvider(logger);
+      const client = provider.getClient("openai/gpt-4o", mockClientOptions);
+      (0, import_vitest.expect)(client).toBeDefined();
+      const deprecationWarning = logs.find(
+        (log) => log.message.toLowerCase().includes("deprecated") || log.message.toLowerCase().includes("deprecation")
+      );
+      (0, import_vitest.expect)(deprecationWarning).toBeUndefined();
+    });
+  });
+});
+//# sourceMappingURL=model-deprecation.test.js.map

package/dist/cjs/tests/model-deprecation.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/model-deprecation.test.ts"],
+  "sourcesContent": ["import { describe, expect, it } from \"vitest\";\nimport { LLMProvider } from \"../lib/v3/llm/LLMProvider.js\";\nimport {\n  UnsupportedModelError,\n  UnsupportedAISDKModelProviderError,\n} from \"../lib/v3/types/public/sdkErrors.js\";\nimport type { LogLine } from \"../lib/v3/types/public/logs.js\";\n\n// Mock client options with fake API keys for testing\nconst mockClientOptions = { apiKey: \"test-api-key-for-testing\" };\n\ndescribe(\"Model format deprecation\", () => {\n  describe(\"UnsupportedModelError\", () => {\n    it(\"includes guidance to use provider/model format for unknown model names\", () => {\n      const error = new UnsupportedModelError([\n        \"gpt-4o\",\n        \"claude-3-5-sonnet-latest\",\n      ]);\n\n      // Should mention the new format\n      expect(error.message).toContain(\"provider/model\");\n      // Should include link to docs\n      expect(error.message).toContain(\n        \"https://docs.stagehand.dev/v3/configuration/models\",\n      );\n    });\n\n    it(\"includes example of provider/model format\", () => {\n      const error = new UnsupportedModelError([\"gpt-4o\"]);\n\n      // Should provide examples like openai/gpt-4o\n      expect(error.message).toContain(\"openai/gpt-4o\");\n      expect(error.message).toContain(\"anthropic/claude-sonnet-4\");\n    });\n\n    it(\"works with feature parameter\", () => {\n      const error = new UnsupportedModelError([\"gpt-4o\"], \"extract\");\n\n      expect(error.message).toContain(\"extract\");\n      expect(error.message).toContain(\"provider/model\");\n      expect(error.message).toContain(\n        \"https://docs.stagehand.dev/v3/configuration/models\",\n      );\n    });\n  });\n\n  describe(\"LLMProvider.getClient deprecation warning\", () => {\n    it(\"logs deprecation warning for legacy model names\", () => {\n      const logs: LogLine[] = [];\n      const logger = (line: LogLine) => logs.push(line);\n      const provider = new LLMProvider(logger);\n\n      // Using a legacy model name like \"gpt-4o\" instead of \"openai/gpt-4o\"\n      // Should not throw, but should log a deprecation warning\n      const client = provider.getClient(\"gpt-4o\", mockClientOptions);\n\n      // Should return a client (not throw)\n      expect(client).toBeDefined();\n\n      // Should have logged a deprecation warning at level 0\n      const deprecationWarning = logs.find(\n        (log) =>\n          log.message.toLowerCase().includes(\"deprecated\") ||\n          log.message.toLowerCase().includes(\"deprecation\"),\n      );\n      expect(deprecationWarning).toBeDefined();\n      expect(deprecationWarning!.level).toBe(0);\n    });\n\n    it(\"deprecation warning mentions provider/model format\", () => {\n      const logs: LogLine[] = [];\n      const logger = (line: LogLine) => logs.push(line);\n      const provider = new LLMProvider(logger);\n\n      provider.getClient(\"gpt-4o\", mockClientOptions);\n\n      const deprecationWarning = logs.find(\n        (log) =>\n          log.message.toLowerCase().includes(\"deprecated\") ||\n          log.message.toLowerCase().includes(\"deprecation\"),\n      );\n\n      expect(deprecationWarning).toBeDefined();\n      const message = deprecationWarning!.message;\n      // Should mention the provider/model format\n      expect(message).toContain(\"provider/model\");\n      // Should give an example\n      expect(message).toContain(\"openai/gpt-5\");\n    });\n\n    it(\"returns OpenAIClient for legacy OpenAI model names\", () => {\n      const logs: LogLine[] = [];\n      const logger = (line: LogLine) => logs.push(line);\n      const provider = new LLMProvider(logger);\n\n      const client = provider.getClient(\"gpt-4o\", mockClientOptions);\n\n      // Should return a client\n      expect(client).toBeDefined();\n      // The client should be an OpenAIClient (check constructor name)\n      expect(client.constructor.name).toBe(\"OpenAIClient\");\n    });\n\n    it(\"returns AnthropicClient for legacy Anthropic model names\", () => {\n      const logs: LogLine[] = [];\n      const logger = (line: LogLine) => logs.push(line);\n      const provider = new LLMProvider(logger);\n\n      const client = provider.getClient(\n        \"claude-3-5-sonnet-latest\",\n        mockClientOptions,\n      );\n\n      // Should return a client\n      expect(client).toBeDefined();\n      // The client should be an AnthropicClient\n      expect(client.constructor.name).toBe(\"AnthropicClient\");\n    });\n  });\n\n  describe(\"LLMProvider.getClient error handling\", () => {\n    it(\"throws UnsupportedModelError for unknown model without slash\", () => {\n      const logs: LogLine[] = [];\n      const logger = (line: LogLine) => logs.push(line);\n      const provider = new LLMProvider(logger);\n\n      // Unknown model without slash should throw UnsupportedModelError\n      expect(() => {\n        provider.getClient(\"some-unknown-model\", mockClientOptions);\n      }).toThrow(UnsupportedModelError);\n    });\n\n    it(\"UnsupportedModelError includes provider/model format guidance\", () => {\n      const logs: LogLine[] = [];\n      const logger = (line: LogLine) => logs.push(line);\n      const provider = new LLMProvider(logger);\n\n      try {\n        provider.getClient(\"some-unknown-model\", mockClientOptions);\n      } catch (error) {\n        expect((error as Error).message).toContain(\"provider/model\");\n      }\n    });\n\n    it(\"throws UnsupportedAISDKModelProviderError for invalid provider in provider/model format\", () => {\n      const logs: LogLine[] = [];\n      const logger = (line: LogLine) => logs.push(line);\n      const provider = new LLMProvider(logger);\n\n      // Invalid provider but correct format\n      expect(() => {\n        provider.getClient(\"invalid-provider/some-model\", mockClientOptions);\n      }).toThrow(UnsupportedAISDKModelProviderError);\n    });\n\n    it(\"UnsupportedAISDKModelProviderError lists valid providers\", () => {\n      const logs: LogLine[] = [];\n      const logger = (line: LogLine) => logs.push(line);\n      const provider = new LLMProvider(logger);\n\n      try {\n        provider.getClient(\"invalid-provider/some-model\", mockClientOptions);\n      } catch (error) {\n        const message = (error as Error).message;\n        // Should list valid providers\n        expect(message).toContain(\"openai\");\n        expect(message).toContain(\"anthropic\");\n        expect(message).toContain(\"google\");\n      }\n    });\n  });\n\n  describe(\"new provider/model format\", () => {\n    it(\"does not log deprecation warning for provider/model format\", () => {\n      const logs: LogLine[] = [];\n      const logger = (line: LogLine) => logs.push(line);\n      const provider = new LLMProvider(logger);\n\n      // Using the new format\n      const client = provider.getClient(\"openai/gpt-4o\", mockClientOptions);\n\n      expect(client).toBeDefined();\n\n      // Should NOT have a deprecation warning\n      const deprecationWarning = logs.find(\n        (log) =>\n          log.message.toLowerCase().includes(\"deprecated\") ||\n          log.message.toLowerCase().includes(\"deprecation\"),\n      );\n      expect(deprecationWarning).toBeUndefined();\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/tests/page-snapshot.test.js

@@ -0,0 +1,58 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_vitest = require("vitest");
+var import_fs = require("fs");
+var import_page = require("../lib/v3/understudy/page.js");
+var snapshotModule = __toESM(require("../lib/v3/understudy/a11y/snapshot/index.js"), 1);
+const baseSnapshot = {
+  combinedTree: "tree",
+  combinedXpathMap: {},
+  combinedUrlMap: {},
+  perFrame: []
+};
+(0, import_vitest.describe)("Page.snapshot", () => {
+  (0, import_vitest.afterEach)(() => {
+    import_vitest.vi.restoreAllMocks();
+  });
+  (0, import_vitest.it)("forwards the includeIframes flag to captureHybridSnapshot", async () => {
+    import_vitest.vi.spyOn(import_fs.promises, "writeFile").mockResolvedValue();
+    const captureSpy = import_vitest.vi.spyOn(snapshotModule, "captureHybridSnapshot").mockResolvedValue(baseSnapshot);
+    const fakePage = {};
+    await import_page.Page.prototype.snapshot.call(fakePage, { includeIframes: false });
+    (0, import_vitest.expect)(captureSpy).toHaveBeenCalledWith(fakePage, {
+      pierceShadow: true,
+      includeIframes: false
+    });
+  });
+  (0, import_vitest.it)("falls back to default iframe inclusion when option is omitted", async () => {
+    import_vitest.vi.spyOn(import_fs.promises, "writeFile").mockResolvedValue();
+    const captureSpy = import_vitest.vi.spyOn(snapshotModule, "captureHybridSnapshot").mockResolvedValue(baseSnapshot);
+    const fakePage = {};
+    await import_page.Page.prototype.snapshot.call(fakePage);
+    (0, import_vitest.expect)(captureSpy).toHaveBeenCalledWith(fakePage, {
+      pierceShadow: true,
+      includeIframes: void 0
+    });
+  });
+});
+//# sourceMappingURL=page-snapshot.test.js.map

package/dist/cjs/tests/page-snapshot.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/page-snapshot.test.ts"],
+  "sourcesContent": ["import { afterEach, describe, expect, it, vi } from \"vitest\";\nimport { promises as fs } from \"fs\";\nimport { Page } from \"../lib/v3/understudy/page.js\";\nimport * as snapshotModule from \"../lib/v3/understudy/a11y/snapshot/index.js\";\nimport type { HybridSnapshot } from \"../lib/v3/types/private/index.js\";\n\nconst baseSnapshot: HybridSnapshot = {\n  combinedTree: \"tree\",\n  combinedXpathMap: {},\n  combinedUrlMap: {},\n  perFrame: [],\n};\n\ndescribe(\"Page.snapshot\", () => {\n  afterEach(() => {\n    vi.restoreAllMocks();\n  });\n\n  it(\"forwards the includeIframes flag to captureHybridSnapshot\", async () => {\n    vi.spyOn(fs, \"writeFile\").mockResolvedValue();\n    const captureSpy = vi\n      .spyOn(snapshotModule, \"captureHybridSnapshot\")\n      .mockResolvedValue(baseSnapshot);\n\n    const fakePage = {} as Page;\n    await Page.prototype.snapshot.call(fakePage, { includeIframes: false });\n\n    expect(captureSpy).toHaveBeenCalledWith(fakePage, {\n      pierceShadow: true,\n      includeIframes: false,\n    });\n  });\n\n  it(\"falls back to default iframe inclusion when option is omitted\", async () => {\n    vi.spyOn(fs, \"writeFile\").mockResolvedValue();\n    const captureSpy = vi\n      .spyOn(snapshotModule, \"captureHybridSnapshot\")\n      .mockResolvedValue(baseSnapshot);\n\n    const fakePage = {} as Page;\n    await Page.prototype.snapshot.call(fakePage);\n\n    expect(captureSpy).toHaveBeenCalledWith(fakePage, {\n      pierceShadow: true,\n      includeIframes: undefined,\n    });\n  });\n});\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;AAAA,oBAAoD;AACpD,gBAA+B;AAC/B,kBAAqB;AACrB,qBAAgC;AAGhC,MAAM,eAA+B;AAAA,EACnC,cAAc;AAAA,EACd,kBAAkB,CAAC;AAAA,EACnB,gBAAgB,CAAC;AAAA,EACjB,UAAU,CAAC;AACb;AAAA,IAEA,wBAAS,iBAAiB,MAAM;AAC9B,+BAAU,MAAM;AACd,qBAAG,gBAAgB;AAAA,EACrB,CAAC;AAED,wBAAG,6DAA6D,YAAY;AAC1E,qBAAG,MAAM,UAAAA,UAAI,WAAW,EAAE,kBAAkB;AAC5C,UAAM,aAAa,iBAChB,MAAM,gBAAgB,uBAAuB,EAC7C,kBAAkB,YAAY;AAEjC,UAAM,WAAW,CAAC;AAClB,UAAM,iBAAK,UAAU,SAAS,KAAK,UAAU,EAAE,gBAAgB,MAAM,CAAC;AAEtE,8BAAO,UAAU,EAAE,qBAAqB,UAAU;AAAA,MAChD,cAAc;AAAA,MACd,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH,CAAC;AAED,wBAAG,iEAAiE,YAAY;AAC9E,qBAAG,MAAM,UAAAA,UAAI,WAAW,EAAE,kBAAkB;AAC5C,UAAM,aAAa,iBAChB,MAAM,gBAAgB,uBAAuB,EAC7C,kBAAkB,YAAY;AAEjC,UAAM,WAAW,CAAC;AAClB,UAAM,iBAAK,UAAU,SAAS,KAAK,QAAQ;AAE3C,8BAAO,UAAU,EAAE,qBAAqB,UAAU;AAAA,MAChD,cAAc;AAAA,MACd,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH,CAAC;AACH,CAAC;",
+  "names": ["fs"]
+}

package/dist/cjs/tests/public-api/export-surface.test.js

@@ -0,0 +1,76 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_vitest = require("vitest");
+var Stagehand = __toESM(require("@browserbasehq/stagehand"), 1);
+var import_public_error_types_test = require("./public-error-types.test.js");
+const publicApiShape = {
+  __internalMaybeRunShutdownSupervisorFromArgv: Stagehand.__internalMaybeRunShutdownSupervisorFromArgv,
+  __internalCreateInMemoryAgentCacheHandle: Stagehand.__internalCreateInMemoryAgentCacheHandle,
+  AISdkClient: Stagehand.AISdkClient,
+  Api: Stagehand.Api,
+  AVAILABLE_CUA_MODELS: Stagehand.AVAILABLE_CUA_MODELS,
+  AgentProvider: Stagehand.AgentProvider,
+  AnnotatedScreenshotText: Stagehand.AnnotatedScreenshotText,
+  ConsoleMessage: Stagehand.ConsoleMessage,
+  CustomOpenAIClient: Stagehand.CustomOpenAIClient,
+  LLMClient: Stagehand.LLMClient,
+  LOG_LEVEL_NAMES: Stagehand.LOG_LEVEL_NAMES,
+  Response: Stagehand.Response,
+  Stagehand: Stagehand.Stagehand,
+  V3: Stagehand.V3,
+  V3Evaluator: Stagehand.V3Evaluator,
+  V3FunctionName: Stagehand.V3FunctionName,
+  connectToMCPServer: Stagehand.connectToMCPServer,
+  default: Stagehand.default,
+  defaultExtractSchema: Stagehand.defaultExtractSchema,
+  getAISDKLanguageModel: Stagehand.getAISDKLanguageModel,
+  getZodType: Stagehand.getZodType,
+  injectUrls: Stagehand.injectUrls,
+  isRunningInBun: Stagehand.isRunningInBun,
+  isZod3Schema: Stagehand.isZod3Schema,
+  isZod4Schema: Stagehand.isZod4Schema,
+  jsonSchemaToZod: Stagehand.jsonSchemaToZod,
+  loadApiKeyFromEnv: Stagehand.loadApiKeyFromEnv,
+  localBrowserLaunchOptionsSchema: Stagehand.localBrowserLaunchOptionsSchema,
+  modelToAgentProviderMap: Stagehand.modelToAgentProviderMap,
+  pageTextSchema: Stagehand.pageTextSchema,
+  providerEnvVarMap: Stagehand.providerEnvVarMap,
+  toGeminiSchema: Stagehand.toGeminiSchema,
+  toJsonSchema: Stagehand.toJsonSchema,
+  tool: Stagehand.tool,
+  transformSchema: Stagehand.transformSchema,
+  trimTrailingTextNode: Stagehand.trimTrailingTextNode,
+  validateZodSchema: Stagehand.validateZodSchema,
+  ...import_public_error_types_test.publicErrorTypes
+};
+(0, import_vitest.describe)("Stagehand public API export surface", () => {
+  (0, import_vitest.it)("public API shape matches module exports", () => {
+    const _check = publicApiShape;
+  });
+  (0, import_vitest.it)("does not expose unexpected top-level exports", () => {
+    const expected = Object.keys(publicApiShape).sort();
+    const actual = Object.keys(Stagehand).sort();
+    (0, import_vitest.expect)(actual).toStrictEqual(expected);
+  });
+});
+//# sourceMappingURL=export-surface.test.js.map

package/dist/cjs/tests/public-api/export-surface.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../tests/public-api/export-surface.test.ts"],
+  "sourcesContent": ["import { describe, expect, it } from \"vitest\";\nimport StagehandDefaultExport, * as Stagehand from \"@browserbasehq/stagehand\";\nimport { publicErrorTypes } from \"./public-error-types.test.js\";\n\n// Type matcher guidelines:\n//\n// toEqualTypeOf \u2013 Default. Assert full, deep type equality; any type change should fail.\n//   e.g. expectTypeOf<ReturnType<typeof foo>>().toEqualTypeOf<FooResult>()\n//\n// toMatchObjectType \u2013 Assert (part of) an object's shape while allowing extra fields.\n//   e.g. expectTypeOf(user).toMatchObjectType<{ id: string; email: string }>()\n//\n// toExtend \u2013 Assert that a type is compatible with a broader contract (assignable/extends).\n//   e.g. expectTypeOf<User>().toExtend<BaseUser>()\n\nconst publicApiShape = {\n  __internalMaybeRunShutdownSupervisorFromArgv:\n    Stagehand.__internalMaybeRunShutdownSupervisorFromArgv,\n  __internalCreateInMemoryAgentCacheHandle:\n    Stagehand.__internalCreateInMemoryAgentCacheHandle,\n  AISdkClient: Stagehand.AISdkClient,\n  Api: Stagehand.Api,\n  AVAILABLE_CUA_MODELS: Stagehand.AVAILABLE_CUA_MODELS,\n  AgentProvider: Stagehand.AgentProvider,\n  AnnotatedScreenshotText: Stagehand.AnnotatedScreenshotText,\n  ConsoleMessage: Stagehand.ConsoleMessage,\n  CustomOpenAIClient: Stagehand.CustomOpenAIClient,\n  LLMClient: Stagehand.LLMClient,\n  LOG_LEVEL_NAMES: Stagehand.LOG_LEVEL_NAMES,\n  Response: Stagehand.Response,\n  Stagehand: Stagehand.Stagehand,\n  V3: Stagehand.V3,\n  V3Evaluator: Stagehand.V3Evaluator,\n  V3FunctionName: Stagehand.V3FunctionName,\n  connectToMCPServer: Stagehand.connectToMCPServer,\n  default: StagehandDefaultExport,\n  defaultExtractSchema: Stagehand.defaultExtractSchema,\n  getAISDKLanguageModel: Stagehand.getAISDKLanguageModel,\n  getZodType: Stagehand.getZodType,\n  injectUrls: Stagehand.injectUrls,\n  isRunningInBun: Stagehand.isRunningInBun,\n  isZod3Schema: Stagehand.isZod3Schema,\n  isZod4Schema: Stagehand.isZod4Schema,\n  jsonSchemaToZod: Stagehand.jsonSchemaToZod,\n  loadApiKeyFromEnv: Stagehand.loadApiKeyFromEnv,\n  localBrowserLaunchOptionsSchema: Stagehand.localBrowserLaunchOptionsSchema,\n  modelToAgentProviderMap: Stagehand.modelToAgentProviderMap,\n  pageTextSchema: Stagehand.pageTextSchema,\n  providerEnvVarMap: Stagehand.providerEnvVarMap,\n  toGeminiSchema: Stagehand.toGeminiSchema,\n  toJsonSchema: Stagehand.toJsonSchema,\n  tool: Stagehand.tool,\n  transformSchema: Stagehand.transformSchema,\n  trimTrailingTextNode: Stagehand.trimTrailingTextNode,\n  validateZodSchema: Stagehand.validateZodSchema,\n  ...publicErrorTypes,\n} as const;\n\ntype StagehandExports = typeof Stagehand & {\n  default: typeof StagehandDefaultExport;\n};\n\ntype PublicAPI = {\n  [K in keyof typeof publicApiShape]: StagehandExports[K];\n};\n\ndescribe(\"Stagehand public API export surface\", () => {\n  it(\"public API shape matches module exports\", () => {\n    const _check: PublicAPI = publicApiShape;\n    void _check;\n  });\n\n  it(\"does not expose unexpected top-level exports\", () => {\n    const expected = Object.keys(publicApiShape).sort();\n    const actual = Object.keys(Stagehand).sort();\n    expect(actual).toStrictEqual(expected);\n  });\n});\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;AAAA,oBAAqC;AACrC,gBAAmD;AACnD,qCAAiC;AAajC,MAAM,iBAAiB;AAAA,EACrB,8CACE,UAAU;AAAA,EACZ,0CACE,UAAU;AAAA,EACZ,aAAa,UAAU;AAAA,EACvB,KAAK,UAAU;AAAA,EACf,sBAAsB,UAAU;AAAA,EAChC,eAAe,UAAU;AAAA,EACzB,yBAAyB,UAAU;AAAA,EACnC,gBAAgB,UAAU;AAAA,EAC1B,oBAAoB,UAAU;AAAA,EAC9B,WAAW,UAAU;AAAA,EACrB,iBAAiB,UAAU;AAAA,EAC3B,UAAU,UAAU;AAAA,EACpB,WAAW,UAAU;AAAA,EACrB,IAAI,UAAU;AAAA,EACd,aAAa,UAAU;AAAA,EACvB,gBAAgB,UAAU;AAAA,EAC1B,oBAAoB,UAAU;AAAA,EAC9B,SAAS,UAAAA;AAAA,EACT,sBAAsB,UAAU;AAAA,EAChC,uBAAuB,UAAU;AAAA,EACjC,YAAY,UAAU;AAAA,EACtB,YAAY,UAAU;AAAA,EACtB,gBAAgB,UAAU;AAAA,EAC1B,cAAc,UAAU;AAAA,EACxB,cAAc,UAAU;AAAA,EACxB,iBAAiB,UAAU;AAAA,EAC3B,mBAAmB,UAAU;AAAA,EAC7B,iCAAiC,UAAU;AAAA,EAC3C,yBAAyB,UAAU;AAAA,EACnC,gBAAgB,UAAU;AAAA,EAC1B,mBAAmB,UAAU;AAAA,EAC7B,gBAAgB,UAAU;AAAA,EAC1B,cAAc,UAAU;AAAA,EACxB,MAAM,UAAU;AAAA,EAChB,iBAAiB,UAAU;AAAA,EAC3B,sBAAsB,UAAU;AAAA,EAChC,mBAAmB,UAAU;AAAA,EAC7B,GAAG;AACL;AAAA,IAUA,wBAAS,uCAAuC,MAAM;AACpD,wBAAG,2CAA2C,MAAM;AAClD,UAAM,SAAoB;AAAA,EAE5B,CAAC;AAED,wBAAG,gDAAgD,MAAM;AACvD,UAAM,WAAW,OAAO,KAAK,cAAc,EAAE,KAAK;AAClD,UAAM,SAAS,OAAO,KAAK,SAAS,EAAE,KAAK;AAC3C,8BAAO,MAAM,EAAE,cAAc,QAAQ;AAAA,EACvC,CAAC;AACH,CAAC;",
+  "names": ["StagehandDefaultExport"]
+}

package/dist/cjs/tests/public-api/llm-and-agents.test.js

@@ -0,0 +1,150 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var import_vitest = require("vitest");
+var Stagehand = __toESM(require("@browserbasehq/stagehand"), 1);
+(0, import_vitest.describe)("LLM and Agents public API types", () => {
+  (0, import_vitest.describe)("AISdkClient", () => {
+    (0, import_vitest.it)("is exported", () => {
+      (0, import_vitest.expect)(Stagehand.AISdkClient).toBeDefined();
+    });
+    (0, import_vitest.it)("extends LLMClient", () => {
+      (0, import_vitest.expectTypeOf)().toExtend();
+    });
+    (0, import_vitest.it)("constructor accepts model parameter", () => {
+      (0, import_vitest.expectTypeOf)().toEqualTypeOf();
+    });
+  });
+  (0, import_vitest.describe)("AVAILABLE_CUA_MODELS", () => {
+    const expectedModels = [
+      "openai/computer-use-preview",
+      "openai/computer-use-preview-2025-03-11",
+      "anthropic/claude-3-7-sonnet-latest",
+      "anthropic/claude-opus-4-5-20251101",
+      "anthropic/claude-opus-4-6",
+      "anthropic/claude-haiku-4-5-20251001",
+      "anthropic/claude-sonnet-4-20250514",
+      "anthropic/claude-sonnet-4-5-20250929",
+      "google/gemini-2.5-computer-use-preview-10-2025",
+      "google/gemini-3-flash-preview",
+      "google/gemini-3-pro-preview",
+      "microsoft/fara-7b"
+    ];
+    (0, import_vitest.it)("AvailableCuaModel matches the known literals", () => {
+      (0, import_vitest.expectTypeOf)().toEqualTypeOf();
+    });
+  });
+  (0, import_vitest.describe)("AgentProvider", () => {
+    (0, import_vitest.it)("is exported", () => {
+      (0, import_vitest.expect)(Stagehand.AgentProvider).toBeDefined();
+    });
+    (0, import_vitest.it)("has getClient method", () => {
+      (0, import_vitest.expectTypeOf)().toBeCallableWith(
+        "test-model"
+      );
+    });
+    (0, import_vitest.it)("constructor accepts logger parameter", () => {
+      (0, import_vitest.expectTypeOf)().toEqualTypeOf();
+    });
+  });
+  (0, import_vitest.describe)("AnnotatedScreenshotText", () => {
+    (0, import_vitest.it)("is a string literal", () => {
+      (0, import_vitest.expectTypeOf)().toExtend();
+    });
+  });
+  (0, import_vitest.describe)("ConsoleMessage", () => {
+    (0, import_vitest.it)("has correct public interface shape", () => {
+      (0, import_vitest.expectTypeOf)().toExtend();
+    });
+  });
+  (0, import_vitest.describe)("AgentClient", () => {
+    (0, import_vitest.it)("getClient returns object with expected methods", () => {
+      (0, import_vitest.expectTypeOf)().toExtend();
+    });
+  });
+  (0, import_vitest.describe)("LLMClient", () => {
+    (0, import_vitest.it)("has correct public interface shape", () => {
+      (0, import_vitest.expectTypeOf)().toExtend();
+    });
+    (0, import_vitest.it)("constructor parameters match expected signature", () => {
+      (0, import_vitest.expectTypeOf)().toEqualTypeOf();
+    });
+    (0, import_vitest.it)("createChatCompletion can be called with basic options", () => {
+      (0, import_vitest.expectTypeOf)().toBeCallableWith({
+        options: {
+          messages: [
+            {
+              role: "user",
+              content: "Hello"
+            }
+          ]
+        },
+        logger: () => {
+        }
+      });
+    });
+    (0, import_vitest.it)("createChatCompletion can be called with response_model", () => {
+      const mockSchema = {};
+      (0, import_vitest.expectTypeOf)().toBeCallableWith({
+        options: {
+          messages: [
+            {
+              role: "user",
+              content: "Extract data"
+            }
+          ],
+          response_model: {
+            name: "extracted",
+            schema: mockSchema
+          }
+        },
+        logger: () => {
+        }
+      });
+    });
+    (0, import_vitest.it)("createChatCompletion supports generic return type", () => {
+      (0, import_vitest.expectTypeOf)().toExtend();
+    });
+    (0, import_vitest.it)("has additional methods", () => {
+      (0, import_vitest.expectTypeOf)().toExtend();
+      (0, import_vitest.expectTypeOf)().toExtend();
+      (0, import_vitest.expectTypeOf)().toExtend();
+      (0, import_vitest.expectTypeOf)().toExtend();
+      (0, import_vitest.expectTypeOf)().toExtend();
+      (0, import_vitest.expectTypeOf)().toExtend();
+      (0, import_vitest.expectTypeOf)().toExtend();
+      (0, import_vitest.expectTypeOf)().toExtend();
+      (0, import_vitest.expectTypeOf)().toExtend();
+    });
+  });
+  (0, import_vitest.describe)("modelToAgentProviderMap", () => {
+    (0, import_vitest.it)("only stores valid provider types", () => {
+      (0, import_vitest.expectTypeOf)().toExtend();
+    });
+  });
+  (0, import_vitest.describe)("Response", () => {
+    (0, import_vitest.it)("has correct public interface shape", () => {
+      (0, import_vitest.expectTypeOf)().toExtend();
+    });
+  });
+});
+//# sourceMappingURL=llm-and-agents.test.js.map

package/dist/cjs/tests/public-api/llm-and-agents.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../tests/public-api/llm-and-agents.test.ts"],
+  "sourcesContent": ["import { describe, expect, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\ndescribe(\"LLM and Agents public API types\", () => {\n  describe(\"AISdkClient\", () => {\n    type AISdkClientInstance = InstanceType<typeof Stagehand.AISdkClient>;\n\n    it(\"is exported\", () => {\n      expect(Stagehand.AISdkClient).toBeDefined();\n    });\n\n    it(\"extends LLMClient\", () => {\n      expectTypeOf<AISdkClientInstance>().toExtend<Stagehand.LLMClient>();\n    });\n\n    it(\"constructor accepts model parameter\", () => {\n      // AISdkClient constructor takes { model: LanguageModelV2 }\n      type CtorParams = ConstructorParameters<typeof Stagehand.AISdkClient>;\n      expectTypeOf<CtorParams[\"length\"]>().toEqualTypeOf<1>();\n    });\n  });\n\n  describe(\"AVAILABLE_CUA_MODELS\", () => {\n    const expectedModels = [\n      \"openai/computer-use-preview\",\n      \"openai/computer-use-preview-2025-03-11\",\n      \"anthropic/claude-3-7-sonnet-latest\",\n      \"anthropic/claude-opus-4-5-20251101\",\n      \"anthropic/claude-opus-4-6\",\n      \"anthropic/claude-haiku-4-5-20251001\",\n      \"anthropic/claude-sonnet-4-20250514\",\n      \"anthropic/claude-sonnet-4-5-20250929\",\n      \"google/gemini-2.5-computer-use-preview-10-2025\",\n      \"google/gemini-3-flash-preview\",\n      \"google/gemini-3-pro-preview\",\n      \"microsoft/fara-7b\",\n    ] as const;\n\n    it(\"AvailableCuaModel matches the known literals\", () => {\n      expectTypeOf<Stagehand.AvailableCuaModel>().toEqualTypeOf<\n        (typeof expectedModels)[number]\n      >();\n      void expectedModels; // Mark as used to satisfy ESLint\n    });\n  });\n\n  describe(\"AgentProvider\", () => {\n    type AgentProviderInstance = InstanceType<typeof Stagehand.AgentProvider>;\n\n    it(\"is exported\", () => {\n      expect(Stagehand.AgentProvider).toBeDefined();\n    });\n\n    it(\"has getClient method\", () => {\n      expectTypeOf<AgentProviderInstance[\"getClient\"]>().toBeCallableWith(\n        \"test-model\",\n      );\n    });\n\n    it(\"constructor accepts logger parameter\", () => {\n      expectTypeOf<\n        ConstructorParameters<typeof Stagehand.AgentProvider>\n      >().toEqualTypeOf<[(message: Stagehand.LogLine) => void]>();\n    });\n  });\n\n  describe(\"AnnotatedScreenshotText\", () => {\n    type ExpectedAnnotatedScreenshotText = string;\n\n    it(\"is a string literal\", () => {\n      expectTypeOf<\n        typeof Stagehand.AnnotatedScreenshotText\n      >().toExtend<ExpectedAnnotatedScreenshotText>();\n    });\n  });\n\n  describe(\"ConsoleMessage\", () => {\n    type ExpectedShape = {\n      type: () => string;\n      text: () => string;\n      args: () => unknown[];\n      location: () => {\n        url?: string;\n        lineNumber?: number;\n        columnNumber?: number;\n      };\n      page: () => unknown;\n      timestamp: () => number | undefined;\n      raw: () => unknown;\n      toString: () => string;\n    };\n\n    type ConsoleMessageInstance = InstanceType<typeof Stagehand.ConsoleMessage>;\n\n    it(\"has correct public interface shape\", () => {\n      expectTypeOf<ConsoleMessageInstance>().toExtend<ExpectedShape>();\n    });\n  });\n\n  describe(\"AgentClient\", () => {\n    type AgentProviderInstance = InstanceType<typeof Stagehand.AgentProvider>;\n    type GetClientReturn = ReturnType<AgentProviderInstance[\"getClient\"]>;\n\n    it(\"getClient returns object with expected methods\", () => {\n      type ExpectedShape = {\n        execute: (\n          options: Stagehand.AgentExecutionOptions,\n        ) => Promise<Stagehand.AgentResult>;\n        captureScreenshot: (\n          options?: Record<string, unknown>,\n        ) => Promise<unknown>;\n        setViewport: (width: number, height: number) => void;\n        setCurrentUrl: (url: string) => void;\n        setScreenshotProvider: (provider: () => Promise<string>) => void;\n        setActionHandler: (\n          handler: (action: Stagehand.AgentAction) => Promise<void>,\n        ) => void;\n      };\n      expectTypeOf<GetClientReturn>().toExtend<ExpectedShape>();\n    });\n  });\n\n  describe(\"LLMClient\", () => {\n    type ExpectedShape = {\n      type: \"openai\" | \"anthropic\" | \"cerebras\" | \"groq\" | (string & {});\n      modelName: Stagehand.AvailableModel | (string & {});\n      hasVision: boolean;\n      clientOptions: Stagehand.ClientOptions;\n      userProvidedInstructions?: string;\n    };\n\n    type ExpectedCtorParams = [Stagehand.AvailableModel, string?];\n\n    type ExpectedBasicOptions = {\n      options: {\n        messages: Array<{\n          role: \"system\" | \"user\" | \"assistant\";\n          content: string | Array<unknown>;\n        }>;\n      };\n      logger: (message: unknown) => void;\n      retries?: number;\n    };\n\n    type ExpectedWithResponseModel = ExpectedBasicOptions & {\n      options: ExpectedBasicOptions[\"options\"] & {\n        response_model: {\n          name: string;\n          schema: Stagehand.StagehandZodSchema;\n        };\n      };\n    };\n\n    type LLMClientInstance = InstanceType<typeof Stagehand.LLMClient>;\n\n    it(\"has correct public interface shape\", () => {\n      expectTypeOf<LLMClientInstance>().toExtend<ExpectedShape>();\n    });\n\n    it(\"constructor parameters match expected signature\", () => {\n      expectTypeOf<\n        ConstructorParameters<typeof Stagehand.LLMClient>\n      >().toEqualTypeOf<ExpectedCtorParams>();\n    });\n\n    it(\"createChatCompletion can be called with basic options\", () => {\n      expectTypeOf<\n        LLMClientInstance[\"createChatCompletion\"]\n      >().toBeCallableWith({\n        options: {\n          messages: [\n            {\n              role: \"user\",\n              content: \"Hello\",\n            },\n          ],\n        },\n        logger: () => {},\n      } satisfies ExpectedBasicOptions);\n    });\n\n    it(\"createChatCompletion can be called with response_model\", () => {\n      const mockSchema = {} as Stagehand.StagehandZodSchema;\n      expectTypeOf<\n        LLMClientInstance[\"createChatCompletion\"]\n      >().toBeCallableWith({\n        options: {\n          messages: [\n            {\n              role: \"user\",\n              content: \"Extract data\",\n            },\n          ],\n          response_model: {\n            name: \"extracted\",\n            schema: mockSchema,\n          },\n        },\n        logger: () => {},\n      } satisfies ExpectedWithResponseModel);\n    });\n\n    it(\"createChatCompletion supports generic return type\", () => {\n      type Result = { custom: string };\n      type ExpectedSignature = (\n        options: Stagehand.CreateChatCompletionOptions,\n      ) => Promise<Result>;\n\n      expectTypeOf<\n        LLMClientInstance[\"createChatCompletion\"]\n      >().toExtend<ExpectedSignature>();\n    });\n\n    it(\"has additional methods\", () => {\n      // These methods exist on LLMClient but have complex signatures from the 'ai' library\n      // We verify they exist by checking they're functions\n      expectTypeOf<LLMClientInstance[\"generateText\"]>().toExtend<\n        (...args: unknown[]) => unknown\n      >();\n      expectTypeOf<LLMClientInstance[\"generateObject\"]>().toExtend<\n        (...args: unknown[]) => unknown\n      >();\n      expectTypeOf<LLMClientInstance[\"streamText\"]>().toExtend<\n        (...args: unknown[]) => unknown\n      >();\n      expectTypeOf<LLMClientInstance[\"streamObject\"]>().toExtend<\n        (...args: unknown[]) => unknown\n      >();\n      expectTypeOf<LLMClientInstance[\"generateImage\"]>().toExtend<\n        (...args: unknown[]) => unknown\n      >();\n      expectTypeOf<LLMClientInstance[\"embed\"]>().toExtend<\n        (...args: unknown[]) => unknown\n      >();\n      expectTypeOf<LLMClientInstance[\"embedMany\"]>().toExtend<\n        (...args: unknown[]) => unknown\n      >();\n      expectTypeOf<LLMClientInstance[\"transcribe\"]>().toExtend<\n        (...args: unknown[]) => unknown\n      >();\n      expectTypeOf<LLMClientInstance[\"generateSpeech\"]>().toExtend<\n        (...args: unknown[]) => unknown\n      >();\n    });\n  });\n\n  describe(\"modelToAgentProviderMap\", () => {\n    type ExpectedModelToAgentProviderMap = Record<\n      string,\n      Stagehand.AgentProviderType\n    >;\n\n    it(\"only stores valid provider types\", () => {\n      expectTypeOf<\n        typeof Stagehand.modelToAgentProviderMap\n      >().toExtend<ExpectedModelToAgentProviderMap>();\n    });\n  });\n\n  describe(\"Response\", () => {\n    type ExpectedShape = {\n      url: () => string;\n      status: () => number;\n      statusText: () => string;\n      ok: () => boolean;\n      frame: () => unknown;\n      fromServiceWorker: () => boolean;\n      securityDetails: () => Promise<unknown>;\n      serverAddr: () => Promise<unknown>;\n      headers: () => Record<string, string>;\n      allHeaders: () => Promise<Record<string, string>>;\n      headerValue: (name: string) => Promise<string | null>;\n      headerValues: (name: string) => Promise<string[]>;\n      headersArray: () => Promise<Array<{ name: string; value: string }>>;\n      body: () => Promise<Buffer>;\n      text: () => Promise<string>;\n      json: <T = unknown>() => Promise<T>;\n      finished: () => Promise<null | Error>;\n      markFinished: (error: Error | null) => void;\n      applyExtraInfo: (info: unknown) => void;\n    };\n\n    type ResponseInstance = InstanceType<typeof Stagehand.Response>;\n\n    it(\"has correct public interface shape\", () => {\n      expectTypeOf<ResponseInstance>().toExtend<ExpectedShape>();\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}