browser-pilot 0.0.13 → 0.0.15

package/dist/index.d.cts

@@ -1,8 +1,8 @@
 export { BatchExecutor, ValidationError, ValidationResult, addBatchToPage, validateSteps } from './actions.cjs';
-import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-BXMGFtnB.cjs';
-export { k as ActionOptions, l as ActionResult, A as ActionType, d as AudioChunk, e as AudioInput, f as AudioInputState, g as AudioOutput, B as BatchOptions, b as BatchResult, h as CaptureOptions, a6 as ClearCookiesOptions, m as ConsoleHandler, n as ConsoleMessage, o as ConsoleMessageType, $ as ContinueRequestOptions, a7 as Cookie, p as CustomSelectConfig, a8 as DeleteCookieOptions, Y as DeviceDescriptor, Z as DeviceName, D as Dialog, q as DialogHandler, r as DialogType, s as Download, E as ElementInfo, t as ElementNotFoundError, u as EmulationState, v as ErrorHandler, a0 as FailRequestOptions, F as FileInput, w as FillOptions, x as FormField, y as FormOption, a1 as FulfillRequestOptions, G as GeolocationOptions, I as InteractiveElement, a2 as InterceptedRequest, N as NavigationError, z as NetworkIdleOptions, H as Page, J as PageError, K as PageSnapshot, P as PlayOptions, a3 as RequestActions, a4 as ResourceType, i as RoundTripOptions, j as RoundTripResult, a5 as RouteOptions, a9 as SetCookieOptions, L as SnapshotNode, M as SnapshotOptions, S as Step, c as StepResult, O as SubmitOptions, T as TimeoutError, Q as TypeOptions, U as UserAgentMetadata, V as UserAgentOptions, W as ViewportOptions, X as WaitForOptions, aa as WaitOptions, ab as WaitResult, ac as WaitState, _ as devices, ad as waitForAnyElement, ae as waitForElement, af as waitForNavigation, ag as waitForNetworkIdle } from './types-BXMGFtnB.cjs';
-import { C as CDPClient } from './client-DRqxBdHv.cjs';
-export { a as CDPClientOptions, c as createCDPClient } from './client-DRqxBdHv.cjs';
+import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-C9ySEdOX.cjs';
+export { l as ActionOptions, m as ActionResult, A as ActionType, e as AudioChunk, f as AudioInput, g as AudioInputState, h as AudioOutput, B as BatchOptions, b as BatchResult, i as CaptureOptions, a7 as ClearCookiesOptions, n as ConsoleHandler, o as ConsoleMessage, p as ConsoleMessageType, a0 as ContinueRequestOptions, a8 as Cookie, q as CustomSelectConfig, a9 as DeleteCookieOptions, Z as DeviceDescriptor, _ as DeviceName, D as Dialog, r as DialogHandler, s as DialogType, t as Download, E as ElementInfo, u as ElementNotFoundError, v as EmulationState, w as ErrorHandler, a1 as FailRequestOptions, F as FileInput, x as FillOptions, y as FormField, z as FormOption, a2 as FulfillRequestOptions, G as GeolocationOptions, I as InteractiveElement, a3 as InterceptedRequest, N as NavigationError, H as NetworkIdleOptions, J as Page, K as PageError, L as PageSnapshot, P as PlayOptions, c as RecordOptions, a4 as RequestActions, a5 as ResourceType, j as RoundTripOptions, k as RoundTripResult, a6 as RouteOptions, aa as SetCookieOptions, M as SnapshotNode, O as SnapshotOptions, S as Step, d as StepResult, Q as SubmitOptions, T as TimeoutError, U as TypeOptions, V as UserAgentMetadata, W as UserAgentOptions, X as ViewportOptions, Y as WaitForOptions, ab as WaitOptions, ac as WaitResult, ad as WaitState, $ as devices, ae as waitForAnyElement, af as waitForElement, ag as waitForNavigation, ah as waitForNetworkIdle } from './types-C9ySEdOX.cjs';
+import { C as CDPClient } from './client-B5QBRgIy.cjs';
+export { a as CDPClientOptions, c as createCDPClient } from './client-B5QBRgIy.cjs';
 export { Browser, BrowserOptions, PageOptions, connect } from './browser.cjs';
 export { CDPError } from './cdp.cjs';
 export { BrowserBaseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.cjs';

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export { BatchExecutor, ValidationError, ValidationResult, addBatchToPage, validateSteps } from './actions.js';
-import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-CzgQjai9.js';
-export { k as ActionOptions, l as ActionResult, A as ActionType, d as AudioChunk, e as AudioInput, f as AudioInputState, g as AudioOutput, B as BatchOptions, b as BatchResult, h as CaptureOptions, a6 as ClearCookiesOptions, m as ConsoleHandler, n as ConsoleMessage, o as ConsoleMessageType, $ as ContinueRequestOptions, a7 as Cookie, p as CustomSelectConfig, a8 as DeleteCookieOptions, Y as DeviceDescriptor, Z as DeviceName, D as Dialog, q as DialogHandler, r as DialogType, s as Download, E as ElementInfo, t as ElementNotFoundError, u as EmulationState, v as ErrorHandler, a0 as FailRequestOptions, F as FileInput, w as FillOptions, x as FormField, y as FormOption, a1 as FulfillRequestOptions, G as GeolocationOptions, I as InteractiveElement, a2 as InterceptedRequest, N as NavigationError, z as NetworkIdleOptions, H as Page, J as PageError, K as PageSnapshot, P as PlayOptions, a3 as RequestActions, a4 as ResourceType, i as RoundTripOptions, j as RoundTripResult, a5 as RouteOptions, a9 as SetCookieOptions, L as SnapshotNode, M as SnapshotOptions, S as Step, c as StepResult, O as SubmitOptions, T as TimeoutError, Q as TypeOptions, U as UserAgentMetadata, V as UserAgentOptions, W as ViewportOptions, X as WaitForOptions, aa as WaitOptions, ab as WaitResult, ac as WaitState, _ as devices, ad as waitForAnyElement, ae as waitForElement, af as waitForNavigation, ag as waitForNetworkIdle } from './types-CzgQjai9.js';
-import { C as CDPClient } from './client-DRqxBdHv.js';
-export { a as CDPClientOptions, c as createCDPClient } from './client-DRqxBdHv.js';
+import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-Cvvf0oGu.js';
+export { l as ActionOptions, m as ActionResult, A as ActionType, e as AudioChunk, f as AudioInput, g as AudioInputState, h as AudioOutput, B as BatchOptions, b as BatchResult, i as CaptureOptions, a7 as ClearCookiesOptions, n as ConsoleHandler, o as ConsoleMessage, p as ConsoleMessageType, a0 as ContinueRequestOptions, a8 as Cookie, q as CustomSelectConfig, a9 as DeleteCookieOptions, Z as DeviceDescriptor, _ as DeviceName, D as Dialog, r as DialogHandler, s as DialogType, t as Download, E as ElementInfo, u as ElementNotFoundError, v as EmulationState, w as ErrorHandler, a1 as FailRequestOptions, F as FileInput, x as FillOptions, y as FormField, z as FormOption, a2 as FulfillRequestOptions, G as GeolocationOptions, I as InteractiveElement, a3 as InterceptedRequest, N as NavigationError, H as NetworkIdleOptions, J as Page, K as PageError, L as PageSnapshot, P as PlayOptions, c as RecordOptions, a4 as RequestActions, a5 as ResourceType, j as RoundTripOptions, k as RoundTripResult, a6 as RouteOptions, aa as SetCookieOptions, M as SnapshotNode, O as SnapshotOptions, S as Step, d as StepResult, Q as SubmitOptions, T as TimeoutError, U as TypeOptions, V as UserAgentMetadata, W as UserAgentOptions, X as ViewportOptions, Y as WaitForOptions, ab as WaitOptions, ac as WaitResult, ad as WaitState, $ as devices, ae as waitForAnyElement, af as waitForElement, ag as waitForNavigation, ah as waitForNetworkIdle } from './types-Cvvf0oGu.js';
+import { C as CDPClient } from './client-B5QBRgIy.js';
+export { a as CDPClientOptions, c as createCDPClient } from './client-B5QBRgIy.js';
 export { Browser, BrowserOptions, PageOptions, connect } from './browser.js';
 export { CDPError } from './cdp.js';
 export { BrowserBaseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.js';

package/dist/index.mjs

@@ -16,10 +16,10 @@ import {
   waitForElement,
   waitForNavigation,
   waitForNetworkIdle
-} from "./chunk-VDAMDOS6.mjs";
+} from "./chunk-ZAXQ5OTV.mjs";
 import {
   createCDPClient
-} from "./chunk-HP6R3W32.mjs";
+} from "./chunk-BVZALQT4.mjs";
 import {
   BrowserBaseProvider,
   BrowserlessProvider,
@@ -35,7 +35,7 @@ import {
   TimeoutError,
   addBatchToPage,
   validateSteps
-} from "./chunk-A2ZRAEO3.mjs";
+} from "./chunk-7YVCOL2W.mjs";
 import {
   CDPError
 } from "./chunk-JXAUPHZM.mjs";

package/dist/page-XPS6IC6V.mjs

@@ -0,0 +1,7 @@
+import {
+  Page
+} from "./chunk-USYSHCI3.mjs";
+import "./chunk-DTVRFXKI.mjs";
+export {
+  Page
+};

package/dist/transport-WHEBAZUP.mjs

@@ -0,0 +1,83 @@
+import {
+  DAEMON_CONNECT_TIMEOUT_MS
+} from "./chunk-LUGLEMVR.mjs";
+
+// src/daemon/transport.ts
+import { connect as netConnect } from "net";
+function createDaemonTransport(socketPath, options) {
+  const { timeout = DAEMON_CONNECT_TIMEOUT_MS } = options ?? {};
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => {
+      socket.destroy();
+      reject(new Error(`Daemon connection timeout after ${timeout}ms`));
+    }, timeout);
+    const socket = netConnect(socketPath, () => {
+      clearTimeout(timer);
+      let buffer = "";
+      const messageHandlers = [];
+      const closeHandlers = [];
+      const errorHandlers = [];
+      socket.on("data", (chunk) => {
+        buffer += chunk.toString("utf-8");
+        let newlineIdx = buffer.indexOf("\n");
+        while (newlineIdx !== -1) {
+          const line = buffer.slice(0, newlineIdx).trim();
+          buffer = buffer.slice(newlineIdx + 1);
+          if (line.length > 0) {
+            for (const handler of messageHandlers) {
+              handler(line);
+            }
+          }
+          newlineIdx = buffer.indexOf("\n");
+        }
+      });
+      socket.on("close", () => {
+        for (const handler of closeHandlers) {
+          handler();
+        }
+      });
+      socket.on("error", (err) => {
+        for (const handler of errorHandlers) {
+          handler(err);
+        }
+      });
+      const transport = {
+        send(message) {
+          if (!socket.writable) {
+            throw new Error("Daemon socket is not writable");
+          }
+          socket.write(`${message}
+`);
+        },
+        async close() {
+          return new Promise((resolveClose) => {
+            if (socket.destroyed) {
+              resolveClose();
+              return;
+            }
+            socket.once("close", () => resolveClose());
+            socket.end();
+            setTimeout(resolveClose, 200);
+          });
+        },
+        onMessage(handler) {
+          messageHandlers.push(handler);
+        },
+        onClose(handler) {
+          closeHandlers.push(handler);
+        },
+        onError(handler) {
+          errorHandlers.push(handler);
+        }
+      };
+      resolve(transport);
+    });
+    socket.on("error", (err) => {
+      clearTimeout(timer);
+      reject(err);
+    });
+  });
+}
+export {
+  createDaemonTransport
+};

package/dist/{types-CzgQjai9.d.ts → types-C9ySEdOX.d.cts}

@@ -1,4 +1,4 @@
-import { C as CDPClient } from './client-DRqxBdHv.js';
+import { C as CDPClient } from './client-B5QBRgIy.cjs';
 
 /**
  * Audio I/O type definitions
@@ -647,6 +647,13 @@ interface RouteOptions {
     contentType?: string;
 }
 
+interface ActionTargetMetadata {
+    tagName?: string;
+    inputType?: string;
+    autocomplete?: string;
+    sensitiveValue?: boolean;
+}
+
 /**
  * Cookie and storage types
  */
@@ -740,6 +747,9 @@ declare class Page {
     private brokenFrame;
     /** Last matched selector from findElement (for selectorUsed tracking) */
     private _lastMatchedSelector;
+    private _lastActionCoordinates;
+    private _lastActionBoundingBox;
+    private _lastActionTargetMetadata;
     /** Last snapshot for stale ref recovery */
     private lastSnapshot?;
     /** Audio input controller (lazy-initialized) */
@@ -761,6 +771,22 @@ declare class Page {
      * Returns undefined if no selector has been matched yet.
      */
     getLastMatchedSelector(): string | undefined;
+    private getActionTargetMetadata;
+    private getElementPosition;
+    private setLastActionPosition;
+    getLastActionCoordinates(): {
+        x: number;
+        y: number;
+    } | null;
+    getLastActionBoundingBox(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    getLastActionTargetMetadata(): ActionTargetMetadata | null;
+    /** Reset position tracking (call before each executor step) */
+    resetLastActionPosition(): void;
     /**
      * Initialize the page (enable required CDP domains)
      */
@@ -1221,7 +1247,7 @@ declare class Page {
  */
 
 type FailureReason = 'missing' | 'hidden' | 'covered' | 'disabled' | 'readonly' | 'detached' | 'replaced' | 'notEditable' | 'timeout' | 'navigation' | 'cdpError' | 'unknown';
-type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'shortcut' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'forms' | 'screenshot' | 'evaluate' | 'text' | 'newTab' | 'closeTab' | 'switchFrame' | 'switchToMain' | 'assertVisible' | 'assertExists' | 'assertText' | 'assertUrl' | 'assertValue';
+type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'shortcut' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'forms' | 'screenshot' | 'evaluate' | 'text' | 'newTab' | 'closeTab' | 'switchFrame' | 'switchToMain' | 'assertVisible' | 'assertExists' | 'assertText' | 'assertUrl' | 'assertValue' | 'waitForWsMessage' | 'assertNoConsoleErrors' | 'assertTextChanged' | 'assertPermission' | 'assertMediaTrackLive';
 interface Step {
     /** Action type */
     action: ActionType;
@@ -1258,7 +1284,9 @@ interface Step {
     /** Custom select: option selector */
     option?: string | string[];
     /** Custom select: match type */
-    match?: 'text' | 'value' | 'contains';
+    match?: 'text' | 'value' | 'contains' | string;
+    /** Structured matcher for trace-backed waits */
+    where?: Record<string, unknown>;
     /** Scroll coordinates */
     x?: number;
     y?: number;
@@ -1276,12 +1304,40 @@ interface Step {
     retry?: number;
     /** Delay between retries in ms (default: 500) */
     retryDelay?: number;
+    /** Previous text expected before a change */
+    from?: string;
+    /** Text expected after a change */
+    to?: string;
+    /** Permission or resource name */
+    name?: string;
+    /** Expected permission state */
+    state?: string;
+    /** Media track kind */
+    kind?: 'audio' | 'video';
+    /** Assertion observation window in milliseconds */
+    windowMs?: number;
+}
+interface RecordOptions {
+    /** Base directory for screenshots and recording.json. */
+    outputDir?: string;
+    /** Session identifier stored in the manifest. CLI fills this automatically. */
+    sessionId?: string;
+    /** Image format. Default: 'webp' */
+    format?: 'png' | 'jpeg' | 'webp';
+    /** Image quality 0-100 (webp/jpeg only). Default: 40 */
+    quality?: number;
+    /** Inject visual highlights before capture. Default: true */
+    highlights?: boolean;
+    /** Actions to skip capturing. Default: ['wait', 'snapshot', 'forms', 'text', 'screenshot'] */
+    skipActions?: ActionType[];
 }
 interface BatchOptions {
     /** Default timeout for all steps (ms) */
     timeout?: number;
     /** How to handle failures */
     onFail?: 'stop' | 'continue';
+    /** Enable screenshot recording */
+    record?: RecordOptions;
 }
 interface StepResult {
     /** Step index */
@@ -1319,6 +1375,22 @@ interface StepResult {
     };
     /** AI-friendly suggestion for what to try next */
     suggestion?: string;
+    /** Absolute timestamp (ms since epoch) when this step completed */
+    timestamp?: number;
+    /** Viewport coordinates where the action occurred (center of interacted element) */
+    coordinates?: {
+        x: number;
+        y: number;
+    };
+    /** Element bounding box at time of action (viewport-relative) */
+    boundingBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Path to screenshot file captured after this step (when recording enabled) */
+    screenshotPath?: string;
 }
 interface BatchResult {
     /** Whether all steps succeeded */
@@ -1329,6 +1401,8 @@ interface BatchResult {
     steps: StepResult[];
     /** Total execution time in ms */
     totalDurationMs: number;
+    /** Path to recording manifest (when recording is enabled) */
+    recordingManifest?: string;
 }
 
-export { type ContinueRequestOptions as $, type ActionType as A, type BatchOptions as B, type CaptureResult as C, type Dialog as D, type ElementInfo as E, type FileInput as F, type GeolocationOptions as G, Page as H, type InteractiveElement as I, type PageError as J, type PageSnapshot as K, type SnapshotNode as L, type SnapshotOptions as M, NavigationError as N, type SubmitOptions as O, type PlayOptions as P, type TypeOptions as Q, type RequestPattern as R, type Step as S, TimeoutError as T, type UserAgentMetadata as U, type UserAgentOptions as V, type ViewportOptions as W, type WaitForOptions as X, type DeviceDescriptor as Y, type DeviceName as Z, devices as _, type RequestHandler as a, type FailRequestOptions as a0, type FulfillRequestOptions as a1, type InterceptedRequest as a2, type RequestActions as a3, type ResourceType as a4, type RouteOptions as a5, type ClearCookiesOptions as a6, type Cookie as a7, type DeleteCookieOptions as a8, type SetCookieOptions as a9, type WaitOptions as aa, type WaitResult as ab, type WaitState as ac, waitForAnyElement as ad, waitForElement as ae, waitForNavigation as af, waitForNetworkIdle as ag, type FailureHint as ah, type FailureReason as ai, type BatchResult as b, type StepResult as c, type AudioChunk as d, AudioInput as e, type AudioInputState as f, AudioOutput as g, type CaptureOptions as h, type RoundTripOptions as i, type RoundTripResult as j, type ActionOptions as k, type ActionResult as l, type ConsoleHandler as m, type ConsoleMessage as n, type ConsoleMessageType as o, type CustomSelectConfig as p, type DialogHandler as q, type DialogType as r, type Download as s, ElementNotFoundError as t, type EmulationState as u, type ErrorHandler as v, type FillOptions as w, type FormField as x, type FormOption as y, type NetworkIdleOptions as z };
+export { devices as $, type ActionType as A, type BatchOptions as B, type CaptureResult as C, type Dialog as D, type ElementInfo as E, type FileInput as F, type GeolocationOptions as G, type NetworkIdleOptions as H, type InteractiveElement as I, Page as J, type PageError as K, type PageSnapshot as L, type SnapshotNode as M, NavigationError as N, type SnapshotOptions as O, type PlayOptions as P, type SubmitOptions as Q, type RequestPattern as R, type Step as S, TimeoutError as T, type TypeOptions as U, type UserAgentMetadata as V, type UserAgentOptions as W, type ViewportOptions as X, type WaitForOptions as Y, type DeviceDescriptor as Z, type DeviceName as _, type RequestHandler as a, type ContinueRequestOptions as a0, type FailRequestOptions as a1, type FulfillRequestOptions as a2, type InterceptedRequest as a3, type RequestActions as a4, type ResourceType as a5, type RouteOptions as a6, type ClearCookiesOptions as a7, type Cookie as a8, type DeleteCookieOptions as a9, type SetCookieOptions as aa, type WaitOptions as ab, type WaitResult as ac, type WaitState as ad, waitForAnyElement as ae, waitForElement as af, waitForNavigation as ag, waitForNetworkIdle as ah, type FailureHint as ai, type FailureReason as aj, type BatchResult as b, type RecordOptions as c, type StepResult as d, type AudioChunk as e, AudioInput as f, type AudioInputState as g, AudioOutput as h, type CaptureOptions as i, type RoundTripOptions as j, type RoundTripResult as k, type ActionOptions as l, type ActionResult as m, type ConsoleHandler as n, type ConsoleMessage as o, type ConsoleMessageType as p, type CustomSelectConfig as q, type DialogHandler as r, type DialogType as s, type Download as t, ElementNotFoundError as u, type EmulationState as v, type ErrorHandler as w, type FillOptions as x, type FormField as y, type FormOption as z };

package/dist/{types-BXMGFtnB.d.cts → types-Cvvf0oGu.d.ts}

@@ -1,4 +1,4 @@
-import { C as CDPClient } from './client-DRqxBdHv.cjs';
+import { C as CDPClient } from './client-B5QBRgIy.js';
 
 /**
  * Audio I/O type definitions
@@ -647,6 +647,13 @@ interface RouteOptions {
     contentType?: string;
 }
 
+interface ActionTargetMetadata {
+    tagName?: string;
+    inputType?: string;
+    autocomplete?: string;
+    sensitiveValue?: boolean;
+}
+
 /**
  * Cookie and storage types
  */
@@ -740,6 +747,9 @@ declare class Page {
     private brokenFrame;
     /** Last matched selector from findElement (for selectorUsed tracking) */
     private _lastMatchedSelector;
+    private _lastActionCoordinates;
+    private _lastActionBoundingBox;
+    private _lastActionTargetMetadata;
     /** Last snapshot for stale ref recovery */
     private lastSnapshot?;
     /** Audio input controller (lazy-initialized) */
@@ -761,6 +771,22 @@ declare class Page {
      * Returns undefined if no selector has been matched yet.
      */
     getLastMatchedSelector(): string | undefined;
+    private getActionTargetMetadata;
+    private getElementPosition;
+    private setLastActionPosition;
+    getLastActionCoordinates(): {
+        x: number;
+        y: number;
+    } | null;
+    getLastActionBoundingBox(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    getLastActionTargetMetadata(): ActionTargetMetadata | null;
+    /** Reset position tracking (call before each executor step) */
+    resetLastActionPosition(): void;
     /**
      * Initialize the page (enable required CDP domains)
      */
@@ -1221,7 +1247,7 @@ declare class Page {
  */
 
 type FailureReason = 'missing' | 'hidden' | 'covered' | 'disabled' | 'readonly' | 'detached' | 'replaced' | 'notEditable' | 'timeout' | 'navigation' | 'cdpError' | 'unknown';
-type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'shortcut' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'forms' | 'screenshot' | 'evaluate' | 'text' | 'newTab' | 'closeTab' | 'switchFrame' | 'switchToMain' | 'assertVisible' | 'assertExists' | 'assertText' | 'assertUrl' | 'assertValue';
+type ActionType = 'goto' | 'click' | 'fill' | 'type' | 'select' | 'check' | 'uncheck' | 'submit' | 'press' | 'shortcut' | 'focus' | 'hover' | 'scroll' | 'wait' | 'snapshot' | 'forms' | 'screenshot' | 'evaluate' | 'text' | 'newTab' | 'closeTab' | 'switchFrame' | 'switchToMain' | 'assertVisible' | 'assertExists' | 'assertText' | 'assertUrl' | 'assertValue' | 'waitForWsMessage' | 'assertNoConsoleErrors' | 'assertTextChanged' | 'assertPermission' | 'assertMediaTrackLive';
 interface Step {
     /** Action type */
     action: ActionType;
@@ -1258,7 +1284,9 @@ interface Step {
     /** Custom select: option selector */
     option?: string | string[];
     /** Custom select: match type */
-    match?: 'text' | 'value' | 'contains';
+    match?: 'text' | 'value' | 'contains' | string;
+    /** Structured matcher for trace-backed waits */
+    where?: Record<string, unknown>;
     /** Scroll coordinates */
     x?: number;
     y?: number;
@@ -1276,12 +1304,40 @@ interface Step {
     retry?: number;
     /** Delay between retries in ms (default: 500) */
     retryDelay?: number;
+    /** Previous text expected before a change */
+    from?: string;
+    /** Text expected after a change */
+    to?: string;
+    /** Permission or resource name */
+    name?: string;
+    /** Expected permission state */
+    state?: string;
+    /** Media track kind */
+    kind?: 'audio' | 'video';
+    /** Assertion observation window in milliseconds */
+    windowMs?: number;
+}
+interface RecordOptions {
+    /** Base directory for screenshots and recording.json. */
+    outputDir?: string;
+    /** Session identifier stored in the manifest. CLI fills this automatically. */
+    sessionId?: string;
+    /** Image format. Default: 'webp' */
+    format?: 'png' | 'jpeg' | 'webp';
+    /** Image quality 0-100 (webp/jpeg only). Default: 40 */
+    quality?: number;
+    /** Inject visual highlights before capture. Default: true */
+    highlights?: boolean;
+    /** Actions to skip capturing. Default: ['wait', 'snapshot', 'forms', 'text', 'screenshot'] */
+    skipActions?: ActionType[];
 }
 interface BatchOptions {
     /** Default timeout for all steps (ms) */
     timeout?: number;
     /** How to handle failures */
     onFail?: 'stop' | 'continue';
+    /** Enable screenshot recording */
+    record?: RecordOptions;
 }
 interface StepResult {
     /** Step index */
@@ -1319,6 +1375,22 @@ interface StepResult {
     };
     /** AI-friendly suggestion for what to try next */
     suggestion?: string;
+    /** Absolute timestamp (ms since epoch) when this step completed */
+    timestamp?: number;
+    /** Viewport coordinates where the action occurred (center of interacted element) */
+    coordinates?: {
+        x: number;
+        y: number;
+    };
+    /** Element bounding box at time of action (viewport-relative) */
+    boundingBox?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Path to screenshot file captured after this step (when recording enabled) */
+    screenshotPath?: string;
 }
 interface BatchResult {
     /** Whether all steps succeeded */
@@ -1329,6 +1401,8 @@ interface BatchResult {
     steps: StepResult[];
     /** Total execution time in ms */
     totalDurationMs: number;
+    /** Path to recording manifest (when recording is enabled) */
+    recordingManifest?: string;
 }
 
-export { type ContinueRequestOptions as $, type ActionType as A, type BatchOptions as B, type CaptureResult as C, type Dialog as D, type ElementInfo as E, type FileInput as F, type GeolocationOptions as G, Page as H, type InteractiveElement as I, type PageError as J, type PageSnapshot as K, type SnapshotNode as L, type SnapshotOptions as M, NavigationError as N, type SubmitOptions as O, type PlayOptions as P, type TypeOptions as Q, type RequestPattern as R, type Step as S, TimeoutError as T, type UserAgentMetadata as U, type UserAgentOptions as V, type ViewportOptions as W, type WaitForOptions as X, type DeviceDescriptor as Y, type DeviceName as Z, devices as _, type RequestHandler as a, type FailRequestOptions as a0, type FulfillRequestOptions as a1, type InterceptedRequest as a2, type RequestActions as a3, type ResourceType as a4, type RouteOptions as a5, type ClearCookiesOptions as a6, type Cookie as a7, type DeleteCookieOptions as a8, type SetCookieOptions as a9, type WaitOptions as aa, type WaitResult as ab, type WaitState as ac, waitForAnyElement as ad, waitForElement as ae, waitForNavigation as af, waitForNetworkIdle as ag, type FailureHint as ah, type FailureReason as ai, type BatchResult as b, type StepResult as c, type AudioChunk as d, AudioInput as e, type AudioInputState as f, AudioOutput as g, type CaptureOptions as h, type RoundTripOptions as i, type RoundTripResult as j, type ActionOptions as k, type ActionResult as l, type ConsoleHandler as m, type ConsoleMessage as n, type ConsoleMessageType as o, type CustomSelectConfig as p, type DialogHandler as q, type DialogType as r, type Download as s, ElementNotFoundError as t, type EmulationState as u, type ErrorHandler as v, type FillOptions as w, type FormField as x, type FormOption as y, type NetworkIdleOptions as z };
+export { devices as $, type ActionType as A, type BatchOptions as B, type CaptureResult as C, type Dialog as D, type ElementInfo as E, type FileInput as F, type GeolocationOptions as G, type NetworkIdleOptions as H, type InteractiveElement as I, Page as J, type PageError as K, type PageSnapshot as L, type SnapshotNode as M, NavigationError as N, type SnapshotOptions as O, type PlayOptions as P, type SubmitOptions as Q, type RequestPattern as R, type Step as S, TimeoutError as T, type TypeOptions as U, type UserAgentMetadata as V, type UserAgentOptions as W, type ViewportOptions as X, type WaitForOptions as Y, type DeviceDescriptor as Z, type DeviceName as _, type RequestHandler as a, type ContinueRequestOptions as a0, type FailRequestOptions as a1, type FulfillRequestOptions as a2, type InterceptedRequest as a3, type RequestActions as a4, type ResourceType as a5, type RouteOptions as a6, type ClearCookiesOptions as a7, type Cookie as a8, type DeleteCookieOptions as a9, type SetCookieOptions as aa, type WaitOptions as ab, type WaitResult as ac, type WaitState as ad, waitForAnyElement as ae, waitForElement as af, waitForNavigation as ag, waitForNetworkIdle as ah, type FailureHint as ai, type FailureReason as aj, type BatchResult as b, type RecordOptions as c, type StepResult as d, type AudioChunk as e, AudioInput as f, type AudioInputState as g, AudioOutput as h, type CaptureOptions as i, type RoundTripOptions as j, type RoundTripResult as k, type ActionOptions as l, type ActionResult as m, type ConsoleHandler as n, type ConsoleMessage as o, type ConsoleMessageType as p, type CustomSelectConfig as q, type DialogHandler as r, type DialogType as s, type Download as t, ElementNotFoundError as u, type EmulationState as v, type ErrorHandler as w, type FillOptions as x, type FormField as y, type FormOption as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-pilot",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Lightweight CDP-based browser automation for Node.js, Bun, and Cloudflare Workers",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -68,7 +68,7 @@
     "fixtures:serve": "bun tests/fixtures/server.ts"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.10",
+    "@biomejs/biome": "^2.4.6",
     "@types/bun": "latest",
     "chrome-launcher": "^1.2.1",
     "oxlint": "^1.51.0",