agent-device 0.21.23 → 0.21.24

package/dist/src/limrun.d.ts

@@ -1,558 +1,7 @@
-import { A as Rect, D as IosTargetActivation, F as SnapshotOptions$1, I as SnapshotProvenance, N as SnapshotKeyboardBandFact, O as Point, S as DeviceTarget, b as DeviceInfo, f as LeaseBackend, k as RawSnapshotNode, w as PlatformSelector, x as DeviceKind } from "./sdk-contracts.js";
-import { s as AppsFilter, t as GesturePlan } from "./gesture-plan-types.js";
-import { d as AndroidAdbProvider, m as AppStateRuntimeResult, n as AndroidKeyboardState, s as AndroidInputOwner, t as AndroidKeyboardDismissResult } from "./device-input-state.js";
-import { A as BackMode, E as DeviceRotation, a as BackendSnapshotResult, b as ScrollExecutionOptions, g as SettingOptions, h as ReadableSetting, l as SessionSurface, m as ReadSettingResult, n as CloudArtifactProvider, v as TvRemoteButton, x as ScrollDirection } from "./cloud-artifacts.js";
-//#region packages/contracts/src/device-inventory.d.ts
-type DeviceInventoryRequest = {
-  platform?: PlatformSelector;
-  target?: DeviceTarget;
-  deviceName?: string;
-  udid?: string;
-  serial?: string;
-  leaseId?: string;
-  leaseProvider?: string;
-  deviceKey?: string;
-  clientId?: string;
-  iosSimulatorSetPath?: string;
-  androidSerialAllowlist?: string[];
-  /** Internal local-inventory projection filters; not public command grammar. */
-  kind?: DeviceKind;
-  booted?: boolean;
-  /** Internal target-resolution policy; ordinary inventory leaves this absent and lists all AVDs. */
-  androidAvdSelection?: 'running-only' | 'include-stopped';
-};
-type ProviderDeviceInventoryRequest = Omit<DeviceInventoryRequest, 'booted' | 'kind'>;
-//#endregion
-//#region packages/contracts/src/ios-system-surface.d.ts
-/**
- * iOS out-of-process system surfaces that agent-device observes and drives IN PLACE, never by
- * activation: launching or activating the host cancels what it presents (issue #2438), so the
- * runner addresses the host process while it is foreground and the `open` path refuses it. The set
- * is deliberately closed and tiny; add a host only with live evidence that it presents out of
- * process and dies on activation. Rationale per host lives in the canonical fixture
- * `contracts/fixtures/ios-system-surface-hosts.json` (see also docs/adr/0004); this module and the
- * Swift `SystemSurfaceHostRegistry` both mirror it, each guarded by a parity test.
- */
-/** Why a system surface is served in place; carried at snapshot-response level as provenance. */
-type IosSystemSurfaceKind = 'web-auth' | 'payment';
-/**
- * Whole-snapshot provenance: the capture describes a system surface presented over the session app,
- * not the app itself. Carried at response level (it applies to the entire snapshot) and folded into
- * iOS snapshot lineage so `--verify`/`--settle` never compare an app baseline against a sheet
- * capture. Mirrors the Android system-chrome/system-surface provenance model.
- */
-type IosSystemSurfaceProvenance = Readonly<{
-  bundleId: string;
-  kind: IosSystemSurfaceKind;
-}>;
-//#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/ios-snapshot.d.ts
-type IosSnapshotProducer = 'apple-runner' | 'simulator-ax-bridge' | 'appium-source' | 'limrun-ios-tree';
-type IosAcquisitionProducer = Exclude<IosSnapshotProducer, 'apple-runner'>;
-type IosAcquisitionIntent = 'full' | 'surface-observation';
-type IosSnapshotProjection = 'regular' | 'raw';
-type IosSnapshotGeneration = string;
-type IosSnapshotLineage = Readonly<{
-  targetId?: string;
-  generation?: IosSnapshotGeneration;
-}>;
-type IosSnapshotPresentationKey = Readonly<{
-  projection: IosSnapshotProjection;
-  interactiveOnly: boolean;
-  depth: number | null;
-  scope: string | null;
-  customActions: boolean;
-}>;
-type CaptureHint = Readonly<{
-  projection: IosSnapshotProjection;
-  rawTraversalDepth: number | null;
-  regularPresentedDepth: number | null;
-  interactiveOnly: boolean;
-  customActions: boolean;
-  acquisitionIntent: IosAcquisitionIntent;
-}>;
-type IosSnapshotFact = 'acquisition-depth' | 'scope' | 'interactive-query' | 'viewport' | 'hittability' | 'generation' | 'truncation';
-type IosViewportEvidence = Readonly<{
-  kind: 'reported';
-  rect: Rect;
-}> | Readonly<{
-  kind: 'derived';
-  rect: Rect;
-}> | Readonly<{
-  kind: 'missing';
-  reason: 'not-provided' | 'not-supported' | 'invalid';
-}>;
-type IosProviderPrunedField = 'nodes' | 'depth' | 'scope' | 'interactive-only';
-type IosAcquisitionResidue = Readonly<{
-  kind: 'provider-pruned';
-  fields: readonly IosProviderPrunedField[];
-}> | Readonly<{
-  kind: 'missing-viewport';
-  reason: 'not-provided' | 'not-supported' | 'invalid';
-}> | Readonly<{
-  kind: 'truncated';
-}> | Readonly<{
-  kind: 'stale-generation';
-  expected?: IosSnapshotGeneration;
-  observed?: IosSnapshotGeneration;
-}> | Readonly<{
-  kind: 'unknown-generation';
-  captureId: string;
-}> | Readonly<{
-  kind: 'unavailable-fact';
-  fact: IosSnapshotFact;
-}> | Readonly<{
-  kind: 'fallback-source';
-  producer: IosSnapshotProducer;
-}>;
-type IosSnapshotAcquisitionForIntent<Intent extends IosAcquisitionIntent> = Readonly<{
-  producer: IosAcquisitionProducer;
-  intent: Intent;
-  hint: CaptureHint & Readonly<{
-    acquisitionIntent: Intent;
-  }>;
-  nodes: readonly RawSnapshotNode[];
-  truncated?: boolean;
-  viewport: IosViewportEvidence;
-  lineage: IosSnapshotLineage;
-  residue: readonly IosAcquisitionResidue[];
-}>;
-type IosSnapshotAcquisition = IosSnapshotAcquisitionForIntent<'full'> | IosSnapshotAcquisitionForIntent<'surface-observation'>;
-type IosSnapshotAcquisitionFacts = Omit<IosSnapshotAcquisition, 'hint'>;
-type IosSnapshotComparisonIdentity = Readonly<{
-  producer: IosSnapshotProducer;
-  intent: IosAcquisitionIntent;
-  lineage: IosSnapshotLineage;
-  presentationKey: IosSnapshotPresentationKey;
-  residue: readonly IosAcquisitionResidue[];
-}>;
-//#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';
-};
-/**
- * What the capture owner observed while writing the image. `displayRotation` is the rotation the display
- * rendered the pixels in, so a landscape value pairs with a landscape image; it is absent when the
- * owner has no rotation reading it can stand behind for this capture.
- */
-type ScreenshotCaptureFacts = Readonly<{
-  displayRotation?: DeviceRotation;
-}>;
-type ElementSelectorKey = 'id' | 'label' | 'text' | 'value';
-type ElementSelectorTapOptions = {
-  key: ElementSelectorKey;
-  value: string;
-  allowNonHittableCoordinateFallback?: boolean;
-  expectedPoint?: Point;
-};
-type PressPointOptions = Readonly<{
-  button: 'primary' | 'secondary' | 'middle';
-  count: number;
-  intervalMs: number;
-  holdMs: number;
-  jitterPx: number;
-  doubleTap: boolean;
-  surface?: SessionSurface;
-}>;
-/**
- * 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, packages/platform-apple/src/interactions.ts) drops a
- * route it cannot name — so a Swift-side addition would silently vanish. The
- * route-parity test in packages/platform-apple/src/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 SnapshotOptions = SnapshotOptions$1 & {
-  appBundleId?: string;
-  signal?: AbortSignal;
-  includeRects?: boolean;
-  includeHiddenContentHints?: boolean;
-  surface?: SessionSurface;
-  /** Internal capture purpose; action outcomes always require the full tree. */
-  acquisitionIntent?: 'full' | 'surface-observation';
-  /**
-   * A one-off read, such as an open's launch observation. It may use a capture host the session
-   * already keeps warm, but it never installs one or leaves running one that it started. It starts
-   * no re-capture after `settleBy` (epoch ms); only `signal` cancels work already started.
-   */
-  transient?: Readonly<{
-    settleBy: number;
-  }>;
-};
-/**
- * Android's live IME status read. Optional on {@link Interactor}: parity with the retired leaf,
- * which refused `status`/`get` on every other family (no other platform's runner exposes one).
- * A single-member discriminated union rather than a bare object so the daemon can derive its wire
- * `platform` label from `kind` the same way it does for dismiss and enter — an owner can only ever
- * produce its own result shape.
- */
-type KeyboardStatusResult = Readonly<{
-  kind: 'ime-probe';
-  visible: boolean;
-  inputType?: string;
-  type?: string;
-  inputMethodPackage?: string;
-  focusedPackage?: string;
-  focusedResourceId?: string;
-  inputOwner?: string;
-}>;
-/**
- * Owner-shaped dismiss evidence, discriminated by which owner produced it: Android's IME probe
- * fields, or iOS's `mechanism` disclosure (#1598), or HarmonyOS's bare acknowledgment (its HDC
- * key press reports nothing beyond success). The daemon derives the wire `platform` label from
- * `kind` rather than re-deriving it from the device, so an owner can only ever produce its own
- * result shape — an android-probe result under an `ios` label is unrepresentable.
- */
-type KeyboardDismissResult = Readonly<{
-  kind: 'ime-probe';
-  attempts?: number;
-  wasVisible?: boolean;
-  dismissed?: boolean;
-  visible?: boolean;
-  inputType?: string;
-  type?: string;
-  inputMethodPackage?: string;
-  focusedPackage?: string;
-  focusedResourceId?: string;
-  inputOwner?: string;
-}> | Readonly<{
-  kind: 'mechanism';
-  wasVisible?: boolean;
-  dismissed?: boolean;
-  visible?: boolean;
-  mechanism?: string;
-}> | Readonly<{
-  kind: 'acknowledged';
-}>;
-/**
- * Only the Apple runner echoes visibility around the return-key press; Android and HarmonyOS
- * acknowledge with no fields beyond success. Kind is owner-specific, not just content-shaped —
- * Android's and HarmonyOS's acknowledgments are structurally identical, so only the discriminant
- * itself tells the daemon which owner actually pressed enter.
- */
-type KeyboardEnterResult = Readonly<{
-  kind: 'visibility-echo';
-  visible?: boolean;
-  wasVisible?: boolean;
-}> | Readonly<{
-  kind: 'android-acknowledged';
-}> | Readonly<{
-  kind: 'harmonyos-acknowledged';
-}>;
-/**
- * Every acquisition carries its provenance pair atomically: the channel alone cannot say who
- * acquired the tree or which guarantees it carries, and `SnapshotProvenance`
- * (`@agent-device/kernel/snapshot`) makes a cross-channel `backend`/`producer` combination
- * fail to compile.
- */
-type SnapshotResult = Omit<BackendSnapshotResult, 'backend' | 'nodes'> & {
-  nodes?: RawSnapshotNode[];
-  comparisonIdentity?: IosSnapshotComparisonIdentity;
-  /**
-   * Set when the capture describes an in-place iOS system surface (a web sign-in sheet) presented
-   * over the session app rather than the app itself (#2438).
-   */
-  systemSurface?: IosSystemSurfaceProvenance;
-  /**
-   * The keyboard band the producer measured while capturing, when it can measure one (#2660). A
-   * producer that publishes nothing measured nothing, so the tap-path guard keeps deriving the band
-   * from `nodes`; see {@link SnapshotKeyboardBandFact}.
-   */
-  keyboard?: SnapshotKeyboardBandFact;
-  /**
-   * Set when this capture's own command had to bring the session app back to the foreground, i.e.
-   * something else held it and an earlier observation described that instead (#2682).
-   */
-  targetActivation?: IosTargetActivation;
-} & SnapshotProvenance;
-type SnapshotRuntimeAcquiredResult = Readonly<{
-  stage: 'acquired';
-  acquisition: IosSnapshotAcquisitionFacts & Readonly<{
-    producer: IosAcquisitionProducer;
-  }>;
-}>;
-type SnapshotRuntimeResult = SnapshotResult | SnapshotRuntimeAcquiredResult;
-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>;
-  /** Complete point-press semantics for owners with fused series, alternate buttons, or surfaces. */
-  pressPoint?(point: Point, options: PressPointOptions): Promise<Record<string, unknown> | void>;
-  /** Alternate mouse buttons for owners that otherwise use the shared point-press series. */
-  alternateClick?(point: Point, button: 'secondary' | 'middle'): Promise<Record<string, unknown> | void>;
-  /** Owner-native ref routes; currently the managed web runtime is their only local owner. */
-  tapRef?(ref: string): Promise<Record<string, unknown> | void>;
-  tapElementSelector?(selector: ElementSelectorTapOptions): Promise<Record<string, unknown> | void>;
-  /**
-   * Fused double-click for owners that have one. The shared `--count` series cannot stand in for it —
-   * it spaces and jitters independent presses rather than firing one pair the target reads as a
-   * double — so an owner with no such mechanic leaves this undefined and `press --double` reports the
-   * gap instead of resolving a denial.
-   */
-  doubleTap?(x: number, y: number): Promise<Record<string, unknown> | void>;
-  longPress(x: number, y: number, durationMs?: number): Promise<Record<string, unknown> | void>;
-  /**
-   * How the app the runner context names is running, as the platform reports it. The Apple runner
-   * reads `XCUIApplication.state`; owners that read the foreground elsewhere leave it undefined.
-   */
-  appState?(): Promise<AppStateRuntimeResult>;
-  /**
-   * Move the pointer to a point without pressing. Only pointer-driven
-   * platforms (web today) implement it; touch platforms have no hover state
-   * and leave it undefined, which the `hover` command reports as unsupported.
-   */
-  hover?(x: number, y: number): Promise<Record<string, unknown> | void>;
-  hoverRef?(ref: string): Promise<Record<string, unknown> | void>;
-  focus(x: number, y: number): Promise<Record<string, unknown> | void>;
-  type(text: string, delayMs?: number): Promise<TypeTextBackendResult | void>;
-  /**
-   * Replace the target's text with `text`. The empty string is the clear request (#2063), not a
-   * no-op: an implementation must empty the field or fail — never report success over an
-   * untouched value. A backend with no clear mechanism refuses the empty text up front (see the
-   * webdriver interactor).
-   */
-  fill(x: number, y: number, text: string, delayMs?: number, options?: {
-    allowNonHittableCoordinateFallback?: boolean;
-  }): Promise<Record<string, unknown> | void>;
-  fillRef?(ref: string, text: string, delayMs?: number): Promise<Record<string, unknown> | void>;
-  scroll(direction: ScrollDirection, options?: ScrollExecutionOptions): Promise<Record<string, unknown> | void>;
-  screenshot(outPath: string, options?: ScreenshotOptions): Promise<ScreenshotCaptureFacts | void>;
-  setViewport?(width: number, height: number): Promise<Record<string, unknown> | void>;
-  snapshot(options?: SnapshotOptions): Promise<SnapshotRuntimeResult>;
-  /**
-   * Native reading of the live text at a point, when the backend has one. Answers the text the
-   * owner can see right now, which can exceed what an already-captured node carries (an editable
-   * field whose value is longer than its label). Optional: a backend without it leaves the
-   * captured tree as the complete answer.
-   */
-  readTextAtPoint?(point: Point, options?: {
-    appBundleId?: string;
-    surface?: SessionSurface;
-    signal?: AbortSignal;
-  }): Promise<string | undefined>;
-  /**
-   * Native text-presence reading, when the backend has one that does not require a tree capture.
-   * A `true` answer is authoritative; anything else means "not proven here" and the caller
-   * consults the canonical tree (see `FindTextResult`).
-   */
-  findText?(text: string, options?: {
-    appBundleId?: string;
-    signal?: AbortSignal;
-  }): Promise<{
-    found: boolean;
-  }>;
-  gestureViewport?(): Promise<Rect>;
-  back(mode?: BackMode): Promise<void>;
-  /**
-   * Optional (parity with `actionButton`): opens the springboard, a control not every owner
-   * carries. An owner without it leaves it undefined; its fact refuses the press before binding,
-   * and the system-button binder fails closed rather than resolving an absent member as a
-   * successful no-op.
-   */
-  home?(): Promise<void>;
-  setOrientation(orientation: DeviceRotation): Promise<{
-    orientation?: DeviceRotation;
-  } | void>;
-  performGesture?(plan: GesturePlan): Promise<Record<string, unknown> | void>;
-  /**
-   * Optional (parity with `home`): opens the recents surface, a control not every owner carries.
-   * An owner without it leaves it undefined; its fact refuses the press before binding, and the
-   * system-button binder fails closed rather than resolving an absent member as a successful
-   * no-op.
-   */
-  appSwitcher?(): Promise<void>;
-  /**
-   * Optional (parity with `home`): presses one TV remote key, a control only TV-capable owners
-   * carry. An owner without it leaves it undefined; its fact refuses the press before binding,
-   * and the TV remote binder fails closed rather than resolving an absent member as a silent
-   * no-op.
-   */
-  tvRemote?(button: TvRemoteButton, durationMs?: number): Promise<void>;
-  /**
-   * Optional (parity with `keyboardDismiss`): presses the iPhone/iPad Action Button, hardware only
-   * the Apple owner carries. An owner without the button leaves it undefined; its fact refuses the
-   * press before binding, and the system-button binder fails closed rather than resolving an
-   * absent member as a successful no-op.
-   */
-  actionButton?(): Promise<void>;
-  /** Optional: only Android implements a live status read (see {@link KeyboardStatusResult}). */
-  keyboardStatus?(): Promise<KeyboardStatusResult>;
-  /** Optional: platforms with no keyboard-dismiss concept leave it undefined. */
-  keyboardDismiss?(): Promise<KeyboardDismissResult>;
-  /** Optional: platforms with no keyboard-return concept leave it undefined. */
-  keyboardEnter?(): Promise<KeyboardEnterResult>;
-  /**
-   * Optional (parity with `readSetting`): the owner's pasteboard read. An owner with no clipboard
-   * surface leaves both halves undefined; its fact refuses the half before binding, and the
-   * clipboard binder fails closed rather than resolving an absent member as an empty answer.
-   */
-  readClipboard?(): Promise<string>;
-  /**
-   * Optional (parity with `readClipboard`): the owner's pasteboard write, with the same
-   * fact-then-guard contract as the read.
-   */
-  writeClipboard?(text: string): Promise<void>;
-  setSetting(setting: string, state: string, appId?: string, options?: SettingOptions): Promise<Record<string, unknown> | void>;
-  /**
-   * Optional: reads back the value a device holds for one readable setting. The name is narrowed to
-   * `READABLE_SETTINGS`, which is not every setting the write switch serves, and an owner's dispatch
-   * is exhaustive over it — a setting joins the list only with an owner that answers it. An owner with
-   * no read path leaves the member undefined; its fact refuses the read before binding, so an absent
-   * method can never resolve into an empty answer.
-   */
-  readSetting?(setting: ReadableSetting): Promise<ReadSettingResult>;
-  /**
-   * The four alert legs. Each owner runs its own observation and, where it needs one, its own
-   * poll: an alert is a transient device surface, and how long to look for it — and how to press
-   * its buttons — is family mechanics, not something a caller can supply. `timeoutMs` is the
-   * whole window the caller allows; the owner spends it however its backend requires.
-   *
-   * Optional: an owner with no alert surface leaves all four undefined. Its facts refuse every leg
-   * before binding, so the absent members are never resolved, and a fact that admitted a leg the
-   * interactor cannot serve fails closed instead of answering empty.
-   */
-  readAlert?(options?: AlertInteractorOptions): Promise<Record<string, unknown>>;
-  awaitAlert?(options?: AlertInteractorOptions): Promise<Record<string, unknown>>;
-  acceptAlert?(options?: AlertInteractorOptions): Promise<Record<string, unknown>>;
-  dismissAlert?(options?: AlertInteractorOptions): Promise<Record<string, unknown>>;
-};
-/**
- * The session-derived target one alert leg acts on. `appBundleId` is separate from the runner
- * context's because the macOS helper reads a frontmost-app surface with no bundle at all, and
- * the two must not collapse into one field that means both.
- */
-type AlertInteractorOptions = {
-  timeoutMs?: number;
-  appBundleId?: string;
-  surface?: SessionSurface;
-};
-//#endregion
-//#region packages/contracts/src/device-provider.d.ts
-type DeviceLease = {
-  leaseId: string;
-  tenantId: string;
-  runId: string;
-  backend: LeaseBackend;
-  leaseProvider?: string;
-  deviceKey?: string;
-  clientId?: string;
-  retainOnClose?: true;
-  createdAt: number;
-  heartbeatAt: number;
-  expiresAt: number;
-};
-type LeaseLifecycleContext = {
-  flags?: Readonly<Record<string, unknown>>;
-  initialApp?: string;
-  cwd?: string;
-  publicNetworkOnly?: boolean;
-  /** Request-bound cancellation (explicit cancel or client disconnect). */
-  signal?: AbortSignal;
-  /**
-   * Epoch-ms deadline by which `allocate` must have settled; derived from the
-   * same budget as the client's `lease_allocate` envelope, so a provider that
-   * fits its remote phases within it is never abandoned by a client first.
-   */
-  deadline?: number;
-};
-type LeaseLifecycleProvider = {
-  allocate?: (lease: DeviceLease, context?: LeaseLifecycleContext) => Promise<Record<string, unknown> | undefined>;
-  heartbeat?: (lease: DeviceLease, context?: LeaseLifecycleContext) => Promise<Record<string, unknown> | undefined>;
-  release?: (lease: DeviceLease, context?: LeaseLifecycleContext) => Promise<Record<string, unknown> | undefined>;
-};
-type DeviceInventoryProvider = (request: ProviderDeviceInventoryRequest, signal?: AbortSignal) => Promise<DeviceInfo[] | null | undefined>;
-type ProviderAppCatalogQuery = Readonly<{
-  provider: string;
-  platform: 'android' | 'ios';
-  publicNetworkOnly?: boolean;
-}>;
-type ProviderAppCatalogHandler = (query: ProviderAppCatalogQuery, signal?: AbortSignal) => Promise<readonly string[]>;
-//#endregion
-//#region packages/contracts/src/provider-device-runtime.d.ts
-type ProviderDeviceInstallResult = {
-  bundleId?: string;
-  packageName?: string;
-  appName?: string;
-  launchTarget?: string;
-};
-type ProviderDeviceInstallOptions = {
-  relaunch?: boolean;
-  appIdentifierHint?: string;
-  packageNameHint?: string;
-};
-type ProviderPortReverseOptions = {
-  leaseId: string;
-  provider?: string;
-  devicePort: number;
-  hostPort: number;
-  name: string;
-};
-type ProviderExpiredLeaseRecovery = (lease: DeviceLease) => Promise<void>;
-/** Provider adapter contract; root owns active-runtime and request composition. */
-type ProviderDeviceRuntime = {
-  provider: string;
-  leaseLifecycle: LeaseLifecycleProvider;
-  recoverExpiredLease?: ProviderExpiredLeaseRecovery;
-  cloudArtifacts?: CloudArtifactProvider;
-  appCatalog?: ProviderAppCatalogHandler;
-  deviceInventoryProvider: DeviceInventoryProvider;
-  ownsDevice(device: DeviceInfo): boolean;
-  getInteractor(device: DeviceInfo, runnerContext?: RunnerContext): Interactor | undefined;
-  installApp?(device: DeviceInfo, app: string, appPath: string, options?: ProviderDeviceInstallOptions): Promise<ProviderDeviceInstallResult | undefined>;
-  installInstallablePath?(device: DeviceInfo, installablePath: string, options?: ProviderDeviceInstallOptions): Promise<ProviderDeviceInstallResult | undefined>;
-  configurePortReverse?(options: ProviderPortReverseOptions): Promise<Record<string, unknown> | undefined>;
-  shutdown(): Promise<void>;
-};
-//#endregion
+import { b as DeviceInfo } from "./sdk-contracts.js";
+import { t as AppsFilter } from "./app-inventory.js";
+import { a as ProviderPortReverseOptions, i as ProviderExpiredLeaseRecovery, l as LeaseLifecycleProvider, n as ProviderDeviceInstallResult, o as DeviceInventoryProvider, r as ProviderDeviceRuntime, t as ProviderDeviceInstallOptions, u as Interactor } from "./provider-device-runtime.js";
+import { d as AndroidAdbProvider, n as AndroidKeyboardState, s as AndroidInputOwner, t as AndroidKeyboardDismissResult } from "./device-input-state.js";
 //#region packages/provider-limrun/src/runtime-dependencies.d.ts
 type LimrunAdbCommandOptions = {
   allowFailure?: boolean;

package/dist/src/load.js

@@ -1 +1 @@
-import{P as e}from"./sdk-contracts.js";import{a as t,i as n,n as r}from"./store.js";import{pathToFileURL as i}from"node:url";async function a(a,o){let s=r(a);n(s,o);let c=[];try{for(let n of s){let r=await import(i(t(n.directory,n.agentDevicePlugin.entry)).href);if(typeof r.default!=`function`)throw new e(`INVALID_ARGS`,`Plugin must export a default factory: ${n.name}`);let o=await r.default(Object.freeze({env:Object.freeze({...a}),options:Object.freeze({...n.selection.options}),createError:(t,n,r)=>new e(t,n,r)}));if(!o?.runtime||typeof o.runtime.shutdown!=`function`)throw new e(`INVALID_ARGS`,`Plugin must return a provider runtime: ${n.name}`);if(c.push(o),o.runtime.provider!==n.agentDevicePlugin.provider||typeof o.runtime.ownsDevice!=`function`||typeof o.runtime.getInteractor!=`function`||typeof o.runtime.deviceInventoryProvider!=`function`||!o.runtime.leaseLifecycle||typeof o.runtime.leaseLifecycle!=`object`||o.platformModule?.owner?.kind!==`provider-runtime`||o.platformModule.owner.provider!==o.runtime.provider||typeof o.platformModule.owner.instance!=`string`||o.platformModule.owner.instance.trim().length===0||typeof o.platformModule.loadRuntime!=`function`)throw new e(`INVALID_ARGS`,`Plugin runtime owner does not match its declaration: ${n.name}`)}return c}catch(e){throw await Promise.allSettled(c.map(async({runtime:e})=>await e.shutdown())),e}}export{a as loadProviderPlugins};
+import{r as e}from"./rolldown-runtime.js";import{P as t}from"./sdk-contracts.js";import{a as n}from"./version.js";import{a as r,n as i,t as a}from"./manifest.js";import{n as o}from"./store.js";import{pathToFileURL as s}from"node:url";function c(e,r){return Object.freeze({env:Object.freeze({...e}),options:Object.freeze({...r}),clientVersion:n(),createError:(e,n,r)=>new t(e,n,r)})}var l=e({loadProviderPlugins:()=>u,withPluginConnection:()=>d});async function u(e,t,n){let r=o(e);i(r,t);let a=[];try{for(let t of r.filter(e=>n===void 0||e.agentDevicePlugin.provider===n)){let n=await f(t,e);a.push(n),m(n,t)}return a}catch(e){throw await Promise.allSettled(a.map(async({runtime:e})=>await e.shutdown())),e}}async function d(e,n,r){let i=await u(n,a,e);try{let n=i.find(t=>t.runtime.provider===e)?.connection;if(!n)throw new t(`INVALID_ARGS`,`Plugin does not register connect: ${e}`);return await r(n)}finally{await Promise.allSettled(i.map(async({runtime:e})=>await e.shutdown()))}}async function f(e,n){let i=await import(s(r(e.directory,e.agentDevicePlugin.entry)).href);if(typeof i.default!=`function`)throw new t(`INVALID_ARGS`,`Plugin must export a default factory: ${e.name}`);let a=c(n,e.selection.options),o=await i.default(a),l;if(p(o)){if(o.webDriver?.provider!==e.agentDevicePlugin.provider)throw new t(`INVALID_ARGS`,`WebDriver plugin provider does not match its declaration: ${e.name}`);let{createCloudWebDriverRuntime:n}=await import(`./plugin.js`),r=await n({...o.webDriver,clientVersion:a.clientVersion});l={runtime:r,platformModule:r.platformRuntimeModule,connection:o.connection}}else l=o;if(!l?.runtime||typeof l.runtime.shutdown!=`function`)throw new t(`INVALID_ARGS`,`Plugin must return a provider runtime: ${e.name}`);return l}function p(e){return typeof e==`object`&&!!e&&`webDriver`in e}function m(e,n){if(e.runtime.provider!==n.agentDevicePlugin.provider||!g(e.runtime)||!h(e)||n.agentDevicePlugin.connection&&(typeof e.connection?.resolve!=`function`||typeof e.connection?.verify!=`function`))throw new t(`INVALID_ARGS`,`Plugin runtime owner does not match its declaration: ${n.name}`)}function h(e){let t=e.platformModule?.owner;return t?.kind===`provider-runtime`&&t.provider===e.runtime.provider&&typeof t.instance==`string`&&t.instance.trim().length>0&&typeof e.platformModule.loadRuntime==`function`}function g(e){return e.leaseLifecycle!==null&&typeof e.leaseLifecycle==`object`&&[`ownsDevice`,`getInteractor`,`deviceInventoryProvider`].every(t=>typeof e[t]==`function`)}export{d as n,l as t};

package/dist/src/local-interactor-operation-set.js

@@ -1 +1 @@
-import{nn as e}from"./sdk-batch.js";import{E as t,K as n,L as r,O as i,P as a,j as o}from"./alert-runtime.js";import{t as s}from"./touch-runtime.js";import{t as c}from"./interactor-operation-catalog.js";function l(l){let{facts:u,pause:d}=l,f={device:l.device,signal:l.signal,resolveInteractor:l.resolveInteractor};return{...u.captureScreenshot.available?n(f):{},...u.focusPoint.available?r(f):{},...a({...f,facts:u}),...u.scrollDirection.available?o(f):{},...u.typeText.available?i(f):{},...u.readTextAtPoint.available?t(f):{},...e(u.tapPoint,()=>s({...f,facts:u,pause:d})),...c({...f,facts:u})}}export{l as t};
+import{rn as e}from"./sdk-batch.js";import{E as t,K as n,L as r,O as i,P as a,j as o}from"./alert-runtime.js";import{t as s}from"./touch-runtime.js";import{t as c}from"./interactor-operation-catalog.js";function l(l){let{facts:u,pause:d}=l,f={device:l.device,signal:l.signal,resolveInteractor:l.resolveInteractor};return{...u.captureScreenshot.available?n(f):{},...u.focusPoint.available?r(f):{},...a({...f,facts:u}),...u.scrollDirection.available?o(f):{},...u.typeText.available?i(f):{},...u.readTextAtPoint.available?t(f):{},...e(u.tapPoint,()=>s({...f,facts:u,pause:d})),...c({...f,facts:u})}}export{l as t};

package/dist/src/managed-device-scope.js

@@ -1 +1 @@
-import{P as e}from"./sdk-contracts.js";import{P as t,j as n}from"./sdk-device.js";import{t as r}from"./scoped-provider.js";const i=r(void 0);function a(){return i.resolve()}async function o(e,t){return await i.run(e,t)}function s(r,i){if(!t(n(r.device),n(i))||r.device.simulatorSetPath!==i.simulatorSetPath)throw new e(`COMMAND_FAILED`,`Managed automation cannot select another device.`,{reason:`managed-device-transport-mismatch`})}function c(){let e=a();if(e)return async t=>{s(e,t)}}async function l(e){let t=c();return t?(await t(e),!0):!1}export{o as a,c as i,a as n,l as r,s as t};
+import{P as e}from"./sdk-contracts.js";import{I as t,N as n}from"./sdk-device.js";import{t as r}from"./scoped-provider.js";const i=r(void 0);function a(){return i.resolve()}async function o(e,t){return await i.run(e,t)}function s(r,i){if(!t(n(r.device),n(i))||r.device.simulatorSetPath!==i.simulatorSetPath)throw new e(`COMMAND_FAILED`,`Managed automation cannot select another device.`,{reason:`managed-device-transport-mismatch`})}function c(){let e=a();if(e)return async t=>{s(e,t)}}async function l(e){let t=c();return t?(await t(e),!0):!1}export{o as a,c as i,a as n,l as r,s as t};

package/dist/src/manifest.js

@@ -0,0 +1 @@
+import{r as e}from"./rolldown-runtime.js";import{P as t}from"./sdk-contracts.js";import{n}from"./providers.js";import r from"node:fs";import i from"node:path";var a=e({RESERVED_PLUGIN_PROVIDERS:()=>o,assertUniquePluginProviders:()=>s,readPluginManifest:()=>c,resolvePluginEntry:()=>d});const o=[`cloud`,`proxy`,...Object.values(n),`limrun`];function s(e,n){let r=new Set(n);for(let n of e){let e=n.agentDevicePlugin.provider;if(r.has(e))throw new t(`INVALID_ARGS`,`Duplicate provider plugin: ${e}`);r.add(e)}}function c(e){let n;try{let t=i.join(e,`package.json`);n=JSON.parse(r.readFileSync(t,`utf8`))}catch(n){throw new t(`INVALID_ARGS`,`Cannot read plugin manifest: ${e}`,{},n)}let a=n?.agentDevicePlugin;if(typeof n?.name!=`string`||typeof n?.version!=`string`||!a||a.apiVersion!==1||typeof a.provider!=`string`||!/^[a-z][a-z0-9-]*$/.test(a.provider)||typeof a.entry!=`string`||!a.entry.startsWith(`./`))throw new t(`INVALID_ARGS`,`Package does not declare a compatible provider plugin`,{reason:`incompatible_plugin`,apiVersion:1,hint:`Install a plugin release supporting agentDevicePlugin.apiVersion 1.`});return d(e,a.entry),l(a.connection),u(a.credentialVariables),n}function l(e){if(e!==void 0&&(!e||typeof e!=`object`||e.leaseKind!==`direct-device-provider`||[`requiresAppAttachment`,`requiresRemoteDaemon`,`supportsArtifacts`,`supportsDeferredAppSelection`,`supportsDirectPortReverse`,`usesCloudWebDriverLease`].some(t=>typeof e[t]!=`boolean`)||e.requiresRemoteDaemon))throw new t(`INVALID_ARGS`,`Plugin connection must declare local provider capabilities`)}function u(e){if(e!==void 0&&(!Array.isArray(e)||!e.every(e=>typeof e==`string`&&/^[A-Z_][A-Z0-9_]*$/.test(e))))throw new t(`INVALID_ARGS`,`Plugin credentialVariables must list environment variable names`)}function d(e,n){try{let t=r.realpathSync(e),a=r.realpathSync(i.resolve(e,n));if(a.startsWith(`${t}${i.sep}`)&&r.statSync(a).isFile())return a}catch{}throw new t(`INVALID_ARGS`,`Plugin entry must be a readable file inside its package`,{directory:e,entry:n})}export{d as a,c as i,s as n,a as r,o as t};