browser-pilot 0.0.16 → 0.0.17

package/dist/actions.d.cts

@@ -1,6 +1,103 @@
-import { J as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-BflRmiDz.cjs';
-export { A as ActionType, aj as FailureReason, c as RecordOptions, d as StepResult } from './types-BflRmiDz.cjs';
-import './client-B5QBRgIy.cjs';
+import { W as Page, c as Condition, M as MatchedCondition, O as OutcomeStatus, S as Step, b as BatchOptions, B as BatchResult } from './types-Yuybzq53.cjs';
+export { A as ActionType, aw as FailureReason, d as RecordOptions, e as StepResult } from './types-Yuybzq53.cjs';
+import { C as CDPClient } from './client-B5QBRgIy.cjs';
+
+/**
+ * Condition evaluation for outcome-based execution
+ */
+
+/**
+ * Tracks network responses during step execution for networkResponse conditions
+ */
+declare class NetworkResponseTracker {
+    private responses;
+    private listening;
+    private handler;
+    start(cdp: CDPClient): void;
+    stop(cdp: CDPClient): void;
+    getResponses(): Array<{
+        url: string;
+        status: number;
+    }>;
+    reset(): void;
+}
+/**
+ * Capture a state signature for stateSignatureChanges condition.
+ * Uses page URL + visible text content hash as a lightweight fingerprint.
+ */
+declare function captureStateSignature(page: Page): Promise<string>;
+/**
+ * Evaluate a single condition against the current page state
+ */
+declare function evaluateCondition(condition: Condition, page: Page, context?: {
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<MatchedCondition>;
+/**
+ * Evaluate outcome conditions after a step has executed.
+ *
+ * Evaluation order:
+ * 1. failIf conditions (any match = 'failed')
+ * 2. expectAll conditions (all must match for success)
+ * 3. expectAny conditions (any match = success)
+ * 4. If no conditions matched and step mechanically succeeded, outcome is 'ambiguous'
+ *
+ * dangerous steps that result in 'ambiguous' get 'unsafe_to_retry'
+ */
+declare function evaluateOutcome(page: Page, options: {
+    expectAny?: Condition[];
+    expectAll?: Condition[];
+    failIf?: Condition[];
+    dangerous?: boolean;
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<{
+    outcomeStatus: OutcomeStatus;
+    matchedConditions: MatchedCondition[];
+    retrySafe: boolean;
+}>;
+
+/**
+ * Condition combinators for multi-path waits
+ */
+
+interface CombinatorResult {
+    matched: boolean;
+    matchedConditions: MatchedCondition[];
+    /** Which path won (for race/any) */
+    winnerIndex?: number;
+}
+/**
+ * any() — succeeds if ANY condition matches
+ */
+declare function conditionAny(conditions: Condition[], page: Page, context?: {
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<CombinatorResult>;
+/**
+ * all() — succeeds only if ALL conditions match
+ */
+declare function conditionAll(conditions: Condition[], page: Page, context?: {
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<CombinatorResult>;
+/**
+ * not() — inverts a single condition
+ */
+declare function conditionNot(condition: Condition, page: Page, context?: {
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<CombinatorResult>;
+/**
+ * race() — evaluates conditions with polling until one matches or timeout.
+ * Returns the first condition to match.
+ */
+declare function conditionRace(conditions: Condition[], page: Page, options?: {
+    timeout?: number;
+    pollInterval?: number;
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<CombinatorResult>;
 
 /**
  * Batch action executor
@@ -67,4 +164,4 @@ interface ValidationResult {
 }
 declare function validateSteps(steps: unknown[]): ValidationResult;
 
-export { BatchExecutor, BatchOptions, BatchResult, Step, type ValidationError, type ValidationResult, addBatchToPage, validateSteps };
+export { BatchExecutor, BatchOptions, BatchResult, type CombinatorResult, Condition, MatchedCondition, NetworkResponseTracker, OutcomeStatus, Step, type ValidationError, type ValidationResult, addBatchToPage, captureStateSignature, conditionAll, conditionAny, conditionNot, conditionRace, evaluateCondition, evaluateOutcome, validateSteps };

package/dist/actions.d.ts

@@ -1,6 +1,103 @@
-import { J as Page, S as Step, B as BatchOptions, b as BatchResult } from './types-BzM-IfsL.js';
-export { A as ActionType, aj as FailureReason, c as RecordOptions, d as StepResult } from './types-BzM-IfsL.js';
-import './client-B5QBRgIy.js';
+import { W as Page, c as Condition, M as MatchedCondition, O as OutcomeStatus, S as Step, b as BatchOptions, B as BatchResult } from './types-B_v62K7C.js';
+export { A as ActionType, aw as FailureReason, d as RecordOptions, e as StepResult } from './types-B_v62K7C.js';
+import { C as CDPClient } from './client-B5QBRgIy.js';
+
+/**
+ * Condition evaluation for outcome-based execution
+ */
+
+/**
+ * Tracks network responses during step execution for networkResponse conditions
+ */
+declare class NetworkResponseTracker {
+    private responses;
+    private listening;
+    private handler;
+    start(cdp: CDPClient): void;
+    stop(cdp: CDPClient): void;
+    getResponses(): Array<{
+        url: string;
+        status: number;
+    }>;
+    reset(): void;
+}
+/**
+ * Capture a state signature for stateSignatureChanges condition.
+ * Uses page URL + visible text content hash as a lightweight fingerprint.
+ */
+declare function captureStateSignature(page: Page): Promise<string>;
+/**
+ * Evaluate a single condition against the current page state
+ */
+declare function evaluateCondition(condition: Condition, page: Page, context?: {
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<MatchedCondition>;
+/**
+ * Evaluate outcome conditions after a step has executed.
+ *
+ * Evaluation order:
+ * 1. failIf conditions (any match = 'failed')
+ * 2. expectAll conditions (all must match for success)
+ * 3. expectAny conditions (any match = success)
+ * 4. If no conditions matched and step mechanically succeeded, outcome is 'ambiguous'
+ *
+ * dangerous steps that result in 'ambiguous' get 'unsafe_to_retry'
+ */
+declare function evaluateOutcome(page: Page, options: {
+    expectAny?: Condition[];
+    expectAll?: Condition[];
+    failIf?: Condition[];
+    dangerous?: boolean;
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<{
+    outcomeStatus: OutcomeStatus;
+    matchedConditions: MatchedCondition[];
+    retrySafe: boolean;
+}>;
+
+/**
+ * Condition combinators for multi-path waits
+ */
+
+interface CombinatorResult {
+    matched: boolean;
+    matchedConditions: MatchedCondition[];
+    /** Which path won (for race/any) */
+    winnerIndex?: number;
+}
+/**
+ * any() — succeeds if ANY condition matches
+ */
+declare function conditionAny(conditions: Condition[], page: Page, context?: {
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<CombinatorResult>;
+/**
+ * all() — succeeds only if ALL conditions match
+ */
+declare function conditionAll(conditions: Condition[], page: Page, context?: {
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<CombinatorResult>;
+/**
+ * not() — inverts a single condition
+ */
+declare function conditionNot(condition: Condition, page: Page, context?: {
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<CombinatorResult>;
+/**
+ * race() — evaluates conditions with polling until one matches or timeout.
+ * Returns the first condition to match.
+ */
+declare function conditionRace(conditions: Condition[], page: Page, options?: {
+    timeout?: number;
+    pollInterval?: number;
+    networkTracker?: NetworkResponseTracker;
+    beforeSignature?: string;
+}): Promise<CombinatorResult>;
 
 /**
  * Batch action executor
@@ -67,4 +164,4 @@ interface ValidationResult {
 }
 declare function validateSteps(steps: unknown[]): ValidationResult;
 
-export { BatchExecutor, BatchOptions, BatchResult, Step, type ValidationError, type ValidationResult, addBatchToPage, validateSteps };
+export { BatchExecutor, BatchOptions, BatchResult, type CombinatorResult, Condition, MatchedCondition, NetworkResponseTracker, OutcomeStatus, Step, type ValidationError, type ValidationResult, addBatchToPage, captureStateSignature, conditionAll, conditionAny, conditionNot, conditionRace, evaluateCondition, evaluateOutcome, validateSteps };

package/dist/actions.mjs

@@ -1,11 +1,27 @@
 import {
   BatchExecutor,
+  NetworkResponseTracker,
   addBatchToPage,
+  captureStateSignature,
+  conditionAll,
+  conditionAny,
+  conditionNot,
+  conditionRace,
+  evaluateCondition,
+  evaluateOutcome,
   validateSteps
-} from "./chunk-V3VLBQAM.mjs";
+} from "./chunk-ZDODXEBD.mjs";
 import "./chunk-JXAUPHZM.mjs";
 export {
   BatchExecutor,
+  NetworkResponseTracker,
   addBatchToPage,
+  captureStateSignature,
+  conditionAll,
+  conditionAny,
+  conditionNot,
+  conditionRace,
+  evaluateCondition,
+  evaluateOutcome,
   validateSteps
 };

package/dist/{browser-ZCR6AA4D.mjs → browser-4ZHNAQR5.mjs}

@@ -1,9 +1,9 @@
 import {
   Browser,
   connect
-} from "./chunk-TJ5B56NV.mjs";
+} from "./chunk-IRLHCVNH.mjs";
 import "./chunk-LCNFBXB5.mjs";
-import "./chunk-6GBYX7C2.mjs";
+import "./chunk-MRY3HRFJ.mjs";
 import "./chunk-DTVRFXKI.mjs";
 export {
   Browser,