agent-device 0.21.19 → 0.21.21

package/dist/src/{scroll-command.d.ts → cloud-artifacts.d.ts}

@@ -1,5 +1,242 @@
-import { L as SnapshotQualityVerdict, P as SnapshotNode, R as SnapshotState, T as PublicPlatform, j as ScreenshotOverlayRef, n as DaemonArtifactType } from "./sdk-contracts.js";
-import { _ as SettleObservation } from "./sdk-selectors.js";
+import { B as SnapshotViewportSize, L as SnapshotQualityVerdict, P as SnapshotNode, R as SnapshotState, T as PublicPlatform, j as ScreenshotOverlayRef, n as DaemonArtifactType } from "./sdk-contracts.js";
+import { v as SettleObservation } from "./sdk-selectors.js";
+//#region packages/contracts/src/back-mode.d.ts
+declare const BACK_MODES: readonly ['in-app', 'system'];
+type BackMode = (typeof BACK_MODES)[number];
+//#endregion
+//#region packages/contracts/src/device-rotation.d.ts
+/** Single source of truth for the discriminator the Apple owner sets and the MCP schema advertises. */
+declare const FOLD_SCREEN_COORDINATE_SPACE: 'native-panel';
+type FoldScreenCoordinateSpace = typeof FOLD_SCREEN_COORDINATE_SPACE;
+declare const DEVICE_ROTATIONS: readonly ['portrait', 'portrait-upside-down', 'landscape-left', 'landscape-right'];
+type DeviceRotation = (typeof DEVICE_ROTATIONS)[number];
+/**
+ * The three hinge poses a foldable Apple device can be put in, named after what an agent sees
+ * rather than after Apple's `UIHinge.Status` cases: `closed` lights the outer panel only,
+ * `half-open` and `open` light the inner panel. Device Hub calls them Closed, Book, and Open;
+ * `UIHinge.Status` calls them `.closed`, `.partiallyOpen`, and `.fullyOpen`.
+ */
+declare const FOLD_POSES: readonly ['closed', 'half-open', 'open'];
+type FoldPose = (typeof FOLD_POSES)[number];
+type FoldKeyframe = Readonly<{
+  atMs: number;
+  angle: number;
+}>;
+type SetFoldPoseInput = Readonly<{
+  pose: FoldPose;
+  keyframes?: never;
+}> | Readonly<{
+  keyframes: readonly FoldKeyframe[];
+  pose?: never;
+}>;
+//#endregion
+//#region packages/contracts/src/scroll-gesture.d.ts
+declare const SCROLL_INPUT_DIRECTIONS: readonly ['up', 'down', 'left', 'right', 'top', 'bottom'];
+type ScrollInputDirection = (typeof SCROLL_INPUT_DIRECTIONS)[number];
+declare const SCROLL_DIRECTIONS: readonly ['up', 'down', 'left', 'right'];
+type ScrollDirection = (typeof SCROLL_DIRECTIONS)[number];
+declare const SWIPE_PRESETS: readonly ['left', 'right', 'left-edge', 'right-edge'];
+type SwipePreset = (typeof SWIPE_PRESETS)[number];
+declare const SWIPE_PATTERNS: readonly ['one-way', 'ping-pong'];
+type SwipePattern = (typeof SWIPE_PATTERNS)[number];
+type TransformGestureParams = {
+  x: number;
+  y: number;
+  dx: number;
+  dy: number;
+  scale: number;
+  degrees: number;
+  durationMs?: number;
+};
+//#endregion
+//#region packages/contracts/src/scroll-command.d.ts
+type ScrollReleaseBehavior = 'controlled' | 'inertial';
+/**
+ * What a directional scroll actually SAW after its gesture, which is the only evidence that can
+ * back the distance the same response reports (#2714).
+ *
+ * - `'moved'`: the post-gesture surface differs from the pre-gesture one, so content did move.
+ * - `'at-edge'`: the surface is identical and the resolved container names no hidden content in
+ *   that direction — the scroll was a legitimate no-op at the end of the content.
+ * - `'unchanged'`: the surface is identical and the direction has no end-of-content signal to read
+ *   (a horizontal scroll: the hidden-content analyzer only covers the vertical axis), so the
+ *   response says what it measured without guessing which of the two it was.
+ * - `'unobserved'`: nothing comparable was available, so the distance rests on the gesture plan
+ *   alone. Callers that need the effect confirmed ask for a capture or a `--settle` observation.
+ *
+ * A directional scroll that measures an unchanged surface WITH hidden content still in that
+ * direction does not answer at all: it fails with `scroll_no_progress`.
+ */
+type ScrollMovementObservation = 'moved' | 'at-edge' | 'unchanged' | 'unobserved';
+type ScrollDistanceOptions = {
+  amount?: number;
+  pixels?: number;
+};
+type ScrollTimingOptions = {
+  durationMs?: number;
+};
+type ScrollCommandOptions = ScrollDistanceOptions & ScrollTimingOptions;
+type ScrollExecutionOptions = ScrollCommandOptions & {
+  releaseBehavior?: ScrollReleaseBehavior;
+};
+/**
+ * `scroll` — the generic-route result built by `buildDispatchedScrollResult`
+ * (src/core/dispatch-scroll.ts): the resolved direction, the edge-pass
+ * bookkeeping for `top`/`bottom` scrolls, the honored distance/timing echo,
+ * and the success message. Platform leaves add gesture-plan coordinates
+ * (`x1`/`y1`/`x2`/`y2`, reference frame) on top; the output schema stays
+ * non-strict so those additive fields validate. The one field the dispatcher
+ * itself may add: `settle`, the opt-in `--settle` observation (#1638),
+ * attached after the command — same shape as `BackCommandResult`.
+ */
+type ScrollCommandResult = {
+  direction: ScrollDirection;
+  /** Set for `top`/`bottom` requests: the extreme being scrolled to. */
+  edge?: 'top' | 'bottom';
+  /** Set for `--until` requests: the selector the passes stopped on. */
+  until?: string;
+  /** Edge and until scrolls only: how many scroll-and-check passes ran. */
+  passes?: number;
+  amount?: number;
+  pixels?: number;
+  durationMs?: number;
+  message?: string;
+  settle?: SettleObservation;
+  /**
+   * The observation that gated this response's distance claim. See
+   * {@link ScrollMovementObservation}: `scroll` answers with what it measured after the gesture,
+   * and only `'moved'` and `'at-edge'` confirm the surface's fate. Absent on the tiers that verify
+   * per pass instead of per gesture (`scroll top`/`bottom` and `--until`), and on platforms whose
+   * scroll owner never dispatches a swipe (the Linux wheel).
+   */
+  movement?: ScrollMovementObservation;
+  /**
+   * Set only when an on-screen keyboard made the owner clip the swipe into the band above it
+   * (#2500). Absent means the swipe was not clipped, which is not the same claim as `false`: a
+   * platform that never runs the clip has nothing to report. The platform leaf's `referenceHeight`
+   * names the shortened axis the reported `pixels` were planned against, and `keyboardMinY` names
+   * where the keyboard began. A surface the owner refused to swipe at all fails instead, under the
+   * `scroll_keyboard_occludes_surface` reason.
+   */
+  keyboardAvoided?: true;
+  /** The keyboard's edge in the same unit as the gesture coordinates, when the swipe was clipped. */
+  keyboardMinY?: number;
+};
+//#endregion
+//#region packages/contracts/src/tv-remote.d.ts
+declare const TV_REMOTE_BUTTON_DEFINITIONS: {
+  readonly up: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_DPAD_UP';
+    readonly appleRemoteButton: 'up';
+    readonly vegaKey: 'KEY_UP';
+  };
+  readonly down: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_DPAD_DOWN';
+    readonly appleRemoteButton: 'down';
+    readonly vegaKey: 'KEY_DOWN';
+  };
+  readonly left: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_DPAD_LEFT';
+    readonly appleRemoteButton: 'left';
+    readonly vegaKey: 'KEY_LEFT';
+  };
+  readonly right: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_DPAD_RIGHT';
+    readonly appleRemoteButton: 'right';
+    readonly vegaKey: 'KEY_RIGHT';
+  };
+  readonly select: {
+    readonly aliases: readonly ["ok", "center", "enter"];
+    readonly androidKeyevent: 'KEYCODE_DPAD_CENTER';
+    readonly appleRemoteButton: 'select';
+    readonly vegaKey: 'KEY_ENTER';
+  };
+  readonly menu: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_MENU';
+    readonly appleRemoteButton: 'menu';
+    readonly vegaKey: 'KEY_MENU';
+  };
+  readonly home: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_HOME';
+    readonly appleRemoteButton: 'home';
+    readonly vegaKey: 'KEY_HOMEPAGE';
+  };
+  readonly back: {
+    readonly aliases: readonly [];
+    readonly androidKeyevent: 'KEYCODE_BACK';
+    readonly appleRemoteButton: 'menu';
+    readonly vegaKey: 'KEY_BACK';
+  };
+};
+declare const TV_REMOTE_BUTTONS: (keyof typeof TV_REMOTE_BUTTON_DEFINITIONS)[];
+type TvRemoteButton = (typeof TV_REMOTE_BUTTONS)[number];
+//#endregion
+//#region packages/contracts/src/settings.d.ts
+/**
+ * The `settings permission` vocabulary, declared once. These collections are what the parsers
+ * below, the public client permission types, the CLI's membership sets, and the permission-name
+ * fragments of `settings` help and its invalid-args message are built from, and their order is
+ * the order `settings` help lists the names in.
+ *
+ * Acceptance is not support: each backend keeps its own target mapping and its own support check,
+ * so a name accepted here never promises that the selected platform serves it.
+ */
+declare const PERMISSION_ACTIONS: readonly ['grant', 'deny', 'reset'];
+declare const PERMISSION_MODES: readonly ['full', 'limited'];
+/** The app-scoped targets, the only ones `parsePermissionTarget` accepts. */
+declare const MOBILE_PERMISSION_TARGETS: readonly ['all', 'camera', 'microphone', 'photos', 'contacts', 'contacts-limited', 'notifications', 'calendar', 'location', 'location-always', 'media-library', 'motion', 'reminders', 'siri'];
+/** The desktop targets the CLI and the public client accept; `parsePermissionTarget` refuses them. */
+declare const MACOS_PERMISSION_TARGETS: readonly ['accessibility', 'screen-recording', 'input-monitoring'];
+type PermissionAction = (typeof PERMISSION_ACTIONS)[number];
+type PermissionMode = (typeof PERMISSION_MODES)[number];
+/**
+ * The preferred-text-size ladder `settings text-size` accepts, in the order `settings` help lists
+ * it. Apple serves it natively — `simctl ui <device> content_size` reads and writes exactly these
+ * names — and Android serves it through its `system font_scale` multiplier, so this ladder is the
+ * cross-platform vocabulary and each owner maps it in its own native terms. Acceptance is not
+ * support: an owner that cannot serve the ladder refuses at admission, on its own fact.
+ */
+declare const TEXT_SIZE_CATEGORIES: readonly ['extra-small', 'small', 'medium', 'large', 'extra-large', 'extra-extra-large', 'extra-extra-extra-large', 'accessibility-medium', 'accessibility-large', 'accessibility-extra-large', 'accessibility-extra-extra-large', 'accessibility-extra-extra-extra-large'];
+type TextSizeCategory = (typeof TEXT_SIZE_CATEGORIES)[number];
+/**
+ * The settings that answer a bare `settings <setting>` with the value the target holds. This is the
+ * vocabulary every settings type and every settings owner reads it from; the matching value is
+ * `READABLE_SETTINGS` in `platform-runtime-operations.ts`, where the CLI hub can evaluate it, and
+ * that module pins the two equal in both directions at compile time.
+ */
+type ReadableSetting = 'text-size';
+/**
+ * What `text-size` answers with. The ladder is shared across platforms, so a read names the
+ * category the ladder calls the device's value *and* the value the platform itself reported: an
+ * Apple content-size name, or an Android `font_scale` multiplier. The ladder is coarser than any
+ * one platform's own scale, and `platformValue` is what keeps a normalized answer auditable.
+ */
+type TextSizeSettingPayload = Readonly<{
+  setting: 'text-size';
+  category: TextSizeCategory;
+  platformValue: string;
+}>;
+/**
+ * The payload a readable setting answers with, keyed by the setting that answered. Each readable
+ * setting has its own shape — a category and a multiplier are not the same observation — so the
+ * discriminant is what lets a response be composed, recorded, and printed from one place without
+ * assuming every setting is a ladder rung. A second readable setting joins this union and supplies
+ * its own sentence in `describeSettingRead`, which is where the compiler then asks for it.
+ */
+type ReadSettingResult = TextSizeSettingPayload;
+type SettingOptions = {
+  permissionTarget?: string;
+  permissionMode?: string;
+  latitude?: number;
+  longitude?: number;
+};
+//#endregion
 //#region packages/contracts/src/session-surface.d.ts
 declare const SESSION_SURFACES: readonly ['app', 'frontmost-app', 'desktop', 'menubar'];
 type SessionSurface = (typeof SESSION_SURFACES)[number];
@@ -27,6 +264,8 @@ type ScreenshotResultData = {
   logicalWidth?: number;
   logicalHeight?: number;
   pixelDensity?: number;
+  /** Display rotation the capture was rendered in; absent when the target reports none. */
+  displayRotation?: DeviceRotation;
   overlayRefs?: ScreenshotOverlayRef[];
   warnings?: string[];
 };
@@ -38,6 +277,11 @@ type BackendSnapshotResult = {
   appName?: string;
   appBundleId?: string;
   snapshotDiagnostics?: SnapshotDiagnosticsSummary;
+  /**
+   * The box the node rects are measured in, as the producer measured it (#3182). Absent means the
+   * producer measured no box; see {@link SnapshotViewportSize} for what each producer measures.
+   */
+  viewport?: SnapshotViewportSize;
   analysis?: {
     rawNodeCount: number;
     maxDepth: number;
@@ -88,25 +332,6 @@ type AndroidSnapshotBackendMetadata = {
 };
 type FindLocator = 'any' | 'text' | 'label' | 'value' | 'role' | 'id';
 //#endregion
-//#region packages/contracts/src/scroll-gesture.d.ts
-declare const SCROLL_INPUT_DIRECTIONS: readonly ['up', 'down', 'left', 'right', 'top', 'bottom'];
-type ScrollInputDirection = (typeof SCROLL_INPUT_DIRECTIONS)[number];
-declare const SCROLL_DIRECTIONS: readonly ['up', 'down', 'left', 'right'];
-type ScrollDirection = (typeof SCROLL_DIRECTIONS)[number];
-declare const SWIPE_PRESETS: readonly ['left', 'right', 'left-edge', 'right-edge'];
-type SwipePreset = (typeof SWIPE_PRESETS)[number];
-declare const SWIPE_PATTERNS: readonly ['one-way', 'ping-pong'];
-type SwipePattern = (typeof SWIPE_PATTERNS)[number];
-type TransformGestureParams = {
-  x: number;
-  y: number;
-  dx: number;
-  dy: number;
-  scale: number;
-  degrees: number;
-  durationMs?: number;
-};
-//#endregion
 //#region packages/contracts/src/cloud-artifacts.d.ts
 declare const CLOUD_ARTIFACT_KINDS: readonly ['video', 'appium-log', 'device-log', 'automation-log', 'provider-session', 'raw'];
 type CloudArtifactKind = (typeof CLOUD_ARTIFACT_KINDS)[number];
@@ -139,6 +364,8 @@ type DaemonArtifactInventoryEntry = {
   sizeBytes: number;
   createdAt: string;
   expiresAt: string;
+  /** Display rotation a screenshot was rendered in; absent when the capture reported none. */
+  displayRotation?: DeviceRotation;
 };
 type DaemonArtifactsResult = {
   source: 'daemon';
@@ -166,222 +393,4 @@ type CloudArtifactProvider = {
   listCloudArtifacts?: (query: CloudArtifactsQuery) => Promise<CloudArtifactsResult | undefined>;
 };
 //#endregion
-//#region packages/contracts/src/settings.d.ts
-/**
- * The `settings permission` vocabulary, declared once. These collections are what the parsers
- * below, the public client permission types, the CLI's membership sets, and the permission-name
- * fragments of `settings` help and its invalid-args message are built from, and their order is
- * the order `settings` help lists the names in.
- *
- * Acceptance is not support: each backend keeps its own target mapping and its own support check,
- * so a name accepted here never promises that the selected platform serves it.
- */
-declare const PERMISSION_ACTIONS: readonly ['grant', 'deny', 'reset'];
-declare const PERMISSION_MODES: readonly ['full', 'limited'];
-/** The app-scoped targets, the only ones `parsePermissionTarget` accepts. */
-declare const MOBILE_PERMISSION_TARGETS: readonly ['all', 'camera', 'microphone', 'photos', 'contacts', 'contacts-limited', 'notifications', 'calendar', 'location', 'location-always', 'media-library', 'motion', 'reminders', 'siri'];
-/** The desktop targets the CLI and the public client accept; `parsePermissionTarget` refuses them. */
-declare const MACOS_PERMISSION_TARGETS: readonly ['accessibility', 'screen-recording', 'input-monitoring'];
-type PermissionAction = (typeof PERMISSION_ACTIONS)[number];
-type PermissionMode = (typeof PERMISSION_MODES)[number];
-/**
- * The preferred-text-size ladder `settings text-size` accepts, in the order `settings` help lists
- * it. Apple serves it natively — `simctl ui <device> content_size` reads and writes exactly these
- * names — and Android serves it through its `system font_scale` multiplier, so this ladder is the
- * cross-platform vocabulary and each owner maps it in its own native terms. Acceptance is not
- * support: an owner that cannot serve the ladder refuses at admission, on its own fact.
- */
-declare const TEXT_SIZE_CATEGORIES: readonly ['extra-small', 'small', 'medium', 'large', 'extra-large', 'extra-extra-large', 'extra-extra-extra-large', 'accessibility-medium', 'accessibility-large', 'accessibility-extra-large', 'accessibility-extra-extra-large', 'accessibility-extra-extra-extra-large'];
-type TextSizeCategory = (typeof TEXT_SIZE_CATEGORIES)[number];
-/**
- * The settings that answer a bare `settings <setting>` with the value the target holds. This is the
- * vocabulary every settings type and every settings owner reads it from; the matching value is
- * `READABLE_SETTINGS` in `platform-runtime-operations.ts`, where the CLI hub can evaluate it, and
- * that module pins the two equal in both directions at compile time.
- */
-type ReadableSetting = 'text-size';
-/**
- * What `text-size` answers with. The ladder is shared across platforms, so a read names the
- * category the ladder calls the device's value *and* the value the platform itself reported: an
- * Apple content-size name, or an Android `font_scale` multiplier. The ladder is coarser than any
- * one platform's own scale, and `platformValue` is what keeps a normalized answer auditable.
- */
-type TextSizeSettingPayload = Readonly<{
-  setting: 'text-size';
-  category: TextSizeCategory;
-  platformValue: string;
-}>;
-/**
- * The payload a readable setting answers with, keyed by the setting that answered. Each readable
- * setting has its own shape — a category and a multiplier are not the same observation — so the
- * discriminant is what lets a response be composed, recorded, and printed from one place without
- * assuming every setting is a ladder rung. A second readable setting joins this union and supplies
- * its own sentence in `describeSettingRead`, which is where the compiler then asks for it.
- */
-type ReadSettingResult = TextSizeSettingPayload;
-type SettingOptions = {
-  permissionTarget?: string;
-  permissionMode?: string;
-  latitude?: number;
-  longitude?: number;
-};
-//#endregion
-//#region packages/contracts/src/back-mode.d.ts
-declare const BACK_MODES: readonly ['in-app', 'system'];
-type BackMode = (typeof BACK_MODES)[number];
-//#endregion
-//#region packages/contracts/src/device-rotation.d.ts
-/** Single source of truth for the discriminator the Apple owner sets and the MCP schema advertises. */
-declare const FOLD_SCREEN_COORDINATE_SPACE: 'native-panel';
-type FoldScreenCoordinateSpace = typeof FOLD_SCREEN_COORDINATE_SPACE;
-declare const DEVICE_ROTATIONS: readonly ['portrait', 'portrait-upside-down', 'landscape-left', 'landscape-right'];
-type DeviceRotation = (typeof DEVICE_ROTATIONS)[number];
-/**
- * The three hinge poses a foldable Apple device can be put in, named after what an agent sees
- * rather than after Apple's `UIHinge.Status` cases: `closed` lights the outer panel only,
- * `half-open` and `open` light the inner panel. Device Hub calls them Closed, Book, and Open;
- * `UIHinge.Status` calls them `.closed`, `.partiallyOpen`, and `.fullyOpen`.
- */
-declare const FOLD_POSES: readonly ['closed', 'half-open', 'open'];
-type FoldPose = (typeof FOLD_POSES)[number];
-type FoldKeyframe = Readonly<{
-  atMs: number;
-  angle: number;
-}>;
-type SetFoldPoseInput = Readonly<{
-  pose: FoldPose;
-  keyframes?: never;
-}> | Readonly<{
-  keyframes: readonly FoldKeyframe[];
-  pose?: never;
-}>;
-//#endregion
-//#region packages/contracts/src/tv-remote.d.ts
-declare const TV_REMOTE_BUTTON_DEFINITIONS: {
-  readonly up: {
-    readonly aliases: readonly [];
-    readonly androidKeyevent: 'KEYCODE_DPAD_UP';
-    readonly appleRemoteButton: 'up';
-    readonly vegaKey: 'KEY_UP';
-  };
-  readonly down: {
-    readonly aliases: readonly [];
-    readonly androidKeyevent: 'KEYCODE_DPAD_DOWN';
-    readonly appleRemoteButton: 'down';
-    readonly vegaKey: 'KEY_DOWN';
-  };
-  readonly left: {
-    readonly aliases: readonly [];
-    readonly androidKeyevent: 'KEYCODE_DPAD_LEFT';
-    readonly appleRemoteButton: 'left';
-    readonly vegaKey: 'KEY_LEFT';
-  };
-  readonly right: {
-    readonly aliases: readonly [];
-    readonly androidKeyevent: 'KEYCODE_DPAD_RIGHT';
-    readonly appleRemoteButton: 'right';
-    readonly vegaKey: 'KEY_RIGHT';
-  };
-  readonly select: {
-    readonly aliases: readonly ["ok", "center", "enter"];
-    readonly androidKeyevent: 'KEYCODE_DPAD_CENTER';
-    readonly appleRemoteButton: 'select';
-    readonly vegaKey: 'KEY_ENTER';
-  };
-  readonly menu: {
-    readonly aliases: readonly [];
-    readonly androidKeyevent: 'KEYCODE_MENU';
-    readonly appleRemoteButton: 'menu';
-    readonly vegaKey: 'KEY_MENU';
-  };
-  readonly home: {
-    readonly aliases: readonly [];
-    readonly androidKeyevent: 'KEYCODE_HOME';
-    readonly appleRemoteButton: 'home';
-    readonly vegaKey: 'KEY_HOMEPAGE';
-  };
-  readonly back: {
-    readonly aliases: readonly [];
-    readonly androidKeyevent: 'KEYCODE_BACK';
-    readonly appleRemoteButton: 'menu';
-    readonly vegaKey: 'KEY_BACK';
-  };
-};
-declare const TV_REMOTE_BUTTONS: (keyof typeof TV_REMOTE_BUTTON_DEFINITIONS)[];
-type TvRemoteButton = (typeof TV_REMOTE_BUTTONS)[number];
-//#endregion
-//#region packages/contracts/src/scroll-command.d.ts
-type ScrollReleaseBehavior = 'controlled' | 'inertial';
-/**
- * What a directional scroll actually SAW after its gesture, which is the only evidence that can
- * back the distance the same response reports (#2714).
- *
- * - `'moved'`: the post-gesture surface differs from the pre-gesture one, so content did move.
- * - `'at-edge'`: the surface is identical and the resolved container names no hidden content in
- *   that direction — the scroll was a legitimate no-op at the end of the content.
- * - `'unchanged'`: the surface is identical and the direction has no end-of-content signal to read
- *   (a horizontal scroll: the hidden-content analyzer only covers the vertical axis), so the
- *   response says what it measured without guessing which of the two it was.
- * - `'unobserved'`: nothing comparable was available, so the distance rests on the gesture plan
- *   alone. Callers that need the effect confirmed ask for a capture or a `--settle` observation.
- *
- * A directional scroll that measures an unchanged surface WITH hidden content still in that
- * direction does not answer at all: it fails with `scroll_no_progress`.
- */
-type ScrollMovementObservation = 'moved' | 'at-edge' | 'unchanged' | 'unobserved';
-type ScrollDistanceOptions = {
-  amount?: number;
-  pixels?: number;
-};
-type ScrollTimingOptions = {
-  durationMs?: number;
-};
-type ScrollCommandOptions = ScrollDistanceOptions & ScrollTimingOptions;
-type ScrollExecutionOptions = ScrollCommandOptions & {
-  releaseBehavior?: ScrollReleaseBehavior;
-};
-/**
- * `scroll` — the generic-route result built by `buildDispatchedScrollResult`
- * (src/core/dispatch-scroll.ts): the resolved direction, the edge-pass
- * bookkeeping for `top`/`bottom` scrolls, the honored distance/timing echo,
- * and the success message. Platform leaves add gesture-plan coordinates
- * (`x1`/`y1`/`x2`/`y2`, reference frame) on top; the output schema stays
- * non-strict so those additive fields validate. The one field the dispatcher
- * itself may add: `settle`, the opt-in `--settle` observation (#1638),
- * attached after the command — same shape as `BackCommandResult`.
- */
-type ScrollCommandResult = {
-  direction: ScrollDirection;
-  /** Set for `top`/`bottom` requests: the extreme being scrolled to. */
-  edge?: 'top' | 'bottom';
-  /** Set for `--until` requests: the selector the passes stopped on. */
-  until?: string;
-  /** Edge and until scrolls only: how many scroll-and-check passes ran. */
-  passes?: number;
-  amount?: number;
-  pixels?: number;
-  durationMs?: number;
-  message?: string;
-  settle?: SettleObservation;
-  /**
-   * The observation that gated this response's distance claim. See
-   * {@link ScrollMovementObservation}: `scroll` answers with what it measured after the gesture,
-   * and only `'moved'` and `'at-edge'` confirm the surface's fate. Absent on the tiers that verify
-   * per pass instead of per gesture (`scroll top`/`bottom` and `--until`), and on platforms whose
-   * scroll owner never dispatches a swipe (the Linux wheel).
-   */
-  movement?: ScrollMovementObservation;
-  /**
-   * Set only when an on-screen keyboard made the owner clip the swipe into the band above it
-   * (#2500). Absent means the swipe was not clipped, which is not the same claim as `false`: a
-   * platform that never runs the clip has nothing to report. The platform leaf's `referenceHeight`
-   * names the shortened axis the reported `pixels` were planned against, and `keyboardMinY` names
-   * where the keyboard began. A surface the owner refused to swipe at all fails instead, under the
-   * `scroll_keyboard_occludes_surface` reason.
-   */
-  keyboardAvoided?: true;
-  /** The keyboard's edge in the same unit as the gesture coordinates, when the swipe was clipped. */
-  keyboardMinY?: number;
-};
-//#endregion
-export { SessionSurface as A, SwipePreset as C, FindLocator as D, BackendSnapshotResult as E, ScreenshotResultData as O, SwipePattern as S, AndroidSnapshotBackendMetadata as T, AgentArtifactsResult as _, FoldPose as a, ScrollDirection as b, BackMode as c, PermissionAction as d, PermissionMode as f, TextSizeCategory as g, SettingOptions as h, DeviceRotation as i, SnapshotDiagnosticsSummary as k, MACOS_PERMISSION_TARGETS as l, ReadableSetting as m, ScrollExecutionOptions as n, FoldScreenCoordinateSpace as o, ReadSettingResult as p, TvRemoteButton as r, SetFoldPoseInput as s, ScrollCommandResult as t, MOBILE_PERMISSION_TARGETS as u, CloudArtifactProvider as v, TransformGestureParams as w, ScrollInputDirection as x, CloudProviderSessionResult as y };
+export { BackMode as A, SwipePattern as C, FoldPose as D, DeviceRotation as E, FoldScreenCoordinateSpace as O, ScrollInputDirection as S, TransformGestureParams as T, TextSizeCategory as _, BackendSnapshotResult as a, ScrollExecutionOptions as b, SnapshotDiagnosticsSummary as c, MOBILE_PERMISSION_TARGETS as d, PermissionAction as f, SettingOptions as g, ReadableSetting as h, AndroidSnapshotBackendMetadata as i, SetFoldPoseInput as k, SessionSurface as l, ReadSettingResult as m, CloudArtifactProvider as n, FindLocator as o, PermissionMode as p, CloudProviderSessionResult as r, ScreenshotResultData as s, AgentArtifactsResult as t, MACOS_PERMISSION_TARGETS as u, TvRemoteButton as v, SwipePreset as w, ScrollDirection as x, ScrollCommandResult as y };

package/dist/src/code-signature-cache.js

@@ -1 +1 @@
-import{k as e}from"./owner-identity.js";import"./file.js";import{a as t,r as n,s as r,t as i}from"./code-signature.js";import a from"node:path";import o from"node:fs";import s from"node:crypto";import c from"node:os";function l(e,a){let o=t(a),s=t(e),c=v(s,o),l=i(o,s),d=u(c,o,l);if(d)return n(d.files);let p;try{p=r(s,o)}catch{return`unknown`}return f(p.files,l)&&_(c,p),n(p.files)}function u(e,t,n){let r=p(e);if(!(!r||!f(r.files,n))){for(let[e,n,i]of r.files){let r=d(a.resolve(t,e));if(!r?.isFile()||r.size!==n||Math.trunc(r.mtimeMs)!==i)return}for(let e of r.absentPaths)if(d(a.resolve(t,e))?.isFile())return;return r}}function d(e){try{return o.statSync(e)}catch{return}}function f(e,t){return e.some(([e])=>e===t)}function p(e){let t=m(e);if(!t)return;let n=[];for(let e of t.files){let t=g(e);if(!t)return;n.push(t)}if(t.absent.every(e=>typeof e==`string`))return{files:n,absentPaths:t.absent}}function m(e){let t=h(e);if(t===void 0)return;let n;try{n=JSON.parse(t)}catch{return}if(!n||typeof n!=`object`)return;let r=n;if(r.version===2&&!(!Array.isArray(r.files)||!Array.isArray(r.absent)))return{files:r.files,absent:r.absent}}function h(e){let t;try{t=o.openSync(e,`r`)}catch{return}try{let e=process.getuid?.();return e!==void 0&&o.fstatSync(t).uid!==e?void 0:o.readFileSync(t,`utf8`)}catch{return}finally{o.closeSync(t)}}function g(e){if(!Array.isArray(e)||e.length!==3)return;let[t,n,r]=e;if(typeof t==`string`&&typeof n==`number`&&typeof r==`number`)return[t,n,r]}function _(t,n){let r={version:2,files:[...n.files],absent:[...n.absentPaths]};try{o.mkdirSync(a.dirname(t),{recursive:!0,mode:448}),e({destination:t,contents:JSON.stringify(r),mode:384})}catch{}}function v(e,t){let n=s.createHash(`sha1`).update(`${t} ${e}`).digest(`hex`),r=`agent-device-code-signature-${process.getuid?.()??`user`}`;return a.join(c.tmpdir(),r,`${n}.json`)}export{l as resolveCachedDaemonCodeSignature};
+import{A as e}from"./owner-identity.js";import"./file.js";import{a as t,r as n,s as r,t as i}from"./code-signature.js";import a from"node:crypto";import o from"node:fs";import s from"node:os";import c from"node:path";function l(e,a){let o=t(a),s=t(e),c=v(s,o),l=i(o,s),d=u(c,o,l);if(d)return n(d.files);let p;try{p=r(s,o)}catch{return`unknown`}return f(p.files,l)&&_(c,p),n(p.files)}function u(e,t,n){let r=p(e);if(!(!r||!f(r.files,n))){for(let[e,n,i]of r.files){let r=d(c.resolve(t,e));if(!r?.isFile()||r.size!==n||Math.trunc(r.mtimeMs)!==i)return}for(let e of r.absentPaths)if(d(c.resolve(t,e))?.isFile())return;return r}}function d(e){try{return o.statSync(e)}catch{return}}function f(e,t){return e.some(([e])=>e===t)}function p(e){let t=m(e);if(!t)return;let n=[];for(let e of t.files){let t=g(e);if(!t)return;n.push(t)}if(t.absent.every(e=>typeof e==`string`))return{files:n,absentPaths:t.absent}}function m(e){let t=h(e);if(t===void 0)return;let n;try{n=JSON.parse(t)}catch{return}if(!n||typeof n!=`object`)return;let r=n;if(r.version===2&&!(!Array.isArray(r.files)||!Array.isArray(r.absent)))return{files:r.files,absent:r.absent}}function h(e){let t;try{t=o.openSync(e,`r`)}catch{return}try{let e=process.getuid?.();return e!==void 0&&o.fstatSync(t).uid!==e?void 0:o.readFileSync(t,`utf8`)}catch{return}finally{o.closeSync(t)}}function g(e){if(!Array.isArray(e)||e.length!==3)return;let[t,n,r]=e;if(typeof t==`string`&&typeof n==`number`&&typeof r==`number`)return[t,n,r]}function _(t,n){let r={version:2,files:[...n.files],absent:[...n.absentPaths]};try{o.mkdirSync(c.dirname(t),{recursive:!0,mode:448}),e({destination:t,contents:JSON.stringify(r),mode:384})}catch{}}function v(e,t){let n=a.createHash(`sha1`).update(`${t} ${e}`).digest(`hex`),r=`agent-device-code-signature-${process.getuid?.()??`user`}`;return c.join(s.tmpdir(),r,`${n}.json`)}export{l as resolveCachedDaemonCodeSignature};

package/dist/src/code-signature.js

@@ -1 +1 @@
-import{r as e,s as t}from"./version.js";import n from"node:path";import r from"node:fs";import i from"node:crypto";const a=/(['"])(\.\.?\/[^'"]*)\1/g,o=/(['"])(@[^'"/\s]+\/[^'"\s]+)\1/g,s=[`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`];function c(){let e=process.argv[1];return e?u(e):`unknown`}function l(n=e()){return t(n)?`checkout`:`installed`}function u(t,n=e()){try{return g(d(t,n).files)}catch{return`unknown`}}function d(e,t){let n=h(t),i=[h(e)],a=new Set,o=[],s=new Set,c={root:n,packages:new Map,absentPaths:s,stamp:e=>{if(a.has(e))return!1;a.add(e);let t=r.statSync(e);if(!t.isFile())return!1;let i=m(n,e);return o.push([i,t.size,Math.trunc(t.mtimeMs)]),!0},follow:e=>{for(let t of e.missedCandidates)s.add(m(n,t));e.filePath&&i.push(e.filePath)}};for(;i.length>0;){let e=i.pop();if(e===void 0||a.has(e)||!c.stamp(e))continue;let t=r.readFileSync(e,`utf8`);for(let n of _(t))c.follow(w(e,n));f(t,c)}return{files:o,absentPaths:[...s]}}function f(e,t){for(let n of v(e)){let{name:e,subpath:r}=y(n),i=p(e,t);if(!i)continue;let a=S(i.manifest,r);a!==void 0&&t.follow(w(i.manifestPath,a))}}function p(e,t){let n=t.packages.get(e);if(n!==void 0)return n;let r=b(t.root,e,t.absentPaths);return t.packages.set(e,r),r&&t.stamp(r.manifestPath),r}function m(e,t){let r=n.resolve(t);return n.relative(n.resolve(e),r)||r}function h(e){try{return r.realpathSync.native(e)}catch{return n.resolve(e)}}function g(e){let t=e.map(([e,t,n])=>`${e}:${t}:${n}`).sort().join(`|`),n=i.createHash(`sha1`).update(t).digest(`hex`);return`graph:${e.length}:${n}`}function _(e){let t=new Set;a.lastIndex=0;let n=null;for(;(n=a.exec(e))!==null;)t.add(n[2]);return[...t]}function v(e){let t=new Set;o.lastIndex=0;let n=null;for(;(n=o.exec(e))!==null;)t.add(n[2]);return[...t]}function y(e){let t=e.split(`/`),n=t.slice(2).join(`/`);return{name:t.slice(0,2).join(`/`),subpath:n?`./${n}`:`.`}}function b(e,t,i){let a=n.join(e,`node_modules`,t,`package.json`);if(!E(a))return i.add(m(e,a)),null;let o=h(a);if(x(e,o))return null;try{return{manifestPath:o,manifest:JSON.parse(r.readFileSync(o,`utf8`))}}catch{return null}}function x(e,t){let r=n.relative(n.join(e,`node_modules`),t);return r!==``&&!r.startsWith(`..`)&&!n.isAbsolute(r)}function S(e,t){if(!e||typeof e!=`object`)return;let n=e.exports;if(!n||typeof n!=`object`)return;let r=n[t],i=typeof r==`string`?r:C(r);return typeof i==`string`&&i.startsWith(`.`)?i:void 0}function C(e){if(!(!e||typeof e!=`object`))return e.default}function w(e,t){let r=n.resolve(n.dirname(e),t),i=[];for(let e of T(r)){if(E(e))return{filePath:e,missedCandidates:i};i.push(e)}return{filePath:null,missedCandidates:i}}function*T(e){yield e;for(let t of s)yield`${e}${t}`;for(let t of s)yield n.join(e,`index${t}`)}function E(e){try{return r.statSync(e).isFile()}catch{return!1}}export{h as a,l as i,u as n,c as o,g as r,d as s,m as t};
+import{r as e,s as t}from"./version.js";import n from"node:crypto";import r from"node:fs";import i from"node:path";const a=/(['"])(\.\.?\/[^'"]*)\1/g,o=/(['"])(@[^'"/\s]+\/[^'"\s]+)\1/g,s=[`.ts`,`.tsx`,`.js`,`.jsx`,`.mjs`,`.cjs`];function c(){let e=process.argv[1];return e?u(e):`unknown`}function l(n=e()){return t(n)?`checkout`:`installed`}function u(t,n=e()){try{return g(d(t,n).files)}catch{return`unknown`}}function d(e,t){let n=h(t),i=[h(e)],a=new Set,o=[],s=new Set,c={root:n,packages:new Map,absentPaths:s,stamp:e=>{if(a.has(e))return!1;a.add(e);let t=r.statSync(e);if(!t.isFile())return!1;let i=m(n,e);return o.push([i,t.size,Math.trunc(t.mtimeMs)]),!0},follow:e=>{for(let t of e.missedCandidates)s.add(m(n,t));e.filePath&&i.push(e.filePath)}};for(;i.length>0;){let e=i.pop();if(e===void 0||a.has(e)||!c.stamp(e))continue;let t=r.readFileSync(e,`utf8`);for(let n of _(t))c.follow(w(e,n));f(t,c)}return{files:o,absentPaths:[...s]}}function f(e,t){for(let n of v(e)){let{name:e,subpath:r}=y(n),i=p(e,t);if(!i)continue;let a=S(i.manifest,r);a!==void 0&&t.follow(w(i.manifestPath,a))}}function p(e,t){let n=t.packages.get(e);if(n!==void 0)return n;let r=b(t.root,e,t.absentPaths);return t.packages.set(e,r),r&&t.stamp(r.manifestPath),r}function m(e,t){let n=i.resolve(t);return i.relative(i.resolve(e),n)||n}function h(e){try{return r.realpathSync.native(e)}catch{return i.resolve(e)}}function g(e){let t=e.map(([e,t,n])=>`${e}:${t}:${n}`).sort().join(`|`),r=n.createHash(`sha1`).update(t).digest(`hex`);return`graph:${e.length}:${r}`}function _(e){let t=new Set;a.lastIndex=0;let n=null;for(;(n=a.exec(e))!==null;)t.add(n[2]);return[...t]}function v(e){let t=new Set;o.lastIndex=0;let n=null;for(;(n=o.exec(e))!==null;)t.add(n[2]);return[...t]}function y(e){let t=e.split(`/`),n=t.slice(2).join(`/`);return{name:t.slice(0,2).join(`/`),subpath:n?`./${n}`:`.`}}function b(e,t,n){let a=i.join(e,`node_modules`,t,`package.json`);if(!E(a))return n.add(m(e,a)),null;let o=h(a);if(x(e,o))return null;try{return{manifestPath:o,manifest:JSON.parse(r.readFileSync(o,`utf8`))}}catch{return null}}function x(e,t){let n=i.relative(i.join(e,`node_modules`),t);return n!==``&&!n.startsWith(`..`)&&!i.isAbsolute(n)}function S(e,t){if(!e||typeof e!=`object`)return;let n=e.exports;if(!n||typeof n!=`object`)return;let r=n[t],i=typeof r==`string`?r:C(r);return typeof i==`string`&&i.startsWith(`.`)?i:void 0}function C(e){if(!(!e||typeof e!=`object`))return e.default}function w(e,t){let n=i.resolve(i.dirname(e),t),r=[];for(let e of T(n)){if(E(e))return{filePath:e,missedCandidates:r};r.push(e)}return{filePath:null,missedCandidates:r}}function*T(e){yield e;for(let t of s)yield`${e}${t}`;for(let t of s)yield i.join(e,`index${t}`)}function E(e){try{return r.statSync(e).isFile()}catch{return!1}}export{h as a,l as i,u as n,c as o,g as r,d as s,m as t};

package/dist/src/command-schema.js

@@ -1,4 +1,4 @@
-import{N as e}from"./sdk-contracts.js";import{r as t,w as n,x as r}from"./registry.js";import{r as i}from"./command-metadata.js";const a={cdp:{text:{summary:`Inspect CDP targets, JS heap, and leaks`,description:`Run CDP commands for React Native diagnostics, JS heap usage, heap snapshots, and leak analysis`},usageOverride:`cdp [...args]`,listUsageOverride:`cdp`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:r},auth:{text:{summary:`Manage cloud login state`,description:`Manage cloud login state used by remote daemon and cloud device workflows.`},usageOverride:`auth status|login|logout`,listUsageOverride:`auth`,positionalArgs:[`status|login|logout`],supportedFlags:[`remoteConfig`,`stateDir`]},daemon:{text:{summary:`Stop a local daemon and clean up resources`,description:`Stop a local daemon after verifying its PID/start-time identity. Use --clean to remove retained Apple runner processes and leases owned by that daemon.`},usageOverride:`daemon stop [--state-dir <path>]`,listUsageOverride:`daemon stop`,positionalArgs:[`stop`],allowedFlags:[`clean`],supportedFlags:[`stateDir`]},device:{text:{summary:`Inspect and recover enforced local device ownership without a daemon`,description:`Inspect enforced host-local device ownership claims without starting or contacting a daemon; status --stale only inspects proven-stale claims. release --stale settles a provably dead owner through exact-owner resource reconciliation and clears its claim last — live and uncertain owners always fail closed. Automatic reclamation still occurs during open and daemon startup.`},usageOverride:`device status|release [--platform <platform>] [--udid <udid>] [--serial <serial>]`,listUsageOverride:`device status`,positionalArgs:[`status|release`],allowedFlags:[`stale`],supportedFlags:[`platform`,`device`,`udid`,`serial`]},connect:{text:{summary:`Configure remote or provider state`,description:`Configure remote access without allocating a device. Direct providers validate credentials/resources before saving state and print the exact device/app preparation needed before open. AGENT_DEVICE_CLOUD_BASE_URL is the bridge/control-plane API origin; use AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_... for CI/service-token automation.`},usageOverride:`connect [cloud|proxy|limrun|browserstack|aws-device-farm] [--remote-config <path>] [--daemon-base-url <url>] [--tenant <id>] [--run-id <id>] [--lease-id <id>] [--lease-backend <backend>] [--force] [--no-login]`,usageFlags:[],listUsageOverride:`connect`,positionalArgs:[`provider?`],allowedFlags:`remoteConfig.daemonBaseUrl.tenant.runId.leaseId.leaseBackend.providerApp.providerOsVersion.providerProject.providerBuild.providerSessionName.providerDeviceOrientation.providerGeoLocation.providerTimezone.providerAppiumVersion.providerLanguage.providerLocale.providerNetworkProfile.providerCustomNetwork.providerNoResignApp.awsProjectArn.awsDeviceArn.awsAppArn.awsRegion.awsInteractionMode.force.noLogin`.split(`.`),supportedFlags:[`stateDir`,`daemonAuthToken`,`session`,`platform`,`device`,...n,`launchUrl`]},connection:{text:{summary:`Inspect the saved remote connection`,description:`Inspect active remote connection state`},usageOverride:`connection status`,listUsageOverride:`connection`,positionalArgs:[`status`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},disconnect:{text:{summary:`Clear remote connection state and release leases`,description:`Disconnect remote daemon state, stop owned Metro companion, and release lease`},listUsageOverride:`disconnect`,allowedFlags:[`shutdown`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},mcp:{text:{summary:`Start MCP server`,description:`Start the official stdio MCP server. It exposes structured command tools backed by the agent-device client.`}},proxy:{text:{summary:`Expose a local daemon through an HTTP tunnel`,description:`Expose the local daemon HTTP contract through a tunnel-friendly reverse proxy.
+import{P as e}from"./sdk-contracts.js";import{S as t,T as n,r}from"./registry.js";import{r as i}from"./command-metadata.js";const a={plugins:{text:{summary:`Manage installed provider plugins`,description:`Install, list, update, or remove npm provider plugins in AGENT_DEVICE_HOME (default ~/.agent-device). Changes take effect after restarting the local daemon. Use --json for structured results.`},usageOverride:`plugins list|add <package[@version]>|update <package>|remove <package>`,listUsageOverride:`plugins`,positionalArgs:[`list|add|update|remove`,`package?`],supportedFlags:[]},cdp:{text:{summary:`Inspect CDP targets, JS heap, and leaks`,description:`Run CDP commands for React Native diagnostics, JS heap usage, heap snapshots, and leak analysis`},usageOverride:`cdp [...args]`,listUsageOverride:`cdp`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:t},auth:{text:{summary:`Manage cloud login state`,description:`Manage cloud login state used by remote daemon and cloud device workflows.`},usageOverride:`auth status|login|logout`,listUsageOverride:`auth`,positionalArgs:[`status|login|logout`],supportedFlags:[`remoteConfig`,`stateDir`]},daemon:{text:{summary:`Stop a local daemon and clean up resources`,description:`Stop a local daemon after verifying its PID/start-time identity. Use --clean to remove retained Apple runner processes and leases owned by that daemon.`},usageOverride:`daemon stop [--state-dir <path>]`,listUsageOverride:`daemon stop`,positionalArgs:[`stop`],allowedFlags:[`clean`],supportedFlags:[`stateDir`]},device:{text:{summary:`Inspect and recover enforced local device ownership without a daemon`,description:`Inspect enforced host-local device ownership claims without starting or contacting a daemon; status --stale only inspects proven-stale claims. release --stale settles a provably dead owner through exact-owner resource reconciliation and clears its claim last — live and uncertain owners always fail closed. Automatic reclamation still occurs during open and daemon startup.`},usageOverride:`device status|release [--platform <platform>] [--udid <udid>] [--serial <serial>]`,listUsageOverride:`device status`,positionalArgs:[`status|release`],allowedFlags:[`stale`],supportedFlags:[`platform`,`device`,`udid`,`serial`]},connect:{text:{summary:`Configure remote or provider state`,description:`Configure remote access without allocating a device. Direct providers validate credentials/resources before saving state and print the exact device/app preparation needed before open. AGENT_DEVICE_CLOUD_BASE_URL is the bridge/control-plane API origin; use AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_... for CI/service-token automation.`},usageOverride:`connect [cloud|proxy|limrun|browserstack|aws-device-farm] [--remote-config <path>] [--daemon-base-url <url>] [--tenant <id>] [--run-id <id>] [--lease-id <id>] [--lease-backend <backend>] [--force] [--no-login]`,usageFlags:[],listUsageOverride:`connect`,positionalArgs:[`provider?`],allowedFlags:`remoteConfig.daemonBaseUrl.tenant.runId.leaseId.leaseBackend.providerApp.providerOsVersion.providerProject.providerBuild.providerSessionName.providerDeviceOrientation.providerGeoLocation.providerTimezone.providerAppiumVersion.providerLanguage.providerLocale.providerNetworkProfile.providerCustomNetwork.providerNoResignApp.awsProjectArn.awsDeviceArn.awsAppArn.awsRegion.awsInteractionMode.force.noLogin`.split(`.`),supportedFlags:[`stateDir`,`daemonAuthToken`,`session`,`platform`,`device`,...n,`launchUrl`]},connection:{text:{summary:`Inspect the saved remote connection`,description:`Inspect active remote connection state`},usageOverride:`connection status`,listUsageOverride:`connection`,positionalArgs:[`status`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},disconnect:{text:{summary:`Clear remote connection state and release leases`,description:`Disconnect remote daemon state, stop owned Metro companion, and release lease`},listUsageOverride:`disconnect`,allowedFlags:[`shutdown`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},mcp:{text:{summary:`Start MCP server`,description:`Start the official stdio MCP server. It exposes structured command tools backed by the agent-device client.`}},proxy:{text:{summary:`Expose a local daemon through an HTTP tunnel`,description:`Expose the local daemon HTTP contract through a tunnel-friendly reverse proxy.
 
 Run this on the host that has access to simulators/devices, expose the printed local proxy URL through a tunnel, then point another machine at the tunnel URL with connect proxy.
 
@@ -9,7 +9,7 @@ Use the /agent-device base path when connecting through cloudflared, ngrok, or a
 Examples:
   agent-device proxy --port 4310
   cloudflared tunnel --url http://127.0.0.1:4310
-  agent-device connect proxy --daemon-base-url https://example.trycloudflare.com/agent-device --daemon-auth-token <token>`},listUsageOverride:`proxy`,allowedFlags:[`proxyHost`,`proxyPort`,`daemonAuthToken`,`stateDir`]},takeover:{text:{summary:`Pause agent interactions while a person controls a device`,description:`Temporarily hand control of the active remote lease device to a person. The foreground command pauses state-changing agent commands, renews the hold until Ctrl+C, and then releases it. Read-only diagnostics remain available. Uses the active connection and --session, with normal tenant and lease admission. status lists holds on that device; release removes a hold owned by the admitted lease. The host-only /admin/human-control/holds API uses the separate local daemon token. Holds do not survive daemon restart. Local takeover without a remote device lease is not supported.`},usageOverride:`takeover [status | release <hold-id>] [--session <name>]`,listUsageOverride:`takeover [status|release]`,positionalArgs:[`status|release?`,`hold-id?`],supportedFlags:[`stateDir`,`session`,`remoteConfig`,`daemonBaseUrl`,`daemonAuthToken`,`daemonTransport`,`tenant`,`runId`,`leaseId`,`leaseBackend`,`sessionIsolation`]},"react-devtools":{text:{summary:`Inspect components, hooks, and render profiles`,description:`Run pinned agent-react-devtools commands for React Native performance profiling, component trees, props/state/hooks, and render analysis`},usageOverride:`react-devtools [...args]`,listUsageOverride:`react-devtools`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:r},web:{text:{summary:`Manage web automation backend`,description:`Install and inspect the managed web automation backend used by --platform web.
+  agent-device connect proxy --daemon-base-url https://example.trycloudflare.com/agent-device --daemon-auth-token <token>`},listUsageOverride:`proxy`,allowedFlags:[`proxyHost`,`proxyPort`,`daemonAuthToken`,`stateDir`]},takeover:{text:{summary:`Pause agent interactions while a person controls a device`,description:`Temporarily hand control of the active remote lease device to a person. The foreground command pauses state-changing agent commands, renews the hold until Ctrl+C, and then releases it. Read-only diagnostics remain available. Uses the active connection and --session, with normal tenant and lease admission. status lists holds on that device; release removes a hold owned by the admitted lease. The host-only /admin/human-control/holds API uses the separate local daemon token. Holds do not survive daemon restart. Local takeover without a remote device lease is not supported.`},usageOverride:`takeover [status | release <hold-id>] [--session <name>]`,listUsageOverride:`takeover [status|release]`,positionalArgs:[`status|release?`,`hold-id?`],supportedFlags:[`stateDir`,`session`,`remoteConfig`,`daemonBaseUrl`,`daemonAuthToken`,`daemonTransport`,`tenant`,`runId`,`leaseId`,`leaseBackend`,`sessionIsolation`]},"react-devtools":{text:{summary:`Inspect components, hooks, and render profiles`,description:`Run pinned agent-react-devtools commands for React Native performance profiling, component trees, props/state/hooks, and render analysis`},usageOverride:`react-devtools [...args]`,listUsageOverride:`react-devtools`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:t},web:{text:{summary:`Manage web automation backend`,description:`Install and inspect the managed web automation backend used by --platform web.
 
 First-run flow:
   agent-device web setup
@@ -19,4 +19,4 @@ First-run flow:
 
 Runtime web commands do not install the backend implicitly. If the managed backend is missing, run agent-device web setup. The backend is resolved only from the managed install in the effective agent-device state dir.
 
-Use web setup to install or reuse the pinned backend. Use web doctor after setup to verify browser backend health.`},usageOverride:`web setup | web doctor`,listUsageOverride:`web setup|doctor`,positionalArgs:[`setup|doctor`],supportedFlags:[`stateDir`]}},o=t();function s(e){return Object.hasOwn(a,e)?a[e]:void 0}function c(e){return Object.hasOwn(o,e)?o[e]:void 0}const l=new Map(i().map(e=>[e.name,{supportedFlags:r}]));function u(e){if(e)return p(e)}function d(e){let t=p(e);if(!t)throw Error(`Missing command schema for ${e}`);return t}function f(t,n,r){let i=u(t);if(!t||!i||i.allowsExtraPositionals)return;let a=i.positionalArgs?.length??0;if(n.length<=a)return;let o=r?`${r} ${t}`:t;throw new e(`INVALID_ARGS`,`${o} accepts at most ${a} positional argument(s), received ${n.length}: ${n.join(` `)}`)}function p(e){let t=s(e);if(t)return t;let n=l.get(e),r=c(e);if(!(!n||!r))return{...n,...r}}export{d as n,u as r,f as t};
+Use web setup to install or reuse the pinned backend. Use web doctor after setup to verify browser backend health.`},usageOverride:`web setup | web doctor`,listUsageOverride:`web setup|doctor`,positionalArgs:[`setup|doctor`],supportedFlags:[`stateDir`]}},o=r();function s(e){return Object.hasOwn(a,e)?a[e]:void 0}function c(e){return Object.hasOwn(o,e)?o[e]:void 0}const l=new Map(i().map(e=>[e.name,{supportedFlags:t}]));function u(e){if(e)return p(e)}function d(e){let t=p(e);if(!t)throw Error(`Missing command schema for ${e}`);return t}function f(t,n,r){let i=u(t);if(!t||!i||i.allowsExtraPositionals)return;let a=i.positionalArgs?.length??0;if(n.length<=a)return;let o=r?`${r} ${t}`:t;throw new e(`INVALID_ARGS`,`${o} accepts at most ${a} positional argument(s), received ${n.length}: ${n.join(` `)}`)}function p(e){let t=s(e);if(t)return t;let n=l.get(e),r=c(e);if(!(!n||!r))return{...n,...r}}export{d as n,u as r,f as t};