@browserbasehq/orca 3.2.0-preview.3 → 3.2.0-preview.5

package/dist/esm/tests/unit/browserbase-session-accessors.test.js

@@ -60,6 +60,7 @@ describe("browserbase accessors", () => {
             await v3.init();
             expect(v3.browserbaseSessionURL).toBe(MOCK_SESSION_URL);
             expect(v3.browserbaseDebugURL).toBe(MOCK_DEBUG_URL);
+            expect(v3.isCaptchaAutoSolveEnabled).toBe(true);
         }
         finally {
             await v3.close().catch(() => { });
@@ -76,6 +77,25 @@ describe("browserbase accessors", () => {
         expect(v3.browserbaseSessionURL).toBeUndefined();
         expect(v3.browserbaseDebugURL).toBeUndefined();
     });
+    it("disables captcha solving when solveCaptchas is explicitly false", async () => {
+        const v3 = new V3({
+            env: "BROWSERBASE",
+            disableAPI: true,
+            verbose: 0,
+            browserbaseSessionCreateParams: {
+                browserSettings: {
+                    solveCaptchas: false,
+                },
+            },
+        });
+        try {
+            await v3.init();
+            expect(v3.isCaptchaAutoSolveEnabled).toBe(false);
+        }
+        finally {
+            await v3.close().catch(() => { });
+        }
+    });
 });
 describe("local accessors", () => {
     it("stay empty for LOCAL environments", async () => {

package/dist/esm/tests/unit/browserbase-session-accessors.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"browserbase-session-accessors.test.js","sourceRoot":"","sources":["../../../../tests/unit/browserbase-session-accessors.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi, beforeEach, afterEach } from \"vitest\";\nimport { V3 } from \"../../lib/v3/v3.js\";\n\nconst MOCK_SESSION_ID = \"session-123\";\nconst MOCK_SESSION_URL = `https://www.browserbase.com/sessions/${MOCK_SESSION_ID}`;\nconst MOCK_DEBUG_URL = `https://debug.browserbase.com/${MOCK_SESSION_ID}`;\n\nvi.mock(\"../../lib/v3/understudy/context\", () => {\n  class MockConnection {\n    onTransportClosed = vi.fn();\n    offTransportClosed = vi.fn();\n    send = vi.fn(async () => {});\n  }\n\n  class MockV3Context {\n    static async create(): Promise<MockV3Context> {\n      return new MockV3Context();\n    }\n\n    conn = new MockConnection();\n\n    pages(): never[] {\n      return [];\n    }\n\n    async close(): Promise<void> {\n      // noop\n    }\n  }\n\n  return { V3Context: MockV3Context };\n});\n\nvi.mock(\"../../lib/v3/launch/browserbase\", () => ({\n  createBrowserbaseSession: vi.fn(async () => ({\n    ws: \"wss://mock-browserbase\",\n    sessionId: MOCK_SESSION_ID,\n    bb: {\n      sessions: {\n        debug: vi.fn(async () => ({ debuggerUrl: MOCK_DEBUG_URL })),\n      },\n    },\n  })),\n}));\n\nvi.mock(\"../../lib/v3/launch/local\", () => ({\n  launchLocalChrome: vi.fn(async () => ({\n    ws: \"ws://local-cdp\",\n    chrome: { kill: vi.fn(async () => {}) },\n  })),\n}));\n\ndescribe(\"browserbase accessors\", () => {\n  beforeEach(() => {\n    process.env.BROWSERBASE_API_KEY = \"fake-key\";\n    process.env.BROWSERBASE_PROJECT_ID = \"fake-project\";\n  });\n\n  afterEach(() => {\n    delete process.env.BROWSERBASE_API_KEY;\n    delete process.env.BROWSERBASE_PROJECT_ID;\n    vi.clearAllMocks();\n  });\n\n  it(\"exposes Browserbase session and debug URLs after init\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n    });\n\n    try {\n      await v3.init();\n\n      expect(v3.browserbaseSessionURL).toBe(MOCK_SESSION_URL);\n      expect(v3.browserbaseDebugURL).toBe(MOCK_DEBUG_URL);\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n\n  it(\"clears stored URLs after close\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n    });\n\n    await v3.init();\n    await v3.close();\n\n    expect(v3.browserbaseSessionURL).toBeUndefined();\n    expect(v3.browserbaseDebugURL).toBeUndefined();\n  });\n});\n\ndescribe(\"local accessors\", () => {\n  it(\"stay empty for LOCAL environments\", async () => {\n    const v3 = new V3({\n      env: \"LOCAL\",\n      disableAPI: true,\n      verbose: 0,\n      localBrowserLaunchOptions: {\n        cdpUrl: \"ws://local-existing-session\",\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.browserbaseSessionURL).toBeUndefined();\n      expect(v3.browserbaseDebugURL).toBeUndefined();\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n});\n"]}
+{"version":3,"file":"browserbase-session-accessors.test.js","sourceRoot":"","sources":["../../../../tests/unit/browserbase-session-accessors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAExC,MAAM,eAAe,GAAG,aAAa,CAAC;AACtC,MAAM,gBAAgB,GAAG,wCAAwC,eAAe,EAAE,CAAC;AACnF,MAAM,cAAc,GAAG,iCAAiC,eAAe,EAAE,CAAC;AAE1E,EAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC9C,MAAM,cAAc;QAClB,iBAAiB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,kBAAkB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,CAAC;KAC9B;IAED,MAAM,aAAa;QACjB,MAAM,CAAC,KAAK,CAAC,MAAM;YACjB,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,CAAC;QAED,IAAI,GAAG,IAAI,cAAc,EAAE,CAAC;QAE5B,KAAK;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,KAAK,CAAC,KAAK;YACT,OAAO;QACT,CAAC;KACF;IAED,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE,CAAC,CAAC;IAChD,wBAAwB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3C,EAAE,EAAE,wBAAwB;QAC5B,SAAS,EAAE,eAAe;QAC1B,EAAE,EAAE;YACF,QAAQ,EAAE;gBACR,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,CAAC;aAC5D;SACF;KACF,CAAC,CAAC;CACJ,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,iBAAiB,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACpC,EAAE,EAAE,gBAAgB;QACpB,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,EAAE;KACxC,CAAC,CAAC;CACJ,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,GAAG,CAAC,mBAAmB,GAAG,UAAU,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,cAAc,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACvC,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAC1C,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;YAChB,GAAG,EAAE,aAAa;YAClB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,CAAC;SACX,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;YAEhB,MAAM,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACxD,MAAM,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACpD,MAAM,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;YAChB,GAAG,EAAE,aAAa;YAClB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,CAAC;SACX,CAAC,CAAC;QAEH,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QAEjB,MAAM,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,aAAa,EAAE,CAAC;QACjD,MAAM,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,aAAa,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;YAChB,GAAG,EAAE,aAAa;YAClB,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,CAAC;YACV,8BAA8B,EAAE;gBAC9B,eAAe,EAAE;oBACf,aAAa,EAAE,KAAK;iBACrB;aACF;SACF,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;YAChB,GAAG,EAAE,OAAO;YACZ,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,CAAC;YACV,yBAAyB,EAAE;gBACzB,MAAM,EAAE,6BAA6B;aACtC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,aAAa,EAAE,CAAC;YACjD,MAAM,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,aAAa,EAAE,CAAC;QACjD,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it, vi, beforeEach, afterEach } from \"vitest\";\nimport { V3 } from \"../../lib/v3/v3.js\";\n\nconst MOCK_SESSION_ID = \"session-123\";\nconst MOCK_SESSION_URL = `https://www.browserbase.com/sessions/${MOCK_SESSION_ID}`;\nconst MOCK_DEBUG_URL = `https://debug.browserbase.com/${MOCK_SESSION_ID}`;\n\nvi.mock(\"../../lib/v3/understudy/context\", () => {\n  class MockConnection {\n    onTransportClosed = vi.fn();\n    offTransportClosed = vi.fn();\n    send = vi.fn(async () => {});\n  }\n\n  class MockV3Context {\n    static async create(): Promise<MockV3Context> {\n      return new MockV3Context();\n    }\n\n    conn = new MockConnection();\n\n    pages(): never[] {\n      return [];\n    }\n\n    async close(): Promise<void> {\n      // noop\n    }\n  }\n\n  return { V3Context: MockV3Context };\n});\n\nvi.mock(\"../../lib/v3/launch/browserbase\", () => ({\n  createBrowserbaseSession: vi.fn(async () => ({\n    ws: \"wss://mock-browserbase\",\n    sessionId: MOCK_SESSION_ID,\n    bb: {\n      sessions: {\n        debug: vi.fn(async () => ({ debuggerUrl: MOCK_DEBUG_URL })),\n      },\n    },\n  })),\n}));\n\nvi.mock(\"../../lib/v3/launch/local\", () => ({\n  launchLocalChrome: vi.fn(async () => ({\n    ws: \"ws://local-cdp\",\n    chrome: { kill: vi.fn(async () => {}) },\n  })),\n}));\n\ndescribe(\"browserbase accessors\", () => {\n  beforeEach(() => {\n    process.env.BROWSERBASE_API_KEY = \"fake-key\";\n    process.env.BROWSERBASE_PROJECT_ID = \"fake-project\";\n  });\n\n  afterEach(() => {\n    delete process.env.BROWSERBASE_API_KEY;\n    delete process.env.BROWSERBASE_PROJECT_ID;\n    vi.clearAllMocks();\n  });\n\n  it(\"exposes Browserbase session and debug URLs after init\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n    });\n\n    try {\n      await v3.init();\n\n      expect(v3.browserbaseSessionURL).toBe(MOCK_SESSION_URL);\n      expect(v3.browserbaseDebugURL).toBe(MOCK_DEBUG_URL);\n      expect(v3.isCaptchaAutoSolveEnabled).toBe(true);\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n\n  it(\"clears stored URLs after close\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n    });\n\n    await v3.init();\n    await v3.close();\n\n    expect(v3.browserbaseSessionURL).toBeUndefined();\n    expect(v3.browserbaseDebugURL).toBeUndefined();\n  });\n\n  it(\"disables captcha solving when solveCaptchas is explicitly false\", async () => {\n    const v3 = new V3({\n      env: \"BROWSERBASE\",\n      disableAPI: true,\n      verbose: 0,\n      browserbaseSessionCreateParams: {\n        browserSettings: {\n          solveCaptchas: false,\n        },\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.isCaptchaAutoSolveEnabled).toBe(false);\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n});\n\ndescribe(\"local accessors\", () => {\n  it(\"stay empty for LOCAL environments\", async () => {\n    const v3 = new V3({\n      env: \"LOCAL\",\n      disableAPI: true,\n      verbose: 0,\n      localBrowserLaunchOptions: {\n        cdpUrl: \"ws://local-existing-session\",\n      },\n    });\n\n    try {\n      await v3.init();\n      expect(v3.browserbaseSessionURL).toBeUndefined();\n      expect(v3.browserbaseDebugURL).toBeUndefined();\n    } finally {\n      await v3.close().catch(() => {});\n    }\n  });\n});\n"]}

package/dist/esm/tests/unit/captcha-solver.test.d.ts

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

package/dist/esm/tests/unit/captcha-solver.test.js

@@ -0,0 +1,152 @@
+import { describe, expect, it } from "vitest";
+import { CaptchaSolver } from "../../lib/v3/agent/utils/captchaSolver.js";
+const SOLVING_STARTED = "browserbase-solving-started";
+const SOLVING_FINISHED = "browserbase-solving-finished";
+const SOLVING_ERRORED = "browserbase-solving-errored";
+class MockPage {
+    listeners = new Set();
+    onCalls = 0;
+    offCalls = 0;
+    on(event, listener) {
+        if (event !== "console")
+            return;
+        this.onCalls++;
+        this.listeners.add(listener);
+    }
+    off(event, listener) {
+        if (event !== "console")
+            return;
+        this.offCalls++;
+        this.listeners.delete(listener);
+    }
+    emitConsole(text) {
+        const message = { text: () => text };
+        for (const listener of this.listeners) {
+            listener(message);
+        }
+    }
+    listenerCount() {
+        return this.listeners.size;
+    }
+}
+describe("CaptchaSolver", () => {
+    it("resolves all concurrent waiters when a solve finishes", async () => {
+        const page = new MockPage();
+        const solver = new CaptchaSolver();
+        solver.init(async () => page);
+        await solver.ensureAttached();
+        page.emitConsole(SOLVING_STARTED);
+        const firstWait = solver.waitIfSolving();
+        const secondWait = solver.waitIfSolving();
+        await new Promise((resolve) => setTimeout(resolve, 0));
+        const sharedWaitPromise = solver.waitPromise;
+        expect(sharedWaitPromise).not.toBeNull();
+        expect(solver.waitPromise).toBe(sharedWaitPromise);
+        let firstResolved = false;
+        let secondResolved = false;
+        void firstWait.then(() => {
+            firstResolved = true;
+        });
+        void secondWait.then(() => {
+            secondResolved = true;
+        });
+        await Promise.resolve();
+        expect(firstResolved).toBe(false);
+        expect(secondResolved).toBe(false);
+        page.emitConsole(SOLVING_FINISHED);
+        await Promise.all([firstWait, secondWait]);
+        expect(firstResolved).toBe(true);
+        expect(secondResolved).toBe(true);
+        expect(solver.consumeSolveResult()).toEqual({
+            solved: true,
+            errored: false,
+        });
+        expect(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: false,
+        });
+    });
+    it("re-attaches to a new page and settles stale waiters when the active page changes", async () => {
+        const firstPage = new MockPage();
+        const secondPage = new MockPage();
+        let activePage = firstPage;
+        const solver = new CaptchaSolver();
+        solver.init(async () => activePage);
+        await solver.ensureAttached();
+        firstPage.emitConsole(SOLVING_STARTED);
+        const pendingWait = solver.waitIfSolving();
+        let settled = false;
+        void pendingWait.then(() => {
+            settled = true;
+        });
+        activePage = secondPage;
+        await solver.waitIfSolving();
+        await pendingWait;
+        expect(settled).toBe(true);
+        expect(firstPage.offCalls).toBe(1);
+        expect(firstPage.listenerCount()).toBe(0);
+        expect(secondPage.onCalls).toBe(1);
+        expect(secondPage.listenerCount()).toBe(1);
+        expect(solver.isSolving()).toBe(false);
+    });
+    it("surfaces solver errors exactly once per consume", async () => {
+        const page = new MockPage();
+        const solver = new CaptchaSolver();
+        solver.init(async () => page);
+        await solver.ensureAttached();
+        page.emitConsole(SOLVING_STARTED);
+        const wait = solver.waitIfSolving();
+        page.emitConsole(SOLVING_ERRORED);
+        await wait;
+        expect(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: true,
+        });
+        expect(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: false,
+        });
+    });
+    it("disposes cleanly while a solve is in progress", async () => {
+        const page = new MockPage();
+        const solver = new CaptchaSolver();
+        solver.init(async () => page);
+        await solver.ensureAttached();
+        page.emitConsole(SOLVING_STARTED);
+        const wait = solver.waitIfSolving();
+        await new Promise((resolve) => setTimeout(resolve, 0));
+        let settled = false;
+        void wait.then(() => {
+            settled = true;
+        });
+        solver.dispose();
+        await wait;
+        expect(settled).toBe(true);
+        expect(solver.isSolving()).toBe(false);
+        expect(page.listenerCount()).toBe(0);
+        expect(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: false,
+        });
+    });
+    it("marks errored when detached mid-solve due to page change", async () => {
+        const firstPage = new MockPage();
+        const secondPage = new MockPage();
+        let activePage = firstPage;
+        const solver = new CaptchaSolver();
+        solver.init(async () => activePage);
+        await solver.ensureAttached();
+        firstPage.emitConsole(SOLVING_STARTED);
+        const wait = solver.waitIfSolving();
+        // Switch to a new page while the solve is in progress
+        activePage = secondPage;
+        await solver.waitIfSolving();
+        await wait;
+        // The interrupted solve should be reported as errored
+        expect(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: true,
+        });
+    });
+});
+//# sourceMappingURL=captcha-solver.test.js.map

package/dist/esm/tests/unit/captcha-solver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captcha-solver.test.js","sourceRoot":"","sources":["../../../../tests/unit/captcha-solver.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { CaptchaSolver } from \"../../lib/v3/agent/utils/captchaSolver.js\";\n\nconst SOLVING_STARTED = \"browserbase-solving-started\";\nconst SOLVING_FINISHED = \"browserbase-solving-finished\";\nconst SOLVING_ERRORED = \"browserbase-solving-errored\";\n\ntype ConsoleListener = (message: { text: () => string }) => void;\n\nclass MockPage {\n  private listeners = new Set<ConsoleListener>();\n  public onCalls = 0;\n  public offCalls = 0;\n\n  on(event: string, listener: ConsoleListener): void {\n    if (event !== \"console\") return;\n    this.onCalls++;\n    this.listeners.add(listener);\n  }\n\n  off(event: string, listener: ConsoleListener): void {\n    if (event !== \"console\") return;\n    this.offCalls++;\n    this.listeners.delete(listener);\n  }\n\n  emitConsole(text: string): void {\n    const message = { text: () => text };\n    for (const listener of this.listeners) {\n      listener(message);\n    }\n  }\n\n  listenerCount(): number {\n    return this.listeners.size;\n  }\n}\n\ndescribe(\"CaptchaSolver\", () => {\n  it(\"resolves all concurrent waiters when a solve finishes\", async () => {\n    const page = new MockPage();\n    const solver = new CaptchaSolver();\n    solver.init(async () => page as never);\n\n    await solver.ensureAttached();\n    page.emitConsole(SOLVING_STARTED);\n\n    const firstWait = solver.waitIfSolving();\n    const secondWait = solver.waitIfSolving();\n    await new Promise((resolve) => setTimeout(resolve, 0));\n\n    const sharedWaitPromise = (\n      solver as unknown as { waitPromise: Promise<void> | null }\n    ).waitPromise;\n\n    expect(sharedWaitPromise).not.toBeNull();\n    expect(\n      (solver as unknown as { waitPromise: Promise<void> | null }).waitPromise,\n    ).toBe(sharedWaitPromise);\n\n    let firstResolved = false;\n    let secondResolved = false;\n    void firstWait.then(() => {\n      firstResolved = true;\n    });\n    void secondWait.then(() => {\n      secondResolved = true;\n    });\n\n    await Promise.resolve();\n    expect(firstResolved).toBe(false);\n    expect(secondResolved).toBe(false);\n\n    page.emitConsole(SOLVING_FINISHED);\n    await Promise.all([firstWait, secondWait]);\n\n    expect(firstResolved).toBe(true);\n    expect(secondResolved).toBe(true);\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: true,\n      errored: false,\n    });\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: false,\n    });\n  });\n\n  it(\"re-attaches to a new page and settles stale waiters when the active page changes\", async () => {\n    const firstPage = new MockPage();\n    const secondPage = new MockPage();\n    let activePage = firstPage;\n\n    const solver = new CaptchaSolver();\n    solver.init(async () => activePage as never);\n\n    await solver.ensureAttached();\n    firstPage.emitConsole(SOLVING_STARTED);\n\n    const pendingWait = solver.waitIfSolving();\n    let settled = false;\n    void pendingWait.then(() => {\n      settled = true;\n    });\n\n    activePage = secondPage;\n    await solver.waitIfSolving();\n    await pendingWait;\n\n    expect(settled).toBe(true);\n    expect(firstPage.offCalls).toBe(1);\n    expect(firstPage.listenerCount()).toBe(0);\n    expect(secondPage.onCalls).toBe(1);\n    expect(secondPage.listenerCount()).toBe(1);\n    expect(solver.isSolving()).toBe(false);\n  });\n\n  it(\"surfaces solver errors exactly once per consume\", async () => {\n    const page = new MockPage();\n    const solver = new CaptchaSolver();\n    solver.init(async () => page as never);\n\n    await solver.ensureAttached();\n    page.emitConsole(SOLVING_STARTED);\n\n    const wait = solver.waitIfSolving();\n    page.emitConsole(SOLVING_ERRORED);\n    await wait;\n\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: true,\n    });\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: false,\n    });\n  });\n\n  it(\"disposes cleanly while a solve is in progress\", async () => {\n    const page = new MockPage();\n    const solver = new CaptchaSolver();\n    solver.init(async () => page as never);\n\n    await solver.ensureAttached();\n    page.emitConsole(SOLVING_STARTED);\n\n    const wait = solver.waitIfSolving();\n    await new Promise((resolve) => setTimeout(resolve, 0));\n    let settled = false;\n    void wait.then(() => {\n      settled = true;\n    });\n\n    solver.dispose();\n    await wait;\n\n    expect(settled).toBe(true);\n    expect(solver.isSolving()).toBe(false);\n    expect(page.listenerCount()).toBe(0);\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: false,\n    });\n  });\n\n  it(\"marks errored when detached mid-solve due to page change\", async () => {\n    const firstPage = new MockPage();\n    const secondPage = new MockPage();\n    let activePage = firstPage;\n\n    const solver = new CaptchaSolver();\n    solver.init(async () => activePage as never);\n\n    await solver.ensureAttached();\n    firstPage.emitConsole(SOLVING_STARTED);\n\n    const wait = solver.waitIfSolving();\n\n    // Switch to a new page while the solve is in progress\n    activePage = secondPage;\n    await solver.waitIfSolving();\n    await wait;\n\n    // The interrupted solve should be reported as errored\n    expect(solver.consumeSolveResult()).toEqual({\n      solved: false,\n      errored: true,\n    });\n  });\n});\n"]}

package/dist/esm/tests/unit/flowlogger-capturing-cdp.test.d.ts

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

package/dist/esm/tests/unit/flowlogger-capturing-cdp.test.js

@@ -0,0 +1,93 @@
+import { EventEmitter } from "node:events";
+import { describe, it, expect } from "vitest";
+import { CdpConnection } from "../../lib/v3/understudy/cdp.js";
+import { InMemoryEventSink } from "../../lib/v3/flowlogger/EventSink.js";
+import { EventEmitterWithWildcardSupport } from "../../lib/v3/flowlogger/EventEmitter.js";
+import { EventStore } from "../../lib/v3/flowlogger/EventStore.js";
+import { FlowEvent, FlowLogger } from "../../lib/v3/flowlogger/FlowLogger.js";
+function attachEventStoreToBus(store, bus) {
+    const onFlowEvent = (event) => {
+        if (event instanceof FlowEvent) {
+            void store.emit(event);
+        }
+    };
+    bus.on("*", onFlowEvent);
+    return () => {
+        bus.off("*", onFlowEvent);
+    };
+}
+class FakeSocket extends EventEmitter {
+    sentPayloads = [];
+    readyState = 1;
+    send(payload) {
+        this.sentPayloads.push(payload);
+    }
+    close() {
+        this.readyState = 3;
+        this.emit("close", 1000, "");
+    }
+}
+function createConnection(socket) {
+    // The production constructor is private; tests instantiate it directly so
+    // they can drive raw websocket messages without a real browser.
+    const ConnectionCtor = CdpConnection;
+    return new ConnectionCtor(socket);
+}
+function requireEvent(events, predicate, description) {
+    const match = events.find(predicate);
+    expect(match, `missing ${description}`).toBeDefined();
+    return match;
+}
+describe("flow logger cdp context", () => {
+    it("preserves the active parent chain when a session event handler issues a nested CDP call", async () => {
+        const sessionId = "session-test";
+        const socket = new FakeSocket();
+        const eventBus = new EventEmitterWithWildcardSupport();
+        const sink = new InMemoryEventSink();
+        const eventStore = new EventStore(sessionId, undefined, sink);
+        const detachBus = attachEventStoreToBus(eventStore, eventBus);
+        const conn = createConnection(socket);
+        conn.flowLoggerContext = FlowLogger.init(sessionId, eventBus);
+        // Seed the target/session mapping the same way a real attach flow would
+        // before any session-scoped messages are dispatched.
+        conn.onMessage(JSON.stringify({
+            method: "Target.attachedToTarget",
+            params: {
+                sessionId: "target-session",
+                targetInfo: { targetId: "target-1" },
+            },
+        }));
+        const session = conn.getSession("target-session");
+        expect(session).toBeDefined();
+        session.on("Runtime.consoleAPICalled", () => {
+            // This nested send used to lose its parent chain because the callback ran
+            // after the original ALS scope had already unwound.
+            void session.send("Runtime.evaluate", {
+                expression: "2 + 2",
+            });
+        });
+        await FlowLogger.runWithLogging({
+            context: conn.flowLoggerContext,
+            eventType: "SyntheticParentEvent",
+        }, async () => {
+            void session.send("Page.navigate", {
+                url: "https://example.com",
+            });
+        }, []);
+        conn.onMessage(JSON.stringify({
+            method: "Runtime.consoleAPICalled",
+            sessionId: "target-session",
+            params: { type: "log" },
+        }));
+        // The nested Runtime.evaluate call should still attach under the synthetic
+        // parent event even though it was triggered by a later session callback.
+        const events = await eventStore.query({});
+        const parentEvent = requireEvent(events, (event) => event.eventType === "SyntheticParentEvent", "SyntheticParentEvent");
+        const nestedCallEvent = requireEvent(events, (event) => event.eventType === "CdpCallEvent" &&
+            String(event.data.method) === "Runtime.evaluate", "nested Runtime.evaluate CdpCallEvent");
+        expect(nestedCallEvent.eventParentIds).toEqual([parentEvent.eventId]);
+        detachBus();
+        await eventStore.destroy();
+    });
+});
+//# sourceMappingURL=flowlogger-capturing-cdp.test.js.map

package/dist/esm/tests/unit/flowlogger-capturing-cdp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowlogger-capturing-cdp.test.js","sourceRoot":"","sources":["../../../../tests/unit/flowlogger-capturing-cdp.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport { describe, it, expect } from \"vitest\";\nimport { CdpConnection } from \"../../lib/v3/understudy/cdp.js\";\nimport { InMemoryEventSink } from \"../../lib/v3/flowlogger/EventSink.js\";\nimport { EventEmitterWithWildcardSupport } from \"../../lib/v3/flowlogger/EventEmitter.js\";\nimport { EventStore } from \"../../lib/v3/flowlogger/EventStore.js\";\nimport { FlowEvent, FlowLogger } from \"../../lib/v3/flowlogger/FlowLogger.js\";\n\nfunction attachEventStoreToBus(\n  store: EventStore,\n  bus: EventEmitterWithWildcardSupport,\n): () => void {\n  const onFlowEvent = (event: unknown) => {\n    if (event instanceof FlowEvent) {\n      void store.emit(event);\n    }\n  };\n\n  bus.on(\"*\", onFlowEvent);\n  return () => {\n    bus.off(\"*\", onFlowEvent);\n  };\n}\n\nclass FakeSocket extends EventEmitter {\n  sentPayloads: string[] = [];\n  readyState = 1;\n\n  send(payload: string): void {\n    this.sentPayloads.push(payload);\n  }\n\n  close(): void {\n    this.readyState = 3;\n    this.emit(\"close\", 1000, \"\");\n  }\n}\n\nfunction createConnection(socket: FakeSocket): CdpConnection {\n  // The production constructor is private; tests instantiate it directly so\n  // they can drive raw websocket messages without a real browser.\n  const ConnectionCtor = CdpConnection as unknown as {\n    new (ws: FakeSocket): CdpConnection;\n  };\n  return new ConnectionCtor(socket);\n}\n\nfunction requireEvent(\n  events: FlowEvent[],\n  predicate: (event: FlowEvent) => boolean,\n  description: string,\n): FlowEvent {\n  const match = events.find(predicate);\n  expect(match, `missing ${description}`).toBeDefined();\n  return match as FlowEvent;\n}\n\ndescribe(\"flow logger cdp context\", () => {\n  it(\"preserves the active parent chain when a session event handler issues a nested CDP call\", async () => {\n    const sessionId = \"session-test\";\n    const socket = new FakeSocket();\n    const eventBus = new EventEmitterWithWildcardSupport();\n    const sink = new InMemoryEventSink();\n    const eventStore = new EventStore(sessionId, undefined, sink);\n\n    const detachBus = attachEventStoreToBus(eventStore, eventBus);\n\n    const conn = createConnection(socket);\n    conn.flowLoggerContext = FlowLogger.init(sessionId, eventBus);\n\n    // Seed the target/session mapping the same way a real attach flow would\n    // before any session-scoped messages are dispatched.\n    (conn as unknown as { onMessage(json: string): void }).onMessage(\n      JSON.stringify({\n        method: \"Target.attachedToTarget\",\n        params: {\n          sessionId: \"target-session\",\n          targetInfo: { targetId: \"target-1\" },\n        },\n      }),\n    );\n\n    const session = conn.getSession(\"target-session\");\n    expect(session).toBeDefined();\n\n    session!.on(\"Runtime.consoleAPICalled\", () => {\n      // This nested send used to lose its parent chain because the callback ran\n      // after the original ALS scope had already unwound.\n      void session!.send(\"Runtime.evaluate\", {\n        expression: \"2 + 2\",\n      });\n    });\n\n    await FlowLogger.runWithLogging(\n      {\n        context: conn.flowLoggerContext,\n        eventType: \"SyntheticParentEvent\",\n      },\n      async () => {\n        void session!.send(\"Page.navigate\", {\n          url: \"https://example.com\",\n        });\n      },\n      [],\n    );\n\n    (conn as unknown as { onMessage(json: string): void }).onMessage(\n      JSON.stringify({\n        method: \"Runtime.consoleAPICalled\",\n        sessionId: \"target-session\",\n        params: { type: \"log\" },\n      }),\n    );\n\n    // The nested Runtime.evaluate call should still attach under the synthetic\n    // parent event even though it was triggered by a later session callback.\n    const events = await eventStore.query({});\n    const parentEvent = requireEvent(\n      events,\n      (event) => event.eventType === \"SyntheticParentEvent\",\n      \"SyntheticParentEvent\",\n    );\n    const nestedCallEvent = requireEvent(\n      events,\n      (event) =>\n        event.eventType === \"CdpCallEvent\" &&\n        String(event.data.method) === \"Runtime.evaluate\",\n      \"nested Runtime.evaluate CdpCallEvent\",\n    );\n\n    expect(nestedCallEvent.eventParentIds).toEqual([parentEvent.eventId]);\n\n    detachBus();\n    await eventStore.destroy();\n  });\n});\n"]}

package/dist/esm/tests/unit/flowlogger-capturing-llm.test.d.ts

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

package/dist/esm/tests/unit/flowlogger-capturing-llm.test.js

@@ -0,0 +1,41 @@
+import { describe, expect, it } from "vitest";
+import { FlowLogger } from "../../lib/v3/flowlogger/FlowLogger.js";
+describe("flow logger llm logging", () => {
+    it("no-ops direct llm logging calls when no flow context is active", () => {
+        // These helpers are called from multiple model adapters, so they must stay
+        // safe even when a test or utility invokes them outside any ALS flow scope.
+        expect(() => FlowLogger.logLlmRequest({
+            requestId: "req-1",
+            model: "mock-model",
+            prompt: "hello",
+        })).not.toThrow();
+        expect(() => FlowLogger.logLlmResponse({
+            requestId: "req-1",
+            model: "mock-model",
+            output: "world",
+            inputTokens: 1,
+            outputTokens: 1,
+        })).not.toThrow();
+    });
+    it("does not throw from llm middleware when no flow context is active", async () => {
+        const middleware = FlowLogger.createLlmLoggingMiddleware("mock-model");
+        // Missing flow context should degrade to a silent no-op and preserve the
+        // underlying model result.
+        await expect(middleware.wrapGenerate({
+            doGenerate: async () => ({
+                text: "done",
+                usage: {
+                    inputTokens: 1,
+                    outputTokens: 1,
+                    totalTokens: 2,
+                },
+            }),
+            params: {
+                prompt: [],
+            },
+        })).resolves.toMatchObject({
+            text: "done",
+        });
+    });
+});
+//# sourceMappingURL=flowlogger-capturing-llm.test.js.map

package/dist/esm/tests/unit/flowlogger-capturing-llm.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowlogger-capturing-llm.test.js","sourceRoot":"","sources":["../../../../tests/unit/flowlogger-capturing-llm.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAEnE,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,2EAA2E;QAC3E,4EAA4E;QAC5E,MAAM,CAAC,GAAG,EAAE,CACV,UAAU,CAAC,aAAa,CAAC;YACvB,SAAS,EAAE,OAAO;YAClB,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,OAAO;SAChB,CAAC,CACH,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAEhB,MAAM,CAAC,GAAG,EAAE,CACV,UAAU,CAAC,cAAc,CAAC;YACxB,SAAS,EAAE,OAAO;YAClB,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,OAAO;YACf,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;SAChB,CAAC,CACH,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,UAAU,GAAG,UAAU,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC;QAEvE,yEAAyE;QACzE,2BAA2B;QAC3B,MAAM,MAAM,CACV,UAAU,CAAC,YAAY,CAAC;YACtB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBACvB,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE;oBACL,WAAW,EAAE,CAAC;oBACd,YAAY,EAAE,CAAC;oBACf,WAAW,EAAE,CAAC;iBACf;aACF,CAAC;YACF,MAAM,EAAE;gBACN,MAAM,EAAE,EAAE;aACX;SACO,CAAC,CACZ,CAAC,QAAQ,CAAC,aAAa,CAAC;YACvB,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { FlowLogger } from \"../../lib/v3/flowlogger/FlowLogger.js\";\n\ndescribe(\"flow logger llm logging\", () => {\n  it(\"no-ops direct llm logging calls when no flow context is active\", () => {\n    // These helpers are called from multiple model adapters, so they must stay\n    // safe even when a test or utility invokes them outside any ALS flow scope.\n    expect(() =>\n      FlowLogger.logLlmRequest({\n        requestId: \"req-1\",\n        model: \"mock-model\",\n        prompt: \"hello\",\n      }),\n    ).not.toThrow();\n\n    expect(() =>\n      FlowLogger.logLlmResponse({\n        requestId: \"req-1\",\n        model: \"mock-model\",\n        output: \"world\",\n        inputTokens: 1,\n        outputTokens: 1,\n      }),\n    ).not.toThrow();\n  });\n\n  it(\"does not throw from llm middleware when no flow context is active\", async () => {\n    const middleware = FlowLogger.createLlmLoggingMiddleware(\"mock-model\");\n\n    // Missing flow context should degrade to a silent no-op and preserve the\n    // underlying model result.\n    await expect(\n      middleware.wrapGenerate({\n        doGenerate: async () => ({\n          text: \"done\",\n          usage: {\n            inputTokens: 1,\n            outputTokens: 1,\n            totalTokens: 2,\n          },\n        }),\n        params: {\n          prompt: [],\n        },\n      } as never),\n    ).resolves.toMatchObject({\n      text: \"done\",\n    });\n  });\n});\n"]}

package/dist/esm/tests/unit/flowlogger-eventstore.test.d.ts

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