@browserbasehq/orca 3.0.9-alpha-3 → 3.1.0-patch.0

package/dist/esm/tests/zod-enum-compatibility.test.js

@@ -0,0 +1,97 @@
+import { describe, expect, it } from "vitest";
+import * as z3 from "zod/v3";
+import { z as z4 } from "zod";
+import { SupportedUnderstudyAction } from "../lib/v3/types/private/handlers.js";
+describe("SupportedUnderstudyAction enum Zod compatibility", () => {
+  const testInput = {
+    elementId: "1-2",
+    method: "click",
+    arguments: []
+  };
+  const invalidInput = {
+    elementId: "1-2",
+    method: "invalidMethod",
+    arguments: []
+  };
+  it("Object.values(SupportedUnderstudyAction) produces correct array for z.enum()", () => {
+    const enumValues = Object.values(
+      SupportedUnderstudyAction
+    );
+    expect(enumValues).toContain("click");
+    expect(enumValues).toContain("fill");
+    expect(enumValues).toContain("type");
+    expect(enumValues).toContain("press");
+    expect(enumValues).toContain("scrollTo");
+    expect(enumValues).toContain("nextChunk");
+    expect(enumValues).toContain("prevChunk");
+    expect(enumValues).toContain("selectOptionFromDropdown");
+    expect(enumValues).toContain("hover");
+    expect(enumValues).toContain("doubleClick");
+    expect(enumValues).toContain("dragAndDrop");
+    expect(enumValues.length).toBe(11);
+  });
+  it("Zod v3 z.enum() with Object.values(SupportedUnderstudyAction) works correctly", () => {
+    const enumValues = Object.values(
+      SupportedUnderstudyAction
+    );
+    const schema = z3.z.object({
+      elementId: z3.z.string(),
+      method: z3.z.enum(enumValues),
+      arguments: z3.z.array(z3.z.string())
+    });
+    const validResult = schema.safeParse(testInput);
+    expect(validResult.success).toBe(true);
+    if (validResult.success) {
+      expect(validResult.data.method).toBe("click");
+    }
+    const invalidResult = schema.safeParse(invalidInput);
+    expect(invalidResult.success).toBe(false);
+  });
+  it("Zod v4 z.enum() with Object.values(SupportedUnderstudyAction) works correctly", () => {
+    const enumValues = Object.values(
+      SupportedUnderstudyAction
+    );
+    const schema = z4.object({
+      elementId: z4.string(),
+      method: z4.enum(enumValues),
+      arguments: z4.array(z4.string())
+    });
+    const validResult = schema.safeParse(testInput);
+    expect(validResult.success).toBe(true);
+    if (validResult.success) {
+      expect(validResult.data.method).toBe("click");
+    }
+    const invalidResult = schema.safeParse(invalidInput);
+    expect(invalidResult.success).toBe(false);
+  });
+  it("Zod v3 z.enum() with raw TypeScript enum throws error on parse", () => {
+    const schema = z3.z.object({
+      elementId: z3.z.string(),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      method: z3.z.enum(SupportedUnderstudyAction),
+      arguments: z3.z.array(z3.z.string())
+    });
+    expect(() => schema.safeParse(testInput)).toThrow("object is not iterable");
+  });
+  it("Zod v4 z.enum() with raw TypeScript enum works (but not v3 compatible)", () => {
+    const schema = z4.object({
+      elementId: z4.string(),
+      method: z4.enum(SupportedUnderstudyAction),
+      arguments: z4.array(z4.string())
+    });
+    const validResult = schema.safeParse(testInput);
+    expect(validResult.success).toBe(true);
+  });
+  it("All SupportedUnderstudyAction values are valid enum options", () => {
+    const enumValues = Object.values(
+      SupportedUnderstudyAction
+    );
+    const v3Schema = z3.z.enum(enumValues);
+    const v4Schema = z4.enum(enumValues);
+    for (const action of enumValues) {
+      expect(v3Schema.safeParse(action).success).toBe(true);
+      expect(v4Schema.safeParse(action).success).toBe(true);
+    }
+  });
+});
+//# sourceMappingURL=zod-enum-compatibility.test.js.map

package/dist/esm/tests/zod-enum-compatibility.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../tests/zod-enum-compatibility.test.ts"],
+  "sourcesContent": ["import { describe, expect, it } from \"vitest\";\nimport * as z3 from \"zod/v3\";\nimport { z as z4 } from \"zod\";\nimport { SupportedUnderstudyAction } from \"../lib/v3/types/private/handlers.js\";\n\n/**\n * Tests for Zod v3/v4 compatibility with the SupportedUnderstudyAction enum.\n *\n * This test ensures that z.enum() works correctly with both Zod v3 and v4.\n * The key issue is that z.enum() in Zod v3 does NOT accept TypeScript enums directly -\n * it only accepts string literal tuples. For TypeScript enums, you need to use\n * Object.values() to convert the enum to an array first.\n *\n * In Zod v4, z.enum() was updated to accept TypeScript enums directly, but for\n * backwards compatibility, we should use Object.values() which works with both.\n *\n * See PR #1613: https://github.com/browserbase/stagehand/pull/1613\n */\ndescribe(\"SupportedUnderstudyAction enum Zod compatibility\", () => {\n  const testInput = {\n    elementId: \"1-2\",\n    method: \"click\",\n    arguments: [] as string[],\n  };\n\n  const invalidInput = {\n    elementId: \"1-2\",\n    method: \"invalidMethod\",\n    arguments: [] as string[],\n  };\n\n  it(\"Object.values(SupportedUnderstudyAction) produces correct array for z.enum()\", () => {\n    const enumValues = Object.values(\n      SupportedUnderstudyAction,\n    ) as unknown as readonly [string, ...string[]];\n\n    expect(enumValues).toContain(\"click\");\n    expect(enumValues).toContain(\"fill\");\n    expect(enumValues).toContain(\"type\");\n    expect(enumValues).toContain(\"press\");\n    expect(enumValues).toContain(\"scrollTo\");\n    expect(enumValues).toContain(\"nextChunk\");\n    expect(enumValues).toContain(\"prevChunk\");\n    expect(enumValues).toContain(\"selectOptionFromDropdown\");\n    expect(enumValues).toContain(\"hover\");\n    expect(enumValues).toContain(\"doubleClick\");\n    expect(enumValues).toContain(\"dragAndDrop\");\n    expect(enumValues.length).toBe(11);\n  });\n\n  it(\"Zod v3 z.enum() with Object.values(SupportedUnderstudyAction) works correctly\", () => {\n    const enumValues = Object.values(\n      SupportedUnderstudyAction,\n    ) as unknown as readonly [string, ...string[]];\n\n    const schema = z3.z.object({\n      elementId: z3.z.string(),\n      method: z3.z.enum(enumValues),\n      arguments: z3.z.array(z3.z.string()),\n    });\n\n    // Valid input should pass\n    const validResult = schema.safeParse(testInput);\n    expect(validResult.success).toBe(true);\n    if (validResult.success) {\n      expect(validResult.data.method).toBe(\"click\");\n    }\n\n    // Invalid input should fail\n    const invalidResult = schema.safeParse(invalidInput);\n    expect(invalidResult.success).toBe(false);\n  });\n\n  it(\"Zod v4 z.enum() with Object.values(SupportedUnderstudyAction) works correctly\", () => {\n    const enumValues = Object.values(\n      SupportedUnderstudyAction,\n    ) as unknown as readonly [string, ...string[]];\n\n    const schema = z4.object({\n      elementId: z4.string(),\n      method: z4.enum(enumValues),\n      arguments: z4.array(z4.string()),\n    });\n\n    // Valid input should pass\n    const validResult = schema.safeParse(testInput);\n    expect(validResult.success).toBe(true);\n    if (validResult.success) {\n      expect(validResult.data.method).toBe(\"click\");\n    }\n\n    // Invalid input should fail\n    const invalidResult = schema.safeParse(invalidInput);\n    expect(invalidResult.success).toBe(false);\n  });\n\n  it(\"Zod v3 z.enum() with raw TypeScript enum throws error on parse\", () => {\n    // This demonstrates the bug that PR #1613 would introduce\n    // In Zod v3, z.enum() does NOT accept TypeScript enums directly\n    // The schema creation might succeed, but parsing will fail\n\n    const schema = z3.z.object({\n      elementId: z3.z.string(),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      method: z3.z.enum(SupportedUnderstudyAction as any),\n      arguments: z3.z.array(z3.z.string()),\n    });\n\n    // This should throw an error because the enum is not iterable\n    expect(() => schema.safeParse(testInput)).toThrow(\"object is not iterable\");\n  });\n\n  it(\"Zod v4 z.enum() with raw TypeScript enum works (but not v3 compatible)\", () => {\n    // Zod v4 allows passing TypeScript enums directly to z.enum()\n    // But this approach is NOT backwards compatible with v3\n\n    const schema = z4.object({\n      elementId: z4.string(),\n      method: z4.enum(SupportedUnderstudyAction),\n      arguments: z4.array(z4.string()),\n    });\n\n    // In v4, this works fine\n    const validResult = schema.safeParse(testInput);\n    expect(validResult.success).toBe(true);\n  });\n\n  it(\"All SupportedUnderstudyAction values are valid enum options\", () => {\n    const enumValues = Object.values(\n      SupportedUnderstudyAction,\n    ) as unknown as readonly [string, ...string[]];\n\n    // Test with both v3 and v4 schemas\n    const v3Schema = z3.z.enum(enumValues);\n    const v4Schema = z4.enum(enumValues);\n\n    for (const action of enumValues) {\n      expect(v3Schema.safeParse(action).success).toBe(true);\n      expect(v4Schema.safeParse(action).success).toBe(true);\n    }\n  });\n});\n"],
+  "mappings": "AAAA,SAAS,UAAU,QAAQ,UAAU;AACrC,YAAY,QAAQ;AACpB,SAAS,KAAK,UAAU;AACxB,SAAS,iCAAiC;AAe1C,SAAS,oDAAoD,MAAM;AACjE,QAAM,YAAY;AAAA,IAChB,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,WAAW,CAAC;AAAA,EACd;AAEA,QAAM,eAAe;AAAA,IACnB,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,WAAW,CAAC;AAAA,EACd;AAEA,KAAG,gFAAgF,MAAM;AACvF,UAAM,aAAa,OAAO;AAAA,MACxB;AAAA,IACF;AAEA,WAAO,UAAU,EAAE,UAAU,OAAO;AACpC,WAAO,UAAU,EAAE,UAAU,MAAM;AACnC,WAAO,UAAU,EAAE,UAAU,MAAM;AACnC,WAAO,UAAU,EAAE,UAAU,OAAO;AACpC,WAAO,UAAU,EAAE,UAAU,UAAU;AACvC,WAAO,UAAU,EAAE,UAAU,WAAW;AACxC,WAAO,UAAU,EAAE,UAAU,WAAW;AACxC,WAAO,UAAU,EAAE,UAAU,0BAA0B;AACvD,WAAO,UAAU,EAAE,UAAU,OAAO;AACpC,WAAO,UAAU,EAAE,UAAU,aAAa;AAC1C,WAAO,UAAU,EAAE,UAAU,aAAa;AAC1C,WAAO,WAAW,MAAM,EAAE,KAAK,EAAE;AAAA,EACnC,CAAC;AAED,KAAG,iFAAiF,MAAM;AACxF,UAAM,aAAa,OAAO;AAAA,MACxB;AAAA,IACF;AAEA,UAAM,SAAS,GAAG,EAAE,OAAO;AAAA,MACzB,WAAW,GAAG,EAAE,OAAO;AAAA,MACvB,QAAQ,GAAG,EAAE,KAAK,UAAU;AAAA,MAC5B,WAAW,GAAG,EAAE,MAAM,GAAG,EAAE,OAAO,CAAC;AAAA,IACrC,CAAC;AAGD,UAAM,cAAc,OAAO,UAAU,SAAS;AAC9C,WAAO,YAAY,OAAO,EAAE,KAAK,IAAI;AACrC,QAAI,YAAY,SAAS;AACvB,aAAO,YAAY,KAAK,MAAM,EAAE,KAAK,OAAO;AAAA,IAC9C;AAGA,UAAM,gBAAgB,OAAO,UAAU,YAAY;AACnD,WAAO,cAAc,OAAO,EAAE,KAAK,KAAK;AAAA,EAC1C,CAAC;AAED,KAAG,iFAAiF,MAAM;AACxF,UAAM,aAAa,OAAO;AAAA,MACxB;AAAA,IACF;AAEA,UAAM,SAAS,GAAG,OAAO;AAAA,MACvB,WAAW,GAAG,OAAO;AAAA,MACrB,QAAQ,GAAG,KAAK,UAAU;AAAA,MAC1B,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAAA,IACjC,CAAC;AAGD,UAAM,cAAc,OAAO,UAAU,SAAS;AAC9C,WAAO,YAAY,OAAO,EAAE,KAAK,IAAI;AACrC,QAAI,YAAY,SAAS;AACvB,aAAO,YAAY,KAAK,MAAM,EAAE,KAAK,OAAO;AAAA,IAC9C;AAGA,UAAM,gBAAgB,OAAO,UAAU,YAAY;AACnD,WAAO,cAAc,OAAO,EAAE,KAAK,KAAK;AAAA,EAC1C,CAAC;AAED,KAAG,kEAAkE,MAAM;AAKzE,UAAM,SAAS,GAAG,EAAE,OAAO;AAAA,MACzB,WAAW,GAAG,EAAE,OAAO;AAAA;AAAA,MAEvB,QAAQ,GAAG,EAAE,KAAK,yBAAgC;AAAA,MAClD,WAAW,GAAG,EAAE,MAAM,GAAG,EAAE,OAAO,CAAC;AAAA,IACrC,CAAC;AAGD,WAAO,MAAM,OAAO,UAAU,SAAS,CAAC,EAAE,QAAQ,wBAAwB;AAAA,EAC5E,CAAC;AAED,KAAG,0EAA0E,MAAM;AAIjF,UAAM,SAAS,GAAG,OAAO;AAAA,MACvB,WAAW,GAAG,OAAO;AAAA,MACrB,QAAQ,GAAG,KAAK,yBAAyB;AAAA,MACzC,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAAA,IACjC,CAAC;AAGD,UAAM,cAAc,OAAO,UAAU,SAAS;AAC9C,WAAO,YAAY,OAAO,EAAE,KAAK,IAAI;AAAA,EACvC,CAAC;AAED,KAAG,+DAA+D,MAAM;AACtE,UAAM,aAAa,OAAO;AAAA,MACxB;AAAA,IACF;AAGA,UAAM,WAAW,GAAG,EAAE,KAAK,UAAU;AACrC,UAAM,WAAW,GAAG,KAAK,UAAU;AAEnC,eAAW,UAAU,YAAY;AAC/B,aAAO,SAAS,UAAU,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI;AACpD,aAAO,SAAS,UAAU,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI;AAAA,IACtD;AAAA,EACF,CAAC;AACH,CAAC;",
+  "names": []
+}

package/package.json

@@ -1,30 +1,44 @@
 {
   "name": "@browserbasehq/orca",
-  "version": "3.0.9-alpha-3",
+  "version": "3.1.0-patch.0",
   "description": "An AI web browsing framework focused on simplicity and extensibility.",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    },
+    "./*.js": {
+      "types": "./dist/esm/*.d.ts",
+      "import": "./dist/esm/*.js"
+    },
+    "./*": {
+      "types": "./dist/esm/*.d.ts",
+      "import": "./dist/esm/*.js"
+    },
+    "./package.json": "./package.json"
+  },
   "scripts": {
     "gen-version": "tsx scripts/gen-version.ts",
-    "build-dom-scripts": "tsx lib/v3/dom/genDomScripts.ts && tsx lib/v3/dom/genLocatorScripts.ts && tsx lib/v3/dom/genA11yScripts.ts",
-    "build-js": "tsup --entry.index lib/v3/index.ts --dts",
-    "typecheck": "tsc --noEmit",
-    "build": "pnpm run gen-version && pnpm run build-dom-scripts && pnpm run build-js && pnpm run typecheck",
-    "example": "node --import tsx -e \"const args=process.argv.slice(1).filter(a=>a!=='--'); const [p]=args; const n=(p||'example').replace(/^\\.\\//,'').replace(/\\.ts$/i,''); import(new URL(require('node:path').resolve('examples', n + '.ts'), 'file:'));\" --",
-    "test": "playwright test --config=lib/v3/tests/v3.playwright.config.ts",
-    "e2e": "playwright test --config=lib/v3/tests/v3.local.playwright.config.ts",
-    "e2e:local": "playwright test --config=lib/v3/tests/v3.local.playwright.config.ts",
-    "e2e:bb": "playwright test --config=lib/v3/tests/v3.bb.playwright.config.ts",
-    "lint": "cd ../.. && prettier --check packages/core && cd packages/core && eslint .",
-    "format": "prettier --write .",
-    "test:vitest": "turbo run build && vitest run --config vitest.config.ts"
+    "build:cjs": "tsx scripts/build-cjs.ts",
+    "build:esm": "tsx scripts/build-esm.ts",
+    "build-dom-scripts": "tsx lib/v3/dom/genDomScripts.ts && tsx lib/v3/dom/genLocatorScripts.ts && tsx lib/v3/dom/genScreenshotScripts.ts && tsx lib/v3/dom/genA11yScripts.ts",
+    "typecheck": "pnpm -w --dir ../.. exec tsc -p packages/core/tsconfig.json --noEmit",
+    "build": "pnpm run build:esm && pnpm run typecheck",
+    "example": "node --import tsx -e \"const args=process.argv.slice(1).filter(a=>a!=='--'); const [p]=args; const n=(p||'example').replace(/^\\.\\//,'').replace(/\\.ts$/i,''); import('node:path').then(path=>import(new URL(path.resolve('examples', n + '.ts'), 'file:')));\" --",
+    "test": "pnpm run test:core --",
+    "test:core": "tsx scripts/test-core.ts",
+    "test:e2e": "tsx scripts/test-e2e.ts",
+    "lint": "cd ../.. && prettier --check packages/core && cd packages/core && eslint . && pnpm run typecheck",
+    "format": "prettier --write ."
   },
   "files": [
-    "dist/index.js",
-    "dist/index.d.ts",
-    "dist/lib",
-    "dist/types",
+    "dist/esm",
+    "dist/cjs",
     "dist/stagehand.config.d.ts"
   ],
   "keywords": [
@@ -38,7 +52,6 @@
   "license": "MIT",
   "peerDependencies": {
     "deepmerge": "^4.3.1",
-    "dotenv": "^16.4.5",
     "zod": "^3.25.76 || ^4.2.0"
   },
   "dependencies": {
@@ -47,8 +60,9 @@
     "@anthropic-ai/sdk": "0.39.0",
     "@browserbasehq/sdk": "^2.4.0",
     "@google/genai": "^1.22.0",
+    "@langchain/openai": "^0.4.4",
     "@modelcontextprotocol/sdk": "^1.17.2",
-    "ai": "^5.0.0",
+    "ai": "^5.0.133",
     "devtools-protocol": "^0.0.1464554",
     "fetch-cookie": "^3.1.0",
     "openai": "^4.87.1",
@@ -58,11 +72,12 @@
     "zod-to-json-schema": "^3.25.0"
   },
   "optionalDependencies": {
+    "@ai-sdk/amazon-bedrock": "^3.0.73",
     "@ai-sdk/anthropic": "^2.0.34",
     "@ai-sdk/azure": "^2.0.54",
     "@ai-sdk/cerebras": "^1.0.25",
     "@ai-sdk/deepseek": "^1.0.23",
-    "@ai-sdk/google": "^2.0.23",
+    "@ai-sdk/google": "^2.0.53",
     "@ai-sdk/google-vertex": "^3.0.70",
     "@ai-sdk/groq": "^2.0.24",
     "@ai-sdk/mistral": "^2.0.19",
@@ -70,6 +85,7 @@
     "@ai-sdk/perplexity": "^2.0.13",
     "@ai-sdk/togetherai": "^1.0.23",
     "@ai-sdk/xai": "^2.0.26",
+    "@langchain/core": "^0.3.40",
     "bufferutil": "^4.0.9",
     "chrome-launcher": "^1.2.0",
     "ollama-ai-provider-v2": "^1.5.0",
@@ -79,20 +95,19 @@
     "puppeteer-core": "^22.8.0"
   },
   "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.8",
     "@playwright/test": "^1.42.1",
     "@types/adm-zip": "^0.5.7",
     "@types/node": "^20.11.30",
     "@types/ws": "^8.5.13",
     "adm-zip": "^0.5.16",
     "chalk": "^5.4.1",
-    "esbuild": "^0.21.4",
     "eslint": "^9.16.0",
+    "jsdom": "^24.0.0",
     "playwright": "^1.52.0",
     "playwright-core": "^1.54.1",
     "prettier": "^3.2.5",
-    "tsup": "^8.2.1",
-    "tsx": "^4.10.5",
-    "typescript": "^5.2.2",
+    "tsx": "*",
     "vitest": "^4.0.8",
     "zod": "^3.25.76 || ^4.2.0"
   },