@browserbasehq/orca 3.1.0-patch.3 → 3.2.0-middleware.1

package/dist/cjs/tests/unit/page-snapshot.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs_1 = require("fs");
+const page_js_1 = require("../../lib/v3/understudy/page.js");
+const snapshotModule = __importStar(require("../../lib/v3/understudy/a11y/snapshot/index.js"));
+const baseSnapshot = {
+    combinedTree: "tree",
+    combinedXpathMap: {},
+    combinedUrlMap: {},
+    perFrame: [],
+};
+(0, vitest_1.describe)("Page.snapshot", () => {
+    (0, vitest_1.afterEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+    });
+    (0, vitest_1.it)("forwards the includeIframes flag to captureHybridSnapshot", async () => {
+        vitest_1.vi.spyOn(fs_1.promises, "writeFile").mockResolvedValue();
+        const captureSpy = vitest_1.vi
+            .spyOn(snapshotModule, "captureHybridSnapshot")
+            .mockResolvedValue(baseSnapshot);
+        const fakePage = {};
+        await page_js_1.Page.prototype.snapshot.call(fakePage, { includeIframes: false });
+        (0, vitest_1.expect)(captureSpy).toHaveBeenCalledWith(fakePage, {
+            pierceShadow: true,
+            includeIframes: false,
+        });
+    });
+    (0, vitest_1.it)("falls back to default iframe inclusion when option is omitted", async () => {
+        vitest_1.vi.spyOn(fs_1.promises, "writeFile").mockResolvedValue();
+        const captureSpy = vitest_1.vi
+            .spyOn(snapshotModule, "captureHybridSnapshot")
+            .mockResolvedValue(baseSnapshot);
+        const fakePage = {};
+        await page_js_1.Page.prototype.snapshot.call(fakePage);
+        (0, vitest_1.expect)(captureSpy).toHaveBeenCalledWith(fakePage, {
+            pierceShadow: true,
+            includeIframes: undefined,
+        });
+    });
+});
+//# sourceMappingURL=page-snapshot.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page-snapshot.test.js","sourceRoot":"","sources":["../../../../tests/unit/page-snapshot.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAA6D;AAC7D,2BAAoC;AACpC,6DAAuD;AACvD,+FAAiF;AAGjF,MAAM,YAAY,GAAmB;IACnC,YAAY,EAAE,MAAM;IACpB,gBAAgB,EAAE,EAAE;IACpB,cAAc,EAAE,EAAE;IAClB,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,IAAA,iBAAQ,EAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,WAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,WAAE,CAAC,KAAK,CAAC,aAAE,EAAE,WAAW,CAAC,CAAC,iBAAiB,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,WAAE;aAClB,KAAK,CAAC,cAAc,EAAE,uBAAuB,CAAC;aAC9C,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAG,EAAU,CAAC;QAC5B,MAAM,cAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;QAExE,IAAA,eAAM,EAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,QAAQ,EAAE;YAChD,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,KAAK;SACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,WAAE,CAAC,KAAK,CAAC,aAAE,EAAE,WAAW,CAAC,CAAC,iBAAiB,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,WAAE;aAClB,KAAK,CAAC,cAAc,EAAE,uBAAuB,CAAC;aAC9C,iBAAiB,CAAC,YAAY,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAG,EAAU,CAAC;QAC5B,MAAM,cAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE7C,IAAA,eAAM,EAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,QAAQ,EAAE;YAChD,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,SAAS;SAC1B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","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"]}

package/dist/cjs/tests/unit/public-api/export-surface.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,107 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const stagehand_1 = __importStar(require("@browserbasehq/stagehand")), Stagehand = stagehand_1;
+const public_error_types_test_js_1 = require("./public-error-types.test.js");
+// Type matcher guidelines:
+//
+// toEqualTypeOf – Default. Assert full, deep type equality; any type change should fail.
+//   e.g. expectTypeOf<ReturnType<typeof foo>>().toEqualTypeOf<FooResult>()
+//
+// toMatchObjectType – Assert (part of) an object's shape while allowing extra fields.
+//   e.g. expectTypeOf(user).toMatchObjectType<{ id: string; email: string }>()
+//
+// toExtend – Assert that a type is compatible with a broader contract (assignable/extends).
+//   e.g. expectTypeOf<User>().toExtend<BaseUser>()
+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_1.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,
+    ...public_error_types_test_js_1.publicErrorTypes,
+};
+(0, vitest_1.describe)("Stagehand public API export surface", () => {
+    (0, vitest_1.it)("public API shape matches module exports", () => {
+        const _check = publicApiShape;
+        void _check;
+    });
+    (0, vitest_1.it)("does not expose unexpected top-level exports", () => {
+        const expected = Object.keys(publicApiShape).sort();
+        const actual = Object.keys(Stagehand).sort();
+        (0, vitest_1.expect)(actual).toStrictEqual(expected);
+    });
+    (0, vitest_1.it)("default export mirrors the named export surface", () => {
+        const expected = Object.keys(Stagehand)
+            .filter((key) => key !== "default")
+            .sort();
+        const actual = Object.keys(stagehand_1.default).sort();
+        (0, vitest_1.expect)(actual).toStrictEqual(expected);
+    });
+});
+//# sourceMappingURL=export-surface.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"export-surface.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/export-surface.test.ts"],"names":[],"mappings":"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","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 – Default. Assert full, deep type equality; any type change should fail.\n//   e.g. expectTypeOf<ReturnType<typeof foo>>().toEqualTypeOf<FooResult>()\n//\n// toMatchObjectType – Assert (part of) an object's shape while allowing extra fields.\n//   e.g. expectTypeOf(user).toMatchObjectType<{ id: string; email: string }>()\n//\n// toExtend – 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  it(\"default export mirrors the named export surface\", () => {\n    const expected = Object.keys(Stagehand)\n      .filter((key) => key !== \"default\")\n      .sort();\n    const actual = Object.keys(StagehandDefaultExport).sort();\n    expect(actual).toStrictEqual(expected);\n  });\n});\n"]}

package/dist/cjs/tests/unit/public-api/llm-and-agents.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,175 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const Stagehand = __importStar(require("@browserbasehq/stagehand"));
+(0, vitest_1.describe)("LLM and Agents public API types", () => {
+    (0, vitest_1.describe)("ModelConfiguration", () => {
+        (0, vitest_1.it)("accepts Vertex headers in model config", () => {
+            const googleConfig = {
+                modelName: "google/gemini-3-flash-preview",
+                project: "test-project",
+                location: "global",
+                headers: {
+                    "X-Goog-Priority": "high",
+                },
+            };
+            void googleConfig;
+        });
+    });
+    (0, vitest_1.describe)("AISdkClient", () => {
+        (0, vitest_1.it)("is exported", () => {
+            (0, vitest_1.expect)(Stagehand.AISdkClient).toBeDefined();
+        });
+        (0, vitest_1.it)("extends LLMClient", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+        (0, vitest_1.it)("constructor accepts model parameter", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("AVAILABLE_CUA_MODELS", () => {
+        const expectedModels = [
+            "openai/computer-use-preview",
+            "openai/computer-use-preview-2025-03-11",
+            "anthropic/claude-opus-4-5-20251101",
+            "anthropic/claude-opus-4-6",
+            "anthropic/claude-sonnet-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, vitest_1.it)("AvailableCuaModel matches the known literals", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+            void expectedModels; // Mark as used to satisfy ESLint
+        });
+    });
+    (0, vitest_1.describe)("AgentProvider", () => {
+        (0, vitest_1.it)("is exported", () => {
+            (0, vitest_1.expect)(Stagehand.AgentProvider).toBeDefined();
+        });
+        (0, vitest_1.it)("has getClient method", () => {
+            (0, vitest_1.expectTypeOf)().toBeCallableWith("test-model");
+        });
+        (0, vitest_1.it)("constructor accepts logger parameter", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("AnnotatedScreenshotText", () => {
+        (0, vitest_1.it)("is a string literal", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+    (0, vitest_1.describe)("ConsoleMessage", () => {
+        (0, vitest_1.it)("has correct public interface shape", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+    (0, vitest_1.describe)("AgentClient", () => {
+        (0, vitest_1.it)("getClient returns object with expected methods", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+    (0, vitest_1.describe)("LLMClient", () => {
+        (0, vitest_1.it)("has correct public interface shape", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+        (0, vitest_1.it)("constructor parameters match expected signature", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+        (0, vitest_1.it)("createChatCompletion can be called with basic options", () => {
+            (0, vitest_1.expectTypeOf)().toBeCallableWith({
+                options: {
+                    messages: [
+                        {
+                            role: "user",
+                            content: "Hello",
+                        },
+                    ],
+                },
+                logger: () => { },
+            });
+        });
+        (0, vitest_1.it)("createChatCompletion can be called with response_model", () => {
+            const mockSchema = {};
+            (0, vitest_1.expectTypeOf)().toBeCallableWith({
+                options: {
+                    messages: [
+                        {
+                            role: "user",
+                            content: "Extract data",
+                        },
+                    ],
+                    response_model: {
+                        name: "extracted",
+                        schema: mockSchema,
+                    },
+                },
+                logger: () => { },
+            });
+        });
+        (0, vitest_1.it)("createChatCompletion supports generic return type", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+        (0, vitest_1.it)("has additional methods", () => {
+            // These methods exist on LLMClient but have complex signatures from the 'ai' library
+            // We verify they exist by checking they're functions
+            (0, vitest_1.expectTypeOf)().toExtend();
+            (0, vitest_1.expectTypeOf)().toExtend();
+            (0, vitest_1.expectTypeOf)().toExtend();
+            (0, vitest_1.expectTypeOf)().toExtend();
+            (0, vitest_1.expectTypeOf)().toExtend();
+            (0, vitest_1.expectTypeOf)().toExtend();
+            (0, vitest_1.expectTypeOf)().toExtend();
+            (0, vitest_1.expectTypeOf)().toExtend();
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+    (0, vitest_1.describe)("modelToAgentProviderMap", () => {
+        (0, vitest_1.it)("only stores valid provider types", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+    (0, vitest_1.describe)("Response", () => {
+        (0, vitest_1.it)("has correct public interface shape", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+});
+//# sourceMappingURL=llm-and-agents.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm-and-agents.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/llm-and-agents.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\ndescribe(\"LLM and Agents public API types\", () => {\n  describe(\"ModelConfiguration\", () => {\n    it(\"accepts Vertex headers in model config\", () => {\n      const googleConfig = {\n        modelName: \"google/gemini-3-flash-preview\",\n        project: \"test-project\",\n        location: \"global\",\n        headers: {\n          \"X-Goog-Priority\": \"high\",\n        },\n      } satisfies Stagehand.ModelConfiguration;\n\n      void googleConfig;\n    });\n  });\n\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-opus-4-5-20251101\",\n      \"anthropic/claude-opus-4-6\",\n      \"anthropic/claude-sonnet-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"]}

package/dist/cjs/tests/unit/public-api/public-error-types.test.d.ts

@@ -0,0 +1,62 @@
+import * as Stagehand from "@browserbasehq/stagehand";
+export declare const publicErrorTypes: {
+    readonly AgentAbortError: typeof Stagehand.AgentAbortError;
+    readonly CdpConnectionClosedError: typeof Stagehand.CdpConnectionClosedError;
+    readonly AgentScreenshotProviderError: typeof Stagehand.AgentScreenshotProviderError;
+    readonly BrowserbaseSessionNotFoundError: typeof Stagehand.BrowserbaseSessionNotFoundError;
+    readonly CaptchaTimeoutError: typeof Stagehand.CaptchaTimeoutError;
+    readonly ConnectionTimeoutError: typeof Stagehand.ConnectionTimeoutError;
+    readonly ContentFrameNotFoundError: typeof Stagehand.ContentFrameNotFoundError;
+    readonly CookieSetError: typeof Stagehand.CookieSetError;
+    readonly CookieValidationError: typeof Stagehand.CookieValidationError;
+    readonly CreateChatCompletionResponseError: typeof Stagehand.CreateChatCompletionResponseError;
+    readonly CuaModelRequiredError: typeof Stagehand.CuaModelRequiredError;
+    readonly ElementNotVisibleError: typeof Stagehand.ElementNotVisibleError;
+    readonly ExperimentalApiConflictError: typeof Stagehand.ExperimentalApiConflictError;
+    readonly ExperimentalNotConfiguredError: typeof Stagehand.ExperimentalNotConfiguredError;
+    readonly HandlerNotInitializedError: typeof Stagehand.HandlerNotInitializedError;
+    readonly InvalidAISDKModelFormatError: typeof Stagehand.InvalidAISDKModelFormatError;
+    readonly LLMResponseError: typeof Stagehand.LLMResponseError;
+    readonly MCPConnectionError: typeof Stagehand.MCPConnectionError;
+    readonly MissingEnvironmentVariableError: typeof Stagehand.MissingEnvironmentVariableError;
+    readonly MissingLLMConfigurationError: typeof Stagehand.MissingLLMConfigurationError;
+    readonly PageNotFoundError: typeof Stagehand.PageNotFoundError;
+    readonly ResponseBodyError: typeof Stagehand.ResponseBodyError;
+    readonly ResponseParseError: typeof Stagehand.ResponseParseError;
+    readonly StagehandAPIError: typeof Stagehand.StagehandAPIError;
+    readonly StagehandAPIUnauthorizedError: typeof Stagehand.StagehandAPIUnauthorizedError;
+    readonly StagehandClickError: typeof Stagehand.StagehandClickError;
+    readonly StagehandClosedError: typeof Stagehand.StagehandClosedError;
+    readonly StagehandDefaultError: typeof Stagehand.StagehandDefaultError;
+    readonly StagehandDomProcessError: typeof Stagehand.StagehandDomProcessError;
+    readonly StagehandElementNotFoundError: typeof Stagehand.StagehandElementNotFoundError;
+    readonly StagehandEnvironmentError: typeof Stagehand.StagehandEnvironmentError;
+    readonly StagehandError: typeof Stagehand.StagehandError;
+    readonly StagehandEvalError: typeof Stagehand.StagehandEvalError;
+    readonly StagehandHttpError: typeof Stagehand.StagehandHttpError;
+    readonly StagehandIframeError: typeof Stagehand.StagehandIframeError;
+    readonly StagehandInitError: typeof Stagehand.StagehandInitError;
+    readonly StagehandInvalidArgumentError: typeof Stagehand.StagehandInvalidArgumentError;
+    readonly StagehandLocatorError: typeof Stagehand.StagehandLocatorError;
+    readonly StagehandMissingArgumentError: typeof Stagehand.StagehandMissingArgumentError;
+    readonly StagehandNotInitializedError: typeof Stagehand.StagehandNotInitializedError;
+    readonly StagehandResponseBodyError: typeof Stagehand.StagehandResponseBodyError;
+    readonly StagehandResponseParseError: typeof Stagehand.StagehandResponseParseError;
+    readonly StagehandServerError: typeof Stagehand.StagehandServerError;
+    readonly StagehandShadowRootMissingError: typeof Stagehand.StagehandShadowRootMissingError;
+    readonly StagehandShadowSegmentEmptyError: typeof Stagehand.StagehandShadowSegmentEmptyError;
+    readonly StagehandShadowSegmentNotFoundError: typeof Stagehand.StagehandShadowSegmentNotFoundError;
+    readonly StreamingCallbacksInNonStreamingModeError: typeof Stagehand.StreamingCallbacksInNonStreamingModeError;
+    readonly StagehandSnapshotError: typeof Stagehand.StagehandSnapshotError;
+    readonly TimeoutError: typeof Stagehand.TimeoutError;
+    readonly UnsupportedAISDKModelProviderError: typeof Stagehand.UnsupportedAISDKModelProviderError;
+    readonly UnsupportedModelError: typeof Stagehand.UnsupportedModelError;
+    readonly UnsupportedModelProviderError: typeof Stagehand.UnsupportedModelProviderError;
+    readonly XPathResolutionError: typeof Stagehand.XPathResolutionError;
+    readonly ZodSchemaValidationError: typeof Stagehand.ZodSchemaValidationError;
+    readonly ActTimeoutError: typeof Stagehand.ActTimeoutError;
+    readonly ObserveTimeoutError: typeof Stagehand.ObserveTimeoutError;
+    readonly ExtractTimeoutError: typeof Stagehand.ExtractTimeoutError;
+    readonly UnderstudyCommandException: typeof Stagehand.UnderstudyCommandException;
+    readonly StagehandSetExtraHTTPHeadersError: typeof Stagehand.StagehandSetExtraHTTPHeadersError;
+};

package/dist/cjs/tests/unit/public-api/public-error-types.test.js

@@ -0,0 +1,110 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publicErrorTypes = void 0;
+const vitest_1 = require("vitest");
+const Stagehand = __importStar(require("@browserbasehq/stagehand"));
+exports.publicErrorTypes = {
+    AgentAbortError: Stagehand.AgentAbortError,
+    CdpConnectionClosedError: Stagehand.CdpConnectionClosedError,
+    AgentScreenshotProviderError: Stagehand.AgentScreenshotProviderError,
+    BrowserbaseSessionNotFoundError: Stagehand.BrowserbaseSessionNotFoundError,
+    CaptchaTimeoutError: Stagehand.CaptchaTimeoutError,
+    ConnectionTimeoutError: Stagehand.ConnectionTimeoutError,
+    ContentFrameNotFoundError: Stagehand.ContentFrameNotFoundError,
+    CookieSetError: Stagehand.CookieSetError,
+    CookieValidationError: Stagehand.CookieValidationError,
+    CreateChatCompletionResponseError: Stagehand.CreateChatCompletionResponseError,
+    CuaModelRequiredError: Stagehand.CuaModelRequiredError,
+    ElementNotVisibleError: Stagehand.ElementNotVisibleError,
+    ExperimentalApiConflictError: Stagehand.ExperimentalApiConflictError,
+    ExperimentalNotConfiguredError: Stagehand.ExperimentalNotConfiguredError,
+    HandlerNotInitializedError: Stagehand.HandlerNotInitializedError,
+    InvalidAISDKModelFormatError: Stagehand.InvalidAISDKModelFormatError,
+    LLMResponseError: Stagehand.LLMResponseError,
+    MCPConnectionError: Stagehand.MCPConnectionError,
+    MissingEnvironmentVariableError: Stagehand.MissingEnvironmentVariableError,
+    MissingLLMConfigurationError: Stagehand.MissingLLMConfigurationError,
+    PageNotFoundError: Stagehand.PageNotFoundError,
+    ResponseBodyError: Stagehand.ResponseBodyError,
+    ResponseParseError: Stagehand.ResponseParseError,
+    StagehandAPIError: Stagehand.StagehandAPIError,
+    StagehandAPIUnauthorizedError: Stagehand.StagehandAPIUnauthorizedError,
+    StagehandClickError: Stagehand.StagehandClickError,
+    StagehandClosedError: Stagehand.StagehandClosedError,
+    StagehandDefaultError: Stagehand.StagehandDefaultError,
+    StagehandDomProcessError: Stagehand.StagehandDomProcessError,
+    StagehandElementNotFoundError: Stagehand.StagehandElementNotFoundError,
+    StagehandEnvironmentError: Stagehand.StagehandEnvironmentError,
+    StagehandError: Stagehand.StagehandError,
+    StagehandEvalError: Stagehand.StagehandEvalError,
+    StagehandHttpError: Stagehand.StagehandHttpError,
+    StagehandIframeError: Stagehand.StagehandIframeError,
+    StagehandInitError: Stagehand.StagehandInitError,
+    StagehandInvalidArgumentError: Stagehand.StagehandInvalidArgumentError,
+    StagehandLocatorError: Stagehand.StagehandLocatorError,
+    StagehandMissingArgumentError: Stagehand.StagehandMissingArgumentError,
+    StagehandNotInitializedError: Stagehand.StagehandNotInitializedError,
+    StagehandResponseBodyError: Stagehand.StagehandResponseBodyError,
+    StagehandResponseParseError: Stagehand.StagehandResponseParseError,
+    StagehandServerError: Stagehand.StagehandServerError,
+    StagehandShadowRootMissingError: Stagehand.StagehandShadowRootMissingError,
+    StagehandShadowSegmentEmptyError: Stagehand.StagehandShadowSegmentEmptyError,
+    StagehandShadowSegmentNotFoundError: Stagehand.StagehandShadowSegmentNotFoundError,
+    StreamingCallbacksInNonStreamingModeError: Stagehand.StreamingCallbacksInNonStreamingModeError,
+    StagehandSnapshotError: Stagehand.StagehandSnapshotError,
+    TimeoutError: Stagehand.TimeoutError,
+    UnsupportedAISDKModelProviderError: Stagehand.UnsupportedAISDKModelProviderError,
+    UnsupportedModelError: Stagehand.UnsupportedModelError,
+    UnsupportedModelProviderError: Stagehand.UnsupportedModelProviderError,
+    XPathResolutionError: Stagehand.XPathResolutionError,
+    ZodSchemaValidationError: Stagehand.ZodSchemaValidationError,
+    ActTimeoutError: Stagehand.ActTimeoutError,
+    ObserveTimeoutError: Stagehand.ObserveTimeoutError,
+    ExtractTimeoutError: Stagehand.ExtractTimeoutError,
+    UnderstudyCommandException: Stagehand.UnderstudyCommandException,
+    StagehandSetExtraHTTPHeadersError: Stagehand.StagehandSetExtraHTTPHeadersError,
+};
+const errorTypes = Object.keys(exports.publicErrorTypes);
+(0, vitest_1.describe)("Stagehand public error types", () => {
+    (0, vitest_1.describe)("errors", () => {
+        vitest_1.it.each(errorTypes)("%s extends Error", (errorTypeName) => {
+            const ErrorClass = Stagehand[errorTypeName];
+            (0, vitest_1.expectTypeOf)().toExtend();
+            void ErrorClass; // Mark as used to satisfy ESLint
+        });
+    });
+});
+//# sourceMappingURL=public-error-types.test.js.map

package/dist/cjs/tests/unit/public-api/public-error-types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-error-types.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/public-error-types.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\nexport const publicErrorTypes = {\n  AgentAbortError: Stagehand.AgentAbortError,\n  CdpConnectionClosedError: Stagehand.CdpConnectionClosedError,\n  AgentScreenshotProviderError: Stagehand.AgentScreenshotProviderError,\n  BrowserbaseSessionNotFoundError: Stagehand.BrowserbaseSessionNotFoundError,\n  CaptchaTimeoutError: Stagehand.CaptchaTimeoutError,\n  ConnectionTimeoutError: Stagehand.ConnectionTimeoutError,\n  ContentFrameNotFoundError: Stagehand.ContentFrameNotFoundError,\n  CookieSetError: Stagehand.CookieSetError,\n  CookieValidationError: Stagehand.CookieValidationError,\n  CreateChatCompletionResponseError:\n    Stagehand.CreateChatCompletionResponseError,\n  CuaModelRequiredError: Stagehand.CuaModelRequiredError,\n  ElementNotVisibleError: Stagehand.ElementNotVisibleError,\n  ExperimentalApiConflictError: Stagehand.ExperimentalApiConflictError,\n  ExperimentalNotConfiguredError: Stagehand.ExperimentalNotConfiguredError,\n  HandlerNotInitializedError: Stagehand.HandlerNotInitializedError,\n  InvalidAISDKModelFormatError: Stagehand.InvalidAISDKModelFormatError,\n  LLMResponseError: Stagehand.LLMResponseError,\n  MCPConnectionError: Stagehand.MCPConnectionError,\n  MissingEnvironmentVariableError: Stagehand.MissingEnvironmentVariableError,\n  MissingLLMConfigurationError: Stagehand.MissingLLMConfigurationError,\n  PageNotFoundError: Stagehand.PageNotFoundError,\n  ResponseBodyError: Stagehand.ResponseBodyError,\n  ResponseParseError: Stagehand.ResponseParseError,\n  StagehandAPIError: Stagehand.StagehandAPIError,\n  StagehandAPIUnauthorizedError: Stagehand.StagehandAPIUnauthorizedError,\n  StagehandClickError: Stagehand.StagehandClickError,\n  StagehandClosedError: Stagehand.StagehandClosedError,\n  StagehandDefaultError: Stagehand.StagehandDefaultError,\n  StagehandDomProcessError: Stagehand.StagehandDomProcessError,\n  StagehandElementNotFoundError: Stagehand.StagehandElementNotFoundError,\n  StagehandEnvironmentError: Stagehand.StagehandEnvironmentError,\n  StagehandError: Stagehand.StagehandError,\n  StagehandEvalError: Stagehand.StagehandEvalError,\n  StagehandHttpError: Stagehand.StagehandHttpError,\n  StagehandIframeError: Stagehand.StagehandIframeError,\n  StagehandInitError: Stagehand.StagehandInitError,\n  StagehandInvalidArgumentError: Stagehand.StagehandInvalidArgumentError,\n  StagehandLocatorError: Stagehand.StagehandLocatorError,\n  StagehandMissingArgumentError: Stagehand.StagehandMissingArgumentError,\n  StagehandNotInitializedError: Stagehand.StagehandNotInitializedError,\n  StagehandResponseBodyError: Stagehand.StagehandResponseBodyError,\n  StagehandResponseParseError: Stagehand.StagehandResponseParseError,\n  StagehandServerError: Stagehand.StagehandServerError,\n  StagehandShadowRootMissingError: Stagehand.StagehandShadowRootMissingError,\n  StagehandShadowSegmentEmptyError: Stagehand.StagehandShadowSegmentEmptyError,\n  StagehandShadowSegmentNotFoundError:\n    Stagehand.StagehandShadowSegmentNotFoundError,\n  StreamingCallbacksInNonStreamingModeError:\n    Stagehand.StreamingCallbacksInNonStreamingModeError,\n  StagehandSnapshotError: Stagehand.StagehandSnapshotError,\n  TimeoutError: Stagehand.TimeoutError,\n  UnsupportedAISDKModelProviderError:\n    Stagehand.UnsupportedAISDKModelProviderError,\n  UnsupportedModelError: Stagehand.UnsupportedModelError,\n  UnsupportedModelProviderError: Stagehand.UnsupportedModelProviderError,\n  XPathResolutionError: Stagehand.XPathResolutionError,\n  ZodSchemaValidationError: Stagehand.ZodSchemaValidationError,\n  ActTimeoutError: Stagehand.ActTimeoutError,\n  ObserveTimeoutError: Stagehand.ObserveTimeoutError,\n  ExtractTimeoutError: Stagehand.ExtractTimeoutError,\n  UnderstudyCommandException: Stagehand.UnderstudyCommandException,\n  StagehandSetExtraHTTPHeadersError:\n    Stagehand.StagehandSetExtraHTTPHeadersError,\n} as const;\n\nconst errorTypes = Object.keys(publicErrorTypes) as Array<\n  keyof typeof publicErrorTypes\n>;\n\ndescribe(\"Stagehand public error types\", () => {\n  describe(\"errors\", () => {\n    it.each(errorTypes)(\"%s extends Error\", (errorTypeName) => {\n      const ErrorClass = Stagehand[errorTypeName];\n      type ErrorClassType = typeof ErrorClass;\n      expectTypeOf<InstanceType<ErrorClassType>>().toExtend<Error>();\n      void ErrorClass; // Mark as used to satisfy ESLint\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/public-api/public-types.test.d.ts

@@ -0,0 +1 @@
+export {};