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

package/dist/esm/tests/unit/public-api/schema-utils.test.js

@@ -0,0 +1,60 @@
+import { describe, expectTypeOf, it } from "vitest";
+import * as Stagehand from "@browserbasehq/stagehand";
+describe("Schema Utils public API types", () => {
+    describe("defaultExtractSchema", () => {
+        it("infers to the correct type", () => {
+            expectTypeOf().toEqualTypeOf();
+        });
+    });
+    describe("getZodType", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.getZodType).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("isZod3Schema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.isZod3Schema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("isZod4Schema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.isZod4Schema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("jsonSchemaToZod", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.jsonSchemaToZod).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("pageTextSchema", () => {
+        it("infers to the correct type", () => {
+            expectTypeOf().toEqualTypeOf();
+        });
+    });
+    describe("toGeminiSchema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.toGeminiSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("toJsonSchema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.toJsonSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("transformSchema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.transformSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("trimTrailingTextNode", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.trimTrailingTextNode).parameters.branded.toEqualTypeOf();
+        });
+    });
+    describe("validateZodSchema", () => {
+        it("has correct parameter types", () => {
+            expectTypeOf(Stagehand.validateZodSchema).parameters.branded.toEqualTypeOf();
+        });
+    });
+});
+//# sourceMappingURL=schema-utils.test.js.map

package/dist/esm/tests/unit/public-api/schema-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/schema-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expectTypeOf, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\ndescribe(\"Schema Utils public API types\", () => {\n  describe(\"defaultExtractSchema\", () => {\n    type ExpectedInferredType = { extraction: string };\n\n    it(\"infers to the correct type\", () => {\n      expectTypeOf<\n        Stagehand.InferStagehandSchema<typeof Stagehand.defaultExtractSchema>\n      >().toEqualTypeOf<ExpectedInferredType>();\n    });\n  });\n\n  describe(\"getZodType\", () => {\n    type ExpectedGetZodTypeParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.getZodType,\n      ).parameters.branded.toEqualTypeOf<ExpectedGetZodTypeParams>();\n    });\n  });\n\n  describe(\"isZod3Schema\", () => {\n    type ExpectedIsZod3SchemaParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.isZod3Schema,\n      ).parameters.branded.toEqualTypeOf<ExpectedIsZod3SchemaParams>();\n    });\n  });\n\n  describe(\"isZod4Schema\", () => {\n    type ExpectedIsZod4SchemaParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.isZod4Schema,\n      ).parameters.branded.toEqualTypeOf<ExpectedIsZod4SchemaParams>();\n    });\n  });\n\n  describe(\"jsonSchemaToZod\", () => {\n    type ExpectedJsonSchemaToZodParams = [Stagehand.JsonSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.jsonSchemaToZod,\n      ).parameters.branded.toEqualTypeOf<ExpectedJsonSchemaToZodParams>();\n    });\n  });\n\n  describe(\"pageTextSchema\", () => {\n    type ExpectedInferredType = { pageText: string };\n\n    it(\"infers to the correct type\", () => {\n      expectTypeOf<\n        Stagehand.InferStagehandSchema<typeof Stagehand.pageTextSchema>\n      >().toEqualTypeOf<ExpectedInferredType>();\n    });\n  });\n\n  describe(\"toGeminiSchema\", () => {\n    type ExpectedToGeminiSchemaParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.toGeminiSchema,\n      ).parameters.branded.toEqualTypeOf<ExpectedToGeminiSchemaParams>();\n    });\n  });\n\n  describe(\"toJsonSchema\", () => {\n    type ExpectedToJsonSchemaParams = [Stagehand.StagehandZodSchema];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.toJsonSchema,\n      ).parameters.branded.toEqualTypeOf<ExpectedToJsonSchemaParams>();\n    });\n  });\n\n  describe(\"transformSchema\", () => {\n    type ExpectedTransformSchemaParams = [\n      Stagehand.StagehandZodSchema,\n      Array<string | number>,\n    ];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.transformSchema,\n      ).parameters.branded.toEqualTypeOf<ExpectedTransformSchemaParams>();\n    });\n  });\n\n  describe(\"trimTrailingTextNode\", () => {\n    type ExpectedTrimTrailingTextNodeParams = [string | undefined];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.trimTrailingTextNode,\n      ).parameters.branded.toEqualTypeOf<ExpectedTrimTrailingTextNodeParams>();\n    });\n  });\n\n  describe(\"validateZodSchema\", () => {\n    type ExpectedValidateZodSchemaParams = [\n      Stagehand.StagehandZodSchema,\n      unknown,\n    ];\n\n    it(\"has correct parameter types\", () => {\n      expectTypeOf(\n        Stagehand.validateZodSchema,\n      ).parameters.branded.toEqualTypeOf<ExpectedValidateZodSchemaParams>();\n    });\n  });\n});\n"]}

package/dist/esm/tests/unit/public-api/timeout-error-types.test.d.ts

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

package/dist/esm/tests/unit/public-api/timeout-error-types.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it } from "vitest";
+import * as Stagehand from "@browserbasehq/stagehand";
+// ============================================================================
+// Public Timeout Error Types Runtime Tests
+// ============================================================================
+// These tests verify the runtime behavior of exported timeout error types,
+// complementing the type-level tests in public-error-types.test.ts
+describe("Public timeout error types runtime behavior", () => {
+    describe("ActTimeoutError", () => {
+        it("is exported and extends Error", () => {
+            const error = new Stagehand.ActTimeoutError(1000);
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(Stagehand.ActTimeoutError);
+            expect(error.name).toBe("ActTimeoutError");
+        });
+        it("contains timeout value in milliseconds in message", () => {
+            const error = new Stagehand.ActTimeoutError(500);
+            expect(error.message).toContain("500ms");
+        });
+        it("contains operation name in message", () => {
+            const error = new Stagehand.ActTimeoutError(100);
+            expect(error.message).toContain("act()");
+        });
+        it("extends TimeoutError", () => {
+            const error = new Stagehand.ActTimeoutError(1000);
+            expect(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+    });
+    describe("ExtractTimeoutError", () => {
+        it("is exported and extends Error", () => {
+            const error = new Stagehand.ExtractTimeoutError(1000);
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(Stagehand.ExtractTimeoutError);
+            expect(error.name).toBe("ExtractTimeoutError");
+        });
+        it("contains timeout value in milliseconds in message", () => {
+            const error = new Stagehand.ExtractTimeoutError(1000);
+            expect(error.message).toContain("1000ms");
+        });
+        it("contains operation name in message", () => {
+            const error = new Stagehand.ExtractTimeoutError(100);
+            expect(error.message).toContain("extract()");
+        });
+        it("extends TimeoutError", () => {
+            const error = new Stagehand.ExtractTimeoutError(1000);
+            expect(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+    });
+    describe("ObserveTimeoutError", () => {
+        it("is exported and extends Error", () => {
+            const error = new Stagehand.ObserveTimeoutError(1000);
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(Stagehand.ObserveTimeoutError);
+            expect(error.name).toBe("ObserveTimeoutError");
+        });
+        it("contains timeout value in milliseconds in message", () => {
+            const error = new Stagehand.ObserveTimeoutError(1500);
+            expect(error.message).toContain("1500ms");
+        });
+        it("contains operation name in message", () => {
+            const error = new Stagehand.ObserveTimeoutError(100);
+            expect(error.message).toContain("observe()");
+        });
+        it("extends TimeoutError", () => {
+            const error = new Stagehand.ObserveTimeoutError(1000);
+            expect(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+    });
+    describe("TimeoutError (base class)", () => {
+        it("is exported and extends Error", () => {
+            const error = new Stagehand.TimeoutError("custom operation", 2000);
+            expect(error).toBeInstanceOf(Error);
+            expect(error).toBeInstanceOf(Stagehand.TimeoutError);
+        });
+        it("contains operation name and timeout in message", () => {
+            const error = new Stagehand.TimeoutError("custom operation", 2000);
+            expect(error.message).toContain("custom operation");
+            expect(error.message).toContain("2000ms");
+        });
+        it("extends StagehandError", () => {
+            const error = new Stagehand.TimeoutError("operation", 1000);
+            expect(error).toBeInstanceOf(Stagehand.StagehandError);
+        });
+    });
+});
+//# sourceMappingURL=timeout-error-types.test.js.map

package/dist/esm/tests/unit/public-api/timeout-error-types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout-error-types.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/timeout-error-types.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AAEtD,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAC/E,2EAA2E;AAC3E,mEAAmE;AAEnE,QAAQ,CAAC,6CAA6C,EAAE,GAAG,EAAE;IAC3D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YACxD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;YAC9B,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YAC5D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;YAC9B,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YAC5D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;YAC3D,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;YAC5C,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACrD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;YAC9B,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,YAAY,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;YACnE,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,YAAY,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;YACnE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC5D,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expect, it } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\n\n// ============================================================================\n// Public Timeout Error Types Runtime Tests\n// ============================================================================\n// These tests verify the runtime behavior of exported timeout error types,\n// complementing the type-level tests in public-error-types.test.ts\n\ndescribe(\"Public timeout error types runtime behavior\", () => {\n  describe(\"ActTimeoutError\", () => {\n    it(\"is exported and extends Error\", () => {\n      const error = new Stagehand.ActTimeoutError(1000);\n      expect(error).toBeInstanceOf(Error);\n      expect(error).toBeInstanceOf(Stagehand.ActTimeoutError);\n      expect(error.name).toBe(\"ActTimeoutError\");\n    });\n\n    it(\"contains timeout value in milliseconds in message\", () => {\n      const error = new Stagehand.ActTimeoutError(500);\n      expect(error.message).toContain(\"500ms\");\n    });\n\n    it(\"contains operation name in message\", () => {\n      const error = new Stagehand.ActTimeoutError(100);\n      expect(error.message).toContain(\"act()\");\n    });\n\n    it(\"extends TimeoutError\", () => {\n      const error = new Stagehand.ActTimeoutError(1000);\n      expect(error).toBeInstanceOf(Stagehand.TimeoutError);\n    });\n  });\n\n  describe(\"ExtractTimeoutError\", () => {\n    it(\"is exported and extends Error\", () => {\n      const error = new Stagehand.ExtractTimeoutError(1000);\n      expect(error).toBeInstanceOf(Error);\n      expect(error).toBeInstanceOf(Stagehand.ExtractTimeoutError);\n      expect(error.name).toBe(\"ExtractTimeoutError\");\n    });\n\n    it(\"contains timeout value in milliseconds in message\", () => {\n      const error = new Stagehand.ExtractTimeoutError(1000);\n      expect(error.message).toContain(\"1000ms\");\n    });\n\n    it(\"contains operation name in message\", () => {\n      const error = new Stagehand.ExtractTimeoutError(100);\n      expect(error.message).toContain(\"extract()\");\n    });\n\n    it(\"extends TimeoutError\", () => {\n      const error = new Stagehand.ExtractTimeoutError(1000);\n      expect(error).toBeInstanceOf(Stagehand.TimeoutError);\n    });\n  });\n\n  describe(\"ObserveTimeoutError\", () => {\n    it(\"is exported and extends Error\", () => {\n      const error = new Stagehand.ObserveTimeoutError(1000);\n      expect(error).toBeInstanceOf(Error);\n      expect(error).toBeInstanceOf(Stagehand.ObserveTimeoutError);\n      expect(error.name).toBe(\"ObserveTimeoutError\");\n    });\n\n    it(\"contains timeout value in milliseconds in message\", () => {\n      const error = new Stagehand.ObserveTimeoutError(1500);\n      expect(error.message).toContain(\"1500ms\");\n    });\n\n    it(\"contains operation name in message\", () => {\n      const error = new Stagehand.ObserveTimeoutError(100);\n      expect(error.message).toContain(\"observe()\");\n    });\n\n    it(\"extends TimeoutError\", () => {\n      const error = new Stagehand.ObserveTimeoutError(1000);\n      expect(error).toBeInstanceOf(Stagehand.TimeoutError);\n    });\n  });\n\n  describe(\"TimeoutError (base class)\", () => {\n    it(\"is exported and extends Error\", () => {\n      const error = new Stagehand.TimeoutError(\"custom operation\", 2000);\n      expect(error).toBeInstanceOf(Error);\n      expect(error).toBeInstanceOf(Stagehand.TimeoutError);\n    });\n\n    it(\"contains operation name and timeout in message\", () => {\n      const error = new Stagehand.TimeoutError(\"custom operation\", 2000);\n      expect(error.message).toContain(\"custom operation\");\n      expect(error.message).toContain(\"2000ms\");\n    });\n\n    it(\"extends StagehandError\", () => {\n      const error = new Stagehand.TimeoutError(\"operation\", 1000);\n      expect(error).toBeInstanceOf(Stagehand.StagehandError);\n    });\n  });\n});\n"]}

package/dist/esm/tests/unit/public-api/tool-type-export.test.d.ts

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

package/dist/esm/tests/unit/public-api/tool-type-export.test.js

@@ -0,0 +1,30 @@
+import { describe, expectTypeOf, it, expect } from "vitest";
+import * as Stagehand from "@browserbasehq/stagehand";
+import { z } from "zod";
+/**
+ * Test to verify tool-related exports from Stagehand.
+ * Users should be able to create custom tools using the exported `tool` function
+ * without needing to install the ai package directly.
+ */
+describe("Tool exports from AI SDK", () => {
+    it("exports Tool type that matches AI SDK Tool type", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("exports tool function", () => {
+        expect(typeof Stagehand.tool).toBe("function");
+    });
+    it("tool function can be used to define custom tools", () => {
+        const customTool = Stagehand.tool({
+            description: "A test tool",
+            inputSchema: z.object({
+                input: z.string(),
+            }),
+            execute: async ({ input }) => {
+                return { result: `Processed: ${input}` };
+            },
+        });
+        expect(customTool).toBeDefined();
+        expect(customTool.description).toBe("A test tool");
+    });
+});
+//# sourceMappingURL=tool-type-export.test.js.map

package/dist/esm/tests/unit/public-api/tool-type-export.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-type-export.test.js","sourceRoot":"","sources":["../../../../../tests/unit/public-api/tool-type-export.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC5D,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,YAAY,EAAkB,CAAC,aAAa,EAAQ,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC;YAChC,WAAW,EAAE,aAAa;YAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;aAClB,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,OAAO,EAAE,MAAM,EAAE,cAAc,KAAK,EAAE,EAAE,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, expectTypeOf, it, expect } from \"vitest\";\nimport * as Stagehand from \"@browserbasehq/stagehand\";\nimport { type Tool } from \"ai\";\nimport { z } from \"zod\";\n\n/**\n * Test to verify tool-related exports from Stagehand.\n * Users should be able to create custom tools using the exported `tool` function\n * without needing to install the ai package directly.\n */\ndescribe(\"Tool exports from AI SDK\", () => {\n  it(\"exports Tool type that matches AI SDK Tool type\", () => {\n    expectTypeOf<Stagehand.Tool>().toEqualTypeOf<Tool>();\n  });\n\n  it(\"exports tool function\", () => {\n    expect(typeof Stagehand.tool).toBe(\"function\");\n  });\n\n  it(\"tool function can be used to define custom tools\", () => {\n    const customTool = Stagehand.tool({\n      description: \"A test tool\",\n      inputSchema: z.object({\n        input: z.string(),\n      }),\n      execute: async ({ input }) => {\n        return { result: `Processed: ${input}` };\n      },\n    });\n\n    expect(customTool).toBeDefined();\n    expect(customTool.description).toBe(\"A test tool\");\n  });\n});\n"]}

package/dist/esm/tests/unit/public-api/v3-core.test.d.ts

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

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

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

package/dist/esm/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/esm/tests/unit/safety-confirmation.test.d.ts

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

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

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

package/dist/esm/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/esm/tests/unit/snapshot-a11y-resolvers.test.d.ts

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