browser-pilot 0.0.5 → 0.0.6

package/README.md

@@ -403,6 +403,45 @@ Output:
 
 Run `bp actions` for complete action reference.
 
+### Recording Browser Actions
+
+Record human interactions to create automation recipes:
+
+```bash
+# Auto-connect to local Chrome and record (creates new session)
+bp record
+
+# Use most recent session
+bp record -s
+
+# Use specific session with custom output file
+bp record -s my-session -f login-flow.json
+
+# Review and edit the recording
+cat recording.json
+
+# Replay the recording
+bp exec -s my-session --file recording.json
+```
+
+The output format is compatible with `page.batch()`:
+```json
+{
+  "recordedAt": "2026-01-06T10:00:00.000Z",
+  "startUrl": "https://example.com",
+  "duration": 15000,
+  "steps": [
+    { "action": "fill", "selector": ["[data-testid=\"email\"]", "#email"], "value": "user@example.com" },
+    { "action": "click", "selector": ["[data-testid=\"submit\"]", "#login-btn"] }
+  ]
+}
+```
+
+**Notes:**
+- Password fields are automatically redacted as `[REDACTED]`
+- Selectors are multi-selector arrays ordered by reliability (data attributes > IDs > CSS paths)
+- Edit the JSON to adjust selectors or add `optional: true` flags
+
 ## Examples
 
 ### Login Flow with Error Handling

package/dist/actions.d.cts

@@ -1,5 +1,5 @@
-import { P as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-DQhA8uQZ.cjs';
-export { A as ActionType, c as StepResult } from './types-DQhA8uQZ.cjs';
+import { P as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-TVlTA7nH.cjs';
+export { A as ActionType, c as StepResult } from './types-TVlTA7nH.cjs';
 import './client-7Nqka5MV.cjs';
 
 /**

package/dist/actions.d.ts

@@ -1,5 +1,5 @@
-import { P as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-DKz34hii.js';
-export { A as ActionType, c as StepResult } from './types-DKz34hii.js';
+import { P as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-CbdmaocU.js';
+export { A as ActionType, c as StepResult } from './types-CbdmaocU.js';
 import './client-7Nqka5MV.js';
 
 /**

package/dist/browser.cjs

@@ -1134,6 +1134,13 @@ var Page = class {
     this.cdp = cdp;
     this.batchExecutor = new BatchExecutor(this);
   }
+  /**
+   * Get the underlying CDP client for advanced operations.
+   * Use with caution - prefer high-level Page methods when possible.
+   */
+  get cdpClient() {
+    return this.cdp;
+  }
   /**
    * Initialize the page (enable required CDP domains)
    */

package/dist/browser.d.cts

@@ -1,7 +1,7 @@
 import { C as CDPClient } from './client-7Nqka5MV.cjs';
 import { C as ConnectOptions } from './types-D_uDqh0Z.cjs';
-import { P as Page } from './types-DQhA8uQZ.cjs';
-export { d as ActionOptions, e as ActionResult, C as ConsoleHandler, f as ConsoleMessage, g as ConsoleMessageType, h as CustomSelectConfig, D as Dialog, i as DialogHandler, j as DialogType, k as Download, E as ElementInfo, l as ElementNotFoundError, m as EmulationState, n as ErrorHandler, F as FileInput, o as FillOptions, G as GeolocationOptions, I as InteractiveElement, N as NavigationError, p as NetworkIdleOptions, q as PageError, r as PageSnapshot, s as SnapshotNode, t as SubmitOptions, T as TimeoutError, u as TypeOptions, U as UserAgentMetadata, v as UserAgentOptions, V as ViewportOptions, W as WaitForOptions } from './types-DQhA8uQZ.cjs';
+import { P as Page } from './types-TVlTA7nH.cjs';
+export { d as ActionOptions, e as ActionResult, C as ConsoleHandler, f as ConsoleMessage, g as ConsoleMessageType, h as CustomSelectConfig, D as Dialog, i as DialogHandler, j as DialogType, k as Download, E as ElementInfo, l as ElementNotFoundError, m as EmulationState, n as ErrorHandler, F as FileInput, o as FillOptions, G as GeolocationOptions, I as InteractiveElement, N as NavigationError, p as NetworkIdleOptions, q as PageError, r as PageSnapshot, s as SnapshotNode, t as SubmitOptions, T as TimeoutError, u as TypeOptions, U as UserAgentMetadata, v as UserAgentOptions, V as ViewportOptions, W as WaitForOptions } from './types-TVlTA7nH.cjs';
 
 /**
  * Browser class - manages CDP connection and pages

package/dist/browser.d.ts

@@ -1,7 +1,7 @@
 import { C as CDPClient } from './client-7Nqka5MV.js';
 import { C as ConnectOptions } from './types-D_uDqh0Z.js';
-import { P as Page } from './types-DKz34hii.js';
-export { d as ActionOptions, e as ActionResult, C as ConsoleHandler, f as ConsoleMessage, g as ConsoleMessageType, h as CustomSelectConfig, D as Dialog, i as DialogHandler, j as DialogType, k as Download, E as ElementInfo, l as ElementNotFoundError, m as EmulationState, n as ErrorHandler, F as FileInput, o as FillOptions, G as GeolocationOptions, I as InteractiveElement, N as NavigationError, p as NetworkIdleOptions, q as PageError, r as PageSnapshot, s as SnapshotNode, t as SubmitOptions, T as TimeoutError, u as TypeOptions, U as UserAgentMetadata, v as UserAgentOptions, V as ViewportOptions, W as WaitForOptions } from './types-DKz34hii.js';
+import { P as Page } from './types-CbdmaocU.js';
+export { d as ActionOptions, e as ActionResult, C as ConsoleHandler, f as ConsoleMessage, g as ConsoleMessageType, h as CustomSelectConfig, D as Dialog, i as DialogHandler, j as DialogType, k as Download, E as ElementInfo, l as ElementNotFoundError, m as EmulationState, n as ErrorHandler, F as FileInput, o as FillOptions, G as GeolocationOptions, I as InteractiveElement, N as NavigationError, p as NetworkIdleOptions, q as PageError, r as PageSnapshot, s as SnapshotNode, t as SubmitOptions, T as TimeoutError, u as TypeOptions, U as UserAgentMetadata, v as UserAgentOptions, V as ViewportOptions, W as WaitForOptions } from './types-CbdmaocU.js';
 
 /**
  * Browser class - manages CDP connection and pages

package/dist/browser.mjs

@@ -5,7 +5,7 @@ import {
   Page,
   TimeoutError,
   connect
-} from "./chunk-NP56KSAN.mjs";
+} from "./chunk-PCNEJAJ7.mjs";
 import "./chunk-BCOZUKWS.mjs";
 import "./chunk-R3PS4PCM.mjs";
 import "./chunk-6RB3GKQP.mjs";

package/dist/{chunk-NP56KSAN.mjs → chunk-PCNEJAJ7.mjs}

@@ -471,6 +471,13 @@ var Page = class {
     this.cdp = cdp;
     this.batchExecutor = new BatchExecutor(this);
   }
+  /**
+   * Get the underlying CDP client for advanced operations.
+   * Use with caution - prefer high-level Page methods when possible.
+   */
+  get cdpClient() {
+    return this.cdp;
+  }
   /**
    * Initialize the page (enable required CDP domains)
    */