agent-device 0.18.0 → 0.18.2

package/README.md

@@ -31,7 +31,7 @@ It works with native iOS and Android apps, plus apps built with Expo, Flutter, a
 
 - **Inspect** real app UI through structured accessibility snapshots, interactive refs like `@e3`, selectors, and React Native component trees.
 - **Interact** by opening apps, tapping, typing, scrolling, performing gestures, waiting, asserting state, handling alerts, and closing sessions.
-- **Capture evidence** with screenshots, videos, logs, traces, network traffic, performance samples, crash context, and React profiles.
+- **Capture evidence** with screenshots, videos, logs, traces, network traffic, audio-level probes for browser and host-rendered simulator/emulator audio, performance samples, crash context, and React profiles.
 - **Replay workflows** by recording `.ad` scripts for local runs, CI, repeatable e2e checks, and strict Maestro YAML export when a flow needs to run in Maestro.
 - **Run across platforms** with iOS Simulator automation, Android Emulator automation, physical devices, tvOS, Android TV, macOS, Linux, and desktop app automation, so agents can see and feel the app they work on.
 
@@ -39,7 +39,7 @@ It works with native iOS and Android apps, plus apps built with Expo, Flutter, a
 
 - Verify mobile changes on real devices, simulators, and emulators before review or merge.
 - Give AI coding agents a real app feedback loop while they implement features.
-- Debug regressions with screenshots, logs, traces, network evidence, and crash context.
+- Debug regressions with screenshots, logs, traces, network/audio evidence, and crash context.
 - Profile performance issues with CPU/memory samples and React render profiles when needed.
 - Turn exploratory app interactions into replayable e2e checks for CI.
 - Use one agent workflow across native iOS, Android, Expo, Flutter, React Native, TV, and desktop apps.
@@ -105,6 +105,7 @@ Snapshots come from the app's accessibility tree, so high-quality labels, roles,
 
 - [Verifying mobile apps with agent-device](https://youtu.be/kZDU-k5r9kE)
 - [Using agent-device in an AI coding workflow](https://youtu.be/dfVG_aNPkW4)
+- [Cloud agents that test mobile apps on real devices](https://youtu.be/r5P0detC4bs?is=_KB6SZbLFRB1au_z)
 
 ## Where To Run agent-device
 

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

@@ -0,0 +1 @@
+1c8e6f04f5453ecea2e26281896faf7d940237c0011ba8d50b436c0b7ba82c4e  agent-device-android-multitouch-helper-0.18.2.apk

package/android-multitouch-helper/dist/{agent-device-android-multitouch-helper-0.18.0.manifest.json → agent-device-android-multitouch-helper-0.18.2.manifest.json}

@@ -1,10 +1,10 @@
 {
   "name": "android-multitouch-helper",
-  "version": "0.18.0",
-  "assetName": "agent-device-android-multitouch-helper-0.18.0.apk",
-  "sha256": "ee175f4b073047b40a3669e38caa85e83cdfe17921fe466bacfb1930551e8022",
+  "version": "0.18.2",
+  "assetName": "agent-device-android-multitouch-helper-0.18.2.apk",
+  "sha256": "1c8e6f04f5453ecea2e26281896faf7d940237c0011ba8d50b436c0b7ba82c4e",
   "packageName": "com.callstack.agentdevice.multitouchhelper",
-  "versionCode": 18000,
+  "versionCode": 18002,
   "instrumentationRunner": "com.callstack.agentdevice.multitouchhelper/.MultiTouchInstrumentation",
   "statusProtocol": "android-multitouch-helper-v1"
 }

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

@@ -0,0 +1 @@
+a91e0b0b4d8b5b1dc6d1e25abe1491efefa8b8d89cc5c406f1fd84a302e56ebf  agent-device-android-snapshot-helper-0.18.2.apk

package/android-snapshot-helper/dist/{agent-device-android-snapshot-helper-0.18.0.manifest.json → agent-device-android-snapshot-helper-0.18.2.manifest.json}

@@ -1,13 +1,13 @@
 {
   "name": "android-snapshot-helper",
-  "version": "0.18.0",
-  "releaseTag": "v0.18.0",
-  "assetName": "agent-device-android-snapshot-helper-0.18.0.apk",
+  "version": "0.18.2",
+  "releaseTag": "v0.18.2",
+  "assetName": "agent-device-android-snapshot-helper-0.18.2.apk",
   "apkUrl": null,
-  "sha256": "1cb010ec7665c1610619f128504fc514b7cc53c04788e081e044bf755a518886",
-  "checksumName": "agent-device-android-snapshot-helper-0.18.0.apk.sha256",
+  "sha256": "a91e0b0b4d8b5b1dc6d1e25abe1491efefa8b8d89cc5c406f1fd84a302e56ebf",
+  "checksumName": "agent-device-android-snapshot-helper-0.18.2.apk.sha256",
   "packageName": "com.callstack.agentdevice.snapshothelper",
-  "versionCode": 18000,
+  "versionCode": 18002,
   "instrumentationRunner": "com.callstack.agentdevice.snapshothelper/.SnapshotInstrumentation",
   "minSdk": 23,
   "targetSdk": 36,

package/apple-runner/AgentDeviceRunner/AgentDeviceRunner/AgentDeviceRunnerApp.m

@@ -0,0 +1,156 @@
+#import <TargetConditionals.h>
+
+#if TARGET_OS_OSX
+#import <Cocoa/Cocoa.h>
+
+@interface AgentDeviceRunnerAppDelegate : NSObject <NSApplicationDelegate>
+@property(nonatomic, strong) NSWindow *window;
+@end
+
+@implementation AgentDeviceRunnerAppDelegate
+
+- (void)applicationDidFinishLaunching:(NSNotification *)notification {
+  (void)notification;
+
+  NSRect frame = NSMakeRect(0, 0, 360, 220);
+  self.window = [[NSWindow alloc] initWithContentRect:frame
+                                            styleMask:(NSWindowStyleMaskTitled | NSWindowStyleMaskClosable |
+                                                       NSWindowStyleMaskMiniaturizable)
+                                              backing:NSBackingStoreBuffered
+                                                defer:NO];
+  self.window.title = @"Agent Device Runner";
+
+  NSTextField *label = [NSTextField labelWithString:@"Agent Device Runner"];
+  label.font = [NSFont systemFontOfSize:20 weight:NSFontWeightSemibold];
+  label.translatesAutoresizingMaskIntoConstraints = NO;
+
+  NSView *contentView = [[NSView alloc] initWithFrame:frame];
+  [contentView addSubview:label];
+  self.window.contentView = contentView;
+
+  [NSLayoutConstraint activateConstraints:@[
+    [label.centerXAnchor constraintEqualToAnchor:contentView.centerXAnchor],
+    [label.centerYAnchor constraintEqualToAnchor:contentView.centerYAnchor],
+  ]];
+
+  [self.window center];
+  [self.window makeKeyAndOrderFront:nil];
+}
+
+@end
+
+int main(int argc, const char *argv[]) {
+  (void)argc;
+  (void)argv;
+
+  @autoreleasepool {
+    NSApplication *application = [NSApplication sharedApplication];
+    AgentDeviceRunnerAppDelegate *delegate = [[AgentDeviceRunnerAppDelegate alloc] init];
+    application.delegate = delegate;
+    [application setActivationPolicy:NSApplicationActivationPolicyRegular];
+    [application run];
+  }
+
+  return 0;
+}
+
+#else
+#import <UIKit/UIKit.h>
+
+@interface AgentDeviceRunnerViewController : UIViewController
+@end
+
+@implementation AgentDeviceRunnerViewController
+
+- (void)viewDidLoad {
+  [super viewDidLoad];
+
+  self.view.backgroundColor = UIColor.whiteColor;
+
+  UILabel *label = [[UILabel alloc] init];
+  label.text = @"Agent Device Runner";
+  label.font = [UIFont preferredFontForTextStyle:UIFontTextStyleTitle2];
+  label.textAlignment = NSTextAlignmentCenter;
+  label.translatesAutoresizingMaskIntoConstraints = NO;
+
+  [self.view addSubview:label];
+  [NSLayoutConstraint activateConstraints:@[
+    [label.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
+    [label.centerYAnchor constraintEqualToAnchor:self.view.centerYAnchor],
+  ]];
+}
+
+@end
+
+#if defined(TARGET_OS_VISION) && TARGET_OS_VISION
+@interface AgentDeviceRunnerSceneDelegate : UIResponder <UIWindowSceneDelegate>
+@property(nonatomic, strong) UIWindow *window;
+@end
+
+@implementation AgentDeviceRunnerSceneDelegate
+
+- (void)scene:(UIScene *)scene
+    willConnectToSession:(UISceneSession *)session
+                 options:(UISceneConnectionOptions *)connectionOptions {
+  (void)session;
+  (void)connectionOptions;
+
+  if (![scene isKindOfClass:UIWindowScene.class]) {
+    return;
+  }
+
+  self.window = [[UIWindow alloc] initWithWindowScene:(UIWindowScene *)scene];
+  self.window.rootViewController = [[AgentDeviceRunnerViewController alloc] init];
+  [self.window makeKeyAndVisible];
+}
+
+@end
+#endif
+
+@interface AgentDeviceRunnerAppDelegate : UIResponder <UIApplicationDelegate>
+@property(nonatomic, strong) UIWindow *window;
+@end
+
+@implementation AgentDeviceRunnerAppDelegate
+
+- (BOOL)application:(UIApplication *)application
+    didFinishLaunchingWithOptions:(NSDictionary<UIApplicationLaunchOptionsKey, id> *)launchOptions {
+  (void)application;
+  (void)launchOptions;
+
+#if defined(TARGET_OS_VISION) && TARGET_OS_VISION
+  return YES;
+#else
+  self.window = [[UIWindow alloc] initWithFrame:UIScreen.mainScreen.bounds];
+  self.window.rootViewController = [[AgentDeviceRunnerViewController alloc] init];
+  [self.window makeKeyAndVisible];
+
+  return YES;
+#endif
+}
+
+#if defined(TARGET_OS_VISION) && TARGET_OS_VISION
+- (UISceneConfiguration *)application:(UIApplication *)application
+    configurationForConnectingSceneSession:(UISceneSession *)connectingSceneSession
+                                   options:(UISceneConnectionOptions *)options {
+  (void)application;
+  (void)connectingSceneSession;
+  (void)options;
+
+  UISceneConfiguration *configuration =
+      [[UISceneConfiguration alloc] initWithName:@"Default Configuration"
+                                     sessionRole:UIWindowSceneSessionRoleApplication];
+  configuration.delegateClass = AgentDeviceRunnerSceneDelegate.class;
+  return configuration;
+}
+#endif
+
+@end
+
+int main(int argc, char *argv[]) {
+  @autoreleasepool {
+    return UIApplicationMain(argc, argv, nil, NSStringFromClass(AgentDeviceRunnerAppDelegate.class));
+  }
+}
+
+#endif

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunner.xcodeproj/project.pbxproj

@@ -206,7 +206,6 @@
 				ALWAYS_SEARCH_USER_PATHS = NO;
 				AGENT_DEVICE_IOS_RUNNER_APP_BUNDLE_ID = com.callstack.agentdevice.runner;
 				AGENT_DEVICE_IOS_RUNNER_TEST_BUNDLE_ID = "$(AGENT_DEVICE_IOS_RUNNER_APP_BUNDLE_ID).uitests";
-				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
 				CLANG_ANALYZER_NONNULL = YES;
 				CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
 				CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
@@ -273,7 +272,6 @@
 				ALWAYS_SEARCH_USER_PATHS = NO;
 				AGENT_DEVICE_IOS_RUNNER_APP_BUNDLE_ID = com.callstack.agentdevice.runner;
 				AGENT_DEVICE_IOS_RUNNER_TEST_BUNDLE_ID = "$(AGENT_DEVICE_IOS_RUNNER_APP_BUNDLE_ID).uitests";
-				ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
 				CLANG_ANALYZER_NONNULL = YES;
 				CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
 				CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
@@ -330,14 +328,12 @@
 		20EA2EE82F2CFC7C001CF0EF /* Debug */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
-				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
-				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
 				DEVELOPMENT_TEAM = 2S799L9W4M;
 				ENABLE_PREVIEWS = YES;
 				GENERATE_INFOPLIST_FILE = YES;
-				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
+				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = NO;
 				INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
 				INFOPLIST_KEY_UILaunchScreen_Generation = YES;
 					INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
@@ -357,8 +353,8 @@
 				SWIFT_EMIT_LOC_STRINGS = YES;
 				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
 				SWIFT_VERSION = 5.0;
-					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator";
-					TARGETED_DEVICE_FAMILY = "1,2,3";
+					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator xros xrsimulator";
+					TARGETED_DEVICE_FAMILY = "1,2,3,7";
 					TVOS_DEPLOYMENT_TARGET = 15.6;
 			};
 			name = Debug;
@@ -366,14 +362,12 @@
 		20EA2EE92F2CFC7C001CF0EF /* Release */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
-				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
-				ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
 				CODE_SIGN_STYLE = Automatic;
 				CURRENT_PROJECT_VERSION = 1;
 				DEVELOPMENT_TEAM = 2S799L9W4M;
 				ENABLE_PREVIEWS = YES;
 				GENERATE_INFOPLIST_FILE = YES;
-				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
+				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = NO;
 				INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
 				INFOPLIST_KEY_UILaunchScreen_Generation = YES;
 					INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
@@ -393,8 +387,8 @@
 				SWIFT_EMIT_LOC_STRINGS = YES;
 				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
 				SWIFT_VERSION = 5.0;
-					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator";
-					TARGETED_DEVICE_FAMILY = "1,2,3";
+					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator xros xrsimulator";
+					TARGETED_DEVICE_FAMILY = "1,2,3,7";
 					TVOS_DEPLOYMENT_TARGET = 15.6;
 			};
 			name = Release;
@@ -418,8 +412,8 @@
 				SWIFT_OBJC_BRIDGING_HEADER = "AgentDeviceRunnerUITests/AgentDeviceRunnerUITests-Bridging-Header.h";
 				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
 				SWIFT_VERSION = 5.0;
-					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator";
-					TARGETED_DEVICE_FAMILY = "1,2,3";
+					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator xros xrsimulator";
+					TARGETED_DEVICE_FAMILY = "1,2,3,7";
 					TVOS_DEPLOYMENT_TARGET = 15.6;
 				TEST_TARGET_NAME = AgentDeviceRunner;
 			};
@@ -444,8 +438,8 @@
 				SWIFT_OBJC_BRIDGING_HEADER = "AgentDeviceRunnerUITests/AgentDeviceRunnerUITests-Bridging-Header.h";
 				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
 				SWIFT_VERSION = 5.0;
-					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator";
-					TARGETED_DEVICE_FAMILY = "1,2,3";
+					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator xros xrsimulator";
+					TARGETED_DEVICE_FAMILY = "1,2,3,7";
 					TVOS_DEPLOYMENT_TARGET = 15.6;
 				TEST_TARGET_NAME = AgentDeviceRunner;
 			};

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+AXSnapshotFallback.swift

@@ -208,6 +208,7 @@ extension RunnerTests {
   }
 }
 
+#if AGENT_DEVICE_RUNNER_UNIT_TESTS
 // MARK: - In-bundle unit tests
 
 extension RunnerTests {
@@ -325,3 +326,4 @@ extension RunnerTests {
     XCTAssertFalse(labels.contains("Admin settings"))
   }
 }
+#endif

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift

@@ -130,6 +130,7 @@ extension RunnerTests {
     return Response(ok: true, data: data)
   }
 
+#if AGENT_DEVICE_RUNNER_UNIT_TESTS
   func testGestureResponseIncludesSynthesizedTapFallbackDiagnostics() {
     let response = gestureResponse(
       message: "tapped",
@@ -180,6 +181,7 @@ extension RunnerTests {
     )
     XCTAssertNil(xctestRecordedFailureResponse(command: tapCommand, response: runnerFatalResponse))
   }
+#endif
 
   func execute(command: Command) throws -> Response {
     if command.command == .status {
@@ -882,7 +884,7 @@ extension RunnerTests {
           ok: false,
           error: ErrorPayload(
             code: "UNSUPPORTED_OPERATION",
-            message: "Unable to dismiss the iOS keyboard without a native dismiss gesture or control"
+            message: "Unable to dismiss the iOS keyboard without a safe native dismiss control"
           )
         )
       }

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandJournal.swift

@@ -153,6 +153,7 @@ final class RunnerCommandJournal {
   }
 }
 
+#if AGENT_DEVICE_RUNNER_UNIT_TESTS
 extension RunnerTests {
   func testUptimeBypassesCommandJournal() throws {
     let command = runnerJournalCommand("uptime", id: "uptime-probe")
@@ -439,3 +440,4 @@ extension RunnerTests {
     return try JSONDecoder().decode(Response.self, from: Data(responseJson.utf8))
   }
 }
+#endif

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+FlatSnapshotFiltering.swift

@@ -7,10 +7,6 @@ struct FlatSnapshotFilterNode {
   let valueText: String?
   let visible: Bool
 
-  var hasContent: Bool {
-    return !label.isEmpty || !identifier.isEmpty || valueText != nil
-  }
-
   func matchesScope(_ scope: String) -> Bool {
     let haystack = [label, identifier, valueText ?? ""].joined(separator: "\n")
     return haystack.localizedCaseInsensitiveContains(scope)
@@ -68,6 +64,7 @@ extension RunnerTests {
     return type
   }
 
+#if AGENT_DEVICE_RUNNER_UNIT_TESTS
   func testFlatSnapshotFilterDecisionMatrixCoversOptions() {
     let visibleContent = FlatSnapshotFilterNode(
       isRoot: false,
@@ -168,4 +165,5 @@ extension RunnerTests {
       "private AX marks scroll containers as interactive candidates"
     )
   }
+#endif
 }

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift

@@ -122,7 +122,7 @@ extension RunnerTests {
   }
 
   func rotateDevice(to orientationName: String) -> Bool {
-#if os(macOS) || os(tvOS)
+#if os(macOS) || os(tvOS) || os(visionOS)
     return false
 #else
     switch orientationName {
@@ -355,27 +355,12 @@ extension RunnerTests {
     let visible = isKeyboardVisible(app: app)
     return (wasVisible: true, dismissed: !visible, visible: visible)
 #else
-    let keyboard = app.keyboards.firstMatch
-    keyboard.swipeDown()
-    sleepFor(0.2)
-    if !isKeyboardVisible(app: app) {
-      return (wasVisible: true, dismissed: true, visible: false)
-    }
-
     if tapKeyboardDismissControl(app: app) {
       sleepFor(0.2)
       let visible = isKeyboardVisible(app: app)
       return (wasVisible: true, dismissed: !visible, visible: visible)
     }
 
-    if tapKeyboardReturnControl(app: app, allowCoordinateFallback: true) {
-      sleepFor(0.2)
-      let visible = isKeyboardVisible(app: app)
-      if !visible {
-        return (wasVisible: true, dismissed: true, visible: false)
-      }
-    }
-
     return (wasVisible: true, dismissed: false, visible: isKeyboardVisible(app: app))
 #endif
   }
@@ -417,6 +402,7 @@ extension RunnerTests {
     app: XCUIApplication,
     wasVisible: Bool
   ) -> (wasVisible: Bool, pressed: Bool, visible: Bool) {
+#if os(iOS)
     let exceptionMessage = RunnerObjCExceptionCatcher.catchException({
       element.tap()
       element.typeText(XCUIKeyboardKey.return.rawValue)
@@ -430,6 +416,9 @@ extension RunnerTests {
     }
     sleepFor(0.2)
     return (wasVisible: wasVisible, pressed: true, visible: isKeyboardVisible(app: app))
+#else
+    return (wasVisible: wasVisible, pressed: false, visible: false)
+#endif
   }
 
   private func singleTextEntryElement(app: XCUIApplication) -> XCUIElement? {
@@ -474,7 +463,7 @@ extension RunnerTests {
         label,
         label
       )
-      let toolbarButtons = app.toolbars.buttons
+      let toolbarButtons = app.descendants(matching: .button)
         .matching(toolbarButtonPredicate)
         .allElementsBoundByIndex
       if let hittable = toolbarButtons.first(where: {
@@ -488,10 +477,7 @@ extension RunnerTests {
 #endif
   }
 
-  private func tapKeyboardReturnControl(
-    app: XCUIApplication,
-    allowCoordinateFallback: Bool = false
-  ) -> Bool {
+  private func tapKeyboardReturnControl(app: XCUIApplication) -> Bool {
 #if os(iOS)
     for label in ["return", "Return", "Enter", "Go", "Search", "Next", "Done", "Send", "Join"] {
       let candidates = [
@@ -502,21 +488,6 @@ extension RunnerTests {
         hittable.tap()
         return true
       }
-      if allowCoordinateFallback,
-         let keyboardFrame = visibleKeyboardFrame(app: app),
-         let framed = candidates.first(where: {
-           guard $0.exists else { return false }
-           let frame = $0.frame
-           return !frame.isEmpty && keyboardFrame.contains(CGPoint(x: frame.midX, y: frame.midY))
-         }) {
-        let frame = framed.frame
-        switch tapAt(app: app, x: frame.midX, y: frame.midY) {
-        case .performed:
-          return true
-        case .unsupported:
-          return false
-        }
-      }
     }
 #endif
     return false
@@ -1261,6 +1232,7 @@ extension RunnerTests {
     return element.exists ? element : nil
   }
 
+#if AGENT_DEVICE_RUNNER_UNIT_TESTS
   // Identity in portrait/unknown, 90° per landscape, 180° upside-down.
   func testNativeSynthesizedPointRotatesByInterfaceOrientation() {
     let portrait = CGRect(x: 0, y: 0, width: 834, height: 1210)
@@ -1329,4 +1301,5 @@ extension RunnerTests {
     XCTAssertEqual(events.count, 1)
     XCTAssertEqual(events.first?.vertical, -200)
   }
+#endif
 }

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+ScrollGesture.swift

@@ -62,6 +62,7 @@ func runnerScrollGesturePlan(
   }
 }
 
+#if AGENT_DEVICE_RUNNER_UNIT_TESTS
 extension RunnerTests {
   // Cross-language parity vectors mirroring src/core/__tests__/scroll-gesture.test.ts. Keep these
   // in sync with the vitest vectors so the two buildScrollGesturePlan implementations cannot drift.
@@ -216,3 +217,4 @@ extension RunnerTests {
     )
   }
 }
+#endif

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SequenceExecution.swift

@@ -273,6 +273,7 @@ extension RunnerTests {
   }
 }
 
+#if AGENT_DEVICE_RUNNER_UNIT_TESTS
 // MARK: - In-bundle unit tests (device-free)
 
 extension RunnerTests {
@@ -448,3 +449,4 @@ extension RunnerTests {
     return try! JSONDecoder().decode(Command.self, from: data)
   }
 }
+#endif

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Snapshot.swift

@@ -426,6 +426,7 @@ extension RunnerTests {
     )
   }
 
+#if AGENT_DEVICE_RUNNER_UNIT_TESTS
   func testSnapshotAccessibilityUnavailableMarksSparseSnapshotRunnerFatal() {
     currentApp = app
     currentBundleId = "com.example.app"
@@ -468,6 +469,7 @@ extension RunnerTests {
     XCTAssertTrue(failure.message.contains("\(Self.rawSnapshotMaxNodes) nodes"))
     XCTAssertEqual(failure.hint, Self.rawSnapshotTooLargeHint)
   }
+#endif
 
   private func interactiveRootNode(rect: CGRect) -> SnapshotNode {
     SnapshotNode(

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotCapturePlan.swift

@@ -304,6 +304,7 @@ extension RunnerTests {
   }
 }
 
+#if AGENT_DEVICE_RUNNER_UNIT_TESTS
 // MARK: - In-bundle unit tests
 
 extension RunnerTests {
@@ -423,3 +424,4 @@ extension RunnerTests {
     XCTAssertEqual(payload.snapshotQuality?.reasonCode, "ax-rejected")
   }
 }
+#endif

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntry.swift

@@ -12,7 +12,6 @@ extension RunnerTests {
 
   enum TextEntryTiming {
     static let focusTimeout: TimeInterval = 0.4
-    static let repairReadinessTimeout: TimeInterval = 1.0
     static let readinessTimeout: TimeInterval = 2.0
     static let hardwareKeyboardFallbackTimeout: TimeInterval = 0.35
     static let pollInterval: TimeInterval = 0.02

package/{ios-runner → apple-runner}/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift

@@ -46,7 +46,8 @@ final class RunnerTests: XCTestCase {
   let firstInteractionAfterActivateDelay: TimeInterval = 0.25
   let scrollInteractionIdleTimeoutDefault: TimeInterval = 1.0
   let tvRemoteDoublePressDelayDefault: TimeInterval = 0.0
-  let xctestIdleKeepaliveInterval: TimeInterval = 5.0
+  // Keep a periodic XCTest liveness marker in runner.log without flooding long-lived sessions.
+  let xctestIdleKeepaliveInterval: TimeInterval = 60.0
   let minRecordingFps = 1
   let maxRecordingFps = 120
   var needsPostSnapshotInteractionDelay = false

package/dist/src/1986.js

@@ -0,0 +1 @@
+import{AppError as e}from"./485.js";import{daemonRuntimeSchema as a}from"./6849.js";let n={alert:"alert",audio:"audio",appState:"appstate",appSwitcher:"app-switcher",artifacts:"artifacts",apps:"apps",back:"back",batch:"batch",boot:"boot",click:"click",close:"close",clipboard:"clipboard",devices:"devices",doctor:"doctor",diff:"diff",fill:"fill",find:"find",focus:"focus",gesture:"gesture",get:"get",home:"home",install:"install",installFromSource:"install-from-source",is:"is",keyboard:"keyboard",logs:"logs",longPress:"longpress",network:"network",open:"open",perf:"perf",prepare:"prepare",press:"press",push:"push",record:"record",reactNative:"react-native",reinstall:"reinstall",replay:"replay",rotate:"rotate",scroll:"scroll",screenshot:"screenshot",settings:"settings",shutdown:"shutdown",snapshot:"snapshot",swipe:"swipe",test:"test",trace:"trace",triggerAppEvent:"trigger-app-event",type:"type",viewport:"viewport",wait:"wait"},i={installSource:"install_source",leaseAllocate:"lease_allocate",leaseHeartbeat:"lease_heartbeat",leaseRelease:"lease_release",releaseMaterializedPaths:"release_materialized_paths",runtime:"runtime",sessionList:"session_list"},t={cdp:"cdp",auth:"auth",connect:"connect",connection:"connection",debug:"debug",disconnect:"disconnect",mcp:"mcp",metro:"metro",proxy:"proxy",reactDevtools:"react-devtools",session:"session",web:"web"},o=["pan","fling","swipe","pinch","rotate","transform"],r=`gesture requires one of: ${o.join(", ")}`,l=s(t.auth,t.cdp,t.connect,t.connection,t.disconnect,t.mcp,t.proxy,t.reactDevtools,t.web,n.prepare);function s(...e){return new Set(e)}function c(){return[...Object.values(n),...Object.values(t)].sort()}function d(e){return Object.values(n).includes(e)||e===t.debug||e===t.metro||e===t.session}function p(){return c().filter(e=>!l.has(e))}function u(a,n,i,t){let o=i(a[n]);if(void 0===o)throw new e("COMMAND_FAILED",t,{response:a});return o}function m(e,a){return u(e,a,D,`Daemon response is missing "${a}".`)}function b(e,a){return D(e[a])}function h(e,a){var n;let i;return n=D,null===(i=e[a])?null:n(i)}function y(e,a){return u(e,a,w,`Daemon response is missing numeric "${a}".`)}function f(e,a){return u(e,a,k,`Daemon response has invalid "${a}".`)}function g(e,a){return u(e,a,_,`Daemon response has invalid "${a}".`)}function S(e,a){return function(e){return"tv"===e||"mobile"===e||"desktop"===e?e:void 0}(e[a])??"mobile"}function v(e){if(!E(e))return;let a=x(e,"x"),n=x(e,"y"),i=x(e,"width"),t=x(e,"height");if(void 0!==a&&void 0!==n&&void 0!==i&&void 0!==t)return{x:a,y:n,width:i,height:t}}function A(e){if(!E(e))return;let a=x(e,"x"),n=x(e,"y");if(void 0!==a&&void 0!==n)return{x:a,y:n}}function x(e,a){let n=e[a];return"number"==typeof n?n:void 0}function D(e){return"string"==typeof e&&e.length>0?e:void 0}function w(e){return"number"==typeof e&&Number.isFinite(e)?e:void 0}function k(e){return"apple"===e?"ios":"ios"===e||"macos"===e||"android"===e||"linux"===e||"web"===e?e:void 0}function _(e){return"simulator"===e||"emulator"===e||"device"===e?e:void 0}s(t.auth,t.cdp,t.connect,t.connection,t.debug,t.disconnect,t.mcp,t.metro,t.proxy,t.reactDevtools,t.session,t.web,n.artifacts,n.appState,n.prepare,n.batch,n.devices,n.doctor,n.gesture,n.replay,n.test,n.trace);function B(a){if(!E(a))throw new e("COMMAND_FAILED","Daemon returned an unexpected response shape.",{value:a});return a}function E(e){return null!==e&&"object"==typeof e&&!Array.isArray(e)}function N(e){let a={};for(let[n,i]of Object.entries(e))void 0!==i&&(a[n]=i);return a}function R(e){return e.split("\n").map(e=>e.trim()).filter(e=>e.length>0)}let C=a=>new e("INVALID_ARGS",a);function G(e){return Number.isInteger(e)&&e>=1&&e<=1e3}function K(e,a,n=C){if(e>a)throw n(`batch has ${e} steps; max allowed is ${a}.`)}function M(e,a,n=C){if(!E(e))throw n(`Invalid batch step ${a}.`);return e}function I(e,a,n=C){let i=e.input;if(!E(i))throw n(`Batch step ${a} input must be an object.`);return i}function O(e,n,i=C){if(void 0!==e)try{return a.parse(e)}catch(e){throw i(`Batch step ${n} runtime is invalid: ${e instanceof Error?e.message:String(e)}`)}}function P(e){let a=[];for(let n of e)n.daemon&&a.push({command:n.name,...n.daemon});return a}function L(e){let a={};for(let n of e)n.capability&&(a[n.name]=n.capability);return a}let $={leaseAdmissionExempt:!0,sessionExecutionLockExempt:!0},T={leaseAdmissionExempt:!0,sessionExecutionLockExempt:!0,selectorValidationExempt:!0},U=()=>!0,j=e=>e.command===n.test&&("number"==typeof e.flags?.shardAll||"number"==typeof e.flags?.shardSplit),H={simulator:!0,device:!0},F={emulator:!0,device:!0,unknown:!0},q={device:!0},V={},z={apple:H,android:F,linux:q},Y={apple:H,android:F,linux:V},J=[{name:i.leaseAllocate,daemon:{route:"lease",...$},batchable:!1},{name:i.leaseHeartbeat,daemon:{route:"lease",...$},batchable:!1},{name:i.leaseRelease,daemon:{route:"lease",...$},batchable:!1},{name:n.artifacts,daemon:{route:"lease",...$},batchable:!1},{name:i.sessionList,daemon:{route:"session",sessionKind:"inventory",...T},batchable:!1},{name:n.devices,daemon:{route:"session",sessionKind:"inventory",lockPolicySelectorOverride:!0,...T},batchable:!0},{name:n.doctor,daemon:{route:"session",sessionKind:"inventory",lockPolicySelectorOverride:!0,allowSessionlessDefaultDevice:U,...T},batchable:!0},{name:n.apps,daemon:{route:"session",sessionKind:"inventory",lockPolicySelectorOverride:!0,preferExplicitDeviceOverExistingSession:!0},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.boot,daemon:{route:"session",sessionKind:"state"},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.shutdown,daemon:{route:"session",sessionKind:"state"},capability:{apple:{simulator:!0},android:{emulator:!0},linux:V},batchable:!0},{name:n.appState,daemon:{route:"session",sessionKind:"state"},batchable:!0},{name:n.perf,daemon:{route:"session",sessionKind:"observability"},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.logs,daemon:{route:"session",sessionKind:"observability"},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.network,daemon:{route:"session",sessionKind:"observability"},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.audio,daemon:{route:"session",sessionKind:"observability"},capability:{apple:H,android:{emulator:!0},linux:V},batchable:!0},{name:n.replay,daemon:{route:"session",sessionKind:"replay",skipSessionlessProviderDevice:j},batchable:!1},{name:n.test,daemon:{route:"session",sessionKind:"replay",skipSessionlessProviderDevice:j},batchable:!0},{name:i.runtime,daemon:{route:"session"},batchable:!1},{name:n.clipboard,daemon:{route:"session",replayScopedAction:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:n.keyboard,daemon:{route:"session",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.install,daemon:{route:"session"},capability:Y,batchable:!0},{name:n.reinstall,daemon:{route:"session"},capability:Y,batchable:!0},{name:i.installSource,daemon:{route:"session"},batchable:!1},{name:i.releaseMaterializedPaths,daemon:{route:"session",...T},batchable:!1},{name:n.push,daemon:{route:"session"},capability:{apple:{simulator:!0},android:F,linux:V},batchable:!0},{name:n.triggerAppEvent,daemon:{route:"session"},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.open,daemon:{route:"session",allowSessionlessDefaultDevice:U},capability:z,batchable:!0},{name:n.prepare,daemon:{route:"session"},batchable:!1},{name:n.batch,daemon:{route:"session"},batchable:!1},{name:n.close,daemon:{route:"session",allowInvalidRecording:!0},capability:z,batchable:!0},{name:n.snapshot,daemon:{route:"snapshot",replayScopedAction:!0},capability:z,batchable:!0},{name:n.diff,daemon:{route:"snapshot",replayScopedAction:!0},capability:z,batchable:!0},{name:n.wait,daemon:{route:"snapshot",replayScopedAction:!0},capability:z,batchable:!0},{name:n.alert,daemon:{route:"snapshot",replayScopedAction:!0},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.settings,daemon:{route:"snapshot",replayScopedAction:!0},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.reactNative,daemon:{route:"reactNative",replayScopedAction:!0},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.record,daemon:{route:"recordTrace",replayScopedAction:!0,allowInvalidRecording:!0,allowSessionlessDefaultDevice:e=>"start"===(e.positionals?.[0]??"").toLowerCase()},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.trace,daemon:{route:"recordTrace"},batchable:!0},{name:n.find,daemon:{route:"find",replayScopedAction:!0},capability:z,batchable:!0},{name:n.click,daemon:{route:"interaction",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:n.fill,daemon:{route:"interaction",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:n.longPress,daemon:{route:"interaction",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:n.press,daemon:{route:"interaction",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:n.type,daemon:{route:"interaction",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:z,batchable:!0},{name:n.get,daemon:{route:"interaction",replayScopedAction:!0},capability:z,batchable:!0},{name:n.is,daemon:{route:"interaction",replayScopedAction:!0},capability:z,batchable:!0},{name:n.back,daemon:{route:"generic",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:n.gesture,daemon:{route:"generic",replayScopedAction:!0,androidBlockingDialogGuard:!0},batchable:!0},{name:n.home,daemon:{route:"generic",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:n.rotate,daemon:{route:"generic",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.scroll,daemon:{route:"generic",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:n.swipe,daemon:{route:"generic",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:"pinch",daemon:{route:"generic",replayScopedAction:!0,androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:V},batchable:!1},{name:n.focus,daemon:{route:"generic",androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!0},{name:n.screenshot,daemon:{route:"generic",replayScopedAction:!0},capability:z,batchable:!0},{name:n.viewport,daemon:{route:"generic",replayScopedAction:!0},capability:{apple:H,android:F,linux:V},batchable:!1},{name:"pan",daemon:{route:"generic",androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:q},batchable:!1},{name:"fling",daemon:{route:"generic",androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:V},batchable:!1},{name:"rotate-gesture",daemon:{route:"generic",androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:V},batchable:!1},{name:"transform-gesture",daemon:{route:"generic",androidBlockingDialogGuard:!0},capability:{apple:H,android:F,linux:V},batchable:!1},{name:n.appSwitcher,capability:{apple:H,android:F,linux:V},batchable:!0},{name:n.installFromSource,capability:Y,batchable:!0}],Q=new Set(p()),W=J.map(e=>({...e,mcpExposed:Q.has(e.name)})),X=W.filter(e=>e.batchable).map(e=>e.name),Z=new Set(["batch","replay"]),ee=["command","positionals","flags","runtime"],ea=["platform","target","device","udid","serial","verbose","out"],en=new Set(X);function ei(e){return"string"==typeof e?e.trim().toLowerCase():""}function et(a,n){let i=ei(a);if(en.has(i))return i;throw new e("INVALID_ARGS",`Batch step ${n} command is not available through command batch: ${String(a)}`)}function eo(a,n){if(Z.has(a))throw new e("INVALID_ARGS",`Batch step ${n} cannot run ${a}.`)}export{ee as BATCH_DAEMON_STEP_KEYS,o as GESTURE_KINDS,r as GESTURE_SUBCOMMAND_ERROR,ea as INHERITED_PARENT_FLAG_KEYS,i as INTERNAL_COMMANDS,n as PUBLIC_COMMANDS,X as STRUCTURED_BATCH_COMMAND_NAMES,B as asRecord,eo as assertBatchRuntimeCommandAllowed,K as assertBatchStepCount,W as commandDescriptors,L as deriveCapabilityMatrix,P as deriveDaemonCommandDescriptors,d as isClientBackedCliCommandName,E as isRecord,G as isValidBatchMaxSteps,c as listCliCommandNames,p as listMcpExposedCommandNames,ei as normalizeBatchCommandName,O as parseBatchStepRuntime,A as parsePoint,v as parseRect,I as readBatchStepInputObject,M as readBatchStepRecord,S as readDeviceTarget,h as readNullableString,b as readOptionalString,g as readRequiredDeviceKind,y as readRequiredNumber,f as readRequiredPlatform,m as readRequiredString,et as readStructuredBatchCommandName,R as splitNonEmptyTrimmedLines,N as stripUndefined};

package/dist/src/2748.js

@@ -1 +1 @@
-import{AppError as e}from"./733.js";let r="user-installed";function t(e){return e??r}function o(r){if(void 0===r)throw new e("INVALID_ARGS","appsFilter must be resolved before executing the apps command");return r}export{r as DEFAULT_APPS_FILTER,o as assertResolvedAppsFilter,t as resolveAppsFilter};
+import{AppError as e}from"./485.js";let r="user-installed";function t(e){return e??r}function o(r){if(void 0===r)throw new e("INVALID_ARGS","appsFilter must be resolved before executing the apps command");return r}export{r as DEFAULT_APPS_FILTER,o as assertResolvedAppsFilter,t as resolveAppsFilter};