agent-device 0.21.11 → 0.21.13

package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.13.apk.sha256

@@ -0,0 +1 @@
+8388dc7a3c3f18aca7322cc50bc4f3ff769d426733746a764f45b56d50a0f267  agent-device-android-ime-helper-0.21.13.apk

package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.11.manifest.json → agent-device-android-ime-helper-0.21.13.manifest.json}

@@ -1,10 +1,10 @@
 {
   "name": "android-ime-helper",
-  "version": "0.21.11",
-  "assetName": "agent-device-android-ime-helper-0.21.11.apk",
-  "sha256": "63beaf80513455a01906685716ad7a91169cb5632dc054e02d06047957490697",
+  "version": "0.21.13",
+  "assetName": "agent-device-android-ime-helper-0.21.13.apk",
+  "sha256": "8388dc7a3c3f18aca7322cc50bc4f3ff769d426733746a764f45b56d50a0f267",
   "packageName": "com.callstack.agentdevice.imehelper",
-  "versionCode": 21011,
+  "versionCode": 21013,
   "serviceComponent": "com.callstack.agentdevice.imehelper/.TestInputMethodService",
   "broadcastProtocol": "android-ime-helper-v1"
 }

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

@@ -0,0 +1 @@
+e07b556384093a04be99af068b6493e0b0a66e7e7cf09264da4fe60f75f2d164  agent-device-android-snapshot-helper-0.21.13.apk

package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.11.manifest.json → agent-device-android-snapshot-helper-0.21.13.manifest.json}

@@ -1,13 +1,13 @@
 {
   "name": "android-snapshot-helper",
-  "version": "0.21.11",
-  "releaseTag": "v0.21.11",
-  "assetName": "agent-device-android-snapshot-helper-0.21.11.apk",
+  "version": "0.21.13",
+  "releaseTag": "v0.21.13",
+  "assetName": "agent-device-android-snapshot-helper-0.21.13.apk",
   "apkUrl": null,
-  "sha256": "9201208584b56e121818bcfcf8db066d8f0f63309af27c34edccc0f9b16e9cfb",
-  "checksumName": "agent-device-android-snapshot-helper-0.21.11.apk.sha256",
+  "sha256": "e07b556384093a04be99af068b6493e0b0a66e7e7cf09264da4fe60f75f2d164",
+  "checksumName": "agent-device-android-snapshot-helper-0.21.13.apk.sha256",
   "packageName": "com.callstack.agentdevice.snapshothelper",
-  "versionCode": 21011,
+  "versionCode": 21013,
   "instrumentationRunner": "com.callstack.agentdevice.snapshothelper/.SnapshotInstrumentation",
   "minSdk": 23,
   "targetSdk": 36,

package/apple/fold-helper/Fold.m

@@ -0,0 +1,97 @@
+#import <Foundation/Foundation.h>
+#import <mach/mach_time.h>
+#import <math.h>
+
+// Private simulator HID entry points; the host verifies the resulting hinge independently.
+extern CFDataRef IOCFSerialize(CFTypeRef object, CFOptionFlags options);
+extern CFTypeRef IOHIDEventCreateVendorDefinedEvent(CFAllocatorRef allocator, uint64_t timestamp,
+    uint32_t usagePage, uint32_t usage, uint32_t version, const uint8_t *data,
+    CFIndex length, uint32_t options);
+extern CFTypeRef IOHIDEventSystemClientCreate(CFAllocatorRef allocator);
+extern void IOHIDEventSystemClientDispatchEvent(CFTypeRef client, CFTypeRef event);
+
+static BOOL sendAngle(CFTypeRef client, double angle) {
+  NSDictionary *payload = @{
+    @"provider": @"com.apple.Virtualization.VirtualMachines",
+    @"source": @"hinge-slider-control", @"type": @"range", @"value": @(angle),
+  };
+  CFDataRef data = IOCFSerialize((__bridge CFTypeRef)payload, 1);
+  if (!data) return NO;
+  CFTypeRef event = IOHIDEventCreateVendorDefinedEvent(kCFAllocatorDefault,
+      mach_absolute_time(), 0xff61, 0x5b, 0, CFDataGetBytePtr(data), CFDataGetLength(data), 0);
+  if (event) IOHIDEventSystemClientDispatchEvent(client, event);
+  CFRelease(data);
+  if (!event) return NO;
+  CFRelease(event);
+  return YES;
+}
+
+static BOOL validNumber(id value) {
+  return [value isKindOfClass:NSNumber.class] &&
+      CFGetTypeID((__bridge CFTypeRef)value) != CFBooleanGetTypeID() && isfinite([value doubleValue]);
+}
+
+static NSArray *readFrames(NSString *argument) {
+  NSNumber *preset = (@{@"closed": @0, @"half-open": @130, @"open": @180})[argument];
+  if (preset) return @[@{@"atMs": @0, @"angle": preset}];
+  id frames = [NSJSONSerialization JSONObjectWithData:[argument dataUsingEncoding:NSUTF8StringEncoding]
+      options:0 error:NULL];
+  if (![frames isKindOfClass:NSArray.class] || [frames count] < 2 || [frames count] > 64) return nil;
+  double previous = -1;
+  for (id frame in frames) {
+    if (![frame isKindOfClass:NSDictionary.class] || [frame count] != 2 ||
+        !validNumber(frame[@"atMs"]) || !validNumber(frame[@"angle"])) return nil;
+    double time = [frame[@"atMs"] doubleValue], angle = [frame[@"angle"] doubleValue];
+    if (time < 0 || time > 60000 || floor(time) != time || time <= previous ||
+        (previous == -1 && time != 0) || angle < 0 || angle > 180) return nil;
+    previous = time;
+  }
+  return frames;
+}
+
+static double angleAtTime(NSArray *frames, double elapsed) {
+  NSUInteger segment = 0;
+  while (segment + 1 < frames.count && [frames[segment + 1][@"atMs"] doubleValue] <= elapsed) segment++;
+  double angle = [frames[segment][@"angle"] doubleValue];
+  if (segment + 1 < frames.count) {
+    double from = [frames[segment][@"atMs"] doubleValue];
+    double to = [frames[segment + 1][@"atMs"] doubleValue];
+    angle += ([frames[segment + 1][@"angle"] doubleValue] - angle) * (elapsed - from) / (to - from);
+  }
+  return angle;
+}
+
+static BOOL runFrames(CFTypeRef client, NSArray *frames) {
+  mach_timebase_info_data_t clock;
+  mach_timebase_info(&clock);
+  uint64_t start = mach_absolute_time();
+  double duration = [frames.lastObject[@"atMs"] doubleValue];
+  double elapsed = 0;
+  while (YES) {
+    @autoreleasepool {
+      if (!sendAngle(client, angleAtTime(frames, elapsed))) return NO;
+    }
+    if (elapsed >= duration) return YES;
+    double now = (mach_absolute_time() - start) * clock.numer / (double)clock.denom / 1e6;
+    // Absolute deadlines skip missed frames instead of extending the user's timeline.
+    double next = fmin(duration, (floor(now * 60 / 1000) + 1) * 1000 / 60);
+    mach_wait_until(start + (uint64_t)(next * 1e6 * clock.denom / clock.numer));
+    elapsed = fmin(duration, (mach_absolute_time() - start) * clock.numer / (double)clock.denom / 1e6);
+  }
+}
+
+int main(int argc, const char *argv[]) {
+  @autoreleasepool {
+    NSArray *frames = argc == 2 ? readFrames(@(argv[1])) : nil;
+    if (!frames) {
+      fprintf(stderr, "Expected a pose or 2-64 {atMs,angle} keyframes spanning 0 to at most 60000ms\n");
+      return 2;
+    }
+    CFTypeRef client = IOHIDEventSystemClientCreate(kCFAllocatorDefault);
+    if (!client) return 1;
+    BOOL dispatched = runFrames(client, frames);
+    CFRelease(client);
+    if (!dispatched) fprintf(stderr, "Unable to create simulator HID event\n");
+    return dispatched ? 0 : 1;
+  }
+}

package/apple/macos-helper/Package.swift

@@ -14,20 +14,17 @@ let package = Package(
     .target(
       name: "AgentDeviceMacOSInput"
     ),
-    .target(
-      name: "AgentDeviceMacOSDeviceHub"
-    ),
     .executableTarget(
       name: "AgentDeviceMacOSHelper",
-      dependencies: ["AgentDeviceMacOSInput", "AgentDeviceMacOSDeviceHub"]
+      dependencies: ["AgentDeviceMacOSInput"]
     ),
     .testTarget(
       name: "AgentDeviceMacOSInputTests",
       dependencies: ["AgentDeviceMacOSInput"]
     ),
     .testTarget(
-      name: "AgentDeviceMacOSDeviceHubTests",
-      dependencies: ["AgentDeviceMacOSDeviceHub"]
+      name: "AgentDeviceMacOSHelperTests",
+      dependencies: ["AgentDeviceMacOSHelper"]
     ),
   ]
 )

package/apple/macos-helper/Sources/AgentDeviceMacOSHelper/main.swift

@@ -75,7 +75,6 @@ struct PressResponse: Encodable {
 struct ScreenshotResponse: Encodable {
   let path: String
   let surface: String?
-  let fullscreen: Bool
 }
 
 struct AgentDeviceMacOSHelper {
@@ -127,8 +126,6 @@ struct AgentDeviceMacOSHelper {
       return try handleScreenshot(arguments: Array(arguments.dropFirst()))
     case "audio-probe":
       return try handleAudioProbe(arguments: Array(arguments.dropFirst()))
-    case "device-hub":
-      return try handleDeviceHub(arguments: Array(arguments.dropFirst()))
     default:
       throw HelperError.invalidArgs("unknown command: \(command)")
     }
@@ -438,9 +435,8 @@ struct AgentDeviceMacOSHelper {
     }
 
     let surface = optionValue(arguments: arguments, name: "--surface")
-    let fullscreen = arguments.contains("--fullscreen")
-    try captureSurfaceScreenshot(surface: surface, outPath: outPath, fullscreen: fullscreen)
-    return SuccessEnvelope(data: ScreenshotResponse(path: outPath, surface: surface, fullscreen: fullscreen))
+    try captureSurfaceScreenshot(surface: surface, outPath: outPath)
+    return SuccessEnvelope(data: ScreenshotResponse(path: outPath, surface: surface))
   }
 
   static func handleAudioProbe(arguments: [String]) throws -> any Encodable {
@@ -549,8 +545,7 @@ private func pressAtPosition(_ request: MouseClickRequest) throws {
   }
 }
 
-private func captureSurfaceScreenshot(surface: String?, outPath: String, fullscreen: Bool) throws {
-  _ = fullscreen
+private func captureSurfaceScreenshot(surface: String?, outPath: String) throws {
   guard #available(macOS 15.2, *) else {
     throw HelperError.commandFailed(
       "screenshot on macOS desktop and menubar surfaces requires macOS 15.2 or newer"

package/apple/macos-helper/Tests/AgentDeviceMacOSHelperTests/ScreenshotResponseTests.swift

@@ -0,0 +1,15 @@
+import XCTest
+
+@testable import AgentDeviceMacOSHelper
+
+/// `captureSurfaceScreenshot` always reads the main display, so the response describes only
+/// what was actually captured: no field for an argument the helper does not read.
+final class ScreenshotResponseTests: XCTestCase {
+  func testResponseNeverCarriesAFullscreenField() throws {
+    let response = ScreenshotResponse(path: "/tmp/out.png", surface: "desktop")
+    let data = try JSONEncoder().encode(response)
+    let decoded = try JSONSerialization.jsonObject(with: data) as? [String: Any]
+
+    XCTAssertEqual(Set(decoded?.keys.map { $0 } ?? []), ["path", "surface"])
+  }
+}

package/apple/snapshot-bridge/SnapshotBridgeRuntime.m

@@ -18,7 +18,7 @@
 NSString *const kProtocolVersionKey = @"protocolVersion";
 NSString *const kSourceVersionKey = @"sourceVersion";
 NSString *const kRequestIdKey = @"requestId";
-NSString *const kSourceVersion = @"agent-device-simulator-ax-v1.6.0";
+NSString *const kSourceVersion = @"agent-device-simulator-ax-v1.7.0";
 const NSUInteger kProtocolVersion = 1;
 const uint32_t kMaximumFrameBytes = 16 * 1024 * 1024;
 const NSUInteger kMaximumDepth = 128;
@@ -34,8 +34,11 @@ static NSString *const kAttributeFrame = @"XC_kAXXCAttributeFrame";
 static NSString *const kAttributeAutomationType = @"XC_kAXXCAttributeAutomationType";
 static NSString *const kAttributeTraits = @"XC_kAXXCAttributeTraits";
 static NSString *const kAttributeChildren = @"XC_kAXXCAttributeChildren";
+static NSString *const kAttributeIsUserInteractionEnabled = @"XC_kAXXCAttributeIsUserInteractionEnabled";
+static NSString *const kPresentationDimmingViewClass = @"UIDimmingView";
 static NSString *const kSnapshotAttributes = @"UIAccessibilitySnapshotKeyAttributes";
 static NSString *const kSnapshotChildren = @"UIAccessibilitySnapshotKeyChildren";
+static NSString *const kSnapshotElement = @"UIAccessibilitySnapshotKeyElement";
 static NSString *const kXctAutomationSupportPath =
     @"/Developer/Library/PrivateFrameworks/XCTAutomationSupport.framework/XCTAutomationSupport";
 static NSString *const kAxRuntimePath =
@@ -202,8 +205,35 @@ static void finishRequestWatchdog(dispatch_source_t watchdog, SnapshotWatchdogSt
   return nil;
 }
 
+/*
+ * Whether a presentation's dimming view takes touches is what separates a sheet that blocks the
+ * content under it from one resting at an undimmed detent, and nothing else in the tree says so.
+ * It is read for dimming views alone: requesting it for every node costs about half again the
+ * capture time.
+ */
+- (nullable NSNumber *)userInteractionEnabledForSnapshot:(NSDictionary *)snapshot
+                                                 options:(nullable NSDictionary *)options
+{
+  id element = snapshot[kSnapshotElement];
+  NSNumber *attribute = [options[@"attributes"] firstObject];
+  if (!element || ![attribute isKindOfClass:NSNumber.class]) return nil;
+  @try {
+    NSError *failure = nil;
+    NSDictionary *read = [_framework userTestingSnapshotForElement:element options:options error:&failure];
+    if (![read isKindOfClass:NSDictionary.class]) return nil;
+    NSDictionary *attributes = read[kSnapshotAttributes];
+    if (![attributes isKindOfClass:NSDictionary.class]) return nil;
+    id value = attributes[attribute];
+    return [value isKindOfClass:NSNumber.class] ? @([(NSNumber *)value boolValue]) : nil;
+  } @catch (NSException *exception) {
+    (void)exception;
+    return nil;
+  }
+}
+
 - (nullable NSDictionary *)nodeFromSnapshot:(id)snapshot
                               namesByNumber:(NSDictionary<NSNumber *, NSString *> *)namesByNumber
+                         interactionOptions:(nullable NSDictionary *)interactionOptions
                                       depth:(NSUInteger)depth
                                    maxDepth:(NSUInteger)maxDepth
                                    maxNodes:(NSUInteger)maxNodes
@@ -233,6 +263,11 @@ static void finishRequestWatchdog(dispatch_source_t watchdog, SnapshotWatchdogSt
     id safe = [self jsonValue:attributes[number] name:name];
     if (safe) node[name] = safe;
   }
+  if ([node[kAttributeElementType] isEqual:kPresentationDimmingViewClass]) {
+    NSNumber *interaction = [self userInteractionEnabledForSnapshot:(NSDictionary *)snapshot
+                                                            options:interactionOptions];
+    if (interaction) node[kAttributeIsUserInteractionEnabled] = interaction;
+  }
 
   NSArray *children = ((NSDictionary *)snapshot)[kSnapshotChildren];
   if (![children isKindOfClass:NSArray.class]) {
@@ -246,6 +281,7 @@ static void finishRequestWatchdog(dispatch_source_t watchdog, SnapshotWatchdogSt
     for (id child in children) {
       NSDictionary *built = [self nodeFromSnapshot:child
                                      namesByNumber:namesByNumber
+                                interactionOptions:interactionOptions
                                              depth:depth + 1
                                           maxDepth:maxDepth
                                              maxNodes:maxNodes
@@ -317,6 +353,15 @@ static void finishRequestWatchdog(dispatch_source_t watchdog, SnapshotWatchdogSt
   options[@"maxDepth"] = @(maxDepth);
   options[@"maxChildren"] = @(maxNodes);
   options[@"maxArrayCount"] = @(maxNodes);
+  NSArray<NSNumber *> *interactionAttribute = _attributeNumbersForNames(@[ kAttributeIsUserInteractionEnabled ]);
+  NSMutableDictionary *interactionOptions = nil;
+  if ([interactionAttribute isKindOfClass:NSArray.class] && interactionAttribute.count == 1) {
+    interactionOptions = [options mutableCopy];
+    interactionOptions[@"attributes"] = interactionAttribute;
+    interactionOptions[@"maxDepth"] = @0;
+    interactionOptions[@"maxChildren"] = @0;
+    interactionOptions[@"maxArrayCount"] = @0;
+  }
   BOOL automationEnabled = [self assertAutomationMode:YES];
   NSError *runtimeError = nil;
   id snapshot = nil;
@@ -372,6 +417,7 @@ static void finishRequestWatchdog(dispatch_source_t watchdog, SnapshotWatchdogSt
   NSUInteger count = 0;
   NSDictionary *tree = [self nodeFromSnapshot:snapshot
                                 namesByNumber:namesByNumber
+                           interactionOptions:interactionOptions
                                         depth:0
                                      maxDepth:maxDepth
                                         maxNodes:maxNodes

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

@@ -56,14 +56,24 @@ int main(int argc, const char *argv[]) {
 
 #else
 #import <UIKit/UIKit.h>
+#if TARGET_OS_IOS
+#import <UserNotifications/UserNotifications.h>
+#endif
 
 @interface AgentDeviceRunnerViewController : UIViewController
 @property(nonatomic, strong) UILabel *alertActionStatus;
+@property(nonatomic, strong) UILabel *alertActivationBusyAnswer;
 @property(nonatomic, assign) NSUInteger firstAlertActions;
 @property(nonatomic, assign) NSUInteger replacementAlertActions;
 @property(nonatomic, assign) BOOL alertFixtureStarted;
 @property(nonatomic, strong) NSTimer *alertActivationBusyBackstop;
+@property(nonatomic, strong) NSTimer *alertBannerRepost;
+@end
+
+#if TARGET_OS_IOS
+@interface AgentDeviceRunnerViewController () <UNUserNotificationCenterDelegate>
 @end
+#endif
 
 @implementation AgentDeviceRunnerViewController
 
@@ -72,15 +82,21 @@ int main(int argc, const char *argv[]) {
 // may receive an event: the app keeps reporting work in flight, which is the state that cost an alert
 // command its whole deadline in #2546. It stops the moment an alert button is answered, since that
 // answer is the event the runner is trying to land, and the backstop stops it even when no answer
-// arrives so a regressed run finishes rather than waiting out XCTest's own timeout. A layer
+// arrives so a regressed run finishes rather than waiting out XCTest's own timeout. The test passes
+// the backstop after `--agent-device-alert-activation-busy`, sized to outlast its whole resolution
+// and activation budget, so a slow host cannot end the busy state before the answer lands. A layer
 // animation on its own is not enough; only a UIView animation counts as in-flight work here.
-static NSTimeInterval const kAgentDeviceAlertActivationBusyWindow = 20.0;
+static NSTimeInterval AgentDeviceAlertActivationBusyWindow(void) {
+  NSArray<NSString *> *arguments = NSProcessInfo.processInfo.arguments;
+  NSUInteger flag = [arguments indexOfObject:@"--agent-device-alert-activation-busy"];
+  return flag + 1 < arguments.count ? arguments[flag + 1].doubleValue : 0;
+}
 
 - (void)startAlertActivationBusy {
   if (self.alertActivationBusyBackstop != nil) {
     return;
   }
-  self.alertActivationBusyBackstop = [NSTimer scheduledTimerWithTimeInterval:kAgentDeviceAlertActivationBusyWindow
+  self.alertActivationBusyBackstop = [NSTimer scheduledTimerWithTimeInterval:AgentDeviceAlertActivationBusyWindow()
                                                                       target:self
                                                                     selector:@selector(stopAlertActivationBusy)
                                                                     userInfo:nil
@@ -101,6 +117,57 @@ static NSTimeInterval const kAgentDeviceAlertActivationBusyWindow = 20.0;
   self.alertActivationBusyBackstop = nil;
 }
 
+// A banner from this app, shown over its own alert and re-posted before the previous one expires so
+// one is on screen for as long as the first alert is unanswered. XCTest treats such a banner as an
+// interruption of every event aimed at the app (#2546's late tap, from the banner side).
+- (void)startAlertBannerThen:(dispatch_block_t)presentAlert {
+  UNUserNotificationCenter *center = UNUserNotificationCenter.currentNotificationCenter;
+  center.delegate = self;
+  [center requestAuthorizationWithOptions:UNAuthorizationOptionAlert
+                        completionHandler:^(BOOL granted, NSError *error) {
+                          (void)error;
+                          if (!granted) {
+                            return;
+                          }
+                          dispatch_async(dispatch_get_main_queue(), ^{
+                            presentAlert();
+                            [self postAlertBanner];
+                            self.alertBannerRepost = [NSTimer scheduledTimerWithTimeInterval:2.0
+                                                                                      target:self
+                                                                                    selector:@selector(postAlertBanner)
+                                                                                    userInfo:nil
+                                                                                     repeats:YES];
+                          });
+                        }];
+}
+
+- (void)postAlertBanner {
+  UNMutableNotificationContent *content = [[UNMutableNotificationContent alloc] init];
+  content.title = @"Agent Device banner";
+  content.body = @"Shown over the alert fixture";
+  UNNotificationRequest *request = [UNNotificationRequest requestWithIdentifier:NSUUID.UUID.UUIDString
+                                                                        content:content
+                                                                        trigger:nil];
+  [UNUserNotificationCenter.currentNotificationCenter addNotificationRequest:request withCompletionHandler:nil];
+}
+
+- (void)stopAlertBanner {
+  if (self.alertBannerRepost == nil) {
+    return;
+  }
+  [self.alertBannerRepost invalidate];
+  self.alertBannerRepost = nil;
+  [UNUserNotificationCenter.currentNotificationCenter removeAllDeliveredNotifications];
+}
+
+- (void)userNotificationCenter:(UNUserNotificationCenter *)center
+       willPresentNotification:(UNNotification *)notification
+         withCompletionHandler:(void (^)(UNNotificationPresentationOptions options))completionHandler {
+  (void)center;
+  (void)notification;
+  completionHandler(UNNotificationPresentationOptionBanner);
+}
+
 
 - (void)updateAlertActionStatus {
   self.alertActionStatus.text = [NSString stringWithFormat:@"First actions: %lu; replacement actions: %lu",
@@ -123,7 +190,12 @@ static NSTimeInterval const kAgentDeviceAlertActivationBusyWindow = 20.0;
         ? UIAlertActionStyleCancel : UIAlertActionStyleDefault;
     [alert addAction:[UIAlertAction actionWithTitle:buttonTitle style:style handler:^(UIAlertAction *action) {
       (void)action;
+      if (!replacement) {
+        self.alertActivationBusyAnswer.text = self.alertActivationBusyBackstop != nil
+            ? @"Answered while busy" : @"Answered after the app went idle";
+      }
       [self stopAlertActivationBusy];
+      [self stopAlertBanner];
       if (replacement) {
         self.replacementAlertActions += 1;
       } else {
@@ -145,9 +217,16 @@ static NSTimeInterval const kAgentDeviceAlertActivationBusyWindow = 20.0;
   if (!self.alertFixtureStarted &&
       [NSProcessInfo.processInfo.arguments containsObject:@"--agent-device-alert-replacement-regression"]) {
     self.alertFixtureStarted = YES;
-    [self presentAlertFixtureReplacement:NO];
-    if ([NSProcessInfo.processInfo.arguments containsObject:@"--agent-device-alert-activation-busy"]) {
-      [self startAlertActivationBusy];
+    dispatch_block_t presentAlert = ^{
+      [self presentAlertFixtureReplacement:NO];
+      if ([NSProcessInfo.processInfo.arguments containsObject:@"--agent-device-alert-activation-busy"]) {
+        [self startAlertActivationBusy];
+      }
+    };
+    if ([NSProcessInfo.processInfo.arguments containsObject:@"--agent-device-alert-banner"]) {
+      [self startAlertBannerThen:presentAlert];
+    } else {
+      presentAlert();
     }
   }
 }
@@ -185,6 +264,19 @@ static NSTimeInterval const kAgentDeviceAlertActivationBusyWindow = 20.0;
     [self updateAlertActionStatus];
   }
 
+  if ([NSProcessInfo.processInfo.arguments containsObject:@"--agent-device-alert-activation-busy"]) {
+    UILabel *busyAnswer = [[UILabel alloc] init];
+    busyAnswer.text = @"Unanswered";
+    busyAnswer.accessibilityIdentifier = @"agent-device-alert-busy-answer";
+    busyAnswer.translatesAutoresizingMaskIntoConstraints = NO;
+    [self.view addSubview:busyAnswer];
+    [NSLayoutConstraint activateConstraints:@[
+      [busyAnswer.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
+      [busyAnswer.topAnchor constraintEqualToAnchor:label.bottomAnchor constant:24],
+    ]];
+    self.alertActivationBusyAnswer = busyAnswer;
+  }
+
   if ([NSProcessInfo.processInfo.arguments containsObject:@"--agent-device-text-entry-regression"]) {
     UITextField *textField = [[UITextField alloc] init];
     textField.accessibilityIdentifier = @"agent-device-hardware-keyboard-input";
@@ -227,7 +319,7 @@ static NSTimeInterval const kAgentDeviceAlertActivationBusyWindow = 20.0;
 
 @end
 
-#if defined(TARGET_OS_VISION) && TARGET_OS_VISION
+// UIApplicationSceneManifest in Info.plist names this class; a rename must update the manifest.
 @interface AgentDeviceRunnerSceneDelegate : UIResponder <UIWindowSceneDelegate>
 @property(nonatomic, strong) UIWindow *window;
 @end
@@ -250,46 +342,11 @@ static NSTimeInterval const kAgentDeviceAlertActivationBusyWindow = 20.0;
 }
 
 @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[]) {

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunner/Info.plist

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>UIApplicationSceneManifest</key>
+	<dict>
+		<key>UIApplicationSupportsMultipleScenes</key>
+		<false/>
+		<key>UISceneConfigurations</key>
+		<dict>
+			<key>UIWindowSceneSessionRoleApplication</key>
+			<array>
+				<dict>
+					<key>UISceneConfigurationName</key>
+					<string>Default Configuration</string>
+					<key>UISceneDelegateClassName</key>
+					<string>AgentDeviceRunnerSceneDelegate</string>
+				</dict>
+			</array>
+		</dict>
+	</dict>
+</dict>
+</plist>

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunner.xcodeproj/project.pbxproj

@@ -21,9 +21,22 @@
 		20EA2EDD2F2CFC7C001CF0EF /* AgentDeviceRunnerUITests.xctest */ = {isa = PBXFileReference; explicitFileType = wrapper.cfbundle; includeInIndex = 0; path = AgentDeviceRunnerUITests.xctest; sourceTree = BUILT_PRODUCTS_DIR; };
 /* End PBXFileReference section */
 
+/* Begin PBXFileSystemSynchronizedBuildFileExceptionSet section */
+		20EA2EF02F2CFC7C001CF0EF /* Exceptions for "AgentDeviceRunner" folder in "AgentDeviceRunner" target */ = {
+			isa = PBXFileSystemSynchronizedBuildFileExceptionSet;
+			membershipExceptions = (
+				Info.plist,
+			);
+			target = 20EA2EC52F2CFC7B001CF0EF /* AgentDeviceRunner */;
+		};
+/* End PBXFileSystemSynchronizedBuildFileExceptionSet section */
+
 /* Begin PBXFileSystemSynchronizedRootGroup section */
 		20EA2EC82F2CFC7B001CF0EF /* AgentDeviceRunner */ = {
 			isa = PBXFileSystemSynchronizedRootGroup;
+			exceptions = (
+				20EA2EF02F2CFC7C001CF0EF /* Exceptions for "AgentDeviceRunner" folder in "AgentDeviceRunner" target */,
+			);
 			path = AgentDeviceRunner;
 			sourceTree = "<group>";
 		};
@@ -352,6 +365,8 @@
 				DEVELOPMENT_TEAM = 2S799L9W4M;
 				ENABLE_PREVIEWS = YES;
 				GENERATE_INFOPLIST_FILE = YES;
+				INFOPLIST_FILE = AgentDeviceRunner/Info.plist;
+				"INFOPLIST_FILE[sdk=macosx*]" = "";
 				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = NO;
 				INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
 				INFOPLIST_KEY_UILaunchScreen_Generation = YES;
@@ -386,6 +401,8 @@
 				DEVELOPMENT_TEAM = 2S799L9W4M;
 				ENABLE_PREVIEWS = YES;
 				GENERATE_INFOPLIST_FILE = YES;
+				INFOPLIST_FILE = AgentDeviceRunner/Info.plist;
+				"INFOPLIST_FILE[sdk=macosx*]" = "";
 				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = NO;
 				INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
 				INFOPLIST_KEY_UILaunchScreen_Generation = YES;

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAppScreenCapture.swift

@@ -54,6 +54,21 @@ enum RunnerAppScreenCaptureFailure: String, Error {
   }
 }
 
+extension RunnerTests {
+
+
+  func selectObservedScreenCapture(
+    resolving: () -> Result<CapturedAppScreen, RunnerAppScreenCaptureFailure>,
+    fallingBack: () -> Result<CapturedAppScreen, RunnerAppScreenCaptureFailure>
+  ) -> Result<CapturedAppScreen, RunnerAppScreenCaptureFailure> {
+    let outcome = resolving()
+    if case .failure(.unresolvedWindow) = outcome {
+      return fallingBack()
+    }
+    return outcome
+  }
+}
+
 #if canImport(UIKit) && os(iOS)
 extension RunnerTests {
 
@@ -103,19 +118,6 @@ extension RunnerTests {
     )
   }
 
-
-
-  func selectObservedScreenCapture(
-    resolving: () -> Result<CapturedAppScreen, RunnerAppScreenCaptureFailure>,
-    fallingBack: () -> Result<CapturedAppScreen, RunnerAppScreenCaptureFailure>
-  ) -> Result<CapturedAppScreen, RunnerAppScreenCaptureFailure> {
-    let outcome = resolving()
-    if case .failure(.unresolvedWindow) = outcome {
-      return fallingBack()
-    }
-    return outcome
-  }
-
   private static func resolveCapturedAppScreen(
     app: XCUIApplication
   ) -> Result<CapturedAppScreen, RunnerAppScreenCaptureFailure> {
@@ -140,6 +142,12 @@ extension RunnerTests {
     guard let cgImage = runnerCGImage(from: upright) else {
       return .failure(.unrenderableImage)
     }
+
+
+
+    guard cgImage.width > 0, cgImage.height > 0 else {
+      return .failure(.unrenderableImage)
+    }
     return .success(
       CapturedAppScreen(
         image: upright,