@applitools/nlp-web-runner 5.16.0 → 5.18.0

package/dist/_inline/nlp-runner/web/index.d.ts

@@ -1,10 +1,143 @@
 import { Dispatcher, WebSocket } from "undici";
+import { Buffer as Buffer$1 } from "node:buffer";
 import { Readable } from "node:stream";
 import { Har } from "chrome-har";
 import { Protocol } from "devtools-protocol";
 type WebDriver = never;
 import { ProtocolMapping } from "devtools-protocol/types/protocol-mapping.js";
-
+//#region dist/_inline/_chunks/node-C7YXPHYp.d.ts
+//#region src/automator.d.ts
+/**
+ * How a screenshot is encoded. The automator holds no preference of its own - whoever takes the
+ * picture says what it wants, so a consumer that wants one kind of image for a whole run keeps that
+ * decision (see the runner's `screenshot` option) instead of setting a mode on the session.
+ */
+type ScreenshotOptions = {
+  format?: 'png' | 'jpeg' | 'webp';
+  quality?: number;
+};
+type StabilizationStage = 'basic' | 'strict' | 'paranoid';
+interface Automator {
+  readonly type: 'web' | 'mobile';
+  readonly blocked: boolean;
+  captureScreenshot(options?: ScreenshotOptions): Promise<string>;
+  stabilize(stage: StabilizationStage, options?: {
+    signal?: AbortSignal;
+    timeout?: number;
+  }): Promise<void>;
+} //#endregion
+//#region src/node.d.ts
+interface Node {
+  equal(node: Node): Promise<boolean>;
+  click(options?: {
+    simulate?: boolean;
+    signal?: AbortSignal;
+    button?: 'left' | 'middle' | 'right' | 'back' | 'forward';
+    times?: number;
+  }): Promise<void>;
+  focus(): Promise<boolean>;
+  type(text: string): Promise<void>;
+  isContentEditable(): Promise<boolean>;
+  setCaretPosition(position: 'beginning' | 'end'): Promise<void>;
+  canTypeInto(): Promise<boolean>;
+  getBox(): Promise<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  }>;
+  getScreenBox(): Promise<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  }>;
+  getContentBoxes(): Promise<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  }[]>;
+  isVisible(): Promise<boolean>;
+  getText(): Promise<string | null>;
+  getValue(options?: {
+    hint?: string;
+    acceptFormValue?: boolean;
+  }): Promise<any>;
+  isEnabled(): Promise<boolean | null>;
+  isHovered(): Promise<boolean | null>;
+  getObscurationInfo(): Promise<{
+    ratio?: number;
+    obscuringElement?: any;
+  }>;
+  getDescription(): Promise<string>;
+} //#endregion
+//#endregion
+//#region dist/_inline/automator/index.d.ts
+//#region src/error.d.ts
+declare class AbortError extends Error {
+  readonly retriable: boolean;
+  constructor(message: string, options?: ErrorOptions & {
+    retriable?: boolean;
+  });
+}
+declare class FlushError extends Error {}
+declare abstract class AutomatorError extends Error {
+  constructor(message: string);
+}
+declare class NavigationFailedError extends AutomatorError {
+  readonly url: string;
+  readonly reason: string;
+  constructor({
+    url,
+    reason
+  }: {
+    url: string;
+    reason: string;
+  });
+}
+declare class NavigationTimedOutError extends AutomatorError {
+  readonly url: string;
+  readonly timeout: number;
+  constructor({
+    url,
+    timeout
+  }: {
+    url: string;
+    timeout: number;
+  });
+}
+declare class NoHistoryEntryError extends AutomatorError {
+  readonly offset: number;
+  constructor({
+    offset
+  }: {
+    offset: number;
+  });
+}
+declare class BodyConsumedError extends AutomatorError {
+  readonly accessor: string;
+  constructor({
+    accessor
+  }: {
+    accessor: string;
+  });
+}
+declare class CommandTimedOutError extends AutomatorError {
+  readonly method: string;
+  readonly commandId: number;
+  readonly sessionId?: string;
+  constructor({
+    method,
+    commandId,
+    sessionId
+  }: {
+    method: string;
+    commandId: number;
+    sessionId?: string;
+  });
+} //#endregion
+//#endregion
 //#region ../parser/dist/types.d.ts
 type SetPreinstructionsControlFlow = {
   type: 'set preinstructions';
@@ -19,6 +152,12 @@ type TryControlFlow = {
 };
 type InitializeScopeControlFlow = {
   type: 'initialize scope';
+  /**
+   * What the name refers to. Absent means a program (or a test, the Autonomous wording for the
+   * same thing); `'function'` means a `function "..."` block, addressed as `name` in the calling
+   * file or `path#name` in another one.
+   */
+  kind?: 'function';
   name: string;
   parameters?: {
     name: string;
@@ -67,7 +206,7 @@ type SetVariableAction = {
     secret?: boolean;
   }[];
   data: {
-    value: AnyExpression | ExtractOperation | Generator$1 | SizeOperation;
+    value: AnyExpression | ExtractOperation | Generator$1 | SizeOperation | FileSource;
     secret?: boolean;
   };
   scope?: 'public' | 'internal';
@@ -97,11 +236,23 @@ type FetchAction = {
     secret: boolean;
   }[];
   body?: {
-    type?: 'json' | 'xml' | 'base64';
+    type?: 'json' | 'xml' | 'csv' | 'base64';
     data: AnyExpression;
   };
   statuses?: number[] | '*';
 };
+type WriteFileAction = {
+  type: 'write file';
+  file: FileHandle;
+  data: AnyExpression | ExtractOperation;
+  format?: FileFormat; /** Set by `append ... to the file`; absent overwrites. */
+  append?: boolean;
+  secret?: boolean;
+};
+type RemoveFileAction = {
+  type: 'remove file';
+  file: FileHandle;
+};
 type AssertAction = {
   type: 'assert';
   condition: Condition;
@@ -250,7 +401,7 @@ type IntentAction = {
   type: 'intent';
   description: string;
 };
-type Action<TType extends string> = Extract<EmptyAction | CommentAction | SetVariableAction | SetValueAction | FetchAction | AssertAction | EvaluateAction | FocusAction | CheckAction | ClearAction | EraseAction | TypeAction | HitKeyAction | SearchAction | ClickElementAction | ClickChromeElementAction | ClickDialogElementAction | HoverAction | ScrollByDistanceAction | ScrollByFractionAction | ScrollToPositionAction | ScrollToElementAction | ScrollTheElementAction | NavigateToUrlAction | NavigateThroughHistoryAction | NavigatePdfAction | RefreshAction | CreateTargetAction | CloseAction | SwitchAction | WaitAction | GoAction | FindAction | VisualCheckAction | IntentAction, {
+type Action<TType extends string> = Extract<EmptyAction | CommentAction | SetVariableAction | SetValueAction | WriteFileAction | RemoveFileAction | FetchAction | AssertAction | EvaluateAction | FocusAction | CheckAction | ClearAction | EraseAction | TypeAction | HitKeyAction | SearchAction | ClickElementAction | ClickChromeElementAction | ClickDialogElementAction | HoverAction | ScrollByDistanceAction | ScrollByFractionAction | ScrollToPositionAction | ScrollToElementAction | ScrollTheElementAction | NavigateToUrlAction | NavigateThroughHistoryAction | NavigatePdfAction | RefreshAction | CreateTargetAction | CloseAction | SwitchAction | WaitAction | GoAction | FindAction | VisualCheckAction | IntentAction, {
   type: TType;
 }>;
 type Instruction = Action<any> | ControlFlow;
@@ -334,6 +485,22 @@ type FileHandle = {
   isFileHandle: true;
   filename: StringExpression;
 };
+/**
+ * How a file's bytes are read as data. `csv` is never inferred from content - any prose with a
+ * comma looks like CSV - so it only arrives from the format word or a `.csv` name.
+ */
+type FileFormat = 'json' | 'xml' | 'csv' | 'base64' | 'text';
+/**
+ * A value read from a file, like {@link Generator} a value-producer rather than an action: the
+ * runner resolves it while evaluating the expression it sits in, so `read the csv file "u.csv"`
+ * is a set-variable whose value is this.
+ */
+type FileSource = {
+  isFileSource: true;
+  file: FileHandle;
+  format?: FileFormat;
+  secret?: boolean;
+};
 type NumberExpression = number | NumberOperation | Reference<number> | JSExpressionReference<number>;
 type StringExpression = string | InterpolatedString | Reference<string> | JSExpressionReference<string>;
 type Any = null | boolean | number | string | {
@@ -347,10 +514,10 @@ type Condition = {
 type Operation = ConditionOperation | ExpressionOperation;
 type ExpressionOperation = SizeOperation | KeysOperation | ValuesOperation | EntriesOperation | NumberOperation | ExtractOperation | MapOperation | EveryOperation | SomeOperation;
 type NumberOperation = AddOperation | SubOperation | MulOperation | DivOperation;
-type ConditionOperation = ParensOperation | IgnoreCaseOperation | MatchCaseOperation | NotOperation | OrOperation | AndOperation | ComparisonOperation | ValidateOperation | MatchOperation | IncludesOnlyOperation | IncludesOperation | StartsWithOperation | EndsWithOperation | VisibleOperation | ClickableOperation | EnabledOperation | HoveredOperation | CheckedOperation | PopulatedOperation | EveryOperation | SomeOperation;
+type ConditionOperation = ParensOperation | IgnoreCaseOperation | MatchCaseOperation | NotOperation | OrOperation | AndOperation | ComparisonOperation | ValidateOperation | MatchOperation | IncludesOnlyOperation | IncludesOperation | StartsWithOperation | EndsWithOperation | VisibleOperation | ClickableOperation | EnabledOperation | HoveredOperation | CheckedOperation | PopulatedOperation | FileExistsOperation | EveryOperation | SomeOperation;
 type Operand = {
   isOperand: true;
-  value: AnyExpression | ElementDescriptor | ElementReference | DialogDescriptor | ExpressionOperation;
+  value: AnyExpression | ElementDescriptor | ElementReference | DialogDescriptor | ExpressionOperation | FileHandle;
 };
 type ParensOperation = {
   operator: 'parens';
@@ -491,6 +658,11 @@ type PopulatedOperation = {
   operator: 'populated';
   operands: [Operand];
 };
+/** `the file "session.json" exists` - the operand's value is a {@link FileHandle}. */
+type FileExistsOperation = {
+  operator: 'file exists';
+  operands: [Operand];
+};
 type ElementScrollDirection = 'horizontal' | 'vertical' | 'both';
 type ElementDescriptor = {
   nth?: NumberExpression;
@@ -598,64 +770,6 @@ type Superlative = 'smallest' | 'largest' | 'widest' | 'narrowest' | 'tallest' |
 type AbsolutePosition = 'inside' | 'center' | 'top' | 'bottom' | 'left' | 'right' | 'topleft' | 'topright' | 'bottomleft' | 'bottomright';
 type RelativePosition = 'near' | 'above' | 'below' | 'leftof' | 'rightof' | 'aboveleftof' | 'aboverightof' | 'belowleftof' | 'belowrightof';
 //#endregion
-//#region dist/_inline/_chunks/node-Cd1bkA9w.d.ts
-//#region src/automator.d.ts
-interface Automator {
-  readonly type: 'web' | 'mobile';
-  readonly blocked: boolean;
-  captureScreenshot(): Promise<string>;
-  stabilize(stage: 'basic' | 'strict' | 'paranoid', options?: {
-    signal?: AbortSignal;
-    timeout?: number;
-  }): Promise<void>;
-} //#endregion
-//#region src/node.d.ts
-interface Node {
-  equal(node: Node): Promise<boolean>;
-  click(options?: {
-    simulate?: boolean;
-    signal?: AbortSignal;
-    button?: 'left' | 'middle' | 'right' | 'back' | 'forward';
-    times?: number;
-  }): Promise<void>;
-  focus(): Promise<boolean>;
-  type(text: string): Promise<void>;
-  isContentEditable(): Promise<boolean>;
-  setCaretPosition(position: 'beginning' | 'end'): Promise<void>;
-  canTypeInto(): Promise<boolean>;
-  getBox(): Promise<{
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-  }>;
-  getScreenBox(): Promise<{
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-  }>;
-  getContentBoxes(): Promise<{
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-  }[]>;
-  isVisible(): Promise<boolean>;
-  getText(): Promise<string | null>;
-  getValue(options?: {
-    hint?: string;
-    acceptFormValue?: boolean;
-  }): Promise<any>;
-  isEnabled(): Promise<boolean | null>;
-  isHovered(): Promise<boolean | null>;
-  getObscurationInfo(): Promise<{
-    ratio?: number;
-    obscuringElement?: any;
-  }>;
-  getDescription(): Promise<string>;
-} //#endregion
-//#endregion
 //#region dist/_inline/utils/index.d.ts
 //#region src/event-target.d.ts
 type EventTargetEventMap<TEventMap extends Record<string, Event>> = TEventMap & {
@@ -836,7 +950,7 @@ declare class Rectangle {
 //#region src/patterns.d.ts
 type Match = (text: string) => string | null;
 //#endregion
-//#region dist/_inline/_chunks/script-Ce-wnPrw.d.ts
+//#region dist/_inline/_chunks/script-D0b_S3Kf.d.ts
 //#region src/port.d.ts
 interface PortMessageEvent<TName extends string = string, TPayload = unknown> extends Event {
   readonly name: TName;
@@ -1222,7 +1336,12 @@ declare class RemoteFunctionHandle<TFunc extends (...args: any[]) => any> extend
   resolve(): Promise<ResolvedRemoteValue<TFunc>>;
   call(...args: Parameters<TFunc>): Promise<ResolvedRemoteValue<ReturnType<TFunc>>>;
 }
-declare class StaleRemoteObjectHandleError extends Error {} //#endregion
+declare class StaleRemoteObjectHandleError extends Error {}
+declare function previewRemoteValue(value: RemoteValue, {
+  maxLength
+}?: {
+  maxLength?: number;
+}): string; //#endregion
 //#region src/web/node.d.ts
 type NodeOptions$2 = {
   evaluator: Evaluator;
@@ -1445,7 +1564,7 @@ declare class Browser extends EventTargetNode<BrowserEventMap> implements Automa
   }: BrowserOptions);
   targets(): Generator<Target, void, unknown>;
   pages(): Generator<Target, void, unknown>;
-  stabilize(stage: 'basic' | 'strict' | 'paranoid', {
+  stabilize(stage: StabilizationStage, {
     signal,
     timeout
   }?: {
@@ -1481,7 +1600,7 @@ declare class Browser extends EventTargetNode<BrowserEventMap> implements Automa
     width: number;
     height: number;
   }): Promise<void>;
-  captureScreenshot(): Promise<string>;
+  captureScreenshot(options?: ScreenshotOptions): Promise<string>;
   hideFilepickers(hide?: boolean): Promise<void>;
   close(): Promise<void>;
 }
@@ -1756,10 +1875,7 @@ declare class Target extends EventTargetNode<TargetEventMap> {
     width: number;
     height: number;
   }>;
-  captureScreenshot(options?: {
-    format: 'png' | 'jpeg';
-    quality?: number;
-  }): Promise<string>;
+  captureScreenshot(options?: ScreenshotOptions): Promise<string>;
   execute<TResult = unknown, TArgs extends readonly any[] = any[]>(fn: EvaluationFunction<TArgs, TResult>, args?: TArgs, options?: EvaluationOptions): Promise<EvaluationResult<TResult>>;
   evaluate<TResult = unknown>(expression: EvaluationExpression<TResult>, options?: EvaluationOptions): Promise<EvaluationResult<TResult>>;
   resolve<TNode extends globalThis.Node = Element | Text>(node: {
@@ -8631,6 +8747,11 @@ declare class Scope {
   get global(): Record<string, {
     value: any;
   }>;
+  /** The open bindings, merged inner-over-outer - what a loop bound for the run of its body. */
+  get bindings(): Record<string, {
+    value: any;
+    secret?: boolean;
+  }>;
   get public(): Record<string, {
     value: any;
     secret?: boolean;
@@ -8677,71 +8798,6 @@ interface Storage {
 }
 type StorageData = Pick<Storage, 'input' | 'public' | 'internal'>;
 //#endregion
-//#region dist/_inline/automator/index.d.ts
-//#region src/error.d.ts
-declare class AbortError extends Error {
-  readonly retriable: boolean;
-  constructor(message: string, options?: ErrorOptions & {
-    retriable?: boolean;
-  });
-}
-declare class FlushError extends Error {}
-declare abstract class AutomatorError extends Error {
-  constructor(message: string);
-}
-declare class NavigationFailedError extends AutomatorError {
-  readonly url: string;
-  readonly reason: string;
-  constructor({
-    url,
-    reason
-  }: {
-    url: string;
-    reason: string;
-  });
-}
-declare class NavigationTimedOutError extends AutomatorError {
-  readonly url: string;
-  readonly timeout: number;
-  constructor({
-    url,
-    timeout
-  }: {
-    url: string;
-    timeout: number;
-  });
-}
-declare class NoHistoryEntryError extends AutomatorError {
-  readonly offset: number;
-  constructor({
-    offset
-  }: {
-    offset: number;
-  });
-}
-declare class BodyConsumedError extends AutomatorError {
-  readonly accessor: string;
-  constructor({
-    accessor
-  }: {
-    accessor: string;
-  });
-}
-declare class CommandTimedOutError extends AutomatorError {
-  readonly method: string;
-  readonly commandId: number;
-  readonly sessionId?: string;
-  constructor({
-    method,
-    commandId,
-    sessionId
-  }: {
-    method: string;
-    commandId: number;
-    sessionId?: string;
-  });
-} //#endregion
-//#endregion
 //#region dist/_inline/automator/ios/index.d.ts
 type IOSNodeHandle$1 = {
   ElementTypeID?: number;
@@ -8894,11 +8950,11 @@ declare class Device implements Automator {
   constructor({
     connection
   }: DeviceOptions);
-  stabilize(_stage: 'basic' | 'strict' | 'paranoid', _options?: {
+  stabilize(_stage: StabilizationStage, _options?: {
     signal?: AbortSignal;
     timeout?: number;
   }): Promise<void>;
-  captureScreenshot(): Promise<string>;
+  captureScreenshot(_options?: ScreenshotOptions): Promise<string>;
   extractFlatAXTree(): Promise<any>;
 } //#endregion
 //#endregion
@@ -8927,7 +8983,7 @@ type ExtractorItem = {
 };
 type GeneratorItem = {
   type: 'generator';
-  entity: Generator$1;
+  entity: Generator$1 | FileSource;
   value: Any;
   secret?: boolean;
 };
@@ -8964,10 +9020,10 @@ declare class ValuesStack {
   extractor(entity: ExtractOperation, value: Primitive<any>, meta?: {
     secret?: boolean;
   }): Primitive<any>;
-  generator(entity: Generator$1): (value: Any, meta?: {
+  generator(entity: Generator$1 | FileSource): (value: Any, meta?: {
     secret?: boolean;
   }) => Any;
-  generator(entity: Generator$1, value: Any, meta?: {
+  generator(entity: Generator$1 | FileSource, value: Any, meta?: {
     secret?: boolean;
   }): Any;
   operand(entity: Operand): (value: Any, meta?: {
@@ -9079,6 +9135,20 @@ declare class ValuesStack {
   }, void, unknown>;
 }
 //#endregion
+//#region src/utils/ax-extraction-event.d.ts
+/**
+ * Fired on the bus every time the runner extracts an accessibility tree - the funnel every find
+ * goes through. A consumer recording the run (lang's trace) subscribes to capture the trees the
+ * runner actually worked with, rather than re-extracting its own.
+ */
+declare class AXTreeExtractedEvent extends Event {
+  readonly tree: IAXTreeView;
+  /** Epoch ms the extraction finished. */
+  readonly at: number;
+  constructor(tree: IAXTreeView, at: number);
+  clone(): AXTreeExtractedEvent;
+}
+//#endregion
 //#region ../automator/dist/ios/protocol.d.ts
 type IOSNodeHandle = {
   ElementTypeID?: number;
@@ -9299,6 +9369,7 @@ declare const ErrorCode: {
   readonly NAVIGATION_FAILED: "NAVIGATION_FAILED";
   readonly NAVIGATION_TIMED_OUT: "NAVIGATION_TIMED_OUT";
   readonly FETCH_FAILED: "FETCH_FAILED";
+  readonly FILE_ACCESS: "FILE_ACCESS";
   readonly UNRESPONSIVE_TAB: "UNRESPONSIVE_TAB";
   readonly INTERNAL: "INTERNAL";
   readonly MESSAGE_PARSING: "MESSAGE_PARSING";
@@ -9326,7 +9397,7 @@ type ResolvedChromeTabDescriptor = {
 declare function activateBrowserTab(automator: Browser, descriptor: ResolvedChromeTabDescriptor): Promise<void>;
 //#endregion
 //#region src/utils/evaluate-expression.d.ts
-type EvaluatedExpression<TValue> = TValue extends ExtractOperation ? Any : TValue extends NumberExpression ? number : TValue extends SizeOperation ? number : TValue extends KeysOperation ? string[] : TValue extends ValuesOperation | EntriesOperation | MapOperation ? Any[] : TValue extends Condition | EveryOperation | SomeOperation ? boolean : TValue extends OTP ? string : TValue extends RandomValue<string> ? string | string[] : TValue extends RandomValue<number> ? number : TValue extends Reference<infer TType extends Any> ? TType : TValue extends JSExpressionReference<infer TType extends Any> ? TType : TValue extends InterpolatedString ? string : TValue extends JSExpression ? string : TValue extends Structure ? Record<string, any> | any[] : TValue extends FileHandle ? string : TValue extends Pattern ? RegExp | Match : TValue extends ChromeTabDescriptor ? ResolvedChromeTabDescriptor : TValue extends ChromeElementDescriptor ? ChromeElementDescriptor : TValue extends ElementDescriptor | ElementReference ? ResolvedElementDescriptor : TValue;
+type EvaluatedExpression<TValue> = TValue extends ExtractOperation ? Any : TValue extends NumberExpression ? number : TValue extends SizeOperation ? number : TValue extends KeysOperation ? string[] : TValue extends ValuesOperation | EntriesOperation | MapOperation ? Any[] : TValue extends Condition | EveryOperation | SomeOperation ? boolean : TValue extends OTP ? string : TValue extends RandomValue<string> ? string | string[] : TValue extends RandomValue<number> ? number : TValue extends Reference<infer TType extends Any> ? TType : TValue extends JSExpressionReference<infer TType extends Any> ? TType : TValue extends InterpolatedString ? string : TValue extends JSExpression ? string : TValue extends Structure ? Record<string, any> | any[] : TValue extends FileSource ? Any : TValue extends FileHandle ? string : TValue extends Pattern ? RegExp | Match : TValue extends ChromeTabDescriptor ? ResolvedChromeTabDescriptor : TValue extends ChromeElementDescriptor ? ChromeElementDescriptor : TValue extends ElementDescriptor | ElementReference ? ResolvedElementDescriptor : TValue;
 //#endregion
 //#region src/handler.d.ts
 type HandlerOptions<TAutomator extends Automator, TInstruction extends Instruction> = {
@@ -9378,7 +9449,8 @@ type ErrorResult = {
   meta?: Record<string, any>;
 };
 type Capture = {
-  image: string;
+  image: string; /** Epoch ms the screenshot was taken - the exact moment, not the instruction's boundaries. */
+  at: number;
   elements?: ElementMarker[];
   viewport?: {
     width: number;
@@ -9441,7 +9513,7 @@ declare abstract class Handler$1<TAutomator extends Automator, TInstruction exte
   throwIfCannotTypeToElement(element: Node | null): Promise<void>;
   abstract handle(): Promise<TSuccessResult | TErrorResult>;
   run(): Promise<RunResult$1<TSuccessResult | TErrorResult | FlushedResult | AbortedResult | SkippedResult>>;
-  stabilize(stage?: 'basic' | 'strict' | 'paranoid'): Promise<void>;
+  stabilize(stage?: StabilizationStage): Promise<void>;
   evaluate<TValue>(value: TValue): Promise<EvaluatedExpression<TValue>>;
   element(descriptor: ResolvedElementDescriptor): Promise<{
     web: IAXNodeView<WebNode> | null;
@@ -9634,6 +9706,44 @@ declare class SetVariableHandler extends Handler$1<Automator, Action<'set variab
   }>;
 }
 //#endregion
+//#region src/handlers/write-file.d.ts
+type WriteFileResult = {
+  status: 'file written';
+  meta: {
+    filename: string;
+    bytes: number;
+    append: boolean;
+    format?: FileFormat;
+  };
+};
+declare class WriteFileHandler extends Handler$1<Automator, Action<'write file'>, WriteFileResult> {
+  handle(): Promise<{
+    status: "file written";
+    meta: {
+      filename: string;
+      bytes: number;
+      append: boolean;
+      format: FileFormat | undefined;
+    };
+  }>;
+}
+//#endregion
+//#region src/handlers/remove-file.d.ts
+type RemoveFileResult = {
+  status: 'file removed';
+  meta: {
+    filename: string;
+  };
+};
+declare class RemoveFileHandler extends Handler$1<Automator, Action<'remove file'>, RemoveFileResult> {
+  handle(): Promise<{
+    status: "file removed";
+    meta: {
+      filename: string;
+    };
+  }>;
+}
+//#endregion
 //#region src/handlers/visual-check.d.ts
 type VisualCheckResult = {
   status: 'visually checked';
@@ -10061,6 +10171,8 @@ declare const handlers: {
     comment: typeof EmptyHandler;
     fetch: typeof FetchHandler;
     'set variable': typeof SetVariableHandler;
+    'write file': typeof WriteFileHandler;
+    'remove file': typeof RemoveFileHandler;
     intent: typeof IntentHandler;
     'set preinstructions': typeof DefinePreinstructionsHandler;
     'drop preinstructions': typeof DefinePreinstructionsHandler;
@@ -10082,6 +10194,8 @@ declare const handlers: {
     comment: typeof EmptyHandler;
     fetch: typeof FetchHandler;
     'set variable': typeof SetVariableHandler;
+    'write file': typeof WriteFileHandler;
+    'remove file': typeof RemoveFileHandler;
     'visual check': typeof VisualCheckHandler;
     intent: typeof IntentHandler;
     'set preinstructions': typeof DefinePreinstructionsHandler;
@@ -10135,422 +10249,71 @@ declare const flags: FlagStore;
 //#endregion
 //#region src/utils/progress-event.d.ts
 type ProgressStatus = 'runningPreStepInstruction' | 'runningInstruction' | 'runningAction' | 'searchingForElement' | 'waitingForNavigation' | 'waitingForResourcesLoad' | 'waitingForOutgoingRequests' | 'waitingForStabilization';
-//#endregion
-//#region src/runner.d.ts
-type RunnerOptions<TAutomator extends Automator> = {
-  automator: TAutomator;
-  axProvider: AXProvider;
-  parameters?: Record<string, {
-    value: any;
-    secret?: boolean;
-  }>;
-  actions?: CustomActions;
-  timeouts?: {
-    timeout?: number;
-    findTimeout?: number;
-    navigateTimeout?: number;
-    frameStabilityTimeout?: number;
-    screenshotTimeout?: number;
-    previewTimeout?: number;
-    maxWaitTimeout?: number;
-  }; /** How many iterations a loop may run before it fails; capped by the runner's hard maximum. */
-  loopIterationLimit?: number;
-  shouldHideFilepickerDialogs?: boolean;
-  shouldSkipInitialNavigationInNestedScope?: boolean;
-  shouldSkipAssertionsInNestedScope?: boolean;
-  flags?: Partial<Flags>;
-  proxy?: {
-    url: string;
-    username?: string;
-    password?: string;
-  };
-};
-type RunOptions = {
-  stepIndex?: number; /** Stable identity of this instruction in the caller's program, used to key a loop handle. */
-  stepId?: string; /** The live loop handle when this instruction belongs to the body of a block-form loop. */
-  loop?: LoopHandle;
-  signal?: AbortSignal;
-  shouldCapture?: boolean;
-  /** Opaque id echoed on each `subinstructionExecutionStarted` so a caller can tie the resulting
-   *  instruction logs back to the run it triggered (e.g. the devtools instruction details view). */
-  correlationId?: string; /** @internal */
-  runningPreinstructions?: boolean; /** @internal for BE usage only */
-  shouldNotThrowOnUnexpectedNavigationStatus?: boolean; /** @internal for BE usage only */
-  expectedNavigationStatuses?: number[];
+declare namespace index_d_exports {
+  export { Context, Driver, Element$1 as Element, PrimarySpecType, Selector, SpecDriver, childContext, executeBrowserCommands, executeScript, extractContext, findElement, findElements, getCookies, getDriverInfo, getTitle, getUrl, getViewportSize, isContext, isDriver, isElement, isSelector, isStaleElementError, mainContext, parentContext, setViewportSize, takeScreenshot, toSelector, toSimpleCommonSelector, visit };
+}
+//#region ../../node_modules/@applitools/utils/types/utility-types.d.ts
+type Location = {
+  x: number;
+  y: number;
 };
-type RunResult<TStatus extends 'success' | 'aborted' | 'error' = any> = (TStatus extends 'success' | 'aborted' ? {
-  status: 'success' | 'aborted';
-} : {
-  status: 'error';
-  error: string;
-  code: ErrorCode;
-  meta?: Record<string, any>;
-}) & {
-  results: HandlerResult<Automator, Instruction>[];
-  values: UsedValues;
+type Size = {
+  width: number;
+  height: number;
 };
-declare function makeRunner<TAutomator extends Automator>(options: RunnerOptions<TAutomator> & {
-  logger?: logger_d_exports.Logger;
-}): Promise<Runner<TAutomator>>;
-declare function makeRunner(options: Omit<RunnerOptions<never>, 'automator'> & {
-  browser: Browser;
-  logger?: logger_d_exports.Logger;
-}): Promise<Runner<Browser>>;
-declare function makeRunner(options: Omit<RunnerOptions<never>, 'automator'> & {
-  driver: WebDriver;
-  debuggerAddress?: string;
-  logger?: logger_d_exports.Logger;
-}): Promise<Runner<Browser>>;
-type RunnerEventMap = LogEventMap & {
-  nodeFound: RunnerAXNodeFoundEvent;
-  statusChanged: RunnerStatusChangedEvent;
-  filepickerDialogRequested: RunnerFilepickerDialogRequestedEvent;
+type Region = Location & Size; //#endregion
+//#region ../../node_modules/@applitools/driver/types/types.d.ts
+type ScreenOrientation = 'portrait' | 'landscape' | 'portrait-secondary' | 'landscape-secondary' | 'unknown';
+type Cookie$1 = {
+  name: string;
+  value: string;
+  domain?: string;
+  path?: string;
+  expiry?: number;
+  httpOnly?: boolean;
+  secure?: boolean;
+  sameSite?: 'Strict' | 'Lax' | 'None';
 };
-declare class Runner<TAutomator extends Automator> extends EventTargetNode<RunnerEventMap> implements AsyncDisposable {
-  #private;
-  /** @internal for testing only */
-  get __context(): RunnerContext;
-  get automator(): TAutomator;
-  get flags(): FlagsSnapshot;
-  /**
-   * browser instance (web-only)
-   */
-  get browser(): Browser;
-  get parameters(): Record<string, {
-    value: any;
-    secret?: boolean;
-  }>;
-  set parameters(parameters: Record<string, {
-    value: any;
-    secret?: boolean;
-  }>);
-  get variables(): Record<string, {
-    value: any;
-    secret?: boolean;
-  }>;
-  set variables(variables: Record<string, {
-    value: any;
-    secret?: boolean;
-  }>);
-  get status(): ProgressStatus;
-  constructor(options: RunnerOptions<TAutomator>);
-  run(input: string | Program$1 | SealedProgram, options?: RunOptions): Promise<RunResult>;
-  handle<TInstruction extends Instruction>(instruction: TInstruction, options?: RunOptions): Promise<HandlerResult<TAutomator, TInstruction>>;
-  /**
-   * Locates an element on the page and returns its node, or `null` when nothing matches.
-   *
-   * Accepts either a natural-language element descriptor string (e.g. `"the red submit button below the form"`)
-   * or a structured {@link ElementDescriptor} object. Unlike {@link run}/{@link handle}, this is a pure query:
-   * it stabilizes the page, resolves the descriptor, and runs Columbus element finding, but does not run
-   * preinstructions, capture screenshots, or update the active element.
-   *
-   * Web-oriented: the returned node is a `WebNode`, consistent with `RunnerContext.activeElement`.
-   */
-  find(descriptor: string | ElementDescriptor, options?: {
-    timeout?: number;
-    signal?: AbortSignal;
-  }): Promise<WebNode | null>;
-  setScope(...names: string[]): Promise<void>;
-  resetScope(): Promise<void>;
-  dispose(): Promise<void>;
-  [Symbol.asyncDispose](): Promise<void>;
-}
-declare class RunnerAXNodeFoundEvent extends Event {
-  readonly node: IAXNodeView;
-  constructor(node: IAXNodeView, eventInit?: EventInit);
-}
-declare class RunnerFilepickerDialogRequestedEvent extends Event {
-  readonly dialog: FilepickerDialog;
-  readonly frame: Frame;
-  readonly element: WebNode<HTMLInputElement>;
-  readonly multiple: boolean;
-  readonly accept: string;
-  constructor(dialog: FilepickerDialog);
-  files(files: ({
-    path: string;
-    alias?: string;
-  } | string)[]): Promise<void>;
-  close(): Promise<void>;
-}
-declare class RunnerStatusChangedEvent extends Event {
-  readonly previousStatus?: ProgressStatus;
-  readonly status: ProgressStatus;
-  constructor({
-    previousStatus,
-    status
-  }: {
-    previousStatus?: ProgressStatus;
-    status: ProgressStatus;
-  });
-}
-//#endregion
-//#region src/utils/log-event.d.ts
-type LogDetails = RunnerLogDetails | RecorderLogDetails;
-type RunnerLogDetails = InstructionExecutionStartedDetails | InstructionExecutionFinishedDetails | SubinstructionExecutionStartedDetails | SubinstructionExecutionFinishedDetails;
-type InstructionExecutionStartedDetails = {
-  type: 'instructionExecutionStarted';
-  data: {
-    instructions: Instruction[];
-    stepIndex?: number;
-  };
+type Capabilities = Record<string, any>;
+type UserAgent = string | {
+  legacy: string;
+  brands: {
+    brand: string;
+    version: string;
+  }[];
+  platform: string;
+  platformVersion?: string;
+  model?: string;
+  mobile?: boolean;
 };
-type InstructionExecutionFinishedDetails = {
-  type: 'instructionExecutionFinished';
-  data: {
-    instructions: Instruction[];
-    stepIndex?: number;
-    duration: number;
-    status: RunResult['status'];
-    errorcode?: ErrorCode;
+type Environment = {
+  browserName?: string;
+  browserVersion?: string;
+  platformName?: string;
+  platformVersion?: string;
+  deviceName?: string;
+  isReliable?: boolean;
+  isW3C?: boolean;
+  isEC?: boolean;
+  isECClient?: boolean;
+  applitoolsLib?: {
+    instrumented: boolean;
+    conflictingCapabilities?: Partial<Capabilities>;
   };
-};
-type SubinstructionExecutionStartedDetails = {
-  type: 'subinstructionExecutionStarted';
-  data: {
-    instruction: Instruction;
-  };
-};
-type InstructionMetrics = {
-  platform?: 'web' | 'mobile';
-  stabilizeMs?: number;
-  handleMs?: number;
-  findStrategy?: 'columbus' | 'selector';
-  axTreeExtractionMs?: number;
-  axTreeExtractionCount?: number;
-  axNodeCount?: number;
-  findElementMs?: number;
-  describeMs?: number;
-};
-type SubinstructionExecutionFinishedDetails = {
-  type: 'subinstructionExecutionFinished';
-  data: {
-    instruction: Instruction;
-    duration: number;
-    status: HandlerResult<Automator, Instruction>['status'];
-    errorcode?: ErrorCode;
-    metrics?: InstructionMetrics;
-  };
-};
-type RecorderLogDetails = RecordingStartedDetails | RecordingStopedDetails | InstructionRecordedDetails | ElementSelectionStartedDetails | ElementSelectionStoppedDetails | ElementDescriptorGeneratedDetails | ElementSelectorGeneratedDetails | RecorderErrorDetails;
-type RecordingStartedDetails = {
-  type: 'recordingStarted';
-};
-type RecordingStopedDetails = {
-  type: 'recordingStopped';
-};
-type InstructionRecordedDetails = {
-  type: 'instructionRecorded';
-  data: {
-    instruction: string;
-    guid: string;
-    analytics?: any;
-    metrics?: InstructionMetrics;
-  };
-};
-type ElementSelectionStartedDetails = {
-  type: 'elementSelectionStarted';
-  data: {
-    output: 'description' | 'selector';
-  };
-};
-type ElementSelectionStoppedDetails = {
-  type: 'elementSelectionStopped';
-};
-type ElementDescriptorGeneratedDetails = {
-  type: 'elementDescriptorGenerated';
-  data: {
-    description: string;
-    metrics?: InstructionMetrics;
-  };
-};
-type ElementSelectorGeneratedDetails = {
-  type: 'elementSelectorGenerated';
-  data: {
-    selector: {
-      type: 'css' | 'xpath';
-      selector: string;
-    };
-  };
-};
-type RecorderErrorDetails = {
-  type: 'recorderError';
-  data: {
-    message: string;
-    code?: string;
-    error?: any;
-  };
-};
-type LogEventMap = {
-  log: LogEvent;
-};
-declare class LogEvent extends CustomEvent<LogDetails & {
-  timestamp: number;
-}> {
-  readonly component: 'runner' | 'recorder';
-  constructor(details: LogDetails & {
-    timestamp?: number;
-  });
-  /** An already-dispatched event can't be dispatched again — re-dispatchers need a fresh instance. */
-  clone(): LogEvent;
-}
-//#endregion
-//#region src/ax/ax-ops.d.ts
-type FindNodeOptions = {
-  stack: ValuesStack;
-  timeout?: number;
-  signal?: AbortSignal;
-  metrics?: InstructionMetrics;
-};
-type FindNodeResult<TAutomator extends Automator> = {
-  web: IAXNodeView<WebNode> | null;
-  mobile: IAXNodeView<IOSNode$1> | null;
-}[TAutomator['type']];
-declare class AXOps<TAutomator extends Automator = Automator> {
-  #private;
-  readonly automator: TAutomator;
-  readonly axProvider: AXProvider;
-  constructor(automator: TAutomator, axProvider: AXProvider);
-  extractTree<TNode = unknown>(): Promise<IAXTreeView<TNode>>;
-  makeTree<TNode>(flat: AXTreeFlat<TNode>): Promise<IAXTreeView<TNode>>;
-  findCandidate<TNode>(tree: IAXTreeView<TNode>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): Promise<CandidateMetric | null>;
-  findCandidates<TNode>(tree: IAXTreeView<TNode>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): Promise<CandidateMetric[]>;
-  /**
-   * Search-oriented "find all": ranked candidates matching the descriptor, and — when the
-   * descriptor combines a title with a type — the remaining candidates of that type appended
-   * after the title matches. A search for "ok button" should surface ALL buttons with the "ok"
-   * ones ranked first, whereas plain candidate matching filters non-matching titles out entirely.
-   * The legacy safety-net type score is disabled: "all buttons" must not include nodes that
-   * merely might be buttons.
-   */
-  searchCandidates<TNode>(tree: IAXTreeView<TNode>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): Promise<CandidateMetric[]>;
-  describeNode<TNode>(tree: IAXTreeView<TNode>, query: ElementDescriptorQuery<IAXNodeView<TNode>>): Promise<ResolvedElementDescriptor | undefined>;
-  findNode(descriptor: ResolvedElementDescriptor, options: FindNodeOptions): Promise<FindNodeResult<TAutomator>>;
-  /**
-   * Resolves an element descriptor to the collection of elements it describes - the candidates
-   * whose match quality ties with the best one found, in document order. Used by for-each loops
-   * over page elements, and by any consumer needing "every element matching the descriptor".
-   * An empty collection is retried until the timeout, since a page mid-load may transiently
-   * match nothing.
-   */
-  findNodes(descriptor: ResolvedElementDescriptor, options: FindNodeOptions): Promise<IAXNodeView<any>[]>;
-}
-//#endregion
-//#region src/types.d.ts
-type CustomActions = {
-  debug?(): Promise<void>;
-  check?(): Promise<void>;
-  generateOTP?(user: string): Promise<string>;
-  generateRandomValue?(expression: RandomValue): Promise<string | string[]>;
-  resolveFilename?(filename: string): Promise<string>;
-};
-type UsedValues = {
-  references: Map<Reference<Any>, {
-    value: Any;
-    secret?: boolean;
-  }>;
-  extractors: Map<ExtractOperation, {
-    value: Primitive<any>;
-    element?: ResolvedElementDescriptor;
-  }>;
-  operands: Map<Operand, {
-    value: Any;
-    element?: ResolvedElementDescriptor;
-  }>;
-};
-/**
- * The state of a running block-form loop, handed to the caller and passed back with every
- * instruction of the body (see adr/2026-08-21-block-form-loop-handles.md). Opaque to the caller:
- * store it, echo it, never interpret it.
- */
-type LoopHandle = {
-  id: string; /** The head instruction, so bindings can be re-derived without runner-side state. */
-  head: LoopControlFlow; /** The enclosing loop, so a nested body sees both sets of bindings. */
-  parent?: LoopHandle; /** How many iterations have started. */
-  iteration: number; /** When the loop started, for a per-loop wall-clock timeout. */
-  startedAt: number;
-};
-interface RunnerContext {
-  axOps: AXOps;
-  scope: Scope;
-  actions: CustomActions;
-  dispatcher?: Dispatcher;
-  activeElement?: WebNode;
-  preinstructions: Instruction[];
-  /** Bookkeeping for each running loop, kept while the runner re-queues it. */
-  loops?: Map<Instruction, LoopState>;
-  /**
-   * The most recently resolved element node - what an element reference (`it`) resolves to at
-   * runtime. Every successful element find updates it, and a for-each loop over page elements
-   * rebinds it to the current entry at the start of each iteration.
-   */
-  activeAXNode?: IAXNodeView<any>;
-}
-type SelectorElementDescriptor = Required<Pick<ResolvedElementDescriptor, 'selector'>>;
-declare namespace index_d_exports {
-  export { Context, Driver, Element$1 as Element, PrimarySpecType, Selector, SpecDriver, childContext, executeBrowserCommands, executeScript, extractContext, findElement, findElements, getCookies, getDriverInfo, getTitle, getUrl, getViewportSize, isContext, isDriver, isElement, isSelector, isStaleElementError, mainContext, parentContext, setViewportSize, takeScreenshot, toSelector, toSimpleCommonSelector, visit };
-}
-//#region ../../node_modules/@applitools/utils/types/utility-types.d.ts
-type Location = {
-  x: number;
-  y: number;
-};
-type Size = {
-  width: number;
-  height: number;
-};
-type Region = Location & Size; //#endregion
-//#region ../../node_modules/@applitools/driver/types/types.d.ts
-type ScreenOrientation = 'portrait' | 'landscape' | 'portrait-secondary' | 'landscape-secondary' | 'unknown';
-type Cookie$1 = {
-  name: string;
-  value: string;
-  domain?: string;
-  path?: string;
-  expiry?: number;
-  httpOnly?: boolean;
-  secure?: boolean;
-  sameSite?: 'Strict' | 'Lax' | 'None';
-};
-type Capabilities = Record<string, any>;
-type UserAgent = string | {
-  legacy: string;
-  brands: {
-    brand: string;
-    version: string;
-  }[];
-  platform: string;
-  platformVersion?: string;
-  model?: string;
-  mobile?: boolean;
-};
-type Environment = {
-  browserName?: string;
-  browserVersion?: string;
-  platformName?: string;
-  platformVersion?: string;
-  deviceName?: string;
-  isReliable?: boolean;
-  isW3C?: boolean;
-  isEC?: boolean;
-  isECClient?: boolean;
-  applitoolsLib?: {
-    instrumented: boolean;
-    conflictingCapabilities?: Partial<Capabilities>;
-  };
-  isWeb?: boolean;
-  isNative?: boolean;
-  isMobile?: boolean;
-  isEmulation?: boolean;
-  isIE?: boolean;
-  isEdge?: boolean;
-  isEdgeLegacy?: boolean;
-  isChrome?: boolean;
-  isChromium?: boolean;
-  isAndroid?: boolean;
-  isIOS?: boolean;
-  isMac?: boolean;
-  isWindows?: boolean;
-  isKobiton?: boolean;
+  isWeb?: boolean;
+  isNative?: boolean;
+  isMobile?: boolean;
+  isEmulation?: boolean;
+  isIE?: boolean;
+  isEdge?: boolean;
+  isEdgeLegacy?: boolean;
+  isChrome?: boolean;
+  isChromium?: boolean;
+  isAndroid?: boolean;
+  isIOS?: boolean;
+  isMac?: boolean;
+  isWindows?: boolean;
+  isKobiton?: boolean;
 };
 type Viewport = {
   displaySize?: Size;
@@ -10954,4 +10717,707 @@ declare class HttpRemoteAXProvider extends RemoteAXProvider {
   protected _rqFindAXNode<TNode>(nodes: IAXNodeView<TNode>[], descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): Promise<CandidateMetricResponse | null>;
 }
 //#endregion
-export { type AXContentType, type AXControlType, type AXNodeFlat, type AXOption, type AXProvider, AXServerFetch, AXServerRequest, type AXState, type AXStructuralType, type AXStyle, type AXTreeFlat, type AXType, AbortError, type AnchorDescriptor, Automator, AutomatorError, BlockingDialog, BodyConsumedError, Browser, BrowserActivePageChangedEvent, BrowserDisconnectedEvent, BrowserPageClosedEvent, BrowserPageCreatedEvent, BrowserPageNavigatedEvent, BrowserStabilizingLoadEvent, BrowserStabilizingNavigationEvent, BrowserStabilizingOutgoingRequestsEvent, BrowserTargetCrashedEvent, BrowserTargetCreatedEvent, BrowserWindowCreatedEvent, CallableRemoteFunctionHandle, CandidateMetricResponse, CommandTimedOutError, Connection, Cookie, type CustomActions, Debugger, DebuggerPausedEvent, DebuggerResumedEvent, DescribeAXNodeResponse, type DescriptorStrategy, DialogHandledEvent, type ElementDescriptor, type ElementDescriptorQuery, EvaluationArguments, EvaluationExpression, EvaluationFunction, EvaluationOptions, EvaluationResult, Evaluator, EvaluatorDestroyedEvent, EvaluatorLogEvent, Expression, FilepickerDialog, FlagChangedEvent, Flags, FlagsSnapshot, FlushError, Frame, FrameDestroyedEvent, FrameDocumentRequestEvent, FrameDocumentResponseEvent, FrameEvaluatorAttached, FrameFetchError, FrameFetchOptions, FrameLifecycleEvent, FrameNavigatedEvent, FrameNavigatingEvent, FrameSwappedEvent, FrameSwappingEvent, type Har, HarRecorder, HarRecorderOptions, HarRecorderStatsChangedEvent, HarStats, HttpRemoteAXProvider, HttpRemoteAXProviderOptions, type IAXNodeView, type IAXTreeView, Injection, InjectionEvaluatorAttachedEvent, InjectionExpression, InjectionIncommingMessageEvent, InjectionOutgoingMessageEvent, InjectionTargetAttachedEvent, Intercepted, InterceptedRequest, InterceptedResponse, InterceptionHandler, InterceptionPattern, InterceptionPatternMatcher, Keyboard, Loader, LoaderRequestEvent, LoaderResponseEvent, LocalizedRemoteValue, type LoopHandle, MakeAXTreeResponse, Mouse, NavigationFailedError, NavigationTimedOutError, NoHistoryEntryError, Node, type NodeBackground, Port, PortIncommingMessageEvent, type PortMessageEvent, PortOutgoingMessageEvent, RemoteAXProvider, RemoteFunctionHandle, RemoteObjectHandle, type Request, type ResolvedAnchor, type ResolvedElementDescriptor, ResolvedRemoteValue, type Response$1 as Response, RunOptions, RunResult, Runner, RunnerAXNodeFoundEvent, type RunnerContext, RunnerFilepickerDialogRequestedEvent, RunnerOptions, RunnerStatusChangedEvent, Script, type SelectorElementDescriptor, StaleNodeError, StaleRemoteObjectHandleError, StylesheetHandle, Target, TargetActivatedEvent, TargetActivatingEvent, TargetAttachedEvent, TargetChangedEvent, TargetChildTargetCreatingEvent, TargetClosedEvent, TargetDetachedEvent, TargetDialogEvent, TargetElementSelectedEvent, TargetFilepickerDialogEvent, TargetFrameAttachedEvent, TargetFrameTargetCreatedEvent, TargetMainFrameReadyEvent, TargetNavigatedEvent, TargetVisibilityChangeEvent, type UsedValues, WebNode, Window, WindowDestroyedEvent, WindowTargetAttachedEvent, WindowTargetDetachedEvent, flags, isElementAcceptableInvisible, localizeRemoteValue, makeBlockingDialog, makeBrowser, makeBundledExpression, makeBundledScript, makeConnection, makeDebugger, makeEvaluator, makeExpression, makeFilepickerDialog, makeFrame, makeInjection, makeIntercepted, makeInterceptedRequest, makeInterceptedResponse, makeInterceptionPatternMatcher, makeKeyboard, makeLoader, makeMouse, makePort, makeRunner, makeScript, makeTarget, makeWebNode, makeWindow, provideRolldownConfig, index_d_exports as spec, toCDPPattern };
+//#region src/log/catalog.d.ts
+interface RunnerLogEventCatalog {
+  runStarted: {
+    runnerVersion: string;
+    parserVersion: string;
+    nodeVersion: string;
+  };
+  instructionExecutionStarted: {
+    instructions: Instruction[];
+    stepIndex?: number;
+  };
+  instructionExecutionFinished: {
+    instructions: Instruction[];
+    stepIndex?: number;
+    duration: number;
+    status: 'success' | 'aborted' | 'error';
+    errorcode?: ErrorCode;
+  };
+  subinstructionExecutionStarted: {
+    instruction: Instruction;
+    correlationId?: string;
+  };
+  loopIterationStarted: {
+    iteration: number;
+    total?: number;
+    correlationId?: string;
+  };
+  subinstructionExecutionFinished: {
+    instruction: Instruction;
+    duration: number;
+    status: string;
+    errorcode?: ErrorCode;
+    metrics?: InstructionMetrics;
+  };
+  instructionResultHandled: {
+    status: string;
+    code?: ErrorCode;
+  };
+  navigationPerformed: {
+    kind: 'url' | 'history';
+    url?: string;
+    statusCode?: number;
+    historyDirection?: 'back' | 'forward';
+    times?: number;
+  };
+  assertionEvaluated: {
+    passed: boolean;
+    attempts: number;
+    durationMs: number;
+    condition: unknown;
+  };
+  waitConditionEvaluated: {
+    conditionMet: boolean;
+    attempt: number;
+    elapsedMs: number;
+    timeout: number;
+  };
+  pdfInterceptorInstallFailed: {
+    error: unknown;
+  };
+  filepickerAutoSetupFailed: {
+    error: unknown;
+  };
+  handlerRetriedOnStaleNode: {
+    error: unknown;
+  };
+  handlerFlushed: {
+    error: unknown;
+  };
+  handlerAutomatorError: {
+    error: unknown;
+  };
+  handlerRunnerError: {
+    error: unknown;
+  };
+  handlerAborted: {
+    error: unknown;
+  };
+  handlerInternalError: {
+    error: unknown;
+  };
+  elementMarkerExtractionFailed: {
+    error: unknown;
+  };
+  captureFailed: {
+    error: unknown;
+  };
+  elementRevealFailed: {
+    error: unknown;
+  };
+  axTreeExtracted: {
+    kind: 'ax' | 'pdf';
+    durationMs: number;
+  };
+  axTreeExtractionAborted: {
+    error: unknown;
+  };
+  elementFound: {
+    descriptor: unknown;
+    node: AXNodeProjection | null;
+  };
+  elementCollectionFound: {
+    descriptor: unknown;
+    count: number;
+  };
+  elementNotFound: {
+    durationMs: number;
+    descriptor: unknown;
+    loadingPending: unknown;
+  };
+  axNodeViewMismatch: {
+    descriptor: unknown;
+  };
+  axTreeNodesCollapsed: {
+    generation: number;
+    collapses: NodeCollapseEntry[];
+    omitted?: number;
+  };
+  findReasoningEmitFailed: {
+    error: unknown;
+  };
+  axCandidatesPrioritized: {
+    generation: number;
+    reason?: string;
+    descriptor: unknown;
+    candidates: CandidatePrioritizationProjection[];
+    omitted?: number;
+  };
+  pdfInterceptorReplaced: {
+    url: string;
+  };
+  sessionReplayInjectionFailed: {
+    targetId: string;
+    error: unknown;
+  };
+  pdfInterceptorFailed: {
+    error: unknown;
+  };
+  pdfPageIsolationFailed: {
+    error: unknown;
+  };
+  pdfPageRestoreFailed: {
+    error: unknown;
+  };
+}
+interface RecorderLogEventCatalog {
+  recordingStarted: Record<string, never>;
+  recordingStopped: Record<string, never>;
+  instructionRecorded: {
+    instruction: string;
+    guid: string;
+    analytics?: any;
+    metrics?: InstructionMetrics;
+  };
+  elementSelectionStarted: {
+    output: 'description' | 'selector';
+  };
+  elementSelectionStopped: Record<string, never>;
+  elementDescriptorGenerated: {
+    description: string;
+    metrics?: InstructionMetrics;
+  };
+  elementSelectorGenerated: {
+    selector: {
+      type: 'css' | 'xpath';
+      selector: string;
+    };
+  };
+  recorderError: {
+    message: string;
+    code?: string;
+    error?: any;
+  };
+  userActionParsingFailed: {
+    error: unknown;
+  };
+  recorderScreenshotFailed: {
+    reason: unknown;
+  };
+  recorderSocketError: {
+    error: unknown;
+  };
+  rawMessagesSaveFailed: {
+    error: unknown;
+  };
+  socketMessageParsingFailed: {
+    error: unknown;
+  };
+  iosCollectNodeMissing: Record<string, never>;
+  iosTargetNodeMissing: Record<string, never>;
+  iosDescriptorGenerationFailed: Record<string, never>;
+  iosUserActionFailed: {
+    error: unknown;
+  };
+  iosUnknownActionType: {
+    actionType: string;
+  };
+}
+type AXNodeProjection = {
+  type?: Record<string, number>;
+  text?: string;
+  label?: string;
+  rect?: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  };
+};
+type NodeCollapseEntry = {
+  nodeId?: string;
+  discardedNode?: string;
+  note: string;
+};
+type CandidatePrioritizationProjection = {
+  nodeId?: string;
+  node: AXNodeProjection | null;
+  quality?: number;
+  prioritizers: {
+    name: string;
+    priorityOrder: number;
+    order: string;
+    value: unknown;
+  }[];
+};
+declare module '#utils' {
+  interface LogEventCatalog extends RunnerLogEventCatalog, RecorderLogEventCatalog {}
+}
+//#endregion
+//#region src/playground/protocol.d.ts
+type FoundElementMatchMetrics = {
+  title?: {
+    source: string;
+    text: string;
+    pattern: string;
+    coverage: number;
+    startsWith: boolean;
+    priority: number;
+  };
+  type?: {
+    required: number[];
+    hint: number[];
+  };
+  obscured?: boolean;
+  color?: number;
+  anchors?: {
+    position: string;
+    positionType: 'relative' | 'absolute';
+    distance: number;
+    alignment?: number;
+    anchorId?: string;
+  }[];
+};
+//#endregion
+//#region src/runner.d.ts
+type RunnerOptions<TAutomator extends Automator> = {
+  automator: TAutomator;
+  axProvider: AXProvider;
+  parameters?: Record<string, {
+    value: any;
+    secret?: boolean;
+  }>;
+  actions?: CustomActions;
+  timeouts?: {
+    timeout?: number;
+    findTimeout?: number;
+    navigateTimeout?: number;
+    frameStabilityTimeout?: number;
+    screenshotTimeout?: number;
+    previewTimeout?: number;
+    maxWaitTimeout?: number;
+  }; /** How many iterations a loop may run before it fails; capped by the runner's hard maximum. */
+  loopIterationLimit?: number;
+  /**
+   * How every screenshot this runner takes is encoded. A consumer wants one kind of image for a
+   * whole run - a report that stores hundreds of them picks `webp`, which costs roughly a quarter
+   * of `png` for the same page - so the choice lives here rather than as a mode set on the browser
+   * session or an argument each capture repeats. Chrome encodes it, so nothing re-compresses after.
+   */
+  screenshot?: ScreenshotOptions;
+  /**
+   * Extra global references, merged with the runner's own (`page`, `pdf`). The runner exposes
+   * nothing from its host by itself - a consumer that wants the process environment readable as
+   * `{env.NAME}` passes it here (see `@applitools/nlp-lang`), so an embedder like the backend
+   * never leaks its own environment into a program.
+   */
+  globals?: Record<string, {
+    value: any;
+  }>;
+  shouldHideFilepickerDialogs?: boolean;
+  shouldSkipInitialNavigationInNestedScope?: boolean;
+  shouldSkipAssertionsInNestedScope?: boolean;
+  flags?: Partial<Flags>;
+  proxy?: {
+    url: string;
+    username?: string;
+    password?: string;
+  };
+};
+type RunOptions = {
+  stepIndex?: number; /** Stable identity of this instruction in the caller's program, used to key a loop handle. */
+  stepId?: string; /** The live loop handle when this instruction belongs to the body of a block-form loop. */
+  loop?: LoopHandle;
+  signal?: AbortSignal;
+  shouldCapture?: boolean;
+  /** Opaque id echoed on each `subinstructionExecutionStarted` so a caller can tie the resulting
+   *  instruction logs back to the run it triggered (e.g. the devtools instruction details view). */
+  correlationId?: string; /** @internal */
+  runningPreinstructions?: boolean; /** @internal for BE usage only */
+  shouldNotThrowOnUnexpectedNavigationStatus?: boolean; /** @internal for BE usage only */
+  expectedNavigationStatuses?: number[];
+};
+type SearchOptions = {
+  /** The tree to search; a fresh one is extracted when omitted. */tree?: IAXTreeView;
+  limit?: number; /** Attach each candidate's scoring breakdown. */
+  explain?: boolean;
+  signal?: AbortSignal;
+};
+type SearchResult = {
+  node: IAXNodeView;
+  quality?: number;
+  metrics?: FoundElementMatchMetrics;
+};
+type RunResult<TStatus extends 'success' | 'aborted' | 'error' = any> = (TStatus extends 'success' | 'aborted' ? {
+  status: 'success' | 'aborted';
+} : {
+  status: 'error';
+  error: string;
+  code: ErrorCode;
+  meta?: Record<string, any>;
+}) & {
+  results: HandlerResult<Automator, Instruction>[];
+  values: UsedValues;
+};
+declare function makeRunner<TAutomator extends Automator>(options: RunnerOptions<TAutomator> & {
+  logger?: logger_d_exports.Logger;
+}): Promise<Runner<TAutomator>>;
+declare function makeRunner(options: Omit<RunnerOptions<never>, 'automator'> & {
+  browser: Browser;
+  logger?: logger_d_exports.Logger;
+}): Promise<Runner<Browser>>;
+declare function makeRunner(options: Omit<RunnerOptions<never>, 'automator'> & {
+  driver: WebDriver;
+  debuggerAddress?: string;
+  logger?: logger_d_exports.Logger;
+}): Promise<Runner<Browser>>;
+type RunnerEventMap = LogEventMap & {
+  nodeFound: RunnerAXNodeFoundEvent;
+  statusChanged: RunnerStatusChangedEvent;
+  filepickerDialogRequested: RunnerFilepickerDialogRequestedEvent;
+  axTreeExtracted: AXTreeExtractedEvent;
+};
+declare class Runner<TAutomator extends Automator> extends EventTargetNode<RunnerEventMap> implements AsyncDisposable {
+  #private;
+  /** @internal for testing only */
+  get __context(): RunnerContext;
+  get automator(): TAutomator;
+  get flags(): FlagsSnapshot;
+  /**
+   * browser instance (web-only)
+   */
+  get browser(): Browser;
+  get parameters(): Record<string, {
+    value: any;
+    secret?: boolean;
+  }>;
+  set parameters(parameters: Record<string, {
+    value: any;
+    secret?: boolean;
+  }>);
+  get variables(): Record<string, {
+    value: any;
+    secret?: boolean;
+  }>;
+  /** The global data bindings (`page`, `pdf`, plus whatever the embedder passed as `globals`). */
+  get globals(): Record<string, {
+    value: any;
+  }>;
+  /** The loop bindings the last run resolved against (`{index}`, a for-each entry), merged
+   *  inner-over-outer. They stay readable until the next run rebuilds or clears them. */
+  get bindings(): Record<string, {
+    value: any;
+    secret?: boolean;
+  }>;
+  set variables(variables: Record<string, {
+    value: any;
+    secret?: boolean;
+  }>);
+  get status(): ProgressStatus;
+  constructor(options: RunnerOptions<TAutomator>);
+  run(input: string | Program$1 | SealedProgram, options?: RunOptions): Promise<RunResult>;
+  handle<TInstruction extends Instruction>(instruction: TInstruction, options?: RunOptions): Promise<HandlerResult<TAutomator, TInstruction>>;
+  /**
+   * Locates an element on the page and returns its node, or `null` when nothing matches.
+   *
+   * Accepts either a natural-language element descriptor string (e.g. `"the red submit button below the form"`)
+   * or a structured {@link ElementDescriptor} object. Unlike {@link run}/{@link handle}, this is a pure query:
+   * it stabilizes the page, resolves the descriptor, and runs Columbus element finding, but does not run
+   * preinstructions, capture screenshots, or update the active element.
+   *
+   * Web-oriented: the returned node is a `WebNode`, consistent with `RunnerContext.activeElement`.
+   */
+  find(descriptor: string | ElementDescriptor, options?: {
+    timeout?: number;
+    signal?: AbortSignal;
+  }): Promise<WebNode | null>;
+  /**
+   * The accessibility tree of the live page - the same view element finding reads.
+   *
+   * A pure query, like {@link find}: an editor, an MCP server or a debugger inspecting a paused
+   * run needs to see the page the way Columbus sees it, without running an instruction.
+   */
+  tree(): Promise<IAXTreeView>;
+  /**
+   * How to describe one element of a tree in the language, best first.
+   *
+   * The inverse of {@link find}: given an element, produce the descriptions that would resolve to
+   * it. This is the recorder's own generator behind a pull API, so an authored instruction gets the
+   * description recording the interaction would have produced - identity first (a name, a label,
+   * a title), position only when nothing else distinguishes the element.
+   */
+  describe(tree: IAXTreeView, node: IAXNodeView, {
+    limit
+  }?: {
+    limit?: number;
+  }): Promise<string[]>;
+  /**
+   * Every candidate a descriptor matches, ranked as element finding ranks them.
+   *
+   * Where {@link find} answers "which element is this", this answers "what is this descriptor
+   * choosing between, and why" - several strong candidates mean the description is ambiguous and
+   * needs narrowing. `explain` attaches each candidate's scoring (text source and coverage, type
+   * scores, anchors, whether it is obscured).
+   */
+  search(descriptor: string | ElementDescriptor, {
+    tree,
+    limit,
+    explain,
+    signal
+  }?: SearchOptions): Promise<SearchResult[]>;
+  setScope(...names: string[]): Promise<void>;
+  resetScope(): Promise<void>;
+  dispose(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
+}
+declare class RunnerAXNodeFoundEvent extends Event {
+  readonly node: IAXNodeView;
+  constructor(node: IAXNodeView, eventInit?: EventInit);
+}
+declare class RunnerFilepickerDialogRequestedEvent extends Event {
+  readonly dialog: FilepickerDialog;
+  readonly frame: Frame;
+  readonly element: WebNode<HTMLInputElement>;
+  readonly multiple: boolean;
+  readonly accept: string;
+  constructor(dialog: FilepickerDialog);
+  files(files: ({
+    path: string;
+    alias?: string;
+  } | string)[]): Promise<void>;
+  close(): Promise<void>;
+}
+declare class RunnerStatusChangedEvent extends Event {
+  readonly previousStatus?: ProgressStatus;
+  readonly status: ProgressStatus;
+  constructor({
+    previousStatus,
+    status
+  }: {
+    previousStatus?: ProgressStatus;
+    status: ProgressStatus;
+  });
+}
+//#endregion
+//#region src/utils/log-event.d.ts
+type LogDetails = RunnerLogDetails | RecorderLogDetails;
+type RunnerLogDetails = InstructionExecutionStartedDetails | InstructionExecutionFinishedDetails | SubinstructionExecutionStartedDetails | SubinstructionExecutionFinishedDetails;
+type InstructionExecutionStartedDetails = {
+  type: 'instructionExecutionStarted';
+  data: {
+    instructions: Instruction[];
+    stepIndex?: number;
+  };
+};
+type InstructionExecutionFinishedDetails = {
+  type: 'instructionExecutionFinished';
+  data: {
+    instructions: Instruction[];
+    stepIndex?: number;
+    duration: number;
+    status: RunResult['status'];
+    errorcode?: ErrorCode;
+  };
+};
+type SubinstructionExecutionStartedDetails = {
+  type: 'subinstructionExecutionStarted';
+  data: {
+    instruction: Instruction;
+  };
+};
+type InstructionMetrics = {
+  platform?: 'web' | 'mobile';
+  stabilizeMs?: number;
+  handleMs?: number;
+  findStrategy?: 'columbus' | 'selector';
+  axTreeExtractionMs?: number;
+  axTreeExtractionCount?: number;
+  axNodeCount?: number;
+  findElementMs?: number;
+  describeMs?: number;
+  revealMs?: number;
+  captureMs?: number;
+};
+type SubinstructionExecutionFinishedDetails = {
+  type: 'subinstructionExecutionFinished';
+  data: {
+    instruction: Instruction;
+    duration: number;
+    status: HandlerResult<Automator, Instruction>['status'];
+    errorcode?: ErrorCode;
+    metrics?: InstructionMetrics;
+  };
+};
+type RecorderLogDetails = RecordingStartedDetails | RecordingStopedDetails | InstructionRecordedDetails | ElementSelectionStartedDetails | ElementSelectionStoppedDetails | ElementDescriptorGeneratedDetails | ElementSelectorGeneratedDetails | RecorderErrorDetails;
+type RecordingStartedDetails = {
+  type: 'recordingStarted';
+};
+type RecordingStopedDetails = {
+  type: 'recordingStopped';
+};
+type InstructionRecordedDetails = {
+  type: 'instructionRecorded';
+  data: {
+    instruction: string;
+    guid: string;
+    analytics?: any;
+    metrics?: InstructionMetrics;
+  };
+};
+type ElementSelectionStartedDetails = {
+  type: 'elementSelectionStarted';
+  data: {
+    output: 'description' | 'selector';
+  };
+};
+type ElementSelectionStoppedDetails = {
+  type: 'elementSelectionStopped';
+};
+type ElementDescriptorGeneratedDetails = {
+  type: 'elementDescriptorGenerated';
+  data: {
+    description: string;
+    metrics?: InstructionMetrics;
+  };
+};
+type ElementSelectorGeneratedDetails = {
+  type: 'elementSelectorGenerated';
+  data: {
+    selector: {
+      type: 'css' | 'xpath';
+      selector: string;
+    };
+  };
+};
+type RecorderErrorDetails = {
+  type: 'recorderError';
+  data: {
+    message: string;
+    code?: string;
+    error?: any;
+  };
+};
+type LogEventMap = {
+  log: LogEvent;
+};
+declare class LogEvent extends CustomEvent<LogDetails & {
+  timestamp: number;
+}> {
+  readonly component: 'runner' | 'recorder';
+  constructor(details: LogDetails & {
+    timestamp?: number;
+  });
+  /** An already-dispatched event can't be dispatched again — re-dispatchers need a fresh instance. */
+  clone(): LogEvent;
+}
+//#endregion
+//#region src/ax/ax-ops.d.ts
+type FindNodeOptions = {
+  stack: ValuesStack;
+  timeout?: number;
+  signal?: AbortSignal;
+  metrics?: InstructionMetrics;
+};
+type FindNodeResult<TAutomator extends Automator> = {
+  web: IAXNodeView<WebNode> | null;
+  mobile: IAXNodeView<IOSNode$1> | null;
+}[TAutomator['type']];
+declare class AXOps<TAutomator extends Automator = Automator> {
+  #private;
+  readonly automator: TAutomator;
+  readonly axProvider: AXProvider;
+  constructor(automator: TAutomator, axProvider: AXProvider);
+  extractTree<TNode = unknown>(): Promise<IAXTreeView<TNode>>;
+  makeTree<TNode>(flat: AXTreeFlat<TNode>): Promise<IAXTreeView<TNode>>;
+  findCandidate<TNode>(tree: IAXTreeView<TNode>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): Promise<CandidateMetric | null>;
+  findCandidates<TNode>(tree: IAXTreeView<TNode>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): Promise<CandidateMetric[]>;
+  /**
+   * Search-oriented "find all": ranked candidates matching the descriptor, and — when the
+   * descriptor combines a title with a type — the remaining candidates of that type appended
+   * after the title matches. A search for "ok button" should surface ALL buttons with the "ok"
+   * ones ranked first, whereas plain candidate matching filters non-matching titles out entirely.
+   * The legacy safety-net type score is disabled: "all buttons" must not include nodes that
+   * merely might be buttons.
+   */
+  searchCandidates<TNode>(tree: IAXTreeView<TNode>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): Promise<CandidateMetric[]>;
+  describeNode<TNode>(tree: IAXTreeView<TNode>, query: ElementDescriptorQuery<IAXNodeView<TNode>>): Promise<ResolvedElementDescriptor | undefined>;
+  findNode(descriptor: ResolvedElementDescriptor, options: FindNodeOptions): Promise<FindNodeResult<TAutomator>>;
+  /**
+   * Resolves an element descriptor to the collection of elements it describes - the candidates
+   * whose match quality ties with the best one found, in document order. Used by for-each loops
+   * over page elements, and by any consumer needing "every element matching the descriptor".
+   * An empty collection is retried until the timeout, since a page mid-load may transiently
+   * match nothing.
+   */
+  findNodes(descriptor: ResolvedElementDescriptor, options: FindNodeOptions): Promise<IAXNodeView<any>[]>;
+}
+//#endregion
+//#region src/types.d.ts
+/**
+ * File access is a capability of the host, not of the runner: the runner names the operations and
+ * the embedder supplies them (see `@applitools/nlp-runner/file-actions` for the Node one). A
+ * surface with no filesystem simply leaves them out, and the instructions that need them fail with
+ * a capability error. Contents cross this seam as strings so an embedder can implement it remotely.
+ */
+type FileActions = {
+  /** Reads a file whole. `encoding: 'base64'` for bytes; parsing by format is the runner's job. */readFile?(filename: string, options?: {
+    encoding?: 'utf8' | 'base64';
+  }): Promise<string>;
+  writeFile?(filename: string, contents: string, options?: {
+    append?: boolean;
+    encoding?: 'utf8' | 'base64';
+  }): Promise<void>;
+  removeFile?(filename: string): Promise<void>; /** Separate from {@link readFile} so asking about a huge file does not read it. */
+  fileExists?(filename: string): Promise<boolean>;
+};
+type CustomActions = FileActions & {
+  debug?(): Promise<void>;
+  check?(): Promise<void>;
+  generateOTP?(user: string): Promise<string>;
+  generateRandomValue?(expression: RandomValue): Promise<string | string[]>;
+  /**
+   * Maps a filename written in an instruction to the one the host will act on. Every file the
+   * runner touches passes through here - uploads and the file actions alike - so an embedder that
+   * confines them to a directory has one place to do it, and a rejection here rejects them all.
+   */
+  resolveFilename?(filename: string): Promise<string>;
+};
+type UsedValues = {
+  references: Map<Reference<Any>, {
+    value: Any;
+    secret?: boolean;
+  }>;
+  extractors: Map<ExtractOperation, {
+    value: Primitive<any>;
+    element?: ResolvedElementDescriptor;
+  }>;
+  operands: Map<Operand, {
+    value: Any;
+    element?: ResolvedElementDescriptor;
+  }>;
+};
+/**
+ * The state of a running block-form loop, handed to the caller and passed back with every
+ * instruction of the body (see adr/2026-08-21-block-form-loop-handles.md). Opaque to the caller:
+ * store it, echo it, never interpret it.
+ */
+type LoopHandle = {
+  id: string; /** The head instruction, so bindings can be re-derived without runner-side state. */
+  head: LoopControlFlow; /** The enclosing loop, so a nested body sees both sets of bindings. */
+  parent?: LoopHandle; /** How many iterations have started. */
+  iteration: number; /** When the loop started, for a per-loop wall-clock timeout. */
+  startedAt: number;
+};
+interface RunnerContext {
+  axOps: AXOps;
+  scope: Scope;
+  actions: CustomActions;
+  dispatcher?: Dispatcher;
+  /** How screenshots are encoded for this run - see `RunnerOptions.screenshot`. */
+  screenshot?: ScreenshotOptions;
+  activeElement?: WebNode;
+  preinstructions: Instruction[];
+  /** Bookkeeping for each running loop, kept while the runner re-queues it. */
+  loops?: Map<Instruction, LoopState>;
+  /**
+   * The most recently resolved element node - what an element reference (`it`) resolves to at
+   * runtime. Every successful element find updates it, and a for-each loop over page elements
+   * rebinds it to the current entry at the start of each iteration.
+   */
+  activeAXNode?: IAXNodeView<any>;
+}
+type SelectorElementDescriptor = Required<Pick<ResolvedElementDescriptor, 'selector'>>;
+//#endregion
+export { type AXContentType, type AXControlType, type AXNodeFlat, type AXOption, type AXProvider, AXServerFetch, AXServerRequest, type AXState, type AXStructuralType, type AXStyle, type AXTreeFlat, type AXType, AbortError, type AnchorDescriptor, Automator, AutomatorError, BlockingDialog, BodyConsumedError, Browser, BrowserActivePageChangedEvent, BrowserDisconnectedEvent, BrowserPageClosedEvent, BrowserPageCreatedEvent, BrowserPageNavigatedEvent, BrowserStabilizingLoadEvent, BrowserStabilizingNavigationEvent, BrowserStabilizingOutgoingRequestsEvent, BrowserTargetCrashedEvent, BrowserTargetCreatedEvent, BrowserWindowCreatedEvent, CallableRemoteFunctionHandle, CandidateMetricResponse, CommandTimedOutError, Connection, Cookie, type CustomActions, Debugger, DebuggerPausedEvent, DebuggerResumedEvent, DescribeAXNodeResponse, type DescriptorStrategy, DialogHandledEvent, type ElementDescriptor, type ElementDescriptorQuery, EvaluationArguments, EvaluationExpression, EvaluationFunction, EvaluationOptions, EvaluationResult, Evaluator, EvaluatorDestroyedEvent, EvaluatorLogEvent, Expression, type FileActions, FilepickerDialog, FlagChangedEvent, Flags, FlagsSnapshot, FlushError, Frame, FrameDestroyedEvent, FrameDocumentRequestEvent, FrameDocumentResponseEvent, FrameEvaluatorAttached, FrameFetchError, FrameFetchOptions, FrameLifecycleEvent, FrameNavigatedEvent, FrameNavigatingEvent, FrameSwappedEvent, FrameSwappingEvent, type Har, HarRecorder, HarRecorderOptions, HarRecorderStatsChangedEvent, HarStats, HttpRemoteAXProvider, HttpRemoteAXProviderOptions, type IAXNodeView, type IAXTreeView, Injection, InjectionEvaluatorAttachedEvent, InjectionExpression, InjectionIncommingMessageEvent, InjectionOutgoingMessageEvent, InjectionTargetAttachedEvent, Intercepted, InterceptedRequest, InterceptedResponse, InterceptionHandler, InterceptionPattern, InterceptionPatternMatcher, Keyboard, Loader, LoaderRequestEvent, LoaderResponseEvent, LocalizedRemoteValue, type LoopHandle, MakeAXTreeResponse, Mouse, NavigationFailedError, NavigationTimedOutError, NoHistoryEntryError, Node, type NodeBackground, Port, PortIncommingMessageEvent, type PortMessageEvent, PortOutgoingMessageEvent, RemoteAXProvider, RemoteFunctionHandle, RemoteObjectHandle, type Request, type ResolvedAnchor, type ResolvedElementDescriptor, ResolvedRemoteValue, type Response$1 as Response, RunOptions, RunResult, Runner, RunnerAXNodeFoundEvent, type RunnerContext, RunnerFilepickerDialogRequestedEvent, RunnerOptions, RunnerStatusChangedEvent, ScreenshotOptions, Script, SearchOptions, SearchResult, type SelectorElementDescriptor, StabilizationStage, StaleNodeError, StaleRemoteObjectHandleError, StylesheetHandle, Target, TargetActivatedEvent, TargetActivatingEvent, TargetAttachedEvent, TargetChangedEvent, TargetChildTargetCreatingEvent, TargetClosedEvent, TargetDetachedEvent, TargetDialogEvent, TargetElementSelectedEvent, TargetFilepickerDialogEvent, TargetFrameAttachedEvent, TargetFrameTargetCreatedEvent, TargetMainFrameReadyEvent, TargetNavigatedEvent, TargetVisibilityChangeEvent, type UsedValues, WebNode, Window, WindowDestroyedEvent, WindowTargetAttachedEvent, WindowTargetDetachedEvent, flags, isElementAcceptableInvisible, localizeRemoteValue, makeBlockingDialog, makeBrowser, makeBundledExpression, makeBundledScript, makeConnection, makeDebugger, makeEvaluator, makeExpression, makeFilepickerDialog, makeFrame, makeInjection, makeIntercepted, makeInterceptedRequest, makeInterceptedResponse, makeInterceptionPatternMatcher, makeKeyboard, makeLoader, makeMouse, makePort, makeRunner, makeScript, makeTarget, makeWebNode, makeWindow, previewRemoteValue, provideRolldownConfig, index_d_exports as spec, toCDPPattern };