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

package/dist/cjs/tests/unit/public-api/v3-core.test.js

@@ -0,0 +1,108 @@
+"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)("V3 Core public API types", () => {
+    (0, vitest_1.describe)("Stagehand", () => {
+        (0, vitest_1.it)("has correct public interface shape", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+        (0, vitest_1.it)("act accepts Action as first parameter", () => {
+            const mockAction = {};
+            (0, vitest_1.expectTypeOf)().toBeCallableWith(mockAction, {});
+        });
+        (0, vitest_1.it)("extract accepts instruction and schema", () => {
+            const mockSchema = {};
+            (0, vitest_1.expectTypeOf)().toBeCallableWith("instruction", mockSchema, {});
+        });
+        (0, vitest_1.it)("observe accepts instruction and options", () => {
+            (0, vitest_1.expectTypeOf)().toBeCallableWith("instruction", {});
+        });
+        (0, vitest_1.it)("agent execute accepts page option", () => {
+            const mockPage = {};
+            (0, vitest_1.expectTypeOf)().toBeCallableWith({
+                instruction: "test",
+                page: mockPage,
+            });
+        });
+    });
+    (0, vitest_1.describe)("StagehandMetrics", () => {
+        (0, vitest_1.it)("matches the published metrics shape", () => {
+            (0, vitest_1.expectTypeOf)().toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("V3", () => {
+        // V3 is the same class as Stagehand, just re-exported with a different name.
+        // The public interface shape is already tested in the "Stagehand" test above.
+        (0, vitest_1.it)("is exported", () => {
+            (0, vitest_1.expect)(Stagehand.V3).toBeDefined();
+        });
+    });
+    (0, vitest_1.describe)("V3Evaluator", () => {
+        (0, vitest_1.it)("is exported", () => {
+            (0, vitest_1.expect)(Stagehand.V3Evaluator).toBeDefined();
+        });
+        (0, vitest_1.it)("has ask method", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+        (0, vitest_1.it)("has batchAsk method", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+    (0, vitest_1.describe)("V3FunctionName", () => {
+        const expectedFunctionNames = [
+            "ACT",
+            "EXTRACT",
+            "OBSERVE",
+            "AGENT",
+        ];
+        (0, vitest_1.it)("matches the known function name literals", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+            void expectedFunctionNames; // Mark as used to satisfy ESLint
+        });
+    });
+    (0, vitest_1.describe)("connectToMCPServer", () => {
+        (0, vitest_1.it)("has correct parameter types", () => {
+            (0, vitest_1.expectTypeOf)(Stagehand.connectToMCPServer).parameters.branded.toEqualTypeOf();
+        });
+    });
+    (0, vitest_1.describe)("LOG_LEVEL_NAMES", () => {
+        (0, vitest_1.it)("maps numeric levels to strings", () => {
+            (0, vitest_1.expectTypeOf)().toExtend();
+        });
+    });
+});
+//# sourceMappingURL=v3-core.test.js.map

package/dist/cjs/tests/unit/public-api/v3-core.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-core.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/v3-core.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\ndescribe(\"V3 Core public API types\", () => {\n  describe(\"Stagehand\", () => {\n    type ExpectedShape = {\n      init: () => Promise<void>;\n      close: (opts?: { force?: boolean }) => Promise<void>;\n      act: (\n        input: string | Stagehand.Action,\n        options?: Stagehand.ActOptions,\n      ) => Promise<Stagehand.ActResult>;\n      extract: (...args: unknown[]) => Promise<unknown>;\n      observe: (...args: unknown[]) => Promise<Stagehand.Action[]>;\n      agent: (config?: Stagehand.AgentConfig) => {\n        execute: (\n          instructionOrOptions: string | Stagehand.AgentExecuteOptions,\n        ) => Promise<Stagehand.AgentResult>;\n      };\n      connectURL: () => string;\n      context: unknown;\n      metrics: Promise<Stagehand.StagehandMetrics>;\n      history: Promise<ReadonlyArray<Stagehand.HistoryEntry>>;\n      llmClient: Stagehand.LLMClient;\n      browserbaseSessionID: string | undefined;\n      browserbaseSessionURL: string | undefined;\n      browserbaseDebugURL: string | undefined;\n      experimental: boolean;\n      logInferenceToFile: boolean;\n      verbose: 0 | 1 | 2;\n      logger: (logLine: Stagehand.LogLine) => void;\n      isAgentReplayActive: () => boolean;\n      recordAgentReplayStep: (step: unknown) => void;\n    };\n\n    type StagehandInstance = InstanceType<typeof Stagehand.Stagehand>;\n\n    it(\"has correct public interface shape\", () => {\n      expectTypeOf<StagehandInstance>().toExtend<ExpectedShape>();\n    });\n\n    it(\"act accepts Action as first parameter\", () => {\n      const mockAction = {} as Stagehand.Action;\n      expectTypeOf<StagehandInstance[\"act\"]>().toBeCallableWith(\n        mockAction,\n        {} as Stagehand.ActOptions,\n      );\n    });\n\n    it(\"extract accepts instruction and schema\", () => {\n      const mockSchema = {} as Stagehand.StagehandZodSchema;\n      expectTypeOf<StagehandInstance[\"extract\"]>().toBeCallableWith(\n        \"instruction\",\n        mockSchema,\n        {} as Stagehand.ExtractOptions,\n      );\n    });\n\n    it(\"observe accepts instruction and options\", () => {\n      expectTypeOf<StagehandInstance[\"observe\"]>().toBeCallableWith(\n        \"instruction\",\n        {} as Stagehand.ObserveOptions,\n      );\n    });\n\n    it(\"agent execute accepts page option\", () => {\n      type AgentReturn = ReturnType<StagehandInstance[\"agent\"]>;\n      const mockPage = {} as Stagehand.AnyPage;\n      expectTypeOf<AgentReturn[\"execute\"]>().toBeCallableWith({\n        instruction: \"test\",\n        page: mockPage,\n      } satisfies Stagehand.AgentExecuteOptions);\n    });\n  });\n\n  describe(\"StagehandMetrics\", () => {\n    type ExpectedStagehandMetrics = {\n      actPromptTokens: number;\n      actCompletionTokens: number;\n      actReasoningTokens: number;\n      actCachedInputTokens: number;\n      actInferenceTimeMs: number;\n      extractPromptTokens: number;\n      extractCompletionTokens: number;\n      extractReasoningTokens: number;\n      extractCachedInputTokens: number;\n      extractInferenceTimeMs: number;\n      observePromptTokens: number;\n      observeCompletionTokens: number;\n      observeReasoningTokens: number;\n      observeCachedInputTokens: number;\n      observeInferenceTimeMs: number;\n      agentPromptTokens: number;\n      agentCompletionTokens: number;\n      agentReasoningTokens: number;\n      agentCachedInputTokens: number;\n      agentInferenceTimeMs: number;\n      totalPromptTokens: number;\n      totalCompletionTokens: number;\n      totalReasoningTokens: number;\n      totalCachedInputTokens: number;\n      totalInferenceTimeMs: number;\n    };\n\n    it(\"matches the published metrics shape\", () => {\n      expectTypeOf<Stagehand.StagehandMetrics>().toEqualTypeOf<ExpectedStagehandMetrics>();\n    });\n  });\n\n  describe(\"V3\", () => {\n    // V3 is the same class as Stagehand, just re-exported with a different name.\n    // The public interface shape is already tested in the \"Stagehand\" test above.\n    it(\"is exported\", () => {\n      expect(Stagehand.V3).toBeDefined();\n    });\n  });\n\n  describe(\"V3Evaluator\", () => {\n    type V3EvaluatorInstance = InstanceType<typeof Stagehand.V3Evaluator>;\n\n    it(\"is exported\", () => {\n      expect(Stagehand.V3Evaluator).toBeDefined();\n    });\n\n    it(\"has ask method\", () => {\n      expectTypeOf<V3EvaluatorInstance[\"ask\"]>().toExtend<\n        (options: unknown) => Promise<unknown>\n      >();\n    });\n\n    it(\"has batchAsk method\", () => {\n      expectTypeOf<V3EvaluatorInstance[\"batchAsk\"]>().toExtend<\n        (options: unknown) => Promise<unknown[]>\n      >();\n    });\n  });\n\n  describe(\"V3FunctionName\", () => {\n    const expectedFunctionNames = [\n      \"ACT\",\n      \"EXTRACT\",\n      \"OBSERVE\",\n      \"AGENT\",\n    ] as const;\n\n    it(\"matches the known function name literals\", () => {\n      expectTypeOf<Stagehand.V3FunctionName>().toExtend<\n        (typeof expectedFunctionNames)[number]\n      >();\n      void expectedFunctionNames; // Mark as used to satisfy ESLint\n    });\n  });\n\n  describe(\"connectToMCPServer\", () => {\n    type ExpectedServerConfig =\n      | string\n      | URL\n      | { command: string; args?: string[]; env?: Record<string, string> }\n      | {\n          serverUrl: string | URL;\n          clientOptions?: unknown;\n          requestOptions?: unknown;\n        };\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.connectToMCPServer,\n      ).parameters.branded.toEqualTypeOf<[ExpectedServerConfig]>();\n    });\n  });\n\n  describe(\"LOG_LEVEL_NAMES\", () => {\n    type ExpectedLOG_LEVEL_NAMES = Record<Stagehand.LogLevel, string>;\n\n    it(\"maps numeric levels to strings\", () => {\n      expectTypeOf<\n        typeof Stagehand.LOG_LEVEL_NAMES\n      >().toExtend<ExpectedLOG_LEVEL_NAMES>();\n    });\n  });\n});\n"]}

package/dist/cjs/tests/unit/safety-confirmation.test.d.ts

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

package/dist/cjs/tests/unit/safety-confirmation.test.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const OpenAICUAClient_js_1 = require("../../lib/v3/agent/OpenAICUAClient.js");
+const GoogleCUAClient_js_1 = require("../../lib/v3/agent/GoogleCUAClient.js");
+const openAISafetyInvoker = OpenAICUAClient_js_1.OpenAICUAClient.prototype.handleSafetyConfirmation;
+const googleSafetyInvoker = GoogleCUAClient_js_1.GoogleCUAClient.prototype.handleSafetyConfirmation;
+function createOpenAIClient() {
+    return new OpenAICUAClient_js_1.OpenAICUAClient("openai", "openai/computer-use-preview", "test instructions", { apiKey: "test" });
+}
+function createGoogleClient() {
+    return new GoogleCUAClient_js_1.GoogleCUAClient("google", "google/gemini-2.5-computer-use-preview-10-2025", "test instructions", { apiKey: "test" });
+}
+(0, vitest_1.describe)("Safety Confirmation Handler", () => {
+    (0, vitest_1.describe)("OpenAI-style (pending_safety_checks)", () => {
+        const mockChecks = [
+            {
+                id: "check-1",
+                code: "malicious_instructions",
+                message: "Potentially harmful action detected",
+            },
+        ];
+        (0, vitest_1.it)("returns checks when handler acknowledges", async () => {
+            const client = createOpenAIClient();
+            const handler = vitest_1.vi.fn(async () => ({
+                acknowledged: true,
+            }));
+            client.setSafetyConfirmationHandler(handler);
+            const logger = vitest_1.vi.fn();
+            const result = await openAISafetyInvoker.call(client, mockChecks, logger);
+            (0, vitest_1.expect)(handler).toHaveBeenCalledWith(mockChecks);
+            (0, vitest_1.expect)(result).toEqual(mockChecks);
+        });
+        (0, vitest_1.it)("returns undefined when handler rejects", async () => {
+            const client = createOpenAIClient();
+            const handler = vitest_1.vi.fn(async () => ({
+                acknowledged: false,
+            }));
+            client.setSafetyConfirmationHandler(handler);
+            const logger = vitest_1.vi.fn();
+            const result = await openAISafetyInvoker.call(client, mockChecks, logger);
+            (0, vitest_1.expect)(handler).toHaveBeenCalledWith(mockChecks);
+            (0, vitest_1.expect)(result).toBeUndefined();
+        });
+        (0, vitest_1.it)("auto-acknowledges when no handler is set", async () => {
+            const client = createOpenAIClient();
+            const logger = vitest_1.vi.fn();
+            const result = await openAISafetyInvoker.call(client, mockChecks, logger);
+            (0, vitest_1.expect)(result).toEqual(mockChecks);
+        });
+    });
+    (0, vitest_1.describe)("Google-style (safety_decision)", () => {
+        const mockDecision = {
+            decision: "require_confirmation",
+            explanation: "Cookie consent dialog detected",
+        };
+        (0, vitest_1.it)("returns 'true' when handler acknowledges", async () => {
+            const client = createGoogleClient();
+            const handler = vitest_1.vi.fn(async () => ({
+                acknowledged: true,
+            }));
+            client.setSafetyConfirmationHandler(handler);
+            const logger = vitest_1.vi.fn();
+            const result = await googleSafetyInvoker.call(client, mockDecision, logger);
+            (0, vitest_1.expect)(handler).toHaveBeenCalledWith([
+                {
+                    id: "google-safety-decision",
+                    code: "safety_decision",
+                    message: JSON.stringify(mockDecision, null, 2),
+                },
+            ]);
+            (0, vitest_1.expect)(result).toBe("true");
+        });
+        (0, vitest_1.it)("returns undefined when handler rejects", async () => {
+            const client = createGoogleClient();
+            const handler = vitest_1.vi.fn(async () => ({
+                acknowledged: false,
+            }));
+            client.setSafetyConfirmationHandler(handler);
+            const logger = vitest_1.vi.fn();
+            const result = await googleSafetyInvoker.call(client, mockDecision, logger);
+            (0, vitest_1.expect)(handler).toHaveBeenCalled();
+            (0, vitest_1.expect)(result).toBeUndefined();
+        });
+        (0, vitest_1.it)("auto-acknowledges when no handler is set", async () => {
+            const client = createGoogleClient();
+            const logger = vitest_1.vi.fn();
+            const result = await googleSafetyInvoker.call(client, mockDecision, logger);
+            (0, vitest_1.expect)(result).toBe("true");
+        });
+        (0, vitest_1.it)("handles string safety decisions", async () => {
+            const client = createGoogleClient();
+            const handler = vitest_1.vi.fn(async () => ({
+                acknowledged: true,
+            }));
+            client.setSafetyConfirmationHandler(handler);
+            const logger = vitest_1.vi.fn();
+            const result = await googleSafetyInvoker.call(client, "Simple string decision", logger);
+            (0, vitest_1.expect)(handler).toHaveBeenCalledWith([
+                {
+                    id: "google-safety-decision",
+                    code: "safety_decision",
+                    message: "Simple string decision",
+                },
+            ]);
+            (0, vitest_1.expect)(result).toBe("true");
+        });
+    });
+});
+//# sourceMappingURL=safety-confirmation.test.js.map

package/dist/cjs/tests/unit/safety-confirmation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safety-confirmation.test.js","sourceRoot":"","sources":["../../../../tests/unit/safety-confirmation.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it, expect, vi } from \"vitest\";\nimport { OpenAICUAClient } from \"../../lib/v3/agent/OpenAICUAClient.js\";\nimport { GoogleCUAClient } from \"../../lib/v3/agent/GoogleCUAClient.js\";\nimport type {\n  SafetyCheck,\n  SafetyConfirmationHandler,\n} from \"../../lib/v3/types/public/agent.js\";\nimport type { LogLine } from \"../../lib/v3/types/public/logs.js\";\n\ntype LoggerMock = (message: LogLine) => void;\n\nconst openAISafetyInvoker = (\n  OpenAICUAClient.prototype as unknown as {\n    handleSafetyConfirmation: (\n      this: OpenAICUAClient,\n      pendingSafetyChecks: SafetyCheck[],\n      logger: LoggerMock,\n    ) => Promise<SafetyCheck[] | undefined>;\n  }\n).handleSafetyConfirmation;\n\nconst googleSafetyInvoker = (\n  GoogleCUAClient.prototype as unknown as {\n    handleSafetyConfirmation: (\n      this: GoogleCUAClient,\n      safetyDecision: unknown,\n      logger: LoggerMock,\n    ) => Promise<string | undefined>;\n  }\n).handleSafetyConfirmation;\n\nfunction createOpenAIClient(): OpenAICUAClient {\n  return new OpenAICUAClient(\n    \"openai\",\n    \"openai/computer-use-preview\",\n    \"test instructions\",\n    { apiKey: \"test\" },\n  );\n}\n\nfunction createGoogleClient(): GoogleCUAClient {\n  return new GoogleCUAClient(\n    \"google\",\n    \"google/gemini-2.5-computer-use-preview-10-2025\",\n    \"test instructions\",\n    { apiKey: \"test\" },\n  );\n}\n\ndescribe(\"Safety Confirmation Handler\", () => {\n  describe(\"OpenAI-style (pending_safety_checks)\", () => {\n    const mockChecks: SafetyCheck[] = [\n      {\n        id: \"check-1\",\n        code: \"malicious_instructions\",\n        message: \"Potentially harmful action detected\",\n      },\n    ];\n\n    it(\"returns checks when handler acknowledges\", async () => {\n      const client = createOpenAIClient();\n      const handler: SafetyConfirmationHandler = vi.fn(async () => ({\n        acknowledged: true,\n      }));\n      client.setSafetyConfirmationHandler(handler);\n      const logger = vi.fn<LoggerMock>();\n      const result = await openAISafetyInvoker.call(client, mockChecks, logger);\n\n      expect(handler).toHaveBeenCalledWith(mockChecks);\n      expect(result).toEqual(mockChecks);\n    });\n\n    it(\"returns undefined when handler rejects\", async () => {\n      const client = createOpenAIClient();\n      const handler: SafetyConfirmationHandler = vi.fn(async () => ({\n        acknowledged: false,\n      }));\n      client.setSafetyConfirmationHandler(handler);\n      const logger = vi.fn<LoggerMock>();\n      const result = await openAISafetyInvoker.call(client, mockChecks, logger);\n\n      expect(handler).toHaveBeenCalledWith(mockChecks);\n      expect(result).toBeUndefined();\n    });\n\n    it(\"auto-acknowledges when no handler is set\", async () => {\n      const client = createOpenAIClient();\n      const logger = vi.fn<LoggerMock>();\n      const result = await openAISafetyInvoker.call(client, mockChecks, logger);\n      expect(result).toEqual(mockChecks);\n    });\n  });\n\n  describe(\"Google-style (safety_decision)\", () => {\n    const mockDecision = {\n      decision: \"require_confirmation\",\n      explanation: \"Cookie consent dialog detected\",\n    };\n\n    it(\"returns 'true' when handler acknowledges\", async () => {\n      const client = createGoogleClient();\n      const handler: SafetyConfirmationHandler = vi.fn(async () => ({\n        acknowledged: true,\n      }));\n      client.setSafetyConfirmationHandler(handler);\n      const logger = vi.fn<LoggerMock>();\n      const result = await googleSafetyInvoker.call(\n        client,\n        mockDecision,\n        logger,\n      );\n\n      expect(handler).toHaveBeenCalledWith([\n        {\n          id: \"google-safety-decision\",\n          code: \"safety_decision\",\n          message: JSON.stringify(mockDecision, null, 2),\n        },\n      ]);\n      expect(result).toBe(\"true\");\n    });\n\n    it(\"returns undefined when handler rejects\", async () => {\n      const client = createGoogleClient();\n      const handler: SafetyConfirmationHandler = vi.fn(async () => ({\n        acknowledged: false,\n      }));\n      client.setSafetyConfirmationHandler(handler);\n      const logger = vi.fn<LoggerMock>();\n      const result = await googleSafetyInvoker.call(\n        client,\n        mockDecision,\n        logger,\n      );\n\n      expect(handler).toHaveBeenCalled();\n      expect(result).toBeUndefined();\n    });\n\n    it(\"auto-acknowledges when no handler is set\", async () => {\n      const client = createGoogleClient();\n      const logger = vi.fn<LoggerMock>();\n      const result = await googleSafetyInvoker.call(\n        client,\n        mockDecision,\n        logger,\n      );\n      expect(result).toBe(\"true\");\n    });\n\n    it(\"handles string safety decisions\", async () => {\n      const client = createGoogleClient();\n      const handler: SafetyConfirmationHandler = vi.fn(async () => ({\n        acknowledged: true,\n      }));\n      client.setSafetyConfirmationHandler(handler);\n      const logger = vi.fn<LoggerMock>();\n      const result = await googleSafetyInvoker.call(\n        client,\n        \"Simple string decision\",\n        logger,\n      );\n\n      expect(handler).toHaveBeenCalledWith([\n        {\n          id: \"google-safety-decision\",\n          code: \"safety_decision\",\n          message: \"Simple string decision\",\n        },\n      ]);\n      expect(result).toBe(\"true\");\n    });\n  });\n});\n"]}

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

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

package/dist/cjs/tests/unit/snapshot-a11y-resolvers.test.js

@@ -0,0 +1,330 @@
+"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 a11yTree_js_1 = require("../../lib/v3/understudy/a11y/snapshot/a11yTree.js");
+const focusSelectors = __importStar(require("../../lib/v3/understudy/a11y/snapshot/focusSelectors.js"));
+const mockCDPSession_js_1 = require("./helpers/mockCDPSession.js");
+const executionContextRegistry_js_1 = require("../../lib/v3/understudy/executionContextRegistry.js");
+const capture_js_1 = require("../../lib/v3/understudy/a11y/snapshot/capture.js");
+const domTree = __importStar(require("../../lib/v3/understudy/a11y/snapshot/domTree.js"));
+const a11yTree = __importStar(require("../../lib/v3/understudy/a11y/snapshot/a11yTree.js"));
+const logger = __importStar(require("../../lib/v3/logger.js"));
+const stringType = "string";
+const baseAxNodes = () => [
+    {
+        nodeId: "1",
+        role: { type: stringType, value: "RootWebArea" },
+        backendDOMNodeId: 100,
+        childIds: ["2"],
+        ignored: false,
+    },
+    {
+        nodeId: "2",
+        role: { type: stringType, value: "link" },
+        name: { type: stringType, value: "Docs" },
+        backendDOMNodeId: 101,
+        parentId: "1",
+        childIds: [],
+        properties: [
+            {
+                name: "url",
+                value: { type: stringType, value: "https://example.com" },
+            },
+        ],
+        ignored: false,
+    },
+];
+const baseHandlers = {
+    "Accessibility.enable": async () => ({}),
+    "Runtime.enable": async () => ({}),
+    "DOM.enable": async () => ({}),
+};
+(0, vitest_1.describe)("a11yForFrame", () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+    });
+    (0, vitest_1.it)("returns full outline and url map when no focus selector is provided", async () => {
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            ...baseHandlers,
+            "Accessibility.getFullAXTree": async () => ({ nodes: baseAxNodes() }),
+        });
+        const opts = {
+            focusSelector: undefined,
+            experimental: false,
+            tagNameMap: { "enc-100": "#document", "enc-101": "a" },
+            scrollableMap: {},
+            encode: (backend) => `enc-${backend}`,
+        };
+        const result = await (0, a11yTree_js_1.a11yForFrame)(session, undefined, opts);
+        (0, vitest_1.expect)(result.scopeApplied).toBe(false);
+        (0, vitest_1.expect)(result.urlMap["enc-101"]).toBe("https://example.com");
+        (0, vitest_1.expect)(result.outline).toContain("Docs");
+    });
+    (0, vitest_1.it)("scopes the tree to the resolved focus selector target", async () => {
+        const nodes = baseAxNodes().map((n) => n.nodeId === "2"
+            ? {
+                ...n,
+                childIds: ["3"],
+            }
+            : n);
+        nodes.push({
+            nodeId: "3",
+            parentId: "2",
+            childIds: [],
+            role: { type: stringType, value: "StaticText" },
+            backendDOMNodeId: 102,
+            ignored: false,
+        });
+        let scopedOnce = false;
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            ...baseHandlers,
+            "Accessibility.getFullAXTree": async (params) => {
+                if (params?.frameId && !scopedOnce) {
+                    scopedOnce = true;
+                    throw new Error("does not belong to the target");
+                }
+                return { nodes };
+            },
+            "DOM.describeNode": async () => ({
+                node: { backendNodeId: 101 },
+            }),
+        });
+        const resolveSpy = vitest_1.vi
+            .spyOn(focusSelectors, "resolveObjectIdForXPath")
+            .mockResolvedValue("object-1");
+        const opts = {
+            focusSelector: "xpath=//a",
+            experimental: false,
+            tagNameMap: { "enc-101": "a" },
+            scrollableMap: {},
+            encode: (backend) => `enc-${backend}`,
+        };
+        const result = await (0, a11yTree_js_1.a11yForFrame)(session, "frame-1", opts);
+        (0, vitest_1.expect)(result.scopeApplied).toBe(true);
+        (0, vitest_1.expect)(result.outline).not.toContain("RootWebArea");
+        (0, vitest_1.expect)(resolveSpy).toHaveBeenCalled();
+        resolveSpy.mockRestore();
+    });
+    (0, vitest_1.it)("falls back to full tree when resolveObjectId throws", async () => {
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            ...baseHandlers,
+            "Accessibility.getFullAXTree": async () => ({ nodes: baseAxNodes() }),
+        });
+        vitest_1.vi.spyOn(focusSelectors, "resolveObjectIdForCss").mockRejectedValue(new Error("fail"));
+        const opts = {
+            focusSelector: ".btn",
+            experimental: false,
+            tagNameMap: {},
+            scrollableMap: {},
+            encode: (backend) => `enc-${backend}`,
+        };
+        const result = await (0, a11yTree_js_1.a11yForFrame)(session, "frame-1", opts);
+        (0, vitest_1.expect)(result.scopeApplied).toBe(false);
+    });
+});
+(0, vitest_1.describe)("resolveObjectIdForXPath", () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+    });
+    (0, vitest_1.it)("evaluates in the target frame's main world when available", async () => {
+        vitest_1.vi.spyOn(executionContextRegistry_js_1.executionContexts, "waitForMainWorld").mockResolvedValue(42);
+        vitest_1.vi.spyOn(executionContextRegistry_js_1.executionContexts, "getMainWorld").mockReturnValue(undefined);
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            "Runtime.evaluate": async (params) => {
+                (0, vitest_1.expect)(params?.contextId).toBe(42);
+                return { result: { objectId: "node-obj" } };
+            },
+        });
+        const objectId = await focusSelectors.resolveObjectIdForXPath(session, "//div", "frame-1");
+        (0, vitest_1.expect)(objectId).toBe("node-obj");
+    });
+    (0, vitest_1.it)("returns null when evaluation throws or reports exception details", async () => {
+        vitest_1.vi.spyOn(executionContextRegistry_js_1.executionContexts, "waitForMainWorld").mockRejectedValue(new Error("missing"));
+        vitest_1.vi.spyOn(executionContextRegistry_js_1.executionContexts, "getMainWorld").mockReturnValue(undefined);
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            "Runtime.evaluate": async () => ({
+                result: {},
+                exceptionDetails: { exception: { description: "bad" } },
+            }),
+        });
+        const objectId = await focusSelectors.resolveObjectIdForXPath(session, "//div", "frame-2");
+        (0, vitest_1.expect)(objectId).toBeNull();
+    });
+});
+(0, vitest_1.describe)("resolveObjectIdForCss", () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+    });
+    (0, vitest_1.it)("returns primary evaluation result when available", async () => {
+        vitest_1.vi.spyOn(executionContextRegistry_js_1.executionContexts, "waitForMainWorld").mockResolvedValue(7);
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            "Runtime.evaluate": async () => ({
+                result: { objectId: "primary-obj" },
+            }),
+        });
+        const objectId = await focusSelectors.resolveObjectIdForCss(session, ".btn", "frame-1");
+        (0, vitest_1.expect)(objectId).toBe("primary-obj");
+    });
+    (0, vitest_1.it)("falls back to the pierce selector when the primary lookup fails", async () => {
+        let call = 0;
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            "Runtime.evaluate": async (params) => {
+                call++;
+                if (call === 1) {
+                    (0, vitest_1.expect)(String(params?.expression)).toContain("resolveCssSelector");
+                    return { result: {} };
+                }
+                (0, vitest_1.expect)(String(params?.expression)).toContain("resolveCssSelectorPierce");
+                return { result: { objectId: "css-obj" } };
+            },
+        });
+        const objectId = await focusSelectors.resolveObjectIdForCss(session, ".btn", undefined);
+        (0, vitest_1.expect)(objectId).toBe("css-obj");
+    });
+    (0, vitest_1.it)("returns null when both primary and fallback evaluations throw", async () => {
+        vitest_1.vi.spyOn(executionContextRegistry_js_1.executionContexts, "waitForMainWorld").mockResolvedValue(11);
+        vitest_1.vi.spyOn(executionContextRegistry_js_1.executionContexts, "getMainWorld").mockReturnValue(undefined);
+        const session = new mockCDPSession_js_1.MockCDPSession({
+            "Runtime.evaluate": async () => ({
+                result: {},
+                exceptionDetails: { exception: { description: "fail" } },
+            }),
+        });
+        const objectId = await focusSelectors.resolveObjectIdForCss(session, ".missing", "frame-1");
+        (0, vitest_1.expect)(objectId).toBeNull();
+    });
+});
+(0, vitest_1.describe)("tryScopedSnapshot", () => {
+    const ordinal = (frameId) => (frameId === "frame-1" ? 0 : 1);
+    const context = {
+        rootId: "frame-1",
+        frames: ["frame-1", "frame-2"],
+        parentByFrame: new Map([
+            ["frame-1", null],
+            ["frame-2", "frame-1"],
+        ]),
+    };
+    const makePage = (session, overrides) => ({
+        mainFrameId: () => "frame-1",
+        asProtocolFrameTree: () => ({
+            frame: { id: "frame-1" },
+            childFrames: [{ frame: { id: "frame-2" } }],
+        }),
+        listAllFrameIds: () => ["frame-1", "frame-2"],
+        getSessionForFrame: () => session,
+        getOrdinal: (fid) => ordinal(fid),
+        ...overrides,
+    });
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+    });
+    (0, vitest_1.it)("returns scoped snapshot when focus selector resolves via CSS hops", async () => {
+        const session = new mockCDPSession_js_1.MockCDPSession({});
+        const domMapsSpy = vitest_1.vi
+            .spyOn(domTree, "domMapsForSession")
+            .mockResolvedValue({
+            tagNameMap: { "1-10": "div" },
+            xpathMap: { "1-10": "/div[1]" },
+            scrollableMap: {},
+        });
+        const a11ySpy = vitest_1.vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
+            outline: "[1-10] div",
+            urlMap: { "1-10": "https://example.com" },
+            scopeApplied: true,
+        });
+        vitest_1.vi.spyOn(focusSelectors, "resolveCssFocusFrameAndTail").mockResolvedValue({
+            targetFrameId: "frame-2",
+            tailSelector: ".btn-inner",
+            absPrefix: "/html/body/iframe[1]",
+        });
+        const result = await (0, capture_js_1.tryScopedSnapshot)(makePage(session), { focusSelector: ".btn" }, context, true);
+        (0, vitest_1.expect)(result).not.toBeNull();
+        (0, vitest_1.expect)(result?.combinedXpathMap["1-10"]).toBe("/html/body/iframe[1]/div[1]");
+        (0, vitest_1.expect)(domMapsSpy).toHaveBeenCalled();
+        (0, vitest_1.expect)(a11ySpy).toHaveBeenCalled();
+    });
+    (0, vitest_1.it)("returns null and logs fallback when scope is not applied", async () => {
+        const session = new mockCDPSession_js_1.MockCDPSession({});
+        vitest_1.vi.spyOn(domTree, "domMapsForSession").mockResolvedValue({
+            tagNameMap: { "1-10": "div" },
+            xpathMap: { "1-10": "/div[1]" },
+            scrollableMap: {},
+        });
+        vitest_1.vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
+            outline: "ignored",
+            urlMap: {},
+            scopeApplied: false,
+        });
+        const loggerSpy = vitest_1.vi.spyOn(logger, "v3Logger").mockImplementation(() => { });
+        const result = await (0, capture_js_1.tryScopedSnapshot)(makePage(session), { focusSelector: ".btn" }, context, false);
+        (0, vitest_1.expect)(result).toBeNull();
+        (0, vitest_1.expect)(loggerSpy).toHaveBeenCalled();
+    });
+    (0, vitest_1.it)("returns null immediately when no focus selector is provided", async () => {
+        const result = await (0, capture_js_1.tryScopedSnapshot)(makePage(new mockCDPSession_js_1.MockCDPSession({})), {}, context, true);
+        (0, vitest_1.expect)(result).toBeNull();
+    });
+    (0, vitest_1.it)("supports XPath focus resolution branch", async () => {
+        const session = new mockCDPSession_js_1.MockCDPSession({});
+        vitest_1.vi.spyOn(domTree, "domMapsForSession").mockResolvedValue({
+            tagNameMap: { "1-10": "div" },
+            xpathMap: { "1-10": "/div[1]" },
+            scrollableMap: {},
+        });
+        vitest_1.vi.spyOn(a11yTree, "a11yForFrame").mockResolvedValue({
+            outline: "[1-10] div",
+            urlMap: {},
+            scopeApplied: true,
+        });
+        vitest_1.vi.spyOn(focusSelectors, "resolveFocusFrameAndTail").mockResolvedValue({
+            targetFrameId: "frame-1",
+            tailXPath: "//div[1]",
+            absPrefix: "",
+        });
+        const result = await (0, capture_js_1.tryScopedSnapshot)(makePage(session), { focusSelector: "xpath=//div" }, context, true);
+        (0, vitest_1.expect)(result).not.toBeNull();
+        (0, vitest_1.expect)(result?.combinedXpathMap["1-10"]).toBe("/div[1]");
+    });
+    (0, vitest_1.it)("logs and returns null when resolver throws", async () => {
+        const session = new mockCDPSession_js_1.MockCDPSession({});
+        vitest_1.vi.spyOn(focusSelectors, "resolveCssFocusFrameAndTail").mockRejectedValue(new Error("bad selector"));
+        const loggerSpy = vitest_1.vi.spyOn(logger, "v3Logger").mockImplementation(() => { });
+        const result = await (0, capture_js_1.tryScopedSnapshot)(makePage(session), { focusSelector: ".bad" }, context, true);
+        (0, vitest_1.expect)(result).toBeNull();
+        (0, vitest_1.expect)(loggerSpy).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=snapshot-a11y-resolvers.test.js.map