agent-device 0.20.5 → 0.20.7

package/dist/src/sdk-selectors.d.ts

@@ -0,0 +1,601 @@
+import { A as SnapshotNode, D as Rect, E as RawSnapshotNode, M as SnapshotQualityVerdict, N as SnapshotState, O as ScreenshotOverlayRef, T as Point, U as PublicPlatform, V as Platform, j as SnapshotOptions$1, k as SnapshotBackend, m as ResponseCost } from "./sdk-contracts.js";
+import { c as ScrollDirection, o as GesturePlan } from "./sdk-android-adb.js";
+//#region packages/contracts/src/back-mode.d.ts
+declare const BACK_MODES: readonly ['in-app', 'system'];
+type BackMode = (typeof BACK_MODES)[number];
+//#endregion
+//#region packages/contracts/src/click-button.d.ts
+declare const CLICK_BUTTONS: readonly ['primary', 'secondary', 'middle'];
+type ClickButton = (typeof CLICK_BUTTONS)[number];
+//#endregion
+//#region packages/contracts/src/device-rotation.d.ts
+declare const DEVICE_ROTATIONS: readonly ['portrait', 'portrait-upside-down', 'landscape-left', 'landscape-right'];
+type DeviceRotation = (typeof DEVICE_ROTATIONS)[number];
+//#endregion
+//#region packages/contracts/src/tv-remote.d.ts
+declare const TV_REMOTE_BUTTON_DEFINITIONS: {
+  readonly up: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_DPAD_UP';
+    readonly appleRemoteButton: 'up';
+    readonly vegaKey: 'KEY_UP';
+  };
+  readonly down: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_DPAD_DOWN';
+    readonly appleRemoteButton: 'down';
+    readonly vegaKey: 'KEY_DOWN';
+  };
+  readonly left: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_DPAD_LEFT';
+    readonly appleRemoteButton: 'left';
+    readonly vegaKey: 'KEY_LEFT';
+  };
+  readonly right: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_DPAD_RIGHT';
+    readonly appleRemoteButton: 'right';
+    readonly vegaKey: 'KEY_RIGHT';
+  };
+  readonly select: {
+    readonly aliases: readonly ["ok", "center", "enter"];
+    readonly androidKeyevent: 'KEYCODE_DPAD_CENTER';
+    readonly appleRemoteButton: 'select';
+    readonly vegaKey: 'KEY_ENTER';
+  };
+  readonly menu: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_MENU';
+    readonly appleRemoteButton: 'menu';
+    readonly vegaKey: 'KEY_MENU';
+  };
+  readonly home: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_HOME';
+    readonly appleRemoteButton: 'home';
+    readonly vegaKey: 'KEY_HOMEPAGE';
+  };
+  readonly back: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_BACK';
+    readonly appleRemoteButton: 'menu';
+    readonly vegaKey: 'KEY_BACK';
+  };
+};
+declare const TV_REMOTE_BUTTONS: (keyof typeof TV_REMOTE_BUTTON_DEFINITIONS)[];
+type TvRemoteButton = (typeof TV_REMOTE_BUTTONS)[number];
+//#endregion
+//#region packages/contracts/src/settings.d.ts
+type SettingOptions = {
+  permissionTarget?: string;
+  permissionMode?: string;
+  latitude?: number;
+  longitude?: number;
+};
+//#endregion
+//#region packages/contracts/src/session-surface.d.ts
+declare const SESSION_SURFACES: readonly ['app', 'frontmost-app', 'desktop', 'menubar'];
+type SessionSurface = (typeof SESSION_SURFACES)[number];
+//#endregion
+//#region packages/contracts/src/snapshot-diagnostics.d.ts
+type SnapshotTimingStats = {
+  count: number;
+  p50Ms: number;
+  p95Ms: number;
+  maxMs: number;
+  slowThresholdMs: number;
+  platform?: PublicPlatform;
+  backends?: Record<string, number>;
+};
+type SnapshotDiagnosticsSummary = {
+  stats: SnapshotTimingStats;
+  warning?: string;
+};
+//#endregion
+//#region packages/contracts/src/snapshot-types.d.ts
+type ScreenshotResultData = {
+  path?: string;
+  width?: number;
+  height?: number;
+  logicalWidth?: number;
+  logicalHeight?: number;
+  pixelDensity?: number;
+  overlayRefs?: ScreenshotOverlayRef[];
+};
+type BackendSnapshotResult = {
+  nodes?: SnapshotNode[];
+  truncated?: boolean;
+  backend?: string;
+  snapshot?: SnapshotState;
+  appName?: string;
+  appBundleId?: string;
+  snapshotDiagnostics?: SnapshotDiagnosticsSummary;
+  analysis?: {
+    rawNodeCount: number;
+    maxDepth: number;
+  };
+  androidSnapshot?: AndroidSnapshotBackendMetadata;
+  freshness?: {
+    action: string;
+    retryCount: number;
+    staleAfterRetries: boolean;
+    reason?: 'empty-interactive' | 'sharp-drop' | 'stuck-route';
+  };
+  quality?: SnapshotQualityVerdict;
+  warnings?: string[];
+};
+type AndroidSnapshotBackendMetadata = {
+  backend: 'android-helper';
+  helperVersion?: string;
+  helperApiVersion?: string;
+  helperTransport?: string;
+  helperSessionReused?: boolean;
+  installReason?: string;
+  waitForIdleTimeoutMs?: number;
+  waitForIdleQuietMs?: number;
+  timeoutMs?: number;
+  maxDepth?: number;
+  maxNodes?: number;
+  rootPresent?: boolean;
+  captureMode?: string;
+  systemSurfaceOnly?: boolean;
+  windowCount?: number;
+  nodeCount?: number;
+  helperTruncated?: boolean;
+  elapsedMs?: number;
+};
+type FindLocator = 'any' | 'text' | 'label' | 'value' | 'role' | 'id';
+//#endregion
+//#region packages/contracts/src/runner-lease-context.d.ts
+type RunnerLogicalLeaseContext = {
+  leaseId?: string;
+  clientId?: string;
+  tenantId?: string;
+  runId?: string;
+  leaseProvider?: string;
+  deviceKey?: string;
+};
+//#endregion
+//#region packages/contracts/src/interactor-types.d.ts
+type RunnerContext = {
+  requestId?: string;
+  signal?: AbortSignal;
+  appBundleId?: string;
+  verbose?: boolean;
+  logPath?: string;
+  traceLogPath?: string;
+  iosXctestrunFile?: string;
+  iosXctestDerivedDataPath?: string;
+  iosXctestEnvDir?: string;
+  runnerLeaseContext?: RunnerLogicalLeaseContext;
+};
+type ScreenshotOptions = {
+  appBundleId?: string;
+  pixelDensity?: number;
+  fullscreen?: boolean;
+  normalizeStatusBar?: boolean;
+  stabilize?: boolean;
+  surface?: SessionSurface;
+  skipIosSimulatorBootCheck?: boolean;
+  captureBackend?: 'runner';
+};
+type ElementSelectorKey = 'id' | 'label' | 'text' | 'value';
+type ElementSelectorTapOptions = {
+  key: ElementSelectorKey;
+  value: string;
+  allowNonHittableCoordinateFallback?: boolean;
+  expectedPoint?: Point;
+};
+/**
+ * The channel the XCTest runner actually entered text through — the Swift
+ * `TextEntryResult.textEntryRoute` (RunnerTests+TextTyping.swift,
+ * RunnerTests+SynthesizedTextEntry.swift). Closed set, because the runner is
+ * its only producer and the boundary that narrows it
+ * (readTypeTextBackendResult, src/platforms/apple/interactions.ts) drops a
+ * route it cannot name — so a Swift-side addition would silently vanish. The
+ * route-parity test in src/platforms/apple/core/__tests__/interactions.test.ts
+ * reads the Swift sources and fails instead.
+ */
+declare const TEXT_ENTRY_ROUTES: readonly ['xctest-element', 'synthesized-first-responder', 'synthesized-first-responder-replacement', 'xctest-application-fallback'];
+type TextEntryRoute = (typeof TEXT_ENTRY_ROUTES)[number];
+/**
+ * What `Interactor.type` reports back about the entry it performed. Only the
+ * Apple runner populates it; every other platform types blind and returns void.
+ */
+type TypeTextBackendResult = {
+  textEntryRoute?: TextEntryRoute;
+};
+type FillVerificationTarget = {
+  resourceId: string | null;
+  className: string | null;
+  packageName: string | null;
+  rect: Rect;
+};
+type FillUnconfirmedVerification = {
+  verification: 'unconfirmed';
+  requested: string;
+  before: string | null;
+  after: string | null;
+  target: FillVerificationTarget;
+};
+type SnapshotOptions = SnapshotOptions$1 & {
+  appBundleId?: string;
+  signal?: AbortSignal;
+  includeRects?: boolean;
+  includeHiddenContentHints?: boolean;
+  surface?: SessionSurface;
+};
+type SnapshotResult = Omit<BackendSnapshotResult, 'backend' | 'nodes'> & {
+  nodes?: RawSnapshotNode[];
+  backend: Extract<SnapshotBackend, 'android' | 'harmonyos-arkui' | 'xctest' | 'linux-atspi' | 'web'>;
+};
+type Interactor = {
+  open(app: string, options?: {
+    activity?: string;
+    appBundleId?: string;
+    launchConsole?: string;
+    launchArgs?: string[];
+    terminateRunningApp?: boolean;
+    url?: string;
+  }): Promise<void>;
+  openDevice(): Promise<void>;
+  close(app: string): Promise<void>;
+  tap(x: number, y: number): Promise<Record<string, unknown> | void>;
+  tapElementSelector?(selector: ElementSelectorTapOptions): Promise<Record<string, unknown> | void>;
+  doubleTap(x: number, y: number): Promise<Record<string, unknown> | void>;
+  longPress(x: number, y: number, durationMs?: number): Promise<Record<string, unknown> | void>;
+  focus(x: number, y: number): Promise<Record<string, unknown> | void>;
+  type(text: string, delayMs?: number): Promise<TypeTextBackendResult | void>;
+  fillElementSelector?(selector: ElementSelectorTapOptions, text: string, delayMs?: number): Promise<Record<string, unknown> | void>;
+  fill(x: number, y: number, text: string, delayMs?: number, options?: {
+    allowNonHittableCoordinateFallback?: boolean;
+  }): Promise<Record<string, unknown> | void>;
+  scroll(direction: ScrollDirection, options?: {
+    amount?: number;
+    pixels?: number;
+    durationMs?: number;
+  }): Promise<Record<string, unknown> | void>;
+  screenshot(outPath: string, options?: ScreenshotOptions): Promise<void>;
+  setViewport?(width: number, height: number): Promise<Record<string, unknown> | void>;
+  snapshot(options?: SnapshotOptions): Promise<SnapshotResult>;
+  gestureViewport?(): Promise<Rect>;
+  back(mode?: BackMode): Promise<void>;
+  home(): Promise<void>;
+  setOrientation(orientation: DeviceRotation): Promise<{
+    orientation?: DeviceRotation;
+  } | void>;
+  performGesture?(plan: GesturePlan): Promise<Record<string, unknown> | void>;
+  appSwitcher(): Promise<void>;
+  tvRemote(button: TvRemoteButton, durationMs?: number): Promise<void>;
+  readClipboard(): Promise<string>;
+  writeClipboard(text: string): Promise<void>;
+  setSetting(setting: string, state: string, appId?: string, options?: SettingOptions): Promise<Record<string, unknown> | void>;
+};
+//#endregion
+//#region packages/contracts/src/interaction.d.ts
+/** The decisive criterion separating a resolveSelectorChain winner from its strongest runner-up (ADR 0012). */
+type DisambiguationTiebreak = 'visible' | 'deepest' | 'smallest-area' | 'structural-equivalence';
+/**
+ * A disambiguation winner or losing alternative. `diagnosticRef` is an opaque,
+ * non-`@` token — never a snapshot ref, never issued via `refsGeneration`,
+ * never pinnable or usable as an `@ref` target. Strings are UTF-8 truncated
+ * to 256 bytes.
+ */
+type ResolutionDiagnosticEntry = {
+  diagnosticRef: string;
+  role?: string;
+  label?: string;
+};
+/**
+ * ADR 0012 decision 2: pre-action disclosure of how the acting path resolved
+ * its target, including each endpoint of a target-authored drag. Never ref-issuing.
+ * `direct-ios`/`not-observed` = the XCTest fast path has no daemon tree to
+ * report from; `ref`/`label-fallback` = a stale `@ref` recovered via
+ * first-match label lookup, never exact ref provenance; `alternatives` holds
+ * at most 5 losing candidates, winner excluded.
+ */
+type ResolutionDisclosure = {
+  source: 'runtime';
+  phase: 'pre-action';
+  kind: 'unique';
+} | {
+  source: 'runtime';
+  phase: 'pre-action';
+  kind: 'disambiguated';
+  matchCount: number;
+  winnerDiagnostic: ResolutionDiagnosticEntry;
+  tiebreak: DisambiguationTiebreak;
+  alternatives: ResolutionDiagnosticEntry[];
+} | {
+  source: 'ref';
+  phase: 'pre-action';
+  kind: 'exact';
+} | {
+  source: 'ref';
+  phase: 'pre-action';
+  kind: 'label-fallback';
+} | {
+  source: 'direct-ios';
+  kind: 'not-observed';
+};
+/**
+ * Opt-in (`--verify`) cheap post-condition evidence for mutating interaction
+ * commands (#1047). `digest`/`nodeCount`/`interactiveNodeCount` describe a single
+ * interactive-only capture taken right after the action; `changedFromBefore`
+ * compares that digest against the pre-action capture the resolution path already
+ * held, so no extra device round trip is spent beyond the one verify capture.
+ * `changedFromBefore: false` is evidence, not failure — the command still
+ * succeeded.
+ */
+type InteractionEvidence = {
+  foregroundApp?: string;
+  nodeCount: number;
+  interactiveNodeCount: number;
+  digest: string;
+  changedFromBefore: boolean;
+};
+type SettleDiffLine = {
+  kind: 'added' | 'removed';
+  text: string;
+  /**
+   * Plain ref body (`e12`) for ADDED lines: minted from the settled tree that
+   * became the stored session snapshot, so it is immediately actionable and
+   * lets the MCP layer pin it at `refsGeneration`. Removed lines never carry
+   * one — their refs name nodes of the replaced tree.
+   */
+  ref?: string;
+};
+/**
+ * One still-present, actionable element on the settled tree, surfaced by the
+ * unchanged-interactive tail (see `SettleObservation.tail`).
+ */
+type SettleTailEntry = {
+  ref: string;
+  role: string;
+  label?: string;
+};
+type SettleObservation = {
+  settled: boolean;
+  waitedMs: number;
+  captures: number;
+  quietMs: number;
+  timeoutMs: number;
+  /**
+   * The session's snapshot generation after the settled tree became the stored
+   * snapshot (#1076 versioned refs). Attached by the daemon response layer
+   * when `diff` is present: added lines carry refs minted from that tree, so
+   * the response is ref-issuing — the MCP layer merges per-ref pins from it
+   * exactly like snapshot/find responses.
+   */
+  refsGeneration?: number;
+  /**
+   * Digest response view only: capped added-line refs preserved without the
+   * verbose diff line text, so MCP can still pin refs when `diff.lines` is
+   * intentionally omitted.
+   */
+  refs?: Array<{
+    ref: string;
+  }>;
+  /** Present only for `settled: true` observations that stored the settled tree. */
+  diff?: {
+    summary: {
+      additions: number;
+      removals: number;
+      unchanged: number;
+    };
+    lines: SettleDiffLine[];
+    /** Present (true) when lines were capped to the response bound. */
+    truncated?: boolean;
+  };
+  /**
+   * Unchanged interactive refs tail: benchmarks (July 2026) showed 27% of
+   * `--settle` actions were followed by a fallback `snapshot -i` because a
+   * change-only diff omits refs for elements that did not change — after a
+   * modal dismiss the diff shows only removals, and the next button to press
+   * (already on screen, untouched) is absent from the response. `tail` lists
+   * the settled tree's remaining uncovered interactive elements (excluding
+   * structural application/window chrome and the keyboard window's chrome)
+   * so the response stays actionable without that extra round trip. Attached
+   * ONLY when `diff` carries zero added-line refs naming a NEW target (the
+   * modal-dismiss/toast-only/fill signature) — a diff whose added refs hand
+   * the next target already pays its way, so the tail would be pure byte
+   * cost. Keyboard-chrome refs and self-echo refs (added lines whose node
+   * contains the action point: the acted-on element re-describing itself,
+   * e.g. a filled field re-labeled with its new value) do not count as new
+   * targets. Refs already present on `diff`'s added lines are excluded.
+   * Capped; `tailTruncated` marks when candidates exceeded the cap.
+   */
+  tail?: SettleTailEntry[];
+  tailTruncated?: true;
+  hint?: string;
+};
+/**
+ * Public daemon response data shared by press/click/fill/longpress.
+ * `buildInteractionResponseData` emits this shape (ADR 0011 Layer 2):
+ * `targetKind` discriminates the resolved target, identity fields are FLAT
+ * (`ref`, `selector`, `x`, `y`), and per-command extras ride alongside.
+ */
+type TouchResponseDataBase = {
+  message?: string;
+  warning?: string;
+  x?: number;
+  y?: number;
+  referenceWidth?: number;
+  referenceHeight?: number;
+  evidence?: InteractionEvidence;
+  settle?: SettleObservation;
+  resolution?: ResolutionDisclosure;
+  cost?: ResponseCost;
+  /** Direct iOS Maestro coordinate-fallback signals. */
+  maestroNonHittableCoordinateFallbackAllowed?: boolean;
+  maestroNonHittableCoordinateFallbackUsed?: boolean;
+  maestroFallbackReason?: 'non-hittable-coordinate';
+};
+type TouchResponsePoint = TouchResponseDataBase & {
+  targetKind: 'point';
+  x: number;
+  y: number;
+};
+type TouchResponseRef = TouchResponseDataBase & {
+  targetKind: 'ref';
+  ref: string;
+  refLabel?: string;
+  selectorChain?: string[];
+  targetHittable?: boolean;
+  hint?: string;
+};
+type TouchResponseSelector = TouchResponseDataBase & {
+  targetKind: 'selector';
+  selector: string;
+  selectorChain?: string[];
+  refLabel?: string;
+  targetHittable?: boolean;
+  hint?: string;
+};
+type TouchPressExtras = {
+  button?: ClickButton;
+  count?: number;
+  intervalMs?: number;
+  holdMs?: number;
+  jitterPx?: number;
+  doubleTap?: boolean;
+};
+type PressCommandResponseData = (TouchResponsePoint & TouchPressExtras) | (TouchResponseRef & TouchPressExtras) | (TouchResponseSelector & TouchPressExtras);
+type ClickCommandResponseData = PressCommandResponseData;
+type TouchFillExtras = {
+  text: string;
+  delayMs?: number;
+} & ({
+  verification?: never;
+  requested?: never;
+  before?: never;
+  after?: never;
+  target?: never;
+} | FillUnconfirmedVerification);
+type FillCommandResponseData = (TouchResponsePoint & TouchFillExtras) | (TouchResponseRef & TouchFillExtras) | (TouchResponseSelector & TouchFillExtras);
+type TouchLongPressExtras = {
+  durationMs?: number;
+  gesture: 'longpress';
+};
+type LongPressCommandResponseData = (TouchResponsePoint & TouchLongPressExtras) | (TouchResponseRef & TouchLongPressExtras) | (TouchResponseSelector & TouchLongPressExtras);
+/**
+ * Daemon response data for the `find` command. Read-only actions (`exists`,
+ * `wait`, `get_text`, `get_attrs`) may issue a pinnable ref with
+ * `refsGeneration`; mutating actions (`click`, `fill`, `focus`, `type`) carry
+ * `ref` as diagnostic pre-action identity and intentionally omit `refsGeneration`
+ * (ADR 0014). The shape is intentionally a flat, optional-field record because
+ * the action positional changes which fields are present.
+ */
+type FindCommandResponseData = {
+  ref?: string;
+  refsGeneration?: number;
+  found?: true;
+  waitedMs?: number;
+  text?: string;
+  node?: SnapshotNode;
+  /** Every match of the read-only `list` action (#1625), each ref pinnable at `refsGeneration`. */
+  matches?: Array<{
+    ref: string;
+    node: SnapshotNode;
+  }>;
+  locator?: string;
+  query?: string;
+  x?: number;
+  y?: number;
+  message?: string;
+  settle?: SettleObservation;
+  cost?: ResponseCost;
+};
+//#endregion
+//#region packages/selectors/src/internal/public-resolution-types.d.ts
+/** One per-alternative diagnostic returned by selector resolution. */
+type SelectorDiagnostics = {
+  selector: string;
+  matches: number;
+};
+/**
+ * The disclosure for an ambiguous selector that was resolved by the heuristic;
+ * present only when the heuristic picked among N>1 matches (ADR 0012).
+ */
+type SelectorDisambiguationDisclosure = {
+  matchCount: number;
+  tiebreak: DisambiguationTiebreak;
+  /** Every losing matched node, document order, uncapped (response layer caps). */
+  alternatives: SnapshotNode[];
+};
+/**
+ * The options every selector lookup takes. Stated once here rather than inline
+ * per function so a façade wrapper and the parser-side function it forwards to
+ * cannot drift apart.
+ */
+type SelectorMatchOptions = {
+  platform: Platform | PublicPlatform;
+  requireRect?: boolean;
+};
+/** {@link SelectorMatchOptions} plus the uniqueness policy resolution adds. */
+type SelectorResolutionOptions = SelectorMatchOptions & {
+  requireUnique?: boolean;
+  disambiguateAmbiguous?: boolean;
+};
+//#endregion
+//#region packages/selectors/src/internal/parse.d.ts
+type SelectorKey = 'id' | 'role' | 'text' | 'label' | 'value' | 'appname' | 'windowtitle' | 'visible' | 'hidden' | 'editable' | 'selected' | 'focused' | 'enabled' | 'hittable';
+type SelectorTerm = {
+  key: SelectorKey;
+  value: string | boolean;
+};
+type Selector = {
+  raw: string;
+  terms: SelectorTerm[];
+};
+type SelectorChain = {
+  raw: string;
+  selectors: Selector[];
+};
+declare function parseSelectorChain(expression: string): SelectorChain;
+declare function tryParseSelectorChain(expression: string): SelectorChain | null;
+declare function isSelectorToken(token: string): boolean;
+//#endregion
+//#region packages/selectors/src/internal/resolve.d.ts
+/**
+ * The parser-side twin of the façade's `SelectorResolution`: identical except
+ * that the winning alternative is the `Selector` node itself, which the façade
+ * flattens to its `raw` text before any consumer sees it. Only the fields that
+ * differ are restated; everything else is shared with
+ * `public-resolution-types.ts`.
+ */
+type AstSelectorResolution = {
+  node: SnapshotNode;
+  selector: Selector;
+  selectorIndex: number;
+  matches: number;
+  diagnostics: SelectorDiagnostics[];
+  disambiguation?: SelectorDisambiguationDisclosure;
+};
+declare function resolveSelectorChain(nodes: SnapshotState['nodes'], chain: SelectorChain, options: SelectorResolutionOptions): AstSelectorResolution | null;
+/** The parser-side twin of the façade's `SelectorChainMatch`. */
+type AstSelectorChainMatch = {
+  selectorIndex: number;
+  selector: Selector;
+  matches: number;
+  diagnostics: SelectorDiagnostics[];
+};
+declare function findSelectorChainMatch(nodes: SnapshotState['nodes'], chain: SelectorChain, options: SelectorMatchOptions): AstSelectorChainMatch | null;
+//#endregion
+//#region packages/selectors/src/internal/node.d.ts
+declare function isNodeVisible(node: SnapshotNode): boolean;
+declare function isNodeEditable(node: SnapshotNode, platform: Platform | PublicPlatform): boolean;
+//#endregion
+//#region packages/selectors/src/ast.d.ts
+/**
+ * The published signature takes a parsed chain or the raw text it came from;
+ * the engine only ever needs the text. Kept here rather than widening
+ * `internal/resolve.ts` back to a union, so the compatibility obligation sits
+ * at the boundary that owes it.
+ */
+declare function formatSelectorFailure(chain: SelectorChain | string, diagnostics: SelectorDiagnostics[], options: {
+  unique?: boolean;
+}): string;
+//#endregion
+export { SessionSurface as C, BackMode as D, ClickButton as E, SnapshotDiagnosticsSummary as S, DeviceRotation as T, Interactor as _, resolveSelectorChain as a, FindLocator as b, parseSelectorChain as c, ClickCommandResponseData as d, FillCommandResponseData as f, SettleObservation as g, PressCommandResponseData as h, findSelectorChainMatch as i, tryParseSelectorChain as l, LongPressCommandResponseData as m, isNodeEditable as n, SelectorChain as o, FindCommandResponseData as p, isNodeVisible as r, isSelectorToken as s, formatSelectorFailure as t, SelectorDiagnostics as u, RunnerContext as v, TvRemoteButton as w, ScreenshotResultData as x, AndroidSnapshotBackendMetadata as y };

package/dist/src/sdk-selectors.js

@@ -1 +1 @@
-import{_ as e,u as t}from"./sdk-contracts.js";import{F as n,U as r,W as i}from"./sdk-batch-runner.js";function a(e,t){return{ok:!1,code:`INVALID_ARGS`,message:e,...t?{hint:t}:{}}}function o(e){return!!(e&&[e.x,e.y,e.width,e.height].every(Number.isFinite)&&e.width>0&&e.height>0)}function s(e,t){return t.x>=e.x&&t.y>=e.y&&t.x+t.width<=e.x+e.width&&t.y+t.height<=e.y+e.height}function c(e){return e.width*e.height}function l(e,n){let r=t(n),i=e.filter(e=>d(e.rect)),a=i.filter(e=>{let t=(e.type??``).toLowerCase();return t.includes(`application`)||t.includes(`window`)});return p(a.map(e=>e.rect).filter(e=>f(e,r.x,r.y)))||p(a.map(e=>e.rect))||p(i.map(e=>e.rect).filter(e=>f(e,r.x,r.y)))||null}function u(e,t){return m(e.x,e.x+e.width,t.x,t.x+t.width)&&m(e.y,e.y+e.height,t.y,t.y+t.height)}function d(e){return e?Number.isFinite(e.x)&&Number.isFinite(e.y)&&Number.isFinite(e.width)&&Number.isFinite(e.height):!1}function f(e,t,n){return t>=e.x&&t<=e.x+e.width&&n>=e.y&&n<=e.y+e.height}function p(e){let t=null,n=-1;for(let r of e){let e=r.width*r.height;e>n&&(t=r,n=e)}return t}function m(e,t,n,r){return Math.max(e,n)<=Math.min(t,r)}function ee(e){let t=e.trim().toLowerCase();return t?/^(vertical|horizontal)\s+scroll\s+bar(?:,?\s*\d+\s+pages?)?$/.test(t):!1}function h(e,t){if(!(e?.trim().toLowerCase()??``).includes(`vertical scroll bar`))return null;let n=te(t);return n===null?null:n<=1?{above:!1,below:!0}:n>=99?{above:!0,below:!1}:{above:!0,below:!0}}function te(e){if(!e)return null;let t=/^(\d{1,3})%$/.exec(e.trim());if(!t)return null;let n=Number(t[1]);return Number.isFinite(n)?Math.max(0,Math.min(100,n)):null}function ne(e){let t=new Map;for(let[n,r]of e.entries())t.set(r.index,n);let n=[],r=[];for(let[i,a]of e.entries()){let e=Math.max(0,a.depth??0);for(;r.length>0&&e<=r[r.length-1].depth;)r.pop();let o=i,s=typeof a.parentIndex==`number`?t.get(a.parentIndex):void 0,c=typeof s==`number`&&s<o?s:r[r.length-1]?.index;n.push({...a,index:o,depth:e,parentIndex:c}),r.push({depth:e,index:o})}return n}function g(e){return new Map(e.map(e=>[e.index,e]))}function _(e){return e.label?.trim()||e.value?.trim()||e.identifier?.trim()||``}function v(e){let t=`${e??``}`.toLowerCase();return t.includes(`scroll`)||t.includes(`recyclerview`)||t.includes(`listview`)||t.includes(`gridview`)||t.includes(`collectionview`)||t===`table`}function y(e){return v(e.type)?!0:`${e.role??``} ${e.subrole??``}`.toLowerCase().includes(`scroll`)}function re(e){if(e.length===0)return{nodes:e,hiddenCount:0,summaryLines:[]};let{byIndex:t,visibleNodeIndexes:n,offscreenNodes:r,hintedContainers:i}=b(e),a=n.size===0?e:e.filter(e=>n.has(e.index));return{nodes:a.map(e=>de(e,i.directionsByContainer)),hiddenCount:n.size===0?0:e.length-a.length,summaryLines:fe(r.filter(e=>!i.coveredNodeIndexes.has(e.index)&&me(e)),e,t)}}function ie(e){if(e.length===0)return new Map;let{hintedContainers:t}=b(e);return ue(t.directionsByContainer)}function b(e){let t=g(e),n=new Set,r=[];for(let i of e){if(x(i,e,t)){ge(i,n,t);continue}r.push(i)}return{byIndex:t,visibleNodeIndexes:n,offscreenNodes:r,hintedContainers:le(e,r,n,t)}}function x(e,t,n=g(t)){if(!e.rect)return!0;let r=C(e,t,n);return r?u(e.rect,r):!0}function ae(e,t,n=g(t)){if(!e.rect)return!0;if(!x(e,t,n))return!1;let r=l(t,e.rect);return S(e.rect,r)}function S(e,t){return!t||t.width<=0||t.height<=0?!0:f(t,e.x+e.width/2,e.y+e.height/2)}function oe(e,t){return e.hittable&&S(e.rect,t)}function C(e,t,n=g(t)){return ye(e,n)||l(t,e.rect??{x:0,y:0,width:0,height:0})}function se(e,t,n=g(t)){if(!e.rect)return null;let r=C(e,t,n);if(r&&!u(e.rect,r)){let t=ce(e.rect,r);if(t)return t}let i=l(t,e.rect);if(i&&!S(e.rect,i)){let t=ce(e.rect,i);if(t)return t}return null}function ce(e,t){let n=e.x+e.width/2,r=e.y+e.height/2,i=[{direction:`down`,amount:r-(t.y+t.height)},{direction:`up`,amount:t.y-r},{direction:`right`,amount:n-(t.x+t.width)},{direction:`left`,amount:t.x-n}],a=null;for(let e of i)e.amount>0&&(!a||e.amount>a.amount)&&(a=e);return a?.direction??null}function le(e,t,n,r){let i=new Map,a=new Map,o=new Set;for(let e of t){if(!e.rect)continue;let t=T(e,n,r);if(!t?.rect)continue;let s=w(e.rect,t.rect);if(!s)continue;let c=i.get(t.index)??new Set;c.add(s),i.set(t.index,c);let l=a.get(t.index)??new Set;l.add(s),a.set(t.index,l),o.add(e.index)}return _e(e,n,r,i,a),{directionsByContainer:i,coveredNodeIndexes:o}}function ue(e){let t=new Map;for(let[n,r]of e){let e={};r.has(`above`)&&(e.hiddenContentAbove=!0),r.has(`below`)&&(e.hiddenContentBelow=!0),(e.hiddenContentAbove||e.hiddenContentBelow)&&t.set(n,e)}return t}function de(e,t){let n=t.get(e.index);if(!n||n.size===0)return e;let r=e.hiddenContentAbove===!0||n.has(`above`)?!0:void 0,i=e.hiddenContentBelow===!0||n.has(`below`)?!0:void 0;return{...e,hiddenContentAbove:r,hiddenContentBelow:i}}function fe(e,t,n){let r=new Map;for(let i of e){let e=pe(i,t,n);if(!e)continue;let a=r.get(e)??[];a.push(i),r.set(e,a)}return[`above`,`below`].flatMap(e=>{let t=r.get(e);if(!t||t.length===0)return[];let n=he(t).slice(0,3).map(e=>`"${e}"`),i=t.length===1?`interactive item`:`interactive items`,a=n.length>0?`: ${n.join(`, `)}`:``;return[`[off-screen ${e}] ${t.length} ${i}${a}`]})}function pe(e,t,n){if(!e.rect)return null;let r=C(e,t,n);return r?w(e.rect,r):null}function w(e,t){return e.y+e.height<=t.y?`above`:e.y>=t.y+t.height?`below`:null}function me(e){if(e.hittable===!0)return!0;let t=(e.type??``).toLowerCase();return t.includes(`button`)||t.includes(`link`)||t.includes(`textfield`)||t.includes(`edittext`)||t.includes(`searchfield`)||t.includes(`checkbox`)||t.includes(`radio`)||t.includes(`switch`)||t.includes(`menuitem`)||!!_(e)}function he(e){let t=new Set,n=[];for(let r of e){let e=_(r);!e||t.has(e)||(t.add(e),n.push(e))}return n}function ge(e,t,n){let r=e,i=new Set;for(;r&&!i.has(r.index);)i.add(r.index),t.add(r.index),r=typeof r.parentIndex==`number`?n.get(r.parentIndex):void 0}function T(e,t,n){return E(e,n,e=>t.has(e.index))}function _e(e,t,n,r,i){for(let a of e){let e=ve(a);if(!e||e.size===0)continue;let o=T(a,t,n);if(!o)continue;let s=r.get(o.index)??new Set,c=i.get(o.index);for(let t of e)c&&c.size>0&&!c.has(t)||s.add(t);r.set(o.index,s)}}function ve(e){let t=h(e.label,e.value);if(!t)return null;let n=new Set;return t.above&&n.add(`above`),t.below&&n.add(`below`),n.size>0?n:null}function ye(e,t){return E(e,t,e=>!!e.rect)?.rect??null}function E(e,t,n){let r=typeof e.parentIndex==`number`?t.get(e.parentIndex):void 0,i=new Set;for(;r&&!i.has(r.index);){if(i.add(r.index),n(r)&&y(r))return r;r=typeof r.parentIndex==`number`?t.get(r.parentIndex):void 0}return null}function D(e){let t=O(e.label),n=O(e.value),r=O(e.identifier),i=we(r)?r:``;return A(e.type??``)?n||t||i:t||n||i}function be(e,t){if(t===`text-view`||t===`text-field`||t===`search`)return!0;let n=k(e.type??``),r=`${e.role??``} ${e.subrole??``}`.toLowerCase();return n.includes(`textview`)||n.includes(`textarea`)||n.includes(`textfield`)||n.includes(`securetextfield`)||n.includes(`searchfield`)||n.includes(`edittext`)||r.includes(`text area`)||r.includes(`text field`)}function xe(e){let t=e.replace(/\s+/g,` `).trim();return t.length<=48?t:`${t.slice(0,45)}...`}function Se(e,t){let n=D(e),r=be(e,t);return{text:n,isLargeSurface:r,shouldSummarize:r&&Ce(n)}}function Ce(e){return e?e.length>80||/[\r\n]/.test(e):!1}function O(e){return typeof e==`string`?e.trim():``}function k(e){let t=e.trim().replace(/XCUIElementType/gi,``).replace(/^AX/,``).toLowerCase(),n=Math.max(t.lastIndexOf(`.`),t.lastIndexOf(`/`));return n!==-1&&(t=t.slice(n+1)),t}function A(e){let t=k(e);return t.includes(`textfield`)||t.includes(`securetextfield`)||t.includes(`searchfield`)||t.includes(`edittext`)||t.includes(`textview`)||t.includes(`textarea`)}function we(e){return e?!/^[\w.]+:id\/[\w.-]+$/i.test(e)&&!/^_?NS:\d+$/i.test(e):!1}function Te(e,t){let n=t.toLowerCase();return e.find(e=>{let t=(e.label??``).toLowerCase(),r=(e.value??``).toLowerCase(),i=(e.identifier??``).toLowerCase();return t.includes(n)||r.includes(n)||i.includes(n)})??null}function Ee(e,t){let n=[e.label,e.value,e.identifier].map(e=>typeof e==`string`?e.trim():``).find(e=>e&&e.length>0);return n&&j(n)?n:De(e,t)??(n&&j(n)?n:void 0)}function j(e){let t=e.trim();return!(!t||/^(true|false)$/i.test(t)||/^\d+$/.test(t))}function De(e,t){if(!e.rect)return;let n=e.rect.y+e.rect.height/2,r=null;for(let e of t){if(!e.rect)continue;let t=[e.label,e.value,e.identifier].map(e=>typeof e==`string`?e.trim():``).find(e=>e&&e.length>0);if(!t||!j(t))continue;let i=e.rect.y+e.rect.height/2,a=Math.abs(i-n);(!r||a<r.distance)&&(r={label:t,distance:a})}return r?.label}function Oe(e){let t=[],n=[];for(let r of e){let e=r.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let i=k(r.type??``),a=[r.label,r.value,r.identifier].map(e=>typeof e==`string`?e.trim():``).find(e=>e&&e.length>0),o=a?j(a):!1;if((i===`group`||i===`ioscontentgroup`)&&!o){t.push(e);continue}let s=Math.max(0,e-t.length);n.push({...r,depth:s})}return n}function M(e,t){let n=k(e);return n?t===`android`?n.includes(`edittext`)||n.includes(`autocompletetextview`):n.includes(`textfield`)||n.includes(`securetextfield`)||n.includes(`searchfield`)||n.includes(`textview`)||n.includes(`textarea`)||n===`search`:!0}function ke(e,t){return t.hittable?t:F(e,t,e=>e.hittable===!0)}function N(e){return new Map(e.map(e=>[e.index,e]))}function P(e,t,n,r){let i=t,a=new Set;for(;typeof i.parentIndex==`number`&&!a.has(i.index);){if(a.add(i.index),i=n.get(i.parentIndex)??e[i.parentIndex],!i)return null;let t=r(i);if(t!==null)return t}return null}function F(e,t,n){return P(e,t,N(e),e=>n(e)?e:null)}function I(e){return[e.label,e.value,e.identifier].map(e=>typeof e==`string`?e.trim():``).filter(e=>e.length>0)[0]??``}function Ae(e){return D(e)}function L(e){return e.hittable===!0?!0:e.rect?e.rect.width>0&&e.rect.height>0:!1}function R(e,t){return M(e.type??``,t)&&e.enabled!==!1}function z(e){return[`visible`,`hidden`,`exists`,`editable`,`selected`,`focused`,`text`].includes(e)}function B(e){let t=e.toLowerCase();return z(t)?{ok:!0,predicate:t}:a(`is requires predicate: visible|hidden|exists|editable|selected|focused|text`,je)}const je=`Use "is <predicate> <selector>" or "is <selector> <predicate>". visible|hidden|editable|selected|focused double as selector keys: a bare predicate token after the selector is read as the predicate, so write key=true (e.g. visible=true) inside the selector to use it as a filter instead.`;function Me(e){if(z((e[0]??``).toLowerCase()))return e;for(let t=1;t<e.length;t+=1){let n=(e[t]??``).toLowerCase();if(z(n)&&i(e.slice(0,t).join(` `)))return[n,...e.slice(0,t),...e.slice(t+1)]}return e}function Ne(e){let{predicate:t,node:n,nodes:r,expectedText:i,platform:a}=e,o=I(n),s=R(n,a),c=n.selected===!0,l=n.focused===!0,u=t===`text`?L(n):Pe(n,r,a),d=!1;switch(t){case`visible`:d=u;break;case`hidden`:d=!u;break;case`editable`:d=s;break;case`selected`:d=c;break;case`focused`:d=l;break;case`text`:d=o===(i??``);break}let f=t===`text`?`expected="${i??``}" actual="${o}"`:`actual=${JSON.stringify({visible:u,editable:s,selected:c,focused:l})}`;return{pass:d,actualText:o,details:f}}function Pe(e,t,n){if(n===`android`&&e.visibleToUser===!1)return!1;if(o(e.rect))return Fe(e,t);if(e.rect)return!1;if(n!==`android`&&e.hittable===!0)return!0;let r=Ie(e,t,n);return r?o(r.rect)?Fe(r,t):n!==`android`&&r.hittable===!0:!1}function Fe(e,t){return x(e,t)}function Ie(e,t,n){return P(t,e,N(t),e=>Le(e,n)?e:null)}function Le(e,t){if(t===`android`&&e.visibleToUser===!1)return!1;let n=k(e.type??``);return n.includes(`application`)||n.includes(`window`)||n.includes(`scrollview`)||n.includes(`tableview`)||n.includes(`collectionview`)||n===`table`||n===`list`||n===`listview`?!1:t===`android`?e.hittable===!0&&o(e.rect):e.hittable===!0||o(e.rect)}function Re(e){let t=Me(e),n=t[0]??``;return{predicate:n,split:r(t.slice(1),{preferTrailingValue:n===`text`})}}const ze=`is requires a selector expression`,Be=`is text requires expected text value`;function Ve(e){let{predicate:t,split:n}=Re([...e]),r=B(t);if(!r.ok)return r;if(!n)return a(ze);let i=n.rest.join(` `).trim();return r.predicate===`text`&&!i?a(Be):r.predicate!==`text`&&n.rest.length>0?a(`is ${r.predicate} does not accept trailing values`):{ok:!0,predicate:r.predicate,selectorExpression:n.selectorExpression,expectedText:i}}function He(e){return e===`text`||e===`attrs`?{ok:!0,format:e}:a(`get only supports text or attrs`)}function Ue(e){let t=e[0];if(t?.startsWith(`@`)){let n=e.slice(1).join(` `).trim();return{ok:!0,ref:t,...n?{label:n}:{}}}let n=e.join(` `).trim();return n?{ok:!0,selector:n}:a(`get requires @ref or selector expression`)}function We(e){return e?{ok:!0,text:e}:a(`wait requires text`)}function V(e,t,n){return t.terms.every(t=>Ge(e,t,n))}function Ge(e,t,n){switch(t.key){case`id`:return H(e.identifier,String(t.value));case`role`:return H(k(e.type??``),String(t.value));case`label`:return H(e.label,String(t.value));case`value`:return H(e.value,String(t.value));case`text`:return H(I(e),String(t.value));case`appname`:return H(e.appName,String(t.value));case`windowtitle`:return H(e.windowTitle,String(t.value));case`visible`:return L(e)===!!t.value;case`hidden`:return!L(e)==!!t.value;case`editable`:return R(e,n)===!!t.value;case`selected`:return e.selected===!0==!!t.value;case`focused`:return e.focused===!0==!!t.value;case`enabled`:return e.enabled!==!1==!!t.value;case`hittable`:return e.hittable===!0==!!t.value;default:return!1}}function H(e,t){return n(e??``)===n(t)}function Ke(e,t,n){let r=n.requireRect??!1,i=n.requireUnique??!0,a=[];for(let[o,s]of t.selectors.entries()){let t=Qe(e,s,n.platform,r);if(a.push({selector:s.raw,matches:t.count}),!(t.count===0||!t.firstNode)){if(i&&t.count!==1){if(!n.disambiguateAmbiguous||!t.disambiguated||!t.tiebreak)continue;return{node:t.disambiguated,selector:s,selectorIndex:o,matches:t.count,diagnostics:a,disambiguation:{matchCount:t.count,tiebreak:t.tiebreak,alternatives:t.candidates.filter(e=>e!==t.disambiguated)}}}return{node:t.firstNode,selector:s,selectorIndex:o,matches:t.count,diagnostics:a}}}return null}function qe(e,t,n){let r=n.requireRect??!1;for(let[i,a]of t.selectors.entries()){let t=e.filter(e=>r&&!e.rect?!1:V(e,a,n.platform));if(t.length>0)return{selector:a,selectorIndex:i,matchedNodes:t}}return null}function Je(e,t,n){let r=n.requireRect??!1,i=[];for(let[a,o]of t.selectors.entries()){let t=nt(e,o,n.platform,r);if(i.push({selector:o.raw,matches:t}),t>0)return{selectorIndex:a,selector:o,matches:t,diagnostics:i}}return null}const Ye=`Snapshot refs expire when the UI changes. Run snapshot -i and retry with a fresh @ref.`;function Xe(e){return e.some(e=>e.matches>1)?`Add more terms to disambiguate (e.g. role=button text="Sign in"), use an @ref from snapshot -i, or use find <text> --first/--last.`:`Selector text/label values match exactly (quote multi-word values: text="Sign in"). Run snapshot -i to see current elements and refs, or use find <text> for contains matching.`}function Ze(e,t,n){if(t.length===0)return`Selector did not match: ${e.raw}`;let r=t.map(e=>`${e.selector} -> ${e.matches}`).join(`, `);return n.unique??!0?`Selector did not resolve uniquely (${r})`:`Selector did not match (${r})`}function Qe(e,t,n,r){let i=0,a=null,o=[],s={best:null,bestVisible:!1,tie:!1},c,l=t=>(c??=g(e),ae(t,e,c));for(let c of e)r&&!c.rect||V(c,t,n)&&(i+=1,a??=c,o.push(c),$e(s,c,l));return{count:i,firstNode:a,disambiguated:s.tie?null:s.best,tiebreak:s.tie?null:et(o,s.best,l),candidates:o}}function $e(e,t,n){if(!e.best){e.best=t;return}e.bestVisible||=n(e.best);let r=n(t);if(r!==e.bestVisible){r&&(e.best=t,e.bestVisible=!0,e.tie=!1);return}let i=rt(t,e.best);i.result>0?(e.best=t,e.tie=!1):i.result===0&&(e.tie=!0)}function et(e,t,n){if(!t)return null;let r=null;for(let i of e)i!==t&&(!r||tt(i,r,n).result>0)&&(r=i);return r?tt(t,r,n).criterion:null}function tt(e,t,n){let r=n(e);return r===n(t)?rt(e,t):{result:r?1:-1,criterion:`visible`}}function nt(e,t,n,r){let i=0;for(let a of e)r&&!a.rect||V(a,t,n)&&(i+=1);return i}function rt(e,t){let n=e.depth??0,r=t.depth??0;if(n!==r)return{result:n>r?1:-1,criterion:`deepest`};let i=it(e),a=it(t);return i===a?{result:0,criterion:null}:{result:i<a?1:-1,criterion:`smallest-area`}}function it(e){return e.rect?e.rect.width*e.rect.height:1/0}const at=/^#\s*agent-device:target-v(\d+)(?:\s+(\S.*))?$/,ot=4096;function U(e){return e.normalize(`NFC`)}function st(e){if(e===void 0)return;let t=U(e);return t.length>0?t:void 0}function ct(e){return U(e)}function lt(e){if(e===void 0)return;let t=U(e).trim().replace(/\s+/g,` `);return t.length>0?t:void 0}function W(e){return Buffer.byteLength(e,`utf8`)}function G(e,t){if(W(e)<=t)return e;let n=e.length;for(;n>0&&W(e.slice(0,n))>t;)--n;if(n>0){let t=e.charCodeAt(n-1);t>=55296&&t<=56319&&--n}return e.slice(0,n)}function ut(e){let t={};return e.id!==void 0&&(t.id=e.id),t.role=e.role,e.label!==void 0&&(t.label=e.label),t.ancestry=e.ancestry.map(dt),t.sibling=e.sibling,t.viewportOrder=e.viewportOrder,e.scrollRegion&&(t.scrollRegion=ft(e.scrollRegion)),e.rect&&(t.rect=pt(e.rect)),t.verification=e.verification,t}function dt(e){let t={role:e.role};return e.label!==void 0&&(t.label=e.label),t}function ft(e){let t={role:e.role};return e.id!==void 0&&(t.id=e.id),e.label!==void 0&&(t.label=e.label),t}function pt(e){return{x:e.x,y:e.y,width:e.width,height:e.height}}function mt(e){return JSON.stringify(ut(e))}function ht(e){return`# agent-device:target-v1 ${mt(e)}`}function gt(e){let t=e.trim();if(!t.startsWith(`#`))return{kind:`none`};let n=at.exec(t);return n?Number(n[1])===1?{kind:`v1`,evidence:_t((n[2]??``).trim())}:{kind:`future-version`}:{kind:`none`}}function _t(t){if(W(t)>4096)throw new e(`INVALID_ARGS`,`target-v1 annotation exceeds the ${ot}-byte payload cap.`);let n;try{n=JSON.parse(t)}catch{throw new e(`INVALID_ARGS`,`target-v1 annotation is not valid JSON.`)}if(typeof n!=`object`||!n||Array.isArray(n))throw new e(`INVALID_ARGS`,`target-v1 annotation must be a JSON object.`);let r=n,i=K(r.role,`role`),a=vt(r.id,`id`),o=q(r.label,`label`),s=yt(r.ancestry),c=xt(r.sibling,`sibling`,0),l=xt(r.viewportOrder,`viewportOrder`,0),u=St(r.scrollRegion),d=Ct(r.rect),f=wt(r.verification);return{...a===void 0?{}:{id:a},role:i,...o===void 0?{}:{label:o},ancestry:s,sibling:c,viewportOrder:l,...u?{scrollRegion:u}:{},...d?{rect:d}:{},verification:f}}function K(t,n){if(t===void 0)throw new e(`INVALID_ARGS`,`target-v1 "${n}" is required.`);if(typeof t!=`string`)throw new e(`INVALID_ARGS`,`target-v1 "${n}" must be a string.`);return J(ct(t),n)}function vt(t,n){if(t===void 0)return;if(typeof t!=`string`)throw new e(`INVALID_ARGS`,`target-v1 "${n}" must be a string.`);let r=st(t);return r===void 0?void 0:J(r,n)}function q(t,n){if(t===void 0)return;if(typeof t!=`string`)throw new e(`INVALID_ARGS`,`target-v1 "${n}" must be a string.`);let r=lt(t);return r===void 0?void 0:J(r,n)}function J(t,n){if(W(t)>256)throw new e(`INVALID_ARGS`,`target-v1 "${n}" exceeds the 256-byte field cap.`);return t}function yt(t){if(t===void 0)return[];if(!Array.isArray(t))throw new e(`INVALID_ARGS`,`target-v1 "ancestry" must be an array.`);if(t.length>8)throw new e(`INVALID_ARGS`,`target-v1 "ancestry" exceeds the 8-entry cap.`);return t.map((e,t)=>bt(e,t))}function bt(t,n){if(typeof t!=`object`||!t||Array.isArray(t))throw new e(`INVALID_ARGS`,`target-v1 "ancestry[${n}]" must be an object.`);let r=t,i=K(r.role,`ancestry[${n}].role`),a=q(r.label,`ancestry[${n}].label`);return{role:i,...a===void 0?{}:{label:a}}}function xt(t,n,r){if(t===void 0)return r;if(typeof t!=`number`||!Number.isSafeInteger(t)||t<0)throw new e(`INVALID_ARGS`,`target-v1 "${n}" must be a non-negative integer.`);return t}function St(t){if(t===void 0)return;if(typeof t!=`object`||!t||Array.isArray(t))throw new e(`INVALID_ARGS`,`target-v1 "scrollRegion" must be an object.`);let n=t,r=K(n.role,`scrollRegion.role`),i=vt(n.id,`id`),a=q(n.label,`scrollRegion.label`);return{role:r,...i===void 0?{}:{id:i},...a===void 0?{}:{label:a}}}function Ct(t){if(t===void 0)return;if(typeof t!=`object`||!t||Array.isArray(t))throw new e(`INVALID_ARGS`,`target-v1 "rect" must be an object.`);let n=t;return{x:Y(n.x,`rect.x`),y:Y(n.y,`rect.y`),width:Y(n.width,`rect.width`),height:Y(n.height,`rect.height`)}}function Y(t,n){if(typeof t!=`number`||!Number.isFinite(t))throw new e(`INVALID_ARGS`,`target-v1 "${n}" must be a finite number.`);return t}function wt(t){if(t===`verified`||t===`unverifiable`)return t;throw new e(`INVALID_ARGS`,`target-v1 "verification" must be "verified" or "unverifiable".`)}function X(e){let t=ct(k(e.type??``)),n=st(e.identifier),r=lt(e.label);return{...n===void 0?{}:{id:G(n,256)},role:G(t,256),...r===void 0?{}:{label:G(r,256)}}}function Tt(e,t){return e.id===t.id&&e.role===t.role&&e.label===t.label}function Et(e,t){let n=0;for(let r of e)X(r).id===t&&(n+=1);return n}function Dt(e,t){if(e.id===void 0||Et(t,e.id)<=1)return e;let{role:n,label:r}=e;return{role:n,...r===void 0?{}:{label:r}}}function Z(e,t){let n=0;for(let r of e)if(r.parentIndex===t.parentIndex){if(r.index===t.index)return n;n+=1}return 0}function Ot(e,t){return{documentOrder:e.index,sibling:Z(t,e)}}function kt(e,t){return e.documentOrder===t.documentOrder&&e.sibling===t.sibling}const At=`replay_target_guard_mismatch`,jt=`wait_landmark_identity_mismatch`;function Mt(e,t,n={}){let r=[],i=k(e.type??``),a=Nt(e,n.nodes),o=$(e.label),s=$(e.value),c=$(I(e)),l=n.action===`fill`;a&&r.push(`id=${Q(a)}`),i&&o&&r.push(l?`role=${Q(i)} label=${Q(o)} editable=true`:`role=${Q(i)} label=${Q(o)}`),o&&r.push(l?`label=${Q(o)} editable=true`:`label=${Q(o)}`),s&&r.push(l?`value=${Q(s)} editable=true`:`value=${Q(s)}`),c&&c!==o&&c!==s&&r.push(l?`text=${Q(c)} editable=true`:`text=${Q(c)}`),i&&l&&!r.some(e=>e.includes(`editable=true`))&&r.push(`role=${Q(i)} editable=true`);let u=Pt(r);return u.length===0&&i&&u.push(l?`role=${Q(i)} editable=true`:`role=${Q(i)}`),u.length===0&&L(e)&&u.push(`visible=true`),u}function Nt(e,t){let n=$(e.identifier);if(!n||!t)return n;let r=X(e).id;return r===void 0?n:Et(t,r)>1?null:n}function Pt(e){return Array.from(new Set(e))}function Q(e){return JSON.stringify(e)}function $(e){return e&&e.trim()||null}export{x as $,B as A,M as B,Be as C,Ve as D,He as E,Ae as F,D as G,Ee as H,I,O as J,k as K,F as L,Me as M,R as N,We as O,L as P,oe as Q,ke as R,V as S,Ue as T,xe as U,Oe as V,Se as W,se as X,re as Y,ie as Z,Je as _,Dt as a,_ as at,Ke as b,Ot as c,ee as ct,ot as d,l as dt,ae as et,ht as f,o as ft,Ye as g,W as h,jt as i,g as it,Ne as j,Re as k,Z as l,f as lt,mt as m,s as mt,$ as n,y as nt,Tt as o,ne as ot,gt as p,c as pt,A as q,At as r,v as rt,X as s,h as st,Mt as t,C as tt,kt as u,p as ut,Ze as v,ze as w,Xe as x,qe as y,Te as z};
+import{tn as e}from"./sdk-batch-runner.js";function t(t,n,r){return e(typeof t==`string`?t:t.raw,n,r)}export{t};