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

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

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const api_js_1 = require("../../lib/v3/api.js");
+(0, vitest_1.describe)("StagehandAPIClient variable serialization", () => {
+    (0, vitest_1.it)("preserves rich variables when sending the act request", async () => {
+        const client = new api_js_1.StagehandAPIClient({
+            apiKey: "bb-test",
+            logger: vitest_1.vi.fn(),
+        });
+        const executeMock = vitest_1.vi.fn().mockResolvedValue({
+            success: true,
+            message: "ok",
+            actionDescription: "typed",
+            actions: [],
+        });
+        client.execute = executeMock;
+        await client.act({
+            input: "type %username% into the email field",
+            options: {
+                variables: {
+                    username: {
+                        value: "john@example.com",
+                        description: "The login email",
+                    },
+                    password: "secret",
+                },
+            },
+        });
+        (0, vitest_1.expect)(executeMock).toHaveBeenCalledWith({
+            method: "act",
+            args: {
+                input: "type %username% into the email field",
+                options: {
+                    variables: {
+                        username: {
+                            value: "john@example.com",
+                            description: "The login email",
+                        },
+                        password: "secret",
+                    },
+                },
+                frameId: undefined,
+            },
+            serverCache: undefined,
+        });
+    });
+    (0, vitest_1.it)("preserves rich variables when sending the observe request", async () => {
+        const client = new api_js_1.StagehandAPIClient({
+            apiKey: "bb-test",
+            logger: vitest_1.vi.fn(),
+        });
+        const executeMock = vitest_1.vi.fn().mockResolvedValue([]);
+        client.execute = executeMock;
+        await client.observe({
+            instruction: "find the field where %username% should be entered",
+            options: {
+                variables: {
+                    username: {
+                        value: "john@example.com",
+                        description: "The login email",
+                    },
+                    password: "secret",
+                },
+            },
+        });
+        (0, vitest_1.expect)(executeMock).toHaveBeenCalledWith({
+            method: "observe",
+            args: {
+                instruction: "find the field where %username% should be entered",
+                options: {
+                    variables: {
+                        username: {
+                            value: "john@example.com",
+                            description: "The login email",
+                        },
+                        password: "secret",
+                    },
+                },
+                frameId: undefined,
+            },
+            serverCache: undefined,
+        });
+    });
+});
+//# sourceMappingURL=api-client-observe-variables.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api-client-observe-variables.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-client-observe-variables.test.ts"],"names":[],"mappings":";;AAAA,mCAAkD;AAClD,gDAAyD;AAEzD,IAAA,iBAAQ,EAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,IAAA,WAAE,EAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,MAAM,GAAG,IAAI,2BAAkB,CAAC;YACpC,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,WAAE,CAAC,EAAE,EAAE;SAChB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAC5C,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,OAAO;YAC1B,OAAO,EAAE,EAAE;SACZ,CAAC,CAAC;QAGD,MAGD,CAAC,OAAO,GAAG,WAAW,CAAC;QAExB,MAAM,MAAM,CAAC,GAAG,CAAC;YACf,KAAK,EAAE,sCAAsC;YAC7C,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,QAAQ,EAAE,QAAQ;iBACnB;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC;YACvC,MAAM,EAAE,KAAK;YACb,IAAI,EAAE;gBACJ,KAAK,EAAE,sCAAsC;gBAC7C,OAAO,EAAE;oBACP,SAAS,EAAE;wBACT,QAAQ,EAAE;4BACR,KAAK,EAAE,kBAAkB;4BACzB,WAAW,EAAE,iBAAiB;yBAC/B;wBACD,QAAQ,EAAE,QAAQ;qBACnB;iBACF;gBACD,OAAO,EAAE,SAAS;aACnB;YACD,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,MAAM,GAAG,IAAI,2BAAkB,CAAC;YACpC,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,WAAE,CAAC,EAAE,EAAE;SAChB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAGhD,MAGD,CAAC,OAAO,GAAG,WAAW,CAAC;QAExB,MAAM,MAAM,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,mDAAmD;YAChE,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,QAAQ,EAAE,QAAQ;iBACnB;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC;YACvC,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE;gBACJ,WAAW,EAAE,mDAAmD;gBAChE,OAAO,EAAE;oBACP,SAAS,EAAE;wBACT,QAAQ,EAAE;4BACR,KAAK,EAAE,kBAAkB;4BACzB,WAAW,EAAE,iBAAiB;yBAC/B;wBACD,QAAQ,EAAE,QAAQ;qBACnB;iBACF;gBACD,OAAO,EAAE,SAAS;aACnB;YACD,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it, vi } from \"vitest\";\nimport { StagehandAPIClient } from \"../../lib/v3/api.js\";\n\ndescribe(\"StagehandAPIClient variable serialization\", () => {\n  it(\"preserves rich variables when sending the act request\", async () => {\n    const client = new StagehandAPIClient({\n      apiKey: \"bb-test\",\n      logger: vi.fn(),\n    });\n    const executeMock = vi.fn().mockResolvedValue({\n      success: true,\n      message: \"ok\",\n      actionDescription: \"typed\",\n      actions: [],\n    });\n\n    (\n      client as unknown as {\n        execute: typeof executeMock;\n      }\n    ).execute = executeMock;\n\n    await client.act({\n      input: \"type %username% into the email field\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          password: \"secret\",\n        },\n      },\n    });\n\n    expect(executeMock).toHaveBeenCalledWith({\n      method: \"act\",\n      args: {\n        input: \"type %username% into the email field\",\n        options: {\n          variables: {\n            username: {\n              value: \"john@example.com\",\n              description: \"The login email\",\n            },\n            password: \"secret\",\n          },\n        },\n        frameId: undefined,\n      },\n      serverCache: undefined,\n    });\n  });\n\n  it(\"preserves rich variables when sending the observe request\", async () => {\n    const client = new StagehandAPIClient({\n      apiKey: \"bb-test\",\n      logger: vi.fn(),\n    });\n    const executeMock = vi.fn().mockResolvedValue([]);\n\n    (\n      client as unknown as {\n        execute: typeof executeMock;\n      }\n    ).execute = executeMock;\n\n    await client.observe({\n      instruction: \"find the field where %username% should be entered\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          password: \"secret\",\n        },\n      },\n    });\n\n    expect(executeMock).toHaveBeenCalledWith({\n      method: \"observe\",\n      args: {\n        instruction: \"find the field where %username% should be entered\",\n        options: {\n          variables: {\n            username: {\n              value: \"john@example.com\",\n              description: \"The login email\",\n            },\n            password: \"secret\",\n          },\n        },\n        frameId: undefined,\n      },\n      serverCache: undefined,\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/api-variables-schema.test.d.ts

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

package/dist/cjs/tests/unit/api-variables-schema.test.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("../../lib/v3/types/public/index.js");
+(0, vitest_1.describe)("API variable schemas", () => {
+    (0, vitest_1.it)("accepts rich variables for act requests", () => {
+        const result = index_js_1.Api.ActRequestSchema.safeParse({
+            input: "type %username% into the email field",
+            options: {
+                variables: {
+                    username: {
+                        value: "john@example.com",
+                        description: "The login email",
+                    },
+                    rememberMe: true,
+                },
+            },
+        });
+        (0, vitest_1.expect)(result.success).toBe(true);
+    });
+    (0, vitest_1.it)("accepts rich variables for observe requests", () => {
+        const result = index_js_1.Api.ObserveRequestSchema.safeParse({
+            instruction: "find the field where %username% should be entered",
+            options: {
+                variables: {
+                    username: {
+                        value: "john@example.com",
+                        description: "The login email",
+                    },
+                    rememberMe: true,
+                },
+            },
+        });
+        (0, vitest_1.expect)(result.success).toBe(true);
+    });
+});
+//# sourceMappingURL=api-variables-schema.test.js.map

package/dist/cjs/tests/unit/api-variables-schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-variables-schema.test.js","sourceRoot":"","sources":["../../../../tests/unit/api-variables-schema.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,iEAAyD;AAEzD,IAAA,iBAAQ,EAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,IAAA,WAAE,EAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG,cAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC;YAC5C,KAAK,EAAE,sCAAsC;YAC7C,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,UAAU,EAAE,IAAI;iBACjB;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,cAAG,CAAC,oBAAoB,CAAC,SAAS,CAAC;YAChD,WAAW,EAAE,mDAAmD;YAChE,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,QAAQ,EAAE;wBACR,KAAK,EAAE,kBAAkB;wBACzB,WAAW,EAAE,iBAAiB;qBAC/B;oBACD,UAAU,EAAE,IAAI;iBACjB;aACF;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport { Api } from \"../../lib/v3/types/public/index.js\";\n\ndescribe(\"API variable schemas\", () => {\n  it(\"accepts rich variables for act requests\", () => {\n    const result = Api.ActRequestSchema.safeParse({\n      input: \"type %username% into the email field\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          rememberMe: true,\n        },\n      },\n    });\n\n    expect(result.success).toBe(true);\n  });\n\n  it(\"accepts rich variables for observe requests\", () => {\n    const result = Api.ObserveRequestSchema.safeParse({\n      instruction: \"find the field where %username% should be entered\",\n      options: {\n        variables: {\n          username: {\n            value: \"john@example.com\",\n            description: \"The login email\",\n          },\n          rememberMe: true,\n        },\n      },\n    });\n\n    expect(result.success).toBe(true);\n  });\n});\n"]}

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

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

package/dist/cjs/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":";;AAAA,mCAAyE;AACzE,8CAAwC;AAExC,MAAM,eAAe,GAAG,aAAa,CAAC;AACtC,MAAM,gBAAgB,GAAG,wCAAwC,eAAe,EAAE,CAAC;AACnF,MAAM,cAAc,GAAG,iCAAiC,eAAe,EAAE,CAAC;AAE1E,WAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC9C,MAAM,cAAc;QAClB,iBAAiB,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,kBAAkB,GAAG,WAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,GAAG,WAAE,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,WAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE,CAAC,CAAC;IAChD,wBAAwB,EAAE,WAAE,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,WAAE,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,WAAE,CAAC,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,iBAAiB,EAAE,WAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACpC,EAAE,EAAE,gBAAgB;QACpB,MAAM,EAAE,EAAE,IAAI,EAAE,WAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAE,CAAC,CAAC,EAAE;KACxC,CAAC,CAAC;CACJ,CAAC,CAAC,CAAC;AAEJ,IAAA,iBAAQ,EAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,IAAA,mBAAU,EAAC,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,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACvC,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;QAC1C,WAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,EAAE,GAAG,IAAI,UAAE,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,IAAA,eAAM,EAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACxD,IAAA,eAAM,EAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtD,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,IAAA,WAAE,EAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,EAAE,GAAG,IAAI,UAAE,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,IAAA,eAAM,EAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,aAAa,EAAE,CAAC;QACjD,IAAA,eAAM,EAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,aAAa,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAA,WAAE,EAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,EAAE,GAAG,IAAI,UAAE,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,IAAA,eAAM,EAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,aAAa,EAAE,CAAC;YACjD,IAAA,eAAM,EAAC,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    } 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":"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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      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/cjs/tests/unit/captcha-solver.test.d.ts

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

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

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const captchaSolver_js_1 = require("../../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;
+    }
+}
+(0, vitest_1.describe)("CaptchaSolver", () => {
+    (0, vitest_1.it)("resolves all concurrent waiters when a solve finishes", async () => {
+        const page = new MockPage();
+        const solver = new captchaSolver_js_1.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;
+        (0, vitest_1.expect)(sharedWaitPromise).not.toBeNull();
+        (0, vitest_1.expect)(solver.waitPromise).toBe(sharedWaitPromise);
+        let firstResolved = false;
+        let secondResolved = false;
+        void firstWait.then(() => {
+            firstResolved = true;
+        });
+        void secondWait.then(() => {
+            secondResolved = true;
+        });
+        await Promise.resolve();
+        (0, vitest_1.expect)(firstResolved).toBe(false);
+        (0, vitest_1.expect)(secondResolved).toBe(false);
+        page.emitConsole(SOLVING_FINISHED);
+        await Promise.all([firstWait, secondWait]);
+        (0, vitest_1.expect)(firstResolved).toBe(true);
+        (0, vitest_1.expect)(secondResolved).toBe(true);
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: true,
+            errored: false,
+        });
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: false,
+        });
+    });
+    (0, vitest_1.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_js_1.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;
+        (0, vitest_1.expect)(settled).toBe(true);
+        (0, vitest_1.expect)(firstPage.offCalls).toBe(1);
+        (0, vitest_1.expect)(firstPage.listenerCount()).toBe(0);
+        (0, vitest_1.expect)(secondPage.onCalls).toBe(1);
+        (0, vitest_1.expect)(secondPage.listenerCount()).toBe(1);
+        (0, vitest_1.expect)(solver.isSolving()).toBe(false);
+    });
+    (0, vitest_1.it)("surfaces solver errors exactly once per consume", async () => {
+        const page = new MockPage();
+        const solver = new captchaSolver_js_1.CaptchaSolver();
+        solver.init(async () => page);
+        await solver.ensureAttached();
+        page.emitConsole(SOLVING_STARTED);
+        const wait = solver.waitIfSolving();
+        page.emitConsole(SOLVING_ERRORED);
+        await wait;
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: true,
+        });
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: false,
+        });
+    });
+    (0, vitest_1.it)("disposes cleanly while a solve is in progress", async () => {
+        const page = new MockPage();
+        const solver = new captchaSolver_js_1.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;
+        (0, vitest_1.expect)(settled).toBe(true);
+        (0, vitest_1.expect)(solver.isSolving()).toBe(false);
+        (0, vitest_1.expect)(page.listenerCount()).toBe(0);
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: false,
+        });
+    });
+    (0, vitest_1.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_js_1.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
+        (0, vitest_1.expect)(solver.consumeSolveResult()).toEqual({
+            solved: false,
+            errored: true,
+        });
+    });
+});
+//# sourceMappingURL=captcha-solver.test.js.map

package/dist/cjs/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/cjs/tests/unit/flowlogger-capturing-cdp.test.d.ts

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

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

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_events_1 = require("node:events");
+const vitest_1 = require("vitest");
+const cdp_js_1 = require("../../lib/v3/understudy/cdp.js");
+const EventSink_js_1 = require("../../lib/v3/flowlogger/EventSink.js");
+const EventEmitter_js_1 = require("../../lib/v3/flowlogger/EventEmitter.js");
+const EventStore_js_1 = require("../../lib/v3/flowlogger/EventStore.js");
+const FlowLogger_js_1 = require("../../lib/v3/flowlogger/FlowLogger.js");
+function attachEventStoreToBus(store, bus) {
+    const onFlowEvent = (event) => {
+        if (event instanceof FlowLogger_js_1.FlowEvent) {
+            void store.emit(event);
+        }
+    };
+    bus.on("*", onFlowEvent);
+    return () => {
+        bus.off("*", onFlowEvent);
+    };
+}
+class FakeSocket extends node_events_1.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 = cdp_js_1.CdpConnection;
+    return new ConnectionCtor(socket);
+}
+function requireEvent(events, predicate, description) {
+    const match = events.find(predicate);
+    (0, vitest_1.expect)(match, `missing ${description}`).toBeDefined();
+    return match;
+}
+(0, vitest_1.describe)("flow logger cdp context", () => {
+    (0, vitest_1.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 EventEmitter_js_1.EventEmitterWithWildcardSupport();
+        const sink = new EventSink_js_1.InMemoryEventSink();
+        const eventStore = new EventStore_js_1.EventStore(sessionId, undefined, sink);
+        const detachBus = attachEventStoreToBus(eventStore, eventBus);
+        const conn = createConnection(socket);
+        conn.flowLoggerContext = FlowLogger_js_1.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");
+        (0, vitest_1.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_js_1.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");
+        (0, vitest_1.expect)(nestedCallEvent.eventParentIds).toEqual([parentEvent.eventId]);
+        detachBus();
+        await eventStore.destroy();
+    });
+});
+//# sourceMappingURL=flowlogger-capturing-cdp.test.js.map

package/dist/cjs/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/cjs/tests/unit/flowlogger-capturing-llm.test.d.ts

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

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

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const FlowLogger_js_1 = require("../../lib/v3/flowlogger/FlowLogger.js");
+(0, vitest_1.describe)("flow logger llm logging", () => {
+    (0, vitest_1.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.
+        (0, vitest_1.expect)(() => FlowLogger_js_1.FlowLogger.logLlmRequest({
+            requestId: "req-1",
+            model: "mock-model",
+            prompt: "hello",
+        })).not.toThrow();
+        (0, vitest_1.expect)(() => FlowLogger_js_1.FlowLogger.logLlmResponse({
+            requestId: "req-1",
+            model: "mock-model",
+            output: "world",
+            inputTokens: 1,
+            outputTokens: 1,
+        })).not.toThrow();
+    });
+    (0, vitest_1.it)("does not throw from llm middleware when no flow context is active", async () => {
+        const middleware = FlowLogger_js_1.FlowLogger.createLlmLoggingMiddleware("mock-model");
+        // Missing flow context should degrade to a silent no-op and preserve the
+        // underlying model result.
+        await (0, vitest_1.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/cjs/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,mCAA8C;AAC9C,yEAAmE;AAEnE,IAAA,iBAAQ,EAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAA,WAAE,EAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,2EAA2E;QAC3E,4EAA4E;QAC5E,IAAA,eAAM,EAAC,GAAG,EAAE,CACV,0BAAU,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,IAAA,eAAM,EAAC,GAAG,EAAE,CACV,0BAAU,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,IAAA,WAAE,EAAC,mEAAmE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,UAAU,GAAG,0BAAU,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC;QAEvE,yEAAyE;QACzE,2BAA2B;QAC3B,MAAM,IAAA,eAAM,EACV,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/cjs/tests/unit/flowlogger-eventstore.test.d.ts

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