agent-device 0.20.1 → 0.20.3

package/dist/src/lease-context.js

@@ -1 +1 @@
-import{T as e}from"./sdk-batch-runner.js";import{Xt as t}from"./recording-export-quality.js";function n(e){return t(e)}function r(t,r){let i=n(t),a=i.leaseId??r?.leaseId,o=i.tenantId??r?.tenantId,s=i.runId??r?.runId;if(!(!o||!s||!a))return e({tenantId:o,runId:s,leaseId:a,leaseBackend:i.leaseBackend??r?.backend,leaseProvider:i.leaseProvider??r?.leaseProvider,deviceKey:i.deviceKey??r?.deviceKey,clientId:i.clientId??r?.clientId,expiresAt:r?.expiresAt})}function i(t,r){let i=n(t),a=r?.lease??r?.deviceLease??void 0;return e({tenantId:i.tenantId??a?.tenantId,runId:i.runId??a?.runId,leaseId:i.leaseId??a?.leaseId,leaseTtlMs:i.leaseTtlMs,leaseBackend:i.leaseBackend??a?.leaseBackend,leaseProvider:i.leaseProvider??a?.leaseProvider,deviceKey:i.deviceKey??a?.deviceKey,clientId:i.clientId??a?.clientId})}function a(t){let n=t.meta,r=e({leaseId:o(n?.leaseId),clientId:o(n?.clientId),tenantId:o(n?.tenantId),runId:o(n?.runId),leaseProvider:o(n?.leaseProvider),deviceKey:o(n?.deviceKey)});return Object.keys(r).length>0?r:void 0}function o(e){return typeof e==`string`&&e.trim().length>0?e.trim():void 0}export{a as i,n,i as r,r as t};
+import{T as e}from"./sdk-batch-runner.js";import{It as t}from"./recording-export-quality.js";function n(e){return t(e)}function r(t,r){let i=n(t),a=i.leaseId??r?.leaseId,o=i.tenantId??r?.tenantId,s=i.runId??r?.runId;if(!(!o||!s||!a))return e({tenantId:o,runId:s,leaseId:a,leaseBackend:i.leaseBackend??r?.backend,leaseProvider:i.leaseProvider??r?.leaseProvider,deviceKey:i.deviceKey??r?.deviceKey,clientId:i.clientId??r?.clientId,expiresAt:r?.expiresAt})}function i(t,r){let i=n(t),a=r?.lease??r?.deviceLease??void 0;return e({tenantId:i.tenantId??a?.tenantId,runId:i.runId??a?.runId,leaseId:i.leaseId??a?.leaseId,leaseTtlMs:i.leaseTtlMs,leaseBackend:i.leaseBackend??a?.leaseBackend,leaseProvider:i.leaseProvider??a?.leaseProvider,deviceKey:i.deviceKey??a?.deviceKey,clientId:i.clientId??a?.clientId})}function a(t){let n=t.meta,r=e({leaseId:o(n?.leaseId),clientId:o(n?.clientId),tenantId:o(n?.tenantId),runId:o(n?.runId),leaseProvider:o(n?.leaseProvider),deviceKey:o(n?.deviceKey)});return Object.keys(r).length>0?r:void 0}function o(e){return typeof e==`string`&&e.trim().length>0?e.trim():void 0}export{a as i,n,i as r,r as t};

package/dist/src/lease.js

@@ -1 +1 @@
-import{_ as e}from"./sdk-contracts.js";import{Jt as t,Zt as n,cr as r,en as i,nn as a}from"./recording-export-quality.js";import{n as o,r as s}from"./lease-context.js";import{Mn as c}from"./internal/daemon.js";async function l(e){let{req:t,sessionName:c,sessionStore:l,leaseRegistry:f,providerRuntimeIds:p,providerRuntimeRequiredIds:m,leaseLifecycleProvider:h,cloudArtifactProvider:g}=e,_=o(t);switch(t.command){case r.artifacts:return{ok:!0,data:await d(t,s(t,l.get(c)),g)};case`lease_allocate`:{u(_.leaseProvider,p,m);let e=f.allocateLease(n(_)),r;try{r=await h?.allocate?.(e,{req:t})}catch(t){throw f.releaseLease(a({leaseId:e.leaseId,tenantId:e.tenantId,runId:e.runId,leaseBackend:e.backend,leaseProvider:e.leaseProvider,deviceKey:e.deviceKey,clientId:e.clientId})),t}return{ok:!0,data:{lease:e,...r?{provider:r}:{}}}}case`lease_heartbeat`:{let e=f.heartbeatLease(i(_)),n=await h?.heartbeat?.(e,{req:t});return{ok:!0,data:{lease:e,...n?{provider:n}:{}}}}case`lease_release`:{let e=a(_),n=f.getLease(e),r=n?await h?.release?.(n,{req:t}):void 0;return{ok:!0,data:{released:f.releaseLease(e).released,...r?{provider:r}:{}}}}default:return null}}function u(t,n,r){if(!(!t||n===void 0||r===void 0||!r.includes(t)||n.includes(t)))throw new e(`UNSUPPORTED_OPERATION`,`Provider "${t}" is not available in this daemon runtime.`,{provider:t,hint:`Restart the daemon with ${t} configured, then retry lease allocation.`})}async function d(e,t,n){let r=h(e.flags,`providerSessionId`);return f(t,r)?await p(t.tenantId):await m(t,r,n)}function f(e,n){return t(e)||!e.leaseProvider&&!n}async function p(e){let t=await c(e);return{source:`daemon`,status:`ready`,artifacts:t,...t.length===0?{message:`No daemon artifacts available.`}:{}}}async function m(t,n,r){if(!t.leaseProvider)throw new e(`INVALID_ARGS`,`artifacts requires --provider for provider session lookup or an active cloud connection.`);if(!t.leaseId&&!n)throw new e(`INVALID_ARGS`,`artifacts requires an active cloud lease or --provider-session <id>.`);let i=await r?.listCloudArtifacts?.({provider:t.leaseProvider,leaseId:t.leaseId,providerSessionId:n});if(!i)throw new e(`UNSUPPORTED_OPERATION`,`Cloud artifacts are not available for provider "${t.leaseProvider}".`);return i}function h(e,t){let n=e?.[t];return typeof n==`string`&&n.length>0?n:void 0}export{l as handleLeaseCommands};
+import{_ as e}from"./sdk-contracts.js";import{Bt as t,Ht as n,Lt as r,On as i,Pt as a}from"./recording-export-quality.js";import{n as o,r as s}from"./lease-context.js";import{on as c}from"./internal/daemon.js";async function l(e){let{req:a,sessionName:c,sessionStore:l,leaseRegistry:f,providerRuntimeIds:p,providerRuntimeRequiredIds:m,leaseLifecycleProvider:h,cloudArtifactProvider:g}=e,_=o(a);switch(a.command){case i.artifacts:return{ok:!0,data:await d(a,s(a,l.get(c)),g)};case`lease_allocate`:{u(_.leaseProvider,p,m);let e=f.allocateLease(r(_)),t;try{t=await h?.allocate?.(e,{req:a})}catch(t){throw f.releaseLease(n({leaseId:e.leaseId,tenantId:e.tenantId,runId:e.runId,leaseBackend:e.backend,leaseProvider:e.leaseProvider,deviceKey:e.deviceKey,clientId:e.clientId})),t}return{ok:!0,data:{lease:e,...t?{provider:t}:{}}}}case`lease_heartbeat`:{let e=f.heartbeatLease(t(_)),n=await h?.heartbeat?.(e,{req:a});return{ok:!0,data:{lease:e,...n?{provider:n}:{}}}}case`lease_release`:{let e=n(_),t=f.getLease(e),r=t?await h?.release?.(t,{req:a}):void 0;return{ok:!0,data:{released:f.releaseLease(e).released,...r?{provider:r}:{}}}}default:return null}}function u(t,n,r){if(!(!t||n===void 0||r===void 0||!r.includes(t)||n.includes(t)))throw new e(`UNSUPPORTED_OPERATION`,`Provider "${t}" is not available in this daemon runtime.`,{provider:t,hint:`Restart the daemon with ${t} configured, then retry lease allocation.`})}async function d(e,t,n){let r=h(e.flags,`providerSessionId`);return f(t,r)?await p(t.tenantId):await m(t,r,n)}function f(e,t){return a(e)||!e.leaseProvider&&!t}async function p(e){let t=await c(e);return{source:`daemon`,status:`ready`,artifacts:t,...t.length===0?{message:`No daemon artifacts available.`}:{}}}async function m(t,n,r){if(!t.leaseProvider)throw new e(`INVALID_ARGS`,`artifacts requires --provider for provider session lookup or an active cloud connection.`);if(!t.leaseId&&!n)throw new e(`INVALID_ARGS`,`artifacts requires an active cloud lease or --provider-session <id>.`);let i=await r?.listCloudArtifacts?.({provider:t.leaseProvider,leaseId:t.leaseId,providerSessionId:n});if(!i)throw new e(`UNSUPPORTED_OPERATION`,`Cloud artifacts are not available for provider "${t.leaseProvider}".`);return i}function h(e,t){let n=e?.[t];return typeof n==`string`&&n.length>0?n:void 0}export{l as handleLeaseCommands};

package/dist/src/limrun.d.ts

@@ -0,0 +1,437 @@
+import { A as SnapshotNode, B as DeviceTarget, D as Rect, E as RawSnapshotNode, H as PlatformSelector, N as SnapshotState, R as DeviceInfo, T as Point, j as SnapshotOptions$1, k as SnapshotBackend, o as DaemonRequest, p as LeaseBackend } from "./sdk-contracts.js";
+import { c as ScrollDirection, o as GesturePlan, r as AndroidAdbProvider } from "./sdk-android-adb.js";
+import { t as AppsFilter } from "./sdk-app-inventory.js";
+import { n as AndroidKeyboardState, t as AndroidKeyboardDismissResult } from "./device-input-state.js";
+import { a as CloudArtifactProvider, f as SnapshotCaptureAnnotations, n as DeviceRotation, p as SessionSurface, s as BackMode, t as TvRemoteButton, u as SnapshotDiagnosticsSummary } from "./tv-remote.js";
+import { t as ClickButton } from "./click-button.js";
+import Limrun from "@limrun/api";
+import "@limrun/api/instance-client";
+import "@limrun/api/ios-client";
+//#region src/platforms/permission-utils.d.ts
+type SettingOptions = {
+  permissionTarget?: string;
+  permissionMode?: string;
+  latitude?: number;
+  longitude?: number;
+};
+//#endregion
+//#region src/backend.d.ts
+type BackendSnapshotResult = {
+  nodes?: SnapshotNode[];
+  truncated?: boolean;
+  backend?: string;
+  snapshot?: SnapshotState;
+  appName?: string;
+  appBundleId?: string;
+  snapshotDiagnostics?: SnapshotDiagnosticsSummary;
+} & SnapshotCaptureAnnotations;
+//#endregion
+//#region src/contracts/runner-lease-context.d.ts
+type RunnerLogicalLeaseContext = {
+  leaseId?: string;
+  clientId?: string;
+  tenantId?: string;
+  runId?: string;
+  leaseProvider?: string;
+  deviceKey?: string;
+};
+//#endregion
+//#region src/contracts/interactor-types.d.ts
+type RunnerContext = {
+  requestId?: string;
+  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;
+};
+type SnapshotOptions = SnapshotOptions$1 & {
+  appBundleId?: string;
+  includeRects?: boolean;
+  includeHiddenContentHints?: boolean;
+  surface?: SessionSurface;
+};
+type SnapshotResult = Omit<BackendSnapshotResult, 'backend' | 'nodes'> & {
+  nodes?: RawSnapshotNode[];
+  backend: Extract<SnapshotBackend, 'android' | '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<void>;
+  fillElementSelector?(selector: ElementSelectorTapOptions, text: string, delayMs?: number): Promise<Record<string, unknown> | void>;
+  fill(x: number, y: number, text: string, delayMs?: number): 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 src/contracts/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[];
+};
+//#endregion
+//#region src/contracts/device-provider.d.ts
+type DeviceLease = {
+  leaseId: string;
+  tenantId: string;
+  runId: string;
+  backend: LeaseBackend;
+  leaseProvider?: string;
+  deviceKey?: string;
+  clientId?: string;
+  createdAt: number;
+  heartbeatAt: number;
+  expiresAt: number;
+};
+type LeaseLifecycleContext = {
+  req: DaemonRequest;
+};
+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: DeviceInventoryRequest) => Promise<DeviceInfo[] | null | undefined>;
+//#endregion
+//#region src/utils/retry.d.ts
+declare class Deadline {
+  private readonly startedAtMs;
+  private readonly expiresAtMs;
+  private constructor();
+  static fromTimeoutMs(timeoutMs: number, nowMs?: number): Deadline;
+  remainingMs(nowMs?: number): number;
+  elapsedMs(nowMs?: number): number;
+  isExpired(nowMs?: number): boolean;
+}
+//#endregion
+//#region src/platforms/apple/core/runner/runner-cache.d.ts
+type RunnerXctestrunCacheKind = 'exact' | 'restore-key' | 'miss' | 'external';
+//#endregion
+//#region src/platforms/apple/core/runner/runner-artifact.d.ts
+type RunnerXctestrunArtifactState = 'valid' | 'rebuilt';
+type ExternalXctestRunnerOptions = {
+  iosXctestrunFile?: string;
+  iosXctestDerivedDataPath?: string;
+  iosXctestEnvDir?: string;
+};
+//#endregion
+//#region src/platforms/apple/core/runner/runner-contract.d.ts
+type RunnerCommand = {
+  command: 'tap' | 'mouseClick' | 'longPress' | 'drag' | 'remotePress' | 'type' | 'swipe' | 'scroll' | 'desktopScroll' | 'findText' | 'querySelector' | 'readText' | 'snapshot' | 'screenshot' | 'back' | 'backInApp' | 'backSystem' | 'home' | 'rotate' | 'gesture' | 'gestureViewport' | 'appSwitcher' | 'keyboardDismiss' | 'keyboardReturn' | 'alert' | 'sequence' | 'recordStart' | 'recordStop' | 'status' | 'uptime' | 'activate' | 'terminate' | 'targetReset' | 'shutdown';
+  commandId?: string;
+  statusCommandId?: string;
+  appBundleId?: string;
+  text?: string;
+  selectorKey?: ElementSelectorKey;
+  selectorValue?: string;
+  allowNonHittableCoordinateFallback?: boolean;
+  delayMs?: number;
+  textEntryMode?: 'append' | 'replace';
+  action?: 'get' | 'accept' | 'dismiss';
+  x?: number;
+  y?: number;
+  button?: ClickButton;
+  remoteButton?: 'select' | 'menu' | 'home' | 'up' | 'down' | 'left' | 'right';
+  x2?: number;
+  y2?: number;
+  durationMs?: number;
+  /** Remaining request budget for runner work that performs bounded XCTest queries. */
+  timeoutMs?: number;
+  direction?: ScrollDirection;
+  amount?: number;
+  pixels?: number;
+  orientation?: DeviceRotation;
+  /** Canonical pointer samples planned by the portable gesture runtime. */
+  gesturePlan?: GesturePlan;
+  outPath?: string;
+  fps?: number;
+  maxSize?: number;
+  interactiveOnly?: boolean;
+  depth?: number;
+  scope?: string;
+  raw?: boolean;
+  fullscreen?: boolean;
+  inlineScreenshot?: boolean;
+  synthesized?: boolean;
+  steps?: RunnerSequenceStep[];
+};
+/**
+ * One allowlisted coordinate gesture step inside a fused `sequence` runner command.
+ * The kind set is intentionally narrow (tap/doubleTap/longPress) and validated on both the
+ * daemon and runner sides — see runner-sequence.ts (the single interpretation point).
+ */
+type RunnerSequenceStep = {
+  kind: 'tap' | 'doubleTap' | 'longPress';
+  x: number;
+  y: number;
+  durationMs?: number;
+  pauseMs?: number;
+  /**
+   * For `tap` steps on iOS non-tv: use the synthesized HID tap (synthesizedTapAt) fast path
+   * instead of the drag-based XCUICoordinate tapAt, matching the individual `tap` command.
+   */
+  synthesized?: boolean;
+};
+//#endregion
+//#region src/platforms/apple/core/runner/runner-provider.d.ts
+type AppleRunnerCommandOptions = ExternalXctestRunnerOptions & {
+  verbose?: boolean;
+  logPath?: string;
+  traceLogPath?: string;
+  cleanStaleBundles?: boolean;
+  startupTimeoutMs?: number;
+  requestId?: string;
+  runnerLeaseContext?: RunnerLogicalLeaseContext;
+};
+type AppleRunnerLifecycleOptions = AppleRunnerCommandOptions & {
+  buildTimeoutMs?: number;
+  forceRunnerXctestrunRebuild?: boolean;
+};
+type AppleRunnerPrewarmOptions = AppleRunnerLifecycleOptions;
+type AppleRunnerPrepareOptions = AppleRunnerLifecycleOptions & {
+  healthTimeoutMs: number;
+  prepareDeadline?: Deadline;
+};
+type AppleRunnerPrepareResult = {
+  runner: Record<string, unknown>;
+  cache?: RunnerXctestrunCacheKind;
+  artifact?: RunnerXctestrunArtifactState;
+  buildMs?: number;
+  connectMs: number;
+  healthCheckMs: number;
+  xctestrunPath?: string;
+  recoveryReason?: string;
+  failureReason?: string;
+};
+type AppleRunnerCommandExecutor = (device: DeviceInfo, command: RunnerCommand, options: AppleRunnerCommandOptions) => Promise<Record<string, unknown>>;
+type AppleRunnerPrepareExecutor = (device: DeviceInfo, options: AppleRunnerPrepareOptions) => Promise<AppleRunnerPrepareResult>;
+type AppleRunnerPrewarmExecutor = (device: DeviceInfo, options: AppleRunnerPrewarmOptions) => Promise<void>;
+type AppleRunnerProvider = {
+  /**
+   * Executes a runner protocol command for an already resolved Apple target.
+   * Scoped providers may adapt this call to a request-local transport.
+   */
+  runCommand: AppleRunnerCommandExecutor;
+  /**
+   * Proves a runner can answer a cheap command after any required local setup.
+   * Command-only providers may omit this and let callers fall back to uptime.
+   */
+  prepare?: AppleRunnerPrepareExecutor;
+  /**
+   * Starts runner setup opportunistically. This must remain best-effort.
+   */
+  prewarm?: AppleRunnerPrewarmExecutor;
+};
+//#endregion
+//#region 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 ProviderDeviceRuntime = {
+  provider: string;
+  leaseLifecycle: LeaseLifecycleProvider;
+  recoverExpiredLease?: ProviderExpiredLeaseRecovery;
+  cloudArtifacts?: CloudArtifactProvider;
+  deviceInventoryProvider: DeviceInventoryProvider;
+  ownsDevice(device: DeviceInfo): boolean;
+  /**
+   * Builds the interactor for an owned device. `runnerContext` carries the
+   * per-request context (requestId for cancellation, appBundleId, log paths);
+   * runtimes composing the shared Apple interactor should thread it through so
+   * runner calls stay attributable to the request that issued them.
+   */
+  getInteractor(device: DeviceInfo, runnerContext?: RunnerContext): Interactor | undefined;
+  /**
+   * Apple runner transport for an owned device. When present, the daemon scopes
+   * the WHOLE request with it (via the `appleRunnerProvider` request resolver),
+   * so daemon routes that issue runner commands outside interactor methods
+   * (keyboard, native alert, point read, iOS sequences) reach the provider
+   * transport instead of the local XCTest runtime.
+   */
+  getAppleRunnerProvider?(device: DeviceInfo): AppleRunnerProvider | AppleRunnerCommandExecutor | 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>;
+};
+type ProviderPortReverseOptions = {
+  leaseId: string;
+  provider?: string;
+  devicePort: number;
+  hostPort: number;
+  name: string;
+};
+type ProviderExpiredLeaseRecovery = (lease: DeviceLease) => Promise<void>;
+//#endregion
+//#region src/providers/limrun/ios.d.ts
+type LimrunIosRemoteInstallOptions = {
+  md5?: string;
+  relaunch?: boolean;
+  appIdentifierHint?: string;
+};
+type LimrunIosRemoteInstallResult = {
+  appId?: string;
+};
+//#endregion
+//#region src/providers/limrun/device-session.d.ts
+type LimrunRecordingQuality = 5 | 6 | 7 | 8 | 9 | 10;
+type LimrunInstalledApp = {
+  id: string;
+  name?: string;
+  installType?: string;
+};
+type LimrunForegroundApp = {
+  appId?: string;
+  activity?: string;
+};
+type LimrunIosCommandResult = {
+  code: number;
+  stdout: string;
+  stderr: string;
+};
+type LimrunIosCommandExecution = {
+  on(event: 'line-stdout' | 'line-stderr', listener: (line: string) => void): LimrunIosCommandExecution;
+  on(event: 'exit', listener: (code: number) => void): LimrunIosCommandExecution;
+  on(event: 'error', listener: (error: Error) => void): LimrunIosCommandExecution;
+  off(event: 'line-stdout' | 'line-stderr', listener: (line: string) => void): LimrunIosCommandExecution;
+  off(event: 'exit', listener: (code: number) => void): LimrunIosCommandExecution;
+  off(event: 'error', listener: (error: Error) => void): LimrunIosCommandExecution;
+  wait(): Promise<LimrunIosCommandResult>;
+  stop(): void;
+};
+type LimrunDeviceSessionBase = {
+  readonly platform: 'android' | 'ios';
+  readonly device: DeviceInfo;
+  readonly interactor: Interactor;
+  listApps(filter?: AppsFilter): Promise<LimrunInstalledApp[]>;
+  pressKey(key: string, modifiers?: string[]): Promise<void>;
+  startRecording(options?: {
+    quality?: LimrunRecordingQuality;
+  }): Promise<void>;
+  stopRecording(options: {
+    outPath: string;
+  }): Promise<string>;
+};
+type LimrunAndroidDeviceSession = LimrunDeviceSessionBase & {
+  readonly platform: 'android';
+  readonly adb: AndroidAdbProvider;
+  getForegroundApp(): Promise<LimrunForegroundApp | undefined>;
+  getKeyboardState(): Promise<AndroidKeyboardState>;
+  dismissKeyboard(): Promise<AndroidKeyboardDismissResult>;
+  readLogs(lineLimit: number): Promise<string>;
+  installRemoteApp(url: string): Promise<void>;
+};
+type LimrunIosDeviceSession = LimrunDeviceSessionBase & {
+  readonly platform: 'ios';
+  readonly viewport: {
+    width: number;
+    height: number;
+  };
+  readLogs(appId: string, lineLimit: number): Promise<string>;
+  installRemoteApp(url: string, options?: LimrunIosRemoteInstallOptions): Promise<LimrunIosRemoteInstallResult>;
+  runSimctl(args: string[]): LimrunIosCommandExecution;
+};
+type LimrunDeviceSession = LimrunAndroidDeviceSession | LimrunIosDeviceSession;
+//#endregion
+//#region src/providers/limrun/runtime.d.ts
+type LimrunRuntimeOptions = {
+  apiKey: string;
+  region?: string;
+};
+declare class LimrunRuntime implements ProviderDeviceRuntime {
+  private readonly limrun;
+  private readonly sessions;
+  private readonly options;
+  readonly provider = "limrun";
+  readonly leaseLifecycle: LeaseLifecycleProvider;
+  readonly recoverExpiredLease: ProviderExpiredLeaseRecovery;
+  readonly deviceInventoryProvider: DeviceInventoryProvider;
+  constructor(options: LimrunRuntimeOptions);
+  ownsDevice(device: DeviceInfo): boolean;
+  getInteractor(device: DeviceInfo): Interactor | undefined;
+  getDeviceSession(device: DeviceInfo): LimrunDeviceSession | 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>;
+  private allocate;
+  private createIosSession;
+  private createAndroidSession;
+  private buildInstanceMetadata;
+  private release;
+  private releaseRecoveredSession;
+  private terminateSession;
+  private getSessionForDevice;
+  private requireAndroidPortReverseSession;
+}
+//#endregion
+export { type AndroidAdbProvider, type AndroidKeyboardDismissResult, type AndroidKeyboardState, type LimrunAndroidDeviceSession, type LimrunDeviceSession, type LimrunForegroundApp, type LimrunInstalledApp, type LimrunIosCommandExecution, type LimrunIosCommandResult, type LimrunIosDeviceSession, type LimrunIosRemoteInstallOptions, type LimrunIosRemoteInstallResult, type LimrunRecordingQuality, LimrunRuntime, type LimrunRuntimeOptions };

package/dist/src/limrun.js

@@ -0,0 +1 @@
+import{t as e}from"./runtime2.js";export{e as LimrunRuntime};

package/dist/src/linux.js

@@ -1 +1 @@
-import{_ as e}from"./sdk-contracts.js";import{I as t}from"./sdk-android-adb.js";import{c as n}from"./selector-vocabulary.js";import{t as r}from"./snapshot.js";import{t as i}from"./tool-provider2.js";import{doubleClickLinux as a,fillLinux as o,focusLinux as s,longPressLinux as c,pressLinux as l,scrollLinux as u,sendKey as d,swipeLinux as f,typeLinux as p}from"./input-actions2.js";async function m(e){await i().desktop.openTarget(e)}async function h(e){await i().desktop.closeApp(e)}async function g(){await d(`alt+Left`,[`56:1`,`105:1`,`105:0`,`56:0`])}async function _(){await d(`super+d`,[`125:1`,`32:1`,`32:0`,`125:0`])}async function v(){return await i().clipboard.readText()}async function y(e){await i().clipboard.writeText(e)}async function b(e,t){await i().screenshot.capture(e,t)}function x(){return{open:e=>m(e),openDevice:()=>Promise.resolve(),close:e=>h(e),tap:(e,t)=>l(e,t),doubleTap:(e,t)=>a(e,t),longPress:(e,t,n)=>c(e,t,n),focus:(e,t)=>s(e,t),type:(e,t)=>p(e,t),fill:(e,t,n,r)=>o(e,t,n,r),scroll:(e,t)=>u(e,t),performGesture:async t=>{if(t.topology===`two`)throw new e(`UNSUPPORTED_OPERATION`,`Multi-touch gestures are not supported on Linux`);let{start:r,end:i}=n(t);await f(r.x,r.y,i.x,i.y,t.durationMs)},screenshot:(e,t)=>b(e,t),snapshot:async e=>{let n=await t(`snapshot_capture`,async()=>await r(e?.surface),{backend:`linux-atspi`});return{nodes:n.nodes??[],truncated:n.truncated??!1,backend:`linux-atspi`}},back:()=>g(),home:()=>_(),setOrientation:()=>{throw new e(`UNSUPPORTED_OPERATION`,`orientation not supported on Linux`)},appSwitcher:()=>{throw new e(`UNSUPPORTED_OPERATION`,`appSwitcher not yet supported on Linux`)},tvRemote:()=>{throw new e(`UNSUPPORTED_OPERATION`,`tv-remote not supported on Linux`)},readClipboard:()=>v(),writeClipboard:e=>y(e),setSetting:()=>{throw new e(`UNSUPPORTED_OPERATION`,`setSetting not supported on Linux`)}}}export{x as createLinuxInteractor};
+import{_ as e}from"./sdk-contracts.js";import{I as t}from"./sdk-android-adb.js";import{n}from"./gesture-plan.js";import{t as r}from"./snapshot.js";import{t as i}from"./tool-provider2.js";import{doubleClickLinux as a,fillLinux as o,focusLinux as s,longPressLinux as c,pressLinux as l,scrollLinux as u,sendKey as d,swipeLinux as f,typeLinux as p}from"./input-actions2.js";async function m(e){await i().desktop.openTarget(e)}async function h(e){await i().desktop.closeApp(e)}async function g(){await d(`alt+Left`,[`56:1`,`105:1`,`105:0`,`56:0`])}async function _(){await d(`super+d`,[`125:1`,`32:1`,`32:0`,`125:0`])}async function v(){return await i().clipboard.readText()}async function y(e){await i().clipboard.writeText(e)}async function b(e,t){await i().screenshot.capture(e,t)}function x(){return{open:e=>m(e),openDevice:()=>Promise.resolve(),close:e=>h(e),tap:(e,t)=>l(e,t),doubleTap:(e,t)=>a(e,t),longPress:(e,t,n)=>c(e,t,n),focus:(e,t)=>s(e,t),type:(e,t)=>p(e,t),fill:(e,t,n,r)=>o(e,t,n,r),scroll:(e,t)=>u(e,t),performGesture:async t=>{if(t.topology===`two`)throw new e(`UNSUPPORTED_OPERATION`,`Multi-touch gestures are not supported on Linux`);let{start:r,end:i}=n(t);await f(r.x,r.y,i.x,i.y,t.durationMs)},screenshot:(e,t)=>b(e,t),snapshot:async e=>{let n=await t(`snapshot_capture`,async()=>await r(e?.surface),{backend:`linux-atspi`});return{nodes:n.nodes??[],truncated:n.truncated??!1,backend:`linux-atspi`}},back:()=>g(),home:()=>_(),setOrientation:()=>{throw new e(`UNSUPPORTED_OPERATION`,`orientation not supported on Linux`)},appSwitcher:()=>{throw new e(`UNSUPPORTED_OPERATION`,`appSwitcher not yet supported on Linux`)},tvRemote:()=>{throw new e(`UNSUPPORTED_OPERATION`,`tv-remote not supported on Linux`)},readClipboard:()=>v(),writeClipboard:e=>y(e),setSetting:()=>{throw new e(`UNSUPPORTED_OPERATION`,`setSetting not supported on Linux`)}}}export{x as createLinuxInteractor};

package/dist/src/logcat.js

@@ -1,5 +1 @@
-import{t as e}from"./rolldown-runtime.js";import{_ as t,v as n}from"./sdk-contracts.js";import{b as r,h as i,n as a,r as o,s,v as c,w as l}from"./sdk-android-adb.js";import{t as u}from"./timeouts.js";import{n as d,t as f}from"./manifest.js";import{n as p,r as m}from"./install-source2.js";import{a as h,l as g,n as _,s as ee,t as v}from"./boot-diagnostics.js";import"node:fs";import y from"node:path";function b(e){let t=e.trim();if(!t||/\s/.test(t))return!1;let n=/^([A-Za-z][A-Za-z0-9+.-]*):(.+)$/.exec(t);if(!n)return!1;let r=n[1]?.toLowerCase(),i=n[2]??``;return r===`http`||r===`https`||r===`ws`||r===`wss`||r===`ftp`||r===`ftps`?i.startsWith(`//`):!0}function x(e){let t=e.trim().split(`:`)[0]?.toLowerCase();return t===`http`||t===`https`}function te(e,t){let n=e?.trim();if(n)return n;if(x(t))return`com.apple.mobilesafari`}function S(e={}){let t=e.ttlMs??3e4,n=e.nowMs??Date.now,r=new Map,i=e=>{let t=w(e);for(let e of r.keys())e.startsWith(t)&&r.delete(e)};return{get(e,t){let i=C(e,t),a=r.get(i);if(a){if(a.expiresAtMs<=n()){r.delete(i);return}return a.value}},set(e,i,a){return r.set(C(e,i),{value:a,expiresAtMs:n()+t}),a},clear(e){i(e)},async invalidateWhile(e,t){i(e);try{return await t()}finally{i(e)}}}}function C(e,t){return[e.platform,e.deviceId,e.variant??``,t.trim().toLowerCase()].join(`\0`)}function w(e){return[e.platform,e.deviceId,``].join(`\0`)}var T=e({ensureAndroidEmulatorBooted:()=>oe,listAndroidDevices:()=>W,parseAndroidAvdList:()=>q,parseAndroidEmulatorAvdNameOutput:()=>N,parseAndroidFeatureListForTv:()=>B,parseAndroidTargetFromCharacteristics:()=>z,resolveAndroidAvdName:()=>J,resolveAndroidEmulatorAvdName:()=>R,waitForAndroidBoot:()=>Q});const E=1e4,D=[`android.software.leanback`,`android.software.leanback_only`,`android.hardware.type.television`];async function O(e,t,n){let r=Array(e.length),i=0,a=Math.min(t,e.length);return await Promise.all(Array.from({length:a},async()=>{for(;i<e.length;){let t=i;i+=1,r[t]=await n(e[t])}})),r}function k(e){return`${e.stdout}\n${e.stderr}`}function A(e,t){return[`-s`,e,...t]}function j(e){return e.startsWith(`emulator-`)}function M(e){return e.toLowerCase().replace(/_/g,` `).replace(/\s+/g,` `).trim()}function N(e){let t=e.split(`
-`).map(e=>e.trim()).filter(e=>e.length>0);if(t.length!==0)return t.at(-1)===`OK`&&t.pop(),t.join(`
-`).trim()||void 0}async function P(e,t=E){return c(`adb`,A(e,[`shell`,`getprop`,`sys.boot_completed`]),{allowFailure:!0,timeoutMs:t})}async function F(e,t){let n=t.replace(/_/g,` `).trim();if(!j(e))return n||e;let r=await R(e);return r?r.replace(/_/g,` `):n||e}async function I(e,t,r){try{return await r(`adb`,A(e,t),{allowFailure:!0,timeoutMs:1e4})}catch(e){if(L(n(e)))return;throw e}}function L(e){return e.code===`COMMAND_FAILED`&&typeof e.details?.timeoutMs==`number`}async function R(e,t=c){for(let n of[`ro.boot.qemu.avd_name`,`persist.sys.avd_name`]){let r=await I(e,[`shell`,`getprop`,n],t);if(!r)continue;let i=r.stdout.trim();if(r.exitCode===0&&i.length>0)return i}let n=await I(e,[`emu`,`avd`,`name`],t);if(!n)return;let r=N(n.stdout);if(n.exitCode===0&&r)return r}function z(e){let t=e.toLowerCase();return t.includes(`tv`)||t.includes(`leanback`)?`tv`:null}function B(e){return/feature:android\.(software\.leanback(_only)?|hardware\.type\.television)\b/i.test(e)}async function V(e,t){let n=k(await c(`adb`,A(e,[`shell`,`cmd`,`package`,`has-feature`,t]),{allowFailure:!0,timeoutMs:E})).toLowerCase();return n.includes(`true`)?!0:n.includes(`false`)?!1:null}async function H(e){return(await O(D,2,async t=>await V(e,t))).some(e=>e===!0)}async function U(e){return z(k(await c(`adb`,A(e,[`shell`,`getprop`,`ro.build.characteristics`]),{allowFailure:!0,timeoutMs:E})))===`tv`||await H(e)||B(k(await c(`adb`,A(e,[`shell`,`pm`,`list`,`features`]),{allowFailure:!0,timeoutMs:E})))?`tv`:`mobile`}async function W(e={}){if(await d(),!await l(`adb`))throw new t(`TOOL_MISSING`,`adb not found in PATH`);let n=e.serialAllowlist??h(void 0),r=await O((await K()).filter(e=>!n||n.has(e.serial)),3,async({serial:e,rawModel:t})=>{let[n,r,i]=await Promise.all([F(e,t),ae(e),U(e)]);return{platform:`android`,id:e,name:n,kind:j(e)?`emulator`:`device`,target:i,booted:r}});return[...r,...await X(r)]}function G(e){return e.split(`
-`).map(e=>e.trim()).filter(e=>e.length>0&&!e.startsWith(`List of devices`)).map(e=>e.split(/\s+/)).flatMap(e=>{let t=e[0];return t===void 0||e[1]!==`device`?[]:[{serial:t,rawModel:(e.find(e=>e.startsWith(`model:`))??``).replace(`model:`,``)}]})}async function K(){try{return G((await c(`adb`,[`devices`,`-l`],{timeoutMs:E})).stdout)}catch(e){throw o(e)}}function q(e){return e.split(`
-`).map(e=>e.trim()).filter(e=>e.length>0)}function J(e,t){let n=e.find(e=>e===t);if(n)return n;let r=M(t);return e.find(e=>M(e)===r)}async function Y(){return q(i(await c(`emulator`,[`-list-avds`],{allowFailure:!0,timeoutMs:E}),`Failed to list Android emulator AVDs`,{hint:`Verify Android emulator tooling is installed and available in PATH.`}).stdout)}async function X(e){let t=await Y().catch(()=>[]),n=new Set(e.filter(e=>e.kind===`emulator`).map(e=>M(e.name)));return t.filter(e=>!n.has(M(e))).map(e=>({platform:`android`,id:e,name:e,kind:`emulator`,target:Z(e),booted:!1}))}function Z(e){return/\b(tv|television)\b/i.test(M(e))?`tv`:`mobile`}function ne(e,t,n){let r=M(t);return e.find(e=>e.platform!==`android`||e.kind!==`emulator`||n&&e.id!==n?!1:M(e.name)===r)}async function re(e){let n=Date.now(),r=Math.min(1e3,Math.max(50,Math.floor(e.timeoutMs/20)));for(;Date.now()-n<e.timeoutMs;){try{let t=await ie(e.avdName,e.serial);if(t)return{platform:`android`,id:t,name:e.avdName,kind:`emulator`,target:`mobile`,booted:!1}}catch{}await u(r)}throw new t(`COMMAND_FAILED`,`Android emulator did not appear in time`,{avdName:e.avdName,serial:e.serial,timeoutMs:e.timeoutMs,hint:`Check emulator logs and verify the AVD can start from command line.`})}async function ie(e,t){let n=M(e),r=(await K()).filter(e=>t&&e.serial!==t?!1:j(e.serial));for(let e of r)if(M(e.rawModel)===n||M(await F(e.serial,e.rawModel))===n)return e.serial}async function ae(e){try{return(await P(e)).stdout.trim()===`1`}catch{return!1}}async function oe(e){await d();let n=e.avdName.trim();if(!n)throw new t(`INVALID_ARGS`,`Android emulator boot requires a non-empty AVD name.`);let i=e.timeoutMs??12e4;if(!await l(`adb`))throw new t(`TOOL_MISSING`,`adb not found in PATH`);if(!await l(`emulator`))throw new t(`TOOL_MISSING`,`emulator not found in PATH`);let a=await Y(),o=J(a,n);if(!o)throw new t(`DEVICE_NOT_FOUND`,`No Android emulator AVD named ${e.avdName}`,{requestedAvdName:n,availableAvds:a,hint:"Run `emulator -list-avds` and pass an existing AVD name to --device."});let s=Date.now(),c=ne(await W(),o,e.serial),u=c&&j(c.id)?c:void 0;if(!u){let t=[`-avd`,o];e.headless&&t.push(`-no-window`,`-no-audio`),r(`emulator`,t)}let f=u??await re({avdName:o,serial:e.serial,timeoutMs:i}),p=Date.now()-s,m=Math.max(1e3,i-p);await Q(f.id,m);let h=(await W()).find(e=>e.id===f.id);return h?{...h,name:o,booted:!0}:{...f,name:o,booted:!0}}async function Q(e,r=6e4){let i=r,a=ee.fromTimeoutMs(i),o=Math.min(1e3,Math.max(50,Math.floor(i/20))),s=Math.max(1,Math.ceil(i/o)),c,l=!1;try{await g(async({deadline:n})=>{if(n?.isExpired())throw l=!0,new t(`COMMAND_FAILED`,`Android boot deadline exceeded`,{serial:e,timeoutMs:r,elapsedMs:a.elapsedMs(),message:`timeout`});let o=Math.max(1e3,n?.remainingMs()??i),s=await P(e,Math.min(o,E));if(c=s,s.stdout.trim()!==`1`)throw new t(`COMMAND_FAILED`,`Android device is still booting`,{serial:e,stdout:s.stdout,stderr:s.stderr,exitCode:s.exitCode})},{maxAttempts:s,baseDelayMs:o,maxDelayMs:o,jitter:0,shouldRetry:e=>{let t=_({error:e,stdout:c?.stdout,stderr:c?.stderr,context:{platform:`android`,phase:`boot`}});return t!==`ADB_TRANSPORT_UNAVAILABLE`&&t!==`ANDROID_BOOT_TIMEOUT`}},{deadline:a,phase:`boot`,classifyReason:e=>_({error:e,stdout:c?.stdout,stderr:c?.stderr,context:{platform:`android`,phase:`boot`}})})}catch(r){let o=n(r),s=c?.stdout,u=c?.stderr,d=c?.exitCode,f=_({error:r,stdout:s,stderr:u,context:{platform:`android`,phase:`boot`}});f===`BOOT_COMMAND_FAILED`&&o.message===`Android device is still booting`&&(f=`ANDROID_BOOT_TIMEOUT`);let p={serial:e,timeoutMs:i,elapsedMs:a.elapsedMs(),reason:f,hint:v(f),stdout:s,stderr:u,exitCode:d};throw l||f===`ANDROID_BOOT_TIMEOUT`?new t(`COMMAND_FAILED`,`Android device did not finish booting in time`,p):o.code===`TOOL_MISSING`?new t(`TOOL_MISSING`,o.message,{...p,...o.details??{}}):f===`ADB_TRANSPORT_UNAVAILABLE`?new t(`COMMAND_FAILED`,o.message,{...p,...o.details??{}}):new t(o.code,o.message,{...p,...o.details??{}},o.cause)}}async function se(e,t,n){return await s(e)(t,n)}function ce(e){return{platform:`android`,id:e,name:e,kind:e.startsWith(`emulator-`)?`emulator`:`device`,booted:!0}}function le(e,t){let n=`${e}\n${t}`.toLowerCase();return n.includes(`no shell command implementation`)||n.includes(`unknown command`)}var ue=e({prepareAndroidInstallArtifact:()=>$});async function $(e,t){let n=e.kind===`url`&&p(e.url),r=await m({source:e,isInstallablePath:(e,t)=>t.isFile()&&de(e),installableLabel:`Android installable (.apk or .aab)`,allowArchiveExtraction:e.kind!==`url`||n,signal:t?.signal});try{let e=t?.resolveIdentity===!1?{}:await fe(r.installablePath);return{archivePath:r.archivePath,installablePath:r.installablePath,packageName:e.packageName,cleanup:r.cleanup}}catch(e){throw await r.cleanup(),e}}function de(e){let t=y.extname(e).toLowerCase();return t===`.apk`||t===`.aab`}async function fe(e){let t=y.extname(e).toLowerCase();return t!==`.apk`&&t!==`.aab`?{}:{packageName:await f(e)}}async function pe(e,t={}){let n=[`logcat`,`-d`,`-v`,`time`];t.lines!==void 0&&n.push(`-t`,String(Math.max(1,Math.floor(t.lines))));let r=await e(n,{allowFailure:!0,timeoutMs:t.timeoutMs,signal:t.signal});if(r.exitCode!==0)throw a(`Failed to capture Android logcat`,r);return r.stdout}function me(e,n={}){if(!e.spawn)throw new t(`UNSUPPORTED_OPERATION`,`Android ADB provider does not support streams`,{capability:`adb.spawn`});let r=[`logcat`,`-v`,`time`];n.pid&&r.push(`--pid`,n.pid);let i=e.spawn(r,{stdio:[`ignore`,`pipe`,`pipe`],signal:n.signal});return n.output&&i.stdout&&i.stdout.pipe(n.output,{end:!1}),i}export{ce as a,T as c,b as d,x as f,$ as i,Q as l,me as n,le as o,te as p,ue as r,se as s,pe as t,S as u};
+import{t as e}from"./rolldown-runtime.js";import{_ as t}from"./sdk-contracts.js";import{n}from"./sdk-android-adb.js";import"node:fs";var r=e({captureAndroidLogcatWithAdb:()=>i,streamAndroidLogcatWithAdb:()=>a});async function i(e,t={}){let r=[`logcat`,`-d`,`-v`,`time`];t.lines!==void 0&&r.push(`-t`,String(Math.max(1,Math.floor(t.lines))));let i=await e(r,{allowFailure:!0,timeoutMs:t.timeoutMs,signal:t.signal});if(i.exitCode!==0)throw n(`Failed to capture Android logcat`,i);return i.stdout}function a(e,n={}){if(!e.spawn)throw new t(`UNSUPPORTED_OPERATION`,`Android ADB provider does not support streams`,{capability:`adb.spawn`});let r=[`logcat`,`-v`,`time`];n.pid&&r.push(`--pid`,n.pid);let i=e.spawn(r,{stdio:[`ignore`,`pipe`,`pipe`],signal:n.signal});return n.output&&i.stdout&&i.stdout.pipe(n.output,{end:!1}),i}export{r as n,a as r,i as t};

package/dist/src/metro.d.ts

@@ -1,9 +1,39 @@
 import { v as SessionRuntimeHints } from "./sdk-contracts.js";
-import { t as MetroBridgeDescriptor } from "./metro-types.js";
+import { d as PrepareMetroRuntimeResult, f as ReloadMetroResult, o as MetroPrepareKind, p as MetroBridgeScope } from "./sdk-remote-config.js";
 //#region src/utils/url.d.ts
 declare function normalizeBaseUrl(input: string): string;
 declare function buildBundleUrl(baseUrl: string, platform: 'ios' | 'android', entryPath?: string): string;
 //#endregion
+//#region src/metro/metro-types.d.ts
+/** Re-export of {@link SessionRuntimeHints} under the Metro-specific alias used by public API consumers. */
+type MetroRuntimeHints = SessionRuntimeHints;
+type MetroBridgeRuntimePayload = {
+  metro_host?: string;
+  metro_port?: number;
+  metro_bundle_url?: string;
+  launch_url?: string;
+};
+type MetroBridgeDescriptor = {
+  enabled: boolean;
+  base_url: string;
+  status_url?: string;
+  bundle_url?: string;
+  ios_runtime: MetroBridgeRuntimePayload;
+  android_runtime: MetroBridgeRuntimePayload;
+  upstream: {
+    bundle_url?: string;
+    host?: string;
+    port?: number;
+    status_url?: string;
+  };
+  probe: {
+    reachable: boolean;
+    status_code: number;
+    latency_ms: number;
+    detail: string;
+  };
+};
+//#endregion
 //#region src/metro/metro.d.ts
 declare function resolveRuntimeTransport(runtime: SessionRuntimeHints | undefined): {
   host: string;
@@ -65,5 +95,44 @@ type MetroTunnelWebSocketCloseMessage = {
 };
 type MetroTunnelRequestMessage = MetroTunnelPingMessage | MetroTunnelHttpRequestMessage | MetroTunnelWebSocketOpenMessage | MetroTunnelWebSocketFrameMessage | MetroTunnelWebSocketCloseMessage;
 type MetroTunnelResponseMessage = MetroTunnelPongMessage | MetroTunnelHttpResponseMessage | MetroTunnelHttpErrorMessage | MetroTunnelWebSocketOpenResultMessage | MetroTunnelWebSocketFrameMessage | MetroTunnelWebSocketCloseMessage;
+type StopMetroTunnelOptions = {
+  projectRoot: string;
+  profileKey?: string;
+  consumerKey?: string;
+};
+declare function stopMetroTunnel(options: StopMetroTunnelOptions): Promise<void>;
+//#endregion
+//#region src/metro/client-metro.d.ts
+type EnvSource = NodeJS.ProcessEnv | Record<string, string | undefined>;
+type PrepareMetroRuntimeOptions = {
+  projectRoot?: string;
+  kind?: MetroPrepareKind;
+  metroPort?: number | string;
+  listenHost?: string;
+  statusHost?: string;
+  publicBaseUrl?: string;
+  proxyBaseUrl?: string;
+  proxyBearerToken?: string;
+  bridgeScope?: MetroBridgeScope;
+  launchUrl?: string;
+  companionProfileKey?: string;
+  companionConsumerKey?: string;
+  startupTimeoutMs?: number | string;
+  probeTimeoutMs?: number | string;
+  reuseExisting?: boolean;
+  installDependenciesIfNeeded?: boolean;
+  runtimeFilePath?: string;
+  logPath?: string;
+  env?: EnvSource;
+};
+type ReloadMetroOptions = {
+  metroHost?: string;
+  metroPort?: number | string;
+  bundleUrl?: string;
+  runtime?: MetroRuntimeHints;
+  timeoutMs?: number | string;
+};
+declare function prepareMetroRuntime(input?: PrepareMetroRuntimeOptions): Promise<PrepareMetroRuntimeResult>;
+declare function reloadMetro(input?: ReloadMetroOptions): Promise<ReloadMetroResult>;
 //#endregion
-export { type MetroBridgeDescriptor, type MetroTunnelRequestMessage, type MetroTunnelResponseMessage, buildBundleUrl, normalizeBaseUrl, resolveRuntimeTransport };
+export { type MetroBridgeDescriptor, type MetroTunnelRequestMessage, type MetroTunnelResponseMessage, buildBundleUrl, normalizeBaseUrl, prepareMetroRuntime, reloadMetro, resolveRuntimeTransport, stopMetroTunnel };

package/dist/src/metro.js

@@ -1 +1 @@
-import{n as e,t}from"./url.js";import{t as n}from"./metro2.js";export{t as buildBundleUrl,e as normalizeBaseUrl,n as resolveRuntimeTransport};
+import{n as e,t}from"./url.js";import{n,t as r}from"./client-metro.js";import{n as i,t as a}from"./metro2.js";export{t as buildBundleUrl,e as normalizeBaseUrl,r as prepareMetroRuntime,n as reloadMetro,a as resolveRuntimeTransport,i as stopMetroTunnel};

package/dist/src/metro2.js

@@ -1 +1 @@
-import{n as e}from"./client-metro-companion.js";import{t}from"./runtime-transport.js";function n(e){return t(e)}async function r(t){await e(t)}export{r as n,n as t};
+import{r as e}from"./client-metro.js";import{t}from"./runtime-transport.js";function n(e){return t(e)}async function r(t){await e(t)}export{r as n,n as t};

package/dist/src/notifications.js

@@ -1 +1 @@
-import{_ as e}from"./sdk-contracts.js";import{s as t}from"./logcat.js";async function n(n,i,a){let o=typeof a.action==`string`&&a.action.trim()?a.action.trim():`${i}.TEST_PUSH`,s=[`shell`,`am`,`broadcast`,`-a`,o,`-p`,i],c=typeof a.receiver==`string`?a.receiver.trim():``;c&&s.push(`-n`,c);let l=a.extras;if(l!==void 0&&(typeof l!=`object`||!l||Array.isArray(l)))throw new e(`INVALID_ARGS`,`Android push payload extras must be an object`);let u=l??{},d=0;for(let[e,t]of Object.entries(u))e&&(r(s,e,t),d+=1);return await t(n,s),{action:o,extrasCount:d}}function r(t,n,r){if(typeof r==`string`){t.push(`--es`,n,r);return}if(typeof r==`boolean`){t.push(`--ez`,n,r?`true`:`false`);return}if(typeof r==`number`&&Number.isFinite(r)){if(Number.isInteger(r)){t.push(`--ei`,n,String(r));return}t.push(`--ef`,n,String(r));return}throw new e(`INVALID_ARGS`,`Unsupported Android broadcast extra type for "${n}". Use string, boolean, or number.`)}export{n as pushAndroidNotification};
+import{_ as e}from"./sdk-contracts.js";import{a as t}from"./install-artifact.js";async function n(n,i,a){let o=typeof a.action==`string`&&a.action.trim()?a.action.trim():`${i}.TEST_PUSH`,s=[`shell`,`am`,`broadcast`,`-a`,o,`-p`,i],c=typeof a.receiver==`string`?a.receiver.trim():``;c&&s.push(`-n`,c);let l=a.extras;if(l!==void 0&&(typeof l!=`object`||!l||Array.isArray(l)))throw new e(`INVALID_ARGS`,`Android push payload extras must be an object`);let u=l??{},d=0;for(let[e,t]of Object.entries(u))e&&(r(s,e,t),d+=1);return await t(n,s),{action:o,extrasCount:d}}function r(t,n,r){if(typeof r==`string`){t.push(`--es`,n,r);return}if(typeof r==`boolean`){t.push(`--ez`,n,r?`true`:`false`);return}if(typeof r==`number`&&Number.isFinite(r)){if(Number.isInteger(r)){t.push(`--ei`,n,String(r));return}t.push(`--ef`,n,String(r));return}throw new e(`INVALID_ARGS`,`Unsupported Android broadcast extra type for "${n}". Use string, boolean, or number.`)}export{n as pushAndroidNotification};