agent-device 0.16.9 → 0.16.11

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

@@ -73,8 +73,7 @@ extension RunnerTests {
     // under XCUITest, so text entry readiness is driven by tap/keyboard state.
     return nil
 #else
-    var focused: XCUIElement?
-    let exceptionMessage = RunnerObjCExceptionCatcher.catchException({
+    return safely("FOCUSED_INPUT_QUERY") {
       let candidates = app
         .descendants(matching: .any)
         .matching(NSPredicate(format: "hasKeyboardFocus == 1"))
@@ -82,21 +81,13 @@ extension RunnerTests {
       for candidate in candidates where candidate.exists {
         switch candidate.elementType {
         case .textField, .secureTextField, .searchField, .textView:
-          focused = candidate
-          return
+          return candidate
         default:
           continue
         }
       }
-    })
-    if let exceptionMessage {
-      NSLog(
-        "AGENT_DEVICE_RUNNER_FOCUSED_INPUT_QUERY_IGNORED_EXCEPTION=%@",
-        exceptionMessage
-      )
       return nil
     }
-    return focused
 #endif
   }
 
@@ -650,18 +641,7 @@ extension RunnerTests {
 
   private func keyboardElementExists(app: XCUIApplication) -> Bool {
 #if os(iOS)
-    var exists = false
-    let exceptionMessage = RunnerObjCExceptionCatcher.catchException({
-      exists = app.keyboards.firstMatch.exists
-    })
-    if let exceptionMessage {
-      NSLog(
-        "AGENT_DEVICE_RUNNER_KEYBOARD_EXISTS_IGNORED_EXCEPTION=%@",
-        exceptionMessage
-      )
-      return false
-    }
-    return exists
+    return safely("KEYBOARD_EXISTS", false) { app.keyboards.firstMatch.exists }
 #else
     return false
 #endif

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

@@ -19,7 +19,11 @@ extension RunnerTests {
       if buffer.count + data.count > self.maxRequestBytes {
         let response = self.jsonResponse(
           status: 413,
-          response: Response(ok: false, error: ErrorPayload(message: "request too large"))
+          response: self.errorResponse(
+            code: "INVALID_ARGS",
+            message: "runner request body exceeds \(self.maxRequestBytes) bytes",
+            hint: "Send one runner command per request and keep the payload below the runner request limit."
+          )
         )
         self.sendResponse(response, over: connection) { [weak self] in
           self?.finish()
@@ -28,10 +32,11 @@ extension RunnerTests {
       }
       let combined = buffer + data
       if let body = self.parseRequest(data: combined) {
-        let result = self.handleRequestBody(body)
-        self.sendResponse(result.data, over: connection) { [weak self] in
-          if result.shouldFinish {
-            self?.finish()
+        self.handleRequestBody(body) { [weak self] result in
+          self?.sendResponse(result.data, over: connection) { [weak self] in
+            if result.shouldFinish {
+              self?.finish()
+            }
           }
         }
       } else {
@@ -82,29 +87,62 @@ extension RunnerTests {
     return nil
   }
 
-  private func handleRequestBody(_ body: Data) -> (data: Data, shouldFinish: Bool) {
-    guard let json = String(data: body, encoding: .utf8) else {
-      return (
-        jsonResponse(status: 400, response: Response(ok: false, error: ErrorPayload(message: "invalid json"))),
-        false
-      )
-    }
-    guard let data = json.data(using: .utf8) else {
-      return (
-        jsonResponse(status: 400, response: Response(ok: false, error: ErrorPayload(message: "invalid json"))),
+  private func handleRequestBody(
+    _ body: Data,
+    completion: @escaping ((data: Data, shouldFinish: Bool)) -> Void
+  ) {
+    guard String(data: body, encoding: .utf8) != nil else {
+      completion((
+        jsonResponse(
+          status: 400,
+          response: errorResponse(
+            code: "INVALID_ARGS",
+            message: "runner request body must be UTF-8 JSON",
+            hint: "Send a JSON object matching the runner command protocol."
+          )
+        ),
         false
-      )
+      ))
+      return
     }
 
     do {
-      let command = try JSONDecoder().decode(Command.self, from: data)
-      let response = try execute(command: command)
-      return (jsonResponse(status: 200, response: response), command.command == .shutdown)
+      let command = try JSONDecoder().decode(Command.self, from: body)
+      if command.command == .status {
+        completion((jsonResponse(status: 200, response: executeStatus(command: command)), false))
+        return
+      }
+      commandJournal.accept(command: command)
+      commandExecutionQueue.async {
+        do {
+          let response = try self.executeAccepted(command: command)
+          completion((self.jsonResponse(status: 200, response: response), command.command == .shutdown))
+        } catch {
+          completion((
+            self.jsonResponse(
+              status: 500,
+              response: self.errorResponse(
+                code: "COMMAND_FAILED",
+                message: error.localizedDescription,
+                hint: "Check the runner log for XCTest details, then retry after the app is foregrounded if this was a timeout or activation failure."
+              )
+            ),
+            false
+          ))
+        }
+      }
     } catch {
-      return (
-        jsonResponse(status: 500, response: Response(ok: false, error: ErrorPayload(message: "\(error)"))),
+      completion((
+        jsonResponse(
+          status: 400,
+          response: errorResponse(
+            code: "INVALID_ARGS",
+            message: "runner command payload is invalid: \(String(describing: error))",
+            hint: "Check the command name and fields against the runner protocol."
+          )
+        ),
         false
-      )
+      ))
     }
   }
 
@@ -116,6 +154,10 @@ extension RunnerTests {
     return httpResponse(status: status, body: body)
   }
 
+  private func errorResponse(code: String, message: String, hint: String? = nil) -> Response {
+    Response(ok: false, error: ErrorPayload(code: code, message: message, hint: hint))
+  }
+
   private func httpResponse(status: Int, body: String) -> Data {
     let headers = [
       "HTTP/1.1 \(status) OK",

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

@@ -32,6 +32,8 @@ final class RunnerTests: XCTestCase {
   static let defaultRecordingFps: Int32 = 15
   var listener: NWListener?
   var doneExpectation: XCTestExpectation?
+  let transportQueue = DispatchQueue(label: "agent-device.runner.transport")
+  let commandExecutionQueue = DispatchQueue(label: "agent-device.runner.commands")
   let app = XCUIApplication()
   lazy var springboard = XCUIApplication(bundleIdentifier: Self.springboardBundleId)
   var currentApp: XCUIApplication?
@@ -53,6 +55,7 @@ final class RunnerTests: XCTestCase {
   var needsPostSnapshotInteractionDelay = false
   var needsFirstInteractionDelay = false
   var activeRecording: ScreenRecorder?
+  let commandJournal = RunnerCommandJournal()
   let interactiveTypes: Set<XCUIElement.ElementType> = [
     .button,
     .cell,
@@ -91,7 +94,6 @@ final class RunnerTests: XCTestCase {
   func testCommand() throws {
     doneExpectation = expectation(description: "agent-device command handled")
     NSLog("AGENT_DEVICE_RUNNER_HEADLESS_STARTUP=1")
-    let queue = DispatchQueue(label: "agent-device.runner")
     let desiredPort = RunnerEnv.resolvePort()
     NSLog("AGENT_DEVICE_RUNNER_DESIRED_PORT=%d", desiredPort)
     listener = try makeRunnerListener(desiredPort: desiredPort)
@@ -112,10 +114,11 @@ final class RunnerTests: XCTestCase {
       }
     }
     listener?.newConnectionHandler = { [weak self] conn in
-      conn.start(queue: queue)
-      self?.handle(connection: conn)
+      guard let self else { return }
+      conn.start(queue: self.transportQueue)
+      self.handle(connection: conn)
     }
-    listener?.start(queue: queue)
+    listener?.start(queue: transportQueue)
 
     guard let expectation = doneExpectation else {
       XCTFail("runner expectation was not initialized")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-device",
-  "version": "0.16.9",
+  "version": "0.16.11",
   "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.9",
+  "version": "0.16.11",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "agent-device",
-      "version": "0.16.9",
+      "version": "0.16.11",
       "transport": {
         "type": "stdio"
       }

package/skills/dogfood/SKILL.md

@@ -22,6 +22,6 @@ Read current CLI guidance:
 agent-device help dogfood
 ```
 
-Loop: open named session -> snapshot -i + screenshot -> explore flows -> capture evidence per issue -> close.
+Loop: open app -> snapshot -i + screenshot -> explore flows -> capture evidence per issue -> close.
 
 Target app is required; infer platform or ask. Findings must come from runtime behavior, not source reads. Let `help dogfood` provide exact report shape, evidence commands, and current workflow guidance.

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

@@ -1 +0,0 @@
-5e33b9281e0c508ae6605bcd6766a859467939aae2e9fde22414a37e0f577602  agent-device-android-multitouch-helper-0.16.9.apk

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

@@ -1 +0,0 @@
-5d1106a1696ba569c2497666e80f9e2f0ba8d44072613a4491242e1118885f1a  agent-device-android-snapshot-helper-0.16.9.apk

package/dist/src/2842.js

@@ -1 +0,0 @@
-function e(e){let l=`${e??""}`.toLowerCase();return l.includes("scroll")||l.includes("recyclerview")||l.includes("listview")||l.includes("gridview")||l.includes("collectionview")||"table"===l}function l(l){return!!e(l.type)||`${l.role??""} ${l.subrole??""}`.toLowerCase().includes("scroll")}export{l as isScrollableNodeLike,e as isScrollableType};

package/dist/src/8114.js

@@ -1,4 +0,0 @@
-import e from"node:path";import t from"node:crypto";import n from"node:fs";import{resolveUserPath as r,expandUserHomePath as o}from"./3267.js";import{findProjectRoot as s}from"./9671.js";function i(e,t){let n=[],r=e+t.toString(),o=r.indexOf("\n");for(;-1!==o;){let e=r.slice(0,o).trim();r=r.slice(o+1),e&&n.push(e),o=r.indexOf("\n")}return{lines:n,buffer:r}}function a(t){let n,s=(n=(t??"").trim())?r(n):e.join(o("~"),".agent-device");return{baseDir:s,infoPath:e.join(s,"daemon.json"),lockPath:e.join(s,"daemon.lock"),logPath:e.join(s,"daemon.log"),sessionsDir:e.join(s,"sessions")}}function l(e){let t=(e??"").trim().toLowerCase();return"http"===t?"http":"dual"===t?"dual":"socket"}function u(e){let t=(e??"").trim().toLowerCase();return"auto"===t?"auto":"socket"===t?"socket":"http"===t?"http":"auto"}function p(e){return"tenant"===(e??"").trim().toLowerCase()?"tenant":"none"}function f(e){if(!e)return;let t=e.trim();if(t&&/^[a-zA-Z0-9._-]{1,128}$/.test(t))return t}let m=/(?:^|[^\w$.])(?:import|export)\s+(?:type\s+)?(?:[^'"`]*?\s+from\s+)?['"]([^'"]+)['"]/gm,c=/import\(\s*['"]([^'"]+)['"]\s*\)/gm,d=[".ts",".tsx",".js",".jsx",".mjs",".cjs"];function $(){let e=process.argv[1];return e?g(e):"unknown"}function g(r,o=s()){try{let s=e.resolve(o),i=[e.resolve(r)],a=new Set,l=[];for(;i.length>0;){let t=i.pop();if(!t||a.has(t))continue;a.add(t);let r=n.statSync(t);if(!r.isFile())continue;let o=e.relative(s,t)||t;l.push(`${o}:${r.size}:${Math.trunc(r.mtimeMs)}`);let u=n.readFileSync(t,"utf8");for(let n of function(e){let t=new Set;return h(e,m,t),h(e,c,t),[...t]}(u)){let r=function(t,n){let r=e.resolve(e.dirname(t),n),o=y(r);if(o)return o;for(let e of d){let t=y(`${r}${e}`);if(t)return t}for(let t of d){let n=y(e.join(r,`index${t}`));if(n)return n}return null}(t,n);r&&i.push(r)}}let u=l.sort().join("|"),p=t.createHash("sha1").update(u).digest("hex");return`graph:${l.length}:${p}`}catch{return"unknown"}}function h(e,t,n){t.lastIndex=0;let r=null;for(;null!==(r=t.exec(e));){let e=r[1]?.trim();e?.startsWith(".")&&n.add(e)}}function y(e){try{return n.statSync(e).isFile()?e:null}catch{return null}}function v(e){return e.meta?.requestProgress==="replay-test"}function S(e){return!!e&&"object"==typeof e&&"progress"===e.type&&!!e.event}function x(e){return!!e&&"object"==typeof e&&"response"===e.type&&!!e.response}function j(e){return`${JSON.stringify({type:"progress",event:e})}
-`}function P(e){return`${JSON.stringify({type:"response",response:e})}
-`}function D(e){return`${JSON.stringify({type:"response",response:e})}
-`}function _(t){var n,r,o;let s,i,a;if("replay-test"!==t.type)return;let l=(n=t,(s=n.title?.trim())?JSON.stringify(s):e.basename(n.file)),u=void 0!==t.durationMs?` (${a=(i=Math.max(0,(r=t).durationMs??0)/1e3)>=10?`${i.toFixed(1)}s`:i>=1?`${i.toFixed(2)}s`:`${i.toFixed(3).replace(/0+$/,"").replace(/\.$/,"")}s`,r.attempt&&r.attempt>1&&!r.retrying?`total ${a}`:a})`:"",p=void 0===(o=t).attempt?"":"fail"===o.status&&o.retrying&&void 0!==o.maxAttempts?` attempt ${o.attempt}/${o.maxAttempts} retrying`:o.attempt>1?` after ${o.attempt} attempts`:"",f=t.message?.replace(/\s+/g," ").trim();return"pass"===t.status?`PASS ${l}${p}${u}`:"skip"===t.status?[`SKIP ${l}`,f?`  ${f}`:""].filter(Boolean).join("\n"):[`FAIL ${l}${p}${u}`,f?`  ${f}`:"",t.artifactsDir?`  artifacts: ${t.artifactsDir}`:""].filter(Boolean).join("\n")}export{g as computeDaemonCodeSignature,i as consumeTextLines,_ as formatRequestProgressEvent,S as isDaemonProgressEnvelope,x as isDaemonResponseEnvelope,f as normalizeTenantId,$ as resolveDaemonCodeSignature,a as resolveDaemonPaths,l as resolveDaemonServerMode,u as resolveDaemonTransportPreference,p as resolveSessionIsolationMode,j as serializeDaemonProgressEnvelope,P as serializeDaemonResponseEnvelope,D as serializeDaemonRpcResponseEnvelope,v as shouldStreamRequestProgress};