agent-device 0.19.0 → 0.19.1

package/README.md

@@ -52,11 +52,15 @@ Install the CLI:
 
 ```bash
 npm install -g agent-device@latest
+agent-device doctor
 agent-device --version
 agent-device help workflow
 ```
 
-The installed CLI help is the source of truth for agents. Start with `agent-device help workflow`, then follow the topic-specific help when a task needs dogfooding, debugging, replay, or React Native profiling.
+Run `agent-device doctor` yourself after installation to check local setup before
+handing the CLI to an agent. The installed CLI help is the source of truth for
+agents. Start with `agent-device help workflow`, then follow the topic-specific
+help when a task needs dogfooding, debugging, replay, or React Native profiling.
 
 Prerequisites depend on the target platform: Node.js 22+, Xcode for iOS/tvOS/macOS targets, Android SDK + ADB for Android, and macOS Accessibility permission for desktop automation. Web automation requires Node 24+. See [Installation](https://oss.callstack.com/agent-device/docs/installation) for platform setup.
 

package/android-multitouch-helper/dist/agent-device-android-multitouch-helper-0.19.1.apk.sha256

@@ -0,0 +1 @@
+047938649fa5a1be4959384c3a6b64443cf4135567fb8f72cfb1107375b0eec7  agent-device-android-multitouch-helper-0.19.1.apk

package/android-multitouch-helper/dist/{agent-device-android-multitouch-helper-0.19.0.manifest.json → agent-device-android-multitouch-helper-0.19.1.manifest.json}

@@ -1,10 +1,10 @@
 {
   "name": "android-multitouch-helper",
-  "version": "0.19.0",
-  "assetName": "agent-device-android-multitouch-helper-0.19.0.apk",
-  "sha256": "fbcaeff3de2f16c64ffe2fef8a4736b4392a08f11e3c957d826b40009195cf2e",
+  "version": "0.19.1",
+  "assetName": "agent-device-android-multitouch-helper-0.19.1.apk",
+  "sha256": "047938649fa5a1be4959384c3a6b64443cf4135567fb8f72cfb1107375b0eec7",
   "packageName": "com.callstack.agentdevice.multitouchhelper",
-  "versionCode": 19000,
+  "versionCode": 19001,
   "instrumentationRunner": "com.callstack.agentdevice.multitouchhelper/.MultiTouchInstrumentation",
   "statusProtocol": "android-multitouch-helper-v1"
 }

package/android-snapshot-helper/dist/agent-device-android-snapshot-helper-0.19.1.apk.sha256

@@ -0,0 +1 @@
+e6e5119b4b2ef7d67b8e50acc745f0ffec78951be2094a9198cb491c5e078b22  agent-device-android-snapshot-helper-0.19.1.apk

package/android-snapshot-helper/dist/{agent-device-android-snapshot-helper-0.19.0.manifest.json → agent-device-android-snapshot-helper-0.19.1.manifest.json}

@@ -1,13 +1,13 @@
 {
   "name": "android-snapshot-helper",
-  "version": "0.19.0",
-  "releaseTag": "v0.19.0",
-  "assetName": "agent-device-android-snapshot-helper-0.19.0.apk",
+  "version": "0.19.1",
+  "releaseTag": "v0.19.1",
+  "assetName": "agent-device-android-snapshot-helper-0.19.1.apk",
   "apkUrl": null,
-  "sha256": "56bb052ba4868491bdace904dc41f905cdde3a589e4f4f314d2a7d57c6f8d76c",
-  "checksumName": "agent-device-android-snapshot-helper-0.19.0.apk.sha256",
+  "sha256": "e6e5119b4b2ef7d67b8e50acc745f0ffec78951be2094a9198cb491c5e078b22",
+  "checksumName": "agent-device-android-snapshot-helper-0.19.1.apk.sha256",
   "packageName": "com.callstack.agentdevice.snapshothelper",
-  "versionCode": 19000,
+  "versionCode": 19001,
   "instrumentationRunner": "com.callstack.agentdevice.snapshothelper/.SnapshotInstrumentation",
   "minSdk": 23,
   "targetSdk": 36,

package/dist/apple-runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+AXSnapshotFallback.swift

@@ -57,14 +57,8 @@ extension RunnerTests {
         return nil
       }
 
-      // If the app frame is unavailable, the private root's own frame is the reliable screen
-      // rect here. Avoid public window queries: stale transient windows can record XCTest
-      // failures after the runner already returned a successful command response.
-      var viewport = safeSnapshotViewport(app: app)
       let rootFrame = privateAXRect(root["frame"])
-      if viewport.isInfinite || viewport.isNull || viewport.isEmpty, !rootFrame.isEmpty {
-        viewport = rootFrame
-      }
+      let viewport = privateAXSnapshotViewport(app: app, rootFrame: rootFrame)
       var nodes: [SnapshotNode] = []
       appendPrivateAXNode(
         root,
@@ -95,6 +89,29 @@ extension RunnerTests {
     #endif
   }
 
+  private func privateAXSnapshotViewport(app: XCUIApplication, rootFrame: CGRect) -> CGRect {
+    let fallback = rootFrame.isEmpty ? CGRect.infinite : rootFrame
+    guard !hasAbandonedTreeCapture() else {
+      return fallback
+    }
+    do {
+      let viewport = try runMainThreadWork(
+        command: nil,
+        timeout: 1,
+        timeoutError: snapshotMainThreadTimeoutError("reading private AX viewport")
+      ) {
+        self.safeSnapshotViewport(app: app)
+      }
+      if viewport.isInfinite || viewport.isNull || viewport.isEmpty {
+        return fallback
+      }
+      return viewport
+    } catch {
+      NSLog("AGENT_DEVICE_RUNNER_PRIVATE_AX_VIEWPORT_FALLBACK=%@", String(describing: error))
+      return fallback
+    }
+  }
+
   private func appendPrivateAXNode(
     _ rawNode: [String: Any],
     to nodes: inout [SnapshotNode],