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

package/dist/cjs/tests/unit/page-extra-http-headers.test.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const page_js_1 = require("../../lib/v3/understudy/page.js");
+const mockCDPSession_js_1 = require("./helpers/mockCDPSession.js");
+const sdkErrors_js_1 = require("../../lib/v3/types/public/sdkErrors.js");
+const makePage = (sessions) => {
+    const mainSession = sessions[0] ?? new mockCDPSession_js_1.MockCDPSession({}, "main");
+    const stub = {
+        mainSession,
+        sessions: new Map(sessions.map((s) => [s.id, s])),
+        extraHTTPHeaders: {},
+        // Bind the private helper from Page.prototype so setExtraHTTPHeaders can call it
+        applyExtraHTTPHeadersToSession: page_js_1.Page.prototype
+            .applyExtraHTTPHeadersToSession,
+    };
+    return stub;
+};
+(0, vitest_1.describe)("Page.setExtraHTTPHeaders", () => {
+    const setExtraHTTPHeaders = page_js_1.Page.prototype.setExtraHTTPHeaders;
+    (0, vitest_1.it)("sends headers to all sessions owned by the page", async () => {
+        const sessionA = new mockCDPSession_js_1.MockCDPSession({}, "session-a");
+        const sessionB = new mockCDPSession_js_1.MockCDPSession({}, "session-b");
+        const page = makePage([sessionA, sessionB]);
+        await setExtraHTTPHeaders.call(page, {
+            "x-stagehand-test": "hello",
+        });
+        for (const session of [sessionA, sessionB]) {
+            (0, vitest_1.expect)(session.callsFor("Network.enable").length).toBe(1);
+            (0, vitest_1.expect)(session.callsFor("Network.setExtraHTTPHeaders")[0]?.params).toEqual({
+                headers: { "x-stagehand-test": "hello" },
+            });
+        }
+    });
+    (0, vitest_1.it)("applies headers to mainSession even when sessions map is empty", async () => {
+        const page = makePage([]);
+        await setExtraHTTPHeaders.call(page, { "x-test": "value" });
+        // mainSession should still receive headers even though it's not in the sessions map
+        (0, vitest_1.expect)(page.mainSession.callsFor("Network.enable").length).toBe(1);
+        (0, vitest_1.expect)(page.mainSession.callsFor("Network.setExtraHTTPHeaders")[0]?.params).toEqual({
+            headers: { "x-test": "value" },
+        });
+    });
+    (0, vitest_1.it)("throws StagehandSetExtraHTTPHeadersError with session failure details", async () => {
+        const sessionA = new mockCDPSession_js_1.MockCDPSession({
+            "Network.setExtraHTTPHeaders": () => {
+                throw new Error("connection closed");
+            },
+        }, "session-a");
+        const sessionB = new mockCDPSession_js_1.MockCDPSession({}, "session-b");
+        const page = makePage([sessionA, sessionB]);
+        let caughtError;
+        try {
+            await setExtraHTTPHeaders.call(page, {
+                "x-stagehand-test": "yes",
+            });
+        }
+        catch (error) {
+            caughtError = error;
+        }
+        (0, vitest_1.expect)(caughtError).toBeInstanceOf(sdkErrors_js_1.StagehandSetExtraHTTPHeadersError);
+        (0, vitest_1.expect)(caughtError?.failures).toHaveLength(1);
+        (0, vitest_1.expect)(caughtError?.failures[0]).toContain("session=session-a");
+        (0, vitest_1.expect)(caughtError?.failures[0]).toContain("connection closed");
+        // sessionB should still have been called successfully
+        (0, vitest_1.expect)(sessionB.callsFor("Network.setExtraHTTPHeaders").length).toBe(1);
+    });
+    (0, vitest_1.it)("applies headers to sessions adopted after the call", async () => {
+        const sessionA = new mockCDPSession_js_1.MockCDPSession({}, "session-a");
+        const page = makePage([sessionA]);
+        await setExtraHTTPHeaders.call(page, { "x-before": "yes" });
+        // A new OOPIF session is adopted after headers were set
+        const sessionB = new mockCDPSession_js_1.MockCDPSession({}, "session-b");
+        page.sessions.set(sessionB.id, sessionB);
+        // Simulate what adoptOopifSession does: replay headers onto the new session
+        await page.applyExtraHTTPHeadersToSession.call(page, sessionB, page.extraHTTPHeaders);
+        // The late-arriving session should have received the headers
+        (0, vitest_1.expect)(sessionB.callsFor("Network.enable").length).toBe(1);
+        (0, vitest_1.expect)(sessionB.callsFor("Network.setExtraHTTPHeaders")[0]?.params).toEqual({
+            headers: { "x-before": "yes" },
+        });
+    });
+    (0, vitest_1.it)("does not mutate the original headers object", async () => {
+        const session = new mockCDPSession_js_1.MockCDPSession({}, "session-a");
+        const page = makePage([session]);
+        const original = { "x-custom": "value" };
+        const frozen = { ...original };
+        await setExtraHTTPHeaders.call(page, original);
+        (0, vitest_1.expect)(original).toEqual(frozen);
+    });
+});
+//# sourceMappingURL=page-extra-http-headers.test.js.map

package/dist/cjs/tests/unit/page-extra-http-headers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-extra-http-headers.test.js","sourceRoot":"","sources":["../../../../tests/unit/page-extra-http-headers.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { Page } from \"../../lib/v3/understudy/page.js\";\nimport { MockCDPSession } from \"./helpers/mockCDPSession.js\";\nimport { StagehandSetExtraHTTPHeadersError } from \"../../lib/v3/types/public/sdkErrors.js\";\n\ntype PageStub = {\n  mainSession: MockCDPSession;\n  sessions: Map<string, MockCDPSession>;\n  extraHTTPHeaders: Record<string, string>;\n  applyExtraHTTPHeadersToSession: (\n    session: MockCDPSession,\n    headers: Record<string, string>,\n  ) => Promise<void>;\n};\n\nconst makePage = (sessions: MockCDPSession[]): PageStub => {\n  const mainSession = sessions[0] ?? new MockCDPSession({}, \"main\");\n  const stub: PageStub = {\n    mainSession,\n    sessions: new Map(sessions.map((s) => [s.id, s])),\n    extraHTTPHeaders: {},\n    // Bind the private helper from Page.prototype so setExtraHTTPHeaders can call it\n    applyExtraHTTPHeadersToSession: (Page.prototype as unknown as PageStub)\n      .applyExtraHTTPHeadersToSession,\n  };\n  return stub;\n};\n\ndescribe(\"Page.setExtraHTTPHeaders\", () => {\n  const setExtraHTTPHeaders = Page.prototype.setExtraHTTPHeaders as (\n    this: PageStub,\n    headers: Record<string, string>,\n  ) => Promise<void>;\n\n  it(\"sends headers to all sessions owned by the page\", async () => {\n    const sessionA = new MockCDPSession({}, \"session-a\");\n    const sessionB = new MockCDPSession({}, \"session-b\");\n    const page = makePage([sessionA, sessionB]);\n\n    await setExtraHTTPHeaders.call(page, {\n      \"x-stagehand-test\": \"hello\",\n    });\n\n    for (const session of [sessionA, sessionB]) {\n      expect(session.callsFor(\"Network.enable\").length).toBe(1);\n      expect(\n        session.callsFor(\"Network.setExtraHTTPHeaders\")[0]?.params,\n      ).toEqual({\n        headers: { \"x-stagehand-test\": \"hello\" },\n      });\n    }\n  });\n\n  it(\"applies headers to mainSession even when sessions map is empty\", async () => {\n    const page = makePage([]);\n\n    await setExtraHTTPHeaders.call(page, { \"x-test\": \"value\" });\n\n    // mainSession should still receive headers even though it's not in the sessions map\n    expect(page.mainSession.callsFor(\"Network.enable\").length).toBe(1);\n    expect(\n      page.mainSession.callsFor(\"Network.setExtraHTTPHeaders\")[0]?.params,\n    ).toEqual({\n      headers: { \"x-test\": \"value\" },\n    });\n  });\n\n  it(\"throws StagehandSetExtraHTTPHeadersError with session failure details\", async () => {\n    const sessionA = new MockCDPSession(\n      {\n        \"Network.setExtraHTTPHeaders\": () => {\n          throw new Error(\"connection closed\");\n        },\n      },\n      \"session-a\",\n    );\n    const sessionB = new MockCDPSession({}, \"session-b\");\n    const page = makePage([sessionA, sessionB]);\n\n    let caughtError: StagehandSetExtraHTTPHeadersError | undefined;\n    try {\n      await setExtraHTTPHeaders.call(page, {\n        \"x-stagehand-test\": \"yes\",\n      });\n    } catch (error) {\n      caughtError = error as StagehandSetExtraHTTPHeadersError;\n    }\n\n    expect(caughtError).toBeInstanceOf(StagehandSetExtraHTTPHeadersError);\n    expect(caughtError?.failures).toHaveLength(1);\n    expect(caughtError?.failures[0]).toContain(\"session=session-a\");\n    expect(caughtError?.failures[0]).toContain(\"connection closed\");\n\n    // sessionB should still have been called successfully\n    expect(sessionB.callsFor(\"Network.setExtraHTTPHeaders\").length).toBe(1);\n  });\n\n  it(\"applies headers to sessions adopted after the call\", async () => {\n    const sessionA = new MockCDPSession({}, \"session-a\");\n    const page = makePage([sessionA]);\n\n    await setExtraHTTPHeaders.call(page, { \"x-before\": \"yes\" });\n\n    // A new OOPIF session is adopted after headers were set\n    const sessionB = new MockCDPSession({}, \"session-b\");\n    page.sessions.set(sessionB.id, sessionB);\n\n    // Simulate what adoptOopifSession does: replay headers onto the new session\n    await page.applyExtraHTTPHeadersToSession.call(\n      page,\n      sessionB,\n      page.extraHTTPHeaders,\n    );\n\n    // The late-arriving session should have received the headers\n    expect(sessionB.callsFor(\"Network.enable\").length).toBe(1);\n    expect(sessionB.callsFor(\"Network.setExtraHTTPHeaders\")[0]?.params).toEqual(\n      {\n        headers: { \"x-before\": \"yes\" },\n      },\n    );\n  });\n\n  it(\"does not mutate the original headers object\", async () => {\n    const session = new MockCDPSession({}, \"session-a\");\n    const page = makePage([session]);\n\n    const original = { \"x-custom\": \"value\" };\n    const frozen = { ...original };\n\n    await setExtraHTTPHeaders.call(page, original);\n\n    expect(original).toEqual(frozen);\n  });\n});\n"]}

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,mCAA4D;AAC5D,oEAAsD;AAEtD,IAAA,iBAAQ,EAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,IAAA,iBAAQ,EAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,IAAA,WAAE,EAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,YAAY,GAAG;gBACnB,SAAS,EAAE,+BAA+B;gBAC1C,OAAO,EAAE,cAAc;gBACvB,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE;oBACP,iBAAiB,EAAE,MAAM;iBAC1B;aACqC,CAAC;YAEzC,KAAK,YAAY,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;QAG3B,IAAA,WAAE,EAAC,aAAa,EAAE,GAAG,EAAE;YACrB,IAAA,eAAM,EAAC,SAAS,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,IAAA,WAAE,EAAC,mBAAmB,EAAE,GAAG,EAAE;YAC3B,IAAA,qBAAY,GAAuB,CAAC,QAAQ,EAAuB,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,IAAA,WAAE,EAAC,qCAAqC,EAAE,GAAG,EAAE;YAG7C,IAAA,qBAAY,GAAwB,CAAC,aAAa,EAAK,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,MAAM,cAAc,GAAG;YACrB,6BAA6B;YAC7B,wCAAwC;YACxC,oCAAoC;YACpC,2BAA2B;YAC3B,6BAA6B;YAC7B,qCAAqC;YACrC,oCAAoC;YACpC,sCAAsC;YACtC,gDAAgD;YAChD,+BAA+B;YAC/B,6BAA6B;YAC7B,mBAAmB;SACX,CAAC;QAEX,IAAA,WAAE,EAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,IAAA,qBAAY,GAA+B,CAAC,aAAa,EAEtD,CAAC;YACJ,KAAK,cAAc,CAAC,CAAC,iCAAiC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,eAAe,EAAE,GAAG,EAAE;QAG7B,IAAA,WAAE,EAAC,aAAa,EAAE,GAAG,EAAE;YACrB,IAAA,eAAM,EAAC,SAAS,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,IAAA,WAAE,EAAC,sBAAsB,EAAE,GAAG,EAAE;YAC9B,IAAA,qBAAY,GAAsC,CAAC,gBAAgB,CACjE,YAAY,CACb,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAA,WAAE,EAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,IAAA,qBAAY,GAET,CAAC,aAAa,EAA0C,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,yBAAyB,EAAE,GAAG,EAAE;QAGvC,IAAA,WAAE,EAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,IAAA,qBAAY,GAET,CAAC,QAAQ,EAAmC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,gBAAgB,EAAE,GAAG,EAAE;QAkB9B,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,IAAA,qBAAY,GAA0B,CAAC,QAAQ,EAAiB,CAAC;QACnE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;QAI3B,IAAA,WAAE,EAAC,gDAAgD,EAAE,GAAG,EAAE;YAexD,IAAA,qBAAY,GAAmB,CAAC,QAAQ,EAAiB,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,WAAW,EAAE,GAAG,EAAE;QAiCzB,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,IAAA,qBAAY,GAAqB,CAAC,QAAQ,EAAiB,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,IAAA,WAAE,EAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,IAAA,qBAAY,GAET,CAAC,aAAa,EAAsB,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,IAAA,WAAE,EAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,IAAA,qBAAY,GAET,CAAC,gBAAgB,CAAC;gBACnB,OAAO,EAAE;oBACP,QAAQ,EAAE;wBACR;4BACE,IAAI,EAAE,MAAM;4BACZ,OAAO,EAAE,OAAO;yBACjB;qBACF;iBACF;gBACD,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;aACc,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,IAAA,WAAE,EAAC,wDAAwD,EAAE,GAAG,EAAE;YAChE,MAAM,UAAU,GAAG,EAAkC,CAAC;YACtD,IAAA,qBAAY,GAET,CAAC,gBAAgB,CAAC;gBACnB,OAAO,EAAE;oBACP,QAAQ,EAAE;wBACR;4BACE,IAAI,EAAE,MAAM;4BACZ,OAAO,EAAE,cAAc;yBACxB;qBACF;oBACD,cAAc,EAAE;wBACd,IAAI,EAAE,WAAW;wBACjB,MAAM,EAAE,UAAU;qBACnB;iBACF;gBACD,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;aACmB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,IAAA,WAAE,EAAC,mDAAmD,EAAE,GAAG,EAAE;YAM3D,IAAA,qBAAY,GAET,CAAC,QAAQ,EAAqB,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,IAAA,WAAE,EAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,qFAAqF;YACrF,qDAAqD;YACrD,IAAA,qBAAY,GAAqC,CAAC,QAAQ,EAEvD,CAAC;YACJ,IAAA,qBAAY,GAAuC,CAAC,QAAQ,EAEzD,CAAC;YACJ,IAAA,qBAAY,GAAmC,CAAC,QAAQ,EAErD,CAAC;YACJ,IAAA,qBAAY,GAAqC,CAAC,QAAQ,EAEvD,CAAC;YACJ,IAAA,qBAAY,GAAsC,CAAC,QAAQ,EAExD,CAAC;YACJ,IAAA,qBAAY,GAA8B,CAAC,QAAQ,EAEhD,CAAC;YACJ,IAAA,qBAAY,GAAkC,CAAC,QAAQ,EAEpD,CAAC;YACJ,IAAA,qBAAY,GAAmC,CAAC,QAAQ,EAErD,CAAC;YACJ,IAAA,qBAAY,GAAuC,CAAC,QAAQ,EAEzD,CAAC;QACN,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,yBAAyB,EAAE,GAAG,EAAE;QAMvC,IAAA,WAAE,EAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,IAAA,qBAAY,GAET,CAAC,QAAQ,EAAmC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,iBAAQ,EAAC,UAAU,EAAE,GAAG,EAAE;QAyBxB,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,IAAA,qBAAY,GAAoB,CAAC,QAAQ,EAAiB,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","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;
+};