Document replay frame-filter overrides in API docs

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

README.md

@@ -527,6 +527,7 @@ const page = await agent.newPage();
 const replay = await page.runFromActionCache(cache, {
   maxXPathRetries: 3,  // Retry XPath resolution up to 3 times before LLM fallback
   debug: true,
+  filterAdTrackingFrames: false, // Optional: include ad/tracking iframes during replay resolution
 });
 
 console.log(replay);

src/types/agent/types.ts

@@ -99,6 +99,9 @@ export interface ActionCacheReplayResult {
 export interface RunFromActionCacheParams {
   maxXPathRetries?: number;
   debug?: boolean;
+  /**
+   * Override ad/tracking iframe filtering for this replay.
+   */
   filterAdTrackingFrames?: boolean;
 }
 
@@ -115,6 +118,9 @@ export interface TaskParams extends AgentExecutionHooks {
   enableVisualMode?: boolean;
   useDomCache?: boolean;
   enableDomStreaming?: boolean;
+  /**
+   * Override ad/tracking iframe filtering for this task run.
+   */
   filterAdTrackingFrames?: boolean;
 }
 
@@ -214,6 +220,9 @@ export interface PerformOptions {
   frameIndex?: number | null;
   performInstruction?: string | null;
   maxSteps?: number;
+  /**
+   * Override ad/tracking iframe filtering for this helper replay call.
+   */
   filterAdTrackingFrames?: boolean;
 }