agent-device 0.21.22 → 0.21.24

package/README.md

@@ -31,7 +31,7 @@ agent-device doctor
 agent-device help workflow
 ```
 
-Run `doctor` yourself before handing the CLI to an agent; `help workflow` links to the guides for debugging, replay, and profiling, and the installed help always matches the installed version.
+Run `doctor` yourself before you hand the CLI to an agent. `help workflow` links to the guides for debugging, replay, and profiling.
 
 ### Drive an app from the CLI
 
@@ -61,7 +61,7 @@ agent-device screenshot ./contact-form.png
 agent-device close
 ```
 
-Refs are only valid from the latest output: after a `--settle` command, use the refs in its diff, and take a new snapshot only if the diff omits what you need. Snapshots come from the app's accessibility tree, so clear labels, roles, and test IDs make agent runs more reliable; use screenshots and video as evidence or when accessibility data is poor.
+Refs are valid only in the latest output: after a `--settle` command, use the refs in its diff, and take a new snapshot only if the diff omits what you need. Snapshots come from the app's accessibility tree, so clear labels, roles, and test IDs make agent runs more reliable; use screenshots and video as evidence or when accessibility data is poor.
 
 ![agent-device demo showing Codex using agent-device to create a new contact in the iOS Contacts app from a simple prompt](./website/docs/public/agent-device-contacts.gif)
 
@@ -126,7 +126,7 @@ With the CLI installed, prompts like these work end to end:
 ## Next steps
 
 - [AI Agent Setup](https://oss.callstack.com/agent-device/docs/agent-setup): skills, project rules, and per-client setup for Cursor, Codex, Claude Code, Windsurf, and others.
-- [Quick Start](https://oss.callstack.com/agent-device/docs/quick-start): a guided run on the bundled Expo test app with screenshots, replay, and performance data.
+- [Quick Start](https://oss.callstack.com/agent-device/docs/quick-start): open an app, read its UI, and interact with it from the command line.
 - [Replay & E2E](https://oss.callstack.com/agent-device/docs/replay-e2e) and [Debugging & Profiling](https://oss.callstack.com/agent-device/docs/debugging-profiling): repeatable tests and bug hunting.
 
 ## Where to run agent-device
@@ -137,15 +137,15 @@ The same session and evidence model works at every step: the agent explores the
 | --- | --- | --- |
 | Local | Trying commands and debugging apps on simulators, emulators, physical devices, macOS, and Linux. | Follow the Quick Start. |
 | CI/CD | Automated pull request and merge validation with replay scripts and captured artifacts. | Try the [EAS workflow template](https://github.com/callstackincubator/eas-agent-device/blob/main/.eas/workflows/agent-qa-mobile.yml). |
-| Cloud / remote | Linux runners, managed devices, and remote jobs. | Set up a [remote proxy](https://oss.callstack.com/agent-device/docs/remote-proxy), connect a [device cloud](https://oss.callstack.com/agent-device/docs/device-clouds) (BrowserStack, AWS Device Farm, Limrun), or [contact Callstack](mailto:hello@callstack.com) for team QA. |
+| Cloud / remote | Linux runners, managed devices, and remote jobs. | Set up a [remote proxy](https://oss.callstack.com/agent-device/docs/remote-proxy), connect a [device cloud](https://oss.callstack.com/agent-device/docs/device-clouds) (BrowserStack, AWS Device Farm, TestMu AI, Limrun), or [contact Callstack](mailto:hello@callstack.com) for team QA. |
 
 ## How it works
 
 `agent-device` keeps device state in sessions. It uses a local accessibility bridge for iOS Simulator snapshots and XCTest for iOS interactions, physical iOS, and tvOS; ADB and the snapshot helper on Android; HDC and ArkUI `uitest` on HarmonyOS; Vega CLI/VDA on the Vega Virtual Device; a local helper on macOS; and AT-SPI on Linux.
 
-Support depth varies by target. Newer backends such as HarmonyOS and Vega OS cover a subset of commands; run `agent-device capabilities --platform <platform>` to see what a target supports.
+Support depth varies by target. Some backends, such as HarmonyOS and Vega OS, cover a subset of commands; run `agent-device capabilities --platform <platform>` to see what a target supports.
 
-Sessions are scoped to the caller's git worktree, and host-local device claims stop parallel agents from taking over each other's simulators and emulators. Inspect ownership without a daemon via `agent-device device status`, and settle provably dead owners with `agent-device device release --stale`. The same commands drive hosted devices on [BrowserStack, AWS Device Farm, and Limrun](https://oss.callstack.com/agent-device/docs/device-clouds).
+Sessions are scoped to the caller's git worktree, and host-local device claims stop parallel agents from taking over each other's simulators and emulators. Run `agent-device device status` to inspect ownership without a daemon, and `agent-device device release --stale` to release claims whose owner is provably no longer running. The same commands drive hosted devices on [BrowserStack, AWS Device Farm, TestMu AI, and Limrun](https://oss.callstack.com/agent-device/docs/device-clouds).
 
 `agent-device` uses the inspect-act-verify process from Vercel's [agent-browser](https://github.com/vercel-labs/agent-browser) for mobile, TV, and desktop apps. Basic `--platform web` support runs `agent-browser` in the same session and replay system.
 

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

@@ -0,0 +1 @@
+ca5c3b48c9da40f1fcddd785f1129906125e4880549cfacb1b63ff70848aed1e  agent-device-android-ime-helper-0.21.24.apk

package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.22.manifest.json → agent-device-android-ime-helper-0.21.24.manifest.json}

@@ -1,10 +1,10 @@
 {
   "name": "android-ime-helper",
-  "version": "0.21.22",
-  "assetName": "agent-device-android-ime-helper-0.21.22.apk",
-  "sha256": "c271cf2448728e2b10c51e132ea9393d1fdc4696578febcd361f6a6470b74b89",
+  "version": "0.21.24",
+  "assetName": "agent-device-android-ime-helper-0.21.24.apk",
+  "sha256": "ca5c3b48c9da40f1fcddd785f1129906125e4880549cfacb1b63ff70848aed1e",
   "packageName": "com.callstack.agentdevice.imehelper",
-  "versionCode": 21022,
+  "versionCode": 21024,
   "serviceComponent": "com.callstack.agentdevice.imehelper/.TestInputMethodService",
   "broadcastProtocol": "android-ime-helper-v1"
 }

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

@@ -0,0 +1 @@
+d3a6ab00e617da9fb019d21eb5a894e1f4699f263044f0ce387a5ea16e56ca47  agent-device-android-snapshot-helper-0.21.24.apk

package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.22.manifest.json → agent-device-android-snapshot-helper-0.21.24.manifest.json}

@@ -1,13 +1,13 @@
 {
   "name": "android-snapshot-helper",
-  "version": "0.21.22",
-  "releaseTag": "v0.21.22",
-  "assetName": "agent-device-android-snapshot-helper-0.21.22.apk",
+  "version": "0.21.24",
+  "releaseTag": "v0.21.24",
+  "assetName": "agent-device-android-snapshot-helper-0.21.24.apk",
   "apkUrl": null,
-  "sha256": "e39e73088e371a3cee63b403f12609eea53acd37c810b0a1241e9c5285ac2c07",
-  "checksumName": "agent-device-android-snapshot-helper-0.21.22.apk.sha256",
+  "sha256": "d3a6ab00e617da9fb019d21eb5a894e1f4699f263044f0ce387a5ea16e56ca47",
+  "checksumName": "agent-device-android-snapshot-helper-0.21.24.apk.sha256",
   "packageName": "com.callstack.agentdevice.snapshothelper",
-  "versionCode": 21022,
+  "versionCode": 21024,
   "instrumentationRunner": "com.callstack.agentdevice.snapshothelper/.SnapshotInstrumentation",
   "minSdk": 23,
   "targetSdk": 36,

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

@@ -795,12 +795,18 @@ func rectAttribute(_ element: AXUIElement) -> RectResponse? {
     return nil
   }
 
-  return RectResponse(
-    x: Double(position.x),
-    y: Double(position.y),
-    width: Double(size.width),
-    height: Double(size.height)
-  )
+  return finiteRectResponse(position: position, size: size)
+}
+
+/// JSONEncoder throws on inf/NaN, which fails the whole snapshot. SwiftUI reports lazy
+/// containers scrolled out of view as an AXOpaqueProviderGroup at (inf, inf, 0, 0).
+func finiteRectResponse(position: CGPoint, size: CGSize) -> RectResponse? {
+  let x = Double(position.x)
+  let y = Double(position.y)
+  let width = Double(size.width)
+  let height = Double(size.height)
+  guard x.isFinite, y.isFinite, width.isFinite, height.isFinite else { return nil }
+  return RectResponse(x: x, y: y, width: width, height: height)
 }
 
 private func accessibilityAxValue(_ value: CFTypeRef?) -> AXValue? {

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

@@ -0,0 +1,21 @@
+import XCTest
+
+@testable import AgentDeviceMacOSHelper
+
+final class RectResponseTests: XCTestCase {
+  func testFiniteRectKeepsItsValues() throws {
+    let rect = try XCTUnwrap(
+      finiteRectResponse(position: CGPoint(x: 1, y: 2), size: CGSize(width: 3, height: 4)))
+    XCTAssertEqual([rect.x, rect.y, rect.width, rect.height], [1, 2, 3, 4])
+  }
+
+  func testNonFiniteComponentYieldsNoRect() {
+    let nonFinite: [CGFloat] = [.infinity, -.infinity, .nan]
+    for value in nonFinite {
+      XCTAssertNil(finiteRectResponse(position: CGPoint(x: value, y: 0), size: .zero))
+      XCTAssertNil(finiteRectResponse(position: CGPoint(x: 0, y: value), size: .zero))
+      XCTAssertNil(finiteRectResponse(position: .zero, size: CGSize(width: value, height: 0)))
+      XCTAssertNil(finiteRectResponse(position: .zero, size: CGSize(width: 0, height: value)))
+    }
+  }
+}

package/apple/snapshot-bridge/README.md

@@ -50,13 +50,15 @@ disabled after fallback until that app relaunches.
 
 ## Remote content
 
-The reader snapshots one process. A WebKit page — Safari's or a `WKWebView`'s —
-lives in a WebContent process and appears in that tree as an `AXRemoteElement`
-leaf under the web view. The guest returns the leaf as delivered; the host
-refuses a tree in which such a leaf sits under a web view and reaches the
-viewport, or reports no frame (`remote-content-boundary`), and routes that app
-generation to XCTest, which resolves remote elements (#2484). A zero-area or
-off-screen leaf is published: it hosts nothing the capture can miss.
+The reader snapshots one process. Two hosts put another process's UI into that
+tree as an `AXRemoteElement` leaf: a WebKit page — Safari's or a `WKWebView`'s —
+lives in a WebContent process under the web view, and a scene-hosted remote view
+controller, such as a share extension presented over the app, lives in the
+extension's process under a `_UISceneHostingView`. The guest returns the leaf as
+delivered; the host refuses a tree in which such a leaf sits under either host
+and reaches the viewport, or reports no frame (`remote-content-boundary`), and
+routes that app generation to XCTest, which resolves remote elements (#2484). A
+zero-area or off-screen leaf is published: it hosts nothing the capture can miss.
 
 ## Bounded depth recovery
 

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

@@ -114,6 +114,7 @@ extension RunnerTests {
     let app: XCUIApplication
 
     var systemSurface: SystemSurfaceHost? = nil
+    var observation: SnapshotObservationPayload? = nil
   }
 
   enum ActiveCommandPreparation {
@@ -494,6 +495,26 @@ extension RunnerTests {
     command: Command,
     routeToSpringboard: Bool = false
   ) -> ActiveCommandPreparation {
+    if command.command == .snapshot, command.observeOnly == true {
+#if os(iOS)
+      guard command.appBundleId?.trimmedNonEmpty != nil else {
+        return .response(observeOnlyUnavailableResponse())
+      }
+      let observedApp = resolveAppWithoutActivation(command: command)
+      let reportedState = observedApp.state
+      guard reportedState == .runningForeground else {
+        return .response(observeOnlyUnavailableResponse())
+      }
+      return .context(ActiveCommandContext(
+        app: observedApp,
+        observation: SnapshotObservationPayload(appState: Self.applicationStateName(reportedState))
+      ))
+#else
+      return .response(Response(ok: false, error: ErrorPayload(
+        code: "UNSUPPORTED_OPERATION", message: "observe-only snapshot is supported on iOS and iPadOS only"
+      )))
+#endif
+    }
     if routeToSpringboard {
       return .context(ActiveCommandContext(app: springboard))
     }
@@ -516,11 +537,26 @@ extension RunnerTests {
 
 
 
+
+
       return prepareActivatedTarget(command: command)
 #endif
     case .existingApp:
 
 
+#if os(macOS)
+      if let bundleId = command.appBundleId?.trimmedNonEmpty,
+        macReadMayBeServedInBackground(
+          command: command,
+          targetState: XCUIApplication(bundleIdentifier: bundleId).state
+        )
+      {
+
+
+        refreshCachedTargetIfProcessChanged(bundleId: bundleId)
+        return .context(ActiveCommandContext(app: resolveAppWithoutActivation(command: command)))
+      }
+#endif
       return prepareActivatedTarget(command: command)
     case .mayLaunch:
       if shouldSkipAppActivationPreflight(command) {
@@ -644,6 +680,14 @@ extension RunnerTests {
     return XCUIApplication(bundleIdentifier: host.bundleId).state
   }
 
+  func observeOnlyUnavailableResponse() -> Response {
+    Response(ok: false, error: ErrorPayload(
+      code: "OBSERVATION_UNAVAILABLE",
+      message: "The session app cannot be observed without activation.",
+      hint: "XCUIApplication must report runningForeground before and after capture. This state report does not prove screen ownership (#2696)."
+    ))
+  }
+
   func currentXCTestFailureCount() -> Int {
     return testRun?.failureCount ?? 0
   }
@@ -746,4 +790,16 @@ extension RunnerTests {
     }
     return XCUIApplication(bundleIdentifier: bundleId)
   }
+
+
+
+
+
+
+
+
+
+  func macReadMayBeServedInBackground(command: Command, targetState: XCUIApplication.State) -> Bool {
+    command.appBundleId?.trimmedNonEmpty != nil && targetState == .runningBackground
+  }
 }

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

@@ -429,17 +429,26 @@ extension RunnerTests {
     case .screenshot:
 #if os(macOS)
 
-      if let bundleId = command.appBundleId, !bundleId.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty {
+
+
+
+      let screenshotBundleId = command.appBundleId?.trimmedNonEmpty
+      if let bundleId = screenshotBundleId {
         let targetApp = XCUIApplication(bundleIdentifier: bundleId)
-        targetApp.activate()
-        activeApp = targetApp
+        if macAppCaptureNeedsRaise(
+          fullscreen: command.fullscreen,
+          targetState: targetApp.state
+        ) {
+          targetApp.activate()
 
-        sleepFor(0.5)
+          sleepFor(0.5)
+        }
+        activeApp = targetApp
       }
       let screenshot: XCUIScreenshot
       if command.fullscreen == true {
         screenshot = XCUIScreen.main.screenshot()
-      } else if let bundleId = command.appBundleId, !bundleId.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty {
+      } else if screenshotBundleId != nil {
         screenshot = screenshotRoot(app: activeApp).screenshot()
       } else {
         screenshot = XCUIScreen.main.screenshot()

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

@@ -284,6 +284,14 @@ extension RunnerTests {
     return false
   }
 
+
+
+
+  func macAppCaptureNeedsRaise(fullscreen: Bool?, targetState: XCUIApplication.State) -> Bool {
+    guard targetState != .runningForeground else { return false }
+    return fullscreen != true || targetState == .notRunning
+  }
+
   @MainActor
   func canUseFastForegroundAppGuard(
     activeApp: XCUIApplication,

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

@@ -66,6 +66,9 @@ enum CommandLaunchPolicy: Equatable {
 
 
 
+
+
+
   case existingApp
 
   case mayLaunch
@@ -239,6 +242,7 @@ struct Command: Codable {
   let interactiveOnly: Bool?
   let preferredBackend: String?
   let customActions: Bool?
+  let observeOnly: Bool?
   let depth: Int?
   let scope: String?
   let raw: Bool?
@@ -488,6 +492,7 @@ struct DataPayload: Codable {
   var failedStepIndex: Int?
   var sequenceResults: [SequenceStepResult]?
   var targetActivation: TargetActivationFactPayload?
+  var observation: SnapshotObservationPayload?
 
 
   var screenshotMetadata: ScreenshotMetadataPayload?
@@ -529,6 +534,13 @@ struct SystemSurfaceProvenancePayload: Codable {
   let kind: String
 }
 
+struct SnapshotObservationPayload: Codable {
+  var mode = "observe-only"
+  var activationPerformed = false
+  let appState: String
+  var appStateSource = "xcuiapplication-state"
+}
+
 struct SnapshotQualityPayload: Codable {
   let nodes: [PresentedNode]
   let truncated: Bool

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

@@ -17,7 +17,7 @@ struct SnapshotCaptureTarget {
 
 enum SnapshotCommandPreparation {
   case response(Response)
-  case capture(SnapshotCaptureTarget, systemSurface: SystemSurfaceHost?)
+  case capture(SnapshotCaptureTarget, systemSurface: SystemSurfaceHost?, observation: SnapshotObservationPayload?)
 }
 
 

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

@@ -19,19 +19,27 @@ extension RunnerTests {
         return .response(response)
       case .context(let context):
         return .capture(
-          self.takeSnapshotCaptureTarget(app: context.app),
-          systemSurface: context.systemSurface
+          context.observation == nil
+            ? self.takeSnapshotCaptureTarget(app: context.app)
+            : SnapshotCaptureTarget(
+              app: context.app,
+              bundleId: command.appBundleId?.trimmedNonEmpty,
+              processIdentifier: Self.processIdentifier(of: context.app)
+            ),
+          systemSurface: context.systemSurface,
+          observation: context.observation
         )
       }
     }
     switch preparation {
     case .response(let response):
       return response
-    case .capture(let target, let systemSurface):
+    case .capture(let target, let systemSurface, let observation):
       return try executeSnapshotPrepared(
         command: command,
         target: target,
-        systemSurface: systemSurface
+        systemSurface: systemSurface,
+        observation: observation
       )
     }
   }
@@ -86,7 +94,8 @@ extension RunnerTests {
   private func executeSnapshotPrepared(
     command: Command,
     target: SnapshotCaptureTarget,
-    systemSurface: SystemSurfaceHost?
+    systemSurface: SystemSurfaceHost?,
+    observation: SnapshotObservationPayload?
   ) throws -> Response {
     let options = Self.presentationOptions(from: command)
     do {
@@ -102,6 +111,21 @@ extension RunnerTests {
           kind: systemSurface.kind.rawValue
         )
       }
+      if let observation {
+        guard let capturedProcessIdentifier = target.processIdentifier else {
+          return observeOnlyUnavailableResponse()
+        }
+        let unchanged = try runMainThreadWork(
+          "observe_only_state",
+          timeout: Self.mainThreadExecutionTimeout,
+          timeoutError: Self.mainThreadExecutionTimeoutError
+        ) {
+          target.app.state == .runningForeground
+            && Self.processIdentifier(of: target.app) == capturedProcessIdentifier
+        }
+        guard unchanged else { return observeOnlyUnavailableResponse() }
+        payload.observation = observation
+      }
       setNeedsPostSnapshotInteractionDelay()
       return Response(ok: true, data: payload)
     } catch let failure as SnapshotCaptureFailure {

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

@@ -243,7 +243,7 @@ extension RunnerTests {
     }
   }
 
-  func clearTextInput(_ element: XCUIElement) {
+  func clearTextInput(app: XCUIApplication, _ element: XCUIElement) {
 
 
 
@@ -257,7 +257,7 @@ extension RunnerTests {
       return
     }
 #if !os(tvOS)
-    moveCaretToEnd(element: element)
+    moveCaretToEnd(app: app, element: element)
 #endif
     let count = estimatedDeleteCount(for: element)
     let deletes = String(repeating: XCUIKeyboardKey.delete.rawValue, count: count)
@@ -358,6 +358,21 @@ extension RunnerTests {
   }
 
 
+
+
+
+
+
+
+
+
+  func textEntrySnapshotFrame(_ element: XCUIElement) -> CGRect? {
+
+
+    safely("TEXT_ENTRY_SNAPSHOT_FRAME", { element.exists ? try? element.snapshot() : nil })?.frame
+  }
+
+
   func probeTextEntryInput(_ element: XCUIElement) -> TextEntryInputProbe {
     var probe = TextEntryInputProbe.unavailable
     let (_, exception) = catchingObjCException(fallback: ()) {
@@ -395,20 +410,29 @@ extension RunnerTests {
     return nil
   }
 
-  private func moveCaretToEnd(element: XCUIElement) {
+  private func moveCaretToEnd(app: XCUIApplication, element: XCUIElement) {
 #if os(tvOS)
     return
 #else
-    let frame = element.frame
-    guard !frame.isEmpty else {
-      element.tap()
+
+
+
+
+
+
+
+
+
+
+
+    guard let frame = textEntrySnapshotFrame(element), !frame.isEmpty else {
       return
     }
-    let origin = element.coordinate(withNormalizedOffset: CGVector(dx: 0, dy: 0))
-    let target = origin.withOffset(
-      CGVector(dx: max(2, frame.width - 4), dy: max(2, frame.height / 2))
+    _ = tapAt(
+      app: app,
+      x: frame.minX + max(2, frame.width - 4),
+      y: frame.minY + max(2, frame.height / 2)
     )
-    target.tap()
 #endif
   }
 

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

@@ -137,7 +137,7 @@ extension RunnerTests {
     if keyboardVisibleBeforeTap, let target {
       return TextEntryTarget(
         element: target,
-        refreshPoint: textEntryRefreshPoint(for: target) ?? requestedPoint,
+        refreshPoint: textEntryRefreshPoint(for: target, fallbackTo: requestedPoint),
         prefersFocusedElement: false
       )
     }
@@ -157,18 +157,32 @@ extension RunnerTests {
       : (waitForTextEntryReadiness(app: app, target: readyTarget) ?? stabilized.element ?? target)
     return TextEntryTarget(
       element: element,
-      refreshPoint: textEntryRefreshPoint(for: element) ?? requestedPoint,
+      refreshPoint: textEntryRefreshPoint(for: element, fallbackTo: requestedPoint),
       prefersFocusedElement: false
     )
   }
 
-  private func textEntryRefreshPoint(for element: XCUIElement?) -> CGPoint? {
+
+
+
+
+
+
+
+
+
+  private func textEntryRefreshPoint(
+    for element: XCUIElement?,
+    fallbackTo requestedPoint: CGPoint?
+  ) -> CGPoint? {
     guard let element else {
+      return requestedPoint
+    }
+    guard let frame = textEntrySnapshotFrame(element) else {
       return nil
     }
-    let frame = element.frame
     guard !frame.isEmpty else {
-      return nil
+      return requestedPoint
     }
     return CGPoint(x: frame.midX, y: frame.midY)
   }

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

@@ -34,7 +34,7 @@ extension RunnerTests {
             failure: .notFocused
           )
         }
-        clearTextInput(clearTarget)
+        clearTextInput(app: app, clearTarget)
 
 
         let observed = editableTextValue(for: clearTarget, treatingPlaceholderAsEmpty: true)
@@ -125,7 +125,7 @@ extension RunnerTests {
       }
       if currentText == nil || currentText?.isEmpty == false {
         let clearStartedAt = Date()
-        clearTextInput(replacementTarget)
+        clearTextInput(app: app, replacementTarget)
         activeTarget = activeTarget.withElement(replacementTarget)
         logTextEntryPhase(
           commandId: commandId,
@@ -465,7 +465,7 @@ extension RunnerTests {
       expectedText.count,
       observedText.count
     )
-    clearTextInput(repairTarget)
+    clearTextInput(app: app, repairTarget)
     repairTarget.typeText(expectedText)
     let repairedTarget = target.withElement(repairTarget)
     let repairedResult = verifyTextEntry(