@browserbasehq/orca 3.7.1-preview.0 → 3.7.2-gemini-cua

package/dist/esm/lib/v3/types/public/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/model.ts"],"names":[],"mappings":"","sourcesContent":["import type { ClientOptions as AnthropicClientOptionsBase } from \"@anthropic-ai/sdk\";\nimport type {\n  LanguageModelV2,\n  LanguageModelV2Middleware,\n} from \"@ai-sdk/provider\";\nimport type { ClientOptions as OpenAIClientOptionsBase } from \"openai\";\nimport type { AgentProviderType } from \"./agent.js\";\n\nexport type OpenAIClientOptions = Pick<\n  OpenAIClientOptionsBase,\n  \"baseURL\" | \"apiKey\"\n>;\n\nexport type AnthropicClientOptions = Pick<\n  AnthropicClientOptionsBase,\n  \"baseURL\" | \"apiKey\"\n>;\n\nexport interface GoogleServiceAccountCredentials {\n  type?: \"service_account\";\n  project_id?: string;\n  private_key_id?: string;\n  private_key: string;\n  client_email: string;\n  client_id?: string;\n  auth_uri?: string;\n  token_uri?: string;\n  auth_provider_x509_cert_url?: string;\n  client_x509_cert_url?: string;\n  universe_domain?: string;\n}\n\nexport interface GoogleServiceAccountAuth {\n  type: \"googleServiceAccount\";\n  credentials: GoogleServiceAccountCredentials;\n  scopes?: string | string[];\n  projectId?: string;\n  universeDomain?: string;\n}\n\nexport interface AzureEntraIdAuth {\n  type: \"azureEntraId\";\n  token: string;\n}\n\nexport type ModelAuth = GoogleServiceAccountAuth | AzureEntraIdAuth;\n\nexport interface VertexProviderOptions {\n  project: string;\n  location: string;\n  baseURL?: string;\n  headers?: Record<string, string>;\n}\n\nexport interface AzureProviderOptions {\n  resourceName?: string;\n  baseURL?: string;\n  apiVersion?: string;\n  useDeploymentBasedUrls?: boolean;\n  headers?: Record<string, string>;\n}\n\nexport type ModelProviderOptions =\n  | { vertex: VertexProviderOptions; azure?: never }\n  | { azure: AzureProviderOptions; vertex?: never };\n\nexport type AnthropicJsonSchemaObject = {\n  definitions?: {\n    MySchema?: {\n      properties?: Record<string, unknown>;\n      required?: string[];\n    };\n  };\n  properties?: Record<string, unknown>;\n  required?: string[];\n} & Record<string, unknown>;\n\nexport interface LLMTool {\n  type: \"function\";\n  name: string;\n  description: string;\n  parameters: Record<string, unknown>;\n}\n\nexport type AISDKProvider = (modelName: string) => LanguageModelV2;\n// Represents a function that takes options (like apiKey) and returns an AISDKProvider\nexport type AISDKCustomProvider = (options: ClientOptions) => AISDKProvider;\n\nexport type AvailableModel =\n  | \"gpt-4.1\"\n  | \"gpt-4.1-mini\"\n  | \"gpt-4.1-nano\"\n  | \"o4-mini\"\n  | \"o3\"\n  | \"o3-mini\"\n  | \"o1\"\n  | \"o1-mini\"\n  | \"gpt-4o\"\n  | \"gpt-4o-mini\"\n  | \"gpt-4o-2024-08-06\"\n  | \"gpt-4.5-preview\"\n  | \"o1-preview\"\n  | \"cerebras-llama-3.3-70b\"\n  | \"cerebras-llama-3.1-8b\"\n  | \"groq-llama-3.3-70b-versatile\"\n  | \"groq-llama-3.3-70b-specdec\"\n  | \"gemini-1.5-flash\"\n  | \"gemini-1.5-pro\"\n  | \"gemini-1.5-flash-8b\"\n  | \"gemini-2.0-flash-lite\"\n  | \"gemini-2.0-flash\"\n  | \"gemini-2.5-flash-preview-04-17\"\n  | \"gemini-2.5-pro-preview-03-25\"\n  | string;\n\nexport type ModelProvider =\n  | \"openai\"\n  | \"anthropic\"\n  | \"cerebras\"\n  | \"groq\"\n  | \"google\"\n  | \"aisdk\";\n\n/**\n * Effort levels for Claude adaptive thinking.\n * Used with Claude 4.6+ models (claude-opus-4-6, claude-sonnet-4-6).\n * - \"none\": Disable adaptive thinking entirely\n * - \"low\": Claude minimizes thinking, skips for simple tasks\n * - \"medium\": Claude uses moderate thinking, may skip for simple queries (default)\n * - \"high\": Claude always thinks with deep reasoning\n * - \"xhigh\": Deeper reasoning than \"high\" (Opus 4.7/4.8 and Fable 5 only)\n * - \"max\": Claude always thinks with no constraints\n */\nexport type ThinkingEffort =\n  | \"none\"\n  | \"low\"\n  | \"medium\"\n  | \"high\"\n  | \"xhigh\"\n  | \"max\";\n\nexport type OpenAIEndpointFormat = \"responses\" | \"chat\";\n\nexport type ClientOptions = (OpenAIClientOptions | AnthropicClientOptions) & {\n  apiKey?: string;\n  provider?: AgentProviderType;\n  auth?: ModelAuth;\n  providerOptions?: ModelProviderOptions;\n  baseURL?: string;\n  /** OpenAI organization ID */\n  organization?: string;\n  /** Delay between agent actions in ms */\n  waitBetweenActions?: number;\n  /**\n   * @deprecated For Claude 4.6+ models, use `thinkingEffort` instead.\n   * Anthropic thinking budget for extended thinking (used with older Claude models like 4.5).\n   * Sets `thinking.type: \"enabled\"` with the specified `budget_tokens`.\n   */\n  thinkingBudget?: number;\n  /**\n   * Effort level for Claude adaptive thinking (Claude 4.6+ models only).\n   * Uses `thinking.type: \"adaptive\"` with `output_config.effort`.\n   * This is the recommended approach for Claude Opus 4.6 and Sonnet 4.6.\n   * @see https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking\n   */\n  thinkingEffort?: ThinkingEffort;\n  /** Environment type for CUA agents (browser, mac, windows, ubuntu) */\n  environment?: string;\n  /** Max images for Microsoft FARA agent */\n  maxImages?: number;\n  /** Temperature for model inference */\n  temperature?: number;\n  /** Custom headers sent with every request to the provider */\n  headers?: Record<string, string>;\n  /** Reasoning effort for reasoning-capable models (e.g., \"none\", \"low\", \"medium\", \"high\") */\n  reasoningEffort?: string;\n  /**\n   * Wire format used against the OpenAI-compatible endpoint at `baseURL`.\n   * Defaults to the Responses API. Use `chat` for providers that expose only\n   * an OpenAI-compatible Chat Completions endpoint (e.g. Databricks).\n   */\n  openaiEndpointFormat?: OpenAIEndpointFormat;\n};\n\nexport type ModelConfiguration =\n  | AvailableModel\n  | (ClientOptions & {\n      modelName: AvailableModel;\n      /**\n       * Optional AI SDK middleware applied to every LanguageModelV2 created for this model.\n       * Use this to intercept LLM calls for usage tracking, logging, request transforms, etc.\n       *\n       * Only effective when running locally (direct mode). Cannot be serialized over HTTP,\n       */\n      middleware?: LanguageModelV2Middleware;\n    });\n"]}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/model.ts"],"names":[],"mappings":"","sourcesContent":["import type { ClientOptions as AnthropicClientOptionsBase } from \"@anthropic-ai/sdk\";\nimport type {\n  LanguageModelV2,\n  LanguageModelV2Middleware,\n} from \"@ai-sdk/provider\";\nimport type { ClientOptions as OpenAIClientOptionsBase } from \"openai\";\nimport type { AgentProviderType } from \"./agent.js\";\n\nexport type OpenAIClientOptions = Pick<\n  OpenAIClientOptionsBase,\n  \"baseURL\" | \"apiKey\"\n>;\n\nexport type AnthropicClientOptions = Pick<\n  AnthropicClientOptionsBase,\n  \"baseURL\" | \"apiKey\"\n>;\n\nexport interface GoogleServiceAccountCredentials {\n  type?: \"service_account\";\n  project_id?: string;\n  private_key_id?: string;\n  private_key: string;\n  client_email: string;\n  client_id?: string;\n  auth_uri?: string;\n  token_uri?: string;\n  auth_provider_x509_cert_url?: string;\n  client_x509_cert_url?: string;\n  universe_domain?: string;\n}\n\nexport interface GoogleServiceAccountAuth {\n  type: \"googleServiceAccount\";\n  credentials: GoogleServiceAccountCredentials;\n  scopes?: string | string[];\n  projectId?: string;\n  universeDomain?: string;\n}\n\nexport interface AzureEntraIdAuth {\n  type: \"azureEntraId\";\n  token: string;\n}\n\nexport type ModelAuth = GoogleServiceAccountAuth | AzureEntraIdAuth;\n\nexport interface VertexProviderOptions {\n  project: string;\n  location: string;\n  baseURL?: string;\n  headers?: Record<string, string>;\n}\n\nexport interface AzureProviderOptions {\n  resourceName?: string;\n  baseURL?: string;\n  apiVersion?: string;\n  useDeploymentBasedUrls?: boolean;\n  headers?: Record<string, string>;\n}\n\nexport type ModelProviderOptions =\n  | { vertex: VertexProviderOptions; azure?: never }\n  | { azure: AzureProviderOptions; vertex?: never };\n\nexport type AnthropicJsonSchemaObject = {\n  definitions?: {\n    MySchema?: {\n      properties?: Record<string, unknown>;\n      required?: string[];\n    };\n  };\n  properties?: Record<string, unknown>;\n  required?: string[];\n} & Record<string, unknown>;\n\nexport interface LLMTool {\n  type: \"function\";\n  name: string;\n  description: string;\n  parameters: Record<string, unknown>;\n}\n\nexport type AISDKProvider = (modelName: string) => LanguageModelV2;\n// Represents a function that takes options (like apiKey) and returns an AISDKProvider\nexport type AISDKCustomProvider = (options: ClientOptions) => AISDKProvider;\n\nexport type AvailableModel =\n  | \"gpt-4.1\"\n  | \"gpt-4.1-mini\"\n  | \"gpt-4.1-nano\"\n  | \"o4-mini\"\n  | \"o3\"\n  | \"o3-mini\"\n  | \"o1\"\n  | \"o1-mini\"\n  | \"gpt-4o\"\n  | \"gpt-4o-mini\"\n  | \"gpt-4o-2024-08-06\"\n  | \"gpt-4.5-preview\"\n  | \"o1-preview\"\n  | \"cerebras-llama-3.3-70b\"\n  | \"cerebras-llama-3.1-8b\"\n  | \"groq-llama-3.3-70b-versatile\"\n  | \"groq-llama-3.3-70b-specdec\"\n  | \"gemini-1.5-flash\"\n  | \"gemini-1.5-pro\"\n  | \"gemini-1.5-flash-8b\"\n  | \"gemini-2.0-flash-lite\"\n  | \"gemini-2.0-flash\"\n  | \"gemini-2.5-flash-preview-04-17\"\n  | \"gemini-2.5-pro-preview-03-25\"\n  | string;\n\nexport type ModelProvider =\n  | \"openai\"\n  | \"anthropic\"\n  | \"cerebras\"\n  | \"groq\"\n  | \"google\"\n  | \"aisdk\";\n\n/**\n * Effort levels for Claude adaptive thinking.\n * Used with Claude 4.6+ models (claude-opus-4-6, claude-sonnet-4-6).\n * - \"none\": Disable adaptive thinking entirely\n * - \"low\": Claude minimizes thinking, skips for simple tasks\n * - \"medium\": Claude uses moderate thinking, may skip for simple queries (default)\n * - \"high\": Claude always thinks with deep reasoning\n * - \"xhigh\": Deeper reasoning than \"high\" (Opus 4.7/4.8 and Fable 5 only)\n * - \"max\": Claude always thinks with no constraints\n */\nexport type ThinkingEffort =\n  | \"none\"\n  | \"low\"\n  | \"medium\"\n  | \"high\"\n  | \"xhigh\"\n  | \"max\";\n\nexport type OpenAIEndpointFormat = \"responses\" | \"chat\";\n\nexport type ClientOptions = (OpenAIClientOptions | AnthropicClientOptions) & {\n  apiKey?: string;\n  provider?: AgentProviderType;\n  auth?: ModelAuth;\n  providerOptions?: ModelProviderOptions;\n  baseURL?: string;\n  /** OpenAI organization ID */\n  organization?: string;\n  /** Delay between agent actions in ms */\n  waitBetweenActions?: number;\n  /**\n   * @deprecated For Claude 4.6+ models, use `thinkingEffort` instead.\n   * Anthropic thinking budget for extended thinking (used with older Claude models like 4.5).\n   * Sets `thinking.type: \"enabled\"` with the specified `budget_tokens`.\n   */\n  thinkingBudget?: number;\n  /**\n   * Effort level for Claude adaptive thinking (Claude 4.6+ models only).\n   * Uses `thinking.type: \"adaptive\"` with `output_config.effort`.\n   * This is the recommended approach for Claude Opus 4.6 and Sonnet 4.6.\n   * @see https://platform.claude.com/docs/en/build-with-claude/adaptive-thinking\n   */\n  thinkingEffort?: ThinkingEffort;\n  /** Environment type for CUA agents (browser, mac, windows, ubuntu) */\n  environment?: string;\n  /**\n   * Request API for the Google CUA agent: \"generateContent\" (default) or the\n   * stateful \"interactions\" API.\n   */\n  googleApi?: \"generateContent\" | \"interactions\";\n  /** Max images for Microsoft FARA agent */\n  maxImages?: number;\n  /** Temperature for model inference */\n  temperature?: number;\n  /** Custom headers sent with every request to the provider */\n  headers?: Record<string, string>;\n  /** Reasoning effort for reasoning-capable models (e.g., \"none\", \"low\", \"medium\", \"high\") */\n  reasoningEffort?: string;\n  /**\n   * Wire format used against the OpenAI-compatible endpoint at `baseURL`.\n   * Defaults to the Responses API. Use `chat` for providers that expose only\n   * an OpenAI-compatible Chat Completions endpoint (e.g. Databricks).\n   */\n  openaiEndpointFormat?: OpenAIEndpointFormat;\n};\n\nexport type ModelConfiguration =\n  | AvailableModel\n  | (ClientOptions & {\n      modelName: AvailableModel;\n      /**\n       * Optional AI SDK middleware applied to every LanguageModelV2 created for this model.\n       * Use this to intercept LLM calls for usage tracking, logging, request transforms, etc.\n       *\n       * Only effective when running locally (direct mode). Cannot be serialized over HTTP,\n       */\n      middleware?: LanguageModelV2Middleware;\n    });\n"]}

package/dist/esm/lib/v3/types/public/options.d.ts

@@ -58,6 +58,19 @@ export interface V3Options {
      */
     keepAlive?: boolean;
     localBrowserLaunchOptions?: LocalBrowserLaunchOptions;
+    /**
+     * Actuate coordinate pointer actions as touch (a real `Input.dispatchTouchEvent`
+     * tap) instead of mouse input. Mobile layouts commonly gate their handlers on
+     * touch/pointer events, where a synthesized mouse click never registers — e.g. a
+     * size selector that keeps reporting "please choose a size". Set this when the
+     * session renders a mobile layout (e.g. Browserbase `browserSettings.os:
+     * "mobile"`).
+     *
+     * Explicit opt-in only — nothing is derived from the session.
+     *
+     * @default false
+     */
+    useTouch?: boolean;
     model?: ModelConfiguration;
     llmClient?: LLMClient;
     systemPrompt?: string;

package/dist/esm/lib/v3/types/public/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/options.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,+BAA+B,GAChC,MAAM,UAAU,CAAC;AAIlB,0DAA0D;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,+BAA+B,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { LLMClient } from \"../../llm/LLMClient.js\";\nimport { ModelConfiguration } from \"./model.js\";\nimport { LogLine } from \"./logs.js\";\nimport {\n  type BrowserbaseSessionCreateParams,\n  LocalBrowserLaunchOptionsSchema,\n} from \"./api.js\";\n\nexport type V3Env = \"LOCAL\" | \"BROWSERBASE\";\n\n// Re-export for backwards compatibility (camelCase alias)\nexport const localBrowserLaunchOptionsSchema = LocalBrowserLaunchOptionsSchema;\n\nexport type LocalBrowserLaunchOptions = z.infer<\n  typeof LocalBrowserLaunchOptionsSchema\n>;\n\n/** Constructor options for V3 */\nexport interface V3Options {\n  env: V3Env;\n  /**\n   * Optional external session identifier to use for flow logging/event storage.\n   * When omitted, Stagehand falls back to its internal instance id.\n   * This currently ends up 1:1 with the Browserbase session id when one exists,\n   * but callers should not rely on that remaining a permanent invariant.\n   */\n  sessionId?: string;\n  // Browserbase (required when env = \"BROWSERBASE\")\n  apiKey?: string;\n  projectId?: string;\n  /**\n   * Optional: fine-tune Browserbase session creation or resume an existing session.\n   */\n  browserbaseSessionCreateParams?: BrowserbaseSessionCreateParams;\n  browserbaseSessionID?: string;\n  /**\n   * Controls browser keepalive behavior. When set, it overrides any value in\n   * browserbaseSessionCreateParams.keepAlive.\n   */\n  keepAlive?: boolean;\n\n  // Local Chromium (optional)\n  localBrowserLaunchOptions?: LocalBrowserLaunchOptions;\n\n  model?: ModelConfiguration;\n  llmClient?: LLMClient; // allow user to pass their own\n  systemPrompt?: string;\n  logInferenceToFile?: boolean;\n  experimental?: boolean;\n  verbose?: 0 | 1 | 2;\n  selfHeal?: boolean;\n  // V2 compatibility fields - only included because the server imports this type and supports V2\n  waitForCaptchaSolves?: boolean;\n  actTimeoutMs?: number;\n  /** Disable pino logging backend (useful for tests or minimal environments). */\n  disablePino?: boolean;\n  /** Optional external logger hook for integrating with host apps. */\n  logger?: (line: LogLine) => void;\n  /** Directory used to persist cached actions for act(). */\n  cacheDir?: string;\n  domSettleTimeout?: number;\n  disableAPI?: boolean;\n  /**\n   * When true, enables server-side caching for API requests.\n   * When false, disables server-side caching.\n   * Defaults to true (caching enabled).\n   * Can be overridden per-method in act(), extract(), and observe() options.\n   */\n  serverCache?: boolean;\n}\n"]}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../../../lib/v3/types/public/options.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,+BAA+B,GAChC,MAAM,UAAU,CAAC;AAIlB,0DAA0D;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,+BAA+B,CAAC","sourcesContent":["import { z } from \"zod\";\nimport { LLMClient } from \"../../llm/LLMClient.js\";\nimport { ModelConfiguration } from \"./model.js\";\nimport { LogLine } from \"./logs.js\";\nimport {\n  type BrowserbaseSessionCreateParams,\n  LocalBrowserLaunchOptionsSchema,\n} from \"./api.js\";\n\nexport type V3Env = \"LOCAL\" | \"BROWSERBASE\";\n\n// Re-export for backwards compatibility (camelCase alias)\nexport const localBrowserLaunchOptionsSchema = LocalBrowserLaunchOptionsSchema;\n\nexport type LocalBrowserLaunchOptions = z.infer<\n  typeof LocalBrowserLaunchOptionsSchema\n>;\n\n/** Constructor options for V3 */\nexport interface V3Options {\n  env: V3Env;\n  /**\n   * Optional external session identifier to use for flow logging/event storage.\n   * When omitted, Stagehand falls back to its internal instance id.\n   * This currently ends up 1:1 with the Browserbase session id when one exists,\n   * but callers should not rely on that remaining a permanent invariant.\n   */\n  sessionId?: string;\n  // Browserbase (required when env = \"BROWSERBASE\")\n  apiKey?: string;\n  projectId?: string;\n  /**\n   * Optional: fine-tune Browserbase session creation or resume an existing session.\n   */\n  browserbaseSessionCreateParams?: BrowserbaseSessionCreateParams;\n  browserbaseSessionID?: string;\n  /**\n   * Controls browser keepalive behavior. When set, it overrides any value in\n   * browserbaseSessionCreateParams.keepAlive.\n   */\n  keepAlive?: boolean;\n\n  // Local Chromium (optional)\n  localBrowserLaunchOptions?: LocalBrowserLaunchOptions;\n\n  /**\n   * Actuate coordinate pointer actions as touch (a real `Input.dispatchTouchEvent`\n   * tap) instead of mouse input. Mobile layouts commonly gate their handlers on\n   * touch/pointer events, where a synthesized mouse click never registers — e.g. a\n   * size selector that keeps reporting \"please choose a size\". Set this when the\n   * session renders a mobile layout (e.g. Browserbase `browserSettings.os:\n   * \"mobile\"`).\n   *\n   * Explicit opt-in only — nothing is derived from the session.\n   *\n   * @default false\n   */\n  useTouch?: boolean;\n\n  model?: ModelConfiguration;\n  llmClient?: LLMClient; // allow user to pass their own\n  systemPrompt?: string;\n  logInferenceToFile?: boolean;\n  experimental?: boolean;\n  verbose?: 0 | 1 | 2;\n  selfHeal?: boolean;\n  // V2 compatibility fields - only included because the server imports this type and supports V2\n  waitForCaptchaSolves?: boolean;\n  actTimeoutMs?: number;\n  /** Disable pino logging backend (useful for tests or minimal environments). */\n  disablePino?: boolean;\n  /** Optional external logger hook for integrating with host apps. */\n  logger?: (line: LogLine) => void;\n  /** Directory used to persist cached actions for act(). */\n  cacheDir?: string;\n  domSettleTimeout?: number;\n  disableAPI?: boolean;\n  /**\n   * When true, enables server-side caching for API requests.\n   * When false, disables server-side caching.\n   * Defaults to true (caching enabled).\n   * Can be overridden per-method in act(), extract(), and observe() options.\n   */\n  serverCache?: boolean;\n}\n"]}

package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js

@@ -64,7 +64,45 @@ export async function resolveXpathForLocation(page, x, y) {
             if (typeof be === "number" &&
                 reportedFrameId &&
                 reportedFrameId !== curFrameId) {
-                const abs = await buildAbsoluteXPathFromChain(iframeChain, curSession, be);
+                const chain = [...iframeChain];
+                const framePath = [];
+                let frameId = reportedFrameId;
+                while (frameId && frameId !== curFrameId) {
+                    framePath.unshift(frameId);
+                    frameId = parentByFrame.get(frameId);
+                }
+                let resolvedFramePath = false;
+                if (frameId === curFrameId) {
+                    resolvedFramePath = true;
+                    for (const childFrameId of framePath) {
+                        const parentFrameId = parentByFrame.get(childFrameId);
+                        if (!parentFrameId) {
+                            resolvedFramePath = false;
+                            break;
+                        }
+                        try {
+                            const parentSession = page.getSessionForFrame(parentFrameId);
+                            const { backendNodeId } = await parentSession.send("DOM.getFrameOwner", { frameId: childFrameId });
+                            if (typeof backendNodeId !== "number") {
+                                resolvedFramePath = false;
+                                break;
+                            }
+                            chain.push({
+                                parentSession,
+                                iframeBackendNodeId: backendNodeId,
+                            });
+                        }
+                        catch {
+                            resolvedFramePath = false;
+                            break;
+                        }
+                    }
+                }
+                if (!resolvedFramePath) {
+                    return null;
+                }
+                const leafSession = page.getSessionForFrame(reportedFrameId);
+                const abs = await buildAbsoluteXPathFromChain(chain, leafSession, be);
                 return abs
                     ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs }
                     : null;

package/dist/esm/lib/v3/understudy/a11y/snapshot/coordinateResolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"coordinateResolver.js","sourceRoot":"","sources":["../../../../../../../lib/v3/understudy/a11y/snapshot/coordinateResolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"../../cdp.js\";\nimport { Page } from \"../../page.js\";\nimport { executionContexts } from \"../../executionContextRegistry.js\";\nimport { a11yScriptSources } from \"../../../dom/build/a11yScripts.generated.js\";\nimport { buildA11yInvocation } from \"../../a11yInvocation.js\";\nimport type { ResolvedLocation } from \"../../../types/private/snapshot.js\";\nimport { listChildrenOf } from \"./focusSelectors.js\";\nimport { buildAbsoluteXPathFromChain } from \"./xpathUtils.js\";\n\n/**\n * Resolve deepest node for a page coordinate and compute its absolute XPath across frames.\n * More efficient than building a full hybrid snapshot when only a single node’s XPath is needed.\n */\nexport async function resolveXpathForLocation(\n  page: Page,\n  x: number,\n  y: number,\n): Promise<ResolvedLocation | null> {\n  const tree = page.getFullFrameTree();\n  const parentByFrame = new Map<string, string | null>();\n  (function index(n: Protocol.Page.FrameTree, parent: string | null) {\n    parentByFrame.set(n.frame.id, parent);\n    for (const c of n.childFrames ?? []) index(c, n.frame.id);\n  })(tree, null);\n\n  const iframeChain: Array<{\n    parentSession: CDPSessionLike;\n    iframeBackendNodeId: number;\n  }> = [];\n\n  let curFrameId = page.mainFrameId();\n  let curSession = page.getSessionForFrame(curFrameId);\n  let curX = x;\n  let curY = y;\n\n  for (let depth = 0; depth < 8; depth++) {\n    try {\n      await curSession.send(\"DOM.enable\").catch(() => {});\n\n      let sx = 0;\n      let sy = 0;\n      try {\n        await curSession.send(\"Runtime.enable\").catch(() => {});\n        const ctxId = await executionContexts\n          .waitForMainWorld(curSession, curFrameId)\n          .catch(() => {});\n        const scrollExpr = buildA11yInvocation(\"getScrollOffsets\", []);\n        const evalParams = ctxId\n          ? {\n              contextId: ctxId,\n              expression: scrollExpr,\n              returnByValue: true,\n            }\n          : { expression: scrollExpr, returnByValue: true };\n        const { result } = await curSession.send<{\n          result: { value?: { sx?: number; sy?: number } };\n        }>(\"Runtime.evaluate\", evalParams);\n        sx = Number(result?.value?.sx ?? 0);\n        sy = Number(result?.value?.sy ?? 0);\n      } catch {\n        //\n      }\n      const xi = Math.max(0, Math.floor(curX + sx));\n      const yi = Math.max(0, Math.floor(curY + sy));\n\n      let res: { backendNodeId?: number; frameId?: string } | undefined;\n      try {\n        res = await curSession.send<{\n          backendNodeId?: number;\n          frameId?: string;\n        }>(\"DOM.getNodeForLocation\", {\n          x: xi,\n          y: yi,\n          includeUserAgentShadowDOM: false,\n          ignorePointerEventsNone: false,\n        });\n      } catch {\n        return null;\n      }\n\n      const be = res?.backendNodeId;\n      const reportedFrameId = res?.frameId;\n      if (\n        typeof be === \"number\" &&\n        reportedFrameId &&\n        reportedFrameId !== curFrameId\n      ) {\n        const abs = await buildAbsoluteXPathFromChain(\n          iframeChain,\n          curSession,\n          be,\n        );\n        return abs\n          ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      if (typeof be !== \"number\") return null;\n\n      let matchedChild: string | undefined;\n      for (const fid of listChildrenOf(parentByFrame, curFrameId)) {\n        try {\n          const { backendNodeId } = await curSession.send<{\n            backendNodeId?: number;\n          }>(\"DOM.getFrameOwner\", { frameId: fid });\n          if (backendNodeId === be) {\n            matchedChild = fid;\n            break;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      if (!matchedChild) {\n        const abs = await buildAbsoluteXPathFromChain(\n          iframeChain,\n          curSession,\n          be,\n        );\n        return abs\n          ? { frameId: curFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      iframeChain.push({\n        parentSession: curSession,\n        iframeBackendNodeId: be,\n      });\n\n      let left = 0;\n      let top = 0;\n      try {\n        const { object } = await curSession.send<{\n          object: { objectId?: string };\n        }>(\"DOM.resolveNode\", { backendNodeId: be });\n        const objectId = object?.objectId;\n        if (objectId) {\n          const { result } = await curSession.send<{\n            result: { value?: { left: number; top: number } };\n          }>(\"Runtime.callFunctionOn\", {\n            objectId,\n            functionDeclaration: a11yScriptSources.getBoundingRectLite,\n            returnByValue: true,\n          });\n          left = Number(result?.value?.left ?? 0);\n          top = Number(result?.value?.top ?? 0);\n          await curSession\n            .send(\"Runtime.releaseObject\", { objectId })\n            .catch(() => {});\n        }\n      } catch {\n        //\n      }\n      curX = Math.max(0, curX - left);\n      curY = Math.max(0, curY - top);\n      curFrameId = matchedChild;\n      curSession = page.getSessionForFrame(curFrameId);\n    } catch {\n      return null;\n    }\n  }\n  return null;\n}\n"]}
+{"version":3,"file":"coordinateResolver.js","sourceRoot":"","sources":["../../../../../../../lib/v3/understudy/a11y/snapshot/coordinateResolver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Protocol } from \"devtools-protocol\";\nimport type { CDPSessionLike } from \"../../cdp.js\";\nimport { Page } from \"../../page.js\";\nimport { executionContexts } from \"../../executionContextRegistry.js\";\nimport { a11yScriptSources } from \"../../../dom/build/a11yScripts.generated.js\";\nimport { buildA11yInvocation } from \"../../a11yInvocation.js\";\nimport type { ResolvedLocation } from \"../../../types/private/snapshot.js\";\nimport { listChildrenOf } from \"./focusSelectors.js\";\nimport { buildAbsoluteXPathFromChain } from \"./xpathUtils.js\";\n\n/**\n * Resolve deepest node for a page coordinate and compute its absolute XPath across frames.\n * More efficient than building a full hybrid snapshot when only a single node’s XPath is needed.\n */\nexport async function resolveXpathForLocation(\n  page: Page,\n  x: number,\n  y: number,\n): Promise<ResolvedLocation | null> {\n  const tree = page.getFullFrameTree();\n  const parentByFrame = new Map<string, string | null>();\n  (function index(n: Protocol.Page.FrameTree, parent: string | null) {\n    parentByFrame.set(n.frame.id, parent);\n    for (const c of n.childFrames ?? []) index(c, n.frame.id);\n  })(tree, null);\n\n  const iframeChain: Array<{\n    parentSession: CDPSessionLike;\n    iframeBackendNodeId: number;\n  }> = [];\n\n  let curFrameId = page.mainFrameId();\n  let curSession = page.getSessionForFrame(curFrameId);\n  let curX = x;\n  let curY = y;\n\n  for (let depth = 0; depth < 8; depth++) {\n    try {\n      await curSession.send(\"DOM.enable\").catch(() => {});\n\n      let sx = 0;\n      let sy = 0;\n      try {\n        await curSession.send(\"Runtime.enable\").catch(() => {});\n        const ctxId = await executionContexts\n          .waitForMainWorld(curSession, curFrameId)\n          .catch(() => {});\n        const scrollExpr = buildA11yInvocation(\"getScrollOffsets\", []);\n        const evalParams = ctxId\n          ? {\n              contextId: ctxId,\n              expression: scrollExpr,\n              returnByValue: true,\n            }\n          : { expression: scrollExpr, returnByValue: true };\n        const { result } = await curSession.send<{\n          result: { value?: { sx?: number; sy?: number } };\n        }>(\"Runtime.evaluate\", evalParams);\n        sx = Number(result?.value?.sx ?? 0);\n        sy = Number(result?.value?.sy ?? 0);\n      } catch {\n        //\n      }\n      const xi = Math.max(0, Math.floor(curX + sx));\n      const yi = Math.max(0, Math.floor(curY + sy));\n\n      let res: { backendNodeId?: number; frameId?: string } | undefined;\n      try {\n        res = await curSession.send<{\n          backendNodeId?: number;\n          frameId?: string;\n        }>(\"DOM.getNodeForLocation\", {\n          x: xi,\n          y: yi,\n          includeUserAgentShadowDOM: false,\n          ignorePointerEventsNone: false,\n        });\n      } catch {\n        return null;\n      }\n\n      const be = res?.backendNodeId;\n      const reportedFrameId = res?.frameId;\n      if (\n        typeof be === \"number\" &&\n        reportedFrameId &&\n        reportedFrameId !== curFrameId\n      ) {\n        const chain = [...iframeChain];\n        const framePath: string[] = [];\n        let frameId: string | null | undefined = reportedFrameId;\n        while (frameId && frameId !== curFrameId) {\n          framePath.unshift(frameId);\n          frameId = parentByFrame.get(frameId);\n        }\n\n        let resolvedFramePath = false;\n        if (frameId === curFrameId) {\n          resolvedFramePath = true;\n          for (const childFrameId of framePath) {\n            const parentFrameId = parentByFrame.get(childFrameId);\n            if (!parentFrameId) {\n              resolvedFramePath = false;\n              break;\n            }\n            try {\n              const parentSession = page.getSessionForFrame(parentFrameId);\n              const { backendNodeId } = await parentSession.send<{\n                backendNodeId?: number;\n              }>(\"DOM.getFrameOwner\", { frameId: childFrameId });\n              if (typeof backendNodeId !== \"number\") {\n                resolvedFramePath = false;\n                break;\n              }\n\n              chain.push({\n                parentSession,\n                iframeBackendNodeId: backendNodeId,\n              });\n            } catch {\n              resolvedFramePath = false;\n              break;\n            }\n          }\n        }\n\n        if (!resolvedFramePath) {\n          return null;\n        }\n\n        const leafSession = page.getSessionForFrame(reportedFrameId);\n        const abs = await buildAbsoluteXPathFromChain(chain, leafSession, be);\n        return abs\n          ? { frameId: reportedFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      if (typeof be !== \"number\") return null;\n\n      let matchedChild: string | undefined;\n      for (const fid of listChildrenOf(parentByFrame, curFrameId)) {\n        try {\n          const { backendNodeId } = await curSession.send<{\n            backendNodeId?: number;\n          }>(\"DOM.getFrameOwner\", { frameId: fid });\n          if (backendNodeId === be) {\n            matchedChild = fid;\n            break;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      if (!matchedChild) {\n        const abs = await buildAbsoluteXPathFromChain(\n          iframeChain,\n          curSession,\n          be,\n        );\n        return abs\n          ? { frameId: curFrameId, backendNodeId: be, absoluteXPath: abs }\n          : null;\n      }\n\n      iframeChain.push({\n        parentSession: curSession,\n        iframeBackendNodeId: be,\n      });\n\n      let left = 0;\n      let top = 0;\n      try {\n        const { object } = await curSession.send<{\n          object: { objectId?: string };\n        }>(\"DOM.resolveNode\", { backendNodeId: be });\n        const objectId = object?.objectId;\n        if (objectId) {\n          const { result } = await curSession.send<{\n            result: { value?: { left: number; top: number } };\n          }>(\"Runtime.callFunctionOn\", {\n            objectId,\n            functionDeclaration: a11yScriptSources.getBoundingRectLite,\n            returnByValue: true,\n          });\n          left = Number(result?.value?.left ?? 0);\n          top = Number(result?.value?.top ?? 0);\n          await curSession\n            .send(\"Runtime.releaseObject\", { objectId })\n            .catch(() => {});\n        }\n      } catch {\n        //\n      }\n      curX = Math.max(0, curX - left);\n      curY = Math.max(0, curY - top);\n      curFrameId = matchedChild;\n      curSession = page.getSessionForFrame(curFrameId);\n    } catch {\n      return null;\n    }\n  }\n  return null;\n}\n"]}

package/dist/esm/lib/v3/understudy/locator.d.ts

@@ -104,6 +104,18 @@ export declare class Locator {
         button?: MouseButton;
         clickCount?: number;
     }): Promise<void>;
+    /**
+     * Tap the element at its visual center with a real (trusted) touch.
+     * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`
+     * instead of mouse input, so mobile layouts that gate handlers on touch/pointer
+     * (`pointerType: "touch"`) events — where a mouse click never registers — respond
+     * correctly. This is the deterministic (selector-based) counterpart used when a
+     * recorded CUA `tap` step is replayed.
+     *
+     * Does not require touch emulation: CDP delivers a trusted touch sequence even on
+     * a session reporting `maxTouchPoints: 0`.
+     */
+    tap(): Promise<void>;
     /**
      * Dispatch a DOM 'click' MouseEvent on the element itself.
      * - Does not synthesize real pointer input; directly dispatches an event.

package/dist/esm/lib/v3/understudy/locator.js

@@ -356,6 +356,50 @@ export class Locator {
             }
         }
     }
+    /**
+     * Tap the element at its visual center with a real (trusted) touch.
+     * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`
+     * instead of mouse input, so mobile layouts that gate handlers on touch/pointer
+     * (`pointerType: "touch"`) events — where a mouse click never registers — respond
+     * correctly. This is the deterministic (selector-based) counterpart used when a
+     * recorded CUA `tap` step is replayed.
+     *
+     * Does not require touch emulation: CDP delivers a trusted touch sequence even on
+     * a session reporting `maxTouchPoints: 0`.
+     */
+    async tap() {
+        const session = this.frame.session;
+        const { objectId } = await this.resolveNode();
+        try {
+            await session.send("DOM.scrollIntoViewIfNeeded", { objectId });
+            const box = await session.send("DOM.getBoxModel", { objectId });
+            if (!box.model)
+                throw new ElementNotVisibleError(this.selector);
+            const { cx, cy } = this.centerFromBoxContent(box.model.content);
+            // Pipelined burst, matching click's press/release batching: CDP preserves
+            // per-session command order, so awaiting each dispatch in turn would only
+            // add a round trip (a full network RTT against a remote browser).
+            await Promise.all([
+                session.send("Input.dispatchTouchEvent", {
+                    type: "touchStart",
+                    touchPoints: [{ x: cx, y: cy }],
+                }),
+                session.send("Input.dispatchTouchEvent", {
+                    type: "touchEnd",
+                    touchPoints: [],
+                }),
+            ]);
+        }
+        finally {
+            try {
+                await session.send("Runtime.releaseObject", { objectId });
+            }
+            catch {
+                // If the context navigated or was destroyed (e.g., link opens new tab),
+                // releaseObject may fail with -32000. Ignore as best-effort cleanup.
+            }
+        }
+    }
     /**
      * Dispatch a DOM 'click' MouseEvent on the element itself.
      * - Does not synthesize real pointer input; directly dispatches an event.

package/dist/esm/lib/v3/understudy/locator.js.map

@@ -1 +1 @@
-{"version":3,"file":"locator.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/locator.ts"],"names":[],"mappings":"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","sourcesContent":["// lib/v3/understudy/locator.ts\nimport { Protocol } from \"devtools-protocol\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\nimport {\n  locatorScriptBootstrap,\n  locatorScriptGlobalRefs,\n  locatorScriptSources,\n} from \"../dom/build/locatorScripts.generated.js\";\nimport type { Frame } from \"./frame.js\";\nimport {\n  FrameSelectorResolver,\n  type SelectorQuery,\n} from \"./selectorResolver.js\";\nimport {\n  StagehandElementNotFoundError,\n  StagehandInvalidArgumentError,\n  StagehandLocatorError,\n  ElementNotVisibleError,\n} from \"../types/public/sdkErrors.js\";\nimport { normalizeInputFiles } from \"./fileUploadUtils.js\";\nimport { SetInputFilesArgument, MouseButton } from \"../types/public/locator.js\";\nimport { NormalizedFilePayload } from \"../types/private/locator.js\";\n\nconst MAX_REMOTE_UPLOAD_BYTES = 50 * 1024 * 1024; // 50MB guard copied from Playwright\n\n/**\n * Locator\n *\n * Purpose:\n * A small, CDP-based element interaction helper scoped to a specific `Frame`.\n * It resolves a CSS/XPath selector inside the frame’s **isolated world**, and then\n * performs low-level actions (click, type, select) using DOM/Runtime/Input\n * protocol domains with minimal abstraction.\n *\n * Key change:\n * - Prefer **objectId**-based CDP calls (scroll, geometry) to avoid brittle\n *   frontend nodeId mappings. nodeId is resolved on a best-effort basis and\n *   returned for compatibility, but actions do not depend on it.\n *\n * Notes:\n * - Resolution is lazy: every action resolves the selector again.\n * - Uses `Page.createIsolatedWorld` so evaluation is isolated from page scripts.\n * - Releases remote objects (`Runtime.releaseObject`) where appropriate.\n */\nexport class Locator {\n  private readonly selectorResolver: FrameSelectorResolver;\n\n  private readonly selectorQuery: SelectorQuery;\n\n  // -1 means \"no explicit nth()\"; default locator resolves to first match for actions.\n  private readonly nthIndex: number;\n\n  constructor(\n    private readonly frame: Frame,\n    private readonly selector: string,\n    private readonly options?: { deep?: boolean; depth?: number },\n    nthIndex: number = -1,\n  ) {\n    this.selectorResolver = new FrameSelectorResolver(this.frame);\n    this.selectorQuery = FrameSelectorResolver.parseSelector(selector);\n    const normalized = Number.isFinite(nthIndex) ? Math.floor(nthIndex) : -1;\n    this.nthIndex = normalized < 0 ? -1 : normalized;\n  }\n\n  /** Return the owning Frame for this locator (typed accessor, no private access). */\n  public getFrame(): Frame {\n    return this.frame;\n  }\n\n  /**\n   * Set files on an <input type=\"file\"> element.\n   *\n   * Mirrors Playwright's Locator.setInputFiles basics:\n   * - Accepts file path(s) or payload object(s) { name, mimeType, buffer }.\n   * - Uses CDP DOM.setFileInputFiles under the hood.\n   * - Best‑effort dispatches change/input via CDP (Chrome does by default).\n   * - Passing an empty array clears the selection.\n   */\n  public async setInputFiles(files: SetInputFilesArgument): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const tempFiles: string[] = [];\n\n    try {\n      // Validate element is an <input type=\"file\">\n      try {\n        const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n          \"Runtime.callFunctionOn\",\n          {\n            objectId,\n            functionDeclaration: locatorScriptSources.ensureFileInputElement,\n            returnByValue: true,\n          },\n        );\n        const ok = Boolean(res.result.value);\n        if (!ok)\n          throw new StagehandInvalidArgumentError(\n            'Target is not an <input type=\"file\"> element',\n          );\n      } catch (e) {\n        throw new StagehandInvalidArgumentError(\n          e instanceof Error\n            ? e.message\n            : \"Unable to verify file input element\",\n        );\n      }\n\n      const normalized = await normalizeInputFiles(files);\n\n      if (!normalized.length) {\n        await session.send<never>(\"DOM.setFileInputFiles\", {\n          objectId,\n          files: [],\n        });\n        return;\n      }\n\n      if (this.frame.isBrowserRemote()) {\n        await this.assignFilesViaPayloadInjection(objectId, normalized);\n        return;\n      }\n\n      const filePaths: string[] = [];\n      for (const payload of normalized) {\n        if (payload.absolutePath) {\n          filePaths.push(payload.absolutePath);\n          continue;\n        }\n        const ext = path.extname(payload.name);\n        const tmp = path.join(\n          os.tmpdir(),\n          `stagehand-upload-${Date.now()}-${Math.random().toString(36).slice(2)}${ext}`,\n        );\n        await fs.promises.writeFile(tmp, payload.buffer);\n        tempFiles.push(tmp);\n        filePaths.push(tmp);\n      }\n\n      await session.send<never>(\"DOM.setFileInputFiles\", {\n        objectId,\n        files: filePaths,\n      });\n    } finally {\n      // Cleanup: release element and remove any temporary files we created\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n      for (const p of tempFiles) {\n        try {\n          await fs.promises.unlink(p);\n        } catch {\n          // ignore\n        }\n      }\n    }\n  }\n\n  /**\n   * Remote browser fallback: build File objects inside the page and attach them via JS.\n   *\n   * When Stagehand is driving a browser that cannot see the local filesystem (Browserbase,\n   * remote CDP, etc.), CDP's DOM.setFileInputFiles would fail because Chrome can't reach\n   * our temp files. Instead we base64-encode the payloads, send them into the page, and\n   * let a DOM helper create File objects + dispatch change/input events.\n   */\n  private async assignFilesViaPayloadInjection(\n    objectId: Protocol.Runtime.RemoteObjectId,\n    files: NormalizedFilePayload[],\n  ): Promise<void> {\n    const session = this.frame.session;\n\n    for (const payload of files) {\n      if (payload.buffer.length > MAX_REMOTE_UPLOAD_BYTES) {\n        throw new StagehandInvalidArgumentError(\n          `setInputFiles(): file \"${payload.name}\" is larger than the 50MB limit for remote uploads`,\n        );\n      }\n    }\n\n    const serialized = files.map((payload) => ({\n      name: payload.name,\n      mimeType: payload.mimeType,\n      lastModified: payload.lastModified,\n      base64: payload.buffer.toString(\"base64\"),\n    }));\n\n    const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n      \"Runtime.callFunctionOn\",\n      {\n        objectId,\n        functionDeclaration:\n          locatorScriptSources.assignFilePayloadsToInputElement,\n        arguments: [\n          {\n            value: serialized,\n          },\n        ],\n        returnByValue: true,\n      },\n    );\n\n    const ok = Boolean(res.result?.value);\n    if (!ok) {\n      throw new StagehandInvalidArgumentError(\n        \"Unable to assign file payloads to remote input element\",\n      );\n    }\n  }\n\n  /**\n   * Return the DOM backendNodeId for this locator's target element.\n   * Useful for identity comparisons without needing element handles.\n   */\n  async backendNodeId(): Promise<Protocol.DOM.BackendNodeId> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send(\"DOM.enable\").catch(() => {});\n      const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n        \"DOM.describeNode\",\n        { objectId },\n      );\n      return node.backendNodeId as Protocol.DOM.BackendNodeId;\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /** Return how many nodes the current selector resolves to. */\n  public async count(): Promise<number> {\n    const session = this.frame.session;\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n    return this.selectorResolver.count(this.selectorQuery);\n  }\n\n  /**\n   * Return the center of the element's bounding box in the owning frame's viewport\n   * (CSS pixels), rounded to integers. Scrolls into view best-effort.\n   */\n  public async centroid(): Promise<{ x: number; y: number }> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n      return { x: Math.round(cx), y: Math.round(cy) };\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Highlight the element's bounding box using the CDP Overlay domain.\n   * - Scrolls element into view best-effort.\n   * - Shows a semi-transparent overlay briefly, then hides it.\n   */\n  public async highlight(options?: {\n    durationMs?: number;\n    borderColor?: { r: number; g: number; b: number; a?: number };\n    contentColor?: { r: number; g: number; b: number; a?: number };\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const duration = Math.max(0, options?.durationMs ?? 800);\n\n    const borderColor = options?.borderColor ?? { r: 255, g: 0, b: 0, a: 0.9 };\n    const contentColor =\n      options?.contentColor ?? ({ r: 255, g: 200, b: 0, a: 0.2 } as const);\n\n    try {\n      await session.send(\"Overlay.enable\").catch(() => {});\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      // Prefer backendNodeId to keep highlight stable even if objectId is released.\n      await session.send(\"DOM.enable\").catch(() => {});\n      let backendNodeId: Protocol.DOM.BackendNodeId | undefined;\n      try {\n        const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n          \"DOM.describeNode\",\n          { objectId },\n        );\n        backendNodeId = node.backendNodeId as Protocol.DOM.BackendNodeId;\n      } catch {\n        backendNodeId = undefined;\n      }\n\n      const highlightConfig: Protocol.Overlay.HighlightConfig = {\n        showInfo: false,\n        showStyles: false,\n        showRulers: false,\n        showExtensionLines: false,\n        borderColor,\n        contentColor,\n      } as Protocol.Overlay.HighlightConfig;\n\n      const highlightOnce = async () => {\n        await session.send<never>(\"Overlay.highlightNode\", {\n          ...(backendNodeId ? { backendNodeId } : { objectId }),\n          highlightConfig,\n        });\n      };\n\n      // Initial draw\n      await highlightOnce();\n\n      // Keep alive until duration elapses to resist overlay clears on mouse move/repaints\n      if (duration > 0) {\n        const start = Date.now();\n        const tick = Math.min(300, Math.max(100, Math.floor(duration / 50)));\n        while (Date.now() - start < duration) {\n          await new Promise((r) => setTimeout(r, tick));\n          try {\n            await highlightOnce();\n          } catch {\n            // ignore transient errors\n          }\n        }\n        await session.send<never>(\"Overlay.hideHighlight\").catch(() => {});\n      }\n    } finally {\n      // Releasing objectId should not affect highlight when using backendNodeId.\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Move the mouse cursor to the element's visual center without clicking.\n   * - Scrolls into view best-effort, resolves geometry, then dispatches a mouse move.\n   */\n  async hover(): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      await session.send<never>(\"Input.dispatchMouseEvent\", {\n        type: \"mouseMoved\",\n        x: cx,\n        y: cy,\n        button: \"none\",\n      } as Protocol.Input.DispatchMouseEventRequest);\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Click the element at its visual center.\n   * Steps:\n   *  1) Resolve selector to { objectId } in the frame world.\n   *  2) Scroll into view via `DOM.scrollIntoViewIfNeeded({ objectId })`.\n   *  3) Read geometry via `DOM.getBoxModel({ objectId })` → compute a center point.\n   *  4) Synthesize mouse press + release via `Input.dispatchMouseEvent`.\n   */\n  async click(options?: {\n    button?: MouseButton;\n    clickCount?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const button = options?.button ?? \"left\";\n    const clickCount = options?.clickCount ?? 1;\n\n    try {\n      // Scroll into view using objectId (avoids frontend nodeId dependence)\n      await session.send(\"DOM.scrollIntoViewIfNeeded\", { objectId });\n\n      // Get geometry using objectId\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      // Dispatch click events in a pipelined burst to reduce inter-click delay\n      // from network/CPU jitter between round trips.\n      const dispatches: Array<Promise<unknown>> = [];\n      dispatches.push(\n        session.send<never>(\"Input.dispatchMouseEvent\", {\n          type: \"mouseMoved\",\n          x: cx,\n          y: cy,\n          button: \"none\",\n        } as Protocol.Input.DispatchMouseEventRequest),\n      );\n\n      for (let i = 1; i <= clickCount; i++) {\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mousePressed\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mouseReleased\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n      }\n      await Promise.all(dispatches);\n    } finally {\n      // release the element handle\n      try {\n        await session.send<never>(\"Runtime.releaseObject\", { objectId });\n      } catch {\n        // If the context navigated or was destroyed (e.g., link opens new tab),\n        // releaseObject may fail with -32000. Ignore as best-effort cleanup.\n      }\n    }\n  }\n\n  /**\n   * Dispatch a DOM 'click' MouseEvent on the element itself.\n   * - Does not synthesize real pointer input; directly dispatches an event.\n   * - Useful for elements that rely on click handlers without needing hit-testing.\n   */\n  async sendClickEvent(options?: {\n    bubbles?: boolean;\n    cancelable?: boolean;\n    composed?: boolean;\n    detail?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const bubbles = options?.bubbles ?? true;\n    const cancelable = options?.cancelable ?? true;\n    const composed = options?.composed ?? true;\n    const detail = options?.detail ?? 1;\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.dispatchDomClick,\n          arguments: [\n            {\n              value: { bubbles, cancelable, composed, detail },\n            },\n          ],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Scroll the element vertically to a given percentage (0–100).\n   * - If the element is <html> or <body>, scrolls the window/document.\n   * - Otherwise, scrolls the element itself via element.scrollTo.\n   */\n  async scrollTo(percent: number | string): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.scrollElementToPercent,\n          arguments: [{ value: percent as unknown as number }],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Fill an input/textarea/contenteditable element.\n   * Mirrors Playwright semantics: the DOM helper either applies the native\n   * value setter (for special input types) or asks us to type text via the CDP\n   * Input domain after focusing/selecting.\n   */\n  async fill(value: string): Promise<void> {\n    const session = this.frame.session;\n    // Use the bundled locator globals; the raw fill snippet depends on helper symbols.\n    const fillDeclaration = `function(value) { ${locatorScriptBootstrap}; return ${locatorScriptGlobalRefs.fillElementValue}.call(this, value); }`;\n    const { objectId } = await this.resolveNode();\n\n    let releaseNeeded = true;\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: fillDeclaration,\n          arguments: [{ value }],\n          returnByValue: true,\n        },\n      );\n      if (res.exceptionDetails) {\n        // prefer exception.description over text (eg \"Uncaught\")\n        const message =\n          res.exceptionDetails.exception?.description ??\n          res.exceptionDetails.text ??\n          \"Unknown exception during locator().fill()\";\n        throw new StagehandLocatorError(\"Filling\", this.selector, message);\n      }\n\n      const result = res.result.value as\n        | { status?: string; reason?: string; value?: string }\n        | null\n        | undefined;\n      const status =\n        typeof result === \"object\" && result ? result.status : undefined;\n\n      if (status === \"done\") {\n        return;\n      }\n\n      if (status === \"needsinput\") {\n        // Release the current handle before synthesizing keyboard input to avoid leaking it.\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n        releaseNeeded = false;\n\n        const valueToType =\n          typeof result?.value === \"string\" ? result.value : value;\n\n        let prepared = false;\n        try {\n          const { objectId: prepObjectId } = await this.resolveNode();\n          try {\n            const prepRes =\n              await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n                \"Runtime.callFunctionOn\",\n                {\n                  objectId: prepObjectId,\n                  functionDeclaration:\n                    locatorScriptSources.prepareElementForTyping,\n                  returnByValue: true,\n                },\n              );\n            prepared = Boolean(prepRes.result.value);\n          } finally {\n            await session\n              .send<never>(\"Runtime.releaseObject\", { objectId: prepObjectId })\n              .catch(() => {});\n          }\n        } catch {\n          // Ignore preparation failures; we'll fall back to typing best-effort.\n        }\n\n        if (!prepared && valueToType.length > 0) {\n          await this.type(valueToType);\n          return;\n        }\n\n        if (valueToType.length === 0) {\n          // Simulate deleting the currently selected text to clear the field.\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyDown\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyUp\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n        } else {\n          await session.send<never>(\"Input.insertText\", { text: valueToType });\n        }\n\n        return;\n      }\n\n      if (status === \"error\") {\n        const reason =\n          typeof result?.reason === \"string\" && result.reason.length > 0\n            ? result.reason\n            : \"Failed to fill element\";\n        throw new StagehandInvalidArgumentError(\n          `Failed to fill element (${reason})`,\n        );\n      }\n\n      // Backward compatibility: if no status is returned (older bundle), fall back to setter logic.\n      if (!status) {\n        await this.type(value);\n      }\n    } finally {\n      if (releaseNeeded) {\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * Type text into the element (focuses first).\n   * - Focus via element.focus() in page JS (no DOM.focus(nodeId)).\n   * - If no delay, uses `Input.insertText` for efficiency.\n   * - With delay, synthesizes `keyDown`/`keyUp` per character.\n   */\n  async type(text: string, options?: { delay?: number }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    try {\n      // Focus using JS (avoids DOM.focus(nodeId))\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.focusElement,\n          returnByValue: true,\n        },\n      );\n\n      if (!options?.delay) {\n        await session.send<never>(\"Input.insertText\", { text });\n        return;\n      }\n\n      for (const ch of text) {\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyDown\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyUp\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await new Promise((r) => setTimeout(r, options.delay));\n      }\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Select one or more options on a `<select>` element.\n   * Returns the values actually selected after the operation.\n   */\n  async selectOption(values: string | string[]): Promise<string[]> {\n    const session = this.frame.session;\n    const desired = Array.isArray(values) ? values : [values];\n    const { objectId } = await this.resolveNode();\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.selectElementOptions,\n          arguments: [{ value: desired }],\n          returnByValue: true,\n        },\n      );\n\n      return (res.result.value as string[]) ?? [];\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is attached and visible (rough heuristic).\n   */\n  async isVisible(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementVisible,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is an input[type=checkbox|radio] and is checked.\n   * Also considers aria-checked for ARIA widgets.\n   */\n  async isChecked(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementChecked,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's input value (for input/textarea/select/contenteditable).\n   */\n  async inputValue(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInputValue,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's textContent (raw, not innerText).\n   */\n  async textContent(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementTextContent,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerHTML string.\n   */\n  async innerHtml(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerHTML,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerText (layout-aware, visible text).\n   */\n  async innerText(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerText,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return a locator narrowed to the first match.\n   */\n  first(): Locator {\n    return this.nth(0);\n  }\n\n  /** Return a locator narrowed to the element at the given zero-based index. */\n  nth(index: number): Locator {\n    const value = Number(index);\n    if (!Number.isFinite(value) || value < 0) {\n      throw new StagehandInvalidArgumentError(\n        \"locator().nth() expects a non-negative index\",\n      );\n    }\n\n    const nextIndex = Math.floor(value);\n    if (nextIndex === this.nthIndex) {\n      return this;\n    }\n\n    return new Locator(this.frame, this.selector, this.options, nextIndex);\n  }\n\n  // ---------- helpers ----------\n\n  /**\n   * Resolve `this.selector` within the frame to `{ objectId, nodeId? }`:\n   * Delegates to a shared selector resolver so all selector logic stays in sync.\n   */\n  public async resolveNode(): Promise<{\n    nodeId: Protocol.DOM.NodeId | null;\n    objectId: Protocol.Runtime.RemoteObjectId;\n  }> {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    const index = this.nthIndex < 0 ? 0 : this.nthIndex;\n    const resolved = await this.selectorResolver.resolveAtIndex(\n      this.selectorQuery,\n      index,\n    );\n    if (!resolved) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n\n    return resolved;\n  }\n\n  /**\n   * Resolve all matching nodes for this locator.\n   * If the locator is narrowed via nth(), only that index is returned.\n   */\n  public async resolveNodesForMask(): Promise<\n    Array<{\n      nodeId: Protocol.DOM.NodeId | null;\n      objectId: Protocol.Runtime.RemoteObjectId;\n    }>\n  > {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    if (this.nthIndex >= 0) {\n      const resolved = await this.selectorResolver.resolveAtIndex(\n        this.selectorQuery,\n        this.nthIndex,\n      );\n      if (!resolved) {\n        throw new StagehandElementNotFoundError([this.selector]);\n      }\n      return [resolved];\n    }\n\n    const resolved = await this.selectorResolver.resolveAll(this.selectorQuery);\n    if (!resolved.length) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n    return resolved;\n  }\n\n  /** Compute a center point from a BoxModel content quad */\n  private centerFromBoxContent(content: number[]): { cx: number; cy: number } {\n    // content is [x1,y1, x2,y2, x3,y3, x4,y4]\n    if (!content || content.length < 8) {\n      throw new StagehandInvalidArgumentError(\"Invalid box model content quad\");\n    }\n    const xs = [content[0], content[2], content[4], content[6]];\n    const ys = [content[1], content[3], content[5], content[7]];\n    const cx = (xs[0] + xs[1] + xs[2] + xs[3]) / 4;\n    const cy = (ys[0] + ys[1] + ys[2] + ys[3]) / 4;\n    return { cx, cy };\n  }\n}\n"]}
+{"version":3,"file":"locator.js","sourceRoot":"","sources":["../../../../../lib/v3/understudy/locator.ts"],"names":[],"mappings":"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","sourcesContent":["// lib/v3/understudy/locator.ts\nimport { Protocol } from \"devtools-protocol\";\nimport * as fs from \"fs\";\nimport * as os from \"os\";\nimport * as path from \"path\";\nimport {\n  locatorScriptBootstrap,\n  locatorScriptGlobalRefs,\n  locatorScriptSources,\n} from \"../dom/build/locatorScripts.generated.js\";\nimport type { Frame } from \"./frame.js\";\nimport {\n  FrameSelectorResolver,\n  type SelectorQuery,\n} from \"./selectorResolver.js\";\nimport {\n  StagehandElementNotFoundError,\n  StagehandInvalidArgumentError,\n  StagehandLocatorError,\n  ElementNotVisibleError,\n} from \"../types/public/sdkErrors.js\";\nimport { normalizeInputFiles } from \"./fileUploadUtils.js\";\nimport { SetInputFilesArgument, MouseButton } from \"../types/public/locator.js\";\nimport { NormalizedFilePayload } from \"../types/private/locator.js\";\n\nconst MAX_REMOTE_UPLOAD_BYTES = 50 * 1024 * 1024; // 50MB guard copied from Playwright\n\n/**\n * Locator\n *\n * Purpose:\n * A small, CDP-based element interaction helper scoped to a specific `Frame`.\n * It resolves a CSS/XPath selector inside the frame’s **isolated world**, and then\n * performs low-level actions (click, type, select) using DOM/Runtime/Input\n * protocol domains with minimal abstraction.\n *\n * Key change:\n * - Prefer **objectId**-based CDP calls (scroll, geometry) to avoid brittle\n *   frontend nodeId mappings. nodeId is resolved on a best-effort basis and\n *   returned for compatibility, but actions do not depend on it.\n *\n * Notes:\n * - Resolution is lazy: every action resolves the selector again.\n * - Uses `Page.createIsolatedWorld` so evaluation is isolated from page scripts.\n * - Releases remote objects (`Runtime.releaseObject`) where appropriate.\n */\nexport class Locator {\n  private readonly selectorResolver: FrameSelectorResolver;\n\n  private readonly selectorQuery: SelectorQuery;\n\n  // -1 means \"no explicit nth()\"; default locator resolves to first match for actions.\n  private readonly nthIndex: number;\n\n  constructor(\n    private readonly frame: Frame,\n    private readonly selector: string,\n    private readonly options?: { deep?: boolean; depth?: number },\n    nthIndex: number = -1,\n  ) {\n    this.selectorResolver = new FrameSelectorResolver(this.frame);\n    this.selectorQuery = FrameSelectorResolver.parseSelector(selector);\n    const normalized = Number.isFinite(nthIndex) ? Math.floor(nthIndex) : -1;\n    this.nthIndex = normalized < 0 ? -1 : normalized;\n  }\n\n  /** Return the owning Frame for this locator (typed accessor, no private access). */\n  public getFrame(): Frame {\n    return this.frame;\n  }\n\n  /**\n   * Set files on an <input type=\"file\"> element.\n   *\n   * Mirrors Playwright's Locator.setInputFiles basics:\n   * - Accepts file path(s) or payload object(s) { name, mimeType, buffer }.\n   * - Uses CDP DOM.setFileInputFiles under the hood.\n   * - Best‑effort dispatches change/input via CDP (Chrome does by default).\n   * - Passing an empty array clears the selection.\n   */\n  public async setInputFiles(files: SetInputFilesArgument): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const tempFiles: string[] = [];\n\n    try {\n      // Validate element is an <input type=\"file\">\n      try {\n        const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n          \"Runtime.callFunctionOn\",\n          {\n            objectId,\n            functionDeclaration: locatorScriptSources.ensureFileInputElement,\n            returnByValue: true,\n          },\n        );\n        const ok = Boolean(res.result.value);\n        if (!ok)\n          throw new StagehandInvalidArgumentError(\n            'Target is not an <input type=\"file\"> element',\n          );\n      } catch (e) {\n        throw new StagehandInvalidArgumentError(\n          e instanceof Error\n            ? e.message\n            : \"Unable to verify file input element\",\n        );\n      }\n\n      const normalized = await normalizeInputFiles(files);\n\n      if (!normalized.length) {\n        await session.send<never>(\"DOM.setFileInputFiles\", {\n          objectId,\n          files: [],\n        });\n        return;\n      }\n\n      if (this.frame.isBrowserRemote()) {\n        await this.assignFilesViaPayloadInjection(objectId, normalized);\n        return;\n      }\n\n      const filePaths: string[] = [];\n      for (const payload of normalized) {\n        if (payload.absolutePath) {\n          filePaths.push(payload.absolutePath);\n          continue;\n        }\n        const ext = path.extname(payload.name);\n        const tmp = path.join(\n          os.tmpdir(),\n          `stagehand-upload-${Date.now()}-${Math.random().toString(36).slice(2)}${ext}`,\n        );\n        await fs.promises.writeFile(tmp, payload.buffer);\n        tempFiles.push(tmp);\n        filePaths.push(tmp);\n      }\n\n      await session.send<never>(\"DOM.setFileInputFiles\", {\n        objectId,\n        files: filePaths,\n      });\n    } finally {\n      // Cleanup: release element and remove any temporary files we created\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n      for (const p of tempFiles) {\n        try {\n          await fs.promises.unlink(p);\n        } catch {\n          // ignore\n        }\n      }\n    }\n  }\n\n  /**\n   * Remote browser fallback: build File objects inside the page and attach them via JS.\n   *\n   * When Stagehand is driving a browser that cannot see the local filesystem (Browserbase,\n   * remote CDP, etc.), CDP's DOM.setFileInputFiles would fail because Chrome can't reach\n   * our temp files. Instead we base64-encode the payloads, send them into the page, and\n   * let a DOM helper create File objects + dispatch change/input events.\n   */\n  private async assignFilesViaPayloadInjection(\n    objectId: Protocol.Runtime.RemoteObjectId,\n    files: NormalizedFilePayload[],\n  ): Promise<void> {\n    const session = this.frame.session;\n\n    for (const payload of files) {\n      if (payload.buffer.length > MAX_REMOTE_UPLOAD_BYTES) {\n        throw new StagehandInvalidArgumentError(\n          `setInputFiles(): file \"${payload.name}\" is larger than the 50MB limit for remote uploads`,\n        );\n      }\n    }\n\n    const serialized = files.map((payload) => ({\n      name: payload.name,\n      mimeType: payload.mimeType,\n      lastModified: payload.lastModified,\n      base64: payload.buffer.toString(\"base64\"),\n    }));\n\n    const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n      \"Runtime.callFunctionOn\",\n      {\n        objectId,\n        functionDeclaration:\n          locatorScriptSources.assignFilePayloadsToInputElement,\n        arguments: [\n          {\n            value: serialized,\n          },\n        ],\n        returnByValue: true,\n      },\n    );\n\n    const ok = Boolean(res.result?.value);\n    if (!ok) {\n      throw new StagehandInvalidArgumentError(\n        \"Unable to assign file payloads to remote input element\",\n      );\n    }\n  }\n\n  /**\n   * Return the DOM backendNodeId for this locator's target element.\n   * Useful for identity comparisons without needing element handles.\n   */\n  async backendNodeId(): Promise<Protocol.DOM.BackendNodeId> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send(\"DOM.enable\").catch(() => {});\n      const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n        \"DOM.describeNode\",\n        { objectId },\n      );\n      return node.backendNodeId as Protocol.DOM.BackendNodeId;\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /** Return how many nodes the current selector resolves to. */\n  public async count(): Promise<number> {\n    const session = this.frame.session;\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n    return this.selectorResolver.count(this.selectorQuery);\n  }\n\n  /**\n   * Return the center of the element's bounding box in the owning frame's viewport\n   * (CSS pixels), rounded to integers. Scrolls into view best-effort.\n   */\n  public async centroid(): Promise<{ x: number; y: number }> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n      return { x: Math.round(cx), y: Math.round(cy) };\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Highlight the element's bounding box using the CDP Overlay domain.\n   * - Scrolls element into view best-effort.\n   * - Shows a semi-transparent overlay briefly, then hides it.\n   */\n  public async highlight(options?: {\n    durationMs?: number;\n    borderColor?: { r: number; g: number; b: number; a?: number };\n    contentColor?: { r: number; g: number; b: number; a?: number };\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const duration = Math.max(0, options?.durationMs ?? 800);\n\n    const borderColor = options?.borderColor ?? { r: 255, g: 0, b: 0, a: 0.9 };\n    const contentColor =\n      options?.contentColor ?? ({ r: 255, g: 200, b: 0, a: 0.2 } as const);\n\n    try {\n      await session.send(\"Overlay.enable\").catch(() => {});\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      // Prefer backendNodeId to keep highlight stable even if objectId is released.\n      await session.send(\"DOM.enable\").catch(() => {});\n      let backendNodeId: Protocol.DOM.BackendNodeId | undefined;\n      try {\n        const { node } = await session.send<{ node: Protocol.DOM.Node }>(\n          \"DOM.describeNode\",\n          { objectId },\n        );\n        backendNodeId = node.backendNodeId as Protocol.DOM.BackendNodeId;\n      } catch {\n        backendNodeId = undefined;\n      }\n\n      const highlightConfig: Protocol.Overlay.HighlightConfig = {\n        showInfo: false,\n        showStyles: false,\n        showRulers: false,\n        showExtensionLines: false,\n        borderColor,\n        contentColor,\n      } as Protocol.Overlay.HighlightConfig;\n\n      const highlightOnce = async () => {\n        await session.send<never>(\"Overlay.highlightNode\", {\n          ...(backendNodeId ? { backendNodeId } : { objectId }),\n          highlightConfig,\n        });\n      };\n\n      // Initial draw\n      await highlightOnce();\n\n      // Keep alive until duration elapses to resist overlay clears on mouse move/repaints\n      if (duration > 0) {\n        const start = Date.now();\n        const tick = Math.min(300, Math.max(100, Math.floor(duration / 50)));\n        while (Date.now() - start < duration) {\n          await new Promise((r) => setTimeout(r, tick));\n          try {\n            await highlightOnce();\n          } catch {\n            // ignore transient errors\n          }\n        }\n        await session.send<never>(\"Overlay.hideHighlight\").catch(() => {});\n      }\n    } finally {\n      // Releasing objectId should not affect highlight when using backendNodeId.\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Move the mouse cursor to the element's visual center without clicking.\n   * - Scrolls into view best-effort, resolves geometry, then dispatches a mouse move.\n   */\n  async hover(): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      await session.send<never>(\"Input.dispatchMouseEvent\", {\n        type: \"mouseMoved\",\n        x: cx,\n        y: cy,\n        button: \"none\",\n      } as Protocol.Input.DispatchMouseEventRequest);\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Click the element at its visual center.\n   * Steps:\n   *  1) Resolve selector to { objectId } in the frame world.\n   *  2) Scroll into view via `DOM.scrollIntoViewIfNeeded({ objectId })`.\n   *  3) Read geometry via `DOM.getBoxModel({ objectId })` → compute a center point.\n   *  4) Synthesize mouse press + release via `Input.dispatchMouseEvent`.\n   */\n  async click(options?: {\n    button?: MouseButton;\n    clickCount?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    const button = options?.button ?? \"left\";\n    const clickCount = options?.clickCount ?? 1;\n\n    try {\n      // Scroll into view using objectId (avoids frontend nodeId dependence)\n      await session.send(\"DOM.scrollIntoViewIfNeeded\", { objectId });\n\n      // Get geometry using objectId\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      // Dispatch click events in a pipelined burst to reduce inter-click delay\n      // from network/CPU jitter between round trips.\n      const dispatches: Array<Promise<unknown>> = [];\n      dispatches.push(\n        session.send<never>(\"Input.dispatchMouseEvent\", {\n          type: \"mouseMoved\",\n          x: cx,\n          y: cy,\n          button: \"none\",\n        } as Protocol.Input.DispatchMouseEventRequest),\n      );\n\n      for (let i = 1; i <= clickCount; i++) {\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mousePressed\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n        dispatches.push(\n          session.send<never>(\"Input.dispatchMouseEvent\", {\n            type: \"mouseReleased\",\n            x: cx,\n            y: cy,\n            button,\n            clickCount: i,\n          } as Protocol.Input.DispatchMouseEventRequest),\n        );\n      }\n      await Promise.all(dispatches);\n    } finally {\n      // release the element handle\n      try {\n        await session.send<never>(\"Runtime.releaseObject\", { objectId });\n      } catch {\n        // If the context navigated or was destroyed (e.g., link opens new tab),\n        // releaseObject may fail with -32000. Ignore as best-effort cleanup.\n      }\n    }\n  }\n\n  /**\n   * Tap the element at its visual center with a real (trusted) touch.\n   * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`\n   * instead of mouse input, so mobile layouts that gate handlers on touch/pointer\n   * (`pointerType: \"touch\"`) events — where a mouse click never registers — respond\n   * correctly. This is the deterministic (selector-based) counterpart used when a\n   * recorded CUA `tap` step is replayed.\n   *\n   * Does not require touch emulation: CDP delivers a trusted touch sequence even on\n   * a session reporting `maxTouchPoints: 0`.\n   */\n  async tap(): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    try {\n      await session.send(\"DOM.scrollIntoViewIfNeeded\", { objectId });\n\n      const box = await session.send<Protocol.DOM.GetBoxModelResponse>(\n        \"DOM.getBoxModel\",\n        { objectId },\n      );\n      if (!box.model) throw new ElementNotVisibleError(this.selector);\n      const { cx, cy } = this.centerFromBoxContent(box.model.content);\n\n      // Pipelined burst, matching click's press/release batching: CDP preserves\n      // per-session command order, so awaiting each dispatch in turn would only\n      // add a round trip (a full network RTT against a remote browser).\n      await Promise.all([\n        session.send<never>(\"Input.dispatchTouchEvent\", {\n          type: \"touchStart\",\n          touchPoints: [{ x: cx, y: cy }],\n        } as Protocol.Input.DispatchTouchEventRequest),\n        session.send<never>(\"Input.dispatchTouchEvent\", {\n          type: \"touchEnd\",\n          touchPoints: [],\n        } as Protocol.Input.DispatchTouchEventRequest),\n      ]);\n    } finally {\n      try {\n        await session.send<never>(\"Runtime.releaseObject\", { objectId });\n      } catch {\n        // If the context navigated or was destroyed (e.g., link opens new tab),\n        // releaseObject may fail with -32000. Ignore as best-effort cleanup.\n      }\n    }\n  }\n\n  /**\n   * Dispatch a DOM 'click' MouseEvent on the element itself.\n   * - Does not synthesize real pointer input; directly dispatches an event.\n   * - Useful for elements that rely on click handlers without needing hit-testing.\n   */\n  async sendClickEvent(options?: {\n    bubbles?: boolean;\n    cancelable?: boolean;\n    composed?: boolean;\n    detail?: number;\n  }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    const bubbles = options?.bubbles ?? true;\n    const cancelable = options?.cancelable ?? true;\n    const composed = options?.composed ?? true;\n    const detail = options?.detail ?? 1;\n    try {\n      await session\n        .send(\"DOM.scrollIntoViewIfNeeded\", { objectId })\n        .catch(() => {});\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.dispatchDomClick,\n          arguments: [\n            {\n              value: { bubbles, cancelable, composed, detail },\n            },\n          ],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Scroll the element vertically to a given percentage (0–100).\n   * - If the element is <html> or <body>, scrolls the window/document.\n   * - Otherwise, scrolls the element itself via element.scrollTo.\n   */\n  async scrollTo(percent: number | string): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.scrollElementToPercent,\n          arguments: [{ value: percent as unknown as number }],\n          returnByValue: true,\n        },\n      );\n    } finally {\n      await session\n        .send<never>(\"Runtime.releaseObject\", { objectId })\n        .catch(() => {});\n    }\n  }\n\n  /**\n   * Fill an input/textarea/contenteditable element.\n   * Mirrors Playwright semantics: the DOM helper either applies the native\n   * value setter (for special input types) or asks us to type text via the CDP\n   * Input domain after focusing/selecting.\n   */\n  async fill(value: string): Promise<void> {\n    const session = this.frame.session;\n    // Use the bundled locator globals; the raw fill snippet depends on helper symbols.\n    const fillDeclaration = `function(value) { ${locatorScriptBootstrap}; return ${locatorScriptGlobalRefs.fillElementValue}.call(this, value); }`;\n    const { objectId } = await this.resolveNode();\n\n    let releaseNeeded = true;\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: fillDeclaration,\n          arguments: [{ value }],\n          returnByValue: true,\n        },\n      );\n      if (res.exceptionDetails) {\n        // prefer exception.description over text (eg \"Uncaught\")\n        const message =\n          res.exceptionDetails.exception?.description ??\n          res.exceptionDetails.text ??\n          \"Unknown exception during locator().fill()\";\n        throw new StagehandLocatorError(\"Filling\", this.selector, message);\n      }\n\n      const result = res.result.value as\n        | { status?: string; reason?: string; value?: string }\n        | null\n        | undefined;\n      const status =\n        typeof result === \"object\" && result ? result.status : undefined;\n\n      if (status === \"done\") {\n        return;\n      }\n\n      if (status === \"needsinput\") {\n        // Release the current handle before synthesizing keyboard input to avoid leaking it.\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n        releaseNeeded = false;\n\n        const valueToType =\n          typeof result?.value === \"string\" ? result.value : value;\n\n        let prepared = false;\n        try {\n          const { objectId: prepObjectId } = await this.resolveNode();\n          try {\n            const prepRes =\n              await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n                \"Runtime.callFunctionOn\",\n                {\n                  objectId: prepObjectId,\n                  functionDeclaration:\n                    locatorScriptSources.prepareElementForTyping,\n                  returnByValue: true,\n                },\n              );\n            prepared = Boolean(prepRes.result.value);\n          } finally {\n            await session\n              .send<never>(\"Runtime.releaseObject\", { objectId: prepObjectId })\n              .catch(() => {});\n          }\n        } catch {\n          // Ignore preparation failures; we'll fall back to typing best-effort.\n        }\n\n        if (!prepared && valueToType.length > 0) {\n          await this.type(valueToType);\n          return;\n        }\n\n        if (valueToType.length === 0) {\n          // Simulate deleting the currently selected text to clear the field.\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyDown\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n          await session.send<never>(\"Input.dispatchKeyEvent\", {\n            type: \"keyUp\",\n            key: \"Backspace\",\n            code: \"Backspace\",\n            windowsVirtualKeyCode: 8,\n            nativeVirtualKeyCode: 8,\n          } as Protocol.Input.DispatchKeyEventRequest);\n        } else {\n          await session.send<never>(\"Input.insertText\", { text: valueToType });\n        }\n\n        return;\n      }\n\n      if (status === \"error\") {\n        const reason =\n          typeof result?.reason === \"string\" && result.reason.length > 0\n            ? result.reason\n            : \"Failed to fill element\";\n        throw new StagehandInvalidArgumentError(\n          `Failed to fill element (${reason})`,\n        );\n      }\n\n      // Backward compatibility: if no status is returned (older bundle), fall back to setter logic.\n      if (!status) {\n        await this.type(value);\n      }\n    } finally {\n      if (releaseNeeded) {\n        await session\n          .send<never>(\"Runtime.releaseObject\", { objectId })\n          .catch(() => {});\n      }\n    }\n  }\n\n  /**\n   * Type text into the element (focuses first).\n   * - Focus via element.focus() in page JS (no DOM.focus(nodeId)).\n   * - If no delay, uses `Input.insertText` for efficiency.\n   * - With delay, synthesizes `keyDown`/`keyUp` per character.\n   */\n  async type(text: string, options?: { delay?: number }): Promise<void> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n\n    try {\n      // Focus using JS (avoids DOM.focus(nodeId))\n      await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.focusElement,\n          returnByValue: true,\n        },\n      );\n\n      if (!options?.delay) {\n        await session.send<never>(\"Input.insertText\", { text });\n        return;\n      }\n\n      for (const ch of text) {\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyDown\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await session.send<never>(\"Input.dispatchKeyEvent\", {\n          type: \"keyUp\",\n          text: ch,\n          key: ch,\n        } as Protocol.Input.DispatchKeyEventRequest);\n\n        await new Promise((r) => setTimeout(r, options.delay));\n      }\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Select one or more options on a `<select>` element.\n   * Returns the values actually selected after the operation.\n   */\n  async selectOption(values: string | string[]): Promise<string[]> {\n    const session = this.frame.session;\n    const desired = Array.isArray(values) ? values : [values];\n    const { objectId } = await this.resolveNode();\n\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.selectElementOptions,\n          arguments: [{ value: desired }],\n          returnByValue: true,\n        },\n      );\n\n      return (res.result.value as string[]) ?? [];\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is attached and visible (rough heuristic).\n   */\n  async isVisible(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementVisible,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return true if the element is an input[type=checkbox|radio] and is checked.\n   * Also considers aria-checked for ARIA widgets.\n   */\n  async isChecked(): Promise<boolean> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.isElementChecked,\n          returnByValue: true,\n        },\n      );\n      return Boolean(res.result.value);\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's input value (for input/textarea/select/contenteditable).\n   */\n  async inputValue(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInputValue,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's textContent (raw, not innerText).\n   */\n  async textContent(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementTextContent,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerHTML string.\n   */\n  async innerHtml(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerHTML,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return the element's innerText (layout-aware, visible text).\n   */\n  async innerText(): Promise<string> {\n    const session = this.frame.session;\n    const { objectId } = await this.resolveNode();\n    try {\n      const res = await session.send<Protocol.Runtime.CallFunctionOnResponse>(\n        \"Runtime.callFunctionOn\",\n        {\n          objectId,\n          functionDeclaration: locatorScriptSources.readElementInnerText,\n          returnByValue: true,\n        },\n      );\n      return String(res.result.value ?? \"\");\n    } finally {\n      await session.send<never>(\"Runtime.releaseObject\", { objectId });\n    }\n  }\n\n  /**\n   * Return a locator narrowed to the first match.\n   */\n  first(): Locator {\n    return this.nth(0);\n  }\n\n  /** Return a locator narrowed to the element at the given zero-based index. */\n  nth(index: number): Locator {\n    const value = Number(index);\n    if (!Number.isFinite(value) || value < 0) {\n      throw new StagehandInvalidArgumentError(\n        \"locator().nth() expects a non-negative index\",\n      );\n    }\n\n    const nextIndex = Math.floor(value);\n    if (nextIndex === this.nthIndex) {\n      return this;\n    }\n\n    return new Locator(this.frame, this.selector, this.options, nextIndex);\n  }\n\n  // ---------- helpers ----------\n\n  /**\n   * Resolve `this.selector` within the frame to `{ objectId, nodeId? }`:\n   * Delegates to a shared selector resolver so all selector logic stays in sync.\n   */\n  public async resolveNode(): Promise<{\n    nodeId: Protocol.DOM.NodeId | null;\n    objectId: Protocol.Runtime.RemoteObjectId;\n  }> {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    const index = this.nthIndex < 0 ? 0 : this.nthIndex;\n    const resolved = await this.selectorResolver.resolveAtIndex(\n      this.selectorQuery,\n      index,\n    );\n    if (!resolved) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n\n    return resolved;\n  }\n\n  /**\n   * Resolve all matching nodes for this locator.\n   * If the locator is narrowed via nth(), only that index is returned.\n   */\n  public async resolveNodesForMask(): Promise<\n    Array<{\n      nodeId: Protocol.DOM.NodeId | null;\n      objectId: Protocol.Runtime.RemoteObjectId;\n    }>\n  > {\n    const session = this.frame.session;\n\n    await session.send(\"Runtime.enable\");\n    await session.send(\"DOM.enable\");\n\n    if (this.nthIndex >= 0) {\n      const resolved = await this.selectorResolver.resolveAtIndex(\n        this.selectorQuery,\n        this.nthIndex,\n      );\n      if (!resolved) {\n        throw new StagehandElementNotFoundError([this.selector]);\n      }\n      return [resolved];\n    }\n\n    const resolved = await this.selectorResolver.resolveAll(this.selectorQuery);\n    if (!resolved.length) {\n      throw new StagehandElementNotFoundError([this.selector]);\n    }\n    return resolved;\n  }\n\n  /** Compute a center point from a BoxModel content quad */\n  private centerFromBoxContent(content: number[]): { cx: number; cy: number } {\n    // content is [x1,y1, x2,y2, x3,y3, x4,y4]\n    if (!content || content.length < 8) {\n      throw new StagehandInvalidArgumentError(\"Invalid box model content quad\");\n    }\n    const xs = [content[0], content[2], content[4], content[6]];\n    const ys = [content[1], content[3], content[5], content[7]];\n    const cx = (xs[0] + xs[1] + xs[2] + xs[3]) / 4;\n    const cy = (ys[0] + ys[1] + ys[2] + ys[3]) / 4;\n    return { cx, cy };\n  }\n}\n"]}

package/dist/esm/lib/v3/understudy/page.d.ts

@@ -314,6 +314,21 @@ export declare class Page {
         clickCount?: number;
         returnXpath?: boolean;
     }): Promise<string>;
+    /**
+     * Tap at absolute page coordinates (CSS pixels) with a real (trusted) touch.
+     * Mirrors {@link click} but synthesizes touch input via `Input.dispatchTouchEvent`
+     * instead of mouse input, so mobile layouts that gate their handlers on
+     * touch/pointer events (`pointerType: "touch"`) — where a synthesized mouse click
+     * never registers — respond correctly. Coordinates are relative to the viewport
+     * origin (top-left). Does not scroll.
+     *
+     * Does not require touch emulation: CDP delivers a trusted touch sequence even on
+     * a session reporting `maxTouchPoints: 0`. Whether the agent *chooses* this over
+     * {@link click} is decided by `V3.usesTouch`.
+     */
+    tap(x: number, y: number, options?: {
+        returnXpath?: boolean;
+    }): Promise<string>;
     /**
      * Hover at absolute page coordinates (CSS pixels).
      * Dispatches mouseMoved via CDP Input domain on the top-level page target's
@@ -355,10 +370,14 @@ export declare class Page {
     }): Promise<void>;
     snapshot(options?: PageSnapshotOptions): Promise<SnapshotResult>;
     private _pressedModifiers;
-    /** Press a key down without releasing it */
-    private keyDown;
+    /**
+     * Press a key down without releasing it. Modifier keys stay held (and apply
+     * to later key events) until released with keyUp.
+     */
+    keyDown(key: string): Promise<void>;
     /** Release a pressed key */
-    private keyUp;
+    /** Release a key previously pressed with keyDown. */
+    keyUp(key: string): Promise<void>;
     /** Normalize key names to match CDP expectations */
     private normalizeModifierKey;
     /**