npm - @browserbasehq/orca - Versions diffs - 3.4.0-preview.0 → 3.5.0-preview.1 - Mend

@browserbasehq/orca 3.4.0-preview.0 → 3.5.0-preview.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (919) hide show

package/dist/cjs/tests/unit/xpath-resolver.test.js DELETED Viewed

@@ -1,80 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const jsdom_1 = require("jsdom");
-const vitest_1 = require("vitest");
-const xpathResolver_js_1 = require("../../lib/v3/dom/locatorScripts/xpathResolver.js");
-const globalRef = globalThis;
-const originalGlobals = {
-    window: globalRef.window,
-    document: globalRef.document,
-    Node: globalRef.Node,
-    NodeFilter: globalRef.NodeFilter,
-    Element: globalRef.Element,
-    HTMLElement: globalRef.HTMLElement,
-    Document: globalRef.Document,
-    DocumentFragment: globalRef.DocumentFragment,
-    ShadowRoot: globalRef.ShadowRoot,
-    XPathResult: globalRef.XPathResult,
-};
-let dom;
-const installDomGlobals = () => {
-    const win = dom.window;
-    globalRef.window = win;
-    globalRef.document = win.document;
-    globalRef.Node = win.Node;
-    globalRef.NodeFilter = win.NodeFilter;
-    globalRef.Element = win.Element;
-    globalRef.HTMLElement = win.HTMLElement;
-    globalRef.Document = win.Document;
-    globalRef.DocumentFragment =
-        win.DocumentFragment;
-    globalRef.ShadowRoot = win.ShadowRoot;
-    globalRef.XPathResult = win.XPathResult;
-};
-const restoreDomGlobals = () => {
-    for (const [key, value] of Object.entries(originalGlobals)) {
-        if (value === undefined) {
-            delete globalRef[key];
-        }
-        else {
-            globalRef[key] = value;
-        }
-    }
-};
-(0, vitest_1.describe)("xpathResolver composed traversal", () => {
-    (0, vitest_1.beforeAll)(() => {
-        dom = new jsdom_1.JSDOM("<!doctype html><html><body></body></html>");
-        installDomGlobals();
-    });
-    (0, vitest_1.afterAll)(() => {
-        dom.window.close();
-        restoreDomGlobals();
-    });
-    (0, vitest_1.beforeEach)(() => {
-        document.body.innerHTML = "";
-    });
-    (0, vitest_1.it)("counts matches across light + shadow DOM without double counting", () => {
-        document.body.innerHTML =
-            '<div id="light-1"></div>' +
-                '<shadow-host id="host"></shadow-host>' +
-                '<div id="light-2"></div>';
-        const host = document.getElementById("host");
-        const shadow = host.attachShadow({ mode: "open" });
-        shadow.innerHTML = '<div id="shadow-1"></div><div id="shadow-2"></div>';
-        (0, vitest_1.expect)((0, xpathResolver_js_1.countXPathMatches)("//div")).toBe(4);
-    });
-    (0, vitest_1.it)("resolves nth over composed tree in document-order DFS", () => {
-        document.body.innerHTML =
-            '<div id="light-1"></div>' +
-                '<shadow-host id="host"></shadow-host>' +
-                '<div id="light-2"></div>';
-        const host = document.getElementById("host");
-        const shadow = host.attachShadow({ mode: "open" });
-        shadow.innerHTML = '<div id="shadow-1"></div><div id="shadow-2"></div>';
-        (0, vitest_1.expect)((0, xpathResolver_js_1.resolveXPathAtIndex)("//div", 0)?.id).toBe("light-1");
-        (0, vitest_1.expect)((0, xpathResolver_js_1.resolveXPathAtIndex)("//div", 1)?.id).toBe("shadow-1");
-        (0, vitest_1.expect)((0, xpathResolver_js_1.resolveXPathAtIndex)("//div", 2)?.id).toBe("shadow-2");
-        (0, vitest_1.expect)((0, xpathResolver_js_1.resolveXPathAtIndex)("//div", 3)?.id).toBe("light-2");
-    });
-});
-//# sourceMappingURL=xpath-resolver.test.js.map

package/dist/cjs/tests/unit/xpath-resolver.test.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"file":"xpath-resolver.test.js","sourceRoot":"","sources":["../../../../tests/unit/xpath-resolver.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { JSDOM } from \"jsdom\";\nimport { afterAll, beforeAll, beforeEach, describe, expect, it } from \"vitest\";\nimport {\n countXPathMatches,\n resolveXPathAtIndex,\n} from \"../../lib/v3/dom/locatorScripts/xpathResolver.js\";\n\ntype DomGlobals = {\n window: Window & typeof globalThis;\n document: Document;\n Node: typeof Node;\n NodeFilter: typeof NodeFilter;\n Element: typeof Element;\n HTMLElement: typeof HTMLElement;\n Document: typeof Document;\n DocumentFragment: typeof DocumentFragment;\n ShadowRoot: typeof ShadowRoot;\n XPathResult: typeof XPathResult;\n};\n\nconst globalRef = globalThis as typeof globalThis & Partial<DomGlobals>;\nconst originalGlobals: Partial<DomGlobals> = {\n window: globalRef.window,\n document: globalRef.document,\n Node: globalRef.Node,\n NodeFilter: globalRef.NodeFilter,\n Element: globalRef.Element,\n HTMLElement: globalRef.HTMLElement,\n Document: globalRef.Document,\n DocumentFragment: globalRef.DocumentFragment,\n ShadowRoot: globalRef.ShadowRoot,\n XPathResult: globalRef.XPathResult,\n};\n\nlet dom: JSDOM;\n\nconst installDomGlobals = () => {\n const win = dom.window;\n globalRef.window = win as unknown as Window & typeof globalThis;\n globalRef.document = win.document;\n globalRef.Node = win.Node as unknown as typeof Node;\n globalRef.NodeFilter = win.NodeFilter as unknown as typeof NodeFilter;\n globalRef.Element = win.Element as unknown as typeof Element;\n globalRef.HTMLElement = win.HTMLElement as unknown as typeof HTMLElement;\n globalRef.Document = win.Document as unknown as typeof Document;\n globalRef.DocumentFragment =\n win.DocumentFragment as unknown as typeof DocumentFragment;\n globalRef.ShadowRoot = win.ShadowRoot as unknown as typeof ShadowRoot;\n globalRef.XPathResult = win.XPathResult as unknown as typeof XPathResult;\n};\n\nconst restoreDomGlobals = () => {\n for (const [key, value] of Object.entries(originalGlobals)) {\n if (value === undefined) {\n delete (globalRef as Record<string, unknown>)[key];\n } else {\n (globalRef as Record<string, unknown>)[key] = value;\n }\n }\n};\n\ndescribe(\"xpathResolver composed traversal\", () => {\n beforeAll(() => {\n dom = new JSDOM(\"<!doctype html><html><body></body></html>\");\n installDomGlobals();\n });\n\n afterAll(() => {\n dom.window.close();\n restoreDomGlobals();\n });\n\n beforeEach(() => {\n document.body.innerHTML = \"\";\n });\n\n it(\"counts matches across light + shadow DOM without double counting\", () => {\n document.body.innerHTML =\n '<div id=\"light-1\"></div>' +\n '<shadow-host id=\"host\"></shadow-host>' +\n '<div id=\"light-2\"></div>';\n\n const host = document.getElementById(\"host\") as HTMLElement;\n const shadow = host.attachShadow({ mode: \"open\" });\n shadow.innerHTML = '<div id=\"shadow-1\"></div><div id=\"shadow-2\"></div>';\n\n expect(countXPathMatches(\"//div\")).toBe(4);\n });\n\n it(\"resolves nth over composed tree in document-order DFS\", () => {\n document.body.innerHTML =\n '<div id=\"light-1\"></div>' +\n '<shadow-host id=\"host\"></shadow-host>' +\n '<div id=\"light-2\"></div>';\n\n const host = document.getElementById(\"host\") as HTMLElement;\n const shadow = host.attachShadow({ mode: \"open\" });\n shadow.innerHTML = '<div id=\"shadow-1\"></div><div id=\"shadow-2\"></div>';\n\n expect(resolveXPathAtIndex(\"//div\", 0)?.id).toBe(\"light-1\");\n expect(resolveXPathAtIndex(\"//div\", 1)?.id).toBe(\"shadow-1\");\n expect(resolveXPathAtIndex(\"//div\", 2)?.id).toBe(\"shadow-2\");\n expect(resolveXPathAtIndex(\"//div\", 3)?.id).toBe(\"light-2\");\n });\n});\n"]}

package/dist/cjs/tests/unit/zod-enum-compatibility.test.d.ts DELETED Viewed

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

package/dist/cjs/tests/unit/zod-enum-compatibility.test.js DELETED Viewed

@@ -1,149 +0,0 @@
-"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 z3 = __importStar(require("zod/v3"));
-const zod_1 = require("zod");
-const handlers_js_1 = require("../../lib/v3/types/private/handlers.js");
-/**
- * Tests for Zod v3/v4 compatibility with the SupportedUnderstudyAction enum.
- *
- * This test ensures that z.enum() works correctly with both Zod v3 and v4.
- * The key issue is that z.enum() in Zod v3 does NOT accept TypeScript enums directly -
- * it only accepts string literal tuples. For TypeScript enums, you need to use
- * Object.values() to convert the enum to an array first.
- *
- * In Zod v4, z.enum() was updated to accept TypeScript enums directly, but for
- * backwards compatibility, we should use Object.values() which works with both.
- *
- * See PR #1613: https://github.com/browserbase/stagehand/pull/1613
- */
-(0, vitest_1.describe)("SupportedUnderstudyAction enum Zod compatibility", () => {
-    const testInput = {
-        elementId: "1-2",
-        method: "click",
-        arguments: [],
-    };
-    const invalidInput = {
-        elementId: "1-2",
-        method: "invalidMethod",
-        arguments: [],
-    };
-    (0, vitest_1.it)("Object.values(SupportedUnderstudyAction) produces correct array for z.enum()", () => {
-        const enumValues = Object.values(handlers_js_1.SupportedUnderstudyAction);
-        (0, vitest_1.expect)(enumValues).toContain("click");
-        (0, vitest_1.expect)(enumValues).toContain("fill");
-        (0, vitest_1.expect)(enumValues).toContain("type");
-        (0, vitest_1.expect)(enumValues).toContain("press");
-        (0, vitest_1.expect)(enumValues).toContain("scrollTo");
-        (0, vitest_1.expect)(enumValues).toContain("nextChunk");
-        (0, vitest_1.expect)(enumValues).toContain("prevChunk");
-        (0, vitest_1.expect)(enumValues).toContain("selectOptionFromDropdown");
-        (0, vitest_1.expect)(enumValues).toContain("hover");
-        (0, vitest_1.expect)(enumValues).toContain("doubleClick");
-        (0, vitest_1.expect)(enumValues).toContain("dragAndDrop");
-        (0, vitest_1.expect)(enumValues.length).toBe(11);
-    });
-    (0, vitest_1.it)("Zod v3 z.enum() with Object.values(SupportedUnderstudyAction) works correctly", () => {
-        const enumValues = Object.values(handlers_js_1.SupportedUnderstudyAction);
-        const schema = z3.z.object({
-            elementId: z3.z.string(),
-            method: z3.z.enum(enumValues),
-            arguments: z3.z.array(z3.z.string()),
-        });
-        // Valid input should pass
-        const validResult = schema.safeParse(testInput);
-        (0, vitest_1.expect)(validResult.success).toBe(true);
-        if (validResult.success) {
-            (0, vitest_1.expect)(validResult.data.method).toBe("click");
-        }
-        // Invalid input should fail
-        const invalidResult = schema.safeParse(invalidInput);
-        (0, vitest_1.expect)(invalidResult.success).toBe(false);
-    });
-    (0, vitest_1.it)("Zod v4 z.enum() with Object.values(SupportedUnderstudyAction) works correctly", () => {
-        const enumValues = Object.values(handlers_js_1.SupportedUnderstudyAction);
-        const schema = zod_1.z.object({
-            elementId: zod_1.z.string(),
-            method: zod_1.z.enum(enumValues),
-            arguments: zod_1.z.array(zod_1.z.string()),
-        });
-        // Valid input should pass
-        const validResult = schema.safeParse(testInput);
-        (0, vitest_1.expect)(validResult.success).toBe(true);
-        if (validResult.success) {
-            (0, vitest_1.expect)(validResult.data.method).toBe("click");
-        }
-        // Invalid input should fail
-        const invalidResult = schema.safeParse(invalidInput);
-        (0, vitest_1.expect)(invalidResult.success).toBe(false);
-    });
-    (0, vitest_1.it)("Zod v3 z.enum() with raw TypeScript enum throws error on parse", () => {
-        // This demonstrates the bug that PR #1613 would introduce
-        // In Zod v3, z.enum() does NOT accept TypeScript enums directly
-        // The schema creation might succeed, but parsing will fail
-        const schema = z3.z.object({
-            elementId: z3.z.string(),
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            method: z3.z.enum(handlers_js_1.SupportedUnderstudyAction),
-            arguments: z3.z.array(z3.z.string()),
-        });
-        // This should throw an error because the enum is not iterable
-        (0, vitest_1.expect)(() => schema.safeParse(testInput)).toThrow("object is not iterable");
-    });
-    (0, vitest_1.it)("Zod v4 z.enum() with raw TypeScript enum works (but not v3 compatible)", () => {
-        // Zod v4 allows passing TypeScript enums directly to z.enum()
-        // But this approach is NOT backwards compatible with v3
-        const schema = zod_1.z.object({
-            elementId: zod_1.z.string(),
-            method: zod_1.z.enum(handlers_js_1.SupportedUnderstudyAction),
-            arguments: zod_1.z.array(zod_1.z.string()),
-        });
-        // In v4, this works fine
-        const validResult = schema.safeParse(testInput);
-        (0, vitest_1.expect)(validResult.success).toBe(true);
-    });
-    (0, vitest_1.it)("All SupportedUnderstudyAction values are valid enum options", () => {
-        const enumValues = Object.values(handlers_js_1.SupportedUnderstudyAction);
-        // Test with both v3 and v4 schemas
-        const v3Schema = z3.z.enum(enumValues);
-        const v4Schema = zod_1.z.enum(enumValues);
-        for (const action of enumValues) {
-            (0, vitest_1.expect)(v3Schema.safeParse(action).success).toBe(true);
-            (0, vitest_1.expect)(v4Schema.safeParse(action).success).toBe(true);
-        }
-    });
-});
-//# sourceMappingURL=zod-enum-compatibility.test.js.map

package/dist/cjs/tests/unit/zod-enum-compatibility.test.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"file":"zod-enum-compatibility.test.js","sourceRoot":"","sources":["../../../../tests/unit/zod-enum-compatibility.test.ts"],"names":[],"mappings":"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","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"]}

package/dist/esm/tests/cache-variables.test.d.ts DELETED Viewed

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

package/dist/esm/tests/cache-variables.test.js DELETED Viewed

@@ -1,219 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import { ActCache } from "../lib/v3/cache/ActCache";
-function createFakeStorage(entry) {
-    return {
-        enabled: true,
-        readJson: vi.fn().mockResolvedValue({ value: entry }),
-        writeJson: vi.fn().mockResolvedValue({}),
-        directory: "/tmp/cache",
-    };
-}
-describe("ActCache variable handling", () => {
-    it("cache key includes variable keys but not values", async () => {
-        const storage = {
-            enabled: true,
-            readJson: vi.fn(),
-            writeJson: vi.fn().mockResolvedValue({}),
-            directory: "/tmp/cache",
-        };
-        const cache = new ActCache({
-            storage,
-            logger: vi.fn(),
-            getActHandler: () => null,
-            getDefaultLlmClient: () => ({}),
-            domSettleTimeoutMs: undefined,
-        });
-        const fakePage = {
-            url: vi.fn().mockResolvedValue("https://example.com"),
-        };
-        // First context with username="user1@example.com"
-        const context1 = await cache.prepareContext("type %username% into the email field", fakePage, { username: "user1@example.com" });
-        // Second context with username="user2@example.com"
-        const context2 = await cache.prepareContext("type %username% into the email field", fakePage, { username: "user2@example.com" });
-        // Third context with different variable key name
-        const context3 = await cache.prepareContext("type %email% into the email field", fakePage, { email: "user3@example.com" });
-        // Same instruction + same variable keys = same cache key
-        expect(context1?.cacheKey).toBe(context2?.cacheKey);
-        // Different variable keys = different cache key
-        expect(context1?.cacheKey).not.toBe(context3?.cacheKey);
-        // Verify variable keys are sorted and stored
-        expect(context1?.variableKeys).toEqual(["username"]);
-        expect(context2?.variableKeys).toEqual(["username"]);
-        expect(context3?.variableKeys).toEqual(["email"]);
-        // Verify variable values are preserved in context
-        expect(context1?.variables).toEqual({ username: "user1@example.com" });
-        expect(context2?.variables).toEqual({ username: "user2@example.com" });
-    });
-    it("replays cached actions with variable substitution", async () => {
-        // Cached action contains variable placeholder %username%
-        const action = {
-            selector: "xpath=/html/body/input[@type='email']",
-            description: "type username into email field",
-            method: "type",
-            arguments: ["%username%"], // Variable placeholder
-        };
-        const entry = {
-            version: 1,
-            instruction: "type %username% into the email field",
-            url: "https://example.com",
-            variableKeys: ["username"],
-            actions: [action],
-            actionDescription: "type username",
-            message: "done",
-        };
-        const storage = createFakeStorage(entry);
-        // Track what variables are passed to takeDeterministicAction
-        const capturedVariables = [];
-        const handler = {
-            takeDeterministicAction: vi
-                .fn()
-                .mockImplementation(async (_action, _page, _timeout, _client, _ensure, variables) => {
-                capturedVariables.push(variables || {});
-                return {
-                    success: true,
-                    message: "ok",
-                    actionDescription: "type username",
-                    actions: [action],
-                };
-            }),
-        };
-        const defaultClient = {};
-        const cache = new ActCache({
-            storage,
-            logger: vi.fn(),
-            getActHandler: () => handler,
-            getDefaultLlmClient: () => defaultClient,
-            domSettleTimeoutMs: undefined,
-        });
-        // First replay with username="user1@example.com"
-        const context1 = {
-            instruction: "type %username% into the email field",
-            cacheKey: "test-key",
-            pageUrl: "https://example.com",
-            variableKeys: ["username"],
-            variables: { username: "user1@example.com" },
-        };
-        const result1 = await cache.tryReplay(context1, {});
-        expect(result1?.success).toBe(true);
-        expect(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);
-        expect(capturedVariables[0]).toEqual({ username: "user1@example.com" });
-        // Reset
-        vi.clearAllMocks();
-        capturedVariables.length = 0;
-        // Second replay with username="user2@example.com"
-        const context2 = {
-            instruction: "type %username% into the email field",
-            cacheKey: "test-key", // Same cache key!
-            pageUrl: "https://example.com",
-            variableKeys: ["username"],
-            variables: { username: "user2@example.com" },
-        };
-        const result2 = await cache.tryReplay(context2, {});
-        expect(result2?.success).toBe(true);
-        expect(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);
-        expect(capturedVariables[0]).toEqual({ username: "user2@example.com" });
-    });
-    it("cache miss when variable keys don't match", async () => {
-        const action = {
-            selector: "xpath=/html/body/input",
-            description: "type username",
-            method: "type",
-            arguments: ["%username%"],
-        };
-        // Cached entry expects "username" variable
-        const entry = {
-            version: 1,
-            instruction: "type %username% into the field",
-            url: "https://example.com",
-            variableKeys: ["username"],
-            actions: [action],
-        };
-        const storage = createFakeStorage(entry);
-        const cache = new ActCache({
-            storage,
-            logger: vi.fn(),
-            getActHandler: () => null,
-            getDefaultLlmClient: () => ({}),
-            domSettleTimeoutMs: undefined,
-        });
-        // Context has different variable key "email"
-        const context = {
-            instruction: "type %email% into the field",
-            cacheKey: "test-key",
-            pageUrl: "https://example.com",
-            variableKeys: ["email"],
-            variables: { email: "test@example.com" },
-        };
-        const result = await cache.tryReplay(context, {});
-        // Should return null (cache miss) due to variable key mismatch
-        expect(result).toBeNull();
-    });
-    it("cache miss when required variables are missing", async () => {
-        const action = {
-            selector: "xpath=/html/body/input",
-            description: "type username",
-            method: "type",
-            arguments: ["%username%"],
-        };
-        const entry = {
-            version: 1,
-            instruction: "type %username% into the field",
-            url: "https://example.com",
-            variableKeys: ["username"],
-            actions: [action],
-        };
-        const storage = createFakeStorage(entry);
-        const logger = vi.fn();
-        const cache = new ActCache({
-            storage,
-            logger,
-            getActHandler: () => null,
-            getDefaultLlmClient: () => ({}),
-            domSettleTimeoutMs: undefined,
-        });
-        // Context missing the username variable value
-        const context = {
-            instruction: "type %username% into the field",
-            cacheKey: "test-key",
-            pageUrl: "https://example.com",
-            variableKeys: ["username"],
-            variables: {}, // Missing username value!
-        };
-        const result = await cache.tryReplay(context, {});
-        // Should return null (cache miss)
-        expect(result).toBeNull();
-        // Should log the miss reason
-        expect(logger).toHaveBeenCalledWith(expect.objectContaining({
-            category: "cache",
-            message: "act cache miss: missing variables for replay",
-            level: 2,
-        }));
-    });
-    it("handles multiple variables correctly", async () => {
-        const storage = {
-            enabled: true,
-            readJson: vi.fn(),
-            writeJson: vi.fn().mockResolvedValue({}),
-            directory: "/tmp/cache",
-        };
-        const cache = new ActCache({
-            storage,
-            logger: vi.fn(),
-            getActHandler: () => null,
-            getDefaultLlmClient: () => ({}),
-            domSettleTimeoutMs: undefined,
-        });
-        const fakePage = {
-            url: vi.fn().mockResolvedValue("https://example.com"),
-        };
-        // Context with multiple variables
-        const context1 = await cache.prepareContext("fill %username% and %password%", fakePage, { username: "user1", password: "pass1" });
-        const context2 = await cache.prepareContext("fill %username% and %password%", fakePage, { username: "user2", password: "pass2" });
-        // Same cache key despite different values
-        expect(context1?.cacheKey).toBe(context2?.cacheKey);
-        // Variable keys should be sorted
-        expect(context1?.variableKeys).toEqual(["password", "username"]);
-        expect(context2?.variableKeys).toEqual(["password", "username"]);
-    });
-});
-//# sourceMappingURL=cache-variables.test.js.map

package/dist/esm/tests/cache-variables.test.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"file":"cache-variables.test.js","sourceRoot":"","sources":["../../../tests/cache-variables.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from \"vitest\";\nimport { ActCache } from \"../lib/v3/cache/ActCache\";\nimport type { CacheStorage } from \"../lib/v3/cache/CacheStorage\";\nimport type { ActHandler } from \"../lib/v3/handlers/actHandler\";\nimport type { LLMClient } from \"../lib/v3/llm/LLMClient\";\nimport type { Page } from \"../lib/v3/understudy/page\";\nimport type { ActCacheContext, CachedActEntry } from \"../lib/v3/types/private\";\nimport type { Action } from \"../lib/v3/types/public\";\n\nfunction createFakeStorage<T>(entry: T): CacheStorage {\n return {\n enabled: true,\n readJson: vi.fn().mockResolvedValue({ value: entry }),\n writeJson: vi.fn().mockResolvedValue({}),\n directory: \"/tmp/cache\",\n } as unknown as CacheStorage;\n}\n\ndescribe(\"ActCache variable handling\", () => {\n it(\"cache key includes variable keys but not values\", async () => {\n const storage = {\n enabled: true,\n readJson: vi.fn(),\n writeJson: vi.fn().mockResolvedValue({}),\n directory: \"/tmp/cache\",\n } as unknown as CacheStorage;\n\n const cache = new ActCache({\n storage,\n logger: vi.fn(),\n getActHandler: () => null as unknown as ActHandler,\n getDefaultLlmClient: () => ({}) as LLMClient,\n domSettleTimeoutMs: undefined,\n });\n\n const fakePage = {\n url: vi.fn().mockResolvedValue(\"https://example.com\"),\n } as unknown as Page;\n\n // First context with username=\"user1@example.com\"\n const context1 = await cache.prepareContext(\n \"type %username% into the email field\",\n fakePage,\n { username: \"user1@example.com\" },\n );\n\n // Second context with username=\"user2@example.com\"\n const context2 = await cache.prepareContext(\n \"type %username% into the email field\",\n fakePage,\n { username: \"user2@example.com\" },\n );\n\n // Third context with different variable key name\n const context3 = await cache.prepareContext(\n \"type %email% into the email field\",\n fakePage,\n { email: \"user3@example.com\" },\n );\n\n // Same instruction + same variable keys = same cache key\n expect(context1?.cacheKey).toBe(context2?.cacheKey);\n\n // Different variable keys = different cache key\n expect(context1?.cacheKey).not.toBe(context3?.cacheKey);\n\n // Verify variable keys are sorted and stored\n expect(context1?.variableKeys).toEqual([\"username\"]);\n expect(context2?.variableKeys).toEqual([\"username\"]);\n expect(context3?.variableKeys).toEqual([\"email\"]);\n\n // Verify variable values are preserved in context\n expect(context1?.variables).toEqual({ username: \"user1@example.com\" });\n expect(context2?.variables).toEqual({ username: \"user2@example.com\" });\n });\n\n it(\"replays cached actions with variable substitution\", async () => {\n // Cached action contains variable placeholder %username%\n const action: Action = {\n selector: \"xpath=/html/body/input[@type='email']\",\n description: \"type username into email field\",\n method: \"type\",\n arguments: [\"%username%\"], // Variable placeholder\n };\n\n const entry: CachedActEntry = {\n version: 1,\n instruction: \"type %username% into the email field\",\n url: \"https://example.com\",\n variableKeys: [\"username\"],\n actions: [action],\n actionDescription: \"type username\",\n message: \"done\",\n };\n\n const storage = createFakeStorage(entry);\n\n // Track what variables are passed to takeDeterministicAction\n const capturedVariables: Record<string, string>[] = [];\n const handler = {\n takeDeterministicAction: vi\n .fn()\n .mockImplementation(\n async (_action, _page, _timeout, _client, _ensure, variables) => {\n capturedVariables.push(variables || {});\n return {\n success: true,\n message: \"ok\",\n actionDescription: \"type username\",\n actions: [action],\n };\n },\n ),\n } as unknown as ActHandler;\n\n const defaultClient = {} as LLMClient;\n\n const cache = new ActCache({\n storage,\n logger: vi.fn(),\n getActHandler: () => handler,\n getDefaultLlmClient: () => defaultClient,\n domSettleTimeoutMs: undefined,\n });\n\n // First replay with username=\"user1@example.com\"\n const context1: ActCacheContext = {\n instruction: \"type %username% into the email field\",\n cacheKey: \"test-key\",\n pageUrl: \"https://example.com\",\n variableKeys: [\"username\"],\n variables: { username: \"user1@example.com\" },\n };\n\n const result1 = await cache.tryReplay(context1, {} as Page);\n\n expect(result1?.success).toBe(true);\n expect(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);\n expect(capturedVariables[0]).toEqual({ username: \"user1@example.com\" });\n\n // Reset\n vi.clearAllMocks();\n capturedVariables.length = 0;\n\n // Second replay with username=\"user2@example.com\"\n const context2: ActCacheContext = {\n instruction: \"type %username% into the email field\",\n cacheKey: \"test-key\", // Same cache key!\n pageUrl: \"https://example.com\",\n variableKeys: [\"username\"],\n variables: { username: \"user2@example.com\" },\n };\n\n const result2 = await cache.tryReplay(context2, {} as Page);\n\n expect(result2?.success).toBe(true);\n expect(handler.takeDeterministicAction).toHaveBeenCalledTimes(1);\n expect(capturedVariables[0]).toEqual({ username: \"user2@example.com\" });\n });\n\n it(\"cache miss when variable keys don't match\", async () => {\n const action: Action = {\n selector: \"xpath=/html/body/input\",\n description: \"type username\",\n method: \"type\",\n arguments: [\"%username%\"],\n };\n\n // Cached entry expects \"username\" variable\n const entry: CachedActEntry = {\n version: 1,\n instruction: \"type %username% into the field\",\n url: \"https://example.com\",\n variableKeys: [\"username\"],\n actions: [action],\n };\n\n const storage = createFakeStorage(entry);\n const cache = new ActCache({\n storage,\n logger: vi.fn(),\n getActHandler: () => null as unknown as ActHandler,\n getDefaultLlmClient: () => ({}) as LLMClient,\n domSettleTimeoutMs: undefined,\n });\n\n // Context has different variable key \"email\"\n const context: ActCacheContext = {\n instruction: \"type %email% into the field\",\n cacheKey: \"test-key\",\n pageUrl: \"https://example.com\",\n variableKeys: [\"email\"],\n variables: { email: \"test@example.com\" },\n };\n\n const result = await cache.tryReplay(context, {} as Page);\n\n // Should return null (cache miss) due to variable key mismatch\n expect(result).toBeNull();\n });\n\n it(\"cache miss when required variables are missing\", async () => {\n const action: Action = {\n selector: \"xpath=/html/body/input\",\n description: \"type username\",\n method: \"type\",\n arguments: [\"%username%\"],\n };\n\n const entry: CachedActEntry = {\n version: 1,\n instruction: \"type %username% into the field\",\n url: \"https://example.com\",\n variableKeys: [\"username\"],\n actions: [action],\n };\n\n const storage = createFakeStorage(entry);\n const logger = vi.fn();\n const cache = new ActCache({\n storage,\n logger,\n getActHandler: () => null as unknown as ActHandler,\n getDefaultLlmClient: () => ({}) as LLMClient,\n domSettleTimeoutMs: undefined,\n });\n\n // Context missing the username variable value\n const context: ActCacheContext = {\n instruction: \"type %username% into the field\",\n cacheKey: \"test-key\",\n pageUrl: \"https://example.com\",\n variableKeys: [\"username\"],\n variables: {}, // Missing username value!\n };\n\n const result = await cache.tryReplay(context, {} as Page);\n\n // Should return null (cache miss)\n expect(result).toBeNull();\n\n // Should log the miss reason\n expect(logger).toHaveBeenCalledWith(\n expect.objectContaining({\n category: \"cache\",\n message: \"act cache miss: missing variables for replay\",\n level: 2,\n }),\n );\n });\n\n it(\"handles multiple variables correctly\", async () => {\n const storage = {\n enabled: true,\n readJson: vi.fn(),\n writeJson: vi.fn().mockResolvedValue({}),\n directory: \"/tmp/cache\",\n } as unknown as CacheStorage;\n\n const cache = new ActCache({\n storage,\n logger: vi.fn(),\n getActHandler: () => null as unknown as ActHandler,\n getDefaultLlmClient: () => ({}) as LLMClient,\n domSettleTimeoutMs: undefined,\n });\n\n const fakePage = {\n url: vi.fn().mockResolvedValue(\"https://example.com\"),\n } as unknown as Page;\n\n // Context with multiple variables\n const context1 = await cache.prepareContext(\n \"fill %username% and %password%\",\n fakePage,\n { username: \"user1\", password: \"pass1\" },\n );\n\n const context2 = await cache.prepareContext(\n \"fill %username% and %password%\",\n fakePage,\n { username: \"user2\", password: \"pass2\" },\n );\n\n // Same cache key despite different values\n expect(context1?.cacheKey).toBe(context2?.cacheKey);\n\n // Variable keys should be sorted\n expect(context1?.variableKeys).toEqual([\"password\", \"username\"]);\n expect(context2?.variableKeys).toEqual([\"password\", \"username\"]);\n });\n});\n"]}

package/dist/esm/tests/integration/agent-abort-signal.spec.d.ts DELETED Viewed

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