agent-device 0.20.8 → 0.20.10

package/dist/src/index.d.ts

@@ -1,1573 +1,6 @@
-import { A as SnapshotNode, B as DeviceTarget, C as normalizeAgentDeviceError, F as SnapshotVisibility, H as PlatformSelector, I as centerOfRect, L as AppleOS, M as SnapshotQualityVerdict, P as SnapshotUnchanged, S as isAgentDeviceError, U as PublicPlatform, _ as SessionRuntimeHints, a as DaemonRequest, b as NormalizedError, f as LeaseBackend, g as SessionIsolationMode, h as ResponseLevel, i as DaemonLockPolicy, o as DaemonResponse, p as NetworkIncludeMode, r as DaemonInstallSource, s as DaemonResponseData, t as DaemonArtifact, v as AppError, y as DaemonError, z as DeviceKind } from "./sdk-contracts.js";
-import { c as ScrollDirection, d as SwipePreset, f as TransformGestureParams, l as ScrollInputDirection, s as GesturePointerCount, u as SwipePattern } from "./sdk-android-adb.js";
-import { C as SessionSurface, D as BackMode, E as ClickButton, S as SnapshotDiagnosticsSummary, T as DeviceRotation, b as FindLocator, d as ClickCommandResponseData, f as FillCommandResponseData, g as SettleObservation, h as PressCommandResponseData, m as LongPressCommandResponseData, p as FindCommandResponseData, w as TvRemoteButton, x as ScreenshotResultData, y as AndroidSnapshotBackendMetadata } from "./sdk-selectors.js";
-import { t as AppsFilter } from "./app-inventory.js";
-import { r as CloudProviderSessionResult, t as AgentArtifactsResult } from "./cloud-artifacts.js";
-import { t as BatchRunResult } from "./sdk-batch-runner.js";
-import { a as RemoteConnectionProfileFields, c as MetroPrepareResult, i as CloudProviderProfileFields, l as MetroReloadOptions, s as MetroPrepareOptions, u as MetroReloadResult } from "./sdk-remote-config.js";
+import { A as AppError, F as normalizeAgentDeviceError, P as isAgentDeviceError, k as centerOfRect } from "./sdk-contracts.js";
+import { n as AgentDeviceClientConfig, r as AgentDeviceDaemonTransport, t as AgentDeviceClient } from "./client-types.js";
 import { p as createLocalArtifactAdapter } from "./sdk-io.js";
-//#region packages/contracts/src/alert-contract.d.ts
-declare const ALERT_ACTIONS: readonly ['get', 'accept', 'dismiss', 'wait'];
-type AlertAction = (typeof ALERT_ACTIONS)[number];
-//#endregion
-//#region packages/contracts/src/clipboard.d.ts
-/**
- * Closed result of the `clipboard` command. Mirrors the dispatch handler's
- * literal return EXACTLY (src/core/dispatch.ts `handleClipboardCommand`): a
- * discriminated union on `action`. `read` returns the clipboard `text`; `write`
- * reports the written `textLength` plus the `successText` message. The handler
- * spreads nothing else, so each branch is closed.
- */
-type ClipboardCommandResult = {
-  action: 'read';
-  text: string;
-} | {
-  action: 'write';
-  textLength: number;
-  message: string;
-};
-//#endregion
-//#region packages/contracts/src/keyboard.d.ts
-/**
- * Closed result of the `keyboard` command, grounded in the dispatch handlers'
- * literal returns (src/core/dispatch.ts `handleAndroidKeyboardCommand` /
- * `handleIosKeyboardCommand`).
- *
- * `platform` and `action` are always present; the remaining fields appear per
- * branch (Android `status`/`dismiss` carry the keyboard-state fields; `enter`
- * and iOS `dismiss` carry a `message`). It is kept as a flat closed shape rather
- * than a five-way `platform`×`action` union because the per-branch field sets
- * overlap heavily and the underlying Android keyboard-state types live in the
- * platform layer (below the public contract). The `Record` index signature of
- * the previous hand-written mirror is dropped, and the spurious `| null`s are
- * removed (the handler never returns `null` for these).
- */
-type KeyboardCommandResult = {
-  platform: 'android' | 'ios';
-  action: 'status' | 'dismiss' | 'enter';
-  visible?: boolean;
-  wasVisible?: boolean;
-  dismissed?: boolean;
-  attempts?: number;
-  inputType?: string;
-  type?: 'text' | 'number' | 'email' | 'phone' | 'password' | 'datetime' | 'unknown';
-  inputMethodPackage?: string;
-  focusedPackage?: string;
-  focusedResourceId?: string;
-  inputOwner?: 'app' | 'ime' | 'unknown';
-  message?: string;
-  /** iOS `dismiss` only (#1598): which mechanism actually resigned the
-   *  keyboard — 'dismissKey' (tapped the keyboard's own Hide/Dismiss/Done
-   *  key). Generic background-tap dismissal is deliberately unsupported
-   *  (#1606 review): no query can prove a coordinate is side-effect-free,
-   *  so the runner only ever taps the keyboard's own control. Absent when
-   *  the keyboard was not dismissed. */
-  mechanism?: 'dismissKey';
-};
-//#endregion
-//#region packages/contracts/src/navigation.d.ts
-/**
- * Closed results of the navigation/global action commands. Each mirrors the
- * dispatch handler's literal return EXACTLY (src/core/dispatch.ts
- * `DISPATCH_HANDLERS`): a fixed `action` discriminant plus the always-present
- * `successText` message (the handlers always pass a non-empty message, so it is
- * required here). The handlers spread nothing else, so the shapes are closed —
- * consistent with the `viewport` contract, the generic-dispatch Android
- * dialog-recovery `warning` annotation is intentionally not part of the contract.
- */
-/** `home` — `{ action: 'home', message: 'Home' }`. */
-type HomeCommandResult = {
-  action: 'home';
-  message: string;
-};
-/**
- * `back` — `{ action: 'back', mode, message: 'Back' }`; `mode` defaults to
- * `'in-app'`. The one field the generic route may add on top of the dispatch
- * handler's literal return: `settle`, the opt-in `--settle` observation
- * (#1638), attached after the command by the generic dispatcher.
- */
-type BackCommandResult = {
-  action: 'back';
-  mode: BackMode;
-  message: string;
-  settle?: SettleObservation;
-};
-/** `orientation` — `{ action: 'orientation', orientation, message: 'Rotated to <orientation>' }`. */
-type OrientationCommandResult = {
-  action: 'orientation';
-  orientation: DeviceRotation;
-  message: string;
-};
-/**
- * @deprecated The `rotate` command was renamed to `orientation`. This is the
- * legacy response contract (`action: 'rotate'`) that shipped in v0.18/v0.19,
- * retained for existing SDK consumers until the next major version. New code
- * should use {@link OrientationCommandResult}.
- */
-type RotateCommandResult = {
-  action: 'rotate';
-  orientation: DeviceRotation;
-  message: string;
-};
-/** `app-switcher` — `{ action: 'app-switcher', message: 'Opened app switcher' }`. */
-type AppSwitcherCommandResult = {
-  action: 'app-switcher';
-  message: string;
-};
-/** `tv-remote` — `{ action: 'tv-remote', button, durationMs?, message }`. */
-type TvRemoteCommandResult = {
-  action: 'tv-remote';
-  button: TvRemoteButton;
-  durationMs?: number;
-  message: string;
-};
-//#endregion
-//#region packages/contracts/src/wait.d.ts
-/**
- * Public daemon result for `wait`. The runtime-local result carries a `kind`
- * discriminant, but `toDaemonWaitData` intentionally projects the normal daemon
- * payload to this compact shape. The direct iOS selector fast path may still
- * include `kind: 'selector'` additively.
- */
-type WaitCommandResult = {
-  waitedMs: number;
-  kind?: 'selector';
-  text?: string;
-  selector?: string;
-  captures?: number;
-  nodeCount?: number;
-  hint?: string;
-  warning?: string;
-};
-//#endregion
-//#region packages/contracts/src/app-events.d.ts
-type TriggerAppEventCommandResult = {
-  event: string;
-  eventUrl: string;
-  transport: 'deep-link';
-  message: string;
-};
-//#endregion
-//#region packages/contracts/src/app-state.d.ts
-/**
- * Closed result of the `appstate` command, grounded in the daemon handler's
- * success returns (src/daemon/handlers/session-state.ts `handleAppStateCommand`).
- * A discriminated union on `platform`:
- *  - Apple (`ios` / `macos`) session state, with iOS-only device locators that
- *    the previous hand-written mirror omitted; and
- *  - Android and HarmonyOS foreground `package` / `activity`.
- *
- * The handler returns one of these fixed objects (errors take the `ok: false`
- * path), so each branch is closed.
- */
-type AppStateCommandResult = {
-  platform: 'ios' | 'macos';
-  appName: string;
-  appBundleId?: string;
-  source: 'session';
-  surface: SessionSurface;
-  /** iOS only — the session device's UDID. */
-  device_udid?: string;
-  /** iOS only — the simulator set path, or `null` when unknown. */
-  ios_simulator_device_set?: string | null;
-} | {
-  platform: 'android' | 'harmonyos';
-  package: string;
-  activity: string;
-};
-//#endregion
-//#region packages/contracts/src/target-shutdown-contract.d.ts
-type TargetShutdownResult = {
-  success: boolean;
-  exitCode: number;
-  stdout: string;
-  stderr: string;
-  error?: NormalizedError;
-};
-//#endregion
-//#region packages/contracts/src/device.d.ts
-/**
- * Closed result of the `boot` command. Mirrors the daemon handler's only
- * success return EXACTLY (src/daemon/handlers/session-state.ts) — the fixed
- * object literal `{ platform, target, device, id, kind, booted }` plus the
- * additive `appleOs` discriminant, emitted only for Apple devices.
- */
-type BootCommandResult = {
-  platform: PublicPlatform;
-  target: DeviceTarget;
-  /** Human-readable device name (`device.name`). */
-  device: string;
-  /** Stable device id (`device.id`). */
-  id: string;
-  kind: DeviceKind;
-  /** Always `true` on the success path. */
-  booted: true;
-  /**
-   * Additive Apple-OS discriminant (`device.appleOs`): iPhone/iPad/tvOS/visionOS/macOS.
-   * Present only for Apple devices; absent for non-Apple platforms. `platform` stays the
-   * leaf (`ios`/`macos`) — this is an extra field, not a replacement.
-   */
-  appleOs?: AppleOS;
-};
-/**
- * Closed result of the `shutdown` command. Mirrors the daemon handler's success
- * return EXACTLY (src/daemon/handlers/session-state.ts) — the fixed object
- * literal `{ platform, target, device, id, kind, shutdown }` plus the additive
- * `appleOs` discriminant (Apple devices only). The `shutdown` field is the raw
- * {@link TargetShutdownResult} from `shutdownDeviceTarget`.
- */
-type ShutdownCommandResult = {
-  platform: PublicPlatform;
-  target: DeviceTarget;
-  /** Human-readable device name (`device.name`). */
-  device: string;
-  /** Stable device id (`device.id`). */
-  id: string;
-  kind: DeviceKind;
-  shutdown: TargetShutdownResult;
-  /**
-   * Additive Apple-OS discriminant (`device.appleOs`): iPhone/iPad/tvOS/visionOS/macOS.
-   * Present only for Apple devices; absent for non-Apple platforms. `platform` stays the
-   * leaf (`ios`/`macos`) — this is an extra field, not a replacement.
-   */
-  appleOs?: AppleOS;
-};
-//#endregion
-//#region packages/contracts/src/perf.d.ts
-declare const PERF_AREA_VALUES: readonly ['metrics', 'frames', 'memory', 'cpu', 'trace'];
-declare const PERF_ACTION_VALUES: readonly ['sample', 'snapshot', 'start', 'stop', 'report'];
-declare const PERF_SUBJECT_VALUES: readonly ['profile'];
-declare const PERF_KIND_VALUES: readonly ['xctrace', 'simpleperf', 'perfetto', 'android-hprof', 'memgraph'];
-type PerfArea = (typeof PERF_AREA_VALUES)[number];
-type PerfAction = (typeof PERF_ACTION_VALUES)[number];
-type PerfSubject = (typeof PERF_SUBJECT_VALUES)[number];
-type PerfKind = (typeof PERF_KIND_VALUES)[number];
-//#endregion
-//#region packages/contracts/src/json.d.ts
-type JsonPrimitive = string | number | boolean | null;
-type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
-type JsonObject = {
-  [key: string]: JsonValue;
-};
-//#endregion
-//#region packages/contracts/src/logs.d.ts
-declare const LOG_ACTION_VALUES: readonly ['path', 'start', 'stop', 'doctor', 'mark', 'clear'];
-type LogAction = (typeof LOG_ACTION_VALUES)[number];
-//#endregion
-//#region packages/contracts/src/recording-scope.d.ts
-declare const RECORDING_SCOPE_VALUES: readonly ['app', 'device', 'system'];
-type RecordingScope = (typeof RECORDING_SCOPE_VALUES)[number];
-//#endregion
-//#region packages/contracts/src/recording.d.ts
-type RecordingAppIdentity = {
-  bundleId: string;
-  name?: string;
-};
-type RecordingStartCommandResult = {
-  recording: 'started';
-  outPath: string;
-  sessionStateDir: string;
-  recordingBackend?: string;
-  recordingScope?: RecordingScope;
-  recordOnlySession?: boolean;
-  activeSessionApp?: RecordingAppIdentity;
-  showTouches: boolean;
-};
-type RecordingStopCommandResult = {
-  recording: 'stopped';
-  outPath: string;
-  telemetryPath?: string;
-  artifacts: DaemonArtifact[];
-  recordingBackend?: string;
-  recordingScope?: RecordingScope;
-  recordOnlySession?: boolean;
-  activeSessionApp?: RecordingAppIdentity;
-  durationMs: number;
-  showTouches: boolean;
-  warning?: string;
-  overlayWarning?: string;
-  chunks?: Array<{
-    index: number;
-    path: string;
-  }>;
-};
-type RecordingCommandResult = RecordingStartCommandResult | RecordingStopCommandResult;
-type TraceCommandResult = {
-  trace: 'started';
-  outPath: string;
-} | {
-  trace: 'stopped';
-  outPath: string;
-  artifacts: DaemonArtifact[];
-};
-//#endregion
-//#region packages/contracts/src/recording-export-quality.d.ts
-declare const RECORDING_EXPORT_QUALITIES: readonly ['medium', 'high'];
-type RecordingExportQuality = (typeof RECORDING_EXPORT_QUALITIES)[number];
-//#endregion
-//#region packages/contracts/src/prepare.d.ts
-type PrepareIosRunnerCacheKind = 'exact' | 'restore-key' | 'miss' | 'external';
-type PrepareIosRunnerArtifactState = 'valid' | 'rebuilt';
-type PrepareIosRunnerTiming = {
-  totalMs: number;
-  additiveParts: {
-    buildMs?: number;
-    connectAfterBuildMs: number;
-    healthCheckMs: number;
-  };
-  containment: {
-    connectMs?: ['buildMs'];
-    healthCheckMs: [];
-  };
-  note: string;
-};
-/**
- * Public daemon result for `prepare ios-runner`. The runner-local prepare result
- * is projected by `prepareIosRunnerResponseData` with device identity and timing
- * guidance before it reaches the client.
- */
-type PrepareCommandResult = {
-  action: 'ios-runner';
-  platform: PublicPlatform;
-  deviceId: string;
-  deviceName: string;
-  kind: DeviceKind;
-  durationMs: number;
-  runner: JsonObject;
-  cache?: PrepareIosRunnerCacheKind;
-  artifact?: PrepareIosRunnerArtifactState;
-  buildMs?: number;
-  connectMs: number;
-  healthCheckMs: number;
-  xctestrunPath?: string;
-  recoveryReason?: string;
-  failureReason?: string;
-  timing: PrepareIosRunnerTiming;
-  message: string;
-};
-//#endregion
-//#region packages/contracts/src/push.d.ts
-type PushCommandResult = {
-  platform: 'ios';
-  bundleId: string;
-  message: string;
-} | {
-  platform: 'android';
-  package: string;
-  action: string;
-  extrasCount: number;
-  message: string;
-};
-//#endregion
-//#region packages/contracts/src/client-connection.d.ts
-type AgentDeviceDaemonTransportContext = {
-  authToken?: string;
-};
-type AgentDeviceDaemonTransport = (req: Omit<DaemonRequest, 'token'>, context?: AgentDeviceDaemonTransportContext) => Promise<DaemonResponse>;
-type AgentDeviceClientConfig = RemoteConnectionProfileFields & CloudProviderProfileFields & {
-  session?: string;
-  lockPolicy?: DaemonLockPolicy;
-  lockPlatform?: PlatformSelector;
-  requestId?: string;
-  sessionIsolation?: SessionIsolationMode;
-  leaseBackend?: LeaseBackend;
-  leaseTtlMs?: number;
-  runtime?: SessionRuntimeHints;
-  cwd?: string;
-  debug?: boolean;
-  cost?: boolean;
-  responseLevel?: ResponseLevel;
-  iosXctestrunFile?: string;
-  iosXctestDerivedDataPath?: string;
-  iosXctestEnvDir?: string;
-};
-type AgentDeviceRequestOverrides = Pick<AgentDeviceClientConfig, 'session' | 'lockPolicy' | 'lockPlatform' | 'requestId' | 'daemonBaseUrl' | 'daemonAuthToken' | 'daemonTransport' | 'daemonServerMode' | 'tenant' | 'sessionIsolation' | 'runId' | 'leaseId' | 'leaseBackend' | 'leaseProvider' | 'deviceKey' | 'clientId' | 'providerApp' | 'providerOsVersion' | 'providerProject' | 'providerBuild' | 'providerSessionName' | 'providerDeviceOrientation' | 'providerGeoLocation' | 'providerTimezone' | 'providerLanguage' | 'providerLocale' | 'providerNetworkProfile' | 'providerCustomNetwork' | 'providerNoResignApp' | 'awsProjectArn' | 'awsDeviceArn' | 'awsAppArn' | 'awsRegion' | 'awsInteractionMode' | 'leaseTtlMs' | 'cwd' | 'debug' | 'cost' | 'responseLevel' | 'iosXctestrunFile' | 'iosXctestDerivedDataPath' | 'iosXctestEnvDir'>;
-type AgentDeviceIdentifiers = {
-  session?: string;
-  deviceId?: string;
-  deviceName?: string;
-  udid?: string;
-  serial?: string;
-  appId?: string;
-  appBundleId?: string;
-  package?: string;
-};
-type AgentDeviceSelectionOptions = {
-  platform?: PlatformSelector;
-  target?: DeviceTarget;
-  device?: string;
-  udid?: string;
-  serial?: string;
-  iosSimulatorDeviceSet?: string;
-  androidDeviceAllowlist?: string;
-};
-type DeviceCommandBaseOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions;
-//#endregion
-//#region packages/contracts/src/client-device-view.d.ts
-type AgentDeviceDevice = {
-  platform: PublicPlatform;
-  target: DeviceTarget;
-  kind: DeviceKind;
-  id: string;
-  name: string;
-  booted?: boolean;
-  /**
-   * Additive Apple-OS discriminant (iPhone/iPad/tvOS/visionOS/macOS). Present only for
-   * Apple devices; `platform` still carries the leaf (`ios`/`macos`).
-   */
-  appleOs?: AppleOS;
-  identifiers: AgentDeviceIdentifiers;
-  ios?: {
-    udid: string;
-  };
-  android?: {
-    serial: string;
-  };
-  harmonyos?: {
-    serial: string;
-  };
-  vega?: {
-    serial: string;
-  };
-};
-type AgentDeviceCapabilitiesResult = {
-  device: AgentDeviceDevice;
-  availableCommands: string[];
-};
-type AgentDeviceSessionDevice = {
-  platform: PublicPlatform;
-  target: DeviceTarget;
-  id: string;
-  name: string;
-  /**
-   * Additive Apple-OS discriminant (iPhone/iPad/tvOS/visionOS/macOS). Present only for
-   * Apple devices; `platform` still carries the leaf (`ios`/`macos`).
-   */
-  appleOs?: AppleOS;
-  identifiers: AgentDeviceIdentifiers;
-  ios?: {
-    udid: string;
-    simulatorSetPath?: string | null;
-  };
-  android?: {
-    serial: string;
-  };
-  harmonyos?: {
-    serial: string;
-  };
-  vega?: {
-    serial: string;
-  };
-};
-type AgentDeviceSession = {
-  name: string;
-  createdAt: number;
-  sessionStateDir?: string;
-  runnerLogPath?: string;
-  device: AgentDeviceSessionDevice;
-  identifiers: AgentDeviceIdentifiers;
-};
-type StartupPerfSample = {
-  durationMs: number;
-  measuredAt: string;
-  method: string;
-  appTarget?: string;
-  appBundleId?: string;
-};
-type DeviceBootOptions = DeviceCommandBaseOptions & {
-  headless?: boolean;
-};
-type DeviceShutdownOptions = DeviceCommandBaseOptions;
-//#endregion
-//#region packages/contracts/src/client-app.d.ts
-type AppInstallOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
-  app?: string;
-  appPath: string;
-};
-type AppDeployOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
-  app: string;
-  appPath: string;
-};
-type AppDeployResult = {
-  app: string;
-  appPath: string;
-  platform: PublicPlatform;
-  appId?: string;
-  bundleId?: string;
-  package?: string;
-  identifiers: AgentDeviceIdentifiers;
-};
-type AppOpenOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
-  app?: string;
-  url?: string;
-  surface?: SessionSurface;
-  activity?: string;
-  launchConsole?: string;
-  launchArgs?: string[];
-  relaunch?: boolean;
-  /**
-   * Include the initial interactive snapshot in a fresh open response. With
-   * no app argument, iOS can discover the sole running app on the sole booted
-   * simulator and fails closed when that environment is ambiguous.
-   */
-  foreground?: boolean;
-  saveScript?: boolean | string;
-  /** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
-  force?: boolean;
-  deviceHub?: boolean;
-  testIme?: boolean;
-  noRecord?: boolean;
-  runtime?: SessionRuntimeHints;
-};
-type AppOpenResult = {
-  session: string;
-  warnings?: string[];
-  sessionStateDir?: string;
-  runnerLogPath?: string;
-  requestLogPath?: string;
-  eventLogPath?: string;
-  appName?: string;
-  appBundleId?: string;
-  appId?: string;
-  startup?: StartupPerfSample;
-  runtime?: SessionRuntimeHints;
-  device?: AgentDeviceSessionDevice;
-  /**
-   * Initial interactive snapshot captured immediately after an open that
-   * requested `foreground`, composed from the same snapshot-runtime dispatch
-   * `agent-device snapshot -i` uses. It stays loosely typed rather than reusing
-   * `CaptureSnapshotResult` because the daemon-side composition does not attach
-   * client-only fields like `identifiers`.
-   */
-  snapshot?: Record<string, unknown>;
-  /**
-   * open --foreground: present when the session opened successfully but the
-   * composed initial snapshot capture failed. Carries the FULL daemon error
-   * shape (code, message, hint, details, diagnosticId, logPath) so recovery
-   * guidance survives to the caller; the session itself is open and usable —
-   * a `warnings` entry says so and points at `snapshot -i`.
-   */
-  initialSnapshotError?: DaemonError;
-  identifiers: AgentDeviceIdentifiers;
-};
-type AppCloseOptions = AgentDeviceRequestOverrides & {
-  app?: string;
-  shutdown?: boolean;
-  saveScript?: boolean | string;
-  /** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
-  force?: boolean;
-};
-type AppCloseResult = {
-  session: string;
-  closedApp?: string;
-  shutdown?: TargetShutdownResult;
-  /**
-   * #1258: absolute path of the committed session/healed script when this close
-   * published one (`close --save-script`, or a repair-armed session's finalize)
-   * — so a client that requested publication learns where the file landed.
-   */
-  savedScript?: string;
-  identifiers: AgentDeviceIdentifiers;
-};
-type AppInstallFromSourceOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
-  source: DaemonInstallSource;
-  retainPaths?: boolean;
-  retentionMs?: number;
-};
-type AppInstallFromSourceResult = {
-  appName?: string;
-  appId?: string;
-  bundleId?: string;
-  packageName?: string;
-  launchTarget: string;
-  installablePath?: string;
-  archivePath?: string;
-  materializationId?: string;
-  materializationExpiresAt?: string;
-  identifiers: AgentDeviceIdentifiers;
-};
-type AppListOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
-  appsFilter?: AppsFilter;
-};
-type AppPushOptions = DeviceCommandBaseOptions & {
-  app: string;
-  payload: string | JsonObject;
-};
-type AppTriggerEventOptions = DeviceCommandBaseOptions & {
-  event: string;
-  payload?: JsonObject;
-};
-type MaterializationReleaseOptions = AgentDeviceRequestOverrides & {
-  materializationId: string;
-};
-type MaterializationReleaseResult = {
-  released: boolean;
-  materializationId: string;
-  identifiers: AgentDeviceIdentifiers;
-};
-//#endregion
-//#region packages/contracts/src/snapshot-capture-annotations.d.ts
-type SnapshotCaptureAnalysis = {
-  rawNodeCount: number;
-  maxDepth: number;
-};
-type SnapshotCaptureFreshness = {
-  action: string;
-  retryCount: number;
-  staleAfterRetries: boolean;
-  reason?: 'empty-interactive' | 'sharp-drop' | 'stuck-route';
-};
-type SnapshotCaptureAnnotations = {
-  analysis?: SnapshotCaptureAnalysis;
-  androidSnapshot?: AndroidSnapshotBackendMetadata;
-  freshness?: SnapshotCaptureFreshness;
-  quality?: SnapshotQualityVerdict;
-  warnings?: string[];
-};
-type PublicSnapshotCaptureAnnotations = Pick<SnapshotCaptureAnnotations, 'androidSnapshot' | 'warnings'> & {
-  snapshotQuality?: SnapshotQualityVerdict;
-};
-//#endregion
-//#region packages/contracts/src/client-capture.d.ts
-type CaptureSnapshotOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
-  interactiveOnly?: boolean;
-  depth?: number;
-  scope?: string;
-  raw?: boolean;
-  /** List accessibility custom actions on merged elements (iOS simulator). */
-  customActions?: boolean;
-  forceFull?: boolean;
-  timeoutMs?: number;
-  /**
-   * #1271 stage 2 (ADR 0012 amendment): `snapshot` is observation-only and
-   * excluded from a repair-armed heal by default; `record` forces it
-   * through. Mutually exclusive with `noRecord`.
-   */
-  noRecord?: boolean;
-  record?: boolean;
-};
-type CaptureSnapshotResult = {
-  nodes: SnapshotNode[];
-  truncated: boolean;
-  appName?: string;
-  appBundleId?: string;
-  visibility?: SnapshotVisibility;
-  unchanged?: SnapshotUnchanged;
-  snapshotDiagnostics?: SnapshotDiagnosticsSummary;
-  identifiers: AgentDeviceIdentifiers;
-  /**
-   * ADR 0014: the response-level ref-frame epoch the plain node refs were minted
-   * from. A ref-issuing snapshot carries it ONCE (nodes stay plain `@e12` for the
-   * token budget); pair a ref with it (`@e12~s<refsGeneration>`) before a mutation.
-   */
-  refsGeneration?: number;
-  /**
-   * Digest response view only: a capped list of `{ ref, label? }` pairs taken
-   * from the full `nodes` tree so the MCP layer can still pin refs when the
-   * default-level `nodes` payload is intentionally omitted.
-   */
-  refs?: Array<{
-    ref: string;
-    label?: string;
-  }>;
-} & PublicSnapshotCaptureAnnotations;
-type CaptureScreenshotOptions = AgentDeviceRequestOverrides & {
-  path?: string;
-  overlayRefs?: boolean;
-  pixelDensity?: number;
-  fullscreen?: boolean;
-  scale?: number;
-  stabilize?: boolean;
-  normalizeStatusBar?: boolean;
-  surface?: SessionSurface;
-};
-type CaptureScreenshotResult = ScreenshotResultData & {
-  path: string;
-  identifiers: AgentDeviceIdentifiers;
-};
-type CaptureDiffOptions = DeviceCommandBaseOptions & Pick<CaptureSnapshotOptions, 'interactiveOnly' | 'depth' | 'scope' | 'raw'> & {
-  kind: 'snapshot';
-  out?: string;
-};
-type SelectorSnapshotCommandOptions = Pick<CaptureSnapshotOptions, 'depth' | 'scope' | 'raw'>;
-type FindSnapshotCommandOptions = Pick<CaptureSnapshotOptions, 'depth' | 'raw'>;
-//#endregion
-//#region packages/contracts/src/client-target.d.ts
-type PointTarget = {
-  x: number;
-  y: number;
-  ref?: never;
-  selector?: never;
-  label?: never;
-};
-type RefTarget = {
-  ref: string;
-  label?: string;
-  x?: never;
-  y?: never;
-  selector?: never;
-};
-type SelectorTarget = {
-  selector: string;
-  x?: never;
-  y?: never;
-  ref?: never;
-  label?: never;
-};
-type InteractionTarget = PointTarget | RefTarget | SelectorTarget;
-type ElementTarget = RefTarget | SelectorTarget;
-//#endregion
-//#region packages/contracts/src/client-gesture.d.ts
-type RepeatedPressOptions = {
-  count?: number;
-  intervalMs?: number;
-  holdMs?: number;
-  jitterPx?: number;
-  doubleTap?: boolean;
-};
-/**
- * Opt-in (#1101): after the action, wait for the UI to go quiet and return the
- * settled diff vs the pre-action tree (`settle` on the result) in the same
- * response. Best-effort — never fails the action. `settleQuietMs` tunes the
- * quiet window (default 500ms); `timeoutMs` bounds the settle wait (default
- * 10s) when `settle` is true. A bare `timeoutMs` without `settle` is ignored
- * for compatibility; `settleQuietMs` still requires `settle`.
- */
-type SettleCommandOptions = {
-  settle?: boolean;
-  settleQuietMs?: number;
-  timeoutMs?: number;
-};
-type ClickOptions = DeviceCommandBaseOptions & SelectorSnapshotCommandOptions & InteractionTarget & RepeatedPressOptions & SettleCommandOptions & {
-  button?: ClickButton;
-  /**
-   * Opt-in (#1047): return cheap post-action evidence (AX digest, node counts,
-   * changedFromBefore) in the response instead of requiring a follow-up
-   * snapshot to confirm the action had an effect.
-   */
-  verify?: boolean;
-};
-type PressOptions = DeviceCommandBaseOptions & SelectorSnapshotCommandOptions & InteractionTarget & RepeatedPressOptions & SettleCommandOptions & {
-  verify?: boolean;
-};
-type LongPressOptions = DeviceCommandBaseOptions & SelectorSnapshotCommandOptions & InteractionTarget & SettleCommandOptions & {
-  durationMs?: number;
-};
-type SwipeOptions = DeviceCommandBaseOptions & {
-  from: {
-    x: number;
-    y: number;
-  };
-  to: {
-    x: number;
-    y: number;
-  };
-  count?: number;
-  pauseMs?: number;
-  pattern?: SwipePattern;
-};
-type PanOptions = DeviceCommandBaseOptions & {
-  x: number;
-  y: number;
-  dx: number;
-  dy: number;
-  pointerCount?: GesturePointerCount;
-  durationMs?: number;
-};
-type DragOptions = DeviceCommandBaseOptions & {
-  source: string;
-  destination: string;
-  sourceHoldMs?: number;
-  moveMs?: number;
-  destinationHoldMs?: number;
-};
-type FlingOptions = DeviceCommandBaseOptions & {
-  direction: ScrollDirection;
-  x: number;
-  y: number;
-  distance?: number;
-};
-type SwipeGestureOptions = DeviceCommandBaseOptions & {
-  preset: SwipePreset;
-};
-type FocusOptions = DeviceCommandBaseOptions & {
-  x: number;
-  y: number;
-};
-type TypeTextOptions = DeviceCommandBaseOptions & {
-  text: string;
-  delayMs?: number;
-};
-type FillOptions = DeviceCommandBaseOptions & SelectorSnapshotCommandOptions & InteractionTarget & SettleCommandOptions & {
-  text: string;
-  delayMs?: number;
-  /** Publish this fill value as `${VAR}` when script recording is armed. */
-  recordAs?: string;
-  verify?: boolean;
-};
-type PinchOptions = DeviceCommandBaseOptions & {
-  scale: number;
-  x?: number;
-  y?: number;
-};
-type RotateGestureOptions = DeviceCommandBaseOptions & {
-  degrees: number;
-  x?: number;
-  y?: number;
-};
-type TransformGestureOptions = DeviceCommandBaseOptions & TransformGestureParams;
-type ScrollOptions = DeviceCommandBaseOptions & SettleCommandOptions & {
-  direction: ScrollInputDirection;
-  amount?: number;
-  pixels?: number;
-  durationMs?: number;
-};
-//#endregion
-//#region packages/contracts/src/client-lease.d.ts
-type Lease = {
-  leaseId: string;
-  tenantId: string;
-  runId: string;
-  backend: LeaseBackend;
-  leaseProvider?: string;
-  deviceKey?: string;
-  clientId?: string;
-  createdAt?: number;
-  heartbeatAt?: number;
-  expiresAt?: number;
-};
-type LeaseOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
-  ttlMs?: number;
-};
-type LeaseAllocateOptions = LeaseOptions & {
-  tenant: string;
-  runId: string;
-  leaseBackend?: LeaseBackend;
-  leaseProvider?: string;
-  provider?: string;
-  deviceKey?: string;
-  clientId?: string;
-};
-type LeaseScopedOptions = LeaseOptions & {
-  tenant?: string;
-  runId?: string;
-  leaseId: string;
-  leaseBackend?: LeaseBackend;
-  leaseProvider?: string;
-  provider?: string;
-  deviceKey?: string;
-  clientId?: string;
-};
-type CloudArtifactsOptions = AgentDeviceRequestOverrides & {
-  provider?: string;
-  providerSessionId?: string;
-};
-//#endregion
-//#region packages/contracts/src/client-observability.d.ts
-type PerfOptions = DeviceCommandBaseOptions & {
-  area?: PerfArea;
-  subject?: PerfSubject;
-  action?: PerfAction;
-  kind?: PerfKind;
-  template?: string;
-  out?: string;
-  tracePath?: string;
-};
-type LogsOptions = AgentDeviceRequestOverrides & {
-  action?: LogAction;
-  message?: string;
-  restart?: boolean;
-};
-type EventsOptions = AgentDeviceRequestOverrides & {
-  cursor?: string;
-  limit?: number;
-};
-type NetworkOptions = DeviceCommandBaseOptions & {
-  action?: 'dump' | 'log';
-  limit?: number;
-  include?: NetworkIncludeMode;
-};
-type AudioOptions = DeviceCommandBaseOptions & {
-  action?: 'probe';
-  probeAction?: 'start' | 'status' | 'stop';
-  durationMs?: number;
-  bucketMs?: number;
-};
-type RecordOptions = AgentDeviceRequestOverrides & {
-  action: 'start' | 'stop';
-  path?: string;
-  fps?: number;
-  quality?: RecordingExportQuality;
-  hideTouches?: boolean;
-  recordingScope?: RecordingScope;
-};
-type TraceOptions = AgentDeviceRequestOverrides & {
-  action: 'start' | 'stop';
-  path?: string;
-};
-//#endregion
-//#region packages/contracts/src/client-replay.d.ts
-type ReplayRunOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
-  path: string;
-  runtime?: SessionRuntimeHints;
-  /**
-   * @deprecated ADR 0012 migration step 6: `--update` no longer rewrites
-   * the script. Accepted for backward compatibility; every divergence
-   * already carries ranked selector suggestions regardless of this flag.
-   */
-  update?: boolean;
-  /** @deprecated Use backend: 'maestro'. */
-  maestro?: boolean;
-  backend?: string;
-  env?: string[];
-  timeoutMs?: number;
-  /**
-   * ADR 0012 decision 4 / migration step 5: resume at this 1-based plan
-   * step, skipping `1..resumeFrom-1` without executing them. Requires
-   * `resumePlanDigest` from the divergence report that reported this
-   * step as the failure. `replay` only — `test` has no resume fields.
-   */
-  resumeFrom?: number;
-  /** The `resume.planDigest` from the divergence report `resumeFrom` came from. */
-  resumePlanDigest?: string;
-  /** Leave the session active by suppressing an authored terminal `close` in native `.ad`. */
-  keepSession?: boolean;
-  /**
-   * ADR 0012 decision 6, R1/R6: arms agent-supervised re-record repair
-   * from this replay attempt onward. Optional string value is the healed
-   * `.ad`'s output path; absent one, it defaults to the `<path>` sibling
-   * `<stem>.healed.ad` when the repair ends with `close --save-script`.
-   */
-  saveScript?: boolean | string;
-  /** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
-  force?: boolean;
-};
-type ReplayTestOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
-  paths: string[];
-  runtime?: SessionRuntimeHints;
-  update?: boolean;
-  /** @deprecated Use backend: 'maestro'. */
-  maestro?: boolean;
-  backend?: string;
-  env?: string[];
-  failFast?: boolean;
-  timeoutMs?: number;
-  retries?: number;
-  recordVideo?: boolean;
-  artifactsDir?: string;
-  /** @deprecated Use the CLI --reporter junit:<path> or --report-junit <path>. */
-  reportJunit?: string;
-  shardAll?: number;
-  shardSplit?: number;
-};
-type BatchStep = {
-  command: string;
-  input: Record<string, unknown>;
-  runtime?: SessionRuntimeHints;
-};
-type BatchRunOptions = AgentDeviceRequestOverrides & {
-  steps: BatchStep[];
-  onError?: 'stop';
-  maxSteps?: number;
-  out?: string;
-};
-//#endregion
-//#region packages/contracts/src/client-request.d.ts
-type CommandRequestResult = DaemonResponseData;
-//#endregion
-//#region packages/contracts/src/client-selector-read.d.ts
-/**
- * #1271 stage 2 (ADR 0012 amendment): `get`/`is`/`find` are observation-only
- * and excluded from a repair-armed heal by default. `record` forces this
- * action through (the corrective-read case); `noRecord` continues to opt the
- * action out entirely. Mutually exclusive.
- */
-type RecordControlOptions = {
-  noRecord?: boolean;
-  record?: boolean;
-};
-type GetOptions = DeviceCommandBaseOptions & SelectorSnapshotCommandOptions & ElementTarget & RecordControlOptions & {
-  format: 'text' | 'attrs';
-};
-type IsTextPredicateOptions = DeviceCommandBaseOptions & SelectorSnapshotCommandOptions & RecordControlOptions & {
-  predicate: 'text';
-  selector: string;
-  value: string;
-};
-type IsStatePredicateOptions = DeviceCommandBaseOptions & SelectorSnapshotCommandOptions & RecordControlOptions & {
-  predicate: 'visible' | 'hidden' | 'exists' | 'editable' | 'selected' | 'focused';
-  selector: string;
-  value?: never;
-};
-type IsOptions = IsTextPredicateOptions | IsStatePredicateOptions;
-type FindBaseOptions = DeviceCommandBaseOptions & FindSnapshotCommandOptions & RecordControlOptions & {
-  locator?: FindLocator;
-  query: string;
-  first?: boolean;
-  last?: boolean;
-};
-type FindOptions = (FindBaseOptions & {
-  action?: 'click' | 'focus' | 'exists' | 'getText' | 'getAttrs' | 'list';
-}) | (FindBaseOptions & {
-  action: 'wait';
-  timeoutMs?: number;
-}) | (FindBaseOptions & {
-  action: 'fill' | 'type';
-  value: string;
-});
-//#endregion
-//#region packages/contracts/src/client-session.d.ts
-type SessionCloseResult = {
-  session: string;
-  shutdown?: TargetShutdownResult;
-  provider?: CloudProviderSessionResult;
-  /**
-   * #1258: absolute path of the committed session/healed script when this close
-   * published one (`close --save-script`, or a repair-armed session's finalize)
-   * — so a client that requested publication learns where the file landed.
-   */
-  savedScript?: string;
-  identifiers: AgentDeviceIdentifiers;
-};
-type SessionSaveScriptOptions = AgentDeviceRequestOverrides & {
-  path?: string;
-  /** Atomically replace an existing target instead of refusing publication. */
-  force?: boolean;
-};
-type SessionSaveScriptResult = {
-  session: string;
-  savedScript: string;
-  actionCount: number;
-  identifiers: AgentDeviceIdentifiers;
-};
-//#endregion
-//#region packages/contracts/src/client-settings.d.ts
-type PermissionTarget = 'camera' | 'microphone' | 'photos' | 'contacts' | 'contacts-limited' | 'notifications' | 'calendar' | 'location' | 'location-always' | 'media-library' | 'motion' | 'reminders' | 'siri' | 'accessibility' | 'screen-recording' | 'input-monitoring';
-type SettingsUpdateOptions = (DeviceCommandBaseOptions & {
-  setting: 'clear-app-state';
-  state: 'clear';
-  app?: string;
-}) | (DeviceCommandBaseOptions & {
-  setting: 'wifi' | 'airplane' | 'location';
-  state: 'on' | 'off';
-}) | (DeviceCommandBaseOptions & {
-  setting: 'location';
-  state: 'set';
-  latitude: number;
-  longitude: number;
-}) | (DeviceCommandBaseOptions & {
-  setting: 'animations';
-  state: 'on' | 'off';
-}) | (DeviceCommandBaseOptions & {
-  setting: 'appearance';
-  state: 'light' | 'dark' | 'toggle';
-}) | (DeviceCommandBaseOptions & {
-  setting: 'faceid' | 'touchid';
-  state: 'match' | 'nonmatch' | 'enroll' | 'unenroll';
-}) | (DeviceCommandBaseOptions & {
-  setting: 'fingerprint';
-  state: 'match' | 'nonmatch';
-}) | (DeviceCommandBaseOptions & {
-  setting: 'permission';
-  state: 'grant' | 'deny' | 'reset';
-  permission: PermissionTarget;
-  mode?: 'full' | 'limited';
-});
-//#endregion
-//#region packages/contracts/src/client-system.d.ts
-type WaitCommandTarget = {
-  durationMs: number;
-  text?: never;
-  ref?: never;
-  selector?: never;
-  stable?: never;
-  quietMs?: never;
-  timeoutMs?: never;
-} | (SelectorSnapshotCommandOptions & {
-  text: string;
-  durationMs?: never;
-  ref?: never;
-  selector?: never;
-  stable?: never;
-  quietMs?: never;
-  timeoutMs?: number;
-}) | (SelectorSnapshotCommandOptions & {
-  ref: string;
-  durationMs?: never;
-  text?: never;
-  selector?: never;
-  stable?: never;
-  quietMs?: never;
-  timeoutMs?: number;
-}) | (SelectorSnapshotCommandOptions & {
-  selector: string;
-  durationMs?: never;
-  text?: never;
-  ref?: never;
-  stable?: never;
-  quietMs?: never;
-  timeoutMs?: number;
-}) | (SelectorSnapshotCommandOptions & {
-  stable: true;
-  durationMs?: never;
-  text?: never;
-  ref?: never;
-  selector?: never;
-  quietMs?: number;
-  timeoutMs?: number;
-});
-type WaitCommandOptions = DeviceCommandBaseOptions & WaitCommandTarget;
-type AlertCommandOptions = DeviceCommandBaseOptions & {
-  action?: AlertAction;
-  timeoutMs?: number;
-};
-type AppStateCommandOptions = DeviceCommandBaseOptions;
-type KeyboardCommandOptions = DeviceCommandBaseOptions & {
-  action?: 'status' | 'dismiss' | 'enter' | 'return';
-};
-type ClipboardCommandOptions = (DeviceCommandBaseOptions & {
-  action: 'read';
-}) | (DeviceCommandBaseOptions & {
-  action: 'write';
-  text: string;
-});
-type ReactNativeCommandOptions = DeviceCommandBaseOptions & {
-  action: 'dismiss-overlay';
-};
-type PrepareCommandOptions = DeviceCommandBaseOptions & {
-  action: 'ios-runner';
-  timeoutMs?: number;
-};
-type DoctorCommandOptions = DeviceCommandBaseOptions & {
-  targetApp?: string;
-  remote?: boolean;
-};
-type ViewportCommandOptions = DeviceCommandBaseOptions & {
-  width: number;
-  height: number;
-};
-//#endregion
-//#region src/commands/command-contract.d.ts
-type JsonSchema = {
-  type?: string | readonly string[];
-  description?: string;
-  properties?: Record<string, JsonSchema>;
-  required?: readonly string[];
-  additionalProperties?: boolean | JsonSchema;
-  items?: JsonSchema;
-  prefixItems?: readonly JsonSchema[];
-  oneOf?: readonly JsonSchema[];
-  not?: JsonSchema;
-  enum?: readonly unknown[];
-  const?: unknown;
-  minimum?: number;
-  maximum?: number;
-};
-type ExecutableCommandProjection<ClientMethod extends string = string> = {
-  clientMethod: ClientMethod;
-  outputSchema: JsonSchema;
-};
-//#endregion
-//#region src/commands/system/navigation-projection.d.ts
-declare const navigationCommandProjectionType: unique symbol;
-type NavigationCommandProjection<Options, Result, Required extends boolean, ClientMethod extends string> = ExecutableCommandProjection<ClientMethod> & {
-  readonly [navigationCommandProjectionType]?: {
-    options: Options;
-    result: Result;
-    required: Required;
-  };
-};
-declare const NAVIGATION_COMMAND_PROJECTIONS: {
-  readonly back: NavigationCommandProjection<{
-    mode?: BackMode;
-  } & SettleCommandOptions, BackCommandResult, false, "back">;
-  readonly home: NavigationCommandProjection<{}, HomeCommandResult, false, "home">;
-  readonly orientation: NavigationCommandProjection<{
-    orientation: DeviceRotation;
-  }, OrientationCommandResult, true, "orientation">;
-  readonly 'app-switcher': NavigationCommandProjection<{}, AppSwitcherCommandResult, false, "appSwitcher">;
-  readonly 'tv-remote': NavigationCommandProjection<{
-    button: TvRemoteButton;
-    durationMs?: number;
-  }, TvRemoteCommandResult, true, "tvRemote">;
-};
-type NavigationCommandName = keyof typeof NAVIGATION_COMMAND_PROJECTIONS;
-type NavigationCommandOptions<Name extends NavigationCommandName> = (typeof NAVIGATION_COMMAND_PROJECTIONS)[Name] extends NavigationCommandProjection<infer Options, unknown, boolean, string> ? Options : never;
-type ProjectedNavigationCommandMethod<BaseOptions, Projection> = Projection extends NavigationCommandProjection<infer Options, infer Result, infer Required, string> ? Required extends true ? (options: BaseOptions & Options) => Promise<Result> : (options?: BaseOptions & Options) => Promise<Result> : never;
-type ProjectedNavigationCommandClient<BaseOptions> = { [Name in NavigationCommandName as (typeof NAVIGATION_COMMAND_PROJECTIONS)[Name]['clientMethod']]: ProjectedNavigationCommandMethod<BaseOptions, (typeof NAVIGATION_COMMAND_PROJECTIONS)[Name]>; };
-//#endregion
-//#region packages/contracts/src/debug-symbols.d.ts
-type DebugSymbolsOptions = {
-  action?: 'symbols';
-  artifact: string;
-  dsym?: string;
-  searchPath?: string;
-  out?: string;
-  cwd?: string;
-};
-type DebugSymbolsImage = {
-  name: string;
-  uuid: string;
-  arch?: string;
-  dsymPath: string;
-  binaryPath: string;
-};
-type DebugSymbolsCrashFrame = {
-  index: number;
-  image: string;
-  address: string;
-  symbol?: string;
-};
-type DebugSymbolsCrashSummary = {
-  format: 'ips' | 'text';
-  appName?: string;
-  bundleId?: string;
-  version?: string;
-  incident?: string;
-  timestamp?: string;
-  exceptionType?: string;
-  exceptionCodes?: string;
-  terminationReason?: string;
-  crashedThread?: number;
-  topFrames: DebugSymbolsCrashFrame[];
-  findings: string[];
-};
-type DebugSymbolsResult = {
-  kind: 'debugSymbols';
-  platform: 'apple';
-  artifactPath: string;
-  outPath: string;
-  crash: DebugSymbolsCrashSummary;
-  matchedImages: DebugSymbolsImage[];
-  symbolicatedFrames: number;
-  skippedImages: number;
-  warnings?: string[];
-  message: string;
-};
-//#endregion
-//#region packages/contracts/src/doctor.d.ts
-type DoctorStatus = 'pass' | 'warn' | 'fail' | 'info';
-type DoctorKind = 'auto' | 'react-native' | 'expo' | 'repack';
-type DoctorCheck = {
-  id: string;
-  status: DoctorStatus;
-  summary: string;
-  hint?: string;
-  command?: string;
-  evidence?: Record<string, unknown>;
-};
-type DoctorCommandResult = {
-  status: DoctorStatus;
-  summary: string;
-  kind: DoctorKind;
-  platform?: PlatformSelector;
-  target?: DeviceTarget;
-  targetApp?: string;
-  metro?: {
-    host: string;
-    port: number;
-  };
-  checks: DoctorCheck[];
-};
-//#endregion
-//#region packages/contracts/src/diff.d.ts
-type SnapshotDiffLine = {
-  kind: 'added' | 'removed' | 'unchanged';
-  text: string;
-  /**
-   * Plain ref body (`e12`) of the current-tree node behind an added line.
-   * Only populated with `withRefs`; removed and unchanged lines never carry it.
-   */
-  ref?: string;
-};
-type SnapshotDiffSummary = {
-  additions: number;
-  removals: number;
-  unchanged: number;
-};
-type DiffSnapshotCommandResult = {
-  mode: 'snapshot';
-  baselineInitialized: boolean;
-  summary: SnapshotDiffSummary;
-  lines: SnapshotDiffLine[];
-  warnings?: string[];
-};
-//#endregion
-//#region packages/contracts/src/viewport.d.ts
-/**
- * Closed result of the `viewport` command. Mirrors the dispatch handler's return
- * EXACTLY (src/core/dispatch.ts `handleViewportCommand`) — `{ width, height }`
- * plus the always-present `successText` message. The generic dispatch path
- * returns this object unchanged (viewport has no Android dialog guard, so no
- * `warning` is ever appended), so the shape is intentionally closed.
- */
-type ViewportCommandResult = {
-  width: number;
-  height: number;
-  message: string;
-};
-//#endregion
-//#region packages/contracts/src/replay.d.ts
-type ReplayCommandResult = {
-  replayed: number;
-  healed: number;
-  session: string;
-  /**
-   * True iff `session` still exists in the daemon's session store when the
-   * response is built. This remains true when replay suppresses an authored
-   * terminal `close` for an explicit live-session handoff. The client uses
-   * this, not script parsing, to decide whether an owned one-shot daemon must
-   * stay alive so the caller can keep addressing this session.
-   */
-  sessionActive: boolean;
-  artifactPaths: string[];
-  warnings?: string[];
-  snapshotDiagnostics?: SnapshotDiagnosticsSummary;
-  message: string;
-};
-type ReplaySuiteTestSkipReason = 'skipped-by-filter';
-type ReplaySuiteAttemptFailure = {
-  attempt: number;
-  message: string;
-  durationMs?: number;
-};
-type ReplaySuiteTestPassed = {
-  file: string;
-  title?: string;
-  session: string;
-  status: 'passed';
-  durationMs: number;
-  finalAttemptDurationMs?: number;
-  attempts: number;
-  artifactsDir?: string;
-  replayed: number;
-  healed: number;
-  warnings?: string[];
-  attemptFailures?: ReplaySuiteAttemptFailure[];
-  shardIndex?: number;
-  shardCount?: number;
-  deviceId?: string;
-  deviceName?: string;
-  snapshotDiagnostics?: SnapshotDiagnosticsSummary;
-};
-type ReplaySuiteTestFailed = {
-  file: string;
-  title?: string;
-  session: string;
-  status: 'failed';
-  durationMs: number;
-  attempts: number;
-  artifactsDir?: string;
-  error: DaemonError;
-  shardIndex?: number;
-  shardCount?: number;
-  deviceId?: string;
-  deviceName?: string;
-  snapshotDiagnostics?: SnapshotDiagnosticsSummary;
-};
-type ReplaySuiteTestSkipped = {
-  file: string;
-  title?: string;
-  status: 'skipped';
-  durationMs: 0;
-  reason: ReplaySuiteTestSkipReason;
-  message: string;
-};
-type ReplaySuiteTestResult = ReplaySuiteTestPassed | ReplaySuiteTestFailed | ReplaySuiteTestSkipped;
-type ReplaySuiteResult = {
-  total: number;
-  executed: number;
-  passed: number;
-  failed: number;
-  skipped: number;
-  notRun: number;
-  durationMs: number;
-  failures: ReplaySuiteTestFailed[];
-  tests: ReplaySuiteTestResult[];
-  snapshotDiagnostics?: SnapshotDiagnosticsSummary;
-};
-//#endregion
-//#region src/core/command-descriptor/command-result.d.ts
-/**
- * The additive typed-result spine (ADR-0008, Phase 1 step 6).
- *
- * Maps a command name to the per-command result type from `@agent-device/contracts`. It
- * is SEEDED, not exhaustive: a command is listed here only once its accurate,
- * closed result shape lives in the contracts layer. Commands whose daemon
- * handler spreads dynamic/Record data (screenshot overlays, gesture
- * visualization, perf, logs, …) are deliberately omitted rather than given an
- * invented shape.
- *
- * Batches 1-2 wired `boot` / `shutdown` / `viewport` and the navigation/action
- * commands `home` / `back` / `orientation` / `app-switcher` alongside the seed
- * interaction quartet. Batch 3 adds `clipboard` (a closed `read`/`write` union) and
- * `appstate` (a closed `platform` union — Apple session state with the iOS-only
- * device locators, or Android package/activity). Batch 4 adds `keyboard` (a
- * closed flat shape). Batch 5 adds the compact daemon projections for `wait`,
- * `prepare`, `push`, and `trigger-app-event`. Each entry is grounded in a
- * re-read of the handler's literal return; see the per-type docstrings.
- */
-interface CommandResultMap {
-  press: PressCommandResponseData;
-  click: ClickCommandResponseData;
-  fill: FillCommandResponseData;
-  longpress: LongPressCommandResponseData;
-  find: FindCommandResponseData;
-  boot: BootCommandResult;
-  shutdown: ShutdownCommandResult;
-  viewport: ViewportCommandResult;
-  home: HomeCommandResult;
-  back: BackCommandResult;
-  orientation: OrientationCommandResult;
-  'app-switcher': AppSwitcherCommandResult;
-  clipboard: ClipboardCommandResult;
-  appstate: AppStateCommandResult;
-  keyboard: KeyboardCommandResult;
-  'tv-remote': TvRemoteCommandResult;
-  wait: WaitCommandResult;
-  prepare: PrepareCommandResult;
-  push: PushCommandResult;
-  'trigger-app-event': TriggerAppEventCommandResult;
-  doctor: DoctorCommandResult;
-  diff: DiffSnapshotCommandResult;
-  replay: ReplayCommandResult;
-  test: ReplaySuiteResult;
-  record: RecordingCommandResult;
-  trace: TraceCommandResult;
-}
-/**
- * The typed result for a command named `N`. Seeded commands resolve to their
- * contract result type from {@link CommandResultMap}; every other (unmigrated)
- * command falls back to the untyped `Record<string, unknown>` bag. That default
- * branch is what keeps the mapping total over every command name, so consumers
- * can switch to `CommandResult<Name>` without first migrating every command.
- */
-type CommandResult<N extends string> = N extends keyof CommandResultMap ? CommandResultMap[N] : Record<string, unknown>;
-//#endregion
-//#region src/client/client-types.d.ts
-type OrientationCommandOptions = DeviceCommandBaseOptions & NavigationCommandOptions<'orientation'>;
-/** @deprecated Renamed to `OrientationCommandOptions`. Retained until the next major. */
-type RotateCommandOptions = OrientationCommandOptions;
-type NonNavigationCommandClient = {
-  wait: (options: WaitCommandOptions) => Promise<CommandResult<'wait'>>;
-  alert: (options?: AlertCommandOptions) => Promise<CommandRequestResult>;
-  appState: (options?: AppStateCommandOptions) => Promise<CommandResult<'appstate'>>;
-  keyboard: (options?: KeyboardCommandOptions) => Promise<CommandResult<'keyboard'>>;
-  clipboard: (options: ClipboardCommandOptions) => Promise<CommandResult<'clipboard'>>;
-  reactNative: (options: ReactNativeCommandOptions) => Promise<CommandRequestResult>;
-  doctor: (options?: DoctorCommandOptions) => Promise<CommandResult<'doctor'>>;
-  /**
-   * JSON prepare results include timing.additiveParts for additive wall-clock phases.
-   * Top-level buildMs/connectMs/healthCheckMs are diagnostics and may overlap.
-   */
-  prepare: (options: PrepareCommandOptions) => Promise<CommandResult<'prepare'>>;
-  viewport: (options: ViewportCommandOptions) => Promise<CommandResult<'viewport'>>;
-};
-type AgentDeviceCommandClient = ProjectedNavigationCommandClient<DeviceCommandBaseOptions> & NonNavigationCommandClient & DeprecatedCommandClient;
-/** Renamed command methods retained for existing consumers until the next major. */
-type DeprecatedCommandClient = {
-  /**
-   * @deprecated Renamed to `orientation`. Delegates to it and returns the legacy
-   * `action: 'rotate'` response contract. Retained until the next major version.
-   */
-  rotate: (options: RotateCommandOptions) => Promise<RotateCommandResult>;
-};
-type AgentDeviceClient = {
-  command: AgentDeviceCommandClient;
-  devices: {
-    list: (options?: AgentDeviceRequestOverrides & AgentDeviceSelectionOptions) => Promise<AgentDeviceDevice[]>;
-    capabilities: (options?: AgentDeviceRequestOverrides & AgentDeviceSelectionOptions) => Promise<AgentDeviceCapabilitiesResult>;
-    boot: (options?: DeviceBootOptions) => Promise<CommandResult<'boot'>>;
-    shutdown: (options?: DeviceShutdownOptions) => Promise<CommandResult<'shutdown'>>;
-  };
-  sessions: {
-    list: (options?: AgentDeviceRequestOverrides) => Promise<AgentDeviceSession[]>;
-    stateDir: (options?: AgentDeviceRequestOverrides & Pick<AgentDeviceClientConfig, 'stateDir'>) => Promise<string>;
-    close: (options?: AgentDeviceRequestOverrides & {
-      shutdown?: boolean;
-      saveScript?: boolean | string;
-      /** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
-      force?: boolean;
-    }) => Promise<SessionCloseResult>;
-    saveScript: (options?: SessionSaveScriptOptions) => Promise<SessionSaveScriptResult>;
-    artifacts: (options?: CloudArtifactsOptions) => Promise<AgentArtifactsResult>;
-  };
-  apps: {
-    install: (options: AppInstallOptions) => Promise<AppDeployResult>;
-    reinstall: (options: AppDeployOptions) => Promise<AppDeployResult>;
-    installFromSource: (options: AppInstallFromSourceOptions) => Promise<AppInstallFromSourceResult>;
-    list: (options?: AppListOptions) => Promise<string[]>;
-    open: (options: AppOpenOptions) => Promise<AppOpenResult>;
-    close: (options?: AppCloseOptions) => Promise<AppCloseResult>;
-    push: (options: AppPushOptions) => Promise<CommandResult<'push'>>;
-    triggerEvent: (options: AppTriggerEventOptions) => Promise<CommandResult<'trigger-app-event'>>;
-  };
-  materializations: {
-    release: (options: MaterializationReleaseOptions) => Promise<MaterializationReleaseResult>;
-  };
-  leases: {
-    allocate: (options: LeaseAllocateOptions) => Promise<Lease>;
-    heartbeat: (options: LeaseScopedOptions) => Promise<Lease>;
-    release: (options: LeaseScopedOptions) => Promise<{
-      released: boolean;
-      provider?: CloudProviderSessionResult;
-    }>;
-  };
-  metro: {
-    prepare: (options: MetroPrepareOptions) => Promise<MetroPrepareResult>;
-    reload: (options?: MetroReloadOptions) => Promise<MetroReloadResult>;
-  };
-  capture: {
-    snapshot: (options?: CaptureSnapshotOptions) => Promise<CaptureSnapshotResult>;
-    screenshot: (options?: CaptureScreenshotOptions) => Promise<CaptureScreenshotResult>;
-    diff: (options: CaptureDiffOptions) => Promise<CommandResult<'diff'>>;
-  };
-  interactions: {
-    click: (options: ClickOptions) => Promise<CommandResult<'click'>>;
-    press: (options: PressOptions) => Promise<CommandResult<'press'>>;
-    longPress: (options: LongPressOptions) => Promise<CommandResult<'longpress'>>;
-    swipe: (options: SwipeOptions) => Promise<CommandRequestResult>;
-    pan: (options: PanOptions) => Promise<CommandRequestResult>;
-    drag: (options: DragOptions) => Promise<CommandRequestResult>;
-    fling: (options: FlingOptions) => Promise<CommandRequestResult>;
-    swipeGesture: (options: SwipeGestureOptions) => Promise<CommandRequestResult>;
-    focus: (options: FocusOptions) => Promise<CommandRequestResult>;
-    type: (options: TypeTextOptions) => Promise<CommandRequestResult>;
-    fill: (options: FillOptions) => Promise<CommandResult<'fill'>>;
-    scroll: (options: ScrollOptions) => Promise<CommandRequestResult>;
-    pinch: (options: PinchOptions) => Promise<CommandRequestResult>;
-    rotateGesture: (options: RotateGestureOptions) => Promise<CommandRequestResult>;
-    transformGesture: (options: TransformGestureOptions) => Promise<CommandRequestResult>;
-    get: (options: GetOptions) => Promise<CommandRequestResult>;
-    is: (options: IsOptions) => Promise<CommandRequestResult>;
-    find: (options: FindOptions) => Promise<CommandResult<'find'>>;
-  };
-  replay: {
-    run: (options: ReplayRunOptions) => Promise<CommandResult<'replay'>>;
-    test: (options: ReplayTestOptions) => Promise<CommandResult<'test'>>;
-  };
-  batch: {
-    run: (options: BatchRunOptions) => Promise<BatchRunResult>;
-  };
-  observability: {
-    perf: (options?: PerfOptions) => Promise<CommandRequestResult>;
-    logs: (options?: LogsOptions) => Promise<CommandRequestResult>;
-    events: (options?: EventsOptions) => Promise<CommandRequestResult>;
-    network: (options?: NetworkOptions) => Promise<CommandRequestResult>;
-    audio: (options?: AudioOptions) => Promise<CommandRequestResult>;
-  };
-  debug: {
-    symbols: (options: DebugSymbolsOptions) => Promise<DebugSymbolsResult>;
-  };
-  recording: {
-    record: (options: RecordOptions) => Promise<CommandResult<'record'>>;
-    trace: (options: TraceOptions) => Promise<CommandResult<'trace'>>;
-  };
-  settings: {
-    update: (options: SettingsUpdateOptions) => Promise<CommandRequestResult>;
-  };
-};
-//#endregion
 //#region src/agent-device-client.d.ts
 declare function createAgentDeviceClient(config?: AgentDeviceClientConfig, deps?: {
   transport?: AgentDeviceDaemonTransport;