@browserbasehq/orca 3.1.0-patch.4 → 3.2.0-preview.1

package/dist/esm/lib/v3/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../lib/v3/api.ts"],"names":[],"mappings":"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","sourcesContent":["import makeFetchCookie from \"fetch-cookie\";\nimport { loadApiKeyFromEnv } from \"../utils.js\";\nimport { STAGEHAND_VERSION } from \"../version.js\";\nimport {\n  StagehandAPIError,\n  StagehandAPIUnauthorizedError,\n  StagehandHttpError,\n  StagehandResponseBodyError,\n  StagehandResponseParseError,\n  StagehandServerError,\n  ExperimentalNotConfiguredError,\n} from \"./types/public/index.js\";\nimport type {\n  ActResult,\n  AgentConfig,\n  AgentExecuteOptions,\n  AgentResult,\n  ExtractResult,\n  ObserveResult,\n  LogLine,\n  StagehandMetrics,\n  BrowserbaseRegion,\n  ActOptions,\n  ExtractOptions,\n  ObserveOptions,\n  Api,\n} from \"./types/public/index.js\";\nimport type {\n  SerializableResponse,\n  AgentCacheTransferPayload,\n} from \"./types/private/index.js\";\nimport type { ModelConfiguration } from \"./types/public/model.js\";\nimport { toJsonSchema } from \"./zodCompat.js\";\nimport type { StagehandZodSchema } from \"./zodCompat.js\";\n\n// =============================================================================\n// Multi-region API URL mapping\n// =============================================================================\n\n/**\n * Mapping of Browserbase regions to their corresponding Stagehand API base URLs.\n * Users should configure their client to hit the API endpoint that matches\n * the region where their browser session is running.\n */\nexport const REGION_API_URLS: Record<BrowserbaseRegion, string> = {\n  \"us-west-2\": \"https://api.stagehand.browserbase.com\",\n  \"us-east-1\": \"https://api.use1.stagehand.browserbase.com\",\n  \"eu-central-1\": \"https://api.euc1.stagehand.browserbase.com\",\n  \"ap-southeast-1\": \"https://api.apse1.stagehand.browserbase.com\",\n};\n\n/**\n * Returns the full API URL (with /v1 suffix) for a given Browserbase region.\n * If no region is specified or the region is unknown, defaults to us-west-2.\n *\n * @param region - The Browserbase region (e.g., \"us-west-2\", \"eu-central-1\")\n * @returns The full API URL including /v1 suffix\n */\nexport function getApiUrlForRegion(\n  region: BrowserbaseRegion | undefined,\n): string {\n  const baseUrl =\n    REGION_API_URLS[region as BrowserbaseRegion] ??\n    REGION_API_URLS[\"us-west-2\"];\n  return `${baseUrl}/v1`;\n}\n\n// =============================================================================\n// Client-specific types (can't be Zod schemas due to functions/Page objects)\n// =============================================================================\n//\n// These types mirror the Api.* schemas from types/public/api.ts but include\n// non-serializable SDK fields (like Page objects) that get stripped before\n// sending requests over the wire.\n//\n// Relationship to wire format:\n// - Client accepts: SDK types (ActOptions, ExtractOptions, etc.) with optional `page`\n// - Wire sends: Api.* types (page stripped, Zod schema converted to JSON schema)\n// - Client returns: SDK result types (ActResult, ExtractResult, etc.)\n// =============================================================================\n\n/**\n * Constructor parameters for StagehandAPIClient\n */\ninterface StagehandAPIConstructorParams {\n  apiKey: string;\n  projectId: string;\n  logger: (message: LogLine) => void;\n  /**\n   * When true, enables server-side caching by default for all 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\n/**\n * Parameters for starting a session via the API client.\n * Extends Api.SessionStartRequest with client-specific field (modelApiKey).\n *\n * Wire format: Api.SessionStartRequest (modelApiKey sent via header, not body)\n */\ninterface ClientSessionStartParams extends Api.SessionStartRequest {\n  /** Model API key - sent via x-model-api-key header, not in request body */\n  modelApiKey: string;\n}\n\n/**\n * Generic API response wrapper matching Api.*Response schemas\n */\ntype ApiResponse<T> =\n  | { success: true; data: T }\n  | { success: false; message: string };\n\n/**\n * Union of all API request body types for type-safe execute() calls\n */\ntype ApiRequestBody =\n  | Api.ActRequest\n  | Api.ExtractRequest\n  | Api.ObserveRequest\n  | Api.NavigateRequest\n  | Api.AgentExecuteRequest;\n\n/**\n * Parameters for executing an action via the streaming API\n */\ninterface ExecuteActionParams {\n  method: \"act\" | \"extract\" | \"observe\" | \"navigate\" | \"end\" | \"agentExecute\";\n  args?: ApiRequestBody;\n  params?: Record<string, string>;\n  /**\n   * Override the instance-level serverCache setting for this request.\n   * When true, enables server-side caching.\n   * When false, disables server-side caching.\n   */\n  serverCache?: boolean;\n}\n\n/**\n * Client parameters for act() method.\n * Derives structure from Api.ActRequest but uses SDK's ActOptions (which includes `page`).\n * Before serialization, `page` is stripped to produce Api.ActRequest wire format.\n */\ninterface ClientActParameters {\n  input: Api.ActRequest[\"input\"];\n  options?: ActOptions;\n  frameId?: Api.ActRequest[\"frameId\"];\n}\n\n/**\n * Client parameters for extract() method.\n * Derives structure from Api.ExtractRequest but uses SDK's ExtractOptions (which includes `page`)\n * and accepts Zod schema (converted to JSON schema for wire format).\n */\ninterface ClientExtractParameters {\n  instruction?: Api.ExtractRequest[\"instruction\"];\n  schema?: StagehandZodSchema;\n  options?: ExtractOptions;\n  frameId?: Api.ExtractRequest[\"frameId\"];\n}\n\n/**\n * Client parameters for observe() method.\n * Derives structure from Api.ObserveRequest but uses SDK's ObserveOptions (which includes `page`).\n * Before serialization, `page` is stripped to produce Api.ObserveRequest wire format.\n */\ninterface ClientObserveParameters {\n  instruction?: Api.ObserveRequest[\"instruction\"];\n  options?: ObserveOptions;\n  frameId?: Api.ObserveRequest[\"frameId\"];\n}\n\nexport class StagehandAPIClient {\n  private apiKey: string;\n  private projectId: string;\n  private sessionId?: string;\n  private modelApiKey: string;\n  private modelProvider?: string;\n  private region?: BrowserbaseRegion;\n  private logger: (message: LogLine) => void;\n  private fetchWithCookies;\n  private serverCache: boolean;\n  private lastFinishedEventData: Record<string, unknown> | null = null;\n  private latestAgentCacheEntry: AgentCacheTransferPayload | null = null;\n\n  constructor({\n    apiKey,\n    projectId,\n    logger,\n    serverCache,\n  }: StagehandAPIConstructorParams) {\n    this.apiKey = apiKey;\n    this.projectId = projectId;\n    this.logger = logger;\n    this.serverCache = serverCache ?? true;\n    // Create a single cookie jar instance that will persist across all requests\n    this.fetchWithCookies = makeFetchCookie(fetch);\n  }\n\n  async init({\n    modelName,\n    modelApiKey,\n    domSettleTimeoutMs,\n    verbose,\n    systemPrompt,\n    selfHeal,\n    browserbaseSessionCreateParams,\n    browserbaseSessionID,\n    // browser,  TODO for local browsers\n  }: ClientSessionStartParams): Promise<Api.SessionStartResult> {\n    if (!modelApiKey) {\n      throw new StagehandAPIError(\"modelApiKey is required\");\n    }\n    this.modelApiKey = modelApiKey;\n    // Extract provider from modelName (e.g., \"openai/gpt-5-nano\" -> \"openai\")\n    this.modelProvider = modelName?.includes(\"/\")\n      ? modelName.split(\"/\")[0]\n      : undefined;\n\n    // Store the region for multi-region API URL resolution\n    this.region = browserbaseSessionCreateParams?.region;\n\n    this.logger({\n      category: \"init\",\n      message: \"Creating new browserbase session...\",\n      level: 1,\n    });\n\n    // Build wire-format request body (Api.SessionStartRequest shape)\n    const requestBody: Api.SessionStartRequest = {\n      modelName,\n      domSettleTimeoutMs,\n      verbose,\n      systemPrompt,\n      selfHeal,\n      browserbaseSessionCreateParams,\n      browserbaseSessionID,\n      // browser, TODO: only send when connected to local fastify\n    };\n\n    const sessionResponse = await this.request(\"/sessions/start\", {\n      method: \"POST\",\n      body: JSON.stringify(requestBody),\n    });\n\n    if (sessionResponse.status === 401) {\n      throw new StagehandAPIUnauthorizedError(\n        \"Unauthorized. Ensure you provided a valid API key.\",\n      );\n    } else if (sessionResponse.status !== 200) {\n      const errorText = await sessionResponse.text();\n      this.logger({\n        category: \"api\",\n        message: `API error (${sessionResponse.status}): ${errorText}`,\n        level: 0,\n      });\n      throw new StagehandHttpError(`Unknown error: ${sessionResponse.status}`);\n    }\n\n    const sessionResponseBody =\n      (await sessionResponse.json()) as ApiResponse<Api.SessionStartResult>;\n\n    if (sessionResponseBody.success === false) {\n      throw new StagehandAPIError(sessionResponseBody.message);\n    }\n\n    // Temporary reroute for rollout\n    if (!sessionResponseBody.data?.available && browserbaseSessionID) {\n      sessionResponseBody.data.sessionId = browserbaseSessionID;\n    }\n\n    this.sessionId = sessionResponseBody.data.sessionId;\n\n    return sessionResponseBody.data;\n  }\n\n  async act({\n    input,\n    options,\n    frameId,\n  }: ClientActParameters): Promise<ActResult> {\n    // Strip non-serializable `page` and SDK-only fields from options before wire serialization\n    let wireOptions: Api.ActRequest[\"options\"];\n    let serverCache: boolean | undefined;\n    if (options) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { page: _, serverCache: enableCache, ...restOptions } = options;\n      serverCache = enableCache;\n      if (Object.keys(restOptions).length > 0) {\n        if (restOptions.model) {\n          restOptions.model = this.prepareModelConfig(restOptions.model);\n        }\n        wireOptions = restOptions as unknown as Api.ActRequest[\"options\"];\n      }\n    }\n\n    // Build wire-format request body\n    const requestBody: Api.ActRequest = {\n      input,\n      options: wireOptions,\n      frameId,\n    };\n\n    return this.execute<ActResult>({\n      method: \"act\",\n      args: requestBody,\n      serverCache,\n    });\n  }\n\n  async extract<T extends StagehandZodSchema>({\n    instruction,\n    schema: zodSchema,\n    options,\n    frameId,\n  }: ClientExtractParameters): Promise<ExtractResult<T>> {\n    // Convert Zod schema to JSON schema for wire format\n    const jsonSchema = zodSchema ? toJsonSchema(zodSchema) : undefined;\n\n    // Strip non-serializable `page` and SDK-only fields from options before wire serialization\n    let wireOptions: Api.ExtractRequest[\"options\"];\n    let serverCache: boolean | undefined;\n    if (options) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { page: _, serverCache: enableCache, ...restOptions } = options;\n      serverCache = enableCache;\n      if (Object.keys(restOptions).length > 0) {\n        if (restOptions.model) {\n          restOptions.model = this.prepareModelConfig(restOptions.model);\n        }\n        wireOptions = restOptions as unknown as Api.ExtractRequest[\"options\"];\n      }\n    }\n\n    // Build wire-format request body\n    const requestBody: Api.ExtractRequest = {\n      instruction,\n      schema: jsonSchema,\n      options: wireOptions,\n      frameId,\n    };\n\n    return this.execute<ExtractResult<T>>({\n      method: \"extract\",\n      args: requestBody,\n      serverCache,\n    });\n  }\n\n  async observe({\n    instruction,\n    options,\n    frameId,\n  }: ClientObserveParameters): Promise<ObserveResult> {\n    // Strip non-serializable `page` and SDK-only fields from options before wire serialization\n    let wireOptions: Api.ObserveRequest[\"options\"];\n    let serverCache: boolean | undefined;\n    if (options) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { page: _, serverCache: enableCache, ...restOptions } = options;\n      serverCache = enableCache;\n      if (Object.keys(restOptions).length > 0) {\n        if (restOptions.model) {\n          restOptions.model = this.prepareModelConfig(restOptions.model);\n        }\n        wireOptions = restOptions as unknown as Api.ObserveRequest[\"options\"];\n      }\n    }\n\n    // Build wire-format request body\n    const requestBody: Api.ObserveRequest = {\n      instruction,\n      options: wireOptions,\n      frameId,\n    };\n\n    return this.execute<ObserveResult>({\n      method: \"observe\",\n      args: requestBody,\n      serverCache,\n    });\n  }\n\n  async goto(\n    url: string,\n    options?: Api.NavigateRequest[\"options\"],\n    frameId?: string,\n  ): Promise<SerializableResponse | null> {\n    const requestBody: Api.NavigateRequest = { url, options, frameId };\n\n    return this.execute<SerializableResponse | null>({\n      method: \"navigate\",\n      args: requestBody,\n    });\n  }\n\n  async agentExecute(\n    agentConfig: AgentConfig,\n    executeOptions: AgentExecuteOptions | string,\n    frameId?: string,\n    shouldCache?: boolean,\n  ): Promise<AgentResult> {\n    // Check if integrations are being used in API mode (not supported)\n    if (agentConfig.integrations && agentConfig.integrations.length > 0) {\n      throw new ExperimentalNotConfiguredError(\"MCP integrations\");\n    }\n\n    // Strip non-serializable `page` from executeOptions before wire serialization\n    let wireExecuteOptions: Api.AgentExecuteRequest[\"executeOptions\"];\n    if (typeof executeOptions === \"string\") {\n      wireExecuteOptions = { instruction: executeOptions };\n    } else if (executeOptions.page) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { page: _, ...rest } = executeOptions;\n      wireExecuteOptions = rest;\n    } else {\n      wireExecuteOptions = executeOptions;\n    }\n\n    const wireAgentConfig: Api.AgentExecuteRequest[\"agentConfig\"] = {\n      systemPrompt: agentConfig.systemPrompt,\n      mode: agentConfig.mode ?? (agentConfig.cua === true ? \"cua\" : undefined),\n      cua: agentConfig.mode === undefined ? agentConfig.cua : undefined,\n      model: agentConfig.model\n        ? this.prepareModelConfig(agentConfig.model)\n        : undefined,\n      executionModel: agentConfig.executionModel\n        ? this.prepareModelConfig(agentConfig.executionModel)\n        : undefined,\n    };\n\n    // Build wire-format request body\n    const requestBody: Api.AgentExecuteRequest = {\n      agentConfig: wireAgentConfig,\n      executeOptions: wireExecuteOptions,\n      frameId,\n      shouldCache,\n    };\n\n    const result = await this.execute<AgentResult>({\n      method: \"agentExecute\",\n      args: requestBody,\n    });\n\n    const finishedData =\n      this.consumeFinishedEventData<Api.AgentExecuteResult>() ?? null;\n    this.latestAgentCacheEntry =\n      finishedData?.cacheEntry !== undefined\n        ? (finishedData.cacheEntry as AgentCacheTransferPayload)\n        : null;\n    return result;\n  }\n\n  consumeLatestAgentCacheEntry(): AgentCacheTransferPayload | null {\n    const entry = this.latestAgentCacheEntry;\n    this.latestAgentCacheEntry = null;\n    return entry;\n  }\n\n  async end(): Promise<Response> {\n    const url = `/sessions/${this.sessionId}/end`;\n    const response = await this.request(url, {\n      method: \"POST\",\n    });\n    return response;\n  }\n\n  async getReplayMetrics(): Promise<StagehandMetrics> {\n    if (!this.sessionId) {\n      throw new StagehandAPIError(\"sessionId is required to fetch metrics.\");\n    }\n\n    const response = await this.request(`/sessions/${this.sessionId}/replay`, {\n      method: \"GET\",\n    });\n\n    if (response.status !== 200) {\n      const errorText = await response.text();\n      this.logger({\n        category: \"api\",\n        message: `Failed to fetch metrics. Status ${response.status}: ${errorText}`,\n        level: 0,\n      });\n      throw new StagehandHttpError(\n        `Failed to fetch metrics with status ${response.status}: ${errorText}`,\n      );\n    }\n\n    const data = (await response.json()) as\n      | Api.ReplayResponse\n      | { success: false; error?: string };\n\n    if (!data.success) {\n      const errorData = data as { success: false; error?: string };\n      throw new StagehandAPIError(\n        `Failed to fetch metrics: ${errorData.error || \"Unknown error\"}`,\n      );\n    }\n\n    // Parse the API data into StagehandMetrics format\n    const apiData = (data as Api.ReplayResponse).data;\n    const metrics: StagehandMetrics = {\n      actPromptTokens: 0,\n      actCompletionTokens: 0,\n      actReasoningTokens: 0,\n      actCachedInputTokens: 0,\n      actInferenceTimeMs: 0,\n      extractPromptTokens: 0,\n      extractCompletionTokens: 0,\n      extractReasoningTokens: 0,\n      extractCachedInputTokens: 0,\n      extractInferenceTimeMs: 0,\n      observePromptTokens: 0,\n      observeCompletionTokens: 0,\n      observeReasoningTokens: 0,\n      observeCachedInputTokens: 0,\n      observeInferenceTimeMs: 0,\n      agentPromptTokens: 0,\n      agentCompletionTokens: 0,\n      agentReasoningTokens: 0,\n      agentCachedInputTokens: 0,\n      agentInferenceTimeMs: 0,\n      totalPromptTokens: 0,\n      totalCompletionTokens: 0,\n      totalReasoningTokens: 0,\n      totalCachedInputTokens: 0,\n      totalInferenceTimeMs: 0,\n    };\n\n    // Parse pages and their actions\n    const pages = apiData?.pages || [];\n    for (const page of pages) {\n      const actions = page.actions || [];\n      for (const action of actions) {\n        // Get method name and token usage\n        const method = (action.method || \"\").toLowerCase();\n        const tokenUsage = action.tokenUsage;\n\n        if (tokenUsage) {\n          const inputTokens = tokenUsage.inputTokens || 0;\n          const outputTokens = tokenUsage.outputTokens || 0;\n          const reasoningTokens =\n            \"reasoningTokens\" in tokenUsage\n              ? Number(\n                  (tokenUsage as { reasoningTokens?: number })\n                    .reasoningTokens ?? 0,\n                )\n              : 0;\n          const cachedInputTokens =\n            \"cachedInputTokens\" in tokenUsage\n              ? Number(\n                  (tokenUsage as { cachedInputTokens?: number })\n                    .cachedInputTokens ?? 0,\n                )\n              : 0;\n          const timeMs = tokenUsage.timeMs || 0;\n\n          // Map method to metrics fields\n          if (method === \"act\") {\n            metrics.actPromptTokens += inputTokens;\n            metrics.actCompletionTokens += outputTokens;\n            metrics.actReasoningTokens += reasoningTokens;\n            metrics.actCachedInputTokens += cachedInputTokens;\n            metrics.actInferenceTimeMs += timeMs;\n          } else if (method === \"extract\") {\n            metrics.extractPromptTokens += inputTokens;\n            metrics.extractCompletionTokens += outputTokens;\n            metrics.extractReasoningTokens += reasoningTokens;\n            metrics.extractCachedInputTokens += cachedInputTokens;\n            metrics.extractInferenceTimeMs += timeMs;\n          } else if (method === \"observe\") {\n            metrics.observePromptTokens += inputTokens;\n            metrics.observeCompletionTokens += outputTokens;\n            metrics.observeReasoningTokens += reasoningTokens;\n            metrics.observeCachedInputTokens += cachedInputTokens;\n            metrics.observeInferenceTimeMs += timeMs;\n          } else if (method === \"agent\") {\n            metrics.agentPromptTokens += inputTokens;\n            metrics.agentCompletionTokens += outputTokens;\n            metrics.agentReasoningTokens += reasoningTokens;\n            metrics.agentCachedInputTokens += cachedInputTokens;\n            metrics.agentInferenceTimeMs += timeMs;\n          }\n\n          // Always update totals for any method with token usage\n          metrics.totalPromptTokens += inputTokens;\n          metrics.totalCompletionTokens += outputTokens;\n          metrics.totalReasoningTokens += reasoningTokens;\n          metrics.totalCachedInputTokens += cachedInputTokens;\n          metrics.totalInferenceTimeMs += timeMs;\n        }\n      }\n    }\n\n    return metrics;\n  }\n\n  /**\n   * Prepares a model configuration for the API payload by ensuring the `apiKey`\n   * is included. If the model is passed as a string, converts it to an object\n   * with `modelName` and `apiKey`.\n   *\n   * In API mode, we only attempt to load an API key from env vars when the\n   * model provider differs from the one used to init the session.\n   */\n  private prepareModelConfig(\n    model: ModelConfiguration,\n  ): { modelName: string; apiKey: string } & Record<string, unknown> {\n    if (typeof model === \"string\") {\n      // Extract provider from model string (e.g., \"openai/gpt-5-nano\" -> \"openai\")\n      const provider = model.includes(\"/\") ? model.split(\"/\")[0] : undefined;\n      const apiKey =\n        provider && provider !== this.modelProvider\n          ? (loadApiKeyFromEnv(provider, this.logger) ?? this.modelApiKey)\n          : this.modelApiKey;\n      return {\n        modelName: model,\n        apiKey,\n      };\n    }\n\n    if (!model.apiKey) {\n      const provider = model.modelName?.includes(\"/\")\n        ? model.modelName.split(\"/\")[0]\n        : undefined;\n      const apiKey =\n        provider && provider !== this.modelProvider\n          ? (loadApiKeyFromEnv(provider, this.logger) ?? this.modelApiKey)\n          : this.modelApiKey;\n      return {\n        ...model,\n        apiKey,\n      };\n    }\n\n    return model as { modelName: string; apiKey: string } & Record<\n      string,\n      unknown\n    >;\n  }\n\n  private consumeFinishedEventData<T>(): T | null {\n    const data = this.lastFinishedEventData as T | null;\n    this.lastFinishedEventData = null;\n    return data;\n  }\n\n  private async execute<T>({\n    method,\n    args,\n    params,\n    serverCache,\n  }: ExecuteActionParams): Promise<T> {\n    this.lastFinishedEventData = null;\n    const urlParams = new URLSearchParams(params as Record<string, string>);\n    const queryString = urlParams.toString();\n    const url = `/sessions/${this.sessionId}/${method}${queryString ? `?${queryString}` : \"\"}`;\n\n    const response = await this.request(\n      url,\n      {\n        method: \"POST\",\n        body: JSON.stringify(args),\n      },\n      serverCache,\n    );\n\n    // Capture cache status from response header\n    const cacheStatus = response.headers.get(\"browserbase-cache-status\") as\n      | \"HIT\"\n      | \"MISS\"\n      | null;\n\n    if (!response.ok) {\n      const errorBody = await response.text();\n      throw new StagehandHttpError(\n        `HTTP error! status: ${response.status}, body: ${errorBody}`,\n      );\n    }\n\n    if (!response.body) {\n      throw new StagehandResponseBodyError();\n    }\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n\n    while (true) {\n      const { value, done } = await reader.read();\n\n      if (done && !buffer) {\n        throw new StagehandServerError(\n          \"Stream ended without completion signal\",\n        );\n      }\n\n      buffer += decoder.decode(value, { stream: true });\n      const lines = buffer.split(\"\\n\\n\");\n      buffer = lines.pop() || \"\";\n\n      for (const line of lines) {\n        if (!line.startsWith(\"data: \")) continue;\n\n        try {\n          const eventData = JSON.parse(line.slice(6));\n\n          if (eventData.type === \"system\") {\n            if (eventData.data.status === \"error\") {\n              const { error: errorMsg } = eventData.data;\n              // Throw plain Error to match local SDK behavior (useApi: false)\n              throw new Error(errorMsg);\n            }\n            if (eventData.data.status === \"finished\") {\n              this.lastFinishedEventData = eventData.data;\n\n              // If caching was bypassed for this request, suppress cache status\n              // so we don't log or surface a MISS that the server emits anyway.\n              const cacheEnabled = this.shouldUseCache(serverCache);\n              return this.attachCacheStatus(\n                eventData.data.result as T,\n                method,\n                cacheEnabled ? cacheStatus : null,\n                cacheEnabled ? eventData : { data: {} },\n              );\n            }\n          } else if (eventData.type === \"log\") {\n            const msg = eventData.data.message;\n            // Skip server-side internal logs that don't apply to API mode\n            if (msg?.message === \"Connecting to local browser\") {\n              continue;\n            }\n            this.logger(eventData.data.message);\n          }\n        } catch (e) {\n          // Let Error instances pass through (server errors thrown above)\n          // Only wrap SyntaxError from JSON.parse as parse errors\n          if (e instanceof Error && !(e instanceof SyntaxError)) {\n            throw e;\n          }\n\n          const errorMessage = e instanceof Error ? e.message : String(e);\n          this.logger({\n            category: \"api\",\n            message: `Failed to parse SSE event: ${errorMessage}`,\n            level: 0,\n          });\n          throw new StagehandResponseParseError(\n            `Failed to parse server response: ${errorMessage}`,\n          );\n        }\n      }\n\n      if (done) {\n        // Process any remaining data in buffer before exiting\n        if (buffer.trim() && buffer.startsWith(\"data: \")) {\n          try {\n            const eventData = JSON.parse(buffer.slice(6));\n            if (\n              eventData.type === \"system\" &&\n              eventData.data.status === \"finished\"\n            ) {\n              return this.attachCacheStatus(\n                eventData.data.result as T,\n                method,\n                cacheStatus,\n                eventData,\n              );\n            }\n          } catch {\n            this.logger({\n              category: \"api\",\n              message: `Incomplete data in final buffer: ${buffer.substring(0, 100)}`,\n              level: 0,\n            });\n          }\n        }\n        throw new StagehandServerError(\n          \"Stream ended without completion signal\",\n        );\n      }\n    }\n  }\n\n  /**\n   * Resolves the final cache status from the response header or SSE event data,\n   * logs it, and attaches it to act/extract results before returning.\n   */\n  private attachCacheStatus<T>(\n    result: T,\n    method: string,\n    cacheStatus: \"HIT\" | \"MISS\" | null,\n    eventData: { data: { cacheHit?: boolean } },\n  ): T {\n    const finalCacheStatus =\n      cacheStatus ||\n      (typeof eventData.data.cacheHit === \"boolean\"\n        ? eventData.data.cacheHit\n          ? \"HIT\"\n          : \"MISS\"\n        : undefined);\n    if (\n      finalCacheStatus &&\n      (method === \"act\" || method === \"extract\" || method === \"observe\")\n    ) {\n      this.logger({\n        category: \"cache\",\n        message: `${method} server cache ${finalCacheStatus.toLowerCase()}`,\n        level: 1,\n      });\n    }\n    if (\n      finalCacheStatus &&\n      result &&\n      typeof result === \"object\" &&\n      (method === \"act\" || method === \"extract\" || method === \"observe\")\n    ) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (result as ActResult | ExtractResult<any> | ObserveResult).cacheStatus =\n        finalCacheStatus;\n    }\n    return result;\n  }\n\n  /**\n   * Determine if caching should be enabled for a request.\n   * Method-level setting takes precedence over instance-level setting.\n   */\n  private shouldUseCache(methodServerCache?: boolean): boolean {\n    // If method-level setting is explicitly provided, use it\n    if (methodServerCache !== undefined) {\n      return methodServerCache;\n    }\n    // Otherwise, use instance-level setting\n    return this.serverCache;\n  }\n\n  private async request(\n    path: string,\n    options: RequestInit,\n    serverCache?: boolean,\n  ): Promise<Response> {\n    const defaultHeaders: Record<string, string> = {\n      \"x-bb-api-key\": this.apiKey,\n      \"x-bb-project-id\": this.projectId,\n      \"x-bb-session-id\": this.sessionId,\n      // we want real-time logs, so we stream the response\n      \"x-stream-response\": \"true\",\n      \"x-model-api-key\": this.modelApiKey,\n      \"x-language\": \"typescript\",\n      \"x-sdk-version\": STAGEHAND_VERSION,\n    };\n\n    // Add cache bypass header if caching is disabled\n    if (!this.shouldUseCache(serverCache)) {\n      defaultHeaders[\"browserbase-cache-bypass\"] = \"true\";\n    }\n\n    if (options.method === \"POST\" && options.body) {\n      defaultHeaders[\"Content-Type\"] = \"application/json\";\n    }\n\n    // Use STAGEHAND_API_URL env var if set, otherwise use region-based URL\n    // Ensure /v1 suffix is present for consistency\n    let baseUrl: string;\n    if (process.env.STAGEHAND_API_URL) {\n      const envUrl = process.env.STAGEHAND_API_URL.replace(/\\/+$/, \"\");\n      // Append /v1 if not already present\n      baseUrl = envUrl.endsWith(\"/v1\") ? envUrl : `${envUrl}/v1`;\n    } else {\n      baseUrl = getApiUrlForRegion(this.region);\n    }\n\n    const response = await this.fetchWithCookies(`${baseUrl}${path}`, {\n      ...options,\n      headers: {\n        ...defaultHeaders,\n        ...options.headers,\n      },\n    });\n\n    return response;\n  }\n}\n"]}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../lib/v3/api.ts"],"names":[],"mappings":"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","sourcesContent":["import makeFetchCookie from \"fetch-cookie\";\nimport { loadApiKeyFromEnv } from \"../utils.js\";\nimport { STAGEHAND_VERSION } from \"../version.js\";\nimport {\n  StagehandAPIError,\n  StagehandAPIUnauthorizedError,\n  StagehandHttpError,\n  StagehandResponseBodyError,\n  StagehandResponseParseError,\n  StagehandServerError,\n  ExperimentalNotConfiguredError,\n} from \"./types/public/index.js\";\nimport type {\n  ActResult,\n  AgentConfig,\n  AgentExecuteOptions,\n  AgentResult,\n  ExtractResult,\n  ObserveResult,\n  LogLine,\n  StagehandMetrics,\n  BrowserbaseRegion,\n  ActOptions,\n  ExtractOptions,\n  ObserveOptions,\n  Api,\n} from \"./types/public/index.js\";\nimport type {\n  SerializableResponse,\n  AgentCacheTransferPayload,\n} from \"./types/private/index.js\";\nimport type { ModelConfiguration } from \"./types/public/model.js\";\nimport { toJsonSchema } from \"./zodCompat.js\";\nimport type { StagehandZodSchema } from \"./zodCompat.js\";\n\n// =============================================================================\n// Multi-region API URL mapping\n// =============================================================================\n\n/**\n * Mapping of Browserbase regions to their corresponding Stagehand API base URLs.\n * Users should configure their client to hit the API endpoint that matches\n * the region where their browser session is running.\n */\nexport const REGION_API_URLS: Record<BrowserbaseRegion, string> = {\n  \"us-west-2\": \"https://api.stagehand.browserbase.com\",\n  \"us-east-1\": \"https://api.use1.stagehand.browserbase.com\",\n  \"eu-central-1\": \"https://api.euc1.stagehand.browserbase.com\",\n  \"ap-southeast-1\": \"https://api.apse1.stagehand.browserbase.com\",\n};\n\n/**\n * Returns the full API URL (with /v1 suffix) for a given Browserbase region.\n * If no region is specified or the region is unknown, defaults to us-west-2.\n *\n * @param region - The Browserbase region (e.g., \"us-west-2\", \"eu-central-1\")\n * @returns The full API URL including /v1 suffix\n */\nexport function getApiUrlForRegion(\n  region: BrowserbaseRegion | undefined,\n): string {\n  const baseUrl =\n    REGION_API_URLS[region as BrowserbaseRegion] ??\n    REGION_API_URLS[\"us-west-2\"];\n  return `${baseUrl}/v1`;\n}\n\n// =============================================================================\n// Client-specific types (can't be Zod schemas due to functions/Page objects)\n// =============================================================================\n//\n// These types mirror the Api.* schemas from types/public/api.ts but include\n// non-serializable SDK fields (like Page objects) that get stripped before\n// sending requests over the wire.\n//\n// Relationship to wire format:\n// - Client accepts: SDK types (ActOptions, ExtractOptions, etc.) with optional `page`\n// - Wire sends: Api.* types (page stripped, Zod schema converted to JSON schema)\n// - Client returns: SDK result types (ActResult, ExtractResult, etc.)\n// =============================================================================\n\n/**\n * Constructor parameters for StagehandAPIClient\n */\ninterface StagehandAPIConstructorParams {\n  apiKey: string;\n  projectId?: string;\n  logger: (message: LogLine) => void;\n  /**\n   * When true, enables server-side caching by default for all 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\n/**\n * Parameters for starting a session via the API client.\n * Extends Api.SessionStartRequest with client-specific field (modelApiKey).\n *\n * Wire format: Api.SessionStartRequest (modelApiKey sent via header, not body)\n */\ninterface ClientSessionStartParams extends Api.SessionStartRequest {\n  /** Model API key - sent via x-model-api-key header, not in request body */\n  modelApiKey: string;\n}\n\n/**\n * Generic API response wrapper matching Api.*Response schemas\n */\ntype ApiResponse<T> =\n  | { success: true; data: T }\n  | { success: false; message: string };\n\n/**\n * Union of all API request body types for type-safe execute() calls\n */\ntype ApiRequestBody =\n  | Api.ActRequest\n  | Api.ExtractRequest\n  | Api.ObserveRequest\n  | Api.NavigateRequest\n  | Api.AgentExecuteRequest;\n\n/**\n * Parameters for executing an action via the streaming API\n */\ninterface ExecuteActionParams {\n  method: \"act\" | \"extract\" | \"observe\" | \"navigate\" | \"end\" | \"agentExecute\";\n  args?: ApiRequestBody;\n  params?: Record<string, string>;\n  /**\n   * Override the instance-level serverCache setting for this request.\n   * When true, enables server-side caching.\n   * When false, disables server-side caching.\n   */\n  serverCache?: boolean;\n}\n\n/**\n * Client parameters for act() method.\n * Derives structure from Api.ActRequest but uses SDK's ActOptions (which includes `page`).\n * Before serialization, `page` is stripped to produce Api.ActRequest wire format.\n */\ninterface ClientActParameters {\n  input: Api.ActRequest[\"input\"];\n  options?: ActOptions;\n  frameId?: Api.ActRequest[\"frameId\"];\n}\n\n/**\n * Client parameters for extract() method.\n * Derives structure from Api.ExtractRequest but uses SDK's ExtractOptions (which includes `page`)\n * and accepts Zod schema (converted to JSON schema for wire format).\n */\ninterface ClientExtractParameters {\n  instruction?: Api.ExtractRequest[\"instruction\"];\n  schema?: StagehandZodSchema;\n  options?: ExtractOptions;\n  frameId?: Api.ExtractRequest[\"frameId\"];\n}\n\n/**\n * Client parameters for observe() method.\n * Derives structure from Api.ObserveRequest but uses SDK's ObserveOptions (which includes `page`).\n * Before serialization, `page` is stripped to produce Api.ObserveRequest wire format.\n */\ninterface ClientObserveParameters {\n  instruction?: Api.ObserveRequest[\"instruction\"];\n  options?: ObserveOptions;\n  frameId?: Api.ObserveRequest[\"frameId\"];\n}\n\nexport class StagehandAPIClient {\n  private apiKey: string;\n  private projectId?: string;\n  private sessionId?: string;\n  private modelApiKey: string;\n  private modelProvider?: string;\n  private region?: BrowserbaseRegion;\n  private logger: (message: LogLine) => void;\n  private fetchWithCookies;\n  private serverCache: boolean;\n  private lastFinishedEventData: Record<string, unknown> | null = null;\n  private latestAgentCacheEntry: AgentCacheTransferPayload | null = null;\n\n  constructor({\n    apiKey,\n    projectId,\n    logger,\n    serverCache,\n  }: StagehandAPIConstructorParams) {\n    this.apiKey = apiKey;\n    this.projectId = projectId;\n    this.logger = logger;\n    this.serverCache = serverCache ?? true;\n    // Create a single cookie jar instance that will persist across all requests\n    this.fetchWithCookies = makeFetchCookie(fetch);\n  }\n\n  async init({\n    modelName,\n    modelApiKey,\n    domSettleTimeoutMs,\n    verbose,\n    systemPrompt,\n    selfHeal,\n    browserbaseSessionCreateParams,\n    browserbaseSessionID,\n    // browser,  TODO for local browsers\n  }: ClientSessionStartParams): Promise<Api.SessionStartResult> {\n    if (!modelApiKey) {\n      throw new StagehandAPIError(\"modelApiKey is required\");\n    }\n    this.modelApiKey = modelApiKey;\n    // Extract provider from modelName (e.g., \"openai/gpt-5-nano\" -> \"openai\")\n    this.modelProvider = modelName?.includes(\"/\")\n      ? modelName.split(\"/\")[0]\n      : undefined;\n\n    // Store the region for multi-region API URL resolution\n    this.region = browserbaseSessionCreateParams?.region;\n\n    this.logger({\n      category: \"init\",\n      message: \"Creating new browserbase session...\",\n      level: 1,\n    });\n\n    // Build wire-format request body (Api.SessionStartRequest shape)\n    const requestBody: Api.SessionStartRequest = {\n      modelName,\n      domSettleTimeoutMs,\n      verbose,\n      systemPrompt,\n      selfHeal,\n      browserbaseSessionCreateParams,\n      browserbaseSessionID,\n      // browser, TODO: only send when connected to local fastify\n    };\n\n    const sessionResponse = await this.request(\"/sessions/start\", {\n      method: \"POST\",\n      body: JSON.stringify(requestBody),\n    });\n\n    if (sessionResponse.status === 401) {\n      throw new StagehandAPIUnauthorizedError(\n        \"Unauthorized. Ensure you provided a valid API key.\",\n      );\n    } else if (sessionResponse.status !== 200) {\n      const errorText = await sessionResponse.text();\n      this.logger({\n        category: \"api\",\n        message: `API error (${sessionResponse.status}): ${errorText}`,\n        level: 0,\n      });\n      throw new StagehandHttpError(`Unknown error: ${sessionResponse.status}`);\n    }\n\n    const sessionResponseBody =\n      (await sessionResponse.json()) as ApiResponse<Api.SessionStartResult>;\n\n    if (sessionResponseBody.success === false) {\n      throw new StagehandAPIError(sessionResponseBody.message);\n    }\n\n    // Temporary reroute for rollout\n    if (!sessionResponseBody.data?.available && browserbaseSessionID) {\n      sessionResponseBody.data.sessionId = browserbaseSessionID;\n    }\n\n    this.sessionId = sessionResponseBody.data.sessionId;\n\n    return sessionResponseBody.data;\n  }\n\n  async act({\n    input,\n    options,\n    frameId,\n  }: ClientActParameters): Promise<ActResult> {\n    // Strip non-serializable `page` and SDK-only fields from options before wire serialization\n    let wireOptions: Api.ActRequest[\"options\"];\n    let serverCache: boolean | undefined;\n    if (options) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { page: _, serverCache: enableCache, ...restOptions } = options;\n      serverCache = enableCache;\n      if (Object.keys(restOptions).length > 0) {\n        if (restOptions.model) {\n          restOptions.model = this.prepareModelConfig(restOptions.model);\n        }\n        wireOptions = restOptions as unknown as Api.ActRequest[\"options\"];\n      }\n    }\n\n    // Build wire-format request body\n    const requestBody: Api.ActRequest = {\n      input,\n      options: wireOptions,\n      frameId,\n    };\n\n    return this.execute<ActResult>({\n      method: \"act\",\n      args: requestBody,\n      serverCache,\n    });\n  }\n\n  async extract<T extends StagehandZodSchema>({\n    instruction,\n    schema: zodSchema,\n    options,\n    frameId,\n  }: ClientExtractParameters): Promise<ExtractResult<T>> {\n    // Convert Zod schema to JSON schema for wire format\n    const jsonSchema = zodSchema ? toJsonSchema(zodSchema) : undefined;\n\n    // Strip non-serializable `page` and SDK-only fields from options before wire serialization\n    let wireOptions: Api.ExtractRequest[\"options\"];\n    let serverCache: boolean | undefined;\n    if (options) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { page: _, serverCache: enableCache, ...restOptions } = options;\n      serverCache = enableCache;\n      if (Object.keys(restOptions).length > 0) {\n        if (restOptions.model) {\n          restOptions.model = this.prepareModelConfig(restOptions.model);\n        }\n        wireOptions = restOptions as unknown as Api.ExtractRequest[\"options\"];\n      }\n    }\n\n    // Build wire-format request body\n    const requestBody: Api.ExtractRequest = {\n      instruction,\n      schema: jsonSchema,\n      options: wireOptions,\n      frameId,\n    };\n\n    return this.execute<ExtractResult<T>>({\n      method: \"extract\",\n      args: requestBody,\n      serverCache,\n    });\n  }\n\n  async observe({\n    instruction,\n    options,\n    frameId,\n  }: ClientObserveParameters): Promise<ObserveResult> {\n    // Strip non-serializable `page` and SDK-only fields from options before wire serialization\n    let wireOptions: Api.ObserveRequest[\"options\"];\n    let serverCache: boolean | undefined;\n    if (options) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { page: _, serverCache: enableCache, ...restOptions } = options;\n      serverCache = enableCache;\n      if (Object.keys(restOptions).length > 0) {\n        if (restOptions.model) {\n          restOptions.model = this.prepareModelConfig(restOptions.model);\n        }\n        wireOptions = restOptions as unknown as Api.ObserveRequest[\"options\"];\n      }\n    }\n\n    // Build wire-format request body\n    const requestBody: Api.ObserveRequest = {\n      instruction,\n      options: wireOptions,\n      frameId,\n    };\n\n    return this.execute<ObserveResult>({\n      method: \"observe\",\n      args: requestBody,\n      serverCache,\n    });\n  }\n\n  async goto(\n    url: string,\n    options?: Api.NavigateRequest[\"options\"],\n    frameId?: string,\n  ): Promise<SerializableResponse | null> {\n    const requestBody: Api.NavigateRequest = { url, options, frameId };\n\n    return this.execute<SerializableResponse | null>({\n      method: \"navigate\",\n      args: requestBody,\n    });\n  }\n\n  async agentExecute(\n    agentConfig: AgentConfig,\n    executeOptions: AgentExecuteOptions | string,\n    frameId?: string,\n    shouldCache?: boolean,\n  ): Promise<AgentResult> {\n    // Check if integrations are being used in API mode (not supported)\n    if (agentConfig.integrations && agentConfig.integrations.length > 0) {\n      throw new ExperimentalNotConfiguredError(\"MCP integrations\");\n    }\n\n    // Strip non-serializable `page` from executeOptions before wire serialization\n    let wireExecuteOptions: Api.AgentExecuteRequest[\"executeOptions\"];\n    if (typeof executeOptions === \"string\") {\n      wireExecuteOptions = { instruction: executeOptions };\n    } else if (executeOptions.page) {\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { page: _, ...rest } = executeOptions;\n      wireExecuteOptions = rest;\n    } else {\n      wireExecuteOptions = executeOptions;\n    }\n\n    const wireAgentConfig: Api.AgentExecuteRequest[\"agentConfig\"] = {\n      systemPrompt: agentConfig.systemPrompt,\n      mode: agentConfig.mode ?? (agentConfig.cua === true ? \"cua\" : undefined),\n      cua: agentConfig.mode === undefined ? agentConfig.cua : undefined,\n      model: agentConfig.model\n        ? this.prepareModelConfig(agentConfig.model)\n        : undefined,\n      executionModel: agentConfig.executionModel\n        ? this.prepareModelConfig(agentConfig.executionModel)\n        : undefined,\n    };\n\n    // Build wire-format request body\n    const requestBody: Api.AgentExecuteRequest = {\n      agentConfig: wireAgentConfig,\n      executeOptions: wireExecuteOptions,\n      frameId,\n      shouldCache,\n    };\n\n    const result = await this.execute<AgentResult>({\n      method: \"agentExecute\",\n      args: requestBody,\n    });\n\n    const finishedData =\n      this.consumeFinishedEventData<Api.AgentExecuteResult>() ?? null;\n    this.latestAgentCacheEntry =\n      finishedData?.cacheEntry !== undefined\n        ? (finishedData.cacheEntry as AgentCacheTransferPayload)\n        : null;\n    return result;\n  }\n\n  consumeLatestAgentCacheEntry(): AgentCacheTransferPayload | null {\n    const entry = this.latestAgentCacheEntry;\n    this.latestAgentCacheEntry = null;\n    return entry;\n  }\n\n  async end(): Promise<Response> {\n    const url = `/sessions/${this.sessionId}/end`;\n    const response = await this.request(url, {\n      method: \"POST\",\n    });\n    return response;\n  }\n\n  async getReplayMetrics(): Promise<StagehandMetrics> {\n    if (!this.sessionId) {\n      throw new StagehandAPIError(\"sessionId is required to fetch metrics.\");\n    }\n\n    const response = await this.request(`/sessions/${this.sessionId}/replay`, {\n      method: \"GET\",\n    });\n\n    if (response.status !== 200) {\n      const errorText = await response.text();\n      this.logger({\n        category: \"api\",\n        message: `Failed to fetch metrics. Status ${response.status}: ${errorText}`,\n        level: 0,\n      });\n      throw new StagehandHttpError(\n        `Failed to fetch metrics with status ${response.status}: ${errorText}`,\n      );\n    }\n\n    const data = (await response.json()) as\n      | Api.ReplayResponse\n      | { success: false; error?: string };\n\n    if (!data.success) {\n      const errorData = data as { success: false; error?: string };\n      throw new StagehandAPIError(\n        `Failed to fetch metrics: ${errorData.error || \"Unknown error\"}`,\n      );\n    }\n\n    // Parse the API data into StagehandMetrics format\n    const apiData = (data as Api.ReplayResponse).data;\n    const metrics: StagehandMetrics = {\n      actPromptTokens: 0,\n      actCompletionTokens: 0,\n      actReasoningTokens: 0,\n      actCachedInputTokens: 0,\n      actInferenceTimeMs: 0,\n      extractPromptTokens: 0,\n      extractCompletionTokens: 0,\n      extractReasoningTokens: 0,\n      extractCachedInputTokens: 0,\n      extractInferenceTimeMs: 0,\n      observePromptTokens: 0,\n      observeCompletionTokens: 0,\n      observeReasoningTokens: 0,\n      observeCachedInputTokens: 0,\n      observeInferenceTimeMs: 0,\n      agentPromptTokens: 0,\n      agentCompletionTokens: 0,\n      agentReasoningTokens: 0,\n      agentCachedInputTokens: 0,\n      agentInferenceTimeMs: 0,\n      totalPromptTokens: 0,\n      totalCompletionTokens: 0,\n      totalReasoningTokens: 0,\n      totalCachedInputTokens: 0,\n      totalInferenceTimeMs: 0,\n    };\n\n    // Parse pages and their actions\n    const pages = apiData?.pages || [];\n    for (const page of pages) {\n      const actions = page.actions || [];\n      for (const action of actions) {\n        // Get method name and token usage\n        const method = (action.method || \"\").toLowerCase();\n        const tokenUsage = action.tokenUsage;\n\n        if (tokenUsage) {\n          const inputTokens = tokenUsage.inputTokens || 0;\n          const outputTokens = tokenUsage.outputTokens || 0;\n          const reasoningTokens =\n            \"reasoningTokens\" in tokenUsage\n              ? Number(\n                  (tokenUsage as { reasoningTokens?: number })\n                    .reasoningTokens ?? 0,\n                )\n              : 0;\n          const cachedInputTokens =\n            \"cachedInputTokens\" in tokenUsage\n              ? Number(\n                  (tokenUsage as { cachedInputTokens?: number })\n                    .cachedInputTokens ?? 0,\n                )\n              : 0;\n          const timeMs = tokenUsage.timeMs || 0;\n\n          // Map method to metrics fields\n          if (method === \"act\") {\n            metrics.actPromptTokens += inputTokens;\n            metrics.actCompletionTokens += outputTokens;\n            metrics.actReasoningTokens += reasoningTokens;\n            metrics.actCachedInputTokens += cachedInputTokens;\n            metrics.actInferenceTimeMs += timeMs;\n          } else if (method === \"extract\") {\n            metrics.extractPromptTokens += inputTokens;\n            metrics.extractCompletionTokens += outputTokens;\n            metrics.extractReasoningTokens += reasoningTokens;\n            metrics.extractCachedInputTokens += cachedInputTokens;\n            metrics.extractInferenceTimeMs += timeMs;\n          } else if (method === \"observe\") {\n            metrics.observePromptTokens += inputTokens;\n            metrics.observeCompletionTokens += outputTokens;\n            metrics.observeReasoningTokens += reasoningTokens;\n            metrics.observeCachedInputTokens += cachedInputTokens;\n            metrics.observeInferenceTimeMs += timeMs;\n          } else if (method === \"agent\") {\n            metrics.agentPromptTokens += inputTokens;\n            metrics.agentCompletionTokens += outputTokens;\n            metrics.agentReasoningTokens += reasoningTokens;\n            metrics.agentCachedInputTokens += cachedInputTokens;\n            metrics.agentInferenceTimeMs += timeMs;\n          }\n\n          // Always update totals for any method with token usage\n          metrics.totalPromptTokens += inputTokens;\n          metrics.totalCompletionTokens += outputTokens;\n          metrics.totalReasoningTokens += reasoningTokens;\n          metrics.totalCachedInputTokens += cachedInputTokens;\n          metrics.totalInferenceTimeMs += timeMs;\n        }\n      }\n    }\n\n    return metrics;\n  }\n\n  /**\n   * Prepares a model configuration for the API payload by ensuring the `apiKey`\n   * is included. If the model is passed as a string, converts it to an object\n   * with `modelName` and `apiKey`.\n   *\n   * In API mode, we only attempt to load an API key from env vars when the\n   * model provider differs from the one used to init the session.\n   */\n  private prepareModelConfig(\n    model: ModelConfiguration,\n  ): { modelName: string; apiKey: string } & Record<string, unknown> {\n    if (typeof model === \"string\") {\n      // Extract provider from model string (e.g., \"openai/gpt-5-nano\" -> \"openai\")\n      const provider = model.includes(\"/\") ? model.split(\"/\")[0] : undefined;\n      const apiKey =\n        provider && provider !== this.modelProvider\n          ? (loadApiKeyFromEnv(provider, this.logger) ?? this.modelApiKey)\n          : this.modelApiKey;\n      return {\n        modelName: model,\n        apiKey,\n      };\n    }\n\n    if (!model.apiKey) {\n      const provider = model.modelName?.includes(\"/\")\n        ? model.modelName.split(\"/\")[0]\n        : undefined;\n      const apiKey =\n        provider && provider !== this.modelProvider\n          ? (loadApiKeyFromEnv(provider, this.logger) ?? this.modelApiKey)\n          : this.modelApiKey;\n      return {\n        ...model,\n        apiKey,\n      };\n    }\n\n    return model as { modelName: string; apiKey: string } & Record<\n      string,\n      unknown\n    >;\n  }\n\n  private consumeFinishedEventData<T>(): T | null {\n    const data = this.lastFinishedEventData as T | null;\n    this.lastFinishedEventData = null;\n    return data;\n  }\n\n  private async execute<T>({\n    method,\n    args,\n    params,\n    serverCache,\n  }: ExecuteActionParams): Promise<T> {\n    this.lastFinishedEventData = null;\n    const urlParams = new URLSearchParams(params as Record<string, string>);\n    const queryString = urlParams.toString();\n    const url = `/sessions/${this.sessionId}/${method}${queryString ? `?${queryString}` : \"\"}`;\n\n    const response = await this.request(\n      url,\n      {\n        method: \"POST\",\n        body: JSON.stringify(args),\n      },\n      serverCache,\n    );\n\n    // Capture cache status from response header\n    const cacheStatus = response.headers.get(\"browserbase-cache-status\") as\n      | \"HIT\"\n      | \"MISS\"\n      | null;\n\n    if (!response.ok) {\n      const errorBody = await response.text();\n      throw new StagehandHttpError(\n        `HTTP error! status: ${response.status}, body: ${errorBody}`,\n      );\n    }\n\n    if (!response.body) {\n      throw new StagehandResponseBodyError();\n    }\n\n    const reader = response.body.getReader();\n    const decoder = new TextDecoder();\n    let buffer = \"\";\n\n    while (true) {\n      const { value, done } = await reader.read();\n\n      if (done && !buffer) {\n        throw new StagehandServerError(\n          \"Stream ended without completion signal\",\n        );\n      }\n\n      buffer += decoder.decode(value, { stream: true });\n      const lines = buffer.split(\"\\n\\n\");\n      buffer = lines.pop() || \"\";\n\n      for (const line of lines) {\n        if (!line.startsWith(\"data: \")) continue;\n\n        try {\n          const eventData = JSON.parse(line.slice(6));\n\n          if (eventData.type === \"system\") {\n            if (eventData.data.status === \"error\") {\n              const { error: errorMsg } = eventData.data;\n              // Throw plain Error to match local SDK behavior (useApi: false)\n              throw new Error(errorMsg);\n            }\n            if (eventData.data.status === \"finished\") {\n              this.lastFinishedEventData = eventData.data;\n\n              // If caching was bypassed for this request, suppress cache status\n              // so we don't log or surface a MISS that the server emits anyway.\n              const cacheEnabled = this.shouldUseCache(serverCache);\n              return this.attachCacheStatus(\n                eventData.data.result as T,\n                method,\n                cacheEnabled ? cacheStatus : null,\n                cacheEnabled ? eventData : { data: {} },\n              );\n            }\n          } else if (eventData.type === \"log\") {\n            const msg = eventData.data.message;\n            // Skip server-side internal logs that don't apply to API mode\n            if (msg?.message === \"Connecting to local browser\") {\n              continue;\n            }\n            this.logger(eventData.data.message);\n          }\n        } catch (e) {\n          // Let Error instances pass through (server errors thrown above)\n          // Only wrap SyntaxError from JSON.parse as parse errors\n          if (e instanceof Error && !(e instanceof SyntaxError)) {\n            throw e;\n          }\n\n          const errorMessage = e instanceof Error ? e.message : String(e);\n          this.logger({\n            category: \"api\",\n            message: `Failed to parse SSE event: ${errorMessage}`,\n            level: 0,\n          });\n          throw new StagehandResponseParseError(\n            `Failed to parse server response: ${errorMessage}`,\n          );\n        }\n      }\n\n      if (done) {\n        // Process any remaining data in buffer before exiting\n        if (buffer.trim() && buffer.startsWith(\"data: \")) {\n          try {\n            const eventData = JSON.parse(buffer.slice(6));\n            if (\n              eventData.type === \"system\" &&\n              eventData.data.status === \"finished\"\n            ) {\n              return this.attachCacheStatus(\n                eventData.data.result as T,\n                method,\n                cacheStatus,\n                eventData,\n              );\n            }\n          } catch {\n            this.logger({\n              category: \"api\",\n              message: `Incomplete data in final buffer: ${buffer.substring(0, 100)}`,\n              level: 0,\n            });\n          }\n        }\n        throw new StagehandServerError(\n          \"Stream ended without completion signal\",\n        );\n      }\n    }\n  }\n\n  /**\n   * Resolves the final cache status from the response header or SSE event data,\n   * logs it, and attaches it to act/extract results before returning.\n   */\n  private attachCacheStatus<T>(\n    result: T,\n    method: string,\n    cacheStatus: \"HIT\" | \"MISS\" | null,\n    eventData: { data: { cacheHit?: boolean } },\n  ): T {\n    const finalCacheStatus =\n      cacheStatus ||\n      (typeof eventData.data.cacheHit === \"boolean\"\n        ? eventData.data.cacheHit\n          ? \"HIT\"\n          : \"MISS\"\n        : undefined);\n    if (\n      finalCacheStatus &&\n      (method === \"act\" || method === \"extract\" || method === \"observe\")\n    ) {\n      this.logger({\n        category: \"cache\",\n        message: `${method} server cache ${finalCacheStatus.toLowerCase()}`,\n        level: 1,\n      });\n    }\n    if (\n      finalCacheStatus &&\n      result &&\n      typeof result === \"object\" &&\n      (method === \"act\" || method === \"extract\" || method === \"observe\")\n    ) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      (result as ActResult | ExtractResult<any> | ObserveResult).cacheStatus =\n        finalCacheStatus;\n    }\n    return result;\n  }\n\n  /**\n   * Determine if caching should be enabled for a request.\n   * Method-level setting takes precedence over instance-level setting.\n   */\n  private shouldUseCache(methodServerCache?: boolean): boolean {\n    // If method-level setting is explicitly provided, use it\n    if (methodServerCache !== undefined) {\n      return methodServerCache;\n    }\n    // Otherwise, use instance-level setting\n    return this.serverCache;\n  }\n\n  private async request(\n    path: string,\n    options: RequestInit,\n    serverCache?: boolean,\n  ): Promise<Response> {\n    const defaultHeaders: Record<string, string> = {\n      \"x-bb-api-key\": this.apiKey,\n      ...(this.projectId ? { \"x-bb-project-id\": this.projectId } : {}),\n      \"x-bb-session-id\": this.sessionId,\n      // we want real-time logs, so we stream the response\n      \"x-stream-response\": \"true\",\n      \"x-model-api-key\": this.modelApiKey,\n      \"x-language\": \"typescript\",\n      \"x-sdk-version\": STAGEHAND_VERSION,\n    };\n\n    // Add cache bypass header if caching is disabled\n    if (!this.shouldUseCache(serverCache)) {\n      defaultHeaders[\"browserbase-cache-bypass\"] = \"true\";\n    }\n\n    if (options.method === \"POST\" && options.body) {\n      defaultHeaders[\"Content-Type\"] = \"application/json\";\n    }\n\n    // Use STAGEHAND_API_URL env var if set, otherwise use region-based URL\n    // Ensure /v1 suffix is present for consistency\n    let baseUrl: string;\n    if (process.env.STAGEHAND_API_URL) {\n      const envUrl = process.env.STAGEHAND_API_URL.replace(/\\/+$/, \"\");\n      // Append /v1 if not already present\n      baseUrl = envUrl.endsWith(\"/v1\") ? envUrl : `${envUrl}/v1`;\n    } else {\n      baseUrl = getApiUrlForRegion(this.region);\n    }\n\n    const response = await this.fetchWithCookies(`${baseUrl}${path}`, {\n      ...options,\n      headers: {\n        ...defaultHeaders,\n        ...options.headers,\n      },\n    });\n\n    return response;\n  }\n}\n"]}

package/dist/esm/lib/v3/cache/ActCache.d.ts

@@ -19,5 +19,4 @@ export declare class ActCache {
     private refreshCacheEntry;
     private doVariableKeysMatch;
     private hasAllVariableValues;
-    private runWithTimeout;
 }

package/dist/esm/lib/v3/cache/ActCache.js

@@ -1,6 +1,7 @@
 import { createHash } from "crypto";
 import { safeGetPageUrl, waitForCachedSelector } from "./utils.js";
 import { StagehandNotInitializedError } from "../types/public/sdkErrors.js";
+import { withTimeout } from "../timeoutConfig.js";
 export class ActCache {
     storage;
     logger;
@@ -192,7 +193,7 @@ export class ActCache {
                 actions,
             };
         };
-        return await this.runWithTimeout(execute, timeout);
+        return await withTimeout(execute(), timeout, "act()");
     }
     haveActionsChanged(original, updated) {
         if (original.length !== updated.length) {
@@ -271,22 +272,5 @@ export class ActCache {
         }
         return true;
     }
-    async runWithTimeout(run, timeout) {
-        if (!timeout) {
-            return await run();
-        }
-        return await new Promise((resolve, reject) => {
-            const timer = setTimeout(() => {
-                reject(new Error(`act() timed out after ${timeout}ms`));
-            }, timeout);
-            void run().then((value) => {
-                clearTimeout(timer);
-                resolve(value);
-            }, (err) => {
-                clearTimeout(timer);
-                reject(err);
-            });
-        });
-    }
 }
 //# sourceMappingURL=ActCache.js.map

package/dist/esm/lib/v3/cache/ActCache.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActCache.js","sourceRoot":"","sources":["../../../../../lib/v3/cache/ActCache.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"crypto\";\nimport type { ActHandler } from \"../handlers/actHandler.js\";\nimport type { LLMClient } from \"../llm/LLMClient.js\";\nimport type { Action, ActResult, Logger } from \"../types/public/index.js\";\nimport type { Page } from \"../understudy/page.js\";\nimport { CacheStorage } from \"./CacheStorage.js\";\nimport { safeGetPageUrl, waitForCachedSelector } from \"./utils.js\";\nimport {\n  ActCacheContext,\n  ActCacheDeps,\n  CachedActEntry,\n} from \"../types/private/index.js\";\nimport { StagehandNotInitializedError } from \"../types/public/sdkErrors.js\";\n\nexport class ActCache {\n  private readonly storage: CacheStorage;\n  private readonly logger: Logger;\n  private readonly getActHandler: () => ActHandler | null;\n  private readonly getDefaultLlmClient: () => LLMClient;\n  private readonly domSettleTimeoutMs?: number;\n\n  constructor({\n    storage,\n    logger,\n    getActHandler,\n    getDefaultLlmClient,\n    domSettleTimeoutMs,\n  }: ActCacheDeps) {\n    this.storage = storage;\n    this.logger = logger;\n    this.getActHandler = getActHandler;\n    this.getDefaultLlmClient = getDefaultLlmClient;\n    this.domSettleTimeoutMs = domSettleTimeoutMs;\n  }\n\n  get enabled(): boolean {\n    return this.storage.enabled;\n  }\n\n  async prepareContext(\n    instruction: string,\n    page: Page,\n    variables?: Record<string, string>,\n  ): Promise<ActCacheContext | null> {\n    if (!this.enabled) return null;\n    const sanitizedInstruction = instruction.trim();\n    const sanitizedVariables = variables ? { ...variables } : undefined;\n    const variableKeys = sanitizedVariables\n      ? Object.keys(sanitizedVariables).sort()\n      : [];\n    const pageUrl = await safeGetPageUrl(page);\n    const cacheKey = this.buildActCacheKey(\n      sanitizedInstruction,\n      pageUrl,\n      variableKeys,\n    );\n    return {\n      instruction: sanitizedInstruction,\n      cacheKey,\n      pageUrl,\n      variableKeys,\n      variables: sanitizedVariables,\n    };\n  }\n\n  async tryReplay(\n    context: ActCacheContext,\n    page: Page,\n    timeout?: number,\n    llmClientOverride?: LLMClient,\n  ): Promise<ActResult | null> {\n    if (!this.enabled) return null;\n\n    const {\n      value: entry,\n      error,\n      path,\n    } = await this.storage.readJson<CachedActEntry>(`${context.cacheKey}.json`);\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: `failed to read act cache entry: ${path}`,\n        level: 2,\n        auxiliary: {\n          error: { value: String(error), type: \"string\" },\n        },\n      });\n      return null;\n    }\n    if (!entry) return null;\n    if (entry.version !== 1) return null;\n    if (!Array.isArray(entry.actions) || entry.actions.length === 0) {\n      return null;\n    }\n\n    const entryVariableKeys = Array.isArray(entry.variableKeys)\n      ? [...entry.variableKeys].sort()\n      : [];\n    const contextVariableKeys = [...context.variableKeys];\n\n    if (!this.doVariableKeysMatch(entryVariableKeys, contextVariableKeys)) {\n      return null;\n    }\n\n    if (\n      contextVariableKeys.length > 0 &&\n      (!context.variables ||\n        !this.hasAllVariableValues(contextVariableKeys, context.variables))\n    ) {\n      this.logger({\n        category: \"cache\",\n        message: \"act cache miss: missing variables for replay\",\n        level: 2,\n        auxiliary: {\n          instruction: { value: context.instruction, type: \"string\" },\n        },\n      });\n      return null;\n    }\n\n    this.logger({\n      category: \"cache\",\n      message: \"act cache hit\",\n      level: 1,\n      auxiliary: {\n        instruction: { value: context.instruction, type: \"string\" },\n        url: {\n          value: entry.url ?? context.pageUrl,\n          type: \"string\",\n        },\n      },\n    });\n\n    return await this.replayCachedActions(\n      context,\n      entry,\n      page,\n      timeout,\n      llmClientOverride,\n    );\n  }\n\n  async store(context: ActCacheContext, result: ActResult): Promise<void> {\n    if (!this.enabled) return;\n\n    const entry: CachedActEntry = {\n      version: 1,\n      instruction: context.instruction,\n      url: context.pageUrl,\n      variableKeys: context.variableKeys,\n      actions: result.actions ?? [],\n      actionDescription: result.actionDescription,\n      message: result.message,\n    };\n\n    const { error, path } = await this.storage.writeJson(\n      `${context.cacheKey}.json`,\n      entry,\n    );\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: \"failed to write act cache entry\",\n        level: 1,\n        auxiliary: {\n          error: { value: String(error), type: \"string\" },\n        },\n      });\n      return;\n    }\n\n    this.logger({\n      category: \"cache\",\n      message: \"act cache stored\",\n      level: 2,\n      auxiliary: {\n        instruction: { value: context.instruction, type: \"string\" },\n        url: { value: context.pageUrl, type: \"string\" },\n      },\n    });\n  }\n\n  private buildActCacheKey(\n    instruction: string,\n    url: string,\n    variableKeys: string[],\n  ): string {\n    const payload = JSON.stringify({\n      instruction,\n      url,\n      variableKeys,\n    });\n    return createHash(\"sha256\").update(payload).digest(\"hex\");\n  }\n\n  private async replayCachedActions(\n    context: ActCacheContext,\n    entry: CachedActEntry,\n    page: Page,\n    timeout?: number,\n    llmClientOverride?: LLMClient,\n  ): Promise<ActResult> {\n    const handler = this.getActHandler();\n    if (!handler) {\n      throw new StagehandNotInitializedError(\"act()\");\n    }\n    const effectiveClient = llmClientOverride ?? this.getDefaultLlmClient();\n\n    const execute = async (): Promise<ActResult> => {\n      const actionResults: ActResult[] = [];\n      for (const action of entry.actions) {\n        await waitForCachedSelector({\n          page,\n          selector: action.selector,\n          timeout: this.domSettleTimeoutMs,\n          logger: this.logger,\n          context: \"act\",\n        });\n        const result = await handler.takeDeterministicAction(\n          action,\n          page,\n          this.domSettleTimeoutMs,\n          effectiveClient,\n          undefined,\n          context.variables,\n        );\n        actionResults.push(result);\n        if (!result.success) {\n          break;\n        }\n      }\n\n      if (actionResults.length === 0) {\n        return {\n          success: false,\n          message: \"Failed to perform act: cached entry has no actions\",\n          actionDescription: entry.actionDescription ?? entry.instruction,\n          actions: [],\n        };\n      }\n\n      const success = actionResults.every((r) => r.success);\n      const actions = actionResults.flatMap((r) => r.actions ?? []);\n      const message =\n        actionResults\n          .map((r) => r.message)\n          .filter((m) => m && m.trim().length > 0)\n          .join(\" → \") ||\n        entry.message ||\n        `Replayed ${entry.actions.length} cached action${\n          entry.actions.length === 1 ? \"\" : \"s\"\n        }.`;\n      const actionDescription =\n        entry.actionDescription ||\n        actionResults[actionResults.length - 1]?.actionDescription ||\n        entry.actions[entry.actions.length - 1]?.description ||\n        entry.instruction;\n\n      if (\n        success &&\n        actions.length > 0 &&\n        this.haveActionsChanged(entry.actions, actions)\n      ) {\n        await this.refreshCacheEntry(context, {\n          ...entry,\n          actions,\n          message,\n          actionDescription,\n        });\n      }\n      return {\n        success,\n        message,\n        actionDescription,\n        actions,\n      };\n    };\n\n    return await this.runWithTimeout(execute, timeout);\n  }\n\n  private haveActionsChanged(original: Action[], updated: Action[]): boolean {\n    if (original.length !== updated.length) {\n      return true;\n    }\n\n    for (let i = 0; i < original.length; i += 1) {\n      const orig = original[i];\n      const next = updated[i];\n      if (!next) {\n        return true;\n      }\n\n      if (orig.selector !== next.selector) {\n        return true;\n      }\n\n      if (orig.description !== next.description) {\n        return true;\n      }\n\n      if ((orig.method ?? \"\") !== (next.method ?? \"\")) {\n        return true;\n      }\n\n      const origArgs = orig.arguments ?? [];\n      const nextArgs = next.arguments ?? [];\n      if (origArgs.length !== nextArgs.length) {\n        return true;\n      }\n\n      for (let j = 0; j < origArgs.length; j += 1) {\n        if (origArgs[j] !== nextArgs[j]) {\n          return true;\n        }\n      }\n    }\n\n    return false;\n  }\n\n  private async refreshCacheEntry(\n    context: ActCacheContext,\n    entry: CachedActEntry,\n  ): Promise<void> {\n    const { error, path } = await this.storage.writeJson(\n      `${context.cacheKey}.json`,\n      {\n        ...entry,\n        variableKeys: context.variableKeys,\n      },\n    );\n\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: \"failed to update act cache entry after self-heal\",\n        level: 0,\n        auxiliary: {\n          error: { value: String(error), type: \"string\" },\n        },\n      });\n      return;\n    }\n\n    this.logger({\n      category: \"cache\",\n      message: \"act cache entry updated after self-heal\",\n      level: 2,\n      auxiliary: {\n        instruction: { value: context.instruction, type: \"string\" },\n        url: { value: context.pageUrl, type: \"string\" },\n      },\n    });\n  }\n\n  private doVariableKeysMatch(\n    entryKeys: string[],\n    contextKeys: string[],\n  ): boolean {\n    if (entryKeys.length !== contextKeys.length) {\n      return false;\n    }\n\n    for (let i = 0; i < entryKeys.length; i += 1) {\n      if (entryKeys[i] !== contextKeys[i]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  private hasAllVariableValues(\n    variableKeys: string[],\n    variables: Record<string, string>,\n  ): boolean {\n    for (const key of variableKeys) {\n      if (!(key in variables)) {\n        return false;\n      }\n    }\n    return true;\n  }\n\n  private async runWithTimeout<T>(\n    run: () => Promise<T>,\n    timeout?: number,\n  ): Promise<T> {\n    if (!timeout) {\n      return await run();\n    }\n\n    return await new Promise<T>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new Error(`act() timed out after ${timeout}ms`));\n      }, timeout);\n\n      void run().then(\n        (value) => {\n          clearTimeout(timer);\n          resolve(value);\n        },\n        (err) => {\n          clearTimeout(timer);\n          reject(err);\n        },\n      );\n    });\n  }\n}\n"]}
+{"version":3,"file":"ActCache.js","sourceRoot":"","sources":["../../../../../lib/v3/cache/ActCache.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"crypto\";\nimport type { ActHandler } from \"../handlers/actHandler.js\";\nimport type { LLMClient } from \"../llm/LLMClient.js\";\nimport type { Action, ActResult, Logger } from \"../types/public/index.js\";\nimport type { Page } from \"../understudy/page.js\";\nimport { CacheStorage } from \"./CacheStorage.js\";\nimport { safeGetPageUrl, waitForCachedSelector } from \"./utils.js\";\nimport {\n  ActCacheContext,\n  ActCacheDeps,\n  CachedActEntry,\n} from \"../types/private/index.js\";\nimport { StagehandNotInitializedError } from \"../types/public/sdkErrors.js\";\nimport { withTimeout } from \"../timeoutConfig.js\";\n\nexport class ActCache {\n  private readonly storage: CacheStorage;\n  private readonly logger: Logger;\n  private readonly getActHandler: () => ActHandler | null;\n  private readonly getDefaultLlmClient: () => LLMClient;\n  private readonly domSettleTimeoutMs?: number;\n\n  constructor({\n    storage,\n    logger,\n    getActHandler,\n    getDefaultLlmClient,\n    domSettleTimeoutMs,\n  }: ActCacheDeps) {\n    this.storage = storage;\n    this.logger = logger;\n    this.getActHandler = getActHandler;\n    this.getDefaultLlmClient = getDefaultLlmClient;\n    this.domSettleTimeoutMs = domSettleTimeoutMs;\n  }\n\n  get enabled(): boolean {\n    return this.storage.enabled;\n  }\n\n  async prepareContext(\n    instruction: string,\n    page: Page,\n    variables?: Record<string, string>,\n  ): Promise<ActCacheContext | null> {\n    if (!this.enabled) return null;\n    const sanitizedInstruction = instruction.trim();\n    const sanitizedVariables = variables ? { ...variables } : undefined;\n    const variableKeys = sanitizedVariables\n      ? Object.keys(sanitizedVariables).sort()\n      : [];\n    const pageUrl = await safeGetPageUrl(page);\n    const cacheKey = this.buildActCacheKey(\n      sanitizedInstruction,\n      pageUrl,\n      variableKeys,\n    );\n    return {\n      instruction: sanitizedInstruction,\n      cacheKey,\n      pageUrl,\n      variableKeys,\n      variables: sanitizedVariables,\n    };\n  }\n\n  async tryReplay(\n    context: ActCacheContext,\n    page: Page,\n    timeout?: number,\n    llmClientOverride?: LLMClient,\n  ): Promise<ActResult | null> {\n    if (!this.enabled) return null;\n\n    const {\n      value: entry,\n      error,\n      path,\n    } = await this.storage.readJson<CachedActEntry>(`${context.cacheKey}.json`);\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: `failed to read act cache entry: ${path}`,\n        level: 2,\n        auxiliary: {\n          error: { value: String(error), type: \"string\" },\n        },\n      });\n      return null;\n    }\n    if (!entry) return null;\n    if (entry.version !== 1) return null;\n    if (!Array.isArray(entry.actions) || entry.actions.length === 0) {\n      return null;\n    }\n\n    const entryVariableKeys = Array.isArray(entry.variableKeys)\n      ? [...entry.variableKeys].sort()\n      : [];\n    const contextVariableKeys = [...context.variableKeys];\n\n    if (!this.doVariableKeysMatch(entryVariableKeys, contextVariableKeys)) {\n      return null;\n    }\n\n    if (\n      contextVariableKeys.length > 0 &&\n      (!context.variables ||\n        !this.hasAllVariableValues(contextVariableKeys, context.variables))\n    ) {\n      this.logger({\n        category: \"cache\",\n        message: \"act cache miss: missing variables for replay\",\n        level: 2,\n        auxiliary: {\n          instruction: { value: context.instruction, type: \"string\" },\n        },\n      });\n      return null;\n    }\n\n    this.logger({\n      category: \"cache\",\n      message: \"act cache hit\",\n      level: 1,\n      auxiliary: {\n        instruction: { value: context.instruction, type: \"string\" },\n        url: {\n          value: entry.url ?? context.pageUrl,\n          type: \"string\",\n        },\n      },\n    });\n\n    return await this.replayCachedActions(\n      context,\n      entry,\n      page,\n      timeout,\n      llmClientOverride,\n    );\n  }\n\n  async store(context: ActCacheContext, result: ActResult): Promise<void> {\n    if (!this.enabled) return;\n\n    const entry: CachedActEntry = {\n      version: 1,\n      instruction: context.instruction,\n      url: context.pageUrl,\n      variableKeys: context.variableKeys,\n      actions: result.actions ?? [],\n      actionDescription: result.actionDescription,\n      message: result.message,\n    };\n\n    const { error, path } = await this.storage.writeJson(\n      `${context.cacheKey}.json`,\n      entry,\n    );\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: \"failed to write act cache entry\",\n        level: 1,\n        auxiliary: {\n          error: { value: String(error), type: \"string\" },\n        },\n      });\n      return;\n    }\n\n    this.logger({\n      category: \"cache\",\n      message: \"act cache stored\",\n      level: 2,\n      auxiliary: {\n        instruction: { value: context.instruction, type: \"string\" },\n        url: { value: context.pageUrl, type: \"string\" },\n      },\n    });\n  }\n\n  private buildActCacheKey(\n    instruction: string,\n    url: string,\n    variableKeys: string[],\n  ): string {\n    const payload = JSON.stringify({\n      instruction,\n      url,\n      variableKeys,\n    });\n    return createHash(\"sha256\").update(payload).digest(\"hex\");\n  }\n\n  private async replayCachedActions(\n    context: ActCacheContext,\n    entry: CachedActEntry,\n    page: Page,\n    timeout?: number,\n    llmClientOverride?: LLMClient,\n  ): Promise<ActResult> {\n    const handler = this.getActHandler();\n    if (!handler) {\n      throw new StagehandNotInitializedError(\"act()\");\n    }\n    const effectiveClient = llmClientOverride ?? this.getDefaultLlmClient();\n\n    const execute = async (): Promise<ActResult> => {\n      const actionResults: ActResult[] = [];\n      for (const action of entry.actions) {\n        await waitForCachedSelector({\n          page,\n          selector: action.selector,\n          timeout: this.domSettleTimeoutMs,\n          logger: this.logger,\n          context: \"act\",\n        });\n        const result = await handler.takeDeterministicAction(\n          action,\n          page,\n          this.domSettleTimeoutMs,\n          effectiveClient,\n          undefined,\n          context.variables,\n        );\n        actionResults.push(result);\n        if (!result.success) {\n          break;\n        }\n      }\n\n      if (actionResults.length === 0) {\n        return {\n          success: false,\n          message: \"Failed to perform act: cached entry has no actions\",\n          actionDescription: entry.actionDescription ?? entry.instruction,\n          actions: [],\n        };\n      }\n\n      const success = actionResults.every((r) => r.success);\n      const actions = actionResults.flatMap((r) => r.actions ?? []);\n      const message =\n        actionResults\n          .map((r) => r.message)\n          .filter((m) => m && m.trim().length > 0)\n          .join(\" → \") ||\n        entry.message ||\n        `Replayed ${entry.actions.length} cached action${\n          entry.actions.length === 1 ? \"\" : \"s\"\n        }.`;\n      const actionDescription =\n        entry.actionDescription ||\n        actionResults[actionResults.length - 1]?.actionDescription ||\n        entry.actions[entry.actions.length - 1]?.description ||\n        entry.instruction;\n\n      if (\n        success &&\n        actions.length > 0 &&\n        this.haveActionsChanged(entry.actions, actions)\n      ) {\n        await this.refreshCacheEntry(context, {\n          ...entry,\n          actions,\n          message,\n          actionDescription,\n        });\n      }\n      return {\n        success,\n        message,\n        actionDescription,\n        actions,\n      };\n    };\n\n    return await withTimeout(execute(), timeout, \"act()\");\n  }\n\n  private haveActionsChanged(original: Action[], updated: Action[]): boolean {\n    if (original.length !== updated.length) {\n      return true;\n    }\n\n    for (let i = 0; i < original.length; i += 1) {\n      const orig = original[i];\n      const next = updated[i];\n      if (!next) {\n        return true;\n      }\n\n      if (orig.selector !== next.selector) {\n        return true;\n      }\n\n      if (orig.description !== next.description) {\n        return true;\n      }\n\n      if ((orig.method ?? \"\") !== (next.method ?? \"\")) {\n        return true;\n      }\n\n      const origArgs = orig.arguments ?? [];\n      const nextArgs = next.arguments ?? [];\n      if (origArgs.length !== nextArgs.length) {\n        return true;\n      }\n\n      for (let j = 0; j < origArgs.length; j += 1) {\n        if (origArgs[j] !== nextArgs[j]) {\n          return true;\n        }\n      }\n    }\n\n    return false;\n  }\n\n  private async refreshCacheEntry(\n    context: ActCacheContext,\n    entry: CachedActEntry,\n  ): Promise<void> {\n    const { error, path } = await this.storage.writeJson(\n      `${context.cacheKey}.json`,\n      {\n        ...entry,\n        variableKeys: context.variableKeys,\n      },\n    );\n\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: \"failed to update act cache entry after self-heal\",\n        level: 0,\n        auxiliary: {\n          error: { value: String(error), type: \"string\" },\n        },\n      });\n      return;\n    }\n\n    this.logger({\n      category: \"cache\",\n      message: \"act cache entry updated after self-heal\",\n      level: 2,\n      auxiliary: {\n        instruction: { value: context.instruction, type: \"string\" },\n        url: { value: context.pageUrl, type: \"string\" },\n      },\n    });\n  }\n\n  private doVariableKeysMatch(\n    entryKeys: string[],\n    contextKeys: string[],\n  ): boolean {\n    if (entryKeys.length !== contextKeys.length) {\n      return false;\n    }\n\n    for (let i = 0; i < entryKeys.length; i += 1) {\n      if (entryKeys[i] !== contextKeys[i]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  private hasAllVariableValues(\n    variableKeys: string[],\n    variables: Record<string, string>,\n  ): boolean {\n    for (const key of variableKeys) {\n      if (!(key in variables)) {\n        return false;\n      }\n    }\n    return true;\n  }\n}\n"]}

package/dist/esm/lib/v3/handlers/actHandler.js

@@ -56,8 +56,7 @@ export class ActHandler {
     async act(params) {
         const { instruction, page, variables, timeout, model } = params;
         const llmClient = this.resolveLlmClient(model);
-        const effectiveTimeoutMs = typeof timeout === "number" && timeout > 0 ? timeout : undefined;
-        const ensureTimeRemaining = createTimeoutGuard(effectiveTimeoutMs, (ms) => new ActTimeoutError(ms));
+        const ensureTimeRemaining = createTimeoutGuard(timeout, (ms) => new ActTimeoutError(ms));
         ensureTimeRemaining();
         await waitForDomNetworkQuiet(page.mainFrame(), this.defaultDomSettleTimeoutMs);
         ensureTimeRemaining();

package/dist/esm/lib/v3/handlers/actHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"actHandler.js","sourceRoot":"","sources":["../../../../../lib/v3/handlers/actHandler.ts"],"names":[],"mappings":"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","sourcesContent":["// lib/v3/handlers/actHandler.ts\nimport { act as actInference } from \"../../inference.js\";\nimport { buildActPrompt, buildStepTwoPrompt } from \"../../prompt.js\";\nimport { trimTrailingTextNode } from \"../../utils.js\";\nimport { v3Logger } from \"../logger.js\";\nimport { ActHandlerParams } from \"../types/private/handlers.js\";\nimport { ActResult, Action, V3FunctionName } from \"../types/public/methods.js\";\nimport { ActTimeoutError } from \"../types/public/sdkErrors.js\";\nimport {\n  captureHybridSnapshot,\n  diffCombinedTrees,\n} from \"../understudy/a11y/snapshot/index.js\";\nimport { LLMClient } from \"../llm/LLMClient.js\";\nimport { SupportedUnderstudyAction } from \"../types/private/index.js\";\nimport { EncodedId } from \"../types/private/internal.js\";\nimport {\n  AvailableModel,\n  ClientOptions,\n  ModelConfiguration,\n} from \"../types/public/model.js\";\nimport type { Variables } from \"../types/public/agent.js\";\nimport type { Page } from \"../understudy/page.js\";\nimport {\n  performUnderstudyMethod,\n  waitForDomNetworkQuiet,\n} from \"./handlerUtils/actHandlerUtils.js\";\nimport { createTimeoutGuard } from \"./handlerUtils/timeoutGuard.js\";\nimport { resolveVariableValue } from \"../agent/utils/variables.js\";\n\ntype ActInferenceElement = {\n  elementId?: string;\n  description: string;\n  method?: string;\n  arguments?: string[];\n};\n\ntype ActInferenceResponse = Awaited<ReturnType<typeof actInference>>;\n\nexport class ActHandler {\n  private readonly llmClient: LLMClient;\n  private readonly defaultModelName: AvailableModel;\n  private readonly defaultClientOptions: ClientOptions;\n  private readonly resolveLlmClient: (model?: ModelConfiguration) => LLMClient;\n  private readonly systemPrompt: string;\n  private readonly logInferenceToFile: boolean;\n  private readonly selfHeal: boolean;\n  private readonly onMetrics?: (\n    functionName: V3FunctionName,\n    promptTokens: number,\n    completionTokens: number,\n    reasoningTokens: number,\n    cachedInputTokens: number,\n    inferenceTimeMs: number,\n  ) => void;\n  private readonly defaultDomSettleTimeoutMs?: number;\n\n  constructor(\n    llmClient: LLMClient,\n    defaultModelName: AvailableModel,\n    defaultClientOptions: ClientOptions,\n    resolveLlmClient: (model?: ModelConfiguration) => LLMClient,\n    systemPrompt?: string,\n    logInferenceToFile?: boolean,\n    selfHeal?: boolean,\n    onMetrics?: (\n      functionName: V3FunctionName,\n      promptTokens: number,\n      completionTokens: number,\n      reasoningTokens: number,\n      cachedInputTokens: number,\n      inferenceTimeMs: number,\n    ) => void,\n    defaultDomSettleTimeoutMs?: number,\n  ) {\n    this.llmClient = llmClient;\n    this.defaultModelName = defaultModelName;\n    this.defaultClientOptions = defaultClientOptions;\n    this.resolveLlmClient = resolveLlmClient;\n    this.systemPrompt = systemPrompt ?? \"\";\n    this.logInferenceToFile = logInferenceToFile ?? false;\n    this.selfHeal = !!selfHeal;\n    this.onMetrics = onMetrics;\n    this.defaultDomSettleTimeoutMs = defaultDomSettleTimeoutMs;\n  }\n\n  private recordActMetrics(response: ActInferenceResponse): void {\n    this.onMetrics?.(\n      V3FunctionName.ACT,\n      response.prompt_tokens ?? 0,\n      response.completion_tokens ?? 0,\n      response.reasoning_tokens ?? 0,\n      response.cached_input_tokens ?? 0,\n      response.inference_time_ms ?? 0,\n    );\n  }\n\n  private async getActionFromLLM({\n    instruction,\n    domElements,\n    xpathMap,\n    llmClient,\n    requireMethodAndArguments = true,\n  }: {\n    instruction: string;\n    domElements: string;\n    xpathMap: Record<string, string>;\n    llmClient: LLMClient;\n    requireMethodAndArguments?: boolean;\n  }): Promise<{ action?: Action; response: ActInferenceResponse }> {\n    const response = await actInference({\n      instruction,\n      domElements,\n      llmClient,\n      userProvidedInstructions: this.systemPrompt,\n      logger: v3Logger,\n      logInferenceToFile: this.logInferenceToFile,\n    });\n\n    this.recordActMetrics(response);\n\n    const normalized = normalizeActInferenceElement(\n      response.element as ActInferenceElement | undefined,\n      xpathMap,\n      requireMethodAndArguments,\n    );\n\n    if (!normalized) {\n      return { response };\n    }\n\n    return {\n      action: { ...normalized } as Action,\n      response,\n    };\n  }\n\n  async act(params: ActHandlerParams): Promise<ActResult> {\n    const { instruction, page, variables, timeout, model } = params;\n\n    const llmClient = this.resolveLlmClient(model);\n    const effectiveTimeoutMs =\n      typeof timeout === \"number\" && timeout > 0 ? timeout : undefined;\n\n    const ensureTimeRemaining = createTimeoutGuard(\n      effectiveTimeoutMs,\n      (ms) => new ActTimeoutError(ms),\n    );\n\n    ensureTimeRemaining();\n    await waitForDomNetworkQuiet(\n      page.mainFrame(),\n      this.defaultDomSettleTimeoutMs,\n    );\n    ensureTimeRemaining();\n    const { combinedTree, combinedXpathMap } = await captureHybridSnapshot(\n      page,\n      { experimental: true },\n    );\n\n    const actInstruction = buildActPrompt(\n      instruction,\n      Object.values(SupportedUnderstudyAction),\n      variables,\n    );\n\n    ensureTimeRemaining();\n    const { action: firstAction, response: actInferenceResponse } =\n      await this.getActionFromLLM({\n        instruction: actInstruction,\n        domElements: combinedTree,\n        xpathMap: combinedXpathMap,\n        llmClient,\n      });\n\n    if (!firstAction) {\n      v3Logger({\n        category: \"action\",\n        message: \"no actionable element returned by LLM\",\n        level: 1,\n      });\n      return {\n        success: false,\n        message: \"Failed to perform act: No action found\",\n        actionDescription: instruction,\n        actions: [],\n      };\n    }\n\n    // First action (self-heal aware path)\n    ensureTimeRemaining();\n    const firstResult = await this.takeDeterministicAction(\n      firstAction,\n      page,\n      this.defaultDomSettleTimeoutMs,\n      llmClient,\n      ensureTimeRemaining,\n      variables,\n    );\n\n    // If not two-step, return the first action result\n    if (actInferenceResponse?.twoStep !== true) {\n      return firstResult;\n    }\n\n    // Take a new focused snapshot and observe again\n    ensureTimeRemaining();\n    const { combinedTree: combinedTree2, combinedXpathMap: combinedXpathMap2 } =\n      await captureHybridSnapshot(page, {\n        experimental: true,\n      });\n\n    let diffedTree = diffCombinedTrees(combinedTree, combinedTree2);\n    if (!diffedTree.trim()) {\n      // Fallback: if no diff detected, use the fresh tree to avoid empty context\n      diffedTree = combinedTree2;\n    }\n\n    const previousAction = `method: ${firstAction.method}, description: ${firstAction.description}, arguments: ${firstAction.arguments}`;\n\n    const stepTwoInstructions = buildStepTwoPrompt(\n      instruction,\n      previousAction,\n      Object.values(SupportedUnderstudyAction).filter(\n        (\n          action,\n        ): action is Exclude<\n          SupportedUnderstudyAction,\n          SupportedUnderstudyAction.SELECT_OPTION_FROM_DROPDOWN\n        > => action !== SupportedUnderstudyAction.SELECT_OPTION_FROM_DROPDOWN,\n      ),\n      variables,\n    );\n\n    ensureTimeRemaining();\n    const { action: secondAction } = await this.getActionFromLLM({\n      instruction: stepTwoInstructions,\n      domElements: diffedTree,\n      xpathMap: combinedXpathMap2,\n      llmClient,\n    });\n\n    if (!secondAction) {\n      // No second action found — return first result as-is\n      return firstResult;\n    }\n\n    ensureTimeRemaining();\n    const secondResult = await this.takeDeterministicAction(\n      secondAction,\n      page,\n      this.defaultDomSettleTimeoutMs,\n      llmClient,\n      ensureTimeRemaining,\n      variables,\n    );\n\n    // Combine results\n    return {\n      success: firstResult.success && secondResult.success,\n      message: secondResult.success\n        ? `${firstResult.message} → ${secondResult.message}`\n        : `${firstResult.message} → ${secondResult.message}`,\n      actionDescription: firstResult.actionDescription,\n      actions: [\n        ...(firstResult.actions || []),\n        ...(secondResult.actions || []),\n      ],\n    };\n  }\n\n  async takeDeterministicAction(\n    action: Action,\n    page: Page,\n    domSettleTimeoutMs?: number,\n    llmClientOverride?: LLMClient,\n    ensureTimeRemaining?: () => void,\n    variables?: Variables,\n  ): Promise<ActResult> {\n    ensureTimeRemaining?.();\n    const settleTimeout = domSettleTimeoutMs ?? this.defaultDomSettleTimeoutMs;\n    const effectiveClient = llmClientOverride ?? this.llmClient;\n    const method = action.method?.trim();\n    if (!method || method === \"not-supported\") {\n      v3Logger({\n        category: \"action\",\n        message: \"action has no supported method\",\n        level: 0,\n        auxiliary: {\n          act: { value: JSON.stringify(action), type: \"object\" },\n        },\n      });\n      return {\n        success: false,\n        message: `Unable to perform action: The method '${method ?? \"\"}' is not supported in Action. Please use a supported Playwright locator method.`,\n        actionDescription:\n          action.description || `Action (${method ?? \"unknown\"})`,\n        actions: [],\n      };\n    }\n\n    const placeholderArgs = Array.isArray(action.arguments)\n      ? [...action.arguments]\n      : [];\n    const resolvedArgs =\n      substituteVariablesInArguments(action.arguments, variables) ?? [];\n\n    try {\n      ensureTimeRemaining?.();\n      await performUnderstudyMethod(\n        page,\n        page.mainFrame(),\n        method,\n        action.selector,\n        resolvedArgs,\n        settleTimeout,\n      );\n      return {\n        success: true,\n        message: `Action [${method}] performed successfully on selector: ${action.selector}`,\n        actionDescription: action.description || `action (${method})`,\n        actions: [\n          {\n            selector: action.selector,\n            description: action.description || `action (${method})`,\n            method,\n            arguments: placeholderArgs,\n          },\n        ],\n      };\n    } catch (err) {\n      if (err instanceof ActTimeoutError) {\n        throw err;\n      }\n      const msg = err instanceof Error ? err.message : String(err);\n\n      // Attempt self-heal: rerun actInference and retry with updated selector\n      if (this.selfHeal) {\n        v3Logger({\n          category: \"action\",\n          message:\n            \"Error performing action. Reprocessing the page and trying again\",\n          level: 1,\n          auxiliary: {\n            error: { value: msg, type: \"string\" },\n            action: {\n              value: JSON.stringify(action),\n              type: \"object\",\n            },\n          },\n        });\n\n        try {\n          // Build an instruction combining method + description, avoiding duplication\n          const actCommand = action.description\n            ? action.description.toLowerCase().startsWith(method.toLowerCase())\n              ? action.description\n              : `${method} ${action.description}`\n            : method;\n\n          // Take a fresh snapshot and ask for a new actionable element\n          ensureTimeRemaining?.();\n          const { combinedTree, combinedXpathMap } =\n            await captureHybridSnapshot(page, {\n              experimental: true,\n            });\n\n          const instruction = buildActPrompt(\n            actCommand,\n            Object.values(SupportedUnderstudyAction),\n            {},\n          );\n\n          ensureTimeRemaining?.();\n          const { action: fallbackAction, response: fallbackResponse } =\n            await this.getActionFromLLM({\n              instruction,\n              domElements: combinedTree,\n              xpathMap: combinedXpathMap,\n              llmClient: effectiveClient,\n              requireMethodAndArguments: false,\n            });\n\n          const fallbackElement = fallbackResponse.element;\n          if (!fallbackElement) {\n            return {\n              success: false,\n              message:\n                \"Failed to self-heal act: No observe results found for action\",\n              actionDescription: actCommand,\n              actions: [],\n            };\n          }\n\n          // Retry with original method/args but new selector from fallback\n          let newSelector = action.selector;\n          if (fallbackAction?.selector) {\n            newSelector = fallbackAction.selector;\n          }\n\n          ensureTimeRemaining?.();\n          await performUnderstudyMethod(\n            page,\n            page.mainFrame(),\n            method,\n            newSelector,\n            resolvedArgs,\n            settleTimeout,\n          );\n\n          return {\n            success: true,\n            message: `Action [${method}] performed successfully on selector: ${newSelector}`,\n            actionDescription: action.description || `action (${method})`,\n            actions: [\n              {\n                selector: newSelector,\n                description: action.description || `action (${method})`,\n                method,\n                arguments: placeholderArgs,\n              },\n            ],\n          };\n        } catch (retryErr) {\n          if (retryErr instanceof ActTimeoutError) {\n            throw retryErr;\n          }\n          const retryMsg =\n            retryErr instanceof Error ? retryErr.message : String(retryErr);\n          return {\n            success: false,\n            message: `Failed to perform act after self-heal: ${retryMsg}`,\n            actionDescription: action.description || `action (${method})`,\n            actions: [],\n          };\n        }\n      }\n\n      return {\n        success: false,\n        message: `Failed to perform act: ${msg}`,\n        actionDescription: action.description || `action (${method})`,\n        actions: [],\n      };\n    }\n  }\n}\n\nfunction normalizeActInferenceElement(\n  element: ActInferenceElement | undefined,\n  xpathMap: Record<string, string>,\n  requireMethodAndArguments = true,\n): Action | undefined {\n  if (!element) {\n    return undefined;\n  }\n  const { elementId, description, method, arguments: args } = element;\n  const hasArgs = Array.isArray(args);\n\n  if (\n    requireMethodAndArguments &&\n    (!method || method === \"not-supported\" || !hasArgs)\n  ) {\n    return undefined;\n  }\n\n  if (typeof elementId !== \"string\" || !elementId.includes(\"-\")) {\n    return undefined;\n  }\n\n  const xp = xpathMap[elementId as EncodedId];\n  const trimmed = trimTrailingTextNode(xp);\n  if (!trimmed) {\n    return undefined;\n  }\n\n  // For dragAndDrop, convert element ID in arguments to xpath (target element)\n  let resolvedArgs = hasArgs ? args : undefined;\n  if (method === \"dragAndDrop\" && hasArgs && args.length > 0) {\n    const targetArg = args[0];\n    // Check if argument looks like an element ID (e.g., \"1-67\")\n    if (typeof targetArg === \"string\" && /^\\d+-\\d+$/.test(targetArg)) {\n      const argXpath = xpathMap[targetArg as EncodedId];\n      const trimmedArgXpath = trimTrailingTextNode(argXpath);\n      if (trimmedArgXpath) {\n        resolvedArgs = [`xpath=${trimmedArgXpath}`, ...args.slice(1)];\n      } else {\n        // Target element lookup failed, filter out this action\n        v3Logger({\n          category: \"action\",\n          message: \"dragAndDrop target element lookup failed\",\n          level: 1,\n          auxiliary: {\n            targetElementId: { value: targetArg, type: \"string\" },\n            sourceElementId: { value: elementId, type: \"string\" },\n          },\n        });\n        return undefined;\n      }\n    } else {\n      v3Logger({\n        category: \"action\",\n        message: \"dragAndDrop target element invalid ID format\",\n        level: 0,\n        auxiliary: {\n          targetElementId: { value: String(targetArg), type: \"string\" },\n          sourceElementId: { value: elementId, type: \"string\" },\n        },\n      });\n      return undefined;\n    }\n  }\n\n  return {\n    description,\n    method,\n    arguments: resolvedArgs,\n    selector: `xpath=${trimmed}`,\n  } as Action;\n}\n\nfunction substituteVariablesInArguments(\n  args: string[] | undefined,\n  variables?: Variables,\n): string[] | undefined {\n  if (!variables || !Array.isArray(args)) {\n    return args;\n  }\n\n  return args.map((arg: string) => {\n    let out = arg;\n    for (const [key, v] of Object.entries(variables)) {\n      const token = `%${key}%`;\n      out = out.split(token).join(resolveVariableValue(v));\n    }\n    return out;\n  });\n}\n"]}
+{"version":3,"file":"actHandler.js","sourceRoot":"","sources":["../../../../../lib/v3/handlers/actHandler.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EAAE,GAAG,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAqB,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAStE,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAWnE,MAAM,OAAO,UAAU;IACJ,SAAS,CAAY;IACrB,gBAAgB,CAAiB;IACjC,oBAAoB,CAAgB;IACpC,gBAAgB,CAA4C;IAC5D,YAAY,CAAS;IACrB,kBAAkB,CAAU;IAC5B,QAAQ,CAAU;IAClB,SAAS,CAOhB;IACO,yBAAyB,CAAU;IAEpD,YACE,SAAoB,EACpB,gBAAgC,EAChC,oBAAmC,EACnC,gBAA2D,EAC3D,YAAqB,EACrB,kBAA4B,EAC5B,QAAkB,EAClB,SAOS,EACT,yBAAkC;QAElC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,IAAI,KAAK,CAAC;QACtD,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,yBAAyB,GAAG,yBAAyB,CAAC;IAC7D,CAAC;IAEO,gBAAgB,CAAC,QAA8B;QACrD,IAAI,CAAC,SAAS,EAAE,CACd,cAAc,CAAC,GAAG,EAClB,QAAQ,CAAC,aAAa,IAAI,CAAC,EAC3B,QAAQ,CAAC,iBAAiB,IAAI,CAAC,EAC/B,QAAQ,CAAC,gBAAgB,IAAI,CAAC,EAC9B,QAAQ,CAAC,mBAAmB,IAAI,CAAC,EACjC,QAAQ,CAAC,iBAAiB,IAAI,CAAC,CAChC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,EAC7B,WAAW,EACX,WAAW,EACX,QAAQ,EACR,SAAS,EACT,yBAAyB,GAAG,IAAI,GAOjC;QACC,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC;YAClC,WAAW;YACX,WAAW;YACX,SAAS;YACT,wBAAwB,EAAE,IAAI,CAAC,YAAY;YAC3C,MAAM,EAAE,QAAQ;YAChB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;SAC5C,CAAC,CAAC;QAEH,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAEhC,MAAM,UAAU,GAAG,4BAA4B,CAC7C,QAAQ,CAAC,OAA0C,EACnD,QAAQ,EACR,yBAAyB,CAC1B,CAAC;QAEF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,QAAQ,EAAE,CAAC;QACtB,CAAC;QAED,OAAO;YACL,MAAM,EAAE,EAAE,GAAG,UAAU,EAAY;YACnC,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAwB;QAChC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAEhE,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,mBAAmB,GAAG,kBAAkB,CAC5C,OAAO,EACP,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,eAAe,CAAC,EAAE,CAAC,CAChC,CAAC;QAEF,mBAAmB,EAAE,CAAC;QACtB,MAAM,sBAAsB,CAC1B,IAAI,CAAC,SAAS,EAAE,EAChB,IAAI,CAAC,yBAAyB,CAC/B,CAAC;QACF,mBAAmB,EAAE,CAAC;QACtB,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,GAAG,MAAM,qBAAqB,CACpE,IAAI,EACJ,EAAE,YAAY,EAAE,IAAI,EAAE,CACvB,CAAC;QAEF,MAAM,cAAc,GAAG,cAAc,CACnC,WAAW,EACX,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,EACxC,SAAS,CACV,CAAC;QAEF,mBAAmB,EAAE,CAAC;QACtB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,oBAAoB,EAAE,GAC3D,MAAM,IAAI,CAAC,gBAAgB,CAAC;YAC1B,WAAW,EAAE,cAAc;YAC3B,WAAW,EAAE,YAAY;YACzB,QAAQ,EAAE,gBAAgB;YAC1B,SAAS;SACV,CAAC,CAAC;QAEL,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,QAAQ,CAAC;gBACP,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE,uCAAuC;gBAChD,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,wCAAwC;gBACjD,iBAAiB,EAAE,WAAW;gBAC9B,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;QAED,sCAAsC;QACtC,mBAAmB,EAAE,CAAC;QACtB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,uBAAuB,CACpD,WAAW,EACX,IAAI,EACJ,IAAI,CAAC,yBAAyB,EAC9B,SAAS,EACT,mBAAmB,EACnB,SAAS,CACV,CAAC;QAEF,kDAAkD;QAClD,IAAI,oBAAoB,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAC3C,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,gDAAgD;QAChD,mBAAmB,EAAE,CAAC;QACtB,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,GACxE,MAAM,qBAAqB,CAAC,IAAI,EAAE;YAChC,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEL,IAAI,UAAU,GAAG,iBAAiB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;YACvB,2EAA2E;YAC3E,UAAU,GAAG,aAAa,CAAC;QAC7B,CAAC;QAED,MAAM,cAAc,GAAG,WAAW,WAAW,CAAC,MAAM,kBAAkB,WAAW,CAAC,WAAW,gBAAgB,WAAW,CAAC,SAAS,EAAE,CAAC;QAErI,MAAM,mBAAmB,GAAG,kBAAkB,CAC5C,WAAW,EACX,cAAc,EACd,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAC7C,CACE,MAAM,EAIN,EAAE,CAAC,MAAM,KAAK,yBAAyB,CAAC,2BAA2B,CACtE,EACD,SAAS,CACV,CAAC;QAEF,mBAAmB,EAAE,CAAC;QACtB,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC;YAC3D,WAAW,EAAE,mBAAmB;YAChC,WAAW,EAAE,UAAU;YACvB,QAAQ,EAAE,iBAAiB;YAC3B,SAAS;SACV,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,qDAAqD;YACrD,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,mBAAmB,EAAE,CAAC;QACtB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,uBAAuB,CACrD,YAAY,EACZ,IAAI,EACJ,IAAI,CAAC,yBAAyB,EAC9B,SAAS,EACT,mBAAmB,EACnB,SAAS,CACV,CAAC;QAEF,kBAAkB;QAClB,OAAO;YACL,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,YAAY,CAAC,OAAO;YACpD,OAAO,EAAE,YAAY,CAAC,OAAO;gBAC3B,CAAC,CAAC,GAAG,WAAW,CAAC,OAAO,MAAM,YAAY,CAAC,OAAO,EAAE;gBACpD,CAAC,CAAC,GAAG,WAAW,CAAC,OAAO,MAAM,YAAY,CAAC,OAAO,EAAE;YACtD,iBAAiB,EAAE,WAAW,CAAC,iBAAiB;YAChD,OAAO,EAAE;gBACP,GAAG,CAAC,WAAW,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC9B,GAAG,CAAC,YAAY,CAAC,OAAO,IAAI,EAAE,CAAC;aAChC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,uBAAuB,CAC3B,MAAc,EACd,IAAU,EACV,kBAA2B,EAC3B,iBAA6B,EAC7B,mBAAgC,EAChC,SAAqB;QAErB,mBAAmB,EAAE,EAAE,CAAC;QACxB,MAAM,aAAa,GAAG,kBAAkB,IAAI,IAAI,CAAC,yBAAyB,CAAC;QAC3E,MAAM,eAAe,GAAG,iBAAiB,IAAI,IAAI,CAAC,SAAS,CAAC;QAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;YAC1C,QAAQ,CAAC;gBACP,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE,gCAAgC;gBACzC,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE;oBACT,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACvD;aACF,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,yCAAyC,MAAM,IAAI,EAAE,iFAAiF;gBAC/I,iBAAiB,EACf,MAAM,CAAC,WAAW,IAAI,WAAW,MAAM,IAAI,SAAS,GAAG;gBACzD,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;YACrD,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;YACvB,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,YAAY,GAChB,8BAA8B,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QAEpE,IAAI,CAAC;YACH,mBAAmB,EAAE,EAAE,CAAC;YACxB,MAAM,uBAAuB,CAC3B,IAAI,EACJ,IAAI,CAAC,SAAS,EAAE,EAChB,MAAM,EACN,MAAM,CAAC,QAAQ,EACf,YAAY,EACZ,aAAa,CACd,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,WAAW,MAAM,yCAAyC,MAAM,CAAC,QAAQ,EAAE;gBACpF,iBAAiB,EAAE,MAAM,CAAC,WAAW,IAAI,WAAW,MAAM,GAAG;gBAC7D,OAAO,EAAE;oBACP;wBACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,WAAW,MAAM,GAAG;wBACvD,MAAM;wBACN,SAAS,EAAE,eAAe;qBAC3B;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;gBACnC,MAAM,GAAG,CAAC;YACZ,CAAC;YACD,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAE7D,wEAAwE;YACxE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,QAAQ,CAAC;oBACP,QAAQ,EAAE,QAAQ;oBAClB,OAAO,EACL,iEAAiE;oBACnE,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE;wBACT,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACrC,MAAM,EAAE;4BACN,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;4BAC7B,IAAI,EAAE,QAAQ;yBACf;qBACF;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC;oBACH,4EAA4E;oBAC5E,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW;wBACnC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;4BACjE,CAAC,CAAC,MAAM,CAAC,WAAW;4BACpB,CAAC,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,WAAW,EAAE;wBACrC,CAAC,CAAC,MAAM,CAAC;oBAEX,6DAA6D;oBAC7D,mBAAmB,EAAE,EAAE,CAAC;oBACxB,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,GACtC,MAAM,qBAAqB,CAAC,IAAI,EAAE;wBAChC,YAAY,EAAE,IAAI;qBACnB,CAAC,CAAC;oBAEL,MAAM,WAAW,GAAG,cAAc,CAChC,UAAU,EACV,MAAM,CAAC,MAAM,CAAC,yBAAyB,CAAC,EACxC,EAAE,CACH,CAAC;oBAEF,mBAAmB,EAAE,EAAE,CAAC;oBACxB,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAC1D,MAAM,IAAI,CAAC,gBAAgB,CAAC;wBAC1B,WAAW;wBACX,WAAW,EAAE,YAAY;wBACzB,QAAQ,EAAE,gBAAgB;wBAC1B,SAAS,EAAE,eAAe;wBAC1B,yBAAyB,EAAE,KAAK;qBACjC,CAAC,CAAC;oBAEL,MAAM,eAAe,GAAG,gBAAgB,CAAC,OAAO,CAAC;oBACjD,IAAI,CAAC,eAAe,EAAE,CAAC;wBACrB,OAAO;4BACL,OAAO,EAAE,KAAK;4BACd,OAAO,EACL,8DAA8D;4BAChE,iBAAiB,EAAE,UAAU;4BAC7B,OAAO,EAAE,EAAE;yBACZ,CAAC;oBACJ,CAAC;oBAED,iEAAiE;oBACjE,IAAI,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC;oBAClC,IAAI,cAAc,EAAE,QAAQ,EAAE,CAAC;wBAC7B,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC;oBACxC,CAAC;oBAED,mBAAmB,EAAE,EAAE,CAAC;oBACxB,MAAM,uBAAuB,CAC3B,IAAI,EACJ,IAAI,CAAC,SAAS,EAAE,EAChB,MAAM,EACN,WAAW,EACX,YAAY,EACZ,aAAa,CACd,CAAC;oBAEF,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,OAAO,EAAE,WAAW,MAAM,yCAAyC,WAAW,EAAE;wBAChF,iBAAiB,EAAE,MAAM,CAAC,WAAW,IAAI,WAAW,MAAM,GAAG;wBAC7D,OAAO,EAAE;4BACP;gCACE,QAAQ,EAAE,WAAW;gCACrB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,WAAW,MAAM,GAAG;gCACvD,MAAM;gCACN,SAAS,EAAE,eAAe;6BAC3B;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAAC,OAAO,QAAQ,EAAE,CAAC;oBAClB,IAAI,QAAQ,YAAY,eAAe,EAAE,CAAC;wBACxC,MAAM,QAAQ,CAAC;oBACjB,CAAC;oBACD,MAAM,QAAQ,GACZ,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAClE,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,OAAO,EAAE,0CAA0C,QAAQ,EAAE;wBAC7D,iBAAiB,EAAE,MAAM,CAAC,WAAW,IAAI,WAAW,MAAM,GAAG;wBAC7D,OAAO,EAAE,EAAE;qBACZ,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,0BAA0B,GAAG,EAAE;gBACxC,iBAAiB,EAAE,MAAM,CAAC,WAAW,IAAI,WAAW,MAAM,GAAG;gBAC7D,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,SAAS,4BAA4B,CACnC,OAAwC,EACxC,QAAgC,EAChC,yBAAyB,GAAG,IAAI;IAEhC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC,IACE,yBAAyB;QACzB,CAAC,CAAC,MAAM,IAAI,MAAM,KAAK,eAAe,IAAI,CAAC,OAAO,CAAC,EACnD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAsB,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,6EAA6E;IAC7E,IAAI,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9C,IAAI,MAAM,KAAK,aAAa,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,4DAA4D;QAC5D,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAsB,CAAC,CAAC;YAClD,MAAM,eAAe,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YACvD,IAAI,eAAe,EAAE,CAAC;gBACpB,YAAY,GAAG,CAAC,SAAS,eAAe,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,uDAAuD;gBACvD,QAAQ,CAAC;oBACP,QAAQ,EAAE,QAAQ;oBAClB,OAAO,EAAE,0CAA0C;oBACnD,KAAK,EAAE,CAAC;oBACR,SAAS,EAAE;wBACT,eAAe,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACrD,eAAe,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;qBACtD;iBACF,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC;gBACP,QAAQ,EAAE,QAAQ;gBAClB,OAAO,EAAE,8CAA8C;gBACvD,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE;oBACT,eAAe,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC7D,eAAe,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACtD;aACF,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW;QACX,MAAM;QACN,SAAS,EAAE,YAAY;QACvB,QAAQ,EAAE,SAAS,OAAO,EAAE;KACnB,CAAC;AACd,CAAC;AAED,SAAS,8BAA8B,CACrC,IAA0B,EAC1B,SAAqB;IAErB,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE;QAC9B,IAAI,GAAG,GAAG,GAAG,CAAC;QACd,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,IAAI,GAAG,GAAG,CAAC;YACzB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["// lib/v3/handlers/actHandler.ts\nimport { act as actInference } from \"../../inference.js\";\nimport { buildActPrompt, buildStepTwoPrompt } from \"../../prompt.js\";\nimport { trimTrailingTextNode } from \"../../utils.js\";\nimport { v3Logger } from \"../logger.js\";\nimport { ActHandlerParams } from \"../types/private/handlers.js\";\nimport { ActResult, Action, V3FunctionName } from \"../types/public/methods.js\";\nimport { ActTimeoutError } from \"../types/public/sdkErrors.js\";\nimport {\n  captureHybridSnapshot,\n  diffCombinedTrees,\n} from \"../understudy/a11y/snapshot/index.js\";\nimport { LLMClient } from \"../llm/LLMClient.js\";\nimport { SupportedUnderstudyAction } from \"../types/private/index.js\";\nimport { EncodedId } from \"../types/private/internal.js\";\nimport {\n  AvailableModel,\n  ClientOptions,\n  ModelConfiguration,\n} from \"../types/public/model.js\";\nimport type { Variables } from \"../types/public/agent.js\";\nimport type { Page } from \"../understudy/page.js\";\nimport {\n  performUnderstudyMethod,\n  waitForDomNetworkQuiet,\n} from \"./handlerUtils/actHandlerUtils.js\";\nimport { createTimeoutGuard } from \"./handlerUtils/timeoutGuard.js\";\nimport { resolveVariableValue } from \"../agent/utils/variables.js\";\n\ntype ActInferenceElement = {\n  elementId?: string;\n  description: string;\n  method?: string;\n  arguments?: string[];\n};\n\ntype ActInferenceResponse = Awaited<ReturnType<typeof actInference>>;\n\nexport class ActHandler {\n  private readonly llmClient: LLMClient;\n  private readonly defaultModelName: AvailableModel;\n  private readonly defaultClientOptions: ClientOptions;\n  private readonly resolveLlmClient: (model?: ModelConfiguration) => LLMClient;\n  private readonly systemPrompt: string;\n  private readonly logInferenceToFile: boolean;\n  private readonly selfHeal: boolean;\n  private readonly onMetrics?: (\n    functionName: V3FunctionName,\n    promptTokens: number,\n    completionTokens: number,\n    reasoningTokens: number,\n    cachedInputTokens: number,\n    inferenceTimeMs: number,\n  ) => void;\n  private readonly defaultDomSettleTimeoutMs?: number;\n\n  constructor(\n    llmClient: LLMClient,\n    defaultModelName: AvailableModel,\n    defaultClientOptions: ClientOptions,\n    resolveLlmClient: (model?: ModelConfiguration) => LLMClient,\n    systemPrompt?: string,\n    logInferenceToFile?: boolean,\n    selfHeal?: boolean,\n    onMetrics?: (\n      functionName: V3FunctionName,\n      promptTokens: number,\n      completionTokens: number,\n      reasoningTokens: number,\n      cachedInputTokens: number,\n      inferenceTimeMs: number,\n    ) => void,\n    defaultDomSettleTimeoutMs?: number,\n  ) {\n    this.llmClient = llmClient;\n    this.defaultModelName = defaultModelName;\n    this.defaultClientOptions = defaultClientOptions;\n    this.resolveLlmClient = resolveLlmClient;\n    this.systemPrompt = systemPrompt ?? \"\";\n    this.logInferenceToFile = logInferenceToFile ?? false;\n    this.selfHeal = !!selfHeal;\n    this.onMetrics = onMetrics;\n    this.defaultDomSettleTimeoutMs = defaultDomSettleTimeoutMs;\n  }\n\n  private recordActMetrics(response: ActInferenceResponse): void {\n    this.onMetrics?.(\n      V3FunctionName.ACT,\n      response.prompt_tokens ?? 0,\n      response.completion_tokens ?? 0,\n      response.reasoning_tokens ?? 0,\n      response.cached_input_tokens ?? 0,\n      response.inference_time_ms ?? 0,\n    );\n  }\n\n  private async getActionFromLLM({\n    instruction,\n    domElements,\n    xpathMap,\n    llmClient,\n    requireMethodAndArguments = true,\n  }: {\n    instruction: string;\n    domElements: string;\n    xpathMap: Record<string, string>;\n    llmClient: LLMClient;\n    requireMethodAndArguments?: boolean;\n  }): Promise<{ action?: Action; response: ActInferenceResponse }> {\n    const response = await actInference({\n      instruction,\n      domElements,\n      llmClient,\n      userProvidedInstructions: this.systemPrompt,\n      logger: v3Logger,\n      logInferenceToFile: this.logInferenceToFile,\n    });\n\n    this.recordActMetrics(response);\n\n    const normalized = normalizeActInferenceElement(\n      response.element as ActInferenceElement | undefined,\n      xpathMap,\n      requireMethodAndArguments,\n    );\n\n    if (!normalized) {\n      return { response };\n    }\n\n    return {\n      action: { ...normalized } as Action,\n      response,\n    };\n  }\n\n  async act(params: ActHandlerParams): Promise<ActResult> {\n    const { instruction, page, variables, timeout, model } = params;\n\n    const llmClient = this.resolveLlmClient(model);\n    const ensureTimeRemaining = createTimeoutGuard(\n      timeout,\n      (ms) => new ActTimeoutError(ms),\n    );\n\n    ensureTimeRemaining();\n    await waitForDomNetworkQuiet(\n      page.mainFrame(),\n      this.defaultDomSettleTimeoutMs,\n    );\n    ensureTimeRemaining();\n    const { combinedTree, combinedXpathMap } = await captureHybridSnapshot(\n      page,\n      { experimental: true },\n    );\n\n    const actInstruction = buildActPrompt(\n      instruction,\n      Object.values(SupportedUnderstudyAction),\n      variables,\n    );\n\n    ensureTimeRemaining();\n    const { action: firstAction, response: actInferenceResponse } =\n      await this.getActionFromLLM({\n        instruction: actInstruction,\n        domElements: combinedTree,\n        xpathMap: combinedXpathMap,\n        llmClient,\n      });\n\n    if (!firstAction) {\n      v3Logger({\n        category: \"action\",\n        message: \"no actionable element returned by LLM\",\n        level: 1,\n      });\n      return {\n        success: false,\n        message: \"Failed to perform act: No action found\",\n        actionDescription: instruction,\n        actions: [],\n      };\n    }\n\n    // First action (self-heal aware path)\n    ensureTimeRemaining();\n    const firstResult = await this.takeDeterministicAction(\n      firstAction,\n      page,\n      this.defaultDomSettleTimeoutMs,\n      llmClient,\n      ensureTimeRemaining,\n      variables,\n    );\n\n    // If not two-step, return the first action result\n    if (actInferenceResponse?.twoStep !== true) {\n      return firstResult;\n    }\n\n    // Take a new focused snapshot and observe again\n    ensureTimeRemaining();\n    const { combinedTree: combinedTree2, combinedXpathMap: combinedXpathMap2 } =\n      await captureHybridSnapshot(page, {\n        experimental: true,\n      });\n\n    let diffedTree = diffCombinedTrees(combinedTree, combinedTree2);\n    if (!diffedTree.trim()) {\n      // Fallback: if no diff detected, use the fresh tree to avoid empty context\n      diffedTree = combinedTree2;\n    }\n\n    const previousAction = `method: ${firstAction.method}, description: ${firstAction.description}, arguments: ${firstAction.arguments}`;\n\n    const stepTwoInstructions = buildStepTwoPrompt(\n      instruction,\n      previousAction,\n      Object.values(SupportedUnderstudyAction).filter(\n        (\n          action,\n        ): action is Exclude<\n          SupportedUnderstudyAction,\n          SupportedUnderstudyAction.SELECT_OPTION_FROM_DROPDOWN\n        > => action !== SupportedUnderstudyAction.SELECT_OPTION_FROM_DROPDOWN,\n      ),\n      variables,\n    );\n\n    ensureTimeRemaining();\n    const { action: secondAction } = await this.getActionFromLLM({\n      instruction: stepTwoInstructions,\n      domElements: diffedTree,\n      xpathMap: combinedXpathMap2,\n      llmClient,\n    });\n\n    if (!secondAction) {\n      // No second action found — return first result as-is\n      return firstResult;\n    }\n\n    ensureTimeRemaining();\n    const secondResult = await this.takeDeterministicAction(\n      secondAction,\n      page,\n      this.defaultDomSettleTimeoutMs,\n      llmClient,\n      ensureTimeRemaining,\n      variables,\n    );\n\n    // Combine results\n    return {\n      success: firstResult.success && secondResult.success,\n      message: secondResult.success\n        ? `${firstResult.message} → ${secondResult.message}`\n        : `${firstResult.message} → ${secondResult.message}`,\n      actionDescription: firstResult.actionDescription,\n      actions: [\n        ...(firstResult.actions || []),\n        ...(secondResult.actions || []),\n      ],\n    };\n  }\n\n  async takeDeterministicAction(\n    action: Action,\n    page: Page,\n    domSettleTimeoutMs?: number,\n    llmClientOverride?: LLMClient,\n    ensureTimeRemaining?: () => void,\n    variables?: Variables,\n  ): Promise<ActResult> {\n    ensureTimeRemaining?.();\n    const settleTimeout = domSettleTimeoutMs ?? this.defaultDomSettleTimeoutMs;\n    const effectiveClient = llmClientOverride ?? this.llmClient;\n    const method = action.method?.trim();\n    if (!method || method === \"not-supported\") {\n      v3Logger({\n        category: \"action\",\n        message: \"action has no supported method\",\n        level: 0,\n        auxiliary: {\n          act: { value: JSON.stringify(action), type: \"object\" },\n        },\n      });\n      return {\n        success: false,\n        message: `Unable to perform action: The method '${method ?? \"\"}' is not supported in Action. Please use a supported Playwright locator method.`,\n        actionDescription:\n          action.description || `Action (${method ?? \"unknown\"})`,\n        actions: [],\n      };\n    }\n\n    const placeholderArgs = Array.isArray(action.arguments)\n      ? [...action.arguments]\n      : [];\n    const resolvedArgs =\n      substituteVariablesInArguments(action.arguments, variables) ?? [];\n\n    try {\n      ensureTimeRemaining?.();\n      await performUnderstudyMethod(\n        page,\n        page.mainFrame(),\n        method,\n        action.selector,\n        resolvedArgs,\n        settleTimeout,\n      );\n      return {\n        success: true,\n        message: `Action [${method}] performed successfully on selector: ${action.selector}`,\n        actionDescription: action.description || `action (${method})`,\n        actions: [\n          {\n            selector: action.selector,\n            description: action.description || `action (${method})`,\n            method,\n            arguments: placeholderArgs,\n          },\n        ],\n      };\n    } catch (err) {\n      if (err instanceof ActTimeoutError) {\n        throw err;\n      }\n      const msg = err instanceof Error ? err.message : String(err);\n\n      // Attempt self-heal: rerun actInference and retry with updated selector\n      if (this.selfHeal) {\n        v3Logger({\n          category: \"action\",\n          message:\n            \"Error performing action. Reprocessing the page and trying again\",\n          level: 1,\n          auxiliary: {\n            error: { value: msg, type: \"string\" },\n            action: {\n              value: JSON.stringify(action),\n              type: \"object\",\n            },\n          },\n        });\n\n        try {\n          // Build an instruction combining method + description, avoiding duplication\n          const actCommand = action.description\n            ? action.description.toLowerCase().startsWith(method.toLowerCase())\n              ? action.description\n              : `${method} ${action.description}`\n            : method;\n\n          // Take a fresh snapshot and ask for a new actionable element\n          ensureTimeRemaining?.();\n          const { combinedTree, combinedXpathMap } =\n            await captureHybridSnapshot(page, {\n              experimental: true,\n            });\n\n          const instruction = buildActPrompt(\n            actCommand,\n            Object.values(SupportedUnderstudyAction),\n            {},\n          );\n\n          ensureTimeRemaining?.();\n          const { action: fallbackAction, response: fallbackResponse } =\n            await this.getActionFromLLM({\n              instruction,\n              domElements: combinedTree,\n              xpathMap: combinedXpathMap,\n              llmClient: effectiveClient,\n              requireMethodAndArguments: false,\n            });\n\n          const fallbackElement = fallbackResponse.element;\n          if (!fallbackElement) {\n            return {\n              success: false,\n              message:\n                \"Failed to self-heal act: No observe results found for action\",\n              actionDescription: actCommand,\n              actions: [],\n            };\n          }\n\n          // Retry with original method/args but new selector from fallback\n          let newSelector = action.selector;\n          if (fallbackAction?.selector) {\n            newSelector = fallbackAction.selector;\n          }\n\n          ensureTimeRemaining?.();\n          await performUnderstudyMethod(\n            page,\n            page.mainFrame(),\n            method,\n            newSelector,\n            resolvedArgs,\n            settleTimeout,\n          );\n\n          return {\n            success: true,\n            message: `Action [${method}] performed successfully on selector: ${newSelector}`,\n            actionDescription: action.description || `action (${method})`,\n            actions: [\n              {\n                selector: newSelector,\n                description: action.description || `action (${method})`,\n                method,\n                arguments: placeholderArgs,\n              },\n            ],\n          };\n        } catch (retryErr) {\n          if (retryErr instanceof ActTimeoutError) {\n            throw retryErr;\n          }\n          const retryMsg =\n            retryErr instanceof Error ? retryErr.message : String(retryErr);\n          return {\n            success: false,\n            message: `Failed to perform act after self-heal: ${retryMsg}`,\n            actionDescription: action.description || `action (${method})`,\n            actions: [],\n          };\n        }\n      }\n\n      return {\n        success: false,\n        message: `Failed to perform act: ${msg}`,\n        actionDescription: action.description || `action (${method})`,\n        actions: [],\n      };\n    }\n  }\n}\n\nfunction normalizeActInferenceElement(\n  element: ActInferenceElement | undefined,\n  xpathMap: Record<string, string>,\n  requireMethodAndArguments = true,\n): Action | undefined {\n  if (!element) {\n    return undefined;\n  }\n  const { elementId, description, method, arguments: args } = element;\n  const hasArgs = Array.isArray(args);\n\n  if (\n    requireMethodAndArguments &&\n    (!method || method === \"not-supported\" || !hasArgs)\n  ) {\n    return undefined;\n  }\n\n  if (typeof elementId !== \"string\" || !elementId.includes(\"-\")) {\n    return undefined;\n  }\n\n  const xp = xpathMap[elementId as EncodedId];\n  const trimmed = trimTrailingTextNode(xp);\n  if (!trimmed) {\n    return undefined;\n  }\n\n  // For dragAndDrop, convert element ID in arguments to xpath (target element)\n  let resolvedArgs = hasArgs ? args : undefined;\n  if (method === \"dragAndDrop\" && hasArgs && args.length > 0) {\n    const targetArg = args[0];\n    // Check if argument looks like an element ID (e.g., \"1-67\")\n    if (typeof targetArg === \"string\" && /^\\d+-\\d+$/.test(targetArg)) {\n      const argXpath = xpathMap[targetArg as EncodedId];\n      const trimmedArgXpath = trimTrailingTextNode(argXpath);\n      if (trimmedArgXpath) {\n        resolvedArgs = [`xpath=${trimmedArgXpath}`, ...args.slice(1)];\n      } else {\n        // Target element lookup failed, filter out this action\n        v3Logger({\n          category: \"action\",\n          message: \"dragAndDrop target element lookup failed\",\n          level: 1,\n          auxiliary: {\n            targetElementId: { value: targetArg, type: \"string\" },\n            sourceElementId: { value: elementId, type: \"string\" },\n          },\n        });\n        return undefined;\n      }\n    } else {\n      v3Logger({\n        category: \"action\",\n        message: \"dragAndDrop target element invalid ID format\",\n        level: 0,\n        auxiliary: {\n          targetElementId: { value: String(targetArg), type: \"string\" },\n          sourceElementId: { value: elementId, type: \"string\" },\n        },\n      });\n      return undefined;\n    }\n  }\n\n  return {\n    description,\n    method,\n    arguments: resolvedArgs,\n    selector: `xpath=${trimmed}`,\n  } as Action;\n}\n\nfunction substituteVariablesInArguments(\n  args: string[] | undefined,\n  variables?: Variables,\n): string[] | undefined {\n  if (!variables || !Array.isArray(args)) {\n    return args;\n  }\n\n  return args.map((arg: string) => {\n    let out = arg;\n    for (const [key, v] of Object.entries(variables)) {\n      const token = `%${key}%`;\n      out = out.split(token).join(resolveVariableValue(v));\n    }\n    return out;\n  });\n}\n"]}

package/dist/esm/lib/v3/handlers/extractHandler.js

@@ -43,8 +43,7 @@ export class ExtractHandler {
     async extract(params) {
         const { instruction, schema, page, selector, timeout, model } = params;
         const llmClient = this.resolveLlmClient(model);
-        const effectiveTimeoutMs = typeof timeout === "number" && timeout > 0 ? timeout : undefined;
-        const ensureTimeRemaining = createTimeoutGuard(effectiveTimeoutMs, (ms) => new ExtractTimeoutError(ms));
+        const ensureTimeRemaining = createTimeoutGuard(timeout, (ms) => new ExtractTimeoutError(ms));
         // No-args → page text (parity with v2)
         const noArgs = !instruction && !schema;
         if (noArgs) {
@@ -54,6 +53,7 @@ export class ExtractHandler {
                 experimental: this.experimental,
                 focusSelector: focusSelector || undefined,
             });
+            ensureTimeRemaining();
             const result = { pageText: snap.combinedTree };
             // Validate via the same schema used in v2
             return pageTextSchema.parse(result);