npm - @browserbasehq/orca - Versions diffs - 3.0.9-alpha-4 → 3.1.0-headers - Mend

@browserbasehq/orca 3.0.9-alpha-4 → 3.1.0-headers

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 (1556) hide show

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

@@ -0,0 +1,80 @@
+"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 ADDED Viewed

@@ -0,0 +1 @@

+ {"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 ADDED Viewed

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

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

@@ -0,0 +1,149 @@
+"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 ADDED Viewed

@@ -0,0 +1 @@

+ {"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/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from "./lib/v3/index.js";
2	+ export { default } from "./lib/v3/index.js";

package/dist/esm/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export * from "./lib/v3/index.js";
2	+ export { default } from "./lib/v3/index.js";

package/dist/esm/lib/inference.d.ts ADDED Viewed

@@ -0,0 +1,65 @@
+import { LogLine } from "./v3/types/public/logs.js";
+import { LLMClient } from "./v3/llm/LLMClient.js";
+import type { InferStagehandSchema, StagehandZodObject } from "./v3/zodCompat.js";
+export type { LLMParsedResponse, LLMUsage } from "./v3/llm/LLMClient.js";
+export declare function extract<T extends StagehandZodObject>({ instruction, domElements, schema, llmClient, logger, userProvidedInstructions, logInferenceToFile, }: {
+    instruction: string;
+    domElements: string;
+    schema: T;
+    llmClient: LLMClient;
+    userProvidedInstructions?: string;
+    logger: (message: LogLine) => void;
+    logInferenceToFile?: boolean;
+}): Promise<InferStagehandSchema<T> & {
+    metadata: {
+        completed: boolean;
+        progress: string;
+    };
+    prompt_tokens: number;
+    completion_tokens: number;
+    reasoning_tokens: number;
+    cached_input_tokens: number;
+    inference_time_ms: number;
+}>;
+export declare function observe({ instruction, domElements, llmClient, userProvidedInstructions, logger, logInferenceToFile, supportedActions, }: {
+    instruction: string;
+    domElements: string;
+    llmClient: LLMClient;
+    userProvidedInstructions?: string;
+    logger: (message: LogLine) => void;
+    logInferenceToFile?: boolean;
+    supportedActions?: string[];
+}): Promise<{
+    elements: {
+        elementId: string;
+        description: string;
+        method: string;
+        arguments: string[];
+    }[];
+    prompt_tokens: number;
+    completion_tokens: number;
+    reasoning_tokens: number;
+    cached_input_tokens: number;
+    inference_time_ms: number;
+}>;
+export declare function act({ instruction, domElements, llmClient, userProvidedInstructions, logger, logInferenceToFile, }: {
+    instruction: string;
+    domElements: string;
+    llmClient: LLMClient;
+    userProvidedInstructions?: string;
+    logger: (message: LogLine) => void;
+    logInferenceToFile?: boolean;
+}): Promise<{
+    element: {
+        elementId: string;
+        description: string;
+        method: string;
+        arguments: string[];
+    };
+    prompt_tokens: number;
+    completion_tokens: number;
+    reasoning_tokens: number;
+    cached_input_tokens: number;
+    inference_time_ms: number;
+    twoStep: boolean;
+}>;