Document perform retry options in public API

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

Author: cursoragent

README.md

@@ -195,6 +195,12 @@ await page.perform("click the login button", {
 });
 ```
 
+**Perform retry options**:
+- `maxElementRetries`: attempts to refetch/find a target element before failing.
+- `retryDelayMs`: delay between element-refetch retries.
+- `maxContextSwitchRetries`: retries when a tab/context switch interrupts an in-flight action.
+- `contextSwitchRetryDelayMs`: delay between context-switch retries (defaults to 500ms, capped for safety).
+
 ### 🧠 `page.ai()` - Complex Multi-Step Tasks
 
 **Best for**: Complex workflows requiring multiple steps and visual context

src/__tests__/public-api.test.ts

@@ -56,4 +56,15 @@ describe("public API exports", () => {
     const typeSmoke: PublicTypeSmoke | null = null;
     expect(typeSmoke).toBeNull();
   });
+
+  it("keeps perform retry option fields available on public PerformTaskParams", () => {
+    const performParams: PerformTaskParams = {
+      maxElementRetries: 5,
+      retryDelayMs: 250,
+      maxContextSwitchRetries: 4,
+      contextSwitchRetryDelayMs: 500,
+    };
+
+    expect(performParams.contextSwitchRetryDelayMs).toBe(500);
+  });
 });