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

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

@@ -0,0 +1 @@
+{"version":3,"file":"AgentCache.js","sourceRoot":"","sources":["../../../../../lib/v3/cache/AgentCache.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 {\n  AgentReplayActStep,\n  AgentReplayFillFormStep,\n  AgentReplayGotoStep,\n  AgentReplayKeysStep,\n  AgentReplayNavBackStep,\n  AgentReplayScrollStep,\n  AgentReplayStep,\n  AgentReplayWaitStep,\n  CachedAgentEntry,\n  SanitizedAgentExecuteOptions,\n  ActFn,\n  AgentCacheContext,\n  AgentCacheDeps,\n  AgentCacheTransferPayload,\n} from \"../types/private/index.js\";\nimport type {\n  Action,\n  AgentResult,\n  AgentStreamResult,\n  AgentConfig,\n  AgentExecuteOptionsBase,\n  AvailableModel,\n  Logger,\n} from \"../types/public/index.js\";\nimport type { Page } from \"../understudy/page.js\";\nimport type { V3Context } from \"../understudy/context.js\";\nimport { CacheStorage } from \"./CacheStorage.js\";\nimport {\n  cloneForCache,\n  safeGetPageUrl,\n  waitForCachedSelector,\n} from \"./utils.js\";\n\nconst SENSITIVE_CONFIG_KEYS = new Set([\"apikey\", \"api_key\", \"api-key\"]);\n\nexport class AgentCache {\n  private readonly storage: CacheStorage;\n  private readonly logger: Logger;\n  private readonly getActHandler: () => ActHandler | null;\n  private readonly getContext: () => V3Context | null;\n  private readonly getDefaultLlmClient: () => LLMClient;\n  private readonly getBaseModelName: () => AvailableModel;\n  private readonly getSystemPrompt: () => string | undefined;\n  private readonly domSettleTimeoutMs?: number;\n  private readonly act: ActFn;\n  private readonly bufferLatestEntry: boolean;\n\n  private recording: AgentReplayStep[] | null = null;\n  private latestEntry: AgentCacheTransferPayload | null = null;\n\n  constructor({\n    storage,\n    logger,\n    getActHandler,\n    getContext,\n    getDefaultLlmClient,\n    getBaseModelName,\n    getSystemPrompt,\n    domSettleTimeoutMs,\n    act,\n    bufferLatestEntry,\n  }: AgentCacheDeps) {\n    this.storage = storage;\n    this.logger = logger;\n    this.getActHandler = getActHandler;\n    this.getContext = getContext;\n    this.getDefaultLlmClient = getDefaultLlmClient;\n    this.getBaseModelName = getBaseModelName;\n    this.getSystemPrompt = getSystemPrompt;\n    this.domSettleTimeoutMs = domSettleTimeoutMs;\n    this.act = act;\n    this.bufferLatestEntry = bufferLatestEntry ?? false;\n  }\n\n  get enabled(): boolean {\n    return this.storage.enabled;\n  }\n\n  shouldAttemptCache(instruction: string): boolean {\n    return this.enabled && instruction.trim().length > 0;\n  }\n\n  sanitizeExecuteOptions(\n    options?: AgentExecuteOptionsBase,\n  ): SanitizedAgentExecuteOptions {\n    if (!options) return {};\n    const sanitized: SanitizedAgentExecuteOptions = {};\n    if (typeof options.maxSteps === \"number\") {\n      sanitized.maxSteps = options.maxSteps;\n    }\n    if (\n      \"highlightCursor\" in options &&\n      typeof (options as { highlightCursor?: unknown }).highlightCursor ===\n        \"boolean\"\n    ) {\n      sanitized.highlightCursor = (\n        options as { highlightCursor?: boolean }\n      ).highlightCursor;\n    }\n    return sanitized;\n  }\n\n  buildConfigSignature(agentOptions?: AgentConfig): string {\n    const toolKeys = agentOptions?.tools\n      ? Object.keys(agentOptions.tools).sort()\n      : undefined;\n    const integrationSignatures = agentOptions?.integrations\n      ? agentOptions.integrations.map((integration) =>\n          typeof integration === \"string\" ? integration : \"client\",\n        )\n      : undefined;\n    const serializedModel = this.serializeAgentModelForCache(\n      agentOptions?.model,\n    );\n    const serializedExecutionModel = this.serializeAgentModelForCache(\n      agentOptions?.executionModel,\n    );\n\n    const isCuaMode =\n      agentOptions?.mode !== undefined\n        ? agentOptions.mode === \"cua\"\n        : agentOptions?.cua === true;\n\n    return JSON.stringify({\n      v3Model: this.getBaseModelName(),\n      systemPrompt: this.getSystemPrompt() ?? \"\",\n      agent: {\n        cua: isCuaMode,\n        model: serializedModel ?? null,\n        executionModel: isCuaMode ? null : serializedExecutionModel,\n        systemPrompt: agentOptions?.systemPrompt ?? null,\n        toolKeys,\n        integrations: integrationSignatures,\n      },\n    });\n  }\n\n  async prepareContext(params: {\n    instruction: string;\n    options: SanitizedAgentExecuteOptions;\n    configSignature: string;\n    page: Page;\n  }): Promise<AgentCacheContext | null> {\n    if (!this.shouldAttemptCache(params.instruction)) {\n      return null;\n    }\n    const instruction = params.instruction.trim();\n    const startUrl = await safeGetPageUrl(params.page);\n    const cacheKey = this.buildAgentCacheKey(\n      instruction,\n      startUrl,\n      params.options,\n      params.configSignature,\n    );\n    return {\n      instruction,\n      startUrl,\n      options: params.options,\n      configSignature: params.configSignature,\n      cacheKey,\n    };\n  }\n\n  async tryReplay(\n    context: AgentCacheContext,\n    llmClientOverride?: LLMClient,\n  ): Promise<AgentResult | null> {\n    if (!this.enabled) return null;\n\n    const {\n      value: entry,\n      error,\n      path,\n    } = await this.storage.readJson<CachedAgentEntry>(\n      `agent-${context.cacheKey}.json`,\n    );\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: `failed to read agent cache entry: ${path}`,\n        level: 1,\n        auxiliary: {\n          error: { value: String(error), type: \"string\" },\n        },\n      });\n      return null;\n    }\n    if (!entry || entry.version !== 1) {\n      return null;\n    }\n\n    this.logger({\n      category: \"cache\",\n      message: \"agent cache hit\",\n      level: 1,\n      auxiliary: {\n        instruction: { value: context.instruction, type: \"string\" },\n        url: { value: context.startUrl, type: \"string\" },\n      },\n    });\n\n    return await this.replayAgentCacheEntry(context, entry, llmClientOverride);\n  }\n\n  /**\n   * Attempts to replay a cached agent execution and returns it as a stream result.\n   *\n   * This method exists because the agent API exposes two execution modes:\n   * - `execute()` - Returns a Promise<AgentResult> directly\n   * - `stream()` - Returns an AgentStreamResult with async iterables for real-time output\n   *\n   * When a cache hit occurs, we need to return the appropriate type for each mode:\n   * - For `execute()`, we use `tryReplay()` which returns AgentResult\n   * - For `stream()`, we use `tryReplayAsStream()` which wraps the result in a\n   *   stream-compatible interface\n   *\n   * This ensures consumers using `stream()` can still iterate over `textStream`\n   * and await `result` even when the response comes from cache, maintaining\n   * API consistency regardless of whether the result was cached or live.\n   */\n  async tryReplayAsStream(\n    context: AgentCacheContext,\n    llmClientOverride?: LLMClient,\n  ): Promise<AgentStreamResult | null> {\n    const result = await this.tryReplay(context, llmClientOverride);\n    if (!result) return null;\n    return this.createCachedStreamResult(result);\n  }\n\n  /**\n   * Creates a mock AgentStreamResult that wraps a cached AgentResult.\n   *\n   * AgentStreamResult (from the AI SDK) is a complex type with multiple async\n   * iterables and promises. When serving from cache, we don't have an actual\n   * LLM stream to consume - we just have the final result. This method creates\n   * a \"fake\" stream\n\n   * This approach lets cached responses be transparent to the consumer -\n   * they can use the same iteration patterns whether the result is live or cached.\n   */\n  private createCachedStreamResult(\n    cachedResult: AgentResult,\n  ): AgentStreamResult {\n    const message = cachedResult.message ?? \"\";\n\n    async function* textStreamGenerator(): AsyncGenerator<string> {\n      yield message;\n    }\n\n    async function* fullStreamGenerator(): AsyncGenerator<{\n      type: string;\n      textDelta?: string;\n    }> {\n      yield { type: \"text-delta\", textDelta: message };\n      yield { type: \"finish\" };\n    }\n\n    const mockStreamResult = {\n      textStream: textStreamGenerator(),\n      fullStream: fullStreamGenerator(),\n      result: Promise.resolve(cachedResult),\n      text: Promise.resolve(message),\n      usage: Promise.resolve({\n        promptTokens: 0,\n        completionTokens: 0,\n        totalTokens: 0,\n      }),\n      finishReason: Promise.resolve(\"stop\" as const),\n      experimental_providerMetadata: Promise.resolve(undefined),\n      response: Promise.resolve({\n        id: \"cached\",\n        timestamp: new Date(),\n        modelId: \"cached\",\n      }),\n      rawResponse: Promise.resolve({ headers: {} }),\n      warnings: Promise.resolve([]),\n      steps: Promise.resolve([]),\n      toolCalls: Promise.resolve([]),\n      toolResults: Promise.resolve([]),\n      [Symbol.asyncIterator]: () => textStreamGenerator(),\n    } as unknown as AgentStreamResult;\n\n    return mockStreamResult;\n  }\n\n  /**\n   * Wraps an AgentStreamResult with caching logic.\n   *\n   * This method handles the complexity of caching for streaming responses:\n   * 1. Begins recording agent replay steps\n   * 2. Wraps the stream's result promise to capture completion\n   * 3. On success: ends recording and stores the cache entry\n   * 4. On error: discards the recording\n   *\n   * This keeps the caching orchestration in AgentCache rather than\n   * spreading it across the V3 class.\n   *\n   * @param context - The cache context for this execution\n   * @param streamResult - The stream result from the agent handler\n   * @param beginRecording - Callback to start recording (from V3)\n   * @param endRecording - Callback to end recording and get steps (from V3)\n   * @param discardRecording - Callback to discard recording on error (from V3)\n   * @returns The wrapped stream result with caching enabled\n   */\n  wrapStreamForCaching(\n    context: AgentCacheContext,\n    streamResult: AgentStreamResult,\n    beginRecording: () => void,\n    endRecording: () => AgentReplayStep[],\n    discardRecording: () => void,\n  ): AgentStreamResult {\n    beginRecording();\n\n    const originalResultPromise = streamResult.result;\n    const wrappedResultPromise = originalResultPromise.then(\n      async (result) => {\n        const agentSteps = endRecording();\n\n        if (result.success && agentSteps.length > 0) {\n          await this.store(context, agentSteps, result);\n        }\n\n        return result;\n      },\n      (error) => {\n        discardRecording();\n        throw error;\n      },\n    );\n\n    streamResult.result = wrappedResultPromise;\n    return streamResult;\n  }\n\n  async store(\n    context: AgentCacheContext,\n    steps: AgentReplayStep[],\n    result: AgentResult,\n  ): Promise<void> {\n    if (!this.enabled) return;\n\n    const entry: CachedAgentEntry = {\n      version: 1,\n      instruction: context.instruction,\n      startUrl: context.startUrl,\n      options: context.options,\n      configSignature: context.configSignature,\n      steps: cloneForCache(steps),\n      result: this.pruneAgentResult(result),\n      timestamp: new Date().toISOString(),\n    };\n\n    const { error, path } = await this.storage.writeJson(\n      `agent-${context.cacheKey}.json`,\n      entry,\n    );\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: \"failed to write agent 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: \"agent cache stored\",\n      level: 2,\n      auxiliary: {\n        instruction: { value: context.instruction, type: \"string\" },\n        steps: { value: String(steps.length), type: \"string\" },\n      },\n    });\n\n    if (this.bufferLatestEntry) {\n      this.latestEntry = {\n        cacheKey: context.cacheKey,\n        entry: cloneForCache(entry),\n      };\n    }\n  }\n\n  consumeBufferedEntry(): AgentCacheTransferPayload | null {\n    if (!this.bufferLatestEntry || !this.latestEntry) {\n      return null;\n    }\n\n    const payload = this.latestEntry;\n    this.latestEntry = null;\n    return payload;\n  }\n\n  async storeTransferredEntry(\n    payload: AgentCacheTransferPayload | null,\n  ): Promise<void> {\n    if (!this.enabled || !payload) return;\n\n    const entry = cloneForCache(payload.entry);\n    const { error, path } = await this.storage.writeJson(\n      `agent-${payload.cacheKey}.json`,\n      entry,\n    );\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: \"failed to import remote agent cache entry\",\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: \"agent cache imported from server\",\n      level: 2,\n      auxiliary: {\n        instruction: { value: entry.instruction, type: \"string\" },\n        steps: { value: String(entry.steps?.length ?? 0), type: \"string\" },\n      },\n    });\n  }\n\n  /**\n   * Clone the agent result and prune bulky fields (e.g. screenshot base64 blobs)\n   * before persisting it to disk. This keeps cache entries compact without\n   * mutating the live AgentResult returned to callers.\n   */\n  private pruneAgentResult(result: AgentResult): AgentResult {\n    const cloned = cloneForCache(result);\n    if (!Array.isArray(cloned.actions)) {\n      return cloned;\n    }\n\n    for (const action of cloned.actions) {\n      if (action?.type === \"screenshot\") {\n        delete action.base64;\n      }\n    }\n\n    return cloned;\n  }\n\n  beginRecording(): void {\n    this.recording = [];\n  }\n\n  endRecording(): AgentReplayStep[] {\n    if (!this.recording) return [];\n    const steps = cloneForCache(this.recording);\n    this.recording = null;\n    return steps;\n  }\n\n  discardRecording(): void {\n    this.recording = null;\n  }\n\n  isRecording(): boolean {\n    return Array.isArray(this.recording);\n  }\n\n  recordStep(step: AgentReplayStep): void {\n    if (!this.isRecording()) return;\n    try {\n      this.recording!.push(cloneForCache(step));\n    } catch (err) {\n      this.logger({\n        category: \"cache\",\n        message: \"failed to record agent replay step\",\n        level: 2,\n        auxiliary: {\n          error: { value: String(err), type: \"string\" },\n        },\n      });\n    }\n  }\n\n  isReplayActive(): boolean {\n    return this.isRecording();\n  }\n\n  private serializeAgentModelForCache(\n    model?: AgentConfig[\"model\"],\n  ): null | string | { modelName: string; options?: Record<string, unknown> } {\n    if (!model) return null;\n    if (typeof model === \"string\") return model;\n\n    const { modelName, ...modelOptions } = model;\n    const sanitizedOptions =\n      Object.keys(modelOptions).length > 0\n        ? this.sanitizeModelOptionsForCache(\n            modelOptions as Record<string, unknown>,\n          )\n        : undefined;\n    return sanitizedOptions\n      ? { modelName, options: sanitizedOptions }\n      : modelName;\n  }\n\n  private buildAgentCacheKey(\n    instruction: string,\n    startUrl: string,\n    options: SanitizedAgentExecuteOptions,\n    configSignature: string,\n  ): string {\n    const payload = {\n      instruction,\n      startUrl,\n      options,\n      configSignature,\n    };\n    return createHash(\"sha256\").update(JSON.stringify(payload)).digest(\"hex\");\n  }\n\n  private sanitizeModelOptionsForCache(\n    value: Record<string, unknown>,\n  ): Record<string, unknown> | undefined {\n    const sanitizedEntries: Record<string, unknown> = {};\n    for (const [key, rawValue] of Object.entries(value)) {\n      if (SENSITIVE_CONFIG_KEYS.has(key.toLowerCase())) {\n        continue;\n      }\n\n      const sanitizedValue = this.sanitizeModelValueForCache(rawValue);\n      if (sanitizedValue !== undefined) {\n        sanitizedEntries[key] = sanitizedValue;\n      }\n    }\n\n    return Object.keys(sanitizedEntries).length > 0\n      ? sanitizedEntries\n      : undefined;\n  }\n\n  private sanitizeModelValueForCache(value: unknown): unknown {\n    if (Array.isArray(value)) {\n      const sanitizedArray = value\n        .map((item) => this.sanitizeModelValueForCache(item))\n        .filter((item) => item !== undefined);\n      return sanitizedArray;\n    }\n\n    if (value && typeof value === \"object\") {\n      return this.sanitizeModelOptionsForCache(\n        value as Record<string, unknown>,\n      );\n    }\n\n    return value;\n  }\n\n  private async replayAgentCacheEntry(\n    context: AgentCacheContext,\n    entry: CachedAgentEntry,\n    llmClientOverride?: LLMClient,\n  ): Promise<AgentResult | null> {\n    const ctx = this.getContext();\n    const handler = this.getActHandler();\n    if (!ctx || !handler) return null;\n    const effectiveClient = llmClientOverride ?? this.getDefaultLlmClient();\n    try {\n      const updatedSteps: AgentReplayStep[] = [];\n      let stepsChanged = false;\n      for (const step of entry.steps ?? []) {\n        const replayedStep =\n          (await this.executeAgentReplayStep(\n            step,\n            ctx,\n            handler,\n            effectiveClient,\n          )) ?? step;\n        stepsChanged ||= replayedStep !== step;\n        updatedSteps.push(replayedStep);\n      }\n      const result = cloneForCache(entry.result);\n      result.usage = {\n        input_tokens: 0,\n        output_tokens: 0,\n        reasoning_tokens: 0,\n        cached_input_tokens: 0,\n        inference_time_ms: 0,\n      };\n      result.metadata = {\n        ...(result.metadata ?? {}),\n        cacheHit: true,\n        cacheTimestamp: entry.timestamp,\n      };\n      if (stepsChanged) {\n        await this.refreshAgentCacheEntry(context, entry, updatedSteps);\n      }\n      return result;\n    } catch (err) {\n      this.logger({\n        category: \"cache\",\n        message: \"agent cache replay failed\",\n        level: 1,\n        auxiliary: {\n          error: { value: String(err), type: \"string\" },\n        },\n      });\n      return null;\n    }\n  }\n\n  private async executeAgentReplayStep(\n    step: AgentReplayStep,\n    ctx: V3Context,\n    handler: ActHandler,\n    llmClient: LLMClient,\n  ): Promise<AgentReplayStep> {\n    switch (step.type) {\n      case \"act\":\n        return await this.replayAgentActStep(\n          step as AgentReplayActStep,\n          ctx,\n          handler,\n          llmClient,\n        );\n      case \"fillForm\":\n        return await this.replayAgentFillFormStep(\n          step as AgentReplayFillFormStep,\n          ctx,\n          handler,\n          llmClient,\n        );\n      case \"goto\":\n        await this.replayAgentGotoStep(step as AgentReplayGotoStep, ctx);\n        return step;\n      case \"scroll\":\n        await this.replayAgentScrollStep(step as AgentReplayScrollStep, ctx);\n        return step;\n      case \"wait\":\n        await this.replayAgentWaitStep(step as AgentReplayWaitStep);\n        return step;\n      case \"navback\":\n        await this.replayAgentNavBackStep(step as AgentReplayNavBackStep, ctx);\n        return step;\n      case \"keys\":\n        await this.replayAgentKeysStep(step as AgentReplayKeysStep, ctx);\n        return step;\n      case \"done\":\n      case \"extract\":\n      case \"screenshot\":\n      case \"ariaTree\":\n        return step;\n      default:\n        this.logger({\n          category: \"cache\",\n          message: `agent cache skipping step type: ${step.type}`,\n          level: 2,\n        });\n        return step;\n    }\n  }\n\n  private async replayAgentActStep(\n    step: AgentReplayActStep,\n    ctx: V3Context,\n    handler: ActHandler,\n    llmClient: LLMClient,\n  ): Promise<AgentReplayActStep> {\n    const actions = Array.isArray(step.actions) ? step.actions : [];\n    if (actions.length > 0) {\n      const page = await ctx.awaitActivePage();\n      const updatedActions: Action[] = [];\n      for (const action of actions) {\n        await waitForCachedSelector({\n          page,\n          selector: action.selector,\n          timeout: this.domSettleTimeoutMs,\n          logger: this.logger,\n          context: \"agent act\",\n        });\n        const result = await handler.takeDeterministicAction(\n          action,\n          page,\n          this.domSettleTimeoutMs,\n          llmClient,\n        );\n        if (result.success && Array.isArray(result.actions)) {\n          updatedActions.push(...cloneForCache(result.actions));\n        } else {\n          updatedActions.push(cloneForCache(action));\n        }\n      }\n      if (this.haveActionsChanged(actions, updatedActions)) {\n        return { ...step, actions: updatedActions };\n      }\n      return step;\n    }\n    await this.act(step.instruction, { timeout: step.timeout });\n    return step;\n  }\n\n  private async replayAgentFillFormStep(\n    step: AgentReplayFillFormStep,\n    ctx: V3Context,\n    handler: ActHandler,\n    llmClient: LLMClient,\n  ): Promise<AgentReplayFillFormStep> {\n    const actions =\n      Array.isArray(step.actions) && step.actions.length > 0\n        ? step.actions\n        : (step.observeResults ?? []);\n    if (!Array.isArray(actions) || actions.length === 0) {\n      return step;\n    }\n    const page = await ctx.awaitActivePage();\n    const updatedActions: Action[] = [];\n    for (const action of actions) {\n      await waitForCachedSelector({\n        page,\n        selector: action.selector,\n        timeout: this.domSettleTimeoutMs,\n        logger: this.logger,\n        context: \"fillForm\",\n      });\n      const result = await handler.takeDeterministicAction(\n        action,\n        page,\n        this.domSettleTimeoutMs,\n        llmClient,\n      );\n      if (result.success && Array.isArray(result.actions)) {\n        updatedActions.push(...cloneForCache(result.actions));\n      } else {\n        updatedActions.push(cloneForCache(action));\n      }\n    }\n    if (this.haveActionsChanged(actions, updatedActions)) {\n      return { ...step, actions: updatedActions };\n    }\n    return step;\n  }\n\n  private async replayAgentGotoStep(\n    step: AgentReplayGotoStep,\n    ctx: V3Context,\n  ): Promise<void> {\n    const page = await ctx.awaitActivePage();\n    await page.goto(step.url, { waitUntil: step.waitUntil ?? \"load\" });\n  }\n\n  private async replayAgentScrollStep(\n    step: AgentReplayScrollStep,\n    ctx: V3Context,\n  ): Promise<void> {\n    const page = await ctx.awaitActivePage();\n    let anchor = step.anchor;\n    if (!anchor) {\n      anchor = await page\n        .mainFrame()\n        .evaluate<{ x: number; y: number }>(() => ({\n          x: Math.max(0, Math.floor(window.innerWidth / 2)),\n          y: Math.max(0, Math.floor(window.innerHeight / 2)),\n        }));\n    }\n    const deltaX = step.deltaX ?? 0;\n    const deltaY = step.deltaY ?? 0;\n    await page.scroll(\n      Math.round(anchor.x ?? 0),\n      Math.round(anchor.y ?? 0),\n      deltaX,\n      deltaY,\n    );\n  }\n\n  private async replayAgentWaitStep(step: AgentReplayWaitStep): Promise<void> {\n    if (!step.timeMs || step.timeMs <= 0) return;\n    await new Promise((resolve) => setTimeout(resolve, step.timeMs));\n  }\n\n  private async replayAgentNavBackStep(\n    step: AgentReplayNavBackStep,\n    ctx: V3Context,\n  ): Promise<void> {\n    const page = await ctx.awaitActivePage();\n    await page.goBack({ waitUntil: step.waitUntil ?? \"domcontentloaded\" });\n  }\n\n  private async replayAgentKeysStep(\n    step: AgentReplayKeysStep,\n    ctx: V3Context,\n  ): Promise<void> {\n    const page = await ctx.awaitActivePage();\n    const { method, text, keys, times } = step.playwrightArguments;\n    const repeatCount = Math.max(1, times ?? 1);\n\n    if (method === \"type\" && text) {\n      for (let i = 0; i < repeatCount; i++) {\n        await page.type(text, { delay: 100 });\n      }\n    } else if (method === \"press\" && keys) {\n      for (let i = 0; i < repeatCount; i++) {\n        await page.keyPress(keys, { delay: 100 });\n      }\n    }\n  }\n\n  private haveActionsChanged(original: Action[], updated: Action[]): boolean {\n    if (original.length !== updated.length) {\n      return true;\n    }\n    for (let i = 0; i < original.length; i += 1) {\n      const orig = original[i];\n      const next = updated[i];\n      if (!orig || !next) {\n        return true;\n      }\n      if (orig.selector !== next.selector) {\n        return true;\n      }\n      if ((orig.description ?? \"\") !== (next.description ?? \"\")) {\n        return true;\n      }\n      if ((orig.method ?? \"\") !== (next.method ?? \"\")) {\n        return true;\n      }\n      const origArgs = Array.isArray(orig.arguments) ? orig.arguments : [];\n      const nextArgs = Array.isArray(next.arguments) ? next.arguments : [];\n      if (origArgs.length !== nextArgs.length) {\n        return true;\n      }\n      for (let j = 0; j < origArgs.length; j += 1) {\n        if (origArgs[j] !== nextArgs[j]) {\n          return true;\n        }\n      }\n    }\n    return false;\n  }\n\n  private async refreshAgentCacheEntry(\n    context: AgentCacheContext,\n    entry: CachedAgentEntry,\n    updatedSteps: AgentReplayStep[],\n  ): Promise<void> {\n    const updatedEntry: CachedAgentEntry = {\n      ...entry,\n      steps: cloneForCache(updatedSteps),\n      timestamp: new Date().toISOString(),\n    };\n    const { error, path } = await this.storage.writeJson(\n      `agent-${context.cacheKey}.json`,\n      updatedEntry,\n    );\n    if (error && path) {\n      this.logger({\n        category: \"cache\",\n        message: \"failed to update agent cache entry after self-heal\",\n        level: 0,\n        auxiliary: {\n          error: { value: String(error), type: \"string\" },\n        },\n      });\n      return;\n    }\n    this.logger({\n      category: \"cache\",\n      message: \"agent cache entry updated after self-heal\",\n      level: 2,\n      auxiliary: {\n        instruction: { value: context.instruction, type: \"string\" },\n        steps: { value: String(updatedSteps.length), type: \"string\" },\n      },\n    });\n  }\n}\n"]}

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

@@ -0,0 +1,17 @@
+import type { Logger } from "../types/public/index.js";
+import { ReadJsonResult, WriteJsonResult } from "../types/private/index.js";
+export declare class CacheStorage {
+    private readonly logger;
+    private readonly dir?;
+    private readonly memoryStore?;
+    private constructor();
+    static create(cacheDir: string | undefined, logger: Logger, options?: {
+        label?: string;
+    }): CacheStorage;
+    static createMemory(logger: Logger): CacheStorage;
+    get directory(): string | undefined;
+    get enabled(): boolean;
+    private resolvePath;
+    readJson<T>(fileName: string): Promise<ReadJsonResult<T>>;
+    writeJson(fileName: string, data: unknown): Promise<WriteJsonResult>;
+}

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

@@ -0,0 +1,98 @@
+import fs from "fs";
+import path from "path";
+const jsonClone = (value) => {
+    const serialized = JSON.stringify(value);
+    if (serialized === undefined) {
+        return value;
+    }
+    return JSON.parse(serialized);
+};
+export class CacheStorage {
+    logger;
+    dir;
+    memoryStore;
+    constructor(logger, dir, memoryStore) {
+        this.logger = logger;
+        this.dir = dir;
+        this.memoryStore = memoryStore;
+    }
+    static create(cacheDir, logger, options) {
+        if (!cacheDir) {
+            return new CacheStorage(logger);
+        }
+        const resolved = path.resolve(cacheDir);
+        try {
+            fs.mkdirSync(resolved, { recursive: true });
+            return new CacheStorage(logger, resolved);
+        }
+        catch (err) {
+            const label = options?.label ?? "cache directory";
+            logger({
+                category: "cache",
+                message: `unable to initialize ${label}: ${resolved}`,
+                level: 1,
+                auxiliary: {
+                    error: { value: String(err), type: "string" },
+                },
+            });
+            return new CacheStorage(logger);
+        }
+    }
+    static createMemory(logger) {
+        return new CacheStorage(logger, undefined, new Map());
+    }
+    get directory() {
+        return this.dir;
+    }
+    get enabled() {
+        return !!this.dir || !!this.memoryStore;
+    }
+    resolvePath(fileName) {
+        if (!this.dir)
+            return null;
+        return path.join(this.dir, fileName);
+    }
+    async readJson(fileName) {
+        if (this.memoryStore) {
+            if (!this.memoryStore.has(fileName)) {
+                return { value: null };
+            }
+            const existing = this.memoryStore.get(fileName);
+            return { value: jsonClone(existing) };
+        }
+        const filePath = this.resolvePath(fileName);
+        if (!filePath) {
+            return { value: null };
+        }
+        try {
+            const raw = await fs.promises.readFile(filePath, "utf8");
+            return { value: JSON.parse(raw) };
+        }
+        catch (err) {
+            const code = err?.code;
+            if (code === "ENOENT") {
+                return { value: null };
+            }
+            return { value: null, error: err, path: filePath };
+        }
+    }
+    async writeJson(fileName, data) {
+        if (this.memoryStore) {
+            this.memoryStore.set(fileName, jsonClone(data));
+            return {};
+        }
+        const filePath = this.resolvePath(fileName);
+        if (!filePath) {
+            return {};
+        }
+        try {
+            await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+            await fs.promises.writeFile(filePath, JSON.stringify(data, null, 2), "utf8");
+            return {};
+        }
+        catch (err) {
+            return { error: err, path: filePath };
+        }
+    }
+}
+//# sourceMappingURL=CacheStorage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheStorage.js","sourceRoot":"","sources":["../../../../../lib/v3/cache/CacheStorage.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport type { Logger } from \"../types/public/index.js\";\nimport { ReadJsonResult, WriteJsonResult } from \"../types/private/index.js\";\n\nconst jsonClone = <T>(value: T): T => {\n  const serialized = JSON.stringify(value);\n  if (serialized === undefined) {\n    return value;\n  }\n  return JSON.parse(serialized) as T;\n};\n\nexport class CacheStorage {\n  private constructor(\n    private readonly logger: Logger,\n    private readonly dir?: string,\n    private readonly memoryStore?: Map<string, unknown>,\n  ) {}\n\n  static create(\n    cacheDir: string | undefined,\n    logger: Logger,\n    options?: { label?: string },\n  ): CacheStorage {\n    if (!cacheDir) {\n      return new CacheStorage(logger);\n    }\n\n    const resolved = path.resolve(cacheDir);\n    try {\n      fs.mkdirSync(resolved, { recursive: true });\n      return new CacheStorage(logger, resolved);\n    } catch (err) {\n      const label = options?.label ?? \"cache directory\";\n      logger({\n        category: \"cache\",\n        message: `unable to initialize ${label}: ${resolved}`,\n        level: 1,\n        auxiliary: {\n          error: { value: String(err), type: \"string\" },\n        },\n      });\n      return new CacheStorage(logger);\n    }\n  }\n\n  static createMemory(logger: Logger): CacheStorage {\n    return new CacheStorage(logger, undefined, new Map());\n  }\n\n  get directory(): string | undefined {\n    return this.dir;\n  }\n\n  get enabled(): boolean {\n    return !!this.dir || !!this.memoryStore;\n  }\n\n  private resolvePath(fileName: string): string | null {\n    if (!this.dir) return null;\n    return path.join(this.dir, fileName);\n  }\n\n  async readJson<T>(fileName: string): Promise<ReadJsonResult<T>> {\n    if (this.memoryStore) {\n      if (!this.memoryStore.has(fileName)) {\n        return { value: null };\n      }\n      const existing = this.memoryStore.get(fileName) as T;\n      return { value: jsonClone(existing) };\n    }\n\n    const filePath = this.resolvePath(fileName);\n    if (!filePath) {\n      return { value: null };\n    }\n\n    try {\n      const raw = await fs.promises.readFile(filePath, \"utf8\");\n      return { value: JSON.parse(raw) as T };\n    } catch (err) {\n      const code = (err as NodeJS.ErrnoException)?.code;\n      if (code === \"ENOENT\") {\n        return { value: null };\n      }\n      return { value: null, error: err, path: filePath };\n    }\n  }\n\n  async writeJson(fileName: string, data: unknown): Promise<WriteJsonResult> {\n    if (this.memoryStore) {\n      this.memoryStore.set(fileName, jsonClone(data));\n      return {};\n    }\n\n    const filePath = this.resolvePath(fileName);\n    if (!filePath) {\n      return {};\n    }\n\n    try {\n      await fs.promises.mkdir(path.dirname(filePath), { recursive: true });\n      await fs.promises.writeFile(\n        filePath,\n        JSON.stringify(data, null, 2),\n        \"utf8\",\n      );\n      return {};\n    } catch (err) {\n      return { error: err, path: filePath };\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,7 @@
+import type { V3 } from "../v3.js";
+import type { AgentCacheTransferPayload } from "../types/private/index.js";
+export interface ServerAgentCacheHandle {
+    complete(): AgentCacheTransferPayload | null;
+    discard(): void;
+}
+export declare function __internalCreateInMemoryAgentCacheHandle(stagehand: V3): ServerAgentCacheHandle;

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

@@ -0,0 +1,49 @@
+import { AgentCache } from "./AgentCache.js";
+import { CacheStorage } from "./CacheStorage.js";
+// TODO (refactor-caching): this reflective access is a known temporary escape hatch.
+// Once the caching internals are reworked, replace it with proper V3 helpers so
+// we stop poking private fields from the outside.
+function getInternalField(instance, key) {
+    return instance[key];
+}
+function setInternalField(instance, key, value) {
+    instance[key] = value;
+}
+function createMemoryAgentCache(stagehand) {
+    const resolveLlmClient = getInternalField(stagehand, "resolveLlmClient");
+    return new AgentCache({
+        storage: CacheStorage.createMemory(stagehand.logger),
+        logger: stagehand.logger,
+        getActHandler: () => getInternalField(stagehand, "actHandler"),
+        getContext: () => getInternalField(stagehand, "ctx"),
+        getDefaultLlmClient: () => resolveLlmClient.call(stagehand),
+        getBaseModelName: () => getInternalField(stagehand, "modelName"),
+        getSystemPrompt: () => getInternalField(stagehand, "opts").systemPrompt,
+        domSettleTimeoutMs: getInternalField(stagehand, "domSettleTimeoutMs"),
+        act: stagehand.act.bind(stagehand),
+        bufferLatestEntry: true,
+    });
+}
+export function __internalCreateInMemoryAgentCacheHandle(stagehand) {
+    const originalCache = getInternalField(stagehand, "agentCache");
+    const memoryCache = createMemoryAgentCache(stagehand);
+    setInternalField(stagehand, "agentCache", memoryCache);
+    let restored = false;
+    const restore = () => {
+        if (!restored) {
+            setInternalField(stagehand, "agentCache", originalCache);
+            restored = true;
+        }
+    };
+    return {
+        complete: () => {
+            const entry = memoryCache.consumeBufferedEntry();
+            restore();
+            return entry;
+        },
+        discard: () => {
+            restore();
+        },
+    };
+}
+//# sourceMappingURL=serverAgentCache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serverAgentCache.js","sourceRoot":"","sources":["../../../../../lib/v3/cache/serverAgentCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAcjD,qFAAqF;AACrF,gFAAgF;AAChF,kDAAkD;AAClD,SAAS,gBAAgB,CAAI,QAAY,EAAE,GAAW;IACpD,OAAQ,QAA+C,CAAC,GAAG,CAAM,CAAC;AACpE,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAY,EAAE,GAAW,EAAE,KAAc;IAChE,QAA+C,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAChE,CAAC;AAED,SAAS,sBAAsB,CAAC,SAAa;IAC3C,MAAM,gBAAgB,GAAG,gBAAgB,CAEvC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAEjC,OAAO,IAAI,UAAU,CAAC;QACpB,OAAO,EAAE,YAAY,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC;QACpD,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,aAAa,EAAE,GAAG,EAAE,CAClB,gBAAgB,CAAoB,SAAS,EAAE,YAAY,CAAC;QAC9D,UAAU,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAmB,SAAS,EAAE,KAAK,CAAC;QACtE,mBAAmB,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3D,gBAAgB,EAAE,GAAG,EAAE,CACrB,gBAAgB,CAAiB,SAAS,EAAE,WAAW,CAAC;QAC1D,eAAe,EAAE,GAAG,EAAE,CACpB,gBAAgB,CAAY,SAAS,EAAE,MAAM,CAAC,CAAC,YAAY;QAC7D,kBAAkB,EAAE,gBAAgB,CAClC,SAAS,EACT,oBAAoB,CACrB;QACD,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;QAClC,iBAAiB,EAAE,IAAI;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,SAAa;IAEb,MAAM,aAAa,GAAG,gBAAgB,CAAa,SAAS,EAAE,YAAY,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAEtD,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IACvD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;YACzD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE;YACb,MAAM,KAAK,GAAG,WAAW,CAAC,oBAAoB,EAAE,CAAC;YACjD,OAAO,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { AgentCache } from \"./AgentCache.js\";\nimport { CacheStorage } from \"./CacheStorage.js\";\nimport type { V3 } from \"../v3.js\";\nimport type { AgentCacheTransferPayload } from \"../types/private/index.js\";\nimport type { ActHandler } from \"../handlers/actHandler.js\";\nimport type { V3Context } from \"../understudy/context.js\";\nimport type { AvailableModel, V3Options } from \"../types/public/index.js\";\nimport type { ModelConfiguration } from \"../types/public/model.js\";\nimport type { LLMClient } from \"../llm/LLMClient.js\";\n\nexport interface ServerAgentCacheHandle {\n  complete(): AgentCacheTransferPayload | null;\n  discard(): void;\n}\n\n// TODO (refactor-caching): this reflective access is a known temporary escape hatch.\n// Once the caching internals are reworked, replace it with proper V3 helpers so\n// we stop poking private fields from the outside.\nfunction getInternalField<T>(instance: V3, key: string): T {\n  return (instance as unknown as Record<string, unknown>)[key] as T;\n}\n\nfunction setInternalField(instance: V3, key: string, value: unknown): void {\n  (instance as unknown as Record<string, unknown>)[key] = value;\n}\n\nfunction createMemoryAgentCache(stagehand: V3): AgentCache {\n  const resolveLlmClient = getInternalField<\n    (model?: ModelConfiguration) => LLMClient\n  >(stagehand, \"resolveLlmClient\");\n\n  return new AgentCache({\n    storage: CacheStorage.createMemory(stagehand.logger),\n    logger: stagehand.logger,\n    getActHandler: () =>\n      getInternalField<ActHandler | null>(stagehand, \"actHandler\"),\n    getContext: () => getInternalField<V3Context | null>(stagehand, \"ctx\"),\n    getDefaultLlmClient: () => resolveLlmClient.call(stagehand),\n    getBaseModelName: () =>\n      getInternalField<AvailableModel>(stagehand, \"modelName\"),\n    getSystemPrompt: () =>\n      getInternalField<V3Options>(stagehand, \"opts\").systemPrompt,\n    domSettleTimeoutMs: getInternalField<number | undefined>(\n      stagehand,\n      \"domSettleTimeoutMs\",\n    ),\n    act: stagehand.act.bind(stagehand),\n    bufferLatestEntry: true,\n  });\n}\n\nexport function __internalCreateInMemoryAgentCacheHandle(\n  stagehand: V3,\n): ServerAgentCacheHandle {\n  const originalCache = getInternalField<AgentCache>(stagehand, \"agentCache\");\n  const memoryCache = createMemoryAgentCache(stagehand);\n\n  setInternalField(stagehand, \"agentCache\", memoryCache);\n  let restored = false;\n  const restore = () => {\n    if (!restored) {\n      setInternalField(stagehand, \"agentCache\", originalCache);\n      restored = true;\n    }\n  };\n\n  return {\n    complete: () => {\n      const entry = memoryCache.consumeBufferedEntry();\n      restore();\n      return entry;\n    },\n    discard: () => {\n      restore();\n    },\n  };\n}\n"]}

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

@@ -0,0 +1,15 @@
+import type { Logger } from "../types/public/index.js";
+import { Page } from "../understudy/page.js";
+export declare function cloneForCache<T>(value: T): T;
+export declare function safeGetPageUrl(page: Page): Promise<string>;
+/**
+ * Waits for a cached action's selector to be attached to the DOM before executing.
+ * Logs a warning and proceeds if the wait times out (non-blocking).
+ */
+export declare function waitForCachedSelector(params: {
+    page: Page;
+    selector: string | undefined;
+    timeout: number | undefined;
+    logger: Logger;
+    context?: string;
+}): Promise<void>;

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

@@ -0,0 +1,39 @@
+const DEFAULT_WAIT_TIMEOUT_MS = 15000;
+export function cloneForCache(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+export async function safeGetPageUrl(page) {
+    try {
+        return page.url();
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Waits for a cached action's selector to be attached to the DOM before executing.
+ * Logs a warning and proceeds if the wait times out (non-blocking).
+ */
+export async function waitForCachedSelector(params) {
+    const { page, selector, timeout, logger, context } = params;
+    if (!selector)
+        return;
+    try {
+        await page.waitForSelector(selector, {
+            state: "attached",
+            timeout: timeout ?? DEFAULT_WAIT_TIMEOUT_MS,
+        });
+    }
+    catch (err) {
+        logger({
+            category: "cache",
+            message: `waitForSelector failed for ${context ?? "cached"} action selector, proceeding anyway`,
+            level: 2,
+            auxiliary: {
+                selector: { value: selector, type: "string" },
+                error: { value: String(err), type: "string" },
+            },
+        });
+    }
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../lib/v3/cache/utils.ts"],"names":[],"mappings":"AAGA,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAEtC,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAU;IAC7C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAM3C;IACC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC5D,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE;YACnC,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,OAAO,IAAI,uBAAuB;SAC5C,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC;YACL,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,8BAA8B,OAAO,IAAI,QAAQ,qCAAqC;YAC/F,KAAK,EAAE,CAAC;YACR,SAAS,EAAE;gBACT,QAAQ,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC7C,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC9C;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC","sourcesContent":["import type { Logger } from \"../types/public/index.js\";\nimport { Page } from \"../understudy/page.js\";\n\nconst DEFAULT_WAIT_TIMEOUT_MS = 15000;\n\nexport function cloneForCache<T>(value: T): T {\n  return JSON.parse(JSON.stringify(value)) as T;\n}\n\nexport async function safeGetPageUrl(page: Page): Promise<string> {\n  try {\n    return page.url();\n  } catch {\n    return \"\";\n  }\n}\n\n/**\n * Waits for a cached action's selector to be attached to the DOM before executing.\n * Logs a warning and proceeds if the wait times out (non-blocking).\n */\nexport async function waitForCachedSelector(params: {\n  page: Page;\n  selector: string | undefined;\n  timeout: number | undefined;\n  logger: Logger;\n  context?: string;\n}): Promise<void> {\n  const { page, selector, timeout, logger, context } = params;\n  if (!selector) return;\n\n  try {\n    await page.waitForSelector(selector, {\n      state: \"attached\",\n      timeout: timeout ?? DEFAULT_WAIT_TIMEOUT_MS,\n    });\n  } catch (err) {\n    logger({\n      category: \"cache\",\n      message: `waitForSelector failed for ${context ?? \"cached\"} action selector, proceeding anyway`,\n      level: 2,\n      auxiliary: {\n        selector: { value: selector, type: \"string\" },\n        error: { value: String(err), type: \"string\" },\n      },\n    });\n  }\n}\n"]}

package/dist/esm/lib/v3/dom/a11yScripts/index.d.ts

@@ -0,0 +1,11 @@
+export declare function getScrollOffsets(): {
+    sx: number;
+    sy: number;
+};
+export declare function getBoundingRectLite(this: Element): {
+    left: number;
+    top: number;
+};
+export declare function resolveDeepActiveElement(): Element | null;
+export declare function nodeToAbsoluteXPath(this: Node | null | undefined): string;
+export declare function documentHasFocusStrict(): boolean;

package/dist/esm/lib/v3/dom/a11yScripts/index.js

@@ -0,0 +1,117 @@
+export function getScrollOffsets() {
+    try {
+        const sx = window.scrollX ??
+            window.pageXOffset ??
+            document.documentElement?.scrollLeft ??
+            0;
+        const sy = window.scrollY ??
+            window.pageYOffset ??
+            document.documentElement?.scrollTop ??
+            0;
+        return { sx: Number(sx) || 0, sy: Number(sy) || 0 };
+    }
+    catch {
+        return { sx: 0, sy: 0 };
+    }
+}
+export function getBoundingRectLite() {
+    try {
+        const rect = this.getBoundingClientRect();
+        return {
+            left: Number(rect?.left ?? 0) || 0,
+            top: Number(rect?.top ?? 0) || 0,
+        };
+    }
+    catch {
+        return { left: 0, top: 0 };
+    }
+}
+export function resolveDeepActiveElement() {
+    try {
+        const deepActive = (doc) => {
+            let el = doc.activeElement ?? null;
+            while (el && el.shadowRoot && el.shadowRoot.activeElement) {
+                el = el.shadowRoot.activeElement;
+            }
+            return el ?? null;
+        };
+        return deepActive(document);
+    }
+    catch {
+        return null;
+    }
+}
+export function nodeToAbsoluteXPath() {
+    const compute = (node) => {
+        try {
+            const sibIndex = (n) => {
+                if (!n || !n.parentNode)
+                    return 1;
+                let i = 1;
+                const targetKey = `${n.nodeType}:${(n.nodeName || "").toLowerCase()}`;
+                for (let p = n.previousSibling; p; p = p.previousSibling) {
+                    const key = `${p.nodeType}:${(p.nodeName || "").toLowerCase()}`;
+                    if (key === targetKey)
+                        i += 1;
+                }
+                return i;
+            };
+            const step = (n) => {
+                if (!n)
+                    return "";
+                if (n.nodeType === Node.DOCUMENT_NODE)
+                    return "";
+                if (n.nodeType === Node.DOCUMENT_FRAGMENT_NODE)
+                    return "//";
+                if (n.nodeType === Node.TEXT_NODE)
+                    return `text()[${sibIndex(n)}]`;
+                if (n.nodeType === Node.COMMENT_NODE)
+                    return `comment()[${sibIndex(n)}]`;
+                const tag = (n.nodeName || "").toLowerCase();
+                const name = tag.includes(":") ? `*[name()='${tag}']` : tag;
+                return `${name}[${sibIndex(n)}]`;
+            };
+            const parts = [];
+            let cur = node;
+            while (cur) {
+                if (cur.nodeType === Node.DOCUMENT_FRAGMENT_NODE) {
+                    parts.push("//");
+                    cur = cur.host ?? null;
+                    continue;
+                }
+                const s = step(cur);
+                if (s)
+                    parts.push(s);
+                cur = cur.parentNode;
+            }
+            parts.reverse();
+            let out = "";
+            for (const part of parts) {
+                if (part === "//") {
+                    out = out ? (out.endsWith("/") ? `${out}/` : `${out}//`) : "//";
+                }
+                else {
+                    out = out
+                        ? out.endsWith("/")
+                            ? `${out}${part}`
+                            : `${out}/${part}`
+                        : `/${part}`;
+                }
+            }
+            return out || "/";
+        }
+        catch {
+            return "/";
+        }
+    };
+    return compute(this);
+}
+export function documentHasFocusStrict() {
+    try {
+        return document.hasFocus() === true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/v3/dom/a11yScripts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/a11yScripts/index.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,MAAM,EAAE,GACN,MAAM,CAAC,OAAO;YACd,MAAM,CAAC,WAAW;YAClB,QAAQ,CAAC,eAAe,EAAE,UAAU;YACpC,CAAC,CAAC;QACJ,MAAM,EAAE,GACN,MAAM,CAAC,OAAO;YACd,MAAM,CAAC,WAAW;YAClB,QAAQ,CAAC,eAAe,EAAE,SAAS;YACnC,CAAC,CAAC;QACJ,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB;IAIjC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC1C,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC;YAClC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC;SACjC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,CAAC,GAA0B,EAAkB,EAAE;YAChE,IAAI,EAAE,GAAmB,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC;YACnD,OAAO,EAAE,IAAI,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;gBAC1D,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;YACnC,CAAC;YACD,OAAO,EAAE,IAAI,IAAI,CAAC;QACpB,CAAC,CAAC;QACF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,CAAC,IAA6B,EAAU,EAAE;QACxD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,CAAC,CAA0B,EAAU,EAAE;gBACtD,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU;oBAAE,OAAO,CAAC,CAAC;gBAClC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACV,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACtE,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,eAAe,EAAE,CAAC;oBACzD,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBAChE,IAAI,GAAG,KAAK,SAAS;wBAAE,CAAC,IAAI,CAAC,CAAC;gBAChC,CAAC;gBACD,OAAO,CAAC,CAAC;YACX,CAAC,CAAC;YAEF,MAAM,IAAI,GAAG,CAAC,CAA0B,EAAU,EAAE;gBAClD,IAAI,CAAC,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAClB,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,aAAa;oBAAE,OAAO,EAAE,CAAC;gBACjD,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,sBAAsB;oBAAE,OAAO,IAAI,CAAC;gBAC5D,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,SAAS;oBAAE,OAAO,UAAU,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;gBACnE,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,YAAY;oBAClC,OAAO,aAAa,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;gBACrC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC5D,OAAO,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;YACnC,CAAC,CAAC;YAEF,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,GAAG,GAA4B,IAAI,CAAC;YACxC,OAAO,GAAG,EAAE,CAAC;gBACX,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,sBAAsB,EAAE,CAAC;oBACjD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACjB,GAAG,GAAI,GAAkB,CAAC,IAAI,IAAI,IAAI,CAAC;oBACvC,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,IAAI,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACrB,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC;YACvB,CAAC;YACD,KAAK,CAAC,OAAO,EAAE,CAAC;YAEhB,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAClB,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBAClE,CAAC;qBAAM,CAAC;oBACN,GAAG,GAAG,GAAG;wBACP,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;4BACjB,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,EAAE;4BACjB,CAAC,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE;wBACpB,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;gBACjB,CAAC;YACH,CAAC;YACD,OAAO,GAAG,IAAI,GAAG,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC","sourcesContent":["export function getScrollOffsets(): { sx: number; sy: number } {\n  try {\n    const sx =\n      window.scrollX ??\n      window.pageXOffset ??\n      document.documentElement?.scrollLeft ??\n      0;\n    const sy =\n      window.scrollY ??\n      window.pageYOffset ??\n      document.documentElement?.scrollTop ??\n      0;\n    return { sx: Number(sx) || 0, sy: Number(sy) || 0 };\n  } catch {\n    return { sx: 0, sy: 0 };\n  }\n}\n\nexport function getBoundingRectLite(this: Element): {\n  left: number;\n  top: number;\n} {\n  try {\n    const rect = this.getBoundingClientRect();\n    return {\n      left: Number(rect?.left ?? 0) || 0,\n      top: Number(rect?.top ?? 0) || 0,\n    };\n  } catch {\n    return { left: 0, top: 0 };\n  }\n}\n\nexport function resolveDeepActiveElement(): Element | null {\n  try {\n    const deepActive = (doc: Document | ShadowRoot): Element | null => {\n      let el: Element | null = doc.activeElement ?? null;\n      while (el && el.shadowRoot && el.shadowRoot.activeElement) {\n        el = el.shadowRoot.activeElement;\n      }\n      return el ?? null;\n    };\n    return deepActive(document);\n  } catch {\n    return null;\n  }\n}\n\nexport function nodeToAbsoluteXPath(this: Node | null | undefined): string {\n  const compute = (node: Node | null | undefined): string => {\n    try {\n      const sibIndex = (n: Node | null | undefined): number => {\n        if (!n || !n.parentNode) return 1;\n        let i = 1;\n        const targetKey = `${n.nodeType}:${(n.nodeName || \"\").toLowerCase()}`;\n        for (let p = n.previousSibling; p; p = p.previousSibling) {\n          const key = `${p.nodeType}:${(p.nodeName || \"\").toLowerCase()}`;\n          if (key === targetKey) i += 1;\n        }\n        return i;\n      };\n\n      const step = (n: Node | null | undefined): string => {\n        if (!n) return \"\";\n        if (n.nodeType === Node.DOCUMENT_NODE) return \"\";\n        if (n.nodeType === Node.DOCUMENT_FRAGMENT_NODE) return \"//\";\n        if (n.nodeType === Node.TEXT_NODE) return `text()[${sibIndex(n)}]`;\n        if (n.nodeType === Node.COMMENT_NODE)\n          return `comment()[${sibIndex(n)}]`;\n        const tag = (n.nodeName || \"\").toLowerCase();\n        const name = tag.includes(\":\") ? `*[name()='${tag}']` : tag;\n        return `${name}[${sibIndex(n)}]`;\n      };\n\n      const parts: string[] = [];\n      let cur: Node | null | undefined = node;\n      while (cur) {\n        if (cur.nodeType === Node.DOCUMENT_FRAGMENT_NODE) {\n          parts.push(\"//\");\n          cur = (cur as ShadowRoot).host ?? null;\n          continue;\n        }\n        const s = step(cur);\n        if (s) parts.push(s);\n        cur = cur.parentNode;\n      }\n      parts.reverse();\n\n      let out = \"\";\n      for (const part of parts) {\n        if (part === \"//\") {\n          out = out ? (out.endsWith(\"/\") ? `${out}/` : `${out}//`) : \"//\";\n        } else {\n          out = out\n            ? out.endsWith(\"/\")\n              ? `${out}${part}`\n              : `${out}/${part}`\n            : `/${part}`;\n        }\n      }\n      return out || \"/\";\n    } catch {\n      return \"/\";\n    }\n  };\n\n  return compute(this);\n}\n\nexport function documentHasFocusStrict(): boolean {\n  try {\n    return document.hasFocus() === true;\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/esm/lib/v3/dom/build/a11yScripts.generated.d.ts

@@ -0,0 +1,16 @@
+export declare const a11yScriptBootstrap = "if (!globalThis.__stagehandA11yScripts) { var __stagehandA11yScriptsFactory=(()=>{var i=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var N=(o,t)=>{for(var n in t)i(o,n,{get:t[n],enumerable:!0})},h=(o,t,n,d)=>{if(t&&typeof t==\"object\"||typeof t==\"function\")for(let u of f(t))!p.call(o,u)&&u!==n&&i(o,u,{get:()=>t[u],enumerable:!(d=a(t,u))||d.enumerable});return o};var E=o=>h(i({},\"__esModule\",{value:!0}),o);var b={};N(b,{documentHasFocusStrict:()=>g,getBoundingRectLite:()=>w,getScrollOffsets:()=>y,nodeToAbsoluteXPath:()=>$,resolveDeepActiveElement:()=>T});function y(){try{let o=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,t=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(o)||0,sy:Number(t)||0}}catch{return{sx:0,sy:0}}}function w(){try{let o=this.getBoundingClientRect();return{left:Number(o?.left??0)||0,top:Number(o?.top??0)||0}}catch{return{left:0,top:0}}}function T(){try{return(t=>{let n=t.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}function $(){return(t=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let l=1,m=`${e.nodeType}:${(e.nodeName||\"\").toLowerCase()}`;for(let c=e.previousSibling;c;c=c.previousSibling)`${c.nodeType}:${(c.nodeName||\"\").toLowerCase()}`===m&&(l+=1);return l},d=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return\"\";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return\"//\";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let l=(e.nodeName||\"\").toLowerCase();return`${l.includes(\":\")?`*[name()='${l}']`:l}[${n(e)}]`},u=[],s=t;for(;s;){if(s.nodeType===Node.DOCUMENT_FRAGMENT_NODE){u.push(\"//\"),s=s.host??null;continue}let e=d(s);e&&u.push(e),s=s.parentNode}u.reverse();let r=\"\";for(let e of u)e===\"//\"?r=r?r.endsWith(\"/\")?`${r}/`:`${r}//`:\"//\":r=r?r.endsWith(\"/\")?`${r}${e}`:`${r}/${e}`:`/${e}`;return r||\"/\"}catch{return\"/\"}})(this)}function g(){try{return document.hasFocus()===!0}catch{return!1}}return E(b);})();\n  globalThis.__stagehandA11yScripts = __stagehandA11yScriptsFactory;\n}";
+export declare const a11yScriptSources: {
+    readonly documentHasFocusStrict: "function h(){try{return document.hasFocus()===!0}catch{return!1}}";
+    readonly getBoundingRectLite: "function f(){try{let r=this.getBoundingClientRect();return{left:Number(r?.left??0)||0,top:Number(r?.top??0)||0}}catch{return{left:0,top:0}}}";
+    readonly getScrollOffsets: "function a(){try{let r=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,s=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(r)||0,sy:Number(s)||0}}catch{return{sx:0,sy:0}}}";
+    readonly nodeToAbsoluteXPath: "function N(){return(s=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let u=1,d=`${e.nodeType}:${(e.nodeName||\"\").toLowerCase()}`;for(let l=e.previousSibling;l;l=l.previousSibling)`${l.nodeType}:${(l.nodeName||\"\").toLowerCase()}`===d&&(u+=1);return u},i=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return\"\";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return\"//\";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let u=(e.nodeName||\"\").toLowerCase();return`${u.includes(\":\")?`*[name()='${u}']`:u}[${n(e)}]`},c=[],o=s;for(;o;){if(o.nodeType===Node.DOCUMENT_FRAGMENT_NODE){c.push(\"//\"),o=o.host??null;continue}let e=i(o);e&&c.push(e),o=o.parentNode}c.reverse();let t=\"\";for(let e of c)e===\"//\"?t=t?t.endsWith(\"/\")?`${t}/`:`${t}//`:\"//\":t=t?t.endsWith(\"/\")?`${t}${e}`:`${t}/${e}`:`/${e}`;return t||\"/\"}catch{return\"/\"}})(this)}";
+    readonly resolveDeepActiveElement: "function p(){try{return(s=>{let n=s.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}";
+};
+export declare const a11yScriptGlobalRefs: {
+    readonly documentHasFocusStrict: "globalThis.__stagehandA11yScripts.documentHasFocusStrict";
+    readonly getBoundingRectLite: "globalThis.__stagehandA11yScripts.getBoundingRectLite";
+    readonly getScrollOffsets: "globalThis.__stagehandA11yScripts.getScrollOffsets";
+    readonly nodeToAbsoluteXPath: "globalThis.__stagehandA11yScripts.nodeToAbsoluteXPath";
+    readonly resolveDeepActiveElement: "globalThis.__stagehandA11yScripts.resolveDeepActiveElement";
+};
+export type A11yScriptName = keyof typeof a11yScriptSources;

package/dist/esm/lib/v3/dom/build/a11yScripts.generated.js

@@ -0,0 +1,20 @@
+/*
+ * AUTO-GENERATED FILE. DO NOT EDIT.
+ * Update sources in lib/v3/dom/a11yScripts and run genA11yScripts.ts.
+ */
+export const a11yScriptBootstrap = "if (!globalThis.__stagehandA11yScripts) { var __stagehandA11yScriptsFactory=(()=>{var i=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var N=(o,t)=>{for(var n in t)i(o,n,{get:t[n],enumerable:!0})},h=(o,t,n,d)=>{if(t&&typeof t==\"object\"||typeof t==\"function\")for(let u of f(t))!p.call(o,u)&&u!==n&&i(o,u,{get:()=>t[u],enumerable:!(d=a(t,u))||d.enumerable});return o};var E=o=>h(i({},\"__esModule\",{value:!0}),o);var b={};N(b,{documentHasFocusStrict:()=>g,getBoundingRectLite:()=>w,getScrollOffsets:()=>y,nodeToAbsoluteXPath:()=>$,resolveDeepActiveElement:()=>T});function y(){try{let o=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,t=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(o)||0,sy:Number(t)||0}}catch{return{sx:0,sy:0}}}function w(){try{let o=this.getBoundingClientRect();return{left:Number(o?.left??0)||0,top:Number(o?.top??0)||0}}catch{return{left:0,top:0}}}function T(){try{return(t=>{let n=t.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}function $(){return(t=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let l=1,m=`${e.nodeType}:${(e.nodeName||\"\").toLowerCase()}`;for(let c=e.previousSibling;c;c=c.previousSibling)`${c.nodeType}:${(c.nodeName||\"\").toLowerCase()}`===m&&(l+=1);return l},d=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return\"\";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return\"//\";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let l=(e.nodeName||\"\").toLowerCase();return`${l.includes(\":\")?`*[name()='${l}']`:l}[${n(e)}]`},u=[],s=t;for(;s;){if(s.nodeType===Node.DOCUMENT_FRAGMENT_NODE){u.push(\"//\"),s=s.host??null;continue}let e=d(s);e&&u.push(e),s=s.parentNode}u.reverse();let r=\"\";for(let e of u)e===\"//\"?r=r?r.endsWith(\"/\")?`${r}/`:`${r}//`:\"//\":r=r?r.endsWith(\"/\")?`${r}${e}`:`${r}/${e}`:`/${e}`;return r||\"/\"}catch{return\"/\"}})(this)}function g(){try{return document.hasFocus()===!0}catch{return!1}}return E(b);})();\n  globalThis.__stagehandA11yScripts = __stagehandA11yScriptsFactory;\n}";
+export const a11yScriptSources = {
+    "documentHasFocusStrict": "function h(){try{return document.hasFocus()===!0}catch{return!1}}",
+    "getBoundingRectLite": "function f(){try{let r=this.getBoundingClientRect();return{left:Number(r?.left??0)||0,top:Number(r?.top??0)||0}}catch{return{left:0,top:0}}}",
+    "getScrollOffsets": "function a(){try{let r=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,s=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(r)||0,sy:Number(s)||0}}catch{return{sx:0,sy:0}}}",
+    "nodeToAbsoluteXPath": "function N(){return(s=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let u=1,d=`${e.nodeType}:${(e.nodeName||\"\").toLowerCase()}`;for(let l=e.previousSibling;l;l=l.previousSibling)`${l.nodeType}:${(l.nodeName||\"\").toLowerCase()}`===d&&(u+=1);return u},i=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return\"\";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return\"//\";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let u=(e.nodeName||\"\").toLowerCase();return`${u.includes(\":\")?`*[name()='${u}']`:u}[${n(e)}]`},c=[],o=s;for(;o;){if(o.nodeType===Node.DOCUMENT_FRAGMENT_NODE){c.push(\"//\"),o=o.host??null;continue}let e=i(o);e&&c.push(e),o=o.parentNode}c.reverse();let t=\"\";for(let e of c)e===\"//\"?t=t?t.endsWith(\"/\")?`${t}/`:`${t}//`:\"//\":t=t?t.endsWith(\"/\")?`${t}${e}`:`${t}/${e}`:`/${e}`;return t||\"/\"}catch{return\"/\"}})(this)}",
+    "resolveDeepActiveElement": "function p(){try{return(s=>{let n=s.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}"
+};
+export const a11yScriptGlobalRefs = {
+    "documentHasFocusStrict": "globalThis.__stagehandA11yScripts.documentHasFocusStrict",
+    "getBoundingRectLite": "globalThis.__stagehandA11yScripts.getBoundingRectLite",
+    "getScrollOffsets": "globalThis.__stagehandA11yScripts.getScrollOffsets",
+    "nodeToAbsoluteXPath": "globalThis.__stagehandA11yScripts.nodeToAbsoluteXPath",
+    "resolveDeepActiveElement": "globalThis.__stagehandA11yScripts.resolveDeepActiveElement"
+};
+//# sourceMappingURL=a11yScripts.generated.js.map

package/dist/esm/lib/v3/dom/build/a11yScripts.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11yScripts.generated.js","sourceRoot":"","sources":["../../../../../../lib/v3/dom/build/a11yScripts.generated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,4uEAA4uE,CAAC;AAChxE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,wBAAwB,EAAE,mEAAmE;IAC7F,qBAAqB,EAAE,8IAA8I;IACrK,kBAAkB,EAAE,mPAAmP;IACvQ,qBAAqB,EAAE,o5BAAo5B;IAC36B,0BAA0B,EAAE,uLAAuL;CAC3M,CAAC;AACX,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,wBAAwB,EAAE,0DAA0D;IACpF,qBAAqB,EAAE,uDAAuD;IAC9E,kBAAkB,EAAE,oDAAoD;IACxE,qBAAqB,EAAE,uDAAuD;IAC9E,0BAA0B,EAAE,4DAA4D;CAChF,CAAC","sourcesContent":["/*\n * AUTO-GENERATED FILE. DO NOT EDIT.\n * Update sources in lib/v3/dom/a11yScripts and run genA11yScripts.ts.\n */\nexport const a11yScriptBootstrap = \"if (!globalThis.__stagehandA11yScripts) { var __stagehandA11yScriptsFactory=(()=>{var i=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var N=(o,t)=>{for(var n in t)i(o,n,{get:t[n],enumerable:!0})},h=(o,t,n,d)=>{if(t&&typeof t==\\\"object\\\"||typeof t==\\\"function\\\")for(let u of f(t))!p.call(o,u)&&u!==n&&i(o,u,{get:()=>t[u],enumerable:!(d=a(t,u))||d.enumerable});return o};var E=o=>h(i({},\\\"__esModule\\\",{value:!0}),o);var b={};N(b,{documentHasFocusStrict:()=>g,getBoundingRectLite:()=>w,getScrollOffsets:()=>y,nodeToAbsoluteXPath:()=>$,resolveDeepActiveElement:()=>T});function y(){try{let o=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,t=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(o)||0,sy:Number(t)||0}}catch{return{sx:0,sy:0}}}function w(){try{let o=this.getBoundingClientRect();return{left:Number(o?.left??0)||0,top:Number(o?.top??0)||0}}catch{return{left:0,top:0}}}function T(){try{return(t=>{let n=t.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}function $(){return(t=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let l=1,m=`${e.nodeType}:${(e.nodeName||\\\"\\\").toLowerCase()}`;for(let c=e.previousSibling;c;c=c.previousSibling)`${c.nodeType}:${(c.nodeName||\\\"\\\").toLowerCase()}`===m&&(l+=1);return l},d=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return\\\"\\\";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return\\\"//\\\";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let l=(e.nodeName||\\\"\\\").toLowerCase();return`${l.includes(\\\":\\\")?`*[name()='${l}']`:l}[${n(e)}]`},u=[],s=t;for(;s;){if(s.nodeType===Node.DOCUMENT_FRAGMENT_NODE){u.push(\\\"//\\\"),s=s.host??null;continue}let e=d(s);e&&u.push(e),s=s.parentNode}u.reverse();let r=\\\"\\\";for(let e of u)e===\\\"//\\\"?r=r?r.endsWith(\\\"/\\\")?`${r}/`:`${r}//`:\\\"//\\\":r=r?r.endsWith(\\\"/\\\")?`${r}${e}`:`${r}/${e}`:`/${e}`;return r||\\\"/\\\"}catch{return\\\"/\\\"}})(this)}function g(){try{return document.hasFocus()===!0}catch{return!1}}return E(b);})();\\n  globalThis.__stagehandA11yScripts = __stagehandA11yScriptsFactory;\\n}\";\nexport const a11yScriptSources = {\n  \"documentHasFocusStrict\": \"function h(){try{return document.hasFocus()===!0}catch{return!1}}\",\n  \"getBoundingRectLite\": \"function f(){try{let r=this.getBoundingClientRect();return{left:Number(r?.left??0)||0,top:Number(r?.top??0)||0}}catch{return{left:0,top:0}}}\",\n  \"getScrollOffsets\": \"function a(){try{let r=window.scrollX??window.pageXOffset??document.documentElement?.scrollLeft??0,s=window.scrollY??window.pageYOffset??document.documentElement?.scrollTop??0;return{sx:Number(r)||0,sy:Number(s)||0}}catch{return{sx:0,sy:0}}}\",\n  \"nodeToAbsoluteXPath\": \"function N(){return(s=>{try{let n=e=>{if(!e||!e.parentNode)return 1;let u=1,d=`${e.nodeType}:${(e.nodeName||\\\"\\\").toLowerCase()}`;for(let l=e.previousSibling;l;l=l.previousSibling)`${l.nodeType}:${(l.nodeName||\\\"\\\").toLowerCase()}`===d&&(u+=1);return u},i=e=>{if(!e||e.nodeType===Node.DOCUMENT_NODE)return\\\"\\\";if(e.nodeType===Node.DOCUMENT_FRAGMENT_NODE)return\\\"//\\\";if(e.nodeType===Node.TEXT_NODE)return`text()[${n(e)}]`;if(e.nodeType===Node.COMMENT_NODE)return`comment()[${n(e)}]`;let u=(e.nodeName||\\\"\\\").toLowerCase();return`${u.includes(\\\":\\\")?`*[name()='${u}']`:u}[${n(e)}]`},c=[],o=s;for(;o;){if(o.nodeType===Node.DOCUMENT_FRAGMENT_NODE){c.push(\\\"//\\\"),o=o.host??null;continue}let e=i(o);e&&c.push(e),o=o.parentNode}c.reverse();let t=\\\"\\\";for(let e of c)e===\\\"//\\\"?t=t?t.endsWith(\\\"/\\\")?`${t}/`:`${t}//`:\\\"//\\\":t=t?t.endsWith(\\\"/\\\")?`${t}${e}`:`${t}/${e}`:`/${e}`;return t||\\\"/\\\"}catch{return\\\"/\\\"}})(this)}\",\n  \"resolveDeepActiveElement\": \"function p(){try{return(s=>{let n=s.activeElement??null;for(;n&&n.shadowRoot&&n.shadowRoot.activeElement;)n=n.shadowRoot.activeElement;return n??null})(document)}catch{return null}}\"\n} as const;\nexport const a11yScriptGlobalRefs = {\n  \"documentHasFocusStrict\": \"globalThis.__stagehandA11yScripts.documentHasFocusStrict\",\n  \"getBoundingRectLite\": \"globalThis.__stagehandA11yScripts.getBoundingRectLite\",\n  \"getScrollOffsets\": \"globalThis.__stagehandA11yScripts.getScrollOffsets\",\n  \"nodeToAbsoluteXPath\": \"globalThis.__stagehandA11yScripts.nodeToAbsoluteXPath\",\n  \"resolveDeepActiveElement\": \"globalThis.__stagehandA11yScripts.resolveDeepActiveElement\"\n} as const;\nexport type A11yScriptName = keyof typeof a11yScriptSources;\n"]}