browser-pilot 0.0.16 → 0.0.17

package/dist/index.d.cts

@@ -1,9 +1,9 @@
-export { BatchExecutor, ValidationError, ValidationResult, addBatchToPage, validateSteps } from './actions.cjs';
-import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-BflRmiDz.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-BflRmiDz.cjs';
+export { BatchExecutor, CombinatorResult, NetworkResponseTracker, ValidationError, ValidationResult, addBatchToPage, captureStateSignature, conditionAll, conditionAny, conditionNot, conditionRace, evaluateCondition, evaluateOutcome, validateSteps } from './actions.cjs';
+import { R as RequestPattern, a as RequestHandler, C as CaptureResult, B as BatchResult } from './types-Yuybzq53.cjs';
+export { m as ActionOptions, n as ActionResult, A as ActionType, f as AudioChunk, g as AudioInput, h as AudioInputState, i as AudioOutput, b as BatchOptions, j as CaptureOptions, ak as ClearCookiesOptions, c as Condition, o as ConsoleHandler, p as ConsoleMessage, q as ConsoleMessageType, ad as ContinueRequestOptions, al as Cookie, r as CustomSelectConfig, am as DeleteCookieOptions, D as DeltaChange, t as DeltaResult, aa as DeviceDescriptor, ab as DeviceName, u as Dialog, v as DialogHandler, w as DialogType, x as Download, E as ElementInfo, y as ElementNotFoundError, z as EmulationState, F as ErrorHandler, ae as FailRequestOptions, I as FileInput, J as FillOptions, K as FormField, L as FormOption, af as FulfillRequestOptions, N as GeolocationOptions, Q as InteractiveElement, ag as InterceptedRequest, T as KeyValuePair, M as MatchedCondition, U as NavigationError, V as NetworkIdleOptions, O as OutcomeStatus, W as Page, X as PageError, Y as PageSnapshot, Z as PageState, P as PlayOptions, d as RecordOptions, ah as RequestActions, ai as ResourceType, _ as ReviewResult, k as RoundTripOptions, l as RoundTripResult, aj as RouteOptions, an as SetCookieOptions, $ as SnapshotNode, a0 as SnapshotOptions, S as Step, e as StepResult, a1 as SubmitOptions, a2 as SummaryCard, a3 as TableData, a4 as TimeoutError, a5 as TypeOptions, a6 as UserAgentMetadata, a7 as UserAgentOptions, a8 as ViewportOptions, a9 as WaitForOptions, ao as WaitOptions, ap as WaitResult, aq as WaitState, s as computeDelta, ac as devices, G as extractPageState, H as extractReview, ar as waitForAnyElement, as as waitForElement, at as waitForNavigation, au as waitForNetworkIdle } from './types-Yuybzq53.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 { Browser, BrowserOptions, ComboboxConfig, ComboboxResult, OverlayInfo, PageOptions, PinRecoveryResult, SemanticFingerprint, SubmitAndVerifyOptions, SubmitAndVerifyResult, TargetFingerprint, UploadConfig, UploadResult, buildFingerprintMap, chooseOption, connect, createFingerprint, createTargetFingerprint, detectOverlay, fingerprintKey, fingerprintSimilarity, recoverPinnedTarget, recoverStaleRef, submitAndVerify, uploadFiles } from './browser.cjs';
 export { CDPError } from './cdp.cjs';
 export { BrowserBaseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.cjs';
 export { B as BrowserEndpointResolutionError, d as ChromeChannel, b as ConnectOptions, C as CreateSessionOptions, P as Provider, a as ProviderSession, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-DeVSWhXj.cjs';
@@ -290,4 +290,55 @@ declare function enableTracing(options?: Partial<Omit<TracerOptions, 'enabled'>>
  */
 declare function disableTracing(): void;
 
-export { type AudioFlagOptions, CDPClient, CaptureResult, RequestHandler, RequestInterceptor, RequestPattern, type TraceCategory, type TraceEvent, type TraceLevel, Tracer, type TracerOptions, type TranscribeOptions, type TranscribeResult, bufferToBase64, calculateRMS, disableTracing, enableTracing, generateSilence, generateTone, getAudioChromeFlags, getTracer, grantAudioPermissions, isTranscriptionAvailable, parseWavHeader, pcmToWav, transcribe };
+/**
+ * Workflow summary — business-readable execution evidence
+ */
+
+interface WorkflowStepSummary {
+    /** Step number (1-based) */
+    step: number;
+    /** Human-readable description */
+    description: string;
+    /** Whether this step succeeded */
+    success: boolean;
+    /** Duration in ms */
+    durationMs: number;
+    /** Outcome status if conditions were evaluated */
+    outcomeStatus?: string;
+    /** Summary of matched conditions */
+    outcomeEvidence?: string[];
+    /** Whether safe to retry */
+    retrySafe?: boolean;
+    /** Error if failed */
+    error?: string;
+    /** Suggestion for next action */
+    suggestion?: string;
+}
+interface WorkflowSummary {
+    /** Whether the entire workflow succeeded */
+    success: boolean;
+    /** Total steps */
+    totalSteps: number;
+    /** Steps that succeeded */
+    succeededSteps: number;
+    /** Steps that failed */
+    failedSteps: number;
+    /** Total duration */
+    totalDurationMs: number;
+    /** Per-step summaries */
+    steps: WorkflowStepSummary[];
+    /** Overall verdict */
+    verdict: string;
+    /** Retry safety of the entire workflow */
+    workflowRetrySafe: boolean;
+}
+/**
+ * Build a workflow summary from a batch result
+ */
+declare function buildWorkflowSummary(result: BatchResult): WorkflowSummary;
+/**
+ * Format a workflow summary as a compact text report
+ */
+declare function formatWorkflowSummary(summary: WorkflowSummary): string;
+
+export { type AudioFlagOptions, BatchResult, CDPClient, CaptureResult, RequestHandler, RequestInterceptor, RequestPattern, type TraceCategory, type TraceEvent, type TraceLevel, Tracer, type TracerOptions, type TranscribeOptions, type TranscribeResult, type WorkflowStepSummary, type WorkflowSummary, bufferToBase64, buildWorkflowSummary, calculateRMS, disableTracing, enableTracing, formatWorkflowSummary, generateSilence, generateTone, getAudioChromeFlags, getTracer, grantAudioPermissions, isTranscriptionAvailable, parseWavHeader, pcmToWav, transcribe };

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { BatchExecutor, ValidationError, ValidationResult, addBatchToPage, validateSteps } from './actions.js';
-import { R as RequestPattern, a as RequestHandler, C as CaptureResult } from './types-BzM-IfsL.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-BzM-IfsL.js';
+export { BatchExecutor, CombinatorResult, NetworkResponseTracker, ValidationError, ValidationResult, addBatchToPage, captureStateSignature, conditionAll, conditionAny, conditionNot, conditionRace, evaluateCondition, evaluateOutcome, validateSteps } from './actions.js';
+import { R as RequestPattern, a as RequestHandler, C as CaptureResult, B as BatchResult } from './types-B_v62K7C.js';
+export { m as ActionOptions, n as ActionResult, A as ActionType, f as AudioChunk, g as AudioInput, h as AudioInputState, i as AudioOutput, b as BatchOptions, j as CaptureOptions, ak as ClearCookiesOptions, c as Condition, o as ConsoleHandler, p as ConsoleMessage, q as ConsoleMessageType, ad as ContinueRequestOptions, al as Cookie, r as CustomSelectConfig, am as DeleteCookieOptions, D as DeltaChange, t as DeltaResult, aa as DeviceDescriptor, ab as DeviceName, u as Dialog, v as DialogHandler, w as DialogType, x as Download, E as ElementInfo, y as ElementNotFoundError, z as EmulationState, F as ErrorHandler, ae as FailRequestOptions, I as FileInput, J as FillOptions, K as FormField, L as FormOption, af as FulfillRequestOptions, N as GeolocationOptions, Q as InteractiveElement, ag as InterceptedRequest, T as KeyValuePair, M as MatchedCondition, U as NavigationError, V as NetworkIdleOptions, O as OutcomeStatus, W as Page, X as PageError, Y as PageSnapshot, Z as PageState, P as PlayOptions, d as RecordOptions, ah as RequestActions, ai as ResourceType, _ as ReviewResult, k as RoundTripOptions, l as RoundTripResult, aj as RouteOptions, an as SetCookieOptions, $ as SnapshotNode, a0 as SnapshotOptions, S as Step, e as StepResult, a1 as SubmitOptions, a2 as SummaryCard, a3 as TableData, a4 as TimeoutError, a5 as TypeOptions, a6 as UserAgentMetadata, a7 as UserAgentOptions, a8 as ViewportOptions, a9 as WaitForOptions, ao as WaitOptions, ap as WaitResult, aq as WaitState, s as computeDelta, ac as devices, G as extractPageState, H as extractReview, ar as waitForAnyElement, as as waitForElement, at as waitForNavigation, au as waitForNetworkIdle } from './types-B_v62K7C.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 { Browser, BrowserOptions, ComboboxConfig, ComboboxResult, OverlayInfo, PageOptions, PinRecoveryResult, SemanticFingerprint, SubmitAndVerifyOptions, SubmitAndVerifyResult, TargetFingerprint, UploadConfig, UploadResult, buildFingerprintMap, chooseOption, connect, createFingerprint, createTargetFingerprint, detectOverlay, fingerprintKey, fingerprintSimilarity, recoverPinnedTarget, recoverStaleRef, submitAndVerify, uploadFiles } from './browser.js';
 export { CDPError } from './cdp.js';
 export { BrowserBaseProvider, BrowserlessProvider, GenericProvider, createProvider, discoverTargets, getBrowserWebSocketUrl } from './providers.js';
 export { B as BrowserEndpointResolutionError, d as ChromeChannel, b as ConnectOptions, C as CreateSessionOptions, P as Provider, a as ProviderSession, R as ResolvedBrowserEndpoint, g as ResolvedBrowserSource, c as buildLocalBrowserScanTargets, f as discoverLocalBrowsers, p as parseDevToolsActivePortFile, r as resolveBrowserEndpoint, h as resolveChromeUserDataDirs } from './types-DeVSWhXj.js';
@@ -290,4 +290,55 @@ declare function enableTracing(options?: Partial<Omit<TracerOptions, 'enabled'>>
  */
 declare function disableTracing(): void;
 
-export { type AudioFlagOptions, CDPClient, CaptureResult, RequestHandler, RequestInterceptor, RequestPattern, type TraceCategory, type TraceEvent, type TraceLevel, Tracer, type TracerOptions, type TranscribeOptions, type TranscribeResult, bufferToBase64, calculateRMS, disableTracing, enableTracing, generateSilence, generateTone, getAudioChromeFlags, getTracer, grantAudioPermissions, isTranscriptionAvailable, parseWavHeader, pcmToWav, transcribe };
+/**
+ * Workflow summary — business-readable execution evidence
+ */
+
+interface WorkflowStepSummary {
+    /** Step number (1-based) */
+    step: number;
+    /** Human-readable description */
+    description: string;
+    /** Whether this step succeeded */
+    success: boolean;
+    /** Duration in ms */
+    durationMs: number;
+    /** Outcome status if conditions were evaluated */
+    outcomeStatus?: string;
+    /** Summary of matched conditions */
+    outcomeEvidence?: string[];
+    /** Whether safe to retry */
+    retrySafe?: boolean;
+    /** Error if failed */
+    error?: string;
+    /** Suggestion for next action */
+    suggestion?: string;
+}
+interface WorkflowSummary {
+    /** Whether the entire workflow succeeded */
+    success: boolean;
+    /** Total steps */
+    totalSteps: number;
+    /** Steps that succeeded */
+    succeededSteps: number;
+    /** Steps that failed */
+    failedSteps: number;
+    /** Total duration */
+    totalDurationMs: number;
+    /** Per-step summaries */
+    steps: WorkflowStepSummary[];
+    /** Overall verdict */
+    verdict: string;
+    /** Retry safety of the entire workflow */
+    workflowRetrySafe: boolean;
+}
+/**
+ * Build a workflow summary from a batch result
+ */
+declare function buildWorkflowSummary(result: BatchResult): WorkflowSummary;
+/**
+ * Format a workflow summary as a compact text report
+ */
+declare function formatWorkflowSummary(summary: WorkflowSummary): string;
+
+export { type AudioFlagOptions, BatchResult, CDPClient, CaptureResult, RequestHandler, RequestInterceptor, RequestPattern, type TraceCategory, type TraceEvent, type TraceLevel, Tracer, type TracerOptions, type TranscribeOptions, type TranscribeResult, type WorkflowStepSummary, type WorkflowSummary, bufferToBase64, buildWorkflowSummary, calculateRMS, disableTracing, enableTracing, formatWorkflowSummary, generateSilence, generateTone, getAudioChromeFlags, getTracer, grantAudioPermissions, isTranscriptionAvailable, parseWavHeader, pcmToWav, transcribe };

package/dist/index.mjs

@@ -5,18 +5,30 @@ import {
   Page,
   RequestInterceptor,
   bufferToBase64,
+  buildFingerprintMap,
   calculateRMS,
+  computeDelta,
   connect,
+  createFingerprint,
+  createTargetFingerprint,
+  detectOverlay,
+  extractPageState,
+  extractReview,
+  fingerprintKey,
+  fingerprintSimilarity,
   generateSilence,
   generateTone,
   grantAudioPermissions,
   parseWavHeader,
   pcmToWav,
+  recoverPinnedTarget,
+  recoverStaleRef,
+  submitAndVerify,
   waitForAnyElement,
   waitForElement,
   waitForNavigation,
   waitForNetworkIdle
-} from "./chunk-NNEHWWHL.mjs";
+} from "./chunk-FEEGNSHB.mjs";
 import {
   BrowserBaseProvider,
   BrowserEndpointResolutionError,
@@ -38,13 +50,27 @@ import {
   BatchExecutor,
   ElementNotFoundError,
   NavigationError,
+  NetworkResponseTracker,
   TimeoutError,
   addBatchToPage,
+  captureStateSignature,
+  conditionAll,
+  conditionAny,
+  conditionNot,
+  conditionRace,
+  evaluateCondition,
+  evaluateOutcome,
   validateSteps
-} from "./chunk-V3VLBQAM.mjs";
+} from "./chunk-ZDODXEBD.mjs";
 import {
   CDPError
 } from "./chunk-JXAUPHZM.mjs";
+import {
+  chooseOption
+} from "./chunk-MIJ7UIKB.mjs";
+import {
+  uploadFiles
+} from "./chunk-OIHU7OFY.mjs";
 
 // src/audio/flags.ts
 function getAudioChromeFlags(options) {
@@ -376,6 +402,143 @@ function disableTracing() {
     globalTracer.disable();
   }
 }
+
+// src/trace/workflow-summary.ts
+function describeStep(result) {
+  const action = result.action;
+  const selector = result.selectorUsed ?? (Array.isArray(result.selector) ? result.selector[0] : result.selector);
+  switch (action) {
+    case "goto":
+      return "Navigate to page";
+    case "click":
+      return `Click ${selector ? `"${selector}"` : "element"}`;
+    case "fill":
+      return `Fill ${selector ? `"${selector}"` : "field"}`;
+    case "type":
+      return `Type into ${selector ? `"${selector}"` : "field"}`;
+    case "select":
+      return `Select option in ${selector ? `"${selector}"` : "dropdown"}`;
+    case "submit":
+      return `Submit ${selector ? `"${selector}"` : "form"}`;
+    case "check":
+      return `Check ${selector ? `"${selector}"` : "checkbox"}`;
+    case "uncheck":
+      return `Uncheck ${selector ? `"${selector}"` : "checkbox"}`;
+    case "press":
+      return "Press key";
+    case "shortcut":
+      return "Keyboard shortcut";
+    case "hover":
+      return `Hover over ${selector ? `"${selector}"` : "element"}`;
+    case "scroll":
+      return `Scroll ${selector ? `"${selector}"` : "page"}`;
+    case "wait":
+      return `Wait for ${selector ? `"${selector}"` : "condition"}`;
+    case "snapshot":
+      return "Capture accessibility snapshot";
+    case "screenshot":
+      return "Take screenshot";
+    case "forms":
+      return "Enumerate form fields";
+    case "evaluate":
+      return "Execute JavaScript";
+    case "text":
+      return "Extract text content";
+    case "review":
+      return "Extract page review";
+    case "delta":
+      return "Capture page delta";
+    default:
+      return `${action}${selector ? ` "${selector}"` : ""}`;
+  }
+}
+function summarizeConditions(conditions) {
+  return conditions.filter((c) => c.detail).map((c) => {
+    const status = c.matched ? "\u2713" : "\u2717";
+    return `${status} ${c.detail}`;
+  });
+}
+function buildWorkflowSummary(result) {
+  const steps = result.steps.map((s) => {
+    const step = {
+      step: s.index + 1,
+      description: describeStep(s),
+      success: s.success,
+      durationMs: s.durationMs
+    };
+    if (s.outcomeStatus) {
+      step.outcomeStatus = s.outcomeStatus;
+      step.retrySafe = s.retrySafe;
+    }
+    if (s.matchedConditions && s.matchedConditions.length > 0) {
+      step.outcomeEvidence = summarizeConditions(s.matchedConditions);
+    }
+    if (s.error) step.error = s.error;
+    if (s.suggestion) step.suggestion = s.suggestion;
+    return step;
+  });
+  const succeededSteps = steps.filter((s) => s.success).length;
+  const failedSteps = steps.filter((s) => !s.success).length;
+  const hasUnsafeStep = steps.some(
+    (s) => s.retrySafe === false || s.outcomeStatus === "unsafe_to_retry"
+  );
+  const workflowRetrySafe = !hasUnsafeStep;
+  let verdict;
+  if (result.success) {
+    verdict = `Workflow completed successfully (${succeededSteps}/${steps.length} steps)`;
+  } else if (result.stoppedAtIndex !== void 0) {
+    const failedStep = steps[result.stoppedAtIndex];
+    verdict = `Workflow stopped at step ${result.stoppedAtIndex + 1}: ${failedStep?.description ?? "unknown"}`;
+    if (failedStep?.outcomeStatus) {
+      verdict += ` (outcome: ${failedStep.outcomeStatus})`;
+    }
+  } else {
+    verdict = `Workflow completed with ${failedSteps} failure(s)`;
+  }
+  return {
+    success: result.success,
+    totalSteps: steps.length,
+    succeededSteps,
+    failedSteps,
+    totalDurationMs: result.totalDurationMs,
+    steps,
+    verdict,
+    workflowRetrySafe
+  };
+}
+function formatWorkflowSummary(summary) {
+  const lines = [];
+  lines.push(`## Workflow ${summary.success ? "Succeeded" : "Failed"}`);
+  lines.push(`${summary.verdict}`);
+  lines.push(
+    `Duration: ${summary.totalDurationMs}ms | Steps: ${summary.succeededSteps}/${summary.totalSteps} passed`
+  );
+  if (!summary.workflowRetrySafe) {
+    lines.push("\u26A0 Contains unsafe-to-retry steps");
+  }
+  lines.push("");
+  for (const step of summary.steps) {
+    const icon = step.success ? "\u2713" : "\u2717";
+    lines.push(`${icon} Step ${step.step}: ${step.description} (${step.durationMs}ms)`);
+    if (step.outcomeStatus) {
+      lines.push(
+        `  Outcome: ${step.outcomeStatus}${step.retrySafe === false ? " (unsafe to retry)" : ""}`
+      );
+    }
+    if (step.outcomeEvidence) {
+      for (const evidence of step.outcomeEvidence) {
+        lines.push(`  ${evidence}`);
+      }
+    }
+    if (step.error) {
+      lines.push(`  Error: ${step.error}`);
+    }
+    if (step.suggestion) {
+      lines.push(`  \u2192 ${step.suggestion}`);
+    }
+  }
+  return lines.join("\n");
+}
 export {
   AudioInput,
   AudioOutput,
@@ -388,22 +551,42 @@ export {
   ElementNotFoundError,
   GenericProvider,
   NavigationError,
+  NetworkResponseTracker,
   Page,
   RequestInterceptor,
   TimeoutError,
   Tracer,
   addBatchToPage,
   bufferToBase64,
+  buildFingerprintMap,
   buildLocalBrowserScanTargets,
+  buildWorkflowSummary,
   calculateRMS,
+  captureStateSignature,
+  chooseOption,
+  computeDelta,
+  conditionAll,
+  conditionAny,
+  conditionNot,
+  conditionRace,
   connect,
   createCDPClient,
+  createFingerprint,
   createProvider,
+  createTargetFingerprint,
+  detectOverlay,
   devices,
   disableTracing,
   discoverLocalBrowsers,
   discoverTargets,
   enableTracing,
+  evaluateCondition,
+  evaluateOutcome,
+  extractPageState,
+  extractReview,
+  fingerprintKey,
+  fingerprintSimilarity,
+  formatWorkflowSummary,
   generateSilence,
   generateTone,
   getAudioChromeFlags,
@@ -414,9 +597,13 @@ export {
   parseDevToolsActivePortFile,
   parseWavHeader,
   pcmToWav,
+  recoverPinnedTarget,
+  recoverStaleRef,
   resolveBrowserEndpoint,
   resolveChromeUserDataDirs,
+  submitAndVerify,
   transcribe,
+  uploadFiles,
   validateSteps,
   waitForAnyElement,
   waitForElement,

package/dist/{page-IUUTJ3SW.mjs → page-SD64DY3F.mjs}

@@ -1,6 +1,6 @@
 import {
   Page
-} from "./chunk-6GBYX7C2.mjs";
+} from "./chunk-MRY3HRFJ.mjs";
 import "./chunk-DTVRFXKI.mjs";
 export {
   Page

package/dist/{types-BzM-IfsL.d.ts → types-B_v62K7C.d.ts}

@@ -718,6 +718,88 @@ interface ClearCookiesOptions {
     domain?: string;
 }
 
+/**
+ * Delta extraction — compares page state before/after actions
+ */
+
+interface PageState {
+    url: string;
+    title: string;
+    headings: string[];
+    formFields: Array<{
+        label?: string;
+        name?: string;
+        id?: string;
+        value: unknown;
+        type: string;
+    }>;
+    buttons: Array<{
+        text: string;
+        disabled: boolean;
+        ref?: string;
+    }>;
+    alerts: string[];
+    visibleText: string;
+}
+interface DeltaChange {
+    kind: 'url' | 'title' | 'heading_added' | 'heading_removed' | 'field_changed' | 'button_changed' | 'alert_added' | 'alert_removed' | 'text_changed';
+    before?: string;
+    after?: string;
+    detail?: string;
+}
+interface DeltaResult {
+    changes: DeltaChange[];
+    before: PageState;
+    after: PageState;
+    hasChanges: boolean;
+}
+/**
+ * Extract a lightweight page state from snapshot + forms data.
+ * Used for delta comparison.
+ */
+declare function extractPageState(url: string, title: string, snapshot: PageSnapshot, forms: FormField[], pageText: string): PageState;
+/**
+ * Compute delta between two page states
+ */
+declare function computeDelta(before: PageState, after: PageState): DeltaResult;
+
+/**
+ * Review surface extraction — structured business state from current page
+ */
+
+interface KeyValuePair {
+    key: string;
+    value: string;
+}
+interface SummaryCard {
+    heading?: string;
+    items: KeyValuePair[];
+}
+interface TableData {
+    headers: string[];
+    rows: string[][];
+}
+interface ReviewResult {
+    url: string;
+    title: string;
+    headings: string[];
+    forms: Array<{
+        label?: string;
+        value: unknown;
+        type: string;
+        disabled: boolean;
+    }>;
+    alerts: string[];
+    summaryCards: SummaryCard[];
+    tables: TableData[];
+    keyValues: KeyValuePair[];
+    statusLabels: string[];
+}
+/**
+ * Extract review surface from page state
+ */
+declare function extractReview(url: string, title: string, snapshot: PageSnapshot, forms: FormField[], pageText: string): ReviewResult;
+
 /**
  * Page class - provides high-level browser automation API
  */
@@ -970,6 +1052,22 @@ declare class Page {
      * Import a ref map previously captured from a snapshot.
      */
     importRefMap(refMap: Record<string, number>): void;
+    /**
+     * Capture current page state for delta comparison.
+     * Call before an action, then call delta() again after and use computeDelta().
+     */
+    captureState(): Promise<PageState>;
+    /**
+     * Compute what changed between two page states.
+     * If no arguments: captures current state and returns it (for use as "before").
+     * If one argument (before state): captures current state and computes delta.
+     */
+    delta(before?: PageState): Promise<DeltaResult | PageState>;
+    /**
+     * Extract structured review surface from the current page.
+     * Returns headings, form values, alerts, key-value pairs, tables, and status labels.
+     */
+    review(): Promise<ReviewResult>;
     /**
      * Execute a batch of steps
      */
@@ -1247,7 +1345,37 @@ 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' | 'waitForWsMessage' | 'assertNoConsoleErrors' | 'assertTextChanged' | 'assertPermission' | 'assertMediaTrackLive';
+type OutcomeStatus = 'success' | 'failed' | 'ambiguous' | 'unsafe_to_retry';
+type Condition = {
+    kind: 'urlMatches';
+    pattern: string;
+} | {
+    kind: 'elementVisible';
+    selector: string | string[];
+} | {
+    kind: 'elementHidden';
+    selector: string | string[];
+} | {
+    kind: 'textAppears';
+    selector?: string | string[];
+    text: string;
+} | {
+    kind: 'textChanges';
+    selector?: string | string[];
+    to?: string;
+} | {
+    kind: 'networkResponse';
+    urlPattern: string;
+    status?: number;
+} | {
+    kind: 'stateSignatureChanges';
+};
+interface MatchedCondition {
+    condition: Condition;
+    matched: boolean;
+    detail?: string;
+}
+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' | 'delta' | 'review' | 'chooseOption' | 'upload';
 interface Step {
     /** Action type */
     action: ActionType;
@@ -1314,8 +1442,18 @@ interface Step {
     state?: string;
     /** Media track kind */
     kind?: 'audio' | 'video';
+    /** File paths for upload action */
+    files?: string[];
     /** Assertion observation window in milliseconds */
     windowMs?: number;
+    /** Conditions where ANY matching means success */
+    expectAny?: Condition[];
+    /** Conditions where ALL must match for success */
+    expectAll?: Condition[];
+    /** Conditions that indicate failure (checked before success conditions) */
+    failIf?: Condition[];
+    /** Mark step as dangerous - never auto-retry after ambiguous outcome */
+    dangerous?: boolean;
 }
 interface RecordOptions {
     /** Base directory for screenshots and recording.json. */
@@ -1391,6 +1529,12 @@ interface StepResult {
     };
     /** Path to screenshot file captured after this step (when recording enabled) */
     screenshotPath?: string;
+    /** Outcome classification when conditions were specified */
+    outcomeStatus?: OutcomeStatus;
+    /** Which conditions matched during evaluation */
+    matchedConditions?: MatchedCondition[];
+    /** Whether it's safe to retry this step */
+    retrySafe?: boolean;
 }
 interface BatchResult {
     /** Whether all steps succeeded */
@@ -1405,4 +1549,4 @@ interface BatchResult {
     recordingManifest?: string;
 }
 
-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 };
+export { type SnapshotNode as $, type ActionType as A, type BatchResult as B, type CaptureResult as C, type DeltaChange as D, type ElementInfo as E, type ErrorHandler as F, extractPageState as G, extractReview as H, type FileInput as I, type FillOptions as J, type FormField as K, type FormOption as L, type MatchedCondition as M, type GeolocationOptions as N, type OutcomeStatus as O, type PlayOptions as P, type InteractiveElement as Q, type RequestPattern as R, type Step as S, type KeyValuePair as T, NavigationError as U, type NetworkIdleOptions as V, Page as W, type PageError as X, type PageSnapshot as Y, type PageState as Z, type ReviewResult as _, type RequestHandler as a, type SnapshotOptions as a0, type SubmitOptions as a1, type SummaryCard as a2, type TableData as a3, TimeoutError as a4, type TypeOptions as a5, type UserAgentMetadata as a6, type UserAgentOptions as a7, type ViewportOptions as a8, type WaitForOptions as a9, type DeviceDescriptor as aa, type DeviceName as ab, devices as ac, type ContinueRequestOptions as ad, type FailRequestOptions as ae, type FulfillRequestOptions as af, type InterceptedRequest as ag, type RequestActions as ah, type ResourceType as ai, type RouteOptions as aj, type ClearCookiesOptions as ak, type Cookie as al, type DeleteCookieOptions as am, type SetCookieOptions as an, type WaitOptions as ao, type WaitResult as ap, type WaitState as aq, waitForAnyElement as ar, waitForElement as as, waitForNavigation as at, waitForNetworkIdle as au, type FailureHint as av, type FailureReason as aw, type BatchOptions as b, type Condition as c, type RecordOptions as d, type StepResult as e, type AudioChunk as f, AudioInput as g, type AudioInputState as h, AudioOutput as i, type CaptureOptions as j, type RoundTripOptions as k, type RoundTripResult as l, type ActionOptions as m, type ActionResult as n, type ConsoleHandler as o, type ConsoleMessage as p, type ConsoleMessageType as q, type CustomSelectConfig as r, computeDelta as s, type DeltaResult as t, type Dialog as u, type DialogHandler as v, type DialogType as w, type Download as x, ElementNotFoundError as y, type EmulationState as z };