agent-device 0.16.13 → 0.17.0

package/ios-runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Transport.swift

@@ -112,12 +112,33 @@ extension RunnerTests {
         completion((jsonResponse(status: 200, response: executeStatus(command: command)), false))
         return
       }
+      if command.command == .uptime {
+        completion((jsonResponse(status: 200, response: executeUptime()), false))
+        return
+      }
+      NSLog(
+        "AGENT_DEVICE_RUNNER_COMMAND_ACCEPTED command=%@ commandId=%@",
+        command.command.rawValue,
+        command.commandId ?? ""
+      )
       commandJournal.accept(command: command)
       commandExecutionQueue.async {
         do {
           let response = try self.executeAccepted(command: command)
+          NSLog(
+            "AGENT_DEVICE_RUNNER_COMMAND_COMPLETED command=%@ commandId=%@ ok=%d",
+            command.command.rawValue,
+            command.commandId ?? "",
+            response.ok ? 1 : 0
+          )
           completion((self.jsonResponse(status: 200, response: response), command.command == .shutdown))
         } catch {
+          NSLog(
+            "AGENT_DEVICE_RUNNER_COMMAND_FAILED command=%@ commandId=%@ error=%@",
+            command.command.rawValue,
+            command.commandId ?? "",
+            String(describing: error)
+          )
           completion((
             self.jsonResponse(
               status: 500,

package/ios-runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TvRemote.swift

@@ -81,7 +81,18 @@ extension RunnerTests {
     if let outcome = selectFocusedTvElement(app: app, element: element, action: action) {
       return outcome
     }
+#if os(tvOS)
     return performElementTap(element)
+#else
+    let frame = element.frame
+    if !frame.isEmpty {
+      // XCUIElement.tap() can fail the whole XCTest after navigation because it
+      // re-resolves the tapped element even after the app removed it. Keep the
+      // selector target semantic, then activate its resolved stable screen point.
+      return tapAt(app: app, x: frame.midX, y: frame.midY)
+    }
+    return performElementTap(element)
+#endif
   }
 
   func selectFocusedTvElement(app: XCUIApplication, point: CGPoint, action: String) -> RunnerInteractionOutcome? {

package/ios-runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift

@@ -39,8 +39,6 @@ final class RunnerTests: XCTestCase {
   var currentApp: XCUIApplication?
   var currentBundleId: String?
   let maxRequestBytes = 2 * 1024 * 1024
-  let maxSnapshotElements = 600
-  let fastSnapshotLimit = 300
   let mainThreadExecutionTimeout: TimeInterval = 30
   let appExistenceTimeout: TimeInterval = 30
   let retryCooldown: TimeInterval = 0.2
@@ -48,6 +46,7 @@ final class RunnerTests: XCTestCase {
   let firstInteractionAfterActivateDelay: TimeInterval = 0.25
   let scrollInteractionIdleTimeoutDefault: TimeInterval = 1.0
   let tvRemoteDoublePressDelayDefault: TimeInterval = 0.0
+  let xctestIdleKeepaliveInterval: TimeInterval = 5.0
   let minRecordingFps = 1
   let maxRecordingFps = 120
   let minRecordingQuality = 5
@@ -119,6 +118,18 @@ final class RunnerTests: XCTestCase {
       self.handle(connection: conn)
     }
     listener?.start(queue: transportQueue)
+    let idleKeepaliveTimer = DispatchSource.makeTimerSource(queue: transportQueue)
+    idleKeepaliveTimer.schedule(
+      deadline: .now() + xctestIdleKeepaliveInterval,
+      repeating: xctestIdleKeepaliveInterval
+    )
+    idleKeepaliveTimer.setEventHandler {
+      NSLog("AGENT_DEVICE_RUNNER_IDLE_KEEPALIVE")
+    }
+    idleKeepaliveTimer.resume()
+    defer {
+      idleKeepaliveTimer.cancel()
+    }
 
     guard let expectation = doneExpectation else {
       XCTFail("runner expectation was not initialized")

package/ios-runner/README.md

@@ -33,6 +33,19 @@ Protocol and maintenance references:
 - `RunnerTests+SystemModal.swift`: SpringBoard/system modal detection and modal snapshot shaping.
 - `RunnerTests+ScreenRecorder.swift`: nested `ScreenRecorder` implementation.
 
+## Snapshot Strategy
+
+iOS snapshots have two explicit capture modes:
+
+- full/raw snapshots use recursive XCTest snapshots for rich hierarchy and diagnostics;
+- compact interactive snapshots use a bounded flat XCTest query path for fast agent-facing refs.
+
+Some simulator apps expose accessibility trees that lower-level AX services can inspect but XCTest
+cannot serialize reliably. In those cases compact interactive snapshots may return a sparse root
+quickly, while full snapshots preserve the XCTest error. See
+[`../docs/adr/0004-ios-snapshot-backend-strategy.md`](../docs/adr/0004-ios-snapshot-backend-strategy.md)
+for the backend boundary and the rationale for a future simulator AX-service backend.
+
 ## Protocol Notes
 
 - The daemon posts JSON commands to `POST /command` on the runner's local HTTP listener.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-device",
-  "version": "0.16.13",
+  "version": "0.17.0",
   "description": "Agent-native CLI for AI mobile testing and app automation across iOS, Android, tvOS, Android TV, macOS, and Linux.",
   "mcpName": "io.github.callstackincubator/agent-device",
   "license": "MIT",

package/server.json

@@ -7,12 +7,12 @@
     "url": "https://github.com/callstackincubator/agent-device",
     "source": "github"
   },
-  "version": "0.16.13",
+  "version": "0.17.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "agent-device",
-      "version": "0.16.13",
+      "version": "0.17.0",
       "transport": {
         "type": "stdio"
       }

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

@@ -1 +0,0 @@
-14f6601f1aa7584d5e51c165615c692ce7377e3ce8003b4a7a3f54b1f4bdddcf  agent-device-android-multitouch-helper-0.16.13.apk

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

@@ -1 +0,0 @@
-ed457dc38126e5459f96de44b6a5ba70c8029b6fe26dfcc2dd1f96e30bae0835  agent-device-android-snapshot-helper-0.16.13.apk