agent-device 0.21.15 → 0.21.16

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

@@ -0,0 +1 @@
+2b9f418df9ee3ddce97502fbb39dd34d06562d2747cf45e41393725a928d1007  agent-device-android-ime-helper-0.21.16.apk

package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.15.manifest.json → agent-device-android-ime-helper-0.21.16.manifest.json}

@@ -1,10 +1,10 @@
 {
   "name": "android-ime-helper",
-  "version": "0.21.15",
-  "assetName": "agent-device-android-ime-helper-0.21.15.apk",
-  "sha256": "2f8d38e6705542b327057b059c77cf3a6358fa2fc9a53e4bf5ecfb6279c441bf",
+  "version": "0.21.16",
+  "assetName": "agent-device-android-ime-helper-0.21.16.apk",
+  "sha256": "2b9f418df9ee3ddce97502fbb39dd34d06562d2747cf45e41393725a928d1007",
   "packageName": "com.callstack.agentdevice.imehelper",
-  "versionCode": 21015,
+  "versionCode": 21016,
   "serviceComponent": "com.callstack.agentdevice.imehelper/.TestInputMethodService",
   "broadcastProtocol": "android-ime-helper-v1"
 }

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

@@ -0,0 +1 @@
+a7db56d04eaee4009721cc4bf0947a12de4eb491b4a16e6b2bfa3b987a43012d  agent-device-android-snapshot-helper-0.21.16.apk

package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.15.manifest.json → agent-device-android-snapshot-helper-0.21.16.manifest.json}

@@ -1,13 +1,13 @@
 {
   "name": "android-snapshot-helper",
-  "version": "0.21.15",
-  "releaseTag": "v0.21.15",
-  "assetName": "agent-device-android-snapshot-helper-0.21.15.apk",
+  "version": "0.21.16",
+  "releaseTag": "v0.21.16",
+  "assetName": "agent-device-android-snapshot-helper-0.21.16.apk",
   "apkUrl": null,
-  "sha256": "af733a540d518ede88f0336564d6d4d03b05191732130b65a3094228fa1bed54",
-  "checksumName": "agent-device-android-snapshot-helper-0.21.15.apk.sha256",
+  "sha256": "a7db56d04eaee4009721cc4bf0947a12de4eb491b4a16e6b2bfa3b987a43012d",
+  "checksumName": "agent-device-android-snapshot-helper-0.21.16.apk.sha256",
   "packageName": "com.callstack.agentdevice.snapshothelper",
-  "versionCode": 21015,
+  "versionCode": 21016,
   "instrumentationRunner": "com.callstack.agentdevice.snapshothelper/.SnapshotInstrumentation",
   "minSdk": 23,
   "targetSdk": 36,

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

@@ -66,7 +66,6 @@ int main(int argc, const char *argv[]) {
 @property(nonatomic, assign) NSUInteger firstAlertActions;
 @property(nonatomic, assign) NSUInteger replacementAlertActions;
 @property(nonatomic, strong) UILabel *textEntryWriteBackStatus;
-@property(nonatomic, assign) NSUInteger textEntryRenderedEdits;
 @property(nonatomic, assign) NSUInteger textEntryWriteBacks;
 @property(nonatomic, copy, nullable) NSString *textEntryRenderedValue;
 @property(nonatomic, assign) NSTimeInterval textEntryLastEditTime;
@@ -187,8 +186,7 @@ static NSTimeInterval AgentDeviceAlertActivationBusyWindow(void) {
 - (void)updateTextEntryWriteBackStatus {
   NSTimeInterval burstSpan = self.textEntryLastEditTime - self.textEntryBurstStartTime;
   self.textEntryWriteBackStatus.text = [NSString
-    stringWithFormat:@"edits=%lu write-backs=%lu burst-edits=%lu burst-ms=%lu min-gap-ms=%lu",
-                     (unsigned long)self.textEntryRenderedEdits,
+    stringWithFormat:@"write-backs=%lu burst-edits=%lu burst-ms=%lu min-gap-ms=%lu",
                      (unsigned long)self.textEntryWriteBacks,
                      (unsigned long)self.textEntryBurstEdits,
                      (unsigned long)llround(burstSpan * 1000),
@@ -292,7 +290,6 @@ static const NSTimeInterval AgentDeviceTextEntryBurstBreakSeconds = 1.0;
       }
     } else {
       self.textEntryRenderedValue = [textField.text copy];
-      self.textEntryRenderedEdits += 1;
     }
     [self updateTextEntryWriteBackStatus];
   }

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedTextEntry.h

@@ -17,21 +17,21 @@ typedef NS_ENUM(NSInteger, RunnerSynthesizedTextEntryStatus) {
 
 @interface RunnerSynthesizedTextEntry : NSObject
 
-// Characters per second the synthesized text-input records are typed at. Declared here, where the
-// typing happens, so the delivery budget that bounds a burst is charged the same pace the app sees.
-// The edit-acknowledge window that pace is sized for is a separate assumption about the app
-// (TextEntryTiming.synthesizedAcknowledgeWindowSeconds), not a value derived from this one.
-+ (NSUInteger)typingSpeedCharactersPerSecond;
-
 // Synthesizes keyboard input for the current first responder without resolving an
 // XCUIElement or serializing the application's accessibility tree.
+//
+// `charactersPerSecond` is XCTest's `typingSpeed:` argument. The caller declares it because the
+// same number is what the caller's delivery budget charges a burst (#2955): a pace owned here and
+// read back from Swift would let a call site type at a speed its own budget never charged.
 + (RunnerSynthesizedTextEntryResult *)synthesizeTextWithApplication:(id)application
-                                                               text:(NSString *)text;
+                                                               text:(NSString *)text
+                                                  charactersPerSecond:(NSUInteger)charactersPerSecond;
 
 // Replaces the current first responder's contents with one synthesized Command-A record
-// followed by a text-input record, typed at the bounded pace declared in the implementation.
+// followed by a text-input record, typed at the pace the caller declares.
 + (RunnerSynthesizedTextEntryResult *)replaceTextWithApplication:(id)application
-                                                           text:(NSString *)text;
+                                                           text:(NSString *)text
+                                              charactersPerSecond:(NSUInteger)charactersPerSecond;
 
 @end
 

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedTextEntry.m

@@ -5,19 +5,10 @@
 
 static NSString *const RunnerTextSynthesisSurface = @"text";
 
-// XCTest's `typingSpeed:` argument is characters per second. At 60 the 11 characters of a `fill`
-// arrived at a fixture field across 131 ms (~13 ms per gap), which is faster than an app that owns
-// its field's value and re-applies it after the edit (a controlled React Native `TextInput`, an
-// async validator) can acknowledge: such a write lands between two characters of the burst and
-// erases what was typed while it was in flight, leaving a value that is stable short of the
-// request. 12 characters/second spaces them ~83 ms apart on average, which reduces that loss but
-// does not remove it: XCTest does not space the characters evenly, and two of them can reach the
-// app a few milliseconds apart. Against a fixture app that acknowledges each edit within 40 ms, 60
-// characters/second left 1 of 11 characters in 20 of 20 bursts, and this pace left 10 or 11. The
-// command refuses a field left short; back-pressure from the field (#2906) is what would prevent
-// it. The app-owned-value lane test pins the average spacing the app sees, and the delivery budget
-// in TextEntryTiming bounds what the pace costs a long text.
-static const NSUInteger RunnerTextEntryTypingSpeedCharactersPerSecond = 12;
+// The pace (`typingSpeed:`) is a caller argument, not a constant here: TextEntryTiming owns it so
+// the synthesized delivery budget charges the pace the app actually sees (#2955). XCTest's
+// `typingSpeed:` is characters per second, and it spaces them unevenly — two characters of a paced
+// burst can reach the app a few milliseconds apart at any pace.
 
 typedef id (*RunnerTextMsgSendInit)(id, SEL, NSString *);
 typedef id (*RunnerTextMsgSendInitPath)(id, SEL);
@@ -49,6 +40,7 @@ static RunnerSynthesizedTextEntryResult *RunnerTextEntryFailed(NSString *message
 static RunnerSynthesizedTextEntryResult *RunnerSynthesizeTextWithMode(
   id application,
   NSString *text,
+  NSUInteger charactersPerSecond,
   BOOL replace
 );
 
@@ -65,18 +57,16 @@ static RunnerSynthesizedTextEntryResult *RunnerSynthesizeTextWithMode(
 
 @implementation RunnerSynthesizedTextEntry
 
-+ (NSUInteger)typingSpeedCharactersPerSecond {
-  return RunnerTextEntryTypingSpeedCharactersPerSecond;
-}
-
 + (RunnerSynthesizedTextEntryResult *)synthesizeTextWithApplication:(id)application
-                                                               text:(NSString *)text {
-  return RunnerSynthesizeTextWithMode(application, text, NO);
+                                                               text:(NSString *)text
+                                                  charactersPerSecond:(NSUInteger)charactersPerSecond {
+  return RunnerSynthesizeTextWithMode(application, text, charactersPerSecond, NO);
 }
 
 + (RunnerSynthesizedTextEntryResult *)replaceTextWithApplication:(id)application
-                                                           text:(NSString *)text {
-  return RunnerSynthesizeTextWithMode(application, text, YES);
+                                                           text:(NSString *)text
+                                              charactersPerSecond:(NSUInteger)charactersPerSecond {
+  return RunnerSynthesizeTextWithMode(application, text, charactersPerSecond, YES);
 }
 
 @end
@@ -84,6 +74,7 @@ static RunnerSynthesizedTextEntryResult *RunnerSynthesizeTextWithMode(
 static RunnerSynthesizedTextEntryResult *RunnerSynthesizeTextWithMode(
   id application,
   NSString *text,
+  NSUInteger charactersPerSecond,
   BOOL replace
 ) {
   @try {
@@ -151,7 +142,7 @@ static RunnerSynthesizedTextEntryResult *RunnerSynthesizeTextWithMode(
       bridge.typeTextSelector,
       text,
       0.0,
-      RunnerTextEntryTypingSpeedCharactersPerSecond,
+      charactersPerSecond,
       YES
     );
     ((RunnerMsgSendAddPath)objc_msgSend)(record, bridge.core.addPathSelector, path);

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

@@ -20,13 +20,4 @@ enum SystemSurfaceHostRegistry {
     SystemSurfaceHost(bundleId: "com.apple.SafariViewService", kind: .webAuth),
     SystemSurfaceHost(bundleId: "com.apple.PassbookUIService", kind: .payment),
   ]
-
-  static func host(forBundleId bundleId: String?) -> SystemSurfaceHost? {
-    guard let bundleId else { return nil }
-    return hosts.first { $0.bundleId == bundleId }
-  }
-
-  static func isSystemSurfaceHost(_ bundleId: String?) -> Bool {
-    host(forBundleId: bundleId) != nil
-  }
 }

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedTextEntry.swift

@@ -42,8 +42,16 @@ extension RunnerTests {
 #if os(iOS)
       let postStartedAt = Date()
       let result = replacingExistingText
-        ? RunnerSynthesizedTextEntry.replaceText(withApplication: app, text: text)
-        : RunnerSynthesizedTextEntry.synthesizeText(withApplication: app, text: text)
+        ? RunnerSynthesizedTextEntry.replaceText(
+          withApplication: app,
+          text: text,
+          charactersPerSecond: TextEntryTiming.synthesizedCharactersPerSecond
+        )
+        : RunnerSynthesizedTextEntry.synthesizeText(
+          withApplication: app,
+          text: text,
+          charactersPerSecond: TextEntryTiming.synthesizedCharactersPerSecond
+        )
       NSLog(
         "[DEBUG-1874] synthesize posted %d chars status=%d tookMs=%.0f",
         text.count, result.status.rawValue, postStartedAt.timeIntervalSinceNow * -1000
@@ -73,90 +81,206 @@ extension RunnerTests {
 #endif
   }
 
-  struct SynthesizedReplacementStep: Equatable {
-    let text: String
-    let replacesExistingText: Bool
-  }
 
-  static func synthesizedReplacementSteps(
-    text: String,
-    delaySeconds: Double
-  ) -> [SynthesizedReplacementStep] {
-    guard synthesizedReplacementIsSpaced(characterCount: text.count, delaySeconds: delaySeconds)
-    else {
-      return [SynthesizedReplacementStep(text: text, replacesExistingText: true)]
+
+
+
+  struct SynthesizedTextPlan: Equatable {
+
+    struct Step: Equatable {
+      let characterCount: Int
+
+
+      var replacesExistingText = false
+
+
+
+
+      var pauseAfterSeconds: TimeInterval = 0
+
+      var warmsUpField = false
+
+
+      var synthesizeCallCount: Int {
+        replacesExistingText ? 2 : 1
+      }
     }
-    return Array(text).enumerated().map { index, character in
-      SynthesizedReplacementStep(
-        text: String(character),
-        replacesExistingText: index == 0
-      )
+
+    let steps: [Step]
+
+
+
+    static func spacedSteps(
+      characterCount: Int,
+      delaySeconds: Double,
+      replacesExistingTextOnFirstPost: Bool = false
+    ) -> [Step] {
+      (0..<characterCount).map { index in
+        Step(
+          characterCount: 1,
+          replacesExistingText: replacesExistingTextOnFirstPost && index == 0,
+          pauseAfterSeconds: index + 1 < characterCount ? delaySeconds : 0
+        )
+      }
+    }
+
+
+
+    var seconds: TimeInterval {
+      steps.reduce(0) { total, step in
+        total
+          + Double(step.characterCount) * TextEntryTiming.synthesizedCharacterInterval
+          + Double(step.synthesizeCallCount) * TextEntryTiming.synthesizeCallOverhead
+          + step.pauseAfterSeconds
+      }
+    }
+
+
+
+
+    var pacesEveryCharacter: Bool {
+      steps.count > 1 && !steps.contains(where: \.warmsUpField)
     }
   }
 
 
 
-  static func synthesizedReplacementIsSpaced(characterCount: Int, delaySeconds: Double) -> Bool {
+  static func synthesizedDeliveryIsSpaced(characterCount: Int, delaySeconds: Double) -> Bool {
     delaySeconds > 0 && characterCount > 1
   }
 
 
 
 
-  enum SynthesizedDeliveryBudget {
 
-    static var characterInterval: TimeInterval {
-      1.0 / Double(RunnerSynthesizedTextEntry.typingSpeedCharactersPerSecond())
-    }
 
 
 
 
+  static func synthesizedTextPlan(
+    characterCount: Int,
+    delaySeconds: Double,
+    selectsExistingText: Bool,
+    peelsWarmupCharacter: Bool = false
+  ) -> SynthesizedTextPlan {
+    if synthesizedDeliveryIsSpaced(characterCount: characterCount, delaySeconds: delaySeconds) {
+      return SynthesizedTextPlan(
+        steps: SynthesizedTextPlan.spacedSteps(
+          characterCount: characterCount,
+          delaySeconds: delaySeconds,
+          replacesExistingTextOnFirstPost: selectsExistingText
+        )
+      )
+    }
+    guard peelsWarmupCharacter && characterCount > 1 else {
+      return SynthesizedTextPlan(
+        steps: [
+          SynthesizedTextPlan.Step(
+            characterCount: characterCount,
+            replacesExistingText: selectsExistingText
+          ),
+        ]
+      )
+    }
+    return SynthesizedTextPlan(
+      steps: [
+        SynthesizedTextPlan.Step(
+          characterCount: 1,
+          pauseAfterSeconds: TextEntryTiming.pollInterval,
+          warmsUpField: true
+        ),
+        SynthesizedTextPlan.Step(characterCount: characterCount - 1),
+      ]
+    )
+  }
 
 
-    static func projectedSeconds(
-      textLength: Int,
-      delaySeconds: TimeInterval,
-      typeWarmup: Bool = false
-    ) -> TimeInterval {
-      let spaced = synthesizedReplacementIsSpaced(characterCount: textLength, delaySeconds: delaySeconds)
-      let warmupSplit = typeWarmup && textLength > 1 && !spaced
-      let calls = spaced ? textLength : (warmupSplit ? 2 : 1)
-      return Double(textLength) * characterInterval
-        + Double(calls) * TextEntryTiming.synthesizeCallOverhead
-        + Double(calls - 1) * delaySeconds
-        + (warmupSplit ? TextEntryTiming.pollInterval : 0)
-    }
 
-    static func exceeds(
-      textLength: Int,
-      delaySeconds: TimeInterval,
-      typeWarmup: Bool = false
-    ) -> Bool {
-      projectedSeconds(textLength: textLength, delaySeconds: delaySeconds, typeWarmup: typeWarmup)
-        > TextEntryTiming.synthesizedDeliveryCeiling
+  enum SynthesizedDeliveryBudget {
+    static func exceeds(_ plan: SynthesizedTextPlan) -> Bool {
+      plan.seconds > TextEntryTiming.synthesizedDeliveryCeiling
     }
 
 
+
+
     static func maxTextLength(delaySeconds: TimeInterval) -> Int {
       var length = 1
-      while !exceeds(textLength: length + 1, delaySeconds: delaySeconds) {
+      while !exceeds(
+        synthesizedTextPlan(
+          characterCount: length + 1,
+          delaySeconds: delaySeconds,
+          selectsExistingText: true
+        )
+      ) {
         length += 1
       }
       return length
     }
   }
 
+
+
+  enum SynthesizedStepDispatch {
+    case posted
+    case stop
+  }
+
+  struct SynthesizedPlanRun {
+    let postedCharacterCount: Int
+
+    let stoppedEarly: Bool
+  }
+
+
+
+
+
+
+
+
+
+
+
+  @MainActor
+  func runSynthesizedTextPlan(
+    _ plan: SynthesizedTextPlan,
+    text: String,
+    post: (_ characters: String, _ step: SynthesizedTextPlan.Step) -> SynthesizedStepDispatch,
+    waitAfterWarmupCharacter: (_ characters: String) -> Void,
+    didPostStep: (_ step: SynthesizedTextPlan.Step) -> Void = { _ in }
+  ) -> SynthesizedPlanRun {
+    let characters = Array(text)
+    var postedCount = 0
+    for step in plan.steps {
+      let nextCount = postedCount + step.characterCount
+      if post(String(characters[postedCount..<nextCount]), step) == .stop {
+
+        return SynthesizedPlanRun(postedCharacterCount: postedCount, stoppedEarly: true)
+      }
+      postedCount = nextCount
+      didPostStep(step)
+      if step.warmsUpField {
+        waitAfterWarmupCharacter(String(characters[postedCount - step.characterCount..<postedCount]))
+      } else if step.pauseAfterSeconds > 0 {
+        sleepFor(step.pauseAfterSeconds)
+      }
+    }
+    return SynthesizedPlanRun(postedCharacterCount: postedCount, stoppedEarly: false)
+  }
+
   @MainActor
   func runSynthesizedReplacementRoute(
     _ request: SynthesizedReplacementRequest
   ) -> SynthesizedReplacementRouteOutcome {
 #if os(iOS)
     NSLog("AGENT_DEVICE_RUNNER_TEXT_ENTRY_ROUTE route=synthesized-first-responder-replacement")
-    if SynthesizedDeliveryBudget.exceeds(
-      textLength: request.text.count,
-      delaySeconds: request.delaySeconds
-    ) {
+    let plan = Self.synthesizedTextPlan(
+      characterCount: request.text.count,
+      delaySeconds: request.delaySeconds,
+      selectsExistingText: true
+    )
+    if SynthesizedDeliveryBudget.exceeds(plan) {
       NSLog(
         "AGENT_DEVICE_RUNNER_TEXT_ENTRY_ROUTE route=synthesized-first-responder-replacement "
           + "reason=delivery-budget-refused chars=%d budgetChars=%d",
@@ -174,33 +298,38 @@ extension RunnerTests {
         )
       )
     }
-    let steps = Self.synthesizedReplacementSteps(
+
+
+    let synthesisAvailable = runSynthesizedTextPlan(
+      plan,
       text: request.text,
-      delaySeconds: request.delaySeconds
+      post: { slice, step in
+        switch request.synthesizer.enterText(
+          app: request.app,
+          text: slice,
+          replacingExistingText: step.replacesExistingText
+        ) {
+        case .continueTyping:
+          return .posted
+        case .fallback:
+          return .stop
+        case .raise(let message):
+          NSException(
+            name: NSExceptionName.internalInconsistencyException,
+            reason: message ?? "private XCTest text synthesis failed"
+          ).raise()
+          return .stop
+        }
+      },
+
+      waitAfterWarmupCharacter: { _ in }
     )
-    for (index, step) in steps.enumerated() {
-      switch request.synthesizer.enterText(
-        app: request.app,
-        text: step.text,
-        replacingExistingText: step.replacesExistingText
-      ) {
-      case .fallback:
-        NSLog("AGENT_DEVICE_RUNNER_TEXT_ENTRY_ROUTE route=verified-fallback reason=synthesis-unavailable")
-        guard let point = request.target.refreshPoint else { return .notApplicable }
-        return .fallback(
-          focusTextInputForTextEntry(app: request.app, x: point.x, y: point.y)
-        )
-      case .raise(let message):
-        NSException(
-          name: NSExceptionName.internalInconsistencyException,
-          reason: message ?? "private XCTest text synthesis failed"
-        ).raise()
-      case .continueTyping:
-        break
-      }
-      if index + 1 < steps.count {
-        sleepFor(request.delaySeconds)
-      }
+    if synthesisAvailable.stoppedEarly {
+      NSLog("AGENT_DEVICE_RUNNER_TEXT_ENTRY_ROUTE route=verified-fallback reason=synthesis-unavailable")
+      guard let point = request.target.refreshPoint else { return .notApplicable }
+      return .fallback(
+        focusTextInputForTextEntry(app: request.app, x: point.x, y: point.y)
+      )
     }
 
 

package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntry.swift

@@ -36,7 +36,11 @@ extension RunnerTests {
         let recoveryBudget = SynthesizedDeliveryBudget.maxTextLength(
           delaySeconds: Double(recoveryDelay) / 1000
         )
-        return "Fill at most \(SynthesizedDeliveryBudget.maxTextLength(delaySeconds: 0)) characters at a time without --delay-ms and append the rest with separate type commands, keeping each command inside that budget. --delay-ms lowers the budget, because each character then gets its own synthesize call and each gap between characters pays the delay: \(recoveryBudget) characters at --delay-ms \(recoveryDelay). A longer timeout does not help: this route is chosen when the accessibility channel is already degraded, and the pace is what makes the text long."
+
+
+
+
+        return "Fill at most \(SynthesizedDeliveryBudget.maxTextLength(delaySeconds: 0)) characters per command without --delay-ms and append the rest with separate type commands. --delay-ms lowers the limit: each character then gets its own synthesize call and each gap pays the delay, so \(recoveryDelay) ms fits \(recoveryBudget). This route is chosen when the accessibility channel is already degraded, so a longer timeout does not help."
       }
     }
   }
@@ -76,7 +80,18 @@ extension RunnerTests {
 
 
 
-    static let synthesizedAcknowledgeWindowSeconds: TimeInterval = 0.04
+
+
+
+
+
+
+
+
+
+    static let synthesizedCharactersPerSecond: UInt = 12
+
+    static let synthesizedCharacterInterval: TimeInterval = 1.0 / Double(synthesizedCharactersPerSecond)