@browserbasehq/orca 3.4.0-preview-4 → 3.4.0-preview-5

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

@@ -1,92 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1,75 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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/prompt-observe-variables.test.d.ts

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

package/dist/cjs/tests/unit/prompt-observe-variables.test.js

@@ -1,25 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const prompt_js_1 = require("../../lib/prompt.js");
-(0, vitest_1.describe)("buildObserveSystemPrompt", () => {
-    (0, vitest_1.it)("includes variable descriptions when present", () => {
-        const prompt = (0, prompt_js_1.buildObserveSystemPrompt)(undefined, ["click", "fill"], {
-            username: {
-                value: "john@example.com",
-                description: "The login email",
-            },
-            password: "secret123",
-        });
-        (0, vitest_1.expect)(prompt.content).toContain("Supported actions: click, fill");
-        (0, vitest_1.expect)(prompt.content).toContain("Available variables: %username% (The login email), %password%");
-        (0, vitest_1.expect)(prompt.content).toContain("return the matching %variableName% placeholder");
-    });
-    (0, vitest_1.it)("instructs the model to copy complete bracketed element IDs", () => {
-        const prompt = (0, prompt_js_1.buildObserveSystemPrompt)(undefined, ["click"]);
-        (0, vitest_1.expect)(prompt.content).toContain("Always copy the complete ID exactly as shown inside the brackets into elementId");
-        (0, vitest_1.expect)(prompt.content).toContain('return elementId "0-18372"');
-        (0, vitest_1.expect)(prompt.content).toContain('never return only "18372"');
-    });
-});
-//# sourceMappingURL=prompt-observe-variables.test.js.map

package/dist/cjs/tests/unit/prompt-observe-variables.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompt-observe-variables.test.js","sourceRoot":"","sources":["../../../../tests/unit/prompt-observe-variables.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,mDAA+D;AAE/D,IAAA,iBAAQ,EAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAA,WAAE,EAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,IAAA,oCAAwB,EAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE;YACpE,QAAQ,EAAE;gBACR,KAAK,EAAE,kBAAkB;gBACzB,WAAW,EAAE,iBAAiB;aAC/B;YACD,QAAQ,EAAE,WAAW;SACtB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACnE,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAC9B,+DAA+D,CAChE,CAAC;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAC9B,gDAAgD,CACjD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,MAAM,GAAG,IAAA,oCAAwB,EAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAE9D,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAC9B,iFAAiF,CAClF,CAAC;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;QAC/D,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { buildObserveSystemPrompt } from \"../../lib/prompt.js\";\n\ndescribe(\"buildObserveSystemPrompt\", () => {\n  it(\"includes variable descriptions when present\", () => {\n    const prompt = buildObserveSystemPrompt(undefined, [\"click\", \"fill\"], {\n      username: {\n        value: \"john@example.com\",\n        description: \"The login email\",\n      },\n      password: \"secret123\",\n    });\n\n    expect(prompt.content).toContain(\"Supported actions: click, fill\");\n    expect(prompt.content).toContain(\n      \"Available variables: %username% (The login email), %password%\",\n    );\n    expect(prompt.content).toContain(\n      \"return the matching %variableName% placeholder\",\n    );\n  });\n\n  it(\"instructs the model to copy complete bracketed element IDs\", () => {\n    const prompt = buildObserveSystemPrompt(undefined, [\"click\"]);\n\n    expect(prompt.content).toContain(\n      \"Always copy the complete ID exactly as shown inside the brackets into elementId\",\n    );\n    expect(prompt.content).toContain('return elementId \"0-18372\"');\n    expect(prompt.content).toContain('never return only \"18372\"');\n  });\n});\n"]}

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

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

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

@@ -1,107 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1,179 +0,0 @@
-"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",
-            "openai/gpt-5.4",
-            "openai/gpt-5.4-mini",
-            "openai/gpt-5.5",
-            "anthropic/claude-opus-4-5-20251101",
-            "anthropic/claude-opus-4-6",
-            "anthropic/claude-sonnet-4-6",
-            "anthropic/claude-haiku-4-5",
-            "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

@@ -1 +0,0 @@
-{"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,gBAAgB;YAChB,qBAAqB;YACrB,gBAAgB;YAChB,oCAAoC;YACpC,2BAA2B;YAC3B,6BAA6B;YAC7B,4BAA4B;YAC5B,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      \"openai/gpt-5.4\",\n      \"openai/gpt-5.4-mini\",\n      \"openai/gpt-5.5\",\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\",\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"]}